2785 files changed, 70703 insertions, 23603 deletions

diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Resources/ResXDataNode.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Resources/ResXDataNode.xml
index 3ff8929e91b..7430b4ba276 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Resources/ResXDataNode.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Resources/ResXDataNode.xml
@@ -121,12 +121,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the position of the resource in the resource file. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that specifies the location of this resource in the resource file as a line position (<see cref="P:System.Drawing.Point.X" />) and a column position (<see cref="P:System.Drawing.Point.Y" />). If this resource is not part of a resource file, this method returns a structure that has an <see cref="P:System.Drawing.Point.X" /> of 0 and a <see cref="P:System.Drawing.Point.Y" /> of 0. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetValue">
@@ -142,7 +145,6 @@
         <Parameter Name="typeResolver" Type="System.ComponentModel.Design.ITypeResolutionService" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the stored value currently exists in memory, it is returned directly. If it is stored in the resource file and it is not a file reference, <see cref="M:System.Resources.ResXDataNode.GetValue(System.Reflection.AssemblyName[])" /> looks for a <see cref="T:System.ComponentModel.TypeConverter" /> by using the specified type resolution service that can convert from a string to the appropriate object. If the resource is a file reference, <see cref="M:System.Resources.ResXDataNode.GetValue(System.Reflection.AssemblyName[])" /> tries to de-serialize it. </para>
@@ -151,6 +153,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the object that is stored by this node by using the specified type resolution service.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object that corresponds to the stored value. </para>
+        </returns>
         <param name="typeResolver">
           <attribution license="cc4" from="Microsoft" modified="false" />The type resolution service to use when looking for a type converter.</param>
       </Docs>
@@ -168,7 +174,6 @@
         <Parameter Name="names" Type="System.Reflection.AssemblyName[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the stored value currently exists in memory, it is returned directly. If it is stored in the resource file and it is not a file reference, <see cref="M:System.Resources.ResXDataNode.GetValue(System.Reflection.AssemblyName[])" /> looks in the assemblies identified by names to find the object's corresponding type, and then looks for a <see cref="T:System.ComponentModel.TypeConverter" /> that can convert from a string to the appropriate object. If the resource is a file reference, <see cref="M:System.Resources.ResXDataNode.GetValue(System.Reflection.AssemblyName[])" /> tries to deserialize it. </para>
@@ -177,6 +182,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the object that is stored by this node by searching the specified assemblies.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object that corresponds to the stored value. </para>
+        </returns>
         <param name="names">
           <attribution license="cc4" from="Microsoft" modified="false" />The list of assemblies to search for the type of the object.</param>
       </Docs>
@@ -194,12 +203,15 @@
         <Parameter Name="typeResolver" Type="System.ComponentModel.Design.ITypeResolutionService" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the type name for the value by using the specified type resolution service.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the fully qualified name of the type.</para>
+        </returns>
         <param name="typeResolver">
           <attribution license="cc4" from="Microsoft" modified="false" />The type resolution service to use to locate a converter for this type. </param>
       </Docs>
@@ -217,12 +229,15 @@
         <Parameter Name="names" Type="System.Reflection.AssemblyName[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the type name for the value by examining the specified assemblies.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the fully qualified name of the type.</para>
+        </returns>
         <param name="names">
           <attribution license="cc4" from="Microsoft" modified="false" />The assemblies to examine for the type. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Resources/ResXFileRef.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Resources/ResXFileRef.xml
index 0e3a0767f72..1dcdd25b7e1 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Resources/ResXFileRef.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Resources/ResXFileRef.xml
@@ -136,12 +136,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the text representation of the current <see cref="T:System.Resources.ResXFileRef" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that consists of the concatenated text representations of the parameters specified in the current <see cref="Overload:System.Resources.ResXFileRef.#ctor" /> constructor.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Resources/ResXResourceReader.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Resources/ResXResourceReader.xml
index 022c5cdfc31..c10448c05a8 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Resources/ResXResourceReader.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Resources/ResXResourceReader.xml
@@ -345,12 +345,15 @@
         <Parameter Name="fileContents" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Resources.ResXResourceReader" /> object and initializes it to read a string whose contents are in the form of an XML resource file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that reads resources from the <paramref name="fileContents" /> string.</para>
+        </returns>
         <param name="fileContents">
           <attribution license="cc4" from="Microsoft" modified="false" />A string containing XML resource-formatted information. </param>
       </Docs>
@@ -370,12 +373,15 @@
         <Parameter Name="typeResolver" Type="System.ComponentModel.Design.ITypeResolutionService" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Resources.ResXResourceReader" /> object and initializes it to read a string whose contents are in the form of an XML resource file, and to use an <see cref="T:System.ComponentModel.Design.ITypeResolutionService" /> object to resolve type names specified in a resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that reads resources from the <paramref name="fileContents" /> string.</para>
+        </returns>
         <param name="fileContents">
           <attribution license="cc4" from="Microsoft" modified="false" />A string containing XML resource-formatted information. </param>
         <param name="typeResolver">
@@ -400,12 +406,15 @@
         <Parameter Name="assemblyNames" Type="System.Reflection.AssemblyName[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Resources.ResXResourceReader" /> object and initializes it to read a string whose contents are in the form of an XML resource file, and to use an array of <see cref="T:System.Reflection.AssemblyName" /> objects to resolve type names specified in a resource. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that reads resources from the <paramref name="fileContents" /> string.</para>
+        </returns>
         <param name="fileContents">
           <attribution license="cc4" from="Microsoft" modified="false" />A string whose contents are in the form of an XML resource file. </param>
         <param name="assemblyNames">
@@ -420,7 +429,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Resources.ResXResourceReader.GetEnumerator" /> method retrieves the name/value pairs in the XML resource (.resx) stream or string associated with the current <see cref="T:System.Resources.ResXResourceReader" /> object. However, if the <see cref="P:System.Resources.ResXResourceReader.UseResXDataNodes" /> property is set to true before you call <see cref="M:System.Resources.ResXResourceReader.GetEnumerator" />, the resource items are retrieved as <see cref="T:System.Resources.ResXDataNode" /> objects. In this case, all resource nodes are returned regardless of type.</para>
@@ -429,6 +437,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator for the current <see cref="T:System.Resources.ResXResourceReader" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator for the current <see cref="T:System.Resources.ResourceReader" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -446,7 +458,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resources are stored as name/value pairs in a resource file or stream. Design-time properties, which are called metadata, are stored in the resource file or stream along with runtime data resources. The <see cref="M:System.Resources.ResXResourceReader.GetMetadataEnumerator" /> method provides an <see cref="T:System.Collections.IDictionaryEnumerator" /> object that can retrieve the metadata from the resource file or stream associated with the current <see cref="T:System.Resources.ResXResourceReader" /> object. However, if the <see cref="P:System.Resources.ResXResourceReader.UseResXDataNodes" /> property is set to true before you call <see cref="M:System.Resources.ResXResourceReader.GetMetadataEnumerator" />, no resource nodes are retrieved.</para>
@@ -455,6 +466,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides a dictionary enumerator that can retrieve the design-time properties from the current XML resource file or stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator for the metadata in a resource.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IEnumerable.GetEnumerator">
@@ -469,7 +484,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Resources.ResXResourceReader" /> instance is cast to an <see cref="T:System.Collections.IEnumerable" /> interface. To enumerate the resources in a .resx file, we recommend that you call the <see cref="M:System.Resources.ResXResourceReader.GetEnumerator" /> method, and then call the MoveNext method on the returned <see cref="T:System.Collections.IDictionaryEnumerator" /> object.</para>
@@ -478,6 +492,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator for the current <see cref="T:System.Resources.ResXResourceReader" /> object. For a description of this member, see the <see cref="M:System.Collections.IEnumerable.GetEnumerator" /> method. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator that can iterate through the name/value pairs in the XML resource (.resx) stream or string associated with the current <see cref="T:System.Resources.ResXResourceReader" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.IDisposable.Dispose">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Resources/ResXResourceSet.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Resources/ResXResourceSet.xml
index 01afaf2051f..7b222d1dcf8 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Resources/ResXResourceSet.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Resources/ResXResourceSet.xml
@@ -73,12 +73,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the preferred resource reader class for this kind of <see cref="T:System.Resources.ResXResourceSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> of the preferred resource reader for this kind of <see cref="T:System.Resources.ResXResourceSet" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -93,12 +96,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the preferred resource writer class for this kind of <see cref="T:System.Resources.ResXResourceSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> of the preferred resource writer for this kind of <see cref="T:System.Resources.ResXResourceSet" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.ComponentModel.Com2Interop/IComPropertyBrowser.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.ComponentModel.Com2Interop/IComPropertyBrowser.xml
index 695efb1012d..4bf84aa000d 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.ComponentModel.Com2Interop/IComPropertyBrowser.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.ComponentModel.Com2Interop/IComPropertyBrowser.xml
@@ -63,12 +63,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Commits all pending changes to the <see cref="T:System.Windows.Forms.PropertyGrid" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Windows.Forms.PropertyGrid" /> successfully commits changes; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/ComponentEditorForm.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/ComponentEditorForm.xml
index 90e2de160b3..c25844ec1de 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/ComponentEditorForm.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/ComponentEditorForm.xml
@@ -216,12 +216,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Shows the form. The form will have no owner window.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DialogResult" /> values indicating the result code returned from the dialog box.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -238,12 +241,15 @@
         <Parameter Name="page" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Shows the specified page of the specified form. The form will have no owner window.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DialogResult" /> values indicating the result code returned from the dialog box.</para>
+        </returns>
         <param name="page">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the page to show. </param>
       </Docs>
@@ -262,12 +268,15 @@
         <Parameter Name="owner" Type="System.Windows.Forms.IWin32Window" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Shows the form with the specified owner.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DialogResult" /> values indicating the result code returned from the dialog box.</para>
+        </returns>
         <param name="owner">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.IWin32Window" /> to own the dialog. </param>
       </Docs>
@@ -287,12 +296,15 @@
         <Parameter Name="page" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Shows the form and the specified page with the specified owner.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DialogResult" /> values indicating the result code returned from the dialog box.</para>
+        </returns>
         <param name="owner">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.IWin32Window" /> to own the dialog. </param>
         <param name="page">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/ComponentEditorPage.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/ComponentEditorPage.xml
index eedd2270137..51a19bbe4d8 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/ComponentEditorPage.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/ComponentEditorPage.xml
@@ -281,12 +281,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the control that represents the window for this page.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.Control" /> that represents the window for this page.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -301,12 +304,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the component that is to be edited.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ComponentModel.IComponent" /> that is to be edited.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -340,12 +346,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the page is being activated for the first time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this is the first time the page is being activated; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -360,12 +369,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the page is being loaded.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the page is being loaded; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -629,12 +641,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the editor supports Help.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the editor supports Help; otherwise, false. The default implementation returns false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/EventsTab.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/EventsTab.xml
index 5e8e0df8683..17fb23e79a6 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/EventsTab.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/EventsTab.xml
@@ -48,12 +48,15 @@
         <Parameter Name="extendee" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified object can be extended.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified object can be extended; otherwise, false.</para>
+        </returns>
         <param name="extendee">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test for extensibility. </param>
       </Docs>
@@ -72,12 +75,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the default property from the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptor" /> indicating the default property.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to retrieve the default property of. </param>
       </Docs>
@@ -97,7 +103,6 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The event tab properties are determined from the event properties returned from a component's event service.</para>
@@ -106,6 +111,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all the properties of the event tab that match the specified attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that contains the properties. This will be an empty <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> if the component does not implement an event service.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to retrieve the properties of. </param>
         <param name="attributes">
@@ -128,12 +137,15 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all the properties of the event tab that match the specified attributes and context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that contains the properties. This will be an empty <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> if the component does not implement an event service.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain context information. </param>
         <param name="component">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/IUIService.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/IUIService.xml
index a1bb7a43af1..54502c94fb7 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/IUIService.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/IUIService.xml
@@ -34,7 +34,6 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Component editors can display a component editor form that is similar to a property page from the Component Object Model (COM).</para>
@@ -44,6 +43,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the component can display a <see cref="T:System.Windows.Forms.Design.ComponentEditorForm" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified component can display a component editor form; otherwise, false.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to check for support for displaying a <see cref="T:System.Windows.Forms.Design.ComponentEditorForm" />. </param>
       </Docs>
@@ -60,7 +63,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Some dialog boxes are parented to an owner application and are not visible in the task list. This method returns an <see cref="T:System.Windows.Forms.IWin32Window" /> that indicates the window that should be the owner for dialog boxes of this sort that are spawned from an integrated development environment.</para>
@@ -69,6 +71,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the window that should be used as the owner when showing dialog boxes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Windows.Forms.IWin32Window" /> that indicates the window to own any child dialog boxes.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -108,7 +114,6 @@
         <Parameter Name="parent" Type="System.Windows.Forms.IWin32Window" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A <see cref="T:System.Windows.Forms.Design.ComponentEditorForm" /> is similar to a property page from the Component Object Model (COM).</para>
@@ -118,6 +123,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to display a <see cref="T:System.Windows.Forms.Design.ComponentEditorForm" /> for a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attempt is successful; otherwise, false.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component for which to display a <see cref="T:System.Windows.Forms.Design.ComponentEditorForm" />. </param>
         <param name="parent">
@@ -138,12 +147,15 @@
         <Parameter Name="form" Type="System.Windows.Forms.Form" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to display the specified form in a dialog box.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DialogResult" /> values indicating the result code returned by the dialog box.</para>
+        </returns>
         <param name="form">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Form" /> to display. </param>
       </Docs>
@@ -300,7 +312,6 @@
         <Parameter Name="buttons" Type="System.Windows.Forms.MessageBoxButtons" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method ensures that the display of the message box is properly integrated with the development environment.</para>
@@ -309,6 +320,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays the specified message in a message box with the specified caption and buttons to place on the dialog box.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DialogResult" /> values indicating the result code returned by the dialog box.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The message to display. </param>
         <param name="caption">
@@ -331,12 +346,15 @@
         <Parameter Name="toolWindow" Type="System.Guid" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays the specified tool window.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the tool window was successfully shown; false if it could not be shown or found.</para>
+        </returns>
         <param name="toolWindow">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Guid" /> identifier for the tool window. This can be a custom <see cref="T:System.Guid" /> or one of the predefined values from <see cref="T:System.ComponentModel.Design.StandardToolWindows" />. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/IWindowsFormsEditorService.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/IWindowsFormsEditorService.xml
index 4e5c8fac34c..804e69c5472 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/IWindowsFormsEditorService.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/IWindowsFormsEditorService.xml
@@ -78,7 +78,6 @@
         <Parameter Name="dialog" Type="System.Windows.Forms.Form" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method displays the specified form.</para>
@@ -87,6 +86,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Shows the specified <see cref="T:System.Windows.Forms.Form" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.DialogResult" /> indicating the result code returned by the <see cref="T:System.Windows.Forms.Form" />.</para>
+        </returns>
         <param name="dialog">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Form" /> to display. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/PropertyTab.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/PropertyTab.xml
index 2ffc9813880..cbd1be3d53f 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/PropertyTab.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/PropertyTab.xml
@@ -72,12 +72,15 @@
         <Parameter Name="extendee" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this <see cref="T:System.Windows.Forms.Design.PropertyTab" /> can display properties for the specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object can be extended; otherwise, false.</para>
+        </returns>
         <param name="extendee">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test. </param>
       </Docs>
@@ -186,12 +189,15 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the default property of the specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptor" /> that represents the default property.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to retrieve the default property of. </param>
       </Docs>
@@ -210,12 +216,15 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the properties of the specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that contains the properties of the component.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to retrieve the properties of. </param>
       </Docs>
@@ -235,12 +244,15 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the properties of the specified component that match the specified attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that contains the properties.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to retrieve properties from. </param>
         <param name="attributes">
@@ -263,12 +275,15 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the properties of the specified component that match the specified attributes and context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that contains the properties matching the specified context and attributes.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that indicates the context to retrieve properties from. </param>
         <param name="component">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/ToolStripItemDesignerAvailabilityAttribute.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/ToolStripItemDesignerAvailabilityAttribute.xml
index 63314fb86b6..6e8337e7bbd 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/ToolStripItemDesignerAvailabilityAttribute.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/ToolStripItemDesignerAvailabilityAttribute.xml
@@ -125,13 +125,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overriden in a derived class, indicates whether the value of this instance is the default value for the derived class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this instance is the default attribute for the class; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/WindowsFormsComponentEditor.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/WindowsFormsComponentEditor.xml
index 6242bcfe9c3..8d473f05eeb 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/WindowsFormsComponentEditor.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Design/WindowsFormsComponentEditor.xml
@@ -45,12 +45,15 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an editor window that allows the user to edit the specified component, using the specified context information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the component was changed during editing; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
         <param name="component">
@@ -72,12 +75,15 @@
         <Parameter Name="owner" Type="System.Windows.Forms.IWin32Window" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an editor window that allows the user to edit the specified component, using the specified window that owns the component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the component was changed during editing; otherwise, false.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to edit. </param>
         <param name="owner">
@@ -100,12 +106,15 @@
         <Parameter Name="owner" Type="System.Windows.Forms.IWin32Window" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an editor window that allows the user to edit the specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the component was changed during editing; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
         <param name="component">
@@ -126,12 +135,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the component editor pages associated with the component editor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of component editor pages.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -146,12 +158,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the initial component editor page for the component editor to display.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the component editor page that the component editor will initially display.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Layout/ArrangedElementCollection.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Layout/ArrangedElementCollection.xml
index 476ad201939..fff791090e4 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Layout/ArrangedElementCollection.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Layout/ArrangedElementCollection.xml
@@ -88,13 +88,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two <see cref="T:System.Windows.Forms.Layout.ArrangedElementCollection" /> instances are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Windows.Forms.Layout.ArrangedElementCollection" /> is equal to the current <see cref="T:System.Windows.Forms.Layout.ArrangedElementCollection" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Layout.ArrangedElementCollection" /> to compare with the current <see cref="T:System.Windows.Forms.Layout.ArrangedElementCollection" />.</param>
       </Docs>
@@ -110,7 +113,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -128,6 +130,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator for the entire collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the entire collection.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -141,13 +147,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.Windows.Forms.Layout.ArrangedElementCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -231,7 +240,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.Layout.ArrangedElementCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -240,6 +248,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see the <see cref="M:System.Collections.IList.Add(System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position into which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to add to the <see cref="T:System.Collections.IList" />.</param>
       </Docs>
@@ -278,7 +290,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.Layout.ArrangedElementCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -287,6 +298,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see the <see cref="M:System.Collections.IList.Contains(System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Object" /> is found in the <see cref="T:System.Collections.IList" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the <see cref="T:System.Collections.IList" />.</param>
       </Docs>
@@ -304,7 +319,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.Layout.ArrangedElementCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -313,6 +327,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see the <see cref="M:System.Collections.IList.IndexOf(System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of <paramref name="value" /> if found in the list; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the <see cref="T:System.Collections.IList" />.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Layout/LayoutEngine.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Layout/LayoutEngine.xml
index 2a964aa1f75..1aed385a0ed 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Layout/LayoutEngine.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Layout/LayoutEngine.xml
@@ -77,7 +77,6 @@
         <Parameter Name="layoutEventArgs" Type="System.Windows.Forms.LayoutEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -87,6 +86,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Requests that the layout engine perform a layout operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if layout should be performed again by the parent of <paramref name="container" />; otherwise, false.</para>
+        </returns>
         <param name="container">
           <attribution license="cc4" from="Microsoft" modified="false" />The container on which the layout engine will operate.</param>
         <param name="layoutEventArgs">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Layout/TableLayoutSettingsTypeConverter.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Layout/TableLayoutSettingsTypeConverter.xml
index fa0ade990f7..40d1d097b7e 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Layout/TableLayoutSettingsTypeConverter.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.Layout/TableLayoutSettingsTypeConverter.xml
@@ -46,12 +46,15 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether this converter can convert an object in the given source type to the native type of this converter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
         <param name="sourceType">
@@ -72,12 +75,15 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this converter can convert an object to the given destination type by using the context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
         <param name="destinationType">
@@ -99,12 +105,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given object to the type of this converter by using the specified context and culture information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
         <param name="culture">
@@ -129,12 +138,15 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given value object to the specified type by using the specified context and culture information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
         <param name="culture">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.VisualStyles/VisualStyleElement.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.VisualStyles/VisualStyleElement.xml
index a6841ce69ff..e778c3fae45 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.VisualStyles/VisualStyleElement.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.VisualStyles/VisualStyleElement.xml
@@ -71,13 +71,16 @@
         <Parameter Name="state" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new visual style element from the specified class, part, and state values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.VisualStyles.VisualStyleElement" /> with the <see cref="P:System.Windows.Forms.VisualStyles.VisualStyleElement.ClassName" />, <see cref="P:System.Windows.Forms.VisualStyles.VisualStyleElement.Part" />, and <see cref="P:System.Windows.Forms.VisualStyles.VisualStyleElement.State" /> properties initialized to the <paramref name="className" />, <paramref name="part" />, and <paramref name="state" /> parameters.</para>
+        </returns>
         <param name="className">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents the class name of the visual style element to be created.</param>
         <param name="part">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.VisualStyles/VisualStyleRenderer.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.VisualStyles/VisualStyleRenderer.xml
index 25b6ce95190..6f5fc9a8a02 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.VisualStyles/VisualStyleRenderer.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms.VisualStyles/VisualStyleRenderer.xml
@@ -179,13 +179,16 @@
         <Parameter Name="effects" Type="System.Windows.Forms.VisualStyles.EdgeEffects" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Draws one or more edges of the specified bounding rectangle.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> that represents the interior of the <paramref name="bounds" /> parameter, minus the edges that were drawn.</para>
+        </returns>
         <param name="dc">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.IDeviceContext" /> used to draw the edges.</param>
         <param name="bounds">
@@ -404,7 +407,6 @@
         <Parameter Name="bounds" Type="System.Drawing.Rectangle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -414,6 +416,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the content area for the background of the current visual style element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> that contains the content area for the background of the current visual style element.</para>
+        </returns>
         <param name="dc">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.IDeviceContext" /> this operation will use.</param>
         <param name="bounds">
@@ -434,7 +440,6 @@
         <Parameter Name="contentBounds" Type="System.Drawing.Rectangle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -444,6 +449,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the entire background area for the current visual style element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> that contains the entire background area of the current visual style element.</para>
+        </returns>
         <param name="dc">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.IDeviceContext" /> this operation will use.</param>
         <param name="contentBounds">
@@ -464,7 +473,6 @@
         <Parameter Name="bounds" Type="System.Drawing.Rectangle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -474,6 +482,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the region for the background of the current visual style element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Region" /> that contains the background of the current visual style element.</para>
+        </returns>
         <param name="dc">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.IDeviceContext" /> this operation will use.</param>
         <param name="bounds">
@@ -498,7 +510,6 @@
         <Parameter Name="prop" Type="System.Windows.Forms.VisualStyles.BooleanProperty" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -508,6 +519,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified Boolean property for the current visual style element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property specified by the <paramref name="prop" /> parameter is true for the current visual style element; otherwise, false.</para>
+        </returns>
         <param name="prop">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.VisualStyles.BooleanProperty" /> values that specifies which property value to retrieve for the current visual style element.</param>
       </Docs>
@@ -525,7 +540,6 @@
         <Parameter Name="prop" Type="System.Windows.Forms.VisualStyles.ColorProperty" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -535,6 +549,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified color property for the current visual style element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Color" /> that contains the value of the property specified by the <paramref name="prop" /> parameter for the current visual style element.</para>
+        </returns>
         <param name="prop">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.VisualStyles.ColorProperty" /> values that specifies which property value to retrieve for the current visual style element.</param>
       </Docs>
@@ -552,7 +570,6 @@
         <Parameter Name="prop" Type="System.Windows.Forms.VisualStyles.EnumProperty" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -562,6 +579,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified enumerated type property for the current visual style element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The integer value of the property specified by the <paramref name="prop" /> parameter for the current visual style element.</para>
+        </returns>
         <param name="prop">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.VisualStyles.EnumProperty" /> values that specifies which property value to retrieve for the current visual style element.</param>
       </Docs>
@@ -579,7 +600,6 @@
         <Parameter Name="prop" Type="System.Windows.Forms.VisualStyles.FilenameProperty" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -589,6 +609,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified file name property for the current visual style element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that contains the value of the property specified by the <paramref name="prop" /> parameter for the current visual style element.</para>
+        </returns>
         <param name="prop">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.VisualStyles.FilenameProperty" /> values that specifies which property value to retrieve for the current visual style element.</param>
       </Docs>
@@ -607,7 +631,6 @@
         <Parameter Name="prop" Type="System.Windows.Forms.VisualStyles.FontProperty" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -617,6 +640,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified font property for the current visual style element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Font" /> that contains the value of the property specified by the <paramref name="prop" /> parameter for the current visual style element.</para>
+        </returns>
         <param name="dc">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.IDeviceContext" /> this operation will use.</param>
         <param name="prop">
@@ -636,7 +663,6 @@
         <Parameter Name="prop" Type="System.Windows.Forms.VisualStyles.IntegerProperty" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -646,6 +672,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified integer property for the current visual style element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The integer value of the property specified by the <paramref name="prop" /> parameter for the current visual style element.</para>
+        </returns>
         <param name="prop">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.VisualStyles.IntegerProperty" /> values that specifies which property value to retrieve for the current visual style element.</param>
       </Docs>
@@ -664,7 +694,6 @@
         <Parameter Name="prop" Type="System.Windows.Forms.VisualStyles.MarginProperty" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -674,6 +703,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified margins property for the current visual style element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.Padding" /> that contains the value of the property specified by the <paramref name="prop" /> parameter for the current visual style element.</para>
+        </returns>
         <param name="dc">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.IDeviceContext" /> this operation will use.</param>
         <param name="prop">
@@ -694,7 +727,6 @@
         <Parameter Name="type" Type="System.Windows.Forms.VisualStyles.ThemeSizeType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -704,6 +736,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified size property of the current visual style part.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Size" /> that contains the size specified by the <paramref name="type" /> parameter for the current visual style part. </para>
+        </returns>
         <param name="dc">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.IDeviceContext" /> this operation will use.</param>
         <param name="type">
@@ -725,13 +761,16 @@
         <Parameter Name="type" Type="System.Windows.Forms.VisualStyles.ThemeSizeType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified size property of the current visual style part using the specified drawing bounds.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Size" /> that contains the size specified by the <paramref name="type" /> parameter for the current visual style part.</para>
+        </returns>
         <param name="dc">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.IDeviceContext" /> this operation will use.</param>
         <param name="bounds">
@@ -753,7 +792,6 @@
         <Parameter Name="prop" Type="System.Windows.Forms.VisualStyles.PointProperty" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -763,6 +801,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified point property for the current visual style element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Point" /> that contains the value of the property specified by the <paramref name="prop" /> parameter for the current visual style element.</para>
+        </returns>
         <param name="prop">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.VisualStyles.PointProperty" /> values that specifies which property value to retrieve for the current visual style element.</param>
       </Docs>
@@ -780,7 +822,6 @@
         <Parameter Name="prop" Type="System.Windows.Forms.VisualStyles.StringProperty" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -790,6 +831,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified string property for the current visual style element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that contains the value of the property specified by the <paramref name="prop" /> parameter for the current visual style element.</para>
+        </returns>
         <param name="prop">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.VisualStyles.StringProperty" /> values that specifies which property value to retrieve for the current visual style element.</param>
       </Docs>
@@ -809,13 +854,16 @@
         <Parameter Name="flags" Type="System.Windows.Forms.TextFormatFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the size and location of the specified string when drawn with the font of the current visual style element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> that contains the area required to fit the rendered text. </para>
+        </returns>
         <param name="dc">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.IDeviceContext" /> this operation will use.</param>
         <param name="textToDraw">
@@ -840,13 +888,16 @@
         <Parameter Name="flags" Type="System.Windows.Forms.TextFormatFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the size and location of the specified string when drawn with the font of the current visual style element within the specified initial bounding rectangle.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> that contains the area required to fit the rendered text. </para>
+        </returns>
         <param name="dc">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.IDeviceContext" /> this operation will use.</param>
         <param name="bounds">
@@ -870,13 +921,16 @@
         <Parameter Name="dc" Type="System.Drawing.IDeviceContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves information about the font specified by the current visual style element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.VisualStyles.TextMetrics" /> that provides information about the font specified by the current visual style element. </para>
+        </returns>
         <param name="dc">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.IDeviceContext" /> this operation will use.</param>
       </Docs>
@@ -920,13 +974,16 @@
         <Parameter Name="options" Type="System.Windows.Forms.VisualStyles.HitTestOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hit test code indicating whether a point is contained in the background of the current visual style element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.VisualStyles.HitTestCode" /> that describes where <paramref name="pt" /> is located in the background of the current visual style element.</para>
+        </returns>
         <param name="dc">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.IDeviceContext" /> this operation will use.</param>
         <param name="backgroundRectangle">
@@ -954,13 +1011,16 @@
         <Parameter Name="options" Type="System.Windows.Forms.VisualStyles.HitTestOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hit test code indicating whether the point is contained in the background of the current visual style element and within the specified bounds.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.VisualStyles.HitTestCode" /> that describes where <paramref name="pt" /> is located in the background of the current visual style element, if at all.</para>
+        </returns>
         <param name="g">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Graphics" /> this operation will use.</param>
         <param name="backgroundRectangle">
@@ -990,13 +1050,16 @@
         <Parameter Name="options" Type="System.Windows.Forms.VisualStyles.HitTestOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hit test code indicating whether the point is contained in the background of the current visual style element and within the specified region.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.VisualStyles.HitTestCode" /> that describes where <paramref name="pt" /> is located in the background of the current visual style element.</para>
+        </returns>
         <param name="dc">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.IDeviceContext" /> this operation will use.</param>
         <param name="backgroundRectangle">
@@ -1020,13 +1083,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the background of the current visual style element has any semitransparent or alpha-blended pieces.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the background of the current visual style element has any semitransparent or alpha-blended pieces; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1042,7 +1108,6 @@
         <Parameter Name="element" Type="System.Windows.Forms.VisualStyles.VisualStyleElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1052,6 +1117,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified visual style element is defined by the current visual style.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the combination of the <see cref="P:System.Windows.Forms.VisualStyles.VisualStyleElement.ClassName" /> and <see cref="P:System.Windows.Forms.VisualStyles.VisualStyleElement.Part" /> properties of <paramref name="element" /> are defined; otherwise, false. </para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.VisualStyles.VisualStyleElement" /> whose class and part combination will be verified.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/AccessibleObject.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/AccessibleObject.xml
index c483a4bc529..0c3affcb20f 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/AccessibleObject.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/AccessibleObject.xml
@@ -188,7 +188,6 @@
         <Parameter Name="yTop" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following table describes the object types that the <see cref="M:System.Windows.Forms.AccessibleObject.Accessibility#IAccessible#accHitTest(System.Int32,System.Int32)" /> method can return.</para>
@@ -228,6 +227,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the child object at the specified screen coordinates. For a description of this member, see <see cref="M:Accessibility.IAccessible.accHitTest(System.Int32,System.Int32)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The accessible object at the point specified by <paramref name="xLeft" /> and <paramref name="yTop" />. </para>
+        </returns>
         <param name="xLeft">
           <attribution license="cc4" from="Microsoft" modified="false" />The horizontal coordinate.</param>
         <param name="yTop">
@@ -276,7 +279,6 @@
         <Parameter Name="childID" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following table describes the object types that the <see cref="M:System.Windows.Forms.AccessibleObject.Accessibility#IAccessible#accNavigate(System.Int32,System.Object)" /> method can return.</para>
@@ -324,6 +326,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Navigates to an accessible object relative to the current object. For a description of this member, see <see cref="M:Accessibility.IAccessible.accNavigate(System.Int32,System.Object)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The accessible object positioned at the value specified by <paramref name="navDir" />. </para>
+        </returns>
         <param name="navDir">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.AccessibleNavigation" /> enumerations that specifies the direction to navigate. </param>
         <param name="childID">
@@ -860,12 +866,15 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the accessible child corresponding to the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Windows.Forms.AccessibleObject" /> that represents the accessible child corresponding to the specified index.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the accessible child. </param>
       </Docs>
@@ -882,12 +891,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the number of children belonging to an accessible object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of children belonging to an accessible object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -902,7 +914,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The concept of keyboard focus is related to that of an active window. An active window is the foreground window in which the user is working. The object with the keyboard focus is either the active window or a child object of the active window.</para>
@@ -912,6 +923,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the object that has the keyboard focus.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Windows.Forms.AccessibleObject" /> that specifies the currently focused child. This method returns the calling object if the object itself is focused. Returns null if no object has focus.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -946,12 +961,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the currently selected child.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Windows.Forms.AccessibleObject" /> that represents the currently selected child. This method returns the calling object if the object itself is selected. Returns null if is no child is currently selected and the object itself does not have focus.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -988,7 +1006,6 @@
         <Parameter Name="y" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For nonrectangular objects such as list view items, the coordinates of the object's bounding rectangle retrieved by <see cref="P:System.Windows.Forms.AccessibleObject.Bounds" /> can fail if tested with <see cref="M:System.Windows.Forms.AccessibleObject.HitTest(System.Int32,System.Int32)" />, because <see cref="M:System.Windows.Forms.AccessibleObject.HitTest(System.Int32,System.Int32)" /> determines the object's boundaries on a pixel-by-pixel basis.</para>
@@ -997,6 +1014,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the child object at the specified screen coordinates.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Windows.Forms.AccessibleObject" /> that represents the child object at the given screen coordinates. This method returns the calling object if the object itself is at the location specified. Returns null if no object is at the tested location.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The horizontal screen coordinate. </param>
         <param name="y">
@@ -1061,7 +1082,6 @@
         <Parameter Name="navdir" Type="System.Windows.Forms.AccessibleNavigation" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Navigation, both spatial and logical, is always restricted to the user interface elements within a container. With spatial navigation, clients can navigate only to a sibling of the starting object. Depending on the navigational flag used with logical navigation, clients can navigate to either a child or to a sibling of the starting object. This method does not change the selection or focus. To change the focus or to select an object, use <see cref="M:System.Windows.Forms.AccessibleObject.Select(System.Windows.Forms.AccessibleSelection)" />. The <see cref="M:System.Windows.Forms.AccessibleObject.Navigate(System.Windows.Forms.AccessibleNavigation)" /> method retrieves only user interface elements that have a defined screen location.</para>
@@ -1070,6 +1090,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Navigates to another accessible object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Windows.Forms.AccessibleObject" /> that represents one of the <see cref="T:System.Windows.Forms.AccessibleNavigation" /> values.</para>
+        </returns>
         <param name="navdir">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.AccessibleNavigation" /> values. </param>
       </Docs>
@@ -1247,7 +1271,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.AccessibleObject" /> instance is cast to an <see cref="T:System.Reflection.IReflect" /> interface.</para>
@@ -1256,6 +1279,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Reflection.FieldInfo" /> object corresponding to the specified field and binding flag. For a description of this member, see <see cref="M:System.Reflection.IReflect.GetField(System.String,System.Reflection.BindingFlags)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.FieldInfo" /> object containing the field information for the named object that meets the search constraints specified in <paramref name="bindingAttr" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the field to find.</param>
         <param name="bindingAttr">
@@ -1276,7 +1303,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Each field must have a unique name. The <see cref="F:System.Reflection.BindingFlags.NonPublic" /> flag specifies that nonpublic fields are included in the search. The <see cref="F:System.Reflection.BindingFlags.Public" /> flag specifies that public fields are included in the search.</para>
@@ -1286,6 +1312,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of <see cref="T:System.Reflection.FieldInfo" /> objects corresponding to all fields of the current class. For a description of this member, see <see cref="M:System.Reflection.IReflect.GetFields(System.Reflection.BindingFlags)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.FieldInfo" /> objects containing all the field information for this reflection object that meets the search constraints specified in <paramref name="bindingAttr" />.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />The binding attributes used to control the search.</param>
       </Docs>
@@ -1305,7 +1335,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.AccessibleObject" /> instance is cast to an <see cref="T:System.Reflection.IReflect" /> interface.</para>
@@ -1314,6 +1343,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of <see cref="T:System.Reflection.MemberInfo" /> objects corresponding to all public members or to all members that match a specified name. For a description of this member, see <see cref="M:System.Reflection.IReflect.GetMember(System.String,System.Reflection.BindingFlags)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.MemberInfo" /> objects matching the name parameter.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the member to find.</param>
         <param name="bindingAttr">
@@ -1334,7 +1367,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.AccessibleObject" /> instance is cast to an <see cref="T:System.Reflection.IReflect" /> interface.</para>
@@ -1343,6 +1375,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of <see cref="T:System.Reflection.MemberInfo" /> objects corresponding either to all public members or to all members of the current class. For a description of this member, see <see cref="M:System.Reflection.IReflect.GetMembers(System.Reflection.BindingFlags)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.MemberInfo" /> objects containing all the member information for this reflection object.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />The binding attributes used to control the search.</param>
       </Docs>
@@ -1362,7 +1398,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.AccessibleObject" /> instance is cast to an <see cref="T:System.Reflection.IReflect" /> interface.</para>
@@ -1371,6 +1406,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Reflection.MethodInfo" /> object corresponding to a specified method under specified search constraints. For a description of this member, see <see cref="M:System.Reflection.IReflect.GetMethod(System.String,System.Reflection.BindingFlags)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodInfo" /> object containing the method information, with the match being based on the method name and search constraints specified in <paramref name="bindingAttr" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the member to find.</param>
         <param name="bindingAttr">
@@ -1395,7 +1434,6 @@
         <Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is a match based on the method name, the <see cref="T:System.Reflection.BindingFlags" /> enumeration, the kind of type conversion specified by the <paramref name="binder" /> parameter, the overload, and the <see cref="T:System.Reflection.ParameterInfo" /> that describes the signature of the method.</para>
@@ -1405,6 +1443,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Reflection.MethodInfo" /> object corresponding to a specified method, using a Type array to choose from among overloaded methods. For a description of this member, see <see cref="M:System.Reflection.IReflect.GetMethod(System.String,System.Reflection.BindingFlags,System.Reflection.Binder,System.Type[],System.Reflection.ParameterModifier[])" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The requested method that matches all the specified parameters.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the member to find.</param>
         <param name="bindingAttr">
@@ -1431,7 +1473,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.AccessibleObject" /> instance is cast to an <see cref="T:System.Reflection.IReflect" /> interface.</para>
@@ -1440,6 +1481,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of <see cref="T:System.Reflection.MethodInfo" /> objects with all public methods or all methods of the current class. For a description of this member, see <see cref="M:System.Reflection.IReflect.GetMethods(System.Reflection.BindingFlags)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.MethodInfo" /> objects containing all the methods defined for this reflection object that meet the search constraints specified in bindingAttr.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />The binding attributes used to control the search. </param>
       </Docs>
@@ -1458,7 +1503,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.AccessibleObject" /> instance is cast to an <see cref="T:System.Reflection.IReflect" /> interface.</para>
@@ -1467,6 +1511,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of <see cref="T:System.Reflection.PropertyInfo" /> objects corresponding to all public properties or to all properties of the current class. For a description of this member, see <see cref="M:System.Reflection.IReflect.GetProperties(System.Reflection.BindingFlags)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.PropertyInfo" /> objects for all the properties defined on the reflection object.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />The binding attribute used to control the search.</param>
       </Docs>
@@ -1486,7 +1534,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.AccessibleObject" /> instance is cast to an <see cref="T:System.Reflection.IReflect" /> interface.</para>
@@ -1495,6 +1542,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Reflection.PropertyInfo" /> object corresponding to a specified property under specified search constraints. For a description of this member, see <see cref="M:System.Reflection.IReflect.GetProperty(System.String,System.Reflection.BindingFlags)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.PropertyInfo" /> object for the located property that meets the search constraints specified in <paramref name="bindingAttr" />, or null if the property was not located.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the property to find.</param>
         <param name="bindingAttr">
@@ -1520,7 +1571,6 @@
         <Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.AccessibleObject" /> instance is cast to an <see cref="T:System.Reflection.IReflect" /> interface.</para>
@@ -1529,6 +1579,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Reflection.PropertyInfo" /> object corresponding to a specified property with specified search constraints. For a description of this member, see <see cref="M:System.Reflection.IReflect.GetProperty(System.String,System.Reflection.BindingFlags,System.Reflection.Binder,System.Type,System.Type[],System.Reflection.ParameterModifier[])" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.PropertyInfo" /> object for the located property, if a property with the specified name was located in this reflection object, or null if the property was not located.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the member to find.</param>
         <param name="bindingAttr">
@@ -1564,7 +1618,6 @@
         <Parameter Name="namedParameters" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="invokeAttr" /> parameter may be a constructor, method, property, or field. A suitable invocation attribute must be specified. Invoke the default member of a class by passing the empty string ("") as the name of the member.</para>
@@ -1575,6 +1628,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes a specified member. For a description of this member, see <see cref="M:System.Reflection.IReflect.InvokeMember(System.String,System.Reflection.BindingFlags,System.Reflection.Binder,System.Object,System.Object[],System.Reflection.ParameterModifier[],System.Globalization.CultureInfo,System.String[])" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified member.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the member to find.</param>
         <param name="invokeAttr">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Application.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Application.xml
index 080ab314a21..8b02bc4426b 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Application.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Application.xml
@@ -541,7 +541,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this method before calling any Microsoft.Win32 method that requires OLE. <see cref="M:System.Windows.Forms.Application.OleRequired" /> first checks to see if OLE has been initialized on the current thread. If not, it initializes the thread for OLE.</para>
@@ -553,6 +552,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes OLE on the current thread.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Threading.ApartmentState" /> values.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -967,7 +970,6 @@
         <Parameter Name="disableWakeEvent" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If an application does not respond to a suspend request within 20 seconds, Windows determines that it is in a non-responsive state, and that the application can either be put to sleep or terminated. Once an application responds to a suspend request, however, it can take whatever time it needs to clean up resources and shut down active processes.</para>
@@ -976,6 +978,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Suspends or hibernates the system, or requests that the system be suspended or hibernated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the system is being suspended, otherwise, false.</para>
+        </returns>
         <param name="state">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.PowerState" /> indicating the power activity mode to which to transition. </param>
         <param name="force">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/AutoCompleteStringCollection.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/AutoCompleteStringCollection.xml
index 676a0890f76..e0806a0b884 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/AutoCompleteStringCollection.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/AutoCompleteStringCollection.xml
@@ -48,13 +48,16 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts a new <see cref="T:System.String" /> into the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position in the collection where the <see cref="T:System.String" /> was added.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> to add to the collection.</param>
       </Docs>
@@ -132,13 +135,16 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the <see cref="T:System.String" /> exists within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.String" /> exists within the collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> for which to search.</param>
       </Docs>
@@ -199,13 +205,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the <see cref="T:System.Windows.Forms.AutoCompleteStringCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator that iterates through the collection.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -221,7 +230,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -231,6 +239,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains the position of the specified string within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index for the specified item.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> for which to search.</param>
       </Docs>
@@ -451,7 +463,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.AutoCompleteStringCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -460,6 +471,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a string to the collection. For a description of this member, see <see cref="M:System.Collections.IList.Add(System.Object)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the <paramref name="value" /> has been added. </para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to be added to the collection</param>
       </Docs>
@@ -477,7 +492,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.AutoCompleteStringCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -486,6 +500,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines where the collection contains a specified string. For a description of this member, see <see cref="M:System.Collections.IList.Contains(System.Object)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is found in the collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to locate in the collection.</param>
       </Docs>
@@ -503,7 +521,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.AutoCompleteStringCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -512,6 +529,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of a specified string in the collection. For a description of this member, see <see cref="M:System.Collections.IList.IndexOf(System.Object)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of <paramref name="value" /> if found in the list; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to locate in the collection.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/AxHost.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/AxHost.xml
index abdd745c85f..d9b3b648a39 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/AxHost.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/AxHost.xml
@@ -524,12 +524,15 @@
         <Parameter Name="clsid" Type="System.Guid" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called by the system to create the ActiveX control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> representing the ActiveX control. </para>
+        </returns>
         <param name="clsid">
           <attribution license="cc4" from="Microsoft" modified="false" />The CLSID of the ActiveX control.</param>
       </Docs>
@@ -1148,12 +1151,15 @@
         <Parameter Name="color" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Drawing.Color" /> structure that corresponds to the specified OLE color value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Color" /> structure that represents the translated OLE color value.</para>
+        </returns>
         <param name="color">
           <attribution license="cc4" from="Microsoft" modified="false" />The OLE color value to translate.</param>
       </Docs>
@@ -1180,12 +1186,15 @@
         <Parameter Name="font" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Drawing.Font" /> created from the specified OLE <see cref="http://go.microsoft.com/fwlink/?LinkId=166075">IFont</see> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Font" /> created from the specified <see cref="http://go.microsoft.com/fwlink/?LinkId=166075">IFont</see>, <see cref="P:System.Windows.Forms.Control.DefaultFont" /> if the font could not be created, or null if <paramref name="font" /> is null.</para>
+        </returns>
         <param name="font">
           <attribution license="cc4" from="Microsoft" modified="false" />The IFont to create a <see cref="T:System.Drawing.Font" /> from.</param>
       </Docs>
@@ -1209,12 +1218,15 @@
         <Parameter Name="font" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Drawing.Font" /> created from the specified OLE <see cref="http://go.microsoft.com/fwlink/?LinkId=166073">IFontDisp</see> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Font" /> created from the specified <see cref="http://go.microsoft.com/fwlink/?LinkId=166073">IFontDisp</see>, <see cref="P:System.Windows.Forms.Control.DefaultFont" /> if the font could not be created, or null if <paramref name="font" /> is null.</para>
+        </returns>
         <param name="font">
           <attribution license="cc4" from="Microsoft" modified="false" />The IFontDisp to create a <see cref="T:System.Drawing.Font" /> from.</param>
       </Docs>
@@ -1238,12 +1250,15 @@
         <Parameter Name="font" Type="System.Drawing.Font" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an OLE <see cref="http://go.microsoft.com/fwlink/?LinkId=166073">IFontDisp</see> object created from the specified <see cref="T:System.Drawing.Font" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="http://go.microsoft.com/fwlink/?LinkId=166073">IFontDisp</see> object created from the specified font or null if <paramref name="font" /> is null.</para>
+        </returns>
         <param name="font">
           <attribution license="cc4" from="Microsoft" modified="false" />The font to create an IFontDisp object from.</param>
       </Docs>
@@ -1267,12 +1282,15 @@
         <Parameter Name="font" Type="System.Drawing.Font" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an OLE <see cref="http://go.microsoft.com/fwlink/?LinkId=166075">IFont</see> object created from the specified <see cref="T:System.Drawing.Font" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="http://go.microsoft.com/fwlink/?LinkId=166075">IFont</see> object created from the specified font, or null if <paramref name="font" /> is null or the <see cref="http://go.microsoft.com/fwlink/?LinkId=166075">IFont</see> could not be created.</para>
+        </returns>
         <param name="font">
           <attribution license="cc4" from="Microsoft" modified="false" />The font to create an IFont object from.</param>
       </Docs>
@@ -1296,12 +1314,15 @@
         <Parameter Name="image" Type="System.Drawing.Image" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an OLE IPictureDisp object corresponding to the specified <see cref="T:System.Drawing.Image" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> representing the OLE IPictureDisp object.</para>
+        </returns>
         <param name="image">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Image" /> to convert.</param>
       </Docs>
@@ -1325,12 +1346,15 @@
         <Parameter Name="cursor" Type="System.Windows.Forms.Cursor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an OLE IPicture object corresponding to the specified <see cref="T:System.Windows.Forms.Cursor" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> representing the OLE IPicture object.</para>
+        </returns>
         <param name="cursor">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.Windows.Forms.Cursor" />
@@ -1356,12 +1380,15 @@
         <Parameter Name="image" Type="System.Drawing.Image" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an OLE IPicture object corresponding to the specified <see cref="T:System.Drawing.Image" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> representing the OLE IPicture object.</para>
+        </returns>
         <param name="image">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Image" /> to convert.</param>
       </Docs>
@@ -1385,7 +1412,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An OLE Automation date is implemented as a floating-point number whose value is the number of days from midnight, 30 December 1899. For example, midnight, 31 December 1899 is represented by 1.0; 6 A.M., 1 January 1900 is represented by 2.25; midnight, 29 December 1899 is represented by -1.0; and 6 A.M., 29 December 1899 is represented by -1.25.</para>
@@ -1396,6 +1422,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an OLE Automation date that corresponds to the specified <see cref="T:System.DateTime" /> structure. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A double-precision floating-point number that contains an OLE Automation date equivalent to specified <paramref name="time" /> value.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> structure to translate.</param>
       </Docs>
@@ -1417,12 +1447,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a reference to the underlying ActiveX control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the ActiveX control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1444,12 +1477,15 @@
         <Parameter Name="color" Type="System.Drawing.Color" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an OLE color value that corresponds to the specified <see cref="T:System.Drawing.Color" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The OLE color value that represents the translated <see cref="T:System.Drawing.Color" /> structure.</para>
+        </returns>
         <param name="color">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Color" /> structure to translate.</param>
       </Docs>
@@ -1476,7 +1512,6 @@
         <Parameter Name="picture" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use this method to convert IPictureDisp objects in addition to IPicture objects. This works because the IPictureDisp OLE interface is a subset of the IPicture interface. Converting IPictureDisp objects with this method is necessary because the <see cref="M:System.Windows.Forms.AxHost.GetPictureFromIPictureDisp(System.Object)" /> does not work correctly at this time.</para>
@@ -1485,6 +1520,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Drawing.Image" /> corresponding to the specified OLE IPicture object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Drawing.Image" /> representing the IPicture. </para>
+        </returns>
         <param name="picture">
           <attribution license="cc4" from="Microsoft" modified="false" />The IPicture to convert.</param>
       </Docs>
@@ -1508,7 +1547,6 @@
         <Parameter Name="picture" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method does not work correctly. You can use the <see cref="M:System.Windows.Forms.AxHost.GetPictureFromIPicture(System.Object)" /> method to convert an IPictureDisp object into an <see cref="T:System.Drawing.Image" />, however, because the IPictureDisp OLE interface is a subset of the IPicture interface. </para>
@@ -1517,6 +1555,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Drawing.Image" /> corresponding to the specified OLE IPictureDisp object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Drawing.Image" /> representing the IPictureDisp. </para>
+        </returns>
         <param name="picture">
           <attribution license="cc4" from="Microsoft" modified="false" />The IPictureDisp to convert.</param>
       </Docs>
@@ -1550,7 +1592,6 @@
         <Parameter Name="specified" Type="System.Windows.Forms.BoundsSpecified" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>ActiveX controls scale themselves, so this method does not perform any special calculations, ignores the <paramref name="factor" /> and <paramref name="specified" /> values, and returns the <paramref name="bounds" /> value unchanged. </para>
@@ -1559,6 +1600,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called by the system to retrieve the current bounds of the ActiveX control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The unmodified <paramref name="bounds" /> value.</para>
+        </returns>
         <param name="bounds">
           <attribution license="cc4" from="Microsoft" modified="false" />The original bounds of the ActiveX control.</param>
         <param name="factor">
@@ -1577,7 +1622,6 @@
         <Parameter Name="date" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="date" /> parameter is a double-precision floating-point number that represents a date as the number of days before or after the base date, midnight, 30 December 1899. The sign and integral part of <paramref name="date" /> encode the date as a positive or negative day displacement from 30 December 1899, and the absolute value of the fractional part of <paramref name="date" /> encodes the time of day as a fraction of a day displacement from midnight. <paramref name="date" /> must be a value between negative 657435.0 through positive 2958466.0.</para>
@@ -1588,6 +1632,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> structure that corresponds to the specified OLE Automation date.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DateTime" /> that represents the same date and time as <paramref name="date" />.</para>
+        </returns>
         <param name="date">
           <attribution license="cc4" from="Microsoft" modified="false" />The OLE Automate date to translate.</param>
       </Docs>
@@ -1671,7 +1719,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Property pages allow an ActiveX control user to view and change ActiveX control properties. These properties are accessed by invoking a control properties dialog box, which contains one or more property pages that provide a customized, graphical interface for viewing and editing the control properties.</para>
@@ -1680,6 +1727,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the ActiveX control has a property page.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the ActiveX control has a property page; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1808,7 +1859,6 @@
         <Parameter Name="charCode" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.AxHost.IsInputChar(System.Char)" /> method is called during window message preprocessing to determine whether the given input character should be preprocessed or sent directly to the ActiveX control. The preprocessing of a character includes checking whether the character is a mnemonic of another control.</para>
@@ -1818,6 +1868,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if a character is an input character that the ActiveX control recognizes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character should be sent directly to the ActiveX control and not preprocessed; otherwise, false.</para>
+        </returns>
         <param name="charCode">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to test. </param>
       </Docs>
@@ -2476,12 +2530,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the hosted control is in a state in which its properties can be accessed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the properties of the hosted control can be accessed; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -3144,12 +3201,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of type <see cref="T:System.Attribute" /> for the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.AttributeCollection" /> with the attributes for the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetClassName">
@@ -3169,7 +3229,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the type name instead of the value that the <see cref="M:System.Windows.Forms.AxHost.System#ComponentModel#ICustomTypeDescriptor#GetClassName" /> method returns.</para>
@@ -3178,6 +3237,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the class name of the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns null in all cases.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetComponentName">
@@ -3197,7 +3260,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the default name instead of the value that the <see cref="M:System.Windows.Forms.AxHost.System#ComponentModel#ICustomTypeDescriptor#GetComponentName" /> method returns.</para>
@@ -3206,6 +3268,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns null in all cases.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetConverter">
@@ -3225,7 +3291,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the default type converter instead of the value that the <see cref="M:System.Windows.Forms.AxHost.System#ComponentModel#ICustomTypeDescriptor#GetConverter" /> method returns.</para>
@@ -3234,6 +3299,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a type converter for the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns null in all cases.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetDefaultEvent">
@@ -3253,12 +3322,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the default event for the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptor" /> that represents the default event for the current object, or null if the object does not have events.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetDefaultProperty">
@@ -3278,12 +3350,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the default property for the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptor" /> that represents the default property for the current object, or null if the object does not have properties.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetEditor">
@@ -3305,12 +3380,15 @@
         <Parameter Name="editorBaseType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an editor of the specified type for the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object of the specified type that is the editor for the current object, or null if the editor cannot be found.</para>
+        </returns>
         <param name="editorBaseType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents the editor for the current object.</param>
       </Docs>
@@ -3332,12 +3410,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the events for the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptorCollection" /> that represents the events for the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetEvents">
@@ -3359,12 +3440,15 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the events for the current object using the specified attribute array as a filter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptorCollection" /> that represents the events for the <see cref="T:System.Windows.Forms.AxHost" /> that match the given set of attributes.</para>
+        </returns>
         <param name="attributes">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Attribute" /> that is used as a filter.</param>
       </Docs>
@@ -3386,12 +3470,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the properties for the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that represents the events for the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetProperties">
@@ -3413,12 +3500,15 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the properties for the current object using the specified attribute array as a filter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that represents the events for the current <see cref="T:System.Windows.Forms.AxHost" /> that match the given set of attributes.</para>
+        </returns>
         <param name="attributes">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Attribute" /> that is used as a filter.</param>
       </Docs>
@@ -3442,12 +3532,15 @@
         <Parameter Name="pd" Type="System.ComponentModel.PropertyDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the object that owns the specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current object.</para>
+        </returns>
         <param name="pd">
           <attribution license="cc4" from="Microsoft" modified="false" />Not used.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/BaseCollection.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/BaseCollection.xml
index 6a6c2fd0967..6ff8430e439 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/BaseCollection.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/BaseCollection.xml
@@ -118,12 +118,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the object that enables iterating through the members of the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that implements the <see cref="T:System.Collections.IEnumerator" /> interface.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/BindingContext.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/BindingContext.xml
index 01613b742b6..8471f397a74 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/BindingContext.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/BindingContext.xml
@@ -233,7 +233,6 @@ this-&gt;BindingContext-&gt;get_Item(dataSet1-&gt;Customers)-&gt;Position = 1;
         <Parameter Name="dataSource" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="T:System.Windows.Forms.Binding" /> class for a list of possible data sources and information about creating bindings between controls and data sources.</para>
@@ -243,6 +242,10 @@ this-&gt;BindingContext-&gt;get_Item(dataSet1-&gt;Customers)-&gt;Position = 1;
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the <see cref="T:System.Windows.Forms.BindingContext" /> contains the <see cref="T:System.Windows.Forms.BindingManagerBase" /> associated with the specified data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Windows.Forms.BindingContext" /> contains the specified <see cref="T:System.Windows.Forms.BindingManagerBase" />; otherwise, false.</para>
+        </returns>
         <param name="dataSource">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Object" /> that represents the data source. </param>
       </Docs>
@@ -262,7 +265,6 @@ this-&gt;BindingContext-&gt;get_Item(dataSet1-&gt;Customers)-&gt;Position = 1;
         <Parameter Name="dataMember" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="T:System.Windows.Forms.Binding" /> class for a list of possible data sources and for information about creating bindings between controls and data sources.</para>
@@ -272,6 +274,10 @@ this-&gt;BindingContext-&gt;get_Item(dataSet1-&gt;Customers)-&gt;Position = 1;
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the <see cref="T:System.Windows.Forms.BindingContext" /> contains the <see cref="T:System.Windows.Forms.BindingManagerBase" /> associated with the specified data source and data member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Windows.Forms.BindingContext" /> contains the specified <see cref="T:System.Windows.Forms.BindingManagerBase" />; otherwise, false.</para>
+        </returns>
         <param name="dataSource">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Object" /> that represents the data source. </param>
         <param name="dataMember">
@@ -517,7 +523,6 @@ this-&gt;BindingContext-&gt;get_Item(dataSet1-&gt;Customers)-&gt;Position = 1;
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Collections.IEnumerator" /> returned by the <see cref="M:System.Windows.Forms.BindingContext.System#Collections#IEnumerable#GetEnumerator" /> method allows you to iterate over the collection managed by the <see cref="T:System.Windows.Forms.BindingContext" />.</para>
@@ -526,6 +531,10 @@ this-&gt;BindingContext-&gt;get_Item(dataSet1-&gt;Customers)-&gt;Position = 1;
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an enumerator for the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="UpdateBinding">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/BindingManagerBase.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/BindingManagerBase.xml
index b6136cbd230..77409d767e6 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/BindingManagerBase.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/BindingManagerBase.xml
@@ -291,12 +291,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, gets the collection of property descriptors for the binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that represents the property descriptors for the binding.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -318,7 +321,6 @@
         <Parameter Name="listAccessors" Type="System.Collections.ArrayList" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is used by developers creating data-bound controls.</para>
@@ -327,6 +329,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the collection of property descriptors for the binding using the specified <see cref="T:System.Collections.ArrayList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that represents the property descriptors for the binding.</para>
+        </returns>
         <param name="dataSources">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.ArrayList" /> containing the data sources. </param>
         <param name="listAccessors">
@@ -346,7 +352,6 @@
         <Parameter Name="listAccessors" Type="System.Collections.ArrayList" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload is used by developers to create data-bound controls.</para>
@@ -355,6 +360,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the list of properties of the items managed by this <see cref="T:System.Windows.Forms.BindingManagerBase" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that represents the property descriptors for the binding.</para>
+        </returns>
         <param name="listType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the bound list. </param>
         <param name="offset">
@@ -383,12 +392,15 @@
         <Parameter Name="listAccessors" Type="System.Collections.ArrayList" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, gets the name of the list supplying the data for the binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the list supplying the data for the binding.</para>
+        </returns>
         <param name="listAccessors">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.ArrayList" /> containing the table's bound properties. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/BindingMemberInfo.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/BindingMemberInfo.xml
index 5ca6e7e86f5..d7ef974fe68 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/BindingMemberInfo.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/BindingMemberInfo.xml
@@ -122,7 +122,6 @@
         <Parameter Name="otherObject" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Windows.Forms.BindingMemberInfo.BindingMember" /> strings are compared with a culture setting of <see cref="P:System.Globalization.CultureInfo.InvariantCulture" />.</para>
@@ -131,6 +130,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified object is equal to this <see cref="T:System.Windows.Forms.BindingMemberInfo" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="otherObject" /> is a <see cref="T:System.Windows.Forms.BindingMemberInfo" /> and both <see cref="P:System.Windows.Forms.BindingMemberInfo.BindingMember" /> strings are equal; otherwise false.</para>
+        </returns>
         <param name="otherObject">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare for equality.</param>
       </Docs>
@@ -147,12 +150,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this <see cref="T:System.Windows.Forms.BindingMemberInfo" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for this <see cref="T:System.Windows.Forms.BindingMemberInfo" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -173,12 +179,15 @@
         <Parameter Name="b" Type="System.Windows.Forms.BindingMemberInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two <see cref="T:System.Windows.Forms.BindingMemberInfo" /> objects are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="P:System.Windows.Forms.BindingMemberInfo.BindingMember" /> strings for <paramref name="a" /> and <paramref name="b" /> are equal; otherwise false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Windows.Forms.BindingMemberInfo" /> to compare for equality.</param>
         <param name="b">
@@ -199,12 +208,15 @@
         <Parameter Name="b" Type="System.Windows.Forms.BindingMemberInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two <see cref="T:System.Windows.Forms.BindingMemberInfo" /> objects are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="P:System.Windows.Forms.BindingMemberInfo.BindingMember" /> strings for <paramref name="a" /> and <paramref name="b" /> are not equal; otherwise false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Windows.Forms.BindingMemberInfo" /> to compare for inequality.</param>
         <param name="b">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/BindingNavigator.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/BindingNavigator.xml
index 5f70f0b5013..e2ab8c7cab4 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/BindingNavigator.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/BindingNavigator.xml
@@ -754,7 +754,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to confirm focus can shift before performing the click action for an item on the <see cref="T:System.Windows.Forms.BindingNavigator" /> control.</para>
@@ -763,6 +762,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Causes form validation to occur and returns whether validation was successful.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if validation was successful and focus can shift to the <see cref="T:System.Windows.Forms.BindingNavigator" />; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/BindingSource.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/BindingSource.xml
index e8789818339..d5bea7b36b3 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/BindingSource.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/BindingSource.xml
@@ -208,7 +208,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.BindingSource.Add(System.Object)" /> method refers the call to the underlying list's Add method.</para>
@@ -219,6 +218,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an existing item to the internal list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index at which <paramref name="value" /> was added to the underlying list represented by the <see cref="P:System.Windows.Forms.BindingSource.List" /> property. </para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Object" /> to be added to the internal list.</param>
       </Docs>
@@ -255,7 +258,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.BindingSource.AddNew" /> method adds a new item to the underlying list represented by the <see cref="P:System.Windows.Forms.BindingSource.List" /> property. This method sets up the following series of actions:</para>
@@ -277,6 +279,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new item to the underlying list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> that was created and added to the list.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="AllowEdit">
@@ -518,7 +524,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Although the implementation is dependent on the underlying list's Contains method, typically the following characteristics apply:</para>
@@ -539,6 +544,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether an object is an item in the list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="value" /> parameter is found in the <see cref="P:System.Windows.Forms.BindingSource.List" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the underlying list represented by the <see cref="P:System.Windows.Forms.BindingSource.List" /> property. The value can be null. </param>
       </Docs>
@@ -998,7 +1007,6 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is typically used in complex data-binding cases to locate the first row where the value of the field specified by the <paramref name="prop" /> parameter equals the value of the <paramref name="key" /> parameter</para>
@@ -1008,6 +1016,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the index of the item that has the given property descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the item that has the given value for <see cref="T:System.ComponentModel.PropertyDescriptor" />.</para>
+        </returns>
         <param name="prop">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.PropertyDescriptor" /> to search for. </param>
         <param name="key">
@@ -1028,7 +1040,6 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.BindingSource.Find(System.String,System.Object)" /> method can only be used when the underlying list is an <see cref="T:System.ComponentModel.IBindingList" /> with searching implemented. This method simply refers the request to the underlying list's <see cref="M:System.ComponentModel.IBindingList.Find(System.ComponentModel.PropertyDescriptor,System.Object)" /> method. For example, if the underlying data source is a <see cref="T:System.Data.DataSet" />, <see cref="T:System.Data.DataTable" />, or <see cref="T:System.Data.DataView" />, this method converts <paramref name="propertyName" /> to a <see cref="T:System.ComponentModel.PropertyDescriptor" /> and calls the <see cref="M:System.Data.DataView.System#ComponentModel#IBindingList#Find(System.ComponentModel.PropertyDescriptor,System.Object)" /> method. The behavior of <see cref="M:System.Windows.Forms.BindingSource.Find(System.ComponentModel.PropertyDescriptor,System.Object)" />, such as the value returned if no matching item is found, depends on the implementation of the method in the underlying list.</para>
@@ -1038,6 +1049,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the item in the list with the specified property name and value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the item with the specified property name and value. </para>
+        </returns>
         <param name="propertyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the property to search for.</param>
         <param name="key">
@@ -1055,12 +1070,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an enumerator for the <see cref="P:System.Windows.Forms.BindingSource.List" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="P:System.Windows.Forms.BindingSource.List" />. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetItemProperties">
@@ -1076,12 +1094,15 @@
         <Parameter Name="listAccessors" Type="System.ComponentModel.PropertyDescriptor[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of <see cref="T:System.ComponentModel.PropertyDescriptor" /> objects representing the bindable properties of the data source list type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.ComponentModel.PropertyDescriptor" /> objects that represents the properties on this list type used to bind data.</para>
+        </returns>
         <param name="listAccessors">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.ComponentModel.PropertyDescriptor" /> objects to find in the list as bindable.</param>
       </Docs>
@@ -1099,12 +1120,15 @@
         <Parameter Name="listAccessors" Type="System.ComponentModel.PropertyDescriptor[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the name of the list supplying data for the binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the list supplying the data for binding.</para>
+        </returns>
         <param name="listAccessors">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.ComponentModel.PropertyDescriptor" /> objects to find in the list as bindable.</param>
       </Docs>
@@ -1122,7 +1146,6 @@
         <Parameter Name="dataMember" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="dataMember" /> is null or an empty string (""), <see cref="M:System.Windows.Forms.BindingSource.GetRelatedCurrencyManager(System.String)" /> returns the main currency manager; otherwise, it checks for another <see cref="T:System.Windows.Forms.BindingSource" /> bound to the specified data member and returns its currency manager.</para>
@@ -1131,6 +1154,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the related currency manager for the specified data member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The related <see cref="T:System.Windows.Forms.CurrencyManager" /> for the specified data member.</para>
+        </returns>
         <param name="dataMember">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of column or list, within the data source to retrieve the currency manager for.</param>
       </Docs>
@@ -1148,7 +1175,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Although the implementation is dependent on the underlying list's IndexOf method, typically the following characteristics apply:</para>
@@ -1168,6 +1194,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified object and returns the index of the first occurrence within the entire list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of the <paramref name="value" /> parameter; otherwise, -1 if <paramref name="value" /> is not in the list.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the underlying list represented by the <see cref="P:System.Windows.Forms.BindingSource.List" /> property. The value can be null. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/BindingsCollection.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/BindingsCollection.xml
index e5b6590dc89..9b896469cf1 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/BindingsCollection.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/BindingsCollection.xml
@@ -347,12 +347,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the collection should be serialized.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection count is greater than zero; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Button.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Button.xml
index b160806fa9b..0767d36051c 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Button.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Button.xml
@@ -386,7 +386,6 @@
         <Parameter Name="charCode" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overriding <see cref="M:System.Windows.Forms.Button.ProcessMnemonic(System.Char)" /> in a derived class, be sure to call the base class's <see cref="M:System.Windows.Forms.Button.ProcessMnemonic(System.Char)" /> to ensure that basic functionality remains unchanged.</para>
@@ -395,6 +394,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a mnemonic character. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the mnemonic was processed; otherwise, false.</para>
+        </returns>
         <param name="charCode">
           <attribution license="cc4" from="Microsoft" modified="false" />The mnemonic character entered. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ButtonBase.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ButtonBase.xml
index 10156cbe1a2..b34ad89aaec 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ButtonBase.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ButtonBase.xml
@@ -321,7 +321,6 @@
         <Parameter Name="proposedSize" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The behavior of <see cref="M:System.Windows.Forms.ButtonBase.GetPreferredSize(System.Drawing.Size)" /> differs by control. The <see cref="P:System.Windows.Forms.Control.LayoutEngine" /> might be unable to assign the returned size to the control. You can return a size larger than the constraints indicated in the <paramref name="proposedSize" /> parameter, but <paramref name="proposedSize" /> should decrease as the constraint decreases. For example, GetPreferredSize(new Size(100, 0)) should not be wider than GetPreferredSize(new Size(200, 0)). The exception is a <paramref name="proposedSize" /> of 0 or Size.Empty, which are defined as unconstrained.</para>
@@ -330,6 +329,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the size of a rectangular area into which a control can be fitted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An ordered pair of type <see cref="T:System.Drawing.Size" /> representing the width and height of a rectangle.</para>
+        </returns>
         <param name="proposedSize">
           <attribution license="cc4" from="Microsoft" modified="false" />The custom-sized area for a control.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ButtonRenderer.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ButtonRenderer.xml
index de7c307cc16..fb361072969 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ButtonRenderer.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ButtonRenderer.xml
@@ -352,13 +352,16 @@
         <Parameter Name="state" Type="System.Windows.Forms.VisualStyles.PushButtonState" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the background of the button has semitransparent or alpha-blended pieces.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the background of the button has semitransparent or alpha-blended pieces; otherwise, false.</para>
+        </returns>
         <param name="state">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.VisualStyles.PushButtonState" /> values that specifies the visual state of the button.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/CheckBox.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/CheckBox.xml
index 01409f5650f..dd5c9b6541f 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/CheckBox.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/CheckBox.xml
@@ -348,7 +348,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you do not explicitly call the <see cref="M:System.Windows.Forms.CheckBox.CreateAccessibilityInstance" /> method, it will be called when the <see cref="P:System.Windows.Forms.Control.AccessibilityObject" /> property is referenced.</para>
@@ -360,6 +359,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessibility object for the <see cref="T:System.Windows.Forms.CheckBox" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.CheckBox.CheckBoxAccessibleObject" /> for the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -639,7 +642,6 @@
         <Parameter Name="charCode" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called to give a control the opportunity to process a mnemonic character. The method should determine whether the control is in a state to process mnemonics and if whether the given character represents a mnemonic. If so, the method should perform the action associated with the mnemonic and return true. If not, the method should return false. Implementations of this method often use the <see cref="M:System.Windows.Forms.Control.IsMnemonic(System.Char,System.String)" /> method to determine whether the given character matches a mnemonic in the control's text.</para>
@@ -653,6 +655,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a mnemonic character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character was processed as a mnemonic by the control; otherwise, false.</para>
+        </returns>
         <param name="charCode">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to process.</param>
       </Docs>
@@ -723,12 +729,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Windows.Forms.CheckBox" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that states the control type and the state of the <see cref="P:System.Windows.Forms.CheckBox.CheckState" /> property.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/CheckBoxRenderer.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/CheckBoxRenderer.xml
index f502ec4948d..bf3ba8be866 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/CheckBoxRenderer.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/CheckBoxRenderer.xml
@@ -289,7 +289,6 @@
         <Parameter Name="state" Type="System.Windows.Forms.VisualStyles.CheckBoxState" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -299,6 +298,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the size of the check box glyph.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Size" /> that represents the size of the check box glyph.</para>
+        </returns>
         <param name="g">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Graphics" /> this operation will use.</param>
         <param name="state">
@@ -318,13 +321,16 @@
         <Parameter Name="state" Type="System.Windows.Forms.VisualStyles.CheckBoxState" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the background of the check box has semitransparent or alpha-blended pieces.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the background of the check box has semitransparent or alpha-blended pieces; otherwise, false.</para>
+        </returns>
         <param name="state">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.VisualStyles.CheckBoxState" /> values that specifies the visual state of the check box.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/CheckedListBox.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/CheckedListBox.xml
index 263690be68a..05f101ecdaa 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/CheckedListBox.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/CheckedListBox.xml
@@ -363,7 +363,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you do not explicitly call the <see cref="M:System.Windows.Forms.CheckedListBox.CreateAccessibilityInstance" /> method, it will be called when the <see cref="P:System.Windows.Forms.Control.AccessibilityObject" /> property is referenced.</para>
@@ -375,6 +374,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessibility object for the <see cref="T:System.Windows.Forms.CheckedListBox" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.AccessibleObject" /> for the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -603,7 +606,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -613,6 +615,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified item is checked.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the item is checked; otherwise, false.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the item. </param>
       </Docs>
@@ -631,7 +637,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.CheckedListBox.GetItemCheckState(System.Int32)" /> method provides the ability to get the <see cref="T:System.Windows.Forms.CheckState" /> value of an item, given the index. If you never set the check state of an item to Indeterminate, then use the <see cref="M:System.Windows.Forms.CheckedListBox.GetItemChecked(System.Int32)" /> method.</para>
@@ -640,6 +645,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating the check state of the current item.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.CheckState" /> values.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the item to get the checked value of. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Clipboard.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Clipboard.xml
index 15b53fcd680..45701a57e9c 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Clipboard.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Clipboard.xml
@@ -68,7 +68,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to determine whether the Clipboard contains audio data before retrieving it with the <see cref="M:System.Windows.Forms.Clipboard.GetAudioStream" /> method.</para>
@@ -80,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether there is data on the Clipboard in the <see cref="F:System.Windows.Forms.DataFormats.WaveAudio" /> format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there is audio data on the Clipboard; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ContainsData">
@@ -95,7 +98,6 @@
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Windows.Forms.DataFormats" /> class contains pre-defined format names that you can use with this method.</para>
@@ -109,6 +111,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether there is data on the Clipboard that is in the specified format or can be converted to that format. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there is data on the Clipboard that is in the specified <paramref name="format" /> or can be converted to that format; otherwise, false.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />The format of the data to look for. See <see cref="T:System.Windows.Forms.DataFormats" /> for predefined formats.</param>
       </Docs>
@@ -124,7 +130,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A file drop list is a collection of strings containing path information for files.</para>
@@ -137,6 +142,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether there is data on the Clipboard that is in the <see cref="F:System.Windows.Forms.DataFormats.FileDrop" /> format or can be converted to that format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there is a file drop list on the Clipboard; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ContainsImage">
@@ -150,7 +159,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to determine whether the Clipboard contains image data before retrieving it with the <see cref="M:System.Windows.Forms.Clipboard.GetImage" /> method.</para>
@@ -162,6 +170,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether there is data on the Clipboard that is in the <see cref="F:System.Windows.Forms.DataFormats.Bitmap" /> format or can be converted to that format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there is image data on the Clipboard; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ContainsText">
@@ -175,7 +187,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method checks for the presence of data in the <see cref="F:System.Windows.Forms.TextDataFormat.UnicodeText" /> format on WinXpFamily and Win2kFamily. Otherwise, this method checks for the presence of data in the <see cref="F:System.Windows.Forms.TextDataFormat.Text" /> format.</para>
@@ -188,6 +199,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether there is data on the Clipboard in the <see cref="F:System.Windows.Forms.TextDataFormat.Text" /> or <see cref="F:System.Windows.Forms.TextDataFormat.UnicodeText" /> format, depending on the operating system.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there is text data on the Clipboard; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ContainsText">
@@ -203,7 +218,6 @@
         <Parameter Name="format" Type="System.Windows.Forms.TextDataFormat" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to determine whether the Clipboard contains text data before retrieving it with the <see cref="Overload:System.Windows.Forms.Clipboard.GetText" /> method.</para>
@@ -215,6 +229,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether there is text data on the Clipboard in the format indicated by the specified <see cref="T:System.Windows.Forms.TextDataFormat" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there is text data on the Clipboard in the value specified for <paramref name="format" />; otherwise, false.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.TextDataFormat" /> values.</param>
       </Docs>
@@ -230,7 +248,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Windows.Forms.Clipboard.ContainsAudio" /> method to determine whether the Clipboard contains audio data before retrieving it with this method.</para>
@@ -243,6 +260,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an audio stream from the Clipboard.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> containing audio data or null if the Clipboard does not contain any data in the <see cref="F:System.Windows.Forms.DataFormats.WaveAudio" /> format.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetData">
@@ -258,7 +279,6 @@
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Windows.Forms.Clipboard.ContainsData(System.String)" /> method to determine whether the Clipboard contains data in the specified format or a compatible format before retrieving it with this method.</para>
@@ -273,6 +293,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves data from the Clipboard in the specified format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> representing the Clipboard data or null if the Clipboard does not contain any data that is in the specified <paramref name="format" /> or can be converted to that format.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />The format of the data to retrieve. See <see cref="T:System.Windows.Forms.DataFormats" /> for predefined formats.</param>
       </Docs>
@@ -285,7 +309,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Because the data type of the object returned from the Clipboard can vary, this method returns the data in an <see cref="T:System.Windows.Forms.IDataObject" />. Then you can use methods of the <see cref="T:System.Windows.Forms.IDataObject" /> interface to extract the data in its proper data type.</para>
@@ -298,6 +321,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the data that is currently on the system Clipboard.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Windows.Forms.IDataObject" /> that represents the data currently on the Clipboard, or null if there is no data on the Clipboard.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -315,7 +342,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A file drop list is a collection of strings containing path information for files.</para>
@@ -330,6 +356,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection of file names from the Clipboard. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.Specialized.StringCollection" /> containing file names or null if the Clipboard does not contain any data that is in the <see cref="F:System.Windows.Forms.DataFormats.FileDrop" /> format or can be converted to that format.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetImage">
@@ -343,7 +373,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Windows.Forms.Clipboard.ContainsImage" /> method to determine whether the Clipboard contains image data before retrieving it with this method.</para>
@@ -356,6 +385,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an image from the Clipboard.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Drawing.Image" /> representing the Clipboard image data or null if the Clipboard does not contain any data that is in the <see cref="F:System.Windows.Forms.DataFormats.Bitmap" /> format or can be converted to that format.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetText">
@@ -369,7 +402,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns text data in the <see cref="F:System.Windows.Forms.TextDataFormat.UnicodeText" /> format on WinXpFamily and Win2kFamily. Otherwise, this method returns text data in the <see cref="F:System.Windows.Forms.TextDataFormat.Text" /> format.</para>
@@ -383,6 +415,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves text data from the Clipboard in the <see cref="F:System.Windows.Forms.TextDataFormat.Text" /> or <see cref="F:System.Windows.Forms.TextDataFormat.UnicodeText" /> format, depending on the operating system.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The Clipboard text data or <see cref="F:System.String.Empty" /> if the Clipboard does not contain data in the <see cref="F:System.Windows.Forms.TextDataFormat.Text" /> or <see cref="F:System.Windows.Forms.TextDataFormat.UnicodeText" /> format, depending on the operating system.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetText">
@@ -398,7 +434,6 @@
         <Parameter Name="format" Type="System.Windows.Forms.TextDataFormat" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="Overload:System.Windows.Forms.Clipboard.ContainsText" /> method to determine whether the Clipboard contains text data before retrieving it with this method.</para>
@@ -411,6 +446,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves text data from the Clipboard in the format indicated by the specified <see cref="T:System.Windows.Forms.TextDataFormat" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The Clipboard text data or <see cref="F:System.String.Empty" /> if the Clipboard does not contain data in the specified format.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.TextDataFormat" /> values.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ColorDialog.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ColorDialog.xml
index 10ab9c73c92..d9110ade30a 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ColorDialog.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ColorDialog.xml
@@ -401,7 +401,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return string includes the type and the value for the <see cref="P:System.Windows.Forms.ColorDialog.Color" /> property.</para>
@@ -410,6 +409,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the <see cref="T:System.Windows.Forms.ColorDialog" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that represents the current <see cref="T:System.Windows.Forms.ColorDialog" />. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ColumnHeader.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ColumnHeader.xml
index e673b346b97..78da054729b 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ColumnHeader.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ColumnHeader.xml
@@ -128,7 +128,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use this method to copy existing <see cref="T:System.Windows.Forms.ColumnHeader" /> objects from an existing <see cref="T:System.Windows.Forms.ListView" /> control for use in other <see cref="T:System.Windows.Forms.ListView" /> controls.</para>
@@ -137,6 +136,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an identical copy of the current <see cref="T:System.Windows.Forms.ColumnHeader" /> that is not attached to any list view control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing a copy of this <see cref="T:System.Windows.Forms.ColumnHeader" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ColumnHeaderConverter.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ColumnHeaderConverter.xml
index adc1c854882..9d2330f4f4d 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ColumnHeaderConverter.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ColumnHeaderConverter.xml
@@ -46,7 +46,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the context parameter to extract additional information about the environment from which this converter is invoked. This parameter can be null, so always check it. Also, properties on the context object can return null.</para>
@@ -55,6 +54,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the <see cref="T:System.Windows.Forms.ColumnHeaderConverter" /> can convert a <see cref="T:System.Windows.Forms.ColumnHeader" /> to the specified type, using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
         <param name="destinationType">
@@ -77,12 +80,15 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object to the specified type, using the specified context and culture information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> that is the result of the conversion.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
         <param name="culture">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ComboBox.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ComboBox.xml
index 7b43c2deb2b..c71d563b28e 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ComboBox.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ComboBox.xml
@@ -409,12 +409,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessibility object for the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.AccessibleObject" /> for the control.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateHandle">
@@ -822,7 +825,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The search performed by this method is not case-sensitive. The <paramref name="s" /> parameter is a substring to compare against the text associated with the items in the combo box list. The search performs a partial match starting from the beginning of the text, and returning the first item in the list that matches the specified substring. You can then perform tasks, such as removing the item that contains the search text using the <see cref="M:System.Windows.Forms.ComboBox.ObjectCollection.Remove(System.Object)" /> method or changing the item's text. Once you have found the specified text, if you want to search for other instances of the text in the <see cref="T:System.Windows.Forms.ComboBox" />, you must use the version of the <see cref="M:System.Windows.Forms.ComboBox.FindString(System.String)" /> method that provides a parameter for specifying a starting index within the <see cref="T:System.Windows.Forms.ComboBox" />. If you want to perform a search for an exact word match instead of a partial match, use the <see cref="M:System.Windows.Forms.ComboBox.FindStringExact(System.String)" /> method.</para>
@@ -831,6 +833,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the first item in the <see cref="T:System.Windows.Forms.ComboBox" /> that starts with the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first item found; returns -1 if no match is found.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> to search for. </param>
       </Docs>
@@ -850,7 +856,6 @@
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The search performed by this method is not case-sensitive. The <paramref name="s" /> parameter is a substring to compare against the text associated with the items in the combo box list. The search performs a partial match starting from the beginning of the text, returning the first item in the list that matches the specified substring. You can then perform tasks, such as removing the item that contains the search text using the <see cref="M:System.Windows.Forms.ComboBox.ObjectCollection.Remove(System.Object)" /> method or changing the item's text. This method is typically used after a call has been made using the version of this method that does not specify a starting index. Once an initial item has been found in the list, this method is typically used to find further instances of the search text by specifying the index position in the <paramref name="startIndex" /> parameter of the item after the first found instance of the search text. If you want to perform a search for an exact word match instead of a partial match, use the <see cref="M:System.Windows.Forms.ComboBox.FindStringExact(System.String)" /> method.</para>
@@ -859,6 +864,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the first item in the <see cref="T:System.Windows.Forms.ComboBox" /> beyond the specified index that contains the specified string. The search is not case sensitive.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first item found; returns -1 if no match is found, or 0 if the <paramref name="s" /> parameter specifies <see cref="F:System.String.Empty" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> to search for. </param>
         <param name="startIndex">
@@ -879,7 +888,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The search performed by this method is not case-sensitive. The <paramref name="s" /> parameter is a string to compare against the text associated with the items in the combo box list. The search looks for a match starting from the beginning of the text, returning the first item in the list that matches the specified substring. You can then perform tasks, such as removing the item that contains the search text using the <see cref="M:System.Windows.Forms.ComboBox.ObjectCollection.Remove(System.Object)" /> method or changing the item's text. Once you have found the specified text, if you want to search for other instances of the text in the <see cref="T:System.Windows.Forms.ComboBox" />, you must use the version of the <see cref="M:System.Windows.Forms.ComboBox.FindStringExact(System.String)" /> method that provides a parameter for specifying a starting index within the <see cref="T:System.Windows.Forms.ComboBox" />. If you want to perform partial word search instead of an exact word match, use the <see cref="M:System.Windows.Forms.ComboBox.FindString(System.String)" /> method.</para>
@@ -888,6 +896,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds the first item in the combo box that matches the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first item found; returns -1 if no match is found, or 0 if the <paramref name="s" /> parameter specifies <see cref="F:System.String.Empty" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> to search for. </param>
       </Docs>
@@ -907,7 +919,6 @@
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The search performed by this method is not case-sensitive. The <paramref name="s" /> parameter is a string to compare against the text associated with the items in the combo box list. The search looks for a match starting from the beginning of the text, returning the first item in the list that matches the specified substring. You can then perform tasks, such as removing the item that contains the search text using the <see cref="M:System.Windows.Forms.ComboBox.ObjectCollection.Remove(System.Object)" /> method or changing the item's text. This method is typically used after a call has been made using the version of this method that does not specify a starting index. Once an initial item has been found in the list, this method is typically used to find further instances of the search text by specifying the index position in the <paramref name="startIndex" /> parameter of the item after the first found instance of the search text. If you want to perform partial word search instead of an exact word match, use the <see cref="M:System.Windows.Forms.ComboBox.FindString(System.String)" /> method.</para>
@@ -917,6 +928,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds the first item after the specified index that matches the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first item found; returns -1 if no match is found, or 0 if the <paramref name="s" /> parameter specifies <see cref="F:System.String.Empty" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> to search for. </param>
         <param name="startIndex">
@@ -1001,7 +1016,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <see cref="P:System.Windows.Forms.ComboBox.DrawMode" /> is not set to OwnerDrawVariable, the value of the <paramref name="index" /> parameter is ignored because all items in a standard <see cref="T:System.Windows.Forms.ComboBox" /> are the same size. You can use this property when you are using an owner-drawn <see cref="T:System.Windows.Forms.ComboBox" /> to determine the size of any item within the <see cref="T:System.Windows.Forms.ComboBox" />.</para>
@@ -1011,6 +1025,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the height of an item in the <see cref="T:System.Windows.Forms.ComboBox" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The height, in pixels, of the item at the specified index.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the item to return the height of. </param>
       </Docs>
@@ -1063,7 +1081,6 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.ComboBox.IsInputKey(System.Windows.Forms.Keys)" /> method returns true when the <paramref name="keyData" /> parameter includes the <see cref="F:System.Windows.Forms.Keys.Return" /> or <see cref="F:System.Windows.Forms.Keys.Escape" /> value and the <see cref="P:System.Windows.Forms.ComboBox.DroppedDown" /> property is true.</para>
@@ -1072,6 +1089,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified key is a regular input key or a special key that requires preprocessing.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified key is a regular input key; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.Keys" /> values.</param>
       </Docs>
@@ -2665,12 +2686,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the <see cref="T:System.Windows.Forms.ComboBox" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that represents the current <see cref="T:System.Windows.Forms.ComboBox" />. The string includes the type and the number of items in the <see cref="T:System.Windows.Forms.ComboBox" /> control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/CommonDialog.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/CommonDialog.xml
index 74e82549865..ff3d27729f8 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/CommonDialog.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/CommonDialog.xml
@@ -76,7 +76,6 @@
         <Parameter Name="lparam" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A hook procedure is a mechanism by which a function can intercept events before they reach an application. When you override the <see cref="M:System.Windows.Forms.CommonDialog.HookProc(System.IntPtr,System.Int32,System.IntPtr,System.IntPtr)" /> method for a <see cref="T:System.Windows.Forms.CommonDialog" /> class, the operating system invokes your override of the function to post operating system messages to the window.</para>
@@ -90,6 +89,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines the common dialog box hook procedure that is overridden to add specific functionality to a common dialog box.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A zero value if the default dialog box procedure processes the message; a nonzero value if the default dialog box procedure ignores the message.</para>
+        </returns>
         <param name="hWnd">
           <attribution license="cc4" from="Microsoft" modified="false" />The handle to the dialog box window. </param>
         <param name="msg">
@@ -143,7 +146,6 @@
         <Parameter Name="lparam" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Control is transferred here when messages are sent to the owner window of the common dialog box. Inheriting classes can override this method to add specific functionality to a common dialog box.</para>
@@ -152,6 +154,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines the owner window procedure that is overridden to add specific functionality to a common dialog box.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of the message processing, which is dependent on the message sent.</para>
+        </returns>
         <param name="hWnd">
           <attribution license="cc4" from="Microsoft" modified="false" />The window handle of the message to send. </param>
         <param name="msg">
@@ -195,7 +201,6 @@
         <Parameter Name="hwndOwner" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is invoked when the user of a common dialog box calls <see cref="M:System.Windows.Forms.CommonDialog.ShowDialog" />, and it must be overridden by inherited classes of <see cref="T:System.Windows.Forms.CommonDialog" /> to implement a specific common dialog box.</para>
@@ -204,6 +209,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, specifies a common dialog box.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the dialog box was successfully run; otherwise, false.</para>
+        </returns>
         <param name="hwndOwner">
           <attribution license="cc4" from="Microsoft" modified="false" />A value that represents the window handle of the owner window for the common dialog box. </param>
       </Docs>
@@ -220,7 +229,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method implements <see cref="M:System.Windows.Forms.CommonDialog.RunDialog(System.IntPtr)" />.</para>
@@ -229,6 +237,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Runs a common dialog box with a default owner.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="F:System.Windows.Forms.DialogResult.OK" /> if the user clicks OK in the dialog box; otherwise, <see cref="F:System.Windows.Forms.DialogResult.Cancel" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -245,7 +258,6 @@
         <Parameter Name="owner" Type="System.Windows.Forms.IWin32Window" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This version of the <see cref="M:System.Windows.Forms.CommonDialog.ShowDialog" /> method allows you to specify a specific form or control that will own the dialog box that is shown. If you use the version of this method that has no parameters, the dialog box being shown would be owned automatically by the currently active window of your application.</para>
@@ -254,6 +266,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Runs a common dialog box with the specified owner.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="F:System.Windows.Forms.DialogResult.OK" /> if the user clicks <ui>OK</ui> in the dialog box; otherwise, <see cref="F:System.Windows.Forms.DialogResult.Cancel" />.</para>
+        </returns>
         <param name="owner">
           <attribution license="cc4" from="Microsoft" modified="false" />Any object that implements <see cref="T:System.Windows.Forms.IWin32Window" /> that represents the top-level window that will own the modal dialog box. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ContainerControl.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ContainerControl.xml
index 4caf80dee93..3973aa377c8 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ContainerControl.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ContainerControl.xml
@@ -642,7 +642,6 @@
         <Parameter Name="forward" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A control with its <see cref="P:System.Windows.Forms.Control.TabStop" /> property set to false cannot be selected, so the next available control will be selected.</para>
@@ -651,6 +650,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Selects the next available control and makes it the active control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a control is selected; otherwise, false.</para>
+        </returns>
         <param name="forward">
           <attribution license="cc4" from="Microsoft" modified="false" />true to cycle forward through the controls in the <see cref="T:System.Windows.Forms.ContainerControl" />; otherwise, false. </param>
       </Docs>
@@ -694,7 +697,6 @@
         <Parameter Name="control" Type="System.Windows.Forms.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="control" /> parameter must be a child of the container control.</para>
@@ -703,6 +705,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Activates the specified control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the control is successfully activated; otherwise, false.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Control" /> to activate.</param>
       </Docs>
@@ -737,7 +743,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.Windows.Forms.ContainerControl.Validate" /> method validates the last child control that is not validated and its ancestors up through, but not including, the current container control. This overloaded version always performs validation, regardless of the value of the <see cref="P:System.Windows.Forms.ContainerControl.AutoValidate" /> property of the control's parent. Therefore use it to unconditionally force validation.</para>
@@ -746,6 +751,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies the value of the control losing focus by causing the <see cref="E:System.Windows.Forms.Control.Validating" /> and <see cref="E:System.Windows.Forms.Control.Validated" /> events to occur, in that order. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if validation is successful; otherwise, false. If called from the <see cref="E:System.Windows.Forms.Control.Validating" /> or <see cref="E:System.Windows.Forms.Control.Validated" /> event handlers, this method will always return false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -765,7 +774,6 @@
         <Parameter Name="checkAutoValidate" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.Windows.Forms.ContainerControl.Validate" /> method validates the last child control that is not validated and its ancestors up through, but not including, the current container control. This overloaded version performs validation based on the following conditions:</para>
@@ -782,6 +790,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies the value of the control that is losing focus; conditionally dependent on whether automatic validation is turned on. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if validation is successful; otherwise, false. If called from the <see cref="E:System.Windows.Forms.Control.Validating" /> or <see cref="E:System.Windows.Forms.Control.Validated" /> event handlers, this method will always return false.</para>
+        </returns>
         <param name="checkAutoValidate">
           <attribution license="cc4" from="Microsoft" modified="false" />If true, the value of the <see cref="P:System.Windows.Forms.ContainerControl.AutoValidate" /> property is used to determine if validation should be performed; if false, validation is unconditionally performed.</param>
       </Docs>
@@ -805,7 +817,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -817,6 +828,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Causes all of the child controls within a control that support validation to validate their data. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if all of the children validated successfully; otherwise, false. If called from the <see cref="E:System.Windows.Forms.Control.Validating" /> or <see cref="E:System.Windows.Forms.Control.Validated" /> event handlers, this method will always return false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ValidateChildren">
@@ -840,7 +855,6 @@
         <Parameter Name="validationConstraints" Type="System.Windows.Forms.ValidationConstraints" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -854,6 +868,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Causes all of the child controls within a control that support validation to validate their data. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if all of the children validated successfully; otherwise, false. If called from the <see cref="E:System.Windows.Forms.Control.Validating" /> or <see cref="E:System.Windows.Forms.Control.Validated" /> event handlers, this method will always return false.</para>
+        </returns>
         <param name="validationConstraints">
           <attribution license="cc4" from="Microsoft" modified="false" />Places restrictions on which controls have their <see cref="E:System.Windows.Forms.Control.Validating" /> event raised.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Control.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Control.xml
index d5eab66ea2c..aa5b38bcdd4 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Control.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Control.xml
@@ -804,7 +804,6 @@
         <Parameter Name="method" Type="System.Delegate" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The delegate is called asynchronously, and this method returns immediately. You can call this method from any thread, even the thread that owns the control's handle. If the control's handle does not exist yet, this method searches up the control's parent chain until it finds a control or form that does have a window handle. If no appropriate handle can be found, <see cref="M:System.Windows.Forms.Control.BeginInvoke(System.Delegate)" /> will throw an exception. Exceptions within the delegate method are considered untrapped and will be sent to the application's untrapped exception handler.</para>
@@ -820,6 +819,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the specified delegate asynchronously on the thread that the control's underlying handle was created on.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that represents the result of the <see cref="M:System.Windows.Forms.Control.BeginInvoke(System.Delegate)" /> operation.</para>
+        </returns>
         <param name="method">
           <attribution license="cc4" from="Microsoft" modified="false" />A delegate to a method that takes no parameters. </param>
       </Docs>
@@ -850,7 +853,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The delegate is called asynchronously, and this method returns immediately. You can call this method from any thread, even the thread that owns the control's handle. If the control's handle does not exist yet, this method searches up the control's parent chain until it finds a control or form that does have a window handle. If no appropriate handle can be found, <see cref="M:System.Windows.Forms.Control.BeginInvoke(System.Delegate)" /> will throw an exception. Exceptions within the delegate method are considered untrapped and will be sent to the application's untrapped exception handler.</para>
@@ -866,6 +868,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the specified delegate asynchronously with the specified arguments, on the thread that the control's underlying handle was created on.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that represents the result of the <see cref="M:System.Windows.Forms.Control.BeginInvoke(System.Delegate)" /> operation.</para>
+        </returns>
         <param name="method">
           <attribution license="cc4" from="Microsoft" modified="false" />A delegate to a method that takes parameters of the same number and type that are contained in the <paramref name="args" /> parameter. </param>
         <param name="args">
@@ -1475,12 +1481,15 @@
         <Parameter Name="ctl" Type="System.Windows.Forms.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a value indicating whether the specified control is a child of the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified control is a child of the control; otherwise, false.</para>
+        </returns>
         <param name="ctl">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Control" /> to evaluate. </param>
       </Docs>
@@ -1724,7 +1733,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you do not explicitly call the <see cref="M:System.Windows.Forms.Control.CreateAccessibilityInstance" /> method, it will be called when the <see cref="P:System.Windows.Forms.Control.AccessibilityObject" /> property is referenced.</para>
@@ -1736,6 +1744,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessibility object for the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.AccessibleObject" /> for the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1779,12 +1791,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the control collection for the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.Windows.Forms.Control.ControlCollection" /> assigned to the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1837,7 +1852,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Drawing.Graphics" /> object that you retrieve through the <see cref="M:System.Windows.Forms.Control.CreateGraphics" /> method should not normally be retained after the current Windows message has been processed, because anything painted with that object will be erased with the next WM_PAINT message. Therefore you cannot cache the <see cref="T:System.Drawing.Graphics" /> object for reuse, except to use non-visual methods like <see cref="M:System.Drawing.Graphics.MeasureString(System.String,System.Drawing.Font)" />. Instead, you must call <see cref="M:System.Windows.Forms.Control.CreateGraphics" /> every time that you want to use the <see cref="T:System.Drawing.Graphics" /> object, and then call <see cref="M:System.Drawing.Graphics.Dispose" /> when you are finished using it. For more information about Windows messages, see <see cref="M:System.Windows.Forms.Control.WndProc(System.Windows.Forms.Message@)" />.</para>
@@ -1850,6 +1864,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the <see cref="T:System.Drawing.Graphics" /> for the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Graphics" /> for the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -2449,7 +2467,6 @@
         <Parameter Name="allowedEffects" Type="System.Windows.Forms.DragDropEffects" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="allowedEffects" /> parameter determines which drag operations can occur. If the drag operation needs to interoperate with applications in another process, data should either be a base managed class (<see cref="T:System.String" />, <see cref="T:System.Drawing.Bitmap" />, or <see cref="T:System.Drawing.Imaging.Metafile" />), or an object that implements <see cref="T:System.Runtime.Serialization.ISerializable" /> or <see cref="T:System.Windows.Forms.IDataObject" />.</para>
@@ -2517,6 +2534,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins a drag-and-drop operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value from the <see cref="T:System.Windows.Forms.DragDropEffects" /> enumeration that represents the final effect that was performed during the drag-and-drop operation.</para>
+        </returns>
         <param name="data">
           <attribution license="cc4" from="Microsoft" modified="false" />The data to drag. </param>
         <param name="allowedEffects">
@@ -2890,7 +2911,6 @@
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the asynchronous operation has not been completed, this function will block until the result is available.</para>
@@ -2902,6 +2922,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the return value of the asynchronous operation represented by the <see cref="T:System.IAsyncResult" /> passed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> generated by the asynchronous operation.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IAsyncResult" /> that represents a specific invoke asynchronous operation, returned when calling <see cref="M:System.Windows.Forms.Control.BeginInvoke(System.Delegate)" />. </param>
       </Docs>
@@ -3005,7 +3029,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The control's <see cref="P:System.Windows.Forms.Control.Parent" /> property value might not be the same as the <see cref="T:System.Windows.Forms.Form" /> returned by <see cref="M:System.Windows.Forms.Control.FindForm" /> method. For example, if a <see cref="T:System.Windows.Forms.RadioButton" /> control is contained within a <see cref="T:System.Windows.Forms.GroupBox" /> control, and the <see cref="T:System.Windows.Forms.GroupBox" /> is on a <see cref="T:System.Windows.Forms.Form" />, the <see cref="T:System.Windows.Forms.RadioButton" /> control's <see cref="P:System.Windows.Forms.Control.Parent" /> is the <see cref="T:System.Windows.Forms.GroupBox" /> and the <see cref="T:System.Windows.Forms.GroupBox" /> control's <see cref="P:System.Windows.Forms.Control.Parent" /> is the <see cref="T:System.Windows.Forms.Form" />.</para>
@@ -3014,6 +3037,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the form that the control is on.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.Form" /> that the control is on.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -3028,7 +3055,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.Control.Focus" /> method returns true if the control successfully received input focus. The control can have the input focus while not displaying any visual cues of having the focus. This behavior is primarily observed by the nonselectable controls listed below, or any controls derived from them.</para>
@@ -3073,6 +3099,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets input focus to the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the input focus request was successful; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -3259,7 +3289,6 @@
         <Parameter Name="handle" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method searches up the window handle parent chain until it finds a handle that is associated with a control. This method is more reliable than the <see cref="M:System.Windows.Forms.Control.FromHandle(System.IntPtr)" /> method, because it correctly returns controls that own more than one handle.</para>
@@ -3268,6 +3297,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the control that contains the specified handle.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.Control" /> that represents the control associated with the specified handle; returns null if no control with the specified handle is found.</para>
+        </returns>
         <param name="handle">
           <attribution license="cc4" from="Microsoft" modified="false" />The window handle (HWND) to search for. </param>
       </Docs>
@@ -3291,7 +3324,6 @@
         <Parameter Name="handle" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Windows.Forms.Control.FromChildHandle(System.IntPtr)" /> method if you need to return controls that own more than one handle.</para>
@@ -3300,6 +3332,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the control that is currently associated with the specified handle.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.Control" /> that represents the control associated with the specified handle; returns null if no control with the specified handle is found.</para>
+        </returns>
         <param name="handle">
           <attribution license="cc4" from="Microsoft" modified="false" />The window handle (HWND) to search for. </param>
       </Docs>
@@ -3326,12 +3362,15 @@
         <Parameter Name="objectId" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the specified <see cref="T:System.Windows.Forms.AccessibleObject" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified <see cref="T:System.Windows.Forms.AccessibleObject" />.</para>
+        </returns>
         <param name="objectId">
           <attribution license="cc4" from="Microsoft" modified="false" />An Int32 that identifies the <see cref="T:System.Windows.Forms.AccessibleObject" /> to retrieve.</param>
       </Docs>
@@ -3347,12 +3386,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a value indicating how a control will behave when its <see cref="P:System.Windows.Forms.Control.AutoSize" /> property is enabled.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.AutoSizeMode" /> values. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetChildAtPoint">
@@ -3365,7 +3407,6 @@
         <Parameter Name="pt" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If there is no child control at the specified point, the <see cref="M:System.Windows.Forms.Control.GetChildAtPoint(System.Drawing.Point)" /> method returns null.</para>
@@ -3374,6 +3415,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the child control that is located at the specified coordinates.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.Control" /> that represents the control that is located at the specified point.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Point" /> that contains the coordinates where you want to look for a control. Coordinates are expressed relative to the upper-left corner of the control's client area. </param>
       </Docs>
@@ -3396,12 +3441,15 @@
         <Parameter Name="skipValue" Type="System.Windows.Forms.GetChildAtPointSkip" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the child control that is located at the specified coordinates, specifying whether to ignore child controls of a certain type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The child <see cref="T:System.Windows.Forms.Control" /> at the specified coordinates.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Point" /> that contains the coordinates where you want to look for a control. Coordinates are expressed relative to the upper-left corner of the control's client area.</param>
         <param name="skipValue">
@@ -3416,12 +3464,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the next <see cref="T:System.Windows.Forms.ContainerControl" /> up the control's chain of parent controls.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Windows.Forms.IContainerControl" />, that represents the parent of the <see cref="T:System.Windows.Forms.Control" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -3439,7 +3490,6 @@
         <Parameter Name="forward" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.Control.GetNextControl(System.Windows.Forms.Control,System.Boolean)" /> method is dependent on tab order. To iterate through all controls of a form, including nested controls, use the <see cref="P:System.Windows.Forms.Control.Controls" /> property. To get or set the active control of a container control, use the <see cref="P:System.Windows.Forms.ContainerControl.ActiveControl" /> property.</para>
@@ -3448,6 +3498,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the next control forward or back in the tab order of child controls.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The next <see cref="T:System.Windows.Forms.Control" /> in the tab order.</para>
+        </returns>
         <param name="ctl">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Control" /> to start the search with. </param>
         <param name="forward">
@@ -3468,7 +3522,6 @@
         <Parameter Name="proposedSize" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3478,6 +3531,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the size of a rectangular area into which a control can be fitted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An ordered pair of type <see cref="T:System.Drawing.Size" /> representing the width and height of a rectangle.</para>
+        </returns>
         <param name="proposedSize">
           <attribution license="cc4" from="Microsoft" modified="false" />The custom-sized area for a control. </param>
       </Docs>
@@ -3510,7 +3567,6 @@
         <Parameter Name="specified" Type="System.Windows.Forms.BoundsSpecified" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is a helper method that is called by <see cref="M:System.Windows.Forms.Control.ScaleControl(System.Drawing.SizeF,System.Windows.Forms.BoundsSpecified)" /> to retrieve the bounds within which the control is scaled. You can override this method to reuse the <see cref="M:System.Windows.Forms.Control.ScaleControl(System.Drawing.SizeF,System.Windows.Forms.BoundsSpecified)" /> scaling logic, but you must supply your own bounds. The default implementation returns scaled bounds that take into account the <paramref name="specified" /> bounds, whether the control is top level, whether the control is fixed width or auto size, and any adornments the control might have. </para>
@@ -3519,6 +3575,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the bounds within which the control is scaled.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> representing the bounds within which the control is scaled.</para>
+        </returns>
         <param name="bounds">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Rectangle" /> that specifies the area for which to retrieve the display bounds.</param>
         <param name="factor">
@@ -3541,7 +3601,6 @@
         <Parameter Name="flag" Type="System.Windows.Forms.ControlStyles" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Control style bit flags are used to categorize supported behavior. A control can enable a style by calling the <see cref="M:System.Windows.Forms.Control.SetStyle(System.Windows.Forms.ControlStyles,System.Boolean)" /> method and passing in the appropriate <see cref="T:System.Windows.Forms.ControlStyles" /> bit and the Boolean value to set the bit to. To determine the value assigned to a specified <see cref="T:System.Windows.Forms.ControlStyles" /> bit, use the <see cref="M:System.Windows.Forms.Control.GetStyle(System.Windows.Forms.ControlStyles)" /> method and pass in the <see cref="T:System.Windows.Forms.ControlStyles" /> member to evaluate.</para>
@@ -3550,6 +3609,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the value of the specified control style bit for the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified control style bit is set to true; otherwise, false.</para>
+        </returns>
         <param name="flag">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.ControlStyles" /> bit to return the value from. </param>
       </Docs>
@@ -3562,12 +3625,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the control is a top-level control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the control is a top-level control; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -4202,7 +4268,6 @@
         <Parameter Name="method" Type="System.Delegate" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Delegates are similar to function pointers in C or C++ languages. Delegates encapsulate a reference to a method inside a delegate object. The delegate object can then be passed to code that calls the referenced method, and the method to be invoked can be unknown at compile time. Unlike function pointers in C or C++, delegates are object-oriented, type-safe, and more secure.</para>
@@ -4219,6 +4284,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the specified delegate on the thread that owns the control's underlying window handle.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value from the delegate being invoked, or null if the delegate has no return value.</para>
+        </returns>
         <param name="method">
           <attribution license="cc4" from="Microsoft" modified="false" />A delegate that contains a method to be called in the control's thread context. </param>
       </Docs>
@@ -4244,7 +4313,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Delegates are similar to function pointers in C or C++ languages. Delegates encapsulate a reference to a method inside a delegate object. The delegate object can then be passed to code that calls the referenced method, and the method to be invoked can be unknown at compile time. Unlike function pointers in C or C++, delegates are object-oriented, type-safe, and more secure.</para>
@@ -4261,6 +4329,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the specified delegate, on the thread that owns the control's underlying window handle, with the specified list of arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that contains the return value from the delegate being invoked, or null if the delegate has no return value.</para>
+        </returns>
         <param name="method">
           <attribution license="cc4" from="Microsoft" modified="false" />A delegate to a method that takes parameters of the same number and type that are contained in the <paramref name="args" /> parameter. </param>
         <param name="args">
@@ -4568,7 +4640,6 @@
         <Parameter Name="charCode" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call the <see cref="M:System.Windows.Forms.Control.IsInputChar(System.Char)" /> method to determine whether the character specified by the <paramref name="charCode" /> parameter is an input character that the control wants. This method is called during window message preprocessing to determine whether the specified input character should be preprocessed or sent directly to the control. If <see cref="M:System.Windows.Forms.Control.IsInputChar(System.Char)" /> returns true, the specified character is sent directly to the control. If <see cref="M:System.Windows.Forms.Control.IsInputChar(System.Char)" /> returns false, the specified character is preprocessed and only sent to the control if it is not consumed by the preprocessing phase. The preprocessing of a character includes checking whether the character is a mnemonic of another control.</para>
@@ -4577,6 +4648,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if a character is an input character that the control recognizes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character should be sent directly to the control and not preprocessed; otherwise, false.</para>
+        </returns>
         <param name="charCode">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to test. </param>
       </Docs>
@@ -4595,7 +4670,6 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call the <see cref="M:System.Windows.Forms.Control.IsInputKey(System.Windows.Forms.Keys)" /> method to determine whether the key specified by the <paramref name="keyData" /> parameter is an input key that the control wants. This method is called during window message preprocessing to determine whether the specified input key should be preprocessed or sent directly to the control. If <see cref="M:System.Windows.Forms.Control.IsInputKey(System.Windows.Forms.Keys)" /> returns true, the specified key is sent directly to the control. If <see cref="M:System.Windows.Forms.Control.IsInputKey(System.Windows.Forms.Keys)" /> returns false, the specified key is preprocessed and only sent to the control if it is not consumed by the preprocessing phase. Keys that are preprocessed include the TAB, RETURN, ESC, and the UP ARROW, DOWN ARROW, LEFT ARROW, and RIGHT ARROW keys.</para>
@@ -4604,6 +4678,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified key is a regular input key or a special key that requires preprocessing.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified key is a regular input key; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.Keys" /> values. </param>
       </Docs>
@@ -4625,7 +4703,6 @@
         <Parameter Name="keyVal" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Windows.Forms.Control.IsKeyLocked(System.Windows.Forms.Keys)" /> property to determine whether the CAPS LOCK, NUM LOCK, or SCROLL LOCK keys are on, whether individually or in combination.</para>
@@ -4634,6 +4711,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the CAPS LOCK, NUM LOCK, or SCROLL LOCK key is in effect.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified key or keys are in effect; otherwise, false.</para>
+        </returns>
         <param name="keyVal">
           <attribution license="cc4" from="Microsoft" modified="false" />The CAPS LOCK, NUM LOCK, or SCROLL LOCK member of the <see cref="T:System.Windows.Forms.Keys" /> enumeration. </param>
       </Docs>
@@ -4681,7 +4762,6 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The mnemonic character is the character immediately following the first instance of "&amp;" in a <see cref="T:System.String" />.</para>
@@ -4690,6 +4770,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the specified character is the mnemonic character assigned to the control in the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="charCode" /> character is the mnemonic character assigned to the control; otherwise, false.</para>
+        </returns>
         <param name="charCode">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to test. </param>
         <param name="text">
@@ -8629,12 +8713,15 @@
         <Parameter Name="p" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the location of the specified screen point into client coordinates.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Point" /> that represents the converted <see cref="T:System.Drawing.Point" />, <paramref name="p" />, in client coordinates.</para>
+        </returns>
         <param name="p">
           <attribution license="cc4" from="Microsoft" modified="false" />The screen coordinate <see cref="T:System.Drawing.Point" /> to convert. </param>
       </Docs>
@@ -8653,12 +8740,15 @@
         <Parameter Name="p" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the location of the specified client point into screen coordinates.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Point" /> that represents the converted <see cref="T:System.Drawing.Point" />, <paramref name="p" />, in screen coordinates.</para>
+        </returns>
         <param name="p">
           <attribution license="cc4" from="Microsoft" modified="false" />The client coordinate <see cref="T:System.Drawing.Point" /> to convert. </param>
       </Docs>
@@ -8787,7 +8877,6 @@
         <Parameter Name="charCode" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called during message preprocessing to handle dialog characters, such as control mnemonics. This method is called only if the <see cref="M:System.Windows.Forms.Control.IsInputChar(System.Char)" /> method indicates that the control is not processing the character. The <see cref="M:System.Windows.Forms.Control.ProcessDialogChar(System.Char)" /> method simply sends the character to the parent's <see cref="M:System.Windows.Forms.Control.ProcessDialogChar(System.Char)" /> method, or returns false if the control has no parent. The <see cref="T:System.Windows.Forms.Form" /> class overrides this method to perform actual processing of dialog characters. This method is only called when the control is hosted in a Windows Forms application or as an ActiveX control.</para>
@@ -8796,6 +8885,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a dialog character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character was processed by the control; otherwise, false.</para>
+        </returns>
         <param name="charCode">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to process. </param>
       </Docs>
@@ -8814,7 +8907,6 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called during message preprocessing to handle dialog characters, such as TAB, RETURN, ESC, and arrow keys. This method is called only if the <see cref="M:System.Windows.Forms.Control.IsInputKey(System.Windows.Forms.Keys)" /> method indicates that the control is not processing the key. The <see cref="M:System.Windows.Forms.Control.ProcessDialogKey(System.Windows.Forms.Keys)" /> simply sends the character to the parent's <see cref="M:System.Windows.Forms.Control.ProcessDialogKey(System.Windows.Forms.Keys)" /> method, or returns false if the control has no parent. The <see cref="T:System.Windows.Forms.Form" /> class overrides this method to perform actual processing of dialog keys. This method is only called when the control is hosted in a Windows Forms application or as an ActiveX control.</para>
@@ -8823,6 +8915,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a dialog key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key was processed by the control; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.Keys" /> values that represents the key to process. </param>
       </Docs>
@@ -8901,7 +8997,6 @@
         <Parameter Name="charCode" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called to give a control the opportunity to process a mnemonic character. The method should determine whether the control is in a state to process mnemonics and if whether the given character represents a mnemonic. If so, the method should perform the action associated with the mnemonic and return true. If not, the method should return false. Implementations of this method often use the <see cref="M:System.Windows.Forms.Control.IsMnemonic(System.Char,System.String)" /> method to determine whether the given character matches a mnemonic in the control's text.</para>
@@ -8916,6 +9011,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a mnemonic character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character was processed as a mnemonic by the control; otherwise, false.</para>
+        </returns>
         <param name="charCode">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to process. </param>
       </Docs>
@@ -9268,12 +9367,15 @@
         <Parameter Name="r" Type="System.Drawing.Rectangle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the size and location of the specified screen rectangle in client coordinates.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> that represents the converted <see cref="T:System.Drawing.Rectangle" />, <paramref name="r" />, in client coordinates.</para>
+        </returns>
         <param name="r">
           <attribution license="cc4" from="Microsoft" modified="false" />The screen coordinate <see cref="T:System.Drawing.Rectangle" /> to convert. </param>
       </Docs>
@@ -9292,12 +9394,15 @@
         <Parameter Name="r" Type="System.Drawing.Rectangle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the size and location of the specified client rectangle in screen coordinates.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> that represents the converted <see cref="T:System.Drawing.Rectangle" />, <paramref name="p" />, in screen coordinates.</para>
+        </returns>
         <param name="r">
           <attribution license="cc4" from="Microsoft" modified="false" />The client coordinate <see cref="T:System.Drawing.Rectangle" /> to convert. </param>
       </Docs>
@@ -9900,7 +10005,6 @@
         <Parameter Name="align" Type="System.Drawing.ContentAlignment" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="P:System.Windows.Forms.Control.RightToLeft" /> property of <see cref="T:System.Windows.Forms.RightToLeft" /> is set to No, the return value is equal to the <paramref name="align" /> parameter passed in.</para>
@@ -9909,6 +10013,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.Drawing.ContentAlignment" /> to the appropriate <see cref="T:System.Drawing.ContentAlignment" /> to support right-to-left text.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Drawing.ContentAlignment" /> values.</para>
+        </returns>
         <param name="align">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Drawing.ContentAlignment" /> values. </param>
       </Docs>
@@ -9932,7 +10040,6 @@
         <Parameter Name="align" Type="System.Windows.Forms.HorizontalAlignment" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="P:System.Windows.Forms.Control.RightToLeft" /> property of <see cref="T:System.Windows.Forms.RightToLeft" /> is set to No, the return value is equal to the <paramref name="align" /> parameter passed in.</para>
@@ -9941,6 +10048,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.Windows.Forms.HorizontalAlignment" /> to the appropriate <see cref="T:System.Windows.Forms.HorizontalAlignment" /> to support right-to-left text.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.HorizontalAlignment" /> values.</para>
+        </returns>
         <param name="align">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.HorizontalAlignment" /> values. </param>
       </Docs>
@@ -9964,7 +10075,6 @@
         <Parameter Name="align" Type="System.Windows.Forms.LeftRightAlignment" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="P:System.Windows.Forms.Control.RightToLeft" /> property of <see cref="T:System.Windows.Forms.RightToLeft" /> is set to No, the return value is equal to the <paramref name="align" /> parameter passed in.</para>
@@ -9973,6 +10083,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.Windows.Forms.LeftRightAlignment" /> to the appropriate <see cref="T:System.Windows.Forms.LeftRightAlignment" /> to support right-to-left text.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.LeftRightAlignment" /> values.</para>
+        </returns>
         <param name="align">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.LeftRightAlignment" /> values. </param>
       </Docs>
@@ -9996,7 +10110,6 @@
         <Parameter Name="align" Type="System.Drawing.ContentAlignment" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="P:System.Windows.Forms.Control.RightToLeft" /> property of <see cref="T:System.Windows.Forms.RightToLeft" /> is set to No, the return value is equal to the <paramref name="align" /> parameter passed in.</para>
@@ -10005,6 +10118,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.Drawing.ContentAlignment" /> to the appropriate <see cref="T:System.Drawing.ContentAlignment" /> to support right-to-left text.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Drawing.ContentAlignment" /> values.</para>
+        </returns>
         <param name="align">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Drawing.ContentAlignment" /> values. </param>
       </Docs>
@@ -10028,7 +10145,6 @@
         <Parameter Name="align" Type="System.Windows.Forms.HorizontalAlignment" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="P:System.Windows.Forms.Control.RightToLeft" /> property of <see cref="T:System.Windows.Forms.RightToLeft" /> is set to No, the return value is equal to the <paramref name="align" /> parameter passed in.</para>
@@ -10037,6 +10153,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.Windows.Forms.HorizontalAlignment" /> to the appropriate <see cref="T:System.Windows.Forms.HorizontalAlignment" /> to support right-to-left text.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.HorizontalAlignment" /> values.</para>
+        </returns>
         <param name="align">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.HorizontalAlignment" /> values. </param>
       </Docs>
@@ -10060,7 +10180,6 @@
         <Parameter Name="align" Type="System.Windows.Forms.LeftRightAlignment" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="P:System.Windows.Forms.Control.RightToLeft" /> property of <see cref="T:System.Windows.Forms.RightToLeft" /> is set to No, the return value is equal to the <paramref name="align" /> parameter passed in.</para>
@@ -10069,6 +10188,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.Windows.Forms.LeftRightAlignment" /> to the appropriate <see cref="T:System.Windows.Forms.LeftRightAlignment" /> to support right-to-left text.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.LeftRightAlignment" /> values.</para>
+        </returns>
         <param name="align">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.LeftRightAlignment" /> values. </param>
       </Docs>
@@ -10400,7 +10523,6 @@
         <Parameter Name="wrap" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.Control.SelectNextControl(System.Windows.Forms.Control,System.Boolean,System.Boolean,System.Boolean,System.Boolean)" /> method activates the next control in the tab order if the control's Selectable style bit is set to true in <see cref="T:System.Windows.Forms.ControlStyles" />, it is contained in another control, and all its parent controls are both visible and enabled.</para>
@@ -10468,6 +10590,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Activates the next control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a control was activated; otherwise, false.</para>
+        </returns>
         <param name="ctl">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Control" /> at which to start the search. </param>
         <param name="forward">
@@ -10953,12 +11079,15 @@
         <Parameter Name="clientSize" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the size of the entire control from the height and width of its client area.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Size" /> value representing the height and width of the entire control.</para>
+        </returns>
         <param name="clientSize">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Size" /> value representing the height and width of the control's client area.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ControlBindingsCollection.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ControlBindingsCollection.xml
index dfb3f44bfaf..f5a544f6f12 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ControlBindingsCollection.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ControlBindingsCollection.xml
@@ -92,7 +92,6 @@
         <Parameter Name="dataMember" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Windows.Forms.Binding.DataSourceUpdateMode" /> property of the <see cref="T:System.Windows.Forms.Binding" /> created by this overload of the <see cref="M:System.Windows.Forms.ControlBindingsCollection.Add(System.String,System.Object,System.String)" /> method is set to the value of the <see cref="P:System.Windows.Forms.ControlBindingsCollection.DefaultDataSourceUpdateMode" /> property. </para>
@@ -102,6 +101,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Windows.Forms.Binding" /> using the specified control property name, data source, and data member, and adds it to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created <see cref="T:System.Windows.Forms.Binding" />.</para>
+        </returns>
         <param name="propertyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the control property to bind. </param>
         <param name="dataSource">
@@ -130,12 +133,15 @@
         <Parameter Name="formattingEnabled" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a binding with the specified control property name, data source, data member, and information about whether formatting is enabled, and adds the binding to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created <see cref="T:System.Windows.Forms.Binding" />.</para>
+        </returns>
         <param name="propertyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the control property to bind.</param>
         <param name="dataSource">
@@ -163,7 +169,6 @@
         <Parameter Name="updateMode" Type="System.Windows.Forms.DataSourceUpdateMode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling the <see cref="M:System.Windows.Forms.ControlBindingsCollection.Add(System.String,System.Object,System.String,System.Boolean,System.Windows.Forms.DataSourceUpdateMode)" /> method raises the <see cref="E:System.Windows.Forms.BindingsCollection.CollectionChanged" /> event.</para>
@@ -172,6 +177,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting, propagating values to the data source based on the specified update setting, and adding the binding to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created <see cref="T:System.Windows.Forms.Binding" />.</para>
+        </returns>
         <param name="propertyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the control property to bind. </param>
         <param name="dataSource">
@@ -202,7 +211,6 @@
         <Parameter Name="nullValue" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling the <see cref="M:System.Windows.Forms.ControlBindingsCollection.Add(System.String,System.Object,System.String,System.Boolean,System.Windows.Forms.DataSourceUpdateMode,System.Object)" /> method raises the <see cref="E:System.Windows.Forms.BindingsCollection.CollectionChanged" /> event.</para>
@@ -211,6 +219,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting, propagating values to the data source based on the specified update setting, setting the property to the specified value when <see cref="T:System.DBNull" /> is returned from the data source, and adding the binding to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created <see cref="T:System.Windows.Forms.Binding" /> </para>
+        </returns>
         <param name="propertyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the control property to bind. </param>
         <param name="dataSource">
@@ -244,7 +256,6 @@
         <Parameter Name="formatString" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling the <see cref="M:System.Windows.Forms.ControlBindingsCollection.Add(System.String,System.Object,System.String,System.Boolean,System.Windows.Forms.DataSourceUpdateMode,System.Object,System.String)" /> method raises the <see cref="E:System.Windows.Forms.BindingsCollection.CollectionChanged" /> event.</para>
@@ -253,6 +264,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting with the specified format string, propagating values to the data source based on the specified update setting, setting the property to the specified value when <see cref="T:System.DBNull" /> is returned from the data source, and adding the binding to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created <see cref="T:System.Windows.Forms.Binding" /> </para>
+        </returns>
         <param name="propertyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the control property to bind. </param>
         <param name="dataSource">
@@ -289,7 +304,6 @@
         <Parameter Name="formatInfo" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling the <see cref="M:System.Windows.Forms.ControlBindingsCollection.Add(System.String,System.Object,System.String,System.Boolean,System.Windows.Forms.DataSourceUpdateMode,System.Object,System.String,System.IFormatProvider)" /> method raises the <see cref="E:System.Windows.Forms.BindingsCollection.CollectionChanged" /> event.</para>
@@ -298,6 +312,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting with the specified format string, propagating values to the data source based on the specified update setting, setting the property to the specified value when <see cref="T:System.DBNull" /> is returned from the data source, setting the specified format provider, and adding the binding to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created <see cref="T:System.Windows.Forms.Binding" />.</para>
+        </returns>
         <param name="propertyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the control property to bind. </param>
         <param name="dataSource">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ControlPaint.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ControlPaint.xml
index 2cfc964bc42..b5a659e6c77 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ControlPaint.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ControlPaint.xml
@@ -54,12 +54,15 @@
         <Parameter Name="background" Type="System.Drawing.Color" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a 16-bit color bitmap.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IntPtr" /> representing the handle to the bitmap.</para>
+        </returns>
         <param name="bitmap">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Bitmap" /> to create.</param>
         <param name="background">
@@ -81,7 +84,6 @@
         <Parameter Name="monochromeMask" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You are responsible for de-allocating the HBITMAP. If the image uses transparency, the background will be filled with the specified color.</para>
@@ -90,6 +92,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a Win32 HBITMAP out of the image. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IntPtr" /> representing the handle to the bitmap.</para>
+        </returns>
         <param name="bitmap">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Bitmap" /> to create.</param>
         <param name="monochromeMask">
@@ -110,7 +116,6 @@
         <Parameter Name="bitmap" Type="System.Drawing.Bitmap" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You are responsible for de-allocating the bitmap.</para>
@@ -119,6 +124,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a color mask for the specified bitmap that indicates which color should be displayed as transparent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The handle to the <see cref="T:System.Drawing.Bitmap" /> mask.</para>
+        </returns>
         <param name="bitmap">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Bitmap" /> to create the transparency mask for. </param>
       </Docs>
@@ -137,7 +146,6 @@
         <Parameter Name="baseColor" Type="System.Drawing.Color" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the specified <see cref="T:System.Drawing.Color" /> is one of the <see cref="T:System.Drawing.SystemColors" />, the color is converted to a <see cref="P:System.Drawing.SystemColors.ControlDark" /> color; otherwise, the color's luminosity value is decreased.</para>
@@ -146,6 +154,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new dark color object for the control from the specified color.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Color" /> that represents the dark color on the control.</para>
+        </returns>
         <param name="baseColor">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Color" /> to be darkened. </param>
       </Docs>
@@ -165,7 +177,6 @@
         <Parameter Name="percOfDarkDark" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the specified <see cref="T:System.Drawing.Color" /> is one of the <see cref="T:System.Drawing.SystemColors" />, the color is converted to a <see cref="P:System.Drawing.SystemColors.ControlDark" /> color; otherwise, the color's luminosity value is decreased.</para>
@@ -174,6 +185,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new dark color object for the control from the specified color and darkens it by the specified percentage.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Color" /> that represent the dark color on the control.</para>
+        </returns>
         <param name="baseColor">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Color" /> to be darkened. </param>
         <param name="percOfDarkDark">
@@ -194,7 +209,6 @@
         <Parameter Name="baseColor" Type="System.Drawing.Color" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the specified <see cref="T:System.Drawing.Color" /> is one of the <see cref="T:System.Drawing.SystemColors" />, the color is converted to the <see cref="P:System.Drawing.SystemColors.ControlDarkDark" /> color; otherwise, the color's luminosity value is increased.</para>
@@ -203,6 +217,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new dark color object for the control from the specified color.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Color" /> that represents the dark color on the control.</para>
+        </returns>
         <param name="baseColor">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Color" /> to be darkened. </param>
       </Docs>
@@ -1700,7 +1718,6 @@
         <Parameter Name="baseColor" Type="System.Drawing.Color" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the specified <see cref="T:System.Drawing.Color" /> is one of the <see cref="T:System.Drawing.SystemColors" />, the color is converted to a <see cref="P:System.Drawing.SystemColors.ControlLight" /> color; otherwise, the color's luminosity value is decreased.</para>
@@ -1709,6 +1726,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new light color object for the control from the specified color.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Color" /> that represents the light color on the control.</para>
+        </returns>
         <param name="baseColor">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Color" /> to be lightened. </param>
       </Docs>
@@ -1728,7 +1749,6 @@
         <Parameter Name="percOfLightLight" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the specified <see cref="T:System.Drawing.Color" /> is one of the <see cref="T:System.Drawing.SystemColors" />, the color is converted to a <see cref="P:System.Drawing.SystemColors.ControlLight" /> color; otherwise, the color's luminosity value is decreased.</para>
@@ -1737,6 +1757,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new light color object for the control from the specified color and lightens it by the specified percentage.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Color" /> that represents the light color on the control.</para>
+        </returns>
         <param name="baseColor">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Color" /> to be lightened. </param>
         <param name="percOfLightLight">
@@ -1757,7 +1781,6 @@
         <Parameter Name="baseColor" Type="System.Drawing.Color" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the specified <see cref="T:System.Drawing.Color" /> is one of the <see cref="T:System.Drawing.SystemColors" />, the color is converted to the <see cref="P:System.Drawing.SystemColors.ControlLightLight" /> color; otherwise, the color's luminosity value is increased.</para>
@@ -1766,6 +1789,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new light color object for the control from the specified color.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Color" /> that represents the light color on the control.</para>
+        </returns>
         <param name="baseColor">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Color" /> to be lightened. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/CurrencyManager.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/CurrencyManager.xml
index 98fba2d0b56..9ae0dc490bf 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/CurrencyManager.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/CurrencyManager.xml
@@ -188,7 +188,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> for the <see cref="T:System.Windows.Forms.CurrencyManager" /> is used to specify a column in the list.</para>
@@ -197,6 +196,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the property descriptor collection for the underlying list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> for the list.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -217,7 +220,6 @@
         <Parameter Name="listAccessors" Type="System.Collections.ArrayList" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For the <see cref="M:System.Windows.Forms.CurrencyManager.GetListName(System.Collections.ArrayList)" /> method to be successful, the underlying list must be of type <see cref="T:System.ComponentModel.ITypedList" />.</para>
@@ -226,6 +228,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the name of the list supplying the data for the binding using the specified set of bound properties.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If successful, a <see cref="T:System.String" /> containing name of the list supplying the data for the binding; otherwise, an <see cref="F:System.String.Empty" /> string.</para>
+        </returns>
         <param name="listAccessors">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.ArrayList" /> of properties to be found in the data source.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Cursor.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Cursor.xml
index b115bdf6168..35ba97eee79 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Cursor.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Cursor.xml
@@ -184,7 +184,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The handle created as a result of calling this method must be disposed of when you are done with it because it will not be disposed of by the garbage collector.</para>
@@ -193,6 +192,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the handle of this <see cref="T:System.Windows.Forms.Cursor" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IntPtr" /> that represents the cursor's handle.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -314,12 +317,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this cursor is equal to the specified <see cref="T:System.Windows.Forms.Cursor" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this cursor is equal to the specified <see cref="T:System.Windows.Forms.Cursor" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Cursor" /> to compare. </param>
       </Docs>
@@ -352,12 +358,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the hash code for the current <see cref="T:System.Windows.Forms.Cursor" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.Windows.Forms.Cursor" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -440,12 +449,15 @@
         <Parameter Name="right" Type="System.Windows.Forms.Cursor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether two instances of the <see cref="T:System.Windows.Forms.Cursor" /> class are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if two instances of the <see cref="T:System.Windows.Forms.Cursor" /> class are equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Cursor" /> to compare. </param>
         <param name="right">
@@ -467,12 +479,15 @@
         <Parameter Name="right" Type="System.Windows.Forms.Cursor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether two instances of the <see cref="T:System.Windows.Forms.Cursor" /> class are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if two instances of the <see cref="T:System.Windows.Forms.Cursor" /> class are not equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Cursor" /> to compare. </param>
         <param name="right">
@@ -612,12 +627,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a human readable string representing this <see cref="T:System.Windows.Forms.Cursor" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that represents this <see cref="T:System.Windows.Forms.Cursor" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/CursorConverter.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/CursorConverter.xml
index 58ee17789aa..c402cb52fa0 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/CursorConverter.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/CursorConverter.xml
@@ -51,12 +51,15 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if this converter can convert an object in the given source type to the native type of the converter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this object can perform the conversion.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A formatter context. This object can be used to extract additional information about the environment this converter is being invoked from. This may be null, so you should always check. Also, properties on the context object may also return null. </param>
         <param name="sourceType">
@@ -78,7 +81,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -87,6 +89,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this converter can convert an object to the given destination type using the context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="destinationType">
@@ -157,12 +163,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection containing a set of standard values for the data type this validator is designed for. This will return null if the data type does not support a standard set of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection containing a standard set of valid values, or null. The default implementation always returns null.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A formatter context. This object can be used to extract additional information about the environment this converter is being invoked from. This may be null, so you should always check. Also, properties on the context object may also return null. </param>
       </Docs>
@@ -181,12 +190,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if this object supports a standard set of values that can be picked from a list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if GetStandardValues should be called to find a common set of values the object supports.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A type descriptor through which additional context may be provided. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataFormats.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataFormats.xml
index b1c3657e4af..8f74b67afbe 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataFormats.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataFormats.xml
@@ -193,7 +193,6 @@
         <Parameter Name="id" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is typically used to register native Clipboard formats.</para>
@@ -204,6 +203,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Windows.Forms.DataFormats.Format" /> with the Windows Clipboard numeric ID and name for the specified ID.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.DataFormats.Format" /> that has the Windows Clipboard numeric ID and the name of the format.</para>
+        </returns>
         <param name="id">
           <attribution license="cc4" from="Microsoft" modified="false" />The format ID. </param>
       </Docs>
@@ -222,7 +225,6 @@
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call <see cref="M:System.Windows.Forms.DataFormats.GetFormat(System.String)" /> with the format name when you need a Windows Clipboard numeric ID for an existing format.</para>
@@ -232,6 +234,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Windows.Forms.DataFormats.Format" /> with the Windows Clipboard numeric ID and name for the specified format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.DataFormats.Format" /> that has the Windows Clipboard numeric ID and the name of the format.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />The format name. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGrid.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGrid.xml
index 65075182732..5c85ea860b1 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGrid.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGrid.xml
@@ -497,7 +497,6 @@
         <Parameter Name="rowNumber" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The grid will deny edit requests if the user already started typing into a cell. In that case, the <see cref="M:System.Windows.Forms.DataGrid.BeginEdit(System.Windows.Forms.DataGridColumnStyle,System.Int32)" /> method will return false.</para>
@@ -506,6 +505,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to put the grid into a state where editing is allowed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the method is successful; otherwise, false.</para>
+        </returns>
         <param name="gridColumn">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.DataGridColumnStyle" /> to edit. </param>
         <param name="rowNumber">
@@ -858,7 +861,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Derived classes should not call the base class's <see cref="M:System.Windows.Forms.Control.CreateAccessibilityInstance" /> method.</para>
@@ -883,6 +885,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Constructs a new instance of the accessibility object for this control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.Control.ControlAccessibleObject" /> for this control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -899,12 +905,15 @@
         <Parameter Name="prop" Type="System.ComponentModel.PropertyDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Windows.Forms.DataGridColumnStyle" /> with the specified <see cref="T:System.ComponentModel.PropertyDescriptor" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Windows.Forms.DataGridColumnStyle" />.</para>
+        </returns>
         <param name="prop">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.PropertyDescriptor" /> to use for creating the grid column style. </param>
       </Docs>
@@ -924,12 +933,15 @@
         <Parameter Name="isDefault" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Windows.Forms.DataGridColumnStyle" /> using the specified <see cref="T:System.ComponentModel.PropertyDescriptor" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Windows.Forms.DataGridColumnStyle" />.</para>
+        </returns>
         <param name="prop">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.PropertyDescriptor" /> to use for creating the grid column style. </param>
         <param name="isDefault">
@@ -1254,7 +1266,6 @@
         <Parameter Name="shouldAbort" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.DataGrid.EndEdit(System.Windows.Forms.DataGridColumnStyle,System.Int32,System.Boolean)" /> method returns false if the user is not editing (typing into) a cell.</para>
@@ -1263,6 +1274,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Requests an end to an edit operation taking place on the <see cref="T:System.Windows.Forms.DataGrid" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the editing operation ceases; otherwise, false.</para>
+        </returns>
         <param name="gridColumn">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.DataGridColumnStyle" /> to cease editing. </param>
         <param name="rowNumber">
@@ -1422,12 +1437,15 @@
         <Parameter Name="dgc" Type="System.Windows.Forms.DataGridCell" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Drawing.Rectangle" /> of the cell specified by <see cref="T:System.Windows.Forms.DataGridCell" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> that defines the current cell's corners.</para>
+        </returns>
         <param name="dgc">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.DataGridCell" /> to look up. </param>
       </Docs>
@@ -1447,7 +1465,6 @@
         <Parameter Name="col" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To retrieve the cell bounds for the currently selected cell, use <see cref="M:System.Windows.Forms.DataGrid.GetCurrentCellBounds" />.</para>
@@ -1456,6 +1473,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Drawing.Rectangle" /> of the cell specified by row and column number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> that defines the current cell's corners.</para>
+        </returns>
         <param name="row">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of the cell's row. </param>
         <param name="col">
@@ -1474,7 +1495,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To retrieve the cell bounds for a cell other than the current cell, use <see cref="Overload:System.Windows.Forms.DataGrid.GetCellBounds" />. </para>
@@ -1483,6 +1503,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Drawing.Rectangle" /> that specifies the four corners of the selected cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> that defines the current cell's corners.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1497,12 +1521,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the string that is the delimiter between columns when row contents are copied to the Clipboard.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string value "\t", which represents a tab used to separate columns in a row. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1677,7 +1704,6 @@
         <Parameter Name="position" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Windows.Forms.DataGrid.HitTestInfo" />, in conjunction with the <see cref="M:System.Windows.Forms.DataGrid.HitTest(System.Int32,System.Int32)" /> method of the <see cref="T:System.Windows.Forms.DataGrid" /> control, is used to determine which part of a <see cref="T:System.Windows.Forms.DataGrid" /> control the user has clicked. The <see cref="T:System.Windows.Forms.DataGrid.HitTestInfo" /> contains the row, column, and part of the grid that was clicked. Additionally, the <see cref="P:System.Windows.Forms.DataGrid.HitTestInfo.Type" /> property returns a <see cref="T:System.Windows.Forms.DataGrid.HitTestType" /> enumeration.</para>
@@ -1687,6 +1713,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets information, such as row and column number of a clicked point on the grid, about the grid using a specific <see cref="T:System.Drawing.Point" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.DataGrid.HitTestInfo" /> that contains specific information about the grid.</para>
+        </returns>
         <param name="position">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Point" /> that represents single x,y coordinate. </param>
       </Docs>
@@ -1706,7 +1736,6 @@
         <Parameter Name="y" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Windows.Forms.DataGrid.HitTestInfo" />, in conjunction with the <see cref="M:System.Windows.Forms.DataGrid.HitTest(System.Int32,System.Int32)" /> method of the <see cref="T:System.Windows.Forms.DataGrid" /> control, is used to determine which part of a <see cref="T:System.Windows.Forms.DataGrid" /> control the user has clicked. The <see cref="T:System.Windows.Forms.DataGrid.HitTestInfo" /> contains the row, column, and part of the grid that was clicked. Additionally, the <see cref="P:System.Windows.Forms.DataGrid.HitTestInfo.Type" /> property returns a <see cref="T:System.Windows.Forms.DataGrid.HitTestType" /> enumeration.</para>
@@ -1716,6 +1745,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets information, such as row and column number of a clicked point on the grid, using the x and y coordinate passed to the method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.DataGrid.HitTestInfo" /> that contains information about the clicked part of the grid.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The horizontal position of the coordinate. </param>
         <param name="y">
@@ -1755,12 +1788,15 @@
         <Parameter Name="rowNumber" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the node of a specified row is expanded or collapsed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the node is expanded; otherwise, false.</para>
+        </returns>
         <param name="rowNumber">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of the row in question. </param>
       </Docs>
@@ -1779,7 +1815,6 @@
         <Parameter Name="row" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method with the <see cref="M:System.Windows.Forms.DataGrid.Select(System.Int32)" />, <see cref="M:System.Windows.Forms.DataGrid.UnSelect(System.Int32)" />, and <see cref="M:System.Windows.Forms.DataGrid.ResetSelection" /> methods to manipulate the selection state of a particular row. </para>
@@ -1788,6 +1823,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether a specified row is selected.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the row is selected; otherwise, false.</para>
+        </returns>
         <param name="row">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of the row you are interested in. </param>
       </Docs>
@@ -3042,7 +3081,6 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method overrides the <see cref="M:System.Windows.Forms.Control.ProcessDialogKey(System.Windows.Forms.Keys)" /> method to implement keyboard navigation of the grid.</para>
@@ -3051,6 +3089,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets or sets a value that indicates whether a key should be processed further.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, the key should be processed; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Keys" /> that contains data about the pressed key. </param>
       </Docs>
@@ -3069,12 +3111,15 @@
         <Parameter Name="ke" Type="System.Windows.Forms.KeyEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes keys for grid navigation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if the key was processed; otherwise false.</para>
+        </returns>
         <param name="ke">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.KeyEventArgs" /> that contains data about the key up or key down event. </param>
       </Docs>
@@ -3113,12 +3158,15 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the Tab key should be processed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the TAB key should be processed; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Keys" /> that contains data about which the pressed key. </param>
       </Docs>
@@ -3634,7 +3682,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You typically use this method if you are either creating a designer for the <see cref="T:System.Windows.Forms.DataGrid" /> or creating your own control incorporating the <see cref="T:System.Windows.Forms.DataGrid" />.</para>
@@ -3643,6 +3690,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the <see cref="P:System.Windows.Forms.DataGrid.AlternatingBackColor" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property value has changed from its default; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -3657,7 +3708,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You typically use this method if you are either creating a designer for the <see cref="T:System.Windows.Forms.DataGrid" /> or creating your own control incorporating the <see cref="T:System.Windows.Forms.DataGrid" />.</para>
@@ -3666,6 +3716,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the <see cref="P:System.Windows.Forms.DataGrid.BackgroundColor" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property value has changed from its default; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -3680,7 +3734,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You typically use this method only if you are either creating a designer for the <see cref="T:System.Windows.Forms.DataGrid" />, or creating your own control incorporating the <see cref="T:System.Windows.Forms.DataGrid" />.</para>
@@ -3689,6 +3742,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the <see cref="P:System.Windows.Forms.DataGrid.CaptionBackColor" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property value has been changed from its default; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -3703,7 +3760,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You typically use this method only if you are either creating a designer for the <see cref="T:System.Windows.Forms.DataGrid" />, or creating your own control incorporating the <see cref="T:System.Windows.Forms.DataGrid" />.</para>
@@ -3712,6 +3768,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the <see cref="P:System.Windows.Forms.DataGrid.CaptionForeColor" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property value has been changed from its default; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -3726,7 +3786,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You typically use this method if you are either creating a designer for the <see cref="T:System.Windows.Forms.DataGrid" /> or creating your own control incorporating the <see cref="T:System.Windows.Forms.DataGrid" />.</para>
@@ -3735,6 +3794,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the <see cref="P:System.Windows.Forms.DataGrid.GridLineColor" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property value has changed from its default; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -3749,7 +3812,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You typically use this method if you are either creating a designer for the <see cref="T:System.Windows.Forms.DataGrid" /> or creating your own control incorporating the <see cref="T:System.Windows.Forms.DataGrid" />.</para>
@@ -3758,6 +3820,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the <see cref="P:System.Windows.Forms.DataGrid.HeaderBackColor" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property value has changed from its default; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -3772,7 +3838,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You typically use this method if you are either creating a designer for the <see cref="T:System.Windows.Forms.DataGrid" /> or creating your own control incorporating the <see cref="T:System.Windows.Forms.DataGrid" />.</para>
@@ -3781,6 +3846,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the <see cref="P:System.Windows.Forms.DataGrid.HeaderFont" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property value has changed from its default; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -3795,7 +3864,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You typically use this method if you are either creating a designer for the <see cref="T:System.Windows.Forms.DataGrid" /> or creating your own control incorporating the <see cref="T:System.Windows.Forms.DataGrid" />.</para>
@@ -3804,6 +3872,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the <see cref="P:System.Windows.Forms.DataGrid.HeaderForeColor" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property value has changed from its default; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -3818,7 +3890,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You typically use this method if you are either creating a designer for the <see cref="T:System.Windows.Forms.DataGrid" /> or creating your own control incorporating the <see cref="T:System.Windows.Forms.DataGrid" />.</para>
@@ -3827,6 +3898,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the <see cref="P:System.Windows.Forms.DataGrid.LinkHoverColor" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property value has changed from its default; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -3841,7 +3916,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You typically use this method only if you are either creating a designer for the <see cref="T:System.Windows.Forms.DataGrid" />, or creating your own control incorporating the <see cref="T:System.Windows.Forms.DataGrid" />.</para>
@@ -3850,6 +3924,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the <see cref="P:System.Windows.Forms.DataGrid.ParentRowsBackColor" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property value has been changed from its default; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -3864,7 +3942,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You typically use this method only if you are either creating a designer for the <see cref="T:System.Windows.Forms.DataGrid" />, or creating your own control incorporating the <see cref="T:System.Windows.Forms.DataGrid" />.</para>
@@ -3873,6 +3950,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the <see cref="P:System.Windows.Forms.DataGrid.ParentRowsForeColor" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property value has been changed from its default; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -3887,7 +3968,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You typically use this method if you are either creating a designer for the <see cref="T:System.Windows.Forms.DataGrid" /> or creating your own control incorporating the <see cref="T:System.Windows.Forms.DataGrid" />.</para>
@@ -3896,6 +3976,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the <see cref="P:System.Windows.Forms.DataGrid.PreferredRowHeight" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property value has changed from its default; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -3910,7 +3994,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You typically use this method if you are either creating a designer for the <see cref="T:System.Windows.Forms.DataGrid" /> or creating your own control incorporating the <see cref="T:System.Windows.Forms.DataGrid" />.</para>
@@ -3919,6 +4002,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the <see cref="P:System.Windows.Forms.DataGrid.SelectionBackColor" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property value has changed from its default; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -3933,7 +4020,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You typically use this method if you are either creating a designer for the <see cref="T:System.Windows.Forms.DataGrid" /> or creating your own control incorporating the <see cref="T:System.Windows.Forms.DataGrid" />.</para>
@@ -3942,6 +4028,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the <see cref="P:System.Windows.Forms.DataGrid.SelectionForeColor" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property value has changed from its default; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridBoolColumn.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridBoolColumn.xml
index 480e86254c5..d8d1af5228f 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridBoolColumn.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridBoolColumn.xml
@@ -174,12 +174,15 @@
         <Parameter Name="rowNum" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initiates a request to complete an editing procedure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the editing procedure committed successfully; otherwise, false.</para>
+        </returns>
         <param name="dataSource">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.DataView" /> of the edited column. </param>
         <param name="rowNum">
@@ -328,12 +331,15 @@
         <Parameter Name="row" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value at the specified row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value, typed as <see cref="T:System.Object" />.</para>
+        </returns>
         <param name="lm">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.CurrencyManager" /> for the column. </param>
         <param name="row">
@@ -352,12 +358,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the height of a cell in a column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The height of the column. The default is 16.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetPreferredHeight">
@@ -375,12 +384,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the height used when resizing columns.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The height used to automatically resize cells in a column.</para>
+        </returns>
         <param name="g">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Graphics" /> that draws on the screen. </param>
         <param name="value">
@@ -402,7 +414,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.DataGridBoolColumn.GetPreferredSize(System.Drawing.Graphics,System.Object)" /> method allows you to resize the column based on the value displayed. For example, if a cell contains an especially large value, you can use the <see cref="M:System.Windows.Forms.DataGridBoolColumn.GetPreferredSize(System.Drawing.Graphics,System.Object)" /> method to return the optimum size of the cell based on the value. The optimum size takes into account not only the size of the string, but also the font used to display it.</para>
@@ -411,6 +422,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the optimum width and height of a cell given a specific value to contain.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Size" /> that contains the drawing information for the cell.</para>
+        </returns>
         <param name="g">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Graphics" /> that draws the cell. </param>
         <param name="value">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridCell.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridCell.xml
index ae6faf705e9..c0c34453b0f 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridCell.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridCell.xml
@@ -76,12 +76,15 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the <see cref="T:System.Windows.Forms.DataGridCell" /> is identical to a second <see cref="T:System.Windows.Forms.DataGridCell" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the second object is identical to the first; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />An object you are to comparing. </param>
       </Docs>
@@ -98,12 +101,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a hash value that can be added to a <see cref="T:System.Collections.Hashtable" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A number that uniquely identifies the <see cref="T:System.Windows.Forms.DataGridCell" /> in a <see cref="T:System.Collections.Hashtable" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -140,12 +146,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the row number and column number of the cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the row number and column number.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridColumnStyle.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridColumnStyle.xml
index 1f28151e83b..9d940588560 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridColumnStyle.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridColumnStyle.xml
@@ -387,12 +387,15 @@
         <Parameter Name="rowNum" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, initiates a request to complete an editing procedure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the editing procedure committed successfully; otherwise, false.</para>
+        </returns>
         <param name="dataSource">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.CurrencyManager" /> for the <see cref="T:System.Windows.Forms.DataGridColumnStyle" />. </param>
         <param name="rowNum">
@@ -429,7 +432,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This property is called by a <see cref="T:System.Windows.Forms.DataGridTableStyle" /> when its <see cref="T:System.Windows.Forms.DataGrid" /> property changes. This property is required because any child controls hosted by a <see cref="T:System.Windows.Forms.DataGridColumnStyle" /> must be added to the <see cref="T:System.Windows.Forms.DataGrid" /> control's ControlCollection.</para>
@@ -438,6 +440,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Windows.Forms.AccessibleObject" /> for the column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Windows.Forms.AccessibleObject" /> for the column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -682,7 +688,6 @@
         <Parameter Name="rowNum" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the data source for the column is a <see cref="T:System.Data.DataTable" />, use the <see cref="E:System.Data.DataTable.ColumnChanging" /> or <see cref="E:System.Data.DataTable.RowChanging" /> events to determine when a row or column value has changed.</para>
@@ -691,6 +696,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value in the specified row from the specified <see cref="T:System.Windows.Forms.CurrencyManager" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> containing the value.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.CurrencyManager" /> containing the data. </param>
         <param name="rowNum">
@@ -709,12 +718,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, gets the minimum height of a row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum height of a row.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetPreferredHeight">
@@ -732,7 +744,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.DataGridColumnStyle.GetPreferredSize(System.Drawing.Graphics,System.Object)" /> will usually be invoked from a mouse down event to resize a column's height for a long string.</para>
@@ -741,6 +752,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, gets the height used for automatically resizing columns.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The height used for auto resizing a cell.</para>
+        </returns>
         <param name="g">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Graphics" /> object. </param>
         <param name="value">
@@ -762,7 +777,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use <see cref="M:System.Windows.Forms.DataGridColumnStyle.GetPreferredSize(System.Drawing.Graphics,System.Object)" /> to determine the width a column should resize to, given a particular string or numeral.</para>
@@ -771,6 +785,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, gets the width and height of the specified value. The width and height are used when the user navigates to <see cref="T:System.Windows.Forms.DataGridTableStyle" /> using the <see cref="T:System.Windows.Forms.DataGridColumnStyle" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Size" /> that contains the dimensions of the cell.</para>
+        </returns>
         <param name="g">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Graphics" /> object. </param>
         <param name="value">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridPreferredColumnWidthTypeConverter.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridPreferredColumnWidthTypeConverter.xml
index 0bf6cbc9460..f03aa6be05a 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridPreferredColumnWidthTypeConverter.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridPreferredColumnWidthTypeConverter.xml
@@ -45,12 +45,15 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that specifies whether the converter can convert an object in the given source type to the native type of the converter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="sourceType">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridTableStyle.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridTableStyle.xml
index a621c6d89b6..936f9606216 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridTableStyle.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridTableStyle.xml
@@ -334,7 +334,6 @@
         <Parameter Name="rowNumber" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.DataGridTableStyle.BeginEdit(System.Windows.Forms.DataGridColumnStyle,System.Int32)" /> method is intended to notify the <see cref="T:System.Windows.Forms.DataGrid" /> control when the user has begun an editing operation. When the control is in edit mode, multiple edits can be made and the constraints will be temporarily unenforced.</para>
@@ -344,6 +343,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Requests an edit operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if the operation succeeds; otherwise, false.</para>
+        </returns>
         <param name="gridColumn">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.DataGridColumnStyle" /> to edit. </param>
         <param name="rowNumber">
@@ -417,12 +420,15 @@
         <Parameter Name="prop" Type="System.ComponentModel.PropertyDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Windows.Forms.DataGridColumnStyle" />, using the specified property descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created <see cref="T:System.Windows.Forms.DataGridColumnStyle" />.</para>
+        </returns>
         <param name="prop">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.PropertyDescriptor" /> used to create the column style object. </param>
       </Docs>
@@ -442,12 +448,15 @@
         <Parameter Name="isDefault" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Windows.Forms.DataGridColumnStyle" /> using the specified property descriptor. Specifies whether the <see cref="T:System.Windows.Forms.DataGridColumnStyle" /> is a default column style.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created <see cref="T:System.Windows.Forms.DataGridColumnStyle" />.</para>
+        </returns>
         <param name="prop">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.PropertyDescriptor" /> used to create the column style object. </param>
         <param name="isDefault">
@@ -537,7 +546,6 @@
         <Parameter Name="shouldAbort" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Similar to the <see cref="M:System.Windows.Forms.DataGridTableStyle.BeginEdit(System.Windows.Forms.DataGridColumnStyle,System.Int32)" /> method, the <see cref="M:System.Windows.Forms.DataGridTableStyle.EndEdit(System.Windows.Forms.DataGridColumnStyle,System.Int32,System.Boolean)" /> method is intended to notify the <see cref="T:System.Windows.Forms.DataGrid" /> when an edit operation is ending.</para>
@@ -546,6 +554,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Requests an end to an edit operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the edit operation ends successfully; otherwise, false.</para>
+        </returns>
         <param name="gridColumn">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.DataGridColumnStyle" /> to edit. </param>
         <param name="rowNumber">
@@ -2102,7 +2114,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You typically use this method if you are either creating a designer for the <see cref="T:System.Windows.Forms.DataGridTableStyle" /> or creating your own control incorporating the <see cref="T:System.Windows.Forms.DataGridTableStyle" />.</para>
@@ -2111,6 +2122,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the <see cref="P:System.Windows.Forms.DataGridTableStyle.AlternatingBackColor" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property value has changed from its default; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -2125,7 +2140,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You typically use this method if you are either creating a designer for the <see cref="T:System.Windows.Forms.DataGridTableStyle" /> or creating your own control incorporating the <see cref="T:System.Windows.Forms.DataGridTableStyle" />.</para>
@@ -2134,6 +2148,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the <see cref="P:System.Windows.Forms.DataGridTableStyle.BackColor" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property value has changed from its default; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -2148,7 +2166,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You typically use this method if you are either creating a designer for the <see cref="T:System.Windows.Forms.DataGridTableStyle" /> or creating your own control incorporating the <see cref="T:System.Windows.Forms.DataGridTableStyle" />.</para>
@@ -2157,6 +2174,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the <see cref="P:System.Windows.Forms.DataGridTableStyle.ForeColor" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property value has changed from its default; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -2171,7 +2192,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You typically use this method if you are either creating a designer for the <see cref="T:System.Windows.Forms.DataGridTableStyle" /> or creating your own control incorporating the <see cref="T:System.Windows.Forms.DataGridTableStyle" />.</para>
@@ -2180,6 +2200,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the <see cref="P:System.Windows.Forms.DataGridTableStyle.GridLineColor" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property value has changed from its default; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -2194,7 +2218,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You typically use this method if you are either creating a designer for the <see cref="T:System.Windows.Forms.DataGridTableStyle" /> or creating your own control incorporating the <see cref="T:System.Windows.Forms.DataGridTableStyle" />.</para>
@@ -2203,6 +2226,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the <see cref="P:System.Windows.Forms.DataGridTableStyle.HeaderBackColor" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property value has changed from its default; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -2217,7 +2244,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You typically use this method if you are either creating a designer for the <see cref="T:System.Windows.Forms.DataGridTableStyle" /> or creating your own control incorporating the <see cref="T:System.Windows.Forms.DataGridTableStyle" />.</para>
@@ -2226,6 +2252,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the <see cref="P:System.Windows.Forms.DataGridTableStyle.HeaderForeColor" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property value has changed from its default; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -2240,7 +2270,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You typically use this method if you are either creating a designer for the <see cref="T:System.Windows.Forms.DataGridTableStyle" /> or creating your own control incorporating the <see cref="T:System.Windows.Forms.DataGridTableStyle" />.</para>
@@ -2249,6 +2278,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the <see cref="P:System.Windows.Forms.DataGridTableStyle.LinkColor" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property value has changed from its default; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -2263,7 +2296,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You typically use this method if you are either creating a designer for the <see cref="T:System.Windows.Forms.DataGridTableStyle" /> or creating your own control incorporating the <see cref="T:System.Windows.Forms.DataGridTableStyle" />.</para>
@@ -2272,6 +2304,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the <see cref="P:System.Windows.Forms.DataGridTableStyle.LinkHoverColor" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property value has changed from its default; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -2286,7 +2322,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You typically use this method if you are either creating a designer for the <see cref="T:System.Windows.Forms.DataGridTableStyle" /> or creating your own control incorporating the <see cref="T:System.Windows.Forms.DataGridTableStyle" />.</para>
@@ -2295,6 +2330,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the <see cref="P:System.Windows.Forms.DataGridTableStyle.PreferredRowHeight" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property value has changed from its default; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -2309,7 +2348,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You typically use this method if you are either creating a designer for the <see cref="T:System.Windows.Forms.DataGridTableStyle" /> or creating your own control incorporating the <see cref="T:System.Windows.Forms.DataGridTableStyle" />.</para>
@@ -2318,6 +2356,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the <see cref="P:System.Windows.Forms.DataGridTableStyle.SelectionBackColor" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property value has changed from its default; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -2332,7 +2374,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You typically use this method if you are either creating a designer for the <see cref="T:System.Windows.Forms.DataGridTableStyle" /> or creating your own control incorporating the <see cref="T:System.Windows.Forms.DataGridTableStyle" />.</para>
@@ -2341,6 +2382,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the <see cref="P:System.Windows.Forms.DataGridTableStyle.SelectionForeColor" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property value has changed from its default; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridTextBoxColumn.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridTextBoxColumn.xml
index 0d1bf03eb30..45dd8a7608c 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridTextBoxColumn.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridTextBoxColumn.xml
@@ -190,7 +190,6 @@
         <Parameter Name="rowNum" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method checks to ensure that an edit is indeed occurring. If so, it formats the value appropriately. If the value is null, the method enters <see cref="F:System.Convert.DBNull" /> into the column; otherwise, it uses the <see cref="M:System.Windows.Forms.DataGridColumnStyle.SetColumnValueAtRow(System.Windows.Forms.CurrencyManager,System.Int32,System.Object)" /> method to commit the value.</para>
@@ -200,6 +199,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inititates a request to complete an editing procedure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value was successfully committed; otherwise, false.</para>
+        </returns>
         <param name="dataSource">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.CurrencyManager" /> of the <see cref="T:System.Windows.Forms.DataGrid" /> control the column belongs to. </param>
         <param name="rowNum">
@@ -390,7 +393,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The value returned by <see cref="M:System.Windows.Forms.DataGridTextBoxColumn.GetMinimumHeight" /> is calculated by adding the size of the column's font plus a margin value.</para>
@@ -399,6 +401,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the height of a cell in a <see cref="T:System.Windows.Forms.DataGridColumnStyle" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The height of a cell.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetPreferredHeight">
@@ -416,12 +422,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the height to be used in for automatically resizing columns.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The height the cells automatically resize to.</para>
+        </returns>
         <param name="g">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Graphics" /> object used to draw shapes on the screen. </param>
         <param name="value">
@@ -443,7 +452,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The optimum width and height is calculated by measuring the string size, taking into account its font and attributes, and adding margin values.</para>
@@ -452,6 +460,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the optimum width and height of the cell in a specified row relative to the specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Size" /> that contains the dimensions of the cell.</para>
+        </returns>
         <param name="g">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Graphics" /> object used to draw shapes on the screen. </param>
         <param name="value">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridView.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridView.xml
index adbc5514051..b65a4b0d245 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridView.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridView.xml
@@ -314,7 +314,6 @@
         <Parameter Name="isLastVisibleColumn" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -324,6 +323,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adjusts the <see cref="T:System.Windows.Forms.DataGridViewAdvancedBorderStyle" /> for a column header cell of a <see cref="T:System.Windows.Forms.DataGridView" /> that is currently being painted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.DataGridViewAdvancedBorderStyle" /> that represents the border style for the current column header.</para>
+        </returns>
         <param name="dataGridViewAdvancedBorderStyleInput">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.DataGridViewAdvancedBorderStyle" /> that that represents the column header border style to modify.</param>
         <param name="dataGridViewAdvancedBorderStylePlaceholder">
@@ -773,7 +776,6 @@
         <Parameter Name="includeInvisibleCells" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -783,6 +785,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether all the <see cref="T:System.Windows.Forms.DataGridView" /> cells are currently selected.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if all cells (or all visible cells) are selected or if there are no cells (or no visible cells); otherwise, false.</para>
+        </returns>
         <param name="includeInvisibleCells">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include the rows and columns with <see cref="P:System.Windows.Forms.DataGridViewBand.Visible" /> property values of false; otherwise, false. </param>
       </Docs>
@@ -1883,7 +1889,6 @@
         <Parameter Name="selectAll" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1895,6 +1900,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Puts the current cell in edit mode.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current cell is already in edit mode or successfully enters edit mode; otherwise, false.</para>
+        </returns>
         <param name="selectAll">
           <attribution license="cc4" from="Microsoft" modified="false" />true to select all the cell's contents; false to not select any contents.</param>
       </Docs>
@@ -1958,13 +1967,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Cancels edit mode for the currently selected cell and discards any changes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the cancel was successful; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -3753,7 +3765,6 @@
         <Parameter Name="context" Type="System.Windows.Forms.DataGridViewDataErrorContexts" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3763,6 +3774,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Commits changes in the current cell to the data cache without ending edit mode.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the changes were committed; otherwise false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Windows.Forms.DataGridViewDataErrorContexts" /> values that specifies the context in which an error can occur. </param>
       </Docs>
@@ -3778,13 +3793,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessible object for the <see cref="T:System.Windows.Forms.DataGridView" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.DataGridView.DataGridViewAccessibleObject" /> for the <see cref="T:System.Windows.Forms.DataGridView" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -3798,13 +3816,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new <see cref="T:System.Windows.Forms.DataGridViewColumnCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An empty <see cref="T:System.Windows.Forms.DataGridViewColumnCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -3823,7 +3844,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3833,6 +3853,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new <see cref="T:System.Windows.Forms.Control.ControlCollection" /> that can be cast to type <see cref="T:System.Windows.Forms.DataGridView.DataGridViewControlCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An empty <see cref="T:System.Windows.Forms.Control.ControlCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -3846,13 +3870,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new <see cref="T:System.Windows.Forms.DataGridViewRowCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An empty <see cref="T:System.Windows.Forms.DataGridViewRowCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -4312,13 +4339,16 @@
         <Parameter Name="includePartialColumns" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of columns displayed to the user.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of columns displayed to the user.</para>
+        </returns>
         <param name="includePartialColumns">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include partial columns in the displayed column count; otherwise, false. </param>
       </Docs>
@@ -4336,13 +4366,16 @@
         <Parameter Name="includePartialRow" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of rows displayed to the user.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows displayed to the user.</para>
+        </returns>
         <param name="includePartialRow">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include partial rows in the displayed row count; otherwise, false. </param>
       </Docs>
@@ -4559,7 +4592,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4571,6 +4603,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Commits and ends the edit operation on the current cell using the default error context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the edit operation is committed and ended; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -4586,7 +4622,6 @@
         <Parameter Name="context" Type="System.Windows.Forms.DataGridViewDataErrorContexts" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4597,6 +4632,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Commits and ends the edit operation on the current cell using the specified error context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the edit operation is committed and ended; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Windows.Forms.DataGridViewDataErrorContexts" /> values that specifies the context in which an error can occur. </param>
       </Docs>
@@ -4876,7 +4915,6 @@
         <Parameter Name="includeFilter" Type="System.Windows.Forms.DataGridViewElementStates" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4886,6 +4924,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the number of cells that satisfy the provided filter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of cells that match the <paramref name="includeFilter" /> parameter.</para>
+        </returns>
         <param name="includeFilter">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of the <see cref="T:System.Windows.Forms.DataGridViewElementStates" /> values specifying the cells to count.</param>
       </Docs>
@@ -4905,7 +4947,6 @@
         <Parameter Name="cutOverflow" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4915,6 +4956,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the rectangle that represents the display area for a cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Rectangle" /> that represents the display rectangle of the cell.</para>
+        </returns>
         <param name="columnIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The column index for the desired cell. </param>
         <param name="rowIndex">
@@ -4934,7 +4979,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4945,6 +4989,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the formatted values that represent the contents of the selected cells for copying to the <see cref="T:System.Windows.Forms.Clipboard" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.DataObject" /> that represents the contents of the selected cells.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -4961,13 +5009,16 @@
         <Parameter Name="cutOverflow" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the rectangle that represents the display area for a column, as determined by the column index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Rectangle" /> that represents the display rectangle of the column.</para>
+        </returns>
         <param name="columnIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The column index for the desired cell. </param>
         <param name="cutOverflow">
@@ -4988,13 +5039,16 @@
         <Parameter Name="cutOverflow" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the rectangle that represents the display area for a row, as determined by the row index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Rectangle" /> that represents the display rectangle of the row.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The row index for the desired cell. </param>
         <param name="cutOverflow">
@@ -5058,7 +5112,6 @@
         <Parameter Name="y" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -5068,6 +5121,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns location information, such as row and column indices, given x- and y-coordinates.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.DataGridView.HitTestInfo" /> that contains the location information. </para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate. </param>
         <param name="y">
@@ -5327,7 +5384,6 @@
         <Parameter Name="charCode" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -5337,6 +5393,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a character is an input character that the <see cref="T:System.Windows.Forms.DataGridView" /> recognizes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character is recognized as an input character; otherwise, false.</para>
+        </returns>
         <param name="charCode">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to test.</param>
       </Docs>
@@ -9546,7 +9606,6 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -9556,6 +9615,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the A key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key was processed; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Windows.Forms.Keys" /> values that represents the key or keys to process.</param>
       </Docs>
@@ -9573,7 +9636,6 @@
         <Parameter Name="e" Type="System.Windows.Forms.KeyEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -9583,6 +9645,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes keys used for navigating in the <see cref="T:System.Windows.Forms.DataGridView" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key was processed; otherwise, false.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />Contains information about the key that was pressed.</param>
       </Docs>
@@ -9600,7 +9666,6 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -9610,6 +9675,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the DELETE key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key was processed; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Windows.Forms.Keys" /> values that represents the key or keys to process.</param>
       </Docs>
@@ -9627,7 +9696,6 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -9638,6 +9706,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes keys, such as the TAB, ESCAPE, ENTER, and ARROW keys, used to control dialog boxes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key was processed; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Windows.Forms.Keys" /> values that represents the key or keys to process.</param>
       </Docs>
@@ -9655,13 +9727,16 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the DOWN ARROW key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key was processed; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Windows.Forms.Keys" /> values that represents the key or keys to process.</param>
       </Docs>
@@ -9679,13 +9754,16 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the END key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key was processed; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Windows.Forms.Keys" /> values that represents the key or keys to process.</param>
       </Docs>
@@ -9703,13 +9781,16 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the ENTER key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key was processed; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Windows.Forms.Keys" /> values that represents the key or keys to process.</param>
       </Docs>
@@ -9727,13 +9808,16 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the ESC key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key was processed; otherwise, false. </para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Windows.Forms.Keys" /> values that represents the key or keys to process.</param>
       </Docs>
@@ -9751,13 +9835,16 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the F2 key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key was processed; otherwise, false. </para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Windows.Forms.Keys" /> values that represents the key or keys to process.</param>
       </Docs>
@@ -9775,13 +9862,16 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the HOME key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key was processed; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />The key that was pressed.</param>
       </Docs>
@@ -9799,13 +9889,16 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the INSERT key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key was processed; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.Keys" /> values that represents the key to process.</param>
       </Docs>
@@ -9863,13 +9956,16 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the LEFT ARROW key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key was processed; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Windows.Forms.Keys" /> values that represents the key or keys to process.</param>
       </Docs>
@@ -9887,13 +9983,16 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the PAGE DOWN key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key was processed; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Windows.Forms.Keys" /> values that represents the key or keys to process.</param>
       </Docs>
@@ -9911,13 +10010,16 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the PAGE UP key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key was processed; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Windows.Forms.Keys" /> values that represents the key or keys to process.</param>
       </Docs>
@@ -9935,13 +10037,16 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the RIGHT ARROW key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key was processed; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Windows.Forms.Keys" /> values that represents the key or keys to process.</param>
       </Docs>
@@ -9959,13 +10064,16 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the SPACEBAR.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key was processed; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.Keys" /> values that represents the key to process.</param>
       </Docs>
@@ -9983,13 +10091,16 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the TAB key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key was processed; otherwise, false. </para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Windows.Forms.Keys" /> values that represents the key or keys to process.</param>
       </Docs>
@@ -10007,13 +10118,16 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the UP ARROW key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key was processed; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Windows.Forms.Keys" /> values that represents the key or keys to process.</param>
       </Docs>
@@ -10031,13 +10145,16 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the 0 key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key was processed; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Windows.Forms.Keys" /> values that represents the key or keys to process.</param>
       </Docs>
@@ -10104,7 +10221,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -10114,6 +10230,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Refreshes the value of the current cell with the underlying cell value when the cell is in edit mode, discarding any previous value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if successful; false if a <see cref="E:System.Windows.Forms.DataGridView.DataError" /> event occurred.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -11558,7 +11678,6 @@ if (rowToDelete &gt; -1)
         <Parameter Name="throughMouseClick" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -11569,6 +11688,10 @@ if (rowToDelete &gt; -1)
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the currently active cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current cell was successfully set; otherwise, false.</para>
+        </returns>
         <param name="columnIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the column containing the cell.</param>
         <param name="rowIndex">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewAdvancedBorderStyle.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewAdvancedBorderStyle.xml
index 453e811e69b..90441c2912f 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewAdvancedBorderStyle.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewAdvancedBorderStyle.xml
@@ -92,13 +92,16 @@
         <Parameter Name="other" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified object is equal to the current <see cref="T:System.Windows.Forms.DataGridViewAdvancedBorderStyle" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="other" /> is a <see cref="T:System.Windows.Forms.DataGridViewAdvancedBorderStyle" /> and the values for the <see cref="P:System.Windows.Forms.DataGridViewAdvancedBorderStyle.Top" />, <see cref="P:System.Windows.Forms.DataGridViewAdvancedBorderStyle.Bottom" />, <see cref="P:System.Windows.Forms.DataGridViewAdvancedBorderStyle.Left" />, and <see cref="P:System.Windows.Forms.DataGridViewAdvancedBorderStyle.Right" /> properties are equal to their counterpart in the current <see cref="T:System.Windows.Forms.DataGridViewAdvancedBorderStyle" />; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Object" /> to be compared.</param>
       </Docs>
@@ -172,7 +175,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.DataGridViewAdvancedBorderStyle" /> instance is cast to an <see cref="T:System.ICloneable" /> interface.</para>
@@ -181,6 +183,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new object that is a copy of the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Top">
@@ -210,7 +216,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -220,6 +225,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the <see cref="T:System.Windows.Forms.DataGridViewAdvancedBorderStyle" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the <see cref="T:System.Windows.Forms.DataGridViewAdvancedBorderStyle" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewBand.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewBand.xml
index d63ead16c06..19007384bc7 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewBand.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewBand.xml
@@ -38,7 +38,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -48,6 +47,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this band.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the cloned <see cref="T:System.Windows.Forms.DataGridViewBand" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -535,7 +538,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -545,6 +547,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current band.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that represents the current <see cref="T:System.Windows.Forms.DataGridViewBand" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewButtonCell.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewButtonCell.xml
index 110250a7c71..f56401b3b19 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewButtonCell.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewButtonCell.xml
@@ -52,7 +52,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -62,6 +61,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the cloned <see cref="T:System.Windows.Forms.DataGridViewButtonCell" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -75,7 +78,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -88,6 +90,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessible object for the <see cref="T:System.Windows.Forms.DataGridViewButtonCell" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.DataGridViewButtonCell.DataGridViewButtonCellAccessibleObject" /> for the <see cref="T:System.Windows.Forms.DataGridViewButtonCell" />. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -242,7 +248,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -252,6 +257,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the text associated with the button.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the <see cref="T:System.Windows.Forms.DataGridViewButtonCell" /> or the <see cref="P:System.Windows.Forms.DataGridViewButtonColumn.Text" /> value of the owning column if <see cref="P:System.Windows.Forms.DataGridViewButtonCell.UseColumnTextForButtonValue" /> is true. </para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the cell's parent row.</param>
       </Docs>
@@ -270,7 +279,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -281,6 +289,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a row is unshared if a key is pressed while the focus is on a cell in the row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the user pressed the SPACE key without modifier keys; otherwise, false.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.KeyEventArgs" /> that contains the event data. </param>
         <param name="rowIndex">
@@ -301,7 +313,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -312,6 +323,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a row is unshared when a key is released while the focus is on a cell in the row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the user released the SPACE key; otherwise, false.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.KeyEventArgs" /> that contains the event data. </param>
         <param name="rowIndex">
@@ -331,7 +346,6 @@
         <Parameter Name="e" Type="System.Windows.Forms.DataGridViewCellMouseEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -342,6 +356,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a row will be unshared when the mouse button is held down while the pointer is on a cell in the row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the user pressed the left mouse button; otherwise, false.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.DataGridViewCellMouseEventArgs" /> that contains the event data.</param>
       </Docs>
@@ -359,7 +377,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -370,6 +387,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a row will be unshared when the mouse pointer moves over a cell in the row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the cell was the last cell receiving a mouse click; otherwise, false.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The row index of the current cell, or -1 if the cell is not owned by a row.</param>
       </Docs>
@@ -387,7 +408,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -398,6 +418,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a row will be unshared when the mouse pointer leaves the row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the button displayed by the cell is in the pressed state; otherwise, false.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The row index of the current cell, or -1 if the cell is not owned by a row.</param>
       </Docs>
@@ -415,7 +439,6 @@
         <Parameter Name="e" Type="System.Windows.Forms.DataGridViewCellMouseEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -426,6 +449,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a row will be unshared when the mouse button is released while the pointer is on a cell in the row. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the left mouse button was released; otherwise, false.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.DataGridViewCellMouseEventArgs" /> that contains the event data.</param>
       </Docs>
@@ -689,7 +716,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -699,6 +725,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the string representation of the cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that represents the current cell.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewButtonColumn.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewButtonColumn.xml
index 4e9f1f6d961..daa9c8eb756 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewButtonColumn.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewButtonColumn.xml
@@ -118,7 +118,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -128,6 +127,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the cloned <see cref="T:System.Windows.Forms.DataGridViewButtonColumn" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewCell.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewCell.xml
index 6f8943e40a1..46db224232b 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewCell.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewCell.xml
@@ -92,7 +92,6 @@
         <Parameter Name="isFirstDisplayedRow" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -103,6 +102,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Modifies the input cell border style according to the specified criteria. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified <see cref="T:System.Windows.Forms.DataGridViewAdvancedBorderStyle" />.</para>
+        </returns>
         <param name="dataGridViewAdvancedBorderStyleInput">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.DataGridViewAdvancedBorderStyle" /> that represents the cell border style to modify.</param>
         <param name="dataGridViewAdvancedBorderStylePlaceholder">
@@ -135,7 +138,6 @@
         <Parameter Name="advancedBorderStyle" Type="System.Windows.Forms.DataGridViewAdvancedBorderStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -154,6 +156,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Drawing.Rectangle" /> that represents the widths of all the cell margins. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> that represents the widths of all the cell margins.</para>
+        </returns>
         <param name="advancedBorderStyle">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.DataGridViewAdvancedBorderStyle" /> that the margins are to be calculated for. </param>
       </Docs>
@@ -171,7 +177,6 @@
         <Parameter Name="e" Type="System.Windows.Forms.DataGridViewCellEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -182,6 +187,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the cell's row will be unshared when the cell is clicked.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the row will be unshared, otherwise, false. The base <see cref="T:System.Windows.Forms.DataGridViewCell" /> class always returns false.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.DataGridViewCellEventArgs" /> containing the data passed to the <see cref="M:System.Windows.Forms.DataGridViewCell.OnClick(System.Windows.Forms.DataGridViewCellEventArgs)" /> method.</param>
       </Docs>
@@ -197,7 +206,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -207,6 +215,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the cloned <see cref="T:System.Windows.Forms.DataGridViewCell" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -273,7 +285,6 @@
         <Parameter Name="e" Type="System.Windows.Forms.DataGridViewCellEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -284,6 +295,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the cell's row will be unshared when the cell's content is clicked.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the row will be unshared, otherwise, false. The base <see cref="T:System.Windows.Forms.DataGridViewCell" /> class always returns false.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.DataGridViewCellEventArgs" /> containing the data passed to the <see cref="M:System.Windows.Forms.DataGridViewCell.OnContentClick(System.Windows.Forms.DataGridViewCellEventArgs)" /> method.</param>
       </Docs>
@@ -301,7 +316,6 @@
         <Parameter Name="e" Type="System.Windows.Forms.DataGridViewCellEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -312,6 +326,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the cell's row will be unshared when the cell's content is double-clicked.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the row will be unshared, otherwise, false. The base <see cref="T:System.Windows.Forms.DataGridViewCell" /> class always returns false.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.DataGridViewCellEventArgs" /> containing the data passed to the <see cref="M:System.Windows.Forms.DataGridViewCell.OnContentDoubleClick(System.Windows.Forms.DataGridViewCellEventArgs)" /> method.</param>
       </Docs>
@@ -357,7 +375,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -370,6 +387,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessible object for the <see cref="T:System.Windows.Forms.DataGridViewCell" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.DataGridViewCell.DataGridViewCellAccessibleObject" /> for the <see cref="T:System.Windows.Forms.DataGridViewCell" />. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -520,7 +541,6 @@
         <Parameter Name="e" Type="System.Windows.Forms.DataGridViewCellEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -531,6 +551,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the cell's row will be unshared when the cell is double-clicked.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the row will be unshared, otherwise, false. The base <see cref="T:System.Windows.Forms.DataGridViewCell" /> class always returns false.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.DataGridViewCellEventArgs" /> containing the data passed to the <see cref="M:System.Windows.Forms.DataGridViewCell.OnDoubleClick(System.Windows.Forms.DataGridViewCellEventArgs)" /> method.</param>
       </Docs>
@@ -613,7 +637,6 @@
         <Parameter Name="throughMouseClick" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.DataGridViewCell.EnterUnsharesRow(System.Int32,System.Boolean)" /> method is called just before the <see cref="M:System.Windows.Forms.DataGridViewCell.OnEnter(System.Int32,System.Boolean)" /> method. It must return true if the call to <see cref="M:System.Windows.Forms.DataGridViewCell.OnEnter(System.Int32,System.Boolean)" /> has the effect of unsharing the row containing the cell. Otherwise, it should return false.</para>
@@ -623,6 +646,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the parent row will be unshared when the focus moves to the cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the row will be unshared; otherwise, false. The base <see cref="T:System.Windows.Forms.DataGridViewCell" /> class always returns false.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the cell's parent row.</param>
         <param name="throughMouseClick">
@@ -812,7 +839,6 @@
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -826,6 +852,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the formatted value of the cell to copy to the <see cref="T:System.Windows.Forms.Clipboard" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the value of the cell to copy to the <see cref="T:System.Windows.Forms.Clipboard" />.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the row containing the cell.</param>
         <param name="firstCell">
@@ -853,7 +883,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -863,6 +892,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the bounding rectangle that encloses the cell's content area using a default <see cref="T:System.Drawing.Graphics" /> and cell style currently in effect for the cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Rectangle" /> that bounds the cell's contents.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the cell's parent row.</param>
       </Docs>
@@ -882,7 +915,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -893,6 +925,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the bounding rectangle that encloses the cell's content area, which is calculated using the specified <see cref="T:System.Drawing.Graphics" /> and cell style.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Rectangle" /> that bounds the cell's contents.</para>
+        </returns>
         <param name="graphics">
           <attribution license="cc4" from="Microsoft" modified="false" />The graphics context for the cell.</param>
         <param name="cellStyle">
@@ -915,7 +951,6 @@
         <Parameter Name="context" Type="System.Windows.Forms.DataGridViewDataErrorContexts" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -927,6 +962,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the current, formatted value of the cell, regardless of whether the cell is in edit mode and the value has not been committed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current, formatted value of the <see cref="T:System.Windows.Forms.DataGridViewCell" />.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The row index of the cell.</param>
         <param name="context">
@@ -948,7 +987,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -959,6 +997,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the bounding rectangle that encloses the cell's error icon, if one is displayed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Rectangle" /> that bounds the cell's error icon, if one is displayed; otherwise, <see cref="F:System.Drawing.Rectangle.Empty" />.</para>
+        </returns>
         <param name="graphics">
           <attribution license="cc4" from="Microsoft" modified="false" />The graphics context for the cell.</param>
         <param name="cellStyle">
@@ -983,12 +1025,15 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the error for the cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that describes the error for the current <see cref="T:System.Windows.Forms.DataGridViewCell" />.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The row index of the cell.</param>
       </Docs>
@@ -1036,7 +1081,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the cell does not have an associated <see cref="T:System.Windows.Forms.ContextMenuStrip" />, it will inherit one from its parents, using the following precedence:</para>
@@ -1061,6 +1105,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the inherited shortcut menu for the current cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.ContextMenuStrip" /> if the parent <see cref="T:System.Windows.Forms.DataGridView" />, <see cref="T:System.Windows.Forms.DataGridViewRow" />, or <see cref="T:System.Windows.Forms.DataGridViewColumn" /> has a <see cref="T:System.Windows.Forms.ContextMenuStrip" /> assigned; otherwise, null.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The row index of the current cell.</param>
       </Docs>
@@ -1075,7 +1123,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1085,6 +1132,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating the current state of the cell as inherited from the state of its row and column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A bitwise combination of <see cref="T:System.Windows.Forms.DataGridViewElementStates" /> values representing the current state of the cell.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the row containing the cell.</param>
       </Docs>
@@ -1104,7 +1155,6 @@
         <Parameter Name="includeColors" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1114,6 +1164,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the style applied to the cell. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.DataGridViewCellStyle" /> that includes the style settings of the cell inherited from the cell's parent row, column, and <see cref="T:System.Windows.Forms.DataGridView" />.</para>
+        </returns>
         <param name="inheritedCellStyle">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.DataGridViewCellStyle" /> to be populated with the inherited cell style. </param>
         <param name="rowIndex">
@@ -1138,7 +1192,6 @@
         <Parameter Name="constraintSize" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1148,6 +1201,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the preferred size, in pixels, of the cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Size" /> that represents the preferred size, in pixels, of the cell.</para>
+        </returns>
         <param name="graphics">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Graphics" /> used to draw the cell.</param>
         <param name="cellStyle">
@@ -1171,7 +1228,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1181,6 +1237,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the size of the cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Size" /> representing the cell's dimensions.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the cell's parent row.</param>
       </Docs>
@@ -1198,7 +1258,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1208,6 +1267,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the cell. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value contained in the <see cref="T:System.Windows.Forms.DataGridViewCell" />.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the cell's parent row.</param>
       </Docs>
@@ -1371,7 +1434,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1382,6 +1444,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the parent row is unshared if the user presses a key while the focus is on the cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the row will be unshared, otherwise, false. The base <see cref="T:System.Windows.Forms.DataGridViewCell" /> class always returns false.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.KeyEventArgs" /> that contains the event data. </param>
         <param name="rowIndex">
@@ -1401,7 +1467,6 @@
         <Parameter Name="e" Type="System.Windows.Forms.KeyEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1411,6 +1476,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if edit mode should be started based on the given key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if edit mode should be started; otherwise, false. The default is false.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.KeyEventArgs" /> that represents the key that was pressed.</param>
       </Docs>
@@ -1429,7 +1498,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1440,6 +1508,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a row will be unshared if a key is pressed while a cell in the row has focus.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the row will be unshared, otherwise, false. The base <see cref="T:System.Windows.Forms.DataGridViewCell" /> class always returns false.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.KeyPressEventArgs" /> that contains the event data. </param>
         <param name="rowIndex">
@@ -1460,7 +1532,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1471,6 +1542,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the parent row is unshared when the user releases a key while the focus is on the cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the row will be unshared, otherwise, false. The base <see cref="T:System.Windows.Forms.DataGridViewCell" /> class always returns false.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.KeyEventArgs" /> that contains the event data. </param>
         <param name="rowIndex">
@@ -1494,7 +1569,6 @@
         <Parameter Name="throughMouseClick" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.DataGridViewCell.LeaveUnsharesRow(System.Int32,System.Boolean)" /> method is called just before the <see cref="M:System.Windows.Forms.DataGridViewCell.OnLeave(System.Int32,System.Boolean)" /> method. It must return true if the call to <see cref="M:System.Windows.Forms.DataGridViewCell.OnLeave(System.Int32,System.Boolean)" /> has the effect of unsharing the row containing the cell. Otherwise, it should return false.</para>
@@ -1504,6 +1578,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a row will be unshared when the focus leaves a cell in the row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the row will be unshared, otherwise, false. The base <see cref="T:System.Windows.Forms.DataGridViewCell" /> class always returns false.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the cell's parent row.</param>
         <param name="throughMouseClick">
@@ -1524,7 +1602,6 @@
         <Parameter Name="flags" Type="System.Windows.Forms.TextFormatFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1534,6 +1611,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the height, in pixels, of the specified text, given the specified characteristics.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The height, in pixels, of the text.</para>
+        </returns>
         <param name="graphics">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Graphics" /> used to render the text.</param>
         <param name="text">
@@ -1603,7 +1684,6 @@
         <Parameter Name="flags" Type="System.Windows.Forms.TextFormatFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1613,6 +1693,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the ideal height and width of the specified text given the specified characteristics.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Size" /> representing the preferred height and width of the text.</para>
+        </returns>
         <param name="graphics">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Graphics" /> used to render the text.</param>
         <param name="text">
@@ -1646,7 +1730,6 @@
         <Parameter Name="flags" Type="System.Windows.Forms.TextFormatFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1656,6 +1739,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the height and width of the specified text given the specified characteristics.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Size" /> representing the height and width of the text.</para>
+        </returns>
         <param name="graphics">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Graphics" /> used to render the text.</param>
         <param name="text">
@@ -1688,13 +1775,16 @@
         <Parameter Name="flags" Type="System.Windows.Forms.TextFormatFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the width, in pixels, of the specified text given the specified characteristics.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The width, in pixels, of the text.</para>
+        </returns>
         <param name="graphics">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Graphics" /> used to render the text.</param>
         <param name="text">
@@ -1725,7 +1815,6 @@
         <Parameter Name="e" Type="System.Windows.Forms.DataGridViewCellMouseEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1736,6 +1825,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a row will be unshared if the user clicks a mouse button while the pointer is on a cell in the row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the row will be unshared, otherwise, false. The base <see cref="T:System.Windows.Forms.DataGridViewCell" /> class always returns false.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.DataGridViewCellMouseEventArgs" /> that contains the event data. </param>
       </Docs>
@@ -1753,7 +1846,6 @@
         <Parameter Name="e" Type="System.Windows.Forms.DataGridViewCellMouseEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1764,6 +1856,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a row will be unshared if the user double-clicks a cell in the row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the row will be unshared, otherwise, false. The base <see cref="T:System.Windows.Forms.DataGridViewCell" /> class always returns false.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.DataGridViewCellMouseEventArgs" /> that contains the event data.</param>
       </Docs>
@@ -1781,7 +1877,6 @@
         <Parameter Name="e" Type="System.Windows.Forms.DataGridViewCellMouseEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1792,6 +1887,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a row will be unshared when the user holds down a mouse button while the pointer is on a cell in the row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the row will be unshared, otherwise, false. The base <see cref="T:System.Windows.Forms.DataGridViewCell" /> class always returns false.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.DataGridViewCellMouseEventArgs" /> that contains the event data. </param>
       </Docs>
@@ -1809,7 +1908,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1820,6 +1918,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a row will be unshared when the mouse pointer moves over a cell in the row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the row will be unshared, otherwise, false. The base <see cref="T:System.Windows.Forms.DataGridViewCell" /> class always returns false.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the cell's parent row. </param>
       </Docs>
@@ -1837,7 +1939,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1848,6 +1949,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a row will be unshared when the mouse pointer leaves the row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the row will be unshared, otherwise, false. The base <see cref="T:System.Windows.Forms.DataGridViewCell" /> class always returns false.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the cell's parent row. </param>
       </Docs>
@@ -1865,7 +1970,6 @@
         <Parameter Name="e" Type="System.Windows.Forms.DataGridViewCellMouseEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1876,6 +1980,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a row will be unshared when the mouse pointer moves over a cell in the row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the row will be unshared, otherwise, false. The base <see cref="T:System.Windows.Forms.DataGridViewCell" /> class always returns false.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.DataGridViewCellMouseEventArgs" /> that contains the event data. </param>
       </Docs>
@@ -1893,7 +2001,6 @@
         <Parameter Name="e" Type="System.Windows.Forms.DataGridViewCellMouseEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1904,6 +2011,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a row will be unshared when the user releases a mouse button while the pointer is on a cell in the row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the row will be unshared, otherwise, false. The base <see cref="T:System.Windows.Forms.DataGridViewCell" /> class always returns false.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.DataGridViewCellMouseEventArgs" /> that contains the event data. </param>
       </Docs>
@@ -2551,7 +2662,6 @@
         <Parameter Name="valueTypeConverter" Type="System.ComponentModel.TypeConverter" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2565,6 +2675,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value formatted for display to an actual cell value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The cell value.</para>
+        </returns>
         <param name="formattedValue">
           <attribution license="cc4" from="Microsoft" modified="false" />The display value of the cell.</param>
         <param name="cellStyle">
@@ -2649,13 +2763,16 @@
         <Parameter Name="isFirstDisplayedRow" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the location and size of the editing panel hosted by the cell, and returns the normal bounds of the editing control within the editing panel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> that represents the normal bounds of the editing control within the editing panel.</para>
+        </returns>
         <param name="cellBounds">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Rectangle" /> that defines the cell bounds. </param>
         <param name="cellClip">
@@ -2835,13 +2952,16 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the value of the cell. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value has been set; otherwise, false.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the cell's parent row. </param>
         <param name="value">
@@ -2983,7 +3103,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2994,6 +3113,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that describes the current object. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewCellCollection.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewCellCollection.xml
index 35e6d1029df..ac9bc9d78b8 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewCellCollection.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewCellCollection.xml
@@ -61,7 +61,6 @@
         <Parameter Name="dataGridViewCell" Type="System.Windows.Forms.DataGridViewCell" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -71,6 +70,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a cell to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position in which to insert the new element.</para>
+        </returns>
         <param name="dataGridViewCell">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.DataGridViewCell" /> to add to the collection.</param>
       </Docs>
@@ -165,13 +168,16 @@
         <Parameter Name="dataGridViewCell" Type="System.Windows.Forms.DataGridViewCell" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified cell is contained in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="dataGridViewCell" /> is in the collection; otherwise, false.</para>
+        </returns>
         <param name="dataGridViewCell">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.DataGridViewCell" /> to locate in the collection.</param>
       </Docs>
@@ -215,13 +221,16 @@
         <Parameter Name="dataGridViewCell" Type="System.Windows.Forms.DataGridViewCell" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the specified cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the value of <paramref name="dataGridViewCell" /> parameter, if it is found in the collection; otherwise, -1.</para>
+        </returns>
         <param name="dataGridViewCell">
           <attribution license="cc4" from="Microsoft" modified="false" />The cell to locate in the collection.</param>
       </Docs>
@@ -409,7 +418,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Once you add the row to a control, the number of cells it contains always matches the number of columns in the control, so this method is no longer useful. </para>
@@ -419,6 +427,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an item to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position into which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.DataGridViewCell" /> to add to the collection.</param>
       </Docs>
@@ -436,7 +448,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.DataGridViewCellCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -445,6 +456,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the collection contains the specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="value" /> is found in the <see cref="T:System.Windows.Forms.DataGridViewCellCollection" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to locate in the <see cref="T:System.Windows.Forms.DataGridViewCellCollection" />.</param>
       </Docs>
@@ -462,7 +477,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.DataGridViewCellCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -471,6 +485,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of a specific item in a collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of value if found in the list; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to locate in the <see cref="T:System.Windows.Forms.DataGridViewCellCollection" />.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewCellStyle.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewCellStyle.xml
index c24f73a89b2..2333051d65f 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewCellStyle.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewCellStyle.xml
@@ -141,12 +141,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this <see cref="T:System.Windows.Forms.DataGridViewCellStyle" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.DataGridViewCellStyle" /> that represents an exact copy of this cell style.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DataSourceNullValue">
@@ -195,13 +198,16 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equivalent to the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="o" /> is a <see cref="T:System.Windows.Forms.DataGridViewCellStyle" /> and has the same property values as this instance; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance, or null. </param>
       </Docs>
@@ -528,7 +534,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.DataGridViewCellStyle" /> instance is cast to an <see cref="T:System.ICloneable" /> interface.</para>
@@ -537,6 +542,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this <see cref="T:System.Windows.Forms.DataGridViewCellStyle" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.DataGridViewCellStyle" /> that represents an exact copy of this cell style.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Tag">
@@ -574,13 +583,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string indicating the current property settings of the <see cref="T:System.Windows.Forms.DataGridViewCellStyle" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string indicating the current property settings of the <see cref="T:System.Windows.Forms.DataGridViewCellStyle" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewCheckBoxCell.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewCheckBoxCell.xml
index ede63377d27..eb62d0d36fc 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewCheckBoxCell.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewCheckBoxCell.xml
@@ -79,7 +79,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -89,6 +88,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the cloned <see cref="T:System.Windows.Forms.DataGridViewCheckBoxCell" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -104,7 +107,6 @@
         <Parameter Name="e" Type="System.Windows.Forms.DataGridViewCellEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -116,6 +118,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the row containing the cell will be unshared when the cell content is clicked.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the cell is in edit mode; otherwise, false.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.DataGridViewCellEventArgs" /> that contains data about the mouse click.</param>
       </Docs>
@@ -136,7 +142,6 @@
         <Parameter Name="e" Type="System.Windows.Forms.DataGridViewCellEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -147,6 +152,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the row containing the cell will be unshared when the cell content is double-clicked.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the cell is in edit mode; otherwise, false.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.DataGridViewCellEventArgs" /> that contains data about the double-click.</param>
       </Docs>
@@ -159,7 +168,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -172,6 +180,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessible object for the <see cref="T:System.Windows.Forms.DataGridViewCheckBoxCell" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.DataGridViewCheckBoxCell.DataGridViewCheckBoxCellAccessibleObject" /> for the <see cref="T:System.Windows.Forms.DataGridViewCheckBoxCell" />. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -352,7 +364,6 @@
         <Parameter Name="context" Type="System.Windows.Forms.DataGridViewDataErrorContexts" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -362,6 +373,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the formatted value of the cell while it is in edit mode.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> representing the formatted value of the editing cell. </para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Windows.Forms.DataGridViewDataErrorContexts" /> values that describes the context in which any formatting error occurs. </param>
       </Docs>
@@ -487,7 +502,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -499,6 +513,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the row containing the cell is unshared when a key is pressed while the cell has focus.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the SPACE key is pressed and the CTRL, ALT, and SHIFT keys are all not pressed; otherwise, false.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.KeyEventArgs" /> that contains data about the key press. </param>
         <param name="rowIndex">
@@ -519,7 +537,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -531,6 +548,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the row containing the cell is unshared when a key is released while the cell has focus.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the SPACE key is released; otherwise, false.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.KeyEventArgs" /> that contains data about the key press. </param>
         <param name="rowIndex">
@@ -550,7 +571,6 @@
         <Parameter Name="e" Type="System.Windows.Forms.DataGridViewCellMouseEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -563,6 +583,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the row containing the cell will be unshared when the mouse button is pressed while the pointer is over the cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always true.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.DataGridViewCellMouseEventArgs" /> that contains data about the mouse click.</param>
       </Docs>
@@ -580,7 +604,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -592,6 +615,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the row containing the cell will be unshared when the mouse pointer moves over the cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the cell was the last cell receiving a mouse click; otherwise, false.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the row containing the cell.</param>
       </Docs>
@@ -609,7 +636,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -621,6 +647,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the row containing the cell will be unshared when the mouse pointer leaves the cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the button is not in the normal state; false if the button is in the pressed state.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the row containing the cell.</param>
       </Docs>
@@ -638,7 +668,6 @@
         <Parameter Name="e" Type="System.Windows.Forms.DataGridViewCellMouseEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -651,6 +680,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the row containing the cell will be unshared when the mouse button is released while the pointer is over the cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always true.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.DataGridViewCellMouseEventArgs" /> that contains data about the mouse click.</param>
       </Docs>
@@ -959,7 +992,6 @@
         <Parameter Name="valueTypeConverter" Type="System.ComponentModel.TypeConverter" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -970,6 +1002,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value formatted for display to an actual cell value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The cell value.</para>
+        </returns>
         <param name="formattedValue">
           <attribution license="cc4" from="Microsoft" modified="false" />The display value of the cell.</param>
         <param name="cellStyle">
@@ -1046,7 +1082,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1056,6 +1091,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the string representation of the cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that represents the current cell.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewColumn.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewColumn.xml
index 4d2b0527799..9a095cc924b 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewColumn.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewColumn.xml
@@ -450,7 +450,6 @@
         <Parameter Name="fixedHeight" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -462,6 +461,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the ideal width of the column based on the specified criteria.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The ideal width, in pixels, of the column.</para>
+        </returns>
         <param name="autoSizeColumnMode">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.DataGridViewAutoSizeColumnMode" /> value that specifies an automatic sizing mode. </param>
         <param name="fixedHeight">
@@ -829,7 +832,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -839,6 +841,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a string that describes the column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that describes the column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewColumnCollection.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewColumnCollection.xml
index 326a0b1d71f..d7e4c9fdc81 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewColumnCollection.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewColumnCollection.xml
@@ -60,13 +60,16 @@
         <Parameter Name="dataGridViewColumn" Type="System.Windows.Forms.DataGridViewColumn" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the given column to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the column.</para>
+        </returns>
         <param name="dataGridViewColumn">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.DataGridViewColumn" /> to add.</param>
       </Docs>
@@ -85,7 +88,6 @@
         <Parameter Name="headerText" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -95,6 +97,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Windows.Forms.DataGridViewTextBoxColumn" /> with the given column name and column header text to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the column.</para>
+        </returns>
         <param name="columnName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name by which the column will be referred.</param>
         <param name="headerText">
@@ -189,7 +195,6 @@
         <Parameter Name="columnName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -199,6 +204,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the collection contains the column referred to by the given name. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the column is contained in the collection; otherwise, false.</para>
+        </returns>
         <param name="columnName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the column to look for.</param>
       </Docs>
@@ -216,13 +225,16 @@
         <Parameter Name="dataGridViewColumn" Type="System.Windows.Forms.DataGridViewColumn" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the collection contains the given column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the given column is in the collection; otherwise, false.</para>
+        </returns>
         <param name="dataGridViewColumn">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.DataGridViewColumn" /> to look for.</param>
       </Docs>
@@ -285,13 +297,16 @@
         <Parameter Name="includeFilter" Type="System.Windows.Forms.DataGridViewElementStates" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of columns that meet the given filter requirements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of columns that meet the filter requirements.</para>
+        </returns>
         <param name="includeFilter">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of the <see cref="T:System.Windows.Forms.DataGridViewElementStates" /> values that represent the filter for inclusion.</param>
       </Docs>
@@ -309,13 +324,16 @@
         <Parameter Name="includeFilter" Type="System.Windows.Forms.DataGridViewElementStates" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the width, in pixels, required to display all of the columns that meet the given filter requirements. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The width, in pixels, that is necessary to display all of the columns that meet the filter requirements.</para>
+        </returns>
         <param name="includeFilter">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of the <see cref="T:System.Windows.Forms.DataGridViewElementStates" /> values that represent the filter for inclusion.</param>
       </Docs>
@@ -333,7 +351,6 @@
         <Parameter Name="includeFilter" Type="System.Windows.Forms.DataGridViewElementStates" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -344,6 +361,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the first column in display order that meets the given inclusion-filter requirements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first column in display order that meets the given filter requirements, or null if no column is found.</para>
+        </returns>
         <param name="includeFilter">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of the <see cref="T:System.Windows.Forms.DataGridViewElementStates" /> values that represents the filter for inclusion.</param>
       </Docs>
@@ -362,7 +383,6 @@
         <Parameter Name="excludeFilter" Type="System.Windows.Forms.DataGridViewElementStates" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -373,6 +393,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the first column in display order that meets the given inclusion-filter and exclusion-filter requirements. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first column in display order that meets the given filter requirements, or null if no column is found.</para>
+        </returns>
         <param name="includeFilter">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of the <see cref="T:System.Windows.Forms.DataGridViewElementStates" /> values that represent the filter to apply for inclusion.</param>
         <param name="excludeFilter">
@@ -393,7 +417,6 @@
         <Parameter Name="excludeFilter" Type="System.Windows.Forms.DataGridViewElementStates" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -404,6 +427,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the last column in display order that meets the given filter requirements. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The last displayed column in display order that meets the given filter requirements, or null if no column is found.</para>
+        </returns>
         <param name="includeFilter">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of the <see cref="T:System.Windows.Forms.DataGridViewElementStates" /> values that represent the filter to apply for inclusion.</param>
         <param name="excludeFilter">
@@ -425,7 +452,6 @@
         <Parameter Name="excludeFilter" Type="System.Windows.Forms.DataGridViewElementStates" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -436,6 +462,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the first column after the given column in display order that meets the given filter requirements. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The next column that meets the given filter requirements, or null if no column is found.</para>
+        </returns>
         <param name="dataGridViewColumnStart">
           <attribution license="cc4" from="Microsoft" modified="false" />The column from which to start searching for the next column.</param>
         <param name="includeFilter">
@@ -459,7 +489,6 @@
         <Parameter Name="excludeFilter" Type="System.Windows.Forms.DataGridViewElementStates" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -470,6 +499,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the last column prior to the given column in display order that meets the given filter requirements. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The previous column that meets the given filter requirements, or null if no column is found.</para>
+        </returns>
         <param name="dataGridViewColumnStart">
           <attribution license="cc4" from="Microsoft" modified="false" />The column from which to start searching for the previous column.</param>
         <param name="includeFilter">
@@ -491,13 +524,16 @@
         <Parameter Name="dataGridViewColumn" Type="System.Windows.Forms.DataGridViewColumn" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the given <see cref="T:System.Windows.Forms.DataGridViewColumn" /> in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the given <see cref="T:System.Windows.Forms.DataGridViewColumn" />.</para>
+        </returns>
         <param name="dataGridViewColumn">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.DataGridViewColumn" /> to return the index of.</param>
       </Docs>
@@ -706,7 +742,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.DataGridViewColumnCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -715,6 +750,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an object to the end of the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which <paramref name="value" /> has been added.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to add to the end of the collection. The value can be null.</param>
       </Docs>
@@ -732,7 +771,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.DataGridViewColumnCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -741,6 +779,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether an object is in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is found in the <see cref="T:System.Windows.Forms.DataGridViewColumnCollection" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the collection. The value can be null.</param>
       </Docs>
@@ -758,7 +800,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.DataGridViewColumnCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -767,6 +808,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of a specific item in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="value" /> within the collection, if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the collection. The value can be null.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewColumnDesignTimeVisibleAttribute.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewColumnDesignTimeVisibleAttribute.xml
index 41131917cd9..896736dd254 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewColumnDesignTimeVisibleAttribute.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewColumnDesignTimeVisibleAttribute.xml
@@ -90,13 +90,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this object is equivalent to the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true to indicate that the specified object is a <see cref="T:System.Windows.Forms.DataGridViewColumnDesignTimeVisibleAttribute" /> instance with the same <see cref="P:System.Windows.Forms.DataGridViewColumnDesignTimeVisibleAttribute.Visible" /> property value as this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to compare with the current <see cref="T:System.Object" />.</param>
       </Docs>
@@ -129,13 +132,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this attribute instance is equal to the <see cref="F:System.Windows.Forms.DataGridViewColumnDesignTimeVisibleAttribute.Default" /> attribute value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true to indicate that this instance is equal to the <see cref="F:System.Windows.Forms.DataGridViewColumnDesignTimeVisibleAttribute.Default" /> instance; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewColumnHeaderCell.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewColumnHeaderCell.xml
index 67a6b9a0cf2..040c976ed92 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewColumnHeaderCell.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewColumnHeaderCell.xml
@@ -62,7 +62,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -75,6 +74,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessible object for the <see cref="T:System.Windows.Forms.DataGridViewColumnHeaderCell" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.AccessibleObject" /> for the <see cref="T:System.Windows.Forms.DataGridViewColumnHeaderCell" />. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -95,7 +98,6 @@
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -108,6 +110,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the formatted value of the cell to copy to the <see cref="T:System.Windows.Forms.Clipboard" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Object" /> that represents the value of the cell to copy to the <see cref="T:System.Windows.Forms.Clipboard" />.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the row containing the cell.</param>
         <param name="firstCell">
@@ -137,7 +143,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -147,6 +152,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the bounding rectangle that encloses the cell's content area, which is calculated using the specified <see cref="T:System.Drawing.Graphics" /> object and cell style.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Rectangle" /> that bounds the cell's contents.</para>
+        </returns>
         <param name="graphics">
           <attribution license="cc4" from="Microsoft" modified="false" />The graphics context for the cell.</param>
         <param name="cellStyle">
@@ -171,12 +180,15 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the inherited shortcut menu for the specified row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.ContextMenuStrip" /> of the column headers if one exists; otherwise, the <see cref="T:System.Windows.Forms.ContextMenuStrip" /> inherited from <see cref="T:System.Windows.Forms.DataGridView" />.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the row to get the <see cref="T:System.Windows.Forms.ContextMenuStrip" /> of. The index must be -1 to indicate the row of column headers.</param>
       </Docs>
@@ -193,7 +205,6 @@
         <Parameter Name="includeColors" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -203,6 +214,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the style applied to the cell. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.DataGridViewCellStyle" /> that includes the style settings of the cell inherited from the cell's parent row, column, and <see cref="T:System.Windows.Forms.DataGridView" />.</para>
+        </returns>
         <param name="inheritedCellStyle">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.DataGridViewCellStyle" /> to be populated with the inherited cell style. </param>
         <param name="rowIndex">
@@ -227,13 +242,16 @@
         <Parameter Name="constraintSize" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the preferred size, in pixels, of the cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Size" /> that represents the preferred size, in pixels, of the cell.</para>
+        </returns>
         <param name="graphics">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Graphics" /> used to draw the cell.</param>
         <param name="cellStyle">
@@ -257,13 +275,16 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the cell. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value contained in the <see cref="T:System.Windows.Forms.DataGridViewColumnHeaderCell" />.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the cell's parent row.</param>
       </Docs>
@@ -361,13 +382,16 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the value of the cell. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value has been set; otherwise false.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the cell's parent row. </param>
         <param name="value">
@@ -412,13 +436,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the string representation of the cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current cell.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewComboBoxCell.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewComboBoxCell.xml
index b4c683c5a86..3c196675ead 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewComboBoxCell.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewComboBoxCell.xml
@@ -76,7 +76,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -86,6 +85,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the cloned <see cref="T:System.Windows.Forms.DataGridViewComboBoxCell" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -516,7 +519,6 @@
         <Parameter Name="e" Type="System.Windows.Forms.KeyEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -527,6 +529,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if edit mode should be started based on the given key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if edit mode should be started; otherwise, false. </para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.KeyEventArgs" /> that represents the key that was pressed.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewComboBoxColumn.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewComboBoxColumn.xml
index 13f0596246c..cec5a3447d6 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewComboBoxColumn.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewComboBoxColumn.xml
@@ -118,7 +118,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -128,6 +127,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the cloned <see cref="T:System.Windows.Forms.DataGridViewComboBoxColumn" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewComboBoxEditingControl.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewComboBoxEditingControl.xml
index fa7e092bc3f..0901aec4e07 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewComboBoxEditingControl.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewComboBoxEditingControl.xml
@@ -181,7 +181,6 @@
         <Parameter Name="dataGridViewWantsInputKey" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -192,6 +191,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified key is a regular input key that the editing control should process or a special key that the <see cref="T:System.Windows.Forms.DataGridView" /> should process.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified key is a regular input key that should be handled by the editing control; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Windows.Forms.Keys" /> values that represents the key that was pressed.</param>
         <param name="dataGridViewWantsInputKey">
@@ -230,13 +233,16 @@
         <Parameter Name="context" Type="System.Windows.Forms.DataGridViewDataErrorContexts" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the formatted value of the cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the formatted version of the cell contents.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Windows.Forms.DataGridViewDataErrorContexts" /> values that specifies the data error context.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewHeaderCell.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewHeaderCell.xml
index b7abe9363b9..0743f2e0510 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewHeaderCell.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewHeaderCell.xml
@@ -67,7 +67,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -77,6 +76,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the cloned <see cref="T:System.Windows.Forms.DataGridViewHeaderCell" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -187,7 +190,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="T:System.Windows.Forms.DataGridViewHeaderCell" /> does not have a shortcut menu, the <see cref="T:System.Windows.Forms.DataGridViewHeaderCell" /> will inherit the shortcut menu from the <see cref="T:System.Windows.Forms.DataGridView" />. If the <see cref="T:System.Windows.Forms.DataGridView" /> also does not have a shortcut menu, then the <see cref="M:System.Windows.Forms.DataGridViewHeaderCell.GetInheritedContextMenuStrip(System.Int32)" /> method will return null.</para>
@@ -196,6 +198,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the shortcut menu of the header cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.ContextMenuStrip" /> if the <see cref="T:System.Windows.Forms.DataGridViewHeaderCell" /> or <see cref="T:System.Windows.Forms.DataGridView" /> has a shortcut menu assigned; otherwise, null.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />Ignored by this implementation.</param>
       </Docs>
@@ -210,13 +216,16 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating the current state of the cell as inherited from the state of its row or column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A bitwise combination of <see cref="T:System.Windows.Forms.DataGridViewElementStates" /> values representing the current state of the cell.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the row containing the cell or -1 if the cell is not a row header cell or is not contained within a <see cref="T:System.Windows.Forms.DataGridView" /> control.</param>
       </Docs>
@@ -237,7 +246,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.DataGridViewHeaderCell.GetSize(System.Int32)" /> method returns the size necessary to fit in a row of column headers if the header cell is a column header, the size necessary to fit in a column of row headers if the header cell is a row header, or the size necessary to be a <see cref="T:System.Windows.Forms.DataGridViewTopLeftHeaderCell" /> if the cell is a top left header cell.</para>
@@ -247,6 +255,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the size of the cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Size" /> that represents the size of the header cell.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The row index of the header cell.</param>
       </Docs>
@@ -264,12 +276,15 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the cell. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current <see cref="T:System.Windows.Forms.DataGridViewCell" />.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the cell's parent row.</param>
       </Docs>
@@ -287,7 +302,6 @@
         <Parameter Name="e" Type="System.Windows.Forms.DataGridViewCellMouseEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For information about enabling visual styles, see the <see cref="M:System.Windows.Forms.Application.EnableVisualStyles" /> method.</para>
@@ -299,6 +313,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a row will be unshared when the mouse button is held down while the pointer is on a cell in the row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the user clicks with the left mouse button, visual styles are enabled, and the <see cref="P:System.Windows.Forms.DataGridView.EnableHeadersVisualStyles" /> property is true; otherwise, false.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.DataGridViewCellMouseEventArgs" /> that contains information about the mouse position.</param>
       </Docs>
@@ -316,7 +334,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For information about enabling visual styles, see the <see cref="M:System.Windows.Forms.Application.EnableVisualStyles" /> method.</para>
@@ -328,6 +345,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a row will be unshared when the mouse pointer moves over a cell in the row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if visual styles are enabled, and the <see cref="P:System.Windows.Forms.DataGridView.EnableHeadersVisualStyles" /> property is true; otherwise, false.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the row that the mouse pointer entered.</param>
       </Docs>
@@ -345,7 +366,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For information about enabling visual styles, see the <see cref="M:System.Windows.Forms.Application.EnableVisualStyles" /> method.</para>
@@ -357,6 +377,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a row will be unshared when the mouse pointer leaves the row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="P:System.Windows.Forms.DataGridViewHeaderCell.ButtonState" /> property value is not <see cref="F:System.Windows.Forms.ButtonState.Normal" />, visual styles are enabled, and the <see cref="P:System.Windows.Forms.DataGridView.EnableHeadersVisualStyles" /> property is true; otherwise, false.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the row that the mouse pointer left.</param>
       </Docs>
@@ -374,7 +398,6 @@
         <Parameter Name="e" Type="System.Windows.Forms.DataGridViewCellMouseEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For information about enabling visual styles, see the <see cref="M:System.Windows.Forms.Application.EnableVisualStyles" /> method.</para>
@@ -386,6 +409,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a row will be unshared when the mouse button is released while the pointer is on a cell in the row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the left mouse button was released, visual styles are enabled, and the <see cref="P:System.Windows.Forms.DataGridView.EnableHeadersVisualStyles" /> property is true; otherwise, false.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.DataGridViewCellMouseEventArgs" /> that contains information about the mouse position.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewImageCell.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewImageCell.xml
index bae550753ca..550be8d6262 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewImageCell.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewImageCell.xml
@@ -75,7 +75,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -85,6 +84,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the cloned <see cref="T:System.Windows.Forms.DataGridViewImageCell" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -98,7 +101,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -111,6 +113,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessible object for the <see cref="T:System.Windows.Forms.DataGridViewImageCell" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.DataGridViewImageCell.DataGridViewImageCellAccessibleObject" /> for the <see cref="T:System.Windows.Forms.DataGridViewImageCell" />. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewImageColumn.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewImageColumn.xml
index 74043f49869..80cb51116e6 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewImageColumn.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewImageColumn.xml
@@ -156,7 +156,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -166,6 +165,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the cloned <see cref="T:System.Windows.Forms.DataGridViewImageColumn" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewLinkCell.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewLinkCell.xml
index 2ed92197e5e..1a41c8601d8 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewLinkCell.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewLinkCell.xml
@@ -69,7 +69,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Override the <see cref="M:System.Windows.Forms.DataGridViewLinkCell.Clone" /> method whenever you derive from <see cref="T:System.Windows.Forms.DataGridViewLinkCell" /> and add new properties to the derived class.</para>
@@ -78,6 +77,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the cloned <see cref="T:System.Windows.Forms.DataGridViewLinkCell" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateAccessibilityInstance">
@@ -91,7 +94,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you do not explicitly call the <see cref="M:System.Windows.Forms.DataGridViewLinkCell.CreateAccessibilityInstance" /> method, it will be called when the <see cref="T:System.Windows.Forms.DataGridViewLinkCell.DataGridViewLinkCellAccessibleObject" /> property is referenced.</para>
@@ -103,6 +105,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessible object for the <see cref="T:System.Windows.Forms.DataGridViewLinkCell" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.DataGridViewLinkCell.DataGridViewLinkCellAccessibleObject" /> for the <see cref="T:System.Windows.Forms.DataGridViewLinkCell" />. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="EditType">
@@ -248,7 +254,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -259,6 +264,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the row containing the cell will be unshared when a key is released and the cell has focus.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the SPACE key was released, the <see cref="P:System.Windows.Forms.DataGridViewLinkCell.TrackVisitedState" /> property is true, the <see cref="P:System.Windows.Forms.DataGridViewLinkCell.LinkVisited" /> property is false, and the CTRL, ALT, and SHIFT keys are not pressed; otherwise, false.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.KeyEventArgs" /> that contains data about the key press.</param>
         <param name="rowIndex">
@@ -348,7 +357,6 @@
         <Parameter Name="e" Type="System.Windows.Forms.DataGridViewCellMouseEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -359,6 +367,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the row containing the cell will be unshared when the mouse button is pressed while the pointer is over the cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the mouse pointer is over the link; otherwise, false.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.DataGridViewCellMouseEventArgs" /> that contains data about the mouse click.</param>
       </Docs>
@@ -376,7 +388,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -387,6 +398,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the row containing the cell will be unshared when the mouse pointer leaves the cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the link displayed by the cell is not in the normal state; otherwise, false.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the row containing the cell.</param>
       </Docs>
@@ -404,7 +419,6 @@
         <Parameter Name="e" Type="System.Windows.Forms.DataGridViewCellMouseEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.DataGridViewLinkCell.MouseMoveUnsharesRow(System.Windows.Forms.DataGridViewCellMouseEventArgs)" /> method is called just before the <see cref="M:System.Windows.Forms.DataGridViewLinkCell.OnMouseMove(System.Windows.Forms.DataGridViewCellMouseEventArgs)" /> method. It must return true if the call to <see cref="M:System.Windows.Forms.DataGridViewLinkCell.OnMouseMove(System.Windows.Forms.DataGridViewCellMouseEventArgs)" /> has the effect of unsharing the row containing the cell. It should return false otherwise.</para>
@@ -414,6 +428,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the row containing the cell will be unshared when the mouse pointer moves over the cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the mouse pointer is over the link and the link is has not yet changed color to reflect the hover state; otherwise, false.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.DataGridViewCellMouseEventArgs" /> that contains data about the mouse click.</param>
       </Docs>
@@ -431,7 +449,6 @@
         <Parameter Name="e" Type="System.Windows.Forms.DataGridViewCellMouseEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -442,6 +459,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the row containing the cell will be unshared when the mouse button is released while the pointer is over the cell. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the mouse pointer is over the link; otherwise, false.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.DataGridViewCellMouseEventArgs" /> that contains data about the mouse click.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewLinkColumn.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewLinkColumn.xml
index 6f18c00a8a7..0d87dcc296c 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewLinkColumn.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewLinkColumn.xml
@@ -111,7 +111,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to duplicate a column of link cells. </para>
@@ -120,6 +119,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the cloned <see cref="T:System.Windows.Forms.DataGridViewLinkColumn" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="LinkBehavior">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewRow.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewRow.xml
index e67af178982..66662fc3b2c 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewRow.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewRow.xml
@@ -90,7 +90,6 @@
         <Parameter Name="isLastVisibleRow" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -100,6 +99,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Modifies an input row header border style according to the specified criteria.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.DataGridViewAdvancedBorderStyle" /> that represents the new border style used.</para>
+        </returns>
         <param name="dataGridViewAdvancedBorderStyleInput">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.DataGridViewAdvancedBorderStyle" /> that represents the row header border style to modify. </param>
         <param name="dataGridViewAdvancedBorderStylePlaceholder">
@@ -160,7 +163,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -171,6 +173,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the cloned <see cref="T:System.Windows.Forms.DataGridViewRow" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -214,7 +220,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -227,6 +232,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessible object for the <see cref="T:System.Windows.Forms.DataGridViewRow" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.DataGridViewRow.DataGridViewRowAccessibleObject" /> for the <see cref="T:System.Windows.Forms.DataGridViewRow" />. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -302,7 +311,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -312,6 +320,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Constructs a new collection of cells based on this row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created <see cref="T:System.Windows.Forms.DataGridViewCellCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -560,7 +572,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Pass the <see cref="M:System.Windows.Forms.DataGridViewRow.GetContextMenuStrip(System.Int32)" /> method the indexer you used to retrieve the <see cref="T:System.Windows.Forms.DataGridViewRow" />. Do not use the <see cref="P:System.Windows.Forms.DataGridViewBand.Index" /> property for the <paramref name="rowIndex" /> parameter. If the row is shared, <see cref="P:System.Windows.Forms.DataGridViewBand.Index" /> is -1, which is an invalid value for <paramref name="rowIndex" />.</para>
@@ -569,6 +580,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the shortcut menu for the row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.ContextMenuStrip" /> that belongs to the <see cref="T:System.Windows.Forms.DataGridViewRow" /> at the specified index.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the current row.</param>
       </Docs>
@@ -583,7 +598,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -593,6 +607,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the error text for the row at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that describes the error of the row at the specified index.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the row that contains the error.</param>
       </Docs>
@@ -612,7 +630,6 @@
         <Parameter Name="fixedWidth" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -625,6 +642,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the ideal height of the specified row based on the specified criteria.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The ideal height of the row, in pixels.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the row whose preferred height is calculated.</param>
         <param name="autoSizeRowMode">
@@ -646,7 +667,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -656,6 +676,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating the current state of the row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A bitwise combination of <see cref="T:System.Windows.Forms.DataGridViewElementStates" /> values indicating the row state.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the row.</param>
       </Docs>
@@ -1084,7 +1108,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="values" /> parameter represents a variable number of arguments used to populate cell values in the row. These values can be passed to this method as multiple, individual arguments or as members of a single <see cref="T:System.Array" />. Because the values are expected to be instances of type <see cref="T:System.Object" />, however, if you pass in an array of value-type values (such as <see cref="T:System.Int32" /> values), this method will treat the array as a single object and assign it to a single cell. To avoid this behavior, you must cast a value-type array to an <see cref="T:System.Object" /> array or pass in multiple values as multiple arguments.</para>
@@ -1095,6 +1118,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the values of the row's cells.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if all values have been set; otherwise, false.</para>
+        </returns>
         <param name="values">
           <attribution license="cc4" from="Microsoft" modified="false" />One or more objects that represent the cell values in the row.</param>
       </Docs>
@@ -1129,7 +1156,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1139,6 +1165,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a human-readable string that describes the row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that describes this row.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewRowCollection.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewRowCollection.xml
index 4089c91656a..5e913441051 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewRowCollection.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewRowCollection.xml
@@ -63,7 +63,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -74,6 +73,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new row to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the new row.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -94,7 +97,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -105,6 +107,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified number of new rows to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the last row that was added.</para>
+        </returns>
         <param name="count">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of rows to add to the <see cref="T:System.Windows.Forms.DataGridViewRowCollection" />.</param>
       </Docs>
@@ -133,7 +139,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -144,6 +149,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new row to the collection, and populates the cells with the specified objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the new row.</para>
+        </returns>
         <param name="values">
           <attribution license="cc4" from="Microsoft" modified="false" />A variable number of objects that populate the cells of the new <see cref="T:System.Windows.Forms.DataGridViewRow" />.</param>
       </Docs>
@@ -166,7 +175,6 @@
         <Parameter Name="dataGridViewRow" Type="System.Windows.Forms.DataGridViewRow" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -177,6 +185,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Windows.Forms.DataGridViewRow" /> to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the new <see cref="T:System.Windows.Forms.DataGridViewRow" />.</para>
+        </returns>
         <param name="dataGridViewRow">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.DataGridViewRow" /> to add to the <see cref="T:System.Windows.Forms.DataGridViewRowCollection" />.</param>
       </Docs>
@@ -195,7 +207,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -206,6 +217,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified number of rows to the collection based on the row at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the last row that was added.</para>
+        </returns>
         <param name="indexSource">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the row on which to base the new rows.</param>
         <param name="count">
@@ -225,7 +240,6 @@
         <Parameter Name="indexSource" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -236,6 +250,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new row based on the row at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the new row.</para>
+        </returns>
         <param name="indexSource">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the row on which to base the new row.</param>
       </Docs>
@@ -333,13 +351,16 @@
         <Parameter Name="dataGridViewRow" Type="System.Windows.Forms.DataGridViewRow" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Windows.Forms.DataGridViewRow" /> is in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Windows.Forms.DataGridViewRow" /> is in the <see cref="T:System.Windows.Forms.DataGridViewRowCollection" />; otherwise, false.</para>
+        </returns>
         <param name="dataGridViewRow">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.DataGridViewRow" /> to locate in the <see cref="T:System.Windows.Forms.DataGridViewRowCollection" />.</param>
       </Docs>
@@ -421,13 +442,16 @@
         <Parameter Name="includeFilter" Type="System.Windows.Forms.DataGridViewElementStates" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the first <see cref="T:System.Windows.Forms.DataGridViewRow" /> that meets the specified criteria.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the first <see cref="T:System.Windows.Forms.DataGridViewRow" /> that has the attributes specified by <paramref name="includeFilter" />; -1 if no row is found.</para>
+        </returns>
         <param name="includeFilter">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Windows.Forms.DataGridViewElementStates" /> values.</param>
       </Docs>
@@ -446,13 +470,16 @@
         <Parameter Name="excludeFilter" Type="System.Windows.Forms.DataGridViewElementStates" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the first <see cref="T:System.Windows.Forms.DataGridViewRow" /> that meets the specified inclusion and exclusion criteria.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the first <see cref="T:System.Windows.Forms.DataGridViewRow" /> that has the attributes specified by <paramref name="includeFilter" />, and does not have the attributes specified by <paramref name="excludeFilter" />; -1 if no row is found.</para>
+        </returns>
         <param name="includeFilter">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Windows.Forms.DataGridViewElementStates" /> values.</param>
         <param name="excludeFilter">
@@ -472,13 +499,16 @@
         <Parameter Name="includeFilter" Type="System.Windows.Forms.DataGridViewElementStates" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the last <see cref="T:System.Windows.Forms.DataGridViewRow" /> that meets the specified criteria.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the last <see cref="T:System.Windows.Forms.DataGridViewRow" /> that has the attributes specified by <paramref name="includeFilter" />; -1 if no row is found.</para>
+        </returns>
         <param name="includeFilter">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Windows.Forms.DataGridViewElementStates" /> values.</param>
       </Docs>
@@ -497,7 +527,6 @@
         <Parameter Name="includeFilter" Type="System.Windows.Forms.DataGridViewElementStates" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -507,6 +536,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the next <see cref="T:System.Windows.Forms.DataGridViewRow" /> that meets the specified criteria.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the first <see cref="T:System.Windows.Forms.DataGridViewRow" /> after <paramref name="indexStart" /> that has the attributes specified by <paramref name="includeFilter" />, or -1 if no row is found.</para>
+        </returns>
         <param name="indexStart">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the row where the method should begin to look for the next <see cref="T:System.Windows.Forms.DataGridViewRow" />.</param>
         <param name="includeFilter">
@@ -528,7 +561,6 @@
         <Parameter Name="excludeFilter" Type="System.Windows.Forms.DataGridViewElementStates" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -538,6 +570,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the next <see cref="T:System.Windows.Forms.DataGridViewRow" /> that meets the specified inclusion and exclusion criteria.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the next <see cref="T:System.Windows.Forms.DataGridViewRow" /> that has the attributes specified by <paramref name="includeFilter" />, and does not have the attributes specified by <paramref name="excludeFilter" />; -1 if no row is found.</para>
+        </returns>
         <param name="indexStart">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the row where the method should begin to look for the next <see cref="T:System.Windows.Forms.DataGridViewRow" />.</param>
         <param name="includeFilter">
@@ -560,7 +596,6 @@
         <Parameter Name="includeFilter" Type="System.Windows.Forms.DataGridViewElementStates" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -570,6 +605,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the previous <see cref="T:System.Windows.Forms.DataGridViewRow" /> that meets the specified criteria.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the previous <see cref="T:System.Windows.Forms.DataGridViewRow" /> that has the attributes specified by <paramref name="includeFilter" />; -1 if no row is found.</para>
+        </returns>
         <param name="indexStart">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the row where the method should begin to look for the previous <see cref="T:System.Windows.Forms.DataGridViewRow" />.</param>
         <param name="includeFilter">
@@ -591,7 +630,6 @@
         <Parameter Name="excludeFilter" Type="System.Windows.Forms.DataGridViewElementStates" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -601,6 +639,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the previous <see cref="T:System.Windows.Forms.DataGridViewRow" /> that meets the specified inclusion and exclusion criteria.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the previous <see cref="T:System.Windows.Forms.DataGridViewRow" /> that has the attributes specified by <paramref name="includeFilter" />, and does not have the attributes specified by <paramref name="excludeFilter" />; -1 if no row is found.</para>
+        </returns>
         <param name="indexStart">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the row where the method should begin to look for the previous <see cref="T:System.Windows.Forms.DataGridViewRow" />.</param>
         <param name="includeFilter">
@@ -622,13 +664,16 @@
         <Parameter Name="includeFilter" Type="System.Windows.Forms.DataGridViewElementStates" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of <see cref="T:System.Windows.Forms.DataGridViewRow" /> objects in the collection that meet the specified criteria.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of <see cref="T:System.Windows.Forms.DataGridViewRow" /> objects in the <see cref="T:System.Windows.Forms.DataGridViewRowCollection" /> that have the attributes specified by <paramref name="includeFilter" />.</para>
+        </returns>
         <param name="includeFilter">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Windows.Forms.DataGridViewElementStates" /> values.</param>
       </Docs>
@@ -646,13 +691,16 @@
         <Parameter Name="includeFilter" Type="System.Windows.Forms.DataGridViewElementStates" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the cumulative height of the <see cref="T:System.Windows.Forms.DataGridViewRow" /> objects that meet the specified criteria.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The cumulative height of <see cref="T:System.Windows.Forms.DataGridViewRow" /> objects in the <see cref="T:System.Windows.Forms.DataGridViewRowCollection" /> that have the attributes specified by <paramref name="includeFilter" />.</para>
+        </returns>
         <param name="includeFilter">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Windows.Forms.DataGridViewElementStates" /> values.</param>
       </Docs>
@@ -670,13 +718,16 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the state of the row with the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A bitwise combination of <see cref="T:System.Windows.Forms.DataGridViewElementStates" /> values indicating the state of the specified row.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the row.</param>
       </Docs>
@@ -694,13 +745,16 @@
         <Parameter Name="dataGridViewRow" Type="System.Windows.Forms.DataGridViewRow" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of a specified item in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of <paramref name="value" /> if it is a <see cref="T:System.Windows.Forms.DataGridViewRow" /> found in the <see cref="T:System.Windows.Forms.DataGridViewRowCollection" />; otherwise, -1.</para>
+        </returns>
         <param name="dataGridViewRow">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.DataGridViewRow" /> to locate in the <see cref="T:System.Windows.Forms.DataGridViewRowCollection" />.</param>
       </Docs>
@@ -1030,7 +1084,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1040,6 +1093,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Windows.Forms.DataGridViewRow" /> at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.DataGridViewRow" /> positioned at the specified index.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the <see cref="T:System.Windows.Forms.DataGridViewRow" /> to get.</param>
       </Docs>
@@ -1149,7 +1206,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.DataGridViewRowCollection" /> instance is cast to an <see cref="T:System.Collections.IEnumerable" /> interface.</para>
@@ -1158,6 +1214,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Add">
@@ -1173,7 +1233,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.DataGridViewRowCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -1184,6 +1243,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Windows.Forms.DataGridViewRow" /> to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the new <see cref="T:System.Windows.Forms.DataGridViewRow" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to add to the <see cref="T:System.Collections.IList" />.</param>
       </Docs>
@@ -1201,7 +1264,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.DataGridViewRowCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -1210,6 +1272,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the collection contains the specified item.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is a <see cref="T:System.Windows.Forms.DataGridViewRow" /> found in the <see cref="T:System.Windows.Forms.DataGridViewRowCollection" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The item to locate in the <see cref="T:System.Windows.Forms.DataGridViewRowCollection" />.</param>
       </Docs>
@@ -1227,7 +1293,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.DataGridViewRowCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -1236,6 +1301,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of a specified item in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of <paramref name="value" /> if it is a <see cref="T:System.Windows.Forms.DataGridViewRow" /> found in the list; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to locate in the <see cref="T:System.Windows.Forms.DataGridViewRowCollection" />.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewRowHeaderCell.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewRowHeaderCell.xml
index 2c34f1e8a25..38f1ab35189 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewRowHeaderCell.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewRowHeaderCell.xml
@@ -66,7 +66,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -79,6 +78,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessible object for the <see cref="T:System.Windows.Forms.DataGridViewRowHeaderCell" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.DataGridViewRowHeaderCell.DataGridViewRowHeaderCellAccessibleObject" /> for the <see cref="T:System.Windows.Forms.DataGridViewRowHeaderCell" />. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -99,7 +102,6 @@
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -112,6 +114,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the formatted value of the cell to copy to the <see cref="T:System.Windows.Forms.Clipboard" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Object" /> that represents the value of the cell to copy to the <see cref="T:System.Windows.Forms.Clipboard" />.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the row containing the cell.</param>
         <param name="firstCell">
@@ -209,12 +215,15 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the inherited shortcut menu for the specified row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.ContextMenuStrip" /> of the row if one exists; otherwise, the <see cref="T:System.Windows.Forms.ContextMenuStrip" /> inherited from <see cref="T:System.Windows.Forms.DataGridView" />.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the row to get the <see cref="T:System.Windows.Forms.ContextMenuStrip" /> of. The index must be -1 to indicate the row of column headers.</param>
       </Docs>
@@ -279,7 +288,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -289,6 +297,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the cell. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value contained in the <see cref="T:System.Windows.Forms.DataGridViewRowHeaderCell" />.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the cell's parent row.</param>
       </Docs>
@@ -405,13 +417,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the string representation of the cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current cell.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewSelectedCellCollection.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewSelectedCellCollection.xml
index 57df8cea2aa..c809e7b4c7e 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewSelectedCellCollection.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewSelectedCellCollection.xml
@@ -67,13 +67,16 @@
         <Parameter Name="dataGridViewCell" Type="System.Windows.Forms.DataGridViewCell" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified cell is contained in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="dataGridViewCell" /> is in the <see cref="T:System.Windows.Forms.DataGridViewSelectedCellCollection" />; otherwise, false.</para>
+        </returns>
         <param name="dataGridViewCell">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.DataGridViewCell" /> to locate in the <see cref="T:System.Windows.Forms.DataGridViewSelectedCellCollection" />.</param>
       </Docs>
@@ -192,7 +195,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You cannot change the <see cref="T:System.Windows.Forms.DataGridViewSelectedCellCollection" /> class directly. To add a cell to the <see cref="T:System.Windows.Forms.DataGridViewSelectedCellCollection" />, use the <see cref="P:System.Windows.Forms.DataGridViewCell.Selected" /> property.</para>
@@ -202,6 +204,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implements the <see cref="M:System.Collections.IList.Add(System.Object)" /> method. Always throws <see cref="T:System.NotSupportedException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position into which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The item to be added to the <see cref="T:System.Windows.Forms.DataGridViewSelectedCellCollection" />.</param>
       </Docs>
@@ -241,7 +247,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.DataGridViewSelectedCellCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -250,6 +255,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified cell is contained in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is in the collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.DataGridViewCell" /> to locate in the <see cref="T:System.Windows.Forms.DataGridViewSelectedCellCollection" />.</param>
       </Docs>
@@ -267,7 +276,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.DataGridViewSelectedCellCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -276,6 +284,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the specified cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the <paramref name="value" /> parameter if it is found in the collection; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The cell to locate in the collection.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewSelectedColumnCollection.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewSelectedColumnCollection.xml
index 68bb5d26089..26524324191 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewSelectedColumnCollection.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewSelectedColumnCollection.xml
@@ -68,13 +68,16 @@
         <Parameter Name="dataGridViewColumn" Type="System.Windows.Forms.DataGridViewColumn" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified column is contained in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="dataGridViewColumn" /> parameter is in the collection; otherwise, false.</para>
+        </returns>
         <param name="dataGridViewColumn">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.DataGridViewColumn" /> to locate in the <see cref="T:System.Windows.Forms.DataGridViewSelectedColumnCollection" />.</param>
       </Docs>
@@ -191,7 +194,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You cannot change the <see cref="T:System.Windows.Forms.DataGridViewSelectedColumnCollection" /> class directly. To add a column to the <see cref="T:System.Windows.Forms.DataGridViewSelectedColumnCollection" />, use the <see cref="P:System.Windows.Forms.DataGridViewBand.Selected" /> property.</para>
@@ -201,6 +203,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implements the <see cref="M:System.Collections.IList.Add(System.Object)" /> method. Always throws <see cref="T:System.NotSupportedException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Not applicable. Always throws an exception.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The item to be added to the <see cref="T:System.Windows.Forms.DataGridViewSelectedColumnCollection" />.</param>
       </Docs>
@@ -240,7 +246,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.DataGridViewSelectedColumnCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -249,6 +254,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified value is contained in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="value" /> parameter is in the collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to locate in the <see cref="T:System.Windows.Forms.DataGridViewSelectedColumnCollection" />.</param>
       </Docs>
@@ -266,7 +275,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.DataGridViewSelectedColumnCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -275,6 +283,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the specified element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the <paramref name="value" /> parameter if it is found in the collection; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The element to locate in the collection.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewSelectedRowCollection.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewSelectedRowCollection.xml
index 924bc1b9aa3..cab8c12574a 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewSelectedRowCollection.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewSelectedRowCollection.xml
@@ -67,13 +67,16 @@
         <Parameter Name="dataGridViewRow" Type="System.Windows.Forms.DataGridViewRow" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified row is contained in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="dataGridViewRow" /> is in the collection; otherwise, false.</para>
+        </returns>
         <param name="dataGridViewRow">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.DataGridViewRow" /> to locate in the <see cref="T:System.Windows.Forms.DataGridViewSelectedRowCollection" />.</param>
       </Docs>
@@ -190,7 +193,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You cannot change the <see cref="T:System.Windows.Forms.DataGridViewSelectedRowCollection" /> class directly. To add a row to the <see cref="T:System.Windows.Forms.DataGridViewSelectedRowCollection" />, use the <see cref="P:System.Windows.Forms.DataGridViewBand.Selected" /> property.</para>
@@ -200,6 +202,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implements the <see cref="M:System.Collections.IList.Add(System.Object)" /> method. Always throws <see cref="T:System.NotSupportedException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which <paramref name="value" /> was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The item to be added to the <see cref="T:System.Windows.Forms.DataGridViewSelectedRowCollection" />.</param>
       </Docs>
@@ -239,7 +245,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.DataGridViewSelectedRowCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -248,6 +253,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified value is contained in the collection. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="value" /> parameter is in the collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to locate in the <see cref="T:System.Windows.Forms.DataGridViewSelectedRowCollection" />.</param>
       </Docs>
@@ -265,7 +274,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.DataGridViewSelectedRowCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -274,6 +282,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the specified element. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the <paramref name="value" /> parameter if it is found in the collection; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The element to locate in the collection.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewTextBoxCell.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewTextBoxCell.xml
index f8144ac15dd..9fc3f147276 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewTextBoxCell.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewTextBoxCell.xml
@@ -47,7 +47,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -57,6 +56,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the cloned <see cref="T:System.Windows.Forms.DataGridViewTextBoxCell" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -232,7 +235,6 @@
         <Parameter Name="e" Type="System.Windows.Forms.KeyEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -243,6 +245,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if edit mode should be started based on the given key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if edit mode should be started; otherwise, false. </para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.KeyEventArgs" /> that represents the key that was pressed.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewTextBoxEditingControl.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewTextBoxEditingControl.xml
index 4e546869595..275c113aa02 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewTextBoxEditingControl.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewTextBoxEditingControl.xml
@@ -178,13 +178,16 @@
         <Parameter Name="dataGridViewWantsInputKey" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified key is a regular input key that the editing control should process or a special key that the <see cref="T:System.Windows.Forms.DataGridView" /> should process.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified key is a regular input key that should be handled by the editing control; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Keys" /> that represents the key that was pressed.</param>
         <param name="dataGridViewWantsInputKey">
@@ -223,13 +226,16 @@
         <Parameter Name="context" Type="System.Windows.Forms.DataGridViewDataErrorContexts" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the formatted value of the cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the formatted version of the cell contents.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.DataGridViewDataErrorContexts" /> values that specifies the data error context.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewTopLeftHeaderCell.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewTopLeftHeaderCell.xml
index badbaee4e1e..a5ba057003f 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewTopLeftHeaderCell.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataGridViewTopLeftHeaderCell.xml
@@ -45,7 +45,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -58,6 +57,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessible object for the <see cref="T:System.Windows.Forms.DataGridViewTopLeftHeaderCell" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.DataGridViewTopLeftHeaderCell.DataGridViewTopLeftHeaderCellAccessibleObject" /> for the <see cref="T:System.Windows.Forms.DataGridViewTopLeftHeaderCell" />. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -75,7 +78,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -86,6 +88,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the bounding rectangle that encloses the cell's content area, which is calculated using the specified <see cref="T:System.Drawing.Graphics" /> object and cell style.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Rectangle" /> that bounds the cell's contents.</para>
+        </returns>
         <param name="graphics">
           <attribution license="cc4" from="Microsoft" modified="false" />The graphics context for the cell.</param>
         <param name="cellStyle">
@@ -109,7 +115,6 @@
         <Parameter Name="rowIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -120,6 +125,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the bounding rectangle that encloses the cell's error icon, if one is displayed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Rectangle" /> that bounds the cell's error icon, if one is displayed; otherwise, <see cref="F:System.Drawing.Rectangle.Empty" />.</para>
+        </returns>
         <param name="graphics">
           <attribution license="cc4" from="Microsoft" modified="false" />The graphics context for the cell.</param>
         <param name="cellStyle">
@@ -144,7 +153,6 @@
         <Parameter Name="constraintSize" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -154,6 +162,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the preferred size, in pixels, of the cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Size" /> that represents the preferred size, in pixels, of the cell.</para>
+        </returns>
         <param name="graphics">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Graphics" /> used to draw the cell.</param>
         <param name="cellStyle">
@@ -255,13 +267,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the string representation of the cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current cell.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataObject.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataObject.xml
index 0aa403d97c6..265a66f2760 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataObject.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DataObject.xml
@@ -117,7 +117,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to determine whether the data object contains audio data before retrieving it with the <see cref="M:System.Windows.Forms.DataObject.GetAudioStream" /> method.</para>
@@ -126,6 +125,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the data object contains data in the <see cref="F:System.Windows.Forms.DataFormats.WaveAudio" /> format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the data object contains audio data; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ContainsFileDropList">
@@ -139,7 +142,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A file drop list is a collection of strings containing path information for files.</para>
@@ -149,6 +151,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the data object contains data that is in the <see cref="F:System.Windows.Forms.DataFormats.FileDrop" /> format or can be converted to that format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the data object contains a file drop list; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ContainsImage">
@@ -162,7 +168,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to determine whether the data object contains image data before retrieving it with the <see cref="M:System.Windows.Forms.DataObject.GetImage" /> method.</para>
@@ -171,6 +176,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the data object contains data that is in the <see cref="F:System.Windows.Forms.DataFormats.Bitmap" /> format or can be converted to that format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the data object contains image data; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ContainsText">
@@ -184,7 +193,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to determine whether the data object contains text data before retrieving it with the <see cref="Overload:System.Windows.Forms.DataObject.GetText" /> method.</para>
@@ -193,6 +201,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the data object contains data in the <see cref="F:System.Windows.Forms.TextDataFormat.UnicodeText" /> format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the data object contains text data; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ContainsText">
@@ -208,7 +220,6 @@
         <Parameter Name="format" Type="System.Windows.Forms.TextDataFormat" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to determine whether the data object contains text data before retrieving it with the <see cref="Overload:System.Windows.Forms.DataObject.GetText" /> method.</para>
@@ -217,6 +228,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the data object contains text data in the format indicated by the specified <see cref="T:System.Windows.Forms.TextDataFormat" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the data object contains text data in the specified format; otherwise, false.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.TextDataFormat" /> values.</param>
       </Docs>
@@ -232,7 +247,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Windows.Forms.DataObject.ContainsAudio" /> method to determine whether the data object contains audio data before retrieving it with this method.</para>
@@ -242,6 +256,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an audio stream from the data object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> containing audio data or null if the data object does not contain any data in the <see cref="F:System.Windows.Forms.DataFormats.WaveAudio" /> format.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetData">
@@ -254,7 +272,6 @@
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If this method cannot find data in the specified format, it attempts to convert the data to the format. If the data cannot be converted to the specified format, or if the data was stored with automatic conversion set to false, this method returns null.</para>
@@ -267,6 +284,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the data associated with the specified data format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The data associated with the specified format, or null.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />The format of the data to retrieve. See <see cref="T:System.Windows.Forms.DataFormats" /> for predefined formats. </param>
       </Docs>
@@ -285,7 +306,6 @@
         <Parameter Name="format" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If this method cannot find data in the specified format, it attempts to convert the data to the format. If the data cannot be converted to the specified format, or if the data was stored with automatic conversion set to false, this method returns null.</para>
@@ -298,6 +318,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the data associated with the specified class type format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The data associated with the specified format, or null.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> representing the format of the data to retrieve. </param>
       </Docs>
@@ -317,7 +341,6 @@
         <Parameter Name="autoConvert" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <paramref name="autoConvert" /> parameter is true and this method cannot find data in the specified format, it attempts to convert the data to the format. If the data cannot be converted to the specified format, or if the data was stored with the automatic conversion set to false, this method returns null.</para>
@@ -331,6 +354,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the data associated with the specified data format, using an automated conversion parameter to determine whether to convert the data to the format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The data associated with the specified format, or null.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />The format of the data to retrieve. See <see cref="T:System.Windows.Forms.DataFormats" /> for predefined formats. </param>
         <param name="autoConvert">
@@ -351,7 +378,6 @@
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this method to determine whether a format exists before calling <see cref="M:System.Windows.Forms.DataObject.GetData(System.String,System.Boolean)" />. Call <see cref="M:System.Windows.Forms.DataObject.GetFormats(System.Boolean)" /> for the formats that are available in this <see cref="T:System.Windows.Forms.DataObject" />.</para>
@@ -366,6 +392,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether data stored in this <see cref="T:System.Windows.Forms.DataObject" /> is associated with, or can be converted to, the specified format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if data stored in this <see cref="T:System.Windows.Forms.DataObject" /> is associated with, or can be converted to, the specified format; otherwise, false.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />The format to check for. See <see cref="T:System.Windows.Forms.DataFormats" /> for predefined formats. </param>
       </Docs>
@@ -384,7 +414,6 @@
         <Parameter Name="format" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this method to determine whether a format exists before calling <see cref="M:System.Windows.Forms.DataObject.GetData(System.String,System.Boolean)" />. Call <see cref="M:System.Windows.Forms.DataObject.GetFormats(System.Boolean)" /> for the formats that are available in this <see cref="T:System.Windows.Forms.DataObject" />.</para>
@@ -399,6 +428,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether data stored in this <see cref="T:System.Windows.Forms.DataObject" /> is associated with, or can be converted to, the specified format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if data stored in this <see cref="T:System.Windows.Forms.DataObject" /> is associated with, or can be converted to, the specified format; otherwise, false.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> representing the format to check for. </param>
       </Docs>
@@ -418,7 +451,6 @@
         <Parameter Name="autoConvert" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this method to determine whether a format exists before calling <see cref="M:System.Windows.Forms.DataObject.GetData(System.String,System.Boolean)" />. Call <see cref="M:System.Windows.Forms.DataObject.GetFormats(System.Boolean)" /> for the formats that are available in this <see cref="T:System.Windows.Forms.DataObject" />.</para>
@@ -451,6 +483,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether this <see cref="T:System.Windows.Forms.DataObject" /> contains data in the specified format or, optionally, contains data that can be converted to the specified format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the data is in, or can be converted to, the specified format; otherwise, false.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />The format to check for. See <see cref="T:System.Windows.Forms.DataFormats" /> for predefined formats. </param>
         <param name="autoConvert">
@@ -472,7 +508,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A file drop list is a collection of strings containing path information for files.</para>
@@ -484,6 +519,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection of file names from the data object. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.Specialized.StringCollection" /> containing file names or null if the data object does not contain any data that is in the <see cref="F:System.Windows.Forms.DataFormats.FileDrop" /> format or can be converted to that format.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetFormats">
@@ -494,7 +533,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this method to get the supported data formats before calling <see cref="M:System.Windows.Forms.DataObject.GetData(System.String,System.Boolean)" />. See <see cref="T:System.Windows.Forms.DataFormats" /> for the predefined formats.</para>
@@ -506,6 +544,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a list of all formats that data stored in this <see cref="T:System.Windows.Forms.DataObject" /> is associated with or can be converted to.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.String" />, containing a list of all formats that are supported by the data stored in this object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -522,7 +564,6 @@
         <Parameter Name="autoConvert" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this method to get the supported data formats before calling <see cref="M:System.Windows.Forms.DataObject.GetData(System.String,System.Boolean)" />. See <see cref="T:System.Windows.Forms.DataFormats" /> for the predefined formats.</para>
@@ -534,6 +575,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a list of all formats that data stored in this <see cref="T:System.Windows.Forms.DataObject" /> is associated with or can be converted to, using an automatic conversion parameter to determine whether to retrieve only native data formats or all formats that the data can be converted to.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.String" />, containing a list of all formats that are supported by the data stored in this object.</para>
+        </returns>
         <param name="autoConvert">
           <attribution license="cc4" from="Microsoft" modified="false" />true to retrieve all formats that data stored in this <see cref="T:System.Windows.Forms.DataObject" /> is associated with, or can be converted to; false to retrieve only native data formats. </param>
       </Docs>
@@ -553,7 +598,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Windows.Forms.DataObject.ContainsImage" /> method to determine whether the data object contains image data before retrieving it with this method.</para>
@@ -563,6 +607,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an image from the data object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Drawing.Image" /> representing the image data in the data object or null if the data object does not contain any data that is in the <see cref="F:System.Windows.Forms.DataFormats.Bitmap" /> format or can be converted to that format.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetText">
@@ -576,7 +624,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="Overload:System.Windows.Forms.DataObject.ContainsText" /> method to determine whether the data object contains text data before retrieving it with this method.</para>
@@ -586,6 +633,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves text data from the data object in the <see cref="F:System.Windows.Forms.TextDataFormat.UnicodeText" /> format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The text data in the data object or <see cref="F:System.String.Empty" /> if the data object does not contain data in the <see cref="F:System.Windows.Forms.TextDataFormat.UnicodeText" /> format.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetText">
@@ -601,7 +652,6 @@
         <Parameter Name="format" Type="System.Windows.Forms.TextDataFormat" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="Overload:System.Windows.Forms.DataObject.ContainsText" /> method to determine whether the data object contains text data before retrieving it with this method.</para>
@@ -611,6 +661,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves text data from the data object in the format indicated by the specified <see cref="T:System.Windows.Forms.TextDataFormat" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The text data in the data object or <see cref="F:System.String.Empty" /> if the data object does not contain data in the specified format.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.TextDataFormat" /> values.</param>
       </Docs>
@@ -936,6 +990,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Destroys a notification connection that had been previously established.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method supports the following return values:</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>S_OK</para>
+              </term>
+              <description>
+                <para>The specified connection was successfully deleted.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>OLE_E_NOCONNECTION</para>
+              </term>
+              <description>
+                <para>The specified connection is not valid.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>OLE_E_ADVISENOTSUPPORTED</para>
+              </term>
+              <description>
+                <para>This <see cref="T:System.Runtime.InteropServices.ComTypes.IDataObject" /> implementation does not support notification.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Runtime.InteropServices.ComTypes.IDataObject.EnumDAdvise">
@@ -971,7 +1065,6 @@
       </Parameters>
       <Docs>
         <param name="direction">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.DataObject" /> is cast to an <see cref="T:System.Runtime.InteropServices.ComTypes.IDataObject" /> interface.</para>
@@ -980,6 +1073,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an object for enumerating the <see cref="T:System.Runtime.InteropServices.ComTypes.FORMATETC" /> structures for a data object. These structures are used in calls to <see cref="M:System.Runtime.InteropServices.ComTypes.IDataObject.GetData(System.Runtime.InteropServices.ComTypes.FORMATETC@,System.Runtime.InteropServices.ComTypes.STGMEDIUM@)" /> or <see cref="M:System.Runtime.InteropServices.ComTypes.IDataObject.SetData(System.Runtime.InteropServices.ComTypes.FORMATETC@,System.Runtime.InteropServices.ComTypes.STGMEDIUM@,System.Boolean)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method supports the standard return values E_INVALIDARG and E_OUTOFMEMORY, as well as the following:</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>S_OK</para>
+              </term>
+              <description>
+                <para>The enumerator object was successfully created.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>E_NOTIMPL</para>
+              </term>
+              <description>
+                <para>The direction specified by the <paramref name="direction" /> parameter is not supported.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>OLE_S_USEREG</para>
+              </term>
+              <description>
+                <para>Requests that OLE enumerate the formats from the registry.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Runtime.InteropServices.ComTypes.IDataObject.GetCanonicalFormatEtc">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DateTimePicker.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DateTimePicker.xml
index 9be6fbb40c8..2bba215ca9e 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DateTimePicker.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DateTimePicker.xml
@@ -470,7 +470,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you do not explicitly call the <see cref="M:System.Windows.Forms.DateTimePicker.CreateAccessibilityInstance" /> method, it will be called when the <see cref="P:System.Windows.Forms.Control.AccessibilityObject" /> property is referenced.</para>
@@ -482,6 +481,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessibility object for the <see cref="T:System.Windows.Forms.DateTimePicker" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.DateTimePicker.DateTimePickerAccessibleObject" /> for the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1097,7 +1100,6 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this method during window-message preprocessing to determine whether the specified key is a regular input key that should be sent directly to the control or a special key (such as PAGE UP and PAGE DOWN) that should preprocessed. In the latter case, send the key to the control only if it is not consumed by the preprocessing phase.</para>
@@ -1106,6 +1108,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified key is a regular input key or a special key that requires preprocessing.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified key is a regular input key; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.Keys" /> values. </param>
       </Docs>
@@ -1385,6 +1391,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Raises the <see cref="E:System.Windows.Forms.Control.FontChanged" /> event.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.DateTimePicker" /> control automatically recalculates its height to fit the new font.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.EventArgs" /> that contains the event data.</param>
       </Docs>
@@ -1869,12 +1879,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Windows.Forms.DateTimePicker" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Windows.Forms.DateTimePicker" />. The string includes the type and the <see cref="P:System.Windows.Forms.DateTimePicker.Value" /> property of the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DockingAttribute.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DockingAttribute.xml
index f7f47b9e375..28813d328a2 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DockingAttribute.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DockingAttribute.xml
@@ -109,13 +109,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares an arbitrary object with the <see cref="T:System.Windows.Forms.DockingAttribute" /> object for equality.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true is <paramref name="obj" /> is equal to this <see cref="T:System.Windows.Forms.DockingAttribute" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> against which to compare this <see cref="T:System.Windows.Forms.DockingAttribute" />.</param>
       </Docs>
@@ -131,13 +134,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The hash code for this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Int32" /> representing an in-memory hash of this object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -151,13 +157,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Specifies whether this <see cref="T:System.Windows.Forms.DockingAttribute" /> is the default docking attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true is the current <see cref="T:System.Windows.Forms.DockingAttribute" /> is the default; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DomainUpDown.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DomainUpDown.xml
index 52eb2131257..7b39065180a 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DomainUpDown.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/DomainUpDown.xml
@@ -64,7 +64,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you do not explicitly call the <see cref="M:System.Windows.Forms.DomainUpDown.CreateAccessibilityInstance" /> method, it will be called when the <see cref="P:System.Windows.Forms.Control.AccessibilityObject" /> property is referenced.</para>
@@ -76,6 +75,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessibility object for the <see cref="T:System.Windows.Forms.DomainUpDown" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.DomainUpDown.DomainUpDownAccessibleObject" /> for the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -422,7 +425,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return string includes the type and the values for the <see cref="P:System.Collections.ArrayList.Count" /> and <see cref="P:System.Windows.Forms.DomainUpDown.SelectedIndex" /> properties.</para>
@@ -431,6 +433,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the <see cref="T:System.Windows.Forms.DomainUpDown" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Windows.Forms.DomainUpDown" />. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ErrorProvider.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ErrorProvider.xml
index 1b539c1bf44..2c6a57079a5 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ErrorProvider.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ErrorProvider.xml
@@ -250,7 +250,6 @@
         <Parameter Name="extendee" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Typically, you will use <see cref="M:System.Windows.Forms.ErrorProvider.CanExtend(System.Object)" /> to determine whether you can attach an <see cref="T:System.Windows.Forms.ErrorProvider" /> to the specified control.</para>
@@ -259,6 +258,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether a control can be extended.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the control can be extended; otherwise, false.</para>
+          <para>This property will be true if the object is a <see cref="T:System.Windows.Forms.Control" /> and is not a <see cref="T:System.Windows.Forms.Form" /> or <see cref="T:System.Windows.Forms.ToolBar" />.</para>
+        </returns>
         <param name="extendee">
           <attribution license="cc4" from="Microsoft" modified="false" />The control to be extended. </param>
       </Docs>
@@ -406,12 +410,15 @@
         <Parameter Name="control" Type="System.Windows.Forms.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the current error description string for the specified control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The error description string for the specified control.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The item to get the error description string for. </param>
       </Docs>
@@ -438,12 +445,15 @@
         <Parameter Name="control" Type="System.Windows.Forms.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating where the error icon should be placed in relation to the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.ErrorIconAlignment" /> values. The default icon alignment is <see cref="F:System.Windows.Forms.ErrorIconAlignment.MiddleRight" />.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The control to get the icon location for. </param>
       </Docs>
@@ -470,7 +480,6 @@
         <Parameter Name="control" Type="System.Windows.Forms.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Many icons typically have extra space around their central images, so the padding value is only necessary if additional space is necessary. Padding values can be positive or negative. Negative values cause the icon to overlap the edge of the control. The default icon padding is 0.</para>
@@ -479,6 +488,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the amount of extra space to leave next to the error icon.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of pixels to leave between the icon and the control. </para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The control to get the padding for. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/FeatureSupport.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/FeatureSupport.xml
index ffb7813c16e..73a622ebb5d 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/FeatureSupport.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/FeatureSupport.xml
@@ -52,7 +52,6 @@
         <Parameter Name="feature" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Version numbers consist of three parts: major, minor, and build. Typically, a version number is displayed as "major number.minor number.build number".</para>
@@ -61,6 +60,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, gets the version of the specified feature that is available on the system.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Version" /> representing the version number of the specified feature available on the system; or null if the feature is not installed.</para>
+        </returns>
         <param name="feature">
           <attribution license="cc4" from="Microsoft" modified="false" />The feature whose version is requested. </param>
       </Docs>
@@ -80,7 +83,6 @@
         <Parameter Name="featureConstName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Version numbers consist of three parts: major, minor, and build. Typically, a version number is displayed as "major number.minor number.build number".</para>
@@ -90,6 +92,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the version of the specified feature that is available on the system.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Version" /> with the version number of the specified feature available on the system; or null if the feature is not installed.</para>
+        </returns>
         <param name="featureClassName">
           <attribution license="cc4" from="Microsoft" modified="false" />The fully qualified name of the class to query for information about the specified feature. This class must implement the <see cref="T:System.Windows.Forms.IFeatureSupport" /> interface or inherit from a class that implements this interface. </param>
         <param name="featureConstName">
@@ -110,12 +116,15 @@
         <Parameter Name="feature" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether any version of the specified feature is installed in the system.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the feature is present; otherwise, false.</para>
+        </returns>
         <param name="feature">
           <attribution license="cc4" from="Microsoft" modified="false" />The feature to look for. </param>
       </Docs>
@@ -135,12 +144,15 @@
         <Parameter Name="minimumVersion" Type="System.Version" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified or newer version of the specified feature is installed in the system.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the feature is present and its version number is greater than or equal to the specified minimum version number; false if the feature is not installed or its version number is below the specified minimum number.</para>
+        </returns>
         <param name="feature">
           <attribution license="cc4" from="Microsoft" modified="false" />The feature to look for. </param>
         <param name="minimumVersion">
@@ -162,7 +174,6 @@
         <Parameter Name="featureConstName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the documentation for the product containing the feature to determine the names to pass to the <paramref name="featureClassName" /> and the <paramref name="featureConstName" /> parameters.</para>
@@ -171,6 +182,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether any version of the specified feature is installed in the system. This method is static.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified feature is present; false if the specified feature is not present or if the product containing the feature is not installed.</para>
+        </returns>
         <param name="featureClassName">
           <attribution license="cc4" from="Microsoft" modified="false" />The fully qualified name of the class to query for information about the specified feature. This class must implement the <see cref="T:System.Windows.Forms.IFeatureSupport" /> interface or inherit from a class that implements this interface. </param>
         <param name="featureConstName">
@@ -193,7 +208,6 @@
         <Parameter Name="minimumVersion" Type="System.Version" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the documentation for the product containing the feature to determine the names to pass to the <paramref name="featureClassName" /> and the <paramref name="featureConstName" /> parameters.</para>
@@ -202,6 +216,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified or newer version of the specified feature is installed in the system. This method is static.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the feature is present and its version number is greater than or equal to the specified minimum version number; false if the feature is not installed or its version number is below the specified minimum number.</para>
+        </returns>
         <param name="featureClassName">
           <attribution license="cc4" from="Microsoft" modified="false" />The fully qualified name of the class to query for information about the specified feature. This class must implement the <see cref="T:System.Windows.Forms.IFeatureSupport" /> interface or inherit from a class that implements this interface. </param>
         <param name="featureConstName">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/FileDialog.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/FileDialog.xml
index ed4cd4df0ba..24c0d756deb 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/FileDialog.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/FileDialog.xml
@@ -468,7 +468,6 @@
         <Parameter Name="lparam" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A hook procedure allows the user to connect or insert other routines into a routine or application for the purpose of debugging or enhancing functionality.</para>
@@ -478,6 +477,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines the common dialog box hook procedure that is overridden to add specific functionality to the file dialog box.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns zero if the default dialog box procedure processes the message; returns a nonzero value if the default dialog box procedure ignores the message.</para>
+        </returns>
         <param name="hWnd">
           <attribution license="cc4" from="Microsoft" modified="false" />The handle to the dialog box window. </param>
         <param name="msg">
@@ -652,7 +655,6 @@
         <Parameter Name="hWndOwner" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method provides an implementation of <see cref="M:System.Windows.Forms.CommonDialog.RunDialog(System.IntPtr)" />, and is invoked when the user of a file dialog invokes <see cref="M:System.Windows.Forms.CommonDialog.ShowDialog" />.</para>
@@ -662,6 +664,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Specifies a common dialog box.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the file could be opened; otherwise, false.</para>
+        </returns>
         <param name="hWndOwner">
           <attribution license="cc4" from="Microsoft" modified="false" />A value that represents the window handle of the owner window for the common dialog box. </param>
       </Docs>
@@ -762,12 +768,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides a string version of this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string version of this object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/FileDialogCustomPlace.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/FileDialogCustomPlace.xml
index 4b32dd36cc4..8c76b6dd4f6 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/FileDialogCustomPlace.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/FileDialogCustomPlace.xml
@@ -109,12 +109,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents this <see cref="T:System.Windows.Forms.FileDialogCustomPlace" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents this <see cref="T:System.Windows.Forms.FileDialogCustomPlace" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/FlowLayoutPanel.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/FlowLayoutPanel.xml
index e845afb1103..5c70deca483 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/FlowLayoutPanel.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/FlowLayoutPanel.xml
@@ -107,13 +107,16 @@
         <Parameter Name="control" Type="System.Windows.Forms.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that represents the flow-break setting of the <see cref="T:System.Windows.Forms.FlowLayoutPanel" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the flow break is set; otherwise, false.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The child control.</param>
       </Docs>
@@ -192,7 +195,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.FlowLayoutPanel" /> instance is cast to an <see cref="T:System.ComponentModel.IExtenderProvider" /> interface.</para>
@@ -201,6 +203,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ComponentModel.IExtenderProvider.CanExtend(System.Object)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this object can provide extender properties to the specified object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to receive the extender properties.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/FlowLayoutSettings.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/FlowLayoutSettings.xml
index a53cf832764..a4e0f7bca89 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/FlowLayoutSettings.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/FlowLayoutSettings.xml
@@ -75,13 +75,16 @@
         <Parameter Name="child" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that represents the flow break setting of the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the flow break is set; otherwise, false.</para>
+        </returns>
         <param name="child">
           <attribution license="cc4" from="Microsoft" modified="false" />The child control.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/FontDialog.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/FontDialog.xml
index 8666bf23a10..8b3956a2da3 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/FontDialog.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/FontDialog.xml
@@ -422,7 +422,6 @@
         <Parameter Name="lparam" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A hook procedure is a mechanism by which a function can intercept events before they reach an application. When you override the <see cref="M:System.Windows.Forms.CommonDialog.HookProc(System.IntPtr,System.Int32,System.IntPtr,System.IntPtr)" /> method for a <see cref="T:System.Windows.Forms.CommonDialog" /> class, the operating system invokes your override of the function to post operating system messages to the window.</para>
@@ -431,6 +430,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Specifies the common dialog box hook procedure that is overridden to add specific functionality to a common dialog box.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A zero value if the default dialog box procedure processes the message; a nonzero value if the default dialog box procedure ignores the message.</para>
+        </returns>
         <param name="hWnd">
           <attribution license="cc4" from="Microsoft" modified="false" />The handle to the dialog box window. </param>
         <param name="msg">
@@ -583,7 +586,6 @@
         <Parameter Name="hWndOwner" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.FontDialog.RunDialog(System.IntPtr)" /> method is invoked when the user of a font dialog box calls the <see cref="M:System.Windows.Forms.CommonDialog.ShowDialog" /> method.</para>
@@ -592,6 +594,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Specifies a file dialog box.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the dialog box was successfully run; otherwise, false.</para>
+        </returns>
         <param name="hWndOwner">
           <attribution license="cc4" from="Microsoft" modified="false" />The window handle of the owner window for the common dialog box.</param>
       </Docs>
@@ -728,12 +734,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a string that includes the name of the current font selected in the dialog box.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that includes the name of the currently selected font.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Form.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Form.xml
index 5b362de54f1..3e847ee7bb1 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Form.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Form.xml
@@ -1248,7 +1248,6 @@
         <Parameter Name="font" Type="System.Drawing.Font" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1260,6 +1259,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the size when autoscaling the form based on a specified font.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.SizeF" /> representing the autoscaled size of the form.</para>
+        </returns>
         <param name="font">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Font" /> representing the font to determine the autoscaled base size of the form. </param>
       </Docs>
@@ -3324,12 +3327,15 @@
         <Parameter Name="charCode" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a dialog character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character was processed by the control; otherwise, false.</para>
+        </returns>
         <param name="charCode">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to process. </param>
       </Docs>
@@ -3353,7 +3359,6 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.Form.ProcessDialogKey(System.Windows.Forms.Keys)" /> method overrides the base <see cref="M:System.Windows.Forms.ContainerControl.ProcessDialogKey(System.Windows.Forms.Keys)" /> implementation to provide additional handling of the RETURN and ESCAPE keys in dialog boxes. The method performs no processing on keystrokes that include the ALT or CONTROL modifiers.</para>
@@ -3362,6 +3367,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a dialog box key. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the keystroke was processed and consumed by the control; otherwise, false to allow further processing.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.Keys" /> values that represents the key to process. </param>
       </Docs>
@@ -3403,12 +3412,15 @@
         <Parameter Name="charCode" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a mnemonic character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character was processed as a mnemonic by the control; otherwise, false.</para>
+        </returns>
         <param name="charCode">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to process. </param>
       </Docs>
@@ -3888,7 +3900,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3900,6 +3911,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Shows the form as a modal dialog box.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DialogResult" /> values.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -3916,7 +3931,6 @@
         <Parameter Name="owner" Type="System.Windows.Forms.IWin32Window" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use this method to display a modal dialog box in your application. When this method is called, the code following it is not executed until after the dialog box is closed. The dialog box can be assigned one of the values of <see cref="T:System.Windows.Forms.DialogResult" /> by assigning it to the <see cref="P:System.Windows.Forms.Button.DialogResult" /> property of a <see cref="T:System.Windows.Forms.Button" /> on the form or by setting the <see cref="P:System.Windows.Forms.Form.DialogResult" /> property of the form in code. This value is then returned by this method. You can use this return value to determine how to process the actions that occurred in the dialog box. For example, if the dialog box was closed and returned the DialogResult.Cancel value through this method, you could prevent code following the call to <see cref="M:System.Windows.Forms.Form.ShowDialog" /> from executing.</para>
@@ -3927,6 +3941,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Shows the form as a modal dialog box with the specified owner.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DialogResult" /> values.</para>
+        </returns>
         <param name="owner">
           <attribution license="cc4" from="Microsoft" modified="false" />Any object that implements <see cref="T:System.Windows.Forms.IWin32Window" /> that represents the top-level window that will own the modal dialog box. </param>
       </Docs>
@@ -4348,12 +4366,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a string representing the current instance of the form.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string consisting of the fully qualified name of the form object's class, with the <see cref="P:System.Windows.Forms.Form.Text" /> property of the form appended to the end. For example, if the form is derived from the class MyForm in the MyNamespace namespace, and the <see cref="P:System.Windows.Forms.Form.Text" /> property is set to <userInput>Hello, World</userInput>, this method will return <userInput>MyNamespace.MyForm, Text: Hello, World</userInput>.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/GridColumnStylesCollection.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/GridColumnStylesCollection.xml
index 06cbc75994f..4566845a132 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/GridColumnStylesCollection.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/GridColumnStylesCollection.xml
@@ -48,12 +48,15 @@
         <Parameter Name="column" Type="System.Windows.Forms.DataGridColumnStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a column style to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the new <see cref="T:System.Windows.Forms.DataGridColumnStyle" />.</para>
+        </returns>
         <param name="column">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.DataGridColumnStyle" /> to add. </param>
       </Docs>
@@ -135,7 +138,6 @@
         <Parameter Name="propertyDescriptor" Type="System.ComponentModel.PropertyDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To get a <see cref="T:System.ComponentModel.PropertyDescriptorCollection" />, use the <see cref="M:System.Windows.Forms.BindingManagerBase.GetItemProperties" /> method of the <see cref="T:System.Windows.Forms.BindingManagerBase" /> class. Pass the <see cref="P:System.Windows.Forms.DataGridColumnStyle.MappingName" /> of the <see cref="T:System.Windows.Forms.DataGridColumnStyle" /> to the <see cref="P:System.ComponentModel.PropertyDescriptorCollection.Item(System.Int32)" /> property of the <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> to return the <see cref="T:System.ComponentModel.PropertyDescriptor" /> for a specific column.</para>
@@ -145,6 +147,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the <see cref="T:System.Windows.Forms.GridColumnStylesCollection" /> contains a <see cref="T:System.Windows.Forms.DataGridColumnStyle" /> associated with the specified <see cref="T:System.ComponentModel.PropertyDescriptor" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the <see cref="T:System.Windows.Forms.DataGridColumnStyle" />; otherwise, false.</para>
+        </returns>
         <param name="propertyDescriptor">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.PropertyDescriptor" /> associated with the desired <see cref="T:System.Windows.Forms.DataGridColumnStyle" />. </param>
       </Docs>
@@ -163,7 +169,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The caption of a <see cref="T:System.Windows.Forms.DataGridColumnStyle" /> is set with the <see cref="P:System.Windows.Forms.DataGridColumnStyle.HeaderText" /> property.</para>
@@ -173,6 +178,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the <see cref="T:System.Windows.Forms.GridColumnStylesCollection" /> contains the <see cref="T:System.Windows.Forms.DataGridColumnStyle" /> with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the <see cref="T:System.Windows.Forms.DataGridColumnStyle" />; otherwise, false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Windows.Forms.DataGridColumnStyle.MappingName" /> of the desired <see cref="T:System.Windows.Forms.DataGridColumnStyle" />. </param>
       </Docs>
@@ -191,7 +200,6 @@
         <Parameter Name="column" Type="System.Windows.Forms.DataGridColumnStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Windows.Forms.GridColumnStylesCollection.Contains(System.ComponentModel.PropertyDescriptor)" /> method to determine if a particular <see cref="T:System.Windows.Forms.DataGridColumnStyle" /> exists before invoking the <see cref="M:System.Windows.Forms.GridColumnStylesCollection.Remove(System.Windows.Forms.DataGridColumnStyle)" /> method to remove the item. If you need to know the index of a particular <see cref="T:System.Windows.Forms.DataGridColumnStyle" />, use the <see cref="M:System.Windows.Forms.GridColumnStylesCollection.IndexOf(System.Windows.Forms.DataGridColumnStyle)" /> method.</para>
@@ -200,6 +208,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the <see cref="T:System.Windows.Forms.GridColumnStylesCollection" /> contains the specified <see cref="T:System.Windows.Forms.DataGridColumnStyle" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the <see cref="T:System.Windows.Forms.DataGridColumnStyle" />; otherwise, false.</para>
+        </returns>
         <param name="column">
           <attribution license="cc4" from="Microsoft" modified="false" />The desired <see cref="T:System.Windows.Forms.DataGridColumnStyle" />. </param>
       </Docs>
@@ -218,7 +230,6 @@
         <Parameter Name="element" Type="System.Windows.Forms.DataGridColumnStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Windows.Forms.GridColumnStylesCollection.Contains(System.ComponentModel.PropertyDescriptor)" /> method to determine if a specific <see cref="T:System.Windows.Forms.DataGridColumnStyle" /> exists. If so, and you need the index of the element within the collection, use the <see cref="M:System.Windows.Forms.GridColumnStylesCollection.IndexOf(System.Windows.Forms.DataGridColumnStyle)" /> method.</para>
@@ -227,6 +238,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of a specified <see cref="T:System.Windows.Forms.DataGridColumnStyle" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the <see cref="T:System.Windows.Forms.DataGridColumnStyle" /> within the <see cref="T:System.Windows.Forms.GridColumnStylesCollection" /> or -1 if no corresponding <see cref="T:System.Windows.Forms.DataGridColumnStyle" /> exists.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.DataGridColumnStyle" /> to find. </param>
       </Docs>
@@ -507,12 +522,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator for the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Add">
@@ -529,12 +547,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an object to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the value has been added.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be added to the collection. The value can be null.</param>
       </Docs>
@@ -572,12 +593,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether an element is in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the element is in the collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to locate in the collection. The value can be null.</param>
       </Docs>
@@ -596,12 +620,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the zero-based index of the first occurrence of the specified object in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of the <paramref name="value" /> parameter within the collection, if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to locate in the collection. The value can be null.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/GridItem.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/GridItem.xml
index 8eeb953cd21..cc4eeadfc26 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/GridItem.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/GridItem.xml
@@ -196,12 +196,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, selects this <see cref="T:System.Windows.Forms.GridItem" /> in the <see cref="T:System.Windows.Forms.PropertyGrid" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the selection is successful; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/GridItemCollection.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/GridItemCollection.xml
index c561a0ae6d1..d6872510b86 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/GridItemCollection.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/GridItemCollection.xml
@@ -71,12 +71,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumeration of all the grid items in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.Windows.Forms.GridItemCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/GridTableStylesCollection.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/GridTableStylesCollection.xml
index 25779442cb1..d8e06a0df62 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/GridTableStylesCollection.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/GridTableStylesCollection.xml
@@ -45,12 +45,15 @@
         <Parameter Name="table" Type="System.Windows.Forms.DataGridTableStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Windows.Forms.DataGridTableStyle" /> to this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the newly added object.</para>
+        </returns>
         <param name="table">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.DataGridTableStyle" /> to add to the collection. </param>
       </Docs>
@@ -132,12 +135,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the <see cref="T:System.Windows.Forms.GridTableStylesCollection" /> contains the <see cref="T:System.Windows.Forms.DataGridTableStyle" /> specified by name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified table style exists in the collection; otherwise, false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Windows.Forms.DataGridTableStyle.MappingName" /> of the <see cref="T:System.Windows.Forms.DataGridTableStyle" /> to look for. </param>
       </Docs>
@@ -156,12 +162,15 @@
         <Parameter Name="table" Type="System.Windows.Forms.DataGridTableStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the <see cref="T:System.Windows.Forms.GridTableStylesCollection" /> contains the specified <see cref="T:System.Windows.Forms.DataGridTableStyle" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified table style exists in the collection; otherwise, false.</para>
+        </returns>
         <param name="table">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.DataGridTableStyle" /> to look for. </param>
       </Docs>
@@ -399,12 +408,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator for the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Add">
@@ -421,12 +433,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Windows.Forms.DataGridTableStyle" /> to this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the newly added object.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.DataGridTableStyle" /> to add to the collection.</param>
       </Docs>
@@ -464,12 +479,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether an element is in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if value is found in the collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to locate in the collection. The value can be null.</param>
       </Docs>
@@ -488,12 +506,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the zero-based index of the first occurrence of the specified object in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of value within the entire collection, if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to locate in the collection. The value can be null.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/GridTablesFactory.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/GridTablesFactory.xml
index bc17bb3b83e..88c40fb2130 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/GridTablesFactory.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/GridTablesFactory.xml
@@ -31,12 +31,15 @@
         <Parameter Name="bindingManager" Type="System.Windows.Forms.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified <see cref="P:System.Windows.Forms.DataGridColumnStyle.DataGridTableStyle" /> in a one-element array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Windows.Forms.DataGridTableStyle" /> objects.</para>
+        </returns>
         <param name="gridTable">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.DataGridTableStyle" />.</param>
         <param name="dataSource">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/GroupBox.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/GroupBox.xml
index c2800ac2068..ea60b2ed7e7 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/GroupBox.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/GroupBox.xml
@@ -213,7 +213,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you do not explicitly call the <see cref="M:System.Windows.Forms.GroupBox.CreateAccessibilityInstance" /> method, it will be called when the <see cref="P:System.Windows.Forms.Control.AccessibilityObject" /> property is referenced.</para>
@@ -222,6 +221,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessibility object for the <see cref="T:System.Windows.Forms.GroupBox" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.AccessibleObject" /> for the <see cref="T:System.Windows.Forms.GroupBox" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateParams">
@@ -788,8 +791,11 @@
       <Parameters />
       <Docs>
         <summary>To be added.</summary>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Windows.Forms.GroupBox" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/GroupBoxRenderer.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/GroupBoxRenderer.xml
index 5bf239de94b..182b7c52deb 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/GroupBoxRenderer.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/GroupBoxRenderer.xml
@@ -258,13 +258,16 @@
         <Parameter Name="state" Type="System.Windows.Forms.VisualStyles.GroupBoxState" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the background of the group box has any semitransparent or alpha-blended pieces.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the background of the group box has semitransparent or alpha-blended pieces; otherwise, false.</para>
+        </returns>
         <param name="state">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.VisualStyles.GroupBoxState" /> values that specifies the visual state of the group box.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/HelpProvider.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/HelpProvider.xml
index 4d2980d0c31..4061672e9c1 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/HelpProvider.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/HelpProvider.xml
@@ -75,12 +75,15 @@
         <Parameter Name="target" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Specifies whether this object can provide its extender properties to the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this object can provide its extender properties; otherwise, false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The object that the externder properties are provided to. </param>
       </Docs>
@@ -99,12 +102,15 @@
         <Parameter Name="ctl" Type="System.Windows.Forms.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the Help keyword for the specified control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The Help keyword associated with this control, or null if the <see cref="T:System.Windows.Forms.HelpProvider" /> is currently configured to display the entire Help file or is configured to provide a Help string.</para>
+        </returns>
         <param name="ctl">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Control" /> from which to retrieve the Help topic. </param>
       </Docs>
@@ -131,12 +137,15 @@
         <Parameter Name="ctl" Type="System.Windows.Forms.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the current <see cref="T:System.Windows.Forms.HelpNavigator" /> setting for the specified control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.HelpNavigator" /> setting for the specified control. The default is <see cref="F:System.Windows.Forms.HelpNavigator.AssociateIndex" />.</para>
+        </returns>
         <param name="ctl">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Control" /> from which to retrieve the Help navigator. </param>
       </Docs>
@@ -163,7 +172,6 @@
         <Parameter Name="ctl" Type="System.Windows.Forms.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To display this Help string at run time, the user presses the F1 key while the specified control has the input focus.</para>
@@ -172,6 +180,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the contents of the pop-up Help window for the specified control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The Help string associated with this control. The default is null.</para>
+        </returns>
         <param name="ctl">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Control" /> from which to retrieve the Help string. </param>
       </Docs>
@@ -198,7 +210,6 @@
         <Parameter Name="ctl" Type="System.Windows.Forms.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When you use the <see cref="M:System.Windows.Forms.HelpProvider.SetHelpKeyword(System.Windows.Forms.Control,System.String)" /> or <see cref="M:System.Windows.Forms.HelpProvider.SetHelpString(System.Windows.Forms.Control,System.String)" /> method to associate a keyword or prompt with a specified control, calling this method automatically returns true. You can override this behavior by passing false to the <see cref="M:System.Windows.Forms.HelpProvider.SetShowHelp(System.Windows.Forms.Control,System.Boolean)" /> method.</para>
@@ -207,6 +218,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified control's Help should be displayed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if Help will be displayed for the control; otherwise, false.</para>
+        </returns>
         <param name="ctl">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Control" /> for which Help will be displayed. </param>
       </Docs>
@@ -432,7 +447,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.HelpProvider.ToString" /> method returns a string that includes the type and the <see cref="P:System.Windows.Forms.HelpProvider.HelpNamespace" /> property of the <see cref="T:System.Windows.Forms.HelpProvider" />.</para>
@@ -441,6 +455,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Windows.Forms.HelpProvider" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Windows.Forms.HelpProvider" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/HtmlDocument.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/HtmlDocument.xml
index 36e3b547fb1..10280064df9 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/HtmlDocument.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/HtmlDocument.xml
@@ -284,7 +284,6 @@
         <Parameter Name="elementTag" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -298,6 +297,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new HtmlElement of the specified HTML tag type. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new element of the specified tag type. </para>
+        </returns>
         <param name="elementTag">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the HTML element to create. </param>
       </Docs>
@@ -425,12 +428,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests the object for equality against the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the objects are equal; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test.</param>
       </Docs>
@@ -591,7 +597,6 @@
         <Parameter Name="id" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If there are multiple elements in the document with the same ID value, <see cref="M:System.Windows.Forms.HtmlDocument.GetElementById(System.String)" /> will return the first one it finds.</para>
@@ -600,6 +605,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a single <see cref="T:System.Windows.Forms.HtmlElement" /> using the element's ID attribute as a search key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the first object with the same ID attribute as the specified value, or null if the <paramref name="id" /> cannot be found. </para>
+        </returns>
         <param name="id">
           <attribution license="cc4" from="Microsoft" modified="false" />The ID attribute of the element to retrieve.</param>
       </Docs>
@@ -617,7 +626,6 @@
         <Parameter Name="point" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -627,6 +635,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the HTML element located at the specified client coordinates.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.HtmlElement" /> at the specified screen location in the document.</para>
+        </returns>
         <param name="point">
           <attribution license="cc4" from="Microsoft" modified="false" />The x,y position of the element on the screen, relative to the top-left corner of the document. </param>
       </Docs>
@@ -644,12 +656,15 @@
         <Parameter Name="tagName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieve a collection of elements with the specified HTML tag.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The collection of elements who tag name is equal to the <paramref name="tagName" /> argument.</para>
+        </returns>
         <param name="tagName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the HTML tag for the <see cref="T:System.Windows.Forms.HtmlElement" /> objects you want to retrieve.</param>
       </Docs>
@@ -665,12 +680,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the hash code for this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Int32" /> representing an in-memory hash of this object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Images">
@@ -709,7 +727,6 @@
         <Parameter Name="scriptName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The underlying type of the object returned by <see cref="M:System.Windows.Forms.HtmlDocument.InvokeScript(System.String)" /> will vary. If the called Active Scripting function returns scalar data, such as a string or an integer, it will be returned as a string. If it returns a script-based object, such as an object created using JScript or VBScript's new operator, it will be of type Object. (You can make calls on such objects by calling <see cref="M:System.Object.GetType" /> and using <see cref="Overload:System.Type.InvokeMember" />.) If it returns an HTML DOM element, such as a DIV or a TABLE, it will be of type Object; if you have added a project reference to MSHTML.DLL, however, it will be cast to its specific unmanaged DOM type.</para>
@@ -720,6 +737,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes an Active Scripting function defined in an HTML page.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object returned by the Active Scripting call. </para>
+        </returns>
         <param name="scriptName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the script method to invoke.</param>
       </Docs>
@@ -738,7 +759,6 @@
         <Parameter Name="args" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The underlying type of the object returned by <see cref="M:System.Windows.Forms.HtmlDocument.InvokeScript(System.String,System.Object[])" /> will vary. If the called Active Scripting function returns scalar data, such as a string or an integer, it will be returned as a string. If it returns a script-based object, such as an object created using JScript or VBScript's new operator, it will be of type Object. (You can make calls on such objects by calling <see cref="M:System.Object.GetType" /> and using <see cref="Overload:System.Type.InvokeMember" />.) If it returns an HTML DOM element, such as a DIV or a TABLE, it will be of type Object; if you have added a project reference to MSHTML.DLL, however, it will be cast to its specific unmanaged DOM type.</para>
@@ -749,6 +769,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes an Active Scripting function defined in an HTML page.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object returned by the Active Scripting call. </para>
+        </returns>
         <param name="scriptName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the script method to invoke.</param>
         <param name="args">
@@ -933,12 +957,15 @@
         <Parameter Name="right" Type="System.Windows.Forms.HtmlDocument" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the specified <see cref="T:System.Windows.Forms.HtmlDocument" /> instances represent the same value. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified instances are equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first instance to compare.</param>
         <param name="right">
@@ -959,12 +986,15 @@
         <Parameter Name="right" Type="System.Windows.Forms.HtmlDocument" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the specified <see cref="T:System.Windows.Forms.HtmlDocument" /> instances do not represent the same value. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified instances are not equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first instance to compare.</param>
         <param name="right">
@@ -984,7 +1014,6 @@
         <Parameter Name="replaceInHistory" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -996,6 +1025,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a new <see cref="T:System.Windows.Forms.HtmlDocument" /> to use with the <see cref="M:System.Windows.Forms.HtmlDocument.Write(System.String)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new document for writing.</para>
+        </returns>
         <param name="replaceInHistory">
           <attribution license="cc4" from="Microsoft" modified="false" />Whether the new window's navigation should replace the previous element in the navigation history of the DOM. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/HtmlElement.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/HtmlElement.xml
index 9e367598d61..3e45ae114ef 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/HtmlElement.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/HtmlElement.xml
@@ -60,7 +60,6 @@
         <Parameter Name="newElement" Type="System.Windows.Forms.HtmlElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The HTML Document Object Model (DOM) enables you to alter the run-time contents of an HTML file in a number of ways. Use <see cref="M:System.Windows.Forms.HtmlElement.AppendChild(System.Windows.Forms.HtmlElement)" /> to add new elements to an existing document, or to move an element on the page.</para>
@@ -71,6 +70,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an element to another element's subtree.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The element after it has been added to the tree. </para>
+        </returns>
         <param name="newElement">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.HtmlElement" /> to append to this location in the tree. </param>
       </Docs>
@@ -417,12 +420,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests if the supplied object is equal to the current element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is an <see cref="T:System.Windows.Forms.HtmlElement" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test for equality.</param>
       </Docs>
@@ -506,7 +512,6 @@
         <Parameter Name="attributeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An attribute in HTML is any valid name/value pair for that element. <see cref="T:System.Windows.Forms.HtmlElement" /> exposes only those attributes that are common to all elements, leaving out those that only apply to certain types of elements; SRC is a predefined attribute for the IMG tag, for example, but not for the DIV tag. Use <see cref="M:System.Windows.Forms.HtmlElement.GetAttribute(System.String)" /> and <see cref="M:System.Windows.Forms.HtmlElement.SetAttribute(System.String,System.String)" /> to manipulate attributes not exposed on the managed Document Object Model (DOM). </para>
@@ -517,6 +522,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the value of the named attribute on the element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of this attribute on the element, as a <see cref="T:System.String" /> value. If the specified attribute does not exist on this element, returns an empty string.</para>
+        </returns>
         <param name="attributeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the attribute. This argument is case-insensitive.</param>
       </Docs>
@@ -534,12 +543,15 @@
         <Parameter Name="tagName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection of elements represented in HTML by the specified HTML tag.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Windows.Forms.HtmlElementCollection" /> containing all elements whose HTML tag name is equal to <paramref name="tagName" />.</para>
+        </returns>
         <param name="tagName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the tag whose <see cref="T:System.Windows.Forms.HtmlElement" /> objects you wish to retrieve.</param>
       </Docs>
@@ -666,7 +678,6 @@
         <Parameter Name="newElement" Type="System.Windows.Forms.HtmlElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Do not call this method until after the <see cref="E:System.Windows.Forms.WebBrowser.DocumentCompleted" /> event on the <see cref="T:System.Windows.Forms.WebBrowser" /> control has occurred. Calling this method before then can result in an exception, as the document will not have finished loading. </para>
@@ -676,6 +687,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Insert a new element into the Document Object Model (DOM).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.HtmlElement" /> that was just inserted. If insertion failed, this will return null.</para>
+        </returns>
         <param name="orient">
           <attribution license="cc4" from="Microsoft" modified="false" />Where to insert this element in relation to the current element.</param>
         <param name="newElement">
@@ -695,7 +710,6 @@
         <Parameter Name="methodName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to call methods from the Document Object Model (DOM) that do not have equivalents in managed code. Use this version of <see cref="M:System.Windows.Forms.HtmlElement.InvokeMember(System.String)" /> to execute unexposed methods that take no arguments. For an example, see <see cref="M:System.Windows.Forms.HtmlElement.InvokeMember(System.String,System.Object[])" />.</para>
@@ -704,6 +718,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes an unexposed method on the underlying DOM element of this element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The element returned by this method, represented as an <see cref="T:System.Object" />. If this <see cref="T:System.Object" /> is another HTML element, and you have a reference to the unmanaged MSHTML library added to your project, you can cast it to its appropriate unmanaged interface.</para>
+        </returns>
         <param name="methodName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the property or method to invoke. </param>
       </Docs>
@@ -728,7 +746,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to call methods from the Document Object Model (DOM) that do not have equivalents in managed code. All arguments supplied to <see cref="M:System.Windows.Forms.HtmlElement.InvokeMember(System.String,System.Object[])" /> will be converted to Win32 VARIANT data types before they are passed to the named scripting function. </para>
@@ -737,6 +754,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a function defined in the current HTML page by a scripting language.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The element returned by the function, represented as an <see cref="T:System.Object" />. If this <see cref="T:System.Object" /> is another HTML element, and you have a reference to the unmanaged MSHTML library added to your project, you can cast it to its appropriate unmanaged interface.</para>
+        </returns>
         <param name="methodName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the property or method to invoke.</param>
         <param name="parameter">
@@ -1090,7 +1111,6 @@
         <Parameter Name="right" Type="System.Windows.Forms.HtmlElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The equality operator tests the IUnknown pointers of the underlying COM objects wrapped by the supplied <see cref="T:System.Windows.Forms.HtmlElement" /> classes.</para>
@@ -1099,6 +1119,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two elements for equality.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if both parameters are null, or if both elements have the same underlying COM interface; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Windows.Forms.HtmlElement" />.</param>
         <param name="right">
@@ -1119,12 +1143,15 @@
         <Parameter Name="right" Type="System.Windows.Forms.HtmlElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Windows.Forms.HtmlElement" /> objects for inequality.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true is only one element is null, or the two objects are not equal; otherwise, false. </para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Windows.Forms.HtmlElement" />.</param>
         <param name="right">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/HtmlElementCollection.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/HtmlElementCollection.xml
index ee3291d071d..5a79b2ae02d 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/HtmlElementCollection.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/HtmlElementCollection.xml
@@ -52,7 +52,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>While the <see cref="P:System.Windows.Forms.HtmlElement.Id" /> property of an <see cref="T:System.Windows.Forms.HtmlElement" /> must be unique, multiple elements can use the same <see cref="P:System.Windows.Forms.HtmlElement.Name" /> property. </para>
@@ -61,6 +60,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of elements by their name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Windows.Forms.HtmlElementCollection" /> containing the elements whose <see cref="P:System.Windows.Forms.HtmlElement.Name" /> property match <paramref name="name" />. </para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name or ID of the element. </param>
       </Docs>
@@ -76,12 +79,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through a collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Item">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/HtmlWindow.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/HtmlWindow.xml
index 72034c751eb..25646124d6a 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/HtmlWindow.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/HtmlWindow.xml
@@ -113,7 +113,6 @@
         <Parameter Name="message" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -124,6 +123,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a dialog box with a message and buttons to solicit a yes/no response.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the user clicked <ui>Yes</ui>; false if the user clicked <ui>No</ui> or closed the dialog box.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to display to the user.</param>
       </Docs>
@@ -209,12 +212,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests the object for equality against the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the objects are equal; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test.</param>
       </Docs>
@@ -297,8 +303,12 @@
       <Parameters />
       <Docs>
         <summary>To be added.</summary>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para />
+          <para>System.Int32</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GotFocus">
@@ -552,7 +562,6 @@
         <Parameter Name="right" Type="System.Windows.Forms.HtmlWindow" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The equality operator tests the IUnknown pointers of the underlying COM objects wrapped by the supplied <see cref="T:System.Windows.Forms.HtmlWindow" /> classes.</para>
@@ -561,6 +570,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests the two <see cref="T:System.Windows.Forms.HtmlWindow" /> objects for equality.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if both parameters are null, or if both elements have the same underlying COM interface; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Windows.Forms.HtmlWindow" /> object.</param>
         <param name="right">
@@ -581,12 +594,15 @@
         <Parameter Name="right" Type="System.Windows.Forms.HtmlWindow" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests two HtmlWindow objects for inequality.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if one but not both of the objects is null, or the underlying COM pointers do not match; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Windows.Forms.HtmlWindow" /> object.</param>
         <param name="right">
@@ -609,7 +625,6 @@
         <Parameter Name="replaceEntry" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="target" /> parameter can name a window that was created as the result of a previous call to <see cref="M:System.Windows.Forms.HtmlWindow.Open(System.String,System.String,System.String,System.Boolean)" />. The parameter may also point to a window opened by clicking on a hyperlink (A element) or a FORM element that uses the TARGET attribute to open its URL in a new window. The following HTML code will open a new window named orderWindow when the user clicks it:</para>
@@ -623,6 +638,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a file in the named window.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Windows.Forms.HtmlWindow" /> representing the new window, or the previously created window named by the <paramref name="target" /> parameter.</para>
+        </returns>
         <param name="urlString">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uniform Resource Locator that describes the location of the file to load.</param>
         <param name="target">
@@ -649,7 +668,6 @@
         <Parameter Name="replaceEntry" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="target" /> parameter can name a window that was created as the result of a previous call to <see cref="M:System.Windows.Forms.HtmlWindow.Open(System.Uri,System.String,System.String,System.Boolean)" />. The parameter may also point to a window opened by clicking on a hyperlink (A element) or a FORM element that uses the TARGET attribute to open its URL in a new window. The following HTML code will open a new window named orderWindow when the user clicks it:</para>
@@ -663,6 +681,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a file in the named window.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Windows.Forms.HtmlWindow" /> representing the new window, or the previously created window named by the <paramref name="target" /> parameter.</para>
+        </returns>
         <param name="url">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uniform Resource Locator that describes the location of the file to load.</param>
         <param name="target">
@@ -705,7 +727,6 @@
         <Parameter Name="windowOptions" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the file referenced by <paramref name="url" /> is an HTML file, text file, or other file type that can be hosted inside of Internet Explorer, it will be displayed in a new window. If the file cannot be displayed inside of Internet Explorer, then the window will open only long enough for Internet Explorer to download the resource; it will close immediately afterwards.</para>
@@ -716,6 +737,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a file in a new window.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Windows.Forms.HtmlWindow" /> representing the new window. </para>
+        </returns>
         <param name="urlString">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uniform Resource Locator that describes the location of the file to load.</param>
         <param name="windowOptions">
@@ -736,7 +761,6 @@
         <Parameter Name="windowOptions" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the file referenced by <paramref name="url" /> is an HTML file, text file, or other file type that can be hosted inside of Internet Explorer, it will be displayed in a new window. If the file cannot be displayed inside of Internet Explorer, then the window will open only long enough for Internet Explorer to download the resource; it will close immediately afterwards.</para>
@@ -747,6 +771,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a file in a new window.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Windows.Forms.HtmlWindow" /> representing the new window. </para>
+        </returns>
         <param name="url">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uniform Resource Locator that describes the location of the file to load.</param>
         <param name="windowOptions">
@@ -809,7 +837,6 @@
         <Parameter Name="defaultInputValue" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -820,6 +847,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Shows a dialog box that displays a message and a text box to the user. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> representing the text entered by the user.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The message to display to the user.</param>
         <param name="defaultInputValue">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/HtmlWindowCollection.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/HtmlWindowCollection.xml
index dbe486cce1e..9a544156ab6 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/HtmlWindowCollection.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/HtmlWindowCollection.xml
@@ -57,12 +57,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that can iterate through all elements in the <see cref="T:System.Windows.Forms.HtmlWindowCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Collections.IEnumerator" /> that enables enumeration of this collection's elements.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Item">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IComponentEditorPageSite.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IComponentEditorPageSite.xml
index 76bb8ce66eb..c7da379afc3 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IComponentEditorPageSite.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IComponentEditorPageSite.xml
@@ -23,12 +23,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the parent control for the page window.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The parent control for the page window.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IContainerControl.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IContainerControl.xml
index 168a8269287..d0a08f10108 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IContainerControl.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IContainerControl.xml
@@ -25,12 +25,15 @@
         <Parameter Name="active" Type="System.Windows.Forms.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Activates a specified control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the control is successfully activated; otherwise, false.</para>
+        </returns>
         <param name="active">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Control" /> being activated. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ICurrencyManagerProvider.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ICurrencyManagerProvider.xml
index ee4a68bbbbb..36c4666f37a 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ICurrencyManagerProvider.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ICurrencyManagerProvider.xml
@@ -50,7 +50,6 @@
         <Parameter Name="dataMember" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="dataMember" /> is null or an empty string (""), <see cref="M:System.Windows.Forms.ICurrencyManagerProvider.GetRelatedCurrencyManager(System.String)" /> returns the main currency manager for this <see cref="T:System.Windows.Forms.ICurrencyManagerProvider" />, which is the same currency manager returned from the <see cref="P:System.Windows.Forms.ICurrencyManagerProvider.CurrencyManager" /> property.</para>
@@ -59,6 +58,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Windows.Forms.CurrencyManager" /> for this <see cref="T:System.Windows.Forms.ICurrencyManagerProvider" /> and the specified data member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The related <see cref="T:System.Windows.Forms.CurrencyManager" /> obtained from this <see cref="T:System.Windows.Forms.ICurrencyManagerProvider" /> and the specified data member.</para>
+        </returns>
         <param name="dataMember">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the column or list, within the data source, to obtain the <see cref="T:System.Windows.Forms.CurrencyManager" /> for.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IDataGridEditingService.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IDataGridEditingService.xml
index 498878d4b65..820c45112da 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IDataGridEditingService.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IDataGridEditingService.xml
@@ -26,12 +26,15 @@
         <Parameter Name="rowNumber" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an edit operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the operation can be performed; otherwise false.</para>
+        </returns>
         <param name="gridColumn">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.DataGridColumnStyle" /> to edit. </param>
         <param name="rowNumber">
@@ -54,7 +57,6 @@
         <Parameter Name="shouldAbort" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the value cannot be committed, the <see cref="T:System.Windows.Forms.DataGridColumnStyle" /> remains editable. </para>
@@ -63,6 +65,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ends the edit operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if value is commited; otherwise false.</para>
+        </returns>
         <param name="gridColumn">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.DataGridColumnStyle" /> to edit. </param>
         <param name="rowNumber">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IDataGridViewEditingCell.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IDataGridViewEditingCell.xml
index 30344896c95..7ccb6effeb5 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IDataGridViewEditingCell.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IDataGridViewEditingCell.xml
@@ -75,7 +75,6 @@
         <Parameter Name="context" Type="System.Windows.Forms.DataGridViewDataErrorContexts" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -86,6 +85,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the formatted value of the cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the formatted version of the cell contents.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Windows.Forms.DataGridViewDataErrorContexts" /> values that specifies the context in which the data is needed.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IDataGridViewEditingControl.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IDataGridViewEditingControl.xml
index 2a13fc324c0..33d3c4dc399 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IDataGridViewEditingControl.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IDataGridViewEditingControl.xml
@@ -158,7 +158,6 @@
         <Parameter Name="dataGridViewWantsInputKey" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -169,6 +168,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified key is a regular input key that the editing control should process or a special key that the <see cref="T:System.Windows.Forms.DataGridView" /> should process.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified key is a regular input key that should be handled by the editing control; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Keys" /> that represents the key that was pressed.</param>
         <param name="dataGridViewWantsInputKey">
@@ -210,7 +213,6 @@
         <Parameter Name="context" Type="System.Windows.Forms.DataGridViewDataErrorContexts" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -221,6 +223,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the formatted value of the cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the formatted version of the cell contents.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Windows.Forms.DataGridViewDataErrorContexts" /> values that specifies the context in which the data is needed.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IDataObject.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IDataObject.xml
index 54fe747cd8d..4f430e5fa67 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IDataObject.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IDataObject.xml
@@ -45,7 +45,6 @@
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If this method cannot find data in the specified format, it attempts to convert the data to the format. If the data cannot be converted to the specified format, this method returns null.</para>
@@ -59,6 +58,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the data associated with the specified data format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The data associated with the specified format, or null.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />The format of the data to retrieve. See <see cref="T:System.Windows.Forms.DataFormats" /> for predefined formats. </param>
       </Docs>
@@ -77,7 +80,6 @@
         <Parameter Name="format" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If this method cannot find data in the specified format, it attempts to convert the data to the format. If the data cannot be converted to the specified format, this method returns null.</para>
@@ -91,6 +93,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the data associated with the specified class type format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The data associated with the specified format, or null.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> representing the format of the data to retrieve. See <see cref="T:System.Windows.Forms.DataFormats" /> for predefined formats. </param>
       </Docs>
@@ -110,7 +116,6 @@
         <Parameter Name="autoConvert" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <paramref name="autoConvert" /> parameter is true and this method cannot find data in the specified format, it attempts to convert the data to the format. If the data cannot be converted to the specified format, or if the data was stored with the <paramref name="autoConvert" /> parameter set to false, this method returns null.</para>
@@ -125,6 +130,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the data associated with the specified data format, using a Boolean to determine whether to convert the data to the format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The data associated with the specified format, or null.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />The format of the data to retrieve. See <see cref="T:System.Windows.Forms.DataFormats" /> for predefined formats. </param>
         <param name="autoConvert">
@@ -145,7 +154,6 @@
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this method to determine whether a format exists in this <see cref="T:System.Windows.Forms.DataObject" /> before calling <see cref="M:System.Windows.Forms.IDataObject.GetData(System.String,System.Boolean)" />. Call <see cref="M:System.Windows.Forms.IDataObject.GetFormats(System.Boolean)" /> for the formats that are available in this instance.</para>
@@ -158,6 +166,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether data stored in this instance is associated with, or can be converted to, the specified format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if data stored in this instance is associated with, or can be converted to, the specified format; otherwise false.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />The format for which to check. See <see cref="T:System.Windows.Forms.DataFormats" /> for predefined formats. </param>
       </Docs>
@@ -176,7 +188,6 @@
         <Parameter Name="format" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this method to determine whether a format exists in this <see cref="T:System.Windows.Forms.DataObject" /> before calling <see cref="M:System.Windows.Forms.IDataObject.GetData(System.String,System.Boolean)" />. Call <see cref="M:System.Windows.Forms.IDataObject.GetFormats(System.Boolean)" /> for the formats that are available in this instance.</para>
@@ -189,6 +200,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether data stored in this instance is associated with, or can be converted to, the specified format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if data stored in this instance is associated with, or can be converted to, the specified format; otherwise, false.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> representing the format for which to check. See <see cref="T:System.Windows.Forms.DataFormats" /> for predefined formats. </param>
       </Docs>
@@ -208,7 +223,6 @@
         <Parameter Name="autoConvert" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this method to determine whether a format exists in this <see cref="T:System.Windows.Forms.DataObject" /> before calling <see cref="M:System.Windows.Forms.IDataObject.GetData(System.String,System.Boolean)" />. Call <see cref="M:System.Windows.Forms.IDataObject.GetFormats(System.Boolean)" /> for the formats that are available in this instance.</para>
@@ -239,6 +253,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether data stored in this instance is associated with the specified format, using a Boolean value to determine whether to convert the data to the format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the data is in, or can be converted to, the specified format; otherwise, false.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />The format for which to check. See <see cref="T:System.Windows.Forms.DataFormats" /> for predefined formats. </param>
         <param name="autoConvert">
@@ -257,7 +275,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this method to get the supported data formats before calling the <see cref="M:System.Windows.Forms.IDataObject.GetData(System.String,System.Boolean)" /> method. See the <see cref="T:System.Windows.Forms.DataFormats" /> class for the predefined formats.</para>
@@ -270,6 +287,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a list of all formats that data stored in this instance is associated with or can be converted to.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of the names that represents a list of all formats that are supported by the data stored in this object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -286,7 +307,6 @@
         <Parameter Name="autoConvert" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this method to get the supported data formats before calling the <see cref="M:System.Windows.Forms.IDataObject.GetData(System.String,System.Boolean)" /> method. See the <see cref="T:System.Windows.Forms.DataFormats" /> class for the predefined formats.</para>
@@ -299,6 +319,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a list of all formats that data stored in this instance is associated with or can be converted to, using a Boolean value to determine whether to retrieve all formats that the data can be converted to or only native data formats.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of the names that represents a list of all formats that are supported by the data stored in this object.</para>
+        </returns>
         <param name="autoConvert">
           <attribution license="cc4" from="Microsoft" modified="false" />true to retrieve all formats that data stored in this instance is associated with or can be converted to; false to retrieve only native data formats. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IFeatureSupport.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IFeatureSupport.xml
index e7af9176910..7eca864f3b4 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IFeatureSupport.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IFeatureSupport.xml
@@ -29,7 +29,6 @@
         <Parameter Name="feature" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For an implementation of this method, see <see cref="M:System.Windows.Forms.OSFeature.GetVersionPresent(System.Object)" />.</para>
@@ -38,6 +37,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the version of the specified feature.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Version" /> representing the version number of the specified feature; or null if the feature is not installed.</para>
+        </returns>
         <param name="feature">
           <attribution license="cc4" from="Microsoft" modified="false" />The feature whose version is requested. </param>
       </Docs>
@@ -56,12 +59,15 @@
         <Parameter Name="feature" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether any version of the specified feature is currently available on the system.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the feature is present; otherwise, false.</para>
+        </returns>
         <param name="feature">
           <attribution license="cc4" from="Microsoft" modified="false" />The feature to look for. </param>
       </Docs>
@@ -81,12 +87,15 @@
         <Parameter Name="minimumVersion" Type="System.Version" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified or newer version of the specified feature is currently available on the system.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the requested version of the feature is present; otherwise, false.</para>
+        </returns>
         <param name="feature">
           <attribution license="cc4" from="Microsoft" modified="false" />The feature to look for. </param>
         <param name="minimumVersion">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IFileReaderService.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IFileReaderService.xml
index bf61cc8397e..453170b8380 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IFileReaderService.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/IFileReaderService.xml
@@ -25,7 +25,6 @@
         <Parameter Name="relativePath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -35,6 +34,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a file from the current directory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A stream of the specified file.</para>
+        </returns>
         <param name="relativePath">
           <attribution license="cc4" from="Microsoft" modified="false" />The file to open.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ImageIndexConverter.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ImageIndexConverter.xml
index 7fe76f737a1..cdeb159c286 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ImageIndexConverter.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ImageIndexConverter.xml
@@ -55,7 +55,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This type converter only can convert a 32-bit signed integer object to and from a string.</para>
@@ -65,6 +64,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified value object to a 32-bit signed integer object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted <paramref name="value" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
@@ -90,7 +93,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default implementation of this method can only convert an index value represented as an <see cref="T:System.Int32" /> to a <see cref="T:System.String" />.</para>
@@ -99,6 +101,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object to the specified destination type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted <paramref name="value" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context, which can be used to extract additional information about the environment this type converter is being invoked from. This parameter or properties of this parameter can be null. </param>
         <param name="culture">
@@ -123,7 +129,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of index values for image lists associated with the <see cref="P:System.ComponentModel.ITypeDescriptorContext.Instance" /> property of the <paramref name="context" /> parameter. If an <see cref="T:System.Windows.Forms.ImageList" /> is not found, then the parent of the component will be searched for such a list.</para>
@@ -133,6 +138,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of standard index values for the image list associated with the specified format context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> that holds a standard set of valid index values. If no image list is found, this collection will contain a single object with a value of -1.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context, which can be used to extract additional information about the environment this type converter is being invoked from. This parameter or properties of this parameter can be null. </param>
       </Docs>
@@ -151,7 +160,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the list returned by the <see cref="Overload:System.Windows.Forms.ImageIndexConverter.GetStandardValues" /> method is exclusive, then no other values are valid. This is typical of an enumerated data type. If the list is not exclusive, then there are other valid values besides the list of standard values that <see cref="Overload:System.Windows.Forms.ImageIndexConverter.GetStandardValues" /> provides.</para>
@@ -162,6 +170,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the list of standard values returned from the <see cref="Overload:System.Windows.Forms.ImageIndexConverter.GetStandardValues" /> method is an exclusive list. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="Overload:System.Windows.Forms.ImageIndexConverter.GetStandardValues" /> method returns an exclusive list of valid values; otherwise, false. This implementation always returns false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A formatter context. </param>
       </Docs>
@@ -180,7 +192,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As implemented in this class, <see cref="M:System.Windows.Forms.ImageIndexConverter.GetStandardValuesSupported(System.ComponentModel.ITypeDescriptorContext)" /> always returns true since this object supports a standard set of index values for images that can be picked from a list.</para>
@@ -189,6 +200,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the type converter supports a standard set of values that can be picked from a list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="Overload:System.Windows.Forms.ImageIndexConverter.GetStandardValues" /> method returns a standard set of values; otherwise, false. Always returns true.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context, which can be used to extract additional information about the environment this type converter is being invoked from. This parameter or properties of this parameter can be null. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ImageKeyConverter.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ImageKeyConverter.xml
index 111b961ac64..eb7cd0caabf 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ImageKeyConverter.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ImageKeyConverter.xml
@@ -52,12 +52,15 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether this converter can convert an object of the given type to a string using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true to indicate the specified conversion can be performed; otherwise, false. </para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
         <param name="sourceType">
@@ -79,12 +82,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts from the specified object to a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
@@ -109,12 +115,15 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given object to the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted <paramref name="value" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context, which can be used to extract additional information about the environment this type converter is being invoked from. This parameter or properties of this parameter can be null. </param>
         <param name="culture">
@@ -138,7 +147,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If no image list is found, and the <see cref="T:System.Windows.Forms.ImageKeyConverter" /> supports null as a standard value, the <see cref="M:System.Windows.Forms.ImageKeyConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> method returns a collection containing a single empty string. If no image list is found, and null is not supported as a standard value, <see cref="M:System.Windows.Forms.ImageKeyConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> returns an empty collection.</para>
@@ -147,6 +155,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of standard image keys for the image list associated with the specified context. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> that contains the standard set of image key values. </para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context, which can be used to extract additional information about the environment this type converter is being invoked from. This parameter or properties of this parameter can be null.</param>
       </Docs>
@@ -164,7 +176,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the list returned by the <see cref="Overload:System.Windows.Forms.ImageKeyConverter.GetStandardValues" /> method is exclusive, no other values are valid. This is typical of an enumerated data type. If the list is not exclusive, there are other valid values besides the list of standard values that <see cref="Overload:System.Windows.Forms.ImageIndexConverter.GetStandardValues" /> provides.</para>
@@ -175,6 +186,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the list of standard values for the <see cref="T:System.Windows.Forms.ImageKeyConverter" /> is exclusive (that is, whether it allows values other than those returned by <see cref="Overload:System.Windows.Forms.ImageKeyConverter.GetStandardValues" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true to indicate the list does not allow additional values; otherwise, false. Always returns true. </para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context, which can be used to extract additional information about the environment this type converter is being invoked from. This parameter or properties of this parameter can be null.</param>
       </Docs>
@@ -192,7 +207,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As implemented in the <see cref="T:System.Windows.Forms.ImageKeyConverter" /> class, the <see cref="M:System.Windows.Forms.ImageKeyConverter.GetStandardValuesSupported(System.ComponentModel.ITypeDescriptorContext)" /> method always returns true since <see cref="T:System.Windows.Forms.ImageKeyConverter" /> supports a standard set of index values for images that can be picked from a list.</para>
@@ -201,6 +215,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether this type converter supports a standard set of values that can be picked from a list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true to indicate a list of standard values is supported; otherwise, false. Always returns true.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context, which can be used to extract additional information about the environment this type converter is being invoked from. This parameter or properties of this parameter can be null.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ImageList.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ImageList.xml
index c4cb0b4c848..55ccc41bf6f 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ImageList.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ImageList.xml
@@ -504,7 +504,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.ImageList.ToString" /> method returns a string that includes the <see cref="P:System.Windows.Forms.ImageList.ImageCollection.Count" /> and <see cref="P:System.Windows.Forms.ImageList.ImageSize" /> properties.</para>
@@ -513,6 +512,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Windows.Forms.ImageList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Windows.Forms.ImageList" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/InputLanguage.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/InputLanguage.xml
index 6927e3f8f07..834a4863902 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/InputLanguage.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/InputLanguage.xml
@@ -89,12 +89,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Specifies whether two input languages are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two languages are equal; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The language to test for equality. </param>
       </Docs>
@@ -113,7 +116,6 @@
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.InputLanguage.FromCulture(System.Globalization.CultureInfo)" /> method selects from among installed keyboards. Specifically, this method performs the following operations:</para>
@@ -142,6 +144,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the input language associated with the specified culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Windows.Forms.InputLanguage" /> that represents the previously selected input language.</para>
+        </returns>
         <param name="culture">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Globalization.CultureInfo" /> that specifies the culture to convert from. </param>
       </Docs>
@@ -158,12 +164,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this input language.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for this input language.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/InputLanguageCollection.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/InputLanguageCollection.xml
index f7f19229118..dbaaf1fc0eb 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/InputLanguageCollection.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/InputLanguageCollection.xml
@@ -32,12 +32,15 @@
         <Parameter Name="value" Type="System.Windows.Forms.InputLanguage" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the <see cref="T:System.Windows.Forms.InputLanguageCollection" /> contains the specified <see cref="T:System.Windows.Forms.InputLanguage" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Windows.Forms.InputLanguage" /> is contained in the collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.InputLanguage" /> to locate. </param>
       </Docs>
@@ -82,12 +85,15 @@
         <Parameter Name="value" Type="System.Windows.Forms.InputLanguage" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of an <see cref="T:System.Windows.Forms.InputLanguage" /> in the <see cref="T:System.Windows.Forms.InputLanguageCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the <see cref="T:System.Windows.Forms.InputLanguage" /> in the <see cref="T:System.Windows.Forms.InputLanguageCollection" />, if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.InputLanguage" /> to locate. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/KeysConverter.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/KeysConverter.xml
index 763e921b815..f5f51a366af 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/KeysConverter.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/KeysConverter.xml
@@ -56,7 +56,6 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.KeysConverter.CanConvertFrom(System.ComponentModel.ITypeDescriptorContext,System.Type)" /> method is specialized to return true if the <paramref name="sourceType" /> parameter is of type <see cref="T:System.String" /> or <see cref="T:System.Enum" /> array; otherwise, it defers evaluation to the base implementation of this method.</para>
@@ -65,6 +64,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this converter can convert an object in the specified source type to the native type of the converter using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the conversion can be performed; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context, which can be used to extract additional information about the environment this converter is being invoked from. This parameter or properties of this parameter can be null. </param>
         <param name="sourceType">
@@ -89,7 +92,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.KeysConverter.CanConvertTo(System.ComponentModel.ITypeDescriptorContext,System.Type)" /> method is specialized to return true if the <paramref name="destinationType" /> parameter is of type <see cref="T:System.Enum" /> array; otherwise, it defers evaluation to the base implementation of this method.</para>
@@ -98,6 +100,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this converter can convert an object in the specified source type to the native type of the converter using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the conversion can be performed; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context, which can be used to extract additional information about the environment this converter is being invoked from. This parameter or properties of this parameter can be null. </param>
         <param name="destinationType">
@@ -115,7 +121,6 @@
         <Parameter Name="b" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses <see cref="M:System.String.Compare(System.String,System.String)" /> to compare the two objects.</para>
@@ -124,6 +129,49 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two key values for equivalence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer indicating the relationship between the two parameters.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value Type </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>A negative integer. </para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="a" /> is less than <paramref name="b" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>zero </para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="a" /> equals <paramref name="b" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>A positive integer. </para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="a" /> is greater than <paramref name="b" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Object" /> that represents the first key to compare. </param>
         <param name="b">
@@ -146,7 +194,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.KeysConverter.ConvertFrom(System.ComponentModel.ITypeDescriptorContext,System.Globalization.CultureInfo,System.Object)" /> method is specialized to convert objects of type <see cref="T:System.String" /> or <see cref="T:System.Enum" /> array. In this case, it will return an object of type <see cref="T:System.Windows.Forms.Keys" />. Otherwise, it defers evaluation to the base implementation of this method.</para>
@@ -155,6 +202,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object to the converter's native type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the converted <paramref name="value" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An ITypeDescriptorContext that provides a format context, which can be used to extract additional information about the environment this converter is being invoked from. This parameter or properties of this parameter can be null. </param>
         <param name="culture">
@@ -180,7 +231,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.KeysConverter.ConvertTo(System.ComponentModel.ITypeDescriptorContext,System.Globalization.CultureInfo,System.Object,System.Type)" /> method is specialized to convert objects of type <see cref="T:System.Windows.Forms.Keys" /> or <see cref="T:System.Int32" />. In this case, it will return an object of type <see cref="T:System.String" />. Otherwise, it defers evaluation to the base implementation of this method. </para>
@@ -189,6 +239,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object to the specified destination type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted <paramref name="value" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context, which can be used to extract additional information about the environment this converter is being invoked from. This parameter or properties of this parameter can be null. </param>
         <param name="culture">
@@ -213,7 +267,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The collection returned contains the values of the keys that can be converted.</para>
@@ -222,6 +275,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of standard values for the data type that this type converter is designed for when provided with a format context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> that holds a standard set of valid values, which can be empty if the data type does not support a standard set of values.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context, which can be used to extract additional information about the environment this converter is being invoked from. This parameter or properties of this parameter can be null. </param>
       </Docs>
@@ -240,7 +297,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter is not used in the standard implementation of this method.</para>
@@ -250,6 +306,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the list of standard values returned from GetStandardValues is an exclusive list using the specified <see cref="T:System.ComponentModel.ITypeDescriptorContext" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection returned from <see cref="Overload:System.Windows.Forms.KeysConverter.GetStandardValues" /> is an exhaustive list of possible values; otherwise, false if other values are possible. The default implementation for this method always returns false. </para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A formatter context. This object can be used to extract additional information about the environment this converter is being invoked from. This may be null, so you should always check. Also, properties on the context object may also return null. </param>
       </Docs>
@@ -268,7 +328,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter is not used in the standard implementation of this method.</para>
@@ -277,6 +336,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this object supports a standard set of values that can be picked from a list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always returns true.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context, which can be used to extract additional information about the environment this converter is being invoked from. This parameter or properties of this parameter can be null. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Label.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Label.xml
index 0b2f5a3f6c9..93adaea184e 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Label.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Label.xml
@@ -335,7 +335,6 @@
         <Parameter Name="align" Type="System.Drawing.ContentAlignment" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use this method within a derived class of <see cref="T:System.Windows.Forms.Label" />, to determine the size and location of an image to draw within the <see cref="T:System.Windows.Forms.Label" /> control based on its location within the control. The location of the image is based on the value of the control's <see cref="P:System.Windows.Forms.Label.ImageAlign" /> property.</para>
@@ -344,6 +343,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the size and location of an image drawn within the <see cref="T:System.Windows.Forms.Label" /> control based on the alignment of the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> that represents the size and location of the specified image within the control.</para>
+        </returns>
         <param name="image">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Image" /> used to determine size and location when drawn within the control. </param>
         <param name="r">
@@ -364,12 +367,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessibility object for the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.AccessibleObject" /> for the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -553,12 +559,15 @@
         <Parameter Name="proposedSize" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the size of a rectangular area into which a control can be fitted. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An ordered pair of type <see cref="T:System.Drawing.Size" /> representing the width and height of a rectangle.</para>
+        </returns>
         <param name="proposedSize">
           <attribution license="cc4" from="Microsoft" modified="false" />The custom-sized area for a control.</param>
       </Docs>
@@ -1261,12 +1270,15 @@
         <Parameter Name="charCode" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a mnemonic character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character was processed as a mnemonic by the control; otherwise, false.</para>
+        </returns>
         <param name="charCode">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to process.</param>
       </Docs>
@@ -1489,12 +1501,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Windows.Forms.Label" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Windows.Forms.Label" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/LinkArea.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/LinkArea.xml
index 8fbacaff830..f2109b64d24 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/LinkArea.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/LinkArea.xml
@@ -60,12 +60,15 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether this <see cref="T:System.Windows.Forms.LinkArea" /> is equal to the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified object is equal to the current <see cref="T:System.Windows.Forms.LinkArea" />; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to this <see cref="T:System.Windows.Forms.LinkArea" />.</param>
       </Docs>
@@ -157,12 +160,15 @@
         <Parameter Name="linkArea2" Type="System.Windows.Forms.LinkArea" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether two instances of the <see cref="T:System.Windows.Forms.LinkArea" /> class are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if two instances of the <see cref="T:System.Windows.Forms.LinkArea" /> class are equal; otherwise, false.</para>
+        </returns>
         <param name="linkArea1">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.LinkArea" /> to compare.</param>
         <param name="linkArea2">
@@ -183,12 +189,15 @@
         <Parameter Name="linkArea2" Type="System.Windows.Forms.LinkArea" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether two instances of the <see cref="T:System.Windows.Forms.LinkArea" /> class are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if two instances of the <see cref="T:System.Windows.Forms.LinkArea" /> class are not equal; otherwise, false.</para>
+        </returns>
         <param name="linkArea1">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.LinkArea" /> to compare.</param>
         <param name="linkArea2">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/LinkConverter.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/LinkConverter.xml
index 7441e01b696..723f579eea8 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/LinkConverter.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/LinkConverter.xml
@@ -49,12 +49,15 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a value that determines if this <see cref="T:System.Windows.Forms.LinkConverter" /> can convert an object having the specified context and source type to the native type of the <see cref="T:System.Windows.Forms.LinkConverter" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this <see cref="T:System.Windows.Forms.LinkConverter" /> can convert the specified object; otherwise, false. </para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> providing contextual information about the object to be converted.</param>
         <param name="sourceType">
@@ -75,12 +78,15 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a value that determines if this <see cref="T:System.Windows.Forms.LinkConverter" /> can convert an object having the specified context to the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this <see cref="T:System.Windows.Forms.LinkConverter" /> can convert the specified object; otherwise, false. </para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> providing contextual information about the object to be converted.</param>
         <param name="destinationType">
@@ -102,12 +108,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object to the native type of the <see cref="T:System.Windows.Forms.LinkConverter" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted object.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> providing contextual information about the object to be converted.</param>
         <param name="culture">
@@ -132,7 +141,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The most common conversion is from one <see cref="T:System.String" /> to another <see cref="T:System.String" />. The default implementation calls <see cref="M:System.Object.ToString" /> on the object if the object is valid and if the <paramref name="destinationType" /> is <see cref="T:System.String" />.</para>
@@ -141,6 +149,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object to another type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted object.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> providing contextual information about the object to be converted.</param>
         <param name="culture">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/LinkLabel.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/LinkLabel.xml
index 68d48a090dd..f5bc091171f 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/LinkLabel.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/LinkLabel.xml
@@ -95,7 +95,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you do not explicitly call the <see cref="M:System.Windows.Forms.LinkLabel.CreateAccessibilityInstance" /> method, it will be called when the <see cref="P:System.Windows.Forms.Control.AccessibilityObject" /> property is referenced.</para>
@@ -106,6 +105,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessibility object for the <see cref="T:System.Windows.Forms.LinkLabel" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.AccessibleObject" /> for the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -822,7 +825,6 @@
         <Parameter Name="y" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method enables you to determine whether a link is located at a specific point within a <see cref="T:System.Windows.Forms.LinkLabel" /> control. You can use this method in an event handler for the <see cref="E:System.Windows.Forms.Control.MouseEnter" /> event of the control to determine whether the mouse pointer is hovering over a link in the control. Once you have determined that the mouse pointer is over a link, you can then display additional information about the link to the user through <see cref="T:System.Windows.Forms.StatusBar" /> text or a <see cref="T:System.Windows.Forms.ToolTip" />.</para>
@@ -831,6 +833,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the link located at the specified client coordinates.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.LinkLabel.Link" /> representing the link located at the specified coordinates. If the point does not contain a link, null is returned.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The horizontal coordinate of the point to search for a link. </param>
         <param name="y">
@@ -851,7 +857,6 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called during message pre-processing to handle dialog characters, such as TAB, RETURN, ESCAPE, and arrow keys. This method is called only if the isInputKey method indicates that the control isn't interested in the key. processDialogKey simply sends the character to the parent's processDialogKey method, or returns false if the control has no parent. The Form class overrides this method to perform actual processing of dialog keys. When overriding processDialogKey, a control should return true to indicate that it has processed the key. For keys that aren't processed by the control, the result of base.processDialogChar should be returned. Controls will seldom, if ever, need to override this method.</para>
@@ -860,6 +865,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a dialog key. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true to consume the key; false to allow further processing.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />Key code and modifier flags. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListBindingHelper.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListBindingHelper.xml
index 02abf608863..ede6ec1f547 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListBindingHelper.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListBindingHelper.xml
@@ -34,7 +34,6 @@
         <Parameter Name="list" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the data source specified by the <paramref name="list" /> parameter implements the <see cref="T:System.ComponentModel.IListSource" /> interface, then the <see cref="M:System.Windows.Forms.ListBindingHelper.GetList(System.Object)" /> method will return an object of type <see cref="T:System.Collections.IList" /> that represents the associated list. Otherwise, this method will just return the specified data source since there is no underlying list.</para>
@@ -43,6 +42,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a list associated with the specified data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> representing the underlying list if it exists; otherwise, the original data source specified by <paramref name="list" />.</para>
+        </returns>
         <param name="list">
           <attribution license="cc4" from="Microsoft" modified="false" />The data source to examine for its underlying list.</param>
       </Docs>
@@ -61,7 +64,6 @@
         <Parameter Name="dataMember" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the data member is null or an empty string (""), the <see cref="M:System.Windows.Forms.ListBindingHelper.GetList(System.Object,System.String)" /> method returns <paramref name="dataSource" />. </para>
@@ -72,6 +74,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object, typically a list, from the evaluation of a specified data source and optional data member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> representing the underlying list if it was found; otherwise, <paramref name="dataSource" />.</para>
+        </returns>
         <param name="dataSource">
           <attribution license="cc4" from="Microsoft" modified="false" />The data source from which to find the list.</param>
         <param name="dataMember">
@@ -91,7 +97,6 @@
         <Parameter Name="list" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.ListBindingHelper.GetListItemProperties(System.Object)" /> method is used to examine the collection of properties for a data source. The action of this method depends on the actual type of the <paramref name="list" /> parameter according to the following table:</para>
@@ -136,6 +141,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that describes the properties of an item type contained in a specified data source, or properties of the specified data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> containing the properties of the items contained in <paramref name="list" />, or properties of <paramref name="list." /></para>
+        </returns>
         <param name="list">
           <attribution license="cc4" from="Microsoft" modified="false" />The data source to examine for property information.</param>
       </Docs>
@@ -154,7 +163,6 @@
         <Parameter Name="listAccessors" Type="System.ComponentModel.PropertyDescriptor[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.ListBindingHelper.GetListItemProperties(System.Object,System.ComponentModel.PropertyDescriptor[])" /> method is useful when the data source has properties that are a collection of items and you need to know properties of the item type in the collection, not the properties of the collection type. </para>
@@ -163,6 +171,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that describes the properties of an item type contained in a collection property of a data source. Uses the specified <see cref="T:System.ComponentModel.PropertyDescriptor" /> array to indicate which properties to examine.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> describing the properties of the item type contained in a collection property of the data source.</para>
+        </returns>
         <param name="list">
           <attribution license="cc4" from="Microsoft" modified="false" />The data source to be examined for property information.</param>
         <param name="listAccessors">
@@ -184,7 +196,6 @@
         <Parameter Name="listAccessors" Type="System.ComponentModel.PropertyDescriptor[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="dataMember" /> parameter can be null, in which case the <see cref="M:System.Windows.Forms.ListBindingHelper.GetListItemProperties(System.Object,System.String,System.ComponentModel.PropertyDescriptor[])" /> method will return property descriptions using the data source and the <see cref="T:System.ComponentModel.PropertyDescriptor" /> array.</para>
@@ -195,6 +206,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that describes the properties of an item type contained in the specified data member of a data source. Uses the specified <see cref="T:System.ComponentModel.PropertyDescriptor" /> array to indicate which properties to examine.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> describing the properties of an item type contained in a collection property of the specified data source.</para>
+        </returns>
         <param name="dataSource">
           <attribution license="cc4" from="Microsoft" modified="false" />The data source to be examined for property information.</param>
         <param name="dataMember">
@@ -216,7 +231,6 @@
         <Parameter Name="list" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <paramref name="list" /> parameter is not a list or array, the type returned will be that of the <paramref name="list" /> parameter itself.</para>
@@ -225,6 +239,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the data type of the items in the specified list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> of the items contained in the list.</para>
+        </returns>
         <param name="list">
           <attribution license="cc4" from="Microsoft" modified="false" />The list to be examined for type information. </param>
       </Docs>
@@ -243,7 +261,6 @@
         <Parameter Name="dataMember" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This version of the <see cref="M:System.Windows.Forms.ListBindingHelper.GetListItemType(System.Object,System.String)" /> method is used to determine the type of items used in complex or simple data-binding schemes. This static method may be useful in determining whether a proposed data-binding scheme is appropriate before attempting it.</para>
@@ -254,6 +271,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the data type of the items in the specified data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>For complex data binding, the <see cref="T:System.Type" /> of the items represented by the <paramref name="dataMember" /> in the data source; otherwise, the <see cref="T:System.Type" /> of the item in the list itself.</para>
+        </returns>
         <param name="dataSource">
           <attribution license="cc4" from="Microsoft" modified="false" />The data source to examine for items. </param>
         <param name="dataMember">
@@ -274,7 +295,6 @@
         <Parameter Name="listAccessors" Type="System.ComponentModel.PropertyDescriptor[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="listAccessors" /> is null or empty, the <see cref="M:System.Windows.Forms.ListBindingHelper.GetListName(System.Object,System.ComponentModel.PropertyDescriptor[])" /> method returns the name of the data source type.</para>
@@ -283,6 +303,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of an underlying list, given a data source and optional <see cref="T:System.ComponentModel.PropertyDescriptor" /> array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the list in the data source, as described by <paramref name="listAccessors" />, or<paramref name=" " />the name of the data source type.</para>
+        </returns>
         <param name="list">
           <attribution license="cc4" from="Microsoft" modified="false" />The data source to examine for the list name.</param>
         <param name="listAccessors">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListBox.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListBox.xml
index dcdb0d83c7e..6ea956e8e69 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListBox.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListBox.xml
@@ -565,12 +565,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the item collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.ListBox.ObjectCollection" /> that represents the new item collection.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -744,7 +747,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The search performed by this method is not case-sensitive. The search looks for words that partially match the specified search string parameter, <paramref name="s" />. You can use this method to search for the first item that matches the specified string. You can then perform tasks such as removing the item that contains the search text by using the <see cref="M:System.Windows.Forms.ListBox.ObjectCollection.Remove(System.Object)" /> method or changing the item's text. Once you have found the specified text, if you want to search for other instances of the text in the <see cref="T:System.Windows.Forms.ListBox" />, you can use the version of the <see cref="M:System.Windows.Forms.ListBox.FindString(System.String)" /> method that provides a parameter for specifying a starting index within the <see cref="T:System.Windows.Forms.ListBox" />. If you want to perform a search for an exact word match instead of a partial match, use the <see cref="M:System.Windows.Forms.ListBox.FindStringExact(System.String)" /> method.</para>
@@ -753,6 +755,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds the first item in the <see cref="T:System.Windows.Forms.ListBox" /> that starts with the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first item found; returns ListBox.NoMatches if no match is found.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to search for. </param>
       </Docs>
@@ -772,7 +778,6 @@
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The search performed by this method is not case-sensitive. The search looks for words that partially match the specified search string parameter, <paramref name="s" />. You can use this method to search for the first item that matches the specified string at the specified starting index within the list of items for the <see cref="T:System.Windows.Forms.ListBox" />. You can then perform tasks such as removing the item that contains the search text by using the <see cref="M:System.Windows.Forms.ListBox.ObjectCollection.Remove(System.Object)" /> method or changing the item's text. This method is typically used after a call has been made using the version of this method that does not specify a starting index. Once an initial item has been found in the list, this method is typically used to find further instances of the search text by specifying the index position in the <paramref name="startIndex" /> parameter of the item after the first found instance of the search text. If you want to perform a search for an exact word match instead of a partial match, use the <see cref="M:System.Windows.Forms.ListBox.FindStringExact(System.String)" /> method.</para>
@@ -784,6 +789,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds the first item in the <see cref="T:System.Windows.Forms.ListBox" /> that starts with the specified string. The search starts at a specific starting index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first item found; returns ListBox.NoMatches if no match is found.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to search for. </param>
         <param name="startIndex">
@@ -804,7 +813,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The search performed by this method is not case-sensitive. The search looks for an exact match to the words specified in the search string parameter, <paramref name="s" />. You can use this method to search for the first item that matches the specified string. You can then perform tasks such as removing the item that contains the search text by using the <see cref="M:System.Windows.Forms.ListBox.ObjectCollection.Remove(System.Object)" /> method or changing the item's text. Once you have found the specified text, if you want to search for other instances of the text in the <see cref="T:System.Windows.Forms.ListBox" />, you can use the version of the <see cref="M:System.Windows.Forms.ListBox.FindStringExact(System.String)" /> method that provides a parameter for specifying a starting index within the <see cref="T:System.Windows.Forms.ListBox" />. If you want to perform partial word search instead of an exact word match, use the <see cref="M:System.Windows.Forms.ListBox.FindString(System.String)" /> method.</para>
@@ -813,6 +821,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds the first item in the <see cref="T:System.Windows.Forms.ListBox" /> that exactly matches the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first item found; returns ListBox.NoMatches if no match is found.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to search for. </param>
       </Docs>
@@ -832,7 +844,6 @@
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The search performed by this method is not case-sensitive. The search looks for words that exactly match the specified search string parameter, <paramref name="s" />. You can use this method to search for the first item that matches the specified string at the specified starting index within the list of items for the <see cref="T:System.Windows.Forms.ListBox" />. You can then perform tasks such as removing the item that contains the search text using the <see cref="M:System.Windows.Forms.ListBox.ObjectCollection.Remove(System.Object)" /> method or change the item's text. This method is typically used after a call has been made using the version of this method that does not specify a starting index. Once an initial item has been found in the list, this method is typically used to find further instances of the search text by specifying the index position in the <paramref name="startIndex" /> parameter of the item after the first found instance of the search text. If you want to perform a partial word search instead of an exact word match, use the <see cref="M:System.Windows.Forms.ListBox.FindString(System.String)" /> method.</para>
@@ -844,6 +855,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds the first item in the <see cref="T:System.Windows.Forms.ListBox" /> that exactly matches the specified string. The search starts at a specific starting index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first item found; returns ListBox.NoMatches if no match is found.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to search for. </param>
         <param name="startIndex">
@@ -902,7 +917,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="P:System.Windows.Forms.ListBox.DrawMode" /> property is not set to DrawMode.OwnerDrawVariable, the value of the index parameter is ignored because all items in a standard <see cref="T:System.Windows.Forms.ListBox" /> are the same size. You can use this property when you are using an owner-drawn <see cref="T:System.Windows.Forms.ListBox" /> to determine the size of any item within the <see cref="T:System.Windows.Forms.ListBox" />.</para>
@@ -911,6 +925,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the height of an item in the <see cref="T:System.Windows.Forms.ListBox" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The height, in pixels, of the specified item.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the item to return the height for. </param>
       </Docs>
@@ -929,7 +947,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the item specified in the <paramref name="index" /> parameter is not visible, the rectangle returned by this method will be outside the visible portion of the control. You can use this method to determine the size and position of an item within the list. To get the height of an item, especially a variable-height owner drawn list item, you can use the <see cref="M:System.Windows.Forms.ListBox.GetItemHeight(System.Int32)" /> method.</para>
@@ -938,6 +955,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the bounding rectangle for an item in the <see cref="T:System.Windows.Forms.ListBox" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> that represents the bounding rectangle for the specified item.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of item whose bounding rectangle you want to return. </param>
       </Docs>
@@ -966,7 +987,6 @@
         <Parameter Name="specified" Type="System.Windows.Forms.BoundsSpecified" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Windows.Forms.ListBox" /> class overrides the <see cref="M:System.Windows.Forms.Control.GetScaledBounds(System.Drawing.Rectangle,System.Drawing.SizeF,System.Windows.Forms.BoundsSpecified)" /> method to ensure that the requested height is scaled rather than the current height.</para>
@@ -975,6 +995,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the bounds within which the <see cref="T:System.Windows.Forms.ListBox" /> is scaled.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> representing the bounds within which the control is scaled.</para>
+        </returns>
         <param name="bounds">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Rectangle" /> that specifies the area for which to retrieve the display bounds.</param>
         <param name="factor">
@@ -993,7 +1017,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use this method to quickly determine whether a specified item is selected. This method is useful when a specific operation needs to be performed when a specific item in a multiple-selection <see cref="T:System.Windows.Forms.ListBox" /> is selected.</para>
@@ -1002,6 +1025,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified item is selected.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified item is currently selected in the <see cref="T:System.Windows.Forms.ListBox" />; otherwise, false.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the item that determines whether it is selected. </param>
       </Docs>
@@ -1080,7 +1107,6 @@
         <Parameter Name="p" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method enables you to determine which item is located at a specific location within the control. You can use this method to determine which item within the list is selected when a user right-clicks the <see cref="T:System.Windows.Forms.ListBox" />. The location of the cursor can be determined and passed to the <paramref name="p" /> parameter of the <see cref="M:System.Windows.Forms.ListBox.IndexFromPoint(System.Drawing.Point)" /> method to determine which item the user right-clicked the mouse over. You can then display a shortcut menu to the user to provide tasks and features based on the specific item.</para>
@@ -1089,6 +1115,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the zero-based index of the item at the specified coordinates.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the item found at the specified coordinates; returns ListBox.NoMatches if no match is found.</para>
+        </returns>
         <param name="p">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Point" /> object containing the coordinates used to obtain the item index. </param>
       </Docs>
@@ -1108,7 +1138,6 @@
         <Parameter Name="y" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method enables you to determine which item that is located at a specific location within the control. You can use this method to determine which item within the list is selected when a user right-clicks the <see cref="T:System.Windows.Forms.ListBox" />. The location of the cursor can be determined and passed to the <paramref name="x" /> and <paramref name="y" /> parameters of the <see cref="M:System.Windows.Forms.ListBox.IndexFromPoint(System.Drawing.Point)" /> method to determine which item the user right-clicked the mouse over. You can then display a shortcut menu to the user to provide tasks and features based on the specific item.</para>
@@ -1117,6 +1146,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the zero-based index of the item at the specified coordinates.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the item found at the specified coordinates; returns ListBox.NoMatches if no match is found.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate of the location to search. </param>
         <param name="y">
@@ -2367,12 +2400,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of the <see cref="T:System.Windows.Forms.ListBox" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that states the control type, the count of items in the <see cref="T:System.Windows.Forms.ListBox" /> control, and the Text property of the first item in the <see cref="T:System.Windows.Forms.ListBox" />, if the count is not 0.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListControl.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListControl.xml
index f46eaafaf1a..e7745d09def 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListControl.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListControl.xml
@@ -201,12 +201,15 @@
         <Parameter Name="item" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the current value of the <see cref="T:System.Windows.Forms.ListControl" /> item, if it is a property of an object, given the item.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The filtered object.</para>
+        </returns>
         <param name="item">
           <attribution license="cc4" from="Microsoft" modified="false" />The object the <see cref="T:System.Windows.Forms.ListControl" /> item is bound to.</param>
       </Docs>
@@ -226,12 +229,15 @@
         <Parameter Name="field" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the current value of the <see cref="T:System.Windows.Forms.ListControl" /> item, if it is a property of an object given the item and the property name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The filtered object.</para>
+        </returns>
         <param name="item">
           <attribution license="cc4" from="Microsoft" modified="false" />The object the <see cref="T:System.Windows.Forms.ListControl" /> item is bound to.</param>
         <param name="field">
@@ -442,12 +448,15 @@
         <Parameter Name="item" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the text representation of the specified item.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If the <see cref="P:System.Windows.Forms.ListControl.DisplayMember" /> property is not specified, the value returned by <see cref="M:System.Windows.Forms.ListControl.GetItemText(System.Object)" /> is the value of the item's ToString method. Otherwise, the method returns the string value of the member specified in the <see cref="P:System.Windows.Forms.ListControl.DisplayMember" /> property for the object specified in the <paramref name="item" /> parameter.</para>
+        </returns>
         <param name="item">
           <attribution license="cc4" from="Microsoft" modified="false" />The object from which to get the contents to display. </param>
       </Docs>
@@ -466,12 +475,15 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Handles special input keys, such as PAGE UP, PAGE DOWN, HOME, END, and so on.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="keyData" /> parameter specifies the <see cref="F:System.Windows.Forms.Keys.End" />, <see cref="F:System.Windows.Forms.Keys.Home" />, <see cref="F:System.Windows.Forms.Keys.PageUp" />, or <see cref="F:System.Windows.Forms.Keys.PageDown" /> key; false if the <paramref name="keyData" /> parameter specifies <see cref="F:System.Windows.Forms.Keys.Alt" />.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the values of <see cref="T:System.Windows.Forms.Keys" />.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListView.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListView.xml
index dce73151fbc..1c81b955538 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListView.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListView.xml
@@ -1167,7 +1167,6 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The search is case-insensitive.</para>
@@ -1178,6 +1177,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds the first <see cref="T:System.Windows.Forms.ListViewItem" /> that begins with the specified text value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first <see cref="T:System.Windows.Forms.ListViewItem" /> that begins with the specified text value.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to search for.</param>
       </Docs>
@@ -1197,7 +1200,6 @@
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The search is case-insensitive.</para>
@@ -1208,6 +1210,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds the first <see cref="T:System.Windows.Forms.ListViewItem" /> or <see cref="T:System.Windows.Forms.ListViewItem.ListViewSubItem" />, if indicated, that begins with the specified text value. The search starts at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first <see cref="T:System.Windows.Forms.ListViewItem" /> that begins with the specified text value.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to search for.</param>
         <param name="includeSubItemsInSearch">
@@ -1232,7 +1238,6 @@
         <Parameter Name="isPrefixSearch" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.Windows.Forms.ListView.FindItemWithText" /> method returns null if the list is empty or there is no matching item.</para>
@@ -1243,6 +1248,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds the first <see cref="T:System.Windows.Forms.ListViewItem" /> or <see cref="T:System.Windows.Forms.ListViewItem.ListViewSubItem" />, if indicated, that begins with the specified text value. The search starts at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first <see cref="T:System.Windows.Forms.ListViewItem" /> that begins with the specified text value.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to search for.</param>
         <param name="includeSubItemsInSearch">
@@ -1267,7 +1276,6 @@
         <Parameter Name="point" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.Windows.Forms.ListView.FindNearestItem" /> method returns null if no item is found in the given direction. Identifying the nearest item can vary depending on the operating system the application is running on, and will affect the results of <see cref="M:System.Windows.Forms.ListView.FindNearestItem(System.Windows.Forms.SearchDirectionHint,System.Drawing.Point)" />.</para>
@@ -1276,6 +1284,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds the next item from the given point, searching in the specified direction</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.ListViewItem" /> that is closest to the given point, searching in the specified direction.</para>
+        </returns>
         <param name="dir">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.SearchDirectionHint" /> values.</param>
         <param name="point">
@@ -1297,7 +1309,6 @@
         <Parameter Name="y" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.Windows.Forms.ListView.FindNearestItem" /> method returns null if no item is found in the given direction. Identifying the nearest item can vary depending on the operating system the application is running on, and will affect the results of <see cref="M:System.Windows.Forms.ListView.FindNearestItem(System.Windows.Forms.SearchDirectionHint,System.Int32,System.Int32)" />.</para>
@@ -1306,6 +1317,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds the next item from the given x- and y-coordinates, searching in the specified direction. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.ListViewItem" /> that is closest to the given coordinates, searching in the specified direction.</para>
+        </returns>
         <param name="searchDirection">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.SearchDirectionHint" /> values.</param>
         <param name="x">
@@ -1404,7 +1419,6 @@
         <Parameter Name="y" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.ListView.GetItemAt(System.Int32,System.Int32)" /> method lets you determine which item is located at a specific location within the client region of the <see cref="T:System.Windows.Forms.ListView" /> control. You can use this method when the user clicks or right-clicks a subitem (when the <see cref="P:System.Windows.Forms.ListView.View" /> property is set to View.Details) and you want to determine which item owns the subitem that was clicked based on the mouse coordinates at the time the user clicked the mouse.</para>
@@ -1420,6 +1434,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the item at the specified location.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.ListViewItem" /> that represents the item at the specified position. If there is no item at the specified location, the method returns null.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate of the location to search for an item (expressed in client coordinates). </param>
         <param name="y">
@@ -1440,7 +1458,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The bounding rectangle returned by this version of the <see cref="M:System.Windows.Forms.ListView.GetItemRect(System.Int32)" /> method represents the entire item, including the icon, item text, and subitem text. To specify a specific portion of the item's bounding rectangle, use the other version of the <see cref="M:System.Windows.Forms.ListView.GetItemRect(System.Int32)" /> method.</para>
@@ -1449,6 +1466,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the bounding rectangle for a specific item within the list view control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> that represents the bounding rectangle of the specified <see cref="T:System.Windows.Forms.ListViewItem" />.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the item within the <see cref="T:System.Windows.Forms.ListView.ListViewItemCollection" /> whose bounding rectangle you want to return. </param>
       </Docs>
@@ -1468,7 +1489,6 @@
         <Parameter Name="portion" Type="System.Windows.Forms.ItemBoundsPortion" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The bounding rectangle returned by this version of the <see cref="M:System.Windows.Forms.ListView.GetItemRect(System.Int32)" /> method represents only the section of the item specified in the <paramref name="portion" /> parameter. To return the bounding rectangle of the entire item, use the other version of the <see cref="M:System.Windows.Forms.ListView.GetItemRect(System.Int32)" /> method.</para>
@@ -1477,6 +1497,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the specified portion of the bounding rectangle for a specific item within the list view control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> that represents the bounding rectangle for the specified portion of the specified <see cref="T:System.Windows.Forms.ListViewItem" />.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the item within the <see cref="T:System.Windows.Forms.ListView.ListViewItemCollection" /> whose bounding rectangle you want to return. </param>
         <param name="portion">
@@ -1632,7 +1656,6 @@
         <Parameter Name="point" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to determine whether a point is in an item or subitem and where in the item the point is located, such as on the label or image area. If the coordinates are located outside the control, the returned <see cref="T:System.Windows.Forms.ListViewHitTestInfo" /> object has a <see cref="P:System.Windows.Forms.ListViewHitTestInfo.Location" /> property of "None"; and the <see cref="P:System.Windows.Forms.ListViewHitTestInfo.Item" /> and <see cref="P:System.Windows.Forms.ListViewHitTestInfo.SubItem" /> properties are set to null.</para>
@@ -1641,6 +1664,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides item information, given a point.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The item information, given a point.</para>
+        </returns>
         <param name="point">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Point" /> at which to retrieve the item information. The coordinates are relative to the upper-left corner of the control.</param>
       </Docs>
@@ -1659,7 +1686,6 @@
         <Parameter Name="y" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to determine whether a point is in an item or subitem, and where in the item the point is located, such as on the label or image area. If the coordinates are located outside the control, the returned <see cref="T:System.Windows.Forms.ListViewHitTestInfo" /> object has a <see cref="P:System.Windows.Forms.ListViewHitTestInfo.Location" /> property of "None"; and the <see cref="P:System.Windows.Forms.ListViewHitTestInfo.Item" /> and <see cref="P:System.Windows.Forms.ListViewHitTestInfo.SubItem" /> properties are set to null.</para>
@@ -1668,6 +1694,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides item information, given x- and y-coordinates.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The item information, given x- and y- coordinates.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate at which to retrieve the item information. The coordinate is relative to the upper-left corner of the control.</param>
         <param name="y">
@@ -1771,12 +1801,15 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified key is a regular input key or a special key that requires preprocessing.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified key is a regular input key; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.Keys" /> values.</param>
       </Docs>
@@ -3578,12 +3611,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of the <see cref="T:System.Windows.Forms.ListView" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that states the control type, the count of items in the <see cref="T:System.Windows.Forms.ListView" /> control, and the type of the first item in the <see cref="T:System.Windows.Forms.ListView" />, if the count is not 0.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListViewGroupCollection.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListViewGroupCollection.xml
index 25bb897ce12..312afab751e 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListViewGroupCollection.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListViewGroupCollection.xml
@@ -53,7 +53,6 @@
         <Parameter Name="group" Type="System.Windows.Forms.ListViewGroup" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -64,6 +63,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Windows.Forms.ListViewGroup" /> to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the group within the collection, or -1 if the group is already present in the collection.</para>
+        </returns>
         <param name="group">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.ListViewGroup" /> to add to the collection. </param>
       </Docs>
@@ -82,13 +85,16 @@
         <Parameter Name="headerText" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new <see cref="T:System.Windows.Forms.ListViewGroup" /> to the collection using the specified values to initialize the <see cref="P:System.Windows.Forms.ListViewGroup.Name" /> and <see cref="P:System.Windows.Forms.ListViewGroup.Header" /> properties </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Windows.Forms.ListViewGroup" />.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The initial value of the <see cref="P:System.Windows.Forms.ListViewGroup.Name" /> property for the new group.</param>
         <param name="headerText">
@@ -187,7 +193,6 @@
         <Parameter Name="value" Type="System.Windows.Forms.ListViewGroup" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -197,6 +202,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified group is located in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the group is in the collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.ListViewGroup" /> to locate in the collection. </param>
       </Docs>
@@ -263,7 +272,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -273,6 +281,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator used to iterate through the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that represents the collection.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -288,7 +300,6 @@
         <Parameter Name="value" Type="System.Windows.Forms.ListViewGroup" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -298,6 +309,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the specified <see cref="T:System.Windows.Forms.ListViewGroup" /> within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the group within the collection, or -1 if the group is not in the collection.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.ListViewGroup" /> to locate in the collection. </param>
       </Docs>
@@ -478,12 +493,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new <see cref="T:System.Windows.Forms.ListViewGroup" /> to the <see cref="T:System.Windows.Forms.ListViewGroupCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the <see cref="T:System.Windows.Forms.ListViewGroup" /> has been added.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.ListViewGroup" /> to add to the <see cref="T:System.Windows.Forms.ListViewGroupCollection" />.</param>
       </Docs>
@@ -501,12 +519,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified value is located in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is a <see cref="T:System.Windows.Forms.ListViewGroup" /> contained in the collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that represents the <see cref="T:System.Windows.Forms.ListViewGroup" /> to locate in the collection.</param>
       </Docs>
@@ -524,12 +545,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index within the collection of the specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of <paramref name="value" /> if it is in the collection; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.ListViewGroup" /> to find in the <see cref="T:System.Windows.Forms.ListViewGroupCollection" />.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListViewInsertionMark.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListViewInsertionMark.xml
index 6b65000b76f..f5a0883ade8 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListViewInsertionMark.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListViewInsertionMark.xml
@@ -173,7 +173,6 @@
         <Parameter Name="pt" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method lets you locate the item closest to the mouse pointer when doing a drag-and-drop operation. Use the index value returned to set the <see cref="P:System.Windows.Forms.ListViewInsertionMark.Index" /> property. When the item closest to the mouse pointer is the item being dragged, the return value of this method is -1. In this case, setting the <see cref="P:System.Windows.Forms.ListViewInsertionMark.Index" /> property to this value hides the insertion mark.</para>
@@ -183,6 +182,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the index of the item closest to the specified point.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the item closest to the specified point or -1 if the closest item is the item currently being dragged.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Point" /> representing the location from which to find the nearest item. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListViewItem.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListViewItem.xml
index a5e6fc727b9..d8cba93603b 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListViewItem.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListViewItem.xml
@@ -797,7 +797,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use this method to create a new instance of the <see cref="T:System.Windows.Forms.ListViewItem" /> class based on an existing item. Even the subitems of the item being cloned are specified for the new version. This feature is useful if you want to reuse a <see cref="T:System.Windows.Forms.ListViewItem" /> in more than one <see cref="T:System.Windows.Forms.ListView" /> control.</para>
@@ -806,6 +805,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an identical copy of the item.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents an item that has the same text, image, and subitems associated with it as the cloned item.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -874,7 +877,6 @@
         <Parameter Name="searchDirection" Type="System.Windows.Forms.SearchDirectionHint" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.ListViewItem.FindNearestItem(System.Windows.Forms.SearchDirectionHint)" /> method returns null if no item is found in the given direction. </para>
@@ -884,6 +886,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds the next item from the <see cref="T:System.Windows.Forms.ListViewItem" />, searching in the specified direction.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.ListViewItem" /> that is closest to the given coordinates, searching in the specified direction.</para>
+        </returns>
         <param name="searchDirection">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.SearchDirectionHint" /> values.</param>
       </Docs>
@@ -987,7 +993,6 @@
         <Parameter Name="portion" Type="System.Windows.Forms.ItemBoundsPortion" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The bounding rectangle returned by the <see cref="M:System.Windows.Forms.ListViewItem.GetBounds(System.Windows.Forms.ItemBoundsPortion)" /> method represents only the section of the item specified in the <paramref name="portion" /> parameter. You can also call the <see cref="M:System.Windows.Forms.ListView.GetItemRect(System.Int32)" /> methods of the <see cref="T:System.Windows.Forms.ListView" /> class to obtain the bounding rectangle of any item in a <see cref="T:System.Windows.Forms.ListView" /> control.</para>
@@ -996,6 +1001,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the specified portion of the bounding rectangle for the item.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> that represents the bounding rectangle for the specified portion of the item.</para>
+        </returns>
         <param name="portion">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.ItemBoundsPortion" /> values that represents a portion of the item for which to retrieve the bounding rectangle. </param>
       </Docs>
@@ -1018,7 +1027,6 @@
         <Parameter Name="y" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.ListViewItem.GetSubItemAt(System.Int32,System.Int32)" /> method will return null if the <see cref="T:System.Windows.Forms.ListView" /> is not in <see cref="F:System.Windows.Forms.View.Details" /> view, or there is not a <see cref="T:System.Windows.Forms.ListViewItem.ListViewSubItem" /> located at the specified point.</para>
@@ -1027,6 +1035,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the subitem of the <see cref="T:System.Windows.Forms.ListViewItem" /> at the specified coordinates.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.ListViewItem.ListViewSubItem" /> at the specified x- and y-coordinates.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate. </param>
         <param name="y">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListViewItemConverter.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListViewItemConverter.xml
index 5b47b138d1b..6e55f576113 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListViewItemConverter.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ListViewItemConverter.xml
@@ -51,7 +51,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -60,6 +59,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this converter can convert an object to the given destination type using the context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="destinationType">
@@ -83,7 +86,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The most common types to convert are to and from a string object. The default implementation will make a call to <see cref="M:System.Object.ToString" /> on the object if the object is valid and if the destination type is string. If this cannot convert to the destination type, this will throw a <see cref="T:System.NotSupportedException" />.</para>
@@ -92,6 +94,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given object to another type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted object.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A formatter context. This object can be used to extract additional information about the environment this converter is being invoked from. This may be null, so you should always check. Also, properties on the context object may also return null. </param>
         <param name="culture">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/MainMenu.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/MainMenu.xml
index b19d4c7cd57..2cea95f80c6 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/MainMenu.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/MainMenu.xml
@@ -101,7 +101,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use this method to create a copy of the menu structure stored in a <see cref="T:System.Windows.Forms.MainMenu" />. You can use this method to reuse the menu structure stored in a <see cref="T:System.Windows.Forms.MainMenu" /> as the foundation for a new <see cref="T:System.Windows.Forms.MainMenu" />. For example, if you want to create a menu structure that has the same menu items as an existing <see cref="T:System.Windows.Forms.MainMenu" /> but will also have additional <see cref="T:System.Windows.Forms.MenuItem" /> objects added to it, you can use the <see cref="M:System.Windows.Forms.MainMenu.CloneMenu" /> method to create a copy of the original <see cref="T:System.Windows.Forms.MainMenu" /> and then add the new <see cref="T:System.Windows.Forms.MenuItem" /> objects to the cloned <see cref="T:System.Windows.Forms.MainMenu" />.</para>
@@ -110,6 +109,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Windows.Forms.MainMenu" /> that is a duplicate of the current <see cref="T:System.Windows.Forms.MainMenu" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.MainMenu" /> that represents the cloned menu.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -190,7 +193,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This property enables you to determine if a specific <see cref="T:System.Windows.Forms.MainMenu" /> is parented to a form. The property is typically used when multiple <see cref="T:System.Windows.Forms.MainMenu" /> objects are being used on a form and you need to determine which one is currently being used by a form.</para>
@@ -199,6 +201,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Windows.Forms.Form" /> that contains this control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.Form" /> that is the container for this control. Returns null if the <see cref="T:System.Windows.Forms.MainMenu" /> is not currently hosted on a form.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -272,7 +278,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return string includes the type and the string returned by the <see cref="M:System.Windows.Forms.Form.ToString" /> method if the <see cref="T:System.Windows.Forms.MainMenu" /> is assigned to a form.</para>
@@ -281,6 +286,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the <see cref="T:System.Windows.Forms.MainMenu" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Windows.Forms.MainMenu" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/MaskedTextBox.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/MaskedTextBox.xml
index 9b38e53d1d1..5942bcd86be 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/MaskedTextBox.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/MaskedTextBox.xml
@@ -637,7 +637,6 @@
         <Parameter Name="lineNumber" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.MaskedTextBox.GetFirstCharIndexFromLine(System.Int32)" /> method is inherited from the base <see cref="T:System.Windows.Forms.TextBoxBase" /> class. However, because the <see cref="T:System.Windows.Forms.MaskedTextBox" /> control does not support multiline configuration, this method is not supported. </para>
@@ -646,6 +645,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the index of the first character of a given line. This method is not supported by <see cref="T:System.Windows.Forms.MaskedTextBox" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method will always return 0. </para>
+        </returns>
         <param name="lineNumber">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is not used.</param>
       </Docs>
@@ -666,7 +669,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.MaskedTextBox.GetFirstCharIndexOfCurrentLine" /> method is inherited from the base <see cref="T:System.Windows.Forms.TextBoxBase" /> class. However, because the <see cref="T:System.Windows.Forms.MaskedTextBox" /> control does not support multiline configuration, this method is not supported. </para>
@@ -675,6 +677,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the index of the first character of the current line. This method is not supported by <see cref="T:System.Windows.Forms.MaskedTextBox" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method will always return 0. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetLineFromCharIndex">
@@ -695,7 +701,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.MaskedTextBox.GetLineFromCharIndex(System.Int32)" /> method is inherited from the base <see cref="T:System.Windows.Forms.TextBoxBase" /> class. However, because the <see cref="T:System.Windows.Forms.MaskedTextBox" /> control does not support multiline configuration, this method is not supported. </para>
@@ -704,6 +709,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the line number from the specified character position within the text of the control. This method is not supported by <see cref="T:System.Windows.Forms.MaskedTextBox" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method will always return 0.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is not used.</param>
       </Docs>
@@ -2186,7 +2195,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This version of the <see cref="M:System.Windows.Forms.MaskedTextBox.ToString" /> method calls the base class implementation of this method, <see cref="M:System.Windows.Forms.TextBoxBase.ToString" />, then appends the input string after processing by the mask. This method honors properties that alter the appearance of the formatted string, with the following exceptions:</para>
@@ -2203,6 +2211,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current masked text box. This method overrides <see cref="M:System.Windows.Forms.TextBoxBase.ToString" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that contains information about the current <see cref="T:System.Windows.Forms.MaskedTextBox" />. The string includes the type, a simplified view of the input string, and the formatted input string.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TypeValidationCompleted">
@@ -2324,7 +2336,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.MaskedTextBox.ValidateText" /> method attempts to convert the formatted string contained in the <see cref="P:System.Windows.Forms.MaskedTextBox.Text" /> property to an instance of the type that is specified by the <see cref="P:System.Windows.Forms.MaskedTextBox.ValidatingType" /> property. Prompt characters are ignored in the formatted string, but literals are handled in accordance with the current value of the <see cref="P:System.Windows.Forms.MaskedTextBox.TextMaskFormat" /> property.</para>
@@ -2335,6 +2346,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the user input string to an instance of the validating type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If successful, an <see cref="T:System.Object" /> of the type specified by the <see cref="P:System.Windows.Forms.MaskedTextBox.ValidatingType" /> property; otherwise, null to indicate conversion failure.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ValidatingType">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Menu.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Menu.xml
index 6cd27e833b4..32a0af4ede7 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Menu.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Menu.xml
@@ -89,12 +89,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new handle to the <see cref="T:System.Windows.Forms.Menu" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A handle to the menu if the method succeeds; otherwise, null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -159,7 +162,6 @@
         <Parameter Name="value" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To search for a <see cref="T:System.Windows.Forms.MenuItem" /> using a handle, pass in the <see cref="F:System.Windows.Forms.Menu.FindHandle" /> field as the type, and the handle of the <see cref="T:System.Windows.Forms.MenuItem" /> you want to find as the value. </para>
@@ -169,6 +171,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Windows.Forms.MenuItem" /> that contains the value specified. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.MenuItem" /> that matches value; otherwise, null.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of item to use to find the <see cref="T:System.Windows.Forms.MenuItem" />.</param>
         <param name="value">
@@ -189,7 +195,6 @@
         <Parameter Name="mergeOrder" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The merge order of a menu item specifies the relative position that this menu item will assume if the menu structure that the <see cref="T:System.Windows.Forms.MenuItem" /> is contained in is merged with another.</para>
@@ -198,6 +203,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the position at which a menu item should be inserted into the menu.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position at which a menu item should be inserted into the menu.</para>
+        </returns>
         <param name="mergeOrder">
           <attribution license="cc4" from="Microsoft" modified="false" />The merge order position for the menu item to be merged.</param>
       </Docs>
@@ -233,7 +242,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method allows you to obtain a reference to the <see cref="T:System.Windows.Forms.ContextMenu" /> that this menu is contained in. This property returns null if the menu is not contained in a <see cref="T:System.Windows.Forms.ContextMenu" />. This can occur if the menu is contained in a <see cref="T:System.Windows.Forms.MenuItem" /> or <see cref="T:System.Windows.Forms.MainMenu" />, or if the menu is not contained in any menu. You can use this property to determine whether a menu is currently being used, and also to determine where.</para>
@@ -242,6 +250,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Windows.Forms.ContextMenu" /> that contains this menu.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.ContextMenu" /> that contains this menu. The default is null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -256,7 +268,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method allows you to obtain a reference to the <see cref="T:System.Windows.Forms.MainMenu" /> this menu is currently located in. This property returns null if the menu is not contained in a <see cref="T:System.Windows.Forms.MainMenu" />. This can occur if the menu is contained in a <see cref="T:System.Windows.Forms.MenuItem" /> or <see cref="T:System.Windows.Forms.ContextMenu" />, or if the menu is not contained in any menu. You can use this property to determine whether a menu is currently being used, and also to determine where.</para>
@@ -265,6 +276,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Windows.Forms.MainMenu" /> that contains this menu.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.MainMenu" /> that contains this menu.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -518,7 +533,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.Menu.ToString" /> method returns a <see cref="T:System.String" /> that includes the type and the number of items in the <see cref="P:System.Windows.Forms.Menu.MenuItems" /> property of the control.</para>
@@ -527,6 +541,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.String" /> that represents the <see cref="T:System.Windows.Forms.Menu" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that represents the current <see cref="T:System.Windows.Forms.Menu" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/MenuItem.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/MenuItem.xml
index 9d109cc4120..55ec461e73f 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/MenuItem.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/MenuItem.xml
@@ -340,7 +340,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -350,6 +349,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the current <see cref="T:System.Windows.Forms.MenuItem" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.MenuItem" /> that represents the duplicated menu item.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -374,6 +377,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the specified <see cref="T:System.Windows.Forms.MenuItem" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.MenuItem" /> that represents the duplicated menu item.</para>
+        </returns>
         <param name="itemSrc">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.MenuItem" /> that represents the menu item to copy. </param>
       </Docs>
@@ -618,7 +625,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When you call this version of <see cref="M:System.Windows.Forms.MenuItem.MergeMenu" />, the <see cref="T:System.Windows.Forms.MenuItem" /> returned is a copy of the current menu item that can be merged with another menu item without affecting the functionality of the current item. This version of the <see cref="M:System.Windows.Forms.MenuItem.MergeMenu" /> method is similar to calling the <see cref="M:System.Windows.Forms.MenuItem.CloneMenu" /> method that contains no parameters.</para>
@@ -627,6 +633,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Merges this <see cref="T:System.Windows.Forms.MenuItem" /> with another <see cref="T:System.Windows.Forms.MenuItem" /> and returns the resulting merged <see cref="T:System.Windows.Forms.MenuItem" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.MenuItem" /> that represents the merged menu item.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1159,12 +1169,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the <see cref="T:System.Windows.Forms.MenuItem" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Windows.Forms.MenuItem" />. The string includes the type and the <see cref="P:System.Windows.Forms.MenuItem.Text" /> property of the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/MenuStrip.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/MenuStrip.xml
index 6a0ff01a5e9..e7e136ae0d4 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/MenuStrip.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/MenuStrip.xml
@@ -107,7 +107,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you do not explicitly call the <see cref="M:System.Windows.Forms.MenuStrip.CreateAccessibilityInstance" /> method, it will be called when the <see cref="P:System.Windows.Forms.Control.AccessibilityObject" /> property is referenced.</para>
@@ -120,6 +119,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessibility object for the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.AccessibleObject" /> for the control.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateDefaultItem">
@@ -137,7 +140,6 @@
         <Parameter Name="onClick" Type="System.EventHandler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Windows.Forms.MenuStrip.CreateDefaultItem(System.String,System.Drawing.Image,System.EventHandler)" /> method to add a <see cref="T:System.Windows.Forms.ToolStripMenuItem" /> with commonly used characteristics to a <see cref="T:System.Windows.Forms.MenuStrip" />.</para>
@@ -146,6 +148,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Windows.Forms.ToolStripMenuItem" /> with the specified text, image, and event handler on a new <see cref="T:System.Windows.Forms.MenuStrip" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="M:System.Windows.Forms.ToolStripMenuItem.#ctor(System.String,System.Drawing.Image,System.EventHandler)" />, or a <see cref="T:System.Windows.Forms.ToolStripSeparator" /> if the <paramref name="text" /> parameter is a hyphen (-).</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to use for the <see cref="T:System.Windows.Forms.ToolStripMenuItem" />. If the <paramref name="text" /> parameter is a hyphen (-), this method creates a <see cref="T:System.Windows.Forms.ToolStripSeparator" />.</param>
         <param name="image">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Message.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Message.xml
index 099938d8c6d..6f86b2dfeee 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Message.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Message.xml
@@ -35,7 +35,6 @@
         <Parameter Name="lparam" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Windows.Forms.Message.Create(System.IntPtr,System.Int32,System.IntPtr,System.IntPtr)" /> method to create a <see cref="T:System.Windows.Forms.Message" /> to wrap a message sent by Windows.</para>
@@ -44,6 +43,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Windows.Forms.Message" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.Message" /> that represents the message that was created.</para>
+        </returns>
         <param name="hWnd">
           <attribution license="cc4" from="Microsoft" modified="false" />The window handle that the message is for. </param>
         <param name="msg">
@@ -68,12 +71,15 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified object is equal to the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified object is equal to the current object; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current object.</param>
       </Docs>
@@ -109,7 +115,6 @@
         <Parameter Name="cls" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Windows.Forms.Message.GetLParam(System.Type)" /> method to retrieve information from the <see cref="P:System.Windows.Forms.Message.LParam" /> field of a message and convert it to an object. You can use this method to access objects passed in a message.</para>
@@ -118,6 +123,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="P:System.Windows.Forms.Message.LParam" /> value and converts the value to an object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents an instance of the class specified by the <paramref name="cls" /> parameter, with the data from the <see cref="P:System.Windows.Forms.Message.LParam" /> field of the message.</para>
+        </returns>
         <param name="cls">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to use to create an instance. This type must be declared as a structure type. </param>
       </Docs>
@@ -200,12 +209,15 @@
         <Parameter Name="b" Type="System.Windows.Forms.Message" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two instances of <see cref="T:System.Windows.Forms.Message" /> are equal. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> and <paramref name="b" /> represent the same <see cref="T:System.Windows.Forms.Message" />; otherwise, false. </para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Message" /> to compare to <paramref name="b" />.</param>
         <param name="b">
@@ -226,12 +238,15 @@
         <Parameter Name="b" Type="System.Windows.Forms.Message" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two instances of <see cref="T:System.Windows.Forms.Message" /> are not equal. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> and <paramref name="b" /> do not represent the same <see cref="T:System.Windows.Forms.Message" />; otherwise, false. </para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Message" /> to compare to <paramref name="b" />.</param>
         <param name="b">
@@ -265,12 +280,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.String" /> that represents the current <see cref="T:System.Windows.Forms.Message" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that represents the current <see cref="T:System.Windows.Forms.Message" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/MessageBox.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/MessageBox.xml
index 511528f2275..e2b19b6eee6 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/MessageBox.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/MessageBox.xml
@@ -31,7 +31,6 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>By default, the message box displays an <ui>OK</ui> button. The message box does not contain a caption in the title.</para>
@@ -40,6 +39,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a message box with specified text.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DialogResult" /> values.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to display in the message box. </param>
       </Docs>
@@ -59,7 +62,6 @@
         <Parameter Name="caption" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>By default, the message box displays an <ui>OK</ui> button.</para>
@@ -68,6 +70,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a message box with specified text and caption.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DialogResult" /> values.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to display in the message box. </param>
         <param name="caption">
@@ -89,7 +95,6 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the <paramref name="owner" /> parameter to specify a particular object, which implements the <see cref="T:System.Windows.Forms.IWin32Window" /> interface, that will serve as the dialog box's top-level window and owner. A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.</para>
@@ -99,6 +104,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a message box in front of the specified object and with the specified text.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DialogResult" /> values.</para>
+        </returns>
         <param name="owner">
           <attribution license="cc4" from="Microsoft" modified="false" />An implementation of <see cref="T:System.Windows.Forms.IWin32Window" /> that will own the modal dialog box. </param>
         <param name="text">
@@ -121,7 +130,6 @@
         <Parameter Name="buttons" Type="System.Windows.Forms.MessageBoxButtons" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can have a maximum of three buttons on the message box.</para>
@@ -130,6 +138,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a message box with specified text, caption, and buttons.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DialogResult" /> values.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to display in the message box. </param>
         <param name="caption">
@@ -154,7 +166,6 @@
         <Parameter Name="caption" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the <paramref name="owner" /> parameter to specify a particular object, which implements the <see cref="T:System.Windows.Forms.IWin32Window" /> interface, that will serve as the dialog box's top-level window and owner. A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.</para>
@@ -164,6 +175,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a message box in front of the specified object and with the specified text and caption.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DialogResult" /> values.</para>
+        </returns>
         <param name="owner">
           <attribution license="cc4" from="Microsoft" modified="false" />An implementation of <see cref="T:System.Windows.Forms.IWin32Window" /> that will own the modal dialog box.</param>
         <param name="text">
@@ -189,7 +204,6 @@
         <Parameter Name="icon" Type="System.Windows.Forms.MessageBoxIcon" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can have a maximum of three buttons on the message box.</para>
@@ -198,6 +212,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a message box with specified text, caption, buttons, and icon.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DialogResult" /> values.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to display in the message box. </param>
         <param name="caption">
@@ -225,7 +243,6 @@
         <Parameter Name="buttons" Type="System.Windows.Forms.MessageBoxButtons" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the <paramref name="owner" /> parameter to specify a particular object, which implements the <see cref="T:System.Windows.Forms.IWin32Window" /> interface, that will serve as the dialog box's top-level window and owner. A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.</para>
@@ -235,6 +252,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a message box in front of the specified object and with the specified text, caption, and buttons.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DialogResult" /> values.</para>
+        </returns>
         <param name="owner">
           <attribution license="cc4" from="Microsoft" modified="false" />An implementation of <see cref="T:System.Windows.Forms.IWin32Window" /> that will own the modal dialog box.</param>
         <param name="text">
@@ -263,7 +284,6 @@
         <Parameter Name="defaultButton" Type="System.Windows.Forms.MessageBoxDefaultButton" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can have a maximum of three buttons on the message box.</para>
@@ -272,6 +292,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a message box with the specified text, caption, buttons, icon, and default button.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DialogResult" /> values.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to display in the message box. </param>
         <param name="caption">
@@ -302,7 +326,6 @@
         <Parameter Name="icon" Type="System.Windows.Forms.MessageBoxIcon" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the <paramref name="owner" /> parameter to specify a particular object, which implements the <see cref="T:System.Windows.Forms.IWin32Window" /> interface, that will serve as the dialog box's top-level window and owner. A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.</para>
@@ -312,6 +335,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a message box in front of the specified object and with the specified text, caption, buttons, and icon.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DialogResult" /> values.</para>
+        </returns>
         <param name="owner">
           <attribution license="cc4" from="Microsoft" modified="false" />An implementation of <see cref="T:System.Windows.Forms.IWin32Window" /> that will own the modal dialog box.</param>
         <param name="text">
@@ -343,7 +370,6 @@
         <Parameter Name="options" Type="System.Windows.Forms.MessageBoxOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can have a maximum of three buttons on the message box.</para>
@@ -352,6 +378,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a message box with the specified text, caption, buttons, icon, default button, and options.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DialogResult" /> values.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to display in the message box. </param>
         <param name="caption">
@@ -385,7 +415,6 @@
         <Parameter Name="defaultButton" Type="System.Windows.Forms.MessageBoxDefaultButton" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the <paramref name="owner" /> parameter to specify a particular object, which implements the <see cref="T:System.Windows.Forms.IWin32Window" /> interface, that will serve as the dialog box's top-level window and owner. A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.</para>
@@ -395,6 +424,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a message box in front of the specified object and with the specified text, caption, buttons, icon, and default button.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DialogResult" /> values.</para>
+        </returns>
         <param name="owner">
           <attribution license="cc4" from="Microsoft" modified="false" />An implementation of <see cref="T:System.Windows.Forms.IWin32Window" /> that will own the modal dialog box.</param>
         <param name="text">
@@ -432,7 +465,6 @@
         <Parameter Name="displayHelpButton" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.</para>
@@ -442,6 +474,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DialogResult" /> values.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to display in the message box. </param>
         <param name="caption">
@@ -477,7 +513,6 @@
         <Parameter Name="helpFilePath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.</para>
@@ -488,6 +523,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DialogResult" /> values.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to display in the message box. </param>
         <param name="caption">
@@ -520,7 +559,6 @@
         <Parameter Name="options" Type="System.Windows.Forms.MessageBoxOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the <paramref name="owner" /> parameter to specify a particular object, which implements the <see cref="T:System.Windows.Forms.IWin32Window" /> interface, that will serve as the dialog box's top-level window and owner. A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.</para>
@@ -530,6 +568,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a message box in front of the specified object and with the specified text, caption, buttons, icon, default button, and options.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DialogResult" /> values.</para>
+        </returns>
         <param name="owner">
           <attribution license="cc4" from="Microsoft" modified="false" />An implementation of <see cref="T:System.Windows.Forms.IWin32Window" /> that will own the modal dialog box.</param>
         <param name="text">
@@ -570,7 +612,6 @@
         <Parameter Name="keyword" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.</para>
@@ -580,6 +621,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and Help keyword.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DialogResult" /> values.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to display in the message box. </param>
         <param name="caption">
@@ -618,7 +663,6 @@
         <Parameter Name="navigator" Type="System.Windows.Forms.HelpNavigator" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.</para>
@@ -630,6 +674,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and HelpNavigator.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DialogResult" /> values.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to display in the message box. </param>
         <param name="caption">
@@ -668,7 +716,6 @@
         <Parameter Name="helpFilePath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. The program must hide or close a modal form (typically in response to some user action) before input to another form can occur. You can use the <paramref name="owner" /> parameter to specify a particular object, which implements the <see cref="T:System.Windows.Forms.IWin32Window" /> interface, that will serve as the dialog box's top-level window and owner.</para>
@@ -679,6 +726,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DialogResult" /> values.</para>
+        </returns>
         <param name="owner">
           <attribution license="cc4" from="Microsoft" modified="false" />An implementation of <see cref="T:System.Windows.Forms.IWin32Window" /> that will own the modal dialog box.</param>
         <param name="text">
@@ -718,7 +769,6 @@
         <Parameter Name="param" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.</para>
@@ -731,6 +781,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file, HelpNavigator, and Help topic.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DialogResult" /> values.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to display in the message box. </param>
         <param name="caption">
@@ -772,7 +826,6 @@
         <Parameter Name="keyword" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. The program must hide or close a modal form (typically in response to some user action) before input to another form can occur. You can use the <paramref name="owner" /> parameter to specify a particular object, which implements the <see cref="T:System.Windows.Forms.IWin32Window" /> interface, that will serve as the dialog box's top-level owner.</para>
@@ -782,6 +835,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and Help keyword.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DialogResult" /> values.</para>
+        </returns>
         <param name="owner">
           <attribution license="cc4" from="Microsoft" modified="false" />An implementation of <see cref="T:System.Windows.Forms.IWin32Window" /> that will own the modal dialog box.</param>
         <param name="text">
@@ -823,7 +880,6 @@
         <Parameter Name="navigator" Type="System.Windows.Forms.HelpNavigator" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. The program must hide or close a modal form (typically in response to some user action) before input to another form can occur. You can use the <paramref name="owner" /> parameter to specify a particular object, which implements the <see cref="T:System.Windows.Forms.IWin32Window" /> interface, that will serve as the dialog box's top-level window and owner.</para>
@@ -835,6 +891,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and HelpNavigator.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DialogResult" /> values.</para>
+        </returns>
         <param name="owner">
           <attribution license="cc4" from="Microsoft" modified="false" />An implementation of <see cref="T:System.Windows.Forms.IWin32Window" /> that will own the modal dialog box.</param>
         <param name="text">
@@ -877,7 +937,6 @@
         <Parameter Name="param" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. The program must hide or close a modal form (typically in response to some user action) before input to another form can occur. You can use the <paramref name="owner" /> parameter to specify a particular object, which implements the <see cref="T:System.Windows.Forms.IWin32Window" /> interface, that will serve as the dialog box's top-level window and owner.</para>
@@ -890,6 +949,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file, HelpNavigator, and Help topic.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DialogResult" /> values.</para>
+        </returns>
         <param name="owner">
           <attribution license="cc4" from="Microsoft" modified="false" />An implementation of <see cref="T:System.Windows.Forms.IWin32Window" /> that will own the modal dialog box.</param>
         <param name="text">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/MonthCalendar.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/MonthCalendar.xml
index 8671b4f2ade..ff70c7e65ea 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/MonthCalendar.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/MonthCalendar.xml
@@ -713,7 +713,6 @@
         <Parameter Name="visible" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.MonthCalendar.GetDisplayRange(System.Boolean)" /> method returns a <see cref="P:System.Windows.Forms.MonthCalendar.SelectionRange" /> that contains the begin and end dates displayed in the current view of the control. You can modify the returned range based on the value you specify for the <paramref name="visible" /> parameter. By specifying false, you can retrieve all dates displayed on the control; specifying true retrieves only those dates that are part of fully displayed months.</para>
@@ -722,6 +721,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves date information that represents the low and high limits of the displayed dates of the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The begin and end dates of the displayed calendar.</para>
+        </returns>
         <param name="visible">
           <attribution license="cc4" from="Microsoft" modified="false" />true to retrieve only the dates that are fully contained in displayed months; otherwise, false. </param>
       </Docs>
@@ -740,12 +743,15 @@
         <Parameter Name="point" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object with information on which portion of a month calendar control is at a location specified by a <see cref="T:System.Drawing.Point" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.MonthCalendar.HitTestInfo" /> that contains information about the specified point on the <see cref="T:System.Windows.Forms.MonthCalendar" />.</para>
+        </returns>
         <param name="point">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Point" /> containing the <see cref="P:System.Drawing.Point.X" /> and <see cref="P:System.Drawing.Point.Y" /> coordinates of the point to be hit tested. </param>
       </Docs>
@@ -765,12 +771,15 @@
         <Parameter Name="y" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Windows.Forms.MonthCalendar.HitTestInfo" /> with information on which portion of a month calendar control is at a specified x- and y-coordinate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.MonthCalendar.HitTestInfo" /> that contains information about the specified point on the <see cref="T:System.Windows.Forms.MonthCalendar" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Drawing.Point.X" /> coordinate of the point to be hit tested. </param>
         <param name="y">
@@ -2053,7 +2062,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The string includes the type and the string returned by the <see cref="M:System.Windows.Forms.SelectionRange.ToString" /> method of the <see cref="P:System.Windows.Forms.MonthCalendar.SelectionRange" /> property.</para>
@@ -2062,6 +2070,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the <see cref="T:System.Windows.Forms.MonthCalendar" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Windows.Forms.MonthCalendar" />. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/NativeWindow.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/NativeWindow.xml
index 593bece78b3..556c9317673 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/NativeWindow.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/NativeWindow.xml
@@ -187,7 +187,6 @@
         <Parameter Name="handle" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you receive a handle from another method, use this method to retrieve the window associated with the handle. The handle must already be owned by another <see cref="T:System.Windows.Forms.NativeWindow" /> in the current process; otherwise, null is returned.</para>
@@ -196,6 +195,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the window associated with the specified handle. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.NativeWindow" /> associated with the specified handle. This method returns null when the handle does not have an associated window.</para>
+        </returns>
         <param name="handle">
           <attribution license="cc4" from="Microsoft" modified="false" />A handle to a window. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/NumericUpDown.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/NumericUpDown.xml
index ff384954540..5c73c3f9be1 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/NumericUpDown.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/NumericUpDown.xml
@@ -617,7 +617,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return string includes the type and the values for the <see cref="P:System.Windows.Forms.NumericUpDown.Minimum" /> and <see cref="P:System.Windows.Forms.NumericUpDown.Maximum" /> properties.</para>
@@ -626,6 +625,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the <see cref="T:System.Windows.Forms.NumericUpDown" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Windows.Forms.NumericUpDown" />. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/NumericUpDownAccelerationCollection.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/NumericUpDownAccelerationCollection.xml
index aabbdf61b0e..5987cb91e6a 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/NumericUpDownAccelerationCollection.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/NumericUpDownAccelerationCollection.xml
@@ -128,12 +128,15 @@
         <Parameter Name="acceleration" Type="System.Windows.Forms.NumericUpDownAcceleration" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Windows.Forms.NumericUpDownAccelerationCollection" /> contains a specific <see cref="T:System.Windows.Forms.NumericUpDownAcceleration" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Windows.Forms.NumericUpDownAcceleration" /> is found in the <see cref="T:System.Windows.Forms.NumericUpDownAccelerationCollection" />; otherwise, false.</para>
+        </returns>
         <param name="acceleration">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.NumericUpDownAcceleration" /> to locate in the <see cref="T:System.Windows.Forms.NumericUpDownAccelerationCollection" />.</param>
       </Docs>
@@ -234,12 +237,15 @@
         <Parameter Name="acceleration" Type="System.Windows.Forms.NumericUpDownAcceleration" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the first occurrence of the specified <see cref="T:System.Windows.Forms.NumericUpDownAcceleration" /> from the <see cref="T:System.Windows.Forms.NumericUpDownAccelerationCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Windows.Forms.NumericUpDownAcceleration" /> is removed from <see cref="T:System.Windows.Forms.NumericUpDownAccelerationCollection" />; otherwise, false.</para>
+        </returns>
         <param name="acceleration">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.NumericUpDownAcceleration" /> to remove from the collection.</param>
       </Docs>
@@ -271,7 +277,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.NumericUpDownAccelerationCollection" /> instance is cast to an <see cref="T:System.Collections.IEnumerable" /> interface.</para>
@@ -280,6 +285,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the enumerator for the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An iteration over the collection.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/OSFeature.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/OSFeature.xml
index bf30bb91bd3..aeca29cfbc0 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/OSFeature.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/OSFeature.xml
@@ -74,7 +74,6 @@
         <Parameter Name="feature" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="P:System.Windows.Forms.OSFeature.Feature" /> property, the static instance of <see cref="T:System.Windows.Forms.OSFeature" /> provided in this class, to query for the version number of a feature.</para>
@@ -83,6 +82,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the version of the specified feature currently available on the system. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Version" /> representing the version of the specified operating system feature currently available on the system; or null if the feature cannot be found.</para>
+        </returns>
         <param name="feature">
           <attribution license="cc4" from="Microsoft" modified="false" />The feature whose version is requested, either <see cref="F:System.Windows.Forms.OSFeature.LayeredWindows" /> or <see cref="F:System.Windows.Forms.OSFeature.Themes" />.</param>
       </Docs>
@@ -104,7 +107,6 @@
         <Parameter Name="enumVal" Type="System.Windows.Forms.SystemParameter" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Typically, you use the <see cref="M:System.Windows.Forms.OSFeature.IsPresent(System.Windows.Forms.SystemParameter)" /> method to determine if the operating system supports the specific feature or metric identified by <paramref name="enumValue" />. Based upon the value returned from <see cref="M:System.Windows.Forms.OSFeature.IsPresent(System.Windows.Forms.SystemParameter)" />, you would perform conditional actions in your code. For example, if calling this method with a parameter value of <see cref="F:System.Windows.Forms.SystemParameter.FlatMenu" /> returns true, you could create owner-drawn menus in your application in a flat style.</para>
@@ -114,6 +116,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a value indicating whether the operating system supports the specified feature or metric. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the feature is available on the system; otherwise, false.</para>
+        </returns>
         <param name="enumVal">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.SystemParameter" /> representing the feature to search for.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/OpacityConverter.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/OpacityConverter.xml
index 0424d55948a..a23791d4b5b 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/OpacityConverter.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/OpacityConverter.xml
@@ -52,7 +52,6 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="sourceType" /> is expected to be a <see cref="T:System.String" />.</para>
@@ -61,6 +60,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this converter can convert an object of the specified source type to the native type of the converter that uses the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides information about the context of a type converter. </param>
         <param name="sourceType">
@@ -83,7 +86,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.OpacityConverter.ConvertFrom(System.ComponentModel.ITypeDescriptorContext,System.Globalization.CultureInfo,System.Object)" /> method is specialized to convert <see cref="T:System.String" /> values that represent percentages or decimal fractions to their corresponding <see cref="T:System.Double" /> values, which represent the opacity as a percentage. Types other than <see cref="T:System.String" /> are passed to the base class implementation of this method.</para>
@@ -92,6 +94,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object to the converter's native type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted <paramref name="value" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides information about the context of a type converter. </param>
         <param name="culture">
@@ -117,7 +123,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.OpacityConverter.ConvertTo(System.ComponentModel.ITypeDescriptorContext,System.Globalization.CultureInfo,System.Object,System.Type)" /> method is specialized to convert integral values to their <see cref="T:System.String" /> percentage representations. Other types are passed to the base class implementation of this method.</para>
@@ -126,6 +131,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts from the converter's native type to a value of the destination type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted <paramref name="value" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides information about the context of a type converter. </param>
         <param name="culture">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/OpenFileDialog.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/OpenFileDialog.xml
index c1dea39c4e8..16853d507af 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/OpenFileDialog.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/OpenFileDialog.xml
@@ -101,7 +101,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.OpenFileDialog.OpenFile" /> method is used to provide a facility to quickly open a file from the dialog box. The file is opened in read-only mode for security purposes. To open a file in read/write mode, you must use another method, such as <see cref="T:System.IO.FileStream" />.</para>
@@ -110,6 +109,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens the file selected by the user, with read-only permission. The file is specified by the <see cref="P:System.Windows.Forms.FileDialog.FileName" /> property. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> that specifies the read-only file selected by the user.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/OwnerDrawPropertyBag.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/OwnerDrawPropertyBag.xml
index 44ec1b48ccc..dd1926bba08 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/OwnerDrawPropertyBag.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/OwnerDrawPropertyBag.xml
@@ -77,12 +77,15 @@
         <Parameter Name="value" Type="System.Windows.Forms.OwnerDrawPropertyBag" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies an <see cref="T:System.Windows.Forms.OwnerDrawPropertyBag" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new copy of the <see cref="T:System.Windows.Forms.OwnerDrawPropertyBag" /> control.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.OwnerDrawPropertyBag" /> to be copied.</param>
       </Docs>
@@ -137,12 +140,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the <see cref="T:System.Windows.Forms.OwnerDrawPropertyBag" /> contains all default values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Windows.Forms.OwnerDrawPropertyBag" /> contains all default values; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Padding.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Padding.xml
index 8c4f128b90d..98160ff2aeb 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Padding.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Padding.xml
@@ -101,13 +101,16 @@
         <Parameter Name="p2" Type="System.Windows.Forms.Padding" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the two specified <see cref="T:System.Windows.Forms.Padding" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.Padding" /> that contains the sum of the two specified <see cref="T:System.Windows.Forms.Padding" /> values.</para>
+        </returns>
         <param name="p1">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Padding" />.</param>
         <param name="p2">
@@ -204,7 +207,6 @@
         <Parameter Name="other" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -214,6 +216,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the value of the specified object is equivalent to the current <see cref="T:System.Windows.Forms.Padding" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Windows.Forms.Padding" /> objects are equivalent; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to the current <see cref="T:System.Windows.Forms.Padding" />.</param>
       </Docs>
@@ -229,7 +235,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -241,6 +246,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a hash code for the current <see cref="T:System.Windows.Forms.Padding" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -311,7 +320,6 @@
         <Parameter Name="p2" Type="System.Windows.Forms.Padding" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -322,6 +330,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs vector addition on the two specified <see cref="T:System.Windows.Forms.Padding" /> objects, resulting in a new <see cref="T:System.Windows.Forms.Padding" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.Padding" /> that results from adding <paramref name="p1" /> and <paramref name="p2" />.</para>
+        </returns>
         <param name="p1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Windows.Forms.Padding" /> to add.</param>
         <param name="p2">
@@ -342,7 +354,6 @@
         <Parameter Name="p2" Type="System.Windows.Forms.Padding" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -352,6 +363,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether two specified <see cref="T:System.Windows.Forms.Padding" /> objects are equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two <see cref="T:System.Windows.Forms.Padding" /> objects are equal; otherwise, false.</para>
+        </returns>
         <param name="p1">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Padding" /> to test.</param>
         <param name="p2">
@@ -372,7 +387,6 @@
         <Parameter Name="p2" Type="System.Windows.Forms.Padding" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -382,6 +396,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether two specified <see cref="T:System.Windows.Forms.Padding" /> objects are not equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two <see cref="T:System.Windows.Forms.Padding" /> objects are different; otherwise, false.</para>
+        </returns>
         <param name="p1">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Padding" /> to test.</param>
         <param name="p2">
@@ -402,7 +420,6 @@
         <Parameter Name="p2" Type="System.Windows.Forms.Padding" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -412,6 +429,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs vector subtraction on the two specified <see cref="T:System.Windows.Forms.Padding" /> objects, resulting in a new <see cref="T:System.Windows.Forms.Padding" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.Padding" /> result of subtracting <paramref name="p2" /> from <paramref name="p1" />.</para>
+        </returns>
         <param name="p1">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Padding" /> to subtract from (the minuend).</param>
         <param name="p2">
@@ -488,13 +509,16 @@
         <Parameter Name="p2" Type="System.Windows.Forms.Padding" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts one specified <see cref="T:System.Windows.Forms.Padding" /> value from another.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.Padding" /> that contains the result of the subtraction of one specified <see cref="T:System.Windows.Forms.Padding" /> value from another.</para>
+        </returns>
         <param name="p1">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Padding" />.</param>
         <param name="p2">
@@ -539,7 +563,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -550,6 +573,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Windows.Forms.Padding" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that represents the current <see cref="T:System.Windows.Forms.Padding" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/PaddingConverter.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/PaddingConverter.xml
index e1ede6eb3aa..5d0cfee2caf 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/PaddingConverter.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/PaddingConverter.xml
@@ -46,12 +46,15 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether this converter can convert an object of one type to the type of this converter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this object can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
         <param name="sourceType">
@@ -73,12 +76,15 @@
       </Parameters>
       <Docs>
         <param name="context">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether this converter can convert the object to the specified type, using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="destinationType">
           <attribution license="cc4" from="Microsoft" modified="false" />A T:System.Type that represents the type you want to convert to. </param>
       </Docs>
@@ -145,12 +151,15 @@
         <Parameter Name="propertyValues" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the type that this <see cref="T:System.ComponentModel.TypeConverter" /> is associated with, using the specified context, given a set of property values for the object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> representing the given <see cref="T:System.Collections.IDictionary" />, or null if the object cannot be created. This method always returns null.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="propertyValues">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Panel.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Panel.xml
index 3085476b883..96f6cc0bf5c 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Panel.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Panel.xml
@@ -408,12 +408,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation for this control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> representation of the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/PictureBox.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/PictureBox.xml
index 7d28f8e2a35..724ae8319c9 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/PictureBox.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/PictureBox.xml
@@ -1502,7 +1502,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.PictureBox.ToString" /> method returns a string that includes the type and the <see cref="P:System.Windows.Forms.PictureBox.SizeMode" /> property of the control.</para>
@@ -1511,6 +1510,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Windows.Forms.PictureBox" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Windows.Forms.PictureBox" />. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/PrintControllerWithStatusDialog.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/PrintControllerWithStatusDialog.xml
index 2c8aff18ed6..a15ba3abf15 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/PrintControllerWithStatusDialog.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/PrintControllerWithStatusDialog.xml
@@ -160,7 +160,6 @@
         <Parameter Name="e" Type="System.Drawing.Printing.PrintPageEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Windows.Forms.PrintControllerWithStatusDialog" /> class calls the <see cref="M:System.Drawing.Printing.PrintController.OnStartPage(System.Drawing.Printing.PrintDocument,System.Drawing.Printing.PrintPageEventArgs)" /> method on the encapsulated <see cref="T:System.Drawing.Printing.PrintController" />.</para>
@@ -172,6 +171,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins the control sequence that determines when and how to print a page of a document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Graphics" /> object that represents a page from a <see cref="T:System.Drawing.Printing.PrintDocument" />.</para>
+        </returns>
         <param name="document">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Printing.PrintDocument" /> that represents the document currently being printed.</param>
         <param name="e">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/PrintPreviewDialog.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/PrintPreviewDialog.xml
index 08e622b9872..b43ddd84f34 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/PrintPreviewDialog.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/PrintPreviewDialog.xml
@@ -2079,7 +2079,6 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="F:System.Windows.Forms.Keys.Up" />, <see cref="F:System.Windows.Forms.Keys.Down" />, <see cref="F:System.Windows.Forms.Keys.Right" />, and <see cref="F:System.Windows.Forms.Keys.Left" /> key values will return false; otherwise, processing is passed to the base class's <see cref="M:System.Windows.Forms.Form.ProcessDialogKey(System.Windows.Forms.Keys)" /> method.</para>
@@ -2088,6 +2087,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a key should be processed further.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true to indicate the key should be processed; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.Keys" /> values. </param>
       </Docs>
@@ -2105,12 +2108,15 @@
         <Parameter Name="forward" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the TAB key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true to indicate the TAB key was successfully processed; otherwise, false.</para>
+        </returns>
         <param name="forward">
           <attribution license="cc4" from="Microsoft" modified="false" />true to cycle forward through the controls in the form; otherwise, false.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ProgressBar.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ProgressBar.xml
index d2021e60499..c0858f19f08 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ProgressBar.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ProgressBar.xml
@@ -1426,7 +1426,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return string includes the type and the values for the <see cref="P:System.Windows.Forms.ProgressBar.Minimum" />, <see cref="P:System.Windows.Forms.ProgressBar.Maximum" />, and <see cref="P:System.Windows.Forms.ProgressBar.Value" /> properties.</para>
@@ -1435,6 +1434,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the <see cref="T:System.Windows.Forms.ProgressBar" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Windows.Forms.ProgressBar" />. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/PropertyGrid.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/PropertyGrid.xml
index 878c533add7..1382b09a29f 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/PropertyGrid.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/PropertyGrid.xml
@@ -560,7 +560,6 @@
         <Parameter Name="tabType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See <see cref="T:System.Windows.Forms.Design.PropertyTab" /> for more information about creating property tabs.</para>
@@ -569,6 +568,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, enables the creation of a <see cref="T:System.Windows.Forms.Design.PropertyTab" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created property tab. Returns null in its default implementation.</para>
+        </returns>
         <param name="tabType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of tab to create. </param>
       </Docs>
@@ -1676,12 +1679,15 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a dialog key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key was processed by the control; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies key codes and modifiers.</param>
       </Docs>
@@ -2173,7 +2179,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.PropertyGrid" /> instance is cast to an <see cref="T:System.Windows.Forms.ComponentModel.Com2Interop.IComPropertyBrowser" /> interface.</para>
@@ -2182,6 +2187,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Commits all pending changes to the <see cref="T:System.Windows.Forms.PropertyGrid" /> control. For a description of this member, see <see cref="M:System.Windows.Forms.ComponentModel.Com2Interop.IComPropertyBrowser.EnsurePendingChangesCommitted" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if all the <see cref="T:System.Windows.Forms.PropertyGrid" /> successfully commits changes; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Windows.Forms.ComponentModel.Com2Interop.IComPropertyBrowser.HandleF4">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/RadioButton.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/RadioButton.xml
index 0f4d3fee1a8..54640f37e0a 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/RadioButton.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/RadioButton.xml
@@ -232,7 +232,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you do not explicitly call the <see cref="M:System.Windows.Forms.RadioButton.CreateAccessibilityInstance" /> method, it will be called when the <see cref="P:System.Windows.Forms.Control.AccessibilityObject" /> property is referenced.</para>
@@ -244,6 +243,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessibility object for the <see cref="T:System.Windows.Forms.RadioButton" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.RadioButton.RadioButtonAccessibleObject" /> for the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -503,12 +506,15 @@
         <Parameter Name="charCode" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Overrides the <see cref="M:System.Windows.Forms.Control.ProcessMnemonic(System.Char)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character was successfully processed; otherwise, false.</para>
+        </returns>
         <param name="charCode">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to process.</param>
       </Docs>
@@ -576,12 +582,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Overrides the <see cref="M:System.ComponentModel.Component.ToString" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the <see cref="T:System.Windows.Forms.RadioButton" /> that indicates whether it is checked.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/RadioButtonRenderer.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/RadioButtonRenderer.xml
index c4c9ff01126..8dd999207f1 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/RadioButtonRenderer.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/RadioButtonRenderer.xml
@@ -292,7 +292,6 @@
         <Parameter Name="state" Type="System.Windows.Forms.VisualStyles.RadioButtonState" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -302,6 +301,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the size, in pixels, of the option button (also known as a radio button) glyph.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Size" /> that represents the size, in pixels, of the option button glyph.</para>
+        </returns>
         <param name="g">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Graphics" /> used to draw the option button.</param>
         <param name="state">
@@ -321,13 +324,16 @@
         <Parameter Name="state" Type="System.Windows.Forms.VisualStyles.RadioButtonState" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the background of the option button (also known as a radio button) has semitransparent or alpha-blended pieces.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the background of the option button has semitransparent or alpha-blended pieces; otherwise, false.</para>
+        </returns>
         <param name="state">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.VisualStyles.RadioButtonState" /> values that specifies the visual state of the option button.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/RichTextBox.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/RichTextBox.xml
index 8dd03826c40..33ca348ad93 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/RichTextBox.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/RichTextBox.xml
@@ -386,12 +386,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an IRichEditOleCallback-compatible object for handling rich-edit callback operations.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that implements the IRichEditOleCallback interface.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -639,7 +642,6 @@
         <Parameter Name="characterSet" Type="System.Char[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This version of the <see cref="M:System.Windows.Forms.RichTextBox.Find(System.String)" /> method searches for the first instance of a character from a list of characters specified in the <paramref name="characterSet" /> parameter and returns the location of the character. For example, you pass an array of characters containing the character 'Q'. If the control contained the text "The Quick Brown Fox", the <see cref="M:System.Windows.Forms.RichTextBox.Find(System.String)" /> method would return the value of four. An upper case character and a lower case character are considered different values in the search.</para>
@@ -649,6 +651,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the text of a <see cref="T:System.Windows.Forms.RichTextBox" /> control for the first instance of a character from a list of characters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The location within the control where the search characters were found or -1 if the search characters are not found or an empty search character set is specified in the <paramref name="char" /> parameter.</para>
+        </returns>
         <param name="characterSet">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of characters to search for. </param>
       </Docs>
@@ -667,7 +673,6 @@
         <Parameter Name="str" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.RichTextBox.Find(System.String)" /> method searches for the text specified in the <paramref name="str" /> parameter and returns the location of the first character within the control. If the property returns a negative value, the text string being searched for was not found within the contents of the control. You can use this method to create search functionality that can be provided to the user of the control. You can also use this method to search for text to be replaced with a specific format. For example, if the user entered dates into the control, you could use the <see cref="M:System.Windows.Forms.RichTextBox.Find(System.String)" /> method to search for all dates in the document and replace them with the appropriate format before using the <see cref="M:System.Windows.Forms.RichTextBox.SaveFile(System.String)" /> method of the control.</para>
@@ -679,6 +684,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the text in a <see cref="T:System.Windows.Forms.RichTextBox" /> control for a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The location within the control where the search text was found or -1 if the search string is not found or an empty search string is specified in the <paramref name="str" /> parameter.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to locate in the control. </param>
       </Docs>
@@ -698,7 +707,6 @@
         <Parameter Name="start" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This version of the <see cref="M:System.Windows.Forms.RichTextBox.Find(System.String)" /> method searches for the first instance of a character from a list of characters specified in the <paramref name="characterSet" /> parameter and returns the location the character. For example, you pass an array of characters containing the character 'Q'. If the control contained the text "The Quick Brown Fox", the <see cref="M:System.Windows.Forms.RichTextBox.Find(System.String)" /> method would return the value of four. An upper case character and a lower case character are considered different values in the search.</para>
@@ -709,6 +717,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the text of a <see cref="T:System.Windows.Forms.RichTextBox" /> control, at a specific starting point, for the first instance of a character from a list of characters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The location within the control where the search characters are found.</para>
+        </returns>
         <param name="characterSet">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of characters to search for. </param>
         <param name="start">
@@ -730,7 +742,6 @@
         <Parameter Name="options" Type="System.Windows.Forms.RichTextBoxFinds" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.RichTextBox.Find(System.String)" /> method searches for the text specified in the <paramref name="str" /> parameter and returns the location of the first character within the control. If the property returns a negative value, the text string being searched for was not found within the contents of the control. You can use this method to create search functionality that can be provided to the user of the control. You can also use this method to search for text to be replaced with a specific format. For example, if the user entered dates into the control, you can use the <see cref="M:System.Windows.Forms.RichTextBox.Find(System.String)" /> method to search for all dates in the document and replace them with the appropriate format before using the <see cref="M:System.Windows.Forms.RichTextBox.SaveFile(System.String)" /> method of the control.</para>
@@ -743,6 +754,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the text in a <see cref="T:System.Windows.Forms.RichTextBox" /> control for a string with specific options applied to the search.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The location within the control where the search text was found.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to locate in the control. </param>
         <param name="options">
@@ -765,7 +780,6 @@
         <Parameter Name="end" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This version of the <see cref="M:System.Windows.Forms.RichTextBox.Find(System.String)" /> method searches for the first instance of a character from a list of characters specified in the <paramref name="characterSet" /> parameter and returns the location of the character. For example, you pass an array of characters containing the character 'Q'. If the control contained the text "The Quick Brown Fox", the <see cref="M:System.Windows.Forms.RichTextBox.Find(System.String)" /> method would return the value of four. An upper case character and a lower case character are considered different values in the search.</para>
@@ -776,6 +790,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches a range of text in a <see cref="T:System.Windows.Forms.RichTextBox" /> control for the first instance of a character from a list of characters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The location within the control where the search characters are found.</para>
+        </returns>
         <param name="characterSet">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of characters to search for. </param>
         <param name="start">
@@ -800,7 +818,6 @@
         <Parameter Name="options" Type="System.Windows.Forms.RichTextBoxFinds" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.RichTextBox.Find(System.String)" /> method searches for the text specified in the <paramref name="str" /> parameter and returns the location of the first character of the search string within the control. If the property returns a negative value, the text string being searched for was not found within the contents of the control. You can use this method to create search functionality that can be provided to the user of the control. You can also use this method to search for text to be replaced with a specific format. For example, if the user entered dates into the control, you could use the <see cref="M:System.Windows.Forms.RichTextBox.Find(System.String)" /> method to search for all dates in the document and replace them with the appropriate format before using the <see cref="M:System.Windows.Forms.RichTextBox.SaveFile(System.String)" /> method of the control.</para>
@@ -813,6 +830,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the text in a <see cref="T:System.Windows.Forms.RichTextBox" /> control for a string at a specific location within the control and with specific options applied to the search.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The location within the control where the search text was found.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to locate in the control. </param>
         <param name="start">
@@ -838,7 +859,6 @@
         <Parameter Name="options" Type="System.Windows.Forms.RichTextBoxFinds" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.RichTextBox.Find(System.String)" /> method searches for the text specified in the <paramref name="str" /> parameter and returns the location of the first character of the search string within the control. If the property returns a negative value, the text string being searched for was not found within the contents of the control. You can use this method to create search functionality that can be provided to the user of the control. You can also use this method to search for text to be replaced with a specific format. For example, if the user entered dates into the control, you can use the <see cref="M:System.Windows.Forms.RichTextBox.Find(System.String)" /> method to search for all dates in the document and replace them with the appropriate format before using the <see cref="M:System.Windows.Forms.RichTextBox.SaveFile(System.String)" /> method of the control.</para>
@@ -851,6 +871,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the text in a <see cref="T:System.Windows.Forms.RichTextBox" /> control for a string within a range of text within the control and with specific options applied to the search.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The location within the control where the search text was found.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to locate in the control. </param>
         <param name="start">
@@ -932,7 +956,6 @@
         <Parameter Name="pt" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns the character index that is closest to the position specified in the <paramref name="pt" /> parameter. The character index is a zero-based index of text in the control, including spaces. You can use this method to determine where in the text the user has the mouse over by passing the mouse coordinates to this method. This can be useful if you want to perform tasks when the user rests the mouse pointer over a word in the text of the control.</para>
@@ -941,6 +964,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the index of the character nearest to the specified location.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based character index at the specified location.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />The location to search. </param>
       </Docs>
@@ -959,7 +986,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method enables you to determine the line number based on the character index specified in the <paramref name="index" /> parameter of the method. The first line of text in the control returns the value zero. The <see cref="M:System.Windows.Forms.RichTextBox.GetLineFromCharIndex(System.Int32)" /> method returns the physical line number where the indexed character is located within the control. For example, if a portion of the first logical line of text in the control wraps to the next line, the <see cref="M:System.Windows.Forms.RichTextBox.GetLineFromCharIndex(System.Int32)" /> method returns 1 if the character at the specified character index has wrapped to the second physical line. If <see cref="P:System.Windows.Forms.TextBoxBase.WordWrap" /> is set to false, no portion of the line wraps to the next, and the method returns 0 for the specified character index. You can use this method to determine which line a specific character index is located within. For example, after calling the <see cref="M:System.Windows.Forms.RichTextBox.Find(System.String)" /> method to search for text, you can obtain the character index to where the search results are found. You can call this method with the character index returned by the <see cref="M:System.Windows.Forms.RichTextBox.Find(System.String)" /> method to determine which line the word was found.</para>
@@ -981,6 +1007,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the line number from the specified character position within the text of the <see cref="T:System.Windows.Forms.RichTextBox" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based line number in which the character index is located.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The character index position to search. </param>
       </Docs>
@@ -999,7 +1029,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method enables you to determine where in the control a specific character index is located. You can use this method for such tasks as displaying shortcut menu items or help information for a word in the control. For example, if you wanted to display a menu of options to the user when the user right clicks on a word in the control, you can use this method to determine the position of the word to properly display a <see cref="T:System.Windows.Forms.ContextMenu" /> control.</para>
@@ -1008,6 +1037,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the location within the control at the specified character index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The location of the specified character.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the character for which to retrieve the location. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/SaveFileDialog.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/SaveFileDialog.xml
index d7eb1b1c7ec..c313f1e77fc 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/SaveFileDialog.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/SaveFileDialog.xml
@@ -78,7 +78,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -89,6 +88,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens the file with read/write permission selected by the user.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The read/write file selected by the user.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Screen.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Screen.xml
index 1f85d9ca202..a58f970f0c6 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Screen.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Screen.xml
@@ -112,12 +112,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets or sets a value indicating whether the specified object is equal to this Screen.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified object is equal to this <see cref="T:System.Windows.Forms.Screen" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to this <see cref="T:System.Windows.Forms.Screen" />. </param>
       </Docs>
@@ -136,12 +139,15 @@
         <Parameter Name="control" Type="System.Windows.Forms.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a <see cref="T:System.Windows.Forms.Screen" /> for the display that contains the largest portion of the specified control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.Screen" /> for the display that contains the largest region of the specified control. In multiple display environments where no display contains the control, the display closest to the specified control is returned.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Control" /> for which to retrieve a <see cref="T:System.Windows.Forms.Screen" />. </param>
       </Docs>
@@ -160,12 +166,15 @@
         <Parameter Name="hwnd" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a <see cref="T:System.Windows.Forms.Screen" /> for the display that contains the largest portion of the object referred to by the specified handle.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.Screen" /> for the display that contains the largest region of the object. In multiple display environments where no display contains any portion of the specified window, the display closest to the object is returned.</para>
+        </returns>
         <param name="hwnd">
           <attribution license="cc4" from="Microsoft" modified="false" />The window handle for which to retrieve the <see cref="T:System.Windows.Forms.Screen" />. </param>
       </Docs>
@@ -184,12 +193,15 @@
         <Parameter Name="point" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a <see cref="T:System.Windows.Forms.Screen" /> for the display that contains the specified point.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.Screen" /> for the display that contains the point. In multiple display environments where no display contains the point, the display closest to the specified point is returned.</para>
+        </returns>
         <param name="point">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Point" /> that specifies the location for which to retrieve a <see cref="T:System.Windows.Forms.Screen" />. </param>
       </Docs>
@@ -208,12 +220,15 @@
         <Parameter Name="rect" Type="System.Drawing.Rectangle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a <see cref="T:System.Windows.Forms.Screen" /> for the display that contains the largest portion of the rectangle.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.Screen" /> for the display that contains the largest region of the specified rectangle. In multiple display environments where no display contains the rectangle, the display closest to the rectangle is returned.</para>
+        </returns>
         <param name="rect">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Rectangle" /> that specifies the area for which to retrieve the display. </param>
       </Docs>
@@ -232,12 +247,15 @@
         <Parameter Name="pt" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the bounds of the display that contains the specified point.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> that specifies the bounds of the display that contains the specified point. In multiple display environments where no display contains the specified point, the display closest to the point is returned.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Point" /> that specifies the coordinates for which to retrieve the display bounds. </param>
       </Docs>
@@ -256,12 +274,15 @@
         <Parameter Name="rect" Type="System.Drawing.Rectangle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the bounds of the display that contains the largest portion of the specified rectangle.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> that specifies the bounds of the display that contains the specified rectangle. In multiple display environments where no monitor contains the specified rectangle, the monitor closest to the rectangle is returned.</para>
+        </returns>
         <param name="rect">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Rectangle" /> that specifies the area for which to retrieve the display bounds. </param>
       </Docs>
@@ -280,12 +301,15 @@
         <Parameter Name="ctl" Type="System.Windows.Forms.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the bounds of the display that contains the largest portion of the specified control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> that specifies the bounds of the display that contains the specified control. In multiple display environments where no display contains the specified control, the display closest to the control is returned.</para>
+        </returns>
         <param name="ctl">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Control" /> for which to retrieve the display bounds. </param>
       </Docs>
@@ -302,7 +326,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method implements the <see cref="T:System.Object" /> method.</para>
@@ -311,6 +334,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes and retrieves a hash code for an object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for an object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -327,12 +354,15 @@
         <Parameter Name="pt" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the working area closest to the specified point. The working area is the desktop area of the display, excluding taskbars, docked windows, and docked tool bars.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> that specifies the working area. In multiple display environments where no display contains the specified point, the display closest to the point is returned.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Point" /> that specifies the coordinates for which to retrieve the working area. </param>
       </Docs>
@@ -351,12 +381,15 @@
         <Parameter Name="rect" Type="System.Drawing.Rectangle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the working area for the display that contains the largest portion of the specified rectangle. The working area is the desktop area of the display, excluding taskbars, docked windows, and docked tool bars.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> that specifies the working area. In multiple display environments where no display contains the specified rectangle, the display closest to the rectangle is returned.</para>
+        </returns>
         <param name="rect">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Rectangle" /> that specifies the area for which to retrieve the working area. </param>
       </Docs>
@@ -375,12 +408,15 @@
         <Parameter Name="ctl" Type="System.Windows.Forms.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the working area for the display that contains the largest region of the specified control. The working area is the desktop area of the display, excluding taskbars, docked windows, and docked tool bars.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> that specifies the working area. In multiple display environments where no display contains the specified control, the display closest to the control is returned.</para>
+        </returns>
         <param name="ctl">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Control" /> for which to retrieve the working area. </param>
       </Docs>
@@ -438,12 +474,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a string representing this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ScrollBar.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ScrollBar.xml
index bb698b2c7db..9b31f1cbb77 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ScrollBar.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ScrollBar.xml
@@ -502,7 +502,6 @@
         <Parameter Name="specified" Type="System.Windows.Forms.BoundsSpecified" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is a helper method that used by the <see cref="M:System.Windows.Forms.Control.ScaleControl(System.Drawing.SizeF,System.Windows.Forms.BoundsSpecified)" /> method to return the bounds that the control should be scaled by. You may override this method if you wish to reuse <see cref="M:System.Windows.Forms.Control.ScaleControl(System.Drawing.SizeF,System.Windows.Forms.BoundsSpecified)" /> scaling logic, but you need to supply your own bounds.</para>
@@ -511,6 +510,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the bounds to use when the <see cref="T:System.Windows.Forms.ScrollBar" /> is scaled by a specified amount.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> specifying the scaled bounds.</para>
+        </returns>
         <param name="bounds">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Rectangle" /> that specifies the initial bounds.</param>
         <param name="factor">
@@ -1092,7 +1095,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.ScrollBar.ToString" /> method returns a string that includes the type and the values for the <see cref="P:System.Windows.Forms.ScrollBar.Minimum" /> <see cref="P:System.Windows.Forms.ScrollBar.Minimum" />, and <see cref="P:System.Windows.Forms.ScrollBar.Value" /> properties.</para>
@@ -1101,6 +1103,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the <see cref="T:System.Windows.Forms.ScrollBar" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Windows.Forms.ScrollBar" />. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ScrollBarRenderer.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ScrollBarRenderer.xml
index 7b14da59069..9985089aaa2 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ScrollBarRenderer.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ScrollBarRenderer.xml
@@ -354,7 +354,6 @@
         <Parameter Name="state" Type="System.Windows.Forms.VisualStyles.ScrollBarState" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -365,6 +364,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the size of the sizing handle.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Size" /> that specifies the size of the sizing handle.</para>
+        </returns>
         <param name="g">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Graphics" /> this operation will use.</param>
         <param name="state">
@@ -385,7 +388,6 @@
         <Parameter Name="state" Type="System.Windows.Forms.VisualStyles.ScrollBarState" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -396,6 +398,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the size of the scroll box grip.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Size" /> that specifies the size of the scroll box grip.</para>
+        </returns>
         <param name="g">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Graphics" /> this operation will use.</param>
         <param name="state">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ScrollableControl.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ScrollableControl.xml
index 0f73e90a6d5..08f8c10d6af 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ScrollableControl.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ScrollableControl.xml
@@ -309,7 +309,6 @@
         <Parameter Name="bit" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following table describes the flags the <see cref="T:System.Windows.Forms.ScrollableControl" /> control uses.</para>
@@ -380,6 +379,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified flag has been set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified flag has been set; otherwise, false.</para>
+        </returns>
         <param name="bit">
           <attribution license="cc4" from="Microsoft" modified="false" />The flag to check.</param>
       </Docs>
@@ -850,7 +853,6 @@
         <Parameter Name="activeControl" Type="System.Windows.Forms.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.ScrollableControl.ScrollControlIntoView(System.Windows.Forms.Control)" /> method uses the <see cref="M:System.Windows.Forms.ScrollableControl.ScrollToControl(System.Windows.Forms.Control)" /> method to calculate how far it must scroll to display the specified control. The <see cref="P:System.Windows.Forms.Control.AutoScrollOffset" /> property of the child control is used to adjust the scrolled position.</para>
@@ -861,6 +863,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the scroll offset to the specified child control. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The upper-left hand <see cref="T:System.Drawing.Point" /> of the display area relative to the client area required to scroll the control into view.</para>
+        </returns>
         <param name="activeControl">
           <attribution license="cc4" from="Microsoft" modified="false" />The child control to scroll into view. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/SelectionRange.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/SelectionRange.xml
index 0d4d68c9d84..5a814395907 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/SelectionRange.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/SelectionRange.xml
@@ -142,7 +142,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.SelectionRange.ToString" /> method returns a string that includes the values for the <see cref="P:System.Windows.Forms.SelectionRange.Start" /> and <see cref="P:System.Windows.Forms.SelectionRange.End" /> properties.</para>
@@ -151,6 +150,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the <see cref="T:System.Windows.Forms.SelectionRange" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Windows.Forms.SelectionRange" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/SelectionRangeConverter.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/SelectionRangeConverter.xml
index 6069d811c08..90effe25664 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/SelectionRangeConverter.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/SelectionRangeConverter.xml
@@ -57,7 +57,6 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Windows.Forms.SelectionRangeConverter" /> class is specialized to convert between the types <see cref="T:System.String" /> and <see cref="T:System.Windows.Forms.SelectionRange" />. As a result, the <see cref="M:System.Windows.Forms.SelectionRangeConverter.CanConvertFrom(System.ComponentModel.ITypeDescriptorContext,System.Type)" /> method returns true if the <paramref name="sourceType" /> parameter is of type <see cref="T:System.String" />. Otherwise, it defers the call to the base implementation of this method, <see cref="M:System.ComponentModel.TypeConverter.CanConvertFrom(System.ComponentModel.ITypeDescriptorContext,System.Type)" />.</para>
@@ -66,6 +65,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if this converter can convert an object of the specified source type to the native type of the converter by querying the supplied type descriptor context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the converter can perform the specified conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="sourceType">
@@ -87,7 +90,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.SelectionRangeConverter.CanConvertTo(System.ComponentModel.ITypeDescriptorContext,System.Type)" /> method returns true if the <paramref name="destinationType" /> parameter is of type <see cref="T:System.String" /> or <see cref="T:System.ComponentModel.Design.Serialization.InstanceDescriptor" />. Otherwise, it defers the call to the base implementation of this method, <see cref="M:System.ComponentModel.TypeConverter.CanConvertTo(System.ComponentModel.ITypeDescriptorContext,System.Type)" />.</para>
@@ -96,6 +98,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this converter can convert an object to the specified destination type by using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the specified conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="destinationType">
@@ -118,7 +124,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.SelectionRangeConverter.ConvertFrom(System.ComponentModel.ITypeDescriptorContext,System.Globalization.CultureInfo,System.Object)" /> method is specialized to convert <see cref="T:System.String" /> values that represent a range of dates to their <see cref="T:System.Windows.Forms.SelectionRange" /> representations. Types other than <see cref="T:System.String" /> are passed to the base class implementation of this method.</para>
@@ -127,6 +132,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified value to the converter's native type by using the specified locale.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted <paramref name="value" />. </para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
@@ -152,7 +161,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.SelectionRangeConverter.ConvertTo(System.ComponentModel.ITypeDescriptorContext,System.Globalization.CultureInfo,System.Object,System.Type)" /> method is specialized to convert <see cref="T:System.Windows.Forms.SelectionRange" /> values to their <see cref="T:System.String" /> or <see cref="T:System.ComponentModel.Design.Serialization.InstanceDescriptor" /> representations. Other types are passed to the base class implementation of this method.</para>
@@ -161,6 +169,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.Windows.Forms.SelectionRangeConverter" /> object to another type by using the specified culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted <paramref name="value" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
@@ -186,7 +198,6 @@
         <Parameter Name="propertyValues" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="Overload:System.Windows.Forms.SelectionRangeConverter.CreateInstance" /> method to make changes to an existing immutable object by creating a modified version of it. This method expects the <paramref name="propertyValues" /> parameter to have elements with key values of Start and End, each with the corresponding <see cref="T:System.DateTime" /> value. </para>
@@ -195,6 +206,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Windows.Forms.SelectionRange" /> object by using the specified type descriptor and set of property values for that object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If successful, the newly created <see cref="T:System.Windows.Forms.SelectionRange" />; otherwise, this method throws an exception.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="propertyValues">
@@ -215,7 +230,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default implementation always returns true.</para>
@@ -224,6 +238,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if changing a value on an instance should require a call to <see cref="Overload:System.Windows.Forms.SelectionRangeConverter.CreateInstance" /> to create a new value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <see cref="Overload:System.Windows.Forms.SelectionRangeConverter.CreateInstance" /> must be called to make a change to one or more properties; otherwise false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
@@ -244,7 +262,6 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default implementation of this method does not use the <paramref name="context" /> or <paramref name="value" /> parameters, but simply refers the call to the TypeDescriptor.<see cref="M:System.ComponentModel.TypeDescriptor.GetProperties(System.Type,System.Attribute[])" /> method.</para>
@@ -253,6 +270,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the set of filtered properties for the <see cref="T:System.Windows.Forms.SelectionRange" /> type </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If successful, the set of properties that should be exposed for the <see cref="T:System.Windows.Forms.SelectionRange" /> type; otherwise, null.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="value">
@@ -275,7 +296,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default implementation always returns true.</para>
@@ -284,6 +304,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current object supports properties that use the specified type descriptor context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <see cref="Overload:System.Windows.Forms.SelectionRangeConverter.GetProperties" /> can be called to find the properties of a <see cref="T:System.Windows.Forms.SelectionRange" /> object; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/SplitContainer.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/SplitContainer.xml
index e9253a017d4..3e4437e0a97 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/SplitContainer.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/SplitContainer.xml
@@ -577,12 +577,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the control collection for the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.Windows.Forms.Control.ControlCollection" /> assigned to the control.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DefaultSize">
@@ -1348,7 +1351,6 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called during message preprocessing to handle dialog box key characters, such as TAB, LEFT ARROW, RIGHT ARROW, UP ARROW, and DOWN ARROW. Keys that include the ALT or CONTROL modifiers are not handled. This method is called only if the <see cref="M:System.Windows.Forms.Control.IsInputKey(System.Windows.Forms.Keys)" /> method indicates that the control is not processing the key. The <see cref="M:System.Windows.Forms.Control.ProcessDialogKey(System.Windows.Forms.Keys)" /> simply sends the character to the parent's <see cref="M:System.Windows.Forms.Control.ProcessDialogKey(System.Windows.Forms.Keys)" /> method, or returns false if the control has no parent. The <see cref="T:System.Windows.Forms.Form" /> class overrides this method to perform actual processing of dialog box keys. The run time calls this method only when the control is hosted in a Windows Forms application or as an ActiveX control.</para>
@@ -1357,6 +1359,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a dialog box key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key was processed by the control; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.Keys" /> values that represents the key to process. </param>
       </Docs>
@@ -1374,7 +1380,6 @@
         <Parameter Name="forward" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -1401,6 +1406,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Selects the next available control and makes it the active control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a control is selected; otherwise, false.</para>
+        </returns>
         <param name="forward">
           <attribution license="cc4" from="Microsoft" modified="false" />true to cycle forward through the controls in the <see cref="T:System.Windows.Forms.ContainerControl" />; otherwise, false. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Splitter.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Splitter.xml
index 205bfc665b6..8d2bbeaa7b6 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Splitter.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Splitter.xml
@@ -1178,7 +1178,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.Splitter.ToString" /> method returns a string that includes the type and the values for the <see cref="P:System.Windows.Forms.Splitter.MinSize" /> and <see cref="P:System.Windows.Forms.Splitter.MinExtra" /> properties.</para>
@@ -1187,6 +1186,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the <see cref="T:System.Windows.Forms.Splitter" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Windows.Forms.Splitter" />. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/StatusBar.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/StatusBar.xml
index 2b129bdcfec..cb347c42b81 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/StatusBar.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/StatusBar.xml
@@ -970,12 +970,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation for this control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>String </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/StatusBarPanel.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/StatusBarPanel.xml
index 7f92a43293f..1ef2c2dfd64 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/StatusBarPanel.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/StatusBarPanel.xml
@@ -567,12 +567,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a string that contains information about the panel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a string that contains the class name for the control and the text it contains.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/StatusStrip.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/StatusStrip.xml
index febea1ea918..005d542641f 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/StatusStrip.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/StatusStrip.xml
@@ -105,7 +105,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you do not explicitly call the <see cref="M:System.Windows.Forms.StatusStrip.CreateAccessibilityInstance" /> method, it will be called when the <see cref="P:System.Windows.Forms.Control.AccessibilityObject" /> property is referenced.</para>
@@ -117,6 +116,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessibility object for the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.AccessibleObject" /> for the control.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateDefaultItem">
@@ -134,7 +137,6 @@
         <Parameter Name="onClick" Type="System.EventHandler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Windows.Forms.StatusStrip.CreateDefaultItem(System.String,System.Drawing.Image,System.EventHandler)" /> method to add a <see cref="T:System.Windows.Forms.ToolStripStatusLabel" /> with commonly used characteristics to a <see cref="T:System.Windows.Forms.StatusStrip" />.</para>
@@ -143,6 +145,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a default <see cref="T:System.Windows.Forms.ToolStripStatusLabel" /> with the specified text, image, and event handler on a new <see cref="T:System.Windows.Forms.StatusStrip" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="M:System.Windows.Forms.ToolStripStatusLabel.#ctor(System.String,System.Drawing.Image,System.EventHandler)" />, or a <see cref="T:System.Windows.Forms.ToolStripSeparator" /> if the <paramref name="text" /> parameter is a hyphen (-).</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to use for the <see cref="T:System.Windows.Forms.ToolStripStatusLabel" />. If the <paramref name="text" /> parameter is a hyphen (-), this method creates a <see cref="T:System.Windows.Forms.ToolStripSeparator" />.</param>
         <param name="image">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TabControl.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TabControl.xml
index c961ca683d4..7638d460187 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TabControl.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TabControl.xml
@@ -351,12 +351,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member overrides <see cref="M:System.Windows.Forms.Control.CreateControlsInstance" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.Windows.Forms.Control.ControlCollection" /> assigned to the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -765,12 +768,15 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Windows.Forms.TabPage" /> control at the specified location.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.TabPage" /> at the specified location.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the <see cref="T:System.Windows.Forms.TabPage" /> to get.</param>
       </Docs>
@@ -787,12 +793,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of <see cref="T:System.Windows.Forms.TabPage" /> controls that belong to the <see cref="T:System.Windows.Forms.TabControl" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Windows.Forms.TabPage" /> controls that belong to the <see cref="T:System.Windows.Forms.TabControl" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -809,12 +818,15 @@
         <Parameter Name="baseType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the <see cref="T:System.Windows.Forms.TabPage" /> controls in the <see cref="T:System.Windows.Forms.TabControl" /> to an array of the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.TabPage" /> controls that belong to the <see cref="T:System.Windows.Forms.TabControl" /> as an array of the specified type.</para>
+        </returns>
         <param name="baseType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the array to create.</param>
       </Docs>
@@ -833,12 +845,15 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the bounding rectangle for a specified tab in this tab control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> that represents the bounds of the specified tab.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the tab you want. </param>
       </Docs>
@@ -857,12 +872,15 @@
         <Parameter Name="item" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the ToolTip for the specified <see cref="T:System.Windows.Forms.TabPage" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The ToolTip text.</para>
+        </returns>
         <param name="item">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.TabPage" /> that owns the desired ToolTip.</param>
       </Docs>
@@ -938,7 +956,6 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this method during window-message preprocessing to determine whether the specified key is a regular input key that should be sent directly to the tab control or a special key (such as PAGE UP and PAGE DOWN) that should preprocessed. In the latter case, send the key to the control only if it is not consumed by the preprocessing phase.</para>
@@ -947,6 +964,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified key is a regular input key or a special key that requires preprocessing.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified key is a regular input key; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.Keys" /> values. </param>
       </Docs>
@@ -2079,7 +2100,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The string includes the type and the <see cref="P:System.Windows.Forms.TabControl.TabPageCollection.Count" /> property of the control. If there is at least one <see cref="T:System.Windows.Forms.TabPage" /> control on the <see cref="T:System.Windows.Forms.TabControl" />, this method returns a string that includes the string returned by the <see cref="M:System.Windows.Forms.TabPage.ToString" /> method for the first <see cref="T:System.Windows.Forms.TabPage" />.</para>
@@ -2088,6 +2108,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the <see cref="T:System.Windows.Forms.TabControl" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Windows.Forms.TabControl" />. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TabPage.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TabPage.xml
index efe6782d6f2..42f13b98a91 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TabPage.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TabPage.xml
@@ -374,12 +374,15 @@
         <Parameter Name="comp" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the tab page that contains the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.TabPage" /> that contains the specified object, or null if the object cannot be found.</para>
+        </returns>
         <param name="comp">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to look for. </param>
       </Docs>
@@ -931,12 +934,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string containing the value of the <see cref="P:System.Windows.Forms.TabPage.Text" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the value of the <see cref="P:System.Windows.Forms.TabPage.Text" /> property.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TableLayoutColumnStyleCollection.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TableLayoutColumnStyleCollection.xml
index 2ed89c424e8..88547b50603 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TableLayoutColumnStyleCollection.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TableLayoutColumnStyleCollection.xml
@@ -33,7 +33,6 @@
         <Parameter Name="columnStyle" Type="System.Windows.Forms.ColumnStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.TableLayoutColumnStyleCollection.Add(System.Windows.Forms.ColumnStyle)" /> method reapplies the table layout to all the controls in the current <see cref="T:System.Windows.Forms.TableLayoutPanel" /> container. </para>
@@ -43,6 +42,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an item to the <see cref="T:System.Windows.Forms.TableLayoutColumnStyleCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position into which the new element was inserted.</para>
+        </returns>
         <param name="columnStyle">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.ColumnStyle" /> to add to the <see cref="T:System.Windows.Forms.TableLayoutColumnStyleCollection" />.</param>
       </Docs>
@@ -60,12 +63,15 @@
         <Parameter Name="columnStyle" Type="System.Windows.Forms.ColumnStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Windows.Forms.ColumnStyle" /> is in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Windows.Forms.ColumnStyle" /> is found in the <see cref="T:System.Windows.Forms.TableLayoutColumnStyleCollection" />; otherwise, false.</para>
+        </returns>
         <param name="columnStyle">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.ColumnStyle" /> to locate in the <see cref="T:System.Windows.Forms.TableLayoutColumnStyleCollection" />. The value can be null.</param>
       </Docs>
@@ -83,7 +89,6 @@
         <Parameter Name="columnStyle" Type="System.Windows.Forms.ColumnStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.TableLayoutColumnStyleCollection.IndexOf(System.Windows.Forms.ColumnStyle)" /> method begins searching at the first element of the <see cref="T:System.Windows.Forms.TableLayoutColumnStyleCollection" /> and ends either when it finds a match or it reaches the last element.</para>
@@ -92,6 +97,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of a specific item in the <see cref="T:System.Windows.Forms.TableLayoutColumnStyleCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of <paramref name="columnStyle" /> if found in the <see cref="T:System.Windows.Forms.TableLayoutColumnStyleCollection" />; otherwise, -1.</para>
+        </returns>
         <param name="columnStyle">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.ColumnStyle" /> to locate in the <see cref="T:System.Windows.Forms.TableLayoutColumnStyleCollection" />.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TableLayoutPanel.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TableLayoutPanel.xml
index 55c429c8dba..5731329d70f 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TableLayoutPanel.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TableLayoutPanel.xml
@@ -268,12 +268,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the control collection for the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.Windows.Forms.Control.ControlCollection" /> assigned to the control.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetCellPosition">
@@ -300,12 +303,15 @@
         <Parameter Name="control" Type="System.Windows.Forms.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Windows.Forms.TableLayoutPanelCellPosition" /> that represents the row and the column of the cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.TableLayoutPanelCellPosition" /> that represents the cell position.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />A control contained within a cell.</param>
       </Docs>
@@ -334,7 +340,6 @@
         <Parameter Name="control" Type="System.Windows.Forms.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="control" /> spans two or more columns, the <see cref="M:System.Windows.Forms.TableLayoutPanel.GetColumn(System.Windows.Forms.Control)" /> method will return the lowest column index.</para>
@@ -347,6 +352,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the column position of the specified child control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The column position of the specified child control, or -1 if the position of <paramref name="control" /> is determined by <see cref="P:System.Windows.Forms.TableLayoutPanel.LayoutEngine" />.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />A child control of the <see cref="T:System.Windows.Forms.TableLayoutPanel" />.</param>
       </Docs>
@@ -372,7 +381,6 @@
         <Parameter Name="control" Type="System.Windows.Forms.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Column spanning is often useful for positioning a control that is considerably wider than its peers.</para>
@@ -382,6 +390,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of columns spanned by the specified child control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of columns spanned by the child control. The default is 1.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />A child control of the <see cref="T:System.Windows.Forms.TableLayoutPanel" />.</param>
       </Docs>
@@ -405,12 +417,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array representing the widths, in pixels, of the columns in the <see cref="T:System.Windows.Forms.TableLayoutPanel" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Int32" /> that contains the widths, in pixels, of the columns in the <see cref="T:System.Windows.Forms.TableLayoutPanel" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetControlFromPosition">
@@ -427,7 +442,6 @@
         <Parameter Name="row" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The column and row position values are zero based. </para>
@@ -436,6 +450,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the child control occupying the specified position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The child control occupying the specified cell; otherwise, null if no control exists at the specified column and row, or if the control has its <see cref="P:System.Windows.Forms.Control.Visible" /> property set to false.</para>
+        </returns>
         <param name="column">
           <attribution license="cc4" from="Microsoft" modified="false" />The column position of the control to retrieve.</param>
         <param name="row">
@@ -455,7 +473,6 @@
         <Parameter Name="control" Type="System.Windows.Forms.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.TableLayoutPanel.GetPositionFromControl(System.Windows.Forms.Control)" /> method returns the actual current position of <paramref name="control" />, even if its position is determined by the <see cref="P:System.Windows.Forms.TableLayoutPanel.LayoutEngine" />. This method takes into account the entire <see cref="T:System.Windows.Forms.TableLayoutPanel" /> control state, including column or row spanning and when the <see cref="P:System.Windows.Forms.TableLayoutPanel.LayoutEngine" /> has placed a control with its Column and Row properties set to -1. This is equivalent to the situation in which <see cref="M:System.Windows.Forms.TableLayoutPanel.GetColumn(System.Windows.Forms.Control)" /> and <see cref="M:System.Windows.Forms.TableLayoutPanel.GetRow(System.Windows.Forms.Control)" /> return -1. </para>
@@ -464,6 +481,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Windows.Forms.TableLayoutPanelCellPosition" /> that represents the row and the column of the cell that contains the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.TableLayoutPanelCellPosition" /> that represents the cell position.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />A control contained within a cell.</param>
       </Docs>
@@ -492,7 +513,6 @@
         <Parameter Name="control" Type="System.Windows.Forms.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="control" /> spans two or more rows, the <see cref="M:System.Windows.Forms.TableLayoutPanel.GetRow(System.Windows.Forms.Control)" /> method will return the lowest row index.</para>
@@ -504,6 +524,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the row position of the specified child control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The row position of <paramref name="control" />, or -1 if the position of <paramref name="control" /> is determined by <see cref="P:System.Windows.Forms.TableLayoutPanel.LayoutEngine" />.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />A child control of the <see cref="T:System.Windows.Forms.TableLayoutPanel" />.</param>
       </Docs>
@@ -527,12 +551,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array representing the heights, in pixels, of the rows in the <see cref="T:System.Windows.Forms.TableLayoutPanel" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Int32" /> that contains the heights, in pixels, of the rows in the <see cref="T:System.Windows.Forms.TableLayoutPanel" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetRowSpan">
@@ -556,7 +583,6 @@
         <Parameter Name="control" Type="System.Windows.Forms.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Row spanning is often useful for positioning a control that is considerably taller than its peers.</para>
@@ -566,6 +592,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of rows spanned by the specified child control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows spanned by the child control. The default is 1.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />A child control of the <see cref="T:System.Windows.Forms.TableLayoutPanel" />.</param>
       </Docs>
@@ -1012,7 +1042,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.TableLayoutPanel" /> instance is cast to an <see cref="T:System.ComponentModel.IExtenderProvider" /> interface.</para>
@@ -1021,6 +1050,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ComponentModel.IExtenderProvider.CanExtend(System.Object)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this object can provide extender properties to the specified object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to receive the extender properties.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TableLayoutPanelCellPosition.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TableLayoutPanelCellPosition.xml
index 3fe1b26e2c6..8598252635f 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TableLayoutPanelCellPosition.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TableLayoutPanelCellPosition.xml
@@ -75,12 +75,15 @@
         <Parameter Name="other" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Specifies whether this <see cref="T:System.Windows.Forms.TableLayoutPanelCellPosition" /> contains the same row and column as the specified <see cref="T:System.Windows.Forms.TableLayoutPanelCellPosition" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="other" /> is a <see cref="T:System.Windows.Forms.TableLayoutPanelCellPosition" /> and has the same row and column as the specified <see cref="T:System.Windows.Forms.TableLayoutPanelCellPosition" />; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.TableLayoutPanelCellPosition" /> to test.</param>
       </Docs>
@@ -96,12 +99,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash code for this <see cref="T:System.Windows.Forms.TableLayoutPanelCellPosition" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer value that specifies a hash value for this <see cref="T:System.Windows.Forms.TableLayoutPanelCellPosition" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="op_Equality">
@@ -118,12 +124,15 @@
         <Parameter Name="p2" Type="System.Windows.Forms.TableLayoutPanelCellPosition" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Windows.Forms.TableLayoutPanelCellPosition" /> objects. The result specifies whether the values of the <see cref="P:System.Windows.Forms.TableLayoutPanelCellPosition.Row" /> and <see cref="P:System.Windows.Forms.TableLayoutPanelCellPosition.Column" /> properties of the two <see cref="T:System.Windows.Forms.TableLayoutPanelCellPosition" /> objects are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="p1" /> and <paramref name="p2" /> are equal; otherwise, false.</para>
+        </returns>
         <param name="p1">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.TableLayoutPanelCellPosition" /> to compare.</param>
         <param name="p2">
@@ -144,12 +153,15 @@
         <Parameter Name="p2" Type="System.Windows.Forms.TableLayoutPanelCellPosition" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Windows.Forms.TableLayoutPanelCellPosition" /> objects. The result specifies whether the values of the <see cref="P:System.Windows.Forms.TableLayoutPanelCellPosition.Row" /> and <see cref="P:System.Windows.Forms.TableLayoutPanelCellPosition.Column" /> properties of the two <see cref="T:System.Windows.Forms.TableLayoutPanelCellPosition" /> objects are unequal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="p1" /> and <paramref name="p2" /> differ; otherwise, false.</para>
+        </returns>
         <param name="p1">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.TableLayoutPanelCellPosition" /> to compare.</param>
         <param name="p2">
@@ -185,12 +197,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Windows.Forms.TableLayoutPanelCellPosition" /> to a human readable string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents this <see cref="T:System.Windows.Forms.TableLayoutPanelCellPosition" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TableLayoutRowStyleCollection.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TableLayoutRowStyleCollection.xml
index 8d76b944213..30d4232677f 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TableLayoutRowStyleCollection.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TableLayoutRowStyleCollection.xml
@@ -33,7 +33,6 @@
         <Parameter Name="rowStyle" Type="System.Windows.Forms.RowStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.TableLayoutRowStyleCollection.Add(System.Windows.Forms.RowStyle)" /> method reapplies the table layout to all the controls in the current <see cref="T:System.Windows.Forms.TableLayoutPanel" /> container.</para>
@@ -43,6 +42,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new <see cref="T:System.Windows.Forms.RowStyle" /> to the <see cref="T:System.Windows.Forms.TableLayoutRowStyleCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position into which the new element was inserted.</para>
+        </returns>
         <param name="rowStyle">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.RowStyle" /> to add to the <see cref="T:System.Windows.Forms.TableLayoutRowStyleCollection" />.</param>
       </Docs>
@@ -60,12 +63,15 @@
         <Parameter Name="rowStyle" Type="System.Windows.Forms.RowStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Windows.Forms.TableLayoutRowStyleCollection" /> contains a specific style.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Windows.Forms.RowStyle" /> is found in the <see cref="T:System.Windows.Forms.TableLayoutRowStyleCollection" />; otherwise, false.</para>
+        </returns>
         <param name="rowStyle">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.RowStyle" /> to locate in the <see cref="T:System.Windows.Forms.TableLayoutRowStyleCollection" />.</param>
       </Docs>
@@ -83,7 +89,6 @@
         <Parameter Name="rowStyle" Type="System.Windows.Forms.RowStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.TableLayoutRowStyleCollection.IndexOf(System.Windows.Forms.RowStyle)" /> method begins searching at the first element of the <see cref="T:System.Windows.Forms.TableLayoutRowStyleCollection" /> and ends either when it finds a match or it reaches the last element.</para>
@@ -92,6 +97,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of a specific item in the <see cref="T:System.Windows.Forms.TableLayoutRowStyleCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of <paramref name="rowStyle" /> if found in the <see cref="T:System.Windows.Forms.TableLayoutRowStyleCollection" />; otherwise, -1.</para>
+        </returns>
         <param name="rowStyle">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.RowStyle" /> to locate in the <see cref="T:System.Windows.Forms.TableLayoutRowStyleCollection" />.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TableLayoutSettings.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TableLayoutSettings.xml
index 059eb0e4e36..b4fce711c77 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TableLayoutSettings.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TableLayoutSettings.xml
@@ -109,12 +109,15 @@
         <Parameter Name="control" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Windows.Forms.TableLayoutPanelCellPosition" /> that represents the row and the column of the cell.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.TableLayoutPanelCellPosition" /> that represents the cell position.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />A control contained within a cell.</param>
       </Docs>
@@ -137,12 +140,15 @@
         <Parameter Name="control" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the column position of the specified child control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The column position of the specified child control.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />A control contained within a cell.</param>
       </Docs>
@@ -160,12 +166,15 @@
         <Parameter Name="control" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the number of columns that the cell containing the child control spans.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of columns that the cell containing the child control spans.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />A control contained within a cell.</param>
       </Docs>
@@ -188,12 +197,15 @@
         <Parameter Name="control" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the row position of the specified child control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The row position of the specified child control.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />A control contained within a cell.</param>
       </Docs>
@@ -211,12 +223,15 @@
         <Parameter Name="control" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the number of rows that the cell containing the child control spans.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows that the cell containing the child control spans.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />A control contained within a cell.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TableLayoutStyleCollection.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TableLayoutStyleCollection.xml
index b49b3801b34..5fef7453748 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TableLayoutStyleCollection.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TableLayoutStyleCollection.xml
@@ -51,7 +51,6 @@
         <Parameter Name="style" Type="System.Windows.Forms.TableLayoutStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.TableLayoutStyleCollection.Add(System.Windows.Forms.TableLayoutStyle)" /> method reapplies the table layout to all the controls in the current <see cref="T:System.Windows.Forms.TableLayoutPanel" /> container. </para>
@@ -61,6 +60,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new <see cref="T:System.Windows.Forms.TableLayoutStyle" /> to the end of the current collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position into which the new element was inserted.</para>
+        </returns>
         <param name="style">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.TableLayoutStyle" /> to add to the <see cref="T:System.Windows.Forms.TableLayoutStyleCollection" />.</param>
       </Docs>
@@ -242,7 +245,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.TableLayoutStyleCollection" /> instance is cast to an <see cref="T:System.Collections.IEnumerable" /> interface.</para>
@@ -251,6 +253,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this method, see the <see cref="M:System.Collections.IEnumerable.GetEnumerator" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Add">
@@ -266,7 +272,6 @@
         <Parameter Name="style" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.TableLayoutStyleCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -275,6 +280,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this method, see the <see cref="M:System.Collections.IList.Add(System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position into which <paramref name="style" /> was inserted.</para>
+        </returns>
         <param name="style">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to add to the <see cref="T:System.Collections.IList" />.</param>
       </Docs>
@@ -292,7 +301,6 @@
         <Parameter Name="style" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.TableLayoutStyleCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -301,6 +309,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this method, see the <see cref="M:System.Collections.IList.Contains(System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="style" /> is found in the <see cref="T:System.Collections.IList" />; otherwise, false.</para>
+        </returns>
         <param name="style">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the <see cref="T:System.Collections.IList" />.</param>
       </Docs>
@@ -318,7 +330,6 @@
         <Parameter Name="style" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.TableLayoutStyleCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -327,6 +338,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this method, see the <see cref="M:System.Collections.IList.IndexOf(System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of <paramref name="style" /> if found in the list; otherwise, -1.</para>
+        </returns>
         <param name="style">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the <see cref="T:System.Collections.IList" />.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TextBox.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TextBox.xml
index df0c7cbe54b..cbdfedfd288 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TextBox.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TextBox.xml
@@ -301,7 +301,6 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.TextBox.IsInputKey(System.Windows.Forms.Keys)" /> method returns true when <paramref name="keyData" /> includes the <see cref="F:System.Windows.Forms.Keys.Return" /> value and the <see cref="P:System.Windows.Forms.TextBox.AcceptsReturn" /> property is true.</para>
@@ -310,6 +309,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified key is an input key or a special key that requires preprocessing.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified key is an input key; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the key's values.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TextBoxBase.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TextBoxBase.xml
index b5ee85588af..2e3588ea41e 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TextBoxBase.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TextBoxBase.xml
@@ -707,7 +707,6 @@
         <Parameter Name="pt" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the location specified in the <paramref name="pt" /> parameter is outside the client area of the control, the first character of the string closest to the point specified in <paramref name="pt" /> is returned. You can use this method to determine which characters are located near a specific point within the control. You can then use this value to perform operations on the text at that location.</para>
@@ -719,6 +718,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the character that is closest to the specified location within the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The character at the specified location.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />The location from which to seek the nearest character. </param>
       </Docs>
@@ -736,7 +739,6 @@
         <Parameter Name="pt" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns the character index that is closest to the position specified in the <paramref name="pt" /> parameter. The character index is a zero-based index of text in the control, including spaces. You can use this method to determine where in the text the user has the mouse over by passing the mouse coordinates to this method. This can be useful if you want to perform tasks when the user rests the mouse pointer over a word in the text of the control.</para>
@@ -748,6 +750,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the index of the character nearest to the specified location.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based character index at the specified location.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />The location to search. </param>
       </Docs>
@@ -765,7 +771,6 @@
         <Parameter Name="lineNumber" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Line numbering in the text box starts at zero. If the <paramref name="lineNumber" /> parameter is greater than the last line in the text box, <see cref="M:System.Windows.Forms.TextBoxBase.GetFirstCharIndexFromLine(System.Int32)" /> returns -1.</para>
@@ -776,6 +781,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the index of the first character of a given line.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first character in the specified line.</para>
+        </returns>
         <param name="lineNumber">
           <attribution license="cc4" from="Microsoft" modified="false" />The line for which to get the index of its first character. </param>
       </Docs>
@@ -791,12 +800,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the index of the first character of the current line.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based character index in the current line.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetLineFromCharIndex">
@@ -812,7 +824,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method enables you to determine the line number based on the character index specified in the <paramref name="index" /> parameter of the method. The first line of text in the control returns the value zero. The <see cref="M:System.Windows.Forms.TextBoxBase.GetLineFromCharIndex(System.Int32)" /> method returns the physical line number where the indexed character is located within the control. For example, if a portion of the first logical line of text in the control wraps to the next line, the <see cref="M:System.Windows.Forms.TextBoxBase.GetLineFromCharIndex(System.Int32)" /> method returns 1 if the character at the specified character index has wrapped to the second physical line. If <see cref="P:System.Windows.Forms.TextBoxBase.WordWrap" /> is set to false, no portion of the line wraps to the next, and the method returns 0 for the specified character index. You can use this method to determine which line a specific character index is located within. For example, after calling the <see cref="M:System.Windows.Forms.RichTextBox.Find(System.String)" /> method to search for text, you can obtain the character index to where the search results are found. You can call this method with the character index returned by the <see cref="M:System.Windows.Forms.RichTextBox.Find(System.String)" /> method to determine which line the word was found.</para>
@@ -824,6 +835,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the line number from the specified character position within the text of the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based line number in which the character index is located.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The character index position to search. </param>
       </Docs>
@@ -841,7 +856,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method enables you to determine where in the control a specific character index is located. You can use this method for such tasks as displaying shortcut menu items or help information for a word in the control. For example, if you wanted to display a menu of options to the user when the user right clicks on a word in the control, you can use this method to determine the position of the word to properly display a <see cref="T:System.Windows.Forms.ContextMenu" /> control.</para>
@@ -850,6 +864,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the location within the control at the specified character index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The location of the specified character within the client rectangle of the control.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the character for which to retrieve the location. </param>
       </Docs>
@@ -913,7 +931,6 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.TextBoxBase.IsInputKey(System.Windows.Forms.Keys)" /> method returns true when the <paramref name="keyData" /> parameter includes the <see cref="F:System.Windows.Forms.Keys.Tab" /> value and the <see cref="P:System.Windows.Forms.TextBoxBase.AcceptsTab" /> property is true. <see cref="M:System.Windows.Forms.TextBoxBase.IsInputKey(System.Windows.Forms.Keys)" /> returns false if <paramref name="keyData" /> contains both <see cref="F:System.Windows.Forms.Keys.Tab" /> and <see cref="F:System.Windows.Forms.Keys.Control" />. </para>
@@ -922,6 +939,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified key is an input key or a special key that requires preprocessing.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified key is an input key; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the Keys value.</param>
       </Docs>
@@ -1664,8 +1685,11 @@
       <Docs>
         <param name="keyData">To be added.</param>
         <summary>To be added.</summary>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key was processed by the control; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -2078,12 +2102,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the <see cref="T:System.Windows.Forms.TextBoxBase" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Windows.Forms.TextBoxBase" />. The string includes the type and the <see cref="T:System.Windows.Forms.TextBoxBase" /> property of the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TextRenderer.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TextRenderer.xml
index 1ac3b418ae8..b67b14f27fb 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TextRenderer.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TextRenderer.xml
@@ -390,7 +390,6 @@
         <Parameter Name="font" Type="System.Drawing.Font" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -400,6 +399,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides the size, in pixels, of the specified text when drawn with the specified font.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Size" />, in pixels, of <paramref name="text" /> drawn on a single line with the specified <paramref name="font" />. You can manipulate how the text is drawn by using one of the <see cref="M:System.Windows.Forms.TextRenderer.DrawText(System.Drawing.IDeviceContext,System.String,System.Drawing.Font,System.Drawing.Rectangle,System.Drawing.Color,System.Windows.Forms.TextFormatFlags)" /> overloads that takes a <see cref="T:System.Windows.Forms.TextFormatFlags" /> parameter. For example, the default behavior of the <see cref="T:System.Windows.Forms.TextRenderer" /> is to add padding to the bounding rectangle of the drawn text to accommodate overhanging glyphs. If you need to draw a line of text without these extra spaces you should use the versions of <see cref="M:System.Windows.Forms.TextRenderer.DrawText(System.Drawing.IDeviceContext,System.String,System.Drawing.Font,System.Drawing.Point,System.Drawing.Color)" /> and <see cref="M:System.Windows.Forms.TextRenderer.MeasureText(System.Drawing.IDeviceContext,System.String,System.Drawing.Font)" /> that take a <see cref="T:System.Drawing.Size" /> and <see cref="T:System.Windows.Forms.TextFormatFlags" /> parameter. For an example, see <see cref="M:System.Windows.Forms.TextRenderer.MeasureText(System.Drawing.IDeviceContext,System.String,System.Drawing.Font,System.Drawing.Size,System.Windows.Forms.TextFormatFlags)" />.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to measure.</param>
         <param name="font">
@@ -424,7 +427,6 @@
         <Parameter Name="font" Type="System.Drawing.Font" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.TextRenderer.MeasureText(System.Drawing.IDeviceContext,System.String,System.Drawing.Font)" /> method requires that the text is drawn on a single line. </para>
@@ -433,6 +435,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides the size, in pixels, of the specified text drawn with the specified font in the specified device context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Size" />, in pixels, of <paramref name="text" /> drawn in a single line with the specified <paramref name="font" /> in the specified device context.</para>
+        </returns>
         <param name="dc">
           <attribution license="cc4" from="Microsoft" modified="false" />The device context in which to measure the text.</param>
         <param name="text">
@@ -456,7 +462,6 @@
         <Parameter Name="proposedSize" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.TextRenderer.MeasureText(System.String,System.Drawing.Font,System.Drawing.Size)" /> method uses the <paramref name="proposedSize" /> parameter to indicate the relationship of height to width when determining the text size. When measuring text on a single line, if the <paramref name="proposedSize" /> parameter represents a <see cref="T:System.Drawing.Size" /> with a height dimension greater than <see cref="F:System.Int32.MaxValue" />, the returned <see cref="T:System.Drawing.Size" /> will be adjusted to reflect the actual height of the text.</para>
@@ -465,6 +470,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides the size, in pixels, of the specified text when drawn with the specified font, using the specified size to create an initial bounding rectangle.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Size" />, in pixels, of <paramref name="text" /> drawn with the specified <paramref name="font" />.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to measure.</param>
         <param name="font">
@@ -489,7 +498,6 @@
         <Parameter Name="proposedSize" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.TextRenderer.MeasureText(System.Drawing.IDeviceContext,System.String,System.Drawing.Font,System.Drawing.Size)" /> method uses the <paramref name="proposedSize" /> parameter to indicate the relationship of height to width when determining the text size. When measuring text on a single line, if the <paramref name="proposedSize" /> parameter represents a <see cref="T:System.Drawing.Size" /> with a height dimension greater than <see cref="F:System.Int32.MaxValue" />, the returned <see cref="T:System.Drawing.Size" /> will be adjusted to reflect the actual height of the text.</para>
@@ -498,6 +506,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides the size, in pixels, of the specified text when drawn with the specified font in the specified device context, using the specified size to create an initial bounding rectangle for the text.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Size" />, in pixels, of <paramref name="text" /> drawn with the specified <paramref name="font" />.</para>
+        </returns>
         <param name="dc">
           <attribution license="cc4" from="Microsoft" modified="false" />The device context in which to measure the text.</param>
         <param name="text">
@@ -521,7 +533,6 @@
         <Parameter Name="flags" Type="System.Windows.Forms.TextFormatFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -536,6 +547,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides the size, in pixels, of the specified text when drawn with the specified font and formatting instructions, using the specified size to create the initial bounding rectangle for the text.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Size" />, in pixels, of <paramref name="text" /> drawn with the specified <paramref name="font" /> and format.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to measure.</param>
         <param name="font">
@@ -566,7 +581,6 @@
         <Parameter Name="flags" Type="System.Windows.Forms.TextFormatFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.TextRenderer.MeasureText(System.Drawing.IDeviceContext,System.String,System.Drawing.Font,System.Drawing.Size,System.Windows.Forms.TextFormatFlags)" /> method uses the <paramref name="proposedSize" /> and <paramref name="flags" /> parameters to indicate the relationship of height to width when determining the text size. When measuring text on a single line, if the <paramref name="proposedSize" /> parameter represents a <see cref="T:System.Drawing.Size" /> with a height dimension greater than <see cref="F:System.Int32.MaxValue" />, the returned <see cref="T:System.Drawing.Size" /> will be adjusted to reflect the actual height of the text.</para>
@@ -576,6 +590,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides the size, in pixels, of the specified text when drawn with the specified device context, font, and formatting instructions, using the specified size to create the initial bounding rectangle for the text.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Size" />, in pixels, of <paramref name="text" /> drawn with the specified <paramref name="font" /> and format.</para>
+        </returns>
         <param name="dc">
           <attribution license="cc4" from="Microsoft" modified="false" />The device context in which to measure the text.</param>
         <param name="text">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Timer.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Timer.xml
index 5e1d63e557c..ad67f1ed33a 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Timer.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/Timer.xml
@@ -304,7 +304,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.Timer.ToString" /> method returns a string that includes the value of the <see cref="P:System.Windows.Forms.Timer.Interval" /> property.</para>
@@ -313,6 +312,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the <see cref="T:System.Windows.Forms.Timer" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Windows.Forms.Timer" />. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolBar.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolBar.xml
index e35dfb5977d..1326a477cb3 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolBar.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolBar.xml
@@ -1296,7 +1296,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.ToolBar.ToString" /> method returns a string that includes the type, the value of the <see cref="P:System.Windows.Forms.ToolBar.ToolBarButtonCollection.Count" /> property in the <see cref="T:System.Windows.Forms.ToolBar.ToolBarButtonCollection" />, and the string returned by the <see cref="M:System.Windows.Forms.ToolBar.ToString" /> method of the toolbar’s first button.</para>
@@ -1305,6 +1304,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the <see cref="T:System.Windows.Forms.ToolBar" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A String that represents the current <see cref="T:System.Windows.Forms.ToolBar" />. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolBarButton.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolBarButton.xml
index 3fc93b82c1c..9e85750255f 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolBarButton.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolBarButton.xml
@@ -508,7 +508,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.ToolBarButton.ToString" /> method returns a string that includes the type and the value of the <see cref="P:System.Windows.Forms.ToolBarButton.Style" /> and <see cref="P:System.Windows.Forms.ToolBarButton.Text" /> properties.</para>
@@ -517,6 +516,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the <see cref="T:System.Windows.Forms.ToolBarButton" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Windows.Forms.ToolBarButton" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStrip.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStrip.xml
index a97168d2adf..84d8eea0bd8 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStrip.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStrip.xml
@@ -676,13 +676,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessibility object for the <see cref="T:System.Windows.Forms.ToolStrip" /> item.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.AccessibleObject" /> for the <see cref="T:System.Windows.Forms.ToolStrip" /> item.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -696,13 +699,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the control collection for the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.Windows.Forms.Control.ControlCollection" /> assigned to the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -723,12 +729,15 @@
         <Parameter Name="onClick" Type="System.EventHandler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a default <see cref="T:System.Windows.Forms.ToolStripItem" /> with the specified text, image, and event handler on a new <see cref="T:System.Windows.Forms.ToolStrip" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="M:System.Windows.Forms.ToolStripButton.#ctor(System.String,System.Drawing.Image,System.EventHandler)" />, or a <see cref="T:System.Windows.Forms.ToolStripSeparator" /> if the <paramref name="text" /> parameter is a hyphen (-).</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to use for the <see cref="T:System.Windows.Forms.ToolStripItem" />. If the <paramref name="text" /> parameter is a hyphen (-), this method creates a <see cref="T:System.Windows.Forms.ToolStripSeparator" />.</param>
         <param name="image">
@@ -750,12 +759,15 @@
         <Parameter Name="layoutStyle" Type="System.Windows.Forms.ToolStripLayoutStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Specifies the visual arrangement for the <see cref="T:System.Windows.Forms.ToolStrip" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.ToolStripLayoutStyle" /> values. The default is null.</para>
+        </returns>
         <param name="layoutStyle">
           <attribution license="cc4" from="Microsoft" modified="false" />The visual arrangement to be applied to the <see cref="T:System.Windows.Forms.ToolStrip" />.</param>
       </Docs>
@@ -1174,7 +1186,6 @@
         <Parameter Name="point" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is not relevant for this class.</para>
@@ -1183,6 +1194,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is not relevant for this class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The child <see cref="T:System.Windows.Forms.Control" /> that is located at the specified coordinates.</para>
+        </returns>
         <param name="point">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Point" />.</param>
       </Docs>
@@ -1206,7 +1221,6 @@
         <Parameter Name="skipValue" Type="System.Windows.Forms.GetChildAtPointSkip" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is not relevant for this class.</para>
@@ -1215,6 +1229,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is not relevant for this class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The child <see cref="T:System.Windows.Forms.Control" /> that is located at the specified coordinates.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Point" /> value.</param>
         <param name="skipValue">
@@ -1231,13 +1249,16 @@
         <Parameter Name="point" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the item located at the specified point in the client area of the <see cref="T:System.Windows.Forms.ToolStrip" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.ToolStripItem" /> at the specified location, or null if the <see cref="T:System.Windows.Forms.ToolStripItem" /> is not found.</para>
+        </returns>
         <param name="point">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Point" /> at which to search for the <see cref="T:System.Windows.Forms.ToolStripItem" />. </param>
       </Docs>
@@ -1256,13 +1277,16 @@
         <Parameter Name="y" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the item located at the specified x- and y-coordinates of the <see cref="T:System.Windows.Forms.ToolStrip" /> client area.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.ToolStripItem" /> located at the specified location, or null if the <see cref="T:System.Windows.Forms.ToolStripItem" /> is not found.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The horizontal coordinate, in pixels, from the left edge of the client area. </param>
         <param name="y">
@@ -1283,7 +1307,6 @@
         <Parameter Name="direction" Type="System.Windows.Forms.ArrowDirection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1293,6 +1316,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the next <see cref="T:System.Windows.Forms.ToolStripItem" /> from the specified reference point and moving in the specified direction.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.ToolStripItem" /> that is specified by the <paramref name="start" /> parameter and is next in the order as specified by the <paramref name="direction" /> parameter.</para>
+        </returns>
         <param name="start">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.ToolStripItem" /> that is the reference point from which to begin the retrieval of the next item.</param>
         <param name="direction">
@@ -1614,7 +1641,6 @@
         <Parameter Name="charCode" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.ToolStrip.IsInputChar(System.Char)" /> method is called during window message preprocessing to determine whether the given input character should be preprocessed or sent directly to the <see cref="T:System.Windows.Forms.ToolStrip" />. If the <see cref="M:System.Windows.Forms.ToolStrip.IsInputChar(System.Char)" /> method returns true, the specified character is sent directly to the <see cref="T:System.Windows.Forms.ToolStrip" />. However, if the method returns false, the character is preprocessed and only sent to the <see cref="T:System.Windows.Forms.ToolStrip" /> if it is not consumed by the preprocessing phase. The preprocessing of a character includes checking whether the character is a mnemonic of another control.</para>
@@ -1623,6 +1649,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a character is an input character that the item recognizes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character should be sent directly to the item and not preprocessed; otherwise, false.</para>
+        </returns>
         <param name="charCode">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to test.</param>
       </Docs>
@@ -1640,12 +1670,15 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified key is a regular input key or a special key that requires preprocessing.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified key is a regular input key; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.Keys" /> values.</param>
       </Docs>
@@ -2759,7 +2792,6 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.ToolStrip.ProcessDialogKey(System.Windows.Forms.Keys)" /> method is called during message preprocessing to handle dialog characters such as TAB, RETURN, ESCAPE, and arrow keys. This method is called only if the <see cref="M:System.Windows.Forms.ToolStrip.IsInputKey(System.Windows.Forms.Keys)" /> method indicates that the control is not processing the key. The <see cref="M:System.Windows.Forms.ToolStrip.ProcessDialogKey(System.Windows.Forms.Keys)" /> simply sends the character to the parent control's <see cref="M:System.Windows.Forms.ToolStrip.ProcessDialogKey(System.Windows.Forms.Keys)" /> method, or returns false if the control has no parent. The <see cref="T:System.Windows.Forms.Form" /> class overrides this method to perform actual processing of dialog box keys. This method is only called when the control is hosted in a Windows Forms application or an ActiveX control.</para>
@@ -2768,6 +2800,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a dialog box key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key was processed by the control; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.Keys" /> values that represents the key to process. </param>
       </Docs>
@@ -2785,7 +2821,6 @@
         <Parameter Name="charCode" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.ToolStrip.ProcessMnemonic(System.Char)" /> method is called to give a control the opportunity to process a mnemonic character. This method should determine whether the control is in a state to process mnemonics and whether the given character represents a mnemonic. If so, the method should perform the action associated with the mnemonic and return true. If not, the method should return false. </para>
@@ -2796,6 +2831,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a mnemonic character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character was processed as a mnemonic by the control; otherwise, false.</para>
+        </returns>
         <param name="charCode">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to process. </param>
       </Docs>
@@ -3240,13 +3279,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the <see cref="T:System.Windows.Forms.ToolStrip" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the <see cref="T:System.Windows.Forms.ToolStrip" /> control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripButton.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripButton.xml
index 8035dda00b3..e7fb0f108d3 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripButton.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripButton.xml
@@ -348,7 +348,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -361,6 +360,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessibility object for the <see cref="T:System.Windows.Forms.ToolStripButton" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.AccessibleObject" /> for the <see cref="T:System.Windows.Forms.ToolStripButton" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -400,13 +403,16 @@
         <Parameter Name="constrainingSize" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the size of a rectangular area into which a <see cref="T:System.Windows.Forms.ToolStripButton" /> can be fitted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An ordered pair of type <see cref="T:System.Drawing.Size" /> representing the width and height of a rectangle.</para>
+        </returns>
         <param name="constrainingSize">
           <attribution license="cc4" from="Microsoft" modified="false" />The specified area for a <see cref="T:System.Windows.Forms.ToolStripButton" />.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripComboBox.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripComboBox.xml
index 5db81535d66..54ca5e139e7 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripComboBox.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripComboBox.xml
@@ -597,7 +597,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -607,6 +606,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds the first item in the <see cref="T:System.Windows.Forms.ToolStripComboBox" /> that starts with the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first item found; returns -1 if no match is found.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> to search for.</param>
       </Docs>
@@ -625,7 +628,6 @@
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -635,6 +637,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds the first item after the given index which starts with the given string. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first item found; returns -1 if no match is found.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> to search for.</param>
         <param name="startIndex">
@@ -654,7 +660,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -664,6 +669,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds the first item in the <see cref="T:System.Windows.Forms.ToolStripComboBox" /> that exactly matches the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first item found; -1 if no match is found.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> to search for.</param>
       </Docs>
@@ -682,7 +691,6 @@
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -692,6 +700,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds the first item after the specified index that exactly matches the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first item found; returns -1 if no match is found.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> to search for.</param>
         <param name="startIndex">
@@ -740,13 +752,16 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the height, in pixels, of an item in the <see cref="T:System.Windows.Forms.ToolStripComboBox" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The height, in pixels, of the item at the specified index.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the item to return the height of.</param>
       </Docs>
@@ -764,13 +779,16 @@
         <Parameter Name="constrainingSize" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the size of a rectangular area into which a control can be fitted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An ordered pair of type <see cref="T:System.Drawing.Size" /> representing the width and height of a rectangle.</para>
+        </returns>
         <param name="constrainingSize">
           <attribution license="cc4" from="Microsoft" modified="false" />The custom-sized area for a control. </param>
       </Docs>
@@ -1396,13 +1414,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of the <see cref="T:System.Windows.Forms.ToolStripComboBox" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the <see cref="T:System.Windows.Forms.ToolStripComboBox" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripContainer.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripContainer.xml
index 9be3a24c643..09e5daac206 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripContainer.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripContainer.xml
@@ -592,13 +592,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a <see cref="T:System.Windows.Forms.ToolStripContainer" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A read-only <see cref="T:System.Windows.Forms.ToolStripContainer" /> collection.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripControlHost.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripControlHost.xml
index 27ef1c62a5f..1de7345892c 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripControlHost.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripControlHost.xml
@@ -253,13 +253,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessibility object for the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.AccessibleObject" /> for the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -556,13 +559,16 @@
         <Parameter Name="constrainingSize" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the size of a rectangular area into which a control can be fitted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An ordered pair of type <see cref="T:System.Drawing.Size" /> representing the width and height of a rectangle.</para>
+        </returns>
         <param name="constrainingSize">
           <attribution license="cc4" from="Microsoft" modified="false" />The custom-sized area for a control. </param>
       </Docs>
@@ -1295,12 +1301,15 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a dialog key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key was processed by the item; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.Keys" /> values that represents the key to process. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripDropDown.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripDropDown.xml
index 2757240c228..4b99ba7fa38 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripDropDown.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripDropDown.xml
@@ -542,12 +542,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessibility object for the <see cref="T:System.Windows.Forms.ToolStripDropDown" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.AccessibleObject" /> for the control.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateHandle">
@@ -579,12 +582,15 @@
         <Parameter Name="style" Type="System.Windows.Forms.ToolStripLayoutStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Applies various layout options to the <see cref="T:System.Windows.Forms.ToolStripDropDown" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.LayoutSettings" /> for this <see cref="T:System.Windows.Forms.ToolStripDropDown" />.</para>
+        </returns>
         <param name="style">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.ToolStripLayoutStyle" /> values. The possibilities are <see cref="F:System.Windows.Forms.ToolStripLayoutStyle.Flow" />, <see cref="F:System.Windows.Forms.ToolStripLayoutStyle.HorizontalStackWithOverflow" />, <see cref="F:System.Windows.Forms.ToolStripLayoutStyle.StackWithOverflow" />, <see cref="F:System.Windows.Forms.ToolStripLayoutStyle.Table" />, and <see cref="F:System.Windows.Forms.ToolStripLayoutStyle.VerticalStackWithOverflow" />.</param>
       </Docs>
@@ -1708,13 +1714,16 @@
         <Parameter Name="charCode" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a dialog box character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character was processed by the control; otherwise, false.</para>
+        </returns>
         <param name="charCode">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to process.</param>
       </Docs>
@@ -1737,7 +1746,6 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1747,6 +1755,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a dialog box key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key was processed by the control; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.Keys" /> values that represents the key to process.</param>
       </Docs>
@@ -1764,7 +1776,6 @@
         <Parameter Name="charCode" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1779,6 +1790,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a mnemonic character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character was processed as a mnemonic by the control; otherwise, false.</para>
+        </returns>
         <param name="charCode">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to process.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripDropDownButton.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripDropDownButton.xml
index 634ef330642..877d467980f 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripDropDownButton.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripDropDownButton.xml
@@ -221,13 +221,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a generic <see cref="T:System.Windows.Forms.ToolStripDropDown" /> for which events can be defined.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.ToolStripDropDown" /> for which events can be defined.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -367,12 +370,15 @@
         <Parameter Name="charCode" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a value indicating whether the drop-down list of the <see cref="T:System.Windows.Forms.ToolStripDropDownButton" /> has items.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the drop-down list has items; otherwise, false.</para>
+        </returns>
         <param name="charCode">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to process.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripDropDownItem.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripDropDownItem.xml
index d0873077ef2..075bafb7b2c 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripDropDownItem.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripDropDownItem.xml
@@ -158,7 +158,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -168,6 +167,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a generic <see cref="T:System.Windows.Forms.ToolStripDropDown" /> for which events can be defined.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Windows.Forms.ToolStripDropDown" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -684,7 +687,6 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called during message preprocessing to handle the UP, DOWN, LEFT, RIGHT, ENTER, and SPACEBAR keys in order to navigate the hierarchy of drop-down menus. </para>
@@ -693,6 +695,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a dialog key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key was processed by the item; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.Keys" /> values that represents the key to process. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripDropDownItemAccessibleObject.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripDropDownItemAccessibleObject.xml
index e69d47594bf..b9ef37ce651 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripDropDownItemAccessibleObject.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripDropDownItemAccessibleObject.xml
@@ -70,12 +70,15 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the accessible child control corresponding to the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Windows.Forms.AccessibleObject" /> that represents the accessible child control corresponding to the specified index.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the accessible child control.</param>
       </Docs>
@@ -91,12 +94,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the number of children belonging to an accessible object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of children belonging to an accessible object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Role">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripDropDownMenu.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripDropDownMenu.xml
index aee317a8a84..34841cd9523 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripDropDownMenu.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripDropDownMenu.xml
@@ -64,7 +64,6 @@
         <Parameter Name="onClick" Type="System.EventHandler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Windows.Forms.ToolStripDropDownMenu.CreateDefaultItem(System.String,System.Drawing.Image,System.EventHandler)" /> method to add a <see cref="T:System.Windows.Forms.ToolStripMenuItem" /> with commonly used characteristics to a <see cref="T:System.Windows.Forms.ToolStripDropDownMenu" />.</para>
@@ -73,6 +72,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a default <see cref="T:System.Windows.Forms.ToolStripMenuItem" /> with the specified text, image, and event handler on a new <see cref="T:System.Windows.Forms.ToolStripDropDownMenu" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.ToolStripMenuItem" />, or a <see cref="T:System.Windows.Forms.ToolStripSeparator" /> if the <paramref name="text" /> parameter is a hyphen (-).</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to use for the <see cref="T:System.Windows.Forms.ToolStripMenuItem" />. If the <paramref name="text" /> parameter is a hyphen (-), this method creates a <see cref="T:System.Windows.Forms.ToolStripSeparator" />.</param>
         <param name="image">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripItem.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripItem.xml
index 7088f66a929..b381ca6830d 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripItem.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripItem.xml
@@ -814,13 +814,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessibility object for the <see cref="T:System.Windows.Forms.ToolStripItem" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.AccessibleObject" /> for the <see cref="T:System.Windows.Forms.ToolStripItem" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1079,7 +1082,6 @@
         <Parameter Name="allowedEffects" Type="System.Windows.Forms.DragDropEffects" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the drag operation needs to interact with applications in another process, the <paramref name="data" /> parameter must either be a base managed class (such as <see cref="T:System.String" />, <see cref="T:System.Drawing.Bitmap" />, or <see cref="T:System.Drawing.Imaging.Metafile" />), an object that implements <see cref="T:System.Runtime.Serialization.ISerializable" />, or an object that implements <see cref="T:System.Windows.Forms.IDataObject" />.</para>
@@ -1088,6 +1090,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins a drag-and-drop operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Windows.Forms.DragDropEffects" /> values.</para>
+        </returns>
         <param name="data">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be dragged. </param>
         <param name="allowedEffects">
@@ -1464,7 +1470,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1475,6 +1480,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the <see cref="T:System.Windows.Forms.ToolStrip" /> that is the container of the current <see cref="T:System.Windows.Forms.ToolStripItem" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.ToolStrip" /> that is the container of the current <see cref="T:System.Windows.Forms.ToolStripItem" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1490,13 +1499,16 @@
         <Parameter Name="constrainingSize" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the size of a rectangular area into which a control can be fit.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Size" /> ordered pair, representing the width and height of a rectangle.</para>
+        </returns>
         <param name="constrainingSize">
           <attribution license="cc4" from="Microsoft" modified="false" />The custom-sized area for a control. </param>
       </Docs>
@@ -1938,7 +1950,6 @@
         <Parameter Name="charCode" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called during window message preprocessing to determine whether the given input character should be preprocessed or sent directly to the <see cref="T:System.Windows.Forms.ToolStripItem" />. If the <see cref="M:System.Windows.Forms.Control.IsInputChar(System.Char)" /> method returns true, the specified character is sent directly to the <see cref="T:System.Windows.Forms.ToolStripItem" />. However, if the method returns false, the character is preprocessed and only sent to the <see cref="T:System.Windows.Forms.ToolStripItem" /> if it is not consumed by the preprocessing phase. The preprocessing of a character includes checking whether the character is a mnemonic of another control.</para>
@@ -1947,6 +1958,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a character is an input character that the item recognizes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character should be sent directly to the item and not preprocessed; otherwise, false.</para>
+        </returns>
         <param name="charCode">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to test. </param>
       </Docs>
@@ -1964,7 +1979,6 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call the <see cref="M:System.Windows.Forms.Control.IsInputChar(System.Char)" /> method during window-message preprocessing to determine whether the specified key is a regular input key that should be sent directly to the <see cref="T:System.Windows.Forms.ToolStripItem" /> or a special key (such as PAGE UP, PAGE DOWN, ENTER, ESC, TAB, or arrow keys) that should be preprocessed. In the latter case, the key is sent to the <see cref="T:System.Windows.Forms.ToolStripItem" /> only if it is not consumed by the preprocessing phase.</para>
@@ -1973,6 +1987,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified key is a regular input key or a special key that requires preprocessing.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified key is a regular input key; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.Keys" /> values. </param>
       </Docs>
@@ -3681,7 +3699,6 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called during message preprocessing to handle the ENTER and SPACEBAR keys in order to raise the <see cref="E:System.Windows.Forms.ToolStripItem.Click" /> event. This method is called only if the <see cref="M:System.Windows.Forms.Control.IsInputKey(System.Windows.Forms.Keys)" /> method indicates that the item is not processing the key. </para>
@@ -3690,6 +3707,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a dialog key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key was processed by the item; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.Keys" /> values that represents the key to process. </param>
       </Docs>
@@ -3707,7 +3728,6 @@
         <Parameter Name="charCode" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called to give an item the opportunity to process a mnemonic character. The method should determine whether the item is in a state to process mnemonics and if whether the given character represents a mnemonic. If so, the method should perform the action associated with the mnemonic and return true. If not, the method should return false. </para>
@@ -3717,6 +3737,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a mnemonic character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true in all cases.</para>
+        </returns>
         <param name="charCode">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to process. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripItemCollection.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripItemCollection.xml
index 577ef30f19d..1389774b514 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripItemCollection.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripItemCollection.xml
@@ -63,13 +63,16 @@
         <Parameter Name="image" Type="System.Drawing.Image" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Windows.Forms.ToolStripItem" /> that displays the specified image to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Windows.Forms.ToolStripItem" />.</para>
+        </returns>
         <param name="image">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Image" /> to be displayed on the <see cref="T:System.Windows.Forms.ToolStripItem" />.</param>
       </Docs>
@@ -87,13 +90,16 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Windows.Forms.ToolStripItem" /> that displays the specified text to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Windows.Forms.ToolStripItem" />.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to be displayed on the <see cref="T:System.Windows.Forms.ToolStripItem" />.</param>
       </Docs>
@@ -111,13 +117,16 @@
         <Parameter Name="value" Type="System.Windows.Forms.ToolStripItem" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified item to the end of the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Int32" /> representing the zero-based index of the new item in the collection.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.ToolStripItem" /> to add to the end of the collection. </param>
       </Docs>
@@ -136,13 +145,16 @@
         <Parameter Name="image" Type="System.Drawing.Image" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Windows.Forms.ToolStripItem" /> that displays the specified image and text to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Windows.Forms.ToolStripItem" />.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to be displayed on the <see cref="T:System.Windows.Forms.ToolStripItem" />.</param>
         <param name="image">
@@ -164,13 +176,16 @@
         <Parameter Name="onClick" Type="System.EventHandler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Windows.Forms.ToolStripItem" /> that displays the specified image and text to the collection and that raises the <see cref="E:System.Windows.Forms.ToolStripItem.Click" /> event.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Windows.Forms.ToolStripItem" />.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to be displayed on the <see cref="T:System.Windows.Forms.ToolStripItem" />.</param>
         <param name="image">
@@ -269,13 +284,16 @@
         <Parameter Name="value" Type="System.Windows.Forms.ToolStripItem" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified item is a member of the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Windows.Forms.ToolStripItem" /> is a member of the current <see cref="T:System.Windows.Forms.ToolStripItemCollection" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.ToolStripItem" /> to search for in the <see cref="T:System.Windows.Forms.ToolStripItemCollection" />. </param>
       </Docs>
@@ -293,7 +311,6 @@
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -303,6 +320,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the collection contains an item with the specified key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Windows.Forms.ToolStripItemCollection" /> contains a <see cref="T:System.Windows.Forms.ToolStripItem" /> with the specified key; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key to locate in the <see cref="T:System.Windows.Forms.ToolStripItemCollection" />. </param>
       </Docs>
@@ -347,13 +368,16 @@
         <Parameter Name="searchAllChildren" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for items by their name and returns an array of all matching controls.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.ToolStripItem" /> array of the search results.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The item name to search the <see cref="T:System.Windows.Forms.ToolStripItemCollection" /> for.</param>
         <param name="searchAllChildren">
@@ -373,13 +397,16 @@
         <Parameter Name="value" Type="System.Windows.Forms.ToolStripItem" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the index of the specified item in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A zero-based index value that represents the position of the specified <see cref="T:System.Windows.Forms.ToolStripItem" /> in the <see cref="T:System.Windows.Forms.ToolStripItemCollection" />, if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.ToolStripItem" /> to locate in the <see cref="T:System.Windows.Forms.ToolStripItemCollection" />. </param>
       </Docs>
@@ -397,7 +424,6 @@
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -408,6 +434,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the index of the first occurrence of the specified item within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A zero-based index value that represents the position of the first occurrence of the <see cref="T:System.Windows.Forms.ToolStripItem" /> specified by the <paramref name="key" /> parameter, if found; otherwise, -1.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Windows.Forms.ToolStripItem" /> to search for. </param>
       </Docs>
@@ -595,7 +625,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.ToolStripItemCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -604,6 +633,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an item to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The location at which <paramref name="value" /> was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The item to add to the collection.</param>
       </Docs>
@@ -642,7 +675,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.ToolStripItemCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -651,6 +683,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the collection contains a specified item.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is contained in the collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The item to locate in the collection.</param>
       </Docs>
@@ -668,7 +704,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.ToolStripItemCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -677,6 +712,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the location of a specified item in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the item in the collection, if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The item to locate in the collection.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripLabel.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripLabel.xml
index b8bc4e25eb4..3cec0fa8781 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripLabel.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripLabel.xml
@@ -484,7 +484,6 @@
         <Parameter Name="charCode" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called to give an item the opportunity to process a mnemonic character. The method should determine whether the item is in a state to process mnemonics and if whether the given character represents a mnemonic. If so, the method should perform the action associated with the mnemonic and return true. If not, the method should return false. </para>
@@ -494,6 +493,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a mnemonic character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character was processed as a mnemonic by the control; otherwise, false.</para>
+        </returns>
         <param name="charCode">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to process. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripManager.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripManager.xml
index 7f414f1687a..25a6a0878e1 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripManager.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripManager.xml
@@ -36,7 +36,6 @@
         <Parameter Name="toolStripName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Windows.Forms.ToolStripManager.FindToolStrip(System.String)" /> method to search for a <see cref="T:System.Windows.Forms.ToolStrip" /> or an object derived from <see cref="T:System.Windows.Forms.ToolStrip" />. Derived types of <see cref="T:System.Windows.Forms.ToolStrip" /> are <see cref="T:System.Windows.Forms.StatusStrip" />, <see cref="T:System.Windows.Forms.MenuStrip" />, <see cref="T:System.Windows.Forms.ToolStripDropDown" />, <see cref="T:System.Windows.Forms.ToolStripDropDownMenu" />, and <see cref="T:System.Windows.Forms.ContextMenuStrip" />. If the object of the search is not specifically a <see cref="T:System.Windows.Forms.ToolStrip" /> but one of these derived types, cast the return type as required.</para>
@@ -45,6 +44,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds the specified <see cref="T:System.Windows.Forms.ToolStrip" /> or a type derived from <see cref="T:System.Windows.Forms.ToolStrip" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.ToolStrip" /> or one of its derived types as specified by the <paramref name="toolStripName" /> parameter, or null if the <see cref="T:System.Windows.Forms.ToolStrip" /> is not found.</para>
+        </returns>
         <param name="toolStripName">
           <attribution license="cc4" from="Microsoft" modified="false" />A string specifying the name of the <see cref="T:System.Windows.Forms.ToolStrip" /> or derived <see cref="T:System.Windows.Forms.ToolStrip" /> type to find.</param>
       </Docs>
@@ -62,12 +65,15 @@
         <Parameter Name="shortcut" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a value indicating whether the specified shortcut key is used by any of the <see cref="T:System.Windows.Forms.ToolStrip" /> controls of a form.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the shortcut key is used by any <see cref="T:System.Windows.Forms.ToolStrip" /> on the form; otherwise, false. </para>
+        </returns>
         <param name="shortcut">
           <attribution license="cc4" from="Microsoft" modified="false" />The shortcut key for which to search.</param>
       </Docs>
@@ -85,7 +91,6 @@
         <Parameter Name="shortcut" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Valid shortcut keys are the function keys F1 through F12 alone; function keys with CTRL, ALT, or SHIFT modifiers; or other keys with CTRL, ALT, or SHIFT modifiers. CTRL, ALT, or SHIFT keys and keys other than function keys are not valid shortcut keys if used alone.</para>
@@ -94,6 +99,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a value indicating whether a defined shortcut key is valid.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the shortcut key is valid; otherwise, false. </para>
+        </returns>
         <param name="shortcut">
           <attribution license="cc4" from="Microsoft" modified="false" />The shortcut key to test for validity.</param>
       </Docs>
@@ -167,7 +176,6 @@
         <Parameter Name="targetName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Windows.Forms.ToolStripManager.Merge(System.Windows.Forms.ToolStrip,System.String)" /> method to combine <see cref="T:System.Windows.Forms.ToolStrip" /> objects of identical type, such as <see cref="T:System.Windows.Forms.ToolStrip" /> objects with other <see cref="T:System.Windows.Forms.ToolStrip" /> objects, <see cref="T:System.Windows.Forms.MenuStrip" /> objects with other <see cref="T:System.Windows.Forms.MenuStrip" /> objects, and so on.</para>
@@ -181,6 +189,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Combines two <see cref="T:System.Windows.Forms.ToolStrip" /> objects of the same type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the merge is successful; otherwise, false. </para>
+        </returns>
         <param name="sourceToolStrip">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.ToolStrip" /> to be combined with the <see cref="T:System.Windows.Forms.ToolStrip" /> referred to by the <paramref name="targetName" /> parameter.</param>
         <param name="targetName">
@@ -201,7 +213,6 @@
         <Parameter Name="targetToolStrip" Type="System.Windows.Forms.ToolStrip" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Windows.Forms.ToolStripManager.Merge(System.Windows.Forms.ToolStrip,System.Windows.Forms.ToolStrip)" /> method to combine <see cref="T:System.Windows.Forms.ToolStrip" /> objects of different types.</para>
@@ -215,6 +226,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Combines two <see cref="T:System.Windows.Forms.ToolStrip" /> objects of different types.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the merge is successful; otherwise, false.</para>
+        </returns>
         <param name="sourceToolStrip">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.ToolStrip" /> to be combined with the <see cref="T:System.Windows.Forms.ToolStrip" /> referred to by the <paramref name="targetToolStrip" /> parameter.</param>
         <param name="targetToolStrip">
@@ -302,7 +317,6 @@
         <Parameter Name="targetName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Windows.Forms.ToolStrip.AllowMerge" /> property must be set to true for both <see cref="T:System.Windows.Forms.ToolStrip" /> objects, or this method returns false.</para>
@@ -311,6 +325,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Undoes a merging of two <see cref="T:System.Windows.Forms.ToolStrip" /> objects, returning the <see cref="T:System.Windows.Forms.ToolStrip" /> with the specified name to its state before the merge and nullifying all previous merge operations.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the undoing of the merge is successful; otherwise, false. </para>
+        </returns>
         <param name="targetName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Windows.Forms.ToolStripItem" /> for which to undo a merge operation.</param>
       </Docs>
@@ -328,7 +346,6 @@
         <Parameter Name="targetToolStrip" Type="System.Windows.Forms.ToolStrip" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Windows.Forms.ToolStrip.AllowMerge" /> property must be set to true for both <see cref="T:System.Windows.Forms.ToolStrip" /> objects, or this method returns false.</para>
@@ -337,6 +354,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Undoes a merging of two <see cref="T:System.Windows.Forms.ToolStrip" /> objects, returning the specified <see cref="T:System.Windows.Forms.ToolStrip" /> to its state before the merge and nullifying all previous merge operations.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the undoing of the merge is successful; otherwise, false. </para>
+        </returns>
         <param name="targetToolStrip">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.ToolStripItem" /> for which to undo a merge operation.</param>
       </Docs>
@@ -355,7 +376,6 @@
         <Parameter Name="sourceToolStrip" Type="System.Windows.Forms.ToolStrip" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Windows.Forms.ToolStrip.AllowMerge" /> property must be set to true for both <see cref="T:System.Windows.Forms.ToolStrip" /> objects, or this method returns false.</para>
@@ -364,6 +384,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Undoes a merging of two <see cref="T:System.Windows.Forms.ToolStrip" /> objects, returning both <see cref="T:System.Windows.Forms.ToolStrip" /> controls to their state before the merge and nullifying all previous merge operations.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the undoing of the merge is successful; otherwise, false.</para>
+        </returns>
         <param name="targetToolStrip">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Windows.Forms.ToolStripItem" /> for which to undo a merge operation.</param>
         <param name="sourceToolStrip">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripMenuItem.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripMenuItem.xml
index ff436376b21..b11481d25ae 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripMenuItem.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripMenuItem.xml
@@ -385,12 +385,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessibility object for the <see cref="T:System.Windows.Forms.ToolStripMenuItem" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.AccessibleObject" /> for the <see cref="T:System.Windows.Forms.ToolStripMenuItem" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateDefaultDropDown">
@@ -401,7 +404,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -411,6 +413,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a generic <see cref="T:System.Windows.Forms.ToolStripDropDown" /> for which events can be defined.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A generic <see cref="T:System.Windows.Forms.ToolStripDropDown" /> for which can be defined.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -924,12 +930,15 @@
         <Parameter Name="charCode" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a mnemonic character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character was processed as a mnemonic by the control; otherwise, false.</para>
+        </returns>
         <param name="charCode">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to process. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripOverflow.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripOverflow.xml
index 7c1b380cded..b1f11689f41 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripOverflow.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripOverflow.xml
@@ -58,7 +58,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you do not explicitly call the <see cref="M:System.Windows.Forms.ToolStripOverflow.CreateAccessibilityInstance" /> method, it will be called when the <see cref="P:System.Windows.Forms.Control.AccessibilityObject" /> property is referenced.</para>
@@ -70,6 +69,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessibility object for the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.AccessibleObject" /> for the control.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DisplayedItems">
@@ -106,12 +109,15 @@
         <Parameter Name="constrainingSize" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the size of a rectangular area into which a control can be fitted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An ordered pair of type <see cref="T:System.Drawing.Size" /> representing the width and height of a rectangle.</para>
+        </returns>
         <param name="constrainingSize">
           <attribution license="cc4" from="Microsoft" modified="false" />The custom-sized area for a control.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripOverflowButton.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripOverflowButton.xml
index 8d41bde94ed..68c6d69a850 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripOverflowButton.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripOverflowButton.xml
@@ -36,7 +36,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you do not explicitly call the <see cref="M:System.Windows.Forms.ToolStripOverflowButton.CreateAccessibilityInstance" /> method, it will be called when the <see cref="P:System.Windows.Forms.Control.AccessibilityObject" /> property is referenced.</para>
@@ -48,6 +47,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessibility object for the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.AccessibleObject" /> for the control.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateDefaultDropDown">
@@ -61,12 +64,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an empty <see cref="T:System.Windows.Forms.ToolStripDropDown" /> that can be dropped down and to which events can be attached.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.ToolStripDropDown" /> control.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DefaultMargin">
@@ -100,12 +106,15 @@
         <Parameter Name="constrainingSize" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the size of a rectangular area into which a control can fit.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An ordered pair of type <see cref="T:System.Drawing.Size" /> representing the width and height of a rectangle.</para>
+        </returns>
         <param name="constrainingSize">
           <attribution license="cc4" from="Microsoft" modified="false" />The custom-sized area for a control. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripPanel.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripPanel.xml
index d69709e1c00..68ecbad9a3f 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripPanel.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripPanel.xml
@@ -273,12 +273,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection of <see cref="T:System.Windows.Forms.ToolStripPanel" /> controls.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of <see cref="T:System.Windows.Forms.ToolStripPanel" /> controls.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DefaultMargin">
@@ -759,13 +762,16 @@
         <Parameter Name="clientLocation" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the <see cref="T:System.Windows.Forms.ToolStripPanelRow" /> given a point within the <see cref="T:System.Windows.Forms.ToolStripPanel" /> client area.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.ToolStripPanelRow" /> that contains the <paramref name="raftingContainerPoint" />, or null if no such <see cref="T:System.Windows.Forms.ToolStripPanelRow" /> exists.</para>
+        </returns>
         <param name="clientLocation">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Point" /> used as a reference to find the <see cref="T:System.Windows.Forms.ToolStripPanelRow" />.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripPanelRow.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripPanelRow.xml
index 7188175322b..a9e6380d04d 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripPanelRow.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripPanelRow.xml
@@ -74,13 +74,16 @@
         <Parameter Name="toolStripToDrag" Type="System.Windows.Forms.ToolStrip" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets or sets a value indicating whether a <see cref="T:System.Windows.Forms.ToolStrip" /> can be dragged and dropped into a <see cref="T:System.Windows.Forms.ToolStripPanelRow" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there is enough space in the <see cref="T:System.Windows.Forms.ToolStripPanelRow" /> to receive the <see cref="T:System.Windows.Forms.ToolStrip" />; otherwise, false. </para>
+        </returns>
         <param name="toolStripToDrag">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.ToolStrip" /> to be dragged and dropped into the <see cref="T:System.Windows.Forms.ToolStripPanelRow" />.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripRenderer.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripRenderer.xml
index 1f9fe64e250..300b4a3960e 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripRenderer.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripRenderer.xml
@@ -56,13 +56,16 @@
         <Parameter Name="normalImage" Type="System.Drawing.Image" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a gray-scale copy of a given image.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Drawing.Image" /> that is a copy of the given image, but with a gray-scale color matrix.</para>
+        </returns>
         <param name="normalImage">
           <attribution license="cc4" from="Microsoft" modified="false" />The image to be copied. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripSeparator.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripSeparator.xml
index eb787362a3e..3611d9b81e7 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripSeparator.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripSeparator.xml
@@ -169,13 +169,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessibility object for the <see cref="T:System.Windows.Forms.ToolStripSeparator" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Windows.Forms.AccessibleObject" /> for the <see cref="T:System.Windows.Forms.ToolStripMenuItem" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -423,13 +426,16 @@
         <Parameter Name="constrainingSize" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the size of a rectangular area into which a <see cref="T:System.Windows.Forms.ToolStripSeparator" /> can be fitted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Size" /> representing the height and width of the <see cref="T:System.Windows.Forms.ToolStripSeparator" />, in pixels.</para>
+        </returns>
         <param name="constrainingSize">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Size" /> representing the height and width of the <see cref="T:System.Windows.Forms.ToolStripSeparator" />, in pixels.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripSplitButton.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripSplitButton.xml
index 5dce618c95b..3314f0e85ec 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripSplitButton.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripSplitButton.xml
@@ -341,12 +341,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new accessibility object for the <see cref="T:System.Windows.Forms.ToolStripSplitButton" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new accessibility object for the <see cref="T:System.Windows.Forms.ToolStripSplitButton" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateDefaultDropDown">
@@ -555,13 +558,16 @@
         <Parameter Name="constrainingSize" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the size of a rectangular area into which a <see cref="T:System.Windows.Forms.ToolStripSplitButton" /> can be fitted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An ordered pair of type <see cref="T:System.Drawing.Size" />, representing the width and height of a rectangle.</para>
+        </returns>
         <param name="constrainingSize">
           <attribution license="cc4" from="Microsoft" modified="false" />The custom-sized area for a control. </param>
       </Docs>
@@ -808,7 +814,6 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called during message preprocessing to handle the ENTER and SPACEBAR keys in order to raise the <see cref="E:System.Windows.Forms.ToolStripItem.Click" /> event. However, if the <see cref="T:System.Windows.Forms.ToolStripSplitButton" /> is not enabled, this method calls the base class implementation instead. </para>
@@ -818,6 +823,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a dialog key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key was processed by the item; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Windows.Forms.Keys" /> values that represents the key to process. </param>
       </Docs>
@@ -835,12 +844,15 @@
         <Parameter Name="charCode" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a mnemonic character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true in all cases.</para>
+        </returns>
         <param name="charCode">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to process. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripStatusLabel.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripStatusLabel.xml
index c8e1aa43fa4..c232f1902ae 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripStatusLabel.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripStatusLabel.xml
@@ -261,13 +261,16 @@
         <Parameter Name="constrainingSize" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the size of a rectangular area into which a <see cref="T:System.Windows.Forms.ToolStripStatusLabel" /> can be fitted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An ordered pair of type <see cref="T:System.Drawing.Size" />, representing the width and height of a rectangle.</para>
+        </returns>
         <param name="constrainingSize">
           <attribution license="cc4" from="Microsoft" modified="false" />The custom-sized area for a control.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripTextBox.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripTextBox.xml
index 7a664422023..f00dc2bc3d4 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripTextBox.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolStripTextBox.xml
@@ -623,7 +623,6 @@
         <Parameter Name="pt" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the location specified in the <paramref name="pt" /> parameter is outside the client area of the control, the first character of the string closest to the point specified in <paramref name="pt" /> is returned. You can use this method to determine which characters are located near a specific point within the control. You can then use this value to perform operations on the text at that location.</para>
@@ -635,6 +634,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the character that is closest to the specified location within the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The character at the specified location.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />The location from which to seek the nearest character.</param>
       </Docs>
@@ -652,7 +655,6 @@
         <Parameter Name="pt" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns the character index that is closest to the position specified in the <paramref name="pt" /> parameter. The character index is a zero-based index of text in the control, including spaces. You can use this method to determine where in the text the user has the mouse over by passing the mouse coordinates to this method. This can be useful if you want to perform tasks when the mouse pointer hovers over a word in the text of the control.</para>
@@ -661,6 +663,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the index of the character nearest to the specified location.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based character index at the specified location.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />The location to search.</param>
       </Docs>
@@ -678,7 +684,6 @@
         <Parameter Name="lineNumber" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <paramref name="lineNum" /> parameter is negative, <see cref="M:System.Windows.Forms.ToolStripTextBox.GetFirstCharIndexFromLine(System.Int32)" /> returns 0. If the <paramref name="lineNum" /> parameter exceeds the number of lines in the control, <see cref="M:System.Windows.Forms.ToolStripTextBox.GetFirstCharIndexFromLine(System.Int32)" /> returns the first character index for the last line in the control.</para>
@@ -689,6 +694,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the index of the first character of a given line.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based character index in the specified line.</para>
+        </returns>
         <param name="lineNumber">
           <attribution license="cc4" from="Microsoft" modified="false" />The line for which to get the index of its first character.</param>
       </Docs>
@@ -704,12 +713,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the index of the first character of the current line.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based character index in the current line.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetLineFromCharIndex">
@@ -725,7 +737,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method enables you to determine the line number based on the character index specified in the <paramref name="index" /> parameter of the method. The first line of text in the control returns the value zero. The <see cref="M:System.Windows.Forms.ToolStripTextBox.GetLineFromCharIndex(System.Int32)" /> method returns the physical line number where the indexed character is located within the control. For example, if a portion of the first logical line of text in the control wraps to the next line, the <see cref="M:System.Windows.Forms.ToolStripTextBox.GetLineFromCharIndex(System.Int32)" /> method returns 1 if the character at the specified character index has wrapped to the second physical line. If <see cref="P:System.Windows.Forms.ToolStripTextBox.WordWrap" /> is set to false, no portion of the line wraps to the next, and the method returns 0 for the specified character index. You can use this method to determine which line a specific character index is located within. For example, after calling the <see cref="M:System.Windows.Forms.RichTextBox.Find(System.String)" /> method to search for text, you can obtain the character index to where the search results are found. You can call this method with the character index returned by the <see cref="M:System.Windows.Forms.RichTextBox.Find(System.String)" /> method to determine which line the word was found.</para>
@@ -737,6 +748,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the line number from the specified character position within the text of the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based line number in which the character index is located.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The character index position to search.</param>
       </Docs>
@@ -754,7 +769,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method enables you to determine where in the control a specific character index is located. You can use this method for such tasks as displaying shortcut menu items or help information for a word in the control. For example, if you wanted to display a menu of options to the user when the user right clicks on a word in the control, you can use this method to determine the position of the word to properly display a <see cref="T:System.Windows.Forms.ContextMenuStrip" /> control.</para>
@@ -763,6 +777,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the location within the control at the specified character index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The location of the specified character.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the character for which to retrieve the location.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolTip.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolTip.xml
index 8d0cbc78da4..a4536e4f99a 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolTip.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/ToolTip.xml
@@ -297,7 +297,6 @@
         <Parameter Name="target" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.ToolTip.CanExtend(System.Object)" /> method is the only member of the <see cref="T:System.ComponentModel.IExtenderProvider" /> interface. This method returns true if the <paramref name="target" /> parameter is of type <see cref="T:System.Windows.Forms.Control" />.</para>
@@ -306,6 +305,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns true if the ToolTip can offer an extender property to the specified target component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Windows.Forms.ToolTip" /> class can offer one or more extender properties; otherwise, false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target object to add an extender property to. </param>
       </Docs>
@@ -440,7 +443,6 @@
         <Parameter Name="control" Type="System.Windows.Forms.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>With the <see cref="M:System.Windows.Forms.ToolTip.GetToolTip(System.Windows.Forms.Control)" /> method, you can retrieve the ToolTip text for any control. If the ToolTip text changes dynamically in an application, you can use this method to find out what text is displayed at any point, depending on the state of the application. To change the text that a control is displaying, use the <see cref="M:System.Windows.Forms.ToolTip.SetToolTip(System.Windows.Forms.Control,System.String)" /> method.</para>
@@ -449,6 +451,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the ToolTip text associated with the specified control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the ToolTip text for the specified control.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Control" /> for which to retrieve the <see cref="T:System.Windows.Forms.ToolTip" /> text. </param>
       </Docs>
@@ -1051,7 +1057,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overridden version of the <see cref="M:System.Windows.Forms.ToolTip.ToString" /> method displays the class name, followed by the values of the <see cref="P:System.Windows.Forms.ToolTip.InitialDelay" /> and <see cref="P:System.Windows.Forms.ToolTip.ShowAlways" /> properties.</para>
@@ -1060,6 +1065,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation for this control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing a description of the <see cref="T:System.Windows.Forms.ToolTip" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TrackBar.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TrackBar.xml
index 399f005d075..2067b77b0b0 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TrackBar.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TrackBar.xml
@@ -1342,7 +1342,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.TrackBar.ToString" /> method returns a string that includes the type and the values for the <see cref="P:System.Windows.Forms.TrackBar.Minimum" />, <see cref="P:System.Windows.Forms.TrackBar.Maximum" />, and <see cref="P:System.Windows.Forms.TrackBar.Value" /> properties.</para>
@@ -1351,6 +1350,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the <see cref="T:System.Windows.Forms.TrackBar" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Windows.Forms.TrackBar" />. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TrackBarRenderer.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TrackBarRenderer.xml
index 267363035f1..c35ce76bda0 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TrackBarRenderer.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TrackBarRenderer.xml
@@ -356,7 +356,6 @@
         <Parameter Name="state" Type="System.Windows.Forms.VisualStyles.TrackBarThumbState" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -367,6 +366,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the size, in pixels, of the track bar slider (also known as the thumb) that points down.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Size" /> that specifies the size, in pixels, of the slider.</para>
+        </returns>
         <param name="g">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Graphics" /> this operation will use.</param>
         <param name="state">
@@ -387,7 +390,6 @@
         <Parameter Name="state" Type="System.Windows.Forms.VisualStyles.TrackBarThumbState" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -398,6 +400,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the size, in pixels, of the track bar slider (also known as the thumb) that points to the left.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Size" /> that specifies the size, in pixels, of the slider.</para>
+        </returns>
         <param name="g">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Graphics" /> this operation will use.</param>
         <param name="state">
@@ -418,7 +424,6 @@
         <Parameter Name="state" Type="System.Windows.Forms.VisualStyles.TrackBarThumbState" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -429,6 +434,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the size, in pixels, of the track bar slider (also known as the thumb) that points to the right.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Size" /> that specifies the size, in pixels, of the slider.</para>
+        </returns>
         <param name="g">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Graphics" /> this operation will use.</param>
         <param name="state">
@@ -449,7 +458,6 @@
         <Parameter Name="state" Type="System.Windows.Forms.VisualStyles.TrackBarThumbState" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -460,6 +468,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the size, in pixels, of the track bar slider (also known as the thumb) that points up.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Size" /> that specifies the size, in pixels, of the slider.</para>
+        </returns>
         <param name="g">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Graphics" /> this operation will use.</param>
         <param name="state">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TreeNode.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TreeNode.xml
index bfa7b9ec752..3d5f3a6c4ae 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TreeNode.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TreeNode.xml
@@ -295,7 +295,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The tree structure from the tree node being cloned and below is copied. Any child tree nodes assigned to the <see cref="T:System.Windows.Forms.TreeNode" /> being cloned are included in the new tree node and subtree.</para>
@@ -305,6 +304,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the tree node and the entire subtree rooted at this tree node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> that represents the cloned <see cref="T:System.Windows.Forms.TreeNode" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -596,7 +599,6 @@
         <Parameter Name="handle" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When a node is added to the <see cref="P:System.Windows.Forms.TreeView.Nodes" /> collection, the <see cref="T:System.Windows.Forms.TreeView" /> control sends an NM_CUSTOMDRAW notification before the node handle is available. If you override the <see cref="M:System.Windows.Forms.Control.WndProc(System.Windows.Forms.Message@)" /> method of the <see cref="T:System.Windows.Forms.TreeView" /> to provide custom drawing in response to this notification, you should always check the return value of this method for null before you attempt to access the node. </para>
@@ -605,6 +607,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the tree node with the specified handle and assigned to the specified tree view control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.TreeNode" /> that represents the tree node assigned to the specified <see cref="T:System.Windows.Forms.TreeView" /> control with the specified handle.</para>
+        </returns>
         <param name="tree">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.TreeView" /> that contains the tree node. </param>
         <param name="handle">
@@ -652,12 +658,15 @@
         <Parameter Name="includeSubTrees" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of child tree nodes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of child tree nodes assigned to the <see cref="P:System.Windows.Forms.TreeNode.Nodes" /> collection.</para>
+        </returns>
         <param name="includeSubTrees">
           <attribution license="cc4" from="Microsoft" modified="false" />true if the resulting count includes all tree nodes indirectly rooted at this tree node; otherwise, false. </param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TreeNodeCollection.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TreeNodeCollection.xml
index f116b630480..5981610b95e 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TreeNodeCollection.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TreeNodeCollection.xml
@@ -45,7 +45,6 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can also add new <see cref="T:System.Windows.Forms.TreeNode" /> objects to the collection by using the <see cref="M:System.Windows.Forms.TreeNodeCollection.AddRange(System.Windows.Forms.TreeNode[])" /> or <see cref="M:System.Windows.Forms.TreeNodeCollection.Insert(System.Int32,System.Windows.Forms.TreeNode)" /> methods.</para>
@@ -55,6 +54,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new tree node with the specified label text to the end of the current tree node collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.TreeNode" /> that represents the tree node being added to the collection.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The label text displayed by the <see cref="T:System.Windows.Forms.TreeNode" />. </param>
       </Docs>
@@ -73,7 +76,6 @@
         <Parameter Name="node" Type="System.Windows.Forms.TreeNode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This version of the <see cref="M:System.Windows.Forms.TreeNodeCollection.Add(System.String)" /> method allows you to add previously created <see cref="T:System.Windows.Forms.TreeNode" /> objects to the end of the tree node collection.</para>
@@ -87,6 +89,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a previously created tree node to the end of the tree node collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index value of the <see cref="T:System.Windows.Forms.TreeNode" /> added to the tree node collection.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.TreeNode" /> to add to the collection. </param>
       </Docs>
@@ -109,7 +115,6 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Windows.Forms.TreeNode.Name" /> property corresponds to the key for a <see cref="T:System.Windows.Forms.TreeNode" /> in the <see cref="T:System.Windows.Forms.TreeNodeCollection" />.</para>
@@ -119,6 +124,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new tree node with the specified key and text, and adds it to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.TreeNode" /> that was added to the collection.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the tree node.</param>
         <param name="text">
@@ -140,7 +149,6 @@
         <Parameter Name="imageIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Windows.Forms.TreeNode.Name" /> property corresponds to the key for a <see cref="T:System.Windows.Forms.TreeNode" /> in the <see cref="T:System.Windows.Forms.TreeNodeCollection" />.</para>
@@ -151,6 +159,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a tree node with the specified key, text, and image, and adds it to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.TreeNode" /> that was added to the collection.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the tree node.</param>
         <param name="text">
@@ -174,7 +186,6 @@
         <Parameter Name="imageKey" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Windows.Forms.TreeNode.Name" /> property corresponds to the key for a <see cref="T:System.Windows.Forms.TreeNode" /> in the <see cref="T:System.Windows.Forms.TreeNodeCollection" />.</para>
@@ -185,6 +196,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a tree node with the specified key, text, and image, and adds it to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.TreeNode" /> that was added to the collection.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the tree node.</param>
         <param name="text">
@@ -209,7 +224,6 @@
         <Parameter Name="selectedImageIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Windows.Forms.TreeNode.Name" /> property corresponds to the key for a <see cref="T:System.Windows.Forms.TreeNode" /> in the <see cref="T:System.Windows.Forms.TreeNodeCollection" />.</para>
@@ -221,6 +235,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a tree node with the specified key, text, and images, and adds it to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The tree node that was added to the collection.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the tree node.</param>
         <param name="text">
@@ -247,7 +265,6 @@
         <Parameter Name="selectedImageKey" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Windows.Forms.TreeNode.Name" /> property corresponds to the key for a <see cref="T:System.Windows.Forms.TreeNode" /> in the <see cref="T:System.Windows.Forms.TreeNodeCollection" />.</para>
@@ -259,6 +276,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a tree node with the specified key, text, and images, and adds it to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.TreeNode" /> that was added to the collection.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the tree node.</param>
         <param name="text">
@@ -331,7 +352,6 @@
         <Parameter Name="node" Type="System.Windows.Forms.TreeNode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method enables you to determine whether a <see cref="T:System.Windows.Forms.TreeNode" /> is a member of the collection before attempting to perform operations on the <see cref="T:System.Windows.Forms.TreeNode" />. You can use this method to confirm that a <see cref="T:System.Windows.Forms.TreeNode" /> has been added to or is still a member of the collection. </para>
@@ -345,6 +365,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified tree node is a member of the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Windows.Forms.TreeNode" /> is a member of the collection; otherwise, false.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.TreeNode" /> to locate in the collection. </param>
       </Docs>
@@ -366,7 +390,6 @@
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Windows.Forms.TreeNode.Name" /> property corresponds to the key for a <see cref="T:System.Windows.Forms.TreeNode" /> in the <see cref="T:System.Windows.Forms.TreeNodeCollection" />.</para>
@@ -376,6 +399,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the collection contains a tree node with the specified key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true to indicate the collection contains a <see cref="T:System.Windows.Forms.TreeNode" /> with the specified key; otherwise, false. </para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Windows.Forms.TreeNode" /> to search for.</param>
       </Docs>
@@ -450,7 +477,6 @@
         <Parameter Name="searchAllChildren" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Windows.Forms.TreeNode.Name" /> property corresponds to the key for a <see cref="T:System.Windows.Forms.TreeNode" /> in the <see cref="T:System.Windows.Forms.TreeNodeCollection" />.</para>
@@ -460,6 +486,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds the tree nodes with specified key, optionally searching subnodes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Windows.Forms.TreeNode" /> objects whose <see cref="P:System.Windows.Forms.TreeNode.Name" /> property matches the specified key.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the tree node to search for.</param>
         <param name="searchAllChildren">
@@ -474,12 +504,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that can be used to iterate through the tree node collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that represents the tree node collection.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -496,7 +529,6 @@
         <Parameter Name="node" Type="System.Windows.Forms.TreeNode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The amount of time this method takes is proportional to the size of the node collection, so you may want to avoid using it with large collections.</para>
@@ -509,6 +541,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the specified tree node in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the item found in the tree node collection; otherwise, -1.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.TreeNode" /> to locate in the collection. </param>
       </Docs>
@@ -530,7 +566,6 @@
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <see cref="M:System.Windows.Forms.TreeNodeCollection.IndexOfKey(System.String)" /> is called successively, the last returned index will be checked for a key match first, and if there is no match, the search starts at the beginning of the collection.</para>
@@ -541,6 +576,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the first occurrence of a tree node with the specified key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of a tree node with the specified key, if found; otherwise, -1.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the tree node to search for.</param>
       </Docs>
@@ -559,7 +598,6 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="P:System.Windows.Forms.TreeView.Sorted" /> property is set to true, the <paramref name="index" /> parameter value is ignored. The <see cref="T:System.Windows.Forms.TreeNode" /> is inserted into the tree view and the <see cref="T:System.Windows.Forms.TreeView" /> is sorted again.</para>
@@ -569,6 +607,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a tree node with the specified text and inserts it at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.TreeNode" /> that was inserted in the collection.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The location within the collection to insert the node.</param>
         <param name="text">
@@ -624,7 +666,6 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="P:System.Windows.Forms.TreeView.Sorted" /> property is set to true, the <paramref name="index" /> parameter value is ignored. The <see cref="T:System.Windows.Forms.TreeNode" /> is inserted into the tree view and the <see cref="T:System.Windows.Forms.TreeView" /> is sorted again.</para>
@@ -635,6 +676,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a tree node with the specified text and key, and inserts it into the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.TreeNode" /> that was inserted in the collection.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The location within the collection to insert the node.</param>
         <param name="key">
@@ -659,7 +704,6 @@
         <Parameter Name="imageIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="P:System.Windows.Forms.TreeView.Sorted" /> property is set to true, the <paramref name="index" /> parameter value is ignored. The <see cref="T:System.Windows.Forms.TreeNode" /> is inserted into the tree view and the <see cref="T:System.Windows.Forms.TreeView" /> is sorted again.</para>
@@ -671,6 +715,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a tree node with the specified key, text, and image, and inserts it into the collection at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.TreeNode" /> that was inserted in the collection.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The location within the collection to insert the node.</param>
         <param name="key">
@@ -697,7 +745,6 @@
         <Parameter Name="imageKey" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="P:System.Windows.Forms.TreeView.Sorted" /> property is set to true, the <paramref name="index" /> parameter value is ignored. The <see cref="T:System.Windows.Forms.TreeNode" /> is inserted into the tree view and the <see cref="T:System.Windows.Forms.TreeView" /> is sorted again.</para>
@@ -709,6 +756,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a tree node with the specified key, text, and image, and inserts it into the collection at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.TreeNode" /> that was inserted in the collection.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The location within the collection to insert the node.</param>
         <param name="key">
@@ -736,7 +787,6 @@
         <Parameter Name="selectedImageIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="P:System.Windows.Forms.TreeView.Sorted" /> property is set to true, the <paramref name="index" /> parameter value is ignored. The <see cref="T:System.Windows.Forms.TreeNode" /> is inserted into the tree view and the <see cref="T:System.Windows.Forms.TreeView" /> is sorted again.</para>
@@ -749,6 +799,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a tree node with the specified key, text, and images, and inserts it into the collection at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.TreeNode" /> that was inserted in the collection.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The location within the collection to insert the node.</param>
         <param name="key">
@@ -778,7 +832,6 @@
         <Parameter Name="selectedImageKey" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="P:System.Windows.Forms.TreeView.Sorted" /> property is set to true, the <paramref name="index" /> parameter value is ignored. The <see cref="T:System.Windows.Forms.TreeNode" /> is inserted into the tree view and the <see cref="T:System.Windows.Forms.TreeView" /> is sorted again.</para>
@@ -791,6 +844,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a tree node with the specified key, text, and images, and inserts it into the collection at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.TreeNode" /> that was inserted in the collection.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The location within the collection to insert the node.</param>
         <param name="key">
@@ -1000,7 +1057,6 @@
         <Parameter Name="node" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="node" /> is not a <see cref="T:System.Windows.Forms.TreeNodeCollection" />, the <see cref="M:System.Windows.Forms.TreeNodeCollection.System#Collections#IList#Add(System.Object)" /> method will use the string returned by the <see cref="M:System.Windows.Forms.TreeNode.ToString" /> method of the <see cref="T:System.Windows.Forms.TreeNode" /> class.</para>
@@ -1009,6 +1065,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an object to the end of the tree node collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index value of the <see cref="T:System.Windows.Forms.TreeNode" /> that was added to the tree node collection.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to add to the tree node collection.</param>
       </Docs>
@@ -1027,7 +1087,6 @@
         <Parameter Name="node" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="node" /> is not a <see cref="T:System.Windows.Forms.TreeNode" />, the <see cref="M:System.Windows.Forms.TreeNodeCollection.System#Collections#IList#Contains(System.Object)" /> method returns false. Therefore, you cannot pass in a string to determine if the collection contains a node that has the value of the string as its <see cref="P:System.Windows.Forms.TreeNode.Text" /> property.</para>
@@ -1036,6 +1095,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified tree node is a member of the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="node" /> is a member of the collection; otherwise, false.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to find in the collection.</param>
       </Docs>
@@ -1054,7 +1117,6 @@
         <Parameter Name="node" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="node" /> is not a <see cref="T:System.Windows.Forms.TreeNode" />, the <see cref="M:System.Windows.Forms.TreeNodeCollection.System#Collections#IList#IndexOf(System.Object)" /> method returns -1. Therefore, you cannot pass in a string to find the node that has the value of the string as its <see cref="P:System.Windows.Forms.TreeNode.Text" /> property.</para>
@@ -1063,6 +1125,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the specified tree node in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the item found in the tree node collection; otherwise, -1.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.TreeNode" /> to locate in the collection.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TreeNodeConverter.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TreeNodeConverter.xml
index 15bdf492d47..58d3aa66e08 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TreeNodeConverter.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TreeNodeConverter.xml
@@ -51,7 +51,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -60,6 +59,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this converter can convert an object to the given destination type using the context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="destinationType">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TreeView.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TreeView.xml
index cd3d52234c2..3068936fc59 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TreeView.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TreeView.xml
@@ -820,12 +820,15 @@
         <Parameter Name="state" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Windows.Forms.OwnerDrawPropertyBag" /> for the specified <see cref="T:System.Windows.Forms.TreeNode" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Windows.Forms.OwnerDrawPropertyBag" /> for the specified <see cref="T:System.Windows.Forms.TreeNode" />.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.TreeNode" /> for which to return an <see cref="T:System.Windows.Forms.OwnerDrawPropertyBag" />.</param>
         <param name="state">
@@ -846,7 +849,6 @@
         <Parameter Name="pt" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can pass the <see cref="P:System.Windows.Forms.MouseEventArgs.X" /> and <see cref="P:System.Windows.Forms.MouseEventArgs.Y" /> coordinates of the <see cref="E:System.Windows.Forms.Control.MouseDown" /> event as the <see cref="P:System.Drawing.Point.X" /> and <see cref="P:System.Drawing.Point.Y" /> values of a new <see cref="T:System.Drawing.Point" />.</para>
@@ -855,6 +857,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the tree node that is at the specified point.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.TreeNode" /> at the specified point, in tree view (client) coordinates, or null if there is no node at that location.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Point" /> to evaluate and retrieve the node from. </param>
       </Docs>
@@ -874,7 +880,6 @@
         <Parameter Name="y" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can pass the <see cref="P:System.Windows.Forms.MouseEventArgs.X" /> and <see cref="P:System.Windows.Forms.MouseEventArgs.Y" /> coordinates of the <see cref="E:System.Windows.Forms.Control.MouseDown" /> event as the <paramref name="x" /> and <paramref name="y" /> parameters.</para>
@@ -883,6 +888,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the tree node at the point with the specified coordinates.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.TreeNode" /> at the specified location, in tree view (client) coordinates, or null if there is no node at that location.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Drawing.Point.X" /> position to evaluate and retrieve the node from. </param>
         <param name="y">
@@ -903,7 +912,6 @@
         <Parameter Name="includeSubTrees" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="includeSubTrees" /> is true, the result is the number of all the tree nodes in the entire tree structure.</para>
@@ -912,6 +920,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the number of tree nodes, optionally including those in all subtrees, assigned to the tree view control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of tree nodes, optionally including those in all subtrees, assigned to the tree view control.</para>
+        </returns>
         <param name="includeSubTrees">
           <attribution license="cc4" from="Microsoft" modified="false" />true to count the <see cref="T:System.Windows.Forms.TreeNode" /> items that the subtrees contain; otherwise, false. </param>
       </Docs>
@@ -963,7 +975,6 @@
         <Parameter Name="pt" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to determine whether a point is located in a <see cref="T:System.Windows.Forms.TreeNode" /> and where within the node the point is located, such as on the label or image area.</para>
@@ -972,6 +983,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides node information, given a point.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node information.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Point" /> at which to retrieve node information.</param>
       </Docs>
@@ -990,7 +1005,6 @@
         <Parameter Name="y" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to determine whether a set of x- and y-coordinates is located in a <see cref="T:System.Windows.Forms.TreeNode" /> and where within the node the point is located, such as on the label or image area.</para>
@@ -999,6 +1013,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides node information, given x- and y-coordinates.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node information.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate at which to retrieve node information </param>
         <param name="y">
@@ -1194,7 +1212,6 @@
         <Parameter Name="keyData" Type="System.Windows.Forms.Keys" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the user is editing a tree node, the <see cref="T:System.Windows.Forms.TreeView" /> control treats keys such as ENTER, ESC, HOME, and END as input keys.</para>
@@ -1203,6 +1220,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified key is a regular input key or a special key that requires preprocessing.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified key is a regular input key; otherwise, false.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the Keys values.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TreeViewImageKeyConverter.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TreeViewImageKeyConverter.xml
index d340ddddc77..6d1244c1c05 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TreeViewImageKeyConverter.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/TreeViewImageKeyConverter.xml
@@ -54,12 +54,15 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object to an object of the specified type using the specified culture information and context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted <paramref name="value" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context, which can be used to extract additional information about the environment this type converter is being invoked from. This parameter or properties of this parameter can be null.</param>
         <param name="culture">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/WebBrowser.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/WebBrowser.xml
index 323e01d6157..85e15519e0a 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/WebBrowser.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/WebBrowser.xml
@@ -323,7 +323,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is useful if you are familiar with OLE development using the unmanaged WebBrowser ActiveX control and you want to extend the functionality of the Windows Forms <see cref="T:System.Windows.Forms.WebBrowser" /> control, which is a managed wrapper for the ActiveX control. You can use this extensibility, for example, to customize the browser shortcut menu and shortcut keys or to provide a custom security configuration for hosted documents.</para>
@@ -336,6 +335,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a reference to the unmanaged WebBrowser ActiveX control site, which you can extend to customize the managed <see cref="T:System.Windows.Forms.WebBrowser" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.WebBrowser.WebBrowserSite" /> that represents the WebBrowser ActiveX control site.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DefaultSize">
@@ -760,7 +763,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Windows.Forms.WebBrowser" /> control maintains a history list of all the Web pages visited during a browsing session. You can use the <see cref="M:System.Windows.Forms.WebBrowser.GoBack" /> method to implement a <ui>Back</ui> button similar to the one in Internet Explorer, which will allow your users to return to a previous page in the navigation history.</para>
@@ -770,6 +772,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Navigates the <see cref="T:System.Windows.Forms.WebBrowser" /> control to the previous page in the navigation history, if one is available.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the navigation succeeds; false if a previous page in the navigation history is not available.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GoForward">
@@ -783,7 +789,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Windows.Forms.WebBrowser" /> control maintains a history list of all the Web pages visited during a browsing session. You can use the <see cref="M:System.Windows.Forms.WebBrowser.GoForward" /> method to implement a <ui>Forward</ui> button similar to the one in Internet Explorer, allowing your users to return to the next page in the navigation history after navigating backward.</para>
@@ -793,6 +798,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Navigates the <see cref="T:System.Windows.Forms.WebBrowser" /> control to the next page in the navigation history, if one is available.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the navigation succeeds; false if a subsequent page in the navigation history is not available.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GoHome">
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/WebBrowserBase.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/WebBrowserBase.xml
index 3c4f4a78867..18284a834e7 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/WebBrowserBase.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/WebBrowserBase.xml
@@ -386,12 +386,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a reference to the unmanaged ActiveX control site.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.WebBrowserSiteBase" /> that represents the site of the underlying ActiveX control.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Cursor">
@@ -989,12 +992,15 @@
         <Parameter Name="charCode" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if a character is an input character that the control recognizes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character should be sent directly to the control and not preprocessed; otherwise, false.</para>
+        </returns>
         <param name="charCode">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to test.</param>
       </Docs>
@@ -1638,12 +1644,15 @@
         <Parameter Name="charCode" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a mnemonic character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character was processed as a mnemonic by the control; otherwise, false.</para>
+        </returns>
         <param name="charCode">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to process.</param>
       </Docs>
diff --git a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/WindowsFormsSynchronizationContext.xml b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/WindowsFormsSynchronizationContext.xml
index e960de4f9ff..b825e0a41d9 100644
--- a/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/WindowsFormsSynchronizationContext.xml
+++ b/mcs/class/Managed.Windows.Forms/Documentation/en/System.Windows.Forms/WindowsFormsSynchronizationContext.xml
@@ -73,12 +73,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the synchronization context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the synchronization context.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Dispose">
diff --git a/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/BuildItem.xml b/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/BuildItem.xml
index 7d5180f346d..be3fdf179ec 100644
--- a/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/BuildItem.xml
+++ b/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/BuildItem.xml
@@ -75,13 +75,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a shallow copy of the <see cref="T:Microsoft.Build.BuildEngine.BuildItem" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the <see cref="T:Microsoft.Build.BuildEngine.BuildItem" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -177,13 +180,16 @@
         <Parameter Name="metadataName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified item metadata after after all item and property references have been evaluated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified item metadata after after all item and property references have been evaluated.</para>
+        </returns>
         <param name="metadataName">
           <attribution license="cc4" from="Microsoft" modified="false" />The item metadata name.</param>
       </Docs>
@@ -201,13 +207,16 @@
         <Parameter Name="metadataName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified item metadata.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified item metadata.</para>
+        </returns>
         <param name="metadataName">
           <attribution license="cc4" from="Microsoft" modified="false" />The item metadata name.</param>
       </Docs>
@@ -225,13 +234,16 @@
         <Parameter Name="metadataName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the item has the specified item metadata.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the item has the specified item metadata; otherwise, false.</para>
+        </returns>
         <param name="metadataName">
           <attribution license="cc4" from="Microsoft" modified="false" />The item metadata name.</param>
       </Docs>
diff --git a/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/BuildItemGroup.xml b/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/BuildItemGroup.xml
index adc277a6e38..47d019751b9 100644
--- a/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/BuildItemGroup.xml
+++ b/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/BuildItemGroup.xml
@@ -52,13 +52,16 @@
         <Parameter Name="itemInclude" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new <see cref="T:Microsoft.Build.BuildEngine.BuildItem" /> with the specified <see cref="P:Microsoft.Build.BuildEngine.BuildItem.Name" /> and <see cref="P:Microsoft.Build.BuildEngine.BuildItem.Include" /> property values to the <see cref="T:Microsoft.Build.BuildEngine.BuildItemGroup" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:Microsoft.Build.BuildEngine.BuildItem" />.</para>
+        </returns>
         <param name="itemName">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:Microsoft.Build.BuildEngine.BuildItem.Name" /> property value to assign the new <see cref="T:Microsoft.Build.BuildEngine.BuildItem" />.</param>
         <param name="itemInclude">
@@ -80,13 +83,16 @@
         <Parameter Name="treatItemIncludeAsLiteral" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new <see cref="T:Microsoft.Build.BuildEngine.BuildItem" /> with the specified <see cref="P:Microsoft.Build.BuildEngine.BuildItem.Name" /> and <see cref="P:Microsoft.Build.BuildEngine.BuildItem.Include" /> property values to the <see cref="T:Microsoft.Build.BuildEngine.BuildItemGroup" />, allowing you to specify whether the <see cref="P:Microsoft.Build.BuildEngine.BuildItem.Include" /> property value is treated as a literal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:Microsoft.Build.BuildEngine.BuildItem" />.</para>
+        </returns>
         <param name="itemName">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:Microsoft.Build.BuildEngine.BuildItem.Name" /> property value to assign the new <see cref="T:Microsoft.Build.BuildEngine.BuildItem" />.</param>
         <param name="itemInclude">
@@ -127,7 +133,6 @@
         <Parameter Name="deepClone" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -139,6 +144,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a deep or shallow copy of the <see cref="T:Microsoft.Build.BuildEngine.BuildItemGroup" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the <see cref="T:Microsoft.Build.BuildEngine.BuildItemGroup" />.</para>
+        </returns>
         <param name="deepClone">
           <attribution license="cc4" from="Microsoft" modified="false" />true to create a deep copy of the <see cref="T:Microsoft.Build.BuildEngine.BuildItemGroup" />; otherwise, false.</param>
       </Docs>
@@ -192,7 +201,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -202,6 +210,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an enumerator that iterates through the <see cref="T:Microsoft.Build.BuildEngine.BuildItemGroup" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the entire <see cref="T:Microsoft.Build.BuildEngine.BuildItemGroup" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -300,13 +312,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the <see cref="T:Microsoft.Build.BuildEngine.BuildItem" /> objects in the <see cref="T:Microsoft.Build.BuildEngine.BuildItemGroup" /> to a new array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new array containing the <see cref="T:Microsoft.Build.BuildEngine.BuildItem" /> objects copied from the <see cref="T:Microsoft.Build.BuildEngine.BuildItemGroup" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/BuildItemGroupCollection.xml b/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/BuildItemGroupCollection.xml
index 757217aab41..8a7504db003 100644
--- a/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/BuildItemGroupCollection.xml
+++ b/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/BuildItemGroupCollection.xml
@@ -78,7 +78,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -88,6 +87,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an enumerator that iterates through the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the entire <see cref="T:Microsoft.Build.BuildEngine.BuildItemGroupCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/BuildProperty.xml b/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/BuildProperty.xml
index 67eeda9f519..ee2231a8f92 100644
--- a/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/BuildProperty.xml
+++ b/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/BuildProperty.xml
@@ -51,7 +51,6 @@
         <Parameter Name="deepClone" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -62,6 +61,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a deep or shallow copy of the <see cref="T:Microsoft.Build.BuildEngine.BuildProperty" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the <see cref="T:Microsoft.Build.BuildEngine.BuildProperty" />.</para>
+        </returns>
         <param name="deepClone">
           <attribution license="cc4" from="Microsoft" modified="false" />true to create a deep copy of the <see cref="T:Microsoft.Build.BuildEngine.BuildProperty" />; otherwise, false.</param>
       </Docs>
@@ -176,12 +179,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the string that represents the property <see cref="P:Microsoft.Build.BuildEngine.BuildProperty.Value" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string that represents the property <see cref="P:Microsoft.Build.BuildEngine.BuildProperty.Value" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/BuildPropertyGroup.xml b/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/BuildPropertyGroup.xml
index 2e2a6ecc5d2..fbc7c1ba6e4 100644
--- a/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/BuildPropertyGroup.xml
+++ b/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/BuildPropertyGroup.xml
@@ -52,13 +52,16 @@
         <Parameter Name="propertyValue" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new <see cref="T:Microsoft.Build.BuildEngine.BuildProperty" /> with the specified <see cref="P:Microsoft.Build.BuildEngine.BuildProperty.Name" /> and <see cref="P:Microsoft.Build.BuildEngine.BuildProperty.Value" /> to the <see cref="T:Microsoft.Build.BuildEngine.BuildPropertyGroup" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:Microsoft.Build.BuildEngine.BuildProperty" />.</para>
+        </returns>
         <param name="propertyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:Microsoft.Build.BuildEngine.BuildProperty.Name" /> property value to assign the new <see cref="T:Microsoft.Build.BuildEngine.BuildProperty" />.</param>
         <param name="propertyValue">
@@ -80,13 +83,16 @@
         <Parameter Name="treatPropertyValueAsLiteral" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new <see cref="T:Microsoft.Build.BuildEngine.BuildProperty" /> with the specified <see cref="P:Microsoft.Build.BuildEngine.BuildProperty.Name" /> and <see cref="P:Microsoft.Build.BuildEngine.BuildProperty.Value" /> to the <see cref="T:Microsoft.Build.BuildEngine.BuildPropertyGroup" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:Microsoft.Build.BuildEngine.BuildProperty" />.</para>
+        </returns>
         <param name="propertyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:Microsoft.Build.BuildEngine.BuildProperty.Name" /> property value to assign the new <see cref="T:Microsoft.Build.BuildEngine.BuildProperty" />.</param>
         <param name="propertyValue">
@@ -127,7 +133,6 @@
         <Parameter Name="deepClone" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -139,6 +144,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a deep or shallow copy of the <see cref="T:Microsoft.Build.BuildEngine.BuildPropertyGroup" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the <see cref="T:Microsoft.Build.BuildEngine.BuildPropertyGroup" />.</para>
+        </returns>
         <param name="deepClone">
           <attribution license="cc4" from="Microsoft" modified="false" />true to create a deep copy of the <see cref="T:Microsoft.Build.BuildEngine.BuildPropertyGroup" />; otherwise, false.</param>
       </Docs>
@@ -195,7 +204,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -205,6 +213,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an enumerator that iterates through the <see cref="T:Microsoft.Build.BuildEngine.BuildPropertyGroup" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the entire <see cref="T:Microsoft.Build.BuildEngine.BuildPropertyGroup" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/BuildPropertyGroupCollection.xml b/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/BuildPropertyGroupCollection.xml
index 7190f7099f0..a79c706d34c 100644
--- a/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/BuildPropertyGroupCollection.xml
+++ b/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/BuildPropertyGroupCollection.xml
@@ -78,7 +78,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -88,6 +87,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an enumerator that iterates through the <see cref="T:Microsoft.Build.BuildEngine.BuildPropertyGroupCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the entire <see cref="T:Microsoft.Build.BuildEngine.BuildPropertyGroupCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/BuildTask.xml b/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/BuildTask.xml
index 3e63b5d5333..0104b770835 100644
--- a/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/BuildTask.xml
+++ b/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/BuildTask.xml
@@ -116,13 +116,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Runs the task represented by this <see cref="T:Microsoft.Build.BuildEngine.BuildTask" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the method was successful; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -136,7 +139,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -147,6 +149,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array containing the parameter names passed to the task.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array containing the parameter names passed to the task.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -162,13 +168,16 @@
         <Parameter Name="attributeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified task parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified task parameter.</para>
+        </returns>
         <param name="attributeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The parameter name.</param>
       </Docs>
diff --git a/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/Engine.xml b/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/Engine.xml
index 117fbe8ae36..2c3045e5a8c 100644
--- a/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/Engine.xml
+++ b/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/Engine.xml
@@ -129,13 +129,16 @@
         <Parameter Name="project" Type="Microsoft.Build.BuildEngine.Project" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds the specified <see cref="T:Microsoft.Build.BuildEngine.Project" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the build was successful; otherwise, false.</para>
+        </returns>
         <param name="project">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:Microsoft.Build.BuildEngine.Project" /> to build.</param>
       </Docs>
@@ -154,13 +157,16 @@
         <Parameter Name="targetName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds the specified target of the specified <see cref="T:Microsoft.Build.BuildEngine.Project" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the build was successful; otherwise, false.</para>
+        </returns>
         <param name="project">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:Microsoft.Build.BuildEngine.Project" /> to build.</param>
         <param name="targetName">
@@ -181,13 +187,16 @@
         <Parameter Name="targetNames" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds the specified targets of the specified <see cref="T:Microsoft.Build.BuildEngine.Project" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the build was successful; otherwise, false.</para>
+        </returns>
         <param name="project">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:Microsoft.Build.BuildEngine.Project" /> to build.</param>
         <param name="targetNames">
@@ -209,13 +218,16 @@
         <Parameter Name="targetOutputs" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds the specified targets of the specified <see cref="T:Microsoft.Build.BuildEngine.Project" />, and returns the outputs of the targets.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the build was successful; otherwise, false.</para>
+        </returns>
         <param name="project">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:Microsoft.Build.BuildEngine.Project" /> to build.</param>
         <param name="targetNames">
@@ -240,13 +252,16 @@
         <Parameter Name="buildFlags" Type="Microsoft.Build.BuildEngine.BuildSettings" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds the specified targets of the specified <see cref="T:Microsoft.Build.BuildEngine.Project" /> with the specified <see cref="T:Microsoft.Build.BuildEngine.BuildSettings" />, and returns the outputs of the targets.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the build was successful; otherwise, false.</para>
+        </returns>
         <param name="project">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:Microsoft.Build.BuildEngine.Project" /> to build.</param>
         <param name="targetNames">
@@ -270,13 +285,16 @@
         <Parameter Name="projectFile" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads the specified project file and builds the project.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the build was successful; otherwise, false.</para>
+        </returns>
         <param name="projectFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The project file to load and build.</param>
       </Docs>
@@ -295,13 +313,16 @@
         <Parameter Name="targetName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads the specified project file and builds the specified target of the project.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the build was successful; otherwise, false.</para>
+        </returns>
         <param name="projectFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The project file to load and build.</param>
         <param name="targetName">
@@ -322,13 +343,16 @@
         <Parameter Name="targetNames" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads the specified project file and builds the specified targets of the project.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the build was successful; otherwise, false.</para>
+        </returns>
         <param name="projectFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The project file to load and build.</param>
         <param name="targetNames">
@@ -350,13 +374,16 @@
         <Parameter Name="globalProperties" Type="Microsoft.Build.BuildEngine.BuildPropertyGroup" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads the specified project file and builds the specified targets of the project with the specified <see cref="P:Microsoft.Build.BuildEngine.Engine.GlobalProperties" />, and returns the outputs of the targets.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the build was successful; otherwise, false.</para>
+        </returns>
         <param name="projectFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The project file to load and build.</param>
         <param name="targetNames">
@@ -381,13 +408,16 @@
         <Parameter Name="targetOutputs" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads the specified project file and builds the specified targets of the project with the specified <see cref="P:Microsoft.Build.BuildEngine.Engine.GlobalProperties" />, and returns the outputs of the targets.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the build was successful; otherwise, false.</para>
+        </returns>
         <param name="projectFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The project file to load and build.</param>
         <param name="targetNames">
@@ -415,13 +445,16 @@
         <Parameter Name="buildFlags" Type="Microsoft.Build.BuildEngine.BuildSettings" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads the specified project file and builds the specified targets of the project with the specified <see cref="T:Microsoft.Build.BuildEngine.BuildSettings" /> and <see cref="P:Microsoft.Build.BuildEngine.Engine.GlobalProperties" />, and returns the outputs of the targets.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the build was successful; otherwise, false.</para>
+        </returns>
         <param name="projectFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The project file to load and build.</param>
         <param name="targetNames">
@@ -445,13 +478,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an empty <see cref="T:Microsoft.Build.BuildEngine.Project" /> object that is associated with this <see cref="T:Microsoft.Build.BuildEngine.Engine" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:Microsoft.Build.BuildEngine.Project" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -467,13 +503,16 @@
         <Parameter Name="projectFullFileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:Microsoft.Build.BuildEngine.Project" /> object that is associated with the specified project file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:Microsoft.Build.BuildEngine.Project" /> object that associated with the specified project file. If no <see cref="T:Microsoft.Build.BuildEngine.Project" /> object is associated with the specified project file, the method returns a null reference (Nothing in vbprvb).</para>
+        </returns>
         <param name="projectFullFileName">
           <attribution license="cc4" from="Microsoft" modified="false" />The fully qualified file path to the project file of the <see cref="T:Microsoft.Build.BuildEngine.Project" /> object.</param>
       </Docs>
diff --git a/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/ImportCollection.xml b/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/ImportCollection.xml
index a05ef70f73f..af4ab69a7d3 100644
--- a/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/ImportCollection.xml
+++ b/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/ImportCollection.xml
@@ -104,7 +104,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -114,6 +113,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an enumerator that iterates through the <see cref="T:Microsoft.Build.BuildEngine.ImportCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the entire <see cref="T:Microsoft.Build.BuildEngine.ImportCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/Project.xml b/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/Project.xml
index c5a8612572e..438975f4bec 100644
--- a/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/Project.xml
+++ b/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/Project.xml
@@ -93,7 +93,6 @@
         <Parameter Name="itemInclude" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -103,6 +102,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <format type="text/html"><a href="dcef5f91-0613-4bfc-8ee9-d7004bb6d3a9">Item</a></format> element to the project.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:Microsoft.Build.BuildEngine.BuildItem" /> containing the created item.</para>
+        </returns>
         <param name="itemName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the item collection to add the item to. Corresponds to the user-defined name of the Item element.</param>
         <param name="itemInclude">
@@ -124,7 +127,6 @@
         <Parameter Name="treatItemIncludeAsLiteral" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -134,6 +136,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <format type="text/html"><a href="dcef5f91-0613-4bfc-8ee9-d7004bb6d3a9">Item</a></format> element to the project.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:Microsoft.Build.BuildEngine.BuildItem" /> containing the created item.</para>
+        </returns>
         <param name="itemName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the item collection to add the item to. Corresponds to the user-defined name of the Item element.</param>
         <param name="itemInclude">
@@ -153,13 +159,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new <format type="text/html"><a href="aac894e3-a9f1-4bbc-a796-6ef07001f35b">ItemGroup</a></format> element to the project.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:Microsoft.Build.BuildEngine.BuildItemGroup" /> containing the created item group.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -175,13 +184,16 @@
         <Parameter Name="insertAtEndOfProject" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new <format type="text/html"><a href="ff1e6c68-b9a1-4263-a1ce-dc3b829a64d4">PropertyGroup</a></format> element to the project.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:Microsoft.Build.BuildEngine.BuildPropertyGroup" /> containing the created property group.</para>
+        </returns>
         <param name="insertAtEndOfProject">
           <attribution license="cc4" from="Microsoft" modified="false" />true to insert the PropertyGroup at the end of the project; otherwise, false.</param>
       </Docs>
@@ -249,13 +261,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds the default targets of the project.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the build was successful; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -271,13 +286,16 @@
         <Parameter Name="targetName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds the specified target in the project.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the build was successful; otherwise, false.</para>
+        </returns>
         <param name="targetName">
           <attribution license="cc4" from="Microsoft" modified="false" />The target to build.</param>
       </Docs>
@@ -295,13 +313,16 @@
         <Parameter Name="targetNames" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds the specified list of targets in the project.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the build was successful; otherwise, false.</para>
+        </returns>
         <param name="targetNames">
           <attribution license="cc4" from="Microsoft" modified="false" />The list of targets to build. This parameter can be a null reference (Nothing in vbprvb) to build the default targets.</param>
       </Docs>
@@ -320,13 +341,16 @@
         <Parameter Name="targetOutputs" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds the specified list of targets in the project, and returns the outputs of the targets.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the build was successful; otherwise, false.</para>
+        </returns>
         <param name="targetNames">
           <attribution license="cc4" from="Microsoft" modified="false" />The list of targets to build. This parameter can be a null reference (Nothing in vbprvb) to build the default targets.</param>
         <param name="targetOutputs">
@@ -348,13 +372,16 @@
         <Parameter Name="buildFlags" Type="Microsoft.Build.BuildEngine.BuildSettings" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds the specified list of targets in the project using the specified settings, and returns the outputs of the targets.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the build was successful; otherwise, false.</para>
+        </returns>
         <param name="targetNames">
           <attribution license="cc4" from="Microsoft" modified="false" />The list of targets to build. This parameter can be a null reference (Nothing in vbprvb) to build the default targets.</param>
         <param name="targetOutputs">
@@ -527,7 +554,6 @@
         <Parameter Name="propertyName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -537,6 +563,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a list of possible values for the specified property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The list of possible values for the property.</para>
+        </returns>
         <param name="propertyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The property to use when generating the list of possible values.</param>
       </Docs>
@@ -554,13 +584,16 @@
         <Parameter Name="itemName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all evaluated items belonging to the specified item collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:Microsoft.Build.BuildEngine.BuildItemGroup" /> containing all of the evaluated items belonging to the specified item collection.</para>
+        </returns>
         <param name="itemName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the item collection.</param>
       </Docs>
@@ -578,13 +611,16 @@
         <Parameter Name="itemName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all items belonging to the specified item collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:Microsoft.Build.BuildEngine.BuildItemGroup" /> containing all items belonging to the specified item collection, even those not used in the build process because a <format type="text/html"><a href="9d7aa308-b667-48ed-b4c9-a61e49eb0a85">Condition</a></format> attribute evaluated to false..</para>
+        </returns>
         <param name="itemName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the specified item collection.</param>
       </Docs>
@@ -602,7 +638,6 @@
         <Parameter Name="propertyName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -612,6 +647,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified property.</para>
+        </returns>
         <param name="propertyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the property.</param>
       </Docs>
@@ -629,13 +668,16 @@
         <Parameter Name="id" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string value of the XML from the specified element in the <format type="text/html"><a href="f95f312f-ff92-41eb-9469-ad99e236a307">ProjectExtensions</a></format> element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string value of the specified element in the <unmanagedCodeEntityReference>ProjectExtensions</unmanagedCodeEntityReference> element of the project.</para>
+        </returns>
         <param name="id">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the element in the ProjectExtensions element to return.</param>
       </Docs>
diff --git a/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/Target.xml b/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/Target.xml
index 9e96b61883b..807f5232dbd 100644
--- a/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/Target.xml
+++ b/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/Target.xml
@@ -32,13 +32,16 @@
         <Parameter Name="taskName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <format type="text/html"><a href="d82e2485-e5f0-4936-a357-745bacccc299">Task</a></format> element to the <format type="text/html"><a href="350f6fc2-86b3-45f2-a31e-ece0e6bd4dca">Target</a></format> element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:Microsoft.Build.BuildEngine.BuildTask" /> object represents a child <unmanagedCodeEntityReference>Task</unmanagedCodeEntityReference> element of the <unmanagedCodeEntityReference>Target</unmanagedCodeEntityReference> element.</para>
+        </returns>
         <param name="taskName">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:Microsoft.Build.BuildEngine.BuildTask" /> object that represents the Task element to add to the Target element.</param>
       </Docs>
@@ -92,7 +95,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -103,6 +105,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an enumerator that iterates through the <see cref="T:Microsoft.Build.BuildEngine.BuildTask" /> objects in the <see cref="T:Microsoft.Build.BuildEngine.Target" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:Microsoft.Build.BuildEngine.BuildTask" /> objects in the <see cref="T:Microsoft.Build.BuildEngine.Target" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/TargetCollection.xml b/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/TargetCollection.xml
index 2bb1c612b33..faa77785328 100644
--- a/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/TargetCollection.xml
+++ b/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/TargetCollection.xml
@@ -32,13 +32,16 @@
         <Parameter Name="targetName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new <format type="text/html"><a href="350f6fc2-86b3-45f2-a31e-ece0e6bd4dca">Target</a></format> element to the end of the project.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:Microsoft.Build.BuildEngine.Target" /> object representing the created <unmanagedCodeEntityReference>Target</unmanagedCodeEntityReference> element.</para>
+        </returns>
         <param name="targetName">
           <attribution license="cc4" from="Microsoft" modified="false" />The Name attribute of the new Target element.</param>
       </Docs>
@@ -104,13 +107,16 @@
         <Parameter Name="targetName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:Microsoft.Build.BuildEngine.Target" /> exists in the <see cref="T:Microsoft.Build.BuildEngine.TargetCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <unmanagedCodeEntityReference>Target</unmanagedCodeEntityReference> element exists; otherwise, false.</para>
+        </returns>
         <param name="targetName">
           <attribution license="cc4" from="Microsoft" modified="false" />The Name attribute of the Target element to search for.</param>
       </Docs>
@@ -126,7 +132,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -136,6 +141,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an enumerator that iterates through the <see cref="T:Microsoft.Build.BuildEngine.TargetCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the entire <see cref="T:Microsoft.Build.BuildEngine.TargetCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/UsingTaskCollection.xml b/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/UsingTaskCollection.xml
index c1187c29f15..f5b04723b2f 100644
--- a/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/UsingTaskCollection.xml
+++ b/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/UsingTaskCollection.xml
@@ -104,7 +104,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -114,6 +113,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an enumerator that iterates through the <see cref="T:Microsoft.Build.BuildEngine.UsingTaskCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the entire <see cref="T:Microsoft.Build.BuildEngine.UsingTaskCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/Utilities.xml b/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/Utilities.xml
index 86cb6af4760..3f544303a40 100644
--- a/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/Utilities.xml
+++ b/mcs/class/Microsoft.Build.Engine/Documentation/en/Microsoft.Build.BuildEngine/Utilities.xml
@@ -28,7 +28,6 @@
         <Parameter Name="unescapedExpression" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -38,6 +37,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string into a syntax that allows the vstecmsbuild engine to interpret the character literally.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value of the specified string.</para>
+        </returns>
         <param name="unescapedExpression">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert.</param>
       </Docs>
diff --git a/mcs/class/Microsoft.Build.Framework/Documentation/en/Microsoft.Build.Framework/IBuildEngine.xml b/mcs/class/Microsoft.Build.Framework/Documentation/en/Microsoft.Build.Framework/IBuildEngine.xml
index 631f9a0ab1c..edd5ed64a1c 100644
--- a/mcs/class/Microsoft.Build.Framework/Documentation/en/Microsoft.Build.Framework/IBuildEngine.xml
+++ b/mcs/class/Microsoft.Build.Framework/Documentation/en/Microsoft.Build.Framework/IBuildEngine.xml
@@ -28,7 +28,6 @@
         <Parameter Name="targetOutputs" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -40,6 +39,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initiates a build of a project file. If the build is successful, the outputs, if any, of the specified targets are returned.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the build was successful; otherwise, false.</para>
+        </returns>
         <param name="projectFileName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the project file to build.</param>
         <param name="targetNames">
diff --git a/mcs/class/Microsoft.Build.Framework/Documentation/en/Microsoft.Build.Framework/ITask.xml b/mcs/class/Microsoft.Build.Framework/Documentation/en/Microsoft.Build.Framework/ITask.xml
index e6fba6226ea..e02608c0fc7 100644
--- a/mcs/class/Microsoft.Build.Framework/Documentation/en/Microsoft.Build.Framework/ITask.xml
+++ b/mcs/class/Microsoft.Build.Framework/Documentation/en/Microsoft.Build.Framework/ITask.xml
@@ -45,7 +45,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -55,6 +54,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a task.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the task executed successfully; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Microsoft.Build.Framework/Documentation/en/Microsoft.Build.Framework/ITaskItem.xml b/mcs/class/Microsoft.Build.Framework/Documentation/en/Microsoft.Build.Framework/ITaskItem.xml
index 7dd74cebdb0..896c22cb057 100644
--- a/mcs/class/Microsoft.Build.Framework/Documentation/en/Microsoft.Build.Framework/ITaskItem.xml
+++ b/mcs/class/Microsoft.Build.Framework/Documentation/en/Microsoft.Build.Framework/ITaskItem.xml
@@ -42,7 +42,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -62,6 +61,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the collection of custom metadata.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The collection of custom metadata.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -114,13 +117,16 @@
         <Parameter Name="metadataName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified metadata entry.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the <paramref name="attributeName" /> metadata.</para>
+        </returns>
         <param name="metadataName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the metadata entry.</param>
       </Docs>
diff --git a/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/AppDomainIsolatedTask.xml b/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/AppDomainIsolatedTask.xml
index 9ddaea9425f..6bcc39e7c09 100644
--- a/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/AppDomainIsolatedTask.xml
+++ b/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/AppDomainIsolatedTask.xml
@@ -119,7 +119,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -129,6 +128,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Runs the task.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if successful; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -189,7 +192,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Otherwise, a limited lease of 5 minutes will result; and task instances can expire if they take a long time to process.</para>
@@ -198,6 +200,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, gives tasks infinite lease time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>null to specify an infinite lifetime.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Log">
diff --git a/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/CommandLineBuilder.xml b/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/CommandLineBuilder.xml
index 03a8cb568fb..c950a6a6c30 100644
--- a/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/CommandLineBuilder.xml
+++ b/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/CommandLineBuilder.xml
@@ -553,13 +553,16 @@
         <Parameter Name="parameter" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified string parameter should be surrounded with quotation marks because it contains white space.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if the switch parameter should be surrounded with quotation marks; otherwise, false.</para>
+        </returns>
         <param name="parameter">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to examine for characters that require quotation marks.</param>
       </Docs>
@@ -578,12 +581,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the command line as a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that represents the command line.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="VerifyThrowNoEmbeddedDoubleQuotes">
diff --git a/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/Logger.xml b/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/Logger.xml
index e3225a3f84e..0fef0d85f0a 100644
--- a/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/Logger.xml
+++ b/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/Logger.xml
@@ -52,13 +52,16 @@
         <Parameter Name="args" Type="Microsoft.Build.Framework.BuildErrorEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates an error message that is in the default format, from a <see cref="T:Microsoft.Build.Framework.BuildErrorEventArgs" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that represents an error message in canonical format.</para>
+        </returns>
         <param name="args">
           <attribution license="cc4" from="Microsoft" modified="false" />The arguments of the error event.</param>
       </Docs>
@@ -76,13 +79,16 @@
         <Parameter Name="args" Type="Microsoft.Build.Framework.BuildWarningEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a warning message that is in the default format, from a <see cref="T:Microsoft.Build.Framework.BuildWarningEventArgs" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that represents a warning message in canonical format.</para>
+        </returns>
         <param name="args">
           <attribution license="cc4" from="Microsoft" modified="false" />The arguments of the warning event.</param>
       </Docs>
@@ -127,13 +133,16 @@
       </Parameters>
       <Docs>
         <param name="verbosity">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current <see cref="P:Microsoft.Build.Utilities.Logger.Verbosity" /> setting is at least the value that is passed in.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current logger verbosity setting is at least the value that is passed in; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/Task.xml b/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/Task.xml
index bfe20ff3309..f52ff2ee12c 100644
--- a/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/Task.xml
+++ b/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/Task.xml
@@ -121,7 +121,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -131,6 +130,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, executes the task.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the task successfully executed; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/TaskItem.xml b/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/TaskItem.xml
index bdb782eb2b5..4f5f14fe44a 100644
--- a/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/TaskItem.xml
+++ b/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/TaskItem.xml
@@ -117,7 +117,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -127,6 +126,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clones the collection of custom metadata for the item specification.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IDictionary" /> that represents a clone of the custom metadata.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -169,13 +172,16 @@
         <Parameter Name="metadataName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the specified metadata on the item.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that represents the metadata value.</para>
+        </returns>
         <param name="metadataName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the metadata to retrieve.</param>
       </Docs>
@@ -194,7 +200,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Otherwise, a limited lease of 5 minutes will result; and task instances can expire if they take a long time to process.</para>
@@ -203,6 +208,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, gives task items infinite lease time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>null to specify an infinite lifetime.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ItemSpec">
@@ -348,12 +357,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the item specification.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that represents the item specification.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/TaskLoggingHelper.xml b/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/TaskLoggingHelper.xml
index 6091f90dc43..41c91825958 100644
--- a/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/TaskLoggingHelper.xml
+++ b/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/TaskLoggingHelper.xml
@@ -96,7 +96,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -107,6 +106,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads the specified resource string and optionally formats it using the given arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The formatted string.</para>
+        </returns>
         <param name="resourceName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the string resource to load.</param>
         <param name="args">
@@ -133,7 +136,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -143,6 +145,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Formats the given string using the given arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The formatted string.</para>
+        </returns>
         <param name="unformatted">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to format.</param>
         <param name="args">
@@ -805,7 +811,6 @@
       </Parameters>
       <Docs>
         <param name="importance">To be added.</param>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -815,6 +820,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Logs an error message or warning from the given line of text.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if an error was logged; otherwise, false.</para>
+        </returns>
         <param name="lineOfText">
           <attribution license="cc4" from="Microsoft" modified="false" />The line of text to log from.</param>
       </Docs>
@@ -833,7 +842,6 @@
       </Parameters>
       <Docs>
         <param name="filename">To be added.</param>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -843,6 +851,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Logs errors, warnings, and messages for each line of text in the given file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true to indicate at least one error was logged; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -860,7 +872,6 @@
       </Parameters>
       <Docs>
         <param name="filename">To be added.</param>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -870,6 +881,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Logs errors, warnings, and messages for each line of text in the given file. Also logs the importance of messages.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true to indicate at least one error was logged; otherwise, false.</para>
+        </returns>
         <param name="messageImportance">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the enumeration values that specifies the importance of logged messages.</param>
       </Docs>
@@ -888,7 +903,6 @@
         <Parameter Name="messageImportance" Type="Microsoft.Build.Framework.MessageImportance" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -898,6 +912,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Logs an error message or warning from the given stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if an error was logged; otherwise, false.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IO.TextReader" /> that reads the stream to log from.</param>
         <param name="messageImportance">
diff --git a/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/ToolLocationHelper.xml b/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/ToolLocationHelper.xml
index 56265e88fd7..dfc30049803 100644
--- a/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/ToolLocationHelper.xml
+++ b/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/ToolLocationHelper.xml
@@ -28,13 +28,16 @@
         <Parameter Name="version" Type="Microsoft.Build.Utilities.TargetDotNetFrameworkVersion" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the full name of the dnprdnshort root registry key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the full name of the dnprdnshort root registry key.</para>
+        </returns>
         <param name="version">
           <attribution license="cc4" from="Microsoft" modified="false" />The version of the dnprdnshort to target.</param>
       </Docs>
@@ -52,13 +55,16 @@
         <Parameter Name="version" Type="Microsoft.Build.Utilities.TargetDotNetFrameworkVersion" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the name of the value under the <see cref="M:Microsoft.Build.Utilities.ToolLocationHelper.GetDotNetFrameworkRootRegistryKey(Microsoft.Build.Utilities.TargetDotNetFrameworkVersion)" /> that contains the dnprdnshort SDK installation path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a string containing the name of the registry key value under the <see cref="M:Microsoft.Build.Utilities.ToolLocationHelper.GetDotNetFrameworkRootRegistryKey(Microsoft.Build.Utilities.TargetDotNetFrameworkVersion)" /> that contains the dnprdnshort SDK installation path.</para>
+        </returns>
         <param name="version">
           <attribution license="cc4" from="Microsoft" modified="false" />The version of the dnprdnshort to target.</param>
       </Docs>
@@ -76,7 +82,6 @@
         <Parameter Name="version" Type="Microsoft.Build.Utilities.TargetDotNetFrameworkVersion" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -86,6 +91,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the prefix of the dnprdnshort folder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the prefix of the dnprdnshort folder.</para>
+        </returns>
         <param name="version">
           <attribution license="cc4" from="Microsoft" modified="false" />The version of the dnprdnshort to target.</param>
       </Docs>
@@ -103,13 +112,16 @@
         <Parameter Name="version" Type="Microsoft.Build.Utilities.TargetDotNetFrameworkVersion" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a fully qualified path to the dnprdnshort root directory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the fully qualified path to the dnprdnshort root directory, or a null reference (Nothing in vbprvb) if the targeted version of the dnprdnshort is not installed.</para>
+        </returns>
         <param name="version">
           <attribution license="cc4" from="Microsoft" modified="false" />The version of the dnprdnshort to target.</param>
       </Docs>
@@ -128,13 +140,16 @@
         <Parameter Name="version" Type="Microsoft.Build.Utilities.TargetDotNetFrameworkVersion" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a fully qualified path to a file in the dnprdnshort directory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the fully qualified path to the specified file, or a null reference (Nothing in vbprvb) if the targeted version of the dnprdnshort is not installed.</para>
+        </returns>
         <param name="fileName">
           <attribution license="cc4" from="Microsoft" modified="false" />The file to locate in the dnprdnshort directory.</param>
         <param name="version">
@@ -154,13 +169,16 @@
         <Parameter Name="version" Type="Microsoft.Build.Utilities.TargetDotNetFrameworkVersion" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the fully qualified path to the \bin directory of the dnprdnshort SDK.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the fully qualified path to the \bin directory of the dnprdnshort SDK, or a null reference (Nothing in vbprvb) if the targeted version of the dnprdnshort SDK is not installed.</para>
+        </returns>
         <param name="version">
           <attribution license="cc4" from="Microsoft" modified="false" />The version of the dnprdnshort to target.</param>
       </Docs>
@@ -179,7 +197,6 @@
         <Parameter Name="version" Type="Microsoft.Build.Utilities.TargetDotNetFrameworkVersion" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -190,6 +207,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the fully qualified path to a file in the dnprdnshort SDK.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the fully qualified path to the \bin directory of the dnprdnshort SDK, or a null reference (Nothing in vbprvb) if the targeted version of the dnprdnshort SDK is not installed.</para>
+        </returns>
         <param name="fileName">
           <attribution license="cc4" from="Microsoft" modified="false" />The file to locate in the dnprdnshort SDK.</param>
         <param name="version">
@@ -209,7 +230,6 @@
         <Parameter Name="fileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -219,6 +239,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a fully qualified path to a file in the system directory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the fully qualified path to the the file in the system directory.</para>
+        </returns>
         <param name="fileName">
           <attribution license="cc4" from="Microsoft" modified="false" />The file to locate in the System folder.</param>
       </Docs>
diff --git a/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/ToolTask.xml b/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/ToolTask.xml
index 65ca0c5fd58..bd8ca7eb443 100644
--- a/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/ToolTask.xml
+++ b/mcs/class/Microsoft.Build.Utilities/Documentation/en/Microsoft.Build.Utilities/ToolTask.xml
@@ -88,13 +88,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calls the host object to perform the work of the task.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the method was successfule; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -133,12 +136,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Runs the exectuable file with the specified task parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the task runs successfully; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ExecuteTool">
@@ -153,13 +159,16 @@
         <Parameter Name="commandLineCommands" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a temporoary response (.rsp) file and runs the executable file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The returned exit code of the executable file. If the task logged errors, but the executable returned an exit code of 0, this method returns -1.</para>
+        </returns>
         <param name="pathToTool">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to the executable file.</param>
         <param name="responseFileCommands">
@@ -203,7 +212,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -213,6 +221,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string value containing the command line arguments to pass directly to the executable file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string value containing the command line arguments to pass directly to the executable file.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -226,7 +238,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -236,6 +247,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the fully qualified path to the executable file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The fully qualified path to the executable file.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -249,7 +264,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -259,6 +273,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string value containing the command line arguments to add to the response (.rsp) file before running the executable file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>a string value containing the command line arguments to add to the response (.rsp) file before running the executable file.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -274,7 +292,6 @@
         <Parameter Name="responseFilePath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -285,6 +302,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the command line switch used by the executable file to specifiy a response (.rsp) file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The command line switch used by the executable file to specifiy a response (.rsp) file.</para>
+        </returns>
         <param name="responseFilePath">
           <attribution license="cc4" from="Microsoft" modified="false" />The full path to the temporary .rsp file.</param>
       </Docs>
@@ -300,7 +321,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -310,6 +330,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the directory in which to run the executable file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The directory in which to run the executable file, or a null reference (Nothing in vbprvb) if the executable file should be run in the current directory.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -323,7 +347,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -334,6 +357,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Handles execution errors raised by the executable file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the method runs successfully; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -347,13 +374,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes the host object of the task.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:Microsoft.Build.Utilities.HostObjectInitializationStatus" /> of the host object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -463,7 +493,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version="2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -473,6 +502,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether task execution should be skipped.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true to skip task execution; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -625,13 +658,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version="2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether all task paratmeters are valid.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if all task parameters are valid; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/Microsoft.CSharp/Documentation/en/Microsoft.CSharp.RuntimeBinder/Binder.xml b/mcs/class/Microsoft.CSharp/Documentation/en/Microsoft.CSharp.RuntimeBinder/Binder.xml
index 55e00e532fe..d63ab50b2e1 100644
--- a/mcs/class/Microsoft.CSharp/Documentation/en/Microsoft.CSharp.RuntimeBinder/Binder.xml
+++ b/mcs/class/Microsoft.CSharp/Documentation/en/Microsoft.CSharp.RuntimeBinder/Binder.xml
@@ -35,12 +35,15 @@
         <Parameter Name="argumentInfo" Type="System.Collections.Generic.IEnumerable&lt;Microsoft.CSharp.RuntimeBinder.CSharpArgumentInfo&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new CSharp binary operation binder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a new CSharp binary operation binder.</para>
+        </returns>
         <param name="flags">
           <attribution license="cc4" from="Microsoft" modified="false" />The flags with which to initialize the binder.</param>
         <param name="operation">
@@ -67,12 +70,15 @@
         <Parameter Name="context" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new CSharp convert binder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a new CSharp convert binder.</para>
+        </returns>
         <param name="flags">
           <attribution license="cc4" from="Microsoft" modified="false" />The flags with which to initialize the binder.</param>
         <param name="type">
@@ -97,12 +103,15 @@
         <Parameter Name="argumentInfo" Type="System.Collections.Generic.IEnumerable&lt;Microsoft.CSharp.RuntimeBinder.CSharpArgumentInfo&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new CSharp get index binder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a new CSharp get index binder.</para>
+        </returns>
         <param name="flags">
           <attribution license="cc4" from="Microsoft" modified="false" />The flags with which to initialize the binder.</param>
         <param name="context">
@@ -128,12 +137,15 @@
         <Parameter Name="argumentInfo" Type="System.Collections.Generic.IEnumerable&lt;Microsoft.CSharp.RuntimeBinder.CSharpArgumentInfo&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new CSharp get member binder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a new CSharp get member binder.</para>
+        </returns>
         <param name="flags">
           <attribution license="cc4" from="Microsoft" modified="false" />The flags with which to initialize the binder.</param>
         <param name="name">
@@ -160,12 +172,15 @@
         <Parameter Name="argumentInfo" Type="System.Collections.Generic.IEnumerable&lt;Microsoft.CSharp.RuntimeBinder.CSharpArgumentInfo&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new CSharp invoke binder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a new CSharp invoke binder.</para>
+        </returns>
         <param name="flags">
           <attribution license="cc4" from="Microsoft" modified="false" />The flags with which to initialize the binder.</param>
         <param name="context">
@@ -190,12 +205,15 @@
         <Parameter Name="argumentInfo" Type="System.Collections.Generic.IEnumerable&lt;Microsoft.CSharp.RuntimeBinder.CSharpArgumentInfo&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new CSharp invoke constructor binder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a new CSharp invoke constructor binder.</para>
+        </returns>
         <param name="flags">
           <attribution license="cc4" from="Microsoft" modified="false" />The flags with which to initialize the binder.</param>
         <param name="context">
@@ -222,12 +240,15 @@
         <Parameter Name="argumentInfo" Type="System.Collections.Generic.IEnumerable&lt;Microsoft.CSharp.RuntimeBinder.CSharpArgumentInfo&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new CSharp invoke member binder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a new CSharp invoke member binder.</para>
+        </returns>
         <param name="flags">
           <attribution license="cc4" from="Microsoft" modified="false" />The flags with which to initialize the binder.</param>
         <param name="name">
@@ -256,12 +277,15 @@
         <Parameter Name="context" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new CSharp is event binder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a new CSharp is event binder.</para>
+        </returns>
         <param name="flags">
           <attribution license="cc4" from="Microsoft" modified="false" />The flags with which to initialize the binder.</param>
         <param name="name">
@@ -286,12 +310,15 @@
         <Parameter Name="argumentInfo" Type="System.Collections.Generic.IEnumerable&lt;Microsoft.CSharp.RuntimeBinder.CSharpArgumentInfo&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new CSharp set index binder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a new CSharp set index binder.</para>
+        </returns>
         <param name="flags">
           <attribution license="cc4" from="Microsoft" modified="false" />The flags with which to initialize the binder.</param>
         <param name="context">
@@ -317,12 +344,15 @@
         <Parameter Name="argumentInfo" Type="System.Collections.Generic.IEnumerable&lt;Microsoft.CSharp.RuntimeBinder.CSharpArgumentInfo&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new CSharp set member binder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a new CSharp set member binder.</para>
+        </returns>
         <param name="flags">
           <attribution license="cc4" from="Microsoft" modified="false" />The flags with which to initialize the binder.</param>
         <param name="name">
@@ -350,12 +380,15 @@
         <Parameter Name="argumentInfo" Type="System.Collections.Generic.IEnumerable&lt;Microsoft.CSharp.RuntimeBinder.CSharpArgumentInfo&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new CSharp unary operation binder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a new CSharp unary operation binder.</para>
+        </returns>
         <param name="flags">
           <attribution license="cc4" from="Microsoft" modified="false" />The flags with which to initialize the binder.</param>
         <param name="operation">
diff --git a/mcs/class/Microsoft.CSharp/Documentation/en/Microsoft.CSharp.RuntimeBinder/CSharpArgumentInfo.xml b/mcs/class/Microsoft.CSharp/Documentation/en/Microsoft.CSharp.RuntimeBinder/CSharpArgumentInfo.xml
index 91705adb14d..3327d38a4f7 100644
--- a/mcs/class/Microsoft.CSharp/Documentation/en/Microsoft.CSharp.RuntimeBinder/CSharpArgumentInfo.xml
+++ b/mcs/class/Microsoft.CSharp/Documentation/en/Microsoft.CSharp.RuntimeBinder/CSharpArgumentInfo.xml
@@ -33,12 +33,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of the <see cref="T:Microsoft.CSharp.RuntimeBinder.CSharpArgumentInfo" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the <see cref="T:Microsoft.CSharp.RuntimeBinder.CSharpArgumentInfo" /> class.</para>
+        </returns>
         <param name="flags">
           <attribution license="cc4" from="Microsoft" modified="false" />The flags for the argument.</param>
         <param name="name">
diff --git a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/AggregateCatalog.xml b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/AggregateCatalog.xml
index 036f2bf9ec7..7c9a15cb56a 100644
--- a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/AggregateCatalog.xml
+++ b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/AggregateCatalog.xml
@@ -174,12 +174,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the catalog.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator that can be used to iterate through the catalog.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetExports">
@@ -196,12 +199,15 @@
         <Parameter Name="definition" Type="System.ComponentModel.Composition.Primitives.ImportDefinition" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the export definitions that match the constraint expressed by the specified definition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of <see cref="T:System.Tuple`2" /> containing the <see cref="T:System.ComponentModel.Composition.Primitives.ExportDefinition" /> objects and their associated <see cref="T:System.ComponentModel.Composition.Primitives.ComposablePartDefinition" /> objects for objects that match the constraint specified by <paramref name="definition" />.</para>
+        </returns>
         <param name="definition">
           <attribution license="cc4" from="Microsoft" modified="false" />The conditions of the <see cref="T:System.ComponentModel.Composition.Primitives.ExportDefinition" /> objects to be returned.</param>
       </Docs>
diff --git a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/AggregateExportProvider.xml b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/AggregateExportProvider.xml
index 081f38ce653..35d97377e5f 100644
--- a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/AggregateExportProvider.xml
+++ b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/AggregateExportProvider.xml
@@ -140,7 +140,6 @@
         <Parameter Name="atomicComposition" Type="System.ComponentModel.Composition.Hosting.AtomicComposition" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implementers should not treat cardinality-related mismatches as errors and are not expected to throw exceptions in those cases.</para>
@@ -150,6 +149,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all the exports that match the conditions of the specified import.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection that contains all the exports that match the specified condition.</para>
+        </returns>
         <param name="definition">
           <attribution license="cc4" from="Microsoft" modified="false" />The conditions of the <see cref="T:System.ComponentModel.Composition.Primitives.Export" /> objects to be returned.</param>
         <param name="atomicComposition">
diff --git a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/ApplicationCatalog.xml b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/ApplicationCatalog.xml
index 55e2e1bca03..b984c29b747 100644
--- a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/ApplicationCatalog.xml
+++ b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/ApplicationCatalog.xml
@@ -136,12 +136,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetExports">
@@ -158,12 +161,15 @@
         <Parameter Name="definition" Type="System.ComponentModel.Composition.Primitives.ImportDefinition" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the export definitions that match the constraint expressed by the specified import definition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of objects that contain the <see cref="T:System.ComponentModel.Composition.Primitives.ExportDefinition" /> objects and their associated <see cref="T:System.ComponentModel.Composition.Primitives.ComposablePartDefinition" /> objects that match the specified constraint.</para>
+        </returns>
         <param name="definition">
           <attribution license="cc4" from="Microsoft" modified="false" />The conditions of the <see cref="T:System.ComponentModel.Composition.Primitives.ExportDefinition" /> objects to be returned.</param>
       </Docs>
@@ -224,12 +230,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a string representation of the application catalog.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the catalog.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/AssemblyCatalog.xml b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/AssemblyCatalog.xml
index a1b2a2c0727..935a63d93b2 100644
--- a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/AssemblyCatalog.xml
+++ b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/AssemblyCatalog.xml
@@ -272,12 +272,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the catalog.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator that can be used to iterate through the catalog.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetExports">
@@ -294,12 +297,15 @@
         <Parameter Name="definition" Type="System.ComponentModel.Composition.Primitives.ImportDefinition" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of exports that match the conditions specified by the import definition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of exports that match the conditions specified by <paramref name="definition" />.</para>
+        </returns>
         <param name="definition">
           <attribution license="cc4" from="Microsoft" modified="false" />Conditions that specify which exports to match.</param>
       </Docs>
@@ -360,12 +366,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a string representation of the assembly catalog.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A representation of the assembly catalog.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/CatalogExportProvider.xml b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/CatalogExportProvider.xml
index fe65e7787d3..2243cfd22cc 100644
--- a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/CatalogExportProvider.xml
+++ b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/CatalogExportProvider.xml
@@ -171,7 +171,6 @@
         <Parameter Name="atomicComposition" Type="System.ComponentModel.Composition.Hosting.AtomicComposition" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implementers should not treat cardinality-related mismatches as errors and should not throw exceptions for cardinality-related mismatches. For example, if the import requests exactly one export and the provider has either no matching exports or more than one, the <see cref="M:System.ComponentModel.Composition.Hosting.CatalogExportProvider.GetExportsCore(System.ComponentModel.Composition.Primitives.ImportDefinition,System.ComponentModel.Composition.Hosting.AtomicComposition)" /> method should return an empty <see cref="T:System.Collections.Generic.IEnumerable`1" /> collection of <see cref="T:System.ComponentModel.Composition.Primitives.Export" /> objects.</para>
@@ -180,6 +179,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all exports that match the conditions of the specified import.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection that contains all the exports that match the specified condition.</para>
+        </returns>
         <param name="definition">
           <attribution license="cc4" from="Microsoft" modified="false" />The conditions of the <see cref="T:System.ComponentModel.Composition.Primitives.Export" /> objects to be returned.</param>
         <param name="atomicComposition">
diff --git a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/CatalogExtensions.xml b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/CatalogExtensions.xml
index 96bc94d2f99..2d56d3d466d 100644
--- a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/CatalogExtensions.xml
+++ b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/CatalogExtensions.xml
@@ -32,12 +32,15 @@
         <Parameter Name="composablePartCatalog" Type="System.ComponentModel.Composition.Primitives.ComposablePartCatalog" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new composition service by using the specified catalog as a source for exports.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new composition service.</para>
+        </returns>
         <param name="composablePartCatalog">
           <attribution license="cc4" from="Microsoft" modified="false" />The catalog that will provide exports.</param>
       </Docs>
diff --git a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/ComposablePartExportProvider.xml b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/ComposablePartExportProvider.xml
index 2379ae0ae52..1f7ee3eeef9 100644
--- a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/ComposablePartExportProvider.xml
+++ b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/ComposablePartExportProvider.xml
@@ -165,7 +165,6 @@
         <Parameter Name="atomicComposition" Type="System.ComponentModel.Composition.Hosting.AtomicComposition" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implementers should not treat cardinality-related mismatches as errors and should not throw exceptions for cardinality-related mismatches. For example, if the import requests exactly one export and the provider has no matching exports or more than one, the <see cref="M:System.ComponentModel.Composition.Hosting.ComposablePartExportProvider.GetExportsCore(System.ComponentModel.Composition.Primitives.ImportDefinition,System.ComponentModel.Composition.Hosting.AtomicComposition)" /> method should return an empty <see cref="T:System.Collections.Generic.IEnumerable`1" /> collection of <see cref="T:System.ComponentModel.Composition.Primitives.Export" /> objects.</para>
@@ -174,6 +173,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of all exports in this provider that match the conditions of the specified import.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of all exports in this provider that match the specified conditions.</para>
+        </returns>
         <param name="definition">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Composition.Primitives.ImportDefinition" /> that defines the conditions of the <see cref="T:System.ComponentModel.Composition.Primitives.Export" /> to get.</param>
         <param name="atomicComposition">
diff --git a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/CompositionBatch.xml b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/CompositionBatch.xml
index ad0c79a5d50..fd793158c03 100644
--- a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/CompositionBatch.xml
+++ b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/CompositionBatch.xml
@@ -71,12 +71,15 @@
         <Parameter Name="export" Type="System.ComponentModel.Composition.Primitives.Export" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified export to the <see cref="T:System.ComponentModel.Composition.Hosting.CompositionBatch" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The part added.</para>
+        </returns>
         <param name="export">
           <attribution license="cc4" from="Microsoft" modified="false" />The export to add to the <see cref="T:System.ComponentModel.Composition.Hosting.CompositionBatch" /> object.</param>
       </Docs>
diff --git a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/CompositionContainer.xml b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/CompositionContainer.xml
index a4e8d71d7d1..b1879b7965e 100644
--- a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/CompositionContainer.xml
+++ b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/CompositionContainer.xml
@@ -314,7 +314,6 @@
         <Parameter Name="atomicComposition" Type="System.ComponentModel.Composition.Hosting.AtomicComposition" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implementations should not treat cardinality-related mismatches as errors and should not throw exceptions for cardinality-related mismatches. For example, if the import requests exactly one export and the provider has either no matching exports or more than one, the <see cref="M:System.ComponentModel.Composition.Hosting.CompositionContainer.GetExportsCore(System.ComponentModel.Composition.Primitives.ImportDefinition,System.ComponentModel.Composition.Hosting.AtomicComposition)" /> method should return an empty <see cref="T:System.Collections.Generic.IEnumerable`1" /> collection of <see cref="T:System.ComponentModel.Composition.Primitives.Export" /> objects.</para>
@@ -323,6 +322,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of all exports that match the conditions in the specified <see cref="T:System.ComponentModel.Composition.Primitives.ImportDefinition" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of all the <see cref="T:System.ComponentModel.Composition.Primitives.Export" /> objects in this <see cref="T:System.ComponentModel.Composition.Hosting.CompositionContainer" /> object that match the conditions specified by <paramref name="definition" />.</para>
+        </returns>
         <param name="definition">
           <attribution license="cc4" from="Microsoft" modified="false" />The object that defines the conditions of the <see cref="T:System.ComponentModel.Composition.Primitives.Export" /> objects to get.</param>
         <param name="atomicComposition">
diff --git a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/CompositionScopeDefinition.xml b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/CompositionScopeDefinition.xml
index 424d6771c3d..dffd288b862 100644
--- a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/CompositionScopeDefinition.xml
+++ b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/CompositionScopeDefinition.xml
@@ -194,12 +194,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the catalog.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator that can be used to iterate through the catalog.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetExports">
@@ -216,12 +219,15 @@
         <Parameter Name="definition" Type="System.ComponentModel.Composition.Primitives.ImportDefinition" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of exports that match the conditions specified by the import definition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of exports that match the specified conditions.</para>
+        </returns>
         <param name="definition">
           <attribution license="cc4" from="Microsoft" modified="false" />Conditions that specify which exports to match.</param>
       </Docs>
diff --git a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/DirectoryCatalog.xml b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/DirectoryCatalog.xml
index c5c48cd5b27..610a5c3e91d 100644
--- a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/DirectoryCatalog.xml
+++ b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/DirectoryCatalog.xml
@@ -322,12 +322,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the catalog.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator that can be used to iterate through the catalog.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetExports">
@@ -344,12 +347,15 @@
         <Parameter Name="definition" Type="System.ComponentModel.Composition.Primitives.ImportDefinition" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the export definitions that match the constraint expressed by the specified import definition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of objects that contain the <see cref="T:System.ComponentModel.Composition.Primitives.ExportDefinition" /> objects and their associated <see cref="T:System.ComponentModel.Composition.Primitives.ComposablePartDefinition" /> objects that match the constraint specified by <paramref name="definition" />.</para>
+        </returns>
         <param name="definition">
           <attribution license="cc4" from="Microsoft" modified="false" />The conditions of the <see cref="T:System.ComponentModel.Composition.Primitives.ExportDefinition" /> objects to be returned.</param>
       </Docs>
@@ -535,12 +541,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a string representation of the directory catalog.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the catalog.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/ExportProvider.xml b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/ExportProvider.xml
index bbffc961da8..77778f5917a 100644
--- a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/ExportProvider.xml
+++ b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/ExportProvider.xml
@@ -85,7 +85,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The contract name is the result of calling the <see cref="M:System.ComponentModel.Composition.AttributedModelServices.GetContractName(System.Type)" /> method on <paramref name="T" />.</para>
@@ -95,6 +94,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the export with the contract name derived from the specified type parameter. If there is not exactly one matching export, an exception is thrown.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The export with the contract name derived from the specified type parameter.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The type parameter of the <see cref="T:System.Lazy`1" /> object to return. The contract name is also derived from this type parameter.</typeparam>
       </Docs>
@@ -116,7 +119,6 @@
         <Parameter Name="contractName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default contract name is the result of calling the <see cref="M:System.ComponentModel.Composition.AttributedModelServices.GetContractName(System.Type)" /> method on <paramref name="T" />.</para>
@@ -126,6 +128,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the export with the specified contract name. If there is not exactly one matching export, an exception is thrown.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The export with the specified contract name.</para>
+        </returns>
         <param name="contractName">
           <attribution license="cc4" from="Microsoft" modified="false" />The contract name of the <see cref="T:System.Lazy`1" /> object to return, or null or an empty string ("") to use the default contract name.</param>
         <typeparam name="T">
@@ -148,7 +154,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The contract name is the result of calling the <see cref="M:System.ComponentModel.Composition.AttributedModelServices.GetContractName(System.Type)" /> method on <paramref name="T" />.</para>
@@ -158,6 +163,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the export with the contract name derived from the specified type parameter. If there is not exactly one matching export, an exception is thrown.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>System.Lazy`2</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The type parameter of the <see cref="T:System.Lazy`2" /> object to return. The contract name is also derived from this type parameter.</typeparam>
         <typeparam name="TMetadataView">
@@ -182,7 +191,6 @@
         <Parameter Name="contractName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default contract name is the result of calling the <see cref="M:System.ComponentModel.Composition.AttributedModelServices.GetContractName(System.Type)" /> method on <paramref name="T" />.</para>
@@ -192,6 +200,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the export with the specified contract name. If there is not exactly one matching export, an exception is thrown.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The export with the specified contract name.</para>
+        </returns>
         <param name="contractName">
           <attribution license="cc4" from="Microsoft" modified="false" />The contract name of the <see cref="T:System.Lazy`2" /> object to return, or null or an empty string ("") to use the default contract name.</param>
         <typeparam name="T">
@@ -215,7 +227,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The contract name is the result of calling the <see cref="M:System.ComponentModel.Composition.AttributedModelServices.GetContractName(System.Type)" /> method on <paramref name="T" />.</para>
@@ -225,6 +236,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the exported object with the contract name derived from the specified type parameter. If there is not exactly one matching exported object, an exception is thrown.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The exported object with the contract name derived from the specified type parameter.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the exported object to return. The contract name is also derived from this type parameter.</typeparam>
       </Docs>
@@ -246,7 +261,6 @@
         <Parameter Name="contractName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default contract name is the result of calling the <see cref="M:System.ComponentModel.Composition.AttributedModelServices.GetContractName(System.Type)" /> method on <paramref name="T" />.</para>
@@ -256,6 +270,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the exported object with the specified contract name. If there is not exactly one matching exported object, an exception is thrown.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The exported object with the specified contract name.</para>
+        </returns>
         <param name="contractName">
           <attribution license="cc4" from="Microsoft" modified="false" />The contract name of the exported object to return, or null or an empty string ("") to use the default contract name.</param>
         <typeparam name="T">
@@ -277,7 +295,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the exported object is not found, this method returns the appropriate default value for <paramref name="T" />; for example, zero for integer types, false for Boolean types, and null for reference types.</para>
@@ -288,6 +305,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the exported object with the contract name derived from the specified type parameter or the default value for the specified type, or throws an exception if there is more than one matching exported object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The exported object with the contract name derived from <paramref name="T" />, if found; otherwise, the default value for <paramref name="T" />.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the exported object to return. The contract name is also derived from this type parameter.</typeparam>
       </Docs>
@@ -309,7 +330,6 @@
         <Parameter Name="contractName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the exported object is not found, this method returns the appropriate default value for <paramref name="T" />; for example, zero for integer types, false for Boolean types, and null for reference types.</para>
@@ -320,6 +340,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the exported object with the specified contract name or the default value for the specified type, or throws an exception if there is more than one matching exported object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The exported object with the specified contract name, if found; otherwise, the default value for <paramref name="T" />.</para>
+        </returns>
         <param name="contractName">
           <attribution license="cc4" from="Microsoft" modified="false" />The contract name of the exported object to return, or null or an empty string ("") to use the default contract name.</param>
         <typeparam name="T">
@@ -341,7 +365,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The contract name is the result of calling the <see cref="M:System.ComponentModel.Composition.AttributedModelServices.GetContractName(System.Type)" /> method on <paramref name="T" />.</para>
@@ -351,6 +374,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all the exported objects with the contract name derived from the specified type parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The exported objects with the contract name derived from the specified type parameter, if found; otherwise, an empty <see cref="T:System.Collections.ObjectModel.Collection`1" /> object.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the exported object to return. The contract name is also derived from this type parameter.</typeparam>
       </Docs>
@@ -372,7 +399,6 @@
         <Parameter Name="contractName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default contract name is the result of calling the <see cref="M:System.ComponentModel.Composition.AttributedModelServices.GetContractName(System.Type)" /> method on <paramref name="T" />.</para>
@@ -382,6 +408,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all the exported objects with the specified contract name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The exported objects with the specified contract name, if found; otherwise, an empty <see cref="T:System.Collections.ObjectModel.Collection`1" /> object.</para>
+        </returns>
         <param name="contractName">
           <attribution license="cc4" from="Microsoft" modified="false" />The contract name of the exported objects to return; or null or an empty string ("") to use the default contract name.</param>
         <typeparam name="T">
@@ -402,12 +432,15 @@
         <Parameter Name="definition" Type="System.ComponentModel.Composition.Primitives.ImportDefinition" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all exports that match the conditions of the specified import definition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of all the <see cref="T:System.ComponentModel.Composition.Primitives.Export" /> objects matching the condition specified by <paramref name="definition" />.</para>
+        </returns>
         <param name="definition">
           <attribution license="cc4" from="Microsoft" modified="false" />The object that defines the conditions of the <see cref="T:System.ComponentModel.Composition.Primitives.Export" /> objects to get.</param>
       </Docs>
@@ -427,12 +460,15 @@
         <Parameter Name="atomicComposition" Type="System.ComponentModel.Composition.Hosting.AtomicComposition" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all exports that match the conditions of the specified import definition and composition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of all the <see cref="T:System.ComponentModel.Composition.Primitives.Export" /> objects matching the condition specified by <paramref name="definition" /> and <paramref name="atomicComposition" />.</para>
+        </returns>
         <param name="definition">
           <attribution license="cc4" from="Microsoft" modified="false" />The object that defines the conditions of the <see cref="T:System.ComponentModel.Composition.Primitives.Export" /> objects to get.</param>
         <param name="atomicComposition">
@@ -455,7 +491,6 @@
         <Parameter Name="contractName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default contract name is the result of calling the <see cref="M:System.ComponentModel.Composition.AttributedModelServices.GetContractName(System.Type)" /> method on <paramref name="type" />.</para>
@@ -465,6 +500,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all the exports with the specified contract name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of all the <see cref="T:System.Lazy`2" /> objects for the contract matching <paramref name="contractName" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type parameter of the <see cref="T:System.Lazy`2" /> objects to return.</param>
         <param name="metadataViewType">
@@ -488,7 +527,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The contract name is the result of calling the <see cref="M:System.ComponentModel.Composition.AttributedModelServices.GetContractName(System.Type)" /> method on <paramref name="T" />.</para>
@@ -498,6 +536,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all the exports with the contract name derived from the specified type parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Lazy`1" /> objects with the contract name derived from <paramref name="T" />, if found; otherwise, an empty <see cref="T:System.Collections.Generic.IEnumerable`1" /> object.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The type parameter of the <see cref="T:System.Lazy`1" /> objects to return. The contract name is also derived from this type parameter.</typeparam>
       </Docs>
@@ -519,7 +561,6 @@
         <Parameter Name="contractName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default contract name is the result of calling the <see cref="M:System.ComponentModel.Composition.AttributedModelServices.GetContractName(System.Type)" /> method on <paramref name="T" />.</para>
@@ -529,6 +570,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all the exports with the specified contract name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Lazy`1" /> objects with the specified contract name, if found; otherwise, an empty <see cref="T:System.Collections.Generic.IEnumerable`1" /> object.</para>
+        </returns>
         <param name="contractName">
           <attribution license="cc4" from="Microsoft" modified="false" />The contract name of the <see cref="T:System.Lazy`1" /> objects to return, or null or an empty string ("") to use the default contract name.</param>
         <typeparam name="T">
@@ -551,7 +596,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The contract name is the result of calling the <see cref="M:System.ComponentModel.Composition.AttributedModelServices.GetContractName(System.Type)" /> method on <paramref name="T" />.</para>
@@ -561,6 +605,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all the exports with the contract name derived from the specified type parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Lazy`2" /> objects with the contract name derived from <paramref name="T" />, if found; otherwise, an empty <see cref="T:System.Collections.Generic.IEnumerable`1" /> object.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The type parameter of the <see cref="T:System.Lazy`2" /> objects to return. The contract name is also derived from this type parameter.</typeparam>
         <typeparam name="TMetadataView">
@@ -585,7 +633,6 @@
         <Parameter Name="contractName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default contract name is the result of calling the <see cref="M:System.ComponentModel.Composition.AttributedModelServices.GetContractName(System.Type)" /> method on <paramref name="T" />.</para>
@@ -595,6 +642,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all the exports with the specified contract name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Lazy`2" /> objects with the specified contract name if found; otherwise, an empty <see cref="T:System.Collections.Generic.IEnumerable`1" /> object.</para>
+        </returns>
         <param name="contractName">
           <attribution license="cc4" from="Microsoft" modified="false" />The contract name of the <see cref="T:System.Lazy`2" /> objects to return, or null or an empty string ("") to use the default contract name.</param>
         <typeparam name="T">
@@ -618,7 +669,6 @@
         <Parameter Name="atomicComposition" Type="System.ComponentModel.Composition.Hosting.AtomicComposition" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Overrides of this method should not treat cardinality-related mismatches as errors, and should not throw exceptions in those cases. For example, if <see cref="P:System.ComponentModel.Composition.Primitives.ImportDefinition.Cardinality" /> is <see cref="F:System.ComponentModel.Composition.Primitives.ImportCardinality.ExactlyOne" /> and there are zero <see cref="T:System.ComponentModel.Composition.Primitives.Export" /> objects that match the conditions of the specified <see cref="T:System.ComponentModel.Composition.Primitives.ImportDefinition" />, an empty <see cref="T:System.Collections.Generic.IEnumerable`1" /> collection should be returned.</para>
@@ -627,6 +677,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all the exports that match the constraint defined by the specified definition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection that contains all the exports that match the specified condition.</para>
+        </returns>
         <param name="definition">
           <attribution license="cc4" from="Microsoft" modified="false" />The object that defines the conditions of the <see cref="T:System.ComponentModel.Composition.Primitives.Export" /> objects to return.</param>
         <param name="atomicComposition">
diff --git a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/FilteredCatalog.xml b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/FilteredCatalog.xml
index f510f40437c..c152fc4e90b 100644
--- a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/FilteredCatalog.xml
+++ b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/FilteredCatalog.xml
@@ -147,12 +147,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the catalog.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator that can be used to iterate through the catalog.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetExports">
@@ -169,12 +172,15 @@
         <Parameter Name="definition" Type="System.ComponentModel.Composition.Primitives.ImportDefinition" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the exported parts from this catalog that match the specified import.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of matching parts.</para>
+        </returns>
         <param name="definition">
           <attribution license="cc4" from="Microsoft" modified="false" />The import to match.</param>
       </Docs>
@@ -191,12 +197,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a new <see cref="T:System.ComponentModel.Composition.Hosting.FilteredCatalog" /> object that contains all the parts from this catalog and all their dependencies.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new catalog.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IncludeDependencies">
@@ -213,12 +222,15 @@
         <Parameter Name="importFilter" Type="System.Func&lt;System.ComponentModel.Composition.Primitives.ImportDefinition,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a new <see cref="T:System.ComponentModel.Composition.Hosting.FilteredCatalog" /> object that contains all the parts from this catalog and all dependencies that can be reached through imports that match the specified filter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new catalog.</para>
+        </returns>
         <param name="importFilter">
           <attribution license="cc4" from="Microsoft" modified="false" />The filter for imports.</param>
       </Docs>
@@ -235,12 +247,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a new <see cref="T:System.ComponentModel.Composition.Hosting.FilteredCatalog" /> object that contains all the parts from this catalog and all their dependents.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new catalog.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IncludeDependents">
@@ -257,12 +272,15 @@
         <Parameter Name="importFilter" Type="System.Func&lt;System.ComponentModel.Composition.Primitives.ImportDefinition,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a new <see cref="T:System.ComponentModel.Composition.Hosting.FilteredCatalog" /> object that contains all the parts from this catalog and all dependents that can be reached through imports that match the specified filter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new catalog.</para>
+        </returns>
         <param name="importFilter">
           <attribution license="cc4" from="Microsoft" modified="false" />The filter for imports.</param>
       </Docs>
diff --git a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/ScopingExtensions.xml b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/ScopingExtensions.xml
index 6a71016face..2a3cdbeb43f 100644
--- a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/ScopingExtensions.xml
+++ b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/ScopingExtensions.xml
@@ -61,12 +61,15 @@
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the specified part contains metadata that has the specified key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="part" /> contains metadata that has the specified key; otherwise, false.</para>
+        </returns>
         <param name="part">
           <attribution license="cc4" from="Microsoft" modified="false" />The part to search.</param>
         <param name="key">
@@ -88,12 +91,15 @@
         <Parameter Name="contractName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the specified part exports the specified contract.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="part" /> exports the specified contract; otherwise, false.</para>
+        </returns>
         <param name="part">
           <attribution license="cc4" from="Microsoft" modified="false" />The part to search.</param>
         <param name="contractName">
@@ -115,12 +121,15 @@
         <Parameter Name="filter" Type="System.Func&lt;System.ComponentModel.Composition.Primitives.ComposablePartDefinition,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Filters the specified catalog with the specified filter function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new catalog filtered by using the specified filter.</para>
+        </returns>
         <param name="catalog">
           <attribution license="cc4" from="Microsoft" modified="false" />The catalog to filter.</param>
         <param name="filter">
@@ -142,12 +151,15 @@
         <Parameter Name="contractName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified part imports the specified contract.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="part" /> imports the specified contract; otherwise, false.</para>
+        </returns>
         <param name="part">
           <attribution license="cc4" from="Microsoft" modified="false" />The part to search.</param>
         <param name="contractName">
@@ -170,12 +182,15 @@
         <Parameter Name="importCardinality" Type="System.ComponentModel.Composition.Primitives.ImportCardinality" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified part imports the specified contract with the specified cardinality.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="part" /> imports a contract that has the specified name and cardinality; otherwise, false.</para>
+        </returns>
         <param name="part">
           <attribution license="cc4" from="Microsoft" modified="false" />The part to search.</param>
         <param name="contractName">
diff --git a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/TypeCatalog.xml b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/TypeCatalog.xml
index ad15204fa35..a41e0f93513 100644
--- a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/TypeCatalog.xml
+++ b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Hosting/TypeCatalog.xml
@@ -183,12 +183,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the catalog.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator that can be used to iterate through the catalog.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.Composition.Primitives.ICompositionElement.DisplayName">
@@ -247,12 +250,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of the type catalog.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the type catalog.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/ComposablePart.xml b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/ComposablePart.xml
index 0ca77189ced..5ff46c2e5fc 100644
--- a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/ComposablePart.xml
+++ b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/ComposablePart.xml
@@ -93,12 +93,15 @@
         <Parameter Name="definition" Type="System.ComponentModel.Composition.Primitives.ExportDefinition" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the exported object described by the specified <see cref="T:System.ComponentModel.Composition.Primitives.ExportDefinition" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The exported object described by <paramref name="definition" />.</para>
+        </returns>
         <param name="definition">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.ComponentModel.Composition.Primitives.ExportDefinition" /> objects from the <see cref="P:System.ComponentModel.Composition.Primitives.ComposablePart.ExportDefinitions" /> property that describes the exported object to return.</param>
       </Docs>
diff --git a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/ComposablePartCatalog.xml b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/ComposablePartCatalog.xml
index 9d0cb999e1d..f127d93bbed 100644
--- a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/ComposablePartCatalog.xml
+++ b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/ComposablePartCatalog.xml
@@ -110,12 +110,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the catalog.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator that can be used to iterate through the catalog.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetExports">
@@ -132,7 +135,6 @@
         <Parameter Name="definition" Type="System.ComponentModel.Composition.Primitives.ImportDefinition" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Overrides of this method should never return null. If no <see cref="T:System.ComponentModel.Composition.Primitives.ExportDefinition" /> matches the conditions defined by <paramref name="definition" />, return an empty <see cref="T:System.Collections.Generic.IEnumerable`1" /> object.</para>
@@ -141,6 +143,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a list of export definitions that match the constraint defined by the specified <see cref="T:System.ComponentModel.Composition.Primitives.ImportDefinition" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of <see cref="T:System.Tuple`2" /> containing the <see cref="T:System.ComponentModel.Composition.Primitives.ExportDefinition" /> objects and their associated <see cref="T:System.ComponentModel.Composition.Primitives.ComposablePartDefinition" /> objects for objects that match the constraint specified by <paramref name="definition" />.</para>
+        </returns>
         <param name="definition">
           <attribution license="cc4" from="Microsoft" modified="false" />The conditions of the <see cref="T:System.ComponentModel.Composition.Primitives.ExportDefinition" /> objects to be returned.</param>
       </Docs>
@@ -184,7 +190,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.ComponentModel.Composition.Primitives.ComposablePartCatalog" /> instance is cast to an <see cref="T:System.Collections.IEnumerable" /> interface.</para>
@@ -193,6 +198,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the catalog.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator that can be used to iterate through the catalog.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/ComposablePartDefinition.xml b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/ComposablePartDefinition.xml
index 445d77e6f75..97b9ceb9c04 100644
--- a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/ComposablePartDefinition.xml
+++ b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/ComposablePartDefinition.xml
@@ -46,7 +46,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Derived types that override this method should return a new instance of a <see cref="T:System.ComponentModel.Composition.Primitives.ComposablePart" /> object every time that the method is invoked and should never return null.</para>
@@ -55,6 +54,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of a part that the <see cref="T:System.ComponentModel.Composition.Primitives.ComposablePartDefinition" /> describes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created part.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ExportDefinitions">
diff --git a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/ContractBasedImportDefinition.xml b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/ContractBasedImportDefinition.xml
index a9a06853dba..10b6e3e57fe 100644
--- a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/ContractBasedImportDefinition.xml
+++ b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/ContractBasedImportDefinition.xml
@@ -146,12 +146,15 @@
         <Parameter Name="exportDefinition" Type="System.ComponentModel.Composition.Primitives.ExportDefinition" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the constraint represented by this object is satisfied by the export represented by the given export definition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the constraint is satisfied; otherwise, false.</para>
+        </returns>
         <param name="exportDefinition">
           <attribution license="cc4" from="Microsoft" modified="false" />The export definition to test.</param>
       </Docs>
@@ -229,8 +232,11 @@
       <Parameters />
       <Docs>
         <summary>To be added.</summary>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.String" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/Export.xml b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/Export.xml
index 39a7ee16a3a..b76750e5ec0 100644
--- a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/Export.xml
+++ b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/Export.xml
@@ -143,12 +143,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the exported object the export provides.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The exported object the export provides.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Metadata">
diff --git a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/ExportDefinition.xml b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/ExportDefinition.xml
index b44469ce664..33b735e3a46 100644
--- a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/ExportDefinition.xml
+++ b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/ExportDefinition.xml
@@ -117,12 +117,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of the export definition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the export definition.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/ExportedDelegate.xml b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/ExportedDelegate.xml
index 60dc471c321..34386727d0f 100644
--- a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/ExportedDelegate.xml
+++ b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/ExportedDelegate.xml
@@ -71,12 +71,15 @@
         <Parameter Name="delegateType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a delegate of the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A delegate of the specified type, or null if no such delegate can be created.</para>
+        </returns>
         <param name="delegateType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the delegate to return.</param>
       </Docs>
diff --git a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/ImportDefinition.xml b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/ImportDefinition.xml
index 540365a1a55..f34b992f456 100644
--- a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/ImportDefinition.xml
+++ b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.Primitives/ImportDefinition.xml
@@ -178,12 +178,15 @@
         <Parameter Name="exportDefinition" Type="System.ComponentModel.Composition.Primitives.ExportDefinition" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the export represented by the specified definition satisfies the constraints of this import definition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the constraints are satisfied; otherwise, false.</para>
+        </returns>
         <param name="exportDefinition">
           <attribution license="cc4" from="Microsoft" modified="false" />The export definition to test.</param>
       </Docs>
@@ -260,12 +263,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of the import definition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the import definition.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.ReflectionModel/LazyMemberInfo.xml b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.ReflectionModel/LazyMemberInfo.xml
index 319ad795bac..a9407513ea3 100644
--- a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.ReflectionModel/LazyMemberInfo.xml
+++ b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.ReflectionModel/LazyMemberInfo.xml
@@ -123,12 +123,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of the accessors for the represented member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of the accessors for the represented member.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -182,12 +185,15 @@
         <Parameter Name="right" Type="System.ComponentModel.Composition.ReflectionModel.LazyMemberInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the two specified <see cref="T:System.ComponentModel.Composition.ReflectionModel.LazyMemberInfo" /> objects are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the objects are equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to test.</param>
         <param name="right">
@@ -209,12 +215,15 @@
         <Parameter Name="right" Type="System.ComponentModel.Composition.ReflectionModel.LazyMemberInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the two specified <see cref="T:System.ComponentModel.Composition.ReflectionModel.LazyMemberInfo" /> objects are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the objects are equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to test.</param>
         <param name="right">
diff --git a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.ReflectionModel/ReflectionModelServices.xml b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.ReflectionModel/ReflectionModelServices.xml
index d91b51c2972..47c235f067f 100644
--- a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.ReflectionModel/ReflectionModelServices.xml
+++ b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition.ReflectionModel/ReflectionModelServices.xml
@@ -35,12 +35,15 @@
         <Parameter Name="origin" Type="System.ComponentModel.Composition.Primitives.ICompositionElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an export definition from the specified member, with the specified contract name, metadata, and origin.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An export definition created from the specified parameters.</para>
+        </returns>
         <param name="exportingMember">
           <attribution license="cc4" from="Microsoft" modified="false" />The member to export.</param>
         <param name="contractName">
@@ -71,12 +74,15 @@
         <Parameter Name="origin" Type="System.ComponentModel.Composition.Primitives.ICompositionElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an import definition for the specified parameter by using the specified contract name, type identity, import metadata, cardinality, and creation policy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An import definition created from the specified parameters.</para>
+        </returns>
         <param name="parameter">
           <attribution license="cc4" from="Microsoft" modified="false" />The parameter to import.</param>
         <param name="contractName">
@@ -114,12 +120,15 @@
         <Parameter Name="origin" Type="System.ComponentModel.Composition.Primitives.ICompositionElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an import definition for the specified member by using the specified contract name, type identity, import metadata, cardinality, recomposition policy, and creation policy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An import definition created from the specified parameters.</para>
+        </returns>
         <param name="importingMember">
           <attribution license="cc4" from="Microsoft" modified="false" />The member to import into.</param>
         <param name="contractName">
@@ -160,12 +169,15 @@
         <Parameter Name="origin" Type="System.ComponentModel.Composition.Primitives.ICompositionElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an import definition for the specified parameter by using the specified contract name, type identity, import and contract metadata, cardinality, and creation policy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An import definition created from the specified parameters.</para>
+        </returns>
         <param name="parameter">
           <attribution license="cc4" from="Microsoft" modified="false" />The parameter to import.</param>
         <param name="contractName">
@@ -209,12 +221,15 @@
         <Parameter Name="origin" Type="System.ComponentModel.Composition.Primitives.ICompositionElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an import definition for the specified member by using the specified contract name, type identity, import and contract metadata, cardinality, recomposition policy, and creation policy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An import definition created from the specified parameters.</para>
+        </returns>
         <param name="importingMember">
           <attribution license="cc4" from="Microsoft" modified="false" />The member to import into.</param>
         <param name="contractName">
@@ -261,12 +276,15 @@
         <Parameter Name="origin" Type="System.ComponentModel.Composition.Primitives.ICompositionElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an import definition for the specified member by using the specified contract name, type identity, import and contract metadata, cardinality, recomposition policy, and creation policy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An import definition created from the specified parameters.</para>
+        </returns>
         <param name="importingMember">
           <attribution license="cc4" from="Microsoft" modified="false" />The member to import into.</param>
         <param name="contractName">
@@ -310,12 +328,15 @@
         <Parameter Name="origin" Type="System.ComponentModel.Composition.Primitives.ICompositionElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a part definition with the specified part type, imports, exports, metadata, and origin.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A part definition created from the specified parameters.</para>
+        </returns>
         <param name="partType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the part.</param>
         <param name="isDisposalRequired">
@@ -344,12 +365,15 @@
         <Parameter Name="importDefinition" Type="System.ComponentModel.Composition.Primitives.ImportDefinition" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a representation of an import definition as an export factory product.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The representation of the import definition.</para>
+        </returns>
         <param name="importDefinition">
           <attribution license="cc4" from="Microsoft" modified="false" />The import definition to represent.</param>
       </Docs>
@@ -368,12 +392,15 @@
         <Parameter Name="exportDefinition" Type="System.ComponentModel.Composition.Primitives.ExportDefinition" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the exporting member from a specified export definition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The member specified in the export definition.</para>
+        </returns>
         <param name="exportDefinition">
           <attribution license="cc4" from="Microsoft" modified="false" />The export definition to examine.</param>
       </Docs>
@@ -392,12 +419,15 @@
         <Parameter Name="importDefinition" Type="System.ComponentModel.Composition.Primitives.ImportDefinition" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the importing member from a specified import definition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The member specified in the import definition.</para>
+        </returns>
         <param name="importDefinition">
           <attribution license="cc4" from="Microsoft" modified="false" />The import definition to examine.</param>
       </Docs>
@@ -416,12 +446,15 @@
         <Parameter Name="importDefinition" Type="System.ComponentModel.Composition.Primitives.ImportDefinition" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the importing parameter from a specified import definition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The parameter specified in the import definition.</para>
+        </returns>
         <param name="importDefinition">
           <attribution license="cc4" from="Microsoft" modified="false" />The import definition to examine.</param>
       </Docs>
@@ -440,12 +473,15 @@
         <Parameter Name="partDefinition" Type="System.ComponentModel.Composition.Primitives.ComposablePartDefinition" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the type of a part from a specified part definition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type of the defined part.</para>
+        </returns>
         <param name="partDefinition">
           <attribution license="cc4" from="Microsoft" modified="false" />The part definition to examine.</param>
       </Docs>
@@ -464,12 +500,15 @@
         <Parameter Name="partDefinition" Type="System.ComponentModel.Composition.Primitives.ComposablePartDefinition" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified part requires disposal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the part requires disposal; otherwise, false.</para>
+        </returns>
         <param name="partDefinition">
           <attribution license="cc4" from="Microsoft" modified="false" />The part to examine.</param>
       </Docs>
@@ -488,12 +527,15 @@
         <Parameter Name="importDefinition" Type="System.ComponentModel.Composition.Primitives.ImportDefinition" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a specified import definition represents an export factory (<see cref="T:System.ComponentModel.Composition.ExportFactory`1" /> or <see cref="T:System.ComponentModel.Composition.ExportFactory`2" /> object).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified import definition represents an export factory; otherwise, false.</para>
+        </returns>
         <param name="importDefinition">
           <attribution license="cc4" from="Microsoft" modified="false" />The import definition to check.</param>
       </Docs>
@@ -512,12 +554,15 @@
         <Parameter Name="importDefinition" Type="System.ComponentModel.Composition.Primitives.ImportDefinition" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether an import definition represents a member or a parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the import definition represents a parameter; otherwise, false.</para>
+        </returns>
         <param name="importDefinition">
           <attribution license="cc4" from="Microsoft" modified="false" />The import definition to examine.</param>
       </Docs>
diff --git a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition/AttributedModelServices.xml b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition/AttributedModelServices.xml
index 247a91344ca..d83a1c426ec 100644
--- a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition/AttributedModelServices.xml
+++ b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition/AttributedModelServices.xml
@@ -87,12 +87,15 @@
         <Parameter Name="attributedPart" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a composable part from the specified attributed object, and adds it to the specified composition batch.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new part.</para>
+        </returns>
         <param name="batch">
           <attribution license="cc4" from="Microsoft" modified="false" />The batch to add to.</param>
         <param name="attributedPart">
@@ -197,12 +200,15 @@
         <Parameter Name="attributedPart" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a composable part from the specified attributed object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created part.</para>
+        </returns>
         <param name="attributedPart">
           <attribution license="cc4" from="Microsoft" modified="false" />The attributed object.</param>
       </Docs>
@@ -222,12 +228,15 @@
         <Parameter Name="attributedPart" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a composable part from the specified attributed object, using the specified part definition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created part.</para>
+        </returns>
         <param name="partDefinition">
           <attribution license="cc4" from="Microsoft" modified="false" />The definition of the new part.</param>
         <param name="attributedPart">
@@ -249,12 +258,15 @@
         <Parameter Name="reflectionContext" Type="System.Reflection.ReflectionContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a composable part from the specified attributed object, using the specified reflection context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created part.</para>
+        </returns>
         <param name="attributedPart">
           <attribution license="cc4" from="Microsoft" modified="false" />The attributed object.</param>
         <param name="reflectionContext">
@@ -276,12 +288,15 @@
         <Parameter Name="origin" Type="System.ComponentModel.Composition.Primitives.ICompositionElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a part definition with the specified type and origin.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new part definition.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the definition.</param>
         <param name="origin">
@@ -304,12 +319,15 @@
         <Parameter Name="ensureIsDiscoverable" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a part definition with the specified type and origin.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new part definition.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the definition.</param>
         <param name="origin">
@@ -333,12 +351,15 @@
         <Parameter Name="contractType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the specified part contains an export that matches the specified contract type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="part" /> contains an export definition that matches <paramref name="contractType" />; otherwise, false.</para>
+        </returns>
         <param name="part">
           <attribution license="cc4" from="Microsoft" modified="false" />The part to search.</param>
         <param name="contractType">
@@ -362,12 +383,15 @@
         <Parameter Name="part" Type="System.ComponentModel.Composition.Primitives.ComposablePartDefinition" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the specified part contains an export that matches the specified contract type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="part" /> contains an export definition of type <paramref name="T" />; otherwise, false.</para>
+        </returns>
         <param name="part">
           <attribution license="cc4" from="Microsoft" modified="false" />The part to search.</param>
         <typeparam name="T">
@@ -388,12 +412,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a canonical contract name for the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A contract name created from the specified type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to use.</param>
       </Docs>
@@ -415,12 +442,15 @@
         <Parameter Name="metadata" Type="System.Collections.Generic.IDictionary&lt;System.String,System.Object&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a metadata view object from a dictionary of loose metadata.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A metadata view containing the specified metadata.</para>
+        </returns>
         <param name="metadata">
           <attribution license="cc4" from="Microsoft" modified="false" />A collection of loose metadata.</param>
         <typeparam name="TMetadataView">
@@ -441,12 +471,15 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the unique identifier for the specified method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The unique identifier for the method.</para>
+        </returns>
         <param name="method">
           <attribution license="cc4" from="Microsoft" modified="false" />The method to examine.</param>
       </Docs>
@@ -465,12 +498,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the unique identifier for the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The unique identifier for the type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to examine.</param>
       </Docs>
@@ -490,12 +526,15 @@
         <Parameter Name="contractType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the specified part contains an import that matches the specified contract type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="part" /> contains an import definition that matches <paramref name="contractType" />; otherwise, false.</para>
+        </returns>
         <param name="part">
           <attribution license="cc4" from="Microsoft" modified="false" />The part to search.</param>
         <param name="contractType">
@@ -518,12 +557,15 @@
         <Parameter Name="importCardinality" Type="System.ComponentModel.Composition.Primitives.ImportCardinality" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the specified part contains an import that matches the specified contract type and import cardinality.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="part" /> contains an import definition that matches <paramref name="contractType" /> and <paramref name="importCardinality" />; otherwise, false.</para>
+        </returns>
         <param name="part">
           <attribution license="cc4" from="Microsoft" modified="false" />The part to search.</param>
         <param name="contractType">
@@ -549,12 +591,15 @@
         <Parameter Name="part" Type="System.ComponentModel.Composition.Primitives.ComposablePartDefinition" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the specified part contains an import that matches the specified contract type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="part" /> contains an import definition of type <paramref name="T" />; otherwise, false.</para>
+        </returns>
         <param name="part">
           <attribution license="cc4" from="Microsoft" modified="false" />The part to search.</param>
         <typeparam name="T">
@@ -579,12 +624,15 @@
         <Parameter Name="importCardinality" Type="System.ComponentModel.Composition.Primitives.ImportCardinality" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the specified part contains an import that matches the specified contract type and import cardinality.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="part" /> contains an import definition of type <paramref name="T" /> that has the specified import cardinality; otherwise, false.</para>
+        </returns>
         <param name="part">
           <attribution license="cc4" from="Microsoft" modified="false" />The part to search.</param>
         <param name="importCardinality">
@@ -608,7 +656,6 @@
         <Parameter Name="attributedPart" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Unlike ordinary composition, parts composed with this method are not guaranteed to remain valid if the catalog behind <paramref name="compositionService" /> changes.</para>
@@ -617,6 +664,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Composes the specified part by using the specified composition service, with recomposition disabled.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The composed part.</para>
+        </returns>
         <param name="compositionService">
           <attribution license="cc4" from="Microsoft" modified="false" />The composition service to use.</param>
         <param name="attributedPart">
@@ -639,12 +690,15 @@
         <Parameter Name="reflectionContext" Type="System.Reflection.ReflectionContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Composes the specified part by using the specified composition service, with recomposition disabled and using the specified reflection context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The composed part.</para>
+        </returns>
         <param name="compositionService">
           <attribution license="cc4" from="Microsoft" modified="false" />The composition service to use.</param>
         <param name="attributedPart">
diff --git a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition/CatalogReflectionContextAttribute.xml b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition/CatalogReflectionContextAttribute.xml
index ae29b29938e..e4500e9a8c2 100644
--- a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition/CatalogReflectionContextAttribute.xml
+++ b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition/CatalogReflectionContextAttribute.xml
@@ -55,12 +55,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the custom <see cref="T:System.Reflection.ReflectionContext" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the custom reflection context.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition/CompositionError.xml b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition/CompositionError.xml
index ef617c7eeb0..24e67be6a23 100644
--- a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition/CompositionError.xml
+++ b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition/CompositionError.xml
@@ -184,12 +184,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of the composition error.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the <see cref="P:System.ComponentModel.Composition.CompositionError.Description" /> property.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition/ExportFactory`1.xml b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition/ExportFactory`1.xml
index bdc07f55c42..1b2b95edc66 100644
--- a/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition/ExportFactory`1.xml
+++ b/mcs/class/System.ComponentModel.Composition/Documentation/en/System.ComponentModel.Composition/ExportFactory`1.xml
@@ -66,12 +66,15 @@ Public Property theData As ExportFactory(Of String)</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the factory's export type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A valid instance of the factory's exported type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="OnFilterScopedCatalog">
@@ -88,12 +91,15 @@ Public Property theData As ExportFactory(Of String)</code>
         <Parameter Name="composablePartDefinition" Type="System.ComponentModel.Composition.Primitives.ComposablePartDefinition" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, filters part definitions in the scope of the <see cref="T:System.ComponentModel.Composition.ExportFactory`1" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the part definition should be included in the scope; otherwise, false.</para>
+        </returns>
         <param name="composablePartDefinition">
           <attribution license="cc4" from="Microsoft" modified="false" />The part definition to filter.</param>
       </Docs>
diff --git a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/AssociatedMetadataTypeTypeDescriptionProvider.xml b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/AssociatedMetadataTypeTypeDescriptionProvider.xml
index 00dd945b260..c1e324f669d 100644
--- a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/AssociatedMetadataTypeTypeDescriptionProvider.xml
+++ b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/AssociatedMetadataTypeTypeDescriptionProvider.xml
@@ -79,12 +79,15 @@
         <Parameter Name="instance" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a type descriptor for the specified type and object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The descriptor that provides metadata for the type.</para>
+        </returns>
         <param name="objectType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of object to retrieve the type descriptor for.</param>
         <param name="instance">
diff --git a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/CompareAttribute.xml b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/CompareAttribute.xml
index 6b544da3d9d..beb6d3a3d9a 100644
--- a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/CompareAttribute.xml
+++ b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/CompareAttribute.xml
@@ -57,12 +57,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Applies formatting to an error message, based on the data field where the error occurred.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The formatted error message.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the field that caused the validation failure.</param>
       </Docs>
@@ -83,12 +86,15 @@
       </Parameters>
       <Docs>
         <param name="context">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a specified object is valid.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is valid; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to validate.</param>
       </Docs>
diff --git a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/CreditCardAttribute.xml b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/CreditCardAttribute.xml
index 8934a5756c2..3a436539b7d 100644
--- a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/CreditCardAttribute.xml
+++ b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/CreditCardAttribute.xml
@@ -56,7 +56,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The value is validated using a regular expression. The class does not validate that the credit card number is valid for purchases, only that it is well formed.</para>
@@ -65,6 +64,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified credit card number is valid. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the credit card number is valid; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate.</param>
       </Docs>
diff --git a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/CustomValidationAttribute.xml b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/CustomValidationAttribute.xml
index df7341ccce7..277526a3e48 100644
--- a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/CustomValidationAttribute.xml
+++ b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/CustomValidationAttribute.xml
@@ -68,7 +68,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The error message is formatted at run time to include the <paramref name="name" /> value that is passed to this method.</para>
@@ -77,6 +76,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Formats a validation error message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the formatted error message.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name to include in the formatted message.</param>
       </Docs>
diff --git a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/DataTypeAttribute.xml b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/DataTypeAttribute.xml
index 50a5064c06d..cbbf0dc561f 100644
--- a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/DataTypeAttribute.xml
+++ b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/DataTypeAttribute.xml
@@ -164,7 +164,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The name of the type that is associated with the data field.</para>
@@ -173,6 +172,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the type that is associated with the data field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the type associated with the data field.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsValid">
@@ -189,7 +192,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method implements validation logic that is specific to the <see cref="T:System.ComponentModel.DataAnnotations.DataTypeAttribute" /> attribute.</para>
@@ -198,6 +200,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks that the value of the data field is valid.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true always.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The data field value to validate.</param>
       </Docs>
diff --git a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/DisplayAttribute.xml b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/DisplayAttribute.xml
index 16c8f19be46..daf7307c29a 100644
--- a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/DisplayAttribute.xml
+++ b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/DisplayAttribute.xml
@@ -125,12 +125,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.AutoGenerateField" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.AutoGenerateField" /> if the property has been initialized; otherwise, null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetAutoGenerateFilter">
@@ -145,12 +148,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether UI should be generated automatically in order to display filtering for this field. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.AutoGenerateFilter" /> if the property has been initialized; otherwise, null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetDescription">
@@ -165,7 +171,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.Description" /> property is typically used as a tooltip for the property that is annotated with this attribute.</para>
@@ -174,6 +179,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.Description" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The localized description, if the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.ResourceType" /> has been specified and the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.Description" /> property represents a resource key; otherwise, the non-localized value of the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.Description" /> property.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetGroupName">
@@ -188,12 +197,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.GroupName" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that will be used for grouping fields in the UI, if <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.GroupName" /> has been initialized; otherwise, null. If the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.ResourceType" /> property has been specified and the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.GroupName" /> property represents a resource key, a localized string is returned; otherwise, a non-localized string is returned.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetName">
@@ -208,7 +220,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The name is typically used as the field label for a UI element that is bound to the property that is annotated with the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.Name" /> property. A null value or empty string is valid.</para>
@@ -217,6 +228,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that is used for field display in the UI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The localized string for the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.Name" /> property, if the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.ResourceType" /> property has been specified and the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.Name" /> property represents a resource key; otherwise, the non-localized value of the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.Name" /> property.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOrder">
@@ -231,7 +246,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If an order is not specified, presentation layers should consider setting the value of the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.Order" /> property to 10000. This value lets explicitly-ordered fields be displayed before and after the fields that do not have a specified order.</para>
@@ -240,6 +254,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.Order" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.Order" /> property, if it has been set; otherwise, null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetPrompt">
@@ -254,7 +272,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.Prompt" /> property is typically used as a prompt or watermark for a UI element that is bound to the property that is annotated with the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.Prompt" /> attribute.</para>
@@ -263,6 +280,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.Prompt" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Gets the localized string for the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.Prompt" /> property if the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.ResourceType" /> property has been specified and if the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.Prompt" /> property represents a resource key; otherwise, the non-localized value of the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.Prompt" /> property.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetShortName">
@@ -277,7 +298,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The short name is used as the grid column label for a UI element that is bound to the property that is annotated with this attribute. This property returns either the literal, non-localized string, or a localized string if <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.ResourceType" /> is not null.</para>
@@ -286,6 +306,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.ShortName" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The localized string for the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.ShortName" /> property if the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.ResourceType" /> property has been specified and if the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.ShortName" /> property represents a resource key; otherwise, the non-localized value of the <see cref="P:System.ComponentModel.DataAnnotations.DisplayAttribute.ShortName" /> value property.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GroupName">
diff --git a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/EmailAddressAttribute.xml b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/EmailAddressAttribute.xml
index 3a05f94ed67..2f1e05a75be 100644
--- a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/EmailAddressAttribute.xml
+++ b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/EmailAddressAttribute.xml
@@ -53,12 +53,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified value matches the pattern of a valid email address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified value is valid or null; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate.</param>
       </Docs>
diff --git a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/EnumDataTypeAttribute.xml b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/EnumDataTypeAttribute.xml
index 3d8a95a6f18..87d86fde8cf 100644
--- a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/EnumDataTypeAttribute.xml
+++ b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/EnumDataTypeAttribute.xml
@@ -79,12 +79,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks that the value of the data field is valid.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the data field value is valid; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The data field value to validate.</param>
       </Docs>
diff --git a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/FileExtensionsAttribute.xml b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/FileExtensionsAttribute.xml
index e9942ae3d7d..57a44e8e9ca 100644
--- a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/FileExtensionsAttribute.xml
+++ b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/FileExtensionsAttribute.xml
@@ -72,12 +72,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Applies formatting to an error message, based on the data field where the error occurred.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The formatted error message.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the field that caused the validation failure.</param>
       </Docs>
@@ -96,12 +99,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks that the specified file name extension or extensions is valid.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the file name extension is valid; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A comma delimited list of valid file extensions.</param>
       </Docs>
diff --git a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/FilterUIHintAttribute.xml b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/FilterUIHintAttribute.xml
index 9129035994b..244bc9fde3d 100644
--- a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/FilterUIHintAttribute.xml
+++ b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/FilterUIHintAttribute.xml
@@ -131,12 +131,17 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether this attribute instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para />
+          <para>True if the passed object is equal to this attribute instance; otherwise, false.</para>
+          <para />
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this attribute instance.</param>
       </Docs>
@@ -172,12 +177,17 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this attribute instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para />
+          <para>This attribute insatnce hash code.</para>
+          <para />
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="PresentationLayer">
diff --git a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/IValidatableObject.xml b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/IValidatableObject.xml
index 042a4355ece..118358ae61e 100644
--- a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/IValidatableObject.xml
+++ b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/IValidatableObject.xml
@@ -29,12 +29,15 @@
         <Parameter Name="validationContext" Type="System.ComponentModel.DataAnnotations.ValidationContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified object is valid.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection that holds failed-validation information.</para>
+        </returns>
         <param name="validationContext">
           <attribution license="cc4" from="Microsoft" modified="false" />The validation context.</param>
       </Docs>
diff --git a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/MaxLengthAttribute.xml b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/MaxLengthAttribute.xml
index 2f28ec37370..4ca25269ea9 100644
--- a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/MaxLengthAttribute.xml
+++ b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/MaxLengthAttribute.xml
@@ -76,12 +76,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Applies formatting to a specified error message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A localized string to describe the maximum acceptable length.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name to include in the formatted string.</param>
       </Docs>
@@ -100,7 +103,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns true if the <paramref name="value" /> parameter is null.</para>
@@ -109,6 +111,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a specified object is valid.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value is null, or if the value is less than or equal to the specified maximum length; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to validate.</param>
       </Docs>
diff --git a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/MinLengthAttribute.xml b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/MinLengthAttribute.xml
index 4d8e4b69e07..8035eb86686 100644
--- a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/MinLengthAttribute.xml
+++ b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/MinLengthAttribute.xml
@@ -70,12 +70,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Applies formatting to a specified error message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A localized string to describe the minimum acceptable length.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name to include in the formatted string.</param>
       </Docs>
@@ -94,12 +97,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a specified object is valid.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified object is valid; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to validate.</param>
       </Docs>
diff --git a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/PhoneAttribute.xml b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/PhoneAttribute.xml
index 3ec6714a17b..2122480e0d7 100644
--- a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/PhoneAttribute.xml
+++ b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/PhoneAttribute.xml
@@ -53,12 +53,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified phone number is in a valid phone number format. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the phone number is valid; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate.</param>
       </Docs>
diff --git a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/RangeAttribute.xml b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/RangeAttribute.xml
index 1283065f25d..860a673f969 100644
--- a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/RangeAttribute.xml
+++ b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/RangeAttribute.xml
@@ -115,7 +115,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.DataAnnotations.RangeAttribute.FormatErrorMessage(System.String)" /> creates the error message by using the name of the data field that caused the validation failure. You can override this method in a custom validation attribute to customize how errors are created, or to provide a more complex message that contains parameters that you evaluate at run time. For an example, see the <see cref="M:System.ComponentModel.DataAnnotations.RangeAttribute.#ctor(System.Type,System.String,System.String)" /> constructor.</para>
@@ -124,6 +123,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Formats the error message that is displayed when range validation fails.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The formatted error message.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the field that caused the validation failure. </param>
       </Docs>
@@ -142,12 +145,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks that the value of the data field is in the specified range.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified value is in the range; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The data field value to validate.</param>
       </Docs>
diff --git a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/RegularExpressionAttribute.xml b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/RegularExpressionAttribute.xml
index f498cd80f2e..eb482670c50 100644
--- a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/RegularExpressionAttribute.xml
+++ b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/RegularExpressionAttribute.xml
@@ -60,7 +60,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.DataAnnotations.RegularExpressionAttribute.FormatErrorMessage(System.String)" /> creates the error message by using the name of the data field that caused the validation failure. You can override this method in custom validation attributes to customize how errors are created or to provide a more complex message that contains parameters that you evaluate at run time. </para>
@@ -69,6 +68,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Formats the error message to display if the regular expression validation fails.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The formatted error message.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the field that caused the validation failure.</param>
       </Docs>
@@ -87,12 +90,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks whether the value entered by the user matches the regular expression pattern. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if validation is successful; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The data field value to validate.</param>
       </Docs>
diff --git a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/RequiredAttribute.xml b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/RequiredAttribute.xml
index 5c478b101d3..3dece32de1f 100644
--- a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/RequiredAttribute.xml
+++ b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/RequiredAttribute.xml
@@ -83,7 +83,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the value is an empty string, the method returns false and a validation error is displayed.</para>
@@ -92,6 +91,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks that the value of the required data field is not empty.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if validation is successful; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The data field value to validate.</param>
       </Docs>
diff --git a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/StringLengthAttribute.xml b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/StringLengthAttribute.xml
index ff788922001..0223bb51b52 100644
--- a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/StringLengthAttribute.xml
+++ b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/StringLengthAttribute.xml
@@ -60,12 +60,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Applies formatting to a specified error message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The formatted error message.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the field that caused the validation failure.</param>
       </Docs>
@@ -84,7 +87,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method determines whether an object is valid. If the value of the object is null, the method automatically validates object. </para>
@@ -93,6 +95,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a specified object is valid.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified object is valid; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to validate.</param>
       </Docs>
diff --git a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/UIHintAttribute.xml b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/UIHintAttribute.xml
index 425545390cd..df3d7153f49 100644
--- a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/UIHintAttribute.xml
+++ b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/UIHintAttribute.xml
@@ -143,12 +143,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether this instance is equal to the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified object is equal to this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this instance, or a null reference.</param>
       </Docs>
@@ -165,12 +168,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash code for the current instance of the attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The attribute instance hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="PresentationLayer">
diff --git a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/ValidationAttribute.xml b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/ValidationAttribute.xml
index 5913ef4bfb0..d579c6eecad 100644
--- a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/ValidationAttribute.xml
+++ b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/ValidationAttribute.xml
@@ -182,7 +182,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method formats an error message by using the <see cref="P:System.ComponentModel.DataAnnotations.ValidationAttribute.ErrorMessageString" /> property. This method appends the name of the data field that triggered the error to the formatted error message. You can customize how the error message is formatted by creating a derived class that overrides this method.</para>
@@ -191,6 +190,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Applies formatting to an error message, based on the data field where the error occurred. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the formatted error message.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name to include in the formatted message.</param>
       </Docs>
@@ -210,7 +213,6 @@
         <Parameter Name="validationContext" Type="System.ComponentModel.DataAnnotations.ValidationContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.DataAnnotations.ValidationAttribute.GetValidationResult(System.Object,System.ComponentModel.DataAnnotations.ValidationContext)" /> method checks validity without throwing an exception.</para>
@@ -219,6 +221,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks whether the specified value is valid with respect to the current validation attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the <see cref="T:System.ComponentModel.DataAnnotations.ValidationResult" /> class. </para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate.</param>
         <param name="validationContext">
@@ -239,7 +245,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you inherit from the <see cref="T:System.ComponentModel.DataAnnotations.ValidationAttribute" /> class, you must implement the validation logic in this method.</para>
@@ -248,6 +253,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified value of the object is valid. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified value is valid; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value of the object to validate. </param>
       </Docs>
@@ -267,12 +276,15 @@
         <Parameter Name="validationContext" Type="System.ComponentModel.DataAnnotations.ValidationContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified value with respect to the current validation attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the <see cref="T:System.ComponentModel.DataAnnotations.ValidationResult" /> class. </para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate.</param>
         <param name="validationContext">
diff --git a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/ValidationContext.xml b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/ValidationContext.xml
index 6ed318eee68..70d54c92b3c 100644
--- a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/ValidationContext.xml
+++ b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/ValidationContext.xml
@@ -137,7 +137,6 @@
         <Parameter Name="serviceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="P:System.ComponentModel.DataAnnotations.ValidationContext.ServiceContainer" /> object is defined at the application level, the <see cref="M:System.ComponentModel.DataAnnotations.ValidationContext.GetService(System.Type)" /> method accesses it to retrieve the requested service. </para>
@@ -147,6 +146,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the service that provides custom validation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the service, or null if the service is not available.</para>
+        </returns>
         <param name="serviceType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the service to use for validation.</param>
       </Docs>
diff --git a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/ValidationResult.xml b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/ValidationResult.xml
index 24786ad16a5..2944bc6beaf 100644
--- a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/ValidationResult.xml
+++ b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/ValidationResult.xml
@@ -158,12 +158,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of the current validation result.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current validation result.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/Validator.xml b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/Validator.xml
index 30d35c67788..47831754758 100644
--- a/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/Validator.xml
+++ b/mcs/class/System.ComponentModel.DataAnnotations/Documentation/en/System.ComponentModel.DataAnnotations/Validator.xml
@@ -34,7 +34,6 @@
         <Parameter Name="validationResults" Type="System.Collections.Generic.ICollection&lt;System.ComponentModel.DataAnnotations.ValidationResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method evaluates each <see cref="T:System.ComponentModel.DataAnnotations.ValidationAttribute" /> instance that is attached to the object type. It also checks whether each property that is marked with <see cref="T:System.ComponentModel.DataAnnotations.RequiredAttribute" /> is provided. It does not recursively validate the property values of the object.</para>
@@ -43,6 +42,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified object is valid using the validation context and validation results collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object validates; otherwise, false.</para>
+        </returns>
         <param name="instance">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to validate.</param>
         <param name="validationContext">
@@ -68,7 +71,6 @@
         <Parameter Name="validateAllProperties" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method evaluates each <see cref="T:System.ComponentModel.DataAnnotations.ValidationAttribute" /> instance that is attached to the object type. It also checks whether each property that is marked with <see cref="T:System.ComponentModel.DataAnnotations.RequiredAttribute" /> is provided. It does not recursively validate the property values of the object.</para>
@@ -77,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified object is valid using the validation context, validation results collection, and a value that specifies whether to validate all properties.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object validates; otherwise, false.</para>
+        </returns>
         <param name="instance">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to validate.</param>
         <param name="validationContext">
@@ -103,7 +109,6 @@
         <Parameter Name="validationResults" Type="System.Collections.Generic.ICollection&lt;System.ComponentModel.DataAnnotations.ValidationResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method tests each <see cref="P:System.ComponentModel.DataAnnotations.ValidationException.ValidationAttribute" /> instance that is associated with the property that is identified by the <paramref name="validationContext" /> parameter.</para>
@@ -112,6 +117,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property validates; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate.</param>
         <param name="validationContext">
@@ -137,7 +146,6 @@
         <Parameter Name="validationAttributes" Type="System.Collections.Generic.IEnumerable&lt;System.ComponentModel.DataAnnotations.ValidationAttribute&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method tests each validation attribute in the <paramref name="validationAttributes" /> parameter against the <paramref name="value" /> parameter. If the <paramref name="validationResults" /> parameter is not null, this method adds a <see cref="T:System.ComponentModel.DataAnnotations.ValidationResult" /> object for each validation failure to the validation results collection. If the <paramref name="validationResults" /> parameter is null, this method does not add a <see cref="T:System.ComponentModel.DataAnnotations.ValidationResult" /> object to the collection. If a <see cref="T:System.ComponentModel.DataAnnotations.RequiredAttribute" /> attribute is included in the <paramref name="validationAttributes" /> parameter, the <see cref="T:System.ComponentModel.DataAnnotations.RequiredAttribute" /> attribute is evaluated first.</para>
@@ -146,6 +154,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the specified value is valid with the specified attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object validates; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate.</param>
         <param name="validationContext">
diff --git a/mcs/class/System.Configuration.Install/Documentation/en/System.Configuration.Install/ComponentInstaller.xml b/mcs/class/System.Configuration.Install/Documentation/en/System.Configuration.Install/ComponentInstaller.xml
index 2c0e721e723..f6604c71c3d 100644
--- a/mcs/class/System.Configuration.Install/Documentation/en/System.Configuration.Install/ComponentInstaller.xml
+++ b/mcs/class/System.Configuration.Install/Documentation/en/System.Configuration.Install/ComponentInstaller.xml
@@ -70,7 +70,6 @@
         <Parameter Name="otherInstaller" Type="System.Configuration.Install.ComponentInstaller" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Typically, <see cref="M:System.Configuration.Install.ComponentInstaller.IsEquivalentInstaller(System.Configuration.Install.ComponentInstaller)" /> returns true only if this installer and the installer specified by the <paramref name="otherInstaller" /> parameter install the same object. In such a case, calling the <see cref="M:System.Configuration.Install.Installer.Install(System.Collections.IDictionary)" /> or <see cref="M:System.Configuration.Install.Installer.Uninstall(System.Collections.IDictionary)" /> method on either installer results in the same system state.</para>
@@ -79,6 +78,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the specified installer installs the same object as this installer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this installer and the installer specified by the <paramref name="otherInstaller" /> parameter install the same object; otherwise, false.</para>
+        </returns>
         <param name="otherInstaller">
           <attribution license="cc4" from="Microsoft" modified="false" />The installer to compare. </param>
       </Docs>
diff --git a/mcs/class/System.Configuration.Install/Documentation/en/System.Configuration.Install/IManagedInstaller.xml b/mcs/class/System.Configuration.Install/Documentation/en/System.Configuration.Install/IManagedInstaller.xml
index fcbb778cc8e..933e5e5e799 100644
--- a/mcs/class/System.Configuration.Install/Documentation/en/System.Configuration.Install/IManagedInstaller.xml
+++ b/mcs/class/System.Configuration.Install/Documentation/en/System.Configuration.Install/IManagedInstaller.xml
@@ -34,12 +34,15 @@
         <Parameter Name="hInstall" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a managed installation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return code for installutil.exe. A successful installation returns 0. Other values indicate failure.</para>
+        </returns>
         <param name="commandLine">
           <attribution license="cc4" from="Microsoft" modified="false" />The command line that specifies the installation.</param>
         <param name="hInstall">
diff --git a/mcs/class/System.Configuration.Install/Documentation/en/System.Configuration.Install/InstallContext.xml b/mcs/class/System.Configuration.Install/Documentation/en/System.Configuration.Install/InstallContext.xml
index b256858cc42..9d08c8b2e5d 100644
--- a/mcs/class/System.Configuration.Install/Documentation/en/System.Configuration.Install/InstallContext.xml
+++ b/mcs/class/System.Configuration.Install/Documentation/en/System.Configuration.Install/InstallContext.xml
@@ -79,7 +79,6 @@
         <Parameter Name="paramName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method accesses the <see cref="P:System.Configuration.Install.InstallContext.Parameters" /> property, which contains a parsed version of the command-line parameters, to determine whether the specified parameter is true.</para>
@@ -88,6 +87,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified command-line parameter is true.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified parameter is set to "yes", "true", "1", or an empty string (""); otherwise, false.</para>
+        </returns>
         <param name="paramName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the command-line parameter to check. </param>
       </Docs>
@@ -154,12 +157,15 @@
         <Parameter Name="args" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Parses the command-line parameters into a string dictionary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.Specialized.StringDictionary" /> containing the parsed command-line parameters.</para>
+        </returns>
         <param name="args">
           <attribution license="cc4" from="Microsoft" modified="false" />An array containing the command-line parameters. </param>
       </Docs>
diff --git a/mcs/class/System.Configuration.Install/Documentation/en/System.Configuration.Install/InstallerCollection.xml b/mcs/class/System.Configuration.Install/Documentation/en/System.Configuration.Install/InstallerCollection.xml
index 35c7e4b6997..3e8faef8274 100644
--- a/mcs/class/System.Configuration.Install/Documentation/en/System.Configuration.Install/InstallerCollection.xml
+++ b/mcs/class/System.Configuration.Install/Documentation/en/System.Configuration.Install/InstallerCollection.xml
@@ -46,7 +46,6 @@
         <Parameter Name="value" Type="System.Configuration.Install.Installer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Configuration.Install.Installer.Parent" /> property of the added <see cref="T:System.Configuration.Install.Installer" /> is set to specify the <see cref="T:System.Configuration.Install.Installer" /> containing this collection.</para>
@@ -55,6 +54,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified installer to this collection of installers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the added installer.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Configuration.Install.Installer" /> that represents the installer to add to the collection. </param>
       </Docs>
@@ -125,12 +128,15 @@
         <Parameter Name="value" Type="System.Configuration.Install.Installer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified installer is included in collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified installer is in this collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Configuration.Install.Installer" /> that represents the installer to look for. </param>
       </Docs>
@@ -175,12 +181,15 @@
         <Parameter Name="value" Type="System.Configuration.Install.Installer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of a specified installer in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the installer in the collection.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Configuration.Install.Installer" /> to locate in the collection. </param>
       </Docs>
diff --git a/mcs/class/System.Configuration.Install/Documentation/en/System.Configuration.Install/ManagedInstallerClass.xml b/mcs/class/System.Configuration.Install/Documentation/en/System.Configuration.Install/ManagedInstallerClass.xml
index d0a5b27a18d..0fc29fff1cf 100644
--- a/mcs/class/System.Configuration.Install/Documentation/en/System.Configuration.Install/ManagedInstallerClass.xml
+++ b/mcs/class/System.Configuration.Install/Documentation/en/System.Configuration.Install/ManagedInstallerClass.xml
@@ -84,7 +84,6 @@
         <Parameter Name="hInstall" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Configuration.Install.ManagedInstallerClass" /> instance is cast to an <see cref="T:System.Configuration.Install.IManagedInstaller" /> interface.</para>
@@ -93,6 +92,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Configuration.Install.IManagedInstaller.ManagedInstall(System.String,System.Int32)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return code for installutil.exe. A successful installation returns 0. Other values indicate failure.</para>
+        </returns>
         <param name="argString">
           <attribution license="cc4" from="Microsoft" modified="false" />The command line to install.</param>
         <param name="hInstall">
diff --git a/mcs/class/System.Configuration.Install/Documentation/en/System.Diagnostics/EventLogInstaller.xml b/mcs/class/System.Configuration.Install/Documentation/en/System.Diagnostics/EventLogInstaller.xml
index aaedc028fd8..ed2aba908de 100644
--- a/mcs/class/System.Configuration.Install/Documentation/en/System.Diagnostics/EventLogInstaller.xml
+++ b/mcs/class/System.Configuration.Install/Documentation/en/System.Diagnostics/EventLogInstaller.xml
@@ -181,7 +181,6 @@
         <Parameter Name="otherInstaller" Type="System.Configuration.Install.ComponentInstaller" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Typically, you do not call the methods of the <see cref="T:System.Diagnostics.EventLogInstaller" /> from within your code; they are generally called only by the Installer tool (Installutil.exe).</para>
@@ -190,6 +189,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether an installer and another specified installer refer to the same source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this installer and the installer specified by the <paramref name="otherInstaller" /> parameter would install or uninstall the same source; otherwise, false.</para>
+        </returns>
         <param name="otherInstaller">
           <attribution license="cc4" from="Microsoft" modified="false" />The installer to compare. </param>
       </Docs>
diff --git a/mcs/class/System.Core/Documentation/en/System.Dynamic/BinaryOperationBinder.xml b/mcs/class/System.Core/Documentation/en/System.Dynamic/BinaryOperationBinder.xml
index 6b0022c7404..98a55b8b65a 100644
--- a/mcs/class/System.Core/Documentation/en/System.Dynamic/BinaryOperationBinder.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Dynamic/BinaryOperationBinder.xml
@@ -53,12 +53,15 @@
         <Parameter Name="args" Type="System.Dynamic.DynamicMetaObject[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic binary operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic operation.</param>
         <param name="args">
@@ -80,12 +83,15 @@
         <Parameter Name="arg" Type="System.Dynamic.DynamicMetaObject" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the binary dynamic operation if the target dynamic object cannot bind.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic binary operation.</param>
         <param name="arg">
@@ -108,12 +114,15 @@
         <Parameter Name="errorSuggestion" Type="System.Dynamic.DynamicMetaObject" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in the derived class, performs the binding of the binary dynamic operation if the target dynamic object cannot bind.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic binary operation.</param>
         <param name="arg">
diff --git a/mcs/class/System.Core/Documentation/en/System.Dynamic/BindingRestrictions.xml b/mcs/class/System.Core/Documentation/en/System.Dynamic/BindingRestrictions.xml
index f19515d56d6..d0032f54da0 100644
--- a/mcs/class/System.Core/Documentation/en/System.Dynamic/BindingRestrictions.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Dynamic/BindingRestrictions.xml
@@ -40,12 +40,15 @@
         <Parameter Name="contributingObjects" Type="System.Collections.Generic.IList&lt;System.Dynamic.DynamicMetaObject&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Combines binding restrictions from the list of <see cref="T:System.Dynamic.DynamicMetaObject" /> instances into one set of restrictions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new set of binding restrictions.</para>
+        </returns>
         <param name="contributingObjects">
           <attribution license="cc4" from="Microsoft" modified="false" />The list of <see cref="T:System.Dynamic.DynamicMetaObject" /> instances from which to combine restrictions.</param>
       </Docs>
@@ -82,7 +85,6 @@
         <Parameter Name="expression" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>By convention, the general restrictions created by this method must only test immutable object properties.</para>
@@ -91,6 +93,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the binding restriction that checks the expression for arbitrary immutable properties.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new binding restrictions.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression representing the restrictions.</param>
       </Docs>
@@ -110,12 +116,15 @@
         <Parameter Name="instance" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the binding restriction that checks the expression for object instance identity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new binding restrictions.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to test.</param>
         <param name="instance">
@@ -137,12 +146,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the binding restriction that check the expression for runtime type identity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new binding restrictions.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to test.</param>
         <param name="type">
@@ -163,12 +175,15 @@
         <Parameter Name="restrictions" Type="System.Dynamic.BindingRestrictions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Merges the set of binding restrictions with the current binding restrictions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new set of binding restrictions.</para>
+        </returns>
         <param name="restrictions">
           <attribution license="cc4" from="Microsoft" modified="false" />The set of restrictions with which to merge the current binding restrictions.</param>
       </Docs>
@@ -185,12 +200,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the <see cref="T:System.Linq.Expressions.Expression" /> representing the binding restrictions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The expression tree representing the restrictions.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Core/Documentation/en/System.Dynamic/CallInfo.xml b/mcs/class/System.Core/Documentation/en/System.Dynamic/CallInfo.xml
index b1c3f4561ba..be417c0f3f9 100644
--- a/mcs/class/System.Core/Documentation/en/System.Dynamic/CallInfo.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Dynamic/CallInfo.xml
@@ -127,12 +127,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified CallInfo instance is considered equal to the current.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified instance is equal to the current one otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The instance of <see cref="T:System.Dynamic.CallInfo" /> to compare with the current instance.</param>
       </Docs>
@@ -149,12 +152,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for the current <see cref="T:System.Dynamic.CallInfo" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.Dynamic.CallInfo" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Core/Documentation/en/System.Dynamic/ConvertBinder.xml b/mcs/class/System.Core/Documentation/en/System.Dynamic/ConvertBinder.xml
index 2a47a891f65..49068abf1ab 100644
--- a/mcs/class/System.Core/Documentation/en/System.Dynamic/ConvertBinder.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Dynamic/ConvertBinder.xml
@@ -56,12 +56,15 @@
         <Parameter Name="args" Type="System.Dynamic.DynamicMetaObject[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic convert operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic convert operation.</param>
         <param name="args">
@@ -101,12 +104,15 @@
         <Parameter Name="target" Type="System.Dynamic.DynamicMetaObject" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic convert operation if the target dynamic object cannot bind.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic convert operation.</param>
       </Docs>
@@ -126,12 +132,15 @@
         <Parameter Name="errorSuggestion" Type="System.Dynamic.DynamicMetaObject" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in the derived class, performs the binding of the dynamic convert operation if the target dynamic object cannot bind.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic convert operation.</param>
         <param name="errorSuggestion">
diff --git a/mcs/class/System.Core/Documentation/en/System.Dynamic/CreateInstanceBinder.xml b/mcs/class/System.Core/Documentation/en/System.Dynamic/CreateInstanceBinder.xml
index 54f34638577..7d310098f28 100644
--- a/mcs/class/System.Core/Documentation/en/System.Dynamic/CreateInstanceBinder.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Dynamic/CreateInstanceBinder.xml
@@ -53,12 +53,15 @@
         <Parameter Name="args" Type="System.Dynamic.DynamicMetaObject[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic create operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic create operation.</param>
         <param name="args">
@@ -99,12 +102,15 @@
         <Parameter Name="args" Type="System.Dynamic.DynamicMetaObject[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic create operation if the target dynamic object cannot bind.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic create operation.</param>
         <param name="args">
@@ -127,12 +133,15 @@
         <Parameter Name="errorSuggestion" Type="System.Dynamic.DynamicMetaObject" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in the derived class, performs the binding of the dynamic create operation if the target dynamic object cannot bind.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic create operation.</param>
         <param name="args">
diff --git a/mcs/class/System.Core/Documentation/en/System.Dynamic/DeleteIndexBinder.xml b/mcs/class/System.Core/Documentation/en/System.Dynamic/DeleteIndexBinder.xml
index 1c2a0f3f4fa..6f14c9ff51d 100644
--- a/mcs/class/System.Core/Documentation/en/System.Dynamic/DeleteIndexBinder.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Dynamic/DeleteIndexBinder.xml
@@ -53,12 +53,15 @@
         <Parameter Name="args" Type="System.Dynamic.DynamicMetaObject[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic delete index operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic delete index operation.</param>
         <param name="args">
@@ -99,12 +102,15 @@
         <Parameter Name="indexes" Type="System.Dynamic.DynamicMetaObject[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic delete index operation if the target dynamic object cannot bind.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic delete index operation.</param>
         <param name="indexes">
@@ -127,12 +133,15 @@
         <Parameter Name="errorSuggestion" Type="System.Dynamic.DynamicMetaObject" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in the derived class, performs the binding of the dynamic delete index operation if the target dynamic object cannot bind.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic delete index operation.</param>
         <param name="indexes">
diff --git a/mcs/class/System.Core/Documentation/en/System.Dynamic/DeleteMemberBinder.xml b/mcs/class/System.Core/Documentation/en/System.Dynamic/DeleteMemberBinder.xml
index 86e50b58257..9b8ec9e44bc 100644
--- a/mcs/class/System.Core/Documentation/en/System.Dynamic/DeleteMemberBinder.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Dynamic/DeleteMemberBinder.xml
@@ -56,12 +56,15 @@
         <Parameter Name="args" Type="System.Dynamic.DynamicMetaObject[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic delete member operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic delete member operation.</param>
         <param name="args">
@@ -82,12 +85,15 @@
         <Parameter Name="target" Type="System.Dynamic.DynamicMetaObject" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic delete member operation if the target dynamic object cannot bind.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic delete member operation.</param>
       </Docs>
@@ -107,12 +113,15 @@
         <Parameter Name="errorSuggestion" Type="System.Dynamic.DynamicMetaObject" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in the derived class, performs the binding of the dynamic delete member operation if the target dynamic object cannot bind.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic delete member operation.</param>
         <param name="errorSuggestion">
diff --git a/mcs/class/System.Core/Documentation/en/System.Dynamic/DynamicMetaObject.xml b/mcs/class/System.Core/Documentation/en/System.Dynamic/DynamicMetaObject.xml
index c49531a0fc1..587fbfb31e4 100644
--- a/mcs/class/System.Core/Documentation/en/System.Dynamic/DynamicMetaObject.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Dynamic/DynamicMetaObject.xml
@@ -85,12 +85,15 @@
         <Parameter Name="arg" Type="System.Dynamic.DynamicMetaObject" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic binary operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="binder">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of the <see cref="T:System.Dynamic.BinaryOperationBinder" /> that represents the details of the dynamic operation.</param>
         <param name="arg">
@@ -111,7 +114,6 @@
         <Parameter Name="binder" Type="System.Dynamic.ConvertBinder" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In Visual Basic, only explicit conversion is supported. If you override this method, it is called by using the <see cref="M:Microsoft.VisualBasic.Conversion.CTypeDynamic``1(System.Object)" /> or <see cref="M:Microsoft.VisualBasic.Conversion.CTypeDynamic(System.Object,System.Type)" /> functions.</para>
@@ -120,6 +122,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic conversion operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="binder">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of the <see cref="T:System.Dynamic.ConvertBinder" /> that represents the details of the dynamic operation.</param>
       </Docs>
@@ -139,12 +145,15 @@
         <Parameter Name="args" Type="System.Dynamic.DynamicMetaObject[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic create instance operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="binder">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of the <see cref="T:System.Dynamic.CreateInstanceBinder" /> that represents the details of the dynamic operation.</param>
         <param name="args">
@@ -166,12 +175,15 @@
         <Parameter Name="indexes" Type="System.Dynamic.DynamicMetaObject[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic delete index operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="binder">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of the <see cref="T:System.Dynamic.DeleteIndexBinder" /> that represents the details of the dynamic operation.</param>
         <param name="indexes">
@@ -192,12 +204,15 @@
         <Parameter Name="binder" Type="System.Dynamic.DeleteMemberBinder" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic delete member operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="binder">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of the <see cref="T:System.Dynamic.DeleteMemberBinder" /> that represents the details of the dynamic operation.</param>
       </Docs>
@@ -217,12 +232,15 @@
         <Parameter Name="indexes" Type="System.Dynamic.DynamicMetaObject[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic get index operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="binder">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of the <see cref="T:System.Dynamic.GetIndexBinder" /> that represents the details of the dynamic operation.</param>
         <param name="indexes">
@@ -243,12 +261,15 @@
         <Parameter Name="binder" Type="System.Dynamic.GetMemberBinder" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic get member operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="binder">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of the <see cref="T:System.Dynamic.GetMemberBinder" /> that represents the details of the dynamic operation.</param>
       </Docs>
@@ -268,12 +289,15 @@
         <Parameter Name="args" Type="System.Dynamic.DynamicMetaObject[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic invoke operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="binder">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of the <see cref="T:System.Dynamic.InvokeBinder" /> that represents the details of the dynamic operation.</param>
         <param name="args">
@@ -295,12 +319,15 @@
         <Parameter Name="args" Type="System.Dynamic.DynamicMetaObject[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic invoke member operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="binder">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of the <see cref="T:System.Dynamic.InvokeMemberBinder" /> that represents the details of the dynamic operation.</param>
         <param name="args">
@@ -323,12 +350,15 @@
         <Parameter Name="value" Type="System.Dynamic.DynamicMetaObject" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic set index operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="binder">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of the <see cref="T:System.Dynamic.SetIndexBinder" /> that represents the details of the dynamic operation.</param>
         <param name="indexes">
@@ -352,12 +382,15 @@
         <Parameter Name="value" Type="System.Dynamic.DynamicMetaObject" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic set member operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="binder">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of the <see cref="T:System.Dynamic.SetMemberBinder" /> that represents the details of the dynamic operation.</param>
         <param name="value">
@@ -378,12 +411,15 @@
         <Parameter Name="binder" Type="System.Dynamic.UnaryOperationBinder" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic unary operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="binder">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of the <see cref="T:System.Dynamic.UnaryOperationBinder" /> that represents the details of the dynamic operation.</param>
       </Docs>
@@ -403,12 +439,15 @@
         <Parameter Name="expression" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a meta-object for the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If the given object implements <see cref="T:System.Dynamic.IDynamicMetaObjectProvider" /> and is not a remote object from outside the current AppDomain, returns the object's specific meta-object returned by <see cref="M:System.Dynamic.IDynamicMetaObjectProvider.GetMetaObject(System.Linq.Expressions.Expression)" />. Otherwise a plain new meta-object with no restrictions is created and returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to get a meta-object for.</param>
         <param name="expression">
@@ -464,12 +503,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the enumeration of all dynamic member names.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The list of dynamic member names.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HasValue">
diff --git a/mcs/class/System.Core/Documentation/en/System.Dynamic/DynamicMetaObjectBinder.xml b/mcs/class/System.Core/Documentation/en/System.Dynamic/DynamicMetaObjectBinder.xml
index c163f66bf91..4987e96cb72 100644
--- a/mcs/class/System.Core/Documentation/en/System.Dynamic/DynamicMetaObjectBinder.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Dynamic/DynamicMetaObjectBinder.xml
@@ -52,12 +52,15 @@
         <Parameter Name="args" Type="System.Dynamic.DynamicMetaObject[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in the derived class, performs the binding of the dynamic operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic operation.</param>
         <param name="args">
@@ -80,12 +83,15 @@
         <Parameter Name="returnLabel" Type="System.Linq.Expressions.LabelTarget" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the runtime binding of the dynamic operation on a set of arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An Expression that performs tests on the dynamic operation arguments, and performs the dynamic operation if the tests are valid. If the tests fail on subsequent occurrences of the dynamic operation, Bind will be called again to produce a new <see cref="T:System.Linq.Expressions.Expression" /> for the new argument types.</para>
+        </returns>
         <param name="args">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of arguments to the dynamic operation.</param>
         <param name="parameters">
@@ -114,12 +120,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defers the binding of the operation until later time when the runtime values of all dynamic operation arguments have been computed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="args">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of arguments of the dynamic operation.</param>
       </Docs>
@@ -145,12 +154,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defers the binding of the operation until later time when the runtime values of all dynamic operation arguments have been computed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic operation.</param>
         <param name="args">
@@ -171,12 +183,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an expression that will cause the binding to be updated. It indicates that the expression's binding is no longer valid. This is typically used when the "version" of a dynamic object has changed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The update expression.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of the resulting expression; any type is allowed.</param>
       </Docs>
diff --git a/mcs/class/System.Core/Documentation/en/System.Dynamic/DynamicObject.xml b/mcs/class/System.Core/Documentation/en/System.Dynamic/DynamicObject.xml
index 438fb2e4e0d..ee387bffbf3 100644
--- a/mcs/class/System.Core/Documentation/en/System.Dynamic/DynamicObject.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Dynamic/DynamicObject.xml
@@ -76,7 +76,6 @@ Dim sampleObject As Object = New SampleDynamicObject()</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method exists for debugging purposes only.</para>
@@ -85,6 +84,10 @@ Dim sampleObject As Object = New SampleDynamicObject()</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the enumeration of all dynamic member names. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that contains dynamic member names.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetMetaObject">
@@ -101,12 +104,15 @@ Dim sampleObject As Object = New SampleDynamicObject()</code>
         <Parameter Name="parameter" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides a <see cref="T:System.Dynamic.DynamicMetaObject" /> that dispatches to the dynamic virtual methods. The object can be encapsulated inside another <see cref="T:System.Dynamic.DynamicMetaObject" /> to provide custom behavior for individual actions. This method supports the Dynamic Language Runtime infrastructure for language implementers and it is not intended to be used directly from your code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object of the <see cref="T:System.Dynamic.DynamicMetaObject" /> type.</para>
+        </returns>
         <param name="parameter">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression that represents <see cref="T:System.Dynamic.DynamicMetaObject" /> to dispatch to the dynamic virtual methods.</param>
       </Docs>
@@ -196,7 +202,6 @@ Dim sampleObject As Object = New SampleDynamicObject()</code>
         <Parameter Name="indexes" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Classes derived from the <see cref="T:System.Dynamic.DynamicObject" /> class can override this method to specify how a value that has a specified index should be deleted. When the method is not overridden, the run-time binder of the language determines the behavior. (In most cases, a language-specific run-time exception is thrown.)</para>
@@ -206,6 +211,10 @@ Dim sampleObject As Object = New SampleDynamicObject()</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides the implementation for operations that delete an object by index. This method is not intended for use in C# or Visual Basic.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the operation is successful; otherwise, false. If this method returns false, the run-time binder of the language determines the behavior. (In most cases, a language-specific run-time exception is thrown.)</para>
+        </returns>
         <param name="binder">
           <attribution license="cc4" from="Microsoft" modified="false" />Provides information about the deletion.</param>
         <param name="indexes">
@@ -226,7 +235,6 @@ Dim sampleObject As Object = New SampleDynamicObject()</code>
         <Parameter Name="binder" Type="System.Dynamic.DeleteMemberBinder" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Classes derived from the <see cref="T:System.Dynamic.DynamicObject" /> class can override this method to specify how an object member should be deleted. When this method is not overridden, the run-time binder of the language determines the behavior. (In most cases, a language-specific run-time exception is thrown.)</para>
@@ -236,6 +244,10 @@ Dim sampleObject As Object = New SampleDynamicObject()</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides the implementation for operations that delete an object member. This method is not intended for use in C# or Visual Basic.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the operation is successful; otherwise, false. If this method returns false, the run-time binder of the language determines the behavior. (In most cases, a language-specific run-time exception is thrown.)</para>
+        </returns>
         <param name="binder">
           <attribution license="cc4" from="Microsoft" modified="false" />Provides information about the deletion.</param>
       </Docs>
@@ -350,7 +362,6 @@ Dim sampleObject As Object = New SampleDynamicObject()</code>
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Classes derived from the <see cref="T:System.Dynamic.DynamicObject" /> class can override this method to specify how operations that access an object by index should be performed for a dynamic object. When the method is not overridden, the run-time binder of the language determines the behavior. (In most cases, a language-specific run-time exception is thrown.)</para>
@@ -360,6 +371,10 @@ Dim sampleObject As Object = New SampleDynamicObject()</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides the implementation for operations that set a value by index. Classes derived from the <see cref="T:System.Dynamic.DynamicObject" /> class can override this method to specify dynamic behavior for operations that access objects by a specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the operation is successful; otherwise, false. If this method returns false, the run-time binder of the language determines the behavior. (In most cases, a language-specific run-time exception is thrown.</para>
+        </returns>
         <param name="binder">
           <attribution license="cc4" from="Microsoft" modified="false" />Provides information about the operation. </param>
         <param name="indexes">
@@ -383,7 +398,6 @@ Dim sampleObject As Object = New SampleDynamicObject()</code>
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Classes derived from the <see cref="T:System.Dynamic.DynamicObject" /> class can override this method to specify how operations that set a value to a member should be performed for a dynamic object. When the method is not overridden, the run-time binder of the language determines the behavior. (In most cases, a language-specific run-time exception is thrown.)</para>
@@ -394,6 +408,10 @@ Dim sampleObject As Object = New SampleDynamicObject()</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides the implementation for operations that set member values. Classes derived from the <see cref="T:System.Dynamic.DynamicObject" /> class can override this method to specify dynamic behavior for operations such as setting a value for a property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the operation is successful; otherwise, false. If this method returns false, the run-time binder of the language determines the behavior. (In most cases, a language-specific run-time exception is thrown.)</para>
+        </returns>
         <param name="binder">
           <attribution license="cc4" from="Microsoft" modified="false" />Provides information about the object that called the dynamic operation. The binder.Name property provides the name of the member to which the value is being assigned. For example, for the statement sampleObject.SampleProperty = "Test", where sampleObject is an instance of the class derived from the <see cref="T:System.Dynamic.DynamicObject" /> class, binder.Name returns "SampleProperty". The binder.IgnoreCase property specifies whether the member name is case-sensitive.</param>
         <param name="value">
diff --git a/mcs/class/System.Core/Documentation/en/System.Dynamic/ExpandoObject.xml b/mcs/class/System.Core/Documentation/en/System.Dynamic/ExpandoObject.xml
index 3329a624b92..24680b7c951 100644
--- a/mcs/class/System.Core/Documentation/en/System.Dynamic/ExpandoObject.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Dynamic/ExpandoObject.xml
@@ -434,12 +434,15 @@ End Module</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Dynamic.IDynamicMetaObjectProvider.GetMetaObject">
@@ -456,12 +459,15 @@ End Module</code>
         <Parameter Name="parameter" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The provided MetaObject will dispatch to the dynamic virtual methods. The object can be encapsulated inside another MetaObject to provide custom behavior for individual actions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object of the <see cref="T:System.Dynamic.DynamicMetaObject" /> type.</para>
+        </returns>
         <param name="parameter">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression that represents the MetaObject to dispatch to the Dynamic virtual methods.</param>
       </Docs>
diff --git a/mcs/class/System.Core/Documentation/en/System.Dynamic/GetIndexBinder.xml b/mcs/class/System.Core/Documentation/en/System.Dynamic/GetIndexBinder.xml
index 9f28ca74e6f..8a289cbdfc7 100644
--- a/mcs/class/System.Core/Documentation/en/System.Dynamic/GetIndexBinder.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Dynamic/GetIndexBinder.xml
@@ -53,12 +53,15 @@
         <Parameter Name="args" Type="System.Dynamic.DynamicMetaObject[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic get index operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic get index operation.</param>
         <param name="args">
@@ -99,12 +102,15 @@
         <Parameter Name="indexes" Type="System.Dynamic.DynamicMetaObject[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic get index operation if the target dynamic object cannot bind.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic get index operation.</param>
         <param name="indexes">
@@ -127,12 +133,15 @@
         <Parameter Name="errorSuggestion" Type="System.Dynamic.DynamicMetaObject" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in the derived class, performs the binding of the dynamic get index operation if the target dynamic object cannot bind.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic get index operation.</param>
         <param name="indexes">
diff --git a/mcs/class/System.Core/Documentation/en/System.Dynamic/GetMemberBinder.xml b/mcs/class/System.Core/Documentation/en/System.Dynamic/GetMemberBinder.xml
index fbabc5048fa..7df3070fab6 100644
--- a/mcs/class/System.Core/Documentation/en/System.Dynamic/GetMemberBinder.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Dynamic/GetMemberBinder.xml
@@ -62,12 +62,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic get member operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic get member operation.</param>
         <param name="args">
@@ -88,12 +91,15 @@
         <Parameter Name="target" Type="System.Dynamic.DynamicMetaObject" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic get member operation if the target dynamic object cannot bind.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic get member operation.</param>
       </Docs>
@@ -113,12 +119,15 @@
         <Parameter Name="errorSuggestion" Type="System.Dynamic.DynamicMetaObject" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in the derived class, performs the binding of the dynamic get member operation if the target dynamic object cannot bind.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic get member operation.</param>
         <param name="errorSuggestion">
diff --git a/mcs/class/System.Core/Documentation/en/System.Dynamic/IDynamicMetaObjectProvider.xml b/mcs/class/System.Core/Documentation/en/System.Dynamic/IDynamicMetaObjectProvider.xml
index 8efb3d9462c..c7ee6226799 100644
--- a/mcs/class/System.Core/Documentation/en/System.Dynamic/IDynamicMetaObjectProvider.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Dynamic/IDynamicMetaObjectProvider.xml
@@ -33,12 +33,15 @@
         <Parameter Name="parameter" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Dynamic.DynamicMetaObject" /> responsible for binding operations performed on this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> to bind this object.</para>
+        </returns>
         <param name="parameter">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression tree representation of the runtime value.</param>
       </Docs>
diff --git a/mcs/class/System.Core/Documentation/en/System.Dynamic/InvokeBinder.xml b/mcs/class/System.Core/Documentation/en/System.Dynamic/InvokeBinder.xml
index 6e6eb179b5b..dd318e25bd0 100644
--- a/mcs/class/System.Core/Documentation/en/System.Dynamic/InvokeBinder.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Dynamic/InvokeBinder.xml
@@ -53,12 +53,15 @@
         <Parameter Name="args" Type="System.Dynamic.DynamicMetaObject[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic invoke operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic invoke operation.</param>
         <param name="args">
@@ -99,12 +102,15 @@
         <Parameter Name="args" Type="System.Dynamic.DynamicMetaObject[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic invoke operation if the target dynamic object cannot bind.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic invoke operation.</param>
         <param name="args">
@@ -127,12 +133,15 @@
         <Parameter Name="errorSuggestion" Type="System.Dynamic.DynamicMetaObject" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic invoke operation if the target dynamic object cannot bind.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic invoke operation.</param>
         <param name="args">
diff --git a/mcs/class/System.Core/Documentation/en/System.Dynamic/InvokeMemberBinder.xml b/mcs/class/System.Core/Documentation/en/System.Dynamic/InvokeMemberBinder.xml
index 2c6ed5e80a8..9db0db2157e 100644
--- a/mcs/class/System.Core/Documentation/en/System.Dynamic/InvokeMemberBinder.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Dynamic/InvokeMemberBinder.xml
@@ -59,12 +59,15 @@
         <Parameter Name="args" Type="System.Dynamic.DynamicMetaObject[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic invoke member operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic invoke member operation.</param>
         <param name="args">
@@ -106,7 +109,6 @@
         <Parameter Name="errorSuggestion" Type="System.Dynamic.DynamicMetaObject" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called by the target when the target implements the invoke member operation as a sequence of get member, and invoke, to let the <see cref="T:System.Dynamic.DynamicMetaObject" /> request the binding of the invoke operation only.</para>
@@ -115,6 +117,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in the derived class, performs the binding of the dynamic invoke operation if the target dynamic object cannot bind.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic invoke operation.</param>
         <param name="args">
@@ -138,12 +144,15 @@
         <Parameter Name="args" Type="System.Dynamic.DynamicMetaObject[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic invoke member operation if the target dynamic object cannot bind.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic invoke member operation.</param>
         <param name="args">
@@ -166,12 +175,15 @@
         <Parameter Name="errorSuggestion" Type="System.Dynamic.DynamicMetaObject" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in the derived class, performs the binding of the dynamic invoke member operation if the target dynamic object cannot bind.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic invoke member operation.</param>
         <param name="args">
diff --git a/mcs/class/System.Core/Documentation/en/System.Dynamic/SetIndexBinder.xml b/mcs/class/System.Core/Documentation/en/System.Dynamic/SetIndexBinder.xml
index 49968bc6995..584db6acc85 100644
--- a/mcs/class/System.Core/Documentation/en/System.Dynamic/SetIndexBinder.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Dynamic/SetIndexBinder.xml
@@ -53,12 +53,15 @@
         <Parameter Name="args" Type="System.Dynamic.DynamicMetaObject[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic set index operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic set index operation.</param>
         <param name="args">
@@ -100,12 +103,15 @@
         <Parameter Name="value" Type="System.Dynamic.DynamicMetaObject" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic set index operation if the target dynamic object cannot bind.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic set index operation.</param>
         <param name="indexes">
@@ -131,12 +137,15 @@
         <Parameter Name="errorSuggestion" Type="System.Dynamic.DynamicMetaObject" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in the derived class, performs the binding of the dynamic set index operation if the target dynamic object cannot bind.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic set index operation.</param>
         <param name="indexes">
diff --git a/mcs/class/System.Core/Documentation/en/System.Dynamic/SetMemberBinder.xml b/mcs/class/System.Core/Documentation/en/System.Dynamic/SetMemberBinder.xml
index 95551293aa6..4d6c296c726 100644
--- a/mcs/class/System.Core/Documentation/en/System.Dynamic/SetMemberBinder.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Dynamic/SetMemberBinder.xml
@@ -56,12 +56,15 @@
         <Parameter Name="args" Type="System.Dynamic.DynamicMetaObject[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic set member operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic set member operation.</param>
         <param name="args">
@@ -83,12 +86,15 @@
         <Parameter Name="value" Type="System.Dynamic.DynamicMetaObject" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic set member operation if the target dynamic object cannot bind.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic set member operation.</param>
         <param name="value">
@@ -111,12 +117,15 @@
         <Parameter Name="errorSuggestion" Type="System.Dynamic.DynamicMetaObject" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic set member operation if the target dynamic object cannot bind.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic set member operation.</param>
         <param name="value">
diff --git a/mcs/class/System.Core/Documentation/en/System.Dynamic/UnaryOperationBinder.xml b/mcs/class/System.Core/Documentation/en/System.Dynamic/UnaryOperationBinder.xml
index f315e2f7759..1c36d8331f3 100644
--- a/mcs/class/System.Core/Documentation/en/System.Dynamic/UnaryOperationBinder.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Dynamic/UnaryOperationBinder.xml
@@ -53,12 +53,15 @@
         <Parameter Name="args" Type="System.Dynamic.DynamicMetaObject[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the dynamic unary operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic operation.</param>
         <param name="args">
@@ -79,12 +82,15 @@
         <Parameter Name="target" Type="System.Dynamic.DynamicMetaObject" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the unary dynamic operation if the target dynamic object cannot bind.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic unary operation.</param>
       </Docs>
@@ -104,12 +110,15 @@
         <Parameter Name="errorSuggestion" Type="System.Dynamic.DynamicMetaObject" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the binding of the unary dynamic operation if the target dynamic object cannot bind.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Dynamic.DynamicMetaObject" /> representing the result of the binding.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the dynamic unary operation.</param>
         <param name="errorSuggestion">
diff --git a/mcs/class/System.Core/Documentation/en/System.IO.MemoryMappedFiles/MemoryMappedFile.xml b/mcs/class/System.Core/Documentation/en/System.IO.MemoryMappedFiles/MemoryMappedFile.xml
index a042cca86f9..e997ed1b6e7 100644
--- a/mcs/class/System.Core/Documentation/en/System.IO.MemoryMappedFiles/MemoryMappedFile.xml
+++ b/mcs/class/System.Core/Documentation/en/System.IO.MemoryMappedFiles/MemoryMappedFile.xml
@@ -43,12 +43,15 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a memory-mapped file from a file on disk.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A memory-mapped file.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to file to map.</param>
       </Docs>
@@ -68,7 +71,6 @@
         <Parameter Name="mode" Type="System.IO.FileMode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="mode" /> parameter pertains to the source file on disk. You can use only the <see cref="F:System.IO.FileMode.Open" /> enumeration value to create the memory-mapped file from the source file on disk.</para>
@@ -77,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a memory-mapped file that has the specified access mode from a file on disk. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A memory-mapped file that has the specified access mode.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to file to map.</param>
         <param name="mode">
@@ -99,7 +105,6 @@
         <Parameter Name="mapName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="mode" /> parameter pertains to the source file on disk. You can use only the <see cref="F:System.IO.FileMode.Open" /> enumeration value to create the memory-mapped file from the source file on disk.</para>
@@ -108,6 +113,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a memory-mapped file that has the specified access mode and name from a file on disk.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A memory-mapped file that has the specified name and access mode.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to the file to map.</param>
         <param name="mode">
@@ -133,7 +142,6 @@
         <Parameter Name="capacity" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="mode" /> parameter pertains to the source file on disk. </para>
@@ -143,6 +151,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a memory-mapped file that has the specified access mode, name, and capacity from a file on disk.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A memory-mapped file that has the specified characteristics.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to the file to map.</param>
         <param name="mode">
@@ -171,7 +183,6 @@
         <Parameter Name="access" Type="System.IO.MemoryMappedFiles.MemoryMappedFileAccess" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="mode" /> parameter pertains to the source file on disk. </para>
@@ -181,6 +192,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a memory-mapped file that has the specified access mode, name, capacity, and access type from a file on disk.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A memory-mapped file that has the specified characteristics.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to the file to map.</param>
         <param name="mode">
@@ -218,7 +233,6 @@
         <Parameter Name="leaveOpen" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="capacity" /> is larger than the size of the file on disk, the file on disk is increased to match the specified capacity even if no data is written to the memory-mapped file. To prevent this from occurring, specify 0 (zero) for the default capacity, which will internally set <paramref name="capacity" /> to the size of the file on disk.</para>
@@ -227,6 +241,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a memory-mapped file that has the specified name, capacity, access type, security permissions, inheritability, and disposal requirement from a file on disk. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A memory-mapped file that has the specified characteristics.</para>
+        </returns>
         <param name="fileStream">
           <attribution license="cc4" from="Microsoft" modified="false" />The <paramref name="fileStream" /> to the file to map.</param>
         <param name="mapName">
@@ -263,7 +281,6 @@
         <Parameter Name="capacity" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create a memory-mapped file that is not persisted (that is, not associated with a file on disk), which you can use to share data between processes.</para>
@@ -272,6 +289,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a memory-mapped file that has the specified capacity in system memory. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A memory-mapped file that has the specified name and capacity.</para>
+        </returns>
         <param name="mapName">
           <attribution license="cc4" from="Microsoft" modified="false" />A name to assign to the memory-mapped file.</param>
         <param name="capacity">
@@ -299,7 +320,6 @@
         <Parameter Name="access" Type="System.IO.MemoryMappedFiles.MemoryMappedFileAccess" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create a memory-mapped file that is not persisted (that is, not associated with a file on disk), which you can use to share data between processes.</para>
@@ -308,6 +328,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a memory-mapped file that has the specified capacity and access type in system memory. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A memory-mapped file that has the specified characteristics.</para>
+        </returns>
         <param name="mapName">
           <attribution license="cc4" from="Microsoft" modified="false" />A name to assign to the memory-mapped file.</param>
         <param name="capacity">
@@ -340,7 +364,6 @@
         <Parameter Name="inheritability" Type="System.IO.HandleInheritability" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create a memory-mapped file that is not persisted (that is, not associated with a file on disk), which you can use to share data between processes.</para>
@@ -349,6 +372,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a memory-mapped file that has the specified capacity, access type, memory allocation, security permissions, and inheritability in system memory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A memory-mapped file that has the specified characteristics.</para>
+        </returns>
         <param name="mapName">
           <attribution license="cc4" from="Microsoft" modified="false" />A name to assign to the memory-mapped file.</param>
         <param name="capacity">
@@ -383,7 +410,6 @@
         <Parameter Name="capacity" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create or open a memory-mapped file that is not persisted (that is, not associated with a file on disk), which you can use to share data between processes.</para>
@@ -392,6 +418,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates or opens a memory-mapped file that has the specified capacity in system memory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A memory-mapped file that has the specified name and size.</para>
+        </returns>
         <param name="mapName">
           <attribution license="cc4" from="Microsoft" modified="false" />A name to assign to the memory-mapped file.</param>
         <param name="capacity">
@@ -419,7 +449,6 @@
         <Parameter Name="access" Type="System.IO.MemoryMappedFiles.MemoryMappedFileAccess" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create or open a memory-mapped file that is not persisted (that is, not associated with a file on disk), which you can use to share data between processes.</para>
@@ -428,6 +457,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates or opens a memory-mapped file that has the specified capacity and access type in system memory. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A memory-mapped file that has the specified characteristics.</para>
+        </returns>
         <param name="mapName">
           <attribution license="cc4" from="Microsoft" modified="false" />A name to assign to the memory-mapped file.</param>
         <param name="capacity">
@@ -460,7 +493,6 @@
         <Parameter Name="inheritability" Type="System.IO.HandleInheritability" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create or open a memory-mapped file that is not persisted (that is, not associated with a file on disk), which you can use to share data between processes.</para>
@@ -469,6 +501,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates or opens a memory-mapped file that has the specified capacity, access type, memory allocation, security permissions, and inheritability in system memory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A memory-mapped file that has the specified characteristics.</para>
+        </returns>
         <param name="mapName">
           <attribution license="cc4" from="Microsoft" modified="false" />A name to assign to the memory-mapped file.</param>
         <param name="capacity">
@@ -495,7 +531,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the view returned by this method for random access to a memory-mapped file.</para>
@@ -504,6 +539,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.IO.MemoryMappedFiles.MemoryMappedViewAccessor" /> that maps to a view of the memory-mapped file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A randomly accessible block of memory.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateViewAccessor">
@@ -521,7 +560,6 @@
         <Parameter Name="size" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the view returned by this method for random access to a memory-mapped file.</para>
@@ -531,6 +569,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.IO.MemoryMappedFiles.MemoryMappedViewAccessor" /> that maps to a view of the memory-mapped file, and that has the specified offset and size.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A randomly accessible block of memory.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte at which to start the view.</param>
         <param name="size">
@@ -553,7 +595,6 @@
         <Parameter Name="access" Type="System.IO.MemoryMappedFiles.MemoryMappedFileAccess" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the view returned by this method for random access to a memory-mapped file.</para>
@@ -563,6 +604,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.IO.MemoryMappedFiles.MemoryMappedViewAccessor" /> that maps to a view of the memory-mapped file, and that has the specified offset, size, and access restrictions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A randomly accessible block of memory.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte at which to start the view.</param>
         <param name="size">
@@ -583,7 +628,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the stream returned by this method for sequential access to a memory-mapped file, such as for inter-process communications. </para>
@@ -592,6 +636,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a stream that maps to a view of the memory-mapped file.  </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A stream of memory.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateViewStream">
@@ -609,7 +657,6 @@
         <Parameter Name="size" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the stream returned by this method for sequential access to a memory-mapped file, such as for inter-process communications.</para>
@@ -619,6 +666,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a stream that maps to a view of the memory-mapped file, and that has the specified offset and size.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A stream of memory that has the specified offset and size.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte at which to start the view.</param>
         <param name="size">
@@ -641,7 +692,6 @@
         <Parameter Name="access" Type="System.IO.MemoryMappedFiles.MemoryMappedFileAccess" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the stream returned by this method for sequential access to a memory-mapped file, such as for inter-process communications.</para>
@@ -651,6 +701,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a stream that maps to a view of the memory-mapped file, and that has the specified offset, size, and access type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A stream of memory that has the specified characteristics.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte at which to start the view.</param>
         <param name="size">
@@ -718,12 +772,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the access control to the memory-mapped file resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The permissions that can be granted for file access and operations on memory-mapped files.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="OpenExisting">
@@ -745,7 +802,6 @@
         <Parameter Name="mapName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The memory-mapped file can be either a persisted memory-mapped file (associated with a file on disk) or non persisted.</para>
@@ -754,6 +810,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens an existing memory-mapped file that has the specified name in system memory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A memory-mapped file that has the specified name. </para>
+        </returns>
         <param name="mapName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the memory-mapped file to open.</param>
       </Docs>
@@ -778,12 +838,15 @@
         <Parameter Name="desiredAccessRights" Type="System.IO.MemoryMappedFiles.MemoryMappedFileRights" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens an existing memory-mapped file that has the specified name and access rights in system memory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A memory-mapped file that has the specified characteristics.</para>
+        </returns>
         <param name="mapName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the memory-mapped file to open.</param>
         <param name="desiredAccessRights">
@@ -811,12 +874,15 @@
         <Parameter Name="inheritability" Type="System.IO.HandleInheritability" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens an existing memory-mapped file that has the specified name, access rights, and inheritability in system memory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A memory-mapped file that has the specified characteristics.</para>
+        </returns>
         <param name="mapName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the memory-mapped file to open.</param>
         <param name="desiredAccessRights">
diff --git a/mcs/class/System.Core/Documentation/en/System.IO.Pipes/AnonymousPipeServerStream.xml b/mcs/class/System.Core/Documentation/en/System.IO.Pipes/AnonymousPipeServerStream.xml
index 5263bca2dfc..68059321a67 100644
--- a/mcs/class/System.Core/Documentation/en/System.IO.Pipes/AnonymousPipeServerStream.xml
+++ b/mcs/class/System.Core/Documentation/en/System.IO.Pipes/AnonymousPipeServerStream.xml
@@ -266,7 +266,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.IO.Pipes.AnonymousPipeServerStream.DisposeLocalCopyOfClientHandle" /> method should be called after a client handle has been passed to a client process. If this method is not called, the <see cref="T:System.IO.Pipes.AnonymousPipeServerStream" /> object will not receive notice when the client disposes of its <see cref="T:System.IO.Pipes.PipeStream" /> object.</para>
@@ -275,6 +274,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the connected <see cref="T:System.IO.Pipes.AnonymousPipeClientStream" /> object's handle as a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the connected <see cref="T:System.IO.Pipes.AnonymousPipeClientStream" /> object's handle.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadMode">
diff --git a/mcs/class/System.Core/Documentation/en/System.IO.Pipes/NamedPipeServerStream.xml b/mcs/class/System.Core/Documentation/en/System.IO.Pipes/NamedPipeServerStream.xml
index 07b3bf20ad9..4df2677b967 100644
--- a/mcs/class/System.Core/Documentation/en/System.IO.Pipes/NamedPipeServerStream.xml
+++ b/mcs/class/System.Core/Documentation/en/System.IO.Pipes/NamedPipeServerStream.xml
@@ -522,7 +522,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous equivalent of <see cref="M:System.IO.Pipes.NamedPipeServerStream.WaitForConnection" />.</para>
@@ -533,6 +532,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to wait for a client to connect.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that references the asynchronous request.</para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />The method to call when a client connects to the <see cref="T:System.IO.Pipes.NamedPipeServerStream" /> object.</param>
         <param name="state">
@@ -605,7 +608,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.IO.Pipes.NamedPipeServerStream.GetImpersonationUserName" /> method returns null if the client has not yet written to the pipe or if the connected client did not connect with a <see cref="T:System.Security.Principal.TokenImpersonationLevel" /> of <see cref="F:System.Security.Principal.TokenImpersonationLevel.Impersonation" />.</para>
@@ -614,6 +616,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the user name of the client on the other end of the pipe.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The user name of the client on the other end of the pipe.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MaxAllowedServerInstances">
diff --git a/mcs/class/System.Core/Documentation/en/System.IO.Pipes/PipeSecurity.xml b/mcs/class/System.Core/Documentation/en/System.IO.Pipes/PipeSecurity.xml
index b3c2b760081..ddc870dc2b8 100644
--- a/mcs/class/System.Core/Documentation/en/System.IO.Pipes/PipeSecurity.xml
+++ b/mcs/class/System.Core/Documentation/en/System.IO.Pipes/PipeSecurity.xml
@@ -87,7 +87,6 @@
         <Parameter Name="type" Type="System.Security.AccessControl.AccessControlType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The recommended way to create access control rules is to use the constructors of the <see cref="T:System.IO.Pipes.PipeAccessRule" /> class.</para>
@@ -96,6 +95,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of the <see cref="T:System.Security.AccessControl.AccessRule" /> class with the specified values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Security.AccessControl.AccessRule" /> object that this method creates.</para>
+        </returns>
         <param name="identityReference">
           <attribution license="cc4" from="Microsoft" modified="false" />The identity that the access rule applies to. It must be an object that can be cast as a <see cref="T:System.Security.Principal.SecurityIdentifier" /> object.</param>
         <param name="accessMask">
@@ -204,7 +207,6 @@
         <Parameter Name="flags" Type="System.Security.AccessControl.AuditFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The recommended way to create audit rules is to use the constructors of the <see cref="T:System.IO.Pipes.PipeAuditRule" /> class.</para>
@@ -213,6 +215,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of the <see cref="T:System.Security.AccessControl.AuditRule" /> class with the specified values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Security.AccessControl.AuditRule" /> object that this method creates.</para>
+        </returns>
         <param name="identityReference">
           <attribution license="cc4" from="Microsoft" modified="false" />The identity that the access rule applies to. It must be an object that can be cast as a <see cref="T:System.Security.Principal.SecurityIdentifier" /> object.</param>
         <param name="accessMask">
@@ -309,7 +315,6 @@
         <Parameter Name="rule" Type="System.IO.Pipes.PipeAccessRule" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.IO.Pipes.PipeSecurity.RemoveAccessRule(System.IO.Pipes.PipeAccessRule)" /> method removes either all matching <see cref="F:System.Security.AccessControl.AccessControlType.Deny" /> access rules or all matching <see cref="F:System.Security.AccessControl.AccessControlType.Allow" /> access rules from the current <see cref="T:System.IO.Pipes.PipeSecurity" /> object. For example, you can use this method to remove all <see cref="F:System.Security.AccessControl.AccessControlType.Deny" /> access rules for a user by passing a <see cref="T:System.IO.Pipes.PipeAccessRule" /> object created using the <see cref="F:System.Security.AccessControl.AccessControlType.Deny" /> value, the <see cref="F:System.IO.Pipes.PipeAccessRights.Read" /> value, and a user account. The <see cref="M:System.IO.Pipes.PipeSecurity.RemoveAccessRule(System.IO.Pipes.PipeAccessRule)" /> method removes any deny rules that specify the <see cref="F:System.IO.Pipes.PipeAccessRights.Read" /> value or the <see cref="F:System.IO.Pipes.PipeAccessRights.Write" /> value.</para>
@@ -318,6 +323,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes an access rule from the Discretionary Access Control List (DACL) that is associated with the current <see cref="T:System.IO.Pipes.PipeSecurity" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the operation is successful; otherwise, false.</para>
+        </returns>
         <param name="rule">
           <attribution license="cc4" from="Microsoft" modified="false" />The access rule to remove.</param>
       </Docs>
@@ -362,7 +371,6 @@
         <Parameter Name="rule" Type="System.IO.Pipes.PipeAuditRule" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.IO.Pipes.PipeSecurity.RemoveAuditRule(System.IO.Pipes.PipeAuditRule)" /> method removes either all matching <see cref="F:System.Security.AccessControl.AccessControlType.Deny" /> audit rules or all matching <see cref="F:System.Security.AccessControl.AccessControlType.Allow" /> audit rules from the current <see cref="T:System.IO.Pipes.PipeSecurity" /> object.  For example, you can use this method to remove all <see cref="F:System.Security.AccessControl.AccessControlType.Deny" /> audit rules for a user by passing a <see cref="T:System.Security.AccessControl.FileSystemAuditRule" /> object created using the <see cref="F:System.Security.AccessControl.AccessControlType.Deny" /> value, the <see cref="F:System.Security.AccessControl.AuditFlags.Failure" /> value, and a user account.  When you do this, the <see cref="M:System.IO.Pipes.PipeSecurity.RemoveAuditRule(System.IO.Pipes.PipeAuditRule)" /> method removes any deny rules that specify the <see cref="F:System.Security.AccessControl.AuditFlags.Failure" /> value or the <see cref="F:System.Security.AccessControl.AuditFlags.Success" /> value.</para>
@@ -371,6 +379,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes an audit rule from the System Access Control List (SACL) that is associated with the current <see cref="T:System.IO.Pipes.PipeSecurity" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the audit rule was removed; otherwise, false</para>
+        </returns>
         <param name="rule">
           <attribution license="cc4" from="Microsoft" modified="false" />The audit rule to remove.</param>
       </Docs>
diff --git a/mcs/class/System.Core/Documentation/en/System.IO.Pipes/PipeStream.xml b/mcs/class/System.Core/Documentation/en/System.IO.Pipes/PipeStream.xml
index 50fa171bbea..4590352290c 100644
--- a/mcs/class/System.Core/Documentation/en/System.IO.Pipes/PipeStream.xml
+++ b/mcs/class/System.Core/Documentation/en/System.IO.Pipes/PipeStream.xml
@@ -92,7 +92,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Pass the returned <see cref="T:System.IAsyncResult" /> object to the <see cref="M:System.IO.Pipes.PipeStream.EndRead(System.IAsyncResult)" /> method to determine how many bytes were read and to release operating system resources used for reading. <see cref="M:System.IO.Pipes.PipeStream.EndRead(System.IAsyncResult)" /> must be called once for every call to <see cref="M:System.IO.Pipes.PipeStream.BeginRead(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)" />. This can be done either in the same code that called <see cref="M:System.IO.Pipes.PipeStream.BeginRead(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)" /> or in a callback that is passed to <see cref="M:System.IO.Pipes.PipeStream.BeginRead(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)" />.</para>
@@ -103,6 +102,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous read operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object that references the asynchronous read.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer to read data into.</param>
         <param name="offset">
@@ -133,7 +136,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -145,6 +147,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous write operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object that references the asynchronous write operation.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer that contains the data to write to the current stream.</param>
         <param name="offset">
@@ -335,7 +341,6 @@
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns the number of bytes read into the byte array specified by the earlier call to <see cref="M:System.IO.Pipes.PipeStream.BeginRead(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)" />.</para>
@@ -347,6 +352,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ends a pending asynchronous read request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes that were read. A return value of 0 indicates the end of the stream (the pipe has been closed).</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />The reference to the pending asynchronous request.</param>
       </Docs>
@@ -419,7 +428,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An access control list (ACL) describes individuals and/or groups that have, or do not have, rights to perform specific actions on a specified file. For more information, see <format type="text/html"><a href="06fbf66d-6f02-4378-b863-b2f12e349045">ACL Technology Overview</a></format> and <format type="text/html"><a href="53758b39-bd9b-4640-bb04-cad5ed8d0abf">How To: Add or Remove Access Control List Entries</a></format>.</para>
@@ -428,6 +436,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.IO.Pipes.PipeSecurity" /> object that encapsulates the access control list (ACL) entries for the pipe described by the current <see cref="T:System.IO.Pipes.PipeStream" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Pipes.PipeSecurity" /> object that encapsulates the access control list (ACL) entries for the pipe described by the current <see cref="T:System.IO.Pipes.PipeStream" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InBufferSize">
@@ -669,7 +681,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="P:System.IO.Pipes.PipeStream.CanRead" /> property to determine whether the current <see cref="T:System.IO.Pipes.PipeStream" /> object supports read operations.</para>
@@ -679,6 +690,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a block of bytes from a stream and writes the data to a specified buffer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The total number of bytes that are read into <paramref name="buffer" />. This might be less than the number of bytes requested if that number of bytes is not currently available, or 0 if the end of the stream is reached.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />When this method returns, contains the specified byte array with the values between <paramref name="offset" /> and (<paramref name="offset" /> + <paramref name="count" /> - 1) replaced by the bytes read from the current source.</param>
         <param name="offset">
@@ -704,7 +719,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="P:System.IO.Pipes.PipeStream.CanRead" /> property to determine whether the current <see cref="T:System.IO.Pipes.PipeStream" /> object supports read operations.</para>
@@ -713,6 +727,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a byte from a pipe.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The byte, cast to <see cref="T:System.Int32" />, or -1 indicates the end of the stream (the pipe has been closed).</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadMode">
@@ -771,7 +789,6 @@
         <Parameter Name="origin" Type="System.IO.SeekOrigin" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.IO.Pipes.PipeStream.Seek(System.Int64,System.IO.SeekOrigin)" /> method is not supported in pipes and raises a <see cref="T:System.NotSupportedException" /> when it is called.</para>
@@ -780,6 +797,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the current position of the current stream to the specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new position in the stream.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />The point, relative to <paramref name="origin" />, to begin seeking from.</param>
         <param name="origin">
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/BinaryExpression.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/BinaryExpression.xml
index 871753ddac6..9b0dc533f55 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/BinaryExpression.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/BinaryExpression.xml
@@ -435,7 +435,6 @@
         <Parameter Name="visitor" Type="System.Linq.Expressions.ExpressionVisitor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This default implementation for <see cref="F:System.Linq.Expressions.ExpressionType.Extension" /> nodes calls <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitExtension(System.Linq.Expressions.Expression)" />. Override this method to call into a more specific method on a derived visitor class of the <see cref="T:System.Linq.Expressions.ExpressionVisitor" /> class. However, it should still support unknown visitors by calling <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitExtension(System.Linq.Expressions.Expression)" />. </para>
@@ -444,6 +443,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Dispatches to the specific visit method for this node type. For example, <see cref="T:System.Linq.Expressions.MethodCallExpression" /> calls the <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitMethodCall(System.Linq.Expressions.MethodCallExpression)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of visiting this node.</para>
+        </returns>
         <param name="visitor">
           <attribution license="cc4" from="Microsoft" modified="false" />The visitor to visit this node with.</param>
       </Docs>
@@ -591,7 +594,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If CanReduce returns true, this should return a valid expression.</para>
@@ -601,6 +603,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reduces the binary expression node to a simpler expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The reduced expression.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Right">
@@ -639,12 +645,15 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new expression that is like this one, but using the supplied children. If all of the children are the same, it will return this expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This expression if no children are changed or an expression with the updated children.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property of the result. </param>
         <param name="conversion">
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/BlockExpression.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/BlockExpression.xml
index 1077305656c..ce8c0381c6f 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/BlockExpression.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/BlockExpression.xml
@@ -40,7 +40,6 @@
         <Parameter Name="visitor" Type="System.Linq.Expressions.ExpressionVisitor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This default implementation for <see cref="F:System.Linq.Expressions.ExpressionType.Extension" /> nodes calls <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitExtension(System.Linq.Expressions.Expression)" />. Override this method to call into a more specific method on a derived visitor class of the <see cref="T:System.Linq.Expressions.ExpressionVisitor" /> class. However, it should still support unknown visitors by calling <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitExtension(System.Linq.Expressions.Expression)" />. </para>
@@ -49,6 +48,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Dispatches to the specific visit method for this node type. For example, <see cref="T:System.Linq.Expressions.MethodCallExpression" /> calls the <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitMethodCall(System.Linq.Expressions.MethodCallExpression)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of visiting this node.</para>
+        </returns>
         <param name="visitor">
           <attribution license="cc4" from="Microsoft" modified="false" />The visitor to visit this node with.</param>
       </Docs>
@@ -144,12 +147,15 @@
         <Parameter Name="expressions" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.Expression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new expression that is like this one, but using the supplied children. If all of the children are the same, it will return this expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This expression if no children changed, or an expression with the updated children.</para>
+        </returns>
         <param name="variables">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.BlockExpression.Variables" /> property of the result. </param>
         <param name="expressions">
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/CatchBlock.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/CatchBlock.xml
index 62786570748..e55aa1a26d0 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/CatchBlock.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/CatchBlock.xml
@@ -95,12 +95,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.String" /> that represents the current <see cref="T:System.Object" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that represents the current <see cref="T:System.Object" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Update">
@@ -119,12 +122,15 @@
         <Parameter Name="body" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new expression that is like this one, but using the supplied children. If all of the children are the same, it will return this expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This expression if no children are changed or an expression with the updated children.</para>
+        </returns>
         <param name="variable">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.CatchBlock.Variable" /> property of the result.</param>
         <param name="filter">
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/ConditionalExpression.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/ConditionalExpression.xml
index 1a203879c4a..0c0321e6744 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/ConditionalExpression.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/ConditionalExpression.xml
@@ -42,7 +42,6 @@
         <Parameter Name="visitor" Type="System.Linq.Expressions.ExpressionVisitor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This default implementation for <see cref="F:System.Linq.Expressions.ExpressionType.Extension" /> nodes calls <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitExtension(System.Linq.Expressions.Expression)" />. Override this method to call into a more specific method on a derived visitor class of the <see cref="T:System.Linq.Expressions.ExpressionVisitor" /> class. However, it should still support unknown visitors by calling <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitExtension(System.Linq.Expressions.Expression)" />. </para>
@@ -51,6 +50,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Dispatches to the specific visit method for this node type. For example, <see cref="T:System.Linq.Expressions.MethodCallExpression" /> calls the <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitMethodCall(System.Linq.Expressions.MethodCallExpression)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of visiting this node.</para>
+        </returns>
         <param name="visitor">
           <attribution license="cc4" from="Microsoft" modified="false" />The visitor to visit this node with.</param>
       </Docs>
@@ -169,12 +172,15 @@
         <Parameter Name="ifFalse" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new expression that is like this one, but using the supplied children. If all of the children are the same, it will return this expression</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This expression if no children changed, or an expression with the updated children.</para>
+        </returns>
         <param name="test">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.ConditionalExpression.Test" /> property of the result.</param>
         <param name="ifTrue">
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/ConstantExpression.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/ConstantExpression.xml
index 5f553a56a13..bee59a6ff0a 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/ConstantExpression.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/ConstantExpression.xml
@@ -42,7 +42,6 @@
         <Parameter Name="visitor" Type="System.Linq.Expressions.ExpressionVisitor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This default implementation for <see cref="F:System.Linq.Expressions.ExpressionType.Extension" /> nodes calls <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitExtension(System.Linq.Expressions.Expression)" />. Override this method to call into a more specific method on a derived visitor class of the <see cref="T:System.Linq.Expressions.ExpressionVisitor" /> class. However, it should still support unknown visitors by calling <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitExtension(System.Linq.Expressions.Expression)" />. </para>
@@ -51,6 +50,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Dispatches to the specific visit method for this node type. For example, <see cref="T:System.Linq.Expressions.MethodCallExpression" /> calls the <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitMethodCall(System.Linq.Expressions.MethodCallExpression)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of visiting this node.</para>
+        </returns>
         <param name="visitor">
           <attribution license="cc4" from="Microsoft" modified="false" />The visitor to visit this node with.</param>
       </Docs>
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/DebugInfoExpression.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/DebugInfoExpression.xml
index e3cf8794c48..f53dda43bbd 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/DebugInfoExpression.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/DebugInfoExpression.xml
@@ -37,7 +37,6 @@
         <Parameter Name="visitor" Type="System.Linq.Expressions.ExpressionVisitor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This default implementation for <see cref="F:System.Linq.Expressions.ExpressionType.Extension" /> nodes calls <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitExtension(System.Linq.Expressions.Expression)" />. Override this method to call into a more specific method on a derived visitor class of the <see cref="T:System.Linq.Expressions.ExpressionVisitor" /> class. However, it should still support unknown visitors by calling <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitExtension(System.Linq.Expressions.Expression)" />. </para>
@@ -46,6 +45,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Dispatches to the specific visit method for this node type. For example, <see cref="T:System.Linq.Expressions.MethodCallExpression" /> calls the <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitMethodCall(System.Linq.Expressions.MethodCallExpression)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of visiting this node.</para>
+        </returns>
         <param name="visitor">
           <attribution license="cc4" from="Microsoft" modified="false" />The visitor to visit this node with.</param>
       </Docs>
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/DynamicExpression.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/DynamicExpression.xml
index 74d6ed6210e..e4c33d30e6b 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/DynamicExpression.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/DynamicExpression.xml
@@ -41,7 +41,6 @@
         <Parameter Name="visitor" Type="System.Linq.Expressions.ExpressionVisitor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This default implementation for <see cref="F:System.Linq.Expressions.ExpressionType.Extension" /> nodes calls <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitExtension(System.Linq.Expressions.Expression)" />. Override this method to call into a more specific method on a derived visitor class of the <see cref="T:System.Linq.Expressions.ExpressionVisitor" /> class. However, it should still support unknown visitors by calling <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitExtension(System.Linq.Expressions.Expression)" />. </para>
@@ -50,6 +49,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Dispatches to the specific visit method for this node type. For example, <see cref="T:System.Linq.Expressions.MethodCallExpression" /> calls the <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitMethodCall(System.Linq.Expressions.MethodCallExpression)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of visiting this node.</para>
+        </returns>
         <param name="visitor">
           <attribution license="cc4" from="Microsoft" modified="false" />The visitor to visit this node with.</param>
       </Docs>
@@ -199,12 +202,15 @@
         <Parameter Name="arguments" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.Expression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the value sent to the parameter, arguments, to the Arguments property of the current instance of DynamicExpression. If the values of the parameter and the property are equal, the current instance is returned. If they are not equal, a new DynamicExpression instance is returned that is identical to the current instance except that the Arguments property is set to the value of parameter arguments. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This expression if no children are changed or an expression with the updated children.</para>
+        </returns>
         <param name="arguments">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.DynamicExpression.Arguments" /> property of the result.</param>
       </Docs>
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/ElementInit.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/ElementInit.xml
index f000bc25593..7c38edaefb6 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/ElementInit.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/ElementInit.xml
@@ -112,12 +112,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a textual representation of an <see cref="T:System.Linq.Expressions.ElementInit" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A textual representation of the <see cref="T:System.Linq.Expressions.ElementInit" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Update">
@@ -134,12 +137,15 @@
         <Parameter Name="arguments" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.Expression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new expression that is like this one, but using the supplied children. If all of the children are the same, it will return this expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This expression if no children are changed or an expression with the updated children.</para>
+        </returns>
         <param name="arguments">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.ElementInit.Arguments" /> property of the result.</param>
       </Docs>
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/Expression.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/Expression.xml
index 7e271ed8d94..3dbf5e32522 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/Expression.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/Expression.xml
@@ -81,7 +81,6 @@
         <Parameter Name="visitor" Type="System.Linq.Expressions.ExpressionVisitor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This default implementation for <see cref="F:System.Linq.Expressions.ExpressionType.Extension" /> nodes calls <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitExtension(System.Linq.Expressions.Expression)" />. Override this method to call into a more specific method on a derived visitor class of the <see cref="T:System.Linq.Expressions.ExpressionVisitor" /> class. However, it should still support unknown visitors by calling <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitExtension(System.Linq.Expressions.Expression)" />. </para>
@@ -90,6 +89,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Dispatches to the specific visit method for this node type. For example, <see cref="T:System.Linq.Expressions.MethodCallExpression" /> calls the <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitMethodCall(System.Linq.Expressions.MethodCallExpression)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of visiting this node.</para>
+        </returns>
         <param name="visitor">
           <attribution license="cc4" from="Microsoft" modified="false" />The visitor to visit this node with.</param>
       </Docs>
@@ -110,7 +113,6 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -162,6 +164,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents an arithmetic addition operation that does not have overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Add" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -185,7 +191,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -240,6 +245,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents an arithmetic addition operation that does not have overflow checking. The implementing method can be specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Add" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -263,12 +272,15 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents an addition assignment operation that does not have overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.AddAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -291,12 +303,15 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents an addition assignment operation that does not have overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.AddAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -322,12 +337,15 @@
         <Parameter Name="conversion" Type="System.Linq.Expressions.LambdaExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents an addition assignment operation that does not have overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.AddAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Method" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -353,12 +371,15 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents an addition assignment operation that has overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.AddAssignChecked" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -381,12 +402,15 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents an addition assignment operation that has overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.AddAssignChecked" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -412,12 +436,15 @@
         <Parameter Name="conversion" Type="System.Linq.Expressions.LambdaExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents an addition assignment operation that has overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.AddAssignChecked" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Method" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -444,7 +471,6 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -496,6 +522,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents an arithmetic addition operation that has overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.AddChecked" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -519,7 +549,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -574,6 +603,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents an arithmetic addition operation that has overflow checking. The implementing method can be specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.AddChecked" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -598,7 +631,6 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -650,6 +682,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a bitwise AND operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.And" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -673,7 +709,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -728,6 +763,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a bitwise AND operation. The implementing method can be specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.And" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -752,7 +791,6 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -811,6 +849,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a conditional AND operation that evaluates the second operand only if the first operand evaluates to true.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.AndAlso" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -834,7 +876,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -896,6 +937,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a conditional AND operation that evaluates the second operand only if the first operand is resolved to true. The implementing method can be specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.AndAlso" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -919,12 +964,15 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a bitwise AND assignment operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.AndAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -947,12 +995,15 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a bitwise AND assignment operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.AndAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -978,12 +1029,15 @@
         <Parameter Name="conversion" Type="System.Linq.Expressions.LambdaExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a bitwise AND assignment operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.AndAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Method" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -1009,7 +1063,6 @@
         <Parameter Name="indexes" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.Expression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The expression that represents the array can be obtained by using the <see cref="M:System.Linq.Expressions.Expression.MakeMemberAccess(System.Linq.Expressions.Expression,System.Reflection.MemberInfo)" /> method, or through <see cref="Overload:System.Linq.Expressions.Expression.NewArrayBounds" /> or <see cref="Overload:System.Linq.Expressions.Expression.NewArrayInit" />.</para>
@@ -1018,6 +1071,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Linq.Expressions.IndexExpression" /> to access a multidimensional array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.IndexExpression" />.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />An expression that represents the multidimensional array.</param>
         <param name="indexes">
@@ -1045,7 +1102,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The expression that represents the array can be obtained by using the <see cref="M:System.Linq.Expressions.Expression.MakeMemberAccess(System.Linq.Expressions.Expression,System.Reflection.MemberInfo)" /> method, or through <see cref="Overload:System.Linq.Expressions.Expression.NewArrayBounds" /> or <see cref="Overload:System.Linq.Expressions.Expression.NewArrayInit" />.</para>
@@ -1055,6 +1111,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Linq.Expressions.IndexExpression" /> to access an array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.IndexExpression" />.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />An expression representing the array to index.</param>
         <param name="indexes">
@@ -1077,7 +1137,6 @@
         <Parameter Name="indexes" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.Expression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Each element of <paramref name="indexes" /> must have <see cref="P:System.Linq.Expressions.Expression.Type" /> equal to <see cref="T:System.Int32" />. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of <paramref name="array" /> must represent an array type whose rank matches the number of elements in <paramref name="indexes" />.</para>
@@ -1088,6 +1147,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents applying an array index operator to an array of rank more than one.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Call" /> and the <see cref="P:System.Linq.Expressions.MethodCallExpression.Object" /> and <see cref="P:System.Linq.Expressions.MethodCallExpression.Arguments" /> properties set to the specified values.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.MethodCallExpression.Object" /> property equal to.</param>
         <param name="indexes">
@@ -1110,7 +1173,6 @@
         <Parameter Name="index" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -1121,6 +1183,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents applying an array index operator to an array of rank one.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.ArrayIndex" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="index">
@@ -1149,7 +1215,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Each element of <paramref name="indexes" /> must have <see cref="P:System.Linq.Expressions.Expression.Type" /> equal to <see cref="T:System.Int32" />. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of <paramref name="array" /> must represent an array type whose rank matches the number of elements in <paramref name="indexes" />.</para>
@@ -1160,6 +1225,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents applying an array index operator to a multidimensional array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Call" /> and the <see cref="P:System.Linq.Expressions.MethodCallExpression.Object" /> and <see cref="P:System.Linq.Expressions.MethodCallExpression.Arguments" /> properties set to the specified values.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Linq.Expressions.Expression" /> instances - indexes for the array index operation.</param>
         <param name="indexes">
@@ -1181,7 +1250,6 @@
         <Parameter Name="array" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of <paramref name="array" /> must represent an array type.</para>
@@ -1191,6 +1259,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents an expression for obtaining the length of a one-dimensional array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.ArrayLength" /> and the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" /> property equal to <paramref name="array" />.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" /> property equal to.</param>
       </Docs>
@@ -1210,7 +1282,6 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The Assign expression copies a value for value types, and it copies a reference for reference types.</para>
@@ -1219,6 +1290,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents an assignment operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Assign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -1241,7 +1316,6 @@
         <Parameter Name="expression" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of <paramref name="expression" /> must be assignable to the type represented by the <see cref="P:System.Reflection.FieldInfo.FieldType" /> or <see cref="P:System.Reflection.PropertyInfo.PropertyType" /> property of <paramref name="member" />.</para>
@@ -1250,6 +1324,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MemberAssignment" /> that represents the initialization of a field or property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MemberAssignment" /> that has <see cref="P:System.Linq.Expressions.MemberBinding.BindingType" /> equal to <see cref="F:System.Linq.Expressions.MemberBindingType.Assignment" /> and the <see cref="P:System.Linq.Expressions.MemberBinding.Member" /> and <see cref="P:System.Linq.Expressions.MemberAssignment.Expression" /> properties set to the specified values.</para>
+        </returns>
         <param name="member">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Reflection.MemberInfo" /> to set the <see cref="P:System.Linq.Expressions.MemberBinding.Member" /> property equal to.</param>
         <param name="expression">
@@ -1272,7 +1350,6 @@
         <Parameter Name="expression" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of <paramref name="expression" /> must be assignable to the type represented by the <see cref="P:System.Reflection.PropertyInfo.PropertyType" /> property of the property accessed in <paramref name="propertyAccessor" />.</para>
@@ -1281,6 +1358,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MemberAssignment" /> that represents the initialization of a member by using a property accessor method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MemberAssignment" /> that has the <see cref="P:System.Linq.Expressions.MemberBinding.BindingType" /> property equal to <see cref="F:System.Linq.Expressions.MemberBindingType.Assignment" />, the <see cref="P:System.Linq.Expressions.MemberBinding.Member" /> property set to the <see cref="T:System.Reflection.PropertyInfo" /> that represents the property accessed in <paramref name="propertyAccessor" />, and the <see cref="P:System.Linq.Expressions.MemberAssignment.Expression" /> property set to <paramref name="expression" />.</para>
+        </returns>
         <param name="propertyAccessor">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Reflection.MethodInfo" /> that represents a property accessor method.</param>
         <param name="expression">
@@ -1301,7 +1382,6 @@
         <Parameter Name="expressions" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.Expression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When the block expression is executed, it returns the value of the last expression in the block.</para>
@@ -1310,6 +1390,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BlockExpression" /> that contains the given expressions and has no variables.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.BlockExpression" />.</para>
+        </returns>
         <param name="expressions">
           <attribution license="cc4" from="Microsoft" modified="false" />The expressions in the block.</param>
       </Docs>
@@ -1334,7 +1418,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When the block expression is executed, it returns the value of the last expression in the block.</para>
@@ -1343,6 +1426,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BlockExpression" /> that contains the given expressions and has no variables.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.BlockExpression" />.</para>
+        </returns>
         <param name="expressions">
           <attribution license="cc4" from="Microsoft" modified="false" />The expressions in the block.</param>
       </Docs>
@@ -1362,7 +1449,6 @@
         <Parameter Name="expressions" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.Expression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When the block expression is executed, it returns the value of the last expression in the block.</para>
@@ -1371,6 +1457,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BlockExpression" /> that contains the given variables and expressions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.BlockExpression" />.</para>
+        </returns>
         <param name="variables">
           <attribution license="cc4" from="Microsoft" modified="false" />The variables in the block.</param>
         <param name="expressions">
@@ -1398,7 +1488,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When the block expression is executed, it returns the value of the last expression in the block.</para>
@@ -1407,6 +1496,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BlockExpression" /> that contains the given variables and expressions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.BlockExpression" />.</para>
+        </returns>
         <param name="variables">
           <attribution license="cc4" from="Microsoft" modified="false" />The variables in the block.</param>
         <param name="expressions">
@@ -1428,7 +1521,6 @@
         <Parameter Name="arg1" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When the block expression is executed, it returns the value of the last expression in the block.</para>
@@ -1437,6 +1529,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BlockExpression" /> that contains two expressions and has no variables.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.BlockExpression" />.</para>
+        </returns>
         <param name="arg0">
           <attribution license="cc4" from="Microsoft" modified="false" />The first expression in the block.</param>
         <param name="arg1">
@@ -1458,12 +1554,15 @@
         <Parameter Name="expressions" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.Expression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BlockExpression" /> that contains the given expressions, has no variables and has specific result type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.BlockExpression" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The result type of the block.</param>
         <param name="expressions">
@@ -1491,12 +1590,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BlockExpression" /> that contains the given expressions, has no variables and has specific result type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.BlockExpression" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The result type of the block.</param>
         <param name="expressions">
@@ -1519,7 +1621,6 @@
         <Parameter Name="arg2" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When the block expression is executed, it returns the value of the last expression in the block.</para>
@@ -1528,6 +1629,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BlockExpression" /> that contains three expressions and has no variables.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.BlockExpression" />.</para>
+        </returns>
         <param name="arg0">
           <attribution license="cc4" from="Microsoft" modified="false" />The first expression in the block.</param>
         <param name="arg1">
@@ -1552,12 +1657,15 @@
         <Parameter Name="expressions" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.Expression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BlockExpression" /> that contains the given variables and expressions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.BlockExpression" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The result type of the block.</param>
         <param name="variables">
@@ -1588,12 +1696,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BlockExpression" /> that contains the given variables and expressions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.BlockExpression" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The result type of the block.</param>
         <param name="variables">
@@ -1619,7 +1730,6 @@
         <Parameter Name="arg3" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When the block expression is executed, it returns the value of the last expression in the block.</para>
@@ -1628,6 +1738,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BlockExpression" /> that contains four expressions and has no variables.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.BlockExpression" />.</para>
+        </returns>
         <param name="arg0">
           <attribution license="cc4" from="Microsoft" modified="false" />The first expression in the block.</param>
         <param name="arg1">
@@ -1656,7 +1770,6 @@
         <Parameter Name="arg4" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When the block expression is executed, it returns the value of the last expression in the block.</para>
@@ -1665,6 +1778,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BlockExpression" /> that contains five expressions and has no variables.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.BlockExpression" />.</para>
+        </returns>
         <param name="arg0">
           <attribution license="cc4" from="Microsoft" modified="false" />The first expression in the block.</param>
         <param name="arg1">
@@ -1691,12 +1808,15 @@
         <Parameter Name="target" Type="System.Linq.Expressions.LabelTarget" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.GotoExpression" /> representing a break statement.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.GotoExpression" /> with <see cref="P:System.Linq.Expressions.GotoExpression.Kind" /> equal to Break, the <see cref="P:System.Linq.Expressions.GotoExpression.Target" /> property set to <paramref name="target" />, and a null value to be passed to the target label upon jumping.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.Expressions.LabelTarget" /> that the <see cref="T:System.Linq.Expressions.GotoExpression" /> will jump to.</param>
       </Docs>
@@ -1716,12 +1836,15 @@
         <Parameter Name="value" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.GotoExpression" /> representing a break statement. The value passed to the label upon jumping can be specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.GotoExpression" /> with <see cref="P:System.Linq.Expressions.GotoExpression.Kind" /> equal to Break, the <see cref="P:System.Linq.Expressions.GotoExpression.Target" /> property set to <paramref name="target" />, and <paramref name="value" /> to be passed to the target label upon jumping.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.Expressions.LabelTarget" /> that the <see cref="T:System.Linq.Expressions.GotoExpression" /> will jump to.</param>
         <param name="value">
@@ -1743,12 +1866,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.GotoExpression" /> representing a break statement with the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.GotoExpression" /> with <see cref="P:System.Linq.Expressions.GotoExpression.Kind" /> equal to Break, the <see cref="P:System.Linq.Expressions.GotoExpression.Target" /> property set to <paramref name="target" />, and the <see cref="P:System.Linq.Expressions.Expression.Type" /> property set to <paramref name="type" />.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.Expressions.LabelTarget" /> that the <see cref="T:System.Linq.Expressions.GotoExpression" /> will jump to.</param>
         <param name="type">
@@ -1771,12 +1897,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.GotoExpression" /> representing a break statement with the specified type. The value passed to the label upon jumping can be specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.GotoExpression" /> with <see cref="P:System.Linq.Expressions.GotoExpression.Kind" /> equal to Break, the <see cref="P:System.Linq.Expressions.GotoExpression.Target" /> property set to <paramref name="target" />, the <see cref="P:System.Linq.Expressions.Expression.Type" /> property set to <paramref name="type" />, and <paramref name="value" /> to be passed to the target label upon jumping.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.Expressions.LabelTarget" /> that the <see cref="T:System.Linq.Expressions.GotoExpression" /> will jump to.</param>
         <param name="value">
@@ -1801,7 +1930,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To represent a call to a static (Shared in Visual Basic) method, pass in null for the <paramref name="instance" /> parameter when you call this method.</para>
@@ -1812,6 +1940,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents a call to a method that takes no arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Call" /> and the <see cref="P:System.Linq.Expressions.MethodCallExpression.Object" /> and <see cref="P:System.Linq.Expressions.MethodCallExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="instance">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> that specifies the instance for an instance method call (pass null for a static (Shared in Visual Basic) method).</param>
         <param name="method">
@@ -1833,12 +1965,15 @@
         <Parameter Name="arguments" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.Expression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents a call to a static (Shared in Visual Basic) method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Call" /> and the <see cref="P:System.Linq.Expressions.MethodCallExpression.Object" /> and <see cref="P:System.Linq.Expressions.MethodCallExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="method">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.MethodInfo" /> that represents the target method.</param>
         <param name="arguments">
@@ -1860,12 +1995,15 @@
         <Parameter Name="arg0" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents a call to a static (Shared in Visual Basic) method that takes one argument.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Call" /> and the <see cref="P:System.Linq.Expressions.MethodCallExpression.Object" /> and <see cref="P:System.Linq.Expressions.MethodCallExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="method">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Reflection.MethodInfo" /> to set the <see cref="P:System.Linq.Expressions.MethodCallExpression.Method" /> property equal to.</param>
         <param name="arg0">
@@ -1894,7 +2032,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="arguments" /> is not null, it must have the same number of elements as the number of parameters for the method represented by <paramref name="method" />. Each element in <paramref name="arguments" /> must not be null and must be assignable to the corresponding parameter of <paramref name="method" />, possibly after <newTerm>quoting</newTerm>.</para>
@@ -1908,6 +2045,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents a call to a static (Shared in Visual Basic) method that has arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Call" /> and the <see cref="P:System.Linq.Expressions.MethodCallExpression.Method" /> and <see cref="P:System.Linq.Expressions.MethodCallExpression.Arguments" /> properties set to the specified values.</para>
+        </returns>
         <param name="method">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Reflection.MethodInfo" /> that represents a static (Shared in Visual Basic) method to set the <see cref="P:System.Linq.Expressions.MethodCallExpression.Method" /> property equal to.</param>
         <param name="arguments">
@@ -1931,7 +2072,6 @@
         <Parameter Name="arguments" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.Expression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To represent a call to a static (Shared in Visual Basic) method, pass in null for the <paramref name="instance" /> parameter when you call this method, or call <see cref="M:System.Linq.Expressions.Expression.Call(System.Reflection.MethodInfo,System.Linq.Expressions.Expression[])" /> instead.</para>
@@ -1947,6 +2087,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents a call to a method that takes arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Call" /> and the <see cref="P:System.Linq.Expressions.MethodCallExpression.Object" />, <see cref="P:System.Linq.Expressions.MethodCallExpression.Method" />, and <see cref="P:System.Linq.Expressions.MethodCallExpression.Arguments" /> properties set to the specified values.</para>
+        </returns>
         <param name="instance">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.MethodCallExpression.Object" /> property equal to (pass null for a static (Shared in Visual Basic) method).</param>
         <param name="method">
@@ -1978,7 +2122,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To represent a call to a static (Shared in Visual Basic) method, pass in null for the <paramref name="instance" /> parameter when you call this method, or call <see cref="M:System.Linq.Expressions.Expression.Call(System.Reflection.MethodInfo,System.Linq.Expressions.Expression[])" /> instead.</para>
@@ -1994,6 +2137,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents a call to a method that takes arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Call" /> and the <see cref="P:System.Linq.Expressions.MethodCallExpression.Object" />, <see cref="P:System.Linq.Expressions.MethodCallExpression.Method" />, and <see cref="P:System.Linq.Expressions.MethodCallExpression.Arguments" /> properties set to the specified values.</para>
+        </returns>
         <param name="instance">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> that specifies the instance fo an instance method call (pass null for a static (Shared in Visual Basic) method).</param>
         <param name="method">
@@ -2018,12 +2165,15 @@
         <Parameter Name="arg1" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents a call to a static method that takes two arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Call" /> and the <see cref="P:System.Linq.Expressions.MethodCallExpression.Object" /> and <see cref="P:System.Linq.Expressions.MethodCallExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="method">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Reflection.MethodInfo" /> to set the <see cref="P:System.Linq.Expressions.MethodCallExpression.Method" /> property equal to.</param>
         <param name="arg0">
@@ -2049,12 +2199,15 @@
         <Parameter Name="arg1" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents a call to a method that takes two arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Call" /> and the <see cref="P:System.Linq.Expressions.MethodCallExpression.Object" /> and <see cref="P:System.Linq.Expressions.MethodCallExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="instance">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> that specifies the instance for an instance call. (pass null for a static (Shared in Visual Basic) method).</param>
         <param name="method">
@@ -2089,7 +2242,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of the resulting <see cref="T:System.Linq.Expressions.MethodCallExpression" /> is equal to the return type of the method denoted by <paramref name="methodName" />.</para>
@@ -2098,6 +2250,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents a call to a method by calling the appropriate factory method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Call" />, the <see cref="P:System.Linq.Expressions.MethodCallExpression.Object" /> property equal to <paramref name="instance" />, <see cref="P:System.Linq.Expressions.MethodCallExpression.Method" /> set to the <see cref="T:System.Reflection.MethodInfo" /> that represents the specified instance method, and <see cref="P:System.Linq.Expressions.MethodCallExpression.Arguments" /> set to the specified arguments.</para>
+        </returns>
         <param name="instance">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> whose <see cref="P:System.Linq.Expressions.Expression.Type" /> property value will be searched for a specific method.</param>
         <param name="methodName">
@@ -2125,12 +2281,15 @@
         <Parameter Name="arg2" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents a call to a static method that takes three arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Call" /> and the <see cref="P:System.Linq.Expressions.MethodCallExpression.Object" /> and <see cref="P:System.Linq.Expressions.MethodCallExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="method">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Reflection.MethodInfo" /> to set the <see cref="P:System.Linq.Expressions.MethodCallExpression.Method" /> property equal to.</param>
         <param name="arg0">
@@ -2165,7 +2324,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of the resulting <see cref="T:System.Linq.Expressions.MethodCallExpression" /> is equal to the return type of the method denoted by <paramref name="methodName" />. The <see cref="P:System.Linq.Expressions.MethodCallExpression.Object" /> property is null.</para>
@@ -2174,6 +2332,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents a call to a static (Shared in Visual Basic) method by calling the appropriate factory method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Call" />, the <see cref="P:System.Linq.Expressions.MethodCallExpression.Method" /> property set to the <see cref="T:System.Reflection.MethodInfo" /> that represents the specified static (Shared in Visual Basic) method, and the <see cref="P:System.Linq.Expressions.MethodCallExpression.Arguments" /> property set to the specified arguments.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> that specifies the type that contains the specified static (Shared in Visual Basic) method.</param>
         <param name="methodName">
@@ -2202,12 +2364,15 @@
         <Parameter Name="arg2" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents a call to a method that takes three arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Call" /> and the <see cref="P:System.Linq.Expressions.MethodCallExpression.Object" /> and <see cref="P:System.Linq.Expressions.MethodCallExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="instance">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> that specifies the instance for an instance call. (pass null for a static (Shared in Visual Basic) method).</param>
         <param name="method">
@@ -2238,12 +2403,15 @@
         <Parameter Name="arg3" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents a call to a static method that takes four arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Call" /> and the <see cref="P:System.Linq.Expressions.MethodCallExpression.Object" /> and <see cref="P:System.Linq.Expressions.MethodCallExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="method">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Reflection.MethodInfo" /> to set the <see cref="P:System.Linq.Expressions.MethodCallExpression.Method" /> property equal to.</param>
         <param name="arg0">
@@ -2275,12 +2443,15 @@
         <Parameter Name="arg4" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents a call to a static method that takes five arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Call" /> and the <see cref="P:System.Linq.Expressions.MethodCallExpression.Object" /> and <see cref="P:System.Linq.Expressions.MethodCallExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="method">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Reflection.MethodInfo" /> to set the <see cref="P:System.Linq.Expressions.MethodCallExpression.Method" /> property equal to.</param>
         <param name="arg0">
@@ -2329,12 +2500,15 @@
         <Parameter Name="body" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.CatchBlock" /> representing a catch statement with a reference to the caught <see cref="T:System.Exception" /> object for use in the handler body.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.CatchBlock" />.</para>
+        </returns>
         <param name="variable">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Linq.Expressions.ParameterExpression" /> representing a reference to the <see cref="T:System.Exception" /> object caught by this handler.</param>
         <param name="body">
@@ -2356,7 +2530,6 @@
         <Parameter Name="body" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> of <see cref="T:System.Exception" /> to be caught can be specified but no reference to the <see cref="T:System.Exception" /> object will be available for use in the <see cref="T:System.Linq.Expressions.CatchBlock" />.</para>
@@ -2365,6 +2538,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.CatchBlock" /> representing a catch statement.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.CatchBlock" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.Expression.Type" /> of <see cref="T:System.Exception" /> this <see cref="T:System.Linq.Expressions.CatchBlock" /> will handle.</param>
         <param name="body">
@@ -2387,12 +2564,15 @@
         <Parameter Name="filter" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.CatchBlock" /> representing a catch statement with an <see cref="T:System.Exception" /> filter and a reference to the caught <see cref="T:System.Exception" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.CatchBlock" />.</para>
+        </returns>
         <param name="variable">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Linq.Expressions.ParameterExpression" /> representing a reference to the <see cref="T:System.Exception" /> object caught by this handler.</param>
         <param name="body">
@@ -2417,12 +2597,15 @@
         <Parameter Name="filter" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.CatchBlock" /> representing a catch statement with an <see cref="T:System.Exception" /> filter but no reference to the caught <see cref="T:System.Exception" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.CatchBlock" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.Expression.Type" /> of <see cref="T:System.Exception" /> this <see cref="T:System.Linq.Expressions.CatchBlock" /> will handle.</param>
         <param name="body">
@@ -2445,12 +2628,15 @@
         <Parameter Name="document" Type="System.Linq.Expressions.SymbolDocumentInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.DebugInfoExpression" /> for clearing a sequence point.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Linq.Expressions.DebugInfoExpression" /> for clearning a sequence point.</para>
+        </returns>
         <param name="document">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.Expressions.SymbolDocumentInfo" /> that represents the source file.</param>
       </Docs>
@@ -2471,7 +2657,6 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property of the resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> is null and both <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> are set to false. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is equal to the result type of the coalescing operation. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -2495,6 +2680,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a coalescing operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Coalesce" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -2518,7 +2707,6 @@
         <Parameter Name="conversion" Type="System.Linq.Expressions.LambdaExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property of the resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> is null and both <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> are set to false.</para>
@@ -2540,6 +2728,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a coalescing operation, given a conversion function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Coalesce" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -2565,7 +2757,6 @@
         <Parameter Name="ifFalse" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of the resulting <see cref="T:System.Linq.Expressions.ConditionalExpression" /> is equal to the <see cref="P:System.Linq.Expressions.Expression.Type" /> property of <paramref name="ifTrue" />.</para>
@@ -2574,6 +2765,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.ConditionalExpression" /> that represents a conditional statement.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.ConditionalExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Conditional" /> and the <see cref="P:System.Linq.Expressions.ConditionalExpression.Test" />, <see cref="P:System.Linq.Expressions.ConditionalExpression.IfTrue" />, and <see cref="P:System.Linq.Expressions.ConditionalExpression.IfFalse" /> properties set to the specified values.</para>
+        </returns>
         <param name="test">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.ConditionalExpression.Test" /> property equal to.</param>
         <param name="ifTrue">
@@ -2599,7 +2794,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method allows explicitly unifying the result type of the conditional expression in cases where the types of <paramref name="ifTrue" /> and <paramref name="ifFalse" /> expressions are not equal. Types of both <paramref name="ifTrue" /> and <paramref name="ifFalse" /> must be implicitly reference assignable to the result type. The <paramref name="type" /> is allowed to be <see cref="T:System.Void" />.</para>
@@ -2608,6 +2802,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.ConditionalExpression" /> that represents a conditional statement.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.ConditionalExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Conditional" /> and the <see cref="P:System.Linq.Expressions.ConditionalExpression.Test" />, <see cref="P:System.Linq.Expressions.ConditionalExpression.IfTrue" />, and <see cref="P:System.Linq.Expressions.ConditionalExpression.IfFalse" /> properties set to the specified values.</para>
+        </returns>
         <param name="test">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.ConditionalExpression.Test" /> property equal to.</param>
         <param name="ifTrue">
@@ -2633,7 +2831,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of the resulting <see cref="T:System.Linq.Expressions.ConstantExpression" /> is equal to the type of <paramref name="value" />. If <paramref name="value" /> is null, <see cref="P:System.Linq.Expressions.Expression.Type" /> is equal to <see cref="T:System.Object" />.</para>
@@ -2644,6 +2841,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.ConstantExpression" /> that has the <see cref="P:System.Linq.Expressions.ConstantExpression.Value" /> property set to the specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.ConstantExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Constant" /> and the <see cref="P:System.Linq.Expressions.ConstantExpression.Value" /> property set to the specified value.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Object" /> to set the <see cref="P:System.Linq.Expressions.ConstantExpression.Value" /> property equal to.</param>
       </Docs>
@@ -2664,7 +2865,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be useful for representing values of nullable types.</para>
@@ -2673,6 +2873,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.ConstantExpression" /> that has the <see cref="P:System.Linq.Expressions.ConstantExpression.Value" /> and <see cref="P:System.Linq.Expressions.Expression.Type" /> properties set to the specified values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.ConstantExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Constant" /> and the <see cref="P:System.Linq.Expressions.ConstantExpression.Value" /> and <see cref="P:System.Linq.Expressions.Expression.Type" /> properties set to the specified values.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Object" /> to set the <see cref="P:System.Linq.Expressions.ConstantExpression.Value" /> property equal to.</param>
         <param name="type">
@@ -2693,12 +2897,15 @@
         <Parameter Name="target" Type="System.Linq.Expressions.LabelTarget" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.GotoExpression" /> representing a continue statement.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.GotoExpression" /> with <see cref="P:System.Linq.Expressions.GotoExpression.Kind" /> equal to Continue, the <see cref="P:System.Linq.Expressions.GotoExpression.Target" /> property set to <paramref name="target" />, and a null value to be passed to the target label upon jumping.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.Expressions.LabelTarget" /> that the <see cref="T:System.Linq.Expressions.GotoExpression" /> will jump to.</param>
       </Docs>
@@ -2718,12 +2925,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.GotoExpression" /> representing a continue statement with the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.GotoExpression" /> with <see cref="P:System.Linq.Expressions.GotoExpression.Kind" /> equal to Continue, the <see cref="P:System.Linq.Expressions.GotoExpression.Target" /> property set to <paramref name="target" />, the <see cref="P:System.Linq.Expressions.Expression.Type" /> property set to <paramref name="type" />, and a null value to be passed to the target label upon jumping.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.Expressions.LabelTarget" /> that the <see cref="T:System.Linq.Expressions.GotoExpression" /> will jump to.</param>
         <param name="type">
@@ -2746,7 +2956,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.UnaryExpression.Method" /> property of the resulting <see cref="T:System.Linq.Expressions.UnaryExpression" /> is set to the implementing method. The <see cref="P:System.Linq.Expressions.UnaryExpression.IsLiftedToNull" /> property is false. If the node is lifted, <see cref="P:System.Linq.Expressions.UnaryExpression.IsLifted" /> is true. Otherwise, it is false.</para>
@@ -2796,6 +3005,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents a type conversion operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Convert" /> and the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" /> and <see cref="P:System.Linq.Expressions.Expression.Type" /> properties set to the specified values.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" /> property equal to.</param>
         <param name="type">
@@ -2819,7 +3032,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.UnaryExpression.Method" /> property of the resulting <see cref="T:System.Linq.Expressions.UnaryExpression" /> is set to the implementing method. The <see cref="P:System.Linq.Expressions.UnaryExpression.IsLiftedToNull" /> property is false. If the node is lifted, <see cref="P:System.Linq.Expressions.UnaryExpression.IsLifted" /> is true. Otherwise, it is false.</para>
@@ -2872,6 +3084,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents a conversion operation for which the implementing method is specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Convert" /> and the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" />, <see cref="P:System.Linq.Expressions.Expression.Type" />, and <see cref="P:System.Linq.Expressions.UnaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" /> property equal to.</param>
         <param name="type">
@@ -2896,7 +3112,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.UnaryExpression.Method" /> property of the resulting <see cref="T:System.Linq.Expressions.UnaryExpression" /> is set to the implementing method. The <see cref="P:System.Linq.Expressions.UnaryExpression.IsLiftedToNull" /> property is false. If the node is lifted, <see cref="P:System.Linq.Expressions.UnaryExpression.IsLifted" /> is true. Otherwise, it is false.</para>
@@ -2946,6 +3161,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents a conversion operation that throws an exception if the target type is overflowed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.ConvertChecked" /> and the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" /> and <see cref="P:System.Linq.Expressions.Expression.Type" /> properties set to the specified values.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" /> property equal to.</param>
         <param name="type">
@@ -2969,7 +3188,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.UnaryExpression.Method" /> property of the resulting <see cref="T:System.Linq.Expressions.UnaryExpression" /> is set to the implementing method. The <see cref="P:System.Linq.Expressions.UnaryExpression.IsLiftedToNull" /> property is false. If the node is lifted, <see cref="P:System.Linq.Expressions.UnaryExpression.IsLifted" /> is true. Otherwise, it is false.</para>
@@ -3022,6 +3240,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents a conversion operation that throws an exception if the target type is overflowed and for which the implementing method is specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.ConvertChecked" /> and the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" />, <see cref="P:System.Linq.Expressions.Expression.Type" />, and <see cref="P:System.Linq.Expressions.UnaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" /> property equal to.</param>
         <param name="type">
@@ -3048,12 +3270,15 @@
         <Parameter Name="endColumn" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.DebugInfoExpression" /> with the specified span.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Linq.Expressions.DebugInfoExpression" />.</para>
+        </returns>
         <param name="document">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.Expressions.SymbolDocumentInfo" /> that represents the source file.</param>
         <param name="startLine">
@@ -3080,7 +3305,6 @@
         <Parameter Name="expression" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This expression is functional and does not change the value of the object passed to it.</para>
@@ -3089,6 +3313,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents the decrementing of the expression by 1.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents the decremented expression.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to decrement.</param>
       </Docs>
@@ -3108,7 +3336,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This expression is functional and does not change the value of the object passed to it.</para>
@@ -3117,6 +3344,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents the decrementing of the expression by 1.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents the decremented expression.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to decrement.</param>
         <param name="method">
@@ -3137,12 +3368,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.DefaultExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.Type" /> property set to the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.DefaultExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Default" /> and the <see cref="P:System.Linq.Expressions.Expression.Type" /> property set to the specified type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> to set the <see cref="P:System.Linq.Expressions.Expression.Type" /> property equal to.</param>
       </Docs>
@@ -3163,7 +3397,6 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -3215,6 +3448,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents an arithmetic division operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Divide" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property to.</param>
         <param name="right">
@@ -3238,7 +3475,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -3293,6 +3529,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents an arithmetic division operation. The implementing method can be specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Divide" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -3316,12 +3556,15 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a division assignment operation that does not have overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.DivideAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -3344,12 +3587,15 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a division assignment operation that does not have overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.DivideAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -3375,12 +3621,15 @@
         <Parameter Name="conversion" Type="System.Linq.Expressions.LambdaExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a division assignment operation that does not have overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.DivideAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Method" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -3407,7 +3656,6 @@
         <Parameter Name="arguments" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.Expression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.DynamicExpression.DelegateType" /> property of the result will be inferred from the types of the arguments and the specified return type.</para>
@@ -3416,6 +3664,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.DynamicExpression" /> that represents a dynamic operation bound by the provided <see cref="T:System.Runtime.CompilerServices.CallSiteBinder" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.DynamicExpression" /> that has <see cref="P:System.Linq.Expressions.Expression.NodeType" /> equal to <see cref="F:System.Linq.Expressions.ExpressionType.Dynamic" /> and has the <see cref="P:System.Linq.Expressions.DynamicExpression.Binder" /> and <see cref="P:System.Linq.Expressions.DynamicExpression.Arguments" /> set to the specified values.</para>
+        </returns>
         <param name="binder">
           <attribution license="cc4" from="Microsoft" modified="false" />The runtime binder for the dynamic operation.</param>
         <param name="returnType">
@@ -3440,7 +3692,6 @@
         <Parameter Name="arg0" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.DynamicExpression.DelegateType" /> property of the result will be inferred from the types of the arguments and the specified return type.</para>
@@ -3449,6 +3700,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.DynamicExpression" /> that represents a dynamic operation bound by the provided <see cref="T:System.Runtime.CompilerServices.CallSiteBinder" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.DynamicExpression" /> that has <see cref="P:System.Linq.Expressions.Expression.NodeType" /> equal to <see cref="F:System.Linq.Expressions.ExpressionType.Dynamic" /> and has the <see cref="P:System.Linq.Expressions.DynamicExpression.Binder" /> and <see cref="P:System.Linq.Expressions.DynamicExpression.Arguments" /> set to the specified values.</para>
+        </returns>
         <param name="binder">
           <attribution license="cc4" from="Microsoft" modified="false" />The runtime binder for the dynamic operation.</param>
         <param name="returnType">
@@ -3479,7 +3734,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.DynamicExpression.DelegateType" /> property of the result will be inferred from the types of the arguments and the specified return type.</para>
@@ -3488,6 +3742,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.DynamicExpression" /> that represents a dynamic operation bound by the provided <see cref="T:System.Runtime.CompilerServices.CallSiteBinder" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.DynamicExpression" /> that has <see cref="P:System.Linq.Expressions.Expression.NodeType" /> equal to <see cref="F:System.Linq.Expressions.ExpressionType.Dynamic" /> and has the <see cref="P:System.Linq.Expressions.DynamicExpression.Binder" /> and <see cref="P:System.Linq.Expressions.DynamicExpression.Arguments" /> set to the specified values.</para>
+        </returns>
         <param name="binder">
           <attribution license="cc4" from="Microsoft" modified="false" />The runtime binder for the dynamic operation.</param>
         <param name="returnType">
@@ -3513,7 +3771,6 @@
         <Parameter Name="arg1" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.DynamicExpression.DelegateType" /> property of the result will be inferred from the types of the arguments and the specified return type.</para>
@@ -3522,6 +3779,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.DynamicExpression" /> that represents a dynamic operation bound by the provided <see cref="T:System.Runtime.CompilerServices.CallSiteBinder" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.DynamicExpression" /> that has <see cref="P:System.Linq.Expressions.Expression.NodeType" /> equal to <see cref="F:System.Linq.Expressions.ExpressionType.Dynamic" /> and has the <see cref="P:System.Linq.Expressions.DynamicExpression.Binder" /> and <see cref="P:System.Linq.Expressions.DynamicExpression.Arguments" /> set to the specified values.</para>
+        </returns>
         <param name="binder">
           <attribution license="cc4" from="Microsoft" modified="false" />The runtime binder for the dynamic operation.</param>
         <param name="returnType">
@@ -3550,7 +3811,6 @@
         <Parameter Name="arg2" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.DynamicExpression.DelegateType" /> property of the result will be inferred from the types of the arguments and the specified return type.</para>
@@ -3559,6 +3819,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.DynamicExpression" /> that represents a dynamic operation bound by the provided <see cref="T:System.Runtime.CompilerServices.CallSiteBinder" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.DynamicExpression" /> that has <see cref="P:System.Linq.Expressions.Expression.NodeType" /> equal to <see cref="F:System.Linq.Expressions.ExpressionType.Dynamic" /> and has the <see cref="P:System.Linq.Expressions.DynamicExpression.Binder" /> and <see cref="P:System.Linq.Expressions.DynamicExpression.Arguments" /> set to the specified values.</para>
+        </returns>
         <param name="binder">
           <attribution license="cc4" from="Microsoft" modified="false" />The runtime binder for the dynamic operation.</param>
         <param name="returnType">
@@ -3590,7 +3854,6 @@
         <Parameter Name="arg3" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.DynamicExpression.DelegateType" /> property of the result will be inferred from the types of the arguments and the specified return type.</para>
@@ -3599,6 +3862,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.DynamicExpression" /> that represents a dynamic operation bound by the provided <see cref="T:System.Runtime.CompilerServices.CallSiteBinder" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.DynamicExpression" /> that has <see cref="P:System.Linq.Expressions.Expression.NodeType" /> equal to <see cref="F:System.Linq.Expressions.ExpressionType.Dynamic" /> and has the <see cref="P:System.Linq.Expressions.DynamicExpression.Binder" /> and <see cref="P:System.Linq.Expressions.DynamicExpression.Arguments" /> set to the specified values.</para>
+        </returns>
         <param name="binder">
           <attribution license="cc4" from="Microsoft" modified="false" />The runtime binder for the dynamic operation.</param>
         <param name="returnType">
@@ -3629,7 +3896,6 @@
         <Parameter Name="arguments" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.Expression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="addMethod" /> parameter must represent an instance method named "Add" (case insensitive). The add method must have the same number of parameters as the number of elements in <paramref name="arguments" />. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of each element in <paramref name="arguments" /> must be assignable to the type of the corresponding parameter of the add method, possibly after <newTerm>quoting</newTerm>.</para>
@@ -3641,6 +3907,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Linq.Expressions.ElementInit" />, given an <see cref="T:System.Collections.Generic.IEnumerable`1" /> as the second argument.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.Expressions.ElementInit" /> that has the <see cref="P:System.Linq.Expressions.ElementInit.AddMethod" /> and <see cref="P:System.Linq.Expressions.ElementInit.Arguments" /> properties set to the specified values.</para>
+        </returns>
         <param name="addMethod">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Reflection.MethodInfo" /> to set the <see cref="P:System.Linq.Expressions.ElementInit.AddMethod" /> property equal to.</param>
         <param name="arguments">
@@ -3669,7 +3939,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="addMethod" /> parameter must represent an instance method named "Add" (case insensitive). The add method must have the same number of parameters as the number of elements in <paramref name="arguments" />. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of each element in <paramref name="arguments" /> must be assignable to the type of the corresponding parameter of the add method, possibly after <newTerm>quoting</newTerm>.</para>
@@ -3681,6 +3950,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Linq.Expressions.ElementInit" />, given an array of values as the second argument.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.Expressions.ElementInit" /> that has the <see cref="P:System.Linq.Expressions.ElementInit.AddMethod" /> and <see cref="P:System.Linq.Expressions.ElementInit.Arguments" /> properties set to the specified values.</para>
+        </returns>
         <param name="addMethod">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Reflection.MethodInfo" /> to set the <see cref="P:System.Linq.Expressions.ElementInit.AddMethod" /> property equal to.</param>
         <param name="arguments">
@@ -3699,7 +3972,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An empty expression can be used where an expression is expected but no action is desired. For example, you can use an empty expression as the last expression in a block expression. In this case, the block expression's return value is void.</para>
@@ -3708,6 +3980,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an empty expression that has <see cref="T:System.Void" /> type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.DefaultExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Default" /> and the <see cref="P:System.Linq.Expressions.Expression.Type" /> property set to <see cref="T:System.Void" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Equal">
@@ -3726,7 +4002,6 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> property is true. Otherwise, it is false. The <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> property is always false. The following information describes the implementing method, the node type, and whether a node is lifted.</para>
@@ -3777,6 +4052,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents an equality comparison.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Equal" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -3801,7 +4080,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> property is true and the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> property is equal to <paramref name="liftToNull" />. Otherwise, they are both false. The following information describes the implementing method, the node type, and whether a node is lifted.</para>
@@ -3855,6 +4133,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents an equality comparison. The implementing method can be specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Equal" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -3881,7 +4163,6 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -3933,6 +4214,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a bitwise XOR operation, using op_ExclusiveOr for user-defined types.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.ExclusiveOr" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -3956,7 +4241,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -4011,6 +4295,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a bitwise XOR operation, using op_ExclusiveOr for user-defined types. The implementing method can be specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.ExclusiveOr" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -4034,12 +4322,15 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a bitwise XOR assignment operation, using op_ExclusiveOr for user-defined types.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.ExclusiveOrAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -4062,12 +4353,15 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a bitwise XOR assignment operation, using op_ExclusiveOr for user-defined types.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.ExclusiveOrAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -4093,12 +4387,15 @@
         <Parameter Name="conversion" Type="System.Linq.Expressions.LambdaExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a bitwise XOR assignment operation, using op_ExclusiveOr for user-defined types.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.ExclusiveOrAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Method" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -4125,7 +4422,6 @@
         <Parameter Name="field" Type="System.Reflection.FieldInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of the resulting <see cref="T:System.Linq.Expressions.MemberExpression" /> is equal to the <see cref="P:System.Reflection.FieldInfo.FieldType" /> property of <paramref name="field" />.</para>
@@ -4134,6 +4430,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MemberExpression" /> that represents accessing a field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MemberExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.MemberAccess" /> and the <see cref="P:System.Linq.Expressions.MemberExpression.Expression" /> and <see cref="P:System.Linq.Expressions.MemberExpression.Member" /> properties set to the specified values.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.MemberExpression.Expression" /> property equal to. For static (Shared in Visual Basic), <paramref name="expression" /> must be null.</param>
         <param name="field">
@@ -4156,7 +4456,6 @@
         <Parameter Name="fieldName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of the resulting <see cref="T:System.Linq.Expressions.MemberExpression" /> is equal to the <see cref="P:System.Reflection.FieldInfo.FieldType" /> property of the <see cref="T:System.Reflection.FieldInfo" /> that represents the field denoted by <paramref name="fieldName" />.</para>
@@ -4166,6 +4465,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MemberExpression" /> that represents accessing a field given the name of the field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MemberExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.MemberAccess" />, the <see cref="P:System.Linq.Expressions.MemberExpression.Expression" /> property set to <paramref name="expression" />, and the <see cref="P:System.Linq.Expressions.MemberExpression.Member" /> property set to the <see cref="T:System.Reflection.FieldInfo" /> that represents the field denoted by <paramref name="fieldName" />.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> whose <see cref="P:System.Linq.Expressions.Expression.Type" /> contains a field named <paramref name="fieldName" />. This can be null for static fields.</param>
         <param name="fieldName">
@@ -4188,12 +4491,15 @@
         <Parameter Name="fieldName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MemberExpression" /> that represents accessing a field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.MemberExpression" />.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />The containing object of the field. This can be null for static fields.</param>
         <param name="type">
@@ -4223,7 +4529,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As an example, if the elements of <paramref name="typeArgs" /> represent the types <unmanagedCodeEntityReference>T1…Tn</unmanagedCodeEntityReference>, the resulting <see cref="T:System.Type" /> object represents the constructed delegate type <unmanagedCodeEntityReference>System.Action&lt;T1,…,Tn&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>System.Action(Of T1,…,Tn) </unmanagedCodeEntityReference>in Visual Basic.</para>
@@ -4232,6 +4537,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Type" /> object that represents a generic <unmanagedCodeEntityReference>System.Action</unmanagedCodeEntityReference> delegate type that has specific type arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type of a <unmanagedCodeEntityReference>System.Action</unmanagedCodeEntityReference> delegate that has the specified type arguments.</para>
+        </returns>
         <param name="typeArgs">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of up to sixteen <see cref="T:System.Type" /> objects that specify the type arguments for the System.Action delegate type.</param>
       </Docs>
@@ -4256,7 +4565,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The last type argument determines the return type of the delegate. If no Func or Action is large enough, it will generate a custom delegate type.</para>
@@ -4266,6 +4574,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="P:System.Linq.Expressions.Expression.Type" /> object that represents a generic System.Func or System.Action delegate type that has specific type arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The delegate type.</para>
+        </returns>
         <param name="typeArgs">
           <attribution license="cc4" from="Microsoft" modified="false" />The type arguments of the delegate.</param>
       </Docs>
@@ -4291,7 +4603,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -4302,6 +4613,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="P:System.Linq.Expressions.Expression.Type" /> object that represents a generic System.Func delegate type that has specific type arguments. The last type argument specifies the return type of the created delegate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type of a <unmanagedCodeEntityReference>System.Func</unmanagedCodeEntityReference> delegate that has the specified type arguments.</para>
+        </returns>
         <param name="typeArgs">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of one to seventeen <see cref="T:System.Type" /> objects that specify the type arguments for the System.Func delegate type.</param>
       </Docs>
@@ -4320,12 +4635,15 @@
         <Parameter Name="target" Type="System.Linq.Expressions.LabelTarget" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.GotoExpression" /> representing a "go to" statement.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.GotoExpression" /> with <see cref="P:System.Linq.Expressions.GotoExpression.Kind" /> equal to Goto, the <see cref="P:System.Linq.Expressions.GotoExpression.Target" /> property set to the specified value, and a null value to be passed to the target label upon jumping.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.Expressions.LabelTarget" /> that the <see cref="T:System.Linq.Expressions.GotoExpression" /> will jump to.</param>
       </Docs>
@@ -4345,12 +4663,15 @@
         <Parameter Name="value" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.GotoExpression" /> representing a "go to" statement. The value passed to the label upon jumping can be specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.GotoExpression" /> with <see cref="P:System.Linq.Expressions.GotoExpression.Kind" /> equal to Goto, the <see cref="P:System.Linq.Expressions.GotoExpression.Target" /> property set to <paramref name="target" />, and <paramref name="value" /> to be passed to the target label upon jumping.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.Expressions.LabelTarget" /> that the <see cref="T:System.Linq.Expressions.GotoExpression" /> will jump to.</param>
         <param name="value">
@@ -4372,12 +4693,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.GotoExpression" /> representing a "go to" statement with the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.GotoExpression" /> with <see cref="P:System.Linq.Expressions.GotoExpression.Kind" /> equal to Goto, the <see cref="P:System.Linq.Expressions.GotoExpression.Target" /> property set to the specified value, the <see cref="P:System.Linq.Expressions.Expression.Type" /> property set to <paramref name="type" />, and a null value to be passed to the target label upon jumping.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.Expressions.LabelTarget" /> that the <see cref="T:System.Linq.Expressions.GotoExpression" /> will jump to.</param>
         <param name="type">
@@ -4400,12 +4724,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.GotoExpression" /> representing a "go to" statement with the specified type. The value passed to the label upon jumping can be specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.GotoExpression" /> with <see cref="P:System.Linq.Expressions.GotoExpression.Kind" /> equal to Goto, the <see cref="P:System.Linq.Expressions.GotoExpression.Target" /> property set to <paramref name="target" />, the <see cref="P:System.Linq.Expressions.Expression.Type" /> property set to <paramref name="type" />, and <paramref name="value" /> to be passed to the target label upon jumping.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.Expressions.LabelTarget" /> that the <see cref="T:System.Linq.Expressions.GotoExpression" /> will jump to.</param>
         <param name="value">
@@ -4430,7 +4757,6 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> property is true. Otherwise, it is false. The <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> property is always false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -4482,6 +4808,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a "greater than" numeric comparison.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.GreaterThan" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -4506,7 +4836,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> property is true and the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> property is equal to <paramref name="liftToNull" />. Otherwise, they are both false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -4561,6 +4890,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a "greater than" numeric comparison. The implementing method can be specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.GreaterThan" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -4587,7 +4920,6 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> property is true. Otherwise, it is false. The <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> property is always false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -4639,6 +4971,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a "greater than or equal" numeric comparison.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.GreaterThanOrEqual" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -4663,7 +4999,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> property is true and the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> property is equal to <paramref name="liftToNull" />. Otherwise, they are both false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -4718,6 +5053,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a "greater than or equal" numeric comparison.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.GreaterThanOrEqual" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -4743,12 +5082,15 @@
         <Parameter Name="ifTrue" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.ConditionalExpression" /> that represents a conditional block with an if statement.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.ConditionalExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Conditional" /> and the <see cref="P:System.Linq.Expressions.ConditionalExpression.Test" />, <see cref="P:System.Linq.Expressions.ConditionalExpression.IfTrue" />, properties set to the specified values. The <see cref="P:System.Linq.Expressions.ConditionalExpression.IfFalse" /> property is set to default expression and the type of the resulting <see cref="T:System.Linq.Expressions.ConditionalExpression" /> returned by this method is <see cref="T:System.Void" />.</para>
+        </returns>
         <param name="test">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.ConditionalExpression.Test" /> property equal to.</param>
         <param name="ifTrue">
@@ -4771,12 +5113,15 @@
         <Parameter Name="ifFalse" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.ConditionalExpression" /> that represents a conditional block with if and else statements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.ConditionalExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Conditional" /> and the <see cref="P:System.Linq.Expressions.ConditionalExpression.Test" />, <see cref="P:System.Linq.Expressions.ConditionalExpression.IfTrue" />, and <see cref="P:System.Linq.Expressions.ConditionalExpression.IfFalse" /> properties set to the specified values. The type of the resulting <see cref="T:System.Linq.Expressions.ConditionalExpression" /> returned by this method is <see cref="T:System.Void" />.</para>
+        </returns>
         <param name="test">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.ConditionalExpression.Test" /> property equal to.</param>
         <param name="ifTrue">
@@ -4799,7 +5144,6 @@
         <Parameter Name="expression" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This expression is functional and does not change the value of the object that is passed to it.</para>
@@ -4808,6 +5152,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents the incrementing of the expression value by 1.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents the incremented expression.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to increment.</param>
       </Docs>
@@ -4827,7 +5175,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This expression is functional and does not change the value of the object that is passed to it.</para>
@@ -4836,6 +5183,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents the incrementing of the expression by 1.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents the incremented expression.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to increment.</param>
         <param name="method">
@@ -4858,7 +5209,6 @@
         <Parameter Name="arguments" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.Expression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of the resulting <see cref="T:System.Linq.Expressions.InvocationExpression" /> represents the return type of the delegate that is represented by <paramref name="expression" />.Type.</para>
@@ -4871,6 +5221,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Linq.Expressions.InvocationExpression" /> that applies a delegate or lambda expression to a list of argument expressions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.Expressions.InvocationExpression" /> that applies the specified delegate or lambda expression to the provided arguments.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> that represents the delegate or lambda expression to be applied to.</param>
         <param name="arguments">
@@ -4899,7 +5253,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of the resulting <see cref="T:System.Linq.Expressions.InvocationExpression" /> represents the return type of the delegate that is represented by <paramref name="expression" />.Type.</para>
@@ -4912,6 +5265,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Linq.Expressions.InvocationExpression" /> that applies a delegate or lambda expression to a list of argument expressions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.Expressions.InvocationExpression" /> that applies the specified delegate or lambda expression to the provided arguments.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> that represents the delegate or lambda expression to be applied.</param>
         <param name="arguments">
@@ -4932,12 +5289,15 @@
         <Parameter Name="expression" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the expression evaluates to false.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Linq.Expressions.UnaryExpression" />.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to evaluate.</param>
       </Docs>
@@ -4957,12 +5317,15 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the expression evaluates to false.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Linq.Expressions.UnaryExpression" />.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to evaluate.</param>
         <param name="method">
@@ -4983,12 +5346,15 @@
         <Parameter Name="expression" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the expression evaluates to true.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Linq.Expressions.UnaryExpression" />.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to evaluate.</param>
       </Docs>
@@ -5008,12 +5374,15 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the expression evaluates to true.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Linq.Expressions.UnaryExpression" />.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to evaluate.</param>
         <param name="method">
@@ -5032,12 +5401,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.LabelTarget" /> representing a label with void type and no name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Linq.Expressions.LabelTarget" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Label">
@@ -5054,12 +5426,15 @@
         <Parameter Name="target" Type="System.Linq.Expressions.LabelTarget" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.LabelExpression" /> representing a label without a default value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.LabelExpression" /> without a default value.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.Expressions.LabelTarget" /> which this <see cref="T:System.Linq.Expressions.LabelExpression" /> will be associated with.</param>
       </Docs>
@@ -5078,12 +5453,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.LabelTarget" /> representing a label with void type and the given name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Linq.Expressions.LabelTarget" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the label.</param>
       </Docs>
@@ -5102,12 +5480,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.LabelTarget" /> representing a label with the given type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Linq.Expressions.LabelTarget" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of value that is passed when jumping to the label.</param>
       </Docs>
@@ -5127,12 +5508,15 @@
         <Parameter Name="defaultValue" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.LabelExpression" /> representing a label with the given default value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.LabelExpression" /> with the given default value.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.Expressions.LabelTarget" /> which this <see cref="T:System.Linq.Expressions.LabelExpression" /> will be associated with.</param>
         <param name="defaultValue">
@@ -5154,12 +5538,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.LabelTarget" /> representing a label with the given type and name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Linq.Expressions.LabelTarget" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of value that is passed when jumping to the label.</param>
         <param name="name">
@@ -5181,12 +5568,15 @@
         <Parameter Name="parameters" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.ParameterExpression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a LambdaExpression by first constructing a delegate type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.LambdaExpression" /> that has the <see cref="P:System.Linq.Expressions.LambdaExpression.NodeType" /> property equal to Lambda and the <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> and <see cref="P:System.Linq.Expressions.LambdaExpression.Parameters" /> properties set to the specified values.</para>
+        </returns>
         <param name="body">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> property equal to.</param>
         <param name="parameters">
@@ -5215,7 +5605,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="parameters" /> parameter must not have more than sixteen elements.</para>
@@ -5226,6 +5615,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.LambdaExpression" /> by first constructing a delegate type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.LambdaExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Lambda" /> and the <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> and <see cref="P:System.Linq.Expressions.LambdaExpression.Parameters" /> properties set to the specified values.</para>
+        </returns>
         <param name="body">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> property equal to.</param>
         <param name="parameters">
@@ -5248,12 +5641,15 @@
         <Parameter Name="parameters" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.ParameterExpression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a LambdaExpression by first constructing a delegate type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.LambdaExpression" /> that has the <see cref="P:System.Linq.Expressions.LambdaExpression.NodeType" /> property equal to Lambda and the <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> and <see cref="P:System.Linq.Expressions.LambdaExpression.Parameters" /> properties set to the specified values.</para>
+        </returns>
         <param name="body">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> property equal to.</param>
         <param name="tailCall">
@@ -5284,12 +5680,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a LambdaExpression by first constructing a delegate type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.LambdaExpression" /> that has the <see cref="P:System.Linq.Expressions.LambdaExpression.NodeType" /> property equal to Lambda and the <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> and <see cref="P:System.Linq.Expressions.LambdaExpression.Parameters" /> properties set to the specified values.</para>
+        </returns>
         <param name="body">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> property equal to.</param>
         <param name="tailCall">
@@ -5314,12 +5713,15 @@
         <Parameter Name="parameters" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.ParameterExpression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a LambdaExpression by first constructing a delegate type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.LambdaExpression" /> that has the <see cref="P:System.Linq.Expressions.LambdaExpression.NodeType" /> property equal to Lambda and the <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> and <see cref="P:System.Linq.Expressions.LambdaExpression.Parameters" /> properties set to the specified values.</para>
+        </returns>
         <param name="body">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> property equal to.</param>
         <param name="name">
@@ -5345,7 +5747,6 @@
         <Parameter Name="parameters" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.ParameterExpression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The object that is returned from this function is of type <see cref="T:System.Linq.Expressions.Expression`1" />. The <see cref="T:System.Linq.Expressions.LambdaExpression" /> type is used to represent the returned object because the concrete type of the lambda expression is not known at compile time.</para>
@@ -5357,6 +5758,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.LambdaExpression" /> by first constructing a delegate type. It can be used when the delegate type is not known at compile time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents a lambda expression which has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Lambda" /> and the <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> and <see cref="P:System.Linq.Expressions.LambdaExpression.Parameters" /> properties set to the specified values.</para>
+        </returns>
         <param name="delegateType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents a delegate signature for the lambda.</param>
         <param name="body">
@@ -5388,7 +5793,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The object that is returned from this function is of type <see cref="T:System.Linq.Expressions.Expression`1" />. The <see cref="T:System.Linq.Expressions.LambdaExpression" /> type is used to represent the returned object because the concrete type of the lambda expression is not known at compile time.</para>
@@ -5400,6 +5804,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.LambdaExpression" /> by first constructing a delegate type. It can be used when the delegate type is not known at compile time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents a lambda expression which has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Lambda" /> and the <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> and <see cref="P:System.Linq.Expressions.LambdaExpression.Parameters" /> properties set to the specified values.</para>
+        </returns>
         <param name="delegateType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents a delegate signature for the lambda.</param>
         <param name="body">
@@ -5425,12 +5833,15 @@
         <Parameter Name="parameters" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.ParameterExpression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a LambdaExpression by first constructing a delegate type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.LambdaExpression" /> that has the <see cref="P:System.Linq.Expressions.LambdaExpression.NodeType" /> property equal to Lambda and the <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> and <see cref="P:System.Linq.Expressions.LambdaExpression.Parameters" /> properties set to the specified values.</para>
+        </returns>
         <param name="body">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> property equal to.</param>
         <param name="name">
@@ -5458,12 +5869,15 @@
         <Parameter Name="parameters" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.ParameterExpression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a LambdaExpression by first constructing a delegate type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.LambdaExpression" /> that has the <see cref="P:System.Linq.Expressions.LambdaExpression.NodeType" /> property equal to Lambda and the <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> and <see cref="P:System.Linq.Expressions.LambdaExpression.Parameters" /> properties set to the specified values.</para>
+        </returns>
         <param name="delegateType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="P:System.Linq.Expressions.Expression.Type" /> representing the delegate signature for the lambda.</param>
         <param name="body">
@@ -5497,12 +5911,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a LambdaExpression by first constructing a delegate type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.LambdaExpression" /> that has the <see cref="P:System.Linq.Expressions.LambdaExpression.NodeType" /> property equal to Lambda and the <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> and <see cref="P:System.Linq.Expressions.LambdaExpression.Parameters" /> properties set to the specified values.</para>
+        </returns>
         <param name="delegateType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="P:System.Linq.Expressions.Expression.Type" /> representing the delegate signature for the lambda.</param>
         <param name="body">
@@ -5530,12 +5947,15 @@
         <Parameter Name="parameters" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.ParameterExpression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a LambdaExpression by first constructing a delegate type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.LambdaExpression" /> that has the <see cref="P:System.Linq.Expressions.LambdaExpression.NodeType" /> property equal to Lambda and the <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> and <see cref="P:System.Linq.Expressions.LambdaExpression.Parameters" /> properties set to the specified values.</para>
+        </returns>
         <param name="delegateType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="P:System.Linq.Expressions.Expression.Type" /> representing the delegate signature for the lambda.</param>
         <param name="body">
@@ -5564,12 +5984,15 @@
         <Parameter Name="parameters" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.ParameterExpression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a LambdaExpression by first constructing a delegate type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.LambdaExpression" /> that has the <see cref="P:System.Linq.Expressions.LambdaExpression.NodeType" /> property equal to Lambda and the <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> and <see cref="P:System.Linq.Expressions.LambdaExpression.Parameters" /> properties set to the specified values.</para>
+        </returns>
         <param name="delegateType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="P:System.Linq.Expressions.Expression.Type" /> representing the delegate signature for the lambda.</param>
         <param name="body">
@@ -5601,7 +6024,6 @@
         <Parameter Name="parameters" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.ParameterExpression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The number of parameters for the delegate type <paramref name="TDelegate" /> must equal the number of elements in <paramref name="parameters" />.</para>
@@ -5612,6 +6034,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Linq.Expressions.Expression`1" /> where the delegate type is known at compile time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.Expressions.Expression`1" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Lambda" /> and the <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> and <see cref="P:System.Linq.Expressions.LambdaExpression.Parameters" /> properties set to the specified values.</para>
+        </returns>
         <param name="body">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> property equal to.</param>
         <param name="parameters">
@@ -5645,7 +6071,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The number of parameters for the delegate type <paramref name="TDelegate" /> must equal the number of elements in <paramref name="parameters" />.</para>
@@ -5656,6 +6081,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Linq.Expressions.Expression`1" /> where the delegate type is known at compile time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.Expressions.Expression`1" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Lambda" /> and the <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> and <see cref="P:System.Linq.Expressions.LambdaExpression.Parameters" /> properties set to the specified values.</para>
+        </returns>
         <param name="body">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> property equal to.</param>
         <param name="parameters">
@@ -5683,12 +6112,15 @@
         <Parameter Name="parameters" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.ParameterExpression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Linq.Expressions.Expression`1" /> where the delegate type is known at compile time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.Expressions.Expression`1" /> that has the <see cref="P:System.Linq.Expressions.LambdaExpression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Lambda" />and the <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> and <see cref="P:System.Linq.Expressions.LambdaExpression.Parameters" /> properties set to the specified values.</para>
+        </returns>
         <param name="body">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> property equal to.</param>
         <param name="tailCall">
@@ -5724,12 +6156,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Linq.Expressions.Expression`1" /> where the delegate type is known at compile time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.Expressions.Expression`1" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Lambda" /> and the <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> and <see cref="P:System.Linq.Expressions.LambdaExpression.Parameters" /> properties set to the specified values.</para>
+        </returns>
         <param name="body">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> property equal to.</param>
         <param name="tailCall">
@@ -5759,12 +6194,15 @@
         <Parameter Name="parameters" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.ParameterExpression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Linq.Expressions.Expression`1" /> where the delegate type is known at compile time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.Expressions.Expression`1" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Lambda" /> and the <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> and <see cref="P:System.Linq.Expressions.LambdaExpression.Parameters" /> properties set to the specified values.</para>
+        </returns>
         <param name="body">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.Expression`1.Body" /> property equal to.</param>
         <param name="name">
@@ -5795,12 +6233,15 @@
         <Parameter Name="parameters" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.ParameterExpression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Linq.Expressions.Expression`1" /> where the delegate type is known at compile time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.Expressions.Expression`1" /> that has the <see cref="P:System.Linq.Expressions.LambdaExpression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Lambda" /> and the <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> and <see cref="P:System.Linq.Expressions.LambdaExpression.Parameters" /> properties set to the specified values.</para>
+        </returns>
         <param name="body">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> property equal to.</param>
         <param name="name">
@@ -5829,7 +6270,6 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -5881,6 +6321,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a bitwise left-shift operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.LeftShift" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -5904,7 +6348,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -5959,6 +6402,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a bitwise left-shift operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.LeftShift" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -5982,12 +6429,15 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a bitwise left-shift assignment operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.LeftShiftAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -6010,12 +6460,15 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a bitwise left-shift assignment operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.LeftShiftAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -6041,12 +6494,15 @@
         <Parameter Name="conversion" Type="System.Linq.Expressions.LambdaExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a bitwise left-shift assignment operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.LeftShiftAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Method" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -6073,7 +6529,6 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> property is true. Otherwise, it is false. The <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> property is always false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -6125,6 +6580,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a "less than" numeric comparison.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.LessThan" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -6149,7 +6608,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> property is true and the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> property is equal to <paramref name="liftToNull" />. Otherwise, they are both false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -6204,6 +6662,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a "less than" numeric comparison.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.LessThan" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -6230,7 +6692,6 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> property is true. Otherwise, it is false. The <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> property is always false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -6282,6 +6743,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a " less than or equal" numeric comparison.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.LessThanOrEqual" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -6306,7 +6771,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> property is true and the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> property is equal to <paramref name="liftToNull" />. Otherwise, they are both false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -6361,6 +6825,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a "less than or equal" numeric comparison.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.LessThanOrEqual" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -6387,12 +6855,15 @@
         <Parameter Name="initializers" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.ElementInit&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MemberListBinding" /> where the member is a field or property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MemberListBinding" /> that has the <see cref="P:System.Linq.Expressions.MemberBinding.BindingType" /> property equal to <see cref="F:System.Linq.Expressions.MemberBindingType.ListBinding" /> and the <see cref="P:System.Linq.Expressions.MemberBinding.Member" /> and <see cref="P:System.Linq.Expressions.MemberListBinding.Initializers" /> properties set to the specified values.</para>
+        </returns>
         <param name="member">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Reflection.MemberInfo" /> that represents a field or property to set the <see cref="P:System.Linq.Expressions.MemberBinding.Member" /> property equal to.</param>
         <param name="initializers">
@@ -6421,12 +6892,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MemberListBinding" /> where the member is a field or property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MemberListBinding" /> that has the <see cref="P:System.Linq.Expressions.MemberBinding.BindingType" /> property equal to <see cref="F:System.Linq.Expressions.MemberBindingType.ListBinding" /> and the <see cref="P:System.Linq.Expressions.MemberBinding.Member" /> and <see cref="P:System.Linq.Expressions.MemberListBinding.Initializers" /> properties set to the specified values.</para>
+        </returns>
         <param name="member">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Reflection.MemberInfo" /> that represents a field or property to set the <see cref="P:System.Linq.Expressions.MemberBinding.Member" /> property equal to.</param>
         <param name="initializers">
@@ -6449,12 +6923,15 @@
         <Parameter Name="initializers" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.ElementInit&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MemberListBinding" /> based on a specified property accessor method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MemberListBinding" /> that has the <see cref="P:System.Linq.Expressions.MemberBinding.BindingType" /> property equal to <see cref="F:System.Linq.Expressions.MemberBindingType.ListBinding" />, the <see cref="P:System.Linq.Expressions.MemberBinding.Member" /> property set to the <see cref="T:System.Reflection.MemberInfo" /> that represents the property accessed in <paramref name="propertyAccessor" />, and <see cref="P:System.Linq.Expressions.MemberListBinding.Initializers" /> populated with the elements of <paramref name="initializers" />.</para>
+        </returns>
         <param name="propertyAccessor">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Reflection.MethodInfo" /> that represents a property accessor method.</param>
         <param name="initializers">
@@ -6483,12 +6960,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MemberListBinding" /> object based on a specified property accessor method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MemberListBinding" /> that has the <see cref="P:System.Linq.Expressions.MemberBinding.BindingType" /> property equal to <see cref="F:System.Linq.Expressions.MemberBindingType.ListBinding" />, the <see cref="P:System.Linq.Expressions.MemberBinding.Member" /> property set to the <see cref="T:System.Reflection.MemberInfo" /> that represents the property accessed in <paramref name="propertyAccessor" />, and <see cref="P:System.Linq.Expressions.MemberListBinding.Initializers" /> populated with the elements of <paramref name="initializers" />.</para>
+        </returns>
         <param name="propertyAccessor">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Reflection.MethodInfo" /> that represents a property accessor method.</param>
         <param name="initializers">
@@ -6511,7 +6991,6 @@
         <Parameter Name="initializers" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.ElementInit&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of <paramref name="newExpression" /> must represent a type that implements <see cref="T:System.Collections.IEnumerable" />.</para>
@@ -6521,6 +7000,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.ListInitExpression" /> that uses specified <see cref="T:System.Linq.Expressions.ElementInit" /> objects to initialize a collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.ListInitExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.ListInit" /> and the <see cref="P:System.Linq.Expressions.ListInitExpression.NewExpression" /> and <see cref="P:System.Linq.Expressions.ListInitExpression.Initializers" /> properties set to the specified values.</para>
+        </returns>
         <param name="newExpression">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Linq.Expressions.NewExpression" /> to set the <see cref="P:System.Linq.Expressions.ListInitExpression.NewExpression" /> property equal to.</param>
         <param name="initializers">
@@ -6543,7 +7026,6 @@
         <Parameter Name="initializers" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.Expression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of <paramref name="newExpression" /> must represent a type that implements <see cref="T:System.Collections.IEnumerable" />.</para>
@@ -6555,6 +7037,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.ListInitExpression" /> that uses a method named "Add" to add elements to a collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.ListInitExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.ListInit" /> and the <see cref="P:System.Linq.Expressions.ListInitExpression.NewExpression" /> property set to the specified value.</para>
+        </returns>
         <param name="newExpression">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Linq.Expressions.NewExpression" /> to set the <see cref="P:System.Linq.Expressions.ListInitExpression.NewExpression" /> property equal to.</param>
         <param name="initializers">
@@ -6583,7 +7069,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of <paramref name="newExpression" /> must represent a type that implements <see cref="T:System.Collections.IEnumerable" />.</para>
@@ -6593,6 +7078,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.ListInitExpression" /> that uses specified <see cref="T:System.Linq.Expressions.ElementInit" /> objects to initialize a collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.ListInitExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.ListInit" /> and the <see cref="P:System.Linq.Expressions.ListInitExpression.NewExpression" /> and <see cref="P:System.Linq.Expressions.ListInitExpression.Initializers" /> properties set to the specified values.</para>
+        </returns>
         <param name="newExpression">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Linq.Expressions.NewExpression" /> to set the <see cref="P:System.Linq.Expressions.ListInitExpression.NewExpression" /> property equal to.</param>
         <param name="initializers">
@@ -6621,7 +7110,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of <paramref name="newExpression" /> must represent a type that implements <see cref="T:System.Collections.IEnumerable" />.</para>
@@ -6633,6 +7121,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.ListInitExpression" /> that uses a method named "Add" to add elements to a collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.ListInitExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.ListInit" /> and the <see cref="P:System.Linq.Expressions.ListInitExpression.NewExpression" /> property set to the specified value.</para>
+        </returns>
         <param name="newExpression">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Linq.Expressions.NewExpression" /> to set the <see cref="P:System.Linq.Expressions.ListInitExpression.NewExpression" /> property equal to.</param>
         <param name="initializers">
@@ -6656,7 +7148,6 @@
         <Parameter Name="initializers" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.Expression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of <paramref name="newExpression" /> must represent a type that implements <see cref="T:System.Collections.IEnumerable" />.</para>
@@ -6668,6 +7159,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.ListInitExpression" /> that uses a specified method to add elements to a collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.ListInitExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.ListInit" /> and the <see cref="P:System.Linq.Expressions.ListInitExpression.NewExpression" /> property set to the specified value.</para>
+        </returns>
         <param name="newExpression">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Linq.Expressions.NewExpression" /> to set the <see cref="P:System.Linq.Expressions.ListInitExpression.NewExpression" /> property equal to.</param>
         <param name="addMethod">
@@ -6699,7 +7194,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of <paramref name="newExpression" /> must represent a type that implements <see cref="T:System.Collections.IEnumerable" />.</para>
@@ -6711,6 +7205,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.ListInitExpression" /> that uses a specified method to add elements to a collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.ListInitExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.ListInit" /> and the <see cref="P:System.Linq.Expressions.ListInitExpression.NewExpression" /> property set to the specified value.</para>
+        </returns>
         <param name="newExpression">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Linq.Expressions.NewExpression" /> to set the <see cref="P:System.Linq.Expressions.ListInitExpression.NewExpression" /> property equal to.</param>
         <param name="addMethod">
@@ -6733,12 +7231,15 @@
         <Parameter Name="body" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.LoopExpression" /> with the given body.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.LoopExpression" />.</para>
+        </returns>
         <param name="body">
           <attribution license="cc4" from="Microsoft" modified="false" />The body of the loop.</param>
       </Docs>
@@ -6758,12 +7259,15 @@
         <Parameter Name="break" Type="System.Linq.Expressions.LabelTarget" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.LoopExpression" /> with the given body and break target.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.LoopExpression" />.</para>
+        </returns>
         <param name="body">
           <attribution license="cc4" from="Microsoft" modified="false" />The body of the loop.</param>
         <param name="break">
@@ -6786,12 +7290,15 @@
         <Parameter Name="continue" Type="System.Linq.Expressions.LabelTarget" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.LoopExpression" /> with the given body.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.LoopExpression" />.</para>
+        </returns>
         <param name="body">
           <attribution license="cc4" from="Microsoft" modified="false" />The body of the loop.</param>
         <param name="break">
@@ -6817,7 +7324,6 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="binaryType" /> parameter determines which <see cref="T:System.Linq.Expressions.BinaryExpression" /> factory method this method calls. For example, if <paramref name="binaryType" /> is <see cref="F:System.Linq.Expressions.ExpressionType.Subtract" />, this method invokes <see cref="M:System.Linq.Expressions.Expression.Subtract(System.Linq.Expressions.Expression,System.Linq.Expressions.Expression,System.Reflection.MethodInfo)" />.</para>
@@ -6826,6 +7332,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" />, given the left and right operands, by calling an appropriate factory method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Linq.Expressions.BinaryExpression" /> that results from calling the appropriate factory method.</para>
+        </returns>
         <param name="binaryType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.Expressions.ExpressionType" /> that specifies the type of binary operation.</param>
         <param name="left">
@@ -6853,7 +7363,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="binaryType" /> parameter determines which <see cref="T:System.Linq.Expressions.BinaryExpression" /> factory method this method will call. For example, if <paramref name="binaryType" /> is <see cref="F:System.Linq.Expressions.ExpressionType.Subtract" />, this method invokes <see cref="M:System.Linq.Expressions.Expression.Subtract(System.Linq.Expressions.Expression,System.Linq.Expressions.Expression,System.Reflection.MethodInfo)" />. The <paramref name="liftToNull" /> and <paramref name="method" /> parameters are ignored if the appropriate factory method does not have a corresponding parameter.</para>
@@ -6862,6 +7371,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" />, given the left operand, right operand and implementing method, by calling the appropriate factory method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Linq.Expressions.BinaryExpression" /> that results from calling the appropriate factory method.</para>
+        </returns>
         <param name="binaryType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.Expressions.ExpressionType" /> that specifies the type of binary operation.</param>
         <param name="left">
@@ -6894,7 +7407,6 @@
         <Parameter Name="conversion" Type="System.Linq.Expressions.LambdaExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="binaryType" /> parameter determines which <see cref="T:System.Linq.Expressions.BinaryExpression" /> factory method this method will call. For example, if <paramref name="binaryType" /> is <see cref="F:System.Linq.Expressions.ExpressionType.Subtract" />, this method invokes <see cref="M:System.Linq.Expressions.Expression.Subtract(System.Linq.Expressions.Expression,System.Linq.Expressions.Expression,System.Reflection.MethodInfo)" />. The <paramref name="liftToNull" />, <paramref name="method" /> and <paramref name="conversion" /> parameters are ignored if the appropriate factory method does not have a corresponding parameter.</para>
@@ -6903,6 +7415,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" />, given the left operand, right operand, implementing method and type conversion function, by calling the appropriate factory method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Linq.Expressions.BinaryExpression" /> that results from calling the appropriate factory method.</para>
+        </returns>
         <param name="binaryType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.Expressions.ExpressionType" /> that specifies the type of binary operation.</param>
         <param name="left">
@@ -6934,7 +7450,6 @@
         <Parameter Name="filter" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -6944,6 +7459,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.CatchBlock" /> representing a catch statement with the specified elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.CatchBlock" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.Expression.Type" /> of <see cref="T:System.Exception" /> this <see cref="T:System.Linq.Expressions.CatchBlock" /> will handle.</param>
         <param name="variable">
@@ -6970,12 +7489,15 @@
         <Parameter Name="arguments" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.Expression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.DynamicExpression" /> that represents a dynamic operation bound by the provided <see cref="T:System.Runtime.CompilerServices.CallSiteBinder" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.DynamicExpression" /> that has <see cref="P:System.Linq.Expressions.Expression.NodeType" /> equal to <see cref="F:System.Linq.Expressions.ExpressionType.Dynamic" /> and has the <see cref="P:System.Linq.Expressions.DynamicExpression.DelegateType" />, <see cref="P:System.Linq.Expressions.DynamicExpression.Binder" />, and <see cref="P:System.Linq.Expressions.DynamicExpression.Arguments" /> set to the specified values.</para>
+        </returns>
         <param name="delegateType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the delegate used by the <see cref="T:System.Runtime.CompilerServices.CallSite" />.</param>
         <param name="binder">
@@ -7000,12 +7522,15 @@
         <Parameter Name="arg0" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.DynamicExpression" /> that represents a dynamic operation bound by the provided <see cref="T:System.Runtime.CompilerServices.CallSiteBinder" /> and one argument.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.DynamicExpression" /> that has <see cref="P:System.Linq.Expressions.Expression.NodeType" /> equal to <see cref="F:System.Linq.Expressions.ExpressionType.Dynamic" /> and has the <see cref="P:System.Linq.Expressions.DynamicExpression.DelegateType" />, <see cref="P:System.Linq.Expressions.DynamicExpression.Binder" />, and <see cref="P:System.Linq.Expressions.DynamicExpression.Arguments" /> set to the specified values.</para>
+        </returns>
         <param name="delegateType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the delegate used by the <see cref="T:System.Runtime.CompilerServices.CallSite" />.</param>
         <param name="binder">
@@ -7036,12 +7561,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.DynamicExpression" /> that represents a dynamic operation bound by the provided <see cref="T:System.Runtime.CompilerServices.CallSiteBinder" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.DynamicExpression" /> that has <see cref="P:System.Linq.Expressions.Expression.NodeType" /> equal to <see cref="F:System.Linq.Expressions.ExpressionType.Dynamic" /> and has the <see cref="P:System.Linq.Expressions.DynamicExpression.DelegateType" />, <see cref="P:System.Linq.Expressions.DynamicExpression.Binder" />, and <see cref="P:System.Linq.Expressions.DynamicExpression.Arguments" /> set to the specified values.</para>
+        </returns>
         <param name="delegateType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the delegate used by the <see cref="T:System.Runtime.CompilerServices.CallSite" />.</param>
         <param name="binder">
@@ -7067,12 +7595,15 @@
         <Parameter Name="arg1" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.DynamicExpression" /> that represents a dynamic operation bound by the provided <see cref="T:System.Runtime.CompilerServices.CallSiteBinder" /> and two arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.DynamicExpression" /> that has <see cref="P:System.Linq.Expressions.Expression.NodeType" /> equal to <see cref="F:System.Linq.Expressions.ExpressionType.Dynamic" /> and has the <see cref="P:System.Linq.Expressions.DynamicExpression.DelegateType" />, <see cref="P:System.Linq.Expressions.DynamicExpression.Binder" />, and <see cref="P:System.Linq.Expressions.DynamicExpression.Arguments" /> set to the specified values.</para>
+        </returns>
         <param name="delegateType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the delegate used by the <see cref="T:System.Runtime.CompilerServices.CallSite" />.</param>
         <param name="binder">
@@ -7101,12 +7632,15 @@
         <Parameter Name="arg2" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.DynamicExpression" /> that represents a dynamic operation bound by the provided <see cref="T:System.Runtime.CompilerServices.CallSiteBinder" /> and three arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.DynamicExpression" /> that has <see cref="P:System.Linq.Expressions.Expression.NodeType" /> equal to <see cref="F:System.Linq.Expressions.ExpressionType.Dynamic" /> and has the <see cref="P:System.Linq.Expressions.DynamicExpression.DelegateType" />, <see cref="P:System.Linq.Expressions.DynamicExpression.Binder" />, and <see cref="P:System.Linq.Expressions.DynamicExpression.Arguments" /> set to the specified values.</para>
+        </returns>
         <param name="delegateType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the delegate used by the <see cref="T:System.Runtime.CompilerServices.CallSite" />.</param>
         <param name="binder">
@@ -7138,12 +7672,15 @@
         <Parameter Name="arg3" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.DynamicExpression" /> that represents a dynamic operation bound by the provided <see cref="T:System.Runtime.CompilerServices.CallSiteBinder" /> and four arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.DynamicExpression" /> that has <see cref="P:System.Linq.Expressions.Expression.NodeType" /> equal to <see cref="F:System.Linq.Expressions.ExpressionType.Dynamic" /> and has the <see cref="P:System.Linq.Expressions.DynamicExpression.DelegateType" />, <see cref="P:System.Linq.Expressions.DynamicExpression.Binder" />, and <see cref="P:System.Linq.Expressions.DynamicExpression.Arguments" /> set to the specified values.</para>
+        </returns>
         <param name="delegateType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the delegate used by the <see cref="T:System.Runtime.CompilerServices.CallSite" />.</param>
         <param name="binder">
@@ -7175,12 +7712,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.GotoExpression" /> representing a jump of the specified <see cref="T:System.Linq.Expressions.GotoExpressionKind" />. The value passed to the label upon jumping can also be specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.GotoExpression" /> with <see cref="P:System.Linq.Expressions.GotoExpression.Kind" /> equal to <paramref name="kind" />, the <see cref="P:System.Linq.Expressions.GotoExpression.Target" /> property set to <paramref name="target" />, the <see cref="P:System.Linq.Expressions.Expression.Type" /> property set to <paramref name="type" />, and <paramref name="value" /> to be passed to the target label upon jumping.</para>
+        </returns>
         <param name="kind">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.Expressions.GotoExpressionKind" /> of the <see cref="T:System.Linq.Expressions.GotoExpression" />.</param>
         <param name="target">
@@ -7207,12 +7747,15 @@
         <Parameter Name="arguments" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.Expression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Linq.Expressions.IndexExpression" /> that represents accessing an indexed property in an object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.IndexExpression" />.</para>
+        </returns>
         <param name="instance">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to which the property belongs. It should be null if the property is static (shared in Visual Basic).</param>
         <param name="indexer">
@@ -7237,7 +7780,6 @@
         <Parameter Name="member" Type="System.Reflection.MemberInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to create a <see cref="T:System.Linq.Expressions.MemberExpression" /> that represents accessing either a field or a property, depending on the type of <paramref name="member" />. If <paramref name="member" /> is of type <see cref="T:System.Reflection.FieldInfo" />, this method calls <see cref="Overload:System.Linq.Expressions.Expression.Field" /> to create the <see cref="T:System.Linq.Expressions.MemberExpression" />. If <paramref name="member" /> is of type <see cref="T:System.Reflection.PropertyInfo" />, this method calls <see cref="Overload:System.Linq.Expressions.Expression.Property" /> to create the <see cref="T:System.Linq.Expressions.MemberExpression" />.</para>
@@ -7246,6 +7788,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MemberExpression" /> that represents accessing either a field or a property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Linq.Expressions.MemberExpression" /> that results from calling the appropriate factory method.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> that represents the object that the member belongs to. This can be null for static members.</param>
         <param name="member">
@@ -7270,12 +7816,15 @@
         <Parameter Name="handlers" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.CatchBlock&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.TryExpression" /> representing a try block with the specified elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.TryExpression" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The result type of the try expression. If null, bodh and all handlers must have identical type.</param>
         <param name="body">
@@ -7305,7 +7854,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="unaryType" /> parameter determines which <see cref="T:System.Linq.Expressions.UnaryExpression" /> factory method this method calls. For example, if <paramref name="unaryType" /> is equal to <see cref="F:System.Linq.Expressions.ExpressionType.Convert" />, this method invokes <see cref="M:System.Linq.Expressions.Expression.Convert(System.Linq.Expressions.Expression,System.Type,System.Reflection.MethodInfo)" />. The <paramref name="type" /> parameter is ignored if it does not apply to the factory method that is called.</para>
@@ -7314,6 +7862,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" />, given an operand, by calling the appropriate factory method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Linq.Expressions.UnaryExpression" /> that results from calling the appropriate factory method.</para>
+        </returns>
         <param name="unaryType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.Expressions.ExpressionType" /> that specifies the type of unary operation.</param>
         <param name="operand">
@@ -7340,7 +7892,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="unaryType" /> parameter determines which <see cref="T:System.Linq.Expressions.UnaryExpression" /> factory method this method calls. For example, if <paramref name="unaryType" /> is equal to <see cref="F:System.Linq.Expressions.ExpressionType.Convert" />, this method invokes <see cref="M:System.Linq.Expressions.Expression.Convert(System.Linq.Expressions.Expression,System.Type,System.Reflection.MethodInfo)" />. The <paramref name="type" /> and <paramref name="method" /> parameters are ignored if they do not apply to the factory method that is called.</para>
@@ -7349,6 +7900,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" />, given an operand and implementing method, by calling the appropriate factory method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Linq.Expressions.UnaryExpression" /> that results from calling the appropriate factory method.</para>
+        </returns>
         <param name="unaryType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.Expressions.ExpressionType" /> that specifies the type of unary operation.</param>
         <param name="operand">
@@ -7375,7 +7930,6 @@
         <Parameter Name="bindings" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.MemberBinding&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="member" /> parameter must represent a field or property.</para>
@@ -7384,6 +7938,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MemberMemberBinding" /> that represents the recursive initialization of members of a field or property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MemberMemberBinding" /> that has the <see cref="P:System.Linq.Expressions.MemberBinding.BindingType" /> property equal to <see cref="F:System.Linq.Expressions.MemberBindingType.MemberBinding" /> and the <see cref="P:System.Linq.Expressions.MemberBinding.Member" /> and <see cref="P:System.Linq.Expressions.MemberMemberBinding.Bindings" /> properties set to the specified values.</para>
+        </returns>
         <param name="member">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.MemberInfo" /> to set the <see cref="P:System.Linq.Expressions.MemberBinding.Member" /> property equal to.</param>
         <param name="bindings">
@@ -7412,7 +7970,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="member" /> parameter must represent a field or property.</para>
@@ -7421,6 +7978,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MemberMemberBinding" /> that represents the recursive initialization of members of a field or property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MemberMemberBinding" /> that has the <see cref="P:System.Linq.Expressions.MemberBinding.BindingType" /> property equal to <see cref="F:System.Linq.Expressions.MemberBindingType.MemberBinding" /> and the <see cref="P:System.Linq.Expressions.MemberBinding.Member" /> and <see cref="P:System.Linq.Expressions.MemberMemberBinding.Bindings" /> properties set to the specified values.</para>
+        </returns>
         <param name="member">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.MemberInfo" /> to set the <see cref="P:System.Linq.Expressions.MemberBinding.Member" /> property equal to.</param>
         <param name="bindings">
@@ -7443,12 +8004,15 @@
         <Parameter Name="bindings" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.MemberBinding&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MemberMemberBinding" /> that represents the recursive initialization of members of a member that is accessed by using a property accessor method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MemberMemberBinding" /> that has the <see cref="P:System.Linq.Expressions.MemberBinding.BindingType" /> property equal to <see cref="F:System.Linq.Expressions.MemberBindingType.MemberBinding" />, the <see cref="P:System.Linq.Expressions.MemberBinding.Member" /> property set to the <see cref="T:System.Reflection.PropertyInfo" /> that represents the property accessed in <paramref name="propertyAccessor" />, and <see cref="P:System.Linq.Expressions.MemberMemberBinding.Bindings" /> properties set to the specified values.</para>
+        </returns>
         <param name="propertyAccessor">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.MethodInfo" /> that represents a property accessor method.</param>
         <param name="bindings">
@@ -7477,12 +8041,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MemberMemberBinding" /> that represents the recursive initialization of members of a member that is accessed by using a property accessor method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MemberMemberBinding" /> that has the <see cref="P:System.Linq.Expressions.MemberBinding.BindingType" /> property equal to <see cref="F:System.Linq.Expressions.MemberBindingType.MemberBinding" />, the <see cref="P:System.Linq.Expressions.MemberBinding.Member" /> property set to the <see cref="T:System.Reflection.PropertyInfo" /> that represents the property accessed in <paramref name="propertyAccessor" />, and <see cref="P:System.Linq.Expressions.MemberMemberBinding.Bindings" /> properties set to the specified values.</para>
+        </returns>
         <param name="propertyAccessor">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.MethodInfo" /> that represents a property accessor method.</param>
         <param name="bindings">
@@ -7505,7 +8072,6 @@
         <Parameter Name="bindings" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.MemberBinding&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of the resulting <see cref="T:System.Linq.Expressions.MemberInitExpression" /> is equal to the <see cref="P:System.Linq.Expressions.Expression.Type" /> property of <paramref name="newExpression" />.</para>
@@ -7514,6 +8080,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Represents an expression that creates a new object and initializes a property of the object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MemberInitExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.MemberInit" /> and the <see cref="P:System.Linq.Expressions.MemberInitExpression.NewExpression" /> and <see cref="P:System.Linq.Expressions.MemberInitExpression.Bindings" /> properties set to the specified values.</para>
+        </returns>
         <param name="newExpression">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Linq.Expressions.NewExpression" /> to set the <see cref="P:System.Linq.Expressions.MemberInitExpression.NewExpression" /> property equal to.</param>
         <param name="bindings">
@@ -7542,7 +8112,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of the resulting <see cref="T:System.Linq.Expressions.MemberInitExpression" /> is equal to the <see cref="P:System.Linq.Expressions.Expression.Type" /> property of <paramref name="newExpression" />.</para>
@@ -7551,6 +8120,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MemberInitExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MemberInitExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.MemberInit" /> and the <see cref="P:System.Linq.Expressions.MemberInitExpression.NewExpression" /> and <see cref="P:System.Linq.Expressions.MemberInitExpression.Bindings" /> properties set to the specified values.</para>
+        </returns>
         <param name="newExpression">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Linq.Expressions.NewExpression" /> to set the <see cref="P:System.Linq.Expressions.MemberInitExpression.NewExpression" /> property equal to.</param>
         <param name="bindings">
@@ -7573,7 +8146,6 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -7625,6 +8197,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents an arithmetic remainder operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Modulo" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -7648,7 +8224,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -7703,6 +8278,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents an arithmetic remainder operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Modulo" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -7726,12 +8305,15 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a remainder assignment operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.ModuloAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -7754,12 +8336,15 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a remainder assignment operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.ModuloAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -7785,12 +8370,15 @@
         <Parameter Name="conversion" Type="System.Linq.Expressions.LambdaExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a remainder assignment operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.ModuloAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Method" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -7817,7 +8405,6 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -7869,6 +8456,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents an arithmetic multiplication operation that does not have overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Multiply" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -7892,7 +8483,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -7947,6 +8537,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents an arithmetic multiplication operation that does not have overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Multiply" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -7970,12 +8564,15 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a multiplication assignment operation that does not have overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.MultiplyAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -7998,12 +8595,15 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a multiplication assignment operation that does not have overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.MultiplyAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -8029,12 +8629,15 @@
         <Parameter Name="conversion" Type="System.Linq.Expressions.LambdaExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a multiplication assignment operation that does not have overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.MultiplyAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Method" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -8060,12 +8663,15 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a multiplication assignment operation that has overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.MultiplyAssignChecked" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -8088,12 +8694,15 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a multiplication assignment operation that has overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.MultiplyAssignChecked" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -8119,12 +8728,15 @@
         <Parameter Name="conversion" Type="System.Linq.Expressions.LambdaExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a multiplication assignment operation that has overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.MultiplyAssignChecked" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Method" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -8151,7 +8763,6 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -8203,6 +8814,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents an arithmetic multiplication operation that has overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.MultiplyChecked" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -8226,7 +8841,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -8281,6 +8895,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents an arithmetic multiplication operation that has overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.MultiplyChecked" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -8304,7 +8922,6 @@
         <Parameter Name="expression" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.UnaryExpression.Method" /> property of the resulting <see cref="T:System.Linq.Expressions.UnaryExpression" /> is set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false.</para>
@@ -8347,6 +8964,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents an arithmetic negation operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Negate" /> and the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" /> property set to the specified value.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" /> property equal to.</param>
       </Docs>
@@ -8367,7 +8988,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.UnaryExpression.Method" /> property of the resulting <see cref="T:System.Linq.Expressions.UnaryExpression" /> is set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false.</para>
@@ -8413,6 +9033,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents an arithmetic negation operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Negate" /> and the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" /> and <see cref="P:System.Linq.Expressions.UnaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" /> property equal to.</param>
         <param name="method">
@@ -8434,7 +9058,6 @@
         <Parameter Name="expression" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.UnaryExpression.Method" /> property of the resulting <see cref="T:System.Linq.Expressions.UnaryExpression" /> is set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false.</para>
@@ -8477,6 +9100,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents an arithmetic negation operation that has overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.NegateChecked" /> and the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" /> property set to the specified value.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" /> property equal to.</param>
       </Docs>
@@ -8497,7 +9124,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.UnaryExpression.Method" /> property of the resulting <see cref="T:System.Linq.Expressions.UnaryExpression" /> is set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false.</para>
@@ -8543,6 +9169,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents an arithmetic negation operation that has overflow checking. The implementing method can be specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.NegateChecked" /> and the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" /> and <see cref="P:System.Linq.Expressions.UnaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" /> property equal to.</param>
         <param name="method">
@@ -8564,7 +9194,6 @@
         <Parameter Name="constructor" Type="System.Reflection.ConstructorInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.NewExpression.Arguments" /> and <see cref="P:System.Linq.Expressions.NewExpression.Members" /> properties of the resulting <see cref="T:System.Linq.Expressions.NewExpression" /> are empty collections. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property represents the declaring type of the constructor represented by <paramref name="constructor" />.</para>
@@ -8573,6 +9202,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.NewExpression" /> that represents calling the specified constructor that takes no arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.NewExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.New" /> and the <see cref="P:System.Linq.Expressions.NewExpression.Constructor" /> property set to the specified value.</para>
+        </returns>
         <param name="constructor">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.ConstructorInfo" /> to set the <see cref="P:System.Linq.Expressions.NewExpression.Constructor" /> property equal to.</param>
       </Docs>
@@ -8592,7 +9225,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="type" /> parameter must represent a type that has a constructor without parameters.</para>
@@ -8602,6 +9234,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.NewExpression" /> that represents calling the parameterless constructor of the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.NewExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.New" /> and the <see cref="P:System.Linq.Expressions.NewExpression.Constructor" /> property set to the <see cref="T:System.Reflection.ConstructorInfo" /> that represents the constructor without parameters for the specified type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that has a constructor that takes no arguments.</param>
       </Docs>
@@ -8622,7 +9258,6 @@
         <Parameter Name="arguments" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.Expression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="arguments" /> parameter must contain the same number of elements as the number of parameters for the constructor represented by <paramref name="constructor" />. If <paramref name="arguments" /> is null, it is considered empty, and the <see cref="P:System.Linq.Expressions.NewExpression.Arguments" /> property of the resulting <see cref="T:System.Linq.Expressions.NewExpression" /> is an empty collection.</para>
@@ -8632,6 +9267,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.NewExpression" /> that represents calling the specified constructor with the specified arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.NewExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.New" /> and the <see cref="P:System.Linq.Expressions.NewExpression.Constructor" /> and <see cref="P:System.Linq.Expressions.NewExpression.Arguments" /> properties set to the specified values.</para>
+        </returns>
         <param name="constructor">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.ConstructorInfo" /> to set the <see cref="P:System.Linq.Expressions.NewExpression.Constructor" /> property equal to.</param>
         <param name="arguments">
@@ -8660,7 +9299,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="arguments" /> parameter must contain the same number of elements as the number of parameters for the constructor represented by <paramref name="constructor" />. If <paramref name="arguments" /> is null, it is considered empty, and the <see cref="P:System.Linq.Expressions.NewExpression.Arguments" /> property of the resulting <see cref="T:System.Linq.Expressions.NewExpression" /> is an empty collection.</para>
@@ -8670,6 +9308,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.NewExpression" /> that represents calling the specified constructor with the specified arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.NewExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.New" /> and the <see cref="P:System.Linq.Expressions.NewExpression.Constructor" /> and <see cref="P:System.Linq.Expressions.NewExpression.Arguments" /> properties set to the specified values.</para>
+        </returns>
         <param name="constructor">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.ConstructorInfo" /> to set the <see cref="P:System.Linq.Expressions.NewExpression.Constructor" /> property equal to.</param>
         <param name="arguments">
@@ -8693,7 +9335,6 @@
         <Parameter Name="members" Type="System.Collections.Generic.IEnumerable&lt;System.Reflection.MemberInfo&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="arguments" /> parameter must contain the same number of elements as the number of parameters for the constructor represented by <paramref name="constructor" />. If <paramref name="arguments" /> is null, it is considered empty, and the <see cref="P:System.Linq.Expressions.NewExpression.Arguments" /> property of the resulting <see cref="T:System.Linq.Expressions.NewExpression" /> is an empty collection.</para>
@@ -8704,6 +9345,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.NewExpression" /> that represents calling the specified constructor with the specified arguments. The members that access the constructor initialized fields are specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.NewExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.New" /> and the <see cref="P:System.Linq.Expressions.NewExpression.Constructor" />, <see cref="P:System.Linq.Expressions.NewExpression.Arguments" /> and <see cref="P:System.Linq.Expressions.NewExpression.Members" /> properties set to the specified values.</para>
+        </returns>
         <param name="constructor">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.ConstructorInfo" /> to set the <see cref="P:System.Linq.Expressions.NewExpression.Constructor" /> property equal to.</param>
         <param name="arguments">
@@ -8735,7 +9380,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="arguments" /> parameter must contain the same number of elements as the number of parameters for the constructor represented by <paramref name="constructor" />. If <paramref name="arguments" /> is null, it is considered empty, and the <see cref="P:System.Linq.Expressions.NewExpression.Arguments" /> property of the resulting <see cref="T:System.Linq.Expressions.NewExpression" /> is an empty collection.</para>
@@ -8746,6 +9390,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.NewExpression" /> that represents calling the specified constructor with the specified arguments. The members that access the constructor initialized fields are specified as an array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.NewExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.New" /> and the <see cref="P:System.Linq.Expressions.NewExpression.Constructor" />, <see cref="P:System.Linq.Expressions.NewExpression.Arguments" /> and <see cref="P:System.Linq.Expressions.NewExpression.Members" /> properties set to the specified values.</para>
+        </returns>
         <param name="constructor">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.ConstructorInfo" /> to set the <see cref="P:System.Linq.Expressions.NewExpression.Constructor" /> property equal to.</param>
         <param name="arguments">
@@ -8770,7 +9418,6 @@
         <Parameter Name="bounds" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.Expression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of the resulting <see cref="T:System.Linq.Expressions.NewArrayExpression" /> represents an array type whose rank is equal to the length of <paramref name="bounds" /> and whose element type is <paramref name="type" />.</para>
@@ -8780,6 +9427,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.NewArrayExpression" /> that represents creating an array that has a specified rank.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.NewArrayExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.NewArrayBounds" /> and the <see cref="P:System.Linq.Expressions.NewArrayExpression.Expressions" /> property set to the specified value.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents the element type of the array.</param>
         <param name="bounds">
@@ -8808,7 +9459,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of the resulting <see cref="T:System.Linq.Expressions.NewArrayExpression" /> represents an array type whose rank is equal to the length of <paramref name="bounds" /> and whose element type is <paramref name="type" />.</para>
@@ -8818,6 +9468,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.NewArrayExpression" /> that represents creating an array that has a specified rank.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.NewArrayExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.NewArrayBounds" /> and the <see cref="P:System.Linq.Expressions.NewArrayExpression.Expressions" /> property set to the specified value.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents the element type of the array.</param>
         <param name="bounds">
@@ -8840,7 +9494,6 @@
         <Parameter Name="initializers" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.Expression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of each element of <paramref name="initializers" /> must represent a type that is assignable to the type represented by <paramref name="type" />, possibly after it is <newTerm>quoted</newTerm>.</para>
@@ -8853,6 +9506,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.NewArrayExpression" /> that represents creating a one-dimensional array and initializing it from a list of elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.NewArrayExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.NewArrayInit" /> and the <see cref="P:System.Linq.Expressions.NewArrayExpression.Expressions" /> property set to the specified value.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents the element type of the array.</param>
         <param name="initializers">
@@ -8881,7 +9538,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of each element of <paramref name="initializers" /> must represent a type that is assignable to the type represented by <paramref name="type" />, possibly after it is <newTerm>quoted</newTerm>.</para>
@@ -8894,6 +9550,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.NewArrayExpression" /> that represents creating a one-dimensional array and initializing it from a list of elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.NewArrayExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.NewArrayInit" /> and the <see cref="P:System.Linq.Expressions.NewArrayExpression.Expressions" /> property set to the specified value.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents the element type of the array.</param>
         <param name="initializers">
@@ -8939,7 +9599,6 @@
         <Parameter Name="expression" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.UnaryExpression.Method" /> property of the resulting <see cref="T:System.Linq.Expressions.UnaryExpression" /> is set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false.</para>
@@ -8982,6 +9641,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents a bitwise complement operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Not" /> and the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" /> property set to the specified value.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" /> property equal to.</param>
       </Docs>
@@ -9002,7 +9665,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.UnaryExpression.Method" /> property of the resulting <see cref="T:System.Linq.Expressions.UnaryExpression" /> is set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false.</para>
@@ -9048,6 +9710,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents a bitwise complement operation. The implementing method can be specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Not" /> and the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" /> and <see cref="P:System.Linq.Expressions.UnaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" /> property equal to.</param>
         <param name="method">
@@ -9070,7 +9736,6 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> property is true. Otherwise, it is false. The <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> property is always false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -9122,6 +9787,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents an inequality comparison.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.NotEqual" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -9146,7 +9815,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> property is true and the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> property is equal to <paramref name="liftToNull" />. Otherwise, they are both false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -9201,6 +9869,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents an inequality comparison.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.NotEqual" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -9225,12 +9897,15 @@
         <Parameter Name="expression" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the expression representing the ones complement.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Linq.Expressions.UnaryExpression" />.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" />.</param>
       </Docs>
@@ -9250,12 +9925,15 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the expression representing the ones complement.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Linq.Expressions.UnaryExpression" />.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" />.</param>
         <param name="method">
@@ -9278,7 +9956,6 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -9330,6 +10007,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a bitwise OR operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Or" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -9353,7 +10034,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -9408,6 +10088,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a bitwise OR operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Or" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -9431,12 +10115,15 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a bitwise OR assignment operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.OrAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -9459,12 +10146,15 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a bitwise OR assignment operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.OrAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -9490,12 +10180,15 @@
         <Parameter Name="conversion" Type="System.Linq.Expressions.LambdaExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a bitwise OR assignment operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.OrAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Method" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -9522,7 +10215,6 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -9581,6 +10273,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a conditional OR operation that evaluates the second operand only if the first operand evaluates to false.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.OrElse" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -9604,7 +10300,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -9666,6 +10361,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a conditional OR operation that evaluates the second operand only if the first operand evaluates to false.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.OrElse" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -9688,12 +10387,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.ParameterExpression" /> node that can be used to identify a parameter or a variable in an expression tree.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.ParameterExpression" /> node with the specified name and type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the parameter or variable.</param>
       </Docs>
@@ -9714,12 +10416,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.ParameterExpression" /> node that can be used to identify a parameter or a variable in an expression tree.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.ParameterExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Parameter" /> and the <see cref="P:System.Linq.Expressions.Expression.Type" /> and <see cref="P:System.Linq.Expressions.ParameterExpression.Name" /> properties set to the specified values.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the parameter or variable.</param>
         <param name="name">
@@ -9740,12 +10445,15 @@
         <Parameter Name="expression" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents the assignment of the expression followed by a subsequent decrement by 1 of the original expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents the resultant expression.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to apply the operations on.</param>
       </Docs>
@@ -9765,12 +10473,15 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents the assignment of the expression followed by a subsequent decrement by 1 of the original expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents the resultant expression.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to apply the operations on.</param>
         <param name="method">
@@ -9791,12 +10502,15 @@
         <Parameter Name="expression" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents the assignment of the expression followed by a subsequent increment by 1 of the original expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents the resultant expression.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to apply the operations on.</param>
       </Docs>
@@ -9816,12 +10530,15 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents the assignment of the expression followed by a subsequent increment by 1 of the original expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents the resultant expression.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to apply the operations on.</param>
         <param name="method">
@@ -9844,7 +10561,6 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -9886,6 +10602,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents raising a number to a power.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Power" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -9909,7 +10629,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -9954,6 +10673,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents raising a number to a power.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Power" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -9977,12 +10700,15 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents raising an expression to a power and assigning the result back to the expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.PowerAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -10005,12 +10731,15 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents raising an expression to a power and assigning the result back to the expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.PowerAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -10036,12 +10765,15 @@
         <Parameter Name="conversion" Type="System.Linq.Expressions.LambdaExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents raising an expression to a power and assigning the result back to the expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.PowerAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Method" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -10066,12 +10798,15 @@
         <Parameter Name="expression" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that decrements the expression by 1 and assigns the result back to the expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents the resultant expression.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to apply the operations on.</param>
       </Docs>
@@ -10091,12 +10826,15 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that decrements the expression by 1 and assigns the result back to the expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents the resultant expression.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to apply the operations on.</param>
         <param name="method">
@@ -10117,12 +10855,15 @@
         <Parameter Name="expression" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that increments the expression by 1 and assigns the result back to the expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents the resultant expression.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to apply the operations on.</param>
       </Docs>
@@ -10142,12 +10883,15 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that increments the expression by 1 and assigns the result back to the expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents the resultant expression.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to apply the operations on.</param>
         <param name="method">
@@ -10170,7 +10914,6 @@
         <Parameter Name="propertyAccessor" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of the resulting <see cref="T:System.Linq.Expressions.MemberExpression" /> is equal to the <see cref="P:System.Reflection.PropertyInfo.PropertyType" /> property of <see cref="P:System.Linq.Expressions.MemberExpression.Member" />.</para>
@@ -10180,6 +10923,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MemberExpression" /> that represents accessing a property by using a property accessor method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MemberExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.MemberAccess" />, the <see cref="P:System.Linq.Expressions.MemberExpression.Expression" /> property set to <paramref name="expression" /> and the <see cref="P:System.Linq.Expressions.MemberExpression.Member" /> property set to the <see cref="T:System.Reflection.PropertyInfo" /> that represents the property accessed in <paramref name="propertyAccessor" />.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.MemberExpression.Expression" /> property equal to. This can be null for static properties.</param>
         <param name="propertyAccessor">
@@ -10202,7 +10949,6 @@
         <Parameter Name="property" Type="System.Reflection.PropertyInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of the resulting <see cref="T:System.Linq.Expressions.MemberExpression" /> is equal to the <see cref="P:System.Reflection.PropertyInfo.PropertyType" /> property of <see cref="P:System.Linq.Expressions.MemberExpression.Member" />.</para>
@@ -10212,6 +10958,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MemberExpression" /> that represents accessing a property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MemberExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.MemberAccess" /> and the <see cref="P:System.Linq.Expressions.MemberExpression.Expression" /> and <see cref="P:System.Linq.Expressions.MemberExpression.Member" /> properties set to the specified values.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.MemberExpression.Expression" /> property equal to. This can be null for static properties.</param>
         <param name="property">
@@ -10234,7 +10984,6 @@
         <Parameter Name="propertyName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of the resulting <see cref="T:System.Linq.Expressions.MemberExpression" /> is equal to the <see cref="P:System.Reflection.PropertyInfo.PropertyType" /> property of the <see cref="T:System.Reflection.PropertyInfo" /> that represents the property denoted by <paramref name="propertyName" />.</para>
@@ -10244,6 +10993,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MemberExpression" /> that represents accessing a property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MemberExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.MemberAccess" />, the <see cref="P:System.Linq.Expressions.MemberExpression.Expression" /> property set to <paramref name="expression" />, and the <see cref="P:System.Linq.Expressions.MemberExpression.Member" /> property set to the <see cref="T:System.Reflection.PropertyInfo" /> that represents the property denoted by <paramref name="propertyName" />.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> whose <see cref="P:System.Linq.Expressions.Expression.Type" /> contains a property named <paramref name="propertyName" />. This can be null for static properties.</param>
         <param name="propertyName">
@@ -10266,12 +11019,15 @@
         <Parameter Name="arguments" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.Expression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Linq.Expressions.IndexExpression" /> representing the access to an indexed property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.IndexExpression" />.</para>
+        </returns>
         <param name="instance">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to which the property belongs. If the property is static/shared, it must be null.</param>
         <param name="indexer">
@@ -10302,12 +11058,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Linq.Expressions.IndexExpression" /> representing the access to an indexed property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.IndexExpression" />.</para>
+        </returns>
         <param name="instance">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to which the property belongs. If the property is static/shared, it must be null.</param>
         <param name="indexer">
@@ -10338,12 +11097,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Linq.Expressions.IndexExpression" /> representing the access to an indexed property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.IndexExpression" />.</para>
+        </returns>
         <param name="instance">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to which the property belongs. If the property is static/shared, it must be null.</param>
         <param name="propertyName">
@@ -10368,12 +11130,15 @@
         <Parameter Name="propertyName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MemberExpression" /> accessing a property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.MemberExpression" />.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />The containing object of the property. This can be null for static properties.</param>
         <param name="type">
@@ -10398,7 +11163,6 @@
         <Parameter Name="propertyOrFieldName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of the resulting <see cref="T:System.Linq.Expressions.MemberExpression" /> is equal to the <see cref="P:System.Reflection.PropertyInfo.PropertyType" /> or <see cref="P:System.Reflection.FieldInfo.FieldType" /> properties of the <see cref="T:System.Reflection.PropertyInfo" /> or <see cref="T:System.Reflection.FieldInfo" />, respectively, that represents the property or field denoted by <paramref name="propertyOrFieldName" />.</para>
@@ -10408,6 +11172,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.MemberExpression" /> that represents accessing a property or field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.MemberExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.MemberAccess" />, the <see cref="P:System.Linq.Expressions.MemberExpression.Expression" /> property set to <paramref name="expression" />, and the <see cref="P:System.Linq.Expressions.MemberExpression.Member" /> property set to the <see cref="T:System.Reflection.PropertyInfo" /> or <see cref="T:System.Reflection.FieldInfo" /> that represents the property or field denoted by <paramref name="propertyOrFieldName" />.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> whose <see cref="P:System.Linq.Expressions.Expression.Type" /> contains a property or field named <paramref name="propertyOrFieldName" />. This can be null for static members.</param>
         <param name="propertyOrFieldName">
@@ -10429,7 +11197,6 @@
         <Parameter Name="expression" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of the resulting <see cref="T:System.Linq.Expressions.UnaryExpression" /> represents the constructed type <see cref="T:System.Linq.Expressions.Expression`1" />, where the type argument is the type represented by <paramref name="expression" />.Type. The <see cref="P:System.Linq.Expressions.UnaryExpression.Method" /> property is null. Both <see cref="P:System.Linq.Expressions.UnaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.UnaryExpression.IsLiftedToNull" /> are false.</para>
@@ -10438,6 +11205,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents an expression that has a constant value of type <see cref="T:System.Linq.Expressions.Expression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Quote" /> and the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" /> property set to the specified value.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" /> property equal to.</param>
       </Docs>
@@ -10454,12 +11225,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reduces this node to a simpler expression. If CanReduce returns true, this should return a valid expression. This method can return another node which itself must be reduced.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The reduced expression.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReduceAndCheck">
@@ -10474,7 +11248,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Unlike Reduce, this method checks that the reduced node satisfies certain invariants.</para>
@@ -10483,6 +11256,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reduces this node to a simpler expression. If CanReduce returns true, this should return a valid expression. This method can return another node which itself must be reduced.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The reduced expression.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReduceExtensions">
@@ -10497,12 +11274,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reduces the expression to a known node type (that is not an Extension node) or just returns the expression if it is already a known type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The reduced expression.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReferenceEqual">
@@ -10520,12 +11300,15 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a reference equality comparison.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Equal" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -10547,12 +11330,15 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a reference inequality comparison.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.NotEqual" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -10571,12 +11357,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents a rethrowing of an exception.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents a rethrowing of an exception.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Rethrow">
@@ -10593,12 +11382,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents a rethrowing of an exception with a given type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents a rethrowing of an exception.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The new <see cref="T:System.Type" /> of the expression.</param>
       </Docs>
@@ -10617,12 +11409,15 @@
         <Parameter Name="target" Type="System.Linq.Expressions.LabelTarget" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.GotoExpression" /> representing a return statement.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.GotoExpression" /> with <see cref="P:System.Linq.Expressions.GotoExpression.Kind" /> equal to Return, the <see cref="P:System.Linq.Expressions.GotoExpression.Target" /> property set to <paramref name="target" />, and a null value to be passed to the target label upon jumping.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.Expressions.LabelTarget" /> that the <see cref="T:System.Linq.Expressions.GotoExpression" /> will jump to.</param>
       </Docs>
@@ -10642,12 +11437,15 @@
         <Parameter Name="value" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.GotoExpression" /> representing a return statement. The value passed to the label upon jumping can be specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.GotoExpression" /> with <see cref="P:System.Linq.Expressions.GotoExpression.Kind" /> equal to Continue, the <see cref="P:System.Linq.Expressions.GotoExpression.Target" /> property set to <paramref name="target" />, and <paramref name="value" /> to be passed to the target label upon jumping.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.Expressions.LabelTarget" /> that the <see cref="T:System.Linq.Expressions.GotoExpression" /> will jump to.</param>
         <param name="value">
@@ -10669,12 +11467,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.GotoExpression" /> representing a return statement with the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.GotoExpression" /> with <see cref="P:System.Linq.Expressions.GotoExpression.Kind" /> equal to Return, the <see cref="P:System.Linq.Expressions.GotoExpression.Target" /> property set to <paramref name="target" />, the <see cref="P:System.Linq.Expressions.Expression.Type" /> property set to <paramref name="type" />, and a null value to be passed to the target label upon jumping.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.Expressions.LabelTarget" /> that the <see cref="T:System.Linq.Expressions.GotoExpression" /> will jump to.</param>
         <param name="type">
@@ -10697,12 +11498,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.GotoExpression" /> representing a return statement with the specified type. The value passed to the label upon jumping can be specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.GotoExpression" /> with <see cref="P:System.Linq.Expressions.GotoExpression.Kind" /> equal to Continue, the <see cref="P:System.Linq.Expressions.GotoExpression.Target" /> property set to <paramref name="target" />, the <see cref="P:System.Linq.Expressions.Expression.Type" /> property set to <paramref name="type" />, and <paramref name="value" /> to be passed to the target label upon jumping.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.Expressions.LabelTarget" /> that the <see cref="T:System.Linq.Expressions.GotoExpression" /> will jump to.</param>
         <param name="value">
@@ -10727,7 +11531,6 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -10779,6 +11582,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a bitwise right-shift operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.RightShift" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -10802,7 +11609,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -10857,6 +11663,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a bitwise right-shift operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.RightShift" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -10880,12 +11690,15 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a bitwise right-shift assignment operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.RightShiftAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -10908,12 +11721,15 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a bitwise right-shift assignment operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.RightShiftAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -10939,12 +11755,15 @@
         <Parameter Name="conversion" Type="System.Linq.Expressions.LambdaExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a bitwise right-shift assignment operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.RightShiftAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Method" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -10969,12 +11788,15 @@
         <Parameter Name="variables" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.ParameterExpression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Linq.Expressions.RuntimeVariablesExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Linq.Expressions.RuntimeVariablesExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.RuntimeVariables" /> and the <see cref="P:System.Linq.Expressions.RuntimeVariablesExpression.Variables" /> property set to the specified value.</para>
+        </returns>
         <param name="variables">
           <attribution license="cc4" from="Microsoft" modified="false" />A collection of <see cref="T:System.Linq.Expressions.ParameterExpression" /> objects to use to populate the <see cref="P:System.Linq.Expressions.RuntimeVariablesExpression.Variables" /> collection.</param>
       </Docs>
@@ -10999,12 +11821,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Linq.Expressions.RuntimeVariablesExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Linq.Expressions.RuntimeVariablesExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.RuntimeVariables" /> and the <see cref="P:System.Linq.Expressions.RuntimeVariablesExpression.Variables" /> property set to the specified value.</para>
+        </returns>
         <param name="variables">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Linq.Expressions.ParameterExpression" /> objects to use to populate the <see cref="P:System.Linq.Expressions.RuntimeVariablesExpression.Variables" /> collection.</param>
       </Docs>
@@ -11025,7 +11850,6 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -11077,6 +11901,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents an arithmetic subtraction operation that does not have overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Subtract" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -11100,7 +11928,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -11155,6 +11982,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents an arithmetic subtraction operation that does not have overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.Subtract" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -11178,12 +12009,15 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a subtraction assignment operation that does not have overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.SubtractAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -11206,12 +12040,15 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a subtraction assignment operation that does not have overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.SubtractAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -11237,12 +12074,15 @@
         <Parameter Name="conversion" Type="System.Linq.Expressions.LambdaExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a subtraction assignment operation that does not have overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.SubtractAssign" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Method" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -11268,12 +12108,15 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a subtraction assignment operation that has overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.SubtractAssignChecked" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -11296,12 +12139,15 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a subtraction assignment operation that has overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.SubtractAssignChecked" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -11327,12 +12173,15 @@
         <Parameter Name="conversion" Type="System.Linq.Expressions.LambdaExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents a subtraction assignment operation that has overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.SubtractAssignChecked" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Method" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -11359,7 +12208,6 @@
         <Parameter Name="right" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -11411,6 +12259,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents an arithmetic subtraction operation that has overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.SubtractChecked" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.Right" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -11434,7 +12286,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting <see cref="T:System.Linq.Expressions.BinaryExpression" /> has the <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> property set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false. The <see cref="P:System.Linq.Expressions.BinaryExpression.Conversion" /> property is null.</para>
@@ -11489,6 +12340,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.BinaryExpression" /> that represents an arithmetic subtraction operation that has overflow checking.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.BinaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.SubtractChecked" /> and the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" />, <see cref="P:System.Linq.Expressions.BinaryExpression.Right" />, and <see cref="P:System.Linq.Expressions.BinaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.BinaryExpression.Left" /> property equal to.</param>
         <param name="right">
@@ -11518,7 +12373,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>All <see cref="T:System.Linq.Expressions.SwitchCase" /> objects in a <see cref="T:System.Linq.Expressions.SwitchExpression" /> object must have the same type, unless the <see cref="T:System.Linq.Expressions.SwitchExpression" /> has the type void.</para>
@@ -11529,6 +12383,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.SwitchExpression" /> that represents a switch statement without a default case.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.SwitchExpression" />.</para>
+        </returns>
         <param name="switchValue">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to be tested against each case.</param>
         <param name="cases">
@@ -11557,7 +12415,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>All <see cref="T:System.Linq.Expressions.SwitchCase" /> objects in a <see cref="T:System.Linq.Expressions.SwitchExpression" /> object must have the same type, unless the <see cref="T:System.Linq.Expressions.SwitchExpression" /> has the type void.</para>
@@ -11568,6 +12425,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.SwitchExpression" /> that represents a switch statement that has a default case.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.SwitchExpression" />.</para>
+        </returns>
         <param name="switchValue">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to be tested against each case.</param>
         <param name="defaultBody">
@@ -11593,12 +12454,15 @@
         <Parameter Name="cases" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.SwitchCase&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.SwitchExpression" /> that represents a switch statement that has a default case.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.SwitchExpression" />.</para>
+        </returns>
         <param name="switchValue">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to be tested against each case.</param>
         <param name="defaultBody">
@@ -11632,12 +12496,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.SwitchExpression" /> that represents a switch statement that has a default case.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.SwitchExpression" />.</para>
+        </returns>
         <param name="switchValue">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to be tested against each case.</param>
         <param name="defaultBody">
@@ -11666,12 +12533,15 @@
         <Parameter Name="cases" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.SwitchCase&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.SwitchExpression" /> that represents a switch statement that has a default case.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.SwitchExpression" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The result type of the switch.</param>
         <param name="switchValue">
@@ -11708,12 +12578,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.SwitchExpression" /> that represents a switch statement that has a default case..</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.SwitchExpression" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The result type of the switch.</param>
         <param name="switchValue">
@@ -11741,7 +12614,6 @@
         <Parameter Name="testValues" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.Expression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>All <see cref="T:System.Linq.Expressions.SwitchCase" /> objects in a <see cref="T:System.Linq.Expressions.SwitchExpression" /> object must have the same type, unless the <see cref="T:System.Linq.Expressions.SwitchExpression" /> has the type void.</para>
@@ -11751,6 +12623,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.SwitchCase" /> object to be used in a <see cref="T:System.Linq.Expressions.SwitchExpression" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.SwitchCase" />.</para>
+        </returns>
         <param name="body">
           <attribution license="cc4" from="Microsoft" modified="false" />The body of the case.</param>
         <param name="testValues">
@@ -11778,12 +12654,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.SwitchCase" /> for use in a <see cref="T:System.Linq.Expressions.SwitchExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.SwitchCase" />.</para>
+        </returns>
         <param name="body">
           <attribution license="cc4" from="Microsoft" modified="false" />The body of the case.</param>
         <param name="testValues">
@@ -11804,12 +12683,15 @@
         <Parameter Name="fileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Linq.Expressions.SymbolDocumentInfo" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.SymbolDocumentInfo" /> that has the <see cref="P:System.Linq.Expressions.SymbolDocumentInfo.FileName" /> property set to the specified value.</para>
+        </returns>
         <param name="fileName">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> to set the <see cref="P:System.Linq.Expressions.SymbolDocumentInfo.FileName" /> equal to.</param>
       </Docs>
@@ -11829,12 +12711,15 @@
         <Parameter Name="language" Type="System.Guid" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Linq.Expressions.SymbolDocumentInfo" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.SymbolDocumentInfo" /> that has the <see cref="P:System.Linq.Expressions.SymbolDocumentInfo.FileName" /> and <see cref="P:System.Linq.Expressions.SymbolDocumentInfo.Language" /> properties set to the specified value.</para>
+        </returns>
         <param name="fileName">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> to set the <see cref="P:System.Linq.Expressions.SymbolDocumentInfo.FileName" /> equal to.</param>
         <param name="language">
@@ -11857,12 +12742,15 @@
         <Parameter Name="languageVendor" Type="System.Guid" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Linq.Expressions.SymbolDocumentInfo" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.SymbolDocumentInfo" /> that has the <see cref="P:System.Linq.Expressions.SymbolDocumentInfo.FileName" /> and <see cref="P:System.Linq.Expressions.SymbolDocumentInfo.Language" /> and <see cref="P:System.Linq.Expressions.SymbolDocumentInfo.LanguageVendor" /> properties set to the specified value.</para>
+        </returns>
         <param name="fileName">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> to set the <see cref="P:System.Linq.Expressions.SymbolDocumentInfo.FileName" /> equal to.</param>
         <param name="language">
@@ -11888,12 +12776,15 @@
         <Parameter Name="documentType" Type="System.Guid" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Linq.Expressions.SymbolDocumentInfo" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.SymbolDocumentInfo" /> that has the <see cref="P:System.Linq.Expressions.SymbolDocumentInfo.FileName" /> and <see cref="P:System.Linq.Expressions.SymbolDocumentInfo.Language" /> and <see cref="P:System.Linq.Expressions.SymbolDocumentInfo.LanguageVendor" /> and <see cref="P:System.Linq.Expressions.SymbolDocumentInfo.DocumentType" /> properties set to the specified value.</para>
+        </returns>
         <param name="fileName">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> to set the <see cref="P:System.Linq.Expressions.SymbolDocumentInfo.FileName" /> equal to.</param>
         <param name="language">
@@ -11918,12 +12809,15 @@
         <Parameter Name="value" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents a throwing of an exception.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents the exception.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" />.</param>
       </Docs>
@@ -11943,12 +12837,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents a throwing of an exception with a given type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents the exception.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" />.</param>
         <param name="type">
@@ -11968,12 +12865,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a textual representation of the <see cref="T:System.Linq.Expressions.Expression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A textual representation of the <see cref="T:System.Linq.Expressions.Expression" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryCatch">
@@ -11997,12 +12897,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.TryExpression" /> representing a try block with any number of catch statements and neither a fault nor finally block.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.TryExpression" />.</para>
+        </returns>
         <param name="body">
           <attribution license="cc4" from="Microsoft" modified="false" />The body of the try block.</param>
         <param name="handlers">
@@ -12031,12 +12934,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.TryExpression" /> representing a try block with any number of catch statements and a finally block.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.TryExpression" />.</para>
+        </returns>
         <param name="body">
           <attribution license="cc4" from="Microsoft" modified="false" />The body of the try block.</param>
         <param name="finally">
@@ -12060,12 +12966,15 @@
         <Parameter Name="fault" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.TryExpression" /> representing a try block with a fault block and no catch statements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.TryExpression" />.</para>
+        </returns>
         <param name="body">
           <attribution license="cc4" from="Microsoft" modified="false" />The body of the try block.</param>
         <param name="fault">
@@ -12087,12 +12996,15 @@
         <Parameter Name="finally" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.TryExpression" /> representing a try block with a finally block and no catch statements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Linq.Expressions.TryExpression" />.</para>
+        </returns>
         <param name="body">
           <attribution license="cc4" from="Microsoft" modified="false" />The body of the try block.</param>
         <param name="finally">
@@ -12183,7 +13095,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.UnaryExpression.Method" /> property of the resulting <see cref="T:System.Linq.Expressions.UnaryExpression" /> is null. The <see cref="P:System.Linq.Expressions.UnaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.UnaryExpression.IsLiftedToNull" /> properties are both false.</para>
@@ -12192,6 +13103,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents an explicit reference or boxing conversion where null is supplied if the conversion fails.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.TypeAs" /> and the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" /> and <see cref="P:System.Linq.Expressions.Expression.Type" /> properties set to the specified values.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" /> property equal to.</param>
         <param name="type">
@@ -12213,12 +13128,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.TypeBinaryExpression" /> that compares run-time type identity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.TypeBinaryExpression" /> for which the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property is equal to <see cref="M:System.Linq.Expressions.Expression.TypeEqual(System.Linq.Expressions.Expression,System.Type)" /> and for which the <see cref="T:System.Linq.Expressions.Expression" /> and <see cref="P:System.Linq.Expressions.TypeBinaryExpression.TypeOperand" /> properties are set to the specified values.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="T:System.Linq.Expressions.Expression" /> property equal to.</param>
         <param name="type">
@@ -12241,7 +13159,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.Expression.Type" /> property of the resulting <see cref="T:System.Linq.Expressions.UnaryExpression" /> represents <see cref="T:System.Boolean" />.</para>
@@ -12250,6 +13167,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.TypeBinaryExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.TypeBinaryExpression" /> for which the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property is equal to <see cref="F:System.Linq.Expressions.ExpressionType.TypeIs" /> and for which the <see cref="P:System.Linq.Expressions.TypeBinaryExpression.Expression" /> and <see cref="P:System.Linq.Expressions.TypeBinaryExpression.TypeOperand" /> properties are set to the specified values.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.TypeBinaryExpression.Expression" /> property equal to.</param>
         <param name="type">
@@ -12271,7 +13192,6 @@
         <Parameter Name="expression" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.UnaryExpression.Method" /> property of the resulting <see cref="T:System.Linq.Expressions.UnaryExpression" /> is set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false.</para>
@@ -12314,6 +13234,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents a unary plus operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.UnaryPlus" /> and the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" /> property set to the specified value.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" /> property equal to.</param>
       </Docs>
@@ -12334,7 +13258,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Linq.Expressions.UnaryExpression.Method" /> property of the resulting <see cref="T:System.Linq.Expressions.UnaryExpression" /> is set to the implementing method. The <see cref="P:System.Linq.Expressions.Expression.Type" /> property is set to the type of the node. If the node is lifted, the <see cref="P:System.Linq.Expressions.BinaryExpression.IsLifted" /> and <see cref="P:System.Linq.Expressions.BinaryExpression.IsLiftedToNull" /> properties are both true. Otherwise, they are false.</para>
@@ -12380,6 +13303,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents a unary plus operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.UnaryExpression" /> that has the <see cref="P:System.Linq.Expressions.Expression.NodeType" /> property equal to <see cref="F:System.Linq.Expressions.ExpressionType.UnaryPlus" /> and the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" /> and <see cref="P:System.Linq.Expressions.UnaryExpression.Method" /> properties set to the specified values.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to set the <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" /> property equal to.</param>
         <param name="method">
@@ -12401,12 +13328,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.UnaryExpression" /> that represents an explicit unboxing.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Linq.Expressions.UnaryExpression" />.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.Expressions.Expression" /> to unbox.</param>
         <param name="type">
@@ -12427,12 +13357,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.ParameterExpression" /> node that can be used to identify a parameter or a variable in an expression tree.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.ParameterExpression" /> node with the specified name and type</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the parameter or variable.</param>
       </Docs>
@@ -12452,12 +13385,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Expressions.ParameterExpression" /> node that can be used to identify a parameter or a variable in an expression tree.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Expressions.ParameterExpression" /> node with the specified name and type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the parameter or variable.</param>
         <param name="name">
@@ -12478,7 +13414,6 @@
         <Parameter Name="visitor" Type="System.Linq.Expressions.ExpressionVisitor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Override this method to provide logic to walk the node's children. A typical implementation will call visitor.Visit on each of its children, and if any of them change, should return a new copy of itself with the modified children.</para>
@@ -12487,6 +13422,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reduces the node and then calls the visitor delegate on the reduced expression. The method throws an exception if the node is not reducible.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The expression being visited, or an expression which should replace it in the tree.</para>
+        </returns>
         <param name="visitor">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of <see cref="T:System.Func`2" />.</param>
       </Docs>
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/ExpressionVisitor.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/ExpressionVisitor.xml
index e61ed2b4d30..9f78a9f33c6 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/ExpressionVisitor.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/ExpressionVisitor.xml
@@ -51,12 +51,15 @@
         <Parameter Name="nodes" Type="System.Collections.ObjectModel.ReadOnlyCollection&lt;System.Linq.Expressions.Expression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Dispatches the list of expressions to one of the more specialized visit methods in this class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression list, if any one of the elements were modified; otherwise, returns the original expression list.</para>
+        </returns>
         <param name="nodes">
           <attribution license="cc4" from="Microsoft" modified="false" />The expressions to visit.</param>
       </Docs>
@@ -75,12 +78,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Dispatches the expression to one of the more specialized visit methods in this class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -103,12 +109,15 @@
         <Parameter Name="elementVisitor" Type="System.Func&lt;T,T&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits all nodes in the collection using a specified element visitor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified node list, if any of the elements were modified; otherwise, returns the original node list.</para>
+        </returns>
         <param name="nodes">
           <attribution license="cc4" from="Microsoft" modified="false" />The nodes to visit.</param>
         <param name="elementVisitor">
@@ -139,12 +148,15 @@
         <Parameter Name="callerName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits an expression, casting the result back to the original expression type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="nodes">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
         <param name="callerName">
@@ -197,12 +209,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.BinaryExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the children of the <see cref="T:System.Linq.Expressions.BinaryExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -221,12 +236,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.BlockExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the children of the <see cref="T:System.Linq.Expressions.BlockExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -245,12 +263,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.CatchBlock" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the children of the <see cref="T:System.Linq.Expressions.CatchBlock" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -269,12 +290,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.ConditionalExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the children of the <see cref="T:System.Linq.Expressions.ConditionalExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -293,12 +317,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.ConstantExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the <see cref="T:System.Linq.Expressions.ConstantExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -317,12 +344,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.DebugInfoExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the <see cref="T:System.Linq.Expressions.DebugInfoExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -341,12 +371,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.DefaultExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the <see cref="T:System.Linq.Expressions.DefaultExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -365,12 +398,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.DynamicExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the children of the <see cref="T:System.Linq.Expressions.DynamicExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -389,12 +425,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.ElementInit" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the children of the <see cref="T:System.Linq.Expressions.ElementInit" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -413,7 +452,6 @@
         <Parameter Name="node" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This can be overridden to visit or rewrite specific extension nodes.</para>
@@ -423,6 +461,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the children of the extension expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -441,12 +483,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.GotoExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the children of the <see cref="T:System.Linq.Expressions.GotoExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -465,12 +510,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.IndexExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the children of the <see cref="T:System.Linq.Expressions.IndexExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -489,12 +537,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.InvocationExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the children of the <see cref="T:System.Linq.Expressions.InvocationExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -513,12 +564,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.LabelExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the children of the <see cref="T:System.Linq.Expressions.LabelExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -537,12 +591,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.LabelTarget" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the <see cref="T:System.Linq.Expressions.LabelTarget" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -564,12 +621,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.Expression&lt;T&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the children of the <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
         <typeparam name="T">
@@ -590,12 +650,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.ListInitExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the children of the <see cref="T:System.Linq.Expressions.ListInitExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -614,12 +677,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.LoopExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the children of the <see cref="T:System.Linq.Expressions.LoopExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -638,12 +704,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.MemberExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the children of the <see cref="T:System.Linq.Expressions.MemberExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -662,12 +731,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.MemberAssignment" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the children of the <see cref="T:System.Linq.Expressions.MemberAssignment" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -686,12 +758,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.MemberBinding" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the children of the <see cref="T:System.Linq.Expressions.MemberBinding" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -710,12 +785,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.MemberInitExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the children of the <see cref="T:System.Linq.Expressions.MemberInitExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -734,12 +812,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.MemberListBinding" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the children of the <see cref="T:System.Linq.Expressions.MemberListBinding" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -758,12 +839,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.MemberMemberBinding" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the children of the <see cref="T:System.Linq.Expressions.MemberMemberBinding" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -782,12 +866,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.MethodCallExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the children of the <see cref="T:System.Linq.Expressions.MethodCallExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -806,12 +893,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.NewExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the children of the <see cref="T:System.Linq.Expressions.NewExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -830,12 +920,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.NewArrayExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the children of the <see cref="T:System.Linq.Expressions.NewArrayExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -854,12 +947,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.ParameterExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the <see cref="T:System.Linq.Expressions.ParameterExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -878,12 +974,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.RuntimeVariablesExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the children of the <see cref="T:System.Linq.Expressions.RuntimeVariablesExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -902,12 +1001,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.SwitchExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the children of the <see cref="T:System.Linq.Expressions.SwitchExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -926,12 +1028,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.SwitchCase" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the children of the <see cref="T:System.Linq.Expressions.SwitchCase" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -950,12 +1055,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.TryExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the children of the <see cref="T:System.Linq.Expressions.TryExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -974,12 +1082,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.TypeBinaryExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the children of the <see cref="T:System.Linq.Expressions.TypeBinaryExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
@@ -998,12 +1109,15 @@
         <Parameter Name="node" Type="System.Linq.Expressions.UnaryExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visits the children of the <see cref="T:System.Linq.Expressions.UnaryExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified expression, if it or any subexpression was modified; otherwise, returns the original expression.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to visit.</param>
       </Docs>
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/Expression`1.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/Expression`1.xml
index ac43e052287..8efd7a94648 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/Expression`1.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/Expression`1.xml
@@ -67,7 +67,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Expressions.Expression`1.Compile" /> method produces a delegate of type <paramref name="TDelegate" /> at runtime. When that delegate is executed, it has the behavior described by the semantics of the <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -78,6 +77,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compiles the lambda expression described by the expression tree into executable code and produces a delegate that represents the lambda expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A delegate of type <paramref name="TDelegate" /> that represents the compiled lambda expression described by the <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Compile">
@@ -94,12 +97,15 @@
         <Parameter Name="debugInfoGenerator" Type="System.Runtime.CompilerServices.DebugInfoGenerator" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces a delegate that represents the lambda expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A delegate containing the compiled version of the lambda.</para>
+        </returns>
         <param name="debugInfoGenerator">
           <attribution license="cc4" from="Microsoft" modified="false" />Debugging information generator used by the compiler to mark sequence points and annotate local variables.</param>
       </Docs>
@@ -119,12 +125,15 @@
         <Parameter Name="parameters" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.ParameterExpression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new expression that is like this one, but using the supplied children. If all of the children are the same, it will return this expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This expression if no children are changed or an expression with the updated children.</para>
+        </returns>
         <param name="body">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.LambdaExpression.Body" /> property of the result.</param>
         <param name="parameters">
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/GotoExpression.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/GotoExpression.xml
index d2565639f8c..84e92ee4517 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/GotoExpression.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/GotoExpression.xml
@@ -134,12 +134,15 @@
         <Parameter Name="value" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new expression that is like this one, but using the supplied children. If all of the children are the same, it will return this expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This expression if no children are changed or an expression with the updated children.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.GotoExpression.Target" /> property of the result. </param>
         <param name="value">
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/IndexExpression.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/IndexExpression.xml
index eec96ebe3cf..8103e9b1407 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/IndexExpression.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/IndexExpression.xml
@@ -193,12 +193,15 @@
         <Parameter Name="arguments" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.Expression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new expression that is like this one, but using the supplied children. If all of the children are the same, it will return this expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This expression if no children are changed or an expression with the updated children.</para>
+        </returns>
         <param name="object">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.IndexExpression.Object" /> property of the result.</param>
         <param name="arguments">
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/InvocationExpression.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/InvocationExpression.xml
index 6800342a8e9..eb15be3b0bc 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/InvocationExpression.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/InvocationExpression.xml
@@ -181,12 +181,15 @@
         <Parameter Name="arguments" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.Expression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new expression that is like this one, but using the supplied children. If all of the children are the same, it will return this expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This expression if no children are changed or an expression with the updated children.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.InvocationExpression.Expression" /> property of the result.</param>
         <param name="arguments">
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/LabelExpression.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/LabelExpression.xml
index 5c18555905a..59753081ce5 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/LabelExpression.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/LabelExpression.xml
@@ -134,12 +134,15 @@
         <Parameter Name="defaultValue" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new expression that is like this one, but using the supplied children. If all of the children are the same, it will return this expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This expression if no children are changed or an expression with the updated children.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.LabelExpression.Target" /> property of the result.</param>
         <param name="defaultValue">
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/LabelTarget.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/LabelTarget.xml
index 096249bb09d..54224e684c7 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/LabelTarget.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/LabelTarget.xml
@@ -52,12 +52,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.String" /> that represents the current <see cref="T:System.Object" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that represents the current <see cref="T:System.Object" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Type">
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/LambdaExpression.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/LambdaExpression.xml
index 949982efa02..643980f1c50 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/LambdaExpression.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/LambdaExpression.xml
@@ -62,7 +62,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Expressions.LambdaExpression.Compile" /> method can be used to convert a <see cref="T:System.Linq.Expressions.LambdaExpression" /> expression tree into the delegate that it represents.</para>
@@ -71,6 +70,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces a delegate that represents the lambda expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Delegate" /> that contains the compiled version of the lambda expression.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Compile">
@@ -87,12 +90,15 @@
         <Parameter Name="debugInfoGenerator" Type="System.Runtime.CompilerServices.DebugInfoGenerator" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces a delegate that represents the lambda expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A delegate containing the compiled version of the lambda.</para>
+        </returns>
         <param name="debugInfoGenerator">
           <attribution license="cc4" from="Microsoft" modified="false" />Debugging information generator used by the compiler to mark sequence points and annotate local variables.</param>
       </Docs>
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/ListInitExpression.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/ListInitExpression.xml
index f276cf984fa..72247627911 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/ListInitExpression.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/ListInitExpression.xml
@@ -138,7 +138,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the CanReduce method returns true, this method should return a valid expression.</para>
@@ -148,6 +147,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reduces the binary expression node to a simpler expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The reduced expression.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Type">
@@ -184,12 +187,15 @@
         <Parameter Name="initializers" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.ElementInit&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new expression that is like this one, but using the supplied children. If all of the children are the same, it will return this expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This expression if no children are changed or an expression with the updated children.</para>
+        </returns>
         <param name="newExpression">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.ListInitExpression.NewExpression" /> property of the result.</param>
         <param name="initializers">
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/LoopExpression.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/LoopExpression.xml
index 8eefaafa61e..17897cbff40 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/LoopExpression.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/LoopExpression.xml
@@ -154,12 +154,15 @@
         <Parameter Name="body" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new expression that is like this one, but using the supplied children. If all of the children are the same, it will return this expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This expression if no children are changed or an expression with the updated children.</para>
+        </returns>
         <param name="breakLabel">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.LoopExpression.BreakLabel" /> property of the result.</param>
         <param name="continueLabel">
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/MemberAssignment.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/MemberAssignment.xml
index 4f4780dfe9a..9852711e290 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/MemberAssignment.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/MemberAssignment.xml
@@ -57,12 +57,15 @@
         <Parameter Name="expression" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new expression that is like this one, but using the supplied children. If all of the children are the same, it will return this expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This expression if no children are changed or an expression with the updated children.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.MemberAssignment.Expression" /> property of the result.</param>
       </Docs>
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/MemberBinding.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/MemberBinding.xml
index d5b075f883f..097bc4e06e5 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/MemberBinding.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/MemberBinding.xml
@@ -101,12 +101,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a textual representation of the <see cref="T:System.Linq.Expressions.MemberBinding" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A textual representation of the <see cref="T:System.Linq.Expressions.MemberBinding" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/MemberExpression.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/MemberExpression.xml
index db2b7420375..a8aa595cf16 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/MemberExpression.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/MemberExpression.xml
@@ -42,7 +42,6 @@
         <Parameter Name="visitor" Type="System.Linq.Expressions.ExpressionVisitor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This default implementation for <see cref="F:System.Linq.Expressions.ExpressionType.Extension" /> nodes calls <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitExtension(System.Linq.Expressions.Expression)" />. Override this method to call into a more specific method on a derived visitor class of the <see cref="T:System.Linq.Expressions.ExpressionVisitor" /> class. However, it should still support unknown visitors by calling <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitExtension(System.Linq.Expressions.Expression)" />. </para>
@@ -51,6 +50,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Dispatches to the specific visit method for this node type. For example, <see cref="T:System.Linq.Expressions.MethodCallExpression" /> calls the <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitMethodCall(System.Linq.Expressions.MethodCallExpression)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of visiting this node.</para>
+        </returns>
         <param name="visitor">
           <attribution license="cc4" from="Microsoft" modified="false" />The visitor to visit this node with.</param>
       </Docs>
@@ -128,12 +131,15 @@
         <Parameter Name="expression" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new expression that is like this one, but using the supplied children. If all of the children are the same, it will return this expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This expression if no children are changed or an expression with the updated children.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.MemberExpression.Expression" /> property of the result.</param>
       </Docs>
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/MemberInitExpression.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/MemberInitExpression.xml
index 5d86739c9bd..0eed6e4551a 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/MemberInitExpression.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/MemberInitExpression.xml
@@ -138,7 +138,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the CanReduce method returns true, this method should return a valid expression.</para>
@@ -148,6 +147,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reduces the <see cref="T:System.Linq.Expressions.MemberInitExpression" /> to a simpler expression. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The reduced expression.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Type">
@@ -184,12 +187,15 @@
         <Parameter Name="bindings" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.MemberBinding&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new expression that is like this one, but using the supplied children. If all of the children are the same, it will return this expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This expression if no children are changed or an expression with the updated children.</para>
+        </returns>
         <param name="newExpression">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.MemberInitExpression.NewExpression" /> property of the result.</param>
         <param name="bindings">
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/MemberListBinding.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/MemberListBinding.xml
index 43085a3fc6a..289f854c5a4 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/MemberListBinding.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/MemberListBinding.xml
@@ -57,12 +57,15 @@
         <Parameter Name="initializers" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.ElementInit&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new expression that is like this one, but using the supplied children. If all of the children are the same, it will return this expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This expression if no children are changed or an expression with the updated children.</para>
+        </returns>
         <param name="initializers">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.MemberListBinding.Initializers" /> property of the result.</param>
       </Docs>
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/MemberMemberBinding.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/MemberMemberBinding.xml
index dd15266c0c9..e76429ec088 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/MemberMemberBinding.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/MemberMemberBinding.xml
@@ -57,12 +57,15 @@
         <Parameter Name="bindings" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.MemberBinding&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new expression that is like this one, but using the supplied children. If all of the children are the same, it will return this expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This expression if no children are changed or an expression with the updated children.</para>
+        </returns>
         <param name="bindings">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.MemberMemberBinding.Bindings" /> property of the result.</param>
       </Docs>
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/MethodCallExpression.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/MethodCallExpression.xml
index 3bc3c4df6c8..a86db68ef84 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/MethodCallExpression.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/MethodCallExpression.xml
@@ -46,7 +46,6 @@
         <Parameter Name="visitor" Type="System.Linq.Expressions.ExpressionVisitor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This default implementation for <see cref="F:System.Linq.Expressions.ExpressionType.Extension" /> nodes calls <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitExtension(System.Linq.Expressions.Expression)" />. Override this method to call into a more specific method on a derived visitor class of the <see cref="T:System.Linq.Expressions.ExpressionVisitor" /> class. However, it should still support unknown visitors by calling <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitExtension(System.Linq.Expressions.Expression)" />. </para>
@@ -55,6 +54,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Dispatches to the specific visit method for this node type. For example, <see cref="T:System.Linq.Expressions.MethodCallExpression" /> calls the <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitMethodCall(System.Linq.Expressions.MethodCallExpression)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of visiting this node.</para>
+        </returns>
         <param name="visitor">
           <attribution license="cc4" from="Microsoft" modified="false" />The visitor to visit this node with.</param>
       </Docs>
@@ -211,12 +214,15 @@
         <Parameter Name="arguments" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.Expression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new expression that is like this one, but using the supplied children. If all of the children are the same, it will return this expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This expression if no children are changed or an expression with the updated children.</para>
+        </returns>
         <param name="object">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.MethodCallExpression.Object" /> property of the result.</param>
         <param name="arguments">
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/NewArrayExpression.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/NewArrayExpression.xml
index db2a397565c..da055637d28 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/NewArrayExpression.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/NewArrayExpression.xml
@@ -79,7 +79,6 @@
         <Parameter Name="visitor" Type="System.Linq.Expressions.ExpressionVisitor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This default implementation for <see cref="F:System.Linq.Expressions.ExpressionType.Extension" /> nodes calls <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitExtension(System.Linq.Expressions.Expression)" />. Override this method to call into a more specific method on a derived visitor class of the <see cref="T:System.Linq.Expressions.ExpressionVisitor" /> class. However, it should still support unknown visitors by calling <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitExtension(System.Linq.Expressions.Expression)" />. </para>
@@ -88,6 +87,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Dispatches to the specific visit method for this node type. For example, <see cref="T:System.Linq.Expressions.MethodCallExpression" /> calls the <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitMethodCall(System.Linq.Expressions.MethodCallExpression)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of visiting this node.</para>
+        </returns>
         <param name="visitor">
           <attribution license="cc4" from="Microsoft" modified="false" />The visitor to visit this node with.</param>
       </Docs>
@@ -145,12 +148,15 @@
         <Parameter Name="expressions" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.Expression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new expression that is like this one, but using the supplied children. If all of the children are the same, it will return this expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This expression if no children are changed or an expression with the updated children.</para>
+        </returns>
         <param name="expressions">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.NewArrayExpression.Expressions" /> property of the result.</param>
       </Docs>
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/NewExpression.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/NewExpression.xml
index 68762fce349..f96509702df 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/NewExpression.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/NewExpression.xml
@@ -46,7 +46,6 @@
         <Parameter Name="visitor" Type="System.Linq.Expressions.ExpressionVisitor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This default implementation for <see cref="F:System.Linq.Expressions.ExpressionType.Extension" /> nodes calls <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitExtension(System.Linq.Expressions.Expression)" />. Override this method to call into a more specific method on a derived visitor class of the <see cref="T:System.Linq.Expressions.ExpressionVisitor" /> class. However, it should still support unknown visitors by calling <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitExtension(System.Linq.Expressions.Expression)" />. </para>
@@ -55,6 +54,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Dispatches to the specific visit method for this node type. For example, <see cref="T:System.Linq.Expressions.MethodCallExpression" /> calls the <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitMethodCall(System.Linq.Expressions.MethodCallExpression)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of visiting this node.</para>
+        </returns>
         <param name="visitor">
           <attribution license="cc4" from="Microsoft" modified="false" />The visitor to visit this node with.</param>
       </Docs>
@@ -213,12 +216,15 @@
         <Parameter Name="arguments" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.Expression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new expression that is like this one, but using the supplied children. If all of the children are the same, it will return this expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This expression if no children are changed or an expression with the updated children.</para>
+        </returns>
         <param name="arguments">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.NewExpression.Arguments" /> property of the result.</param>
       </Docs>
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/ParameterExpression.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/ParameterExpression.xml
index 3f84475142b..c17fa48cb5e 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/ParameterExpression.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/ParameterExpression.xml
@@ -42,7 +42,6 @@
         <Parameter Name="visitor" Type="System.Linq.Expressions.ExpressionVisitor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This default implementation for <see cref="F:System.Linq.Expressions.ExpressionType.Extension" /> nodes calls <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitExtension(System.Linq.Expressions.Expression)" />. Override this method to call into a more specific method on a derived visitor class of the <see cref="T:System.Linq.Expressions.ExpressionVisitor" /> class. However, it should still support unknown visitors by calling <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitExtension(System.Linq.Expressions.Expression)" />. </para>
@@ -51,6 +50,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Dispatches to the specific visit method for this node type. For example, <see cref="T:System.Linq.Expressions.MethodCallExpression" /> calls the <see cref="M:System.Linq.Expressions.ExpressionVisitor.VisitMethodCall(System.Linq.Expressions.MethodCallExpression)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of visiting this node.</para>
+        </returns>
         <param name="visitor">
           <attribution license="cc4" from="Microsoft" modified="false" />The visitor to visit this node with.</param>
       </Docs>
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/RuntimeVariablesExpression.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/RuntimeVariablesExpression.xml
index c8feba29fa9..7f1d58bfdc8 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/RuntimeVariablesExpression.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/RuntimeVariablesExpression.xml
@@ -98,12 +98,15 @@
         <Parameter Name="variables" Type="System.Collections.Generic.IEnumerable&lt;System.Linq.Expressions.ParameterExpression&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new expression that is like this one, but using the supplied children. If all of the children are the same, it will return this expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This expression if no children are changed or an expression with the updated children.</para>
+        </returns>
         <param name="variables">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.RuntimeVariablesExpression.Variables" /> property of the result.</param>
       </Docs>
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/SwitchCase.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/SwitchCase.xml
index 81fcff83a3a..62a1751075f 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/SwitchCase.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/SwitchCase.xml
@@ -73,12 +73,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.String" /> that represents the current <see cref="T:System.Object" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that represents the current <see cref="T:System.Object" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Update">
@@ -96,12 +99,15 @@
         <Parameter Name="body" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new expression that is like this one, but using the supplied children. If all of the children are the same, it will return this expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This expression if no children are changed or an expression with the updated children.</para>
+        </returns>
         <param name="testValues">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.SwitchCase.TestValues" /> property of the result.</param>
         <param name="body">
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/SwitchExpression.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/SwitchExpression.xml
index 2417f34ae63..a1a84eeb959 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/SwitchExpression.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/SwitchExpression.xml
@@ -173,12 +173,15 @@
         <Parameter Name="defaultBody" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new expression that is like this one, but using the supplied children. If all of the children are the same, it will return this expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This expression if no children are changed or an expression with the updated children.</para>
+        </returns>
         <param name="switchValue">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.SwitchExpression.SwitchValue" /> property of the result.</param>
         <param name="cases">
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/TryExpression.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/TryExpression.xml
index 20a8a8c2f56..0bfb41b41d9 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/TryExpression.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/TryExpression.xml
@@ -182,12 +182,15 @@
         <Parameter Name="fault" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new expression that is like this one, but using the supplied children. If all of the children are the same, it will return this expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This expression if no children are changed or an expression with the updated children.</para>
+        </returns>
         <param name="body">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.TryExpression.Body" /> property of the result.</param>
         <param name="handlers">
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/TypeBinaryExpression.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/TypeBinaryExpression.xml
index 12bd74c1813..a83a0bb030e 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/TypeBinaryExpression.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/TypeBinaryExpression.xml
@@ -141,12 +141,15 @@
         <Parameter Name="expression" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new expression that is like this one, but using the supplied children. If all of the children are the same, it will return this expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This expression if no children are changed or an expression with the updated children.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.TypeBinaryExpression.Expression" /> property of the result.</param>
       </Docs>
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/UnaryExpression.xml b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/UnaryExpression.xml
index b653e389db5..7f2887e2d95 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/UnaryExpression.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq.Expressions/UnaryExpression.xml
@@ -306,7 +306,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the CanReduce method returns true, this should return a valid expression.</para>
@@ -316,6 +315,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reduces the expression node to a simpler expression. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The reduced expression.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Type">
@@ -351,12 +354,15 @@
         <Parameter Name="operand" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new expression that is like this one, but using the supplied children. If all of the children are the same, it will return this expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This expression if no children are changed or an expression with the updated children.</para>
+        </returns>
         <param name="operand">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Linq.Expressions.UnaryExpression.Operand" /> property of the result.</param>
       </Docs>
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq/Enumerable.xml b/mcs/class/System.Core/Documentation/en/System.Linq/Enumerable.xml
index 45897fd5b3a..8a310834196 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq/Enumerable.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq/Enumerable.xml
@@ -43,7 +43,6 @@
         <Parameter Name="func" Type="System.Func&lt;TSource,TSource,TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Aggregate``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,``0,``0})" /> method makes it simple to perform a calculation over a sequence of values. This method works by calling <paramref name="func" /> one time for each element in <paramref name="source" /> except the first one. Each time <paramref name="func" /> is called, <see cref="M:System.Linq.Enumerable.Aggregate``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,``0,``0})" /> passes both the element from the sequence and an aggregated value (as the first argument to <paramref name="func" />). The first element of <paramref name="source" /> is used as the initial aggregate value. The result of <paramref name="func" /> replaces the previous aggregated value. <see cref="M:System.Linq.Enumerable.Aggregate``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,``0,``0})" /> returns the final result of <paramref name="func" />.</para>
@@ -54,6 +53,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Applies an accumulator function over a sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The final accumulator value.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to aggregate over.</param>
         <param name="func">
@@ -83,7 +86,6 @@
         <Parameter Name="func" Type="System.Func&lt;TAccumulate,TSource,TAccumulate&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Aggregate``2(System.Collections.Generic.IEnumerable{``0},``1,System.Func{``1,``0,``1})" /> method makes it simple to perform a calculation over a sequence of values. This method works by calling <paramref name="func" /> one time for each element in <paramref name="source" />. Each time <paramref name="func" /> is called, <see cref="M:System.Linq.Enumerable.Aggregate``2(System.Collections.Generic.IEnumerable{``0},``1,System.Func{``1,``0,``1})" /> passes both the element from the sequence and an aggregated value (as the first argument to <paramref name="func" />). The value of the <paramref name="seed" /> parameter is used as the initial aggregate value. The result of <paramref name="func" /> replaces the previous aggregated value. <see cref="M:System.Linq.Enumerable.Aggregate``2(System.Collections.Generic.IEnumerable{``0},``1,System.Func{``1,``0,``1})" /> returns the final result of <paramref name="func" />.</para>
@@ -93,6 +95,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Applies an accumulator function over a sequence. The specified seed value is used as the initial accumulator value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The final accumulator value.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to aggregate over.</param>
         <param name="seed">
@@ -128,7 +134,6 @@
         <Parameter Name="resultSelector" Type="System.Func&lt;TAccumulate,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Aggregate``3(System.Collections.Generic.IEnumerable{``0},``1,System.Func{``1,``0,``1},System.Func{``1,``2})" /> method makes it simple to perform a calculation over a sequence of values. This method works by calling <paramref name="func" /> one time for each element in <paramref name="source" />. Each time <paramref name="func" /> is called, <see cref="M:System.Linq.Enumerable.Aggregate``3(System.Collections.Generic.IEnumerable{``0},``1,System.Func{``1,``0,``1},System.Func{``1,``2})" /> passes both the element from the sequence and an aggregated value (as the first argument to <paramref name="func" />). The value of the <paramref name="seed" /> parameter is used as the initial aggregate value. The result of <paramref name="func" /> replaces the previous aggregated value. The final result of <paramref name="func" /> is passed to <paramref name="resultSelector" /> to obtain the final result of <see cref="M:System.Linq.Enumerable.Aggregate``3(System.Collections.Generic.IEnumerable{``0},``1,System.Func{``1,``0,``1},System.Func{``1,``2})" />.</para>
@@ -138,6 +143,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Applies an accumulator function over a sequence. The specified seed value is used as the initial accumulator value, and the specified function is used to select the result value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The transformed final accumulator value.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to aggregate over.</param>
         <param name="seed">
@@ -173,7 +182,6 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -186,6 +194,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether all elements of a sequence satisfy a condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if every element of the source sequence passes the test in the specified predicate, or if the sequence is empty; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> that contains the elements to apply the predicate to.</param>
         <param name="predicate">
@@ -212,7 +224,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -225,6 +236,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a sequence contains any elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the source sequence contains any elements; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.Generic.IEnumerable`1" /> to check for emptiness.</param>
         <typeparam name="TSource">
@@ -250,7 +265,6 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -263,6 +277,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether any element of a sequence satisfies a condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if any elements in the source sequence pass the test in the specified predicate; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> whose elements to apply the predicate to.</param>
         <param name="predicate">
@@ -289,7 +307,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.AsEnumerable``1(System.Collections.Generic.IEnumerable{``0})" /> method has no effect other than to change the compile-time type of <paramref name="source" /> from a type that implements <see cref="T:System.Collections.Generic.IEnumerable`1" /> to <see cref="T:System.Collections.Generic.IEnumerable`1" /> itself.</para>
@@ -300,6 +317,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the input typed as <see cref="T:System.Collections.Generic.IEnumerable`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The input sequence typed as <see cref="T:System.Collections.Generic.IEnumerable`1" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to type as <see cref="T:System.Collections.Generic.IEnumerable`1" />.</param>
         <typeparam name="TSource">
@@ -321,7 +342,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Decimal&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In vbprvb query expression syntax, an Aggregate Into Average() clause translates to an invocation of <see cref="Overload:System.Linq.Enumerable.Average" />.</para>
@@ -330,6 +350,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of <see cref="T:System.Decimal" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Decimal" /> values to calculate the average of.</param>
       </Docs>
@@ -349,7 +373,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Double&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the sum of the elements is too large to represent as a <see cref="T:System.Double" />, this method returns positive or negative infinity.</para>
@@ -359,6 +382,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of <see cref="T:System.Double" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Double" /> values to calculate the average of.</param>
       </Docs>
@@ -378,7 +405,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Int32&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In vbprvb query expression syntax, an Aggregate Into Average() clause translates to an invocation of <see cref="Overload:System.Linq.Enumerable.Average" />.</para>
@@ -387,6 +413,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of <see cref="T:System.Int32" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Int32" /> values to calculate the average of.</param>
       </Docs>
@@ -406,7 +436,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Int64&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In vbprvb query expression syntax, an Aggregate Into Average() clause translates to an invocation of <see cref="Overload:System.Linq.Enumerable.Average" />.</para>
@@ -415,6 +444,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of <see cref="T:System.Int64" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Int64" /> values to calculate the average of.</param>
       </Docs>
@@ -434,7 +467,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Nullable&lt;System.Decimal&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In vbprvb query expression syntax, an Aggregate Into Average() clause translates to an invocation of <see cref="Overload:System.Linq.Enumerable.Average" />.</para>
@@ -443,6 +475,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of nullable <see cref="T:System.Decimal" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values, or null if the source sequence is empty or contains only values that are null.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Decimal" /> values to calculate the average of.</param>
       </Docs>
@@ -462,7 +498,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Nullable&lt;System.Double&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the sum of the elements is too large to represent as a <see cref="T:System.Double" />, this method returns positive or negative infinity.</para>
@@ -472,6 +507,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of nullable <see cref="T:System.Double" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values, or null if the source sequence is empty or contains only values that are null.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Double" /> values to calculate the average of.</param>
       </Docs>
@@ -491,7 +530,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Nullable&lt;System.Int32&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In vbprvb query expression syntax, an Aggregate Into Average() clause translates to an invocation of <see cref="Overload:System.Linq.Enumerable.Average" />.</para>
@@ -500,6 +538,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of nullable <see cref="T:System.Int32" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values, or null if the source sequence is empty or contains only values that are null.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Int32" /> values to calculate the average of.</param>
       </Docs>
@@ -519,7 +561,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Nullable&lt;System.Int64&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In vbprvb query expression syntax, an Aggregate Into Average() clause translates to an invocation of <see cref="Overload:System.Linq.Enumerable.Average" />.</para>
@@ -528,6 +569,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of nullable <see cref="T:System.Int64" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values, or null if the source sequence is empty or contains only values that are null.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Int64" /> values to calculate the average of.</param>
       </Docs>
@@ -547,7 +592,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Nullable&lt;System.Single&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In vbprvb query expression syntax, an Aggregate Into Average() clause translates to an invocation of <see cref="Overload:System.Linq.Enumerable.Average" />.</para>
@@ -556,6 +600,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of nullable <see cref="T:System.Single" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values, or null if the source sequence is empty or contains only values that are null.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Single" /> values to calculate the average of.</param>
       </Docs>
@@ -575,7 +623,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Single&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In vbprvb query expression syntax, an Aggregate Into Average() clause translates to an invocation of <see cref="Overload:System.Linq.Enumerable.Average" />.</para>
@@ -584,6 +631,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of <see cref="T:System.Single" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Single" /> values to calculate the average of.</param>
       </Docs>
@@ -607,7 +658,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Decimal&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In vbprvb query expression syntax, an Aggregate Into Average() clause translates to an invocation of <see cref="Overload:System.Linq.Enumerable.Average" />.</para>
@@ -616,6 +666,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of <see cref="T:System.Decimal" /> values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate an average.</param>
         <param name="selector">
@@ -643,7 +697,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Double&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In vbprvb query expression syntax, an Aggregate Into Average() clause translates to an invocation of <see cref="Overload:System.Linq.Enumerable.Average" />.</para>
@@ -652,6 +705,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of <see cref="T:System.Double" /> values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the average of.</param>
         <param name="selector">
@@ -679,7 +736,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Int32&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In vbprvb query expression syntax, an Aggregate Into Average() clause translates to an invocation of <see cref="Overload:System.Linq.Enumerable.Average" />.</para>
@@ -688,6 +744,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of <see cref="T:System.Int32" /> values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the average of.</param>
         <param name="selector">
@@ -715,7 +775,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Int64&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In vbprvb query expression syntax, an Aggregate Into Average() clause translates to an invocation of <see cref="Overload:System.Linq.Enumerable.Average" />.</para>
@@ -724,6 +783,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of <see cref="T:System.Int64" /> values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the average of.</param>
         <param name="selector">
@@ -751,7 +814,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Decimal&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In vbprvb query expression syntax, an Aggregate Into Average() clause translates to an invocation of <see cref="Overload:System.Linq.Enumerable.Average" />.</para>
@@ -760,6 +822,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of nullable <see cref="T:System.Decimal" /> values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values, or null if the source sequence is empty or contains only values that are null.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the average of.</param>
         <param name="selector">
@@ -787,7 +853,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Double&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In vbprvb query expression syntax, an Aggregate Into Average() clause translates to an invocation of <see cref="Overload:System.Linq.Enumerable.Average" />.</para>
@@ -796,6 +861,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of nullable <see cref="T:System.Double" /> values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values, or null if the source sequence is empty or contains only values that are null.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the average of.</param>
         <param name="selector">
@@ -823,7 +892,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Int32&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In vbprvb query expression syntax, an Aggregate Into Average() clause translates to an invocation of <see cref="Overload:System.Linq.Enumerable.Average" />.</para>
@@ -832,6 +900,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of nullable <see cref="T:System.Int32" /> values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values, or null if the source sequence is empty or contains only values that are null.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the average of.</param>
         <param name="selector">
@@ -859,7 +931,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Int64&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In vbprvb query expression syntax, an Aggregate Into Average() clause translates to an invocation of <see cref="Overload:System.Linq.Enumerable.Average" />.</para>
@@ -868,6 +939,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of nullable <see cref="T:System.Int64" /> values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values, or null if the source sequence is empty or contains only values that are null.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the average of.</param>
         <param name="selector">
@@ -895,7 +970,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Single&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In vbprvb query expression syntax, an Aggregate Into Average() clause translates to an invocation of <see cref="Overload:System.Linq.Enumerable.Average" />.</para>
@@ -904,6 +978,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of nullable <see cref="T:System.Single" /> values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values, or null if the source sequence is empty or contains only values that are null.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the average of.</param>
         <param name="selector">
@@ -931,7 +1009,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Single&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In vbprvb query expression syntax, an Aggregate Into Average() clause translates to an invocation of <see cref="Overload:System.Linq.Enumerable.Average" />.</para>
@@ -940,6 +1017,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of <see cref="T:System.Single" /> values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the average of.</param>
         <param name="selector">
@@ -966,7 +1047,6 @@
         <Parameter Name="source" Type="System.Collections.IEnumerable" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -980,6 +1060,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Casts the elements of an <see cref="T:System.Collections.IEnumerable" /> to the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> that contains each element of the source sequence cast to the specified type.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.IEnumerable" /> that contains the elements to be cast to type <paramref name="TResult" />.</param>
         <typeparam name="TResult">
@@ -1005,7 +1089,6 @@
         <Parameter Name="second" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -1015,6 +1098,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Concatenates two sequences.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> that contains the concatenated elements of the two input sequences.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />The first sequence to concatenate.</param>
         <param name="second">
@@ -1042,7 +1129,6 @@
         <Parameter Name="value" Type="TSource" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the type of <paramref name="source" /> implements <see cref="T:System.Collections.Generic.ICollection`1" />, the <unmanagedCodeEntityReference>Contains</unmanagedCodeEntityReference> method in that implementation is invoked to obtain the result. Otherwise, this method determines whether <paramref name="source" /> contains the specified element.</para>
@@ -1053,6 +1139,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a sequence contains a specified element by using the default equality comparer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the source sequence contains an element that has the specified value; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence in which to locate a value.</param>
         <param name="value">
@@ -1081,7 +1171,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Enumeration is terminated as soon as a matching element is found.</para>
@@ -1091,6 +1180,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a sequence contains a specified element by using a specified <see cref="T:System.Collections.Generic.IEqualityComparer`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the source sequence contains an element that has the specified value; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence in which to locate a value.</param>
         <param name="value">
@@ -1119,7 +1212,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the type of <paramref name="source" /> implements <see cref="T:System.Collections.Generic.ICollection`1" />, that implementation is used to obtain the count of elements. Otherwise, this method determines the count.</para>
@@ -1130,6 +1222,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of elements in a sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of elements in the input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence that contains elements to be counted.</param>
         <typeparam name="TSource">
@@ -1155,7 +1251,6 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the type of <paramref name="source" /> implements <see cref="T:System.Collections.Generic.ICollection`1" />, that implementation is used to obtain the count of elements. Otherwise, this method determines the count.</para>
@@ -1166,6 +1261,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a number that represents how many elements in the specified sequence satisfy a condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A number that represents how many elements in the sequence satisfy the condition in the predicate function.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence that contains elements to be tested and counted.</param>
         <param name="predicate">
@@ -1192,7 +1291,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -1203,6 +1301,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the elements of the specified sequence or the type parameter's default value in a singleton collection if the sequence is empty.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> object that contains the default value for the <paramref name="TSource" /> type if <paramref name="source" /> is empty; otherwise, <paramref name="source" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to return a default value for if it is empty.</param>
         <typeparam name="TSource">
@@ -1228,7 +1330,6 @@
         <Parameter Name="defaultValue" Type="TSource" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -1238,6 +1339,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the elements of the specified sequence or the specified value in a singleton collection if the sequence is empty.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> that contains <paramref name="defaultValue" /> if <paramref name="source" /> is empty; otherwise, <paramref name="source" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to return the specified value for if it is empty.</param>
         <param name="defaultValue">
@@ -1264,7 +1369,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -1277,6 +1381,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns distinct elements from a sequence by using the default equality comparer to compare values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> that contains distinct elements from the source sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to remove duplicate elements from.</param>
         <typeparam name="TSource">
@@ -1302,7 +1410,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -1312,6 +1419,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns distinct elements from a sequence by using a specified <see cref="T:System.Collections.Generic.IEqualityComparer`1" /> to compare values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> that contains distinct elements from the source sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to remove duplicate elements from.</param>
         <param name="comparer">
@@ -1339,7 +1450,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the type of <paramref name="source" /> implements <see cref="T:System.Collections.Generic.IList`1" />, that implementation is used to obtain the element at the specified index. Otherwise, this method obtains the specified element.</para>
@@ -1349,6 +1459,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the element at a specified index in a sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The element at the specified position in the source sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to return an element from.</param>
         <param name="index">
@@ -1376,7 +1490,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the type of <paramref name="source" /> implements <see cref="T:System.Collections.Generic.IList`1" />, that implementation is used to obtain the element at the specified index. Otherwise, this method obtains the specified element.</para>
@@ -1386,6 +1499,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the element at a specified index in a sequence or a default value if the index is out of range.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>default(<paramref name="TSource" />) if the index is outside the bounds of the source sequence; otherwise, the element at the specified position in the source sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to return an element from.</param>
         <param name="index">
@@ -1410,7 +1527,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Empty``1" /> method caches an empty sequence of type <paramref name="TResult" />. When the object it returns is enumerated, it yields no elements.</para>
@@ -1420,6 +1536,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an empty <see cref="T:System.Collections.Generic.IEnumerable`1" /> that has the specified type argument.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An empty <see cref="T:System.Collections.Generic.IEnumerable`1" /> whose type argument is <paramref name="TResult" />.</para>
+        </returns>
         <typeparam name="TResult">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to assign to the type parameter of the returned generic <see cref="T:System.Collections.Generic.IEnumerable`1" />.</typeparam>
       </Docs>
@@ -1443,7 +1563,6 @@
         <Parameter Name="second" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -1457,6 +1576,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces the set difference of two sequences by using the default equality comparer to compare values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that contains the set difference of the elements of two sequences.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> whose elements that are not also in <paramref name="second" /> will be returned.</param>
         <param name="second">
@@ -1485,7 +1608,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If c<paramref name="omparer" /> is null, the default equality comparer, <see cref="P:System.Collections.Generic.EqualityComparer`1.Default" />, is used to compare values.</para>
@@ -1494,6 +1616,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces the set difference of two sequences by using the specified <see cref="T:System.Collections.Generic.IEqualityComparer`1" /> to compare values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that contains the set difference of the elements of two sequences.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> whose elements that are not also in <paramref name="second" /> will be returned.</param>
         <param name="second">
@@ -1522,7 +1648,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.First``1(System.Collections.Generic.IEnumerable{``0})" /> method throws an exception if <paramref name="source" /> contains no elements. To instead return a default value when the source sequence is empty, use the <see cref="M:System.Linq.Enumerable.FirstOrDefault``1(System.Collections.Generic.IEnumerable{``0})" /> method.</para>
@@ -1531,6 +1656,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the first element of a sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first element in the specified sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.Generic.IEnumerable`1" /> to return the first element of.</param>
         <typeparam name="TSource">
@@ -1556,7 +1685,6 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.First``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Boolean})" /> method throws an exception if no matching element is found in <paramref name="source" />. To instead return a default value when no matching element is found, use the <see cref="M:System.Linq.Enumerable.FirstOrDefault``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Boolean})" /> method.</para>
@@ -1565,6 +1693,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the first element in a sequence that satisfies a specified condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first element in the sequence that passes the test in the specified predicate function.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to return an element from.</param>
         <param name="predicate">
@@ -1591,7 +1723,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default value for reference and nullable types is null.</para>
@@ -1601,6 +1732,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the first element of a sequence, or a default value if the sequence contains no elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>default(<paramref name="TSource" />) if <paramref name="source" /> is empty; otherwise, the first element in <paramref name="source" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.Generic.IEnumerable`1" /> to return the first element of.</param>
         <typeparam name="TSource">
@@ -1626,7 +1761,6 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default value for reference and nullable types is null.</para>
@@ -1635,6 +1769,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the first element of the sequence that satisfies a condition or a default value if no such element is found.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>default(<paramref name="TSource" />) if <paramref name="source" /> is empty or if no element passes the test specified by <paramref name="predicate" />; otherwise, the first element in <paramref name="source" /> that passes the test specified by <paramref name="predicate" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to return an element from.</param>
         <param name="predicate">
@@ -1663,7 +1801,6 @@
         <Parameter Name="keySelector" Type="System.Func&lt;TSource,TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -1696,6 +1833,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Groups the elements of a sequence according to a specified key selector function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <unmanagedCodeEntityReference>IEnumerable&lt;IGrouping&lt;TKey, TSource&gt;&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>IEnumerable(Of IGrouping(Of TKey, TSource))</unmanagedCodeEntityReference> in vbprvb where each <see cref="T:System.Linq.IGrouping`2" /> object contains a sequence of objects and a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> whose elements to group.</param>
         <param name="keySelector">
@@ -1727,7 +1868,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -1761,6 +1901,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Groups the elements of a sequence according to a specified key selector function and compares the keys by using a specified comparer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <unmanagedCodeEntityReference>IEnumerable&lt;IGrouping&lt;TKey, TSource&gt;&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>IEnumerable(Of IGrouping(Of TKey, TSource))</unmanagedCodeEntityReference> in vbprvb where each <see cref="T:System.Linq.IGrouping`2" /> object contains a collection of objects and a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> whose elements to group.</param>
         <param name="keySelector">
@@ -1795,7 +1939,6 @@
         <Parameter Name="elementSelector" Type="System.Func&lt;TSource,TElement&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -1807,6 +1950,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Groups the elements of a sequence according to a specified key selector function and projects the elements for each group by using a specified function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <unmanagedCodeEntityReference>IEnumerable&lt;IGrouping&lt;TKey, TElement&gt;&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>IEnumerable(Of IGrouping(Of TKey, TElement))</unmanagedCodeEntityReference> in vbprvb where each <see cref="T:System.Linq.IGrouping`2" /> object contains a collection of objects of type <paramref name="TElement" /> and a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> whose elements to group.</param>
         <param name="keySelector">
@@ -1844,7 +1991,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -1878,6 +2024,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Groups the elements of a sequence according to a key selector function. The keys are compared by using a comparer and each group's elements are projected by using a specified function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <unmanagedCodeEntityReference>IEnumerable&lt;IGrouping&lt;TKey, TElement&gt;&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>IEnumerable(Of IGrouping(Of TKey, TElement))</unmanagedCodeEntityReference> in vbprvb where each <see cref="T:System.Linq.IGrouping`2" /> object contains a collection of objects of type <paramref name="TElement" /> and a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> whose elements to group.</param>
         <param name="keySelector">
@@ -1916,7 +2066,6 @@
         <Parameter Name="resultSelector" Type="System.Func&lt;TKey,System.Collections.Generic.IEnumerable&lt;TSource&gt;,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In query expression syntax, a group by (csprcs) or Group By Into (vbprvb) clause translates to an invocation of <see cref="Overload:System.Linq.Enumerable.GroupBy" />.</para>
@@ -1925,6 +2074,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Groups the elements of a sequence according to a specified key selector function and creates a result value from each group and its key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of elements of type <paramref name="TResult" /> where each element represents a projection over a group and its key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> whose elements to group.</param>
         <param name="keySelector">
@@ -1962,12 +2115,15 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Groups the elements of a sequence according to a specified key selector function and creates a result value from each group and its key. The keys are compared by using a specified comparer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of elements of type <paramref name="TResult" /> where each element represents a projection over a group and its key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> whose elements to group.</param>
         <param name="keySelector">
@@ -2008,7 +2164,6 @@
         <Parameter Name="resultSelector" Type="System.Func&lt;TKey,System.Collections.Generic.IEnumerable&lt;TElement&gt;,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In query expression syntax, a group by (csprcs) or Group By Into (vbprvb) clause translates to an invocation of <see cref="Overload:System.Linq.Enumerable.GroupBy" />.</para>
@@ -2017,6 +2172,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Groups the elements of a sequence according to a specified key selector function and creates a result value from each group and its key. The elements of each group are projected by using a specified function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of elements of type <paramref name="TResult" /> where each element represents a projection over a group and its key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> whose elements to group.</param>
         <param name="keySelector">
@@ -2060,12 +2219,15 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Groups the elements of a sequence according to a specified key selector function and creates a result value from each group and its key. Key values are compared by using a specified comparer, and the elements of each group are projected by using a specified function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of elements of type <paramref name="TResult" /> where each element represents a projection over a group and its key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> whose elements to group.</param>
         <param name="keySelector">
@@ -2111,7 +2273,6 @@
         <Parameter Name="resultSelector" Type="System.Func&lt;TOuter,System.Collections.Generic.IEnumerable&lt;TInner&gt;,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -2132,6 +2293,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Correlates the elements of two sequences based on equality of keys and groups the results. The default equality comparer is used to compare keys.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> that contains elements of type <paramref name="TResult" /> that are obtained by performing a grouped join on two sequences.</para>
+        </returns>
         <param name="outer">
           <attribution license="cc4" from="Microsoft" modified="false" />The first sequence to join.</param>
         <param name="inner">
@@ -2178,7 +2343,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -2198,6 +2362,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Correlates the elements of two sequences based on key equality and groups the results. A specified <see cref="T:System.Collections.Generic.IEqualityComparer`1" /> is used to compare keys.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> that contains elements of type <paramref name="TResult" /> that are obtained by performing a grouped join on two sequences.</para>
+        </returns>
         <param name="outer">
           <attribution license="cc4" from="Microsoft" modified="false" />The first sequence to join.</param>
         <param name="inner">
@@ -2239,7 +2407,6 @@
         <Parameter Name="second" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -2251,6 +2418,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces the set intersection of two sequences by using the default equality comparer to compare values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that contains the elements that form the set intersection of two sequences.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> whose distinct elements that also appear in <paramref name="second" /> will be returned.</param>
         <param name="second">
@@ -2279,7 +2450,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -2291,6 +2461,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces the set intersection of two sequences by using the specified <see cref="T:System.Collections.Generic.IEqualityComparer`1" /> to compare values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that contains the elements that form the set intersection of two sequences.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> whose distinct elements that also appear in <paramref name="second" /> will be returned.</param>
         <param name="second">
@@ -2326,7 +2500,6 @@
         <Parameter Name="resultSelector" Type="System.Func&lt;TOuter,TInner,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -2341,6 +2514,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Correlates the elements of two sequences based on matching keys. The default equality comparer is used to compare keys.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> that has elements of type <paramref name="TResult" /> that are obtained by performing an inner join on two sequences.</para>
+        </returns>
         <param name="outer">
           <attribution license="cc4" from="Microsoft" modified="false" />The first sequence to join.</param>
         <param name="inner">
@@ -2387,7 +2564,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -2401,6 +2577,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Correlates the elements of two sequences based on matching keys. A specified <see cref="T:System.Collections.Generic.IEqualityComparer`1" /> is used to compare keys.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> that has elements of type <paramref name="TResult" /> that are obtained by performing an inner join on two sequences.</para>
+        </returns>
         <param name="outer">
           <attribution license="cc4" from="Microsoft" modified="false" />The first sequence to join.</param>
         <param name="inner">
@@ -2441,7 +2621,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Last``1(System.Collections.Generic.IEnumerable{``0})" /> method throws an exception if <paramref name="source" /> contains no elements. To instead return a default value when the source sequence is empty, use the <see cref="M:System.Linq.Enumerable.LastOrDefault``1(System.Collections.Generic.IEnumerable{``0})" /> method.</para>
@@ -2450,6 +2629,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the last element of a sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value at the last position in the source sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to return the last element of.</param>
         <typeparam name="TSource">
@@ -2475,7 +2658,6 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Last``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Boolean})" /> method throws an exception if no matching element is found in <paramref name="source" />. To instead return a default value when no matching element is found, use the <see cref="M:System.Linq.Enumerable.LastOrDefault``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Boolean})" /> method.</para>
@@ -2484,6 +2666,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the last element of a sequence that satisfies a specified condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The last element in the sequence that passes the test in the specified predicate function.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to return an element from.</param>
         <param name="predicate">
@@ -2510,7 +2696,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default value for reference and nullable types is null.</para>
@@ -2520,6 +2705,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the last element of a sequence, or a default value if the sequence contains no elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>default(<paramref name="TSource" />) if the source sequence is empty; otherwise, the last element in the <see cref="T:System.Collections.Generic.IEnumerable`1" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to return the last element of.</param>
         <typeparam name="TSource">
@@ -2545,7 +2734,6 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default value for reference and nullable types is null.</para>
@@ -2554,6 +2742,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the last element of a sequence that satisfies a condition or a default value if no such element is found.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>default(<paramref name="TSource" />) if the sequence is empty or if no elements pass the test in the predicate function; otherwise, the last element that passes the test in the predicate function.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to return an element from.</param>
         <param name="predicate">
@@ -2580,7 +2772,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method rather than <see cref="M:System.Linq.Enumerable.Count``1(System.Collections.Generic.IEnumerable{``0})" /> when you expect the result to be greater than <see cref="F:System.Int32.MaxValue" />.</para>
@@ -2590,6 +2781,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Int64" /> that represents the total number of elements in a sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of elements in the source sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> that contains the elements to be counted.</param>
         <typeparam name="TSource">
@@ -2615,7 +2810,6 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method rather than <see cref="M:System.Linq.Enumerable.Count``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Boolean})" /> when you expect the result to be greater than <see cref="F:System.Int32.MaxValue" />.</para>
@@ -2625,6 +2819,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Int64" /> that represents how many elements in a sequence satisfy a condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A number that represents how many elements in the sequence satisfy the condition in the predicate function.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> that contains the elements to be counted.</param>
         <param name="predicate">
@@ -2648,7 +2846,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Decimal&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Max(System.Collections.Generic.IEnumerable{System.Decimal})" /> method uses the <see cref="T:System.Decimal" /> implementation of <see cref="T:System.IComparable`1" /> to compare values.</para>
@@ -2658,6 +2855,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the maximum value in a sequence of <see cref="T:System.Decimal" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Decimal" /> values to determine the maximum value of.</param>
       </Docs>
@@ -2677,7 +2878,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Double&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Max(System.Collections.Generic.IEnumerable{System.Double})" /> method uses the <see cref="T:System.Double" /> implementation of <see cref="T:System.IComparable`1" /> to compare values.</para>
@@ -2687,6 +2887,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the maximum value in a sequence of <see cref="T:System.Double" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Double" /> values to determine the maximum value of.</param>
       </Docs>
@@ -2706,7 +2910,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Int32&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Max(System.Collections.Generic.IEnumerable{System.Int32})" /> method uses the <see cref="T:System.Int32" /> implementation of <see cref="T:System.IComparable`1" /> to compare values.</para>
@@ -2716,6 +2919,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the maximum value in a sequence of <see cref="T:System.Int32" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Int32" /> values to determine the maximum value of.</param>
       </Docs>
@@ -2735,7 +2942,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Int64&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Max(System.Collections.Generic.IEnumerable{System.Int64})" /> method uses the <see cref="T:System.Int64" /> implementation of <see cref="T:System.IComparable`1" /> to compare values.</para>
@@ -2745,6 +2951,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the maximum value in a sequence of <see cref="T:System.Int64" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Int64" /> values to determine the maximum value of.</param>
       </Docs>
@@ -2764,7 +2974,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Nullable&lt;System.Decimal&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Max(System.Collections.Generic.IEnumerable{System.Nullable{System.Decimal}})" /> method uses the <see cref="T:System.Decimal" /> implementation of <see cref="T:System.IComparable`1" /> to compare values.</para>
@@ -2775,6 +2984,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the maximum value in a sequence of nullable <see cref="T:System.Decimal" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value of type <unmanagedCodeEntityReference>Nullable&lt;Decimal&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>Nullable(Of Decimal)</unmanagedCodeEntityReference> in vbprvb that corresponds to the maximum value in the sequence. </para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Decimal" /> values to determine the maximum value of.</param>
       </Docs>
@@ -2794,7 +3007,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Nullable&lt;System.Double&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Max(System.Collections.Generic.IEnumerable{System.Nullable{System.Double}})" /> method uses the <see cref="T:System.Double" /> implementation of <see cref="T:System.IComparable`1" /> to compare values. </para>
@@ -2805,6 +3017,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the maximum value in a sequence of nullable <see cref="T:System.Double" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value of type <unmanagedCodeEntityReference>Nullable&lt;Double&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>Nullable(Of Double)</unmanagedCodeEntityReference> in vbprvb that corresponds to the maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Double" /> values to determine the maximum value of.</param>
       </Docs>
@@ -2824,7 +3040,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Nullable&lt;System.Int32&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Max(System.Collections.Generic.IEnumerable{System.Nullable{System.Int32}})" /> method uses the <see cref="T:System.Int32" /> implementation of <see cref="T:System.IComparable`1" /> to compare values. </para>
@@ -2835,6 +3050,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the maximum value in a sequence of nullable <see cref="T:System.Int32" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value of type <unmanagedCodeEntityReference>Nullable&lt;Int32&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>Nullable(Of Int32)</unmanagedCodeEntityReference> in vbprvb that corresponds to the maximum value in the sequence. </para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Int32" /> values to determine the maximum value of.</param>
       </Docs>
@@ -2854,7 +3073,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Nullable&lt;System.Int64&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Max(System.Collections.Generic.IEnumerable{System.Nullable{System.Int64}})" /> method uses the <see cref="T:System.Int64" /> implementation of <see cref="T:System.IComparable`1" /> to compare values. </para>
@@ -2865,6 +3083,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the maximum value in a sequence of nullable <see cref="T:System.Int64" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value of type <unmanagedCodeEntityReference>Nullable&lt;Int64&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>Nullable(Of Int64)</unmanagedCodeEntityReference> in vbprvb that corresponds to the maximum value in the sequence. </para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Int64" /> values to determine the maximum value of.</param>
       </Docs>
@@ -2884,7 +3106,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Nullable&lt;System.Single&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Max(System.Collections.Generic.IEnumerable{System.Nullable{System.Single}})" /> method uses the <see cref="T:System.Single" /> implementation of <see cref="T:System.IComparable`1" /> to compare values.</para>
@@ -2895,6 +3116,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the maximum value in a sequence of nullable <see cref="T:System.Single" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value of type <unmanagedCodeEntityReference>Nullable&lt;Single&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>Nullable(Of Single)</unmanagedCodeEntityReference> in vbprvb that corresponds to the maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Single" /> values to determine the maximum value of.</param>
       </Docs>
@@ -2914,7 +3139,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Single&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Max(System.Collections.Generic.IEnumerable{System.Single})" /> method uses the <see cref="T:System.Single" /> implementation of <see cref="T:System.IComparable`1" /> to compare values.</para>
@@ -2924,6 +3148,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the maximum value in a sequence of <see cref="T:System.Single" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Single" /> values to determine the maximum value of.</param>
       </Docs>
@@ -2946,7 +3174,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If type <paramref name="TSource" /> implements <see cref="T:System.IComparable`1" />, the <see cref="M:System.Linq.Enumerable.Max``1(System.Collections.Generic.IEnumerable{``0})" /> method uses that implementation to compare values. Otherwise, if type <paramref name="TSource" /> implements <see cref="T:System.IComparable" />, that implementation is used to compare values.</para>
@@ -2957,6 +3184,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the maximum value in a generic sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
         <typeparam name="TSource">
@@ -2982,7 +3213,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Decimal&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Max``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Decimal})" /> method uses the <see cref="T:System.Decimal" /> implementation of <see cref="T:System.IComparable`1" /> to compare values.</para>
@@ -2993,6 +3223,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes a transform function on each element of a sequence and returns the maximum <see cref="T:System.Decimal" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
         <param name="selector">
@@ -3020,7 +3254,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Double&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Max``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Double})" /> method uses the <see cref="T:System.Double" /> implementation of <see cref="T:System.IComparable`1" /> to compare values.</para>
@@ -3031,6 +3264,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes a transform function on each element of a sequence and returns the maximum <see cref="T:System.Double" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
         <param name="selector">
@@ -3058,7 +3295,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Int32&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Max``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Int32})" /> method uses the <see cref="T:System.Int32" /> implementation of <see cref="T:System.IComparable`1" /> to compare values.</para>
@@ -3069,6 +3305,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes a transform function on each element of a sequence and returns the maximum <see cref="T:System.Int32" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
         <param name="selector">
@@ -3096,7 +3336,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Int64&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Max``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Int64})" /> method uses the <see cref="T:System.Int64" /> implementation of <see cref="T:System.IComparable`1" /> to compare values.</para>
@@ -3107,6 +3346,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes a transform function on each element of a sequence and returns the maximum <see cref="T:System.Int64" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
         <param name="selector">
@@ -3134,7 +3377,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Decimal&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Max``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Nullable{System.Decimal}})" /> method uses the <see cref="T:System.Decimal" /> implementation of <see cref="T:System.IComparable`1" /> to compare values.</para>
@@ -3145,6 +3387,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes a transform function on each element of a sequence and returns the maximum nullable <see cref="T:System.Decimal" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of type <unmanagedCodeEntityReference>Nullable&lt;Decimal&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>Nullable(Of Decimal)</unmanagedCodeEntityReference> in vbprvb that corresponds to the maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
         <param name="selector">
@@ -3172,7 +3418,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Double&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Max``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Nullable{System.Double}})" /> method uses the <see cref="T:System.Double" /> implementation of <see cref="T:System.IComparable`1" /> to compare values.</para>
@@ -3183,6 +3428,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes a transform function on each element of a sequence and returns the maximum nullable <see cref="T:System.Double" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of type <unmanagedCodeEntityReference>Nullable&lt;Double&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>Nullable(Of Double)</unmanagedCodeEntityReference> in vbprvb that corresponds to the maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
         <param name="selector">
@@ -3210,7 +3459,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Int32&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Max``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Nullable{System.Int32}})" /> method uses the <see cref="T:System.Int32" /> implementation of <see cref="T:System.IComparable`1" /> to compare values.</para>
@@ -3221,6 +3469,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes a transform function on each element of a sequence and returns the maximum nullable <see cref="T:System.Int32" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of type <unmanagedCodeEntityReference>Nullable&lt;Int32&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>Nullable(Of Int32)</unmanagedCodeEntityReference> in vbprvb that corresponds to the maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
         <param name="selector">
@@ -3248,7 +3500,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Int64&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Max``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Nullable{System.Int64}})" /> method uses the <see cref="T:System.Int64" /> implementation of <see cref="T:System.IComparable`1" /> to compare values.</para>
@@ -3259,6 +3510,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes a transform function on each element of a sequence and returns the maximum nullable <see cref="T:System.Int64" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of type <unmanagedCodeEntityReference>Nullable&lt;Int64&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>Nullable(Of Int64)</unmanagedCodeEntityReference> in vbprvb that corresponds to the maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
         <param name="selector">
@@ -3286,7 +3541,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Single&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Max``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Nullable{System.Single}})" /> method uses the <see cref="T:System.Single" /> implementation of <see cref="T:System.IComparable`1" /> to compare values.</para>
@@ -3297,6 +3551,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes a transform function on each element of a sequence and returns the maximum nullable <see cref="T:System.Single" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of type <unmanagedCodeEntityReference>Nullable&lt;Single&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>Nullable(Of Single)</unmanagedCodeEntityReference> in vbprvb that corresponds to the maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
         <param name="selector">
@@ -3324,7 +3582,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Single&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Max``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Single})" /> method uses the <see cref="T:System.Single" /> implementation of <see cref="T:System.IComparable`1" /> to compare values.</para>
@@ -3335,6 +3592,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes a transform function on each element of a sequence and returns the maximum <see cref="T:System.Single" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
         <param name="selector">
@@ -3363,7 +3624,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If type <paramref name="TResult" /> implements <see cref="T:System.IComparable`1" />, this method uses that implementation to compare values. Otherwise, if type <paramref name="TResult" /> implements <see cref="T:System.IComparable" />, that implementation is used to compare values.</para>
@@ -3373,6 +3633,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes a transform function on each element of a generic sequence and returns the maximum resulting value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
         <param name="selector">
@@ -3398,7 +3662,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Decimal&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Min(System.Collections.Generic.IEnumerable{System.Decimal})" /> method uses the <see cref="T:System.Decimal" /> implementation of <see cref="T:System.IComparable`1" /> to compare values.</para>
@@ -3408,6 +3671,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the minimum value in a sequence of <see cref="T:System.Decimal" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Decimal" /> values to determine the minimum value of.</param>
       </Docs>
@@ -3427,7 +3694,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Double&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Min(System.Collections.Generic.IEnumerable{System.Double})" /> method uses the <see cref="T:System.Double" /> implementation of <see cref="T:System.IComparable`1" /> to compare values.</para>
@@ -3437,6 +3703,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the minimum value in a sequence of <see cref="T:System.Double" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Double" /> values to determine the minimum value of.</param>
       </Docs>
@@ -3456,7 +3726,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Int32&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Min(System.Collections.Generic.IEnumerable{System.Int32})" /> method uses the <see cref="T:System.Int32" /> implementation of <see cref="T:System.IComparable`1" /> to compare values.</para>
@@ -3466,6 +3735,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the minimum value in a sequence of <see cref="T:System.Int32" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Int32" /> values to determine the minimum value of.</param>
       </Docs>
@@ -3485,7 +3758,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Int64&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Min(System.Collections.Generic.IEnumerable{System.Int64})" /> method uses the <see cref="T:System.Int64" /> implementation of <see cref="T:System.IComparable`1" /> to compare values.</para>
@@ -3495,6 +3767,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the minimum value in a sequence of <see cref="T:System.Int64" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Int64" /> values to determine the minimum value of.</param>
       </Docs>
@@ -3514,7 +3790,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Nullable&lt;System.Decimal&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Min(System.Collections.Generic.IEnumerable{System.Nullable{System.Decimal}})" /> method uses the <see cref="T:System.Decimal" /> implementation of <see cref="T:System.IComparable`1" /> to compare values. </para>
@@ -3525,6 +3800,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the minimum value in a sequence of nullable <see cref="T:System.Decimal" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value of type <unmanagedCodeEntityReference>Nullable&lt;Decimal&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>Nullable(Of Decimal)</unmanagedCodeEntityReference> in vbprvb that corresponds to the minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Decimal" /> values to determine the minimum value of.</param>
       </Docs>
@@ -3544,7 +3823,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Nullable&lt;System.Double&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Min(System.Collections.Generic.IEnumerable{System.Nullable{System.Double}})" /> method uses the <see cref="T:System.Double" /> implementation of <see cref="T:System.IComparable`1" /> to compare values. </para>
@@ -3555,6 +3833,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the minimum value in a sequence of nullable <see cref="T:System.Double" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value of type <unmanagedCodeEntityReference>Nullable&lt;Double&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>Nullable(Of Double)</unmanagedCodeEntityReference> in vbprvb that corresponds to the minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Double" /> values to determine the minimum value of.</param>
       </Docs>
@@ -3574,7 +3856,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Nullable&lt;System.Int32&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Min(System.Collections.Generic.IEnumerable{System.Nullable{System.Int32}})" /> method uses the <see cref="T:System.Int32" /> implementation of <see cref="T:System.IComparable`1" /> to compare values. </para>
@@ -3585,6 +3866,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the minimum value in a sequence of nullable <see cref="T:System.Int32" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value of type <unmanagedCodeEntityReference>Nullable&lt;Int32&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>Nullable(Of Int32)</unmanagedCodeEntityReference> in vbprvb that corresponds to the minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Int32" /> values to determine the minimum value of.</param>
       </Docs>
@@ -3604,7 +3889,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Nullable&lt;System.Int64&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Min(System.Collections.Generic.IEnumerable{System.Nullable{System.Int64}})" /> method uses the <see cref="T:System.Int64" /> implementation of <see cref="T:System.IComparable`1" /> to compare values. </para>
@@ -3615,6 +3899,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the minimum value in a sequence of nullable <see cref="T:System.Int64" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value of type <unmanagedCodeEntityReference>Nullable&lt;Int64&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>Nullable(Of Int64)</unmanagedCodeEntityReference> in vbprvb that corresponds to the minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Int64" /> values to determine the minimum value of.</param>
       </Docs>
@@ -3634,7 +3922,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Nullable&lt;System.Single&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Min(System.Collections.Generic.IEnumerable{System.Nullable{System.Single}})" /> method uses the <see cref="T:System.Single" /> implementation of <see cref="T:System.IComparable`1" /> to compare values. </para>
@@ -3645,6 +3932,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the minimum value in a sequence of nullable <see cref="T:System.Single" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value of type <unmanagedCodeEntityReference>Nullable&lt;Single&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>Nullable(Of Single)</unmanagedCodeEntityReference> in vbprvb that corresponds to the minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Single" /> values to determine the minimum value of.</param>
       </Docs>
@@ -3664,7 +3955,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Single&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Min(System.Collections.Generic.IEnumerable{System.Single})" /> method uses the <see cref="T:System.Single" /> implementation of <see cref="T:System.IComparable`1" /> to compare values.</para>
@@ -3674,6 +3964,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the minimum value in a sequence of <see cref="T:System.Single" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Single" /> values to determine the minimum value of.</param>
       </Docs>
@@ -3696,7 +3990,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If type <paramref name="TSource" /> implements <see cref="T:System.IComparable`1" />, this method uses that implementation to compare values. Otherwise, if type <paramref name="TSource" /> implements <see cref="T:System.IComparable" />, that implementation is used to compare values. </para>
@@ -3707,6 +4000,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the minimum value in a generic sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
         <typeparam name="TSource">
@@ -3732,7 +4029,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Decimal&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Min``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Decimal})" /> method uses the <see cref="T:System.Decimal" /> implementation of <see cref="T:System.IComparable`1" /> to compare values.</para>
@@ -3743,6 +4039,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes a transform function on each element of a sequence and returns the minimum <see cref="T:System.Decimal" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
         <param name="selector">
@@ -3770,7 +4070,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Double&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Min``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Double})" /> method uses the <see cref="T:System.Double" /> implementation of <see cref="T:System.IComparable`1" /> to compare values. </para>
@@ -3781,6 +4080,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes a transform function on each element of a sequence and returns the minimum <see cref="T:System.Double" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
         <param name="selector">
@@ -3808,7 +4111,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Int32&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Min``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Int32})" /> method uses the <see cref="T:System.Int32" /> implementation of <see cref="T:System.IComparable`1" /> to compare values. </para>
@@ -3819,6 +4121,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes a transform function on each element of a sequence and returns the minimum <see cref="T:System.Int32" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
         <param name="selector">
@@ -3846,7 +4152,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Int64&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Min``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Int64})" /> method uses the <see cref="T:System.Int64" /> implementation of <see cref="T:System.IComparable`1" /> to compare values. </para>
@@ -3857,6 +4162,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes a transform function on each element of a sequence and returns the minimum <see cref="T:System.Int64" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
         <param name="selector">
@@ -3884,7 +4193,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Decimal&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Min``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Nullable{System.Decimal}})" /> method uses the <see cref="T:System.Decimal" /> implementation of <see cref="T:System.IComparable`1" /> to compare values. </para>
@@ -3895,6 +4203,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes a transform function on each element of a sequence and returns the minimum nullable <see cref="T:System.Decimal" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of type <unmanagedCodeEntityReference>Nullable&lt;Decimal&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>Nullable(Of Decimal)</unmanagedCodeEntityReference> in vbprvb that corresponds to the minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
         <param name="selector">
@@ -3922,7 +4234,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Double&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Min``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Nullable{System.Double}})" /> method uses the <see cref="T:System.Double" /> implementation of <see cref="T:System.IComparable`1" /> to compare values. </para>
@@ -3933,6 +4244,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes a transform function on each element of a sequence and returns the minimum nullable <see cref="T:System.Double" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of type <unmanagedCodeEntityReference>Nullable&lt;Double&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>Nullable(Of Double)</unmanagedCodeEntityReference> in vbprvb that corresponds to the minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
         <param name="selector">
@@ -3960,7 +4275,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Int32&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Min``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Nullable{System.Int32}})" /> method uses the <see cref="T:System.Int32" /> implementation of <see cref="T:System.IComparable`1" /> to compare values. </para>
@@ -3971,6 +4285,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes a transform function on each element of a sequence and returns the minimum nullable <see cref="T:System.Int32" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of type <unmanagedCodeEntityReference>Nullable&lt;Int32&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>Nullable(Of Int32)</unmanagedCodeEntityReference> in vbprvb that corresponds to the minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
         <param name="selector">
@@ -3998,7 +4316,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Int64&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Min``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Nullable{System.Int64}})" /> method uses the <see cref="T:System.Int64" /> implementation of <see cref="T:System.IComparable`1" /> to compare values. </para>
@@ -4009,6 +4326,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes a transform function on each element of a sequence and returns the minimum nullable <see cref="T:System.Int64" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of type <unmanagedCodeEntityReference>Nullable&lt;Int64&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>Nullable(Of Int64)</unmanagedCodeEntityReference> in vbprvb that corresponds to the minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
         <param name="selector">
@@ -4036,7 +4357,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Single&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Min``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Nullable{System.Single}})" /> method uses the <see cref="T:System.Single" /> implementation of <see cref="T:System.IComparable`1" /> to compare values. </para>
@@ -4047,6 +4367,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes a transform function on each element of a sequence and returns the minimum nullable <see cref="T:System.Single" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of type <unmanagedCodeEntityReference>Nullable&lt;Single&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>Nullable(Of Single)</unmanagedCodeEntityReference> in vbprvb that corresponds to the minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
         <param name="selector">
@@ -4074,7 +4398,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Single&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Min``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Single})" /> method uses the <see cref="T:System.Single" /> implementation of <see cref="T:System.IComparable`1" /> to compare values. </para>
@@ -4085,6 +4408,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes a transform function on each element of a sequence and returns the minimum <see cref="T:System.Single" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
         <param name="selector">
@@ -4113,7 +4440,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If type <paramref name="TResult" /> implements <see cref="T:System.IComparable`1" />, this method uses that implementation to compare values. Otherwise, if type <paramref name="TResult" /> implements <see cref="T:System.IComparable" />, that implementation is used to compare values.</para>
@@ -4123,6 +4449,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes a transform function on each element of a generic sequence and returns the minimum resulting value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
         <param name="selector">
@@ -4151,7 +4481,6 @@
         <Parameter Name="source" Type="System.Collections.IEnumerable" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -4163,6 +4492,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Filters the elements of an <see cref="T:System.Collections.IEnumerable" /> based on a specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> that contains elements from the input sequence of type <paramref name="TResult" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.IEnumerable" /> whose elements to filter.</param>
         <typeparam name="TResult">
@@ -4189,7 +4522,6 @@
         <Parameter Name="keySelector" Type="System.Func&lt;TSource,TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -4206,6 +4538,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sorts the elements of a sequence in ascending order according to a key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IOrderedEnumerable`1" /> whose elements are sorted according to a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to order.</param>
         <param name="keySelector">
@@ -4237,7 +4573,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -4253,6 +4588,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sorts the elements of a sequence in ascending order by using a specified comparer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IOrderedEnumerable`1" /> whose elements are sorted according to a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to order.</param>
         <param name="keySelector">
@@ -4285,7 +4624,6 @@
         <Parameter Name="keySelector" Type="System.Func&lt;TSource,TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -4303,6 +4641,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sorts the elements of a sequence in descending order according to a key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IOrderedEnumerable`1" /> whose elements are sorted in descending order according to a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to order.</param>
         <param name="keySelector">
@@ -4334,7 +4676,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -4350,6 +4691,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sorts the elements of a sequence in descending order by using a specified comparer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IOrderedEnumerable`1" /> whose elements are sorted in descending order according to a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to order.</param>
         <param name="keySelector">
@@ -4378,7 +4723,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -4387,6 +4731,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a sequence of integral numbers within a specified range.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <unmanagedCodeEntityReference>IEnumerable&lt;Int32&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>IEnumerable(Of Int32)</unmanagedCodeEntityReference> in vbprvb that contains a range of sequential integral numbers.</para>
+        </returns>
         <param name="start">
           <attribution license="cc4" from="Microsoft" modified="false" />The value of the first integer in the sequence.</param>
         <param name="count">
@@ -4438,7 +4786,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -4448,6 +4795,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inverts the order of the elements in a sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence whose elements correspond to those of the input sequence in reverse order.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to reverse.</param>
         <typeparam name="TSource">
@@ -4474,7 +4825,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Int32,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -4485,6 +4835,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Projects each element of a sequence into a new form by incorporating the element's index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> whose elements are the result of invoking the transform function on each element of <paramref name="source" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to invoke a transform function on.</param>
         <param name="selector">
@@ -4515,7 +4869,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -4526,6 +4879,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Projects each element of a sequence into a new form.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> whose elements are the result of invoking the transform function on each element of <paramref name="source" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to invoke a transform function on.</param>
         <param name="selector">
@@ -4556,7 +4913,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Collections.Generic.IEnumerable&lt;TResult&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -4567,6 +4923,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Projects each element of a sequence to an <see cref="T:System.Collections.Generic.IEnumerable`1" /> and flattens the resulting sequences into one sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> whose elements are the result of invoking the one-to-many transform function on each element of the input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to project.</param>
         <param name="selector">
@@ -4597,7 +4957,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Int32,System.Collections.Generic.IEnumerable&lt;TResult&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -4608,6 +4967,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Projects each element of a sequence to an <see cref="T:System.Collections.Generic.IEnumerable`1" />, and flattens the resulting sequences into one sequence. The index of each source element is used in the projected form of that element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> whose elements are the result of invoking the one-to-many transform function on each element of an input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to project.</param>
         <param name="selector">
@@ -4640,7 +5003,6 @@
         <Parameter Name="resultSelector" Type="System.Func&lt;TSource,TCollection,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -4651,6 +5013,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Projects each element of a sequence to an <see cref="T:System.Collections.Generic.IEnumerable`1" />, flattens the resulting sequences into one sequence, and invokes a result selector function on each element therein.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> whose elements are the result of invoking the one-to-many transform function <paramref name="collectionSelector" /> on each element of <paramref name="source" /> and then mapping each of those sequence elements and their corresponding source element to a result element.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to project.</param>
         <param name="collectionSelector">
@@ -4687,7 +5053,6 @@
         <Parameter Name="resultSelector" Type="System.Func&lt;TSource,TCollection,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -4697,6 +5062,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Projects each element of a sequence to an <see cref="T:System.Collections.Generic.IEnumerable`1" />, flattens the resulting sequences into one sequence, and invokes a result selector function on each element therein. The index of each source element is used in the intermediate projected form of that element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> whose elements are the result of invoking the one-to-many transform function <paramref name="collectionSelector" /> on each element of <paramref name="source" /> and then mapping each of those sequence elements and their corresponding source element to a result element.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to project.</param>
         <param name="collectionSelector">
@@ -4730,7 +5099,6 @@
         <Parameter Name="second" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.SequenceEqual``1(System.Collections.Generic.IEnumerable{``0},System.Collections.Generic.IEnumerable{``0})" /> method enumerates the two source sequences in parallel and compares corresponding elements by using the default equality comparer for <paramref name="TSource" />, <see cref="P:System.Collections.Generic.EqualityComparer`1.Default" />. The default equality comparer, <see cref="P:System.Collections.Generic.EqualityComparer`1.Default" />, is used to compare values of the types that implement the <see cref="T:System.Collections.Generic.IEqualityComparer`1" /> generic interface. To compare a custom data type, you need to implement this interface and provide your own <see cref="M:System.Object.GetHashCode" /> and <see cref="M:System.Object.Equals(System.Object)" /> methods for the type.</para>
@@ -4739,6 +5107,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two sequences are equal by comparing the elements by using the default equality comparer for their type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two source sequences are of equal length and their corresponding elements are equal according to the default equality comparer for their type; otherwise, false.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to compare to <paramref name="second" />.</param>
         <param name="second">
@@ -4767,7 +5139,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.SequenceEqual``1(System.Collections.Generic.IEnumerable{``0},System.Collections.Generic.IEnumerable{``0},System.Collections.Generic.IEqualityComparer{``0})" /> method enumerates the two source sequences in parallel and compares corresponding elements by using the specified <see cref="T:System.Collections.Generic.IEqualityComparer`1" />. If c<paramref name="omparer" /> is null, the default equality comparer, <see cref="P:System.Collections.Generic.EqualityComparer`1.Default" />, is used to compare elements.</para>
@@ -4776,6 +5147,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two sequences are equal by comparing their elements by using a specified <see cref="T:System.Collections.Generic.IEqualityComparer`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two source sequences are of equal length and their corresponding elements compare equal according to <paramref name="comparer" />; otherwise, false.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to compare to <paramref name="second" />.</param>
         <param name="second">
@@ -4804,7 +5179,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Single``1(System.Collections.Generic.IEnumerable{``0})" /> method throws an exception if the input sequence is empty. To instead return null when the input sequence is empty, use <see cref="M:System.Linq.Enumerable.SingleOrDefault``1(System.Collections.Generic.IEnumerable{``0})" />.</para>
@@ -4813,6 +5187,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the only element of a sequence, and throws an exception if there is not exactly one element in the sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The single element of the input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to return the single element of.</param>
         <typeparam name="TSource">
@@ -4838,7 +5216,6 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Single``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Boolean})" /> method throws an exception if the input sequence contains no matching element. To instead return null when no matching element is found, use <see cref="M:System.Linq.Enumerable.SingleOrDefault``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Boolean})" />.</para>
@@ -4847,6 +5224,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the only element of a sequence that satisfies a specified condition, and throws an exception if more than one such element exists.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The single element of the input sequence that satisfies a condition.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to return a single element from.</param>
         <param name="predicate">
@@ -4873,7 +5254,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default value for reference and nullable types is null.</para>
@@ -4883,6 +5263,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the only element of a sequence, or a default value if the sequence is empty; this method throws an exception if there is more than one element in the sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The single element of the input sequence, or default(<paramref name="TSource" />) if the sequence contains no elements.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to return the single element of.</param>
         <typeparam name="TSource">
@@ -4908,7 +5292,6 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default value for reference and nullable types is null.</para>
@@ -4917,6 +5300,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the only element of a sequence that satisfies a specified condition or a default value if no such element exists; this method throws an exception if more than one element satisfies the condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The single element of the input sequence that satisfies the condition, or default(<paramref name="TSource" />) if no such element is found.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to return a single element from.</param>
         <param name="predicate">
@@ -4944,7 +5331,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -4956,6 +5342,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Bypasses a specified number of elements in a sequence and then returns the remaining elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> that contains the elements that occur after the specified index in the input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to return elements from.</param>
         <param name="count">
@@ -4983,7 +5373,6 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.SkipWhile``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Boolean})" /> method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -4996,6 +5385,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Bypasses elements in a sequence as long as a specified condition is true and then returns the remaining elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> that contains the elements from the input sequence starting at the first element in the linear series that does not pass the test specified by <paramref name="predicate" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to return elements from.</param>
         <param name="predicate">
@@ -5023,7 +5416,6 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Int32,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -5037,6 +5429,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Bypasses elements in a sequence as long as a specified condition is true and then returns the remaining elements. The element's index is used in the logic of the predicate function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> that contains the elements from the input sequence starting at the first element in the linear series that does not pass the test specified by <paramref name="predicate" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to return elements from.</param>
         <param name="predicate">
@@ -5060,7 +5456,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Decimal&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Sum(System.Collections.Generic.IEnumerable{System.Decimal})" /> method returns zero if <paramref name="source" /> contains no elements.</para>
@@ -5070,6 +5465,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of a sequence of <see cref="T:System.Decimal" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Decimal" /> values to calculate the sum of.</param>
       </Docs>
@@ -5089,7 +5488,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Double&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns zero if <paramref name="source" /> contains no elements.</para>
@@ -5099,6 +5497,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of a sequence of <see cref="T:System.Double" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Double" /> values to calculate the sum of.</param>
       </Docs>
@@ -5118,7 +5520,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Int32&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns zero if <paramref name="source" /> contains no elements.</para>
@@ -5128,6 +5529,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of a sequence of <see cref="T:System.Int32" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Int32" /> values to calculate the sum of.</param>
       </Docs>
@@ -5147,7 +5552,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Int64&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns zero if <paramref name="source" /> contains no elements.</para>
@@ -5157,6 +5561,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of a sequence of <see cref="T:System.Int64" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Int64" /> values to calculate the sum of.</param>
       </Docs>
@@ -5176,7 +5584,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Nullable&lt;System.Decimal&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns zero if <paramref name="source" /> contains no elements.</para>
@@ -5187,6 +5594,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of a sequence of nullable <see cref="T:System.Decimal" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Decimal" /> values to calculate the sum of.</param>
       </Docs>
@@ -5206,7 +5617,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Nullable&lt;System.Double&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns zero if <paramref name="source" /> contains no elements.</para>
@@ -5217,6 +5627,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of a sequence of nullable <see cref="T:System.Double" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Double" /> values to calculate the sum of.</param>
       </Docs>
@@ -5236,7 +5650,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Nullable&lt;System.Int32&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns zero if <paramref name="source" /> contains no elements.</para>
@@ -5247,6 +5660,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of a sequence of nullable <see cref="T:System.Int32" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Int32" /> values to calculate the sum of.</param>
       </Docs>
@@ -5266,7 +5683,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Nullable&lt;System.Int64&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns zero if <paramref name="source" /> contains no elements.</para>
@@ -5277,6 +5693,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of a sequence of nullable <see cref="T:System.Int64" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Int64" /> values to calculate the sum of.</param>
       </Docs>
@@ -5296,7 +5716,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Nullable&lt;System.Single&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns zero if <paramref name="source" /> contains no elements.</para>
@@ -5307,6 +5726,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of a sequence of nullable <see cref="T:System.Single" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Single" /> values to calculate the sum of.</param>
       </Docs>
@@ -5326,7 +5749,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Single&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns zero if <paramref name="source" /> contains no elements.</para>
@@ -5336,6 +5758,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of a sequence of <see cref="T:System.Single" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Single" /> values to calculate the sum of.</param>
       </Docs>
@@ -5359,7 +5785,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Decimal&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns zero if <paramref name="source" /> contains no elements. </para>
@@ -5370,6 +5795,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the sequence of <see cref="T:System.Decimal" /> values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate a sum.</param>
         <param name="selector">
@@ -5397,7 +5826,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Double&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns zero if <paramref name="source" /> contains no elements.</para>
@@ -5408,6 +5836,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the sequence of <see cref="T:System.Double" /> values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate a sum.</param>
         <param name="selector">
@@ -5435,7 +5867,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Int32&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns zero if <paramref name="source" /> contains no elements. </para>
@@ -5446,6 +5877,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the sequence of <see cref="T:System.Int32" /> values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate a sum.</param>
         <param name="selector">
@@ -5473,7 +5908,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Int64&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns zero if <paramref name="source" /> contains no elements. </para>
@@ -5484,6 +5918,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the sequence of <see cref="T:System.Int64" /> values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate a sum.</param>
         <param name="selector">
@@ -5511,7 +5949,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Decimal&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns zero if <paramref name="source" /> contains no elements.</para>
@@ -5523,6 +5960,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the sequence of nullable <see cref="T:System.Decimal" /> values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate a sum.</param>
         <param name="selector">
@@ -5550,7 +5991,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Double&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns zero if <paramref name="source" /> contains no elements.</para>
@@ -5562,6 +6002,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the sequence of nullable <see cref="T:System.Double" /> values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate a sum.</param>
         <param name="selector">
@@ -5589,7 +6033,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Int32&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns zero if <paramref name="source" /> contains no elements.</para>
@@ -5601,6 +6044,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the sequence of nullable <see cref="T:System.Int32" /> values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate a sum.</param>
         <param name="selector">
@@ -5628,7 +6075,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Int64&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns zero if <paramref name="source" /> contains no elements.</para>
@@ -5640,6 +6086,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the sequence of nullable <see cref="T:System.Int64" /> values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate a sum.</param>
         <param name="selector">
@@ -5667,7 +6117,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Single&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns zero if <paramref name="source" /> contains no elements.</para>
@@ -5679,6 +6128,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the sequence of nullable <see cref="T:System.Single" /> values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate a sum.</param>
         <param name="selector">
@@ -5706,7 +6159,6 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Single&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.Sum``1(System.Collections.Generic.IEnumerable{``0},System.Func{``0,System.Single})" /> method returns zero if <paramref name="source" /> contains no elements. </para>
@@ -5717,6 +6169,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the sequence of <see cref="T:System.Single" /> values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate a sum.</param>
         <param name="selector">
@@ -5744,7 +6200,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -5758,6 +6213,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a specified number of contiguous elements from the start of a sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> that contains the specified number of elements from the start of the input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to return elements from.</param>
         <param name="count">
@@ -5785,7 +6244,6 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -5797,6 +6255,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns elements from a sequence as long as a specified condition is true.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> that contains the elements from the input sequence that occur before the element at which the test no longer passes.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence to return elements from.</param>
         <param name="predicate">
@@ -5824,7 +6286,6 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Int32,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -5837,6 +6298,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns elements from a sequence as long as a specified condition is true. The element's index is used in the logic of the predicate function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> that contains elements from the input sequence that occur before the element at which the test no longer passes.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to return elements from.</param>
         <param name="predicate">
@@ -5865,7 +6330,6 @@
         <Parameter Name="keySelector" Type="System.Func&lt;TSource,TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -5883,6 +6347,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a subsequent ordering of the elements in a sequence in ascending order according to a key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IOrderedEnumerable`1" /> whose elements are sorted according to a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IOrderedEnumerable`1" /> that contains elements to sort.</param>
         <param name="keySelector">
@@ -5914,7 +6382,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -5931,6 +6398,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a subsequent ordering of the elements in a sequence in ascending order by using a specified comparer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IOrderedEnumerable`1" /> whose elements are sorted according to a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IOrderedEnumerable`1" /> that contains elements to sort.</param>
         <param name="keySelector">
@@ -5963,7 +6434,6 @@
         <Parameter Name="keySelector" Type="System.Func&lt;TSource,TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -5982,6 +6452,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a subsequent ordering of the elements in a sequence in descending order, according to a key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IOrderedEnumerable`1" /> whose elements are sorted in descending order according to a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IOrderedEnumerable`1" /> that contains elements to sort.</param>
         <param name="keySelector">
@@ -6013,7 +6487,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -6030,6 +6503,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a subsequent ordering of the elements in a sequence in descending order by using a specified comparer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IOrderedEnumerable`1" /> whose elements are sorted in descending order according to a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IOrderedEnumerable`1" /> that contains elements to sort.</param>
         <param name="keySelector">
@@ -6060,7 +6537,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.ToArray``1(System.Collections.Generic.IEnumerable{``0})" /> method forces immediate query evaluation and returns an array that contains the query results. You can append this method to your query in order to obtain a cached copy of the query results.</para>
@@ -6071,6 +6547,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an array from a <see cref="T:System.Collections.Generic.IEnumerable`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains the elements from the input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to create an array from.</param>
         <typeparam name="TSource">
@@ -6097,7 +6577,6 @@
         <Parameter Name="keySelector" Type="System.Func&lt;TSource,TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.ToDictionary``2(System.Collections.Generic.IEnumerable{``0},System.Func{``0,``1})" /> method uses the default equality comparer <see cref="P:System.Collections.Generic.EqualityComparer`1.Default" /> to compare keys.</para>
@@ -6106,6 +6585,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Collections.Generic.Dictionary`2" /> from an <see cref="T:System.Collections.Generic.IEnumerable`1" /> according to a specified key selector function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.Generic.Dictionary`2" /> that contains keys and values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to create a <see cref="T:System.Collections.Generic.Dictionary`2" /> from.</param>
         <param name="keySelector">
@@ -6137,7 +6620,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="comparer" /> is null, the default equality comparer <see cref="P:System.Collections.Generic.EqualityComparer`1.Default" /> is used to compare keys.</para>
@@ -6146,6 +6628,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Collections.Generic.Dictionary`2" /> from an <see cref="T:System.Collections.Generic.IEnumerable`1" /> according to a specified key selector function and key comparer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.Generic.Dictionary`2" /> that contains keys and values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to create a <see cref="T:System.Collections.Generic.Dictionary`2" /> from.</param>
         <param name="keySelector">
@@ -6180,7 +6666,6 @@
         <Parameter Name="elementSelector" Type="System.Func&lt;TSource,TElement&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.ToDictionary``3(System.Collections.Generic.IEnumerable{``0},System.Func{``0,``1},System.Func{``0,``2})" /> method uses the default equality comparer <see cref="P:System.Collections.Generic.EqualityComparer`1.Default" /> to compare keys.</para>
@@ -6189,6 +6674,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Collections.Generic.Dictionary`2" /> from an <see cref="T:System.Collections.Generic.IEnumerable`1" /> according to specified key selector and element selector functions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.Generic.Dictionary`2" /> that contains values of type <paramref name="TElement" /> selected from the input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to create a <see cref="T:System.Collections.Generic.Dictionary`2" /> from.</param>
         <param name="keySelector">
@@ -6226,7 +6715,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="comparer" /> is null, the default equality comparer <see cref="P:System.Collections.Generic.EqualityComparer`1.Default" /> is used to compare keys.</para>
@@ -6235,6 +6723,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Collections.Generic.Dictionary`2" /> from an <see cref="T:System.Collections.Generic.IEnumerable`1" /> according to a specified key selector function, a comparer, and an element selector function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.Generic.Dictionary`2" /> that contains values of type <paramref name="TElement" /> selected from the input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to create a <see cref="T:System.Collections.Generic.Dictionary`2" /> from.</param>
         <param name="keySelector">
@@ -6269,7 +6761,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.ToList``1(System.Collections.Generic.IEnumerable{``0})" /> method forces immediate query evaluation and returns a <see cref="T:System.Collections.Generic.List`1" /> that contains the query results. You can append this method to your query in order to obtain a cached copy of the query results.</para>
@@ -6280,6 +6771,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Collections.Generic.List`1" /> from an <see cref="T:System.Collections.Generic.IEnumerable`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.Generic.List`1" /> that contains elements from the input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.Generic.IEnumerable`1" /> to create a <see cref="T:System.Collections.Generic.List`1" /> from.</param>
         <typeparam name="TSource">
@@ -6306,7 +6801,6 @@
         <Parameter Name="keySelector" Type="System.Func&lt;TSource,TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.ToLookup``2(System.Collections.Generic.IEnumerable{``0},System.Func{``0,``1})" /> method returns a <see cref="T:System.Linq.Lookup`2" />, a one-to-many dictionary that maps keys to collections of values. A <see cref="T:System.Linq.Lookup`2" /> differs from a <see cref="T:System.Collections.Generic.Dictionary`2" />, which performs a one-to-one mapping of keys to single values.</para>
@@ -6316,6 +6810,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Lookup`2" /> from an <see cref="T:System.Collections.Generic.IEnumerable`1" /> according to a specified key selector function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Lookup`2" /> that contains keys and values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.Generic.IEnumerable`1" /> to create a <see cref="T:System.Linq.Lookup`2" /> from.</param>
         <param name="keySelector">
@@ -6347,7 +6845,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.ToLookup``2(System.Collections.Generic.IEnumerable{``0},System.Func{``0,``1},System.Collections.Generic.IEqualityComparer{``1})" /> method returns a <see cref="T:System.Linq.Lookup`2" />, a one-to-many dictionary that maps keys to collections of values. A <see cref="T:System.Linq.Lookup`2" /> is different to a <see cref="T:System.Collections.Generic.Dictionary`2" />, which performs a one-to-one mapping of keys to single values.</para>
@@ -6357,6 +6854,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Lookup`2" /> from an <see cref="T:System.Collections.Generic.IEnumerable`1" /> according to a specified key selector function and key comparer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Lookup`2" /> that contains keys and values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.Generic.IEnumerable`1" /> to create a <see cref="T:System.Linq.Lookup`2" /> from.</param>
         <param name="keySelector">
@@ -6391,7 +6892,6 @@
         <Parameter Name="elementSelector" Type="System.Func&lt;TSource,TElement&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.ToLookup``3(System.Collections.Generic.IEnumerable{``0},System.Func{``0,``1},System.Func{``0,``2})" /> method returns a <see cref="T:System.Linq.Lookup`2" />, a one-to-many dictionary that maps keys to collections of values. A <see cref="T:System.Linq.Lookup`2" /> differs from a <see cref="T:System.Collections.Generic.Dictionary`2" />, which performs a one-to-one mapping of keys to single values.</para>
@@ -6401,6 +6901,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Lookup`2" /> from an <see cref="T:System.Collections.Generic.IEnumerable`1" /> according to specified key selector and element selector functions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Lookup`2" /> that contains values of type <paramref name="TElement" /> selected from the input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.Generic.IEnumerable`1" /> to create a <see cref="T:System.Linq.Lookup`2" /> from.</param>
         <param name="keySelector">
@@ -6438,7 +6942,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Enumerable.ToLookup``3(System.Collections.Generic.IEnumerable{``0},System.Func{``0,``1},System.Func{``0,``2},System.Collections.Generic.IEqualityComparer{``1})" /> method returns a <see cref="T:System.Linq.Lookup`2" />, a one-to-many dictionary that maps keys to collections of values. A <see cref="T:System.Linq.Lookup`2" /> differs from a <see cref="T:System.Collections.Generic.Dictionary`2" />, which performs a one-to-one mapping of keys to single values.</para>
@@ -6448,6 +6951,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Linq.Lookup`2" /> from an <see cref="T:System.Collections.Generic.IEnumerable`1" /> according to a specified key selector function, a comparer and an element selector function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.Lookup`2" /> that contains values of type <paramref name="TElement" /> selected from the input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.Generic.IEnumerable`1" /> to create a <see cref="T:System.Linq.Lookup`2" /> from.</param>
         <param name="keySelector">
@@ -6483,7 +6990,6 @@
         <Parameter Name="second" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -6495,6 +7001,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces the set union of two sequences by using the default equality comparer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> that contains the elements from both input sequences, excluding duplicates.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> whose distinct elements form the first set for the union.</param>
         <param name="second">
@@ -6523,7 +7033,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -6535,6 +7044,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces the set union of two sequences by using a specified <see cref="T:System.Collections.Generic.IEqualityComparer`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> that contains the elements from both input sequences, excluding duplicates.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> whose distinct elements form the first set for the union.</param>
         <param name="second">
@@ -6564,7 +7077,6 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -6574,6 +7086,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Filters a sequence of values based on a predicate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> that contains elements from the input sequence that satisfy the condition.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to filter.</param>
         <param name="predicate">
@@ -6601,7 +7117,6 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Int32,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -6611,6 +7126,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Filters a sequence of values based on a predicate. Each element's index is used in the logic of the predicate function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> that contains elements from the input sequence that satisfy the condition.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to filter.</param>
         <param name="predicate">
@@ -6640,7 +7159,6 @@
         <Parameter Name="resultSelector" Type="System.Func&lt;TFirst,TSecond,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <unmanagedCodeEntityReference>GetEnumerator</unmanagedCodeEntityReference> method directly or by using foreach in csprcs or For Each in vbprvb.</para>
@@ -6650,6 +7168,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Applies a specified function to the corresponding elements of two sequences, producing a sequence of the results.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> that contains merged elements of two input sequences.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />The first sequence to merge.</param>
         <param name="second">
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq/EnumerableQuery`1.xml b/mcs/class/System.Core/Documentation/en/System.Linq/EnumerableQuery`1.xml
index 753d18efa01..03c5175eb51 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq/EnumerableQuery`1.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq/EnumerableQuery`1.xml
@@ -100,12 +100,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that can iterate through the associated <see cref="T:System.Collections.Generic.IEnumerable`1" /> collection, or, if it is null, through the collection that results from rewriting the associated expression tree as a query on an <see cref="T:System.Collections.Generic.IEnumerable`1" /> data source and executing it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator that can be used to iterate through the associated data source.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Linq.IQueryable.ElementType">
@@ -179,12 +182,15 @@
         <Parameter Name="expression" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Constructs a new <see cref="T:System.Linq.EnumerableQuery`1" /> object and associates it with a specified expression tree that represents an <see cref="T:System.Linq.IQueryable" /> collection of data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.EnumerableQuery`1" /> object that is associated with <paramref name="expression" />.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An expression tree that represents an <see cref="T:System.Linq.IQueryable" /> collection of data.</param>
       </Docs>
@@ -207,12 +213,15 @@
       </Parameters>
       <Docs>
         <typeparam name="TElem">To be added.</typeparam>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Constructs a new <see cref="T:System.Linq.EnumerableQuery`1" /> object and associates it with a specified expression tree that represents an <see cref="T:System.Linq.IQueryable`1" /> collection of data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An EnumerableQuery object that is associated with <paramref name="expression" />.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An expression tree to execute.</param>
       </Docs>
@@ -231,12 +240,15 @@
         <Parameter Name="expression" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes an expression after rewriting it to call <see cref="T:System.Linq.Enumerable" /> methods instead of <see cref="T:System.Linq.Queryable" /> methods on any enumerable data sources that cannot be queried by <see cref="T:System.Linq.Queryable" /> methods.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value that results from executing <paramref name="expression" />.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An expression tree to execute.</param>
       </Docs>
@@ -259,12 +271,15 @@
       </Parameters>
       <Docs>
         <typeparam name="TResult">To be added.</typeparam>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes an expression after rewriting it to call <see cref="T:System.Linq.Enumerable" /> methods instead of <see cref="T:System.Linq.Queryable" /> methods on any enumerable data sources that cannot be queried by <see cref="T:System.Linq.Queryable" /> methods.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value that results from executing <paramref name="expression" />.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An expression tree to execute.</param>
       </Docs>
@@ -281,12 +296,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a textual representation of the enumerable collection or, if it is null, of the expression tree that is associated with this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A textual representation of the enumerable collection or, if it is null, of the expression tree that is associated with this instance.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq/IQueryProvider.xml b/mcs/class/System.Core/Documentation/en/System.Linq/IQueryProvider.xml
index 98fac66767a..c17eacff089 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq/IQueryProvider.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq/IQueryProvider.xml
@@ -35,7 +35,6 @@
         <Parameter Name="expression" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -48,6 +47,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Constructs an <see cref="T:System.Linq.IQueryable" /> object that can evaluate the query represented by a specified expression tree.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable" /> that can evaluate the query represented by the specified expression tree.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An expression tree that represents a vbteclinq query.</param>
       </Docs>
@@ -70,7 +73,6 @@
         <Parameter Name="expression" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -83,6 +85,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Constructs an <see cref="T:System.Linq.IQueryable`1" /> object that can evaluate the query represented by a specified expression tree.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> that can evaluate the query represented by the specified expression tree.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An expression tree that represents a vbteclinq query.</param>
         <typeparam name="TElement">
@@ -104,7 +110,6 @@
         <Parameter Name="expression" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.IQueryProvider.Execute(System.Linq.Expressions.Expression)" /> method executes queries that return a single value (instead of an enumerable sequence of values). Expression trees that represent queries that return enumerable results are executed when their associated <see cref="T:System.Linq.IQueryable" /> object is enumerated.</para>
@@ -113,6 +118,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the query represented by a specified expression tree.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value that results from executing the specified query.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An expression tree that represents a vbteclinq query.</param>
       </Docs>
@@ -135,7 +144,6 @@
         <Parameter Name="expression" Type="System.Linq.Expressions.Expression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method executes queries that return a single value (instead of an enumerable sequence of values). Expression trees that represent queries that return enumerable results are executed when the <see cref="T:System.Linq.IQueryable`1" /> object that contains the expression tree is enumerated.</para>
@@ -145,6 +153,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the strongly-typed query represented by a specified expression tree.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value that results from executing the specified query.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An expression tree that represents a vbteclinq query.</param>
         <typeparam name="TResult">
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq/Lookup`2.xml b/mcs/class/System.Core/Documentation/en/System.Linq/Lookup`2.xml
index d5cf854d4f8..1ba184aa4f4 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq/Lookup`2.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq/Lookup`2.xml
@@ -121,12 +121,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a generic enumerator that iterates through the <see cref="T:System.Linq.Lookup`2" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator for the <see cref="T:System.Linq.Lookup`2" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Item">
@@ -163,12 +166,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the <see cref="T:System.Linq.Lookup`2" />. This class cannot be inherited.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator for the <see cref="T:System.Linq.Lookup`2" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq/OrderedParallelQuery`1.xml b/mcs/class/System.Core/Documentation/en/System.Linq/OrderedParallelQuery`1.xml
index adbffd0253c..f7c327379d4 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq/OrderedParallelQuery`1.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq/OrderedParallelQuery`1.xml
@@ -37,12 +37,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator that iterates through the sequence.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq/ParallelEnumerable.xml b/mcs/class/System.Core/Documentation/en/System.Linq/ParallelEnumerable.xml
index 207d134f9c6..56dabcc9822 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq/ParallelEnumerable.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq/ParallelEnumerable.xml
@@ -36,12 +36,15 @@
         <Parameter Name="func" Type="System.Func&lt;TSource,TSource,TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Applies in parallel an accumulator function over a sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The final accumulator value.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence to aggregate over.</param>
         <param name="func">
@@ -70,12 +73,15 @@
         <Parameter Name="func" Type="System.Func&lt;TAccumulate,TSource,TAccumulate&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Applies in parallel an accumulator function over a sequence. The specified seed value is used as the initial accumulator value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The final accumulator value.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence to aggregate over.</param>
         <param name="seed">
@@ -110,12 +116,15 @@
         <Parameter Name="resultSelector" Type="System.Func&lt;TAccumulate,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Applies in parallel an accumulator function over a sequence. The specified seed value is used as the initial accumulator value, and the specified function is used to select the result value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The transformed final accumulator value.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence to aggregate over.</param>
         <param name="seed">
@@ -155,7 +164,6 @@
         <Parameter Name="resultSelector" Type="System.Func&lt;TAccumulate,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload is specific to parallelized queries. A parallelized query may partition the data source sequence into several sub-sequences (partitions). The <paramref name="updateAccumulatorFunc" /> is invoked on each element within partitions. Each partition then yields a single accumulated result. The <paramref name="combineAccumulatorsFunc" /> is then invoked on the results of each partition to yield a single element. This element is then transformed by the <paramref name="resultSelector" /> function.</para>
@@ -164,6 +172,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Applies in parallel an accumulator function over a sequence. This overload is not available in the sequential implementation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The transformed final accumulator value.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence to aggregate over.</param>
         <param name="seedFactory">
@@ -205,7 +217,6 @@
         <Parameter Name="resultSelector" Type="System.Func&lt;TAccumulate,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload is specific to processing a parallelized query. A parallelized query may partition the data source sequence into several sub-sequences (partitions). The <paramref name="updateAccumulatorFunc" /> is invoked on each element within partitions. Each partition then yields a single accumulated result. The <paramref name="combineAccumulatorsFunc" /> is then invoked on the results of each partition to yield a single element. This element is then transformed by the <paramref name="resultSelector" /> function.</para>
@@ -214,6 +225,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Applies in parallel an accumulator function over a sequence. This overload is not available in the sequential implementation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The transformed final accumulator value.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence to aggregate over.</param>
         <param name="seed">
@@ -250,12 +265,15 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines in parallel whether all elements of a sequence satisfy a condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if every element of the source sequence passes the test in the specified predicate, or if the sequence is empty; otherwise, false..</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence whose elements to apply the predicate to.</param>
         <param name="predicate">
@@ -281,7 +299,6 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload of the Any method causes a fully-buffered merge to be performed before the result is returned. The merge behavior can impact performance or cause an out of memory exception in large enumerables. To avoid the merge behavior, use the overload of Any that takes a Func parameter, or else use an alternative method such as FirstOrDefault.</para>
@@ -290,6 +307,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a parallel sequence contains any elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the source sequence contains any elements; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to check for emptiness.</param>
         <typeparam name="TSource">
@@ -314,12 +335,15 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines in parallel whether any element of a sequence satisfies a condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if any elements in the source sequence pass the test in the specified predicate; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence to whose elements the predicate will be applied.</param>
         <param name="predicate">
@@ -345,12 +369,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a <see cref="T:System.Linq.ParallelQuery`1" /> into an <see cref="T:System.Collections.Generic.IEnumerable`1" /> to force sequential evaluation of the query.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The input sequence typed as <see cref="T:System.Collections.Generic.IEnumerable`1" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to cast as <see cref="T:System.Collections.Generic.IEnumerable`1" />.</param>
         <typeparam name="TSource">
@@ -371,7 +398,6 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A natural tension exists between performance and preserving order in parallel processing. By default, a parallelized query behaves as if the ordering of the results is arbitrary unless AsOrdered is applied or there is an explicit OrderBy operator in the query. For more information, see <format type="text/html"><a href="10d202bc-19e1-4b5c-bbf1-9a977322a9ca">Order Preservation in PLINQ</a></format>.</para>
@@ -380,6 +406,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Enables treatment of a data source as if it were ordered, overriding the default of unordered. AsOrdered may only be invoked on non-generic sequences returned by AsParallel, ParallelEnumerable.Range, and ParallelEnumerable.Repeat.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The source sequence which will maintain the original ordering in the subsequent query operators.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The input sequence.</param>
       </Docs>
@@ -401,7 +431,6 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A natural tension exists between performance and preserving order in parallel processing. By default, a parallelized query behaves as if the ordering of the results is arbitrary unless AsOrdered is applied or there is an explicit OrderBy operator in the query. For more information, see <format type="text/html"><a href="10d202bc-19e1-4b5c-bbf1-9a977322a9ca">Order Preservation in PLINQ</a></format>.</para>
@@ -410,6 +439,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Enables treatment of a data source as if it were ordered, overriding the default of unordered. AsOrdered may only be invoked on generic sequences returned by AsParallel, ParallelEnumerable.Range, and ParallelEnumerable.Repeat.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The source sequence which will maintain the original ordering in the subsequent query operators.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The input sequence.</param>
         <typeparam name="TSource">
@@ -430,7 +463,6 @@
         <Parameter Name="source" Type="System.Collections.IEnumerable" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.ParallelEnumerable.Cast``1(System.Linq.ParallelQuery)" /> operator can be used to convert a ParallelQuery to a ParallelQuery(T).</para>
@@ -439,6 +471,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Enables parallelization of a query.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The source as a ParallelQuery to bind to ParallelEnumerable extension methods.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to convert to a <see cref="T:System.Linq.ParallelQuery" />.</param>
       </Docs>
@@ -460,7 +496,6 @@
         <Parameter Name="source" Type="System.Collections.Concurrent.Partitioner&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The source partitioner's GetOrderedPartitions method is used when ordering is enabled, whereas the partitioner's GetPartitions is used if ordering is not enabled (the default). The source partitioner's GetDynamicPartitions and GetDynamicOrderedPartitions are not used. For more information and examples, see <format type="text/html"><a href="96153688-9a01-47c4-8430-909cee9a2887">Custom Partitioners for PLINQ and TPL</a></format>.</para>
@@ -469,6 +504,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Enables parallelization of a query, as sourced by a custom partitioner that is responsible for splitting the input sequence into partitions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <paramref name="source" /> as a ParallelQuery to bind to ParallelEnumerable extension methods.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A partitioner over the input sequence.</param>
         <typeparam name="TSource">
@@ -492,12 +531,15 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Enables parallelization of a query.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The source as a <see cref="T:System.Linq.ParallelQuery`1" /> to bind to ParallelEnumerable extension methods.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to convert to a <see cref="T:System.Linq.ParallelQuery`1" />.</param>
         <typeparam name="TSource">
@@ -521,7 +563,6 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information, see <format type="text/html"><a href="10d202bc-19e1-4b5c-bbf1-9a977322a9ca">Order Preservation in PLINQ</a></format> and <format type="text/html"><a href="c67eccc7-004d-4b2f-987e-919cbbd62ef7">How to: Control Ordering in a PLINQ Query</a></format>.</para>
@@ -530,6 +571,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a <see cref="T:System.Linq.ParallelQuery`1" /> into an <see cref="T:System.Collections.Generic.IEnumerable`1" /> to force sequential evaluation of the query.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The source as an <see cref="T:System.Collections.Generic.IEnumerable`1" /> to bind to sequential extension methods.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Linq.ParallelQuery`1" /> to convert to an <see cref="T:System.Collections.Generic.IEnumerable`1" />.</param>
         <typeparam name="TSource">
@@ -553,7 +598,6 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>AsUnordered may provide performance benefits when ordering is not required in a portion of a query. By default, PLINQ treats an input sequence as unordered unless OrderBy or AsOrdered is specified. However, if ordering was turned on and is no longer needed, then AsUnordered can be used to turn it off in mid-query, and this may result in performance benefits. The AsUnordered operator itself does not shuffle the source sequence; it simply removes the ordering requirement for subsequent operators. If the source is ordered, subsequent operators might keep that ordering if it is more efficient to do so. AsUnordered can be called anywhere in the query; it does not need to be called immediately after AsParallel. For more information, see <format type="text/html"><a href="53706c7e-397d-467a-98cd-c0d1fd63ba5e">Understanding Speedup in PLINQ</a></format> and <format type="text/html"><a href="10d202bc-19e1-4b5c-bbf1-9a977322a9ca">Order Preservation in PLINQ</a></format>.</para>
@@ -562,6 +606,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Allows an intermediate query to be treated as if no ordering is implied among the elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The source sequence with arbitrary order.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The input sequence.</param>
         <typeparam name="TSource">
@@ -582,12 +630,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Decimal&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the average of a sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate an average.</param>
       </Docs>
@@ -606,12 +657,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Double&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the average of a sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate an average.</param>
       </Docs>
@@ -630,12 +684,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Int32&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the average of a sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate an average.</param>
       </Docs>
@@ -654,12 +711,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Int64&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the average of a sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate an average.</param>
       </Docs>
@@ -678,12 +738,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Nullable&lt;System.Decimal&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the average of a sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate an average.</param>
       </Docs>
@@ -702,12 +765,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Nullable&lt;System.Double&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the average of a sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The source sequence.</param>
       </Docs>
@@ -726,12 +792,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Nullable&lt;System.Int32&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the average of a sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate an average.</param>
       </Docs>
@@ -750,12 +819,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Nullable&lt;System.Int64&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the average of a sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate an average.</param>
       </Docs>
@@ -774,12 +846,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Nullable&lt;System.Single&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the average of a sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate an average.</param>
       </Docs>
@@ -798,12 +873,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Single&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the average of a sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate an average.</param>
       </Docs>
@@ -826,12 +904,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Decimal&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the average of a sequence of values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate an average.</param>
         <param name="selector">
@@ -858,12 +939,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Double&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the average of a sequence of values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate an average.</param>
         <param name="selector">
@@ -890,12 +974,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Int32&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the average of a sequence of values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate an average.</param>
         <param name="selector">
@@ -922,12 +1009,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Int64&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the average of a sequence of values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate an average.</param>
         <param name="selector">
@@ -954,12 +1044,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Decimal&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the average of a sequence of values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate an average.</param>
         <param name="selector">
@@ -986,12 +1079,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Double&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the average of a sequence of values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate an average.</param>
         <param name="selector">
@@ -1018,12 +1114,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Int32&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the average of a sequence of values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate an average.</param>
         <param name="selector">
@@ -1050,12 +1149,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Int64&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the average of a sequence of values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate an average.</param>
         <param name="selector">
@@ -1082,12 +1184,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Single&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the average of a sequence of values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate an average.</param>
         <param name="selector">
@@ -1114,12 +1219,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Single&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the average of a sequence of values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate an average.</param>
         <param name="selector">
@@ -1145,12 +1253,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the elements of a ParallelQuery to the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that contains each element of the source sequence converted to the specified type.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence that contains the elements to be converted.</param>
         <typeparam name="TResult">
@@ -1180,7 +1291,6 @@
         <Parameter Name="second" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload exists to disallow usage of Concat with a left data source of type <see cref="T:System.Linq.ParallelQuery`1" /> and a right data source of type <see cref="T:System.Collections.Generic.IEnumerable`1" />. Otherwise, the Concat operator would appear to be binding to the parallel implementation, but would in reality bind to the sequential implementation.</para>
@@ -1189,6 +1299,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This Concat overload should never be called. This method is marked as obsolete and always throws <see cref="T:System.NotSupportedException" /> when called.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This overload always throws a <see cref="T:System.NotSupportedException" />.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is not used.</param>
         <param name="second">
@@ -1215,12 +1329,15 @@
         <Parameter Name="second" Type="System.Linq.ParallelQuery&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Concatenates two parallel sequences.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that contains the concatenated elements of the two input sequences.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />The first sequence to concatenate.</param>
         <param name="second">
@@ -1247,12 +1364,15 @@
         <Parameter Name="value" Type="TSource" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines in parallel whether a sequence contains a specified element by using the default equality comparer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the source sequence contains an element that has the specified value; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence in which to locate a value.</param>
         <param name="value">
@@ -1280,12 +1400,15 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines in parallel whether a sequence contains a specified element by using a specified <see cref="T:System.Collections.Generic.IEqualityComparer`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the source sequence contains an element that has the specified value; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence in which to locate a value.</param>
         <param name="value">
@@ -1313,12 +1436,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of elements in a parallel sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of elements in the input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence that contains elements to be counted.</param>
         <typeparam name="TSource">
@@ -1343,12 +1469,15 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a number that represents how many elements in the specified parallel sequence satisfy a condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A number that represents how many elements in the sequence satisfy the condition in the predicate function.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence that contains elements to be counted.</param>
         <param name="predicate">
@@ -1374,12 +1503,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the elements of the specified parallel sequence or the type parameter's default value in a singleton collection if the sequence is empty.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that contains default(TSource) if <paramref name="source" /> is empty; otherwise, <paramref name="source" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to return a default value for if it is empty.</param>
         <typeparam name="TSource">
@@ -1404,12 +1536,15 @@
         <Parameter Name="defaultValue" Type="TSource" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the elements of the specified parallel sequence or the specified value in a singleton collection if the sequence is empty.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that contains defaultValue if <paramref name="source" /> is empty; otherwise, <paramref name="source" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to return the specified value for if it is empty.</param>
         <param name="defaultValue">
@@ -1435,12 +1570,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns distinct elements from a parallel sequence by using the default equality comparer to compare values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that contains distinct elements from the source sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to remove duplicate elements from.</param>
         <typeparam name="TSource">
@@ -1465,12 +1603,15 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns distinct elements from a parallel sequence by using a specified <see cref="T:System.Collections.Generic.IEqualityComparer`1" /> to compare values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that contains distinct elements from the source sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to remove duplicate elements from.</param>
         <param name="comparer">
@@ -1497,12 +1638,15 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the element at a specified index in a parallel sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The element at the specified position in the source sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence to return an element from.</param>
         <param name="index">
@@ -1529,12 +1673,15 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the element at a specified index in a parallel sequence or a default value if the index is out of range.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>default(TSource) if the index is outside the bounds of the source sequence; otherwise, the element at the specified position in the source sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence to return an element from.</param>
         <param name="index">
@@ -1558,12 +1705,15 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an empty ParallelQuery{TResult} that has the specified type argument.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An empty sequence whose type argument is <paramref name="TResult" />.</para>
+        </returns>
         <typeparam name="TResult">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to assign to the type parameter of the returned generic sequence.</typeparam>
       </Docs>
@@ -1591,7 +1741,6 @@
         <Parameter Name="second" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload exists to disallow usage of Except with a left data source of type <see cref="T:System.Linq.ParallelQuery`1" /> and a right data source of type <see cref="T:System.Collections.Generic.IEnumerable`1" />. Otherwise, the Except operator would appear to be binding to the parallel implementation, but would in reality bind to the sequential implementation.</para>
@@ -1600,6 +1749,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This Except overload should never be called. This method is marked as obsolete and always throws <see cref="T:System.NotSupportedException" /> when called.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This overload always throws a <see cref="T:System.NotSupportedException" />.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is not used.</param>
         <param name="second">
@@ -1626,12 +1779,15 @@
         <Parameter Name="second" Type="System.Linq.ParallelQuery&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces the set difference of two parallel sequences by using the default equality comparer to compare values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that contains the set difference of the elements of two sequences.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence whose elements that are not also in <paramref name="second" /> will be returned.</param>
         <param name="second">
@@ -1664,7 +1820,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload exists to disallow usage of Except with a left data source of type <see cref="T:System.Linq.ParallelQuery`1" /> and a right data source of type <see cref="T:System.Collections.Generic.IEnumerable`1" />. Otherwise, the Except operator would appear to be binding to the parallel implementation, but would in reality bind to the sequential implementation.</para>
@@ -1673,6 +1828,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This Except overload should never be called. This method is marked as obsolete and always throws <see cref="T:System.NotSupportedException" /> when called.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This overload always throws a <see cref="T:System.NotSupportedException" />.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is not used.</param>
         <param name="second">
@@ -1702,12 +1861,15 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces the set difference of two parallel sequences by using the specified <see cref="T:System.Collections.Generic.IEqualityComparer`1" /> to compare values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that contains the set difference of the elements of two sequences.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence whose elements that are not also in <paramref name="second" /> will be returned.</param>
         <param name="second">
@@ -1736,7 +1898,6 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the query is not ordered, then the first element is non-deterministic. For more information, see <format type="text/html"><a href="10d202bc-19e1-4b5c-bbf1-9a977322a9ca">Order Preservation in PLINQ</a></format>.</para>
@@ -1745,6 +1906,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the first element of a parallel sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first element in the specified sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to return the first element of.</param>
         <typeparam name="TSource">
@@ -1769,7 +1934,6 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the query is not ordered, then the first element is non-deterministic. For more information, see <format type="text/html"><a href="10d202bc-19e1-4b5c-bbf1-9a977322a9ca">Order Preservation in PLINQ</a></format>.</para>
@@ -1778,6 +1942,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the first element in a parallel sequence that satisfies a specified condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first element in the sequence that passes the test in the specified predicate function.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to return an element from.</param>
         <param name="predicate">
@@ -1803,7 +1971,6 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the query is not ordered, then the first element is non-deterministic. For more information, see <format type="text/html"><a href="10d202bc-19e1-4b5c-bbf1-9a977322a9ca">Order Preservation in PLINQ</a></format>.</para>
@@ -1812,6 +1979,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the first element of a parallel sequence, or a default value if the sequence contains no elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>default(TSource) if <paramref name="source" /> is empty; otherwise, the first element in <paramref name="source" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to return the first element of.</param>
         <typeparam name="TSource">
@@ -1836,7 +2007,6 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the query is not ordered, then the first element is non-deterministic. For more information, see <format type="text/html"><a href="10d202bc-19e1-4b5c-bbf1-9a977322a9ca">Order Preservation in PLINQ</a></format>.</para>
@@ -1845,6 +2015,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the first element of the parallel sequence that satisfies a condition or a default value if no such element is found.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>default(TSource) if <paramref name="source" /> is empty or if no element passes the test specified by predicate; otherwise, the first element in <paramref name="source" /> that passes the test specified by predicate.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to return an element from.</param>
         <param name="predicate">
@@ -1906,12 +2080,15 @@
         <Parameter Name="keySelector" Type="System.Func&lt;TSource,TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Groups in parallel the elements of a sequence according to a specified key selector function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence of groups that are sorted descending according to <paramref name="TKey" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An OrderedParallelQuery{TSource}that contains elements to sort.</param>
         <param name="keySelector">
@@ -1942,12 +2119,15 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Groups in parallel the elements of a sequence according to a specified key selector function and compares the keys by using a specified <see cref="T:System.Collections.Generic.IComparer`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence of groups that are sorted descending according to <paramref name="TKey" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.OrderedParallelQuery`1" /> that contains elements to sort.</param>
         <param name="keySelector">
@@ -1981,12 +2161,15 @@
         <Parameter Name="elementSelector" Type="System.Func&lt;TSource,TElement&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Groups in parallel the elements of a sequence according to a specified key selector function and projects the elements for each group by using a specified function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence of groups that are sorted descending according to <paramref name="TKey" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.OrderedParallelQuery`1" /> that contains elements to sort.</param>
         <param name="keySelector">
@@ -2023,12 +2206,15 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Groups in parallel the elements of a sequence according to a key selector function. The keys are compared by using a comparer and each group's elements are projected by using a specified function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence of groups that are sorted descending according to <paramref name="TKey" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An OrderedParallelQuery{TSource}that contains elements to sort.</param>
         <param name="keySelector">
@@ -2066,12 +2252,15 @@
         <Parameter Name="resultSelector" Type="System.Func&lt;TKey,System.Collections.Generic.IEnumerable&lt;TSource&gt;,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Groups in parallel the elements of a sequence according to a specified key selector function and creates a result value from each group and its key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence of elements of type <paramref name="TResult" /> where each element represents a projection over a group and its key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence whose elements to group.</param>
         <param name="keySelector">
@@ -2108,12 +2297,15 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Groups in parallel the elements of a sequence according to a specified key selector function and creates a result value from each group and its key. The keys are compared by using a specified comparer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence of groups.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence whose elements to group.</param>
         <param name="keySelector">
@@ -2153,12 +2345,15 @@
         <Parameter Name="resultSelector" Type="System.Func&lt;TKey,System.Collections.Generic.IEnumerable&lt;TElement&gt;,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Groups in parallel the elements of a sequence according to a specified key selector function and creates a result value from each group and its key. The elements of each group are projected by using a specified function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence of elements of type <paramref name="TResult" /> where each element represents a projection over a group and its key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence whose elements to group.</param>
         <param name="keySelector">
@@ -2201,12 +2396,15 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Groups the elements of a sequence according to a specified key selector function and creates a result value from each group and its key. Key values are compared by using a specified comparer, and the elements of each group are projected by using a specified function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence of elements of type <paramref name="TResult" /> where each element represents a projection over a group and its key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence whose elements to group.</param>
         <param name="keySelector">
@@ -2256,7 +2454,6 @@
         <Parameter Name="resultSelector" Type="System.Func&lt;TOuter,System.Collections.Generic.IEnumerable&lt;TInner&gt;,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload exists to disallow usage of GroupJoin with a left data source of type <see cref="T:System.Linq.ParallelQuery`1" /> and a right data source of type <see cref="T:System.Collections.Generic.IEnumerable`1" />. Otherwise, the GroupJoin operator would appear to be binding to the parallel implementation, but would in reality bind to the sequential implementation.</para>
@@ -2265,6 +2462,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This GroupJoin overload should never be called. This method is marked as obsolete and always throws <see cref="T:System.NotSupportedException" /> when called.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This overload always throws a <see cref="T:System.NotSupportedException" />.</para>
+        </returns>
         <param name="outer">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is not used.</param>
         <param name="inner">
@@ -2309,12 +2510,15 @@
         <Parameter Name="resultSelector" Type="System.Func&lt;TOuter,System.Collections.Generic.IEnumerable&lt;TInner&gt;,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Correlates in parallel the elements of two sequences based on equality of keys and groups the results. The default equality comparer is used to compare keys.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that has elements of type <paramref name="TResult" /> that are obtained by performing a grouped join on two sequences.</para>
+        </returns>
         <param name="outer">
           <attribution license="cc4" from="Microsoft" modified="false" />The first sequence to join.</param>
         <param name="inner">
@@ -2365,7 +2569,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload exists to disallow usage of GroupJoin with a left data source of type <see cref="T:System.Linq.ParallelQuery`1" /> and a right data source of type <see cref="T:System.Collections.Generic.IEnumerable`1" />. Otherwise, the GroupJoin operator would appear to be binding to the parallel implementation, but would in reality bind to the sequential implementation.</para>
@@ -2374,6 +2577,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This GroupJoin overload should never be called. This method is marked as obsolete and always throws <see cref="T:System.NotSupportedException" /> when called.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This overload always throws a <see cref="T:System.NotSupportedException" />.</para>
+        </returns>
         <param name="outer">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is not used.</param>
         <param name="inner">
@@ -2421,12 +2628,15 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Correlates in parallel the elements of two sequences based on key equality and groups the results. A specified <see cref="T:System.Collections.Generic.IEqualityComparer`1" /> is used to compare keys.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that has elements of type <paramref name="TResult" /> that are obtained by performing a grouped join on two sequences.</para>
+        </returns>
         <param name="outer">
           <attribution license="cc4" from="Microsoft" modified="false" />The first sequence to join.</param>
         <param name="inner">
@@ -2472,7 +2682,6 @@
         <Parameter Name="second" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload exists to disallow usage of Intersect with a left data source of type <see cref="T:System.Linq.ParallelQuery`1" /> and a right data source of type <see cref="T:System.Collections.Generic.IEnumerable`1" />. Otherwise, the Intersect operator would appear to be binding to the parallel implementation, but would in reality bind to the sequential implementation.</para>
@@ -2481,6 +2690,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This Intersect overload should never be called. This method is marked as obsolete and always throws <see cref="T:System.NotSupportedException" /> when called.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This overload always throws a <see cref="T:System.NotSupportedException" />.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is not used.</param>
         <param name="second">
@@ -2507,12 +2720,15 @@
         <Parameter Name="second" Type="System.Linq.ParallelQuery&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces the set intersection of two parallel sequences by using the default equality comparer to compare values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that contains the elements that form the set intersection of two sequences.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence whose distinct elements that also appear in <paramref name="second" /> will be returned.</param>
         <param name="second">
@@ -2545,7 +2761,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload exists to disallow usage of Intersect with a left data source of type <see cref="T:System.Linq.ParallelQuery`1" /> and a right data source of type <see cref="T:System.Collections.Generic.IEnumerable`1" />. Otherwise, the Intersect operator would appear to be binding to the parallel implementation, but would in reality bind to the sequential implementation.</para>
@@ -2554,6 +2769,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This Intersect overload should never be called. This method is marked as obsolete and always throws <see cref="T:System.NotSupportedException" /> when called.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This overload always throws a <see cref="T:System.NotSupportedException" />.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is not used.</param>
         <param name="second">
@@ -2583,12 +2802,15 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces the set intersection of two parallel sequences by using the specified IEqualityComparer{T} to compare values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that contains the elements that form the set intersection of two sequences.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence whose distinct elements that also appear in <paramref name="second" /> will be returned.</param>
         <param name="second">
@@ -2628,7 +2850,6 @@
         <Parameter Name="resultSelector" Type="System.Func&lt;TOuter,TInner,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload exists to disallow usage Join with a left data source of type <see cref="T:System.Linq.ParallelQuery`1" /> and a right data source of type <see cref="T:System.Collections.Generic.IEnumerable`1" />. Otherwise, the Join operator would appear to be binding to the parallel implementation, but would in reality bind to the sequential implementation.</para>
@@ -2637,6 +2858,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This Join overload should never be called. This method is marked as obsolete and always throws <see cref="T:System.NotSupportedException" /> when invoked.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This overload always throws a <see cref="T:System.NotSupportedException" />.</para>
+        </returns>
         <param name="outer">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is not used.</param>
         <param name="inner">
@@ -2681,12 +2906,15 @@
         <Parameter Name="resultSelector" Type="System.Func&lt;TOuter,TInner,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Correlates in parallel the elements of two sequences based on matching keys. The default equality comparer is used to compare keys.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that has elements of type <paramref name="TResult" /> that are obtained by performing an inner join on two sequences.</para>
+        </returns>
         <param name="outer">
           <attribution license="cc4" from="Microsoft" modified="false" />The first sequence to join.</param>
         <param name="inner">
@@ -2737,7 +2965,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload exists to disallow usage of Join with a left data source of type <see cref="T:System.Linq.ParallelQuery`1" /> and a right data source of type <see cref="T:System.Collections.Generic.IEnumerable`1" />. Otherwise, the Join operator would appear to be binding to the parallel implementation, but would in reality bind to the sequential implementation.</para>
@@ -2746,6 +2973,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This Join overload should never be called. This method is marked as obsolete and always throws <see cref="T:System.NotSupportedException" /> when invoked.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This overload always throws a <see cref="T:System.NotSupportedException" />.</para>
+        </returns>
         <param name="outer">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is not used.</param>
         <param name="inner">
@@ -2793,12 +3024,15 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Correlates in parallel the elements of two sequences based on matching keys. A specified <see cref="T:System.Collections.Generic.IEqualityComparer`1" /> is used to compare keys.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that has elements of type <paramref name="TResult" /> that are obtained by performing an inner join on two sequences.</para>
+        </returns>
         <param name="outer">
           <attribution license="cc4" from="Microsoft" modified="false" />The first sequence to join.</param>
         <param name="inner">
@@ -2838,7 +3072,6 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the query is not ordered, then the last element is non-deterministic. For more information, see <format type="text/html"><a href="10d202bc-19e1-4b5c-bbf1-9a977322a9ca">Order Preservation in PLINQ</a></format>.</para>
@@ -2847,6 +3080,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the last element of a parallel sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value at the last position in the source sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to return the last element from.</param>
         <typeparam name="TSource">
@@ -2871,7 +3108,6 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the query is not ordered, then the last element is non-deterministic. For more information, see <format type="text/html"><a href="10d202bc-19e1-4b5c-bbf1-9a977322a9ca">Order Preservation in PLINQ</a></format>.</para>
@@ -2880,6 +3116,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the last element of a parallel sequence that satisfies a specified condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The last element in the sequence that passes the test in the specified predicate function.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to return an element from.</param>
         <param name="predicate">
@@ -2905,7 +3145,6 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the query is not ordered, then the last element is non-deterministic. For more information, see <format type="text/html"><a href="10d202bc-19e1-4b5c-bbf1-9a977322a9ca">Order Preservation in PLINQ</a></format>.</para>
@@ -2914,6 +3153,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the last element of a parallel sequence, or a default value if the sequence contains no elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>default() if the source sequence is empty; otherwise, the last element in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to return an element from.</param>
         <typeparam name="TSource">
@@ -2938,7 +3181,6 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the query is not ordered, then the last element is non-deterministic. For more information, see <format type="text/html"><a href="10d202bc-19e1-4b5c-bbf1-9a977322a9ca">Order Preservation in PLINQ</a></format>.</para>
@@ -2947,6 +3189,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the last element of a parallel sequence that satisfies a condition, or a default value if no such element is found.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>default() if the sequence is empty or if no elements pass the test in the predicate function; otherwise, the last element that passes the test in the predicate function.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to return an element from.</param>
         <param name="predicate">
@@ -2972,12 +3218,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an Int64 that represents the total number of elements in a parallel sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of elements in the input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence that contains elements to be counted.</param>
         <typeparam name="TSource">
@@ -3002,12 +3251,15 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an Int64 that represents how many elements in a parallel sequence satisfy a condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A number that represents how many elements in the sequence satisfy the condition in the predicate function.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence that contains elements to be counted.</param>
         <param name="predicate">
@@ -3030,12 +3282,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Decimal&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the maximum value in a parallel sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
       </Docs>
@@ -3054,12 +3309,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Double&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the maximum value in a parallel sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
       </Docs>
@@ -3078,12 +3336,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Int32&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the maximum value in a parallel sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
       </Docs>
@@ -3102,12 +3363,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Int64&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the maximum value in a parallel sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
       </Docs>
@@ -3126,12 +3390,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Nullable&lt;System.Decimal&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the maximum value in a parallel sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
       </Docs>
@@ -3150,12 +3417,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Nullable&lt;System.Double&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the maximum value in a parallel sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
       </Docs>
@@ -3174,12 +3444,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Nullable&lt;System.Int32&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the maximum value in a parallel sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
       </Docs>
@@ -3198,12 +3471,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Nullable&lt;System.Int64&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the maximum value in a parallel sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
       </Docs>
@@ -3222,12 +3498,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Nullable&lt;System.Single&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the maximum value in a parallel sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
       </Docs>
@@ -3246,12 +3525,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Single&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the maximum value in a parallel sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
       </Docs>
@@ -3273,12 +3555,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the maximum value in a parallel sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
         <typeparam name="TSource">
@@ -3303,12 +3588,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Decimal&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes in parallel a transform function on each element of a sequence and returns the maximum value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
         <param name="selector">
@@ -3335,12 +3623,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Double&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes in parallel a transform function on each element of a sequence and returns the maximum value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
         <param name="selector">
@@ -3367,12 +3658,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Int32&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes in parallel a transform function on each element of a sequence and returns the maximum value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
         <param name="selector">
@@ -3399,12 +3693,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Int64&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes in parallel a transform function on each element of a sequence and returns the maximum value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
         <param name="selector">
@@ -3431,12 +3728,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Decimal&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes in parallel a transform function on each element of a sequence and returns the maximum value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
         <param name="selector">
@@ -3463,12 +3763,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Double&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes in parallel a transform function on each element of a sequence and returns the maximum value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
         <param name="selector">
@@ -3495,12 +3798,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Int32&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes in parallel a transform function on each element of a sequence and returns the maximum value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
         <param name="selector">
@@ -3527,12 +3833,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Int64&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes in parallel a transform function on each element of a sequence and returns the maximum value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
         <param name="selector">
@@ -3559,12 +3868,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Single&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes in parallel a transform function on each element of a sequence and returns the maximum value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
         <param name="selector">
@@ -3591,12 +3903,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Single&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes in parallel a transform function on each element of a sequence and returns the maximum value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
         <param name="selector">
@@ -3624,12 +3939,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes in parallel a transform function on each element of a sequence and returns the maximum value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum value of.</param>
         <param name="selector">
@@ -3654,12 +3972,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Decimal&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the minimum value in a parallel sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
       </Docs>
@@ -3678,12 +3999,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Double&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the minimum value in a parallel sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
       </Docs>
@@ -3702,12 +4026,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Int32&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the minimum value in a parallel sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
       </Docs>
@@ -3726,12 +4053,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Int64&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the minimum value in a parallel sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
       </Docs>
@@ -3750,12 +4080,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Nullable&lt;System.Decimal&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the minimum value in a parallel sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
       </Docs>
@@ -3774,12 +4107,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Nullable&lt;System.Double&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the minimum value in a parallel sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
       </Docs>
@@ -3798,12 +4134,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Nullable&lt;System.Int32&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the minimum value in a parallel sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
       </Docs>
@@ -3822,12 +4161,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Nullable&lt;System.Int64&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the minimum value in a parallel sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
       </Docs>
@@ -3846,12 +4188,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Nullable&lt;System.Single&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the minimum value in a parallel sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
       </Docs>
@@ -3870,12 +4215,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Single&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the minimum value in a parallel sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
       </Docs>
@@ -3897,12 +4245,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the minimum value in a parallel sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
         <typeparam name="TSource">
@@ -3927,12 +4278,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Decimal&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes in parallel a transform function on each element of a sequence and returns the minimum value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
         <param name="selector">
@@ -3959,12 +4313,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Double&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes in parallel a transform function on each element of a sequence and returns the minimum value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
         <param name="selector">
@@ -3991,12 +4348,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Int32&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes in parallel a transform function on each element of a sequence and returns the minimum value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
         <param name="selector">
@@ -4023,12 +4383,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Int64&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes in parallel a transform function on each element of a sequence and returns the minimum value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
         <param name="selector">
@@ -4055,12 +4418,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Decimal&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes in parallel a transform function on each element of a sequence and returns the minimum value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
         <param name="selector">
@@ -4087,12 +4453,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Double&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes in parallel a transform function on each element of a sequence and returns the minimum value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
         <param name="selector">
@@ -4119,12 +4488,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Int32&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes in parallel a transform function on each element of a sequence and returns the minimum value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
         <param name="selector">
@@ -4151,12 +4523,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Int64&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes in parallel a transform function on each element of a sequence and returns the minimum value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
         <param name="selector">
@@ -4183,12 +4558,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Single&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes in parallel a transform function on each element of a sequence and returns the minimum value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
         <param name="selector">
@@ -4215,12 +4593,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Single&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes in parallel a transform function on each element of a sequence and returns the minimum value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
         <param name="selector">
@@ -4248,12 +4629,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes in parallel a transform function on each element of a sequence and returns the minimum value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum value of.</param>
         <param name="selector">
@@ -4281,12 +4665,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Filters the elements of a ParallelQuery based on a specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that contains elements from the input sequence of type .</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence whose elements to filter.</param>
         <typeparam name="TResult">
@@ -4312,7 +4699,6 @@
         <Parameter Name="keySelector" Type="System.Func&lt;TSource,TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In contrast to the sequential implementation, this is not a stable sort. To achieve a stable sort, change a query of the form: var ordered = source.Select((e,i) =&gt; new { E=e, I=i }).OrderBy((v) =&gt; v.e).ThenBy(v =&gt; v.i).Select((v) =&gt; v.e); </para>
@@ -4321,6 +4707,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sorts in parallel the elements of a sequence in ascending order according to a key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An OrderedParallelQuery{TSource} whose elements are sorted according to a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to order.</param>
         <param name="keySelector">
@@ -4351,7 +4741,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In contrast to the sequential implementation, this is not a stable sort. See the remarks for <see cref="M:System.Linq.ParallelEnumerable.OrderBy``2(System.Linq.ParallelQuery{``0},System.Func{``0,``1})" /> for an approach to implementing a stable sort.</para>
@@ -4360,6 +4749,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sorts in parallel the elements of a sequence in ascending order by using a specified comparer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An OrderedParallelQuery{TSource} whose elements are sorted according to a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to order.</param>
         <param name="keySelector">
@@ -4391,7 +4784,6 @@
         <Parameter Name="keySelector" Type="System.Func&lt;TSource,TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In contrast to the sequential implementation, this is not a stable sort. See the remarks for <see cref="M:System.Linq.ParallelEnumerable.OrderBy``2(System.Linq.ParallelQuery{``0},System.Func{``0,``1})" /> for an approach to implementing a stable sort.</para>
@@ -4400,6 +4792,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sorts in parallel the elements of a sequence in descending order according to a key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An OrderedParallelQuery{TSource} whose elements are sorted descending according to a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to order.</param>
         <param name="keySelector">
@@ -4430,7 +4826,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In contrast to the sequential implementation, this is not a stable sort. See the remarks for <see cref="M:System.Linq.ParallelEnumerable.OrderBy``2(System.Linq.ParallelQuery{``0},System.Func{``0,``1})" /> for an approach to implementing a stable sort.</para>
@@ -4439,6 +4834,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sorts the elements of a sequence in descending order by using a specified comparer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An OrderedParallelQuery{TSource} whose elements are sorted descending according to a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to order.</param>
         <param name="keySelector">
@@ -4466,12 +4865,15 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a parallel sequence of integral numbers within a specified range.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An IEnumerable&lt;Int32&gt; in C# or IEnumerable(Of Int32) in Visual Basic that contains a range of sequential integral numbers.</para>
+        </returns>
         <param name="start">
           <attribution license="cc4" from="Microsoft" modified="false" />The value of the first integer in the sequence.</param>
         <param name="count">
@@ -4521,12 +4923,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inverts the order of the elements in a parallel sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence whose elements correspond to those of the input sequence in reverse order.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to reverse.</param>
         <typeparam name="TSource">
@@ -4552,12 +4957,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Int32,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Projects in parallel each element of a sequence into a new form by incorporating the element's index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence whose elements are the result of invoking the transform function on each element of <paramref name="source" />, based on the index supplied to <paramref name="selector" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to invoke a transform function on.</param>
         <param name="selector">
@@ -4587,12 +4995,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Projects in parallel each element of a sequence into a new form.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence whose elements are the result of invoking the transform function on each element of <paramref name="source" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to invoke a transform function on.</param>
         <param name="selector">
@@ -4622,12 +5033,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Collections.Generic.IEnumerable&lt;TResult&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Projects in parallel each element of a sequence to an <see cref="T:System.Collections.Generic.IEnumerable`1" /> and flattens the resulting sequences into one sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence whose elements are the result of invoking the one-to-many transform function on each element of the input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to project.</param>
         <param name="selector">
@@ -4657,12 +5071,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Int32,System.Collections.Generic.IEnumerable&lt;TResult&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Projects in parallel each element of a sequence to an <see cref="T:System.Collections.Generic.IEnumerable`1" />, and flattens the resulting sequences into one sequence. The index of each source element is used in the projected form of that element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence whose elements are the result of invoking the one-to-many transform function on each element of the input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to project.</param>
         <param name="selector">
@@ -4694,12 +5111,15 @@
         <Parameter Name="resultSelector" Type="System.Func&lt;TSource,TCollection,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Projects each element of a sequence to an <see cref="T:System.Collections.Generic.IEnumerable`1" />, flattens the resulting sequences into one sequence, and invokes a result selector function on each element therein.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence whose elements are the result of invoking the one-to-many transform function <paramref name="collectionSelector" /> on each element of <paramref name="source" /> based on the index supplied to <paramref name="collectionSelector" />, and then mapping each of those sequence elements and their corresponding source element to a result element. </para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to project.</param>
         <param name="collectionSelector">
@@ -4735,12 +5155,15 @@
         <Parameter Name="resultSelector" Type="System.Func&lt;TSource,TCollection,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Projects each element of a sequence to an <see cref="T:System.Collections.Generic.IEnumerable`1" />, flattens the resulting sequences into one sequence, and invokes a result selector function on each element therein. The index of each source element is used in the intermediate projected form of that element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence whose elements are the result of invoking the one-to-many transform function <paramref name="collectionSelector" /> on each element of <paramref name="source" /> based on the index supplied to <paramref name="collectionSelector" />, and then mapping each of those sequence elements and their corresponding source element to a result element.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to project.</param>
         <param name="collectionSelector">
@@ -4778,7 +5201,6 @@
         <Parameter Name="second" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload exists to disallow usage of SequenceEqual with a left data source of type <see cref="T:System.Linq.ParallelQuery`1" /> and a right data source of type <see cref="T:System.Collections.Generic.IEnumerable`1" />. Otherwise, the SequenceEqual operator would appear to be binding to the parallel implementation, but would in reality bind to the sequential implementation.</para>
@@ -4787,6 +5209,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This SequenceEqual overload should never be called. This method is marked as obsolete and always throws <see cref="T:System.NotSupportedException" /> when called.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This overload always throws a <see cref="T:System.NotSupportedException" />.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is not used.</param>
         <param name="second">
@@ -4813,12 +5239,15 @@
         <Parameter Name="second" Type="System.Linq.ParallelQuery&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two parallel sequences are equal by comparing the elements by using the default equality comparer for their type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two source sequences are of equal length and their corresponding elements are equal according to the default equality comparer for their type; otherwise, false.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence to compare to second.</param>
         <param name="second">
@@ -4851,7 +5280,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload exists to disallow usage of SequenceEqual with a left data source of type <see cref="T:System.Linq.ParallelQuery`1" /> and a right data source of type <see cref="T:System.Collections.Generic.IEnumerable`1" />. Otherwise, the SequenceEqual operator would appear to be binding to the parallel implementation, but would in reality bind to sequential implementation.</para>
@@ -4860,6 +5288,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This SequenceEqual overload should never be called. This method is marked as obsolete and always throws <see cref="T:System.NotSupportedException" /> when called.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This overload always throws a <see cref="T:System.NotSupportedException" />.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is not used.</param>
         <param name="second">
@@ -4889,12 +5321,15 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two parallel sequences are equal by comparing their elements by using a specified IEqualityComparer{T}.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two source sequences are of equal length and their corresponding elements are equal according to the default equality comparer for their type; otherwise, false.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence to compare to <paramref name="second" />.</param>
         <param name="second">
@@ -4922,12 +5357,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the only element of a parallel sequence, and throws an exception if there is not exactly one element in the sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The single element of the input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to return the single element of.</param>
         <typeparam name="TSource">
@@ -4952,12 +5390,15 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the only element of a parallel sequence that satisfies a specified condition, and throws an exception if more than one such element exists.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The single element of the input sequence that satisfies a condition.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to return the single element of.</param>
         <param name="predicate">
@@ -4983,12 +5424,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the only element of a parallel sequence, or a default value if the sequence is empty; this method throws an exception if there is more than one element in the sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The single element of the input sequence, or default() if the sequence contains no elements.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to return the single element of.</param>
         <typeparam name="TSource">
@@ -5013,12 +5457,15 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the only element of a parallel sequence that satisfies a specified condition or a default value if no such element exists; this method throws an exception if more than one element satisfies the condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The single element of the input sequence that satisfies the condition, or default() if no such element is found.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to return the single element of.</param>
         <param name="predicate">
@@ -5045,7 +5492,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If count &gt; source.Count(), no elements are returned.</para>
@@ -5054,6 +5500,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Bypasses a specified number of elements in a parallel sequence and then returns the remaining elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that contains the elements that occur after the specified index in the input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to return elements from.</param>
         <param name="count">
@@ -5080,12 +5530,15 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Bypasses elements in a parallel sequence as long as a specified condition is true and then returns the remaining elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that contains the elements from the input sequence starting at the first element in the linear series that does not pass the test specified by predicate.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to return elements from.</param>
         <param name="predicate">
@@ -5112,12 +5565,15 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Int32,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Bypasses elements in a parallel sequence as long as a specified condition is true and then returns the remaining elements. The element's index is used in the logic of the predicate function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that contains the elements from the input sequence starting at the first element in the linear series that does not pass the test specified by predicate.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to return elements from.</param>
         <param name="predicate">
@@ -5140,12 +5596,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Decimal&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the sum of a sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the sum of.</param>
       </Docs>
@@ -5164,12 +5623,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Double&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the sum of a sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the sum of.</param>
       </Docs>
@@ -5188,12 +5650,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Int32&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the sum of a sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the sum of.</param>
       </Docs>
@@ -5212,12 +5677,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Int64&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the sum of a sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the sum of.</param>
       </Docs>
@@ -5236,12 +5704,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Nullable&lt;System.Decimal&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the sum of a sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the sum of.</param>
       </Docs>
@@ -5260,12 +5731,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Nullable&lt;System.Double&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the sum of a sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the sum of.</param>
       </Docs>
@@ -5284,12 +5758,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Nullable&lt;System.Int32&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the sum of a sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the sum of.</param>
       </Docs>
@@ -5308,12 +5785,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Nullable&lt;System.Int64&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the sum of a sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the sum of.</param>
       </Docs>
@@ -5332,12 +5812,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Nullable&lt;System.Single&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the sum of a sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the sum of.</param>
       </Docs>
@@ -5356,12 +5839,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;System.Single&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the sum of a sequence of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the sum of.</param>
       </Docs>
@@ -5384,12 +5870,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Decimal&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the sum of the sequence of values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the sum of.</param>
         <param name="selector">
@@ -5416,12 +5905,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Double&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the sum of the sequence of values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the sum of.</param>
         <param name="selector">
@@ -5448,12 +5940,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Int32&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the sum of the sequence of values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the sum of.</param>
         <param name="selector">
@@ -5480,12 +5975,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Int64&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the sum of the sequence of values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the sum of.</param>
         <param name="selector">
@@ -5512,12 +6010,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Decimal&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the sum of the sequence of values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the sum of.</param>
         <param name="selector">
@@ -5544,12 +6045,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Double&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the sum of the sequence of values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the sum of.</param>
         <param name="selector">
@@ -5576,12 +6080,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Int32&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the sum of the sequence of values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the sum of.</param>
         <param name="selector">
@@ -5608,12 +6115,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Int64&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the sum of the sequence of values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the sum of.</param>
         <param name="selector">
@@ -5640,12 +6150,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Nullable&lt;System.Single&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the sum of the sequence of values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the sum of.</param>
         <param name="selector">
@@ -5672,12 +6185,15 @@
         <Parameter Name="selector" Type="System.Func&lt;TSource,System.Single&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes in parallel the sum of the sequence of values that are obtained by invoking a transform function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the sum of.</param>
         <param name="selector">
@@ -5704,12 +6220,15 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a specified number of contiguous elements from the start of a parallel sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that contains the specified number of elements from the start of the input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to return elements from.</param>
         <param name="count">
@@ -5736,12 +6255,15 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns elements from a parallel sequence as long as a specified condition is true.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that contains the elements from the input sequence that occur before the element at which the test no longer passes.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to return elements from.</param>
         <param name="predicate">
@@ -5768,12 +6290,15 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Int32,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns elements from a parallel sequence as long as a specified condition is true. The element's index is used in the logic of the predicate function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that contains elements from the input sequence that occur before the element at which the test no longer passes.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to return elements from.</param>
         <param name="predicate">
@@ -5801,7 +6326,6 @@
         <Parameter Name="keySelector" Type="System.Func&lt;TSource,TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In contrast to the sequential implementation, this is not a stable sort. See the remarks for <see cref="M:System.Linq.ParallelEnumerable.OrderBy``2(System.Linq.ParallelQuery{``0},System.Func{``0,``1})" /> for an approach to implementing a stable sort.</para>
@@ -5810,6 +6334,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs in parallel a subsequent ordering of the elements in a sequence in ascending order according to a key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An OrderedParallelQuery{TSource} whose elements are sorted according to a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An OrderedParallelQuery{TSource} that contains elements to sort.</param>
         <param name="keySelector">
@@ -5840,7 +6368,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In contrast to the sequential implementation, this is not a stable sort. See the remarks for <see cref="M:System.Linq.ParallelEnumerable.OrderBy``2(System.Linq.ParallelQuery{``0},System.Func{``0,``1})" /> for an approach to implementing a stable sort.</para>
@@ -5849,6 +6376,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs in parallel a subsequent ordering of the elements in a sequence in ascending order by using a specified comparer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An OrderedParallelQuery{TSource} whose elements are sorted according to a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An OrderedParallelQuery{TSource} that contains elements to sort.</param>
         <param name="keySelector">
@@ -5880,7 +6411,6 @@
         <Parameter Name="keySelector" Type="System.Func&lt;TSource,TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In contrast to the sequential implementation, this is not a stable sort. See the remarks for <see cref="M:System.Linq.ParallelEnumerable.OrderBy``2(System.Linq.ParallelQuery{``0},System.Func{``0,``1})" /> for an approach to implementing a stable sort.</para>
@@ -5889,6 +6419,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs in parallel a subsequent ordering of the elements in a sequence in descending order, according to a key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence whose elements are sorted descending according to a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An OrderedParallelQuery{TSource} that contains elements to sort.</param>
         <param name="keySelector">
@@ -5919,7 +6453,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In contrast to the sequential implementation, this is not a stable sort. See the remarks for <see cref="M:System.Linq.ParallelEnumerable.OrderBy``2(System.Linq.ParallelQuery{``0},System.Func{``0,``1})" /> for an approach to implementing a stable sort.</para>
@@ -5928,6 +6461,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs in parallel a subsequent ordering of the elements in a sequence in descending order by using a specified comparer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence whose elements are sorted descending according to a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An OrderedParallelQuery{TSource} that contains elements to sort.</param>
         <param name="keySelector">
@@ -5957,12 +6494,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an array from a <see cref="T:System.Linq.ParallelQuery`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains the elements from the input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence to create an array from.</param>
         <typeparam name="TSource">
@@ -5988,12 +6528,15 @@
         <Parameter Name="keySelector" Type="System.Func&lt;TSource,TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Collections.Generic.Dictionary`2" /> from a <see cref="T:System.Linq.ParallelQuery`1" /> according to a specified key selector function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.Generic.Dictionary`2" /> that contains keys and values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence to create a <see cref="T:System.Collections.Generic.Dictionary`2" /> from.</param>
         <param name="keySelector">
@@ -6024,12 +6567,15 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Collections.Generic.Dictionary`2" />  from a <see cref="T:System.Linq.ParallelQuery`1" /> according to a specified key selector function and key comparer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.Generic.Dictionary`2" /> that contains keys and values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence to create a <see cref="T:System.Collections.Generic.Dictionary`2" /> from.</param>
         <param name="keySelector">
@@ -6063,12 +6609,15 @@
         <Parameter Name="elementSelector" Type="System.Func&lt;TSource,TElement&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Collections.Generic.Dictionary`2" /> from a <see cref="T:System.Linq.ParallelQuery`1" /> according to specified key selector and element selector functions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.Generic.Dictionary`2" /> that contains values of type <paramref name="TElement" /> selected from the input sequence</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence to create a <see cref="T:System.Collections.Generic.Dictionary`2" /> from.</param>
         <param name="keySelector">
@@ -6105,12 +6654,15 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Collections.Generic.Dictionary`2" /> from a <see cref="T:System.Linq.ParallelQuery`1" /> according to a specified key selector function, a comparer, and an element selector function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.Generic.Dictionary`2" /> that contains values of type <paramref name="TElement" /> selected from the input sequence</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence to create a <see cref="T:System.Collections.Generic.Dictionary`2" /> from.</param>
         <param name="keySelector">
@@ -6144,12 +6696,15 @@
         <Parameter Name="source" Type="System.Linq.ParallelQuery&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Collections.Generic.List`1" /> from an <see cref="T:System.Linq.ParallelQuery`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.Generic.List`1" />  that contains elements from the input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence to create a <see cref="T:System.Collections.Generic.List`1" /> from.</param>
         <typeparam name="TSource">
@@ -6175,12 +6730,15 @@
         <Parameter Name="keySelector" Type="System.Func&lt;TSource,TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Linq.ILookup`2" /> from a <see cref="T:System.Linq.ParallelQuery`1" /> according to a specified key selector function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.ILookup`2" /> that contains keys and values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to create a <see cref="T:System.Linq.ILookup`2" /> from.</param>
         <param name="keySelector">
@@ -6211,12 +6769,15 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Linq.ILookup`2" /> from a <see cref="T:System.Linq.ParallelQuery`1" /> according to a specified key selector function and key comparer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.ILookup`2" /> that contains keys and values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to create a <see cref="T:System.Linq.ILookup`2" /> from.</param>
         <param name="keySelector">
@@ -6250,12 +6811,15 @@
         <Parameter Name="elementSelector" Type="System.Func&lt;TSource,TElement&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Linq.ILookup`2" /> from a <see cref="T:System.Linq.ParallelQuery`1" /> according to specified key selector and element selector functions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Linq.ILookup`2" /> that contains values of type <paramref name="TElement" /> selected from the input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to create a <see cref="T:System.Linq.ILookup`2" /> from.</param>
         <param name="keySelector">
@@ -6292,12 +6856,15 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Linq.ILookup`2" /> from a <see cref="T:System.Linq.ParallelQuery`1" /> according to a specified key selector function, a comparer and an element selector function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Lookup&lt;(Of &lt;(TKey, TElement&gt;)&gt;) that contains values of type TElement selected from the input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to create a <see cref="T:System.Linq.ILookup`2" /> from.</param>
         <param name="keySelector">
@@ -6337,7 +6904,6 @@
         <Parameter Name="second" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload exists to disallow usage of Union with a left data source of type <see cref="T:System.Linq.ParallelQuery`1" /> and a right data source of type <see cref="T:System.Collections.Generic.IEnumerable`1" />. Otherwise, the Union operator would appear to be binding to the parallel implementation, but would in reality bind to sequential implementation.</para>
@@ -6346,6 +6912,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This Union overload should never be called. This method is marked as obsolete and always throws <see cref="T:System.NotSupportedException" /> when called.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This overload always throws a <see cref="T:System.NotSupportedException" />.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is not used.</param>
         <param name="second">
@@ -6372,12 +6942,15 @@
         <Parameter Name="second" Type="System.Linq.ParallelQuery&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces the set union of two parallel sequences by using the default equality comparer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that contains the elements from both input sequences, excluding duplicates.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence whose distinct elements form the first set for the union.</param>
         <param name="second">
@@ -6410,7 +6983,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload exists to disallow usage of Union with a left data source of type <see cref="T:System.Linq.ParallelQuery`1" /> and a right data source of type <see cref="T:System.Collections.Generic.IEnumerable`1" />. Otherwise, the Union operator would appear to be binding to the parallel implementation, but would in reality bind to the sequential implementation.</para>
@@ -6419,6 +6991,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This Union overload should never be called. This method is marked as obsolete and always throws <see cref="T:System.NotSupportedException" /> when called.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This overload always throws a <see cref="T:System.NotSupportedException" />.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is not used.</param>
         <param name="second">
@@ -6448,12 +7024,15 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces the set union of two parallel sequences by using a specified IEqualityComparer{T}.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that contains the elements from both input sequences, excluding duplicates.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence whose distinct elements form the first set for the union.</param>
         <param name="second">
@@ -6482,12 +7061,15 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Filters in parallel a sequence of values based on a predicate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that contains elements from the input sequence that satisfy the condition.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence to filter.</param>
         <param name="predicate">
@@ -6514,12 +7096,15 @@
         <Parameter Name="predicate" Type="System.Func&lt;TSource,System.Int32,System.Boolean&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Filters in parallel a sequence of values based on a predicate. Each element's index is used in the logic of the predicate function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that contains elements from the input sequence that satisfy the condition.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence to filter.</param>
         <param name="predicate">
@@ -6546,12 +7131,15 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the <see cref="T:System.Threading.CancellationToken" /> to associate with the query.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>ParallelQuery representing the same query as source, but with the registered cancellation token.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A ParallelQuery on which to set the option.</param>
         <param name="cancellationToken">
@@ -6578,12 +7166,15 @@
         <Parameter Name="degreeOfParallelism" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the degree of parallelism to use in a query. Degree of parallelism is the maximum number of concurrently executing tasks that will be used to process the query.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>ParallelQuery representing the same query as source, with the limit on the degrees of parallelism set.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A ParallelQuery on which to set the limit on the degrees of parallelism.</param>
         <param name="degreeOfParallelism">
@@ -6610,7 +7201,6 @@
         <Parameter Name="executionMode" Type="System.Linq.ParallelExecutionMode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The execution mode specifies whether PLINQ will attempt to fall back to sequential execution if it detects certain query shapes. For more information and examples, see <format type="text/html"><a href="e52ff26c-c5d3-4fab-9fec-c937fb387963">How to: Specify the Execution Mode in PLINQ</a></format>.</para>
@@ -6619,6 +7209,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the execution mode of the query.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>ParallelQuery representing the same query as source, but with the registered execution mode.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A ParallelQuery on which to set the option.</param>
         <param name="executionMode">
@@ -6645,12 +7239,15 @@
         <Parameter Name="mergeOptions" Type="System.Linq.ParallelMergeOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the merge options for this query, which specify how the query will buffer output.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>ParallelQuery representing the same query as source, but with the registered merge options.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A ParallelQuery on which to set the option.</param>
         <param name="mergeOptions">
@@ -6685,7 +7282,6 @@
         <Parameter Name="resultSelector" Type="System.Func&lt;TFirst,TSecond,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload exists to disallow usage of Zip with a left data source of type <see cref="T:System.Linq.ParallelQuery`1" /> and a right data source of type <see cref="T:System.Collections.Generic.IEnumerable`1" />. Otherwise, the Zip operator would appear to be bind to the parallel implementation, but would in reality bind to the sequential implementation.</para>
@@ -6694,6 +7290,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This Zip overload should never be called. This method is marked as obsolete and always throws <see cref="T:System.NotSupportedException" /> when invoked.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This overload always throws a <see cref="T:System.NotSupportedException" />.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is not used.</param>
         <param name="second">
@@ -6729,12 +7329,15 @@
         <Parameter Name="resultSelector" Type="System.Func&lt;TFirst,TSecond,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Merges in parallel two sequences by using the specified predicate function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that has elements of type <paramref name="TResult" /> that are obtained by performing <paramref name="resultSelector" /> pairwise on two sequences. If the sequence lengths are unequal, this truncates to the length of the shorter sequence.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />The first sequence to zip.</param>
         <param name="second">
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq/ParallelQuery.xml b/mcs/class/System.Core/Documentation/en/System.Linq/ParallelQuery.xml
index daca1eb9a81..6da5105ec9a 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq/ParallelQuery.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq/ParallelQuery.xml
@@ -34,12 +34,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator that iterates through the sequence.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq/ParallelQuery`1.xml b/mcs/class/System.Core/Documentation/en/System.Linq/ParallelQuery`1.xml
index 7a18c1a063c..8294f1af178 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq/ParallelQuery`1.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq/ParallelQuery`1.xml
@@ -38,12 +38,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator that iterates through the sequence.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IEnumerable.GetEnumerator">
diff --git a/mcs/class/System.Core/Documentation/en/System.Linq/Queryable.xml b/mcs/class/System.Core/Documentation/en/System.Linq/Queryable.xml
index eaf603214fb..cdab368e33f 100644
--- a/mcs/class/System.Core/Documentation/en/System.Linq/Queryable.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Linq/Queryable.xml
@@ -44,7 +44,6 @@
         <Parameter Name="func" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,TSource,TSource&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -56,6 +55,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Applies an accumulator function over a sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The final accumulator value.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence to aggregate over.</param>
         <param name="func">
@@ -85,7 +88,6 @@
         <Parameter Name="func" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TAccumulate,TSource,TAccumulate&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -97,6 +99,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Applies an accumulator function over a sequence. The specified seed value is used as the initial accumulator value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The final accumulator value.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence to aggregate over.</param>
         <param name="seed">
@@ -132,7 +138,6 @@
         <Parameter Name="selector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TAccumulate,TResult&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -144,6 +149,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Applies an accumulator function over a sequence. The specified seed value is used as the initial accumulator value, and the specified function is used to select the result value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The transformed final accumulator value.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence to aggregate over.</param>
         <param name="seed">
@@ -179,7 +188,6 @@
         <Parameter Name="predicate" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Boolean&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -190,6 +198,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether all the elements of a sequence satisfy a condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if every element of the source sequence passes the test in the specified predicate, or if the sequence is empty; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence whose elements to test for a condition.</param>
         <param name="predicate">
@@ -216,7 +228,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Any``1(System.Linq.IQueryable{``0})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Any``1(System.Linq.IQueryable{``0})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -226,6 +237,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a sequence contains any elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the source sequence contains any elements; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence to check for being empty.</param>
         <typeparam name="TSource">
@@ -251,7 +266,6 @@
         <Parameter Name="predicate" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Boolean&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -262,6 +276,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether any element of a sequence satisfies a condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if any elements in the source sequence pass the test in the specified predicate; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence whose elements to test for a condition.</param>
         <param name="predicate">
@@ -285,7 +303,6 @@
         <Parameter Name="source" Type="System.Collections.IEnumerable" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the type of <paramref name="source" /> implements <see cref="T:System.Linq.IQueryable`1" />, <see cref="M:System.Linq.Queryable.AsQueryable(System.Collections.IEnumerable)" /> returns it directly. Otherwise, it returns an <see cref="T:System.Linq.IQueryable`1" /> that executes queries by calling the equivalent query operator methods in <see cref="T:System.Linq.Enumerable" /> instead of those in <see cref="T:System.Linq.Queryable" />.</para>
@@ -295,6 +312,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an <see cref="T:System.Collections.IEnumerable" /> to an <see cref="T:System.Linq.IQueryable" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable" /> that represents the input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence to convert.</param>
       </Docs>
@@ -317,7 +338,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;TElement&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the type of <paramref name="source" /> implements <see cref="T:System.Linq.IQueryable`1" />, <see cref="M:System.Linq.Queryable.AsQueryable``1(System.Collections.Generic.IEnumerable{``0})" /> returns it directly. Otherwise, it returns an <see cref="T:System.Linq.IQueryable`1" /> that executes queries by calling the equivalent query operator methods in <see cref="T:System.Linq.Enumerable" /> instead of those in <see cref="T:System.Linq.Queryable" />.</para>
@@ -326,6 +346,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a generic <see cref="T:System.Collections.Generic.IEnumerable`1" /> to a generic <see cref="T:System.Linq.IQueryable`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> that represents the input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence to convert.</param>
         <typeparam name="TElement">
@@ -347,7 +371,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;System.Decimal&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Average(System.Linq.IQueryable{System.Decimal})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Average(System.Linq.IQueryable{System.Decimal})" /> itself. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -357,6 +380,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of <see cref="T:System.Decimal" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Decimal" /> values to calculate the average of.</param>
       </Docs>
@@ -376,7 +403,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;System.Double&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Average(System.Linq.IQueryable{System.Double})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Average(System.Linq.IQueryable{System.Double})" /> itself. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -386,6 +412,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of <see cref="T:System.Double" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Double" /> values to calculate the average of.</param>
       </Docs>
@@ -405,7 +435,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;System.Int32&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Average(System.Linq.IQueryable{System.Int32})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Average(System.Linq.IQueryable{System.Int32})" /> itself. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -415,6 +444,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of <see cref="T:System.Int32" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Int32" /> values to calculate the average of.</param>
       </Docs>
@@ -434,7 +467,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;System.Int64&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Average(System.Linq.IQueryable{System.Int64})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Average(System.Linq.IQueryable{System.Int64})" /> itself. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -444,6 +476,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of <see cref="T:System.Int64" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Int64" /> values to calculate the average of.</param>
       </Docs>
@@ -463,7 +499,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;System.Nullable&lt;System.Decimal&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Average(System.Linq.IQueryable{System.Nullable{System.Decimal}})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Average(System.Linq.IQueryable{System.Nullable{System.Decimal}})" /> itself. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -473,6 +508,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of nullable <see cref="T:System.Decimal" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values, or null if the source sequence is empty or contains only null values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Decimal" /> values to calculate the average of.</param>
       </Docs>
@@ -492,7 +531,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;System.Nullable&lt;System.Double&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Average(System.Linq.IQueryable{System.Nullable{System.Double}})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Average(System.Linq.IQueryable{System.Nullable{System.Double}})" /> itself. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -502,6 +540,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of nullable <see cref="T:System.Double" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values, or null if the source sequence is empty or contains only null values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Double" /> values to calculate the average of.</param>
       </Docs>
@@ -521,7 +563,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;System.Nullable&lt;System.Int32&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Average(System.Linq.IQueryable{System.Nullable{System.Int32}})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Average(System.Linq.IQueryable{System.Nullable{System.Int32}})" /> itself. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -531,6 +572,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of nullable <see cref="T:System.Int32" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values, or null if the source sequence is empty or contains only null values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Int32" /> values to calculate the average of.</param>
       </Docs>
@@ -550,7 +595,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;System.Nullable&lt;System.Int64&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Average(System.Linq.IQueryable{System.Nullable{System.Int64}})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Average(System.Linq.IQueryable{System.Nullable{System.Int64}})" /> itself. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -560,6 +604,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of nullable <see cref="T:System.Int64" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values, or null if the source sequence is empty or contains only null values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Int64" /> values to calculate the average of.</param>
       </Docs>
@@ -579,7 +627,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;System.Nullable&lt;System.Single&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Average(System.Linq.IQueryable{System.Nullable{System.Single}})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Average(System.Linq.IQueryable{System.Nullable{System.Single}})" /> itself. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -589,6 +636,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of nullable <see cref="T:System.Single" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values, or null if the source sequence is empty or contains only null values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Single" /> values to calculate the average of.</param>
       </Docs>
@@ -608,7 +659,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;System.Single&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Average(System.Linq.IQueryable{System.Single})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Average(System.Linq.IQueryable{System.Single})" /> itself. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -618,6 +668,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of <see cref="T:System.Single" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Single" /> values to calculate the average of.</param>
       </Docs>
@@ -641,7 +695,6 @@
         <Parameter Name="selector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Decimal&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -652,6 +705,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of <see cref="T:System.Decimal" /> values that is obtained by invoking a projection function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values that are used to calculate an average.</param>
         <param name="selector">
@@ -679,7 +736,6 @@
         <Parameter Name="selector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Double&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -690,6 +746,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of <see cref="T:System.Double" /> values that is obtained by invoking a projection function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the average of.</param>
         <param name="selector">
@@ -717,7 +777,6 @@
         <Parameter Name="selector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Int32&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -728,6 +787,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of <see cref="T:System.Int32" /> values that is obtained by invoking a projection function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the average of.</param>
         <param name="selector">
@@ -755,7 +818,6 @@
         <Parameter Name="selector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Int64&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -766,6 +828,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of <see cref="T:System.Int64" /> values that is obtained by invoking a projection function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the average of.</param>
         <param name="selector">
@@ -793,7 +859,6 @@
         <Parameter Name="selector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Nullable&lt;System.Decimal&gt;&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -804,6 +869,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of nullable <see cref="T:System.Decimal" /> values that is obtained by invoking a projection function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values, or null if the <paramref name="source" /> sequence is empty or contains only null values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the average of.</param>
         <param name="selector">
@@ -831,7 +900,6 @@
         <Parameter Name="selector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Nullable&lt;System.Double&gt;&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -842,6 +910,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of nullable <see cref="T:System.Double" /> values that is obtained by invoking a projection function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values, or null if the <paramref name="source" /> sequence is empty or contains only null values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the average of.</param>
         <param name="selector">
@@ -869,7 +941,6 @@
         <Parameter Name="selector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Nullable&lt;System.Int32&gt;&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -880,6 +951,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of nullable <see cref="T:System.Int32" /> values that is obtained by invoking a projection function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values, or null if the <paramref name="source" /> sequence is empty or contains only null values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the average of.</param>
         <param name="selector">
@@ -907,7 +982,6 @@
         <Parameter Name="selector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Nullable&lt;System.Int64&gt;&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -918,6 +992,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of nullable <see cref="T:System.Int64" /> values that is obtained by invoking a projection function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values, or null if the <paramref name="source" /> sequence is empty or contains only null values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the average of.</param>
         <param name="selector">
@@ -945,7 +1023,6 @@
         <Parameter Name="selector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Nullable&lt;System.Single&gt;&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -956,6 +1033,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of nullable <see cref="T:System.Single" /> values that is obtained by invoking a projection function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values, or null if the <paramref name="source" /> sequence is empty or contains only null values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the average of.</param>
         <param name="selector">
@@ -983,7 +1064,6 @@
         <Parameter Name="selector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Single&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -994,6 +1074,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the average of a sequence of <see cref="T:System.Single" /> values that is obtained by invoking a projection function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The average of the sequence of values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to calculate the average of.</param>
         <param name="selector">
@@ -1020,7 +1104,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Cast``1(System.Linq.IQueryable)" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Cast``1(System.Linq.IQueryable)" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.CreateQuery(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -1030,6 +1113,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the elements of an <see cref="T:System.Linq.IQueryable" /> to the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> that contains each element of the source sequence converted to the specified type.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.IQueryable" /> that contains the elements to be converted.</param>
         <typeparam name="TResult">
@@ -1055,7 +1142,6 @@
         <Parameter Name="source2" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Concat``1(System.Linq.IQueryable{``0},System.Collections.Generic.IEnumerable{``0})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Concat``1(System.Linq.IQueryable{``0},System.Collections.Generic.IEnumerable{``0})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.CreateQuery``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source1" /> parameter.</para>
@@ -1065,6 +1151,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Concatenates two sequences.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> that contains the concatenated elements of the two input sequences.</para>
+        </returns>
         <param name="source1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first sequence to concatenate.</param>
         <param name="source2">
@@ -1092,7 +1182,6 @@
         <Parameter Name="item" Type="TSource" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Contains``1(System.Linq.IQueryable{``0},``0)" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Contains``1(System.Linq.IQueryable{``0},``0)" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -1102,6 +1191,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a sequence contains a specified element by using the default equality comparer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the input sequence contains an element that has the specified value; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> in which to locate <paramref name="item" />.</param>
         <param name="item">
@@ -1130,7 +1223,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Contains``1(System.Linq.IQueryable{``0},``0,System.Collections.Generic.IEqualityComparer{``0})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Contains``1(System.Linq.IQueryable{``0},``0,System.Collections.Generic.IEqualityComparer{``0})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -1140,6 +1232,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a sequence contains a specified element by using a specified <see cref="T:System.Collections.Generic.IEqualityComparer`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the input sequence contains an element that has the specified value; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> in which to locate <paramref name="item" />.</param>
         <param name="item">
@@ -1168,7 +1264,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Count``1(System.Linq.IQueryable{``0})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Count``1(System.Linq.IQueryable{``0})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -1178,6 +1273,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of elements in a sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of elements in the input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.IQueryable`1" /> that contains the elements to be counted.</param>
         <typeparam name="TSource">
@@ -1203,7 +1302,6 @@
         <Parameter Name="predicate" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Boolean&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -1214,6 +1312,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of elements in the specified sequence that satisfies a condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of elements in the sequence that satisfies the condition in the predicate function.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> that contains the elements to be counted.</param>
         <param name="predicate">
@@ -1240,7 +1342,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.DefaultIfEmpty``1(System.Linq.IQueryable{``0})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.DefaultIfEmpty``1(System.Linq.IQueryable{``0})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.CreateQuery``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -1250,6 +1351,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the elements of the specified sequence or the type parameter's default value in a singleton collection if the sequence is empty.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> that contains default(<paramref name="TSource" />) if <paramref name="source" /> is empty; otherwise, <paramref name="source" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.IQueryable`1" /> to return a default value for if empty.</param>
         <typeparam name="TSource">
@@ -1275,7 +1380,6 @@
         <Parameter Name="defaultValue" Type="TSource" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.DefaultIfEmpty``1(System.Linq.IQueryable{``0},``0)" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.DefaultIfEmpty``1(System.Linq.IQueryable{``0},``0)" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.CreateQuery``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -1285,6 +1389,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the elements of the specified sequence or the specified value in a singleton collection if the sequence is empty.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> that contains <paramref name="defaultValue" /> if <paramref name="source" /> is empty; otherwise, <paramref name="source" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.IQueryable`1" /> to return the specified value for if empty.</param>
         <param name="defaultValue">
@@ -1311,7 +1419,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Distinct``1(System.Linq.IQueryable{``0})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Distinct``1(System.Linq.IQueryable{``0})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.CreateQuery``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -1321,6 +1428,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns distinct elements from a sequence by using the default equality comparer to compare values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> that contains distinct elements from <paramref name="source" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.IQueryable`1" /> to remove duplicates from.</param>
         <typeparam name="TSource">
@@ -1346,7 +1457,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Distinct``1(System.Linq.IQueryable{``0},System.Collections.Generic.IEqualityComparer{``0})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Distinct``1(System.Linq.IQueryable{``0},System.Collections.Generic.IEqualityComparer{``0})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.CreateQuery``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -1356,6 +1466,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns distinct elements from a sequence by using a specified <see cref="T:System.Collections.Generic.IEqualityComparer`1" /> to compare values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> that contains distinct elements from <paramref name="source" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.IQueryable`1" /> to remove duplicates from.</param>
         <param name="comparer">
@@ -1383,7 +1497,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.ElementAt``1(System.Linq.IQueryable{``0},System.Int32)" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.ElementAt``1(System.Linq.IQueryable{``0},System.Int32)" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -1393,6 +1506,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the element at a specified index in a sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The element at the specified position in <paramref name="source" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> to return an element from.</param>
         <param name="index">
@@ -1420,7 +1537,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.ElementAtOrDefault``1(System.Linq.IQueryable{``0},System.Int32)" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.ElementAtOrDefault``1(System.Linq.IQueryable{``0},System.Int32)" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -1430,6 +1546,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the element at a specified index in a sequence or a default value if the index is out of range.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <unmanagedCodeEntityReference>default</unmanagedCodeEntityReference>(<paramref name="TSource" />) if <paramref name="index" /> is outside the bounds of <paramref name="source" />; otherwise, the element at the specified position in <paramref name="source" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> to return an element from.</param>
         <param name="index">
@@ -1457,7 +1578,6 @@
         <Parameter Name="source2" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Except``1(System.Linq.IQueryable{``0},System.Collections.Generic.IEnumerable{``0})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Except``1(System.Linq.IQueryable{``0},System.Collections.Generic.IEnumerable{``0})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.CreateQuery``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the<paramref name="source1" /> parameter.</para>
@@ -1467,6 +1587,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces the set difference of two sequences by using the default equality comparer to compare values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> that contains the set difference of the two sequences.</para>
+        </returns>
         <param name="source1">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> whose elements that are not also in <paramref name="source2" /> will be returned.</param>
         <param name="source2">
@@ -1495,7 +1619,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Except``1(System.Linq.IQueryable{``0},System.Collections.Generic.IEnumerable{``0},System.Collections.Generic.IEqualityComparer{``0})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Except``1(System.Linq.IQueryable{``0},System.Collections.Generic.IEnumerable{``0},System.Collections.Generic.IEqualityComparer{``0})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.CreateQuery``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the<paramref name="source1" /> parameter.</para>
@@ -1505,6 +1628,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces the set difference of two sequences by using the specified <see cref="T:System.Collections.Generic.IEqualityComparer`1" /> to compare values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> that contains the set difference of the two sequences.</para>
+        </returns>
         <param name="source1">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> whose elements that are not also in <paramref name="source2" /> will be returned.</param>
         <param name="source2">
@@ -1533,7 +1660,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.First``1(System.Linq.IQueryable{``0})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.First``1(System.Linq.IQueryable{``0})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -1543,6 +1669,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the first element of a sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first element in <paramref name="source" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.IQueryable`1" /> to return the first element of.</param>
         <typeparam name="TSource">
@@ -1568,7 +1698,6 @@
         <Parameter Name="predicate" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Boolean&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -1579,6 +1708,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the first element of a sequence that satisfies a specified condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first element in <paramref name="source" /> that passes the test in <paramref name="predicate" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> to return an element from.</param>
         <param name="predicate">
@@ -1605,7 +1738,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.FirstOrDefault``1(System.Linq.IQueryable{``0})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.FirstOrDefault``1(System.Linq.IQueryable{``0})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -1616,6 +1748,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the first element of a sequence, or a default value if the sequence contains no elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <unmanagedCodeEntityReference>default</unmanagedCodeEntityReference>(<paramref name="TSource" />) if <paramref name="source" /> is empty; otherwise, the first element in <paramref name="source" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Linq.IQueryable`1" /> to return the first element of.</param>
         <typeparam name="TSource">
@@ -1641,7 +1778,6 @@
         <Parameter Name="predicate" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Boolean&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -1652,6 +1788,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the first element of a sequence that satisfies a specified condition or a default value if no such element is found.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <unmanagedCodeEntityReference>default</unmanagedCodeEntityReference>(<paramref name="TSource" />) if <paramref name="source" /> is empty or if no element passes the test specified by <paramref name="predicate" />; otherwise, the first element in <paramref name="source" /> that passes the test specified by <paramref name="predicate" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> to return an element from.</param>
         <param name="predicate">
@@ -1680,7 +1821,6 @@
         <Parameter Name="keySelector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,TKey&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -1691,6 +1831,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Groups the elements of a sequence according to a specified key selector function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <unmanagedCodeEntityReference>IQueryable&lt;IGrouping&lt;TKey, TSource&gt;&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>IQueryable(Of IGrouping(Of TKey, TSource))</unmanagedCodeEntityReference> in vbprvb where each <see cref="T:System.Linq.IGrouping`2" /> object contains a sequence of objects and a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> whose elements to group.</param>
         <param name="keySelector">
@@ -1722,7 +1866,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -1733,6 +1876,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Groups the elements of a sequence according to a specified key selector function and compares the keys by using a specified comparer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <unmanagedCodeEntityReference>IQueryable&lt;IGrouping&lt;TKey, TSource&gt;&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>IQueryable(Of IGrouping(Of TKey, TSource))</unmanagedCodeEntityReference> in vbprvb where each <see cref="T:System.Linq.IGrouping`2" /> contains a sequence of objects and a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> whose elements to group.</param>
         <param name="keySelector">
@@ -1767,7 +1914,6 @@
         <Parameter Name="elementSelector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,TElement&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -1778,6 +1924,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Groups the elements of a sequence according to a specified key selector function and projects the elements for each group by using a specified function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <unmanagedCodeEntityReference>IQueryable&lt;IGrouping&lt;TKey, TElement&gt;&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>IQueryable(Of IGrouping(Of TKey, TElement))</unmanagedCodeEntityReference> in vbprvb where each <see cref="T:System.Linq.IGrouping`2" /> contains a sequence of objects of type <paramref name="TElement" /> and a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> whose elements to group.</param>
         <param name="keySelector">
@@ -1815,7 +1965,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -1826,6 +1975,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Groups the elements of a sequence and projects the elements for each group by using a specified function. Key values are compared by using a specified comparer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <unmanagedCodeEntityReference>IQueryable&lt;IGrouping&lt;TKey, TElement&gt;&gt;</unmanagedCodeEntityReference> in C# or <unmanagedCodeEntityReference>IQueryable(Of IGrouping(Of TKey, TElement))</unmanagedCodeEntityReference> in vbprvb where each <see cref="T:System.Linq.IGrouping`2" /> contains a sequence of objects of type <paramref name="TElement" /> and a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> whose elements to group.</param>
         <param name="keySelector">
@@ -1864,7 +2017,6 @@
         <Parameter Name="resultSelector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TKey,System.Collections.Generic.IEnumerable&lt;TSource&gt;,TResult&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -1875,6 +2027,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Groups the elements of a sequence according to a specified key selector function and creates a result value from each group and its key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <unmanagedCodeEntityReference>T:System.Linq.IQueryable`1</unmanagedCodeEntityReference> that has a type argument of <paramref name="TResult" /> and where each element represents a projection over a group and its key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> whose elements to group.</param>
         <param name="keySelector">
@@ -1912,7 +2068,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -1923,6 +2078,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Groups the elements of a sequence according to a specified key selector function and creates a result value from each group and its key. Keys are compared by using a specified comparer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <unmanagedCodeEntityReference>T:System.Linq.IQueryable`1</unmanagedCodeEntityReference> that has a type argument of <paramref name="TResult" /> and where each element represents a projection over a group and its key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> whose elements to group.</param>
         <param name="keySelector">
@@ -1963,7 +2122,6 @@
         <Parameter Name="resultSelector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TKey,System.Collections.Generic.IEnumerable&lt;TElement&gt;,TResult&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -1974,6 +2132,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Groups the elements of a sequence according to a specified key selector function and creates a result value from each group and its key. The elements of each group are projected by using a specified function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <unmanagedCodeEntityReference>T:System.Linq.IQueryable`1</unmanagedCodeEntityReference> that has a type argument of <paramref name="TResult" /> and where each element represents a projection over a group and its key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> whose elements to group.</param>
         <param name="keySelector">
@@ -2017,7 +2179,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -2028,6 +2189,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Groups the elements of a sequence according to a specified key selector function and creates a result value from each group and its key. Keys are compared by using a specified comparer and the elements of each group are projected by using a specified function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <unmanagedCodeEntityReference>T:System.Linq.IQueryable`1</unmanagedCodeEntityReference> that has a type argument of <paramref name="TResult" /> and where each element represents a projection over a group and its key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> whose elements to group.</param>
         <param name="keySelector">
@@ -2073,7 +2238,6 @@
         <Parameter Name="resultSelector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TOuter,System.Collections.Generic.IEnumerable&lt;TInner&gt;,TResult&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -2084,6 +2248,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Correlates the elements of two sequences based on key equality and groups the results. The default equality comparer is used to compare keys.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> that contains elements of type <paramref name="TResult" /> obtained by performing a grouped join on two sequences.</para>
+        </returns>
         <param name="outer">
           <attribution license="cc4" from="Microsoft" modified="false" />The first sequence to join.</param>
         <param name="inner">
@@ -2130,7 +2298,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -2141,6 +2308,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Correlates the elements of two sequences based on key equality and groups the results. A specified <see cref="T:System.Collections.Generic.IEqualityComparer`1" /> is used to compare keys.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> that contains elements of type <paramref name="TResult" /> obtained by performing a grouped join on two sequences.</para>
+        </returns>
         <param name="outer">
           <attribution license="cc4" from="Microsoft" modified="false" />The first sequence to join.</param>
         <param name="inner">
@@ -2182,7 +2353,6 @@
         <Parameter Name="source2" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Intersect``1(System.Linq.IQueryable{``0},System.Collections.Generic.IEnumerable{``0})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Intersect``1(System.Linq.IQueryable{``0},System.Collections.Generic.IEnumerable{``0})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.CreateQuery``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source1" /> parameter.</para>
@@ -2192,6 +2362,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces the set intersection of two sequences by using the default equality comparer to compare values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A sequence that contains the set intersection of the two sequences.</para>
+        </returns>
         <param name="source1">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence whose distinct elements that also appear in <paramref name="source2" /> are returned.</param>
         <param name="source2">
@@ -2220,7 +2394,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Intersect``1(System.Linq.IQueryable{``0},System.Collections.Generic.IEnumerable{``0},System.Collections.Generic.IEqualityComparer{``0})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Intersect``1(System.Linq.IQueryable{``0},System.Collections.Generic.IEnumerable{``0},System.Collections.Generic.IEqualityComparer{``0})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.CreateQuery``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source1" /> parameter.</para>
@@ -2230,6 +2403,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces the set intersection of two sequences by using the specified <see cref="T:System.Collections.Generic.IEqualityComparer`1" /> to compare values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> that contains the set intersection of the two sequences.</para>
+        </returns>
         <param name="source1">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> whose distinct elements that also appear in <paramref name="source2" /> are returned.</param>
         <param name="source2">
@@ -2265,7 +2442,6 @@
         <Parameter Name="resultSelector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TOuter,TInner,TResult&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -2276,6 +2452,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Correlates the elements of two sequences based on matching keys. The default equality comparer is used to compare keys.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> that has elements of type <paramref name="TResult" /> obtained by performing an inner join on two sequences.</para>
+        </returns>
         <param name="outer">
           <attribution license="cc4" from="Microsoft" modified="false" />The first sequence to join.</param>
         <param name="inner">
@@ -2322,7 +2502,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -2333,6 +2512,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Correlates the elements of two sequences based on matching keys. A specified <see cref="T:System.Collections.Generic.IEqualityComparer`1" /> is used to compare keys.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> that has elements of type <paramref name="TResult" /> obtained by performing an inner join on two sequences.</para>
+        </returns>
         <param name="outer">
           <attribution license="cc4" from="Microsoft" modified="false" />The first sequence to join.</param>
         <param name="inner">
@@ -2373,7 +2556,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Last``1(System.Linq.IQueryable{``0})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Last``1(System.Linq.IQueryable{``0})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -2383,6 +2565,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the last element in a sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value at the last position in <paramref name="source" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> to return the last element of.</param>
         <typeparam name="TSource">
@@ -2408,7 +2594,6 @@
         <Parameter Name="predicate" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Boolean&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -2419,6 +2604,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the last element of a sequence that satisfies a specified condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The last element in <paramref name="source" /> that passes the test specified by <paramref name="predicate" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> to return an element from.</param>
         <param name="predicate">
@@ -2445,7 +2634,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.LastOrDefault``1(System.Linq.IQueryable{``0})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.LastOrDefault``1(System.Linq.IQueryable{``0})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -2456,6 +2644,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the last element in a sequence, or a default value if the sequence contains no elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <unmanagedCodeEntityReference>default</unmanagedCodeEntityReference>(<paramref name="TSource" />) if <paramref name="source" /> is empty; otherwise, the last element in <paramref name="source" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> to return the last element of.</param>
         <typeparam name="TSource">
@@ -2481,7 +2674,6 @@
         <Parameter Name="predicate" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Boolean&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -2492,6 +2684,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the last element of a sequence that satisfies a condition or a default value if no such element is found.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <unmanagedCodeEntityReference>default</unmanagedCodeEntityReference>(<paramref name="TSource" />) if <paramref name="source" /> is empty or if no elements pass the test in the predicate function; otherwise, the last element of <paramref name="source" /> that passes the test in the predicate function.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> to return an element from.</param>
         <param name="predicate">
@@ -2518,7 +2715,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.LongCount``1(System.Linq.IQueryable{``0})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.LongCount``1(System.Linq.IQueryable{``0})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -2528,6 +2724,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Int64" /> that represents the total number of elements in a sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of elements in <paramref name="source" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> that contains the elements to be counted.</param>
         <typeparam name="TSource">
@@ -2553,7 +2753,6 @@
         <Parameter Name="predicate" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Boolean&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -2564,6 +2763,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Int64" /> that represents the number of elements in a sequence that satisfy a condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of elements in <paramref name="source" /> that satisfy the condition in the predicate function.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> that contains the elements to be counted.</param>
         <param name="predicate">
@@ -2590,7 +2793,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Max``1(System.Linq.IQueryable{``0})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Max``1(System.Linq.IQueryable{``0})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -2600,6 +2802,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the maximum value in a generic <see cref="T:System.Linq.IQueryable`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum of.</param>
         <typeparam name="TSource">
@@ -2626,7 +2832,6 @@
         <Parameter Name="selector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,TResult&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -2637,6 +2842,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes a projection function on each element of a generic <see cref="T:System.Linq.IQueryable`1" /> and returns the maximum resulting value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the maximum of.</param>
         <param name="selector">
@@ -2665,7 +2874,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Min``1(System.Linq.IQueryable{``0})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Min``1(System.Linq.IQueryable{``0})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -2675,6 +2883,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the minimum value of a generic <see cref="T:System.Linq.IQueryable`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum of.</param>
         <typeparam name="TSource">
@@ -2701,7 +2913,6 @@
         <Parameter Name="selector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,TResult&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -2712,6 +2923,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes a projection function on each element of a generic <see cref="T:System.Linq.IQueryable`1" /> and returns the minimum resulting value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The minimum value in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to determine the minimum of.</param>
         <param name="selector">
@@ -2740,7 +2955,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The OfType method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling OfType itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.CreateQuery(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -2750,6 +2964,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Filters the elements of an <see cref="T:System.Linq.IQueryable" /> based on a specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection that contains the elements from <paramref name="source" /> that have type <paramref name="TResult" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable" /> whose elements to filter.</param>
         <typeparam name="TResult">
@@ -2776,7 +2994,6 @@
         <Parameter Name="keySelector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,TKey&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -2787,6 +3004,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sorts the elements of a sequence in ascending order according to a key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IOrderedQueryable`1" /> whose elements are sorted according to a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to order.</param>
         <param name="keySelector">
@@ -2818,7 +3039,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -2829,6 +3049,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sorts the elements of a sequence in ascending order by using a specified comparer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IOrderedQueryable`1" /> whose elements are sorted according to a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to order.</param>
         <param name="keySelector">
@@ -2861,7 +3085,6 @@
         <Parameter Name="keySelector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,TKey&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -2872,6 +3095,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sorts the elements of a sequence in descending order according to a key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IOrderedQueryable`1" /> whose elements are sorted in descending order according to a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to order.</param>
         <param name="keySelector">
@@ -2903,7 +3130,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -2914,6 +3140,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sorts the elements of a sequence in descending order by using a specified comparer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IOrderedQueryable`1" /> whose elements are sorted in descending order according to a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to order.</param>
         <param name="keySelector">
@@ -2944,7 +3174,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Reverse``1(System.Linq.IQueryable{``0})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Reverse``1(System.Linq.IQueryable{``0})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.CreateQuery``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -2954,6 +3183,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inverts the order of the elements in a sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> whose elements correspond to those of the input sequence in reverse order.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to reverse.</param>
         <typeparam name="TSource">
@@ -2980,7 +3213,6 @@
         <Parameter Name="selector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Int32,TResult&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -2991,6 +3223,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Projects each element of a sequence into a new form by incorporating the element's index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> whose elements are the result of invoking a projection function on each element of <paramref name="source" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to project.</param>
         <param name="selector">
@@ -3021,7 +3257,6 @@
         <Parameter Name="selector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,TResult&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -3032,6 +3267,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Projects each element of a sequence into a new form.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> whose elements are the result of invoking a projection function on each element of <paramref name="source" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to project.</param>
         <param name="selector">
@@ -3062,7 +3301,6 @@
         <Parameter Name="selector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Collections.Generic.IEnumerable&lt;TResult&gt;&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -3073,6 +3311,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Projects each element of a sequence to an <see cref="T:System.Collections.Generic.IEnumerable`1" /> and combines the resulting sequences into one sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> whose elements are the result of invoking a one-to-many projection function on each element of the input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to project.</param>
         <param name="selector">
@@ -3103,7 +3345,6 @@
         <Parameter Name="selector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Int32,System.Collections.Generic.IEnumerable&lt;TResult&gt;&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -3114,6 +3355,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Projects each element of a sequence to an <see cref="T:System.Collections.Generic.IEnumerable`1" /> and combines the resulting sequences into one sequence. The index of each source element is used in the projected form of that element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> whose elements are the result of invoking a one-to-many projection function on each element of the input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to project.</param>
         <param name="selector">
@@ -3146,7 +3391,6 @@
         <Parameter Name="resultSelector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,TCollection,TResult&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -3157,6 +3401,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Projects each element of a sequence to an <see cref="T:System.Collections.Generic.IEnumerable`1" /> and invokes a result selector function on each element therein. The resulting values from each intermediate sequence are combined into a single, one-dimensional sequence and returned.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> whose elements are the result of invoking the one-to-many projection function <paramref name="collectionSelector" /> on each element of <paramref name="source" /> and then mapping each of those sequence elements and their corresponding <paramref name="source" /> element to a result element.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to project.</param>
         <param name="collectionSelector">
@@ -3193,7 +3441,6 @@
         <Parameter Name="resultSelector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,TCollection,TResult&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -3204,6 +3451,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Projects each element of a sequence to an <see cref="T:System.Collections.Generic.IEnumerable`1" /> that incorporates the index of the source element that produced it. A result selector function is invoked on each element of each intermediate sequence, and the resulting values are combined into a single, one-dimensional sequence and returned.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> whose elements are the result of invoking the one-to-many projection function <paramref name="collectionSelector" /> on each element of <paramref name="source" /> and then mapping each of those sequence elements and their corresponding <paramref name="source" /> element to a result element.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values to project.</param>
         <param name="collectionSelector">
@@ -3237,7 +3488,6 @@
         <Parameter Name="source2" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.SequenceEqual``1(System.Linq.IQueryable{``0},System.Collections.Generic.IEnumerable{``0})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.SequenceEqual``1(System.Linq.IQueryable{``0},System.Collections.Generic.IEnumerable{``0})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source1" /> parameter.</para>
@@ -3247,6 +3497,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two sequences are equal by using the default equality comparer to compare elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two source sequences are of equal length and their corresponding elements compare equal; otherwise, false.</para>
+        </returns>
         <param name="source1">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> whose elements to compare to those of <paramref name="source2" />.</param>
         <param name="source2">
@@ -3275,7 +3529,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.SequenceEqual``1(System.Linq.IQueryable{``0},System.Collections.Generic.IEnumerable{``0},System.Collections.Generic.IEqualityComparer{``0})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.SequenceEqual``1(System.Linq.IQueryable{``0},System.Collections.Generic.IEnumerable{``0},System.Collections.Generic.IEqualityComparer{``0})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source1" /> parameter.</para>
@@ -3285,6 +3538,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two sequences are equal by using a specified <see cref="T:System.Collections.Generic.IEqualityComparer`1" /> to compare elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two source sequences are of equal length and their corresponding elements compare equal; otherwise, false.</para>
+        </returns>
         <param name="source1">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> whose elements to compare to those of <paramref name="source2" />.</param>
         <param name="source2">
@@ -3313,7 +3570,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Single``1(System.Linq.IQueryable{``0})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Single``1(System.Linq.IQueryable{``0})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -3323,6 +3579,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the only element of a sequence, and throws an exception if there is not exactly one element in the sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The single element of the input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> to return the single element of.</param>
         <typeparam name="TSource">
@@ -3348,7 +3608,6 @@
         <Parameter Name="predicate" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Boolean&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -3359,6 +3618,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the only element of a sequence that satisfies a specified condition, and throws an exception if more than one such element exists.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The single element of the input sequence that satisfies the condition in <paramref name="predicate" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> to return a single element from.</param>
         <param name="predicate">
@@ -3385,7 +3648,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;TSource&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.SingleOrDefault``1(System.Linq.IQueryable{``0})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.SingleOrDefault``1(System.Linq.IQueryable{``0})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -3396,6 +3658,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the only element of a sequence, or a default value if the sequence is empty; this method throws an exception if there is more than one element in the sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The single element of the input sequence, or <unmanagedCodeEntityReference>default</unmanagedCodeEntityReference>(<paramref name="TSource" />) if the sequence contains no elements.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> to return the single element of.</param>
         <typeparam name="TSource">
@@ -3421,7 +3687,6 @@
         <Parameter Name="predicate" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Boolean&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -3432,6 +3697,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the only element of a sequence that satisfies a specified condition or a default value if no such element exists; this method throws an exception if more than one element satisfies the condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The single element of the input sequence that satisfies the condition in <paramref name="predicate" />, or <unmanagedCodeEntityReference>default</unmanagedCodeEntityReference>(<paramref name="TSource" />) if no such element is found.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> to return a single element from.</param>
         <param name="predicate">
@@ -3459,7 +3728,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Skip``1(System.Linq.IQueryable{``0},System.Int32)" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Skip``1(System.Linq.IQueryable{``0},System.Int32)" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.CreateQuery(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -3469,6 +3737,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Bypasses a specified number of elements in a sequence and then returns the remaining elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> that contains elements that occur after the specified index in the input sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> to return elements from.</param>
         <param name="count">
@@ -3496,7 +3768,6 @@
         <Parameter Name="predicate" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Boolean&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -3507,6 +3778,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Bypasses elements in a sequence as long as a specified condition is true and then returns the remaining elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> that contains elements from <paramref name="source" /> starting at the first element in the linear series that does not pass the test specified by <paramref name="predicate" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> to return elements from.</param>
         <param name="predicate">
@@ -3534,7 +3809,6 @@
         <Parameter Name="predicate" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Int32,System.Boolean&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -3545,6 +3819,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Bypasses elements in a sequence as long as a specified condition is true and then returns the remaining elements. The element's index is used in the logic of the predicate function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> that contains elements from <paramref name="source" /> starting at the first element in the linear series that does not pass the test specified by <paramref name="predicate" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> to return elements from.</param>
         <param name="predicate">
@@ -3568,7 +3846,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;System.Decimal&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Sum(System.Linq.IQueryable{System.Decimal})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Sum(System.Linq.IQueryable{System.Decimal})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -3578,6 +3855,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of a sequence of <see cref="T:System.Decimal" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Decimal" /> values to calculate the sum of.</param>
       </Docs>
@@ -3597,7 +3878,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;System.Double&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Sum(System.Linq.IQueryable{System.Double})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Sum(System.Linq.IQueryable{System.Double})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -3607,6 +3887,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of a sequence of <see cref="T:System.Double" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Double" /> values to calculate the sum of.</param>
       </Docs>
@@ -3626,7 +3910,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;System.Int32&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Sum(System.Linq.IQueryable{System.Int32})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Sum(System.Linq.IQueryable{System.Int32})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -3636,6 +3919,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of a sequence of <see cref="T:System.Int32" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Int32" /> values to calculate the sum of.</param>
       </Docs>
@@ -3655,7 +3942,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;System.Int64&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Sum(System.Linq.IQueryable{System.Int64})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Sum(System.Linq.IQueryable{System.Int64})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -3665,6 +3951,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of a sequence of <see cref="T:System.Int64" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Int64" /> values to calculate the sum of.</param>
       </Docs>
@@ -3684,7 +3974,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;System.Nullable&lt;System.Decimal&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Sum(System.Linq.IQueryable{System.Nullable{System.Decimal}})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Sum(System.Linq.IQueryable{System.Nullable{System.Decimal}})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -3694,6 +3983,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of a sequence of nullable <see cref="T:System.Decimal" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Decimal" /> values to calculate the sum of.</param>
       </Docs>
@@ -3713,7 +4006,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;System.Nullable&lt;System.Double&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Sum(System.Linq.IQueryable{System.Nullable{System.Double}})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Sum(System.Linq.IQueryable{System.Nullable{System.Double}})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -3723,6 +4015,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of a sequence of nullable <see cref="T:System.Double" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Double" /> values to calculate the sum of.</param>
       </Docs>
@@ -3742,7 +4038,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;System.Nullable&lt;System.Int32&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Sum(System.Linq.IQueryable{System.Nullable{System.Int32}})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Sum(System.Linq.IQueryable{System.Nullable{System.Int32}})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -3752,6 +4047,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of a sequence of nullable <see cref="T:System.Int32" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Int32" /> values to calculate the sum of.</param>
       </Docs>
@@ -3771,7 +4070,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;System.Nullable&lt;System.Int64&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Sum(System.Linq.IQueryable{System.Nullable{System.Int64}})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Sum(System.Linq.IQueryable{System.Nullable{System.Int64}})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -3781,6 +4079,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of a sequence of nullable <see cref="T:System.Int64" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Int64" /> values to calculate the sum of.</param>
       </Docs>
@@ -3800,7 +4102,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;System.Nullable&lt;System.Single&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Sum(System.Linq.IQueryable{System.Nullable{System.Single}})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Sum(System.Linq.IQueryable{System.Nullable{System.Single}})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -3810,6 +4111,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of a sequence of nullable <see cref="T:System.Single" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of nullable <see cref="T:System.Single" /> values to calculate the sum of.</param>
       </Docs>
@@ -3829,7 +4134,6 @@
         <Parameter Name="source" Type="System.Linq.IQueryable&lt;System.Single&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Sum(System.Linq.IQueryable{System.Single})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Sum(System.Linq.IQueryable{System.Single})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.Execute``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -3839,6 +4143,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of a sequence of <see cref="T:System.Single" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the values in the sequence.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of <see cref="T:System.Single" /> values to calculate the sum of.</param>
       </Docs>
@@ -3862,7 +4170,6 @@
         <Parameter Name="selector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Decimal&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -3873,6 +4180,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the sequence of <see cref="T:System.Decimal" /> values that is obtained by invoking a projection function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values of type <paramref name="TSource" />.</param>
         <param name="selector">
@@ -3900,7 +4211,6 @@
         <Parameter Name="selector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Double&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -3911,6 +4221,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the sequence of <see cref="T:System.Double" /> values that is obtained by invoking a projection function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values of type <paramref name="TSource" />.</param>
         <param name="selector">
@@ -3938,7 +4252,6 @@
         <Parameter Name="selector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Int32&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -3949,6 +4262,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the sequence of <see cref="T:System.Int32" /> values that is obtained by invoking a projection function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values of type <paramref name="TSource" />.</param>
         <param name="selector">
@@ -3976,7 +4293,6 @@
         <Parameter Name="selector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Int64&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -3987,6 +4303,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the sequence of <see cref="T:System.Int64" /> values that is obtained by invoking a projection function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values of type <paramref name="TSource" />.</param>
         <param name="selector">
@@ -4014,7 +4334,6 @@
         <Parameter Name="selector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Nullable&lt;System.Decimal&gt;&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -4025,6 +4344,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the sequence of nullable <see cref="T:System.Decimal" /> values that is obtained by invoking a projection function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values of type <paramref name="TSource" />.</param>
         <param name="selector">
@@ -4052,7 +4375,6 @@
         <Parameter Name="selector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Nullable&lt;System.Double&gt;&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -4063,6 +4385,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the sequence of nullable <see cref="T:System.Double" /> values that is obtained by invoking a projection function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values of type <paramref name="TSource" />.</param>
         <param name="selector">
@@ -4090,7 +4416,6 @@
         <Parameter Name="selector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Nullable&lt;System.Int32&gt;&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -4101,6 +4426,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the sequence of nullable <see cref="T:System.Int32" /> values that is obtained by invoking a projection function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values of type <paramref name="TSource" />.</param>
         <param name="selector">
@@ -4128,7 +4457,6 @@
         <Parameter Name="selector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Nullable&lt;System.Int64&gt;&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -4139,6 +4467,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the sequence of nullable <see cref="T:System.Int64" /> values that is obtained by invoking a projection function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values of type <paramref name="TSource" />.</param>
         <param name="selector">
@@ -4166,7 +4498,6 @@
         <Parameter Name="selector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Nullable&lt;System.Single&gt;&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -4177,6 +4508,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the sequence of nullable <see cref="T:System.Single" /> values that is obtained by invoking a projection function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values of type <paramref name="TSource" />.</param>
         <param name="selector">
@@ -4204,7 +4539,6 @@
         <Parameter Name="selector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Single&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -4215,6 +4549,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the sequence of <see cref="T:System.Single" /> values that is obtained by invoking a projection function on each element of the input sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the projected values.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence of values of type <paramref name="TSource" />.</param>
         <param name="selector">
@@ -4242,7 +4580,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Take``1(System.Linq.IQueryable{``0},System.Int32)" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Take``1(System.Linq.IQueryable{``0},System.Int32)" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.CreateQuery(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source" /> parameter.</para>
@@ -4252,6 +4589,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a specified number of contiguous elements from the start of a sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> that contains the specified number of elements from the start of <paramref name="source" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to return elements from.</param>
         <param name="count">
@@ -4279,7 +4620,6 @@
         <Parameter Name="predicate" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Boolean&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -4290,6 +4630,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns elements from a sequence as long as a specified condition is true.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> that contains elements from the input sequence occurring before the element at which the test specified by <paramref name="predicate" /> no longer passes.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to return elements from.</param>
         <param name="predicate">
@@ -4317,7 +4661,6 @@
         <Parameter Name="predicate" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Int32,System.Boolean&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -4328,6 +4671,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns elements from a sequence as long as a specified condition is true. The element's index is used in the logic of the predicate function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> that contains elements from the input sequence occurring before the element at which the test specified by <paramref name="predicate" /> no longer passes.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence to return elements from.</param>
         <param name="predicate">
@@ -4356,7 +4703,6 @@
         <Parameter Name="keySelector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,TKey&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -4367,6 +4713,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a subsequent ordering of the elements in a sequence in ascending order according to a key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IOrderedQueryable`1" /> whose elements are sorted according to a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IOrderedQueryable`1" /> that contains elements to sort.</param>
         <param name="keySelector">
@@ -4398,7 +4748,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -4409,6 +4758,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a subsequent ordering of the elements in a sequence in ascending order by using a specified comparer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IOrderedQueryable`1" /> whose elements are sorted according to a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IOrderedQueryable`1" /> that contains elements to sort.</param>
         <param name="keySelector">
@@ -4441,7 +4794,6 @@
         <Parameter Name="keySelector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,TKey&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -4452,6 +4804,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a subsequent ordering of the elements in a sequence in descending order, according to a key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IOrderedQueryable`1" /> whose elements are sorted in descending order according to a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IOrderedQueryable`1" /> that contains elements to sort.</param>
         <param name="keySelector">
@@ -4483,7 +4839,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IComparer&lt;TKey&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -4494,6 +4849,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a subsequent ordering of the elements in a sequence in descending order by using a specified comparer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection whose elements are sorted in descending order according to a key.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IOrderedQueryable`1" /> that contains elements to sort.</param>
         <param name="keySelector">
@@ -4525,7 +4884,6 @@
         <Parameter Name="source2" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Union``1(System.Linq.IQueryable{``0},System.Collections.Generic.IEnumerable{``0})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Union``1(System.Linq.IQueryable{``0},System.Collections.Generic.IEnumerable{``0})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.CreateQuery``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source1" /> parameter.</para>
@@ -4535,6 +4893,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces the set union of two sequences by using the default equality comparer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> that contains the elements from both input sequences, excluding duplicates.</para>
+        </returns>
         <param name="source1">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence whose distinct elements form the first set for the union operation.</param>
         <param name="source2">
@@ -4563,7 +4925,6 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Union``1(System.Linq.IQueryable{``0},System.Collections.Generic.IEnumerable{``0},System.Collections.Generic.IEqualityComparer{``0})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Union``1(System.Linq.IQueryable{``0},System.Collections.Generic.IEnumerable{``0},System.Collections.Generic.IEqualityComparer{``0})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.CreateQuery``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source1" /> parameter.</para>
@@ -4573,6 +4934,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces the set union of two sequences by using a specified <see cref="T:System.Collections.Generic.IEqualityComparer`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> that contains the elements from both input sequences, excluding duplicates.</para>
+        </returns>
         <param name="source1">
           <attribution license="cc4" from="Microsoft" modified="false" />A sequence whose distinct elements form the first set for the union operation.</param>
         <param name="source2">
@@ -4602,7 +4967,6 @@
         <Parameter Name="predicate" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Boolean&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -4613,6 +4977,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Filters a sequence of values based on a predicate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> that contains elements from the input sequence that satisfy the condition specified by <paramref name="predicate" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> to filter.</param>
         <param name="predicate">
@@ -4640,7 +5008,6 @@
         <Parameter Name="predicate" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TSource,System.Int32,System.Boolean&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has at least one parameter of type <see cref="T:System.Linq.Expressions.Expression`1" /> whose type argument is one of the <see cref="T:System.Func`2" /> types. For these parameters, you can pass in a lambda expression and it will be compiled to an <see cref="T:System.Linq.Expressions.Expression`1" />.</para>
@@ -4651,6 +5018,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Filters a sequence of values based on a predicate. Each element's index is used in the logic of the predicate function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> that contains elements from the input sequence that satisfy the condition specified by <paramref name="predicate" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Linq.IQueryable`1" /> to filter.</param>
         <param name="predicate">
@@ -4680,7 +5051,6 @@
         <Parameter Name="resultSelector" Type="System.Linq.Expressions.Expression&lt;System.Func&lt;TFirst,TSecond,TResult&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Linq.Queryable.Zip``3(System.Linq.IQueryable{``0},System.Collections.Generic.IEnumerable{``1},System.Linq.Expressions.Expression{System.Func{``0,``1,``2}})" /> method generates a <see cref="T:System.Linq.Expressions.MethodCallExpression" /> that represents calling <see cref="M:System.Linq.Queryable.Zip``3(System.Linq.IQueryable{``0},System.Collections.Generic.IEnumerable{``1},System.Linq.Expressions.Expression{System.Func{``0,``1,``2}})" /> itself as a constructed generic method. It then passes the <see cref="T:System.Linq.Expressions.MethodCallExpression" /> to the <see cref="M:System.Linq.IQueryProvider.CreateQuery``1(System.Linq.Expressions.Expression)" /> method of the <see cref="T:System.Linq.IQueryProvider" /> represented by the <see cref="P:System.Linq.IQueryable.Provider" /> property of the <paramref name="source1" /> parameter.</para>
@@ -4690,6 +5060,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Merges two sequences by using the specified predicate function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Linq.IQueryable`1" /> that contains merged elements of two input sequences.</para>
+        </returns>
         <param name="source1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first sequence to merge.</param>
         <param name="source2">
diff --git a/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/CallSite.xml b/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/CallSite.xml
index 62b2c00fe1c..ac449274f97 100644
--- a/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/CallSite.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/CallSite.xml
@@ -52,12 +52,15 @@
         <Parameter Name="binder" Type="System.Runtime.CompilerServices.CallSiteBinder" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a call site with the given delegate type and binder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new call site.</para>
+        </returns>
         <param name="delegateType">
           <attribution license="cc4" from="Microsoft" modified="false" />The call site delegate type.</param>
         <param name="binder">
diff --git a/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/CallSiteBinder.xml b/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/CallSiteBinder.xml
index e4e65680dcc..80c840544fa 100644
--- a/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/CallSiteBinder.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/CallSiteBinder.xml
@@ -50,12 +50,15 @@
         <Parameter Name="returnLabel" Type="System.Linq.Expressions.LabelTarget" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the runtime binding of the dynamic operation on a set of arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An Expression that performs tests on the dynamic operation arguments, and performs the dynamic operation if the tests are valid. If the tests fail on subsequent occurrences of the dynamic operation, Bind will be called again to produce a new <see cref="T:System.Linq.Expressions.Expression" /> for the new argument types.</para>
+        </returns>
         <param name="args">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of arguments to the dynamic operation.</param>
         <param name="parameters">
@@ -86,12 +89,15 @@
         <Parameter Name="args" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides low-level runtime binding support. Classes can override this and provide a direct delegate for the implementation of rule. This can enable saving rules to disk, having specialized rules available at runtime, or providing a different caching policy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new delegate which replaces the CallSite Target.</para>
+        </returns>
         <param name="site">
           <attribution license="cc4" from="Microsoft" modified="false" />The CallSite the bind is being performed for.</param>
         <param name="args">
diff --git a/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/CallSiteHelpers.xml b/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/CallSiteHelpers.xml
index 78df99ccd34..5f949c5e7fd 100644
--- a/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/CallSiteHelpers.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/CallSiteHelpers.xml
@@ -32,12 +32,15 @@
         <Parameter Name="mb" Type="System.Reflection.MethodBase" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks if a <see cref="T:System.Reflection.MethodBase" /> is internally used by DLR and should not be displayed on the language code's stack.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True if the input <see cref="T:System.Reflection.MethodBase" /> is internally used by DLR and should not be displayed on the language code's stack. Otherwise, false.</para>
+        </returns>
         <param name="mb">
           <attribution license="cc4" from="Microsoft" modified="false" />The input <see cref="T:System.Reflection.MethodBase" /></param>
       </Docs>
diff --git a/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/CallSiteOps.xml b/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/CallSiteOps.xml
index 047a3abe4fc..d03d3690621 100644
--- a/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/CallSiteOps.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/CallSiteOps.xml
@@ -100,12 +100,15 @@
         <Parameter Name="args" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Updates the call site target with a new rule based on the arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new call site target.</para>
+        </returns>
         <param name="binder">
           <attribution license="cc4" from="Microsoft" modified="false" />The call site binder.</param>
         <param name="site">
@@ -176,12 +179,15 @@
         <Parameter Name="site" Type="System.Runtime.CompilerServices.CallSite&lt;T&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of a dynamic call site used for cache lookup.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new call site.</para>
+        </returns>
         <param name="site">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of the dynamic call site.</param>
         <typeparam name="T">
@@ -217,12 +223,15 @@
         <Parameter Name="cache" Type="System.Runtime.CompilerServices.RuleCache&lt;T&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the dynamic rule cache for rules applicable to the dynamic operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The collection of applicable rules.</para>
+        </returns>
         <param name="cache">
           <attribution license="cc4" from="Microsoft" modified="false" />The cache.</param>
         <typeparam name="T">
@@ -251,12 +260,15 @@
         <Parameter Name="site" Type="System.Runtime.CompilerServices.CallSite" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks whether the executed rule matched</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if rule matched, false otherwise.</para>
+        </returns>
         <param name="site">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of the dynamic call site.</param>
       </Docs>
@@ -290,12 +302,15 @@
         <Parameter Name="site" Type="System.Runtime.CompilerServices.CallSite&lt;T&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves binding rule cache.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The cache.</para>
+        </returns>
         <param name="site">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of the dynamic call site.</param>
         <typeparam name="T">
@@ -331,12 +346,15 @@
         <Parameter Name="site" Type="System.Runtime.CompilerServices.CallSite&lt;T&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the dynamic binding rules from the call site.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of dynamic binding rules.</para>
+        </returns>
         <param name="site">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of the dynamic call site.</param>
         <typeparam name="T">
@@ -411,12 +429,15 @@
         <Parameter Name="site" Type="System.Runtime.CompilerServices.CallSite" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks if a dynamic site requires an update.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if rule does not need updating, false otherwise.</para>
+        </returns>
         <param name="site">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of the dynamic call site.</param>
       </Docs>
diff --git a/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/CallSite`1.xml b/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/CallSite`1.xml
index 3e4c63cd435..a0f8501fbee 100644
--- a/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/CallSite`1.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/CallSite`1.xml
@@ -40,12 +40,15 @@
         <Parameter Name="binder" Type="System.Runtime.CompilerServices.CallSiteBinder" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the dynamic call site, initialized with the binder responsible for the runtime binding of the dynamic operations at this call site.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new instance of dynamic call site.</para>
+        </returns>
         <param name="binder">
           <attribution license="cc4" from="Microsoft" modified="false" />The binder responsible for the runtime binding of the dynamic operations at this call site.</param>
       </Docs>
diff --git a/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/DebugInfoGenerator.xml b/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/DebugInfoGenerator.xml
index cea8dfde3dc..8384b3b60da 100644
--- a/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/DebugInfoGenerator.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/DebugInfoGenerator.xml
@@ -46,12 +46,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a program database (PDB) symbol generator.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A PDB symbol generator.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MarkSequencePoint">
diff --git a/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/ExecutionScope.xml b/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/ExecutionScope.xml
index f29fa5abaa0..9bd20b90b57 100644
--- a/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/ExecutionScope.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/ExecutionScope.xml
@@ -34,12 +34,15 @@
         <Parameter Name="locals" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a delegate that can be used to execute a dynamically generated method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Delegate" /> that can execute a dynamically generated method.</para>
+        </returns>
         <param name="indexLambda">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the object that stores information about associated lambda expression of the dynamic method.</param>
         <param name="locals">
@@ -57,12 +60,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an array to store the hoisted local variables.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array to store hoisted local variables.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Globals">
@@ -96,12 +102,15 @@
         <Parameter Name="locals" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Frees a specified expression tree of external parameter references by replacing the parameter with its current value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An expression tree that does not contain external parameter references.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An expression tree to free of external parameter references.</param>
         <param name="locals">
diff --git a/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/ReadOnlyCollectionBuilder`1.xml b/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/ReadOnlyCollectionBuilder`1.xml
index ee6444a8e1e..cf153bf6e4d 100644
--- a/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/ReadOnlyCollectionBuilder`1.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/ReadOnlyCollectionBuilder`1.xml
@@ -216,12 +216,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.Generic.IEnumerator`1" /> that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IndexOf">
@@ -465,12 +468,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Add">
@@ -487,12 +493,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an item to the <see cref="T:System.Collections.IList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position into which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to add to the <see cref="T:System.Collections.IList" />.</param>
       </Docs>
@@ -511,12 +520,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Collections.IList" /> contains a specific value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="item" /> is found in the <see cref="T:System.Collections.IList" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the <see cref="T:System.Collections.IList" />.</param>
       </Docs>
@@ -535,12 +547,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of a specific item in the <see cref="T:System.Collections.IList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of <paramref name="item" /> if found in the list; otherwise, –1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to locate in the <see cref="T:System.Collections.IList" />.</param>
       </Docs>
@@ -664,12 +679,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the elements of the <see cref="T:System.Runtime.CompilerServices.ReadOnlyCollectionBuilder`1" /> to a new array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array containing copies of the elements of the <see cref="T:System.Runtime.CompilerServices.ReadOnlyCollectionBuilder`1" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToReadOnlyCollection">
@@ -684,12 +702,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Collections.ObjectModel.ReadOnlyCollection`1" /> containing all of the elements of the <see cref="T:System.Runtime.CompilerServices.ReadOnlyCollectionBuilder`1" />, avoiding copying the elements to the new array if possible. Resets the <see cref="T:System.Runtime.CompilerServices.ReadOnlyCollectionBuilder`1" /> after the <see cref="T:System.Collections.ObjectModel.ReadOnlyCollection`1" /> has been created.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.Collections.ObjectModel.ReadOnlyCollection`1" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/RuntimeOps.xml b/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/RuntimeOps.xml
index 91a54e23265..fc462186f99 100644
--- a/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/RuntimeOps.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Runtime.CompilerServices/RuntimeOps.xml
@@ -46,12 +46,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an interface that can be used to modify closed over variables at runtime.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An interface to access variables.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateRuntimeVariables">
@@ -77,12 +80,15 @@
         <Parameter Name="indexes" Type="System.Int64[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an interface that can be used to modify closed over variables at runtime.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An interface to access variables.</para>
+        </returns>
         <param name="data">
           <attribution license="cc4" from="Microsoft" modified="false" />The closure array.</param>
         <param name="indexes">
@@ -112,12 +118,15 @@
         <Parameter Name="version" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks the version of the Expando object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the version is equal; otherwise, false.</para>
+        </returns>
         <param name="expando">
           <attribution license="cc4" from="Microsoft" modified="false" />The Expando object.</param>
         <param name="version">
@@ -187,12 +196,15 @@
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deletes the value of an item in an expando object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the item was successfully removed; otherwise, false.</para>
+        </returns>
         <param name="expando">
           <attribution license="cc4" from="Microsoft" modified="false" />The expando object.</param>
         <param name="indexClass">
@@ -270,12 +282,15 @@
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the value of an item in an expando object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the index for the set member.</para>
+        </returns>
         <param name="expando">
           <attribution license="cc4" from="Microsoft" modified="false" />The expando object.</param>
         <param name="indexClass">
@@ -314,12 +329,15 @@
         <Parameter Name="indexes" Type="System.Int32[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Combines two runtime variable lists and returns a new list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The merged runtime variables.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />The first list.</param>
         <param name="second">
@@ -352,12 +370,15 @@
         <Parameter Name="locals" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Quotes the provided expression tree.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The quoted expression.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to quote.</param>
         <param name="hoistedLocals">
diff --git a/mcs/class/System.Core/Documentation/en/System.Security.Cryptography/AesCryptoServiceProvider.xml b/mcs/class/System.Core/Documentation/en/System.Security.Cryptography/AesCryptoServiceProvider.xml
index 71ca06ac02b..5135ed5de5f 100644
--- a/mcs/class/System.Core/Documentation/en/System.Security.Cryptography/AesCryptoServiceProvider.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Security.Cryptography/AesCryptoServiceProvider.xml
@@ -46,12 +46,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric AES decryptor object using the current key and initialization vector (IV).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A symmetric AES decryptor object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateDecryptor">
@@ -71,12 +74,15 @@
       <Docs>
         <param name="rgbKey">To be added.</param>
         <param name="rgbIV">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric AES decryptor object using the specified key and initialization vector (IV).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A symmetric AES decryptor object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateEncryptor">
@@ -91,12 +97,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric AES encryptor object using the current key and initialization vector (IV).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A symmetric AES encryptor object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateEncryptor">
@@ -116,7 +125,6 @@
       <Docs>
         <param name="rgbKey">To be added.</param>
         <param name="rgbIV">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the code examples in the <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.LegalKeySizes" /> and <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.LegalBlockSizes" /> properties to determine the size of the <paramref name="key" /> and <paramref name="iv" /> parameters.</para>
@@ -125,6 +133,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric encryptor object using the specified key and initialization vector (IV).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A symmetric AES encryptor object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Dispose">
diff --git a/mcs/class/System.Core/Documentation/en/System.Security.Cryptography/AesManaged.xml b/mcs/class/System.Core/Documentation/en/System.Security.Cryptography/AesManaged.xml
index 22d44f9eca5..2130a764707 100644
--- a/mcs/class/System.Core/Documentation/en/System.Security.Cryptography/AesManaged.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Security.Cryptography/AesManaged.xml
@@ -52,12 +52,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric decryptor object using the current key and initialization vector (IV).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A symmetric decryptor object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateDecryptor">
@@ -75,12 +78,15 @@
         <Parameter Name="iv" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric decryptor object using the specified key and initialization vector (IV).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A symmetric decryptor object.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The secret key to use for the symmetric algorithm.</param>
         <param name="iv">
@@ -99,12 +105,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric encryptor object using the current key and initialization vector (IV).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A symmetric encryptor object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateEncryptor">
@@ -122,12 +131,15 @@
         <Parameter Name="iv" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric encryptor object using the specified key and initialization vector (IV).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A symmetric encryptor object.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The secret key to use for the symmetric algorithm.</param>
         <param name="iv">
diff --git a/mcs/class/System.Core/Documentation/en/System.Security.Cryptography/CngAlgorithm.xml b/mcs/class/System.Core/Documentation/en/System.Security.Cryptography/CngAlgorithm.xml
index 7f1c42bd274..bc57ff7dd8e 100644
--- a/mcs/class/System.Core/Documentation/en/System.Security.Cryptography/CngAlgorithm.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Security.Cryptography/CngAlgorithm.xml
@@ -200,12 +200,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the specified object to the current <see cref="T:System.Security.Cryptography.CngAlgorithm" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="obj" /> parameter is a <see cref="T:System.Security.Cryptography.CngAlgorithm" /> that specifies the same algorithm as the current object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to be compared to the current <see cref="T:System.Security.Cryptography.CngAlgorithm" /> object.</param>
       </Docs>
@@ -224,12 +227,15 @@
         <Parameter Name="other" Type="System.Security.Cryptography.CngAlgorithm" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the specified <see cref="T:System.Security.Cryptography.CngAlgorithm" /> object to the current <see cref="T:System.Security.Cryptography.CngAlgorithm" /> object. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="other" /> parameter specifies the same algorithm as the current object; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to be compared to the current <see cref="T:System.Security.Cryptography.CngAlgorithm" /> object.</param>
       </Docs>
@@ -246,12 +252,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a hash value for the algorithm name that is embedded in the current <see cref="T:System.Security.Cryptography.CngAlgorithm" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash value of the embedded algorithm name.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MD5">
@@ -288,12 +297,15 @@
         <Parameter Name="right" Type="System.Security.Cryptography.CngAlgorithm" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two <see cref="T:System.Security.Cryptography.CngAlgorithm" /> objects specify the same algorithm name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two objects specify the same algorithm name; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that specifies an algorithm name.</param>
         <param name="right">
@@ -315,12 +327,15 @@
         <Parameter Name="right" Type="System.Security.Cryptography.CngAlgorithm" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two <see cref="T:System.Security.Cryptography.CngAlgorithm" /> objects do not specify the same algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two objects do not specify the same algorithm name; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that specifies an algorithm name.</param>
         <param name="right">
@@ -415,12 +430,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the name of the algorithm that the current <see cref="T:System.Security.Cryptography.CngAlgorithm" /> object specifies.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The embedded algorithm name.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Core/Documentation/en/System.Security.Cryptography/CngAlgorithmGroup.xml b/mcs/class/System.Core/Documentation/en/System.Security.Cryptography/CngAlgorithmGroup.xml
index 623957b41c3..809b391e2c1 100644
--- a/mcs/class/System.Core/Documentation/en/System.Security.Cryptography/CngAlgorithmGroup.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Security.Cryptography/CngAlgorithmGroup.xml
@@ -162,12 +162,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the specified object to the current <see cref="T:System.Security.Cryptography.CngAlgorithmGroup" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="obj" /> parameter is a <see cref="T:System.Security.Cryptography.CngAlgorithmGroup" /> that specifies the same algorithm group as the current object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to be compared to the current <see cref="T:System.Security.Cryptography.CngAlgorithmGroup" /> object.</param>
       </Docs>
@@ -186,12 +189,15 @@
         <Parameter Name="other" Type="System.Security.Cryptography.CngAlgorithmGroup" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the specified <see cref="T:System.Security.Cryptography.CngAlgorithmGroup" /> object to the current <see cref="T:System.Security.Cryptography.CngAlgorithmGroup" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="other" /> parameter specifies the same algorithm group as the current object; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to be compared to the current <see cref="T:System.Security.Cryptography.CngAlgorithmGroup" /> object.</param>
       </Docs>
@@ -208,12 +214,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a hash value for the algorithm group name that is embedded in the current <see cref="T:System.Security.Cryptography.CngAlgorithmGroup" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash value of the embedded algorithm group name.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="op_Equality">
@@ -231,12 +240,15 @@
         <Parameter Name="right" Type="System.Security.Cryptography.CngAlgorithmGroup" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two <see cref="T:System.Security.Cryptography.CngAlgorithmGroup" /> objects specify the same algorithm group.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two objects specify the same algorithm group; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that specifies an algorithm group.</param>
         <param name="right">
@@ -258,12 +270,15 @@
         <Parameter Name="right" Type="System.Security.Cryptography.CngAlgorithmGroup" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two <see cref="T:System.Security.Cryptography.CngAlgorithmGroup" /> objects do not specify the same algorithm group.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two objects do not specify the same algorithm group; otherwise, false. </para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that specifies an algorithm group.</param>
         <param name="right">
@@ -301,12 +316,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the name of the algorithm group that the current <see cref="T:System.Security.Cryptography.CngAlgorithm" /> object specifies.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The embedded algorithm group name.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Core/Documentation/en/System.Threading.Tasks/TaskExtensions.xml b/mcs/class/System.Core/Documentation/en/System.Threading.Tasks/TaskExtensions.xml
index 3a630821a5b..8f1bcf9a096 100644
--- a/mcs/class/System.Core/Documentation/en/System.Threading.Tasks/TaskExtensions.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Threading.Tasks/TaskExtensions.xml
@@ -32,7 +32,6 @@
         <Parameter Name="task" Type="System.Threading.Tasks.Task&lt;System.Threading.Tasks.Task&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>It is often useful to be able to return a Task from a <see cref="T:System.Threading.Tasks.Task`1" />, where the inner Task represents work done as part of the outer <see cref="T:System.Threading.Tasks.Task`1" />. However, doing so results in a Task&lt;Task&gt; (C#) or Task (Of Task) (Visual Basic), which, if not dealt with carefully, could produce unexpected behavior. Unwrap solves this problem by creating a proxy Task that represents the entire asynchronous operation of such a task.</para>
@@ -41,6 +40,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a proxy <see cref="T:System.Threading.Tasks.Task" /> that represents the asynchronous operation of a <see cref="M:System.Threading.Tasks.TaskScheduler.TryExecuteTaskInline(System.Threading.Tasks.Task,System.Boolean)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Task that represents the asynchronous operation of the provided System.Threading.Tasks.Task(Of Task).</para>
+        </returns>
         <param name="task">
           <attribution license="cc4" from="Microsoft" modified="false" />The Task&lt;Task&gt; (C#) or Task (Of Task) (Visual Basic) to unwrap.</param>
       </Docs>
@@ -62,7 +65,6 @@
         <Parameter Name="task" Type="System.Threading.Tasks.Task&lt;System.Threading.Tasks.Task&lt;TResult&gt;&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>It is often useful to be able to return a <see cref="T:System.Threading.Tasks.Task" /> from a <see cref="T:System.Threading.Tasks.Task" />, where the inner <see cref="T:System.Threading.Tasks.Task" /> represents work done as part of the outer <see cref="T:System.Threading.Tasks.Task" />. However, doing so results in a Task&lt;Task&lt;T&gt;&gt; (C#) or Task (Of Task(Of T)) (Visual Basic), which, if not dealt with carefully, could produce unexpected behavior. Unwrap solves this problem by creating a proxy <see cref="T:System.Threading.Tasks.Task`1" /> that represents the entire asynchronous operation of such a Task&lt;Task&lt;T&gt;&gt; (C#) or Task (Of Task(Of T)) (Visual Basic).</para>
@@ -71,6 +73,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a proxy <see cref="T:System.Threading.Tasks.Task" /> that represents the asynchronous operation of a Task&lt;Task&lt;T&gt;&gt; (C#) or Task (Of Task(Of T)) (Visual Basic).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Threading.Tasks.Task" /> that represents the asynchronous operation of the provided Task&lt;Task&lt;T&gt;&gt; (C#) or Task (Of Task(Of T)) (Visual Basic).</para>
+        </returns>
         <param name="task">
           <attribution license="cc4" from="Microsoft" modified="false" />The Task&lt;Task&lt;T&gt;&gt; (C#) or Task (Of Task(Of T)) (Visual Basic) to unwrap.</param>
         <typeparam name="TResult">
diff --git a/mcs/class/System.Core/Documentation/en/System.Threading/ReaderWriterLockSlim.xml b/mcs/class/System.Core/Documentation/en/System.Threading/ReaderWriterLockSlim.xml
index 85f5f54e5e2..48c57f95552 100644
--- a/mcs/class/System.Core/Documentation/en/System.Threading/ReaderWriterLockSlim.xml
+++ b/mcs/class/System.Core/Documentation/en/System.Threading/ReaderWriterLockSlim.xml
@@ -635,7 +635,6 @@
         <Parameter Name="millisecondsTimeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="millisecondsTimeout" /> is 0 (zero), this method checks the lock state and returns false immediately if the desired state is unavailable.</para>
@@ -650,6 +649,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tries to enter the lock in read mode, with an optional integer time-out.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the calling thread entered read mode, otherwise, false.</para>
+        </returns>
         <param name="millisecondsTimeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of milliseconds to wait, or -1 (<see cref="F:System.Threading.Timeout.Infinite" />) to wait indefinitely.</param>
       </Docs>
@@ -668,7 +671,6 @@
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="timeout" /> is 0 (zero), this method checks the lock state and returns false immediately if the desired state is unavailable.</para>
@@ -683,6 +685,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tries to enter the lock in read mode, with an optional time-out.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the calling thread entered read mode, otherwise, false.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The interval to wait, or -1 milliseconds to wait indefinitely. </param>
       </Docs>
@@ -701,7 +707,6 @@
         <Parameter Name="millisecondsTimeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="millisecondsTimeout" /> is 0 (zero), this method checks the lock state and returns false immediately if the desired state is unavailable.</para>
@@ -716,6 +721,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tries to enter the lock in upgradeable mode, with an optional time-out.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the calling thread entered upgradeable mode, otherwise, false.</para>
+        </returns>
         <param name="millisecondsTimeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of milliseconds to wait, or -1 (<see cref="F:System.Threading.Timeout.Infinite" />) to wait indefinitely.</param>
       </Docs>
@@ -734,7 +743,6 @@
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="timeout" /> is 0 (zero), this method checks the lock state and returns false immediately if the desired state is unavailable.</para>
@@ -749,6 +757,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tries to enter the lock in upgradeable mode, with an optional time-out.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the calling thread entered upgradeable mode, otherwise, false.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The interval to wait, or -1 milliseconds to wait indefinitely.</param>
       </Docs>
@@ -767,7 +779,6 @@
         <Parameter Name="millisecondsTimeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="millisecondsTimeout" /> is 0 (zero), this method checks the lock state and returns false immediately if the desired state is unavailable.</para>
@@ -780,6 +791,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tries to enter the lock in write mode, with an optional time-out.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the calling thread entered write mode, otherwise, false.</para>
+        </returns>
         <param name="millisecondsTimeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of milliseconds to wait, or -1 (<see cref="F:System.Threading.Timeout.Infinite" />) to wait indefinitely.</param>
       </Docs>
@@ -798,7 +813,6 @@
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="timeout" /> is 0 (zero), this method checks the lock state and returns false immediately if the desired state is unavailable.</para>
@@ -811,6 +825,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tries to enter the lock in write mode, with an optional time-out.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the calling thread entered write mode, otherwise, false.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The interval to wait, or -1 milliseconds to wait indefinitely.</param>
       </Docs>
diff --git a/mcs/class/System.Core/Documentation/en/System/TimeZoneInfo.xml b/mcs/class/System.Core/Documentation/en/System/TimeZoneInfo.xml
index 9783462c8d9..545448aee1a 100644
--- a/mcs/class/System.Core/Documentation/en/System/TimeZoneInfo.xml
+++ b/mcs/class/System.Core/Documentation/en/System/TimeZoneInfo.xml
@@ -192,7 +192,6 @@
         <Parameter Name="destinationTimeZone" Type="System.TimeZoneInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When performing the conversion, the <see cref="M:System.TimeZoneInfo.ConvertTime(System.DateTimeOffset,System.TimeZoneInfo)" /> method applies any adjustment rules in effect in the <paramref name="destinationTimeZone" /> time zone. </para>
@@ -306,6 +305,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a time to the time in a particular time zone.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The date and time in the destination time zone.</para>
+        </returns>
         <param name="dateTime">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time to convert.   </param>
         <param name="destinationTimeZone">
@@ -326,7 +329,6 @@
         <Parameter Name="destinationTimeZone" Type="System.TimeZoneInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When performing the conversion, the <see cref="M:System.TimeZoneInfo.ConvertTime(System.DateTimeOffset,System.TimeZoneInfo)" /> method applies any adjustment rules in effect in the <paramref name="destinationTimeZone" /> time zone.</para>
@@ -338,6 +340,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a time to the time in a particular time zone.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The date and time in the destination time zone.</para>
+        </returns>
         <param name="dateTimeOffset">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time to convert.   </param>
         <param name="destinationTimeZone">
@@ -359,7 +365,6 @@
         <Parameter Name="destinationTimeZone" Type="System.TimeZoneInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When performing the conversion, the <see cref="M:System.TimeZoneInfo.ConvertTime(System.DateTimeOffset,System.TimeZoneInfo)" /> method applies any adjustment rules in effect in the <paramref name="destinationTimeZone" /> time zone.</para>
@@ -491,6 +496,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a time from one time zone to another.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The date and time in the destination time zone that corresponds to the <paramref name="dateTime" /> parameter in the source time zone.</para>
+        </returns>
         <param name="dateTime">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time to convert.</param>
         <param name="sourceTimeZone">
@@ -513,7 +522,6 @@
         <Parameter Name="destinationTimeZoneId" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When performing the conversion, the <see cref="Overload:System.TimeZoneInfo.ConvertTimeBySystemTimeZoneId" /> method applies any adjustment rules in effect in the <paramref name="destinationTimeZoneId" /> time zone.</para>
@@ -618,6 +626,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a time to the time in another time zone based on the time zone's identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The date and time in the destination time zone.</para>
+        </returns>
         <param name="dateTime">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time to convert.</param>
         <param name="destinationTimeZoneId">
@@ -638,7 +650,6 @@
         <Parameter Name="destinationTimeZoneId" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When performing the conversion, the <see cref="Overload:System.TimeZoneInfo.ConvertTimeBySystemTimeZoneId" /> method applies any adjustment rules in effect in the <paramref name="destinationTimeZoneId" /> time zone.</para>
@@ -652,6 +663,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a time to the time in another time zone based on the time zone's identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The date and time in the destination time zone.</para>
+        </returns>
         <param name="dateTimeOffset">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time to convert.</param>
         <param name="destinationTimeZoneId">
@@ -673,7 +688,6 @@
         <Parameter Name="destinationTimeZoneId" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When performing the conversion, the <see cref="Overload:System.TimeZoneInfo.ConvertTimeBySystemTimeZoneId" /> method applies any adjustment rules in effect in the <paramref name="destinationTimeZoneId" /> time zone.</para>
@@ -763,6 +777,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a time from one time zone to another based on time zone identifiers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The date and time in the destination time zone that corresponds to the <paramref name="dateTime" /> parameter in the source time zone.</para>
+        </returns>
         <param name="dateTime">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time to convert.</param>
         <param name="sourceTimeZoneId">
@@ -785,7 +803,6 @@
         <Parameter Name="destinationTimeZone" Type="System.TimeZoneInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When performing the conversion, the <see cref="M:System.TimeZoneInfo.ConvertTimeFromUtc(System.DateTime,System.TimeZoneInfo)" /> method applies any adjustment rules in effect in the <paramref name="destinationTimeZone" /> time zone.</para>
@@ -826,6 +843,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a Coordinated Universal Time (UTC) to the time in a specified time zone.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The date and time in the destination time zone. Its <see cref="P:System.DateTime.Kind" /> property is <see cref="F:System.DateTimeKind.Utc" /> if <paramref name="destinationTimeZone" /> is <see cref="P:System.TimeZoneInfo.Utc" />; otherwise, its <see cref="P:System.DateTime.Kind" /> property is <see cref="F:System.DateTimeKind.Unspecified" />.</para>
+        </returns>
         <param name="dateTime">
           <attribution license="cc4" from="Microsoft" modified="false" />The Coordinated Universal Time (UTC).</param>
         <param name="destinationTimeZone">
@@ -845,7 +866,6 @@
         <Parameter Name="dateTime" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The exact conversion performed depends on the value of the <see cref="P:System.DateTime.Kind" /> property of the <paramref name="dateTime" /> parameter, as the following table shows.</para>
@@ -898,6 +918,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified date and time to Coordinated Universal Time (UTC).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The Coordinated Universal Time (UTC) that corresponds to the <paramref name="dateTime" /> parameter. The <see cref="T:System.DateTime" /> value's <see cref="P:System.DateTime.Kind" /> property is always set to <see cref="F:System.DateTimeKind.Utc" />.</para>
+        </returns>
         <param name="dateTime">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time to convert.</param>
       </Docs>
@@ -916,7 +940,6 @@
         <Parameter Name="sourceTimeZone" Type="System.TimeZoneInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="P:System.DateTime.Kind" /> property of the <paramref name="dateTime" /> parameter equals <see cref="F:System.DateTimeKind.Utc" /> and the <paramref name="sourceTimeZone" /> parameter equals <see cref="P:System.TimeZoneInfo.Utc" />, this method returns <paramref name="dateTime" /> without performing any conversion. </para>
@@ -927,6 +950,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the time in a specified time zone to Coordinated Universal Time (UTC).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The Coordinated Universal Time (UTC) that corresponds to the <paramref name="dateTime" /> parameter. The <see cref="T:System.DateTime" /> object's <see cref="P:System.DateTime.Kind" /> property is always set to <see cref="F:System.DateTimeKind.Utc" />.</para>
+        </returns>
         <param name="dateTime">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time to convert.</param>
         <param name="sourceTimeZone">
@@ -949,7 +976,6 @@
         <Parameter Name="standardDisplayName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload of the <see cref="M:System.TimeZoneInfo.CreateCustomTimeZone(System.String,System.TimeSpan,System.String,System.String)" /> method is suitable for creating a time zone that has no adjustments (that is, a time zone that does not support daylight saving time). To define a time zone that includes adjustments for daylight saving time, use either the <see cref="M:System.TimeZoneInfo.CreateCustomTimeZone(System.String,System.TimeSpan,System.String,System.String,System.String,System.TimeZoneInfo.AdjustmentRule[])" /> or the <see cref="M:System.TimeZoneInfo.CreateCustomTimeZone(System.String,System.TimeSpan,System.String,System.String,System.String,System.TimeZoneInfo.AdjustmentRule[],System.Boolean)" /> method.</para>
@@ -1023,6 +1049,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a custom time zone with a specified identifier, an offset from Coordinated Universal Time (UTC), a display name, and a standard time display name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new time zone.</para>
+        </returns>
         <param name="id">
           <attribution license="cc4" from="Microsoft" modified="false" />The time zone's identifier.</param>
         <param name="baseUtcOffset">
@@ -1156,7 +1186,6 @@
         <Parameter Name="other" Type="System.TimeZoneInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Equality is based on a comparison of values. Two <see cref="T:System.TimeZoneInfo" /> objects are considered to be equal under the following conditions:</para>
@@ -1180,6 +1209,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current <see cref="T:System.TimeZoneInfo" /> object and another <see cref="T:System.TimeZoneInfo" /> object are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two <see cref="T:System.TimeZoneInfo" /> objects are equal; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />A second object to compare with the current object.  </param>
       </Docs>
@@ -1197,7 +1230,6 @@
         <Parameter Name="id" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="id" /> parameter must correspond exactly to the time zone's registry key in length, but not in case, for a successful match to occur; that is, the comparison of <paramref name="id" /> with time zone identifiers is case-insensitive. If you want to retrieve time zone objects based on partial matches, you can write custom procedures that work with the read-only collection of <see cref="T:System.TimeZoneInfo" /> objects returned by the <see cref="M:System.TimeZoneInfo.GetSystemTimeZones" /> method. </para>
@@ -1208,6 +1240,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a <see cref="T:System.TimeZoneInfo" /> object from the registry based on its identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose identifier is the value of the <paramref name="id" /> parameter.</para>
+        </returns>
         <param name="id">
           <attribution license="cc4" from="Microsoft" modified="false" />The time zone identifier, which corresponds to the <see cref="P:System.TimeZoneInfo.Id" /> property.      </param>
       </Docs>
@@ -1225,7 +1261,6 @@
         <Parameter Name="source" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>There is an alternative to providing all the code required to create a time zone that is not found in the registry. You can define a custom time zone and either use the <see cref="M:System.TimeZoneInfo.ToSerializedString" /> method in a standalone executable or use an application's setup program to save the time zone as a string. The application can then retrieve this string from its storage location and instantiate it using the <see cref="M:System.TimeZoneInfo.FromSerializedString(System.String)" /> method.</para>
@@ -1234,6 +1269,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes a string to re-create an original serialized <see cref="T:System.TimeZoneInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The original serialized object.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string representation of the serialized <see cref="T:System.TimeZoneInfo" /> object.   </param>
       </Docs>
@@ -1249,7 +1288,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.TimeZoneInfo.GetAdjustmentRules" /> method retrieves an array of <see cref="T:System.TimeZoneInfo.AdjustmentRule" /> objects. Each object in the array defines the effective start and end date of that time zone adjustment, as well as its delta (the exact amount by which the adjustment causes the time to change). In addition, two properties return <see cref="T:System.TimeZoneInfo.TransitionTime" /> objects that define when each annual transition to and from standard time occurs. </para>
@@ -1261,6 +1299,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of <see cref="T:System.TimeZoneInfo.AdjustmentRule" /> objects that apply to the current <see cref="T:System.TimeZoneInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of objects for this time zone.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetAmbiguousTimeOffsets">
@@ -1276,7 +1318,6 @@
         <Parameter Name="dateTime" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The precise behavior of this method depends on the relationship between the <see cref="P:System.DateTime.Kind" /> property and the <see cref="T:System.TimeZoneInfo" /> object, as the following table shows.</para>
@@ -1368,6 +1409,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns information about the possible dates and times that an ambiguous date and time can be mapped to.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of objects that represents possible Coordinated Universal Time (UTC) offsets that a particular date and time can be mapped to.</para>
+        </returns>
         <param name="dateTime">
           <attribution license="cc4" from="Microsoft" modified="false" />A date and time.</param>
       </Docs>
@@ -1385,7 +1430,6 @@
         <Parameter Name="dateTimeOffset" Type="System.DateTimeOffset" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The precise behavior of this method depends on the relationship between the <see cref="P:System.DateTimeOffset.Offset" /> property of the <paramref name="dateTimeOffset" /> parameter and the <see cref="T:System.TimeZoneInfo" /> object. If the value of the <see cref="P:System.DateTimeOffset.Offset" /> property corresponds to the current time zone's possible offsets from Coordinated Universal Time (UTC) for that date and time, the method returns the possible offsets. Otherwise, it converts <paramref name="dateTime" /> to the time in the current time zone, and then returns the possible offsets of that date and time. </para>
@@ -1395,6 +1439,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns information about the possible dates and times that an ambiguous date and time can be mapped to.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of objects that represents possible Coordinated Universal Time (UTC) offsets that a particular date and time can be mapped to.</para>
+        </returns>
         <param name="dateTimeOffset">
           <attribution license="cc4" from="Microsoft" modified="false" />A date and time.</param>
       </Docs>
@@ -1410,7 +1458,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For additional detail about the <see cref="M:System.TimeZoneInfo.GetHashCode" /> method, see <see cref="M:System.Object.GetHashCode" />.</para>
@@ -1419,6 +1466,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for hashing algorithms and data structures such as hash tables.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer that serves as the hash code for this <see cref="T:System.TimeZoneInfo" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetObjectData">
@@ -1452,7 +1503,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.TimeZoneInfo.GetSystemTimeZones" /> method retrieves all available time zone information from the subkeys of the registry's HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\Time Zones key. If it is unable to successfully retrieve and parse values for particular string properties of individual <see cref="T:System.TimeZoneInfo" /> objects, this method sets their value to an empty string ("").</para>
@@ -1468,6 +1518,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a sorted collection of all the time zones about which information is available on the local system.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A read-only collection of <see cref="T:System.TimeZoneInfo" /> objects.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetUtcOffset">
@@ -1483,7 +1537,6 @@
         <Parameter Name="dateTime" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned time span includes any differences due to the application of adjustment rules to the current time zone. It differs from the <see cref="P:System.TimeZoneInfo.BaseUtcOffset" /> property, which returns the difference between Coordinated Universal Time (UTC) and the time zone's standard time and, therefore, does not take adjustment rules into account.</para>
@@ -1494,6 +1547,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the offset or difference between the time in this time zone and Coordinated Universal Time (UTC) for a particular date and time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that indicates the time difference between the two time zones.</para>
+        </returns>
         <param name="dateTime">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time to determine the offset for.   </param>
       </Docs>
@@ -1511,7 +1568,6 @@
         <Parameter Name="dateTimeOffset" Type="System.DateTimeOffset" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned time span includes any differences due to the application of adjustment rules to the current time zone. It differs from the <see cref="P:System.TimeZoneInfo.BaseUtcOffset" /> property, which returns the difference between Coordinated Universal Time (UTC) and the time zone's standard time and, therefore, does not take adjustment rules into account.</para>
@@ -1520,6 +1576,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the offset or difference between the time in this time zone and Coordinated Universal Time (UTC) for a particular date and time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that indicates the time difference between Coordinated Universal Time (UTC) and the current time zone.</para>
+        </returns>
         <param name="dateTimeOffset">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time to determine the offset for.</param>
       </Docs>
@@ -1537,7 +1597,6 @@
         <Parameter Name="other" Type="System.TimeZoneInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Like the <see cref="M:System.TimeZoneInfo.Equals(System.TimeZoneInfo)" /> method, the <see cref="M:System.TimeZoneInfo.HasSameRules(System.TimeZoneInfo)" /> method indicates whether two time zones have the same base offset (as defined by the <see cref="P:System.TimeZoneInfo.BaseUtcOffset" /> property) and the same adjustment rules. Unlike the <see cref="M:System.TimeZoneInfo.Equals(System.TimeZoneInfo)" /> method, <see cref="M:System.TimeZoneInfo.HasSameRules(System.TimeZoneInfo)" /> does not compare time zone identifiers (as defined by the <see cref="P:System.TimeZoneInfo.Id" /> property).</para>
@@ -1546,6 +1605,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the current object and another <see cref="T:System.TimeZoneInfo" /> object have the same adjustment rules.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two time zones have identical adjustment rules and an identical base offset; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />A second object to compare with the current <see cref="T:System.TimeZoneInfo" /> object.   </param>
       </Docs>
@@ -1588,7 +1651,6 @@
         <Parameter Name="dateTime" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An ambiguous time falls within a range of times for the current time zone. This means it can be either a standard time or a time that results from the application of an adjustment rule. Typically, ambiguous times result when the clock is set to return to standard time from daylight saving time. See the Example section for an illustration. </para>
@@ -1697,6 +1759,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a particular date and time in a particular time zone is ambiguous and can be mapped to two or more Coordinated Universal Time (UTC) times.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="dateTime" /> parameter is ambiguous; otherwise, false.</para>
+        </returns>
         <param name="dateTime">
           <attribution license="cc4" from="Microsoft" modified="false" />A date and time value.   </param>
       </Docs>
@@ -1714,7 +1780,6 @@
         <Parameter Name="dateTimeOffset" Type="System.DateTimeOffset" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An ambiguous time falls within a range of times for the current time zone. This means that it can be either a standard time or a time that results from the application of an adjustment rule. Typically, ambiguous times result when the clock is set to return to standard time from daylight saving time. Coordinated Universal Time (UTC) has no ambiguous times; neither do time zones that do not support daylight saving time. </para>
@@ -1724,6 +1789,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a particular date and time in a particular time zone is ambiguous and can be mapped to two or more Coordinated Universal Time (UTC) times.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="dateTimeOffset" /> parameter is ambiguous in the current time zone; otherwise, false.</para>
+        </returns>
         <param name="dateTimeOffset">
           <attribution license="cc4" from="Microsoft" modified="false" />A date and time.</param>
       </Docs>
@@ -1741,7 +1810,6 @@
         <Parameter Name="dateTime" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value of <see cref="M:System.TimeZoneInfo.IsDaylightSavingTime(System.DateTime)" /> is affected by the relationship between the time zone represented by the <see cref="T:System.TimeZoneInfo" /> object and the <see cref="P:System.DateTime.Kind" /> property of the <paramref name="dateTime" /> parameter, as the following table shows.</para>
@@ -1856,6 +1924,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a specified date and time falls in the range of daylight saving time for the time zone of the current <see cref="T:System.TimeZoneInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="dateTime" /> parameter is a daylight saving time; otherwise, false.</para>
+        </returns>
         <param name="dateTime">
           <attribution license="cc4" from="Microsoft" modified="false" />A date and time value.   </param>
       </Docs>
@@ -1873,7 +1945,6 @@
         <Parameter Name="dateTimeOffset" Type="System.DateTimeOffset" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value of <see cref="M:System.TimeZoneInfo.IsDaylightSavingTime(System.DateTime)" /> is affected by the relationship between the time zone represented by the <see cref="T:System.TimeZoneInfo" /> object and the <see cref="P:System.DateTimeOffset.Offset" /> property of the <paramref name="dateTimeOffset" /> parameter. If <paramref name="dateTimeOffset" /> does not correspond to the current time zone's offset from Coordinated Universal Time (UTC), the method converts that time to the time in the current time zone. It then determines whether that date and time is a daylight saving time.</para>
@@ -1883,6 +1954,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a specified date and time falls in the range of daylight saving time for the time zone of the current <see cref="T:System.TimeZoneInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="dateTimeOffset" /> parameter is a daylight saving time; otherwise, false.</para>
+        </returns>
         <param name="dateTimeOffset">
           <attribution license="cc4" from="Microsoft" modified="false" />A date and time value.</param>
       </Docs>
@@ -1900,7 +1975,6 @@
         <Parameter Name="dateTime" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An invalid time falls within a range of times for the current time zone that cannot be mapped to Coordinated Universal Time (UTC) due to the application of an adjustment rule. Typically, invalid times occur when the time moves ahead for daylight saving time. See the Example section for an illustration.</para>
@@ -1980,6 +2054,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a particular date and time is invalid.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="dateTime" /> is invalid; otherwise, false.</para>
+        </returns>
         <param name="dateTime">
           <attribution license="cc4" from="Microsoft" modified="false" />A date and time value.   </param>
       </Docs>
@@ -2113,7 +2191,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Applications that rely on time zones that are not typically defined in the registry of Windows systems can use the <see cref="Overload:System.TimeZoneInfo.CreateCustomTimeZone" /> method to instantiate the necessary time zones as <see cref="T:System.TimeZoneInfo" /> objects. The application can then call the <see cref="M:System.TimeZoneInfo.ToSerializedString" /> method to convert the time zone object to a string. </para>
@@ -2134,6 +2211,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the current <see cref="T:System.TimeZoneInfo" /> object to a serialized string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.TimeZoneInfo" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -2147,7 +2228,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When assigning a collection that contains <see cref="T:System.TimeZoneInfo" /> objects to a list control such as the <see cref="T:System.Windows.Forms.ListBox" /> control, the control automatically calls the <see cref="M:System.TimeZoneInfo.ToString" /> method to extract a string that describes each object to be represented in the list. As a result, you do not need to store a meaningful description of the object as a string, and the user does not need to use that string to extract the object from the collection. See <format type="text/html"><a href="bb7a42ab-6bd9-4c5c-b734-5546d51f8669">How to: Enumerate Time Zones Present on a Computer</a></format> for more detail.</para>
@@ -2156,6 +2236,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the current <see cref="T:System.TimeZoneInfo" /> object's display name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the <see cref="P:System.TimeZoneInfo.DisplayName" /> property of the current <see cref="T:System.TimeZoneInfo" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Utc">
diff --git a/mcs/class/System.Data/Documentation/en/Microsoft.SqlServer.Server/SqlMetaData.xml b/mcs/class/System.Data/Documentation/en/Microsoft.SqlServer.Server/SqlMetaData.xml
index 88be92cc382..7384921118e 100644
--- a/mcs/class/System.Data/Documentation/en/Microsoft.SqlServer.Server/SqlMetaData.xml
+++ b/mcs/class/System.Data/Documentation/en/Microsoft.SqlServer.Server/SqlMetaData.xml
@@ -1413,13 +1413,16 @@
         <Parameter Name="value" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified <see cref="T:System.Boolean" /> value against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as a <see cref="T:System.Boolean" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -1437,13 +1440,16 @@
         <Parameter Name="value" Type="System.Byte" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified <see cref="T:System.Byte" /> value against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as a <see cref="T:System.Byte" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -1461,13 +1467,16 @@
         <Parameter Name="value" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified array of <see cref="T:System.Byte" /> values against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as an array of <see cref="T:System.Byte" /> values.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -1485,13 +1494,16 @@
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified <see cref="T:System.Char" /> value against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as a <see cref="T:System.Char" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -1509,13 +1521,16 @@
         <Parameter Name="value" Type="System.Char[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified array of <see cref="T:System.Char" /> values against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as an array <see cref="T:System.Char" /> values.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -1533,13 +1548,16 @@
         <Parameter Name="value" Type="System.Data.SqlTypes.SqlBinary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified <see cref="T:System.Data.SqlTypes.SqlBinary" /> value against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as a <see cref="T:System.Data.SqlTypes.SqlBinary" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -1557,13 +1575,16 @@
         <Parameter Name="value" Type="System.Data.SqlTypes.SqlBoolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified <see cref="T:System.Data.SqlTypes.SqlBoolean" /> value against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as a <see cref="T:System.Data.SqlTypes.SqlBoolean" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -1581,13 +1602,16 @@
         <Parameter Name="value" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified <see cref="T:System.Data.SqlTypes.SqlByte" /> value against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as a <see cref="T:System.Data.SqlTypes.SqlByte" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -1605,13 +1629,16 @@
         <Parameter Name="value" Type="System.Data.SqlTypes.SqlBytes" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified <see cref="T:System.Data.SqlTypes.SqlBytes" /> value against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as a <see cref="T:System.Data.SqlTypes.SqlBytes" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -1629,13 +1656,16 @@
         <Parameter Name="value" Type="System.Data.SqlTypes.SqlChars" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified <see cref="T:System.Data.SqlTypes.SqlChars" /> value against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as a <see cref="T:System.Data.SqlTypes.SqlChars" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -1653,13 +1683,16 @@
         <Parameter Name="value" Type="System.Data.SqlTypes.SqlDateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified <see cref="T:System.Data.SqlTypes.SqlDateTime" /> value against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as a <see cref="T:System.Data.SqlTypes.SqlDateTime" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -1677,13 +1710,16 @@
         <Parameter Name="value" Type="System.Data.SqlTypes.SqlDecimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified <see cref="T:System.Data.SqlTypes.SqlDecimal" /> value against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as a <see cref="T:System.Data.SqlTypes.SqlDecimal" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -1701,13 +1737,16 @@
         <Parameter Name="value" Type="System.Data.SqlTypes.SqlDouble" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified <see cref="T:System.Data.SqlTypes.SqlDouble" /> value against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as a <see cref="T:System.Data.SqlTypes.SqlDouble" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -1725,13 +1764,16 @@
         <Parameter Name="value" Type="System.Data.SqlTypes.SqlGuid" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified <see cref="T:System.Data.SqlTypes.SqlGuid" /> value against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as a <see cref="T:System.Data.SqlTypes.SqlGuid" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -1749,13 +1791,16 @@
         <Parameter Name="value" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified <see cref="T:System.Data.SqlTypes.SqlInt16" /> value against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as a <see cref="T:System.Data.SqlTypes.SqlInt16" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -1773,13 +1818,16 @@
         <Parameter Name="value" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified <see cref="T:System.Data.SqlTypes.SqlInt32" /> value against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as a <see cref="T:System.Data.SqlTypes.SqlInt32" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -1797,13 +1845,16 @@
         <Parameter Name="value" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified <see cref="T:System.Data.SqlTypes.SqlInt64" /> value against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as a <see cref="T:System.Data.SqlTypes.SqlInt64" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -1821,13 +1872,16 @@
         <Parameter Name="value" Type="System.Data.SqlTypes.SqlMoney" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified <see cref="T:System.Data.SqlTypes.SqlMoney" /> value against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as a <see cref="T:System.Data.SqlTypes.SqlMoney" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -1845,13 +1899,16 @@
         <Parameter Name="value" Type="System.Data.SqlTypes.SqlSingle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified <see cref="T:System.Data.SqlTypes.SqlSingle" /> value against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as a <see cref="T:System.Data.SqlTypes.SqlSingle" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -1869,13 +1926,16 @@
         <Parameter Name="value" Type="System.Data.SqlTypes.SqlString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified <see cref="T:System.Data.SqlTypes.SqlString" /> value against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as a <see cref="T:System.Data.SqlTypes.SqlString" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -1893,13 +1953,16 @@
         <Parameter Name="value" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified <see cref="T:System.DateTime" /> value against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as a <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -1917,13 +1980,16 @@
         <Parameter Name="value" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified <see cref="T:System.Decimal" /> value against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as a <see cref="T:System.Decimal" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -1941,13 +2007,16 @@
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified <see cref="T:System.Double" /> value against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as a <see cref="T:System.Double" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -1965,13 +2034,16 @@
         <Parameter Name="value" Type="System.Guid" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified <see cref="T:System.Guid" /> value against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as a <see cref="T:System.Guid" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -1989,13 +2061,16 @@
         <Parameter Name="value" Type="System.Int16" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified <see cref="T:System.Int16" /> value against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as a <see cref="T:System.Int16" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -2013,13 +2088,16 @@
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified <see cref="T:System.Int32" /> value against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as a <see cref="T:System.Int32" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -2037,13 +2115,16 @@
         <Parameter Name="value" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified <see cref="T:System.Int64" /> value against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as a <see cref="T:System.Int64" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -2061,13 +2142,16 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified <see cref="T:System.Object" /> value against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as a <see cref="T:System.Object" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -2085,13 +2169,16 @@
         <Parameter Name="value" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified <see cref="T:System.Single" /> value against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as a <see cref="T:System.Single" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -2109,13 +2196,16 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the specified <see cref="T:System.String" /> value against the metadata, and adjusts the value if necessary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The adjusted value as a <see cref="T:System.String" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate against the <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</param>
       </Docs>
@@ -2175,13 +2265,16 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Infers the metadata from the specified object and returns it as a <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The inferred metadata as a <see cref="T:Microsoft.SqlServer.Server.SqlMetaData" /> instance.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object used from which the metadata is inferred.</param>
         <param name="name">
diff --git a/mcs/class/System.Data/Documentation/en/Microsoft.SqlServer.Server/SqlTriggerContext.xml b/mcs/class/System.Data/Documentation/en/Microsoft.SqlServer.Server/SqlTriggerContext.xml
index f613b35961b..562d73be0ed 100644
--- a/mcs/class/System.Data/Documentation/en/Microsoft.SqlServer.Server/SqlTriggerContext.xml
+++ b/mcs/class/System.Data/Documentation/en/Microsoft.SqlServer.Server/SqlTriggerContext.xml
@@ -76,13 +76,16 @@
         <Parameter Name="columnOrdinal" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns true if a column was affected by an INSERT or UPDATE statement.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the column was affected by an INSERT or UPDATE operation.</para>
+        </returns>
         <param name="columnOrdinal">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based ordinal of the column.</param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Common/DBDataPermission.xml b/mcs/class/System.Data/Documentation/en/System.Data.Common/DBDataPermission.xml
index ded70e2d48a..6b49f345707 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Common/DBDataPermission.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Common/DBDataPermission.xml
@@ -237,7 +237,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Security.IPermission'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A copy of a permission object represents the same access to resources as the original permission object.</para>
@@ -246,6 +245,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an identical copy of the current permission object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current permission object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -260,12 +263,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'DBDataPermission'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the DBDataPermission class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new DBDataPermission object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -308,7 +314,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Security.IPermission'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The intersection of two permissions is a permission that describes the set of operations they both describe. Only a demand that passes both original permissions will pass the intersection.</para>
@@ -317,6 +322,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new permission object representing the intersection of the current permission object and the specified permission object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission object that represents the intersection of the current permission object and the specified permission object. This new permission object is a null reference (Nothing in Visual Basic) if the intersection is empty.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission object to intersect with the current permission object. It must be of the same type as the current permission object. </param>
       </Docs>
@@ -335,7 +344,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current permission object is a subset of the specified permission object if the current permission object specifies a set of operations that is wholly contained by the specified permission object. For example, a permission that represents access to C:\example.txt is a subset of a permission that represents access to C:\. If this method returns true, the current permission object represents no more access to the protected resource than does the specified permission object.</para>
@@ -344,6 +352,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the current permission object is a subset of the specified permission object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission object is a subset of the specified permission object, otherwise false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission object that is to be tested for the subset relationship. This object must be of the same type as the current permission object. </param>
       </Docs>
@@ -360,12 +372,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the permission can be represented as unrestricted without any knowledge of the permission semantics.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the permission can be represented as unrestricted.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -380,7 +395,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Security.SecurityElement'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Custom code that extends security objects must implement the <see cref="M:System.Data.Common.DBDataPermission.ToXml" /> and <see cref="M:System.Data.Common.DBDataPermission.FromXml(System.Security.SecurityElement)" /> methods to make the objects security encodable.</para>
@@ -389,6 +403,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the security object and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the security object, including any state information.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -405,7 +423,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Security.IPermission'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The result of a call to <see cref="M:System.Data.Common.DBDataPermission.Union(System.Security.IPermission)" /> is a permission that represents all the operations permitted by both the current permission object and the specified permission object. Any demand that passes either permission passes their union.</para>
@@ -414,6 +431,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new permission object that is the union of the current and specified permission objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission object that represents the union of the current permission object and the specified permission object.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission object to combine with the current permission object. It must be of the same type as the current permission object. </param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Common/DBDataPermissionAttribute.xml b/mcs/class/System.Data/Documentation/en/System.Data.Common/DBDataPermissionAttribute.xml
index 29450990148..2cc28bcf03f 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Common/DBDataPermissionAttribute.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Common/DBDataPermissionAttribute.xml
@@ -149,12 +149,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Identifies whether the attribute should serialize the connection string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute should serialize the connection string; otherwise false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ShouldSerializeKeyRestrictions">
@@ -173,12 +176,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Identifies whether the attribute should serialize the set of key restrictions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute should serialize the set of key restrictions; otherwise false.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Common/DataAdapter.xml b/mcs/class/System.Data/Documentation/en/System.Data.Common/DataAdapter.xml
index 4d2df19d69c..804ae3e9bd3 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Common/DataAdapter.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Common/DataAdapter.xml
@@ -178,7 +178,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'DataAdapter'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is deprecated. The <see cref="M:System.Data.Common.DataAdapter.#ctor(System.Data.Common.DataAdapter)" /> constructor should be used instead of this method.</para>
@@ -188,6 +187,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of this instance of <see cref="T:System.Data.Common.DataAdapter" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The cloned instance of <see cref="T:System.Data.Common.DataAdapter" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -237,12 +240,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'DataTableMappingCollection'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Data.Common.DataTableMappingCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new table mapping collection.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -286,7 +292,6 @@
         <Parameter Name="dataSet" Type="System.Data.DataSet" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.Common.DataAdapter.Fill(System.Data.DataSet)" /> method retrieves rows from the data source using the SELECT statement specified by an associated <see cref="P:System.Data.IDbDataAdapter.SelectCommand" /> property. The connection object associated with the SELECT statement must be valid, but it does not need to be open. If the connection is closed before <see cref="M:System.Data.Common.DataAdapter.Fill(System.Data.DataSet)" /> is called, it is opened to retrieve data, then closed. If the connection is open before <see cref="M:System.Data.Common.DataAdapter.Fill(System.Data.DataSet)" /> is called, it remains open.</para>
@@ -303,6 +308,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds or refreshes rows in the <see cref="T:System.Data.DataSet" /> to match those in the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows successfully added to or refreshed in the <see cref="T:System.Data.DataSet" />. This does not include rows affected by statements that do not return rows.</para>
+        </returns>
         <param name="dataSet">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.DataSet" /> to fill with records and, if necessary, schema. </param>
       </Docs>
@@ -325,7 +334,6 @@
         <Parameter Name="dataReader" Type="System.Data.IDataReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the remarks for System.Data.Common.DataAdapter.Fill(System.Data.DataSet) for additional information.</para>
@@ -334,6 +342,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds or refreshes rows in the <see cref="T:System.Data.DataTable" /> to match those in the data source using the <see cref="T:System.Data.DataTable" /> name and the specified <see cref="T:System.Data.IDataReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows successfully added to or refreshed in the <see cref="T:System.Data.DataTable" />. This does not include rows affected by statements that do not return rows.</para>
+        </returns>
         <param name="dataTable">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.DataTable" /> to fill with records.</param>
         <param name="dataReader">
@@ -356,7 +368,6 @@
         <Parameter Name="maxRecords" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the remarks for System.Data.Common.DataAdapter.Fill(System.Data.DataSet) for additional information.</para>
@@ -365,6 +376,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds or refreshes rows in a specified range in the collection of <see cref="T:System.Data.DataTable" /> objects to match those in the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows successfully added to or refreshed in the <see cref="T:System.Data.DataTable" />. This does not include rows affected by statements that do not return rows.</para>
+        </returns>
         <param name="dataTables">
           <attribution license="cc4" from="Microsoft" modified="false" />A collection of <see cref="T:System.Data.DataTable" /> objects to fill with records.</param>
         <param name="dataReader">
@@ -392,7 +407,6 @@
         <Parameter Name="maxRecords" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the remarks for System.Data.Common.DataAdapter.Fill(System.Data.DataSet) for additional information.</para>
@@ -401,6 +415,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds or refreshes rows in a specified range in the <see cref="T:System.Data.DataSet" /> to match those in the data source using the <see cref="T:System.Data.DataSet" /> and <see cref="T:System.Data.DataTable" /> names.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows successfully added to or refreshed in the <see cref="T:System.Data.DataSet" />. This does not include rows affected by statements that do not return rows.</para>
+        </returns>
         <param name="dataSet">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.DataSet" /> to fill with records.</param>
         <param name="srcTable">
@@ -475,7 +493,6 @@
         <Parameter Name="schemaType" Type="System.Data.SchemaType" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Data.DataTable []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.Common.DataAdapter.FillSchema(System.Data.DataSet,System.Data.SchemaType)" /> method retrieves the schema from the data source using the <see cref="P:System.Data.IDbDataAdapter.SelectCommand" />. The connection object associated with the <see cref="P:System.Data.IDbDataAdapter.SelectCommand" /> must be valid, but it does not need to be open. If the connection is closed before <see cref="M:System.Data.Common.DataAdapter.FillSchema(System.Data.DataSet,System.Data.SchemaType)" /> is called, it is opened to retrieve data and then closed. If the connection is open before <see cref="M:System.Data.Common.DataAdapter.FillSchema(System.Data.DataSet,System.Data.SchemaType)" /> is called, it remains open.</para>
@@ -531,6 +548,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Data.DataTable" /> to the specified <see cref="T:System.Data.DataSet" /> and configures the schema to match that in the data source based on the specified <see cref="T:System.Data.SchemaType" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataTable" /> object that contains schema information returned from the data source.</para>
+        </returns>
         <param name="dataSet">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.DataSet" /> to be filled with the schema from the data source. </param>
         <param name="schemaType">
@@ -556,12 +577,15 @@
         <Parameter Name="dataReader" Type="System.Data.IDataReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Data.DataTable" /> to the specified <see cref="T:System.Data.DataSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataTable" /> object that contains schema information returned from the data source.</para>
+        </returns>
         <param name="dataTable">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.DataTable" /> to be filled from the <see cref="T:System.Data.IDataReader" />.</param>
         <param name="schemaType">
@@ -586,12 +610,15 @@
         <Parameter Name="dataReader" Type="System.Data.IDataReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Data.DataTable" /> to the specified <see cref="T:System.Data.DataSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to a collection of <see cref="T:System.Data.DataTable" /> objects that were added to the <see cref="T:System.Data.DataSet" />.</para>
+        </returns>
         <param name="dataSet">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.DataTable" /> to be filled from the <see cref="T:System.Data.IDataReader" />.</param>
         <param name="schemaType">
@@ -610,12 +637,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Data.IDataParameter []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the parameters set by the user when executing an SQL SELECT statement.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Data.IDataParameter" /> objects that contains the parameters set by the user.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -638,12 +668,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a <see cref="T:System.Data.Common.DataTableMappingCollection" /> has been created.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a <see cref="T:System.Data.Common.DataTableMappingCollection" /> has been created; otherwise false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MissingMappingAction">
@@ -788,12 +821,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="P:System.Data.Common.DataAdapter.AcceptChangesDuringFill" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="P:System.Data.Common.DataAdapter.AcceptChangesDuringFill" /> property is persisted; otherwise false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ShouldSerializeFillLoadOption">
@@ -812,12 +848,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="P:System.Data.Common.DataAdapter.FillLoadOption" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="P:System.Data.Common.DataAdapter.FillLoadOption" /> property is persisted; otherwise false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ShouldSerializeTableMappings">
@@ -828,12 +867,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether one or more <see cref="T:System.Data.Common.DataTableMapping" /> objects exist and they should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if one or more <see cref="T:System.Data.Common.DataTableMapping" /> objects exist; otherwise false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -900,7 +942,6 @@
         <Parameter Name="dataSet" Type="System.Data.DataSet" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The update is performed on a by-row basis. For every inserted, modified, and deleted row, the <see cref="M:System.Data.Common.DataAdapter.Update(System.Data.DataSet)" /> method determines the type of change that has been performed on it (Insert, Update or Delete). Depending on the type of change, the Insert, Update, or Delete command template executes to propagate the modified row to the data source. When an application calls the <see cref="M:System.Data.Common.DataAdapter.Update(System.Data.DataSet)" /> method, the <see cref="T:System.Data.Common.DataAdapter" /> examines the <see cref="P:System.Data.DataRow.RowState" /> property, and executes the required INSERT, UPDATE, or DELETE statements iteratively for each row, based on the order of the indexes configured in the <see cref="T:System.Data.DataSet" />. For example, <see cref="M:System.Data.Common.DataAdapter.Update(System.Data.DataSet)" /> might execute a DELETE statement, followed by an INSERT statement, and then another DELETE statement, due to the ordering of the rows in the <see cref="T:System.Data.DataTable" />.</para>
@@ -983,6 +1024,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calls the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified <see cref="T:System.Data.DataSet" /> from a <see cref="T:System.Data.DataTable" /> named "Table."</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows successfully updated from the <see cref="T:System.Data.DataSet" />.</para>
+        </returns>
         <param name="dataSet">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.DataSet" /> used to update the data source. </param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Common/DataColumnMapping.xml b/mcs/class/System.Data/Documentation/en/System.Data.Common/DataColumnMapping.xml
index af74b1f7f90..1e67d6ffff4 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Common/DataColumnMapping.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Common/DataColumnMapping.xml
@@ -115,12 +115,15 @@
         <Parameter Name="schemaAction" Type="System.Data.MissingSchemaAction" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Data.DataColumn'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Data.DataColumn" /> from the given <see cref="T:System.Data.DataTable" /> using the <see cref="T:System.Data.MissingSchemaAction" /> and the <see cref="P:System.Data.Common.DataColumnMapping.DataSetColumn" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A data column.</para>
+        </returns>
         <param name="dataTable">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.DataTable" /> to get the column from.</param>
         <param name="dataType">
@@ -160,12 +163,15 @@
         <Parameter Name="schemaAction" Type="System.Data.MissingSchemaAction" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A static version of <see cref="M:System.Data.Common.DataColumnMapping.GetDataColumnBySchemaAction(System.Data.DataTable,System.Type,System.Data.MissingSchemaAction)" /> that can be called without instantiating a <see cref="T:System.Data.Common.DataColumnMapping" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataColumn" /> object.</para>
+        </returns>
         <param name="sourceColumn">
           <attribution license="cc4" from="Microsoft" modified="false" />The case-sensitive column name from a data source. </param>
         <param name="dataSetColumn">
@@ -216,7 +222,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.SqlClient.SqlCommand" /> instance is cast to an <see cref="T:System.ICloneable" /> interface.</para>
@@ -226,6 +231,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new object that is a copy of the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -236,12 +245,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the current <see cref="P:System.Data.Common.DataColumnMapping.SourceColumn" /> name to a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current <see cref="P:System.Data.Common.DataColumnMapping.SourceColumn" /> name as a string.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Common/DataColumnMappingCollection.xml b/mcs/class/System.Data/Documentation/en/System.Data.Common/DataColumnMappingCollection.xml
index 24fd7b20e46..8120b502ba6 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Common/DataColumnMappingCollection.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Common/DataColumnMappingCollection.xml
@@ -52,12 +52,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Data.Common.DataColumnMapping" /> object to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the DataColumnMapping object that was added to the collection.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A DataColumnMapping object to add to the collection. </param>
       </Docs>
@@ -77,12 +80,15 @@
         <Parameter Name="dataSetColumn" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataColumnMapping'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Data.Common.DataColumnMapping" /> object to the collection when given a source column name and a <see cref="T:System.Data.DataSet" /> column name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The DataColumnMapping object that was added to the collection.</para>
+        </returns>
         <param name="sourceColumn">
           <attribution license="cc4" from="Microsoft" modified="false" />The case-sensitive name of the source column to map to. </param>
         <param name="dataSetColumn">
@@ -167,12 +173,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether a <see cref="T:System.Data.Common.DataColumnMapping" /> object with the given <see cref="T:System.Object" /> exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the specified <see cref="T:System.Data.Common.DataColumnMapping" /> object; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Object" /> that is the <see cref="T:System.Data.Common.DataColumnMapping" />. </param>
       </Docs>
@@ -191,12 +200,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether a <see cref="T:System.Data.Common.DataColumnMapping" /> object with the given source column name exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if collection contains a <see cref="T:System.Data.Common.DataColumnMapping" /> object with the specified source column name; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The case-sensitive source column name of the <see cref="T:System.Data.Common.DataColumnMapping" /> object. </param>
       </Docs>
@@ -292,12 +304,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataColumnMapping'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Data.Common.DataColumnMapping" /> object with the specified <see cref="T:System.Data.DataSet" /> column name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Data.Common.DataColumnMapping" /> object with the specified <see cref="T:System.Data.DataSet" /> column name.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The name, which is not case-sensitive, of the <see cref="T:System.Data.DataSet" /> column to find. </param>
       </Docs>
@@ -318,7 +333,6 @@
         <Parameter Name="mappingAction" Type="System.Data.MissingMappingAction" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataColumnMapping'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="T:System.Data.Common.DataColumnMapping" /> exists in the collection, it is returned.</para>
@@ -364,6 +378,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Data.Common.DataColumnMapping" /> for the specified <see cref="T:System.Data.Common.DataColumnMappingCollection" />, source column name, and <see cref="T:System.Data.MissingMappingAction" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.Common.DataColumnMapping" /> object.</para>
+        </returns>
         <param name="columnMappings">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.Common.DataColumnMappingCollection" />. </param>
         <param name="sourceColumn">
@@ -404,12 +422,15 @@
         <Parameter Name="schemaAction" Type="System.Data.MissingSchemaAction" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A static method that returns a <see cref="T:System.Data.DataColumn" /> object without instantiating a <see cref="T:System.Data.Common.DataColumnMappingCollection" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataColumn" /> object.</para>
+        </returns>
         <param name="columnMappings">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.Common.DataColumnMappingCollection" />.</param>
         <param name="sourceColumn">
@@ -432,12 +453,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IEnumerator'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an enumerator that can iterate through the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -454,12 +478,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the location of the specified <see cref="T:System.Object" /> that is a <see cref="T:System.Data.Common.DataColumnMapping" /> within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based location of the specified <see cref="T:System.Object" /> that is a <see cref="T:System.Data.Common.DataColumnMapping" /> within the collection.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Object" /> that is the <see cref="T:System.Data.Common.DataColumnMapping" /> to find. </param>
       </Docs>
@@ -478,12 +505,15 @@
         <Parameter Name="sourceColumn" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the location of the <see cref="T:System.Data.Common.DataColumnMapping" /> with the specified source column name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based location of the <see cref="T:System.Data.Common.DataColumnMapping" /> with the specified case-sensitive source column name.</para>
+        </returns>
         <param name="sourceColumn">
           <attribution license="cc4" from="Microsoft" modified="false" />The case-sensitive name of the source column. </param>
       </Docs>
@@ -502,12 +532,15 @@
         <Parameter Name="dataSetColumn" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the location of the specified <see cref="T:System.Data.Common.DataColumnMapping" /> with the given <see cref="T:System.Data.DataSet" /> column name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based location of the specified <see cref="T:System.Data.Common.DataColumnMapping" /> with the given DataSet column name, or -1 if the DataColumnMapping object does not exist in the collection.</para>
+        </returns>
         <param name="dataSetColumn">
           <attribution license="cc4" from="Microsoft" modified="false" />The name, which is not case-sensitive, of the data set column to find. </param>
       </Docs>
@@ -556,6 +589,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts a <see cref="T:System.Data.Common.DataColumnMapping" /> object into the <see cref="T:System.Data.Common.DataColumnMappingCollection" /> at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.Common.DataColumnMapping" /> object.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the <see cref="T:System.Data.Common.DataColumnMapping" /> object to insert. </param>
         <param name="value">
@@ -840,7 +877,6 @@
         <Parameter Name="dataSetColumnName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Common.DataColumnMappingCollection" /> instance is cast to an <see cref="T:System.Data.IColumnMappingCollection" /> interface.</para>
@@ -850,6 +886,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Data.Common.DataColumnMapping" /> object to the <see cref="T:System.Data.Common.DataColumnMappingCollection" /> by using the source column and <see cref="T:System.Data.DataSet" /> column names.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The ColumnMapping object that was added to the collection.</para>
+        </returns>
         <param name="sourceColumnName">
           <attribution license="cc4" from="Microsoft" modified="false" />The case-sensitive name of the source column.</param>
         <param name="dataSetColumnName">
@@ -870,7 +910,6 @@
         <Parameter Name="dataSetColumnName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Common.DataColumnMappingCollection" /> instance is cast to an <see cref="T:System.Data.IColumnMappingCollection" /> interface.</para>
@@ -880,6 +919,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Data.Common.DataColumnMapping" /> object that has the specified <see cref="T:System.Data.DataSet" /> column name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Data.Common.DataColumnMapping" /> object that  has the specified <see cref="T:System.Data.DataSet" /> column name.</para>
+        </returns>
         <param name="dataSetColumnName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name, which is not case-sensitive, of the <see cref="T:System.Data.DataSet" /> column to find.</param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Common/DataTableMapping.xml b/mcs/class/System.Data/Documentation/en/System.Data.Common/DataTableMapping.xml
index 58af3219486..13b66c461e4 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Common/DataTableMapping.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Common/DataTableMapping.xml
@@ -165,7 +165,6 @@
         <Parameter Name="mappingAction" Type="System.Data.MissingMappingAction" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataColumnMapping'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="T:System.Data.Common.DataColumnMapping" /> exists, it is returned.</para>
@@ -211,6 +210,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Data.DataColumn" /> from the specified <see cref="T:System.Data.DataTable" /> using the specified <see cref="T:System.Data.MissingMappingAction" /> value and the name of the <see cref="T:System.Data.DataColumn" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A data column.</para>
+        </returns>
         <param name="sourceColumn">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Data.DataColumn" />. </param>
         <param name="mappingAction">
@@ -248,12 +251,15 @@
         <Parameter Name="schemaAction" Type="System.Data.MissingSchemaAction" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Data.DataColumn" /> object for a given column name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataColumn" /> object.</para>
+        </returns>
         <param name="sourceColumn">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Data.DataColumn" />. </param>
         <param name="dataType">
@@ -277,7 +283,6 @@
         <Parameter Name="schemaAction" Type="System.Data.MissingSchemaAction" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Data.DataTable'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="T:System.Data.DataTable" /> does not exist, the specified <see cref="T:System.Data.MissingSchemaAction" /> is taken.</para>
@@ -286,6 +291,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the current <see cref="T:System.Data.DataTable" /> for the specified <see cref="T:System.Data.DataSet" /> using the specified <see cref="T:System.Data.MissingSchemaAction" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A data table.</para>
+        </returns>
         <param name="dataSet">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.DataSet" /> from which to get the <see cref="T:System.Data.DataTable" />. </param>
         <param name="schemaAction">
@@ -362,7 +371,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Common.DataTableMapping" /> instance is cast to an <see cref="T:System.ICloneable" /> interface.</para>
@@ -372,6 +380,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new object that is a copy of the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new object that is a copy of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -382,12 +394,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the current <see cref="P:System.Data.Common.DataTableMapping.SourceTable" /> name to a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current <see cref="P:System.Data.Common.DataTableMapping.SourceTable" /> name, as a string.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Common/DataTableMappingCollection.xml b/mcs/class/System.Data/Documentation/en/System.Data.Common/DataTableMappingCollection.xml
index 05d6894971b..f9e84c305ba 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Common/DataTableMappingCollection.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Common/DataTableMappingCollection.xml
@@ -60,12 +60,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an <see cref="T:System.Object" /> that is a table mapping to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the DataTableMapping object added to the collection.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A DataTableMapping object to add to the collection. </param>
       </Docs>
@@ -85,12 +88,15 @@
         <Parameter Name="dataSetTable" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataTableMapping'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Data.Common.DataTableMapping" /> object to the collection when given a source table name and a <see cref="T:System.Data.DataSet" /> table name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Data.Common.DataTableMapping" /> object that was added to the collection.</para>
+        </returns>
         <param name="sourceTable">
           <attribution license="cc4" from="Microsoft" modified="false" />The case-sensitive name of the source table to map from. </param>
         <param name="dataSetTable">
@@ -175,12 +181,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the given <see cref="T:System.Data.Common.DataTableMapping" /> object exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this collection contains the specified <see cref="T:System.Data.Common.DataTableMapping" />; otherwise false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Object" /> that is the <see cref="T:System.Data.Common.DataTableMapping" />. </param>
       </Docs>
@@ -199,12 +208,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether a <see cref="T:System.Data.Common.DataTableMapping" /> object with the specified source table name exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains a <see cref="T:System.Data.Common.DataTableMapping" /> object with this source table name; otherwise false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The case-sensitive source table name containing the <see cref="T:System.Data.Common.DataTableMapping" /> object. </param>
       </Docs>
@@ -301,12 +313,15 @@
         <Parameter Name="dataSetTable" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataTableMapping'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Data.Common.DataTableMapping" /> object with the specified <see cref="T:System.Data.DataSet" /> table name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Data.Common.DataTableMapping" /> object with the specified <see cref="T:System.Data.DataSet" /> table name.</para>
+        </returns>
         <param name="dataSetTable">
           <attribution license="cc4" from="Microsoft" modified="false" />The name, which is not case-sensitive, of the <see cref="T:System.Data.DataSet" /> table to find. </param>
       </Docs>
@@ -323,12 +338,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IEnumerator'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an enumerator that can iterate through the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -348,7 +366,6 @@
         <Parameter Name="mappingAction" Type="System.Data.MissingMappingAction" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataTableMapping'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="T:System.Data.Common.DataTableMapping" /> exists in the collection, it is returned.</para>
@@ -394,6 +411,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Data.Common.DataColumnMapping" /> object with the specified source table name and <see cref="T:System.Data.DataSet" /> table name, using the given <see cref="T:System.Data.MissingMappingAction" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.Common.DataTableMapping" /> object.</para>
+        </returns>
         <param name="tableMappings">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.Common.DataTableMappingCollection" /> collection to search. </param>
         <param name="sourceTable">
@@ -423,12 +444,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the location of the specified <see cref="T:System.Data.Common.DataTableMapping" /> object within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based location of the specified <see cref="T:System.Data.Common.DataTableMapping" /> object within the collection.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Object" /> that is the <see cref="T:System.Data.Common.DataTableMapping" /> object to find. </param>
       </Docs>
@@ -447,12 +471,15 @@
         <Parameter Name="sourceTable" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the location of the <see cref="T:System.Data.Common.DataTableMapping" /> object with the specified source table name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based location of the <see cref="T:System.Data.Common.DataTableMapping" /> object with the specified source table name.</para>
+        </returns>
         <param name="sourceTable">
           <attribution license="cc4" from="Microsoft" modified="false" />The case-sensitive name of the source table. </param>
       </Docs>
@@ -471,12 +498,15 @@
         <Parameter Name="dataSetTable" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the location of the <see cref="T:System.Data.Common.DataTableMapping" /> object with the specified <see cref="T:System.Data.DataSet" /> table name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based location of the <see cref="T:System.Data.Common.DataTableMapping" /> object with the given <see cref="T:System.Data.DataSet" /> table name, or -1 if the <see cref="T:System.Data.Common.DataTableMapping" /> object does not exist in the collection.</para>
+        </returns>
         <param name="dataSetTable">
           <attribution license="cc4" from="Microsoft" modified="false" />The name, which is not case-sensitive, of the DataSet table to find. </param>
       </Docs>
@@ -526,6 +556,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts a <see cref="T:System.Data.Common.DataTableMapping" /> object into the <see cref="T:System.Data.Common.DataTableMappingCollection" /> at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.Common.DataTableMapping" /> object.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the <see cref="T:System.Data.Common.DataTableMapping" /> object to insert. </param>
         <param name="value">
@@ -810,7 +844,6 @@
         <Parameter Name="dataSetTableName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Common.DataTableMappingCollection" /> instance is cast to an <see cref="T:System.Data.ITableMappingCollection" /> interface. </para>
@@ -820,6 +853,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a table mapping to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to the newly-mapped <see cref="T:System.Data.ITableMapping" /> object.</para>
+        </returns>
         <param name="sourceTableName">
           <attribution license="cc4" from="Microsoft" modified="false" />The case-sensitive name of the source table.</param>
         <param name="dataSetTableName">
@@ -840,7 +877,6 @@
         <Parameter Name="dataSetTableName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Common.DataTableMappingCollection" /> instance is cast to an <see cref="T:System.Data.ITableMappingCollection" /> interface.</para>
@@ -850,6 +886,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the TableMapping object with the specified <see cref="T:System.Data.DataSet" /> table name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The TableMapping object with the specified DataSet table name.</para>
+        </returns>
         <param name="dataSetTableName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the DataSet table within the collection.</param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Common/DbCommand.xml b/mcs/class/System.Data/Documentation/en/System.Data.Common/DbCommand.xml
index 369e9fea581..969b66d63a9 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Common/DbCommand.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Common/DbCommand.xml
@@ -181,13 +181,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of a <see cref="T:System.Data.Common.DbParameter" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.Common.DbParameter" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -201,13 +204,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of a <see cref="T:System.Data.Common.DbParameter" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.Common.DbParameter" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -313,13 +319,16 @@
         <Parameter Name="behavior" Type="System.Data.CommandBehavior" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the command text against the connection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task representing the operation.</para>
+        </returns>
         <param name="behavior">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of <see cref="T:System.Data.CommandBehavior" />.</param>
       </Docs>
@@ -335,7 +344,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -347,6 +355,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a SQL statement against a connection object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows affected.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -360,13 +372,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the <see cref="P:System.Data.Common.DbCommand.CommandText" /> against the <see cref="P:System.Data.Common.DbCommand.Connection" />, and returns an <see cref="T:System.Data.Common.DbDataReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.Common.DbDataReader" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -382,13 +397,16 @@
         <Parameter Name="behavior" Type="System.Data.CommandBehavior" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the <see cref="P:System.Data.Common.DbCommand.CommandText" /> against the <see cref="P:System.Data.Common.DbCommand.Connection" />, and returns an <see cref="T:System.Data.Common.DbDataReader" /> using one of the <see cref="T:System.Data.CommandBehavior" /> values. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Data.Common.DbDataReader" /> object.</para>
+        </returns>
         <param name="behavior">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Data.CommandBehavior" /> values.</param>
       </Docs>
@@ -404,7 +422,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -415,6 +432,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the query and returns the first column of the first row in the result set returned by the query. All other columns and rows are ignored.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first column of the first row in the result set.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -501,7 +522,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Common.DbCommand" /> instance is cast to an <see cref="T:System.Data.IDbCommand" /> interface.</para>
@@ -511,6 +531,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of an <see cref="T:System.Data.IDbDataParameter" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An IDbDataParameter object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Data.IDbCommand.ExecuteReader">
@@ -524,7 +548,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Common.DbCommand" /> instance is cast to an <see cref="T:System.Data.IDbCommand" /> interface.</para>
@@ -534,6 +557,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the <see cref="P:System.Data.IDbCommand.CommandText" /> against the <see cref="P:System.Data.IDbCommand.Connection" /> and builds an <see cref="T:System.Data.IDataReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Data.IDataReader" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Data.IDbCommand.ExecuteReader">
@@ -549,7 +576,6 @@
         <Parameter Name="behavior" Type="System.Data.CommandBehavior" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Common.DbCommand" /> instance is cast to an <see cref="T:System.Data.IDbCommand" /> interface.</para>
@@ -559,6 +585,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the <see cref="P:System.Data.IDbCommand.CommandText" /> against the <see cref="P:System.Data.IDbCommand.Connection" />, and builds an <see cref="T:System.Data.IDataReader" /> using one of the <see cref="T:System.Data.CommandBehavior" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Data.IDataReader" /> object.</para>
+        </returns>
         <param name="behavior">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Data.CommandBehavior" /> values.</param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Common/DbCommandBuilder.xml b/mcs/class/System.Data/Documentation/en/System.Data.Common/DbCommandBuilder.xml
index 958f14ba247..482188cdc7e 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Common/DbCommandBuilder.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Common/DbCommandBuilder.xml
@@ -216,7 +216,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -228,6 +227,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the automatically generated <see cref="T:System.Data.Common.DbCommand" /> object required to perform deletions at the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The automatically generated <see cref="T:System.Data.Common.DbCommand" /> object required to perform deletions.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -244,7 +247,6 @@
       </Parameters>
       <Docs>
         <param name="option">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -268,6 +270,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the automatically generated <see cref="T:System.Data.Common.DbCommand" /> object required to perform deletions at the data source, optionally using columns for parameter names.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The automatically generated <see cref="T:System.Data.Common.DbCommand" /> object required to perform deletions.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -281,7 +287,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -293,6 +298,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the automatically generated <see cref="T:System.Data.Common.DbCommand" /> object required to perform insertions at the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The automatically generated <see cref="T:System.Data.Common.DbCommand" /> object required to perform insertions.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -309,7 +318,6 @@
       </Parameters>
       <Docs>
         <param name="option">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -333,6 +341,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the automatically generated <see cref="T:System.Data.Common.DbCommand" /> object required to perform insertions at the data source, optionally using columns for parameter names.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The automatically generated <see cref="T:System.Data.Common.DbCommand" /> object required to perform insertions.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -348,13 +360,16 @@
         <Parameter Name="parameterOrdinal" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the specified parameter in the format of @p#. Use when building a custom command builder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the parameter with the specified number appended as part of the parameter name.</para>
+        </returns>
         <param name="parameterOrdinal">
           <attribution license="cc4" from="Microsoft" modified="false" />The number to be included as part of the parameter's name..</param>
       </Docs>
@@ -372,13 +387,16 @@
         <Parameter Name="parameterName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the full parameter name, given the partial parameter name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The full parameter name corresponding to the partial parameter name requested.</para>
+        </returns>
         <param name="parameterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The partial name of the parameter.</param>
       </Docs>
@@ -396,7 +414,6 @@
         <Parameter Name="parameterOrdinal" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -406,6 +423,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the placeholder for the parameter in the associated SQL statement.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the parameter with the specified number appended.</para>
+        </returns>
         <param name="parameterOrdinal">
           <attribution license="cc4" from="Microsoft" modified="false" />The number to be included as part of the parameter's name.</param>
       </Docs>
@@ -424,7 +445,6 @@
       </Parameters>
       <Docs>
         <param name="cmd">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -434,6 +454,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the schema table for the <see cref="T:System.Data.Common.DbCommandBuilder" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataTable" /> that represents the schema for the specific <see cref="T:System.Data.Common.DbCommand" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -447,7 +471,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -459,6 +482,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the automatically generated <see cref="T:System.Data.Common.DbCommand" /> object required to perform updates at the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The automatically generated <see cref="T:System.Data.Common.DbCommand" /> object required to perform updates.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -475,7 +502,6 @@
       </Parameters>
       <Docs>
         <param name="option">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -499,6 +525,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the automatically generated <see cref="T:System.Data.Common.DbCommand" /> object required to perform updates at the data source, optionally using columns for parameter names.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The automatically generated <see cref="T:System.Data.Common.DbCommand" /> object required to perform updates.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -514,7 +544,6 @@
         <Parameter Name="command" Type="System.Data.Common.DbCommand" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -524,6 +553,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resets the <see cref="P:System.Data.Common.DbCommand.CommandTimeout" />, <see cref="P:System.Data.Common.DbCommand.Transaction" />, <see cref="P:System.Data.Common.DbCommand.CommandType" />, and <see cref="T:System.Data.UpdateRowSource" /> properties on the <see cref="T:System.Data.Common.DbCommand" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.Common.DbCommand" /> instance to use for each insert, update, or delete operation. Passing a null value allows the <see cref="M:System.Data.Common.DbCommandBuilder.InitializeCommand(System.Data.Common.DbCommand)" /> method to create a <see cref="T:System.Data.Common.DbCommand" /> object based on the Select command associated with the <see cref="T:System.Data.Common.DbCommandBuilder" />.</para>
+        </returns>
         <param name="command">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.Common.DbCommand" /> to be used by the command builder for the corresponding insert, update, or delete command.</param>
       </Docs>
@@ -541,13 +574,16 @@
         <Parameter Name="unquotedIdentifier" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Given an unquoted identifier in the correct catalog case, returns the correct quoted form of that identifier, including properly escaping any embedded quotes in the identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The quoted version of the identifier. Embedded quotes within the identifier are properly escaped.</para>
+        </returns>
         <param name="unquotedIdentifier">
           <attribution license="cc4" from="Microsoft" modified="false" />The original unquoted identifier.</param>
       </Docs>
@@ -755,13 +791,16 @@
         <Parameter Name="quotedIdentifier" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Given a quoted identifier, returns the correct unquoted form of that identifier, including properly un-escaping any embedded quotes in the identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The unquoted identifier, with embedded quotes properly un-escaped.</para>
+        </returns>
         <param name="quotedIdentifier">
           <attribution license="cc4" from="Microsoft" modified="false" />The identifier that will have its embedded quotes removed.</param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Common/DbConnection.xml b/mcs/class/System.Data/Documentation/en/System.Data.Common/DbConnection.xml
index 604aa3c6e4f..0a0a52c0a31 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Common/DbConnection.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Common/DbConnection.xml
@@ -48,7 +48,6 @@
         <Parameter Name="isolationLevel" Type="System.Data.IsolationLevel" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -58,6 +57,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Starts a database transaction.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the new transaction.</para>
+        </returns>
         <param name="isolationLevel">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies the isolation level for the transaction.</param>
       </Docs>
@@ -73,7 +76,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -83,6 +85,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Starts a database transaction.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the new transaction.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -98,13 +104,16 @@
         <Parameter Name="isolationLevel" Type="System.Data.IsolationLevel" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Starts a database transaction with the specified isolation level.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the new transaction.</para>
+        </returns>
         <param name="isolationLevel">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies the isolation level for the transaction.</param>
       </Docs>
@@ -225,13 +234,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a <see cref="T:System.Data.Common.DbCommand" /> object associated with the current connection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.Common.DbCommand" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -245,7 +257,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -255,6 +266,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a <see cref="T:System.Data.Common.DbCommand" /> object associated with the current connection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.Common.DbCommand" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -338,7 +353,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -348,6 +362,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns schema information for the data source of this <see cref="T:System.Data.Common.DbConnection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataTable" /> that contains schema information.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -363,7 +381,6 @@
         <Parameter Name="collectionName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -373,6 +390,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns schema information for the data source of this <see cref="T:System.Data.Common.DbConnection" /> using the specified string for the schema name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataTable" /> that contains schema information.</para>
+        </returns>
         <param name="collectionName">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies the name of the schema to return. </param>
       </Docs>
@@ -391,7 +412,6 @@
         <Parameter Name="restrictionValues" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -403,6 +423,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns schema information for the data source of this <see cref="T:System.Data.Common.DbConnection" /> using the specified string for the schema name and the specified string array for the restriction values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataTable" /> that contains schema information.</para>
+        </returns>
         <param name="collectionName">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies the name of the schema to return.</param>
         <param name="restrictionValues">
@@ -539,7 +563,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Common.DbConnection" /> instance is cast to an <see cref="T:System.Data.IDbConnection" /> interface.</para>
@@ -549,6 +572,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins a database transaction.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the new transaction.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Data.IDbConnection.BeginTransaction">
@@ -565,7 +592,6 @@
       </Parameters>
       <Docs>
         <param name="il">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information, see <see cref="M:System.Data.IDbConnection.BeginTransaction(System.Data.IsolationLevel)" />.</para>
@@ -574,6 +600,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins a database transaction with the specified <see cref="T:System.Data.IsolationLevel" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the new transaction.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Data.IDbConnection.CreateCommand">
@@ -587,7 +617,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information, see <format type="text/html"><a href="b623f810-d871-49a5-b0f5-078cc3c34db6">Commands (ADO.NET)</a></format> and <see cref="M:System.Data.IDbConnection.CreateCommand" />.</para>
@@ -596,6 +625,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a <see cref="T:System.Data.Common.DbCommand" /> object that is associated with the current connection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.Common.DbCommand" /> object that is associated with the connection.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Common/DbConnectionStringBuilder.xml b/mcs/class/System.Data/Documentation/en/System.Data.Common/DbConnectionStringBuilder.xml
index 836c620ec77..98b3dd1c408 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Common/DbConnectionStringBuilder.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Common/DbConnectionStringBuilder.xml
@@ -304,13 +304,16 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
         <Parameter Name="keyword" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Data.Common.DbConnectionStringBuilder" /> contains a specific key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Data.Common.DbConnectionStringBuilder" /> contains an entry with the specified key; otherwise false.</para>
+        </returns>
         <param name="keyword">
           <attribution license="cc4" from="Microsoft" modified="false" />The key to locate in the <see cref="T:System.Data.Common.DbConnectionStringBuilder" />.</param>
       </Docs>
@@ -352,7 +355,6 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
         <Parameter Name="connectionStringBuilder" Type="System.Data.Common.DbConnectionStringBuilder" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -363,6 +365,10 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the connection information in this <see cref="T:System.Data.Common.DbConnectionStringBuilder" /> object with the connection information in the supplied object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the connection information in both of the <see cref="T:System.Data.Common.DbConnectionStringBuilder" /> objects causes an equivalent connection string; otherwise false.</para>
+        </returns>
         <param name="connectionStringBuilder">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.Common.DbConnectionStringBuilder" /> to be compared with this <see cref="T:System.Data.Common.DbConnectionStringBuilder" /> object.</param>
       </Docs>
@@ -512,7 +518,6 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
         <Parameter Name="keyword" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -522,6 +527,10 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the entry with the specified key from the <see cref="T:System.Data.Common.DbConnectionStringBuilder" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key existed within the connection string and was removed; false if the key did not exist.</para>
+        </returns>
         <param name="keyword">
           <attribution license="cc4" from="Microsoft" modified="false" />The key of the key/value pair to be removed from the connection string in this <see cref="T:System.Data.Common.DbConnectionStringBuilder" />.</param>
       </Docs>
@@ -539,7 +548,6 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
         <Parameter Name="keyword" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -549,6 +557,10 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified key exists in this <see cref="T:System.Data.Common.DbConnectionStringBuilder" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Data.Common.DbConnectionStringBuilder" /> contains an entry with the specified key; otherwise false.</para>
+        </returns>
         <param name="keyword">
           <attribution license="cc4" from="Microsoft" modified="false" />The key to locate in the <see cref="T:System.Data.Common.DbConnectionStringBuilder" />.</param>
       </Docs>
@@ -671,7 +683,6 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
         <Parameter Name="keyword" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Common.DbConnectionStringBuilder" /> instance is cast to an <see cref="T:System.Collections.IDictionary" /> interface.</para>
@@ -681,6 +692,10 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Collections.IDictionary" /> object contains an element with the specified key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Collections.IDictionary" /> contains an element with the key; otherwise, false.</para>
+        </returns>
         <param name="keyword">
           <attribution license="cc4" from="Microsoft" modified="false" />The key to locate in the <see cref="T:System.Collections.IDictionary" /> object.</param>
       </Docs>
@@ -696,7 +711,6 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Common.DbConnectionStringBuilder" /> instance is cast to an <see cref="T:System.Collections.IDictionary" /> interface.</para>
@@ -706,6 +720,10 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IDictionaryEnumerator" /> object for the <see cref="T:System.Collections.IDictionary" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IDictionaryEnumerator" /> object for the <see cref="T:System.Collections.IDictionary" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IDictionary.Item">
@@ -764,7 +782,6 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Common.DbConnectionStringBuilder" /> instance is cast to an <see cref="T:System.Collections.IEnumerable" /> interface.</para>
@@ -774,6 +791,10 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through a collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> object that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetAttributes">
@@ -787,7 +808,6 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Common.DbConnectionStringBuilder" /> instance is cast to an <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -797,6 +817,10 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of custom attributes for this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.AttributeCollection" /> containing the attributes for this object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetClassName">
@@ -810,7 +834,6 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Common.DbConnectionStringBuilder" /> instance is cast to an <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -820,6 +843,10 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the class name of this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The class name of the object, or null if the class does not have a name.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetComponentName">
@@ -833,7 +860,6 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Common.DbConnectionStringBuilder" /> instance is cast to an <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -843,6 +869,10 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the object, or null if the object does not have a name.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetConverter">
@@ -856,7 +886,6 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Common.DbConnectionStringBuilder" /> instance is cast to an <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -866,6 +895,10 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a type converter for this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter" /> that is the converter for this object, or null if there is no <see cref="T:System.ComponentModel.TypeConverter" /> for this object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetDefaultEvent">
@@ -879,7 +912,6 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Common.DbConnectionStringBuilder" /> instance is cast to an <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -889,6 +921,10 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the default event for this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptor" /> that represents the default event for this object, or null if this object does not have events.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetDefaultProperty">
@@ -902,7 +938,6 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Common.DbConnectionStringBuilder" /> instance is cast to an <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -912,6 +947,10 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the default property for this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptor" /> that represents the default property for this object, or null if this object does not have properties.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetEditor">
@@ -927,7 +966,6 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
         <Parameter Name="editorBaseType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Common.DbConnectionStringBuilder" /> instance is cast to an <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -937,6 +975,10 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an editor of the specified type for this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> of the specified type that is the editor for this object, or null if the editor cannot be found.</para>
+        </returns>
         <param name="editorBaseType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents the editor for this object.</param>
       </Docs>
@@ -952,7 +994,6 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Common.DbConnectionStringBuilder" /> instance is cast to an <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -962,6 +1003,10 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the events for this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptorCollection" /> that represents the events for this component instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetEvents">
@@ -977,7 +1022,6 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Common.DbConnectionStringBuilder" /> instance is cast to an <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -987,6 +1031,10 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the events for this instance of a component using the specified attribute array as a filter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptorCollection" /> that represents the filtered events for this component instance.</para>
+        </returns>
         <param name="attributes">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Attribute" /> that is used as a filter.</param>
       </Docs>
@@ -1002,7 +1050,6 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Common.DbConnectionStringBuilder" /> instance is cast to an <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -1012,6 +1059,10 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the properties for this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that represents the properties for this component instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetProperties">
@@ -1027,7 +1078,6 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Common.DbConnectionStringBuilder" /> instance is cast to an <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -1037,6 +1087,10 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the properties for this instance of a component using the attribute array as a filter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that represents the filtered properties for this component instance.</para>
+        </returns>
         <param name="attributes">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Attribute" /> that is used as a filter.</param>
       </Docs>
@@ -1054,7 +1108,6 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
         <Parameter Name="pd" Type="System.ComponentModel.PropertyDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Common.DbConnectionStringBuilder" /> instance is cast to an <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -1064,6 +1117,10 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that contains the property described by the specified property descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the owner of the specified property.</para>
+        </returns>
         <param name="pd">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.PropertyDescriptor" /> that represents the property whose owner is to be found.</param>
       </Docs>
@@ -1076,13 +1133,16 @@ initial catalog="AdventureWorks;NewValue=Bad"</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the connection string associated with this <see cref="T:System.Data.Common.DbConnectionStringBuilder" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current <see cref="P:System.Data.Common.DbConnectionStringBuilder.ConnectionString" /> property.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Common/DbDataAdapter.xml b/mcs/class/System.Data/Documentation/en/System.Data.Common/DbDataAdapter.xml
index c88d9d9ed03..dd658a3744f 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Common/DbDataAdapter.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Common/DbDataAdapter.xml
@@ -156,7 +156,6 @@
         <Parameter Name="command" Type="System.Data.IDbCommand" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In <see cref="T:System.Data.Common.DbDataAdapter" />, this method throws <see cref="T:System.NotSupportedException" />. Classes that inherit from <see cref="T:System.Data.Common.DbDataAdapter" /> override this method to provide support for batches.</para>
@@ -165,6 +164,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Data.IDbCommand" /> to the current batch.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of commands in the batch before adding the <see cref="T:System.Data.IDbCommand" />.</para>
+        </returns>
         <param name="command">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.IDbCommand" /> to add to the batch.</param>
       </Docs>
@@ -203,12 +206,15 @@
         <Parameter Name="tableMapping" Type="System.Data.Common.DataTableMapping" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'RowUpdatedEventArgs'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of the <see cref="T:System.Data.Common.RowUpdatedEventArgs" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the <see cref="T:System.Data.Common.RowUpdatedEventArgs" /> class.</para>
+        </returns>
         <param name="dataRow">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.DataRow" /> used to update the data source. </param>
         <param name="command">
@@ -236,12 +242,15 @@
         <Parameter Name="tableMapping" Type="System.Data.Common.DataTableMapping" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'RowUpdatingEventArgs'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of the <see cref="T:System.Data.Common.RowUpdatingEventArgs" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the <see cref="T:System.Data.Common.RowUpdatingEventArgs" /> class.</para>
+        </returns>
         <param name="dataRow">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.DataRow" /> that updates the data source. </param>
         <param name="command">
@@ -343,7 +352,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In <see cref="T:System.Data.Common.DbDataAdapter" />, this method throws <see cref="T:System.NotSupportedException" />. Classes that inherit from <see cref="T:System.Data.Common.DbDataAdapter" /> override this method to provide support for batches.</para>
@@ -352,6 +360,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the current batch.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value from the last command in the batch.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Fill">
@@ -364,7 +376,6 @@
         <Parameter Name="dataSet" Type="System.Data.DataSet" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.Common.DbDataAdapter.Fill(System.Data.DataSet)" /> method retrieves the data from the data source using a SELECT statement. The <see cref="T:System.Data.IDbConnection" /> object associated with the select command must be valid, but it does not need to be open. If the <see cref="T:System.Data.IDbConnection" /> is closed before <see cref="M:System.Data.Common.DbDataAdapter.Fill(System.Data.DataSet)" /> is called, it is opened to retrieve data and then closed. If the connection is open before <see cref="M:System.Data.Common.DbDataAdapter.Fill(System.Data.DataSet)" /> is called, it remains open.</para>
@@ -392,6 +403,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds or refreshes rows in the <see cref="T:System.Data.DataSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows successfully added to or refreshed in the <see cref="T:System.Data.DataSet" />. This does not include rows affected by statements that do not return rows.</para>
+        </returns>
         <param name="dataSet">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.DataSet" /> to fill with records and, if necessary, schema. </param>
       </Docs>
@@ -410,7 +425,6 @@
         <Parameter Name="dataTable" Type="System.Data.DataTable" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.Common.DbDataAdapter.Fill(System.Data.DataSet)" /> method retrieves rows from the data source using the SELECT statement specified by an associated <see cref="P:System.Data.IDbDataAdapter.SelectCommand" /> property. The connection object associated with the SELECT statement must be valid, but it does not need to be open. If the connection is closed before <see cref="M:System.Data.Common.DbDataAdapter.Fill(System.Data.DataSet)" /> is called, it is opened to retrieve data, then closed. If the connection is open before <see cref="M:System.Data.Common.DbDataAdapter.Fill(System.Data.DataSet)" /> is called, it remains open.</para>
@@ -437,6 +451,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds or refreshes rows in a specified range in the <see cref="T:System.Data.DataSet" /> to match those in the data source using the <see cref="T:System.Data.DataTable" /> name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows successfully added to or refreshed in the <see cref="T:System.Data.DataSet" />. This does not include rows affected by statements that do not return rows.</para>
+        </returns>
         <param name="dataTable">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Data.DataTable" /> to use for table mapping. </param>
       </Docs>
@@ -456,7 +474,6 @@
         <Parameter Name="srcTable" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.Common.DbDataAdapter.Fill(System.Data.DataSet)" /> method retrieves the data from the data source using a SELECT statement. The <see cref="T:System.Data.IDbConnection" /> object associated with the select command must be valid, but it does not need to be open. If the <see cref="T:System.Data.IDbConnection" /> is closed before <see cref="M:System.Data.Common.DbDataAdapter.Fill(System.Data.DataSet)" /> is called, it is opened to retrieve data, then closed. If the connection is open before <see cref="M:System.Data.Common.DbDataAdapter.Fill(System.Data.DataSet)" /> is called, it remains open.</para>
@@ -498,6 +515,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds or refreshes rows in the <see cref="T:System.Data.DataSet" /> to match those in the data source using the <see cref="T:System.Data.DataSet" /> and <see cref="T:System.Data.DataTable" /> names.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows successfully added to or refreshed in the <see cref="T:System.Data.DataSet" />. This does not include rows affected by statements that do not return rows.</para>
+        </returns>
         <param name="dataSet">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.DataSet" /> to fill with records and, if necessary, schema. </param>
         <param name="srcTable">
@@ -541,7 +562,6 @@
         <Parameter Name="behavior" Type="System.Data.CommandBehavior" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.Common.DbDataAdapter.Fill(System.Data.DataSet)" /> method retrieves rows from the data source using the SELECT statement specified by an associated <see cref="P:System.Data.IDbDataAdapter.SelectCommand" /> property. The connection object associated with the SELECT statement must be valid, but it does not need to be open. If the connection is closed before <see cref="M:System.Data.Common.DbDataAdapter.Fill(System.Data.DataSet)" /> is called, it is opened to retrieve data and then closed. If the connection is open before <see cref="M:System.Data.Common.DbDataAdapter.Fill(System.Data.DataSet)" /> is called, it remains open.</para>
@@ -558,6 +578,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds or refreshes rows in a <see cref="T:System.Data.DataTable" /> to match those in the data source using the specified <see cref="T:System.Data.DataTable" />, <see cref="T:System.Data.IDbCommand" /> and <see cref="T:System.Data.CommandBehavior" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows successfully added to or refreshed in the <see cref="T:System.Data.DataTable" />. This does not include rows affected by statements that do not return rows.</para>
+        </returns>
         <param name="dataTable">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.DataTable" /> to fill with records and, if necessary, schema. </param>
         <param name="command">
@@ -591,7 +615,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.Common.DataAdapter.Fill(System.Data.DataSet)" /> method retrieves rows from the data source using the SELECT statement specified by an associated <see cref="P:System.Data.IDbDataAdapter.SelectCommand" /> property. The connection object associated with the SELECT statement must be valid, but it does not need to be open. If the connection is closed before <see cref="M:System.Data.Common.DataAdapter.Fill(System.Data.DataSet)" /> is called, it is opened to retrieve data, and then it is closed. If the connection is open before <see cref="M:System.Data.Common.DataAdapter.Fill(System.Data.DataSet)" /> is called, it remains open.</para>
@@ -608,6 +631,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds or refreshes rows in a <see cref="T:System.Data.DataTable" /> to match those in the data source starting at the specified record and retrieving up to the specified maximum number of records.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows successfully added to or refreshed in the <see cref="T:System.Data.DataTable" />. This value does not include rows affected by statements that do not return rows.</para>
+        </returns>
         <param name="startRecord">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based record number to start with. </param>
         <param name="maxRecords">
@@ -629,7 +656,6 @@
         <Parameter Name="srcTable" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A <paramref name="maxRecords" /> value of 0 gets all records found after the start record. If <paramref name="maxRecords" /> is greater than the number of remaining rows, only the remaining rows are returned, and no error is issued.</para>
@@ -680,6 +706,10 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds or refreshes rows in a specified range in the <see cref="T:System.Data.DataSet" /> to match those in the data source using the <see cref="T:System.Data.DataSet" /> and <see cref="T:System.Data.DataTable" /> names.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows successfully added to or refreshed in the <see cref="T:System.Data.DataSet" />. This does not include rows affected by statements that do not return rows.</para>
+        </returns>
         <param name="dataSet">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.DataSet" /> to fill with records and, if necessary, schema. </param>
         <param name="startRecord">
@@ -738,7 +768,6 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
         <Parameter Name="behavior" Type="System.Data.CommandBehavior" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A <paramref name="maxRecords" /> value of 0 gets all records found after the start record. If <paramref name="maxRecords" /> is greater than the number of remaining rows, only the remaining rows are returned and no error is issued.</para>
@@ -774,6 +803,10 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds or refreshes rows in a specified range in the <see cref="T:System.Data.DataSet" /> to match those in the data source using the <see cref="T:System.Data.DataSet" /> and <see cref="T:System.Data.DataTable" /> names.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows added to or refreshed in the data tables.</para>
+        </returns>
         <param name="dataTables">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.DataTable" /> objects to fill from the data source.</param>
         <param name="startRecord">
@@ -801,7 +834,6 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
         <Parameter Name="behavior" Type="System.Data.CommandBehavior" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.Common.DbDataAdapter.Fill(System.Data.DataSet)" /> method retrieves rows from the data source using the SELECT statement specified by an associated <see cref="P:System.Data.IDbDataAdapter.SelectCommand" /> property. The connection object associated with the SELECT statement must be valid, but it does not need to be open. If the connection is closed before <see cref="M:System.Data.Common.DbDataAdapter.Fill(System.Data.DataSet)" /> is called, it is opened to retrieve data, then closed. If the connection is open before <see cref="M:System.Data.Common.DbDataAdapter.Fill(System.Data.DataSet)" /> is called, it remains open.</para>
@@ -827,6 +859,10 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds or refreshes rows in a specified range in the <see cref="T:System.Data.DataSet" /> to match those in the data source using the <see cref="T:System.Data.DataSet" /> and source table names, command string, and command behavior.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows successfully added to or refreshed in the <see cref="T:System.Data.DataSet" />. This does not include rows affected by statements that do not return rows.</para>
+        </returns>
         <param name="dataSet">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.DataSet" /> to fill with records and, if necessary, schema. </param>
         <param name="startRecord">
@@ -894,7 +930,6 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
         <Parameter Name="schemaType" Type="System.Data.SchemaType" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Data.DataTable []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method retrieves the schema information from the data source using the <see cref="P:System.Data.IDbDataAdapter.SelectCommand" />.</para>
@@ -948,6 +983,10 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Data.DataTable" /> named "Table" to the specified <see cref="T:System.Data.DataSet" /> and configures the schema to match that in the data source based on the specified <see cref="T:System.Data.SchemaType" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to a collection of <see cref="T:System.Data.DataTable" /> objects that were added to the <see cref="T:System.Data.DataSet" />.</para>
+        </returns>
         <param name="dataSet">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.DataSet" /> to insert the schema in. </param>
         <param name="schemaType">
@@ -969,7 +1008,6 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
         <Parameter Name="schemaType" Type="System.Data.SchemaType" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Data.DataTable'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.Common.DbDataAdapter.FillSchema(System.Data.DataTable,System.Data.SchemaType)" /> method retrieves the schema from the data source using the <see cref="P:System.Data.IDbDataAdapter.SelectCommand" />. The connection object associated with the <see cref="P:System.Data.IDbDataAdapter.SelectCommand" /> must be valid, but it does not need to be open. If the connection is closed before <see cref="M:System.Data.Common.DbDataAdapter.FillSchema(System.Data.DataTable,System.Data.SchemaType)" /> is called, it is opened to retrieve data, then closed. If the connection is open before <see cref="M:System.Data.Common.DbDataAdapter.FillSchema(System.Data.DataTable,System.Data.SchemaType)" /> is called, it remains open.</para>
@@ -1026,6 +1064,10 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Configures the schema of the specified <see cref="T:System.Data.DataTable" /> based on the specified <see cref="T:System.Data.SchemaType" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataTable" /> that contains schema information returned from the data source.</para>
+        </returns>
         <param name="dataTable">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.DataTable" /> to be filled with the schema from the data source. </param>
         <param name="schemaType">
@@ -1048,7 +1090,6 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
         <Parameter Name="srcTable" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Data.DataTable []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method retrieves the schema information from the data source using the <see cref="P:System.Data.IDbDataAdapter.SelectCommand" />.</para>
@@ -1112,6 +1153,10 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Data.DataTable" /> to the specified <see cref="T:System.Data.DataSet" /> and configures the schema to match that in the data source based upon the specified <see cref="T:System.Data.SchemaType" /> and <see cref="T:System.Data.DataTable" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to a collection of <see cref="T:System.Data.DataTable" /> objects that were added to the <see cref="T:System.Data.DataSet" />.</para>
+        </returns>
         <param name="dataSet">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.DataSet" /> to insert the schema in. </param>
         <param name="schemaType">
@@ -1137,7 +1182,6 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
         <Parameter Name="behavior" Type="System.Data.CommandBehavior" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Data.DataTable'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.Common.DbDataAdapter.FillSchema(System.Data.DataTable,System.Data.SchemaType)" /> method retrieves the schema from the data source using the <see cref="P:System.Data.IDbDataAdapter.SelectCommand" />. The connection object associated with the <see cref="P:System.Data.IDbDataAdapter.SelectCommand" /> must be valid, but it does not need to be open. If the connection is closed before <see cref="M:System.Data.Common.DbDataAdapter.FillSchema(System.Data.DataTable,System.Data.SchemaType)" /> is called, it is opened to retrieve data, then closed. If the connection is open before <see cref="M:System.Data.Common.DbDataAdapter.FillSchema(System.Data.DataTable,System.Data.SchemaType)" /> is called, it remains open.</para>
@@ -1191,6 +1235,10 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Configures the schema of the specified <see cref="T:System.Data.DataTable" /> based on the specified <see cref="T:System.Data.SchemaType" />, command string, and <see cref="T:System.Data.CommandBehavior" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A of <see cref="T:System.Data.DataTable" /> object that contains schema information returned from the data source.</para>
+        </returns>
         <param name="dataTable">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.DataTable" /> to be filled with the schema from the data source. </param>
         <param name="schemaType">
@@ -1219,7 +1267,6 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
         <Parameter Name="behavior" Type="System.Data.CommandBehavior" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Data.DataTable []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.Common.DbDataAdapter.FillSchema(System.Data.DataTable,System.Data.SchemaType)" /> method retrieves the schema from the data source using the <see cref="P:System.Data.IDbDataAdapter.SelectCommand" />. The connection object associated with the <see cref="P:System.Data.IDbDataAdapter.SelectCommand" /> must be valid, but it does not need to be open. If the connection is closed before <see cref="M:System.Data.Common.DbDataAdapter.FillSchema(System.Data.DataTable,System.Data.SchemaType)" /> is called, it is opened to retrieve data, then closed. If the connection is open before <see cref="M:System.Data.Common.DbDataAdapter.FillSchema(System.Data.DataTable,System.Data.SchemaType)" /> is called, it remains open.</para>
@@ -1283,6 +1330,10 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Data.DataTable" /> to the specified <see cref="T:System.Data.DataSet" /> and configures the schema to match that in the data source based on the specified <see cref="T:System.Data.SchemaType" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Data.DataTable" /> objects that contain schema information returned from the data source.</para>
+        </returns>
         <param name="dataSet">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.DataSet" /> to be filled with the schema from the data source. </param>
         <param name="schemaType">
@@ -1313,7 +1364,6 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
         <Parameter Name="parameterIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In <see cref="T:System.Data.Common.DbDataAdapter" />, this method throws <see cref="T:System.NotSupportedException" />. Classes that inherit from <see cref="T:System.Data.Common.DbDataAdapter" /> override this method to provide support for batches.</para>
@@ -1322,6 +1372,10 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Data.IDataParameter" /> from one of the commands in the current batch.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Data.IDataParameter" /> specified.</para>
+        </returns>
         <param name="commandIdentifier">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the command to retrieve the parameter from.</param>
         <param name="parameterIndex">
@@ -1359,12 +1413,15 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Data.IDataParameter []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the parameters set by the user when executing an SQL SELECT statement.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Data.IDataParameter" /> objects that contains the parameters set by the user.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1627,7 +1684,6 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Common.DbDataAdapter" /> instance is cast to an <see cref="T:System.ICloneable" /> interface.</para>
@@ -1637,6 +1693,10 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new object that is a copy of the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new object that is a copy of this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TerminateBatching">
@@ -1670,7 +1730,6 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
         <Parameter Name="dataRows" Type="System.Data.DataRow[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When an application calls the <see cref="M:System.Data.Common.DbDataAdapter.Update(System.Data.DataSet)" /> method, the <see cref="T:System.Data.Common.DbDataAdapter" /> examines the <see cref="P:System.Data.DataRow.RowState" /> property, and executes the required INSERT, UPDATE, or DELETE statements iteratively for each row, based on the order of the indexes configured in the <see cref="T:System.Data.DataSet" />. For example, <see cref="M:System.Data.Common.DbDataAdapter.Update(System.Data.DataSet)" /> might execute a DELETE statement, followed by an INSERT statement, and then another DELETE statement, due to the ordering of the rows in the <see cref="T:System.Data.DataTable" />.</para>
@@ -1751,6 +1810,10 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified array in the <see cref="T:System.Data.DataSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows successfully updated from the <see cref="T:System.Data.DataSet" />.</para>
+        </returns>
         <param name="dataRows">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Data.DataRow" /> objects used to update the data source. </param>
       </Docs>
@@ -1769,7 +1832,6 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
         <Parameter Name="dataSet" Type="System.Data.DataSet" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When an application calls the <see cref="M:System.Data.Common.DbDataAdapter.Update(System.Data.DataSet)" /> method, the <see cref="T:System.Data.Common.DbDataAdapter" /> examines the <see cref="P:System.Data.DataRow.RowState" /> property, and executes the required INSERT, UPDATE, or DELETE statements iteratively for each row, based on the order of the indexes configured in the <see cref="T:System.Data.DataSet" />. For example, <see cref="M:System.Data.Common.DbDataAdapter.Update(System.Data.DataSet)" /> might execute a DELETE statement, followed by an INSERT statement, and then another DELETE statement, due to the ordering of the rows in the <see cref="T:System.Data.DataTable" />.</para>
@@ -1850,6 +1912,10 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified <see cref="T:System.Data.DataSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows successfully updated from the <see cref="T:System.Data.DataSet" />.</para>
+        </returns>
         <param name="dataSet">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.DataSet" /> used to update the data source. </param>
       </Docs>
@@ -1868,7 +1934,6 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
         <Parameter Name="dataTable" Type="System.Data.DataTable" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When an application calls the <see cref="M:System.Data.Common.DbDataAdapter.Update(System.Data.DataSet)" /> method, the <see cref="T:System.Data.Common.DbDataAdapter" /> examines the <see cref="P:System.Data.DataRow.RowState" /> property, and executes the required INSERT, UPDATE, or DELETE statements iteratively for each row, based on the order of the indexes configured in the <see cref="T:System.Data.DataSet" />. For example, <see cref="M:System.Data.Common.DbDataAdapter.Update(System.Data.DataSet)" /> might execute a DELETE statement, followed by an INSERT statement, and then another DELETE statement, due to the ordering of the rows in the <see cref="T:System.Data.DataTable" />.</para>
@@ -1949,6 +2014,10 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified <see cref="T:System.Data.DataTable" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows successfully updated from the <see cref="T:System.Data.DataTable" />.</para>
+        </returns>
         <param name="dataTable">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.DataTable" /> used to update the data source. </param>
       </Docs>
@@ -1968,7 +2037,6 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
         <Parameter Name="tableMapping" Type="System.Data.Common.DataTableMapping" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When an application calls the <see cref="M:System.Data.Common.DbDataAdapter.Update(System.Data.DataSet)" /> method, the <see cref="T:System.Data.Common.DbDataAdapter" /> examines the <see cref="P:System.Data.DataRow.RowState" /> property, and executes the required INSERT, UPDATE, or DELETE statements iteratively for each row, based on the order of the indexes configured in the <see cref="T:System.Data.DataSet" />. For example, <see cref="M:System.Data.Common.DbDataAdapter.Update(System.Data.DataSet)" /> might execute a DELETE statement, followed by an INSERT statement, and then another DELETE statement, due to the ordering of the rows in the <see cref="T:System.Data.DataTable" />.</para>
@@ -2049,6 +2117,10 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified array of <see cref="T:System.Data.DataSet" /> objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows successfully updated from the <see cref="T:System.Data.DataSet" />.</para>
+        </returns>
         <param name="dataRows">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Data.DataRow" /> objects used to update the data source. </param>
         <param name="tableMapping">
@@ -2070,7 +2142,6 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
         <Parameter Name="srcTable" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When an application calls the <see cref="M:System.Data.Common.DbDataAdapter.Update(System.Data.DataSet)" /> method, the <see cref="T:System.Data.Common.DbDataAdapter" /> examines the <see cref="P:System.Data.DataRow.RowState" /> property, and executes the required INSERT, UPDATE, or DELETE statements iteratively for each row, based on the order of the indexes configured in the <see cref="T:System.Data.DataSet" />. For example, <see cref="M:System.Data.Common.DbDataAdapter.Update(System.Data.DataSet)" /> might execute a DELETE statement, followed by an INSERT statement, and then another DELETE statement, due to the ordering of the rows in the <see cref="T:System.Data.DataTable" />.</para>
@@ -2162,6 +2233,10 @@ adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly na
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Updates the values in the database by executing the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the <see cref="T:System.Data.DataSet" />  with the specified <see cref="T:System.Data.DataTable" /> name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows successfully updated from the <see cref="T:System.Data.DataSet" />.</para>
+        </returns>
         <param name="dataSet">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.DataSet" /> to use to update the data source. </param>
         <param name="srcTable">
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Common/DbDataReader.xml b/mcs/class/System.Data/Documentation/en/System.Data.Common/DbDataReader.xml
index 0e35f898883..a220c2dc790 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Common/DbDataReader.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Common/DbDataReader.xml
@@ -172,13 +172,16 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a Boolean.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -195,13 +198,16 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a byte.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -223,13 +229,16 @@
       <Docs>
         <param name="i">To be added.</param>
         <param name="fieldOffset">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a stream of bytes from the specified column, starting at location indicated by <paramref name="dataOffset" />, into the buffer, starting at the location indicated by <paramref name="bufferOffset" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of bytes read.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer into which to copy the data.</param>
         <param name="bufferOffset">
@@ -252,13 +261,16 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a single character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -281,13 +293,16 @@
         <param name="i">To be added.</param>
         <param name="dataIndex">To be added.</param>
         <param name="bufferIndex">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a stream of characters from the specified column, starting at location indicated by <paramref name="dataOffset" />, into the buffer, starting at the location indicated by <paramref name="bufferOffset" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of characters read.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer into which to copy the data.</param>
         <param name="length">
@@ -308,13 +323,16 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Data.Common.DbDataReader" /> object for the requested column ordinal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.Common.DbDataReader" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -336,7 +354,6 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -358,6 +375,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets name of the data type of the specified column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representing the name of the data type.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -374,13 +395,16 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a <see cref="T:System.DateTime" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -396,13 +420,16 @@
         <Parameter Name="ordinal" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Data.Common.DbDataReader" /> object for the requested column ordinal that can be overridden with a provider-specific implementation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.Common.DbDataReader" /> object.</para>
+        </returns>
         <param name="ordinal">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal.</param>
       </Docs>
@@ -421,13 +448,16 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a <see cref="T:System.Decimal" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -444,13 +474,16 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a double-precision floating point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -464,7 +497,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -475,6 +507,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the rows in the data reader.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the rows in the data reader.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -496,13 +532,16 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the data type of the specified column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The data type of the specified column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -519,13 +558,16 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a single-precision floating point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -542,13 +584,16 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a globally-unique identifier (GUID).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -565,13 +610,16 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a 16-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -588,7 +636,6 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -613,6 +660,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -629,13 +680,16 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -652,13 +706,16 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the name of the column, given the zero-based column ordinal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the specified column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -674,13 +731,16 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the column ordinal given the name of the column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based column ordinal.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the column.</param>
       </Docs>
@@ -699,13 +759,16 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the provider-specific field type of the specified column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> object that describes the data type of the specified column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -727,7 +790,6 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -737,6 +799,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as an instance of <see cref="T:System.Object" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -757,13 +823,16 @@
         <Parameter Name="values" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all provider-specific attribute columns in the collection for the current row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of instances of <see cref="T:System.Object" /> in the array.</para>
+        </returns>
         <param name="values">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Object" /> into which to copy the attribute columns.</param>
       </Docs>
@@ -784,13 +853,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Data.DataTable" /> that describes the column metadata of the <see cref="T:System.Data.Common.DbDataReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataTable" /> that describes the column metadata.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -807,13 +879,16 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as an instance of <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -830,13 +905,16 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as an instance of <see cref="T:System.Object" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -852,13 +930,16 @@
         <Parameter Name="values" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Populates an array of objects with the column values of the current row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of instances of <see cref="T:System.Object" /> in the array.</para>
+        </returns>
         <param name="values">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Object" /> into which to copy the attribute columns.</param>
       </Docs>
@@ -915,7 +996,6 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -925,6 +1005,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the column contains nonexistent or missing values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified column is equivalent to <see cref="T:System.DBNull" />; otherwise false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -978,7 +1062,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -988,6 +1071,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the reader to the next result when reading the results of a batch of statements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there are more result sets; otherwise false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1001,7 +1088,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1011,6 +1097,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the reader to the next record in a result set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there are more rows; otherwise false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1052,7 +1142,6 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Common.DbDataReader" /> instance is cast to an <see cref="T:System.Data.IDataRecord" /> interface.</para>
@@ -1061,6 +1150,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Data.IDataRecord.GetData(System.Int32)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Data.IDataReader" /> to be used when the field points to more remote structured data.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="VisibleFieldCount">
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Common/DbDataRecord.xml b/mcs/class/System.Data/Documentation/en/System.Data.Common/DbDataRecord.xml
index a0342efca99..7524f126c22 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Common/DbDataRecord.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Common/DbDataRecord.xml
@@ -57,7 +57,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore the data retrieved must already be a Boolean.</para>
@@ -66,6 +65,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified column as a Boolean.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the Boolean is true; otherwise false.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The column ordinal. </param>
       </Docs>
@@ -84,7 +87,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore the data retrieved must already be a byte.</para>
@@ -93,6 +95,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified column as a byte.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The column ordinal. </param>
       </Docs>
@@ -115,7 +121,6 @@
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore the data retrieved must already be a byte array.</para>
@@ -124,6 +129,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified column as a byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal.</param>
         <param name="dataIndex">
@@ -150,7 +159,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'char'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore the data retrieved must already be a character.</para>
@@ -159,6 +167,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified column as a character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The column ordinal. </param>
       </Docs>
@@ -181,7 +193,6 @@
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore the data retrieved must already be a character array.</para>
@@ -190,6 +201,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified column as a character array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />Column ordinal. </param>
         <param name="dataIndex">
@@ -216,12 +231,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Data.IDataReader'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Not currently supported.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Not currently supported.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />Not currently supported.</param>
       </Docs>
@@ -240,12 +258,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the back-end data type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the back-end data type.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The column ordinal. </param>
       </Docs>
@@ -264,7 +285,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DateTime'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore the data retrieved must already be a <see cref="T:System.DateTime" /> object.</para>
@@ -273,6 +293,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified column as a <see cref="T:System.DateTime" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The column ordinal. </param>
       </Docs>
@@ -291,7 +315,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'decimal'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore the data retrieved must already be a <see cref="T:System.Decimal" /> object.</para>
@@ -300,6 +323,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified column as a <see cref="T:System.Decimal" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The column ordinal. </param>
       </Docs>
@@ -318,7 +345,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'double'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore the data retrieved must already be a double-precision floating-point number.</para>
@@ -327,6 +353,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified column as a double-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The column ordinal. </param>
       </Docs>
@@ -345,12 +375,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Type'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Type" /> that is the data type of the object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> that is the data type of the object.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The column ordinal. </param>
       </Docs>
@@ -369,7 +402,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'float'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore the data retrieved must already be a single-precision floating-point number.</para>
@@ -378,6 +410,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified column as a single-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The column ordinal. </param>
       </Docs>
@@ -396,12 +432,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Guid'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the GUID value of the specified field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The GUID value of the specified field.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the field to return. </param>
       </Docs>
@@ -420,7 +459,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'short'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore the data retrieved must already be a 16-bit signed integer.</para>
@@ -429,6 +467,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified column as a 16-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The column ordinal. </param>
       </Docs>
@@ -447,7 +489,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore the data retrieved must already be a 32-bit signed integer.</para>
@@ -456,6 +497,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified column as a 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The column ordinal. </param>
       </Docs>
@@ -474,7 +519,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore the data retrieved must already be a 64-bit signed integer.</para>
@@ -483,6 +527,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified column as a 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The column ordinal. </param>
       </Docs>
@@ -501,12 +549,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the specified column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the specified column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The column ordinal. </param>
       </Docs>
@@ -525,12 +576,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the column ordinal, given the name of the column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The column ordinal.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the column. </param>
       </Docs>
@@ -549,7 +603,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore the data retrieved must already be a string.</para>
@@ -558,6 +611,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified column as a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The column ordinal. </param>
       </Docs>
@@ -576,12 +633,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value at the specified column in its native format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value to return.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The column ordinal. </param>
       </Docs>
@@ -600,7 +660,6 @@
         <Parameter Name="values" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Using this method may be more efficient for most applications then retrieving each field individually.</para>
@@ -609,6 +668,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Populates an array of objects with the column values of the current record.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of instances of <see cref="T:System.Object" /> in the array.</para>
+        </returns>
         <param name="values">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Object" /> to copy the attribute fields into. </param>
       </Docs>
@@ -627,7 +690,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this method to check for null column values before calling the typed get methods (for example, <see cref="M:System.Data.SqlClient.SqlDataReader.GetByte(System.Int32)" />, <see cref="M:System.Data.SqlClient.SqlDataReader.GetChar(System.Int32)" />, and so on) to avoid raising an error.</para>
@@ -636,6 +698,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used to indicate nonexistent values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified column is equivalent to <see cref="T:System.DBNull" />; otherwise false.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The column ordinal. </param>
       </Docs>
@@ -696,7 +762,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information, see <see cref="M:System.ComponentModel.ICustomTypeDescriptor.GetAttributes" />.</para>
@@ -705,6 +770,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of custom attributes for this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.AttributeCollection" /> that contains the attributes for this object. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetClassName">
@@ -719,7 +788,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information, see <see cref="M:System.ComponentModel.ICustomTypeDescriptor.GetClassName" />.</para>
@@ -728,6 +796,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the class name of this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The class name of the object, or null if the class does not have a name.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetComponentName">
@@ -742,7 +814,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information, see <see cref="M:System.ComponentModel.ICustomTypeDescriptor.GetComponentName" />.</para>
@@ -751,6 +822,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the object, or null if the object does not have a name.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetConverter">
@@ -765,7 +840,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information, see <see cref="M:System.ComponentModel.ICustomTypeDescriptor.GetConverter" />.</para>
@@ -774,6 +848,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a type converter for this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter" /> that is the converter for this object, or null if there is no <see cref="T:System.ComponentModel.TypeConverter" /> for this object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetDefaultEvent">
@@ -788,7 +866,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information, see <see cref="M:System.ComponentModel.ICustomTypeDescriptor.GetDefaultEvent" />.</para>
@@ -797,6 +874,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the default event for this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptor" /> that represents the default event for this object, or null if this object does not have events.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetDefaultProperty">
@@ -811,7 +892,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information, see <see cref="M:System.ComponentModel.ICustomTypeDescriptor.GetDefaultProperty" />.</para>
@@ -820,6 +900,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the default property for this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptor" /> that represents the default property for this object, or null if this object does not have properties.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetEditor">
@@ -836,7 +920,6 @@
         <Parameter Name="editorBaseType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information, see <see cref="M:System.ComponentModel.CustomTypeDescriptor.GetEditor(System.Type)" />.</para>
@@ -845,6 +928,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an editor of the specified type for this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> of the specified type that is the editor for this object, or null if the editor cannot be found.</para>
+        </returns>
         <param name="editorBaseType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents the editor for this object.</param>
       </Docs>
@@ -861,7 +948,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information, see <see cref="M:System.ComponentModel.ICustomTypeDescriptor.GetEvents" />.</para>
@@ -870,6 +956,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the events for this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptorCollection" /> that represents the events for this component instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetEvents">
@@ -886,7 +976,6 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information, see <see cref="M:System.ComponentModel.ICustomTypeDescriptor.GetEvents.(System.Attribute[])" />.</para>
@@ -895,6 +984,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the events for this instance of a component using the specified attribute array as a filter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptorCollection" /> that represents the filtered events for this component instance.</para>
+        </returns>
         <param name="attributes">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Attribute" /> that is used as a filter.</param>
       </Docs>
@@ -911,7 +1004,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information, see <see cref="M:System.ComponentModel.ICustomTypeDescriptor.GetProperties" />.</para>
@@ -920,6 +1012,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the properties for this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that represents the properties for this component instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetProperties">
@@ -936,7 +1032,6 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information, see <see cref="M:System.ComponentModel.ICustomTypeDescriptor.GetProperties.(System.Attribute[])" />.</para>
@@ -945,6 +1040,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the properties for this instance of a component using the attribute array as a filter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that represents the filtered properties for this component instance.</para>
+        </returns>
         <param name="attributes">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Attribute" /> that is used as a filter.</param>
       </Docs>
@@ -963,7 +1062,6 @@
         <Parameter Name="pd" Type="System.ComponentModel.PropertyDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information, see <see cref="M:System.ComponentModel.ICustomTypeDescriptor.PropertyDescriptor" />.</para>
@@ -972,6 +1070,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that contains the property described by the specified property descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the owner of the specified property.</para>
+        </returns>
         <param name="pd">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.PropertyDescriptor" /> that represents the property whose owner is to be found.</param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Common/DbDataSourceEnumerator.xml b/mcs/class/System.Data/Documentation/en/System.Data.Common/DbDataSourceEnumerator.xml
index 258d9a7e944..ddc8a7830a1 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Common/DbDataSourceEnumerator.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Common/DbDataSourceEnumerator.xml
@@ -49,7 +49,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -129,6 +128,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a <see cref="T:System.Data.DataTable" /> containing information about all visible instances of the server represented by the strongly typed instance of this class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a <see cref="T:System.Data.DataTable" /> containing information about the visible instances of the associated data source.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Common/DbEnumerator.xml b/mcs/class/System.Data/Documentation/en/System.Data.Common/DbEnumerator.xml
index 656cf1fb8b5..8c35d4c7c27 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Common/DbEnumerator.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Common/DbEnumerator.xml
@@ -104,7 +104,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>After an enumerator is created or after a call to <see cref="M:System.Data.Common.DbEnumerator.Reset" />, an enumerator is positioned before the first element of the collection, and the first call to <see cref="M:System.Data.Common.DbEnumerator.MoveNext" /> moves the enumerator over the first element of the collection. After the end of the collection is passed, subsequent calls to <see cref="M:System.Data.Common.DbEnumerator.MoveNext" /> return false until <see cref="M:System.Data.Common.DbEnumerator.Reset" /> is called. An enumerator remains valid as long as the collection remains unchanged. If changes are made to the collection, such as adding, modifying or deleting elements, the enumerator is irrecoverably invalidated and the next call to <see cref="M:System.Data.Common.DbEnumerator.MoveNext" /> or <see cref="M:System.Data.Common.DbEnumerator.Reset" /> throws an <see cref="T:System.InvalidOperationException" />.</para>
@@ -113,6 +112,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the enumerator to the next element of the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Common/DbParameterCollection.xml b/mcs/class/System.Data/Documentation/en/System.Data.Common/DbParameterCollection.xml
index 331a8819814..8cc42d7e756 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Common/DbParameterCollection.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Common/DbParameterCollection.xml
@@ -48,13 +48,16 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Data.Common.DbParameter" /> object to the <see cref="T:System.Data.Common.DbParameterCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the <see cref="T:System.Data.Common.DbParameter" /> object in the collection.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Data.Common.DbParameter.Value" /> of the <see cref="T:System.Data.Common.DbParameter" /> to add to the collection.</param>
       </Docs>
@@ -114,13 +117,16 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a <see cref="T:System.Data.Common.DbParameter" /> with the specified <see cref="P:System.Data.Common.DbParameter.Value" /> is contained in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Data.Common.DbParameter" /> is in the collection; otherwise false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Data.Common.DbParameter.Value" /> of the <see cref="T:System.Data.Common.DbParameter" /> to look for in the collection.</param>
       </Docs>
@@ -138,13 +144,16 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a <see cref="T:System.Data.Common.DbParameter" /> with the specified name exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Data.Common.DbParameter" /> is in the collection; otherwise false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Data.Common.DbParameter" /> to look for in the collection.</param>
       </Docs>
@@ -213,13 +222,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Exposes the <see cref="M:System.Collections.IEnumerable.GetEnumerator" /> method, which supports a simple iteration over a collection by a .NET Framework data provider.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -240,13 +252,16 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Data.Common.DbParameter" /> object at the specified index in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Data.Common.DbParameter" /> object at the specified index in the collection.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the <see cref="T:System.Data.Common.DbParameter" /> in the collection.</param>
       </Docs>
@@ -264,13 +279,16 @@
         <Parameter Name="parameterName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns <see cref="T:System.Data.Common.DbParameter" /> the object with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Data.Common.DbParameter" /> the object with the specified name.</para>
+        </returns>
         <param name="parameterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Data.Common.DbParameter" /> in the collection.</param>
       </Docs>
@@ -288,13 +306,16 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the specified <see cref="T:System.Data.Common.DbParameter" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified <see cref="T:System.Data.Common.DbParameter" /> object.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.Common.DbParameter" /> object in the collection.</param>
       </Docs>
@@ -312,13 +333,16 @@
         <Parameter Name="parameterName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the <see cref="T:System.Data.Common.DbParameter" /> object with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the <see cref="T:System.Data.Common.DbParameter" /> object with the specified name.</para>
+        </returns>
         <param name="parameterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Data.Common.DbParameter" /> object in the collection.</param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Common/DbProviderConfigurationHandler.xml b/mcs/class/System.Data/Documentation/en/System.Data.Common/DbProviderConfigurationHandler.xml
index 43b983511c8..aedfaf8f15f 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Common/DbProviderConfigurationHandler.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Common/DbProviderConfigurationHandler.xml
@@ -50,13 +50,16 @@
         <Parameter Name="section" Type="System.Xml.XmlNode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="System.Collections.Specialized.NameValueCollection" /> expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new expression.</para>
+        </returns>
         <param name="parent">
           <attribution license="cc4" from="Microsoft" modified="false" />This type supports the .NET Framework infrastructure and is not intended to be used directly from your code.</param>
         <param name="configContext">
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Common/DbProviderFactories.xml b/mcs/class/System.Data/Documentation/en/System.Data.Common/DbProviderFactories.xml
index e169fd0fcba..80895e41420 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Common/DbProviderFactories.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Common/DbProviderFactories.xml
@@ -28,7 +28,6 @@
         <Parameter Name="providerRow" Type="System.Data.DataRow" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -38,6 +37,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an instance of a <see cref="T:System.Data.Common.DbProviderFactory" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of a <see cref="T:System.Data.Common.DbProviderFactory" /> for a specified <see cref="T:System.Data.DataRow" />.</para>
+        </returns>
         <param name="providerRow">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.Data.DataRow" /> containing the provider's configuration information.</param>
@@ -56,7 +59,6 @@
         <Parameter Name="providerInvariantName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -66,6 +68,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an instance of a <see cref="T:System.Data.Common.DbProviderFactory" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of a <see cref="T:System.Data.Common.DbProviderFactory" /> for a specified provider name.</para>
+        </returns>
         <param name="providerInvariantName">
           <attribution license="cc4" from="Microsoft" modified="false" />Invariant name of a provider.</param>
       </Docs>
@@ -81,13 +87,75 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Data.DataTable" /> that contains information about all installed providers that implement <see cref="T:System.Data.Common.DbProviderFactory" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a <see cref="T:System.Data.DataTable" /> containing <see cref="T:System.Data.DataRow" /> objects that contain the following data. </para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Column ordinal</para>
+                </term>
+                <description>
+                  <para>Column name</para>
+                </description>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>0</para>
+              </term>
+              <description>
+                <para>Name</para>
+              </description>
+              <description>
+                <para>Human-readable name for the data provider.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>1</para>
+              </term>
+              <description>
+                <para>Description</para>
+              </description>
+              <description>
+                <para>Human-readable description of the data provider.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>2</para>
+              </term>
+              <description>
+                <para>InvariantName</para>
+              </description>
+              <description>
+                <para>Name that can be used programmatically to refer to the data provider.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>3</para>
+              </term>
+              <description>
+                <para>AssemblyQualifiedName</para>
+              </description>
+              <description>
+                <para>Fully qualified name of the factory class, which contains enough information to instantiate the object.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Common/DbProviderFactoriesConfigurationHandler.xml b/mcs/class/System.Data/Documentation/en/System.Data.Common/DbProviderFactoriesConfigurationHandler.xml
index 9c6bb8ccb08..1ba30e9ae11 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Common/DbProviderFactoriesConfigurationHandler.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Common/DbProviderFactoriesConfigurationHandler.xml
@@ -50,13 +50,16 @@
         <Parameter Name="section" Type="System.Xml.XmlNode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This type supports the .NET Framework infrastructure and is not intended to be used directly from your code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This type supports the .NET Framework infrastructure and is not intended to be used directly from your code.</para>
+        </returns>
         <param name="parent">
           <attribution license="cc4" from="Microsoft" modified="false" />This type supports the .NET Framework infrastructure and is not intended to be used directly from your code.</param>
         <param name="configContext">
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Common/DbProviderFactory.xml b/mcs/class/System.Data/Documentation/en/System.Data.Common/DbProviderFactory.xml
index 2771c6ed0ec..63af1fa7bce 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Common/DbProviderFactory.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Common/DbProviderFactory.xml
@@ -64,13 +64,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new instance of the provider's class that implements the <see cref="T:System.Data.Common.DbCommand" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.Data.Common.DbCommand" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -84,13 +87,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new instance of the provider's class that implements the <see cref="T:System.Data.Common.DbCommandBuilder" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.Data.Common.DbCommandBuilder" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -104,13 +110,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new instance of the provider's class that implements the <see cref="T:System.Data.Common.DbConnection" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.Data.Common.DbConnection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -124,13 +133,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new instance of the provider's class that implements the <see cref="T:System.Data.Common.DbConnectionStringBuilder" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.Data.Common.DbConnectionStringBuilder" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -144,13 +156,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new instance of the provider's class that implements the <see cref="T:System.Data.Common.DbDataAdapter" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.Data.Common.DbDataAdapter" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -164,13 +179,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new instance of the provider's class that implements the <see cref="T:System.Data.Common.DbDataSourceEnumerator" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.Data.Common.DbDataSourceEnumerator" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -184,13 +202,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new instance of the provider's class that implements the <see cref="T:System.Data.Common.DbParameter" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.Data.Common.DbParameter" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -206,13 +227,16 @@
         <Parameter Name="state" Type="System.Security.Permissions.PermissionState" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new instance of the provider's class that implements the provider's version of the <see cref="T:System.Security.CodeAccessPermission" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.CodeAccessPermission" /> object for the specified <see cref="T:System.Security.Permissions.PermissionState" />.</para>
+        </returns>
         <param name="state">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Security.Permissions.PermissionState" /> values.</param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcCommand.xml b/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcCommand.xml
index b8d13fc4ace..af34f115384 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcCommand.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcCommand.xml
@@ -478,7 +478,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -488,6 +487,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of an <see cref="T:System.Data.Odbc.OdbcParameter" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Data.Odbc.OdbcParameter" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -622,7 +625,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use <see cref="M:System.Data.Odbc.OdbcCommand.ExecuteNonQuery" /> to perform catalog operations (for example, querying the structure of a database or creating database objects such as tables); or to change the data in a database, without using a <see cref="T:System.Data.DataSet" />, by executing UPDATE, INSERT, or DELETE statements.</para>
@@ -635,6 +637,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes an SQL statement against the <see cref="P:System.Data.Odbc.OdbcCommand.Connection" /> and returns the number of rows affected.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>For UPDATE, INSERT, and DELETE statements, the return value is the number of rows affected by the command. For all other types of statements, the return value is -1.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -649,7 +655,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -660,6 +665,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends the <see cref="P:System.Data.Odbc.OdbcCommand.CommandText" /> to the <see cref="P:System.Data.Odbc.OdbcCommand.Connection" /> and builds an <see cref="T:System.Data.Odbc.OdbcDataReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Data.Odbc.OdbcDataReader" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -676,7 +685,6 @@
         <Parameter Name="behavior" Type="System.Data.CommandBehavior" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -692,6 +700,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends the <see cref="P:System.Data.Odbc.OdbcCommand.CommandText" /> to the <see cref="P:System.Data.Odbc.OdbcCommand.Connection" />, and builds an <see cref="T:System.Data.Odbc.OdbcDataReader" /> using one of the CommandBehavior values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Data.Odbc.OdbcDataReader" /> object.</para>
+        </returns>
         <param name="behavior">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the System.Data.CommandBehavior values. </param>
       </Docs>
@@ -708,7 +720,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Data.Odbc.OdbcCommand.ExecuteScalar" /> method to retrieve a single value (for example, an aggregate value) from a data source. This requires less code than using the <see cref="M:System.Data.Odbc.OdbcCommand.ExecuteReader" /> method, and then performing the operations required to generate the single value from the data returned by an <see cref="T:System.Data.Odbc.OdbcDataReader" />.</para>
@@ -717,6 +728,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the query, and returns the first column of the first row in the result set returned by the query. Additional columns or rows are ignored.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first column of the first row in the result set, or a null reference if the result set is empty.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -912,7 +927,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Odbc.OdbcCommand" /> instance is cast to an <see cref="T:InterfaceName" /> interface.</para>
@@ -921,6 +935,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ICloneable.Clone" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T;System.Object" /> that is a copy of this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Transaction">
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcCommandBuilder.xml b/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcCommandBuilder.xml
index f5bc981ae30..b77ccec18c3 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcCommandBuilder.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcCommandBuilder.xml
@@ -180,7 +180,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the <see cref="M:System.Data.Odbc.OdbcCommandBuilder.GetDeleteCommand" /> method for informational or troubleshooting purposes because it returns the <see cref="T:System.Data.Odbc.OdbcCommand" /> object to be executed.</para>
@@ -191,6 +190,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the automatically generated <see cref="T:System.Data.Odbc.OdbcCommand" /> object required to perform deletions at the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The automatically generated <see cref="T:System.Data.Odbc.OdbcCommand" /> object required to perform deletions.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -210,7 +213,6 @@
         <Parameter Name="useColumnsForParameterNames" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the <see cref="M:System.Data.Odbc.OdbcCommandBuilder.GetDeleteCommand" /> method for informational or troubleshooting purposes because it returns the <see cref="T:System.Data.Odbc.OdbcCommand" /> object to be executed.</para>
@@ -233,6 +235,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the automatically generated <see cref="T:System.Data.Odbc.OdbcCommand" /> object required to perform deletions at the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The automatically generated <see cref="T:System.Data.Odbc.OdbcCommand" /> object required to perform deletions.</para>
+        </returns>
         <param name="useColumnsForParameterNames">
           <attribution license="cc4" from="Microsoft" modified="false" />If true, generate parameter names matching column names, if it is possible. If false, generate @p1, @p2, and so on.</param>
       </Docs>
@@ -245,7 +251,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the <see cref="M:System.Data.Odbc.OdbcCommandBuilder.GetInsertCommand" /> method for informational or troubleshooting purposes because it returns the <see cref="T:System.Data.Odbc.OdbcCommand" /> object to be executed.</para>
@@ -256,6 +261,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the automatically generated <see cref="T:System.Data.Odbc.OdbcCommand" /> object required to perform insertions at the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The automatically generated <see cref="T:System.Data.Odbc.OdbcCommand" /> object required to perform insertions.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -275,7 +284,6 @@
         <Parameter Name="useColumnsForParameterNames" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the <see cref="M:System.Data.Odbc.OdbcCommandBuilder.GetInsertCommand" /> method for informational or troubleshooting purposes because it returns the <see cref="T:System.Data.Odbc.OdbcCommand" /> object to be executed.</para>
@@ -298,6 +306,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the automatically generated <see cref="T:System.Data.Odbc.OdbcCommand" /> object required to perform insertions at the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The automatically generated <see cref="T:System.Data.Odbc.OdbcCommand" /> object required to perform insertions.</para>
+        </returns>
         <param name="useColumnsForParameterNames">
           <attribution license="cc4" from="Microsoft" modified="false" />If true, generate parameter names matching column names, if it is possible. If false, generate @p1, @p2, and so on.</param>
       </Docs>
@@ -370,7 +382,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the <see cref="M:System.Data.Odbc.OdbcCommandBuilder.GetUpdateCommand" /> method for informational or troubleshooting purposes because it returns the <see cref="T:System.Data.Odbc.OdbcCommand" /> object to be executed.</para>
@@ -381,6 +392,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the automatically generated <see cref="T:System.Data.Odbc.OdbcCommand" /> object required to perform updates at the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The automatically generated <see cref="T:System.Data.Odbc.OdbcCommand" /> object required to perform updates.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -400,7 +415,6 @@
         <Parameter Name="useColumnsForParameterNames" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the <see cref="M:System.Data.Odbc.OdbcCommandBuilder.GetUpdateCommand" /> method for informational or troubleshooting purposes because it returns the <see cref="T:System.Data.Odbc.OdbcCommand" /> object to be executed.</para>
@@ -423,6 +437,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the automatically generated <see cref="T:System.Data.Odbc.OdbcCommand" /> object required to perform updates at the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The automatically generated <see cref="T:System.Data.Odbc.OdbcCommand" /> object required to perform updates.</para>
+        </returns>
         <param name="useColumnsForParameterNames">
           <attribution license="cc4" from="Microsoft" modified="false" />If true, generate parameter names matching column names, if it is possible. If false, generate @p1, @p2, and so on.</param>
       </Docs>
@@ -437,13 +455,16 @@
         <Parameter Name="unquotedIdentifier" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Given an unquoted identifier in the correct catalog case, returns the correct quoted form of that identifier. This includes correctly escaping any embedded quotes in the identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The quoted version of the identifier. Embedded quotes within the identifier are correctly escaped.</para>
+        </returns>
         <param name="unquotedIdentifier">
           <attribution license="cc4" from="Microsoft" modified="false" />The original unquoted identifier.</param>
       </Docs>
@@ -465,12 +486,15 @@
         <Parameter Name="connection" Type="System.Data.Odbc.OdbcConnection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Given an unquoted identifier in the correct catalog case, returns the correct quoted form of that identifier. This includes correctly escaping any embedded quotes in the identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The quoted version of the identifier. Embedded quotes within the identifier are correctly escaped.</para>
+        </returns>
         <param name="unquotedIdentifier">
           <attribution license="cc4" from="Microsoft" modified="false" />The original unquoted identifier.</param>
         <param name="connection">
@@ -567,13 +591,16 @@
         <Parameter Name="quotedIdentifier" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Given a quoted identifier, returns the correct unquoted form of that identifier, including correctly unescaping any embedded quotes in the identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The unquoted identifier, with embedded quotes correctly unescaped.</para>
+        </returns>
         <param name="quotedIdentifier">
           <attribution license="cc4" from="Microsoft" modified="false" />The identifier that will have its embedded quotes removed.</param>
       </Docs>
@@ -595,12 +622,15 @@
         <Parameter Name="connection" Type="System.Data.Odbc.OdbcConnection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Given a quoted identifier, returns the correct unquoted form of that identifier, including correctly unescaping any embedded quotes in the identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The unquoted identifier, with embedded quotes correctly unescaped.</para>
+        </returns>
         <param name="quotedIdentifier">
           <attribution license="cc4" from="Microsoft" modified="false" />The identifier that will have its embedded quotes removed.</param>
         <param name="connection">
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcConnection.xml b/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcConnection.xml
index 387ea78267b..dfa9e552f12 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcConnection.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcConnection.xml
@@ -188,7 +188,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To commit or roll back the transaction, you must explicitly use the <see cref="M:System.Data.Odbc.OdbcTransaction.Commit" /> or <see cref="M:System.Data.Odbc.OdbcTransaction.Rollback" /> methods.</para>
@@ -201,6 +200,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Starts a transaction at the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the new transaction.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -217,7 +220,6 @@
         <Parameter Name="isolevel" Type="System.Data.IsolationLevel" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To commit or roll back the transaction, you must explicitly use the <see cref="M:System.Data.Odbc.OdbcTransaction.Commit" /> or <see cref="M:System.Data.Odbc.OdbcTransaction.Rollback" /> methods.</para>
@@ -227,6 +229,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Starts a transaction at the data source with the specified <see cref="T:System.Data.IsolationLevel" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the new transaction.</para>
+        </returns>
         <param name="isolevel">
           <attribution license="cc4" from="Microsoft" modified="false" />The transaction isolation level for this connection. If you do not specify an isolation level, the default isolation level for the driver is used. </param>
       </Docs>
@@ -400,12 +406,15 @@ driver-defined-attribute-keyword ::= identifier</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an <see cref="T:System.Data.Odbc.OdbcCommand" /> object associated with the <see cref="T:System.Data.Odbc.OdbcConnection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Data.Odbc.OdbcCommand" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -602,12 +611,15 @@ driver-defined-attribute-keyword ::= identifier</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns schema information for the data source of this <see cref="T:System.Data.Odbc.OdbcConnection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataTable" /> that contains schema information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetSchema">
@@ -623,7 +635,6 @@ driver-defined-attribute-keyword ::= identifier</code>
         <Parameter Name="collectionName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When <paramref name="collectionName" /> is null, the <see cref="T:System.Data.DataTable" /> contains information about all available metadata and any restrictions.</para>
@@ -635,6 +646,10 @@ driver-defined-attribute-keyword ::= identifier</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns schema information for the data source of this <see cref="T:System.Data.Odbc.OdbcConnection" /> using the specified name for the schema name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataTable" /> that contains schema information.</para>
+        </returns>
         <param name="collectionName">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies the name of the schema to return.</param>
       </Docs>
@@ -653,7 +668,6 @@ driver-defined-attribute-keyword ::= identifier</code>
         <Parameter Name="restrictionValues" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When <paramref name="collectionName" /> is specified as null, the <see cref="T:System.Data.DataTable" /> contains information about all the metadata that is available, and its restrictions.</para>
@@ -667,6 +681,10 @@ driver-defined-attribute-keyword ::= identifier</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns schema information for the data source of this <see cref="T:System.Data.Odbc.OdbcConnection" /> using the specified string for the schema name and the specified string array for the restriction values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataTable" /> that contains schema information.</para>
+        </returns>
         <param name="collectionName">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies the name of the schema to return.</param>
         <param name="restrictionValues">
@@ -909,7 +927,6 @@ driver-defined-attribute-keyword ::= identifier</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Odbc.OdbcConnection" /> instance is cast to an <see cref="T:System.ICloneable" /> interface.</para>
@@ -918,6 +935,10 @@ driver-defined-attribute-keyword ::= identifier</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ICloneable.Clone" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Object" /> that is a copy of this instance.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcConnectionStringBuilder.xml b/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcConnectionStringBuilder.xml
index b87c6e7ea3e..50931549233 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcConnectionStringBuilder.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcConnectionStringBuilder.xml
@@ -168,12 +168,15 @@ Console.WriteLine(builder.ConnectionString);</code>
         <Parameter Name="keyword" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Data.Odbc.OdbcConnectionStringBuilder" /> contains a specific key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Data.Odbc.OdbcConnectionStringBuilder" /> contains an element that has the specified key; otherwise false.</para>
+        </returns>
         <param name="keyword">
           <attribution license="cc4" from="Microsoft" modified="false" />The key to locate in the <see cref="T:System.Data.Odbc.OdbcConnectionStringBuilder" />.</param>
       </Docs>
@@ -289,7 +292,6 @@ Console.WriteLine(builder.ConnectionString);</code>
         <Parameter Name="keyword" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Because the <see cref="M:System.Data.Odbc.OdbcConnectionStringBuilder.Remove(System.String)" /> method returns a value that indicates its success, it is not required to look for the existence of a key before trying to remove the key/value pair from the <see cref="T:System.Data.Odbc.OdbcConnectionStringBuilder" /> instance.</para>
@@ -298,6 +300,10 @@ Console.WriteLine(builder.ConnectionString);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the entry with the specified key from the <see cref="T:System.Data.Odbc.OdbcConnectionStringBuilder" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key existed within the connection string and was removed; false if the key did not exist.</para>
+        </returns>
         <param name="keyword">
           <attribution license="cc4" from="Microsoft" modified="false" />The key of the key/value pair to be removed from the connection string in this <see cref="T:System.Data.Odbc.OdbcConnectionStringBuilder" />.</param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcDataAdapter.xml b/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcDataAdapter.xml
index 171eed56eec..d632f9f1262 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcDataAdapter.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcDataAdapter.xml
@@ -608,7 +608,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Odbc.OdbcDataAdapter" /> instance is cast to an <see cref="T:System.ICloneable" /> interface.</para>
@@ -617,6 +616,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ICloneable.Clone" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Object" /> that is a copy of this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="UpdateCommand">
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcDataReader.xml b/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcDataReader.xml
index 8f6a8f309b5..9f83922c910 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcDataReader.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcDataReader.xml
@@ -140,7 +140,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Conversions are performed based on the underlying capabilities of the ODBC driver. If the conversion is not supported then the method call will fail.</para>
@@ -150,6 +149,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a Boolean.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Boolean that is the value of the column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -168,7 +171,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Conversions are performed based on the underlying capabilities of the ODBC driver. If the conversion is not supported, the method call fails.</para>
@@ -178,6 +180,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a byte.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column as a byte.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -200,7 +206,6 @@
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -215,6 +220,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a stream of bytes from the specified column offset into the buffer as an array, starting at the particular buffer offset.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of bytes read.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
         <param name="dataIndex">
@@ -241,7 +250,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Conversions are performed based on the underlying capabilities of the ODBC driver. If the conversion is not supported, the method call fails.</para>
@@ -251,6 +259,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column as a character.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -273,7 +285,6 @@
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -288,6 +299,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a stream of characters from the specified column offset into the buffer as an array, starting at the particular buffer offset.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of characters read.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
         <param name="dataIndex">
@@ -339,12 +354,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the name of the source data type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the source data type.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -363,13 +381,16 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a <see cref="T:System.DateTime" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column as a <see cref="T:System.DateTime" /> object.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -388,7 +409,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Conversions are performed based on the underlying capabilities of the ODBC driver. If the conversion is not supported then the method call will fail.</para>
@@ -398,6 +418,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a <see cref="T:System.DateTime" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column as a <see cref="T:System.DateTime" /> object.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -416,7 +440,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Conversions are performed based on the underlying capabilities of the ODBC driver. If the conversion is not supported then the method call will fail.</para>
@@ -428,6 +451,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a <see cref="T:System.Decimal" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column as a <see cref="T:System.Decimal" /> object.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -446,7 +473,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Conversions are performed based on the underlying capabilities of the ODBC driver. If the conversion is not supported, the method call fails.</para>
@@ -456,6 +482,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a double-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column as a double-precision floating-point number.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -472,7 +502,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -482,6 +511,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the rows in the data reader.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the rows in the data reader.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -497,12 +530,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Type" /> that is the data type of the object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> that is the data type of the object.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -521,7 +557,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Conversions are performed based on the underlying capabilities of the ODBC driver. If the conversion is not supported then the method call will fail.</para>
@@ -531,6 +566,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a single-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column as a single-precision floating-point number.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -549,7 +588,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Conversions are performed based on the underlying capabilities of the ODBC driver. If the conversion is not supported, the method call fails.</para>
@@ -559,6 +597,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a globally unique identifier (GUID).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column as a GUID.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -577,7 +619,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Conversions are performed based on the underlying capabilities of the ODBC driver. If the conversion is not supported, the method call fails.</para>
@@ -587,6 +628,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a 16-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column as a 16-bit signed integer.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -605,7 +650,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Conversions are performed based on the underlying capabilities of the ODBC driver. If the conversion is not supported, the method call fails.</para>
@@ -615,6 +659,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column as a 32-bit signed integer.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -633,7 +681,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Conversions are performed based on the underlying capabilities of the ODBC driver. If the conversion is not supported, the method call fails.</para>
@@ -643,6 +690,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column as a 64-bit signed integer.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -661,12 +712,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the name of the specified column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that is the name of the specified column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -685,7 +739,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -698,6 +751,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the column ordinal, given the name of the column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based column ordinal.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the column. </param>
       </Docs>
@@ -714,7 +771,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.Odbc.OdbcDataReader.GetSchemaTable" /> method returns metadata about each column in the following order: </para>
@@ -891,6 +947,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Data.DataTable" /> that describes the column metadata of the <see cref="T:System.Data.Odbc.OdbcDataReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataTable" /> that describes the column metadata.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -907,7 +967,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Conversions are performed based on the underlying capabilities of the ODBC driver. If the conversion is not supported, the method call fails.</para>
@@ -917,6 +976,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column as a <see cref="T:System.String" />.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -935,12 +998,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a <see cref="T:System.TimeSpan" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column as a <see cref="T:System.TimeSpan" /> object.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -959,7 +1025,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns <see cref="T:System.DBNull" /> for null database columns.</para>
@@ -968,6 +1033,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the column at the specified ordinal in its native format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value to return.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -986,7 +1055,6 @@
         <Parameter Name="values" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For most applications, the <see cref="M:System.Data.Odbc.OdbcDataReader.GetValues" /> method provides an efficient means for retrieving all columns, instead of retrieving each column individually.</para>
@@ -997,6 +1065,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Populates an array of objects with the column values of the current row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of instances of <see cref="T:System.Object" /> in the array.</para>
+        </returns>
         <param name="values">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Object" /> into which to copy the attribute columns. </param>
       </Docs>
@@ -1057,7 +1129,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To avoid raising an error, call this method to look for null column values before calling the typed Get methods (for example, <see cref="M:System.Data.Odbc.OdbcDataReader.GetByte(System.Int32)" />, <see cref="M:System.Data.Odbc.OdbcDataReader.GetChar(System.Int32)" />, and so on).</para>
@@ -1066,6 +1137,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the column contains nonexistent or missing values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified column value is equivalent to <see cref="T:System.DBNull" />; otherwise false.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -1122,7 +1197,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used to process multiple results that can be generated by executing batch SQL statements.</para>
@@ -1132,6 +1206,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the <see cref="T:System.Data.Odbc.OdbcDataReader" /> to the next result when reading the results of batch SQL statements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there are more result sets; otherwise false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1146,7 +1224,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default position of the <see cref="T:System.Data.Odbc.OdbcDataReader" /> is before the first record. Therefore, you must call <see cref="M:System.Data.Odbc.OdbcDataReader.Read" /> to start accessing any data.</para>
@@ -1156,6 +1233,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the <see cref="T:System.Data.Odbc.OdbcDataReader" /> to the next record.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there are more rows; otherwise false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcError.xml b/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcError.xml
index e6ba9d11445..d29fe8dc42d 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcError.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcError.xml
@@ -106,12 +106,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the complete text of the error message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The complete text of the error.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcErrorCollection.xml b/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcErrorCollection.xml
index e935e313b93..0486568b242 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcErrorCollection.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcErrorCollection.xml
@@ -102,12 +102,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that implements the <see cref="T:" /><see cref="System.Collections.IEnumerator" /> interface and that can iterate through the <see cref="T:System.Data.Odbc.OdbcErrorCollection" /> objects in the <see cref="T:System.Data.Odbc.OdbcErrorCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that implements the <see cref="T:" /><see cref="System.Collections.IEnumerator" /> interface and that can iterate through the <see cref="T:System.Data.Odbc.OdbcErrorCollection" /> objects in the <see cref="T:System.Data.Odbc.OdbcErrorCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcFactory.xml b/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcFactory.xml
index af4f519b1c3..e455f6de231 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcFactory.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcFactory.xml
@@ -26,13 +26,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a strongly-typed <see cref="T:System.Data.Common.DbCommand" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new strongly-typed instance of <see cref="T:System.Data.Common.DbCommand" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -46,13 +49,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a strongly-typed <see cref="T:System.Data.Common.DbCommandBuilder" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new strongly-typed instance of <see cref="T:System.Data.Common.DbCommandBuilder" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -66,13 +72,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a strongly-typed <see cref="T:System.Data.Common.DbConnection" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new strongly-typed instance of <see cref="T:System.Data.Common.DbConnection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -89,12 +98,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a strongly-typed <see cref="T:System.Data.Common.DbConnectionStringBuilder" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new strongly-typed instance of <see cref="T:System.Data.Common.DbConnectionStringBuilder" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateDataAdapter">
@@ -105,13 +117,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a strongly-typed <see cref="T:System.Data.Common.DbDataAdapter" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new strongly-typed instance of <see cref="T:System.Data.Common.DbDataAdapter" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -125,13 +140,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a strongly-typed <see cref="T:System.Data.Common.DbParameter" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new strongly-typed instance of <see cref="T:System.Data.Common.DbParameter" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -150,12 +168,15 @@
         <Parameter Name="state" Type="System.Security.Permissions.PermissionState" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a strongly-typed <see cref="T:System.Security.CodeAccessPermission" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new strongly-typed instance of <see cref="T:System.Security.CodeAccessPermission" />. </para>
+        </returns>
         <param name="state">
           <attribution license="cc4" from="Microsoft" modified="false" />A member of the <see cref="T:System.Security.Permissions.PermissionState" /> enumeration.</param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcInfoMessageEventArgs.xml b/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcInfoMessageEventArgs.xml
index e0cfe91de73..f96336cbd99 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcInfoMessageEventArgs.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcInfoMessageEventArgs.xml
@@ -70,12 +70,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a string representation of the <see cref="E:System.Data.Odbc.OdbcConnection.InfoMessage" /> event.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representing the <see cref="E:System.Data.Odbc.OdbcConnection.InfoMessage" /> event.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcParameter.xml b/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcParameter.xml
index 997840c92e4..694a2b55370 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcParameter.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcParameter.xml
@@ -583,7 +583,6 @@ OleDbDataReader reader = command.ExecuteReader();</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.Odbc.OdbcParameter" /> instance is cast to an <see cref="T:System.ICloneable" /> interface.</para>
@@ -592,6 +591,10 @@ OleDbDataReader reader = command.ExecuteReader();</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ICloneable.Clone" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Object" /> that is a copy of this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -602,12 +605,15 @@ OleDbDataReader reader = command.ExecuteReader();</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a string that contains the <see cref="P:System.Data.Odbc.OdbcParameter.ParameterName" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the <see cref="P:System.Data.Odbc.OdbcParameter.ParameterName" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcParameterCollection.xml b/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcParameterCollection.xml
index a7fc897fba0..8a9d436ba7c 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcParameterCollection.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcParameterCollection.xml
@@ -40,12 +40,15 @@
         <Parameter Name="value" Type="System.Data.Odbc.OdbcParameter" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Data.Odbc.OdbcParameter" /> to the <see cref="T:System.Data.Odbc.OdbcParameterCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the new <see cref="T:System.Data.Odbc.OdbcParameter" /> object.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.Odbc.OdbcParameter" /> to add to the collection. </param>
       </Docs>
@@ -64,12 +67,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Data.Odbc.OdbcParameter" /> object to the <see cref="T:System.Data.Odbc.OdbcParameterCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the new <see cref="T:System.Data.Odbc.OdbcParameter" /> object in the collection.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Object" />.</param>
       </Docs>
@@ -94,12 +100,15 @@
         <Parameter Name="odbcType" Type="System.Data.Odbc.OdbcType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an <see cref="T:System.Data.Odbc.OdbcParameter" /> to the <see cref="T:System.Data.Odbc.OdbcParameterCollection" />, given the parameter name and data type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the new <see cref="T:System.Data.Odbc.OdbcParameter" /> object.</para>
+        </returns>
         <param name="parameterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the parameter. </param>
         <param name="odbcType">
@@ -121,7 +130,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use caution when using this overload of the <see cref="M:System.Data.Odbc.OdbcParameterCollection.Add(System.Data.Odbc.OdbcParameter)" /> method to specify integer parameter values. Because this overload takes a <paramref name="value" /> of type <see cref="T:System.Object" />, you must convert the integer value to an <see cref="T:System.Object" /> type when the value is zero, as the following C# example demonstrates.</para>
@@ -132,6 +140,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an <see cref="T:System.Data.Odbc.OdbcParameter" /> to the <see cref="T:System.Data.Odbc.OdbcParameterCollection" /> given the parameter name and value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the new <see cref="T:System.Data.Odbc.OdbcParameter" /> object.</para>
+        </returns>
         <param name="parameterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the parameter. </param>
         <param name="value">
@@ -162,12 +174,15 @@
         <Parameter Name="size" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an <see cref="T:System.Data.Odbc.OdbcParameter" /> to the <see cref="T:System.Data.Odbc.OdbcParameterCollection" />, given the parameter name, data type, and column length.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the new <see cref="T:System.Data.Odbc.OdbcParameter" /> object.</para>
+        </returns>
         <param name="parameterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the parameter. </param>
         <param name="odbcType">
@@ -193,13 +208,16 @@
         <Parameter Name="sourceColumn" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an <see cref="T:System.Data.Odbc.OdbcParameter" /> to the <see cref="T:System.Data.Odbc.OdbcParameterCollection" /> given the parameter name, data type, column length, and source column name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the new <see cref="T:System.Data.Odbc.OdbcParameter" /> object.</para>
+        </returns>
         <param name="parameterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the parameter. </param>
         <param name="odbcType">
@@ -273,12 +291,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a value to the end of the <see cref="T:System.Data.Odbc.OdbcParameterCollection" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Data.Odbc.OdbcParameter" /> object.</para>
+        </returns>
         <param name="parameterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the parameter.</param>
         <param name="value">
@@ -317,12 +338,15 @@
         <Parameter Name="value" Type="System.Data.Odbc.OdbcParameter" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Data.Odbc.OdbcParameter" /> is in this <see cref="T:System.Data.Odbc.OdbcParameterCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Data.Odbc.OdbcParameter" /> is in the collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.Odbc.OdbcParameter" /> value.</param>
       </Docs>
@@ -337,12 +361,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is in this <see cref="T:System.Data.Odbc.OdbcParameterCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Data.Odbc.OdbcParameterCollection" /> contains the value otherwise false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> value.</param>
       </Docs>
@@ -361,12 +388,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether an <see cref="T:System.Data.Odbc.OdbcParameter" /> object with the specified parameter name exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the parameter; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Data.Odbc.OdbcParameter" /> object to find. </param>
       </Docs>
@@ -453,12 +483,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the <see cref="T:System.Data.Odbc.OdbcParameterCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerator" /> for the <see cref="T:System.Data.Odbc.OdbcParameterCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -518,12 +551,15 @@
         <Parameter Name="value" Type="System.Data.Odbc.OdbcParameter" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the location of the specified <see cref="T:System.Data.Odbc.OdbcParameter" /> within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based location of the specified <see cref="T:System.Data.Odbc.OdbcParameter" /> within the collection.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.Odbc.OdbcParameter" /> object in the collection to find.</param>
       </Docs>
@@ -538,12 +574,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the location of the specified <see cref="T:System.Object" /> within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based location of the specified <see cref="T:System.Object" /> that is a <see cref="T:System.Data.Odbc.OdbcParameter" /> within the collection.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to find.</param>
       </Docs>
@@ -562,12 +601,15 @@
         <Parameter Name="parameterName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the location of the specified <see cref="T:System.Data.Odbc.OdbcParameter" /> with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based location of the specified <see cref="T:System.Data.Odbc.OdbcParameter" /> with the specified case-sensitive name.</para>
+        </returns>
         <param name="parameterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The case-sensitive name of the <see cref="T:System.Data.Odbc.OdbcParameter" /> to find.</param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcPermission.xml b/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcPermission.xml
index 5970d71ac87..d62bb531b69 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcPermission.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcPermission.xml
@@ -147,12 +147,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Data.Odbc.OdbcPermission" /> as an <see cref="T:System.Security.IPermission" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current permission object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcPermissionAttribute.xml b/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcPermissionAttribute.xml
index b64eb250e4f..80aed04060a 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcPermissionAttribute.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Odbc/OdbcPermissionAttribute.xml
@@ -38,6 +38,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of the <see cref="T:System.Data.Odbc.OdbcPermissionAttribute" /> class with one of the <see cref="T:System.Security.Permissions.SecurityAction" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Data.Odbc.OdbcPermissionAttribute" /> object.</para>
+        </returns>
         <param name="action">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Security.Permissions.SecurityAction" /> values representing an action that can be performed by using declarative security. </param>
       </Docs>
@@ -54,12 +58,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Data.Odbc.OdbcPermission" /> object that is configured according to the attribute properties.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Data.Odbc.OdbcPermission" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbCommand.xml b/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbCommand.xml
index 04d03da5c32..e7a61749bfa 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbCommand.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbCommand.xml
@@ -413,12 +413,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Data.OleDb.OleDbCommand" /> object that is a copy of the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.OleDb.OleDbCommand" /> object that is a copy of this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CommandText">
@@ -579,7 +582,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'OleDbParameter'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.OleDb.OleDbCommand.CreateParameter" /> method is a strongly typed version of <see cref="M:System.Data.IDbCommand.CreateParameter" />.</para>
@@ -588,6 +590,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of an <see cref="T:System.Data.OleDb.OleDbParameter" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Data.OleDb.OleDbParameter" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -720,7 +726,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the <see cref="M:System.Data.OleDb.OleDbCommand.ExecuteNonQuery" /> to perform catalog operations, for example, to query the structure of a database or to create database objects such as tables, or to change the data in a database without using a <see cref="T:System.Data.DataSet" /> by executing UPDATE, INSERT, or DELETE statements.</para>
@@ -731,6 +736,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes an SQL statement against the <see cref="P:System.Data.OleDb.OleDbCommand.Connection" /> and returns the number of rows affected.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows affected.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -745,7 +754,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'OleDbDataReader'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When the <see cref="P:System.Data.OleDb.OleDbCommand.CommandType" /> property is set to StoredProcedure, the <see cref="P:System.Data.OleDb.OleDbCommand.CommandText" /> property should be set to the name of the stored procedure. The command executes this stored procedure when you call <see cref="M:System.Data.OleDb.OleDbCommand.ExecuteReader" />.</para>
@@ -755,6 +763,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends the <see cref="P:System.Data.OleDb.OleDbCommand.CommandText" /> to the <see cref="P:System.Data.OleDb.OleDbCommand.Connection" /> and builds an <see cref="T:System.Data.OleDb.OleDbDataReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Data.OleDb.OleDbDataReader" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -771,7 +783,6 @@
         <Parameter Name="behavior" Type="System.Data.CommandBehavior" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'OleDbDataReader'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When you specify <see cref="F:System.Data.CommandBehavior.SingleRow" /> with the <see cref="M:System.Data.OleDb.OleDbCommand.ExecuteReader" /> method of the <see cref="T:System.Data.OleDb.OleDbCommand" /> object, the .NET Framework Data Provider for OLE DB performs binding using the OLE DB IRow interface if it is available. Otherwise, it uses the IRowset interface. If your SQL statement is expected to return only a single row, specifying <see cref="F:System.Data.CommandBehavior.SingleRow" /> can also improve application performance.</para>
@@ -783,6 +794,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends the <see cref="P:System.Data.OleDb.OleDbCommand.CommandText" /> to the <see cref="P:System.Data.OleDb.OleDbCommand.Connection" />, and builds an <see cref="T:System.Data.OleDb.OleDbDataReader" /> using one of the <see cref="T:System.Data.CommandBehavior" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Data.OleDb.OleDbDataReader" /> object.</para>
+        </returns>
         <param name="behavior">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Data.CommandBehavior" /> values. </param>
       </Docs>
@@ -799,7 +814,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Data.OleDb.OleDbCommand.ExecuteScalar" /> method to retrieve a single value, for example, an aggregate value, from a data source. This requires less code than using the <see cref="M:System.Data.OleDb.OleDbCommand.ExecuteReader" /> method, and then performing the operations that are required to generate the single value using the data returned by an <see cref="T:System.Data.OleDb.OleDbDataReader" />.</para>
@@ -811,6 +825,10 @@ Int32 count = (int32) ExecuteScalar();</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the query, and returns the first column of the first row in the result set returned by the query. Additional columns or rows are ignored.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first column of the first row in the result set, or a null reference if the result set is empty.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -941,7 +959,6 @@ Int32 count = (int32) ExecuteScalar();</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.OleDb.OleDbCommand" /> instance is cast to an <see cref="T:System.Data.IDbCommand" /> interface.</para>
@@ -950,6 +967,10 @@ Int32 count = (int32) ExecuteScalar();</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Data.IDbCommand.ExecuteReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Data.IDataReader" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Data.IDbCommand.ExecuteReader">
@@ -966,7 +987,6 @@ Int32 count = (int32) ExecuteScalar();</code>
         <Parameter Name="behavior" Type="System.Data.CommandBehavior" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.OleDb.OleDbCommand" /> instance is cast to an <see cref="T:System.Data.IDbCommand" /> interface.</para>
@@ -976,6 +996,10 @@ Int32 count = (int32) ExecuteScalar();</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the <see cref="P:System.Data.IDbCommand.CommandText" /> against the <see cref="P:System.Data.IDbCommand.Connection" />, and builds an <see cref="T:System.Data.IDataReader" /> using one of the <see cref="T:System.Data.CommandBehavior" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Data.IDataReader" /> built using one of the <see cref="T:System.Data.CommandBehavior" /> values.</para>
+        </returns>
         <param name="behavior">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Data.CommandBehavior" /> values.</param>
       </Docs>
@@ -1024,7 +1048,6 @@ Int32 count = (int32) ExecuteScalar();</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.OleDb.OleDbCommand" /> instance is cast to an <see cref="T:System.ICloneable" /> interface.</para>
@@ -1033,6 +1056,10 @@ Int32 count = (int32) ExecuteScalar();</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ICloneable.Clone" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Object" /> that is a copy of this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Transaction">
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbCommandBuilder.xml b/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbCommandBuilder.xml
index 3400bb75ef5..144cf0fab4a 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbCommandBuilder.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbCommandBuilder.xml
@@ -182,7 +182,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'OleDbCommand'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An application can use the <see cref="M:System.Data.OleDb.OleDbCommandBuilder.GetDeleteCommand" /> method for informational or troubleshooting purposes because it returns the <see cref="T:System.Data.OleDb.OleDbCommand" /> object to be executed.</para>
@@ -193,6 +192,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the automatically generated <see cref="T:System.Data.OleDb.OleDbCommand" /> object required to perform deletions at the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The automatically generated <see cref="T:System.Data.OleDb.OleDbCommand" /> object required to perform deletions.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -212,7 +215,6 @@
         <Parameter Name="useColumnsForParameterNames" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An application can use the <see cref="M:System.Data.OleDb.OleDbCommandBuilder.GetDeleteCommand" /> method for informational or troubleshooting purposes because it returns the <see cref="T:System.Data.OleDb.OleDbCommand" /> object to be executed.</para>
@@ -235,6 +237,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the automatically generated <see cref="T:System.Data.OleDb.OleDbCommand" /> object required to perform deletions at the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The automatically generated <see cref="T:System.Data.OleDb.OleDbCommand" /> object required to perform deletions.</para>
+        </returns>
         <param name="useColumnsForParameterNames">
           <attribution license="cc4" from="Microsoft" modified="false" />If true, generate parameter names matching column names, if it is possible. If false, generate @p1, @p2, and so on.</param>
       </Docs>
@@ -247,7 +253,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'OleDbCommand'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An application can use the <see cref="M:System.Data.OleDb.OleDbCommandBuilder.GetInsertCommand" /> method for informational or troubleshooting purposes because it returns the text of the <see cref="T:System.Data.OleDb.OleDbCommand" /> object to be executed.</para>
@@ -258,6 +263,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the automatically generated <see cref="T:System.Data.OleDb.OleDbCommand" /> object required to perform insertions at the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The automatically generated <see cref="T:System.Data.OleDb.OleDbCommand" /> object required to perform insertions.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -277,7 +286,6 @@
         <Parameter Name="useColumnsForParameterNames" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An application can use the <see cref="M:System.Data.OleDb.OleDbCommandBuilder.GetInsertCommand" /> method for informational or troubleshooting purposes because it returns the text of the <see cref="T:System.Data.OleDb.OleDbCommand" /> object to be executed.</para>
@@ -300,6 +308,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the automatically generated <see cref="T:System.Data.OleDb.OleDbCommand" /> object required to perform insertions at the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The automatically generated <see cref="T:System.Data.OleDb.OleDbCommand" /> object required to perform insertions.</para>
+        </returns>
         <param name="useColumnsForParameterNames">
           <attribution license="cc4" from="Microsoft" modified="false" />If true, generate parameter names matching column names, if it is possible. If false, generate @p1, @p2, and so on.</param>
       </Docs>
@@ -369,7 +381,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'OleDbCommand'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An application can use the <see cref="M:System.Data.OleDb.OleDbCommandBuilder.GetUpdateCommand" /> method for informational or troubleshooting purposes because it returns the <see cref="T:System.Data.OleDb.OleDbCommand" /> object to be executed.</para>
@@ -380,6 +391,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the automatically generated <see cref="T:System.Data.OleDb.OleDbCommand" /> object required to perform updates at the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The automatically generated <see cref="T:System.Data.OleDb.OleDbCommand" /> object required to perform updates.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -399,7 +414,6 @@
         <Parameter Name="useColumnsForParameterNames" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An application can use the <see cref="M:System.Data.OleDb.OleDbCommandBuilder.GetUpdateCommand" /> method for informational or troubleshooting purposes because it returns the <see cref="T:System.Data.OleDb.OleDbCommand" /> object to be executed.</para>
@@ -422,6 +436,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the automatically generated <see cref="T:System.Data.OleDb.OleDbCommand" /> object required to perform updates at the data source, optionally using columns for parameter names.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The automatically generated <see cref="T:System.Data.OleDb.OleDbCommand" /> object required to perform updates.</para>
+        </returns>
         <param name="useColumnsForParameterNames">
           <attribution license="cc4" from="Microsoft" modified="false" />If true, generate parameter names matching column names, if it is possible. If false, generate @p1, @p2, and so on.</param>
       </Docs>
@@ -439,12 +457,15 @@
         <Parameter Name="unquotedIdentifier" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Given an unquoted identifier in the correct catalog case, returns the correct quoted form of that identifier. This includes correctly escaping any embedded quotes in the identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The quoted version of the identifier. Embedded quotes within the identifier are correctly escaped.</para>
+        </returns>
         <param name="unquotedIdentifier">
           <attribution license="cc4" from="Microsoft" modified="false" />The original unquoted identifier.</param>
       </Docs>
@@ -463,12 +484,15 @@
         <Parameter Name="connection" Type="System.Data.OleDb.OleDbConnection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Given an unquoted identifier in the correct catalog case, returns the correct quoted form of that identifier. This includes correctly escaping any embedded quotes in the identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The quoted version of the identifier. Embedded quotes within the identifier are correctly escaped.</para>
+        </returns>
         <param name="unquotedIdentifier">
           <attribution license="cc4" from="Microsoft" modified="false" />The unquoted identifier to be returned in quoted format.</param>
         <param name="connection">
@@ -567,12 +591,15 @@
         <Parameter Name="quotedIdentifier" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Given a quoted identifier, returns the correct unquoted form of that identifier. This includes correctly un-escaping any embedded quotes in the identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The unquoted identifier, with embedded quotes correctly un-escaped.</para>
+        </returns>
         <param name="quotedIdentifier">
           <attribution license="cc4" from="Microsoft" modified="false" />The identifier that will have its embedded quotes removed.</param>
       </Docs>
@@ -591,12 +618,15 @@
         <Parameter Name="connection" Type="System.Data.OleDb.OleDbConnection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Given a quoted identifier, returns the correct unquoted form of that identifier. This includes correctly un-escaping any embedded quotes in the identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The unquoted identifier, with embedded quotes correctly un-escaped.</para>
+        </returns>
         <param name="quotedIdentifier">
           <attribution license="cc4" from="Microsoft" modified="false" />The identifier that will have its embedded quotes removed.</param>
         <param name="connection">
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbConnection.xml b/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbConnection.xml
index 55e5af9b79a..6f04090d5b4 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbConnection.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbConnection.xml
@@ -215,7 +215,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'OleDbTransaction'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You must explicitly commit or roll back the transaction using the <see cref="M:System.Data.OleDb.OleDbTransaction.Commit" /> or <see cref="M:System.Data.OleDb.OleDbTransaction.Rollback" /> method. To make sure that the .NET Framework Data Provider for OLE DB transaction management model performs correctly, avoid using other transaction management models, such as those provided by the data source.</para>
@@ -224,6 +223,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Starts a database transaction with the current <see cref="T:System.Data.IsolationLevel" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the new transaction.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -240,7 +243,6 @@
         <Parameter Name="isolationLevel" Type="System.Data.IsolationLevel" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'OleDbTransaction'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You must explicitly commit or roll back the transaction using the <see cref="M:System.Data.OleDb.OleDbTransaction.Commit" /> or <see cref="M:System.Data.OleDb.OleDbTransaction.Rollback" /> method. To make sure that the .NET Framework Data Provider for OLE DB transaction management model performs correctly, avoid using other transaction management models, such as those provided by the data source.</para>
@@ -252,6 +254,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Starts a database transaction with the specified isolation level.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the new transaction.</para>
+        </returns>
         <param name="isolationLevel">
           <attribution license="cc4" from="Microsoft" modified="false" />The isolation level under which the transaction should run.</param>
       </Docs>
@@ -417,12 +423,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'OleDbCommand'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an <see cref="T:System.Data.OleDb.OleDbCommand" /> object associated with the <see cref="T:System.Data.OleDb.OleDbConnection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Data.OleDb.OleDbCommand" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -583,7 +592,6 @@
         <Parameter Name="restrictions" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Data.DataTable'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The schema table is returned as a <see cref="T:System.Data.DataTable" /> that has the same format as the OLE DB schema rowset specified by the <paramref name="schema" /> parameter. Use the <paramref name="restrictions" /> parameter to filter the rows to be returned in the <see cref="T:System.Data.DataTable" /> (for example, by specifying restrictions for table name, type, owner, or schema). When you pass values in the array, include empty strings or nulls for array elements that do not contain values. If you pass an empty array to <paramref name="restrictions" />, all rows (one for each table) are returned in default order. Values in the array correspond to the order of the columns in the source table and <see cref="T:System.Data.DataTable" />. Each element in the restrictions array is compared with the content of the corresponding column in the schema rowset. For example, the first element in the restrictions array is compared to first column in the rowset. If a restriction element is not null, only rows from the schema rowset that exactly match the value of the restriction are added to the resulting <see cref="T:System.Data.DataTable" />.</para>
@@ -594,6 +602,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns schema information from a data source as indicated by a GUID, and after it applies the specified restrictions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataTable" /> that contains the requested schema information.</para>
+        </returns>
         <param name="schema">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Data.OleDb.OleDbSchemaGuid" /> values that specifies the schema table to return. </param>
         <param name="restrictions">
@@ -615,12 +627,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns schema information for the data source of this <see cref="T:System.Data.OleDb.OleDbConnection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataTable" /> that contains schema information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetSchema">
@@ -636,7 +651,6 @@
         <Parameter Name="collectionName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When <paramref name="collectionName" /> is specified as null, the <see cref="T:System.Data.DataTable" /> will contain information about all the metadata that is available, and its restrictions.</para>
@@ -645,6 +659,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns schema information for the data source of this <see cref="T:System.Data.OleDb.OleDbConnection" /> using the specified string for the schema name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataTable" /> that contains schema information.</para>
+        </returns>
         <param name="collectionName">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies the name of the schema to return. </param>
       </Docs>
@@ -663,7 +681,6 @@
         <Parameter Name="restrictionValues" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When <paramref name="collectionName" /> is specified as null, the <see cref="T:System.Data.DataTable" /> will contain information about all the metadata that is available, and its restrictions.</para>
@@ -674,6 +691,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns schema information for the data source of this <see cref="T:System.Data.OleDb.OleDbConnection" /> using the specified string for the schema name and the specified string array for the restriction values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataTable" /> that contains schema information.</para>
+        </returns>
         <param name="collectionName">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies the name of the schema to return.</param>
         <param name="restrictionValues">
@@ -967,7 +988,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.OleDb.OleDbConnection" /> instance is cast to an <see cref="T:System.ICloneable" /> interface.</para>
@@ -976,6 +996,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ICloneable.Clone" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Object" /> that is a copy of this instance.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbDataAdapter.xml b/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbDataAdapter.xml
index cd5202b02e9..7b56d4d641f 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbDataAdapter.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbDataAdapter.xml
@@ -379,7 +379,6 @@
         <Parameter Name="ADODBRecordSet" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The link between ActiveX Data Objects (ADO) and ADO.NET is a one-way operation in that you can copy data from ADO to the <see cref="T:System.Data.DataSet" />, but any updates to the data must be handled by ADO.NET. </para>
@@ -434,6 +433,10 @@ rAdapter.Fill(rDataSet, "source table");   </code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds or refreshes rows in a <see cref="T:System.Data.DataTable" /> to match those in an ADO Recordset or Record object using the specified <see cref="T:System.Data.DataTable" /> and ADO objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows successfully refreshed to the <see cref="T:System.Data.DataTable" />. This does not include rows affected by statements that do not return rows.</para>
+        </returns>
         <param name="dataTable">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.DataTable" /> to fill with records and, if it is required, schema. </param>
         <param name="ADODBRecordSet">
@@ -456,7 +459,6 @@ rAdapter.Fill(rDataSet, "source table");   </code>
         <Parameter Name="srcTable" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The link between ActiveX Data Objects (ADO) and ADO.NET is a one-way operation in that you can copy data from ADO to the <see cref="T:System.Data.DataSet" />, but any updates to the data must be handled by ADO.NET. </para>
@@ -498,6 +500,10 @@ rAdapter.Fill(rDataSet, "source table");   </code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds or refreshes rows in the <see cref="T:System.Data.DataSet" /> to match those in an ADO Recordset or Record object using the specified <see cref="T:System.Data.DataSet" />, ADO object, and source table name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows successfully added to or refreshed in the <see cref="T:System.Data.DataSet" />. This does not include rows affected by statements that do not return rows.</para>
+        </returns>
         <param name="dataSet">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.DataSet" /> to fill with records and, if it is required, schema. </param>
         <param name="ADODBRecordSet">
@@ -825,7 +831,6 @@ rAdapter.Fill(rDataSet, "source table");   </code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.OleDb.OleDbDataAdapter" /> instance is cast to an <see cref="T:System.ICloneable" /> interface.</para>
@@ -834,6 +839,10 @@ rAdapter.Fill(rDataSet, "source table");   </code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ICloneable.Clone" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Object" /> that is a copy of this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="UpdateCommand">
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbDataReader.xml b/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbDataReader.xml
index 69ceae8cd48..e8e70cdd8d9 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbDataReader.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbDataReader.xml
@@ -124,7 +124,6 @@
         <Parameter Name="ordinal" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore the data retrieved must already be a Boolean, or an exception is generated.</para>
@@ -134,6 +133,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a Boolean.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the column.</para>
+        </returns>
         <param name="ordinal">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -152,7 +155,6 @@
         <Parameter Name="ordinal" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore the data retrieved must already be a byte.</para>
@@ -162,6 +164,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a byte.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column as a byte.</para>
+        </returns>
         <param name="ordinal">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -184,7 +190,6 @@
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -196,6 +201,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a stream of bytes from the specified column offset into the buffer as an array starting at the given buffer offset.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of bytes read.</para>
+        </returns>
         <param name="ordinal">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
         <param name="dataIndex">
@@ -222,7 +231,6 @@
         <Parameter Name="ordinal" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'char'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Not supported for <see cref="N:System.Data.OleDb" />.</para>
@@ -231,6 +239,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="ordinal">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -258,7 +270,6 @@
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -270,6 +281,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a stream of characters from the specified column offset into the buffer as an array starting at the given buffer offset.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of characters read.</para>
+        </returns>
         <param name="ordinal">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
         <param name="dataIndex">
@@ -296,7 +311,6 @@
         <Parameter Name="ordinal" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'OleDbDataReader'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.OleDb.OleDbDataAdapter.Fill(System.Data.DataSet,System.Object,System.String)" /> will call <see cref="M:System.Data.OleDb.OleDbDataReader.GetData(System.Int32)" /> if the provider returns a <see cref="T:System.Data.IDataReader" /> that has a column that supports <see cref="T:System.Data.IDataReader" />.</para>
@@ -305,6 +319,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Data.OleDb.OleDbDataReader" /> object for the requested column ordinal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Data.OleDb.OleDbDataReader" /> object.</para>
+        </returns>
         <param name="ordinal">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal.</param>
       </Docs>
@@ -328,12 +346,15 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the name of the source data type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the back-end data type. For more information, see <see cref="http://go.microsoft.com/fwlink/?LinkId=198032">SQL Server data types</see> or <see cref="http://go.microsoft.com/fwlink/?LinkId=198033">Access data types</see>.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -352,7 +373,6 @@
         <Parameter Name="ordinal" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DateTime'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore, the data retrieved must already be a <see cref="T:System.DateTime" /> object.</para>
@@ -362,6 +382,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a <see cref="T:System.DateTime" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="ordinal">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -399,7 +423,6 @@
         <Parameter Name="ordinal" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'decimal'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore, the data retrieved must already be a <see cref="T:System.Decimal" /> object.</para>
@@ -409,6 +432,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a <see cref="T:System.Decimal" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="ordinal">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -427,7 +454,6 @@
         <Parameter Name="ordinal" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'double'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore, the data retrieved must already be a double-precision floating-point number.</para>
@@ -437,6 +463,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a double-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="ordinal">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -456,7 +486,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Although you can use this method to retrieve an explicit enumerator, in languages that support a foreach construct, it is simpler to use the looping construct directly in order to iterate through the rows in the data reader.</para>
@@ -465,6 +494,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the rows in the data reader.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the rows in the data reader.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetFieldType">
@@ -477,12 +510,15 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Type'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Type" /> that is the data type of the object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> that is the data type of the object.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -501,7 +537,6 @@
         <Parameter Name="ordinal" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'float'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed. Therefore, the data retrieved must already be a single-precision floating-point number.</para>
@@ -511,6 +546,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a single-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="ordinal">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -529,7 +568,6 @@
         <Parameter Name="ordinal" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Guid'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore the data retrieved must already be a globally unique identifier.</para>
@@ -539,6 +577,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a globally unique identifier (GUID).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="ordinal">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -557,7 +599,6 @@
         <Parameter Name="ordinal" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'short'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore, the data retrieved must already be a 16-bit signed integer.</para>
@@ -567,6 +608,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a 16-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="ordinal">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -585,7 +630,6 @@
         <Parameter Name="ordinal" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore, the data retrieved must already be a 32-bit signed integer.</para>
@@ -595,6 +639,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="ordinal">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -613,7 +661,6 @@
         <Parameter Name="ordinal" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore, the data retrieved must already be a 64-bit signed integer.</para>
@@ -623,6 +670,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="ordinal">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -641,12 +692,15 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the name of the specified column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the specified column.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -665,7 +719,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -678,6 +731,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the column ordinal, given the name of the column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based column ordinal.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the column. </param>
       </Docs>
@@ -694,7 +751,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Data.DataTable'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.OleDb.OleDbDataReader.GetSchemaTable" /> method maps to the OLE DB IColumnsRowset::GetColumnsRowset method, and returns metadata about each column in the following order: </para>
@@ -922,6 +978,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Data.DataTable" /> that describes the column metadata of the <see cref="T:System.Data.OleDb.OleDbDataReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataTable" /> that describes the column metadata.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -938,7 +998,6 @@
         <Parameter Name="ordinal" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore the data retrieved must already be a string.</para>
@@ -948,6 +1007,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="ordinal">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -966,7 +1029,6 @@
         <Parameter Name="ordinal" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TimeSpan'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore, the data retrieved must already be a <see cref="T:System.TimeSpan" /> object.</para>
@@ -976,6 +1038,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a <see cref="T:System.TimeSpan" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="ordinal">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -994,7 +1060,6 @@
         <Parameter Name="ordinal" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns <see cref="T:System.DBNull" /> for null database columns.</para>
@@ -1003,6 +1068,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the column at the specified ordinal in its native format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value to return.</para>
+        </returns>
         <param name="ordinal">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -1021,7 +1090,6 @@
         <Parameter Name="values" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For most applications, the <see cref="M:System.Data.OleDb.OleDbDataReader.GetValues(System.Object[])" /> method provides an efficient means for retrieving all columns, instead of retrieving each column individually.</para>
@@ -1032,6 +1100,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Populates an array of objects with the column values of the current row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of instances of <see cref="T:System.Object" /> in the array.</para>
+        </returns>
         <param name="values">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Object" /> into which to copy the attribute columns. </param>
       </Docs>
@@ -1092,7 +1164,6 @@
         <Parameter Name="ordinal" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this method to look for null column values before calling the typed get methods (for example, <see cref="M:System.Data.OleDb.OleDbDataReader.GetByte(System.Int32)" />, <see cref="M:System.Data.OleDb.OleDbDataReader.GetChar(System.Int32)" />, and so on) to avoid raising an error.</para>
@@ -1101,6 +1172,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the column contains nonexistent or missing values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified column value is equivalent to <see cref="T:System.DBNull" />; otherwise, false.</para>
+        </returns>
         <param name="ordinal">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -1157,7 +1232,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used to process multiple results that can be generated by executing batch SQL statements.</para>
@@ -1167,6 +1241,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the data reader to the next result, when reading the results of batch SQL statements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there are more result sets; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1181,7 +1259,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default position of the <see cref="T:System.Data.OleDb.OleDbDataReader" /> is before the first record. Therefore, you must call <see cref="M:System.Data.OleDb.OleDbDataReader.Read" /> to start accessing any data.</para>
@@ -1191,6 +1268,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the <see cref="T:System.Data.OleDb.OleDbDataReader" /> to the next record.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there are more rows; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbError.xml b/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbError.xml
index de9f54a43ae..57ff2123fcd 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbError.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbError.xml
@@ -109,7 +109,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The string is in the form "OleDbError:", followed by the <see cref="P:System.Data.OleDb.OleDbError.Message" />, and the stack trace. For example: </para>
@@ -119,6 +118,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the complete text of the error message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The complete text of the error.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbErrorCollection.xml b/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbErrorCollection.xml
index 33127a1176b..ef2053443dc 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbErrorCollection.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbErrorCollection.xml
@@ -111,12 +111,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IEnumerator'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Exposes the <see cref="M:System.Collections.IEnumerable.GetEnumerator" /> method, which supports a simple iteration over a collection by a .NET Framework data provider.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbInfoMessageEventArgs.xml b/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbInfoMessageEventArgs.xml
index 4c20a71d468..d41549cdfde 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbInfoMessageEventArgs.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbInfoMessageEventArgs.xml
@@ -117,12 +117,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a string representation of the <see cref="E:System.Data.OleDb.OleDbConnection.InfoMessage" /> event.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representing the <see cref="E:System.Data.OleDb.OleDbConnection.InfoMessage" /> event.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbParameter.xml b/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbParameter.xml
index eba136da26f..766f3024f6b 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbParameter.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbParameter.xml
@@ -663,7 +663,6 @@ OleDbDataReader reader = command.ExecuteReader();</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.OleDb.OleDbParameter" /> instance is cast to an <see cref="T:System.ICloneable" /> interface.</para>
@@ -672,6 +671,10 @@ OleDbDataReader reader = command.ExecuteReader();</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ICloneable.Clone" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Object" /> that is a copy of this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -682,12 +685,15 @@ OleDbDataReader reader = command.ExecuteReader();</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a string that contains the <see cref="P:System.Data.OleDb.OleDbParameter.ParameterName" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the <see cref="P:System.Data.OleDb.OleDbParameter.ParameterName" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbParameterCollection.xml b/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbParameterCollection.xml
index f2ec984c453..b24ed998d94 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbParameterCollection.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbParameterCollection.xml
@@ -43,12 +43,15 @@
         <Parameter Name="value" Type="System.Data.OleDb.OleDbParameter" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'OleDbParameter'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Data.OleDb.OleDbParameter" /> to the <see cref="T:System.Data.OleDb.OleDbParameterCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the new <see cref="T:System.Data.OleDb.OleDbParameter" /> object.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.OleDb.OleDbParameter" /> to add to the collection.</param>
       </Docs>
@@ -67,12 +70,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Data.OleDb.OleDbParameter" /> object to the <see cref="T:System.Data.OleDb.OleDbParameterCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the new <see cref="T:System.Data.OleDb.OleDbParameter" /> object in the collection.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Object" />.</param>
       </Docs>
@@ -97,12 +103,15 @@
         <Parameter Name="oleDbType" Type="System.Data.OleDb.OleDbType" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'OleDbParameter'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an <see cref="T:System.Data.OleDb.OleDbParameter" /> to the <see cref="T:System.Data.OleDb.OleDbParameterCollection" />, given the parameter name and data type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the new <see cref="T:System.Data.OleDb.OleDbParameter" /> object.</para>
+        </returns>
         <param name="parameterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the parameter. </param>
         <param name="oleDbType">
@@ -124,7 +133,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'OleDbParameter'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use caution when using this overload of the <see cref="M:System.Data.OleDb.OleDbParameterCollection.Add(System.Data.OleDb.OleDbParameter)" /> method to specify integer parameter values. Because this overload takes a <paramref name="value" /> of type <see cref="T:System.Object" />, you must convert the value to an <see cref="T:System.Object" /> type when the value is zero, as the following C# example demonstrates.</para>
@@ -135,6 +143,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an <see cref="T:System.Data.OleDb.OleDbParameter" /> to the <see cref="T:System.Data.OleDb.OleDbParameterCollection" /> given the parameter name and value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the new <see cref="T:System.Data.OleDb.OleDbParameter" /> object.</para>
+        </returns>
         <param name="parameterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the parameter. </param>
         <param name="value">
@@ -165,12 +177,15 @@
         <Parameter Name="size" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'OleDbParameter'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an <see cref="T:System.Data.OleDb.OleDbParameter" /> to the <see cref="T:System.Data.OleDb.OleDbParameterCollection" /> given the parameter name, data type, and column length.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the new <see cref="T:System.Data.OleDb.OleDbParameter" /> object.</para>
+        </returns>
         <param name="parameterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the parameter. </param>
         <param name="oleDbType">
@@ -196,12 +211,15 @@
         <Parameter Name="sourceColumn" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'OleDbParameter'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an <see cref="T:System.Data.OleDb.OleDbParameter" /> to the <see cref="T:System.Data.OleDb.OleDbParameterCollection" /> given the parameter name, data type, column length, and source column name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the new <see cref="T:System.Data.OleDb.OleDbParameter" /> object.</para>
+        </returns>
         <param name="parameterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the parameter. </param>
         <param name="oleDbType">
@@ -274,12 +292,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a value to the end of the <see cref="T:System.Data.OleDb.OleDbParameterCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Data.OleDb.OleDbParameter" /> object.</para>
+        </returns>
         <param name="parameterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the parameter.</param>
         <param name="value">
@@ -318,12 +339,15 @@
         <Parameter Name="value" Type="System.Data.OleDb.OleDbParameter" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Data.OleDb.OleDbParameter" /> is in this <see cref="T:System.Data.OleDb.OleDbParameterCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="P:System.Data.OleDb.OleDbParameter" /> is in the collection; otherwise false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.OleDb.OleDbParameter" /> value.</param>
       </Docs>
@@ -338,12 +362,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is in this <see cref="T:System.Data.OleDb.OleDbParameterCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Data.OleDb.OleDbParameterCollection" /> contains <paramref name="value" />; otherwise false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> value.</param>
       </Docs>
@@ -362,12 +389,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.String" /> is in this <see cref="T:System.Data.OleDb.OleDbParameterCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Data.OleDb.OleDbParameterCollection" /> contains the value; otherwise false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> value.</param>
       </Docs>
@@ -454,12 +484,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IEnumerator'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the <see cref="T:System.Data.OleDb.OleDbParameterCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerator" /> for the <see cref="T:System.Data.OleDb.OleDbParameterCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -517,12 +550,15 @@
         <Parameter Name="value" Type="System.Data.OleDb.OleDbParameter" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the location of the specified <see cref="T:System.Data.OleDb.OleDbParameter" /> within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based location of the specified <see cref="T:System.Data.OleDb.OleDbParameter" /> that is a <see cref="T:System.Data.OleDb.OleDbParameter" /> within the collection.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.OleDb.OleDbParameter" /> object in the collection to find.</param>
       </Docs>
@@ -537,12 +573,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The location of the specified <see cref="T:System.Object" /> within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based location of the specified <see cref="T:System.Object" /> that is a <see cref="T:System.Data.OleDb.OleDbParameterCollection" /> within the collection.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to find.</param>
       </Docs>
@@ -561,12 +600,15 @@
         <Parameter Name="parameterName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the location of the specified <see cref="T:System.Data.OleDb.OleDbParameter" /> with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based location of the specified <see cref="T:System.Data.OleDb.OleDbParameter" /> with the specified case-sensitive name.</para>
+        </returns>
         <param name="parameterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The case-sensitive name of the <see cref="T:System.Data.OleDb.OleDbParameter" /> to find.</param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbPermission.xml b/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbPermission.xml
index 072efb8890b..7fbbebaa4a0 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbPermission.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbPermission.xml
@@ -108,12 +108,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Security.IPermission'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Data.OleDb.OleDbPermission" /> as an <see cref="T:System.Security.IPermission" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current permission object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbPermissionAttribute.xml b/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbPermissionAttribute.xml
index 41e040c0f02..4c53638e1d1 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbPermissionAttribute.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbPermissionAttribute.xml
@@ -42,6 +42,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of the <see cref="T:System.Data.OleDb.OleDbPermissionAttribute" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Data.OleDb.OleDbPermissionAttribute" /> object.</para>
+        </returns>
         <param name="action">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Security.Permissions.SecurityAction" /> values representing an action that can be performed by using declarative security. </param>
       </Docs>
@@ -58,12 +62,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Security.IPermission'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Data.OleDb.OleDbPermission" /> object that is configured according to the attribute properties.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Data.OleDb.OleDbPermission" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbTransaction.xml b/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbTransaction.xml
index 7b97bfdbecf..7acbf8c1a1a 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbTransaction.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.OleDb/OleDbTransaction.xml
@@ -33,7 +33,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'OleDbTransaction'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The new transaction is nested within the current transaction.</para>
@@ -42,6 +41,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initiates a nested database transaction.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A nested database transaction.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -58,7 +61,6 @@
         <Parameter Name="isolevel" Type="System.Data.IsolationLevel" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'OleDbTransaction'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The new transaction is nested within the current transaction.</para>
@@ -67,6 +69,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initiates a nested database transaction and specifies the isolation level to use for the new transaction.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A nested database transaction.</para>
+        </returns>
         <param name="isolevel">
           <attribution license="cc4" from="Microsoft" modified="false" />The isolation level to use for the transaction. </param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.Sql/SqlDataSourceEnumerator.xml b/mcs/class/System.Data/Documentation/en/System.Data.Sql/SqlDataSourceEnumerator.xml
index 6c171782c70..b309b8aacc3 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.Sql/SqlDataSourceEnumerator.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.Sql/SqlDataSourceEnumerator.xml
@@ -29,7 +29,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -86,6 +85,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a <see cref="T:System.Data.DataTable" /> containing information about all visible SQL Server 2000 or SQL Server 2005 instances.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a <see cref="T:System.Data.DataTable" /> containing information about the visible SQL Server instances.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlBulkCopyColumnMappingCollection.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlBulkCopyColumnMappingCollection.xml
index 47ace46e056..60d4fbd0b42 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlBulkCopyColumnMappingCollection.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlBulkCopyColumnMappingCollection.xml
@@ -36,12 +36,15 @@
         <Parameter Name="bulkCopyColumnMapping" Type="System.Data.SqlClient.SqlBulkCopyColumnMapping" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified mapping to the <see cref="T:System.Data.SqlClient.SqlBulkCopyColumnMappingCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlClient.SqlBulkCopyColumnMapping" /> object.</para>
+        </returns>
         <param name="bulkCopyColumnMapping">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlClient.SqlBulkCopyColumnMapping" /> object that describes the mapping to be added to the collection.</param>
       </Docs>
@@ -60,7 +63,6 @@
         <Parameter Name="destinationColumnIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Mappings in a collection must be uniform: either all integer/integer pairs, all string/string pairs, all integer/string pairs, or all string/integer pairs. If you try to add a mapping that is different from others already in the collection, an <see cref="T:System.InvalidOperationException" /> is thrown.</para>
@@ -69,6 +71,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Data.SqlClient.SqlBulkCopyColumnMapping" /> and adds it to the collection, using ordinals to specify both source and destination columns.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A column mapping.</para>
+        </returns>
         <param name="sourceColumnIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The ordinal position of the source column within the data source.</param>
         <param name="destinationColumnIndex">
@@ -89,7 +95,6 @@
         <Parameter Name="destinationColumn" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Mappings in a collection must be uniform: either all integer/integer pairs, all string/string pairs, all integer/string pairs, or all string/integer pairs. If you try to add a mapping that is different from others already in the collection, an <see cref="T:System.InvalidOperationException" /> is thrown.</para>
@@ -98,6 +103,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Data.SqlClient.SqlBulkCopyColumnMapping" /> and adds it to the collection, using an ordinal for the source column and a string for the destination column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A column mapping.</para>
+        </returns>
         <param name="sourceColumnIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The ordinal position of the source column within the data source.</param>
         <param name="destinationColumn">
@@ -118,7 +127,6 @@
         <Parameter Name="destinationColumnIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Mappings in a collection must be uniform: either all integer/integer pairs, all string/string pairs, all integer/string pairs, or all string/integer pairs. If you try to add a mapping that is different from others already in the collection, an <see cref="T:System.InvalidOperationException" /> is thrown.</para>
@@ -127,6 +135,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Data.SqlClient.SqlBulkCopyColumnMapping" /> and adds it to the collection, using a column name to describe the source column and an ordinal to specify the destination column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A column mapping.</para>
+        </returns>
         <param name="sourceColumn">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the source column within the data source.</param>
         <param name="destinationColumnIndex">
@@ -147,7 +159,6 @@
         <Parameter Name="destinationColumn" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Mappings in a collection must be uniform: either all integer/integer pairs, all string/string pairs, all integer/string pairs, or all string/integer pairs. If you try to add a mapping that is different from others already in the collection, an <see cref="T:System.InvalidOperationException" /> is thrown.</para>
@@ -156,6 +167,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Data.SqlClient.SqlBulkCopyColumnMapping" /> and adds it to the collection, using column names to specify both source and destination columns.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A column mapping.</para>
+        </returns>
         <param name="sourceColumn">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the source column within the data source.</param>
         <param name="destinationColumn">
@@ -197,12 +212,15 @@
         <Parameter Name="value" Type="System.Data.SqlClient.SqlBulkCopyColumnMapping" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether a specified <see cref="T:System.Data.SqlClient.SqlBulkCopyColumnMapping" /> object exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified mapping exists in the collection; otherwise false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A valid <see cref="T:System.Data.SqlClient.SqlBulkCopyColumnMapping" /> object. </param>
       </Docs>
@@ -245,12 +263,15 @@
         <Parameter Name="value" Type="System.Data.SqlClient.SqlBulkCopyColumnMapping" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the specified <see cref="T:System.Data.SqlClient.SqlBulkCopyColumnMapping" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the column mapping, or -1 if the column mapping is not found in the collection.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlClient.SqlBulkCopyColumnMapping" /> object for which to search.</param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlClientFactory.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlClientFactory.xml
index 6a16396cd3c..87fb212776c 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlClientFactory.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlClientFactory.xml
@@ -48,13 +48,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a strongly typed <see cref="T:System.Data.Common.DbCommand" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new strongly typed instance of <see cref="T:System.Data.Common.DbCommand" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -68,13 +71,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a strongly typed <see cref="T:System.Data.Common.DbCommandBuilder" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new strongly typed instance of <see cref="T:System.Data.Common.DbCommandBuilder" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -88,13 +94,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a strongly typed <see cref="T:System.Data.Common.DbConnection" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new strongly typed instance of <see cref="T:System.Data.Common.DbConnection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -111,12 +120,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a strongly typed <see cref="T:System.Data.Common.DbConnectionStringBuilder" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new strongly typed instance of <see cref="T:System.Data.Common.DbConnectionStringBuilder" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateDataAdapter">
@@ -127,13 +139,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a strongly typed <see cref="T:System.Data.Common.DbDataAdapter" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new strongly typed instance of <see cref="T:System.Data.Common.DbDataAdapter" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -147,13 +162,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new <see cref="T:System.Data.Sql.SqlDataSourceEnumerator" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new data source enumerator.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -167,13 +185,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a strongly typed <see cref="T:System.Data.Common.DbParameter" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new strongly typed instance of <see cref="T:System.Data.Common.DbParameter" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -192,12 +213,15 @@
         <Parameter Name="state" Type="System.Security.Permissions.PermissionState" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new <see cref="T:System.Security.CodeAccessPermission" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A strongly typed instance of <see cref="T:System.Security.CodeAccessPermission" />.</para>
+        </returns>
         <param name="state">
           <attribution license="cc4" from="Microsoft" modified="false" />A member of the <see cref="T:System.Security.Permissions.PermissionState" /> enumeration.</param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlClientPermission.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlClientPermission.xml
index 944a027ef18..d5347f660ca 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlClientPermission.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlClientPermission.xml
@@ -155,12 +155,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Data.SqlClient.SqlClientPermission" /> as an <see cref="T:System.Security.IPermission" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current permission object.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlClientPermissionAttribute.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlClientPermissionAttribute.xml
index 46a09cb929b..c95772c03b9 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlClientPermissionAttribute.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlClientPermissionAttribute.xml
@@ -39,6 +39,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of the <see cref="T:System.Data.SqlClient.SqlClientPermissionAttribute" /> class. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlClient.SqlClientPermissionAttribute" /> object.</para>
+        </returns>
         <param name="action">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Security.Permissions.SecurityAction" /> values representing an action that can be performed by using declarative security. </param>
       </Docs>
@@ -55,12 +59,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Security.IPermission'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Data.SqlClient.SqlClientPermission" /> object that is configured according to the attribute properties.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlClient.SqlClientPermission" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlCommand.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlCommand.xml
index 56d54d83ae3..b885babb845 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlCommand.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlCommand.xml
@@ -435,7 +435,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.SqlClient.SqlCommand.BeginExecuteNonQuery" /> method starts the process of asynchronously executing a tsql statement or stored procedure that does not return rows, so that other tasks can run concurrently while the statement is executing. When the statement has completed, developers must call the <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteNonQuery(System.IAsyncResult)" /> method to finish the operation. The <see cref="M:System.Data.SqlClient.SqlCommand.BeginExecuteNonQuery" /> method returns immediately (<see cref="P:System.Data.SqlClient.SqlCommand.CommandTimeout" /> has no effect on <see cref="M:System.Data.SqlClient.SqlCommand.BeginExecuteNonQuery" />), but until the code executes the corresponding <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteNonQuery(System.IAsyncResult)" /> method call, it must not execute any other calls that start a synchronous or asynchronous execution against the same <see cref="T:System.Data.SqlClient.SqlCommand" /> object. Calling the <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteNonQuery(System.IAsyncResult)" /> before the command's execution is completed causes the <see cref="T:System.Data.SqlClient.SqlCommand" /> object to block until the execution is finished.</para>
@@ -446,6 +445,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this <see cref="T:System.Data.SqlClient.SqlCommand" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that can be used to poll or wait for results, or both; this value is also needed when invoking <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteNonQuery(System.IAsyncResult)" />, which returns the number of affected rows.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="BeginExecuteNonQuery">
@@ -462,7 +465,6 @@
         <Parameter Name="stateObject" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.SqlClient.SqlCommand.BeginExecuteNonQuery" /> method starts the process of asynchronously executing a Transact-SQL statement or stored procedure that does not return rows, so that other tasks can run concurrently while the statement is executing. When the statement has completed, developers must call the <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteNonQuery(System.IAsyncResult)" /> method to finish the operation. The <see cref="M:System.Data.SqlClient.SqlCommand.BeginExecuteNonQuery" /> method returns immediately (<see cref="P:System.Data.SqlClient.SqlCommand.CommandTimeout" /> has no effect on <see cref="M:System.Data.SqlClient.SqlCommand.BeginExecuteNonQuery(System.AsyncCallback,System.Object)" />), but until the code executes the corresponding <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteNonQuery(System.IAsyncResult)" /> method call, it must not execute any other calls that start a synchronous or asynchronous execution against the same <see cref="T:System.Data.SqlClient.SqlCommand" /> object. Calling the <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteNonQuery(System.IAsyncResult)" /> before the command's execution is completed causes the <see cref="T:System.Data.SqlClient.SqlCommand" /> object to block until the execution is finished.</para>
@@ -475,6 +477,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this <see cref="T:System.Data.SqlClient.SqlCommand" />, given a callback procedure and state information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that can be used to poll or wait for results, or both; this value is also needed when invoking <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteNonQuery(System.IAsyncResult)" />, which returns the number of affected rows.</para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.AsyncCallback" /> delegate that is invoked when the command's execution has completed. Pass null (Nothing in Microsoft Visual Basic) to indicate that no callback is required.</param>
         <param name="stateObject">
@@ -492,7 +498,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.SqlClient.SqlCommand.BeginExecuteReader" /> method starts the process of asynchronously executing a Transact-SQL statement or stored procedure that returns rows, so that other tasks can run concurrently while the statement is executing. When the statement has completed, developers must call the <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteReader(System.IAsyncResult)" /> method to finish the operation and retrieve the <see cref="T:System.Data.SqlClient.SqlDataReader" /> returned by the command. The <see cref="M:System.Data.SqlClient.SqlCommand.BeginExecuteReader" /> method returns immediately, but until the code executes the corresponding <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteReader(System.IAsyncResult)" /> method call, it must not execute any other calls that start a synchronous or asynchronous execution against the same <see cref="T:System.Data.SqlClient.SqlCommand" /> object. Calling the <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteReader(System.IAsyncResult)" /> before the command's execution is completed causes the <see cref="T:System.Data.SqlClient.SqlCommand" /> object to block until the execution is finished.</para>
@@ -504,6 +509,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this <see cref="T:System.Data.SqlClient.SqlCommand" />, and retrieves one or more result sets from the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that can be used to poll or wait for results, or both; this value is also needed when invoking <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteReader(System.IAsyncResult)" />, which returns a <see cref="T:System.Data.SqlClient.SqlDataReader" /> instance that can be used to retrieve the returned rows.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="BeginExecuteReader">
@@ -519,7 +528,6 @@
         <Parameter Name="behavior" Type="System.Data.CommandBehavior" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.SqlClient.SqlCommand.BeginExecuteReader" /> method starts the process of asynchronously executing a Transact-SQL statement or stored procedure that returns rows, so that other tasks can run concurrently while the statement is executing. When the statement has completed, developers must call the <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteReader(System.IAsyncResult)" /> method to finish the operation and retrieve the <see cref="T:System.Data.SqlClient.SqlDataReader" /> returned by the command. The <see cref="M:System.Data.SqlClient.SqlCommand.BeginExecuteReader" /> method returns immediately, but until the code executes the corresponding <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteReader(System.IAsyncResult)" /> method call, it must not execute any other calls that start a synchronous or asynchronous execution against the same <see cref="T:System.Data.SqlClient.SqlCommand" /> object. Calling the <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteReader(System.IAsyncResult)" /> before the command's execution is completed causes the <see cref="T:System.Data.SqlClient.SqlCommand" /> object to block until the execution is finished.</para>
@@ -532,6 +540,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this <see cref="T:System.Data.SqlClient.SqlCommand" /> using one of the <see cref="T:System.Data.CommandBehavior" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that can be used to poll, wait for results, or both; this value is also needed when invoking <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteReader(System.IAsyncResult)" />, which returns a <see cref="T:System.Data.SqlClient.SqlDataReader" /> instance that can be used to retrieve the returned rows.</para>
+        </returns>
         <param name="behavior">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Data.CommandBehavior" /> values, indicating options for statement execution and data retrieval.</param>
       </Docs>
@@ -550,7 +562,6 @@
         <Parameter Name="stateObject" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.SqlClient.SqlCommand.BeginExecuteReader" /> method starts the process of asynchronously executing a Transact-SQL statement or stored procedure that returns rows, so that other tasks can run concurrently while the statement is executing. When the statement has completed, developers must call the <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteReader(System.IAsyncResult)" /> method to finish the operation and retrieve the <see cref="T:System.Data.SqlClient.SqlDataReader" /> returned by the command. The <see cref="M:System.Data.SqlClient.SqlCommand.BeginExecuteReader" /> method returns immediately, but until the code executes the corresponding <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteReader(System.IAsyncResult)" /> method call, it must not execute any other calls that start a synchronous or asynchronous execution against the same <see cref="T:System.Data.SqlClient.SqlCommand" /> object. Calling the <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteReader(System.IAsyncResult)" /> before the command's execution is completed cause the <see cref="T:System.Data.SqlClient.SqlCommand" /> object to block until the execution is finished.</para>
@@ -564,6 +575,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this <see cref="T:System.Data.SqlClient.SqlCommand" /> and retrieves one or more result sets from the server, given a callback procedure and state information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that can be used to poll, wait for results, or both; this value is also needed when invoking <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteReader(System.IAsyncResult)" />, which returns a <see cref="T:System.Data.SqlClient.SqlDataReader" /> instance which can be used to retrieve the returned rows.</para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.AsyncCallback" /> delegate that is invoked when the command's execution has completed. Pass null (Nothing in Microsoft Visual Basic) to indicate that no callback is required.</param>
         <param name="stateObject">
@@ -585,7 +600,6 @@
         <Parameter Name="behavior" Type="System.Data.CommandBehavior" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.SqlClient.SqlCommand.BeginExecuteReader" /> method starts the process of asynchronously executing a Transact-SQL statement or stored procedure that returns rows, so that other tasks can run concurrently while the statement is executing. When the statement has completed, developers must call the <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteReader(System.IAsyncResult)" /> method to finish the operation and retrieve the <see cref="T:System.Data.SqlClient.SqlDataReader" /> returned by the command. The <see cref="M:System.Data.SqlClient.SqlCommand.BeginExecuteReader" /> method returns immediately, but until the code executes the corresponding <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteReader(System.IAsyncResult)" /> method call, it must not execute any other calls that start a synchronous or asynchronous execution against the same <see cref="T:System.Data.SqlClient.SqlCommand" /> object. Calling the <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteReader(System.IAsyncResult)" /> before the command's execution is completed causes the <see cref="T:System.Data.SqlClient.SqlCommand" /> object to block until the execution is finished.</para>
@@ -600,6 +614,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this <see cref="T:System.Data.SqlClient.SqlCommand" />, using one of the CommandBehavior values, and retrieving one or more result sets from the server, given a callback procedure and state information. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that can be used to poll or wait for results, or both; this value is also needed when invoking <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteReader(System.IAsyncResult)" />, which returns a <see cref="T:System.Data.SqlClient.SqlDataReader" /> instance which can be used to retrieve the returned rows.</para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.AsyncCallback" /> delegate that is invoked when the command's execution has completed. Pass null (Nothing in Microsoft Visual Basic) to indicate that no callback is required.</param>
         <param name="stateObject">
@@ -619,7 +637,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.SqlClient.SqlCommand.BeginExecuteXmlReader" /> method starts the process of asynchronously executing a Transact-SQL statement that returns rows as XML, so that other tasks can run concurrently while the statement is executing. When the statement has completed, developers must call the EndExecuteXmlReader method to finish the operation and retrieve the XML returned by the command. The <see cref="M:System.Data.SqlClient.SqlCommand.BeginExecuteXmlReader" /> method returns immediately, but until the code executes the corresponding EndExecuteXmlReader method call, it must not execute any other calls that start a synchronous or asynchronous execution against the same <see cref="T:System.Data.SqlClient.SqlCommand" /> object. Calling the EndExecuteXmlReader before the command's execution is completed causes the <see cref="T:System.Data.SqlClient.SqlCommand" /> object to block until the execution is finished.</para>
@@ -636,6 +653,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this <see cref="T:System.Data.SqlClient.SqlCommand" /> and returns results as an <see cref="T:System.Xml.XmlReader" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that can be used to poll or wait for results, or both; this value is also needed when invoking EndExecuteXmlReader, which returns a single XML value.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="BeginExecuteXmlReader">
@@ -652,7 +673,6 @@
         <Parameter Name="stateObject" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.SqlClient.SqlCommand.BeginExecuteXmlReader" /> method starts the process of asynchronously executing a Transact-SQL statement or stored procedure that returns rows as XML, so that other tasks can run concurrently while the statement is executing. When the statement has completed, developers must call the <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteXmlReader(System.IAsyncResult)" /> method to finish the operation and retrieve the requested XML data. The <see cref="M:System.Data.SqlClient.SqlCommand.BeginExecuteXmlReader" /> method returns immediately, but until the code executes the corresponding <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteXmlReader(System.IAsyncResult)" /> method call, it must not execute any other calls that start a synchronous or asynchronous execution against the same <see cref="T:System.Data.SqlClient.SqlCommand" /> object. Calling the <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteXmlReader(System.IAsyncResult)" /> before the command's execution is completed causes the <see cref="T:System.Data.SqlClient.SqlCommand" /> object to block until the execution is finished.</para>
@@ -670,6 +690,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initiates the asynchronous execution of the Transact-SQL statement or stored procedure that is described by this <see cref="T:System.Data.SqlClient.SqlCommand" /> and returns results as an <see cref="T:System.Xml.XmlReader" /> object, using a callback procedure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that can be used to poll, wait for results, or both; this value is also needed when the <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteXmlReader(System.IAsyncResult)" /> is called, which returns the results of the command as XML.</para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.AsyncCallback" /> delegate that is invoked when the command's execution has completed. Pass null (Nothing in Microsoft Visual Basic) to indicate that no callback is required.</param>
         <param name="stateObject">
@@ -710,12 +734,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Data.SqlClient.SqlCommand" /> object that is a copy of the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlClient.SqlCommand" /> object that is a copy of this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CommandText">
@@ -905,7 +932,6 @@ public class A {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlParameter'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.SqlClient.SqlCommand.CreateParameter" /> method is a strongly-typed version of <see cref="M:System.Data.IDbCommand.CreateParameter" />.</para>
@@ -914,6 +940,10 @@ public class A {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of a <see cref="T:System.Data.SqlClient.SqlParameter" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlClient.SqlParameter" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1031,7 +1061,6 @@ public class A {
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When you call <see cref="Overload:System.Data.SqlClient.SqlCommand.BeginExecuteNonQuery" /> to execute a tsql statement, you must call <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteNonQuery(System.IAsyncResult)" /> in order to complete the operation. If the process of executing the command has not yet finished, this method blocks until the operation is complete. Users can verify that the command has completed its operation by using the <see cref="T:System.IAsyncResult" /> instance returned by the <see cref="M:System.Data.SqlClient.SqlCommand.BeginExecuteNonQuery" /> method. If a callback procedure was specified in the call to <see cref="M:System.Data.SqlClient.SqlCommand.BeginExecuteNonQuery" />, this method must be called.</para>
@@ -1040,6 +1069,10 @@ public class A {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finishes asynchronous execution of a Transact-SQL statement.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows affected (the same behavior as <see cref="M:System.Data.SqlClient.SqlCommand.ExecuteNonQuery" />).</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IAsyncResult" /> returned by the call to <see cref="M:System.Data.SqlClient.SqlCommand.BeginExecuteNonQuery" />.</param>
       </Docs>
@@ -1057,7 +1090,6 @@ public class A {
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When you call <see cref="Overload:System.Data.SqlClient.SqlCommand.BeginExecuteReader" /> to execute a Transact-SQL statement, you must call <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteReader(System.IAsyncResult)" /> in order to complete the operation. If the process of executing the command has not yet finished, this method blocks until the operation is complete. Users can verify that the command has completed its operation by using the <see cref="T:System.IAsyncResult" /> instance returned by the <see cref="M:System.Data.SqlClient.SqlCommand.BeginExecuteReader" /> method. If a callback procedure was specified in the call to <see cref="M:System.Data.SqlClient.SqlCommand.BeginExecuteReader" />, this method must be called.</para>
@@ -1066,6 +1098,10 @@ public class A {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finishes asynchronous execution of a Transact-SQL statement, returning the requested <see cref="T:System.Data.SqlClient.SqlDataReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlClient.SqlDataReader" /> object that can be used to retrieve the requested rows.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IAsyncResult" /> returned by the call to <see cref="M:System.Data.SqlClient.SqlCommand.BeginExecuteReader" />.</param>
       </Docs>
@@ -1083,7 +1119,6 @@ public class A {
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When you call <see cref="Overload:System.Data.SqlClient.SqlCommand.BeginExecuteXmlReader" /> to execute a Transact-SQL statement, you must call <see cref="M:System.Data.SqlClient.SqlCommand.EndExecuteXmlReader(System.IAsyncResult)" /> in order to complete the operation. If the process of executing the command has not yet finished, this method blocks until the operation is complete. Users can verify that the command has completed its operation by using the <see cref="T:System.IAsyncResult" /> instance returned by the <see cref="M:System.Data.SqlClient.SqlCommand.BeginExecuteXmlReader" /> method. If a callback procedure was specified in the call to <see cref="M:System.Data.SqlClient.SqlCommand.BeginExecuteXmlReader" />, this method must be called.</para>
@@ -1092,6 +1127,10 @@ public class A {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finishes asynchronous execution of a Transact-SQL statement, returning the requested data as XML.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlReader" /> object that can be used to fetch the resulting XML data.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IAsyncResult" /> returned by the call to <see cref="M:System.Data.SqlClient.SqlCommand.BeginExecuteXmlReader" />.</param>
       </Docs>
@@ -1123,7 +1162,6 @@ public class A {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>The number of rows that were affected by the query.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the <see cref="M:System.Data.SqlClient.SqlCommand.ExecuteNonQuery" /> to perform catalog operations (for example, querying the structure of a database or creating database objects such as tables), or to change the data in a database without using a <see cref="T:System.Data.DataSet" /> by executing UPDATE, INSERT, or DELETE statements.</para>
@@ -1134,6 +1172,10 @@ public class A {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a Transact-SQL statement against the connection and returns the number of rows affected.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows affected.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1148,7 +1190,6 @@ public class A {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlDataReader'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When the <see cref="P:System.Data.SqlClient.SqlCommand.CommandType" /> property is set to StoredProcedure, the <see cref="P:System.Data.SqlClient.SqlCommand.CommandText" /> property should be set to the name of the stored procedure. The command executes this stored procedure when you call <see cref="M:System.Data.SqlClient.SqlCommand.ExecuteReader" />.</para>
@@ -1162,6 +1203,10 @@ public class A {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends the <see cref="P:System.Data.SqlClient.SqlCommand.CommandText" /> to the <see cref="P:System.Data.SqlClient.SqlCommand.Connection" /> and builds a <see cref="T:System.Data.SqlClient.SqlDataReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlClient.SqlDataReader" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1178,7 +1223,6 @@ public class A {
         <Parameter Name="behavior" Type="System.Data.CommandBehavior" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlDataReader'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When the <see cref="P:System.Data.SqlClient.SqlCommand.CommandType" /> property is set to StoredProcedure, the <see cref="P:System.Data.SqlClient.SqlCommand.CommandText" /> property should be set to the name of the stored procedure. The command executes this stored procedure when you call <see cref="M:System.Data.SqlClient.SqlCommand.ExecuteReader" />.</para>
@@ -1192,6 +1236,10 @@ public class A {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends the <see cref="P:System.Data.SqlClient.SqlCommand.CommandText" /> to the <see cref="P:System.Data.SqlClient.SqlCommand.Connection" />, and builds a <see cref="T:System.Data.SqlClient.SqlDataReader" /> using one of the <see cref="T:System.Data.CommandBehavior" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlClient.SqlDataReader" /> object.</para>
+        </returns>
         <param name="behavior">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Data.CommandBehavior" /> values.</param>
       </Docs>
@@ -1208,7 +1256,6 @@ public class A {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Data.SqlClient.SqlCommand.ExecuteScalar" /> method to retrieve a single value (for example, an aggregate value) from a database. This requires less code than using the <see cref="M:System.Data.SqlClient.SqlCommand.ExecuteReader" /> method, and then performing the operations that you need to generate the single value using the data returned by a <see cref="T:System.Data.SqlClient.SqlDataReader" />.</para>
@@ -1220,6 +1267,10 @@ public class A {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the query, and returns the first column of the first row in the result set returned by the query. Additional columns or rows are ignored.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first column of the first row in the result set, or a null reference (Nothing in Visual Basic) if the result set is empty. Returns a maximum of 2033 characters.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1234,7 +1285,6 @@ public class A {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Xml.XmlReader'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Data.SqlClient.SqlCommand.CommandText" /> property ordinarily specifies a tsql statement with a valid FOR XML clause. However, <see cref="P:System.Data.SqlClient.SqlCommand.CommandText" /> can also specify a statement that returns ntext or nvarchar data that contains valid XML, or the contents of a column defined with the xml data type. </para>
@@ -1248,6 +1298,10 @@ public class A {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends the <see cref="P:System.Data.SqlClient.SqlCommand.CommandText" /> to the <see cref="P:System.Data.SqlClient.SqlCommand.Connection" /> and builds an <see cref="T:System.Xml.XmlReader" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlReader" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1440,12 +1494,15 @@ public class A {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of a <see cref="T:System.Data.SqlClient.SqlParameter" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlClient.SqlParameter" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Data.IDbCommand.ExecuteReader">
@@ -1459,12 +1516,15 @@ public class A {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends the <see cref="P:System.Data.SqlClient.SqlCommand.CommandText" /> to the <see cref="P:System.Data.SqlClient.SqlCommand.Connection" />, and builds a <see cref="T:System.Data.SqlClient.SqlDataReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlClient.SqlDataReader" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Data.IDbCommand.ExecuteReader">
@@ -1480,12 +1540,15 @@ public class A {
         <Parameter Name="behavior" Type="System.Data.CommandBehavior" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends the <see cref="P:System.Data.SqlClient.SqlCommand.CommandText" /> to the <see cref="P:System.Data.SqlClient.SqlCommand.Connection" />, and builds a <see cref="T:System.Data.SqlClient.SqlDataReader" /> using one of the <see cref="T:System.Data.CommandBehavior" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlClient.SqlDataReader" /> object.</para>
+        </returns>
         <param name="behavior">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Data.CommandBehavior" /> values. </param>
       </Docs>
@@ -1537,12 +1600,15 @@ public class A {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Data.SqlClient.SqlCommand" /> object that is a copy of the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlClient.SqlCommand" /> object that is a copy of this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Transaction">
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlCommandBuilder.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlCommandBuilder.xml
index 908e0ff65b2..0755e096d47 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlCommandBuilder.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlCommandBuilder.xml
@@ -239,7 +239,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlCommand'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An application can use the <see cref="M:System.Data.SqlClient.SqlCommandBuilder.GetDeleteCommand" /> method for informational or troubleshooting purposes because it returns the <see cref="T:System.Data.SqlClient.SqlCommand" /> object to be executed.</para>
@@ -251,6 +250,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the automatically generated <see cref="T:System.Data.SqlClient.SqlCommand" /> object required to perform deletions on the database.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The automatically generated <see cref="T:System.Data.SqlClient.SqlCommand" /> object required to perform deletions.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -270,7 +273,6 @@
         <Parameter Name="useColumnsForParameterNames" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An application can use the <see cref="M:System.Data.SqlClient.SqlCommandBuilder.GetDeleteCommand" /> method for informational or troubleshooting purposes because it returns the <see cref="T:System.Data.SqlClient.SqlCommand" /> object to be executed.</para>
@@ -294,6 +296,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the automatically generated <see cref="T:System.Data.SqlClient.SqlCommand" /> object that is required to perform deletions on the database.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The automatically generated <see cref="T:System.Data.SqlClient.SqlCommand" /> object that is required to perform deletions.</para>
+        </returns>
         <param name="useColumnsForParameterNames">
           <attribution license="cc4" from="Microsoft" modified="false" />If true, generate parameter names matching column names if possible. If false, generate @p1, @p2, and so on.</param>
       </Docs>
@@ -306,7 +312,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlCommand'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An application can use the <see cref="M:System.Data.SqlClient.SqlCommandBuilder.GetInsertCommand" /> method for informational or troubleshooting purposes because it returns the <see cref="T:System.Data.SqlClient.SqlCommand" /> object to be executed.</para>
@@ -318,6 +323,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the automatically generated <see cref="T:System.Data.SqlClient.SqlCommand" /> object required to perform insertions on the database.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The automatically generated <see cref="T:System.Data.SqlClient.SqlCommand" /> object required to perform insertions.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -337,7 +346,6 @@
         <Parameter Name="useColumnsForParameterNames" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An application can use the <see cref="M:System.Data.SqlClient.SqlCommandBuilder.GetInsertCommand" /> method for informational or troubleshooting purposes because it returns the <see cref="T:System.Data.SqlClient.SqlCommand" /> object to be executed.</para>
@@ -361,6 +369,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the automatically generated <see cref="T:System.Data.SqlClient.SqlCommand" /> object that is required to perform insertions on the database.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The automatically generated <see cref="T:System.Data.SqlClient.SqlCommand" /> object that is required to perform insertions.</para>
+        </returns>
         <param name="useColumnsForParameterNames">
           <attribution license="cc4" from="Microsoft" modified="false" />If true, generate parameter names matching column names if possible. If false, generate @p1, @p2, and so on.</param>
       </Docs>
@@ -449,7 +461,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlCommand'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An application can use the <see cref="M:System.Data.SqlClient.SqlCommandBuilder.GetUpdateCommand" /> method for informational or troubleshooting purposes because it returns the <see cref="T:System.Data.SqlClient.SqlCommand" /> object to be executed.</para>
@@ -461,6 +472,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the automatically generated <see cref="T:System.Data.SqlClient.SqlCommand" /> object required to perform updates on the database.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The automatically generated <see cref="T:System.Data.SqlClient.SqlCommand" /> object that is required to perform updates.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -480,7 +495,6 @@
         <Parameter Name="useColumnsForParameterNames" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An application can use the <see cref="M:System.Data.SqlClient.SqlCommandBuilder.GetUpdateCommand" /> method for informational or troubleshooting purposes because it returns the <see cref="T:System.Data.SqlClient.SqlCommand" /> object to be executed.</para>
@@ -504,6 +518,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the automatically generated <see cref="T:System.Data.SqlClient.SqlCommand" /> object required to perform updates on the database.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The automatically generated <see cref="T:System.Data.SqlClient.SqlCommand" /> object required to perform updates.</para>
+        </returns>
         <param name="useColumnsForParameterNames">
           <attribution license="cc4" from="Microsoft" modified="false" />If true, generate parameter names matching column names if possible. If false, generate @p1, @p2, and so on.</param>
       </Docs>
@@ -540,12 +558,15 @@
         <Parameter Name="unquotedIdentifier" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Given an unquoted identifier in the correct catalog case, returns the correct quoted form of that identifier. This includes correctly escaping any embedded quotes in the identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The quoted version of the identifier. Embedded quotes within the identifier are correctly escaped.</para>
+        </returns>
         <param name="unquotedIdentifier">
           <attribution license="cc4" from="Microsoft" modified="false" />The original unquoted identifier.</param>
       </Docs>
@@ -705,12 +726,15 @@
         <Parameter Name="quotedIdentifier" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Given a quoted identifier, returns the correct unquoted form of that identifier. This includes correctly unescaping any embedded quotes in the identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The unquoted identifier, with embedded quotes properly unescaped.</para>
+        </returns>
         <param name="quotedIdentifier">
           <attribution license="cc4" from="Microsoft" modified="false" />The identifier that will have its embedded quotes removed.</param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlConnection.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlConnection.xml
index b8235fcf107..d80af96efc1 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlConnection.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlConnection.xml
@@ -229,7 +229,6 @@ End Using
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>A new instance of the <see cref="T:System.Data.SqlClient.SqlTransaction" /> class that references the current <see cref="T:System.Data.SqlClient.SqlConnection" /> instance.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This command maps to the ssNoVersion implementation of BEGIN TRANSACTION.</para>
@@ -249,6 +248,10 @@ End Using
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Starts a database transaction.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the new transaction.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -265,7 +268,6 @@ End Using
         <Parameter Name="iso" Type="System.Data.IsolationLevel" />
       </Parameters>
       <Docs>
-        <returns>A new instance of the <see cref="T:System.Data.SqlClient.SqlTransaction" /> class that references the current <see cref="T:System.Data.SqlClient.SqlConnection" /> instance.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This command maps to the ssNoVersion implementation of BEGIN TRANSACTION.</para>
@@ -282,6 +284,10 @@ End Using
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Starts a database transaction with the specified isolation level.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the new transaction.</para>
+        </returns>
         <param name="iso">
           <attribution license="cc4" from="Microsoft" modified="false" />The isolation level under which the transaction should run. </param>
       </Docs>
@@ -300,7 +306,6 @@ End Using
         <Parameter Name="transactionName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>A new instance of the <see cref="T:System.Data.SqlClient.SqlTransaction" /> class that references the current <see cref="T:System.Data.SqlClient.SqlConnection" /> instance.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This command maps to the ssNoVersion implementation of BEGIN TRANSACTION.</para>
@@ -316,6 +321,10 @@ End Using
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Starts a database transaction with the specified transaction name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the new transaction.</para>
+        </returns>
         <param name="transactionName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the transaction. </param>
       </Docs>
@@ -335,7 +344,6 @@ End Using
         <Parameter Name="transactionName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>A new instance of the <see cref="T:System.Data.SqlClient.SqlTransaction" /> class that references the current <see cref="T:System.Data.SqlClient.SqlConnection" /> instance.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This command maps to the ssNoVersion implementation of BEGIN TRANSACTION.</para>
@@ -353,6 +361,10 @@ End Using
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Starts a database transaction with the specified isolation level and transaction name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the new transaction.</para>
+        </returns>
         <param name="iso">
           <attribution license="cc4" from="Microsoft" modified="false" />The isolation level under which the transaction should run. </param>
         <param name="transactionName">
@@ -1152,7 +1164,6 @@ End Using
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>A new instance of the <see cref="T:System.Data.SqlClient.SqlCommand" /> class.</returns>
         <remarks>
           <para>Creates a new instance of the <see cref="T:System.Data.SqlClient.SqlCommand" /> class with the connection referencing the current <see cref="T:System.Data.SqlClient.SqlCommand" /> instance.</para>
           <para>The returned <see cref="T:System.Data.SqlClient.SqlCommand" /> instance can be used to execute T-SQL statements or stored procedures against the current database connection.</para>
@@ -1161,6 +1172,10 @@ End Using
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a <see cref="T:System.Data.SqlClient.SqlCommand" /> object associated with the <see cref="T:System.Data.SqlClient.SqlConnection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlClient.SqlCommand" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1332,12 +1347,15 @@ Disposing this class will close the current connection, if one is active.
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns schema information for the data source of this <see cref="T:System.Data.SqlClient.SqlConnection" />. For more information about scheme, see <see cref="http://msdn.microsoft.com/library/ms254969.aspx">SQL Server Schema Collections</see>.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataTable" /> that contains schema information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetSchema">
@@ -1353,12 +1371,15 @@ Disposing this class will close the current connection, if one is active.
         <Parameter Name="collectionName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns schema information for the data source of this <see cref="T:System.Data.SqlClient.SqlConnection" /> using the specified string for the schema name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataTable" /> that contains schema information. </para>
+        </returns>
         <param name="collectionName">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies the name of the schema to return.</param>
       </Docs>
@@ -1377,7 +1398,6 @@ Disposing this class will close the current connection, if one is active.
         <Parameter Name="restrictionValues" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="restrictionValues" /> parameter can supply n depth of values, which are specified by the restrictions collection for a specific collection. In order to set values on a given restriction, and not set the values of other restrictions, you need to set the preceding restrictions to null and then put the appropriate value in for the restriction that you would like to specify a value for.</para>
@@ -1387,6 +1407,10 @@ Disposing this class will close the current connection, if one is active.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns schema information for the data source of this <see cref="T:System.Data.SqlClient.SqlConnection" /> using the specified string for the schema name and the specified string array for the restriction values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataTable" /> that contains schema information. </para>
+        </returns>
         <param name="collectionName">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies the name of the schema to return.</param>
         <param name="restrictionValues">
@@ -1600,7 +1624,6 @@ Disposing this class will close the current connection, if one is active.
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Once the transaction has completed, you must explicitly commit or roll back the transaction by using the <see cref="M:System.Data.IDbTransaction.Commit" /> or <see cref="M:System.Data.IDbTransaction.Rollback" /> method.</para>
@@ -1609,6 +1632,10 @@ Disposing this class will close the current connection, if one is active.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins a database transaction.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the new transaction.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Data.IDbConnection.BeginTransaction">
@@ -1624,7 +1651,6 @@ Disposing this class will close the current connection, if one is active.
         <Parameter Name="iso" Type="System.Data.IsolationLevel" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Once the transaction has completed, you must explicitly commit or roll back the transaction by using the <see cref="M:System.Data.IDbTransaction.Commit" /> or <see cref="M:System.Data.IDbTransaction.Rollback" /> method.</para>
@@ -1633,6 +1659,10 @@ Disposing this class will close the current connection, if one is active.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins a database transaction with the specified <see cref="T:System.Data.IsolationLevel" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the new transaction.</para>
+        </returns>
         <param name="iso">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Data.IsolationLevel" /> values. </param>
       </Docs>
@@ -1648,12 +1678,15 @@ Disposing this class will close the current connection, if one is active.
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a Command object that is associated with the connection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Command object that is associated with the connection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ICloneable.Clone">
@@ -1668,7 +1701,6 @@ Disposing this class will close the current connection, if one is active.
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.SqlClient.SqlConnection" /> instance is cast to an <see cref="T:System.ICloneable" /> interface.</para>
@@ -1678,6 +1710,10 @@ Disposing this class will close the current connection, if one is active.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new object that is a copy of the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new object that is a copy of this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="WorkstationId">
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlConnectionStringBuilder.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlConnectionStringBuilder.xml
index 1be09608b48..210bc1251b7 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlConnectionStringBuilder.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlConnectionStringBuilder.xml
@@ -276,7 +276,6 @@ Integrated Security=True</code>
         <Parameter Name="keyword" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -286,6 +285,10 @@ Integrated Security=True</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Data.SqlClient.SqlConnectionStringBuilder" /> contains a specific key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Data.SqlClient.SqlConnectionStringBuilder" /> contains an element that has the specified key; otherwise, false.</para>
+        </returns>
         <param name="keyword">
           <attribution license="cc4" from="Microsoft" modified="false" />The key to locate in the <see cref="T:System.Data.SqlClient.SqlConnectionStringBuilder" />.</param>
       </Docs>
@@ -891,7 +894,6 @@ Integrated Security=True</code>
         <Parameter Name="keyword" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1122,6 +1124,10 @@ Integrated Security=True</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the entry with the specified key from the <see cref="T:System.Data.SqlClient.SqlConnectionStringBuilder" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key existed within the connection string and was removed; false if the key did not exist.</para>
+        </returns>
         <param name="keyword">
           <attribution license="cc4" from="Microsoft" modified="false" />The key of the key/value pair to be removed from the connection string in this <see cref="T:System.Data.SqlClient.SqlConnectionStringBuilder" />.</param>
       </Docs>
@@ -1169,7 +1175,6 @@ Integrated Security=True</code>
         <Parameter Name="keyword" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1179,6 +1184,10 @@ Integrated Security=True</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified key exists in this <see cref="T:System.Data.SqlClient.SqlConnectionStringBuilder" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Data.SqlClient.SqlConnectionStringBuilder" /> contains an entry with the specified key; otherwise, false.</para>
+        </returns>
         <param name="keyword">
           <attribution license="cc4" from="Microsoft" modified="false" />The key to locate in the <see cref="T:System.Data.SqlClient.SqlConnectionStringBuilder" />.</param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlDataAdapter.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlDataAdapter.xml
index ea08d3f66b1..572e48be713 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlDataAdapter.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlDataAdapter.xml
@@ -778,7 +778,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.SqlClient.SqlDataAdapter" /> instance is cast to an <see cref="T:System.ICloneable" /> interface.</para>
@@ -787,6 +786,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ICloneable.Clone" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new object that is a copy of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TerminateBatching">
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlDataReader.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlDataReader.xml
index e2c97de4e64..3d6b0f149f2 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlDataReader.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlDataReader.xml
@@ -131,7 +131,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore, the data retrieved must already be a Boolean, or an exception is generated.</para>
@@ -141,6 +140,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a Boolean.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -159,7 +162,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore, the data retrieved must already be a byte.</para>
@@ -169,6 +171,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a byte.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column as a byte.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -191,7 +197,6 @@
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -203,6 +208,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a stream of bytes from the specified column offset into the buffer an array starting at the given buffer offset.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of bytes read.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
         <param name="dataIndex">
@@ -229,7 +238,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'char'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Not supported for <see cref="N:System.Data.SqlClient" />. </para>
@@ -238,6 +246,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a single character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -265,7 +277,6 @@
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -280,6 +291,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a stream of characters from the specified column offset into the buffer as an array starting at the given buffer offset.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of characters read.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
         <param name="dataIndex">
@@ -306,12 +321,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Data.IDataReader'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Data.IDataReader" /> for the specified column ordinal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Data.IDataReader" /> instance for the specified column ordinal.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />A column ordinal.</param>
       </Docs>
@@ -334,7 +352,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the back-end data type.</para>
@@ -344,6 +361,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a string representing the data type of the specified column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representing the data type of the specified column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based ordinal position of the column to find.</param>
       </Docs>
@@ -362,7 +383,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DateTime'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore, the data retrieved must already be a <see cref="T:System.DateTime" /> object.</para>
@@ -372,6 +392,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a <see cref="T:System.DateTime" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -390,7 +414,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'decimal'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore, the data retrieved must already be a <see cref="T:System.Decimal" /> object.</para>
@@ -400,6 +423,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a <see cref="T:System.Decimal" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -418,7 +445,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'double'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed. Therefore, the data retrieved must already be a double-precision floating point number.</para>
@@ -428,6 +454,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a double-precision floating point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -447,7 +477,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Although you can use this method to retrieve an explicit enumerator, in languages that support a foreach construct, it is simpler to use the looping construct directly in order to iterate through the rows in the data reader.</para>
@@ -456,6 +485,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IEnumerator" /> that iterates through the <see cref="T:System.Data.SqlClient.SqlDataReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.Data.SqlClient.SqlDataReader" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetFieldType">
@@ -468,12 +501,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Type'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Type" /> that is the data type of the object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> that is the data type of the object. If the type does not exist on the client, in the case of a User-Defined Type (UDT) returned from the database, GetFieldType returns null.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -492,7 +528,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'float'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed. Therefore, the data retrieved must already be a single-precision floating point number.</para>
@@ -502,6 +537,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a single-precision floating point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -520,7 +559,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Guid'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore, the data retrieved must already be a GUID.</para>
@@ -530,6 +568,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a globally unique identifier (GUID).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -548,7 +590,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'short'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore, the data retrieved must already be a 16-bit signed integer.</para>
@@ -558,6 +599,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a 16-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -576,7 +621,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore, the data retrieved must already be a 32-bit signed integer.</para>
@@ -586,6 +630,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -604,7 +652,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore, the data retrieved must already be a 64-bit signed integer.</para>
@@ -614,6 +661,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -632,12 +683,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the name of the specified column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the specified column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -656,7 +710,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>GetOrdinal performs a case-sensitive lookup first. If it fails, a second, case-insensitive search occurs (a case-insensitive comparison is done using the database collation). Unexpected results can occur when comparisons are affected by culture-specific casing rules. For example, in Turkish, the following example yields the wrong results because the file system in Turkish does not use linguistic casing rules for the letter 'i' in "file". The method throws an IndexOutOfRange exception if the zero-based column ordinal is not found.</para>
@@ -667,6 +720,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the column ordinal, given the name of the column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based column ordinal.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the column. </param>
       </Docs>
@@ -688,12 +745,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an Object that is a representation of the underlying provider-specific field type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Gets an <see cref="T:System.Object" /> that is a representation of the underlying provider-specific field type.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Int32" /> representing the column ordinal. </param>
       </Docs>
@@ -711,12 +771,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an Object that is a representation of the underlying provider specific value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that is a representation of the underlying provider specific value.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Int32" /> representing the column ordinal. </param>
       </Docs>
@@ -734,12 +797,15 @@
         <Parameter Name="values" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of objects that are a representation of the underlying provider specific values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The array of objects that are a representation of the underlying provider specific values.</para>
+        </returns>
         <param name="values">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Object" /> into which to copy the column values.</param>
       </Docs>
@@ -752,7 +818,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Data.DataTable'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For the <see cref="M:System.Data.SqlClient.SqlDataReader.GetSchemaTable" /> method returns metadata about each column in the following order: </para>
@@ -1026,6 +1091,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Data.DataTable" /> that describes the column metadata of the <see cref="T:System.Data.SqlClient.SqlDataReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataTable" /> that describes the column metadata.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1042,7 +1111,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Data.SqlTypes.SqlBinary'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore the data retrieved must already be a binary structure or an exception is generated.</para>
@@ -1051,6 +1119,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a <see cref="T:System.Data.SqlTypes.SqlBinary" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the column expressed as a <see cref="T:System.Data.SqlTypes.SqlBinary" />.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -1069,7 +1141,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Data.SqlTypes.SqlBoolean'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore, the data retrieved must already be a Boolean or an exception is generated.</para>
@@ -1078,6 +1149,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a <see cref="T:System.Data.SqlTypes.SqlBoolean" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -1096,7 +1171,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Data.SqlTypes.SqlByte'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore the data retrieved must already be a byte, or an exception is generated.</para>
@@ -1105,6 +1179,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a <see cref="T:System.Data.SqlTypes.SqlByte" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the column expressed as a  <see cref="T:System.Data.SqlTypes.SqlByte" />.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -1126,12 +1204,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as <see cref="T:System.Data.SqlTypes.SqlBytes" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the column expressed as a <see cref="T:System.Data.SqlTypes.SqlBytes" />.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -1146,7 +1227,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Data.SqlTypes.SqlDateTime'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore, the data retrieved must already be a date/time value, or an exception is generated.</para>
@@ -1155,6 +1235,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a <see cref="T:System.Data.SqlTypes.SqlDateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the column expressed as a  <see cref="T:System.Data.SqlTypes.SqlDateTime" />.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -1173,7 +1257,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Data.SqlTypes.SqlDecimal'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore, the data retrieved must already be a decimal value, or an exception is generated.</para>
@@ -1182,6 +1265,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a <see cref="T:System.Data.SqlTypes.SqlDecimal" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the column expressed as a <see cref="T:System.Data.SqlTypes.SqlDecimal" />.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -1200,7 +1287,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Data.SqlTypes.SqlDouble'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore, the data retrieved must already be a double-precision floating-point number, or an exception is generated.</para>
@@ -1209,6 +1295,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a <see cref="T:System.Data.SqlTypes.SqlDouble" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the column expressed as a  <see cref="T:System.Data.SqlTypes.SqlDouble" />.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -1227,7 +1317,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Data.SqlTypes.SqlGuid'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore, the data retrieved must already be a GUID, or an exception is generated.</para>
@@ -1236,6 +1325,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a <see cref="T:System.Data.SqlTypes.SqlGuid" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the column expressed as a  <see cref="T:System.Data.SqlTypes.SqlGuid" />.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -1254,7 +1347,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Data.SqlTypes.SqlInt16'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore, the data retrieved must already be a 16-bit signed integer, or an exception is generated.</para>
@@ -1263,6 +1355,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a <see cref="T:System.Data.SqlTypes.SqlInt16" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the column expressed as a <see cref="T:System.Data.SqlTypes.SqlInt16" />.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -1281,7 +1377,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Data.SqlTypes.SqlInt32'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore the data retrieved must already be a 32-bit signed integer, or an exception is generated.</para>
@@ -1290,6 +1385,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a <see cref="T:System.Data.SqlTypes.SqlInt32" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the column expressed as a <see cref="T:System.Data.SqlTypes.SqlInt32" />.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -1308,7 +1407,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Data.SqlTypes.SqlInt64'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore, the data retrieved must already be a 64-bit signed integer, or an exception is generated.</para>
@@ -1317,6 +1415,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a <see cref="T:System.Data.SqlTypes.SqlInt64" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the column expressed as a <see cref="T:System.Data.SqlTypes.SqlInt64" />.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -1335,7 +1437,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Data.SqlTypes.SqlMoney'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore, the data retrieved must already be a decimal value, or an exception is generated.</para>
@@ -1344,6 +1445,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a <see cref="T:System.Data.SqlTypes.SqlMoney" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the column expressed as a <see cref="T:System.Data.SqlTypes.SqlMoney" />.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -1362,7 +1467,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Data.SqlTypes.SqlSingle'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore, the data retrieved must already be a single precision floating point number, or an exception is generated.</para>
@@ -1371,6 +1475,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a <see cref="T:System.Data.SqlTypes.SqlSingle" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the column expressed as a <see cref="T:System.Data.SqlTypes.SqlSingle" />.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -1389,7 +1497,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Data.SqlTypes.SqlString'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore, the data retrieved must already be a string, or an exception is generated.</para>
@@ -1398,6 +1505,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a <see cref="T:System.Data.SqlTypes.SqlString" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the column expressed as a <see cref="T:System.Data.SqlTypes.SqlString" />.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -1416,7 +1527,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -1426,6 +1536,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the data value in the specified column as a SQL Server type. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the column expressed as a <see cref="T:System.Data.SqlDbType" />.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -1444,7 +1558,6 @@
         <Parameter Name="values" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the values for all the columns in the record in a single call, using the SQL type system instead of the CLR type system. The length of the <see cref="T:System.Object" /> array does not need to match the number of columns in the record. You can pass an <see cref="T:System.Object" /> array that contains fewer than the number of columns contained in the record. Only the amount of data the <see cref="T:System.Object" /> array holds is copied to the array, starting at the column with ordinal 0. You can also pass an <see cref="T:System.Object" /> array whose length is more than the number of columns contained in the resulting row. Any remaining columns are untouched.</para>
@@ -1453,6 +1566,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Fills an array of <see cref="T:System.Object" /> that contains the values for all the columns in the record, expressed as SQL Server types.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer indicating the number of columns copied.</para>
+        </returns>
         <param name="values">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Object" /> into which to copy the values. The column values are expressed as SQL Server types.</param>
       </Docs>
@@ -1474,7 +1591,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore, the data retrieved must already be an XML value.</para>
@@ -1484,6 +1600,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as an XML value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlXml" /> value that contains the XML stored within the corresponding field. </para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal.</param>
       </Docs>
@@ -1498,7 +1618,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed; therefore, the data retrieved must already be a string.</para>
@@ -1508,6 +1627,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -1526,7 +1649,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -1536,6 +1658,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column in its native format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns <see cref="T:System.DBNull" /> for null database columns.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -1554,7 +1680,6 @@
         <Parameter Name="values" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For most applications, this method provides an efficient means for retrieving all columns, instead of retrieving each column individually.</para>
@@ -1565,6 +1690,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Populates an array of objects with the column values of the current row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of instances of <see cref="T:System.Object" /> in the array.</para>
+        </returns>
         <param name="values">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Object" /> into which to copy the attribute columns. </param>
       </Docs>
@@ -1627,7 +1756,6 @@
         <Parameter Name="condition" Type="System.Data.CommandBehavior" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.</para>
@@ -1636,6 +1764,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Data.CommandBehavior" /> matches that of the <see cref="T:System.Data.SqlClient.SqlDataReader" /> .</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Data.CommandBehavior" /> is true, false otherwise.</para>
+        </returns>
         <param name="condition">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.CommandBehavior" /> enumeration.</param>
       </Docs>
@@ -1650,7 +1782,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this method to check for null column values before calling the typed get methods (for example, <see cref="M:System.Data.SqlClient.SqlDataReader.GetByte(System.Int32)" />, <see cref="M:System.Data.SqlClient.SqlDataReader.GetChar(System.Int32)" />, and so on) to avoid raising an error.</para>
@@ -1660,6 +1791,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the column contains non-existent or missing values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified column value is equivalent to <see cref="T:System.DBNull" />; otherwise false.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -1716,7 +1851,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used to process multiple results, which can be generated by executing batch Transact-SQL statements.</para>
@@ -1726,6 +1860,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the data reader to the next result, when reading the results of batch Transact-SQL statements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there are more result sets; otherwise false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1740,7 +1878,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default position of the <see cref="T:System.Data.SqlClient.SqlDataReader" /> is before the first record. Therefore, you must call <see cref="M:System.Data.SqlClient.SqlDataReader.Read" /> to begin accessing any data.</para>
@@ -1750,6 +1887,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the <see cref="T:System.Data.SqlClient.SqlDataReader" /> to the next record.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there are more rows; otherwise false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1792,12 +1933,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that can be used to iterate through the item collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The enumerator that can be used to iterate through the item collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.IDisposable.Dispose">
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlDependency.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlDependency.xml
index c40386c3c83..8230084b235 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlDependency.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlDependency.xml
@@ -444,7 +444,6 @@
         <Parameter Name="connectionString" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method starts the listener for the <see cref="T:System.AppDomain" /> for receiving dependency notifications from the instance of ssNoVersion specified by the <paramref name="connectionString" /> parameter. This method may be called more than once with different connection strings for multiple servers.</para>
@@ -454,6 +453,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Starts the listener for receiving dependency change notifications from the instance of SQL Server specified by the connection string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the listener initialized successfully; false if a compatible listener already exists.</para>
+        </returns>
         <param name="connectionString">
           <attribution license="cc4" from="Microsoft" modified="false" />The connection string for the instance of ssNoVersion from which to obtain change notifications.</param>
       </Docs>
@@ -472,7 +475,6 @@
         <Parameter Name="queue" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method starts the listener for the <see cref="T:System.AppDomain" /> for receiving dependency notifications from the instance of SQL Server specified by the <paramref name="connectionString" /> parameter. This method may be called more than once with different connection strings for multiple servers.</para>
@@ -483,6 +485,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Starts the listener for receiving dependency change notifications from the instance of SQL Server specified by the connection string using the specified SQL Server Service Broker queue.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the listener initialized successfully; false if a compatible listener already exists.</para>
+        </returns>
         <param name="connectionString">
           <attribution license="cc4" from="Microsoft" modified="false" />The connection string for the instance of SQL Server from which to obtain change notifications.</param>
         <param name="queue">
@@ -502,7 +508,6 @@
         <Parameter Name="connectionString" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.Data.SqlClient.SqlDependency.Stop" /> method must be called for each <see cref="Overload:System.Data.SqlClient.SqlDependency.Start" /> call. A given listener only shuts down fully when it receives the same number of <see cref="Overload:System.Data.SqlClient.SqlDependency.Stop" /> requests as <see cref="Overload:System.Data.SqlClient.SqlDependency.Start" /> requests.</para>
@@ -511,6 +516,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Stops a listener for a connection specified in a previous <see cref="Overload:System.Data.SqlClient.SqlDependency.Start" /> call.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the listener was completely stopped; false if the <see cref="T:System.AppDomain" /> was unbound from the listener, but there are is at least one other <see cref="T:System.AppDomain" /> using the same listener.</para>
+        </returns>
         <param name="connectionString">
           <attribution license="cc4" from="Microsoft" modified="false" />Connection string for the instance of SQL Server that was used in a previous <see cref="M:System.Data.SqlClient.SqlDependency.Start(System.String)" /> call.</param>
       </Docs>
@@ -529,7 +538,6 @@
         <Parameter Name="queue" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.Data.SqlClient.SqlDependency.Stop" /> method must be called for each <see cref="Overload:System.Data.SqlClient.SqlDependency.Start" /> call. A given listener only shuts down fully when it receives the same number of <see cref="Overload:System.Data.SqlClient.SqlDependency.Stop" /> requests as <see cref="Overload:System.Data.SqlClient.SqlDependency.Start" /> requests.</para>
@@ -538,6 +546,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Stops a listener for a connection specified in a previous <see cref="Overload:System.Data.SqlClient.SqlDependency.Start" /> call.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the listener was completely stopped; false if the <see cref="T:System.AppDomain" /> was unbound from the listener, but there is at least one other <see cref="T:System.AppDomain" /> using the same listener.</para>
+        </returns>
         <param name="connectionString">
           <attribution license="cc4" from="Microsoft" modified="false" />Connection string for the instance of SQL Server that was used in a previous <see cref="M:System.Data.SqlClient.SqlDependency.Start(System.String,System.String)" /> call.</param>
         <param name="queue">
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlError.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlError.xml
index 57e55720a98..aa104a454cb 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlError.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlError.xml
@@ -363,7 +363,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The string is in the form "SqlError:", followed by the <see cref="P:System.Data.SqlClient.SqlError.Message" />, and the stack trace. For example: </para>
@@ -373,6 +372,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the complete text of the error message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The complete text of the error.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlErrorCollection.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlErrorCollection.xml
index 1d8a8669a34..7709c19993f 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlErrorCollection.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlErrorCollection.xml
@@ -111,7 +111,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IEnumerator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Enumerators can be used to read the data in a collection, but they cannot be used to modify the underlying collection.</para>
@@ -120,6 +119,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the <see cref="T:System.Data.SqlClient.SqlErrorCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.Data.SqlClient.SqlErrorCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlInfoMessageEventArgs.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlInfoMessageEventArgs.xml
index 1dfa37d1335..3e795a871ba 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlInfoMessageEventArgs.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlInfoMessageEventArgs.xml
@@ -96,12 +96,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a string representation of the <see cref="E:System.Data.SqlClient.SqlConnection.InfoMessage" /> event.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representing the <see cref="E:System.Data.SqlClient.SqlConnection.InfoMessage" /> event.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlParameter.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlParameter.xml
index d4fc0abfc01..3ebdc1ae24f 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlParameter.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlParameter.xml
@@ -785,7 +785,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.SqlClient.SqlParameter" /> instance is cast to an <see cref="T:System.ICloneable" /> interface.</para>
@@ -794,6 +793,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ICloneable.Clone" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Object" /> that is a copy of this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -804,12 +807,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a string that contains the <see cref="P:System.Data.SqlClient.SqlParameter.ParameterName" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the <see cref="P:System.Data.SqlClient.SqlParameter.ParameterName" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlParameterCollection.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlParameterCollection.xml
index 653ada86a26..d6ed5321995 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlParameterCollection.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlClient/SqlParameterCollection.xml
@@ -44,12 +44,15 @@
         <Parameter Name="value" Type="System.Data.SqlClient.SqlParameter" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlParameter'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Data.SqlClient.SqlParameter" /> object to the <see cref="T:System.Data.SqlClient.SqlParameterCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlClient.SqlParameter" /> object.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlClient.SqlParameter" /> to add to the collection. </param>
       </Docs>
@@ -68,12 +71,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Data.SqlClient.SqlParameter" /> object to the <see cref="T:System.Data.SqlClient.SqlParameterCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the new <see cref="T:System.Data.SqlClient.SqlParameter" /> object.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Object" />.</param>
       </Docs>
@@ -98,12 +104,15 @@
         <Parameter Name="sqlDbType" Type="System.Data.SqlDbType" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlParameter'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Data.SqlClient.SqlParameter" /> to the <see cref="T:System.Data.SqlClient.SqlParameterCollection" /> given the parameter name and the data type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlClient.SqlParameter" /> object.</para>
+        </returns>
         <param name="parameterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the parameter. </param>
         <param name="sqlDbType">
@@ -125,12 +134,18 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlParameter'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Data.SqlClient.SqlParameter" /> object to the <see cref="T:System.Data.SqlClient.SqlParameterCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlClient.SqlParameter" /> object.</para>
+          <para>Use caution when you are using this overload of the SqlParameterCollection.Add method to specify integer parameter values. Because this overload takes a <paramref name="value" /> of type <see cref="T:System.Object" />, you must convert the integral value to an <see cref="T:System.Object" /> type when the value is zero, as the following C# example demonstrates.</para>
+          <code>parameters.Add("@pname", Convert.ToInt32(0));</code>
+          <para>If you do not perform this conversion, the compiler assumes that you are trying to call the SqlParameterCollection.Add (string, SqlDbType) overload.</para>
+        </returns>
         <param name="parameterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Data.SqlClient.SqlParameter" /> to add to the collection.</param>
         <param name="value">
@@ -161,7 +176,6 @@
         <Parameter Name="size" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlParameter'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload is useful when you are adding a parameter of a variable-length data type such as varchar or binary.</para>
@@ -170,6 +184,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Data.SqlClient.SqlParameter" /> to the <see cref="T:System.Data.SqlClient.SqlParameterCollection" />, given the specified parameter name, <see cref="T:System.Data.SqlDbType" /> and size.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlClient.SqlParameter" /> object.</para>
+        </returns>
         <param name="parameterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the parameter. </param>
         <param name="sqlDbType">
@@ -195,12 +213,15 @@
         <Parameter Name="sourceColumn" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlParameter'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Data.SqlClient.SqlParameter" /> to the <see cref="T:System.Data.SqlClient.SqlParameterCollection" /> with the parameter name, the data type, and the column length.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlClient.SqlParameter" /> object.</para>
+        </returns>
         <param name="parameterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the parameter. </param>
         <param name="sqlDbType">
@@ -273,7 +294,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -284,6 +304,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a value to the end of the <see cref="T:System.Data.SqlClient.SqlParameterCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlClient.SqlParameter" /> object.</para>
+        </returns>
         <param name="parameterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the parameter.</param>
         <param name="value">
@@ -322,12 +346,15 @@
         <Parameter Name="value" Type="System.Data.SqlClient.SqlParameter" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Data.SqlClient.SqlParameter" /> is in this <see cref="T:System.Data.SqlClient.SqlParameterCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Data.SqlClient.SqlParameterCollection" /> contains the value; otherwise false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlClient.SqlParameter" /> value.</param>
       </Docs>
@@ -342,12 +369,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is in this <see cref="T:System.Data.SqlClient.SqlParameterCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Data.SqlClient.SqlParameterCollection" /> contains the value; otherwise false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> value.</param>
       </Docs>
@@ -366,12 +396,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified parameter name is in this <see cref="T:System.Data.SqlClient.SqlParameterCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Data.SqlClient.SqlParameterCollection" /> contains the value; otherwise false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> value.</param>
       </Docs>
@@ -458,12 +491,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IEnumerator'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the <see cref="T:System.Data.SqlClient.SqlParameterCollection" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.Data.SqlClient.SqlParameterCollection" />. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -521,12 +557,15 @@
         <Parameter Name="value" Type="System.Data.SqlClient.SqlParameter" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the location of the specified <see cref="T:System.Data.SqlClient.SqlParameter" /> within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based location of the specified <see cref="T:System.Data.SqlClient.SqlParameter" /> that is a <see cref="T:System.Data.SqlClient.SqlParameter" /> within the collection. Returns -1 when the object does not exist in the <see cref="T:System.Data.SqlClient.SqlParameterCollection" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlClient.SqlParameter" /> to find. </param>
       </Docs>
@@ -541,12 +580,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the location of the specified <see cref="T:System.Object" /> within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based location of the specified <see cref="T:System.Object" /> that is a <see cref="T:System.Data.SqlClient.SqlParameter" /> within the collection. Returns -1 when the object does not exist in the <see cref="T:System.Data.SqlClient.SqlParameterCollection" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to find. </param>
       </Docs>
@@ -565,12 +607,15 @@
         <Parameter Name="parameterName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the location of the specified <see cref="T:System.Data.SqlClient.SqlParameter" /> with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based location of the specified <see cref="T:System.Data.SqlClient.SqlParameter" /> with the specified case-sensitive name. Returns -1 when the object does not exist in the <see cref="T:System.Data.SqlClient.SqlParameterCollection" />.</para>
+        </returns>
         <param name="parameterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The case-sensitive name of the <see cref="T:System.Data.SqlClient.SqlParameter" /> to find.</param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlBinary.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlBinary.xml
index 2f047cbc625..29b15d2aa1f 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlBinary.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlBinary.xml
@@ -71,7 +71,6 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBinary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -81,6 +80,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Concatenates two specified <see cref="T:System.Data.SqlTypes.SqlBinary" /> values to create a new <see cref="T:System.Data.SqlTypes.SqlBinary" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBinary" /> that is the concatenated value of x and y.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBinary" />. </param>
         <param name="y">
@@ -100,12 +103,53 @@
         <Parameter Name="value" Type="System.Data.SqlTypes.SqlBinary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this <see cref="T:System.Data.SqlTypes.SqlBinary" /> object to the supplied <see cref="T:System.Data.SqlTypes.SqlBinary" /> object and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number that indicates the relative values of this <see cref="T:System.Data.SqlTypes.SqlBinary" /> structure and the object.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>The value of this <see cref="T:System.Data.SqlTypes.SqlBinary" /> object is less than the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This <see cref="T:System.Data.SqlTypes.SqlBinary" /> object is the same as object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This <see cref="T:System.Data.SqlTypes.SqlBinary" /> object is greater than object.</para>
+                <para>-or- </para>
+                <para>The object is a null reference. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlTypes.SqlBinary" /> object to be compared to this <see cref="T:System.Data.SqlTypes.SqlBinary" /> structure. </param>
       </Docs>
@@ -120,12 +164,53 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this <see cref="T:System.Data.SqlTypes.SqlBinary" /> object to the supplied object and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number that indicates the relative values of this <see cref="T:System.Data.SqlTypes.SqlBinary" /> structure and the object.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>The value of this <see cref="T:System.Data.SqlTypes.SqlBinary" /> object is less than the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This <see cref="T:System.Data.SqlTypes.SqlBinary" /> object is the same as object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This <see cref="T:System.Data.SqlTypes.SqlBinary" /> object is greater than object.</para>
+                <para>-or- </para>
+                <para>The object is a null reference. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be compared to this <see cref="T:System.Data.SqlTypes.SqlBinary" /> structure. </param>
       </Docs>
@@ -145,12 +230,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBinary" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBinary'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Concatenates two <see cref="T:System.Data.SqlTypes.SqlBinary" /> structures to create a new <see cref="T:System.Data.SqlTypes.SqlBinary" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The concatenated values of the <paramref name="x" /> and <paramref name="y" /> parameters.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBinary" /> structure. </param>
         <param name="y">
@@ -171,12 +259,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the supplied object parameter to the <see cref="P:System.Data.SqlTypes.SqlBinary.Value" /> property of the <see cref="T:System.Data.SqlTypes.SqlBinary" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if object is an instance of <see cref="T:System.Data.SqlTypes.SqlBinary" /> and the two are equal; otherwise false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be compared. </param>
       </Docs>
@@ -196,12 +287,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBinary" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Data.SqlTypes.SqlBinary" /> structures to determine whether they are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two values are equal. Otherwise, false. If either instance is null, then the SqlBinary will be null.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBinary" /> structure. </param>
         <param name="y">
@@ -220,12 +314,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this <see cref="T:System.Data.SqlTypes.SqlBinary" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -245,12 +342,15 @@
         <Parameter Name="schemaSet" Type="System.Xml.Schema.XmlSchemaSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that indicates the XSD of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
+        </returns>
         <param name="schemaSet">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</param>
       </Docs>
@@ -266,12 +366,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBinary" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Data.SqlTypes.SqlBinary" /> structures to determine whether the first is greater than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than the second instance. Otherwise <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlBinary" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBinary" /> structure. </param>
         <param name="y">
@@ -293,12 +396,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBinary" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Data.SqlTypes.SqlBinary" /> structures to determine whether the first is greater than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than or equal to the second instance. Otherwise <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlBinary" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBinary" /> structure. </param>
         <param name="y">
@@ -384,12 +490,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBinary" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Data.SqlTypes.SqlBinary" /> structures to determine whether the first is less than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than the second instance. Otherwise <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlBinary" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBinary" /> structure. </param>
         <param name="y">
@@ -411,12 +520,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBinary" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Data.SqlTypes.SqlBinary" /> structures to determine whether the first is less than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than or equal to the second instance. Otherwise <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlBinary" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBinary" /> structure. </param>
         <param name="y">
@@ -438,12 +550,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBinary" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Data.SqlTypes.SqlBinary" /> structures to determine whether they are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are not equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlBinary" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBinary" /> structure. </param>
         <param name="y">
@@ -491,7 +606,6 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBinary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -501,6 +615,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Concatenates the two <see cref="T:System.Data.SqlTypes.SqlBinary" /> parameters to create a new <see cref="T:System.Data.SqlTypes.SqlBinary" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The concatenated values of the <paramref name="x" /> and <paramref name="y" /> parameters.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBinary" /> object. </param>
         <param name="y">
@@ -522,12 +640,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBinary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Data.SqlTypes.SqlBinary" /> structures to determine whether they are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are not equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlBinary" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBinary" /> object. </param>
         <param name="y">
@@ -589,12 +710,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBinary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Data.SqlTypes.SqlBinary" /> structures to determine whether the first is greater than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than the second instance. Otherwise <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlBinary" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBinary" /> object. </param>
         <param name="y">
@@ -616,12 +740,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBinary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Data.SqlTypes.SqlBinary" /> structues to determine whether the first is greater than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than or equal to the second instance. Otherwise <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlBinary" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBinary" /> object. </param>
         <param name="y">
@@ -663,12 +790,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBinary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Data.SqlTypes.SqlBinary" /> structures to determine whether they are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are not equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlBinary" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBinary" /> object. </param>
         <param name="y">
@@ -690,12 +820,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBinary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Data.SqlTypes.SqlBinary" /> structures to determine whether the first is less than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than the second instance. Otherwise <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlBinary" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBinary" /> object. </param>
         <param name="y">
@@ -717,12 +850,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBinary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Data.SqlTypes.SqlBinary" /> structures to determine whether the first is less than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than or equal to the second instance. Otherwise <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlBinary" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBinary" /> object. </param>
         <param name="y">
@@ -740,7 +876,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.SqlTypes.SqlBinary" /> instance is cast to an <see cref="T:System.Xml.Serialization.IXmlSerializable" /> interface.</para>
@@ -749,6 +884,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Xml.Serialization.IXmlSerializable.GetSchema" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Schema.XMLSchema" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
@@ -809,12 +948,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlGuid'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this instance of <see cref="T:System.Data.SqlTypes.SqlBinary" /> to <see cref="T:System.Data.SqlTypes.SqlGuid" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlGuid" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -829,12 +971,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlBinary" /> object to a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the <see cref="P:System.Data.SqlTypes.SqlBinary.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBinary" />. If the <see cref="P:System.Data.SqlTypes.SqlBinary.Value" /> is null the string will contain "null".</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlBoolean.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlBoolean.xml
index 199b742e69a..54ad9137b93 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlBoolean.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlBoolean.xml
@@ -88,12 +88,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBoolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the bitwise AND operation of two specified <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structures.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of the logical AND operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure. </param>
         <param name="y">
@@ -139,7 +142,6 @@
         <Parameter Name="value" Type="System.Data.SqlTypes.SqlBoolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Any instance of <see cref="T:System.Data.SqlTypes.SqlBoolean" />, regardless of its value, is considered greater than a null reference (Nothing in Visual Basic).</para>
@@ -148,6 +150,49 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this <see cref="T:System.Data.SqlTypes.SqlBoolean" /> object to the supplied <see cref="T:System.Data.SqlTypes.SqlBoolean" /> object and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number that indicates the relative values of the instance and value.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>A negative integer </para>
+              </term>
+              <description>
+                <para>This instance is less than <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is equal to <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>A positive integer </para>
+              </term>
+              <description>
+                <para>This instance is greater than <paramref name="value" />.</para>
+                <para>-or- </para>
+                <para>
+                  <paramref name="value" /> is a null reference (Nothing in Visual Basic). </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> <see cref="T:System.Data.SqlTypes.SqlBoolean" /> object to compare, or a null reference (Nothing in Visual Basic).  </param>
       </Docs>
@@ -162,7 +207,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Any instance of <see cref="T:System.Data.SqlTypes.SqlBoolean" />, regardless of its value, is considered greater than a null reference (Nothing in Visual Basic).</para>
@@ -171,6 +215,49 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure to a specified object and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number that indicates the relative values of the instance and value.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>A negative integer </para>
+              </term>
+              <description>
+                <para>This instance is less than <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is equal to <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>A positive integer </para>
+              </term>
+              <description>
+                <para>This instance is greater than <paramref name="value" />.</para>
+                <para>-or- </para>
+                <para>
+                  <paramref name="value" /> is a null reference (Nothing in Visual Basic). </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare, or a null reference (Nothing in Visual Basic). </param>
       </Docs>
@@ -189,12 +276,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the supplied object parameter to the <see cref="T:System.Data.SqlTypes.SqlBoolean" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if object is an instance of <see cref="T:System.Data.SqlTypes.SqlBoolean" /> and the two are equal; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be compared. </param>
       </Docs>
@@ -214,12 +304,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBoolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structures to determine whether they are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are not equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlBoolean" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure. </param>
         <param name="y">
@@ -260,12 +353,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -285,12 +381,15 @@
         <Parameter Name="schemaSet" Type="System.Xml.Schema.XmlSchemaSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string value that indicates the XSD of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
+        </returns>
         <param name="schemaSet">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</param>
       </Docs>
@@ -309,7 +408,6 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBoolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If either instance of <paramref name="x" /> or <paramref name="y" /> is null, the value of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be null.</para>
@@ -318,6 +416,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlBoolean" /> to determine whether the first is greater than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is true if the first instance is greater than the second instance; otherwise false. </para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure.</param>
         <param name="y">
@@ -338,7 +440,6 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBoolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If either instance of <paramref name="x" /> or <paramref name="y" /> is null, the value of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be null.</para>
@@ -347,6 +448,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlBoolean" /> to determine whether the first is greater than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is true if the first instance is greater than or equal to the second instance; otherwise false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure.</param>
         <param name="y">
@@ -433,7 +538,6 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBoolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If either instance of <paramref name="x" /> or <paramref name="y" /> is null, the value of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be null.</para>
@@ -442,6 +546,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlBoolean" /> to determine whether the first is less than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is true if the first instance is less than the second instance; otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure.</param>
         <param name="y">
@@ -462,7 +570,6 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBoolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If either instance of <paramref name="x" /> or <paramref name="y" /> is null, the value of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be null.</para>
@@ -471,6 +578,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlBoolean" /> to determine whether the first is less than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is true if the first instance is less than or equal to the second instance; otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure.</param>
         <param name="y">
@@ -488,12 +599,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBoolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlBoolean" /> for equality.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are not equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlBoolean" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure. </param>
         <param name="y">
@@ -558,12 +672,15 @@
         <Parameter Name="x" Type="System.Data.SqlTypes.SqlBoolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a one's complement operation on the supplied <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structures.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The one's complement of the supplied <see cref="T:System.Data.SqlTypes.SqlBoolean" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure. </param>
       </Docs>
@@ -587,12 +704,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBoolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the bitwise AND operation of two specified <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structures.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of the logical AND operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure. </param>
         <param name="y">
@@ -614,12 +734,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBoolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the bitwise OR of its operands.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The results of the logical OR operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure. </param>
         <param name="y">
@@ -641,12 +764,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBoolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlBoolean" /> for equality.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are not equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlBoolean" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBoolean" />. </param>
         <param name="y">
@@ -668,12 +794,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBoolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a bitwise exclusive-OR (XOR) operation on the supplied parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of the logical XOR operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure. </param>
         <param name="y">
@@ -894,12 +1023,15 @@
         <Parameter Name="x" Type="System.Data.SqlTypes.SqlBoolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The false operator can be used to test the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> to determine whether it is false.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the supplied parameter is <see cref="T:System.Data.SqlTypes.SqlBoolean" /> is false, false otherwise.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure to be tested. </param>
       </Docs>
@@ -918,7 +1050,6 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBoolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If either instance of <paramref name="x" /> or <paramref name="y" /> is null, the value of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be null.</para>
@@ -927,6 +1058,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structures to determine whether the first is greater than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is true if the first instance is greater than the second instance; otherwise, false. </para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> object. </param>
         <param name="y">
@@ -947,7 +1082,6 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBoolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If either instance of <paramref name="x" /> or <paramref name="y" /> is null, the value of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be null.</para>
@@ -956,6 +1090,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structures to determine whether the first is greater than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is true if the first instance is greater than or equal to the second instance; otherwise, false. </para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure.</param>
         <param name="y">
@@ -997,12 +1135,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBoolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlBoolean" /> to determine whether they are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are not equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlBoolean" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBoolean" />. </param>
         <param name="y">
@@ -1023,7 +1164,6 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBoolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If either instance of <paramref name="x" /> or <paramref name="y" /> is null, the value of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be null.</para>
@@ -1032,6 +1172,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlBoolean" /> to determine whether the first is less than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is true if the first instance is less than the second instance; otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure.</param>
         <param name="y">
@@ -1052,7 +1196,6 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBoolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If either instance of <paramref name="x" /> or <paramref name="y" /> is null, the value of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be null.</para>
@@ -1061,6 +1204,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlBoolean" /> to determine whether the first is less than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is true if the first instance is less than or equal to the second instance; otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure.</param>
         <param name="y">
@@ -1081,12 +1228,15 @@
         <Parameter Name="x" Type="System.Data.SqlTypes.SqlBoolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a NOT operation on a <see cref="T:System.Data.SqlTypes.SqlBoolean" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> with the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if argument was true, <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" /> if argument was null, and <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> otherwise.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlTypes.SqlBoolean" /> on which the NOT operation will be performed. </param>
       </Docs>
@@ -1105,12 +1255,15 @@
         <Parameter Name="x" Type="System.Data.SqlTypes.SqlBoolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a one's complement operation on the supplied <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structures.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The one's complement of the supplied <see cref="T:System.Data.SqlTypes.SqlBoolean" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure. </param>
       </Docs>
@@ -1129,12 +1282,15 @@
         <Parameter Name="x" Type="System.Data.SqlTypes.SqlBoolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The true operator can be used to test the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> to determine whether it is true.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the supplied parameter is <see cref="T:System.Data.SqlTypes.SqlBoolean" /> is true, false otherwise.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure to be tested. </param>
       </Docs>
@@ -1150,12 +1306,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBoolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a bitwise OR operation on the two specified <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structures.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure whose Value is the result of the bitwise OR operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure. </param>
         <param name="y">
@@ -1176,12 +1335,15 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> representation of a logical value to its <see cref="T:System.Data.SqlTypes.SqlBoolean" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure that contains the parsed value.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> to be converted. </param>
       </Docs>
@@ -1201,12 +1363,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XmlSchema.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
@@ -1261,12 +1426,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlByte'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure to <see cref="T:System.Data.SqlTypes.SqlByte" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlByte" /> structure whose value is 1 or 0. If the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure's value equals true, the new <see cref="T:System.Data.SqlTypes.SqlByte" /> structure's value is 1. Otherwise, the new <see cref="T:System.Data.SqlTypes.SqlByte" /> structure's value is 0.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1281,12 +1449,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlDecimal'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure to <see cref="T:System.Data.SqlTypes.SqlDecimal" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure whose value is 1 or 0. If the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure's value equals true then the new <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure's value is 1. Otherwise, the new <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure's value is 0.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1301,12 +1472,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlDouble'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure to <see cref="T:System.Data.SqlTypes.SqlDouble" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure whose value is 1 or 0. If the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure's value equals true then the new <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure's value is 1. Otherwise, the new <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure's value is 0.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1321,12 +1495,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlInt16'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure to <see cref="T:System.Data.SqlTypes.SqlInt16" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new SqlInt16 structure whose value is 1 or 0. If the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure's value equals true then the new <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure's value is 1. Otherwise, the new SqlInt16 structure's value is 0.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1341,12 +1518,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlInt32'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure to <see cref="T:System.Data.SqlTypes.SqlInt32" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new SqlInt32 structure whose value is 1 or 0. If the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure's value equals true, the new <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure's value is 1. Otherwise, the new SqlInt32 structure's value is 0.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1361,12 +1541,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlInt64'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure to <see cref="T:System.Data.SqlTypes.SqlInt64" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new SqlInt64 structure whose value is 1 or 0. If the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure's value equals true, the new <see cref="T:System.Data.SqlTypes.SqlInt64" />  structure's value is 1. Otherwise, the new SqlInt64 structure's value is 0.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1381,12 +1564,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlMoney'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure to <see cref="T:System.Data.SqlTypes.SqlMoney" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure whose value is 1 or 0. If the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure's value equals true, the new <see cref="T:System.Data.SqlTypes.SqlMoney" /> value is 1. If the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure's value equals false, the new <see cref="T:System.Data.SqlTypes.SqlMoney" /> value is 0. If <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure's value is neither 1 nor 0, the new <see cref="T:System.Data.SqlTypes.SqlMoney" /> value is <see cref="F:System.Data.SqlTypes.SqlMoney.Null" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1401,12 +1587,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlSingle'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure to <see cref="T:System.Data.SqlTypes.SqlSingle" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure whose value is 1 or 0.</para>
+          <para>If the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure's value equals true, the new <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure's value is 1; otherwise the new <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure's value is 0.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1421,12 +1611,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlString'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure to <see cref="T:System.Data.SqlTypes.SqlString" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlString" /> structure whose value is 1 or 0. If the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure's value equals true then <see cref="T:System.Data.SqlTypes.SqlString" /> structure's value is 1. Otherwise the new <see cref="T:System.Data.SqlTypes.SqlString" /> structure's value is 0.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1441,12 +1634,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure to a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the value of the <see cref="T:System.Data.SqlTypes.SqlBoolean" />. If the value is null, the string will contain "null".</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1505,12 +1701,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlBoolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a bitwise exclusive-OR operation on the supplied parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of the logical XOR operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure. </param>
         <param name="y">
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlByte.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlByte.xml
index 0aa9b1b5245..589b928cd0e 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlByte.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlByte.xml
@@ -63,12 +63,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlByte'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the two specified <see cref="T:System.Data.SqlTypes.SqlByte" /> structures.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure whose Value property contains the results of the addition.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
         <param name="y">
@@ -90,12 +93,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlByte'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the bitwise AND of its <see cref="T:System.Data.SqlTypes.SqlByte" /> operands.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The results of the bitwise AND operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
         <param name="y">
@@ -117,12 +123,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlByte'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the bitwise OR of its two <see cref="T:System.Data.SqlTypes.SqlByte" /> operands.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The results of the bitwise OR operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
         <param name="y">
@@ -146,12 +155,53 @@
         <Parameter Name="value" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this instance to the supplied <see cref="T:System.Data.SqlTypes.SqlByte" /> object and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number that indicates the relative values of the instance and the object.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is the same as the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than the object </para>
+                <para>-or- </para>
+                <para>The object is a null reference (Nothing in Visual Basic) </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlTypes.SqlByte" /> object to be compared.</param>
       </Docs>
@@ -166,12 +216,53 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this instance to the supplied <see cref="T:System.Object" /> and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number that indicates the relative values of the instance and the object.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is the same as the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than the object </para>
+                <para>-or- </para>
+                <para>The object is a null reference (Nothing in Visual Basic) </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to be compared.</param>
       </Docs>
@@ -191,12 +282,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlByte'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Divides its first <see cref="T:System.Data.SqlTypes.SqlByte" /> operand by its second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlByte" /> structure whose <see cref="P:System.Data.SqlTypes.SqlByte.Value" /> property contains the results of the division.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
         <param name="y">
@@ -217,12 +311,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the supplied <see cref="T:System.Object" /> parameter to the <see cref="P:System.Data.SqlTypes.SqlByte.Value" /> property of the <see cref="T:System.Data.SqlTypes.SqlByte" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if object is an instance of <see cref="T:System.Data.SqlTypes.SqlByte" /> and the two are equal; otherwise false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to be compared. </param>
       </Docs>
@@ -242,12 +339,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of two <see cref="T:System.Data.SqlTypes.SqlByte" /> structures to determine whether they are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two values are equal. Otherwise, false. If either instance is null, then the SqlByte will be null.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
         <param name="y">
@@ -266,12 +366,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -291,12 +394,15 @@
         <Parameter Name="schemaSet" Type="System.Xml.Schema.XmlSchemaSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string value that indicates the XSD of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
+        </returns>
         <param name="schemaSet">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</param>
       </Docs>
@@ -312,12 +418,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlByte" /> to determine whether the first is greater than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlByte" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
         <param name="y">
@@ -339,12 +448,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Data.SqlTypes.SqlByte" /> structures to determine whether the first is greater than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlByte" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
         <param name="y">
@@ -388,12 +500,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlByte" /> to determine whether the first is less than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlByte" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
         <param name="y">
@@ -415,12 +530,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlByte" /> to determine whether the first is less than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlByte" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
         <param name="y">
@@ -486,12 +604,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlByte'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the remainder after dividing its first <see cref="T:System.Data.SqlTypes.SqlByte" /> operand by its second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure whose <see cref="P:System.Data.SqlTypes.SqlByte.Value" /> contains the remainder.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
         <param name="y">
@@ -516,7 +637,6 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If either instance of <paramref name="x" /> or <paramref name="y" /> is null, the value will be null.</para>
@@ -525,6 +645,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Divides two <see cref="T:System.Data.SqlTypes.SqlByte" /> values and returns the remainder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The remainder left after division is performed on <paramref name="x" /> and <paramref name="y" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" />.</param>
         <param name="y">
@@ -542,12 +666,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlByte'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the product of the two <see cref="T:System.Data.SqlTypes.SqlByte" /> operands.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlByte" /> structure whose <see cref="P:System.Data.SqlTypes.SqlByte.Value" /> property contains the product of the multiplication.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
         <param name="y">
@@ -569,12 +696,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlByte" /> to determine whether they are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are not equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlByte" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
         <param name="y">
@@ -617,12 +747,15 @@
         <Parameter Name="x" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlByte'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The ones complement operator performs a bitwise one's complement operation on its <see cref="T:System.Data.SqlTypes.SqlByte" /> operand.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure whose <see cref="P:System.Data.SqlTypes.SqlByte.Value" /> property contains the ones complement of the <see cref="T:System.Data.SqlTypes.SqlByte" /> parameter.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
       </Docs>
@@ -646,12 +779,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the two specified <see cref="T:System.Data.SqlTypes.SqlByte" /> structures.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlByte" /> whose <see cref="P:System.Data.SqlTypes.SqlByte.Value" /> property contains the sum of the two operands.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
         <param name="y">
@@ -673,12 +809,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the bitwise AND of its <see cref="T:System.Data.SqlTypes.SqlByte" /> operands.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The results of the bitwise AND operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
         <param name="y">
@@ -700,12 +839,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the bitwise OR of its two <see cref="T:System.Data.SqlTypes.SqlByte" /> operands.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The results of the bitwise OR operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
         <param name="y">
@@ -727,12 +869,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Divides its first <see cref="T:System.Data.SqlTypes.SqlByte" /> operand by its second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlByte" /> structure whose <see cref="P:System.Data.SqlTypes.SqlByte.Value" /> property contains the results of the division.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
         <param name="y">
@@ -754,12 +899,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of two <see cref="T:System.Data.SqlTypes.SqlByte" /> structures to determine whether they are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are not equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlByte" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
         <param name="y">
@@ -781,12 +929,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a bitwise exclusive-OR operation on the supplied parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The results of the bitwise XOR operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
         <param name="y">
@@ -1008,12 +1159,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlByte" /> to determine whether the first is greater than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlByte" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
         <param name="y">
@@ -1035,12 +1189,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlByte" /> to determine whether the first is greater than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlByte" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the SqlBoolean will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
         <param name="y">
@@ -1082,12 +1239,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlByte" /> to determine whether they are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are not equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlByte" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
         <param name="y">
@@ -1109,12 +1269,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlByte" /> to determine whether the first is less than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlByte" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
         <param name="y">
@@ -1136,12 +1299,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlByte" /> to determine whether the first is less than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlByte" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
         <param name="y">
@@ -1163,12 +1329,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the remainder after dividing its first <see cref="T:System.Data.SqlTypes.SqlByte" /> operand by its second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure whose <see cref="P:System.Data.SqlTypes.SqlByte.Value" /> contains the remainder.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
         <param name="y">
@@ -1190,12 +1359,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the product of the two <see cref="T:System.Data.SqlTypes.SqlByte" /> operands.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlByte" /> structure whose <see cref="P:System.Data.SqlTypes.SqlByte.Value" /> property contains the product of the multiplication.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
         <param name="y">
@@ -1216,12 +1388,15 @@
         <Parameter Name="x" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The ones complement operator performs a bitwise one's complement operation on its <see cref="T:System.Data.SqlTypes.SqlByte" /> operand.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure whose <see cref="P:System.Data.SqlTypes.SqlByte.Value" /> property contains the ones complement of the <see cref="T:System.Data.SqlTypes.SqlByte" /> parameter.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
       </Docs>
@@ -1241,12 +1416,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts the second <see cref="T:System.Data.SqlTypes.SqlByte" /> operand from the first.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The results of subtracting the second <see cref="T:System.Data.SqlTypes.SqlByte" /> operand from the first.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
         <param name="y">
@@ -1263,12 +1441,15 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlByte'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.String" /> representation of a number to its 8-bit unsigned integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure that contains the 8-bit number represented by the String parameter.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The String to be parsed. </param>
       </Docs>
@@ -1288,12 +1469,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlByte'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts the second <see cref="T:System.Data.SqlTypes.SqlByte" /> operand from the first.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The results of subtracting the second <see cref="T:System.Data.SqlTypes.SqlByte" /> operand from the first.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
         <param name="y">
@@ -1315,12 +1499,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XmlSchema.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
@@ -1375,12 +1562,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlByte" /> structure to <see cref="T:System.Data.SqlTypes.SqlBoolean" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="P:System.Data.SqlTypes.SqlByte.Value" /> is non-zero; false if zero; otherwise Null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1395,12 +1585,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlDecimal'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlByte" /> structure to <see cref="T:System.Data.SqlTypes.SqlDecimal" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A SqlDecimal structure whose <see cref="P:System.Data.SqlTypes.SqlDecimal.Value" /> equals the <see cref="P:System.Data.SqlTypes.SqlByte.Value" /> of this <see cref="T:System.Data.SqlTypes.SqlByte" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1415,12 +1608,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlDouble'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlByte" /> structure to <see cref="T:System.Data.SqlTypes.SqlDouble" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A SqlDouble structure with the same value as this <see cref="T:System.Data.SqlTypes.SqlByte" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1435,12 +1631,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlInt16'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlByte" /> structure to <see cref="T:System.Data.SqlTypes.SqlInt16" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A SqlInt16 structure with the same value as this <see cref="T:System.Data.SqlTypes.SqlByte" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1455,12 +1654,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlInt32'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlByte" /> to <see cref="T:System.Data.SqlTypes.SqlInt32" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A SqlInt32 structure with the same value as this <see cref="T:System.Data.SqlTypes.SqlByte" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1475,12 +1677,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlInt64'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlByte" /> structure to <see cref="T:System.Data.SqlTypes.SqlInt64" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A SqlInt64 structure who <see cref="P:System.Data.SqlTypes.SqlInt64.Value" /> equals the <see cref="P:System.Data.SqlTypes.SqlByte.Value" /> of this <see cref="T:System.Data.SqlTypes.SqlByte" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1495,12 +1700,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlMoney'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlByte" /> structure to <see cref="T:System.Data.SqlTypes.SqlMoney" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A SqlMoney structure whose <see cref="P:System.Data.SqlTypes.SqlMoney.Value" /> equals the <see cref="P:System.Data.SqlTypes.SqlByte.Value" /> of this <see cref="T:System.Data.SqlTypes.SqlByte" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1515,12 +1723,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlSingle'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlByte" /> structure to <see cref="T:System.Data.SqlTypes.SqlSingle" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A SqlSingle structure that has the same <see cref="P:System.Data.SqlTypes.SqlSingle.Value" /> as this <see cref="T:System.Data.SqlTypes.SqlByte" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1535,12 +1746,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlString'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this instance of <see cref="T:System.Data.SqlTypes.SqlByte" /> to <see cref="T:System.Data.SqlTypes.SqlString" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A SqlString that contains the string representation of the <see cref="T:System.Data.SqlTypes.SqlByte" /> structure's <see cref="P:System.Data.SqlTypes.SqlByte.Value" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1555,12 +1769,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlByte" /> structure to a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the <see cref="P:System.Data.SqlTypes.SqlByte.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlByte" />. If the Value is null, the String will be a null string.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1597,12 +1814,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlByte" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlByte'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a bitwise exclusive-OR operation on the supplied parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The results of the XOR operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure. </param>
         <param name="y">
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlBytes.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlBytes.xml
index 4ef4574e6d9..d4324206de6 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlBytes.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlBytes.xml
@@ -152,12 +152,15 @@
         <Parameter Name="schemaSet" Type="System.Xml.Schema.XmlSchemaSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that indicates the XSD of the specified XmlSchemaSet.</para>
+        </returns>
         <param name="schemaSet">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</param>
       </Docs>
@@ -317,7 +320,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If an attempt is made to read beyond <see cref="P:System.Data.SqlTypes.SqlBytes.MaxLength" />, an exception is thrown.</para>
@@ -329,6 +331,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies bytes from this <see cref="T:System.Data.SqlTypes.SqlBytes" /> instance to the passed-in buffer and returns the number of copied bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Int64" /> long value representing the number of copied bytes.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Int64" /> long value offset into the value that is contained in the <see cref="T:System.Data.SqlTypes.SqlBytes" /> instance.</param>
         <param name="buffer">
@@ -457,12 +463,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
@@ -520,12 +529,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Constructs and returns a <see cref="T:System.Data.SqlTypes.SqlBinary" /> from this <see cref="T:System.Data.SqlTypes.SqlBytes" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBinary" /> from this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlChars.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlChars.xml
index 902a21618a8..3c00ff9d3a3 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlChars.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlChars.xml
@@ -139,12 +139,15 @@
         <Parameter Name="schemaSet" Type="System.Xml.Schema.XmlSchemaSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string value that indicates the XSD of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
+        </returns>
         <param name="schemaSet">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</param>
       </Docs>
@@ -304,7 +307,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If an attempt is made to read beyond <see cref="P:System.Data.SqlTypes.SqlChars.MaxLength" />, an exception is thrown.</para>
@@ -316,6 +318,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies characters from this <see cref="T:System.Data.SqlTypes.SqlChars" /> instance to the passed-in buffer and returns the number of copied characters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Int64" /> long value representing the number of copied bytes.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Int64" /> long value offset into the value that is contained in the <see cref="T:System.Data.SqlTypes.SqlChars" /> instance.</param>
         <param name="buffer">
@@ -423,12 +429,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
@@ -485,12 +494,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlChars" /> instance to its equivalent <see cref="T:System.Data.SqlTypes.SqlString" /> representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlString" /> representation of this type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlDateTime.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlDateTime.xml
index ccdc5537bc0..9c63bee4672 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlDateTime.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlDateTime.xml
@@ -231,12 +231,15 @@
         <Parameter Name="t" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Data.SqlTypes.SqlDateTime" /> to the specified TimeSpan.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlDateTime" /> value.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDateTime" /> value.</param>
         <param name="t">
@@ -256,12 +259,54 @@
         <Parameter Name="value" Type="System.Data.SqlTypes.SqlDateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this <see cref="T:System.Data.SqlTypes.SqlDateTime" /> structure to the supplied <see cref="T:System.Data.SqlTypes.SqlDateTime" /> structure and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number that indicates the relative values of the instance and the object.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than <see cref="T:System.Data.SqlTypes.SqlDateTime" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is the same as <see cref="T:System.Data.SqlTypes.SqlDateTime" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than <see cref="T:System.Data.SqlTypes.SqlDateTime" /></para>
+                <para>-or- </para>
+                <para>
+                  <see cref="T:System.Data.SqlTypes.SqlDateTime" /> is a null reference (Nothing in Visual Basic) </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlTypes.SqlDateTime" /> structure to be compared.</param>
       </Docs>
@@ -276,12 +321,53 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this <see cref="T:System.Data.SqlTypes.SqlDateTime" /> structure to the supplied <see cref="T:System.Object" /> and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number that indicates the relative values of the instance and the object.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is the same as the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than the object </para>
+                <para>-or- </para>
+                <para>The object is a null reference (Nothing as Visual Basic). </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to be compared. </param>
       </Docs>
@@ -319,12 +405,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the supplied object parameter to the <see cref="P:System.Data.SqlTypes.SqlDateTime.Value" /> property of the <see cref="T:System.Data.SqlTypes.SqlDateTime" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object is an instance of <see cref="T:System.Data.SqlTypes.SqlDateTime" /> and the two are equal; otherwise false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be compared. </param>
       </Docs>
@@ -344,12 +433,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of two <see cref="T:System.Data.SqlTypes.SqlDateTime" /> structures to determine whether they are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two values are equal. Otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDateTime" /> structure. </param>
         <param name="y">
@@ -368,12 +460,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -393,12 +488,15 @@
         <Parameter Name="schemaSet" Type="System.Xml.Schema.XmlSchemaSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string value that indicates the XSD of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
+        </returns>
         <param name="schemaSet">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</param>
       </Docs>
@@ -414,12 +512,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlDateTime" /> to determine whether the first is greater than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlDateTime" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDateTime" /> structure. </param>
         <param name="y">
@@ -441,12 +542,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlDateTime" /> to determine whether the first is greater than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlDateTime" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDateTime" /> structure. </param>
         <param name="y">
@@ -490,12 +594,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlDateTime" /> to determine whether the first is less than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlDateTime" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDateTime" /> structure. </param>
         <param name="y">
@@ -517,12 +624,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlDateTime" /> to determine whether the first is less than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlDateTime" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDateTime" /> structure. </param>
         <param name="y">
@@ -588,12 +698,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of two instances of <see cref="T:System.Data.SqlTypes.SqlDateTime" /> to determine whether they are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are not equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlDateTime" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDateTime" /> structure. </param>
         <param name="y">
@@ -641,12 +754,15 @@
         <Parameter Name="t" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the period of time indicated by the supplied <see cref="T:System.TimeSpan" /> parameter, <paramref name="t" />, to the supplied <see cref="T:System.Data.SqlTypes.SqlDateTime" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlDateTime" />. If either argument is <see cref="F:System.Data.SqlTypes.SqlDateTime.Null" />, the new <see cref="P:System.Data.SqlTypes.SqlDateTime.Value" /> is <see cref="F:System.Data.SqlTypes.SqlDateTime.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDateTime" /> structure. </param>
         <param name="t">
@@ -668,12 +784,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of two <see cref="T:System.Data.SqlTypes.SqlDateTime" /> structures to determine whether they are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two values are equal. Otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDateTime" /> structure. </param>
         <param name="y">
@@ -735,12 +854,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlDateTime" /> to determine whether the first is greater than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlBoolean" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDateTime" /> structure. </param>
         <param name="y">
@@ -762,12 +884,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlDateTime" /> to determine whether the first is greater than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlDateTime" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDateTime" /> structure. </param>
         <param name="y">
@@ -809,12 +934,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of two instances of <see cref="T:System.Data.SqlTypes.SqlDateTime" /> to determine whether they are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are not equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlDateTime" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDateTime" /> structure. </param>
         <param name="y">
@@ -836,12 +964,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlDateTime" /> to determine whether the first is less than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlDateTime" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDateTime" /> structure. </param>
         <param name="y">
@@ -863,12 +994,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlDateTime" /> to determine whether the first is less than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlDateTime" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDateTime" /> structure. </param>
         <param name="y">
@@ -890,12 +1024,15 @@
         <Parameter Name="t" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts the supplied <see cref="T:System.TimeSpan" /> structure, <paramref name="t" />, from the supplied <see cref="T:System.Data.SqlTypes.SqlDateTime" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlDateTime" /> structure representing the results of the subtraction.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDateTime" /> structure. </param>
         <param name="t">
@@ -912,12 +1049,15 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlDateTime'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> representation of a date and time to its <see cref="T:System.Data.SqlTypes.SqlDateTime" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlDateTime" /> structure equal to the date and time represented by the specified string.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to be parsed. </param>
       </Docs>
@@ -1000,12 +1140,15 @@
         <Parameter Name="t" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts the specified Timespan from this <see cref="T:System.Data.SqlTypes.SqlDateTime" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlDateTime" /> value.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDateTime" /> value.</param>
         <param name="t">
@@ -1023,12 +1166,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XmlSchema.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
@@ -1102,12 +1248,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlString'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlDateTime" /> structure to <see cref="T:System.Data.SqlTypes.SqlString" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A SqlString structure whose value is a string representing the date and time that is contained in this <see cref="T:System.Data.SqlTypes.SqlDateTime" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1122,12 +1271,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlDateTime" /> structure to a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A String representing the <see cref="P:System.Data.SqlTypes.SqlDateTime.Value" /> property of this <see cref="T:System.Data.SqlTypes.SqlDateTime" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlDecimal.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlDecimal.xml
index fd6591272e5..bef38f14871 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlDecimal.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlDecimal.xml
@@ -198,12 +198,15 @@
         <Parameter Name="n" Type="System.Data.SqlTypes.SqlDecimal" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlDecimal'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The Abs method gets the absolute value of the <see cref="T:System.Data.SqlTypes.SqlDecimal" /> parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure whose <see cref="P:System.Data.SqlTypes.SqlDecimal.Value" /> property contains the unsigned number representing the absolute value of the <see cref="T:System.Data.SqlTypes.SqlDecimal" /> parameter.</para>
+        </returns>
         <param name="n">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure. </param>
       </Docs>
@@ -223,12 +226,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDecimal" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlDecimal'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the sum of the two <see cref="T:System.Data.SqlTypes.SqlDecimal" /> operators.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure whose <see cref="P:System.Data.SqlTypes.SqlDecimal.Value" /> property contains the sum.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure. </param>
         <param name="y">
@@ -251,12 +257,15 @@
         <Parameter Name="fRound" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlDecimal'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The scale of the <see cref="T:System.Data.SqlTypes.SqlDecimal" /> operand will be adjusted to the number of digits indicated by the digits parameter. Depending on the value of the fRound parameter, the value will either be rounded to the appropriate number of digits or truncated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure whose <see cref="P:System.Data.SqlTypes.SqlDecimal.Value" /> property contains the adjusted number.</para>
+        </returns>
         <param name="n">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure to be adjusted. </param>
         <param name="digits">
@@ -298,12 +307,15 @@
         <Parameter Name="n" Type="System.Data.SqlTypes.SqlDecimal" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlDecimal'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the smallest whole number greater than or equal to the specified <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlDecimal" /> representing the smallest whole number greater than or equal to the specified <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure.</para>
+        </returns>
         <param name="n">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure for which the ceiling value is to be calculated. </param>
       </Docs>
@@ -325,12 +337,53 @@
         <Parameter Name="value" Type="System.Data.SqlTypes.SqlDecimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this <see cref="T:System.Data.SqlTypes.SqlDecimal" /> instance to the supplied <see cref="T:System.Data.SqlTypes.SqlDecimal" /> object and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number that indicates the relative values of the instance and the object.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is the same as the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than the object </para>
+                <para>-or- </para>
+                <para>The object is a null reference (Nothing in Visual Basic) </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlTypes.SqlDecimal" /> to be compared. </param>
       </Docs>
@@ -345,12 +398,53 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this <see cref="T:System.Data.SqlTypes.SqlDecimal" /> instance to the supplied <see cref="T:System.Object" /> and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number that indicates the relative values of the instance and the object.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is the same as the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than the object </para>
+                <para>-or- </para>
+                <para>The object is a null reference (Nothing in Visual Basic) </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to be compared. </param>
       </Docs>
@@ -371,12 +465,15 @@
         <Parameter Name="scale" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlDecimal'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adjusts the value of the <see cref="T:System.Data.SqlTypes.SqlDecimal" /> operand to the indicated precision and scale.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure whose Value has been adjusted to the precision and scale indicated in the parameters.</para>
+        </returns>
         <param name="n">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure whose value is to be adjusted. </param>
         <param name="precision">
@@ -419,12 +516,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDecimal" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlDecimal'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The division operator calculates the results of dividing the first <see cref="T:System.Data.SqlTypes.SqlDecimal" /> operand by the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure whose <see cref="P:System.Data.SqlTypes.SqlDecimal.Value" /> property contains the results of the division.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure. </param>
         <param name="y">
@@ -445,12 +545,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the supplied <see cref="T:System.Object" /> parameter to the <see cref="P:System.Data.SqlTypes.SqlDecimal.Value" /> property of the <see cref="T:System.Data.SqlTypes.SqlDecimal" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if object is an instance of <see cref="T:System.Data.SqlTypes.SqlDecimal" /> and the two are equal. Otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to be compared.</param>
       </Docs>
@@ -470,12 +573,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDecimal" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlDecimal" /> operands to determine whether they are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two values are equal. Otherwise, false. If either instance is null, the value of the SqlDecimal will be null.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure. </param>
         <param name="y">
@@ -496,12 +602,15 @@
         <Parameter Name="n" Type="System.Data.SqlTypes.SqlDecimal" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlDecimal'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Rounds a specified <see cref="T:System.Data.SqlTypes.SqlDecimal" /> number to the next lower whole number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure that contains the whole number part of this <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure.</para>
+        </returns>
         <param name="n">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure for which the floor value is to be calculated. </param>
       </Docs>
@@ -518,12 +627,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -543,12 +655,15 @@
         <Parameter Name="schemaSet" Type="System.Xml.Schema.XmlSchemaSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string value that indicates the XSD of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
+        </returns>
         <param name="schemaSet">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</param>
       </Docs>
@@ -564,12 +679,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDecimal" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of two <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structures to determine whether the first is greater than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlDecimal" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure. </param>
         <param name="y">
@@ -591,12 +709,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDecimal" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlDecimal" /> parameters to determine whether the first is greater than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlDecimal" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure. </param>
         <param name="y">
@@ -659,12 +780,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDecimal" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of two <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structures to determine whether the first is less than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlDecimal" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure. </param>
         <param name="y">
@@ -686,12 +810,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDecimal" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlDecimal" /> parameters to determine whether the first is less than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlDecimal" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure. </param>
         <param name="y">
@@ -800,12 +927,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDecimal" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlDecimal'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The multiplication operator computes the product of the two <see cref="T:System.Data.SqlTypes.SqlDecimal" /> parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure whose <see cref="P:System.Data.SqlTypes.SqlDecimal.Value" /> property contains the product of the multiplication.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure. </param>
         <param name="y">
@@ -827,12 +957,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDecimal" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlDecimal" /> parameters to determine whether they are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are not equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlDecimal" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure. </param>
         <param name="y">
@@ -880,12 +1013,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDecimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the sum of the two <see cref="T:System.Data.SqlTypes.SqlDecimal" /> operators.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure whose <see cref="P:System.Data.SqlTypes.SqlDecimal.Value" /> property contains the sum.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure. </param>
         <param name="y">
@@ -907,12 +1043,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDecimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The division operator calculates the results of dividing the first <see cref="T:System.Data.SqlTypes.SqlDecimal" /> operand by the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure whose <see cref="P:System.Data.SqlTypes.SqlDecimal.Value" /> property contains the results of the division.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure. </param>
         <param name="y">
@@ -934,12 +1073,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDecimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlDecimal" /> operands to determine whether they are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are not equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlDecimal" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure. </param>
         <param name="y">
@@ -1080,12 +1222,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDecimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of two <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structures to determine whether the first is greater than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlDecimal" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure. </param>
         <param name="y">
@@ -1107,12 +1252,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDecimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlDecimal" /> parameters to determine whether the first is greater than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlDecimal" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure. </param>
         <param name="y">
@@ -1273,12 +1421,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDecimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlDecimal" /> parameters to determine whether they are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are not equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlDecimal" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure. </param>
         <param name="y">
@@ -1300,12 +1451,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDecimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of two <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structures to determine whether the first is less than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlDecimal" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure. </param>
         <param name="y">
@@ -1327,12 +1481,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDecimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlDecimal" /> parameters to determine whether the first is less than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlDecimal" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure. </param>
         <param name="y">
@@ -1354,12 +1511,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDecimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The multiplication operator computes the product of the two <see cref="T:System.Data.SqlTypes.SqlDecimal" /> parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure whose <see cref="P:System.Data.SqlTypes.SqlDecimal.Value" /> property contains the product of the multiplication.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure. </param>
         <param name="y">
@@ -1381,12 +1541,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDecimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the results of subtracting the second <see cref="T:System.Data.SqlTypes.SqlDecimal" /> operand from the first.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure whose Value property contains the results of the subtraction.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure. </param>
         <param name="y">
@@ -1407,12 +1570,15 @@
         <Parameter Name="x" Type="System.Data.SqlTypes.SqlDecimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The unary minus operator negates the <see cref="T:System.Data.SqlTypes.SqlDecimal" /> parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure whose value contains the results of the negation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure to be negated. </param>
       </Docs>
@@ -1427,12 +1593,15 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlDecimal'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.String" /> representation of a number to its <see cref="T:System.Data.SqlTypes.SqlDecimal" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlDecimal" /> equivalent to the value that is contained in the specified <see cref="T:System.String" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The String to be parsed. </param>
       </Docs>
@@ -1452,12 +1621,15 @@
         <Parameter Name="exp" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlDecimal'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Raises the value of the specified <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure to the specified exponential power.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure that contains the results.</para>
+        </returns>
         <param name="n">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure to be raised to a power. </param>
         <param name="exp">
@@ -1498,12 +1670,15 @@
         <Parameter Name="position" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlDecimal'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the number nearest the specified <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure's value with the specified precision.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure that contains the results of the rounding operation.</para>
+        </returns>
         <param name="n">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure to be rounded. </param>
         <param name="position">
@@ -1543,12 +1718,15 @@
         <Parameter Name="n" Type="System.Data.SqlTypes.SqlDecimal" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt32'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates the sign of a <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure's <see cref="P:System.Data.SqlTypes.SqlDecimal.Value" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A number that indicates the sign of the <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure.</para>
+        </returns>
         <param name="n">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure whose sign is to be evaluated. </param>
       </Docs>
@@ -1568,12 +1746,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDecimal" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlDecimal'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the results of subtracting the second <see cref="T:System.Data.SqlTypes.SqlDecimal" /> operand from the first.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure whose Value property contains the results of the subtraction.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure. </param>
         <param name="y">
@@ -1595,12 +1776,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XmlSchema.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
@@ -1655,12 +1839,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'double'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the a double equal to the contents of the <see cref="P:System.Data.SqlTypes.SqlDecimal.Value" /> property of this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The decimal representation of the <see cref="P:System.Data.SqlTypes.SqlDecimal.Value" /> property.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1675,12 +1862,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure to <see cref="T:System.Data.SqlTypes.SqlBoolean" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="P:System.Data.SqlTypes.SqlDecimal.Value" /> is non-zero; false if zero; otherwise Null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1695,12 +1885,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlByte'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure to <see cref="T:System.Data.SqlTypes.SqlByte" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure whose Value equals the Value of this <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure. If the <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure's Value is true, the <see cref="T:System.Data.SqlTypes.SqlByte" /> structure's Value will be 1. Otherwise, the <see cref="T:System.Data.SqlTypes.SqlByte" /> structure's Value will be 0.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1715,12 +1908,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlDouble'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure to <see cref="T:System.Data.SqlTypes.SqlDouble" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure with the same value as this instance of <see cref="T:System.Data.SqlTypes.SqlDecimal" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1735,12 +1931,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlInt16'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure to <see cref="T:System.Data.SqlTypes.SqlInt16" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure with the same value as this instance of <see cref="T:System.Data.SqlTypes.SqlDecimal" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1755,12 +1954,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlInt32'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure to <see cref="T:System.Data.SqlTypes.SqlInt32" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure with the same value as this instance of <see cref="T:System.Data.SqlTypes.SqlDecimal" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1775,12 +1977,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlInt64'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure to <see cref="T:System.Data.SqlTypes.SqlInt64" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure with the same value as this instance of <see cref="T:System.Data.SqlTypes.SqlDecimal" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1795,12 +2000,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlMoney'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure to <see cref="T:System.Data.SqlTypes.SqlMoney" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure with the same value as this instance of <see cref="T:System.Data.SqlTypes.SqlDecimal" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1815,12 +2023,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlSingle'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure to <see cref="T:System.Data.SqlTypes.SqlSingle" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure with the same value as this instance of <see cref="T:System.Data.SqlTypes.SqlDecimal" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1835,12 +2046,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlString'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure to <see cref="T:System.Data.SqlTypes.SqlString" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlString" /> structure whose value is a string representing the value contained in this <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1855,12 +2069,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure to <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.String" /> object that contains the string representation of the <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure's <see cref="P:System.Data.SqlTypes.SqlDecimal.Value" /> property.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1878,12 +2095,15 @@
         <Parameter Name="position" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlDecimal'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Truncates the specified <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure's value to the that you want position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Supply a negative value for the <paramref name="position" /> parameter in order to truncate the value to the corresponding position to the left of the decimal point.</para>
+        </returns>
         <param name="n">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure to be truncated. </param>
         <param name="position">
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlDouble.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlDouble.xml
index b14589453cc..38ac999299b 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlDouble.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlDouble.xml
@@ -63,12 +63,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDouble" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlDouble'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The addition operator computes the sum of the two <see cref="T:System.Data.SqlTypes.SqlDouble" /> operands.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the two <see cref="T:System.Data.SqlTypes.SqlDouble" /> operands.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure. </param>
         <param name="y">
@@ -92,12 +95,53 @@
         <Parameter Name="value" Type="System.Data.SqlTypes.SqlDouble" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this <see cref="T:System.Data.SqlTypes.SqlDouble" /> instance to the supplied <see cref="T:System.Data.SqlTypes.SqlDouble" /> and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number that indicates the relative values of the instance and the object.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is the same as the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than the object </para>
+                <para>-or- </para>
+                <para>The object is a null reference (Nothing in Visual Basic) </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlTypes.SqlDouble" /> to be compared. </param>
       </Docs>
@@ -112,12 +156,53 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this <see cref="T:System.Data.SqlTypes.SqlDouble" /> instance to the supplied <see cref="T:System.Object" /> and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number that indicates the relative values of the instance and the object.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is the same as the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than the object </para>
+                <para>-or- </para>
+                <para>The object is a null reference (Nothing in Visual Basic). </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to compare. </param>
       </Docs>
@@ -137,12 +222,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDouble" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlDouble'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The division operator divides the first <see cref="T:System.Data.SqlTypes.SqlDouble" /> operand by the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure that contains the results of the division operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure. </param>
         <param name="y">
@@ -163,12 +251,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the supplied object parameter to the <see cref="P:System.Data.SqlTypes.SqlDateTime.Value" /> property of the <see cref="T:System.Data.SqlTypes.SqlDouble" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two values are equal. Otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be compared. </param>
       </Docs>
@@ -188,12 +279,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDouble" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison on two instances of <see cref="T:System.Data.SqlTypes.SqlDouble" /> to determine whether they are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two values are equal. Otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure. </param>
         <param name="y">
@@ -212,12 +306,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this <see cref="T:System.Data.SqlTypes.SqlDouble" /> structre.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -237,12 +334,15 @@
         <Parameter Name="schemaSet" Type="System.Xml.Schema.XmlSchemaSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string value that indicates the XSD of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
+        </returns>
         <param name="schemaSet">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</param>
       </Docs>
@@ -258,12 +358,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDouble" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlDouble" /> to determine whether the first is greater than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlDouble" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure. </param>
         <param name="y">
@@ -285,12 +388,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDouble" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlDouble" /> to determine whether the first is greater than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlDouble" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure. </param>
         <param name="y">
@@ -334,12 +440,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDouble" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlDouble" /> to determine whether the first is less than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlDouble" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure. </param>
         <param name="y">
@@ -361,12 +470,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDouble" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlDouble" /> to determine whether the first is less than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlDouble" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure. </param>
         <param name="y">
@@ -432,12 +544,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDouble" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlDouble'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The multiplication operator computes the product of the two <see cref="T:System.Data.SqlTypes.SqlDouble" /> operands.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The product of the two <see cref="T:System.Data.SqlTypes.SqlDouble" /> operands.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure. </param>
         <param name="y">
@@ -459,12 +574,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDouble" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlDouble" /> to determine whether they are notequal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are not equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlDouble" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure. </param>
         <param name="y">
@@ -512,12 +630,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDouble" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The addition operator computes the sum of the two <see cref="T:System.Data.SqlTypes.SqlDouble" /> operands.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of the two <see cref="T:System.Data.SqlTypes.SqlDouble" /> operands.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure. </param>
         <param name="y">
@@ -539,12 +660,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDouble" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The division operator divides the first <see cref="T:System.Data.SqlTypes.SqlDouble" /> operand by the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure that contains the results of the division operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure. </param>
         <param name="y">
@@ -566,12 +690,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDouble" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison on two instances of <see cref="T:System.Data.SqlTypes.SqlDouble" /> to determine whether they are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two values are equal. Otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure. </param>
         <param name="y">
@@ -653,12 +780,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDouble" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlDouble" /> to determine whether the first is greater than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlDouble" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure. </param>
         <param name="y">
@@ -680,12 +810,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDouble" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlDouble" /> to determine whether the first is greater than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlDouble" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure. </param>
         <param name="y">
@@ -867,12 +1000,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDouble" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlDouble" /> to determine whether they are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are not equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlDouble" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure. </param>
         <param name="y">
@@ -894,12 +1030,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDouble" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlDouble" /> to determine whether the first is less than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlDouble" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure. </param>
         <param name="y">
@@ -921,12 +1060,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDouble" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlDouble" /> to determine whether the first is less than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlDouble" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure. </param>
         <param name="y">
@@ -948,12 +1090,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDouble" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The multiplication operator computes the product of the two <see cref="T:System.Data.SqlTypes.SqlDouble" /> operands.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The product of the two <see cref="T:System.Data.SqlTypes.SqlDouble" /> operands.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure. </param>
         <param name="y">
@@ -975,12 +1120,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDouble" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The subtraction operator the second <see cref="T:System.Data.SqlTypes.SqlDouble" /> operand from the first.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The results of the subtraction operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure. </param>
         <param name="y">
@@ -1001,12 +1149,15 @@
         <Parameter Name="x" Type="System.Data.SqlTypes.SqlDouble" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the negated value of the specified <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure that contains the negated value.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure. </param>
       </Docs>
@@ -1021,12 +1172,15 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlDouble'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.String" /> representation of a number to its double-precision floating point number equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlDouble" /> that contains the value represented by the String.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The String to be parsed. </param>
       </Docs>
@@ -1046,12 +1200,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlDouble" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlDouble'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The subtraction operator the second <see cref="T:System.Data.SqlTypes.SqlDouble" /> operand from the first.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The results of the subtraction operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure. </param>
         <param name="y">
@@ -1073,12 +1230,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML schema consumed by .NET Framework.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
@@ -1133,12 +1293,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure to <see cref="T:System.Data.SqlTypes.SqlBoolean" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A SqlBoolean structure whose <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure's <see cref="P:System.Data.SqlTypes.SqlDouble.Value" /> is non-zero, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the <see cref="T:System.Data.SqlTypes.SqlDouble" /> is zero and <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" /> if the <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure is <see cref="F:System.Data.SqlTypes.SqlDouble.Null" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1153,12 +1316,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlByte'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure to <see cref="T:System.Data.SqlTypes.SqlByte" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A SqlByte structure whose Value equals the Value of this <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1173,12 +1339,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlDecimal'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure to <see cref="T:System.Data.SqlTypes.SqlDecimal" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new SqlDecimal structure whose converted value equals the rounded value of this SqlDouble.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1193,12 +1362,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlInt16'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure to <see cref="T:System.Data.SqlTypes.SqlInt16" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure whose Value equals the integer part of the <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure's value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1213,12 +1385,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlInt32'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure to <see cref="T:System.Data.SqlTypes.SqlInt32" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure whose Value equals the integer part of the <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure's value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1233,12 +1408,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlInt64'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure to <see cref="T:System.Data.SqlTypes.SqlInt64" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure whose Value equals the integer part of the <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure's value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1253,12 +1431,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlMoney'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure to <see cref="T:System.Data.SqlTypes.SqlMoney" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new SqlMoney structure whose <see cref="P:System.Data.SqlTypes.SqlMoney.Value" /> is equal to the value of this <see cref="T:System.Data.SqlTypes.SqlDouble" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1273,12 +1454,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlSingle'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure to <see cref="T:System.Data.SqlTypes.SqlSingle" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new SqlSingle structure whose <see cref="P:System.Data.SqlTypes.SqlSingle.Value" /> is equal to the <see cref="P:System.Data.SqlTypes.SqlDouble.Value" /> of this <see cref="T:System.Data.SqlTypes.SqlDouble" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1293,12 +1477,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlString'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure to <see cref="T:System.Data.SqlTypes.SqlString" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A SqlString representing the <see cref="P:System.Data.SqlTypes.SqlDouble.Value" /> of this <see cref="T:System.Data.SqlTypes.SqlDouble" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1313,12 +1500,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure to a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representing the <see cref="P:System.Data.SqlTypes.SqlDouble.Value" /> of this <see cref="T:System.Data.SqlTypes.SqlDouble" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlGuid.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlGuid.xml
index 5b9404b0982..359da9bfc05 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlGuid.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlGuid.xml
@@ -161,12 +161,53 @@
         <Parameter Name="value" Type="System.Data.SqlTypes.SqlGuid" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this <see cref="T:System.Data.SqlTypes.SqlGuid" /> structure to the supplied <see cref="T:System.Data.SqlTypes.SqlGuid" /> and returns an indication of their relative values. Compares more than the last 6 bytes, but treats the last 6 bytes as the most significant ones in comparisons.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number that indicates the relative values of the instance and the object.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is the same as object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than object </para>
+                <para>-or- </para>
+                <para>object is a null reference (Nothing). </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlTypes.SqlGuid" /> to be compared.</param>
       </Docs>
@@ -181,12 +222,53 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this <see cref="T:System.Data.SqlTypes.SqlGuid" /> structure to the supplied object and returns an indication of their relative values. Compares more than the last 6 bytes, but treats the last 6 bytes as the most significant ones in comparisons.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number that indicates the relative values of the instance and the object.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is the same as object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than object </para>
+                <para>-or- </para>
+                <para>object is a null reference (Nothing) </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to be compared. </param>
       </Docs>
@@ -205,12 +287,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the supplied object parameter to the <see cref="P:System.Data.SqlTypes.SqlGuid.Value" /> property of the <see cref="T:System.Data.SqlTypes.SqlGuid" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if object is an instance of <see cref="T:System.Data.SqlTypes.SqlGuid" /> and the two are equal; otherwise false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be compared. </param>
       </Docs>
@@ -230,12 +315,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlGuid" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of two <see cref="T:System.Data.SqlTypes.SqlGuid" /> structures to determine whether they are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two values are equal. Otherwise, false. If either instance is null, then the SqlGuid will be null.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlGuid" /> structure. </param>
         <param name="y">
@@ -254,12 +342,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code of this <see cref="T:System.Data.SqlTypes.SqlGuid" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -279,12 +370,15 @@
         <Parameter Name="schemaSet" Type="System.Xml.Schema.XmlSchemaSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string value that indicates the XSD of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
+        </returns>
         <param name="schemaSet">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</param>
       </Docs>
@@ -300,12 +394,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlGuid" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlGuid" /> to determine whether the first is greater than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlGuid" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlGuid" /> structure. </param>
         <param name="y">
@@ -327,12 +424,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlGuid" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlGuid" /> to determine whether the first is greater than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlGuid" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlGuid" /> structure. </param>
         <param name="y">
@@ -376,12 +476,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlGuid" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlGuid" /> to determine whether the first is less than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlGuid" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlGuid" /> structure. </param>
         <param name="y">
@@ -403,12 +506,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlGuid" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlGuid" /> to determine whether the first is less than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlGuid" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlGuid" /> structure. </param>
         <param name="y">
@@ -430,12 +536,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlGuid" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison on two <see cref="T:System.Data.SqlTypes.SqlGuid" /> structures to determine whether they are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are not equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlGuid" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlGuid" /> structure. </param>
         <param name="y">
@@ -484,12 +593,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlGuid" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of two <see cref="T:System.Data.SqlTypes.SqlGuid" /> structures to determine whether they are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are not equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlGuid" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlGuid" /> structure. </param>
         <param name="y">
@@ -571,12 +683,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlGuid" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlGuid" /> to determine whether the first is greater than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlGuid" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlGuid" /> structure. </param>
         <param name="y">
@@ -598,12 +713,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlGuid" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlGuid" /> to determine whether the first is greater than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlGuid" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlGuid" /> structure. </param>
         <param name="y">
@@ -645,12 +763,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlGuid" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison on two <see cref="T:System.Data.SqlTypes.SqlGuid" /> structures to determine whether they are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are not equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlGuid" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlGuid" /> structure. </param>
         <param name="y">
@@ -672,12 +793,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlGuid" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlGuid" /> to determine whether the first is less than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlGuid" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlGuid" /> structure. </param>
         <param name="y">
@@ -699,12 +823,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlGuid" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlGuid" /> to determine whether the first is less than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlGuid" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlGuid" /> structure. </param>
         <param name="y">
@@ -721,12 +848,15 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlGuid'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> structure to <see cref="T:System.Data.SqlTypes.SqlGuid" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlGuid" /> equivalent to the value that is contained in the specified <see cref="T:System.String" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The String to be parsed. </param>
       </Docs>
@@ -746,12 +876,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XmlSchema.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
@@ -806,12 +939,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlGuid" /> structure to a byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of bytes representing the <see cref="P:System.Data.SqlTypes.SqlGuid.Value" /> of this <see cref="T:System.Data.SqlTypes.SqlGuid" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -826,12 +962,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlBinary'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlGuid" /> structure to <see cref="T:System.Data.SqlTypes.SqlBinary" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A SqlBinary structure that contains the bytes in the <see cref="T:System.Data.SqlTypes.SqlGuid" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -846,12 +985,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlString'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlGuid" /> structure to <see cref="T:System.Data.SqlTypes.SqlString" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlString" /> structure that contains the string representation of the <see cref="T:System.Data.SqlTypes.SqlGuid" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -866,12 +1008,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlGuid" /> structure to a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that contains the string representation of the <see cref="T:System.Data.SqlTypes.SqlGuid" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlInt16.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlInt16.xml
index 79f726e5c33..75cb588f9b3 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlInt16.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlInt16.xml
@@ -63,12 +63,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt16'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the two <see cref="T:System.Data.SqlTypes.SqlInt16" /> operands.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt16.Value" /> property contains the sum of the two <see cref="T:System.Data.SqlTypes.SqlInt16" /> operands.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
         <param name="y">
@@ -90,12 +93,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt16'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the bitwise AND of its <see cref="T:System.Data.SqlTypes.SqlInt16" /> operands.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt16.Value" /> property contains the results of the bitwise AND.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
         <param name="y">
@@ -117,12 +123,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt16'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the bitwise OR of its two <see cref="T:System.Data.SqlTypes.SqlInt16" /> operands.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt16.Value" /> property contains the results of the bitwise OR.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
         <param name="y">
@@ -146,12 +155,53 @@
         <Parameter Name="value" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this <see cref="T:System.Data.SqlTypes.SqlInt16" /> instance to the supplied <see cref="T:System.Data.SqlTypes.SqlInt16" /> and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number that indicates the relative values of the instance and the object.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is the same as the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than the object </para>
+                <para>-or- </para>
+                <para>The object is a null reference (Nothing in Visual Basic) </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlTypes.SqlInt16" /> to be compared.</param>
       </Docs>
@@ -166,12 +216,53 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this <see cref="T:System.Data.SqlTypes.SqlInt16" /> instance to the supplied <see cref="T:System.Object" /> and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number that indicates the relative values of the instance and the object.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is the same as the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than the object </para>
+                <para>-or- </para>
+                <para>object is a null reference (Nothing in Visual Basic) </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to be compared. </param>
       </Docs>
@@ -191,12 +282,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt16'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Divides the first <see cref="T:System.Data.SqlTypes.SqlInt16" /> operand by the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt16" /> whose <see cref="P:System.Data.SqlTypes.SqlInt16.Value" /> property contains the results of the division.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
         <param name="y">
@@ -217,12 +311,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the specified object to the <see cref="P:System.Data.SqlTypes.SqlInt16.Value" /> property of the <see cref="T:System.Data.SqlTypes.SqlInt16" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if object is an instance of <see cref="T:System.Data.SqlTypes.SqlInt16" /> and the two are equal; otherwise false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be compared. </param>
       </Docs>
@@ -242,12 +339,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of two <see cref="T:System.Data.SqlTypes.SqlInt16" /> structures to determine whether they are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two values are equal. Otherwise, false. If either instance is null, then the SqlInt16 will be null.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
         <param name="y">
@@ -266,12 +366,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -291,12 +394,15 @@
         <Parameter Name="schemaSet" Type="System.Xml.Schema.XmlSchemaSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> value that indicates the XSD of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
+        </returns>
         <param name="schemaSet">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</param>
       </Docs>
@@ -312,12 +418,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlInt16" /> to determine whether the first is greater than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt16" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
         <param name="y">
@@ -339,12 +448,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Data.SqlTypes.SqlInt16" /> structures to determine whether the first is greater than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt16" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
         <param name="y">
@@ -385,12 +497,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlInt16" /> to determine whether the first is less than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt16" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
         <param name="y">
@@ -412,12 +527,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Data.SqlTypes.SqlInt16" /> structures to determine whether the first is less than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt16" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
         <param name="y">
@@ -483,12 +601,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt16'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the remainder after dividing its first <see cref="T:System.Data.SqlTypes.SqlInt16" /> operand by its second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt16.Value" /> contains the remainder.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
         <param name="y">
@@ -513,7 +634,6 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If either instance of <paramref name="x" /> or <paramref name="y" /> is null, the value is null.</para>
@@ -522,6 +642,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Divides two <see cref="T:System.Data.SqlTypes.SqlInt16" /> values and returns the remainder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The remainder left after division is performed on <paramref name="x" /> and <paramref name="y" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> value.</param>
         <param name="y">
@@ -539,12 +663,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt16'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the product of the two <see cref="T:System.Data.SqlTypes.SqlInt16" /> parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt16.Value" /> contains the product of the two parameters.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
         <param name="y">
@@ -566,12 +693,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of two <see cref="T:System.Data.SqlTypes.SqlInt16" /> structures to determine whether they are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are not equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt16" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
         <param name="y">
@@ -615,12 +745,15 @@
         <Parameter Name="x" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt16'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The ~ operator performs a bitwise one's complement operation on its <see cref="T:System.Data.SqlTypes.SqlByte" /> operand.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt16.Value" /> property contains the complement of the specified <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
       </Docs>
@@ -644,12 +777,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the two <see cref="T:System.Data.SqlTypes.SqlInt16" /> operands.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt16.Value" /> property contains the sum of the two <see cref="T:System.Data.SqlTypes.SqlInt16" /> operands.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
         <param name="y">
@@ -671,12 +807,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the bitwise AND of its <see cref="T:System.Data.SqlTypes.SqlInt16" /> operands.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt16.Value" /> property contains the results of the bitwise AND.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
         <param name="y">
@@ -698,12 +837,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the bitwise OR of its two <see cref="T:System.Data.SqlTypes.SqlInt16" /> operands.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt16.Value" /> property contains the results of the bitwise OR.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
         <param name="y">
@@ -725,12 +867,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Divides the first <see cref="T:System.Data.SqlTypes.SqlInt16" /> operand by the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt16" /> whose <see cref="P:System.Data.SqlTypes.SqlInt16.Value" /> property contains the results of the division.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
         <param name="y">
@@ -752,12 +897,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of two <see cref="T:System.Data.SqlTypes.SqlInt16" /> structures to determine whether they are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are not equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt16" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
         <param name="y">
@@ -779,12 +927,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a bitwise exclusive-OR operation on the supplied parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt16.Value" /> property contains the results of the bitwise XOR.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
         <param name="y">
@@ -986,12 +1137,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlInt16" /> to determine whether the first is greater than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt16" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
         <param name="y">
@@ -1013,12 +1167,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Data.SqlTypes.SqlInt16" /> structures to determine whether the first is greater than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt16" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
         <param name="y">
@@ -1080,12 +1237,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of two <see cref="T:System.Data.SqlTypes.SqlInt16" /> structures to determine whether they are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are not equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt16" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
         <param name="y">
@@ -1107,12 +1267,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two instances of <see cref="T:System.Data.SqlTypes.SqlInt16" /> to determine whether the first is less than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt16" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
         <param name="y">
@@ -1134,12 +1297,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Data.SqlTypes.SqlInt16" /> structures to determine whether the first is less than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt16" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
         <param name="y">
@@ -1161,12 +1327,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the remainder after dividing its first <see cref="T:System.Data.SqlTypes.SqlInt16" /> operand by its second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt16.Value" /> contains the remainder.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
         <param name="y">
@@ -1188,12 +1357,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the product of the two <see cref="T:System.Data.SqlTypes.SqlInt16" /> parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt16.Value" /> contains the product of the two parameters.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
         <param name="y">
@@ -1214,12 +1386,15 @@
         <Parameter Name="x" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The ~ operator performs a bitwise one's complement operation on its <see cref="T:System.Data.SqlTypes.SqlByte" /> operand.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt16.Value" /> property contains the complement of the specified <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
       </Docs>
@@ -1239,12 +1414,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts the second <see cref="T:System.Data.SqlTypes.SqlInt16" /> parameter from the first.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt16.Value" /> property contains the results of the subtraction.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
         <param name="y">
@@ -1265,12 +1443,15 @@
         <Parameter Name="x" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The unary minus operator negates the <see cref="P:System.Data.SqlTypes.SqlInt16.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlInt16" /> operand.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure that contains the negated value.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
       </Docs>
@@ -1285,12 +1466,15 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt16'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.String" /> representation of a number to its 16-bit signed integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit signed integer equivalent to the value that is contained in the specified <see cref="T:System.String" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The String to be parsed. </param>
       </Docs>
@@ -1310,12 +1494,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt16'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts the second <see cref="T:System.Data.SqlTypes.SqlInt16" /> parameter from the first.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt16.Value" /> property contains the results of the subtraction.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
         <param name="y">
@@ -1337,12 +1524,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML schema consumed by .NET Framework.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
@@ -1397,12 +1587,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure to <see cref="T:System.Data.SqlTypes.SqlBoolean" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="P:System.Data.SqlTypes.SqlInt16.Value" /> is non-zero; false if zero; otherwise Null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1417,12 +1610,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlByte'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure to <see cref="T:System.Data.SqlTypes.SqlByte" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt16.Value" /> equals the <see cref="P:System.Data.SqlTypes.SqlInt16.Value" /> of this <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. If the value of the <see cref="T:System.Data.SqlTypes.SqlInt16" /> is less than 0 or greater than 255, an <see cref="T:System.OverflowException" /> occurs.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1437,12 +1633,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlDecimal'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure to <see cref="T:System.Data.SqlTypes.SqlDecimal" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure whose Value equals the value of this <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1457,12 +1656,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlDouble'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure to <see cref="T:System.Data.SqlTypes.SqlDouble" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure whose Value equals the value of this <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1477,12 +1679,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlInt32'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure to <see cref="T:System.Data.SqlTypes.SqlInt32" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure whose Value equals the value of this <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1497,12 +1702,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlInt64'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure to <see cref="T:System.Data.SqlTypes.SqlInt64" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure whose Value equals the value of this <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1517,12 +1725,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlMoney'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure to <see cref="T:System.Data.SqlTypes.SqlMoney" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure whose Value equals the value of this <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1537,12 +1748,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlSingle'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure to <see cref="T:System.Data.SqlTypes.SqlSingle" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure whose Value equals the value of this <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1557,12 +1771,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlString'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure to <see cref="T:System.Data.SqlTypes.SqlString" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlString" /> representing the <see cref="P:System.Data.SqlTypes.SqlInt16.Value" /> of this instance of <see cref="T:System.Data.SqlTypes.SqlInt16" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1577,12 +1794,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure to <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> object representing the <see cref="P:System.Data.SqlTypes.SqlInt16.Value" /> of this instance of <see cref="T:System.Data.SqlTypes.SqlInt16" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1619,12 +1839,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt16'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a bitwise exclusive-OR operation on the supplied parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure that contains the results of the XOR operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure. </param>
         <param name="y">
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlInt32.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlInt32.xml
index ca309c2c0eb..bf39af9b540 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlInt32.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlInt32.xml
@@ -63,12 +63,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt32'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the two specified <see cref="T:System.Data.SqlTypes.SqlInt32" /> structures.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt32.Value" /> property contains the sum of the specified <see cref="T:System.Data.SqlTypes.SqlInt32" /> structures.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
         <param name="y">
@@ -90,12 +93,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt32'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the bitwise AND of its <see cref="T:System.Data.SqlTypes.SqlInt32" /> operands.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure that contains the results of the bitwise AND operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
         <param name="y">
@@ -117,12 +123,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt32'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the bitwise OR of the specified <see cref="T:System.Data.SqlTypes.SqlInt32" /> structures.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure that contains the results of the bitwise OR operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
         <param name="y">
@@ -146,12 +155,53 @@
         <Parameter Name="value" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this <see cref="T:System.Data.SqlTypes.SqlInt32" /> instance to the supplied <see cref="T:System.Data.SqlTypes.SqlInt32" /> and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number that indicates the relative values of the instance and the object.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is the same as the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than the object </para>
+                <para>-or- </para>
+                <para>The object is a null reference (Nothing in Visual Basic) </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlTypes.SqlInt32" /> to be compared.</param>
       </Docs>
@@ -166,12 +216,53 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this <see cref="T:System.Data.SqlTypes.SqlInt32" /> instance to the supplied <see cref="T:System.Object" /> and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number that indicates the relative values of the instance and the object.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is the same as the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than the object </para>
+                <para>-or- </para>
+                <para>The object is a null reference (Nothing in Visual Basic). </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to be compared. </param>
       </Docs>
@@ -191,12 +282,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt32'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Divides the first <see cref="T:System.Data.SqlTypes.SqlInt32" /> parameter from the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt32" /> whose <see cref="P:System.Data.SqlTypes.SqlInt32.Value" /> property contains the results of the division.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
         <param name="y">
@@ -217,12 +311,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the supplied object parameter to the <see cref="P:System.Data.SqlTypes.SqlInt32.Value" /> property of the <see cref="T:System.Data.SqlTypes.SqlInt32" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if object is an instance of <see cref="T:System.Data.SqlTypes.SqlInt32" /> and the two are equal; otherwise false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be compared. </param>
       </Docs>
@@ -242,12 +339,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlInt32" /> parameters to determine whether they are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two values are equal. Otherwise, false. If either instance is null, then the SqlInt32 will be null.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
         <param name="y">
@@ -266,12 +366,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -291,12 +394,15 @@
         <Parameter Name="schemaSet" Type="System.Xml.Schema.XmlSchemaSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string value that indicates the XSD of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
+        </returns>
         <param name="schemaSet">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</param>
       </Docs>
@@ -312,12 +418,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the two <see cref="T:System.Data.SqlTypes.SqlInt32" /> parameters to determine whether the first is greater than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt32" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
         <param name="y">
@@ -339,12 +448,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the two <see cref="T:System.Data.SqlTypes.SqlInt32" /> parameters to determine whether the first is greater than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt32" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
         <param name="y">
@@ -388,12 +500,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the two <see cref="T:System.Data.SqlTypes.SqlInt32" /> parameters to determine whether the first is less than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt32" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
         <param name="y">
@@ -415,12 +530,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the two <see cref="T:System.Data.SqlTypes.SqlInt32" /> parameters to determine whether the first is less than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt32" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
         <param name="y">
@@ -486,12 +604,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt32'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the remainder after dividing the first <see cref="T:System.Data.SqlTypes.SqlInt32" /> parameter by the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt32.Value" /> contains the remainder.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
         <param name="y">
@@ -516,7 +637,6 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If either instance of <paramref name="x" /> or <paramref name="y" /> is null, the value will be null.</para>
@@ -525,6 +645,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Divides two <see cref="T:System.Data.SqlTypes.SqlInt32" /> values and returns the remainder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The remainder left after division is performed on <paramref name="x" /> and <paramref name="y" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> value.</param>
         <param name="y">
@@ -542,12 +666,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt32'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the product of the two <see cref="T:System.Data.SqlTypes.SqlInt32" /> parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt32.Value" /> contains the product of the two parameters.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
         <param name="y">
@@ -569,12 +696,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlInt32" /> parameters to determine whether they are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are not equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt32" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
         <param name="y">
@@ -618,12 +748,15 @@
         <Parameter Name="x" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt32'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a bitwise one's complement operation on the specified <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure that contains the results of the one's complement operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
       </Docs>
@@ -647,12 +780,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the two specified <see cref="T:System.Data.SqlTypes.SqlInt32" /> structures.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt32.Value" /> property contains the sum of the specified <see cref="T:System.Data.SqlTypes.SqlInt32" /> structures.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
         <param name="y">
@@ -674,12 +810,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the bitwise AND of its <see cref="T:System.Data.SqlTypes.SqlInt32" /> operands.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure that contains the results of the bitwise AND operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
         <param name="y">
@@ -701,12 +840,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the bitwise OR of the specified <see cref="T:System.Data.SqlTypes.SqlInt32" /> structures.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure that contains the results of the bitwise OR operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
         <param name="y">
@@ -728,12 +870,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Divides the first <see cref="T:System.Data.SqlTypes.SqlInt32" /> parameter from the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt32" /> whose <see cref="P:System.Data.SqlTypes.SqlInt32.Value" /> property contains the results of the division.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
         <param name="y">
@@ -755,12 +900,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlInt32" /> parameters to determine whether they are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are not equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt32" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
         <param name="y">
@@ -782,12 +930,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a bitwise exclusive-OR operation on the specified <see cref="T:System.Data.SqlTypes.SqlInt32" /> structures.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure that contains the results of the bitwise XOR operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
         <param name="y">
@@ -969,12 +1120,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the two <see cref="T:System.Data.SqlTypes.SqlInt32" /> parameters to determine whether the first is greater than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt32" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
         <param name="y">
@@ -996,12 +1150,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the two <see cref="T:System.Data.SqlTypes.SqlInt32" /> parameters to determine whether the first is greater than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt32" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
         <param name="y">
@@ -1083,12 +1240,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performa a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlInt32" /> parameters to determine whether they are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are not equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt32" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
         <param name="y">
@@ -1110,12 +1270,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the two <see cref="T:System.Data.SqlTypes.SqlInt32" /> parameters to determine whether the first is less than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt32" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
         <param name="y">
@@ -1137,12 +1300,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the two <see cref="T:System.Data.SqlTypes.SqlInt32" /> parameters to determine whether the first is less than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt32" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
         <param name="y">
@@ -1164,12 +1330,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the remainder after dividing the first <see cref="T:System.Data.SqlTypes.SqlInt32" /> parameter by the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt32.Value" /> contains the remainder.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
         <param name="y">
@@ -1191,12 +1360,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the product of the two <see cref="T:System.Data.SqlTypes.SqlInt32" /> parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt32.Value" /> contains the product of the two parameters.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
         <param name="y">
@@ -1217,12 +1389,15 @@
         <Parameter Name="x" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a bitwise one's complement operation on the specified <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure that contains the results of the one's complement operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
       </Docs>
@@ -1242,12 +1417,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts the second <see cref="T:System.Data.SqlTypes.SqlInt32" /> parameter from the first.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt32.Value" /> property contains the results of the subtraction.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
         <param name="y">
@@ -1268,12 +1446,15 @@
         <Parameter Name="x" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Negates the <see cref="P:System.Data.SqlTypes.SqlInt32.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlInt32" /> operand.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure that contains the negated value.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
       </Docs>
@@ -1288,12 +1469,15 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt32'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.String" /> representation of a number to its 32-bit signed integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer equivalent to the value that is contained in the specified <see cref="T:System.String" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> to be parsed. </param>
       </Docs>
@@ -1313,12 +1497,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt32'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts the second <see cref="T:System.Data.SqlTypes.SqlInt32" /> parameter from the first.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt32.Value" /> property contains the results of the subtraction.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
         <param name="y">
@@ -1340,12 +1527,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XmlSchema.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
@@ -1400,12 +1590,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure to <see cref="T:System.Data.SqlTypes.SqlBoolean" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="P:System.Data.SqlTypes.SqlInt32.Value" /> is non-zero; false if zero; otherwise Null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1420,12 +1613,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlByte'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure to <see cref="T:System.Data.SqlTypes.SqlByte" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure whose Value equals the Value of this <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. If the value of the SqlInt32 is less than 0 or greater than 255, an <see cref="T:System.OverflowException" /> occurs.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1440,12 +1636,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlDecimal'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure to <see cref="T:System.Data.SqlTypes.SqlDecimal" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlDecimal" /> structure equal to the value of this <see cref="T:System.Data.SqlTypes.SqlInt32" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1460,12 +1659,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlDouble'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure to <see cref="T:System.Data.SqlTypes.SqlDouble" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlDouble" /> structure equal to the value of this <see cref="T:System.Data.SqlTypes.SqlInt32" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1480,12 +1682,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlInt16'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure to <see cref="T:System.Data.SqlTypes.SqlInt16" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlInt16" /> structure equal to the value of this <see cref="T:System.Data.SqlTypes.SqlInt32" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1500,12 +1705,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlInt64'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure to <see cref="T:System.Data.SqlTypes.SqlInt64" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure equal to the value of this <see cref="T:System.Data.SqlTypes.SqlInt32" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1520,12 +1728,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlMoney'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure to <see cref="T:System.Data.SqlTypes.SqlMoney" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure equal to the value of this <see cref="T:System.Data.SqlTypes.SqlInt32" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1540,12 +1751,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlSingle'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure to <see cref="T:System.Data.SqlTypes.SqlSingle" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure equal to the value of this <see cref="T:System.Data.SqlTypes.SqlInt32" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1560,12 +1774,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlString'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure to <see cref="T:System.Data.SqlTypes.SqlString" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlString" /> structure equal to the value of this <see cref="T:System.Data.SqlTypes.SqlInt32" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1580,12 +1797,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure to a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> structure equal to the value of this <see cref="T:System.Data.SqlTypes.SqlInt32" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1622,12 +1842,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt32'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a bitwise exclusive-OR operation on the specified <see cref="T:System.Data.SqlTypes.SqlInt32" /> structures.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure that contains the results of the bitwise XOR operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt32" /> structure. </param>
         <param name="y">
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlInt64.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlInt64.xml
index 3dd4eca2dbc..6bfb50f2161 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlInt64.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlInt64.xml
@@ -63,12 +63,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt64'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the two <see cref="T:System.Data.SqlTypes.SqlInt64" /> parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt64.Value" /> is equal to the sum of the two <see cref="T:System.Data.SqlTypes.SqlInt64" /> parameters.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
         <param name="y">
@@ -90,12 +93,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt64'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the bitwise AND of its <see cref="T:System.Data.SqlTypes.SqlInt64" /> operands.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure that contains the results of the bitwise AND operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
         <param name="y">
@@ -117,12 +123,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt64'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the bitwise OR of its two <see cref="T:System.Data.SqlTypes.SqlInt64" /> operands.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure that contains the results of the bitwise OR operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
         <param name="y">
@@ -146,12 +155,53 @@
         <Parameter Name="value" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this <see cref="T:System.Data.SqlTypes.SqlInt64" /> instance to the supplied <see cref="T:System.Data.SqlTypes.SqlInt64" /> and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number that indicates the relative values of the instance and the object.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is the same as the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than the object </para>
+                <para>-or- </para>
+                <para>The object is a null reference (Nothing in Visual Basic). </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlTypes.SqlInt64" /> to be compared.</param>
       </Docs>
@@ -166,12 +216,53 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this <see cref="T:System.Data.SqlTypes.SqlInt64" /> instance to the supplied <see cref="T:System.Object" /> and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number that indicates the relative values of the instance and the object.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is the same as the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than the object </para>
+                <para>-or- </para>
+                <para>The object is a null reference (Nothing in Visual Basic). </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to be compared. </param>
       </Docs>
@@ -191,12 +282,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt64'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Divides the first <see cref="T:System.Data.SqlTypes.SqlInt64" /> parameter by the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt64.Value" /> property contains the results of the division operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
         <param name="y">
@@ -217,12 +311,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the supplied object parameter to the <see cref="P:System.Data.SqlTypes.SqlInt64.Value" /> property of the <see cref="T:System.Data.SqlTypes.SqlInt64" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if object is an instance of <see cref="T:System.Data.SqlTypes.SqlInt64" /> and the two are equal; otherwise false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be compared. </param>
       </Docs>
@@ -242,12 +339,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlInt64" /> parameters to determine whether they are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two values are equal. Otherwise, false. If either instance is null, then the SqlInt64 will be null.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
         <param name="y">
@@ -266,12 +366,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -291,12 +394,15 @@
         <Parameter Name="schemaSet" Type="System.Xml.Schema.XmlSchemaSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that indicates the XSD of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
+        </returns>
         <param name="schemaSet">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</param>
       </Docs>
@@ -312,12 +418,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlInt64" /> parameters to determine whether the first is greater than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt64" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
         <param name="y">
@@ -339,12 +448,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlInt64" /> parameters to determine whether the first is greater than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt64" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
         <param name="y">
@@ -388,12 +500,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison on the two <see cref="T:System.Data.SqlTypes.SqlInt64" /> parameters to determine whether the first is less than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt64" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
         <param name="y">
@@ -415,12 +530,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison on the two <see cref="T:System.Data.SqlTypes.SqlInt64" /> parameters to determine whether the first is less than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt64" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
         <param name="y">
@@ -486,12 +604,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt64'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the remainder after dividing the first <see cref="T:System.Data.SqlTypes.SqlInt64" /> parameter by the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt64.Value" /> property contains the remainder.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
         <param name="y">
@@ -516,7 +637,6 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If either instance of <paramref name="x" /> or <paramref name="y" /> is null, the value will be null.</para>
@@ -525,6 +645,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Divides two <see cref="T:System.Data.SqlTypes.SqlInt64" /> values and returns the remainder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The remainder left after division is performed on <paramref name="x" /> and <paramref name="y" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> value.</param>
         <param name="y">
@@ -542,12 +666,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt64'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the product of the two <see cref="T:System.Data.SqlTypes.SqlInt64" /> parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt64.Value" /> is equal to the product of the two <see cref="T:System.Data.SqlTypes.SqlInt64" /> parameters.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
         <param name="y">
@@ -569,12 +696,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison on the two SqlInt64 parameters to determine whether they are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are not equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt64" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
         <param name="y">
@@ -618,12 +748,15 @@
         <Parameter Name="x" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt64'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a bitwise one's complement operation on its <see cref="T:System.Data.SqlTypes.SqlInt64" /> operand.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt64.Value" /> is equal to the ones complement of the <see cref="T:System.Data.SqlTypes.SqlInt64" /> parameter.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
       </Docs>
@@ -647,12 +780,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the two <see cref="T:System.Data.SqlTypes.SqlInt64" /> parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt64.Value" /> is equal to the sum of the two <see cref="T:System.Data.SqlTypes.SqlInt64" /> parameters.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
         <param name="y">
@@ -674,12 +810,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the bitwise AND of its <see cref="T:System.Data.SqlTypes.SqlInt64" /> operands.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure that contains the results of the bitwise AND operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
         <param name="y">
@@ -701,12 +840,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the bitwise OR of its two <see cref="T:System.Data.SqlTypes.SqlInt64" /> operands.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure that contains the results of the bitwise OR operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
         <param name="y">
@@ -728,12 +870,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Divides the first <see cref="T:System.Data.SqlTypes.SqlInt64" /> parameter by the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt64.Value" /> property contains the results of the division operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
         <param name="y">
@@ -755,12 +900,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlInt64" /> parameters to determine whether they are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are not equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt64" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
         <param name="y">
@@ -782,12 +930,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a bitwise exclusive-OR operation on the supplied parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure that contains the results of the bitwise XOR operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
         <param name="y">
@@ -949,12 +1100,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlInt64" /> parameters to determine whether the first is greater than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt64" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
         <param name="y">
@@ -976,12 +1130,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlInt64" /> parameters to determine whether the first is greater than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt64" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
         <param name="y">
@@ -1083,12 +1240,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison on the two SqlInt64 parameters to determine whether they are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are not equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt64" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
         <param name="y">
@@ -1110,12 +1270,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison on the two <see cref="T:System.Data.SqlTypes.SqlInt64" /> parameters to determine whether the first is less than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt64" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
         <param name="y">
@@ -1137,12 +1300,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison on the two <see cref="T:System.Data.SqlTypes.SqlInt64" /> parameters to determine whether the first is less than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlInt64" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
         <param name="y">
@@ -1164,12 +1330,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the remainder after dividing the first <see cref="T:System.Data.SqlTypes.SqlInt64" /> parameter by the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt64.Value" /> property contains the remainder.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
         <param name="y">
@@ -1191,12 +1360,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the product of the two <see cref="T:System.Data.SqlTypes.SqlInt64" /> parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt64.Value" /> is equal to the product of the two <see cref="T:System.Data.SqlTypes.SqlInt64" /> parameters.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
         <param name="y">
@@ -1217,12 +1389,15 @@
         <Parameter Name="x" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a bitwise one's complement operation on its <see cref="T:System.Data.SqlTypes.SqlInt64" /> operand.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt64.Value" /> is equal to the ones complement of the <see cref="T:System.Data.SqlTypes.SqlInt64" /> parameter.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
       </Docs>
@@ -1242,12 +1417,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts the second <see cref="T:System.Data.SqlTypes.SqlInt64" /> parameter from the first.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt64.Value" /> property equals the results of the subtraction operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
         <param name="y">
@@ -1268,12 +1446,15 @@
         <Parameter Name="x" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The unary minus operator negates the <see cref="P:System.Data.SqlTypes.SqlInt64.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlInt64" /> operand.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt64.Value" /> is equal to the negated <see cref="P:System.Data.SqlTypes.SqlInt64.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlInt64" /> parameter.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
       </Docs>
@@ -1288,12 +1469,15 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt64'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.String" /> representation of a number to its 64-bit signed integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit signed integer equivalent to the value that is contained in the specified <see cref="T:System.String" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> to be parsed. </param>
       </Docs>
@@ -1313,12 +1497,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt64'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts the second <see cref="T:System.Data.SqlTypes.SqlInt64" /> parameter from the first.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure whose <see cref="P:System.Data.SqlTypes.SqlInt64.Value" /> property equals the results of the subtraction operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
         <param name="y">
@@ -1340,12 +1527,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XmlSchema.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
@@ -1400,12 +1590,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure to <see cref="T:System.Data.SqlTypes.SqlBoolean" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="P:System.Data.SqlTypes.SqlInt64.Value" /> is non-zero; false if zero; otherwise Null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1420,12 +1613,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlByte'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure to <see cref="T:System.Data.SqlTypes.SqlByte" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure whose Value equals the Value of this <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1440,12 +1636,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlDecimal'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure to <see cref="T:System.Data.SqlTypes.SqlDecimal" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlDecimal" /> equal to the value of this <see cref="T:System.Data.SqlTypes.SqlInt64" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1460,12 +1659,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlDouble'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure to <see cref="T:System.Data.SqlTypes.SqlDouble" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlDouble" /> equal to the value of this <see cref="T:System.Data.SqlTypes.SqlInt64" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1480,12 +1682,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlInt16'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure to <see cref="T:System.Data.SqlTypes.SqlInt16" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlInt16" /> equal to the value of this <see cref="T:System.Data.SqlTypes.SqlInt64" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1500,12 +1705,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlInt32'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure to <see cref="T:System.Data.SqlTypes.SqlInt32" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlInt64" /> equal to the value of this <see cref="T:System.Data.SqlTypes.SqlInt64" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1520,12 +1728,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlMoney'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure to <see cref="T:System.Data.SqlTypes.SqlMoney" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlMoney" /> equal to the value of this <see cref="T:System.Data.SqlTypes.SqlInt64" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1540,12 +1751,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlSingle'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure to <see cref="T:System.Data.SqlTypes.SqlSingle" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlSingle" /> equal to the value of this <see cref="T:System.Data.SqlTypes.SqlInt64" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1560,12 +1774,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlString'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure to <see cref="T:System.Data.SqlTypes.SqlString" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlString" /> representing the value of this <see cref="T:System.Data.SqlTypes.SqlInt64" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1580,12 +1797,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this instance of <see cref="T:System.Data.SqlTypes.SqlInt64" /> to <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> representing the value of this <see cref="T:System.Data.SqlTypes.SqlInt64" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1622,12 +1842,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlInt64'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a bitwise exclusive-OR operation on the supplied parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure that contains the results of the bitwise XOR operation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlInt64" /> structure. </param>
         <param name="y">
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlMoney.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlMoney.xml
index 39b51e29778..e98dd6c4471 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlMoney.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlMoney.xml
@@ -129,12 +129,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlMoney" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlMoney'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the sum of the two <see cref="T:System.Data.SqlTypes.SqlMoney" /> parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlMoney" /> stucture whose <see cref="P:System.Data.SqlTypes.SqlMoney.Value" /> contains the sum of the two <see cref="T:System.Data.SqlTypes.SqlMoney" /> parameters.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure. </param>
         <param name="y">
@@ -158,12 +161,53 @@
         <Parameter Name="value" Type="System.Data.SqlTypes.SqlMoney" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this <see cref="T:System.Data.SqlTypes.SqlMoney" /> instance to the supplied <see cref="T:System.Data.SqlTypes.SqlMoney" /> and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number that indicates the relative values of the instance and the object.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is the same as the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than the object </para>
+                <para>-or- </para>
+                <para>The object is a null reference (Nothing in Visual Basic) </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlTypes.SqlMoney" /> to be compared.</param>
       </Docs>
@@ -178,12 +222,53 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this <see cref="T:System.Data.SqlTypes.SqlMoney" /> instance to the supplied <see cref="T:System.Object" /> and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number that indicates the relative values of the instance and the object.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is the same as the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than the object </para>
+                <para>-or- </para>
+                <para>The object is a null reference (Nothing in Visual Basic) </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to be compared. </param>
       </Docs>
@@ -203,12 +288,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlMoney" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlMoney'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The division operator divides the first <see cref="T:System.Data.SqlTypes.SqlMoney" /> parameter by the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure whose <see cref="P:System.Data.SqlTypes.SqlMoney.Value" /> contains the results of the division.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure. </param>
         <param name="y">
@@ -229,12 +317,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the supplied object parameter to the <see cref="P:System.Data.SqlTypes.SqlMoney.Value" /> property of the <see cref="T:System.Data.SqlTypes.SqlMoney" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Equals will return true if the object is an instance of <see cref="T:System.Data.SqlTypes.SqlMoney" /> and the two are equal; otherwise false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be compared. </param>
       </Docs>
@@ -254,12 +345,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlMoney" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlMoney" /> parameters to determine whether they are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two values are equal. Otherwise, false. If either instance is null, then the SqlMoney will be null.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure. </param>
         <param name="y">
@@ -278,12 +372,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -303,12 +400,15 @@
         <Parameter Name="schemaSet" Type="System.Xml.Schema.XmlSchemaSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that indicates the XSD of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
+        </returns>
         <param name="schemaSet">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</param>
       </Docs>
@@ -324,12 +424,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlMoney" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlMoney" /> parameters to determine whether the first is greater than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlMoney" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure. </param>
         <param name="y">
@@ -351,12 +454,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlMoney" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlMoney" /> parameters to determine whether the first is greater than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlMoney" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure. </param>
         <param name="y">
@@ -400,12 +506,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlMoney" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlMoney" /> parameters to determine whether the first is less than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlMoney" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure. </param>
         <param name="y">
@@ -427,12 +536,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlMoney" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlMoney" /> parameters to determine whether the first is less than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlMoney" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure. </param>
         <param name="y">
@@ -498,12 +610,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlMoney" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlMoney'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The multiplicaion operator calculates the product of the two <see cref="T:System.Data.SqlTypes.SqlMoney" /> parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure whose <see cref="P:System.Data.SqlTypes.SqlMoney.Value" /> contains the product of the multiplication.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure. </param>
         <param name="y">
@@ -525,12 +640,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlMoney" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlMoney" /> parameters to determine whether they are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are not equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlMoney" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure. </param>
         <param name="y">
@@ -579,12 +697,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlMoney" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the sum of the two <see cref="T:System.Data.SqlTypes.SqlMoney" /> parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlMoney" /> stucture whose <see cref="P:System.Data.SqlTypes.SqlMoney.Value" /> contains the sum of the two <see cref="T:System.Data.SqlTypes.SqlMoney" /> parameters.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure. </param>
         <param name="y">
@@ -606,12 +727,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlMoney" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The division operator divides the first <see cref="T:System.Data.SqlTypes.SqlMoney" /> parameter by the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure whose <see cref="P:System.Data.SqlTypes.SqlMoney.Value" /> contains the results of the division.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure. </param>
         <param name="y">
@@ -633,12 +757,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlMoney" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlMoney" /> parameters to determine whether they are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are not equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlMoney" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure. </param>
         <param name="y">
@@ -799,12 +926,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlMoney" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlMoney" /> parameters to determine whether the first is greater than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlMoney" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure. </param>
         <param name="y">
@@ -826,12 +956,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlMoney" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlMoney" /> parameters to determine whether the first is greater than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlMoney" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure. </param>
         <param name="y">
@@ -972,12 +1105,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlMoney" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlMoney" /> parameters to determine whether they are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are not equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlMoney" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure. </param>
         <param name="y">
@@ -999,12 +1135,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlMoney" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlMoney" /> parameters to determine whether the first is less than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlMoney" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure. </param>
         <param name="y">
@@ -1026,12 +1165,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlMoney" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlMoney" /> parameters to determine whether the first is less than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlMoney" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure. </param>
         <param name="y">
@@ -1053,12 +1195,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlMoney" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The multiplicaion operator calculates the product of the two <see cref="T:System.Data.SqlTypes.SqlMoney" /> parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure whose <see cref="P:System.Data.SqlTypes.SqlMoney.Value" /> contains the product of the multiplication.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure. </param>
         <param name="y">
@@ -1080,12 +1225,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlMoney" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The subtraction operator subtracts the second <see cref="T:System.Data.SqlTypes.SqlMoney" /> parameter from the first.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure that contains the results of the subtraction.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure. </param>
         <param name="y">
@@ -1106,12 +1254,15 @@
         <Parameter Name="x" Type="System.Data.SqlTypes.SqlMoney" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The unary minus operator negates the <see cref="T:System.Data.SqlTypes.SqlMoney" /> parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure whose <see cref="P:System.Data.SqlTypes.SqlMoney.Value" /> contains the results of the negation.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure to be negated. </param>
       </Docs>
@@ -1126,12 +1277,15 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlMoney'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.String" /> representation of a number to its <see cref="T:System.Data.SqlTypes.SqlMoney" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlMoney" /> equivalent to the value that is contained in the specified <see cref="T:System.String" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The String to be parsed. </param>
       </Docs>
@@ -1151,12 +1305,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlMoney" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlMoney'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The subtraction operator subtracts the second <see cref="T:System.Data.SqlTypes.SqlMoney" /> parameter from the first.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure that contains the results of the subtraction.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure. </param>
         <param name="y">
@@ -1178,12 +1335,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XmlSchema.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
@@ -1238,12 +1398,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'decimal'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the Value of this instance of <see cref="T:System.Data.SqlTypes.SqlMoney" /> as a <see cref="T:System.Decimal" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Decimal" /> structure whose value equals the <see cref="P:System.Data.SqlTypes.SqlMoney.Value" /> property of this <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1258,12 +1421,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'double'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure to a <see cref="T:System.Double" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A double with a value equal to this <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1278,12 +1444,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure to an <see cref="T:System.Int32" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit integer whose value equals the integer part of this <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1298,12 +1467,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the Value of this <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure to an <see cref="T:System.Int64" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit integer whose value equals the integer part of this <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1318,12 +1490,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure to <see cref="T:System.Data.SqlTypes.SqlBoolean" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure. If the value of the <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure is zero, the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> structure's value will be <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.True" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1338,12 +1513,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlByte'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure to <see cref="T:System.Data.SqlTypes.SqlByte" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlByte" /> equal to the value of this <see cref="T:System.Data.SqlTypes.SqlMoney" />. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1358,12 +1536,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlDecimal'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure to <see cref="T:System.Data.SqlTypes.SqlDecimal" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlDecimal" /> equal to the value of this <see cref="T:System.Data.SqlTypes.SqlMoney" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1378,12 +1559,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlDouble'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure to <see cref="T:System.Data.SqlTypes.SqlDouble" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlDouble" /> equal to the value of this <see cref="T:System.Data.SqlTypes.SqlMoney" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1398,12 +1582,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlInt16'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure to <see cref="T:System.Data.SqlTypes.SqlInt16" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlInt16" /> equal to the value of this <see cref="T:System.Data.SqlTypes.SqlMoney" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1418,12 +1605,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlInt32'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure to <see cref="T:System.Data.SqlTypes.SqlInt32" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlInt32" /> equal to the value of this <see cref="T:System.Data.SqlTypes.SqlMoney" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1438,12 +1628,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlInt64'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure to <see cref="T:System.Data.SqlTypes.SqlInt64" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlInt64" /> equal to the value of this <see cref="T:System.Data.SqlTypes.SqlMoney" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1458,12 +1651,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlSingle'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure to <see cref="T:System.Data.SqlTypes.SqlSingle" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlSingle" /> equal to the value of this <see cref="T:System.Data.SqlTypes.SqlMoney" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1478,12 +1674,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlString'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlMoney" /> structure to <see cref="T:System.Data.SqlTypes.SqlString" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlString" /> structure whose value is a string representing the value of this <see cref="T:System.Data.SqlTypes.SqlMoney" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1498,12 +1697,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this instance of <see cref="T:System.Data.SqlTypes.SqlMoney" /> to string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string whose value is the string representation of the value of this <see cref="T:System.Data.SqlTypes.SqlMoney" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlSingle.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlSingle.xml
index bdb052a3f53..c2ed05eaa7a 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlSingle.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlSingle.xml
@@ -87,12 +87,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlSingle" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlSingle'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the two specified <see cref="T:System.Data.SqlTypes.SqlSingle" /> structures.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure that contains the sum of the two specified <see cref="T:System.Data.SqlTypes.SqlSingle" /> structures.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure. </param>
         <param name="y">
@@ -116,12 +119,53 @@
         <Parameter Name="value" Type="System.Data.SqlTypes.SqlSingle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this <see cref="T:System.Data.SqlTypes.SqlSingle" /> instance to the supplied <see cref="T:System.Data.SqlTypes.SqlSingle" /> and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number that indicates the relative values of the instance and the object.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is the same as the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than the object </para>
+                <para>-or- </para>
+                <para>The object is a null reference (Nothing in Visual Basic) </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlTypes.SqlSingle" /> to be compared.</param>
       </Docs>
@@ -136,12 +180,53 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this <see cref="T:System.Data.SqlTypes.SqlSingle" /> instance to the supplied <see cref="T:System.Object" /> and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number that indicates the relative values of the instance and the object.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is the same as the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than the object </para>
+                <para>-or- </para>
+                <para>The object is a null reference (Nothing in Visual Basic) </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to be compared. </param>
       </Docs>
@@ -161,12 +246,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlSingle" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlSingle'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Divides the first <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure by the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A SqlInt64 structure that contains the results of the division.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure. </param>
         <param name="y">
@@ -187,12 +275,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the supplied object parameter to the <see cref="P:System.Data.SqlTypes.SqlSingle.Value" /> property of the <see cref="T:System.Data.SqlTypes.SqlSingle" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object is an instance of <see cref="T:System.Data.SqlTypes.SqlSingle" /> and the two are equal. Otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be compared. </param>
       </Docs>
@@ -212,12 +303,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlSingle" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlSingle" /> parameters to determine whether they are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two values are equal. Otherwise, false. If either instance is null, then the SqlSingle will be null.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure. </param>
         <param name="y">
@@ -236,12 +330,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -261,12 +358,15 @@
         <Parameter Name="schemaSet" Type="System.Xml.Schema.XmlSchemaSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string value that indicates the XSD of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
+        </returns>
         <param name="schemaSet">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</param>
       </Docs>
@@ -282,12 +382,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlSingle" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlSingle" /> operands to determine whether the first is greater than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlSingle" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure. </param>
         <param name="y">
@@ -309,12 +412,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlSingle" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of two <see cref="T:System.Data.SqlTypes.SqlSingle" /> structures to determine whether the first is greater than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlSingle" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure. </param>
         <param name="y">
@@ -358,12 +464,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlSingle" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlSingle" /> parameters to determine whether the first is less than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlSingle" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure. </param>
         <param name="y">
@@ -385,12 +494,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlSingle" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlSingle" /> parameters to determine whether the first is less than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlSingle" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure. </param>
         <param name="y">
@@ -456,12 +568,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlSingle" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlSingle'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the product of the two specified <see cref="T:System.Data.SqlTypes.SqlSingle" /> structures.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure that contains the product of the multiplication.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure. </param>
         <param name="y">
@@ -483,12 +598,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlSingle" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlSingle" /> parameters to determine whether they are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are not equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlSingle" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure. </param>
         <param name="y">
@@ -536,12 +654,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlSingle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the sum of the two specified <see cref="T:System.Data.SqlTypes.SqlSingle" /> structures.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure that contains the sum of the two specified <see cref="T:System.Data.SqlTypes.SqlSingle" /> structures.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure. </param>
         <param name="y">
@@ -563,12 +684,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlSingle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Divides the first <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure by the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure that contains the results of the division.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure. </param>
         <param name="y">
@@ -590,12 +714,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlSingle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two SqlSingle parameters to determine whether they are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are not equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlSingle" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure. </param>
         <param name="y">
@@ -697,12 +824,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlSingle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlSingle" /> operands to determine whether the first is greater than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlSingle" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure. </param>
         <param name="y">
@@ -724,12 +854,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlSingle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of two <see cref="T:System.Data.SqlTypes.SqlSingle" /> structures to determine whether the first is greater than or equl to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlSingle" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure. </param>
         <param name="y">
@@ -891,12 +1024,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlSingle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlSingle" /> parameters to determine whether they are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are not equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlSingle" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure. </param>
         <param name="y">
@@ -918,12 +1054,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlSingle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlSingle" /> parameters to determine whether the first is less than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlSingle" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure. </param>
         <param name="y">
@@ -945,12 +1084,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlSingle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlSingle" /> parameters to determine whether the first is less than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlSingle" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure. </param>
         <param name="y">
@@ -972,12 +1114,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlSingle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the product of the two specified <see cref="T:System.Data.SqlTypes.SqlSingle" /> structures.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure that contains the product of the multiplication.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure. </param>
         <param name="y">
@@ -999,12 +1144,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlSingle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts the second <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure from the first.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure that contains the results of the subtraction.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure. </param>
         <param name="y">
@@ -1025,12 +1173,15 @@
         <Parameter Name="x" Type="System.Data.SqlTypes.SqlSingle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Negates the <see cref="P:System.Data.SqlTypes.SqlSingle.Value" /> of the specified <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure that contains the negated value.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure. </param>
       </Docs>
@@ -1045,12 +1196,15 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlSingle'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> to a <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlSingle" /> equivalent to the value that is contained in the specified <see cref="T:System.String" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> to be parsed. </param>
       </Docs>
@@ -1070,12 +1224,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlSingle" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlSingle'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts the second <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure from the first.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure that contains the results of the subtraction.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure. </param>
         <param name="y">
@@ -1097,12 +1254,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XmlSchema.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
@@ -1157,12 +1317,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure to <see cref="T:System.Data.SqlTypes.SqlBoolean" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="P:System.Data.SqlTypes.SqlSingle.Value" /> is non-zero; false if zero; otherwise Null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1177,12 +1340,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlByte'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure to <see cref="T:System.Data.SqlTypes.SqlByte" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlByte" /> structure whose Value equals the Value of this <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure. If the <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure's Value is true, the <see cref="T:System.Data.SqlTypes.SqlByte" /> structure's Value will be 1. Otherwise, the <see cref="T:System.Data.SqlTypes.SqlByte" /> structure's Value will be 0.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1197,12 +1363,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlDecimal'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure to <see cref="T:System.Data.SqlTypes.SqlDecimal" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new SqlDecimal equal to the value of this <see cref="T:System.Data.SqlTypes.SqlSingle" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1217,12 +1386,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlDouble'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure to <see cref="T:System.Data.SqlTypes.SqlDouble" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new SqlDouble equal to the value of this <see cref="T:System.Data.SqlTypes.SqlSingle" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1237,12 +1409,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlInt16'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure to <see cref="T:System.Data.SqlTypes.SqlInt16" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new SqlInt16 equal to the value of this <see cref="T:System.Data.SqlTypes.SqlSingle" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1257,12 +1432,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlInt32'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure to <see cref="T:System.Data.SqlTypes.SqlInt32" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlInt32" /> equal to the value of this <see cref="T:System.Data.SqlTypes.SqlSingle" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1277,12 +1455,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlInt64'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure to <see cref="T:System.Data.SqlTypes.SqlInt64" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlInt64" /> equal to the value of this <see cref="T:System.Data.SqlTypes.SqlSingle" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1297,12 +1478,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlMoney'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure to <see cref="T:System.Data.SqlTypes.SqlMoney" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlMoney" /> equal to the value of this <see cref="T:System.Data.SqlTypes.SqlSingle" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1317,12 +1501,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlString'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure to <see cref="T:System.Data.SqlTypes.SqlString" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlString" /> representing the value of this <see cref="T:System.Data.SqlTypes.SqlSingle" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1337,12 +1524,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlSingle" /> structure to <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A String object representing the value of this <see cref="T:System.Data.SqlTypes.SqlSingle" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlString.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlString.xml
index b19f573d557..c5d2d7f0df4 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlString.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlString.xml
@@ -250,7 +250,6 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -260,6 +259,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Concatenates two specified <see cref="T:System.Data.SqlTypes.SqlString" /> values to create a new <see cref="T:System.Data.SqlTypes.SqlString" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlString" /> that is the concatenated value of <paramref name="x" /> and <paramref name="y" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlString" />. </param>
         <param name="y">
@@ -298,12 +301,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlString'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of this <see cref="T:System.Data.SqlTypes.SqlString" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlString" /> object in which all property values are the same as the original.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -339,12 +345,15 @@
         <Parameter Name="compareOptions" Type="System.Data.SqlTypes.SqlCompareOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Globalization.CompareOptions'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Globalization.CompareOptions" /> enumeration equilvalent of the specified <see cref="T:System.Data.SqlTypes.SqlCompareOptions" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A CompareOptions value that corresponds to the SqlCompareOptions for this <see cref="T:System.Data.SqlTypes.SqlString" /> structure.</para>
+        </returns>
         <param name="compareOptions">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlCompareOptions" /> value that describes the comparison options for this <see cref="T:System.Data.SqlTypes.SqlString" /> structure. </param>
       </Docs>
@@ -366,12 +375,53 @@
         <Parameter Name="value" Type="System.Data.SqlTypes.SqlString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this <see cref="T:System.Data.SqlTypes.SqlString" /> instance to the supplied <see cref="T:System.Data.SqlTypes.SqlString" /> and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number that indicates the relative values of the instance and the object.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is the same as the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than the object </para>
+                <para>-or- </para>
+                <para>The object is a null reference (Nothing in Visual Basic). </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.SqlTypes.SqlString" /> to be compared.</param>
       </Docs>
@@ -386,12 +436,53 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this <see cref="T:System.Data.SqlTypes.SqlString" /> object to the supplied <see cref="T:System.Object" /> and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number that indicates the relative values of the instance and the object.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is the same as the object. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than the object </para>
+                <para>-or- </para>
+                <para>The object is a null reference (Nothing in Visual Basic) </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to be compared. </param>
       </Docs>
@@ -411,12 +502,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlString" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlString'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Concatenates the two specified <see cref="T:System.Data.SqlTypes.SqlString" /> structures.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlString" /> that contains the newly concatenated value representing the contents of the two <see cref="T:System.Data.SqlTypes.SqlString" /> parameters.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlString" />. </param>
         <param name="y">
@@ -456,12 +550,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the supplied object parameter to the <see cref="P:System.Data.SqlTypes.SqlString.Value" /> property of the <see cref="T:System.Data.SqlTypes.SqlString" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Equals will return true if the object is an instance of <see cref="T:System.Data.SqlTypes.SqlString" /> and the two are equal; otherwise false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be compared. </param>
       </Docs>
@@ -481,12 +578,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlString" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlString" /> operands to determine whether they are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two values are equal. Otherwise, false. If either instance is null, then the SqlString will be null.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlString" />. </param>
         <param name="y">
@@ -505,12 +605,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -525,12 +628,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of bytes, that contains the contents of the <see cref="T:System.Data.SqlTypes.SqlString" /> in ANSI format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An byte array, that contains the contents of the <see cref="T:System.Data.SqlTypes.SqlString" /> in ANSI format.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -545,12 +651,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of bytes, that contains the contents of the <see cref="T:System.Data.SqlTypes.SqlString" /> in Unicode format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An byte array, that contains the contents of the <see cref="T:System.Data.SqlTypes.SqlString" /> in Unicode format.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -570,12 +679,15 @@
         <Parameter Name="schemaSet" Type="System.Xml.Schema.XmlSchemaSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string value that indicates the XSD of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
+        </returns>
         <param name="schemaSet">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</param>
       </Docs>
@@ -591,12 +703,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlString" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlString" /> operands to determine whether the first is greater than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlString" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlString" />. </param>
         <param name="y">
@@ -618,12 +733,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlString" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlString" /> operands to determine whether the first is greater than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlString" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlString" />. </param>
         <param name="y">
@@ -785,12 +903,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlString" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlString" /> operands to determine whether the first is less than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlString" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlString" />. </param>
         <param name="y">
@@ -812,12 +933,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlString" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlString" /> operands to determine whether the first is less than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlString" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlString" />. </param>
         <param name="y">
@@ -839,12 +963,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlString" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlString" /> operands to determine whether they are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are not equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlString" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlString" />. </param>
         <param name="y">
@@ -892,12 +1019,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Concatenates the two specified <see cref="T:System.Data.SqlTypes.SqlString" /> structures.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlString" /> that contains the newly concatenated value representing the contents of the two <see cref="T:System.Data.SqlTypes.SqlString" /> parameters.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlString" />. </param>
         <param name="y">
@@ -919,12 +1049,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlString" /> operands to determine whether they are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are not equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlString" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlString" />. </param>
         <param name="y">
@@ -1186,12 +1319,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlString" /> operands to determine whether the first is greater than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlString" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlString" />. </param>
         <param name="y">
@@ -1213,12 +1349,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlString" /> operands to determine whether the first is greater than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is greater than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlString" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlString" />. </param>
         <param name="y">
@@ -1260,12 +1399,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlString" /> operands to determine whether they are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the two instances are not equal or <see cref="F:System.Data.SqlTypes.SqlBoolean.False" /> if the two instances are equal. If either instance of <see cref="T:System.Data.SqlTypes.SqlString" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlString" />. </param>
         <param name="y">
@@ -1287,12 +1429,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlString" /> operands to determine whether the first is less than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlString" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlString" />. </param>
         <param name="y">
@@ -1314,12 +1459,15 @@
         <Parameter Name="y" Type="System.Data.SqlTypes.SqlString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a logical comparison of the two <see cref="T:System.Data.SqlTypes.SqlString" /> operands to determine whether the first is less than or equal to the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.SqlTypes.SqlBoolean" /> that is <see cref="F:System.Data.SqlTypes.SqlBoolean.True" /> if the first instance is less than or equal to the second instance. Otherwise, <see cref="F:System.Data.SqlTypes.SqlBoolean.False" />. If either instance of <see cref="T:System.Data.SqlTypes.SqlString" /> is null, the <see cref="P:System.Data.SqlTypes.SqlBoolean.Value" /> of the <see cref="T:System.Data.SqlTypes.SqlBoolean" /> will be <see cref="F:System.Data.SqlTypes.SqlBoolean.Null" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.SqlTypes.SqlString" />. </param>
         <param name="y">
@@ -1356,12 +1504,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XmlSchema.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
@@ -1416,12 +1567,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlBoolean'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlString" /> structure to <see cref="T:System.Data.SqlTypes.SqlBoolean" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="P:System.Data.SqlTypes.SqlString.Value" /> is non-zero; false if zero; otherwise Null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1436,12 +1590,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlByte'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlString" /> structure to <see cref="T:System.Data.SqlTypes.SqlByte" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new SqlByte structure whose <see cref="P:System.Data.SqlTypes.SqlByte.Value" /> equals the number represented by this <see cref="T:System.Data.SqlTypes.SqlString" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1456,12 +1613,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlDateTime'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlString" /> structure to <see cref="T:System.Data.SqlTypes.SqlDateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new SqlDateTime structure that contains the date value represented by this <see cref="T:System.Data.SqlTypes.SqlString" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1476,12 +1636,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlDecimal'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlString" /> structure to <see cref="T:System.Data.SqlTypes.SqlDecimal" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlDecimal" /> that contains the value of this <see cref="T:System.Data.SqlTypes.SqlString" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1496,12 +1659,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlDouble'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlString" /> structure to <see cref="T:System.Data.SqlTypes.SqlDouble" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlDouble" /> that is equal to the numeric value of this <see cref="T:System.Data.SqlTypes.SqlString" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1516,12 +1682,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlGuid'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlString" /> structure to <see cref="T:System.Data.SqlTypes.SqlGuid" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlGuid" /> structure whose <see cref="P:System.Data.SqlTypes.SqlGuid.Value" /> is the Guid represented by this <see cref="T:System.Data.SqlTypes.SqlString" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1536,12 +1705,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlInt16'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlString" /> structure to <see cref="T:System.Data.SqlTypes.SqlInt16" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlInt16" /> that is equal to the numeric value of this <see cref="T:System.Data.SqlTypes.SqlString" />. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1556,12 +1728,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlInt32'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlString" /> structure to <see cref="T:System.Data.SqlTypes.SqlInt32" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlInt32" /> that is equal to the numeric value of this <see cref="T:System.Data.SqlTypes.SqlString" />. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1576,12 +1751,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlInt64'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlString" /> structure to <see cref="T:System.Data.SqlTypes.SqlInt64" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlInt64" /> that is equal to the numeric value of this <see cref="T:System.Data.SqlTypes.SqlString" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1596,12 +1774,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlMoney'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlString" /> structure to <see cref="T:System.Data.SqlTypes.SqlMoney" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlMoney" /> that is equal to the numeric value of this <see cref="T:System.Data.SqlTypes.SqlString" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1616,12 +1797,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SqlSingle'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Data.SqlTypes.SqlString" /> structure to <see cref="T:System.Data.SqlTypes.SqlSingle" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.SqlTypes.SqlSingle" /> that is equal to the numeric value of this <see cref="T:System.Data.SqlTypes.SqlString" />..</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1636,12 +1820,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a <see cref="T:System.Data.SqlTypes.SqlString" /> object to a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> with the same value as this <see cref="T:System.Data.SqlTypes.SqlString" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlXml.xml b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlXml.xml
index d471ccfe283..0adf033d4e2 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlXml.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data.SqlTypes/SqlXml.xml
@@ -101,7 +101,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="T:System.Data.SqlTypes.SqlXml" /> instance was initialized to null (Nothing in Visual Basic), this method returns null.</para>
@@ -110,6 +109,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the XML content of this <see cref="T:System.Data.SqlTypes.SqlXml" /> as a <see cref="T:System.Xml.XmlReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Xml.XmlReader" />-derived instance that contains the XML content. The actual type may vary (for example, the return value might be <see cref="T:System.Xml.XmlTextReader" />) depending on how the information is represented internally, on the server.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetXsdType">
@@ -125,12 +128,15 @@
         <Parameter Name="schemaSet" Type="System.Xml.Schema.XmlSchemaSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that indicates the XSD of the specified <see cref="T:System.Xml.Schema.XmlSchemaSet" />. </para>
+        </returns>
         <param name="schemaSet">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</param>
       </Docs>
@@ -182,7 +188,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.SqlTypes.SqlXml" /> instance is cast to an <see cref="T:System.Xml.Serialization.IXmlSerializable" /> interface.</para>
@@ -191,6 +196,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Xml.Serialization.IXmlSerializable.GetSchema" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Schema.XmlSchema" /> that describes the XML representation of the object that is produced by the <see cref="M:System.Xml.Serialization.IXmlSerializable.WriteXml(System.Xml.XmlWriter)" /> method and consumed by the <see cref="M:System.Xml.Serialization.IXmlSerializable.ReadXml(System.Xml.XmlReader)" /> method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
diff --git a/mcs/class/System.Data/Documentation/en/System.Data/Constraint.xml b/mcs/class/System.Data/Documentation/en/System.Data/Constraint.xml
index 83cbbb01545..b8c70b2fde0 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data/Constraint.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data/Constraint.xml
@@ -202,12 +202,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="P:System.Data.Constraint.ConstraintName" />, if there is one, as a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string value of the <see cref="P:System.Data.Constraint.ConstraintName" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data/ConstraintCollection.xml b/mcs/class/System.Data/Documentation/en/System.Data/ConstraintCollection.xml
index 8d33477b5bc..72210eebab8 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data/ConstraintCollection.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data/ConstraintCollection.xml
@@ -58,6 +58,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Data.Constraint" /> object to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.UniqueConstraint" /> or <see cref="T:System.Data.ForeignKeyConstraint" />.</para>
+        </returns>
         <param name="constraint">
           <attribution license="cc4" from="Microsoft" modified="false" />The Constraint to add. </param>
       </Docs>
@@ -78,7 +82,6 @@
         <Parameter Name="primaryKey" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Constraint'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="E:System.Data.ConstraintCollection.CollectionChanged" /> event occurs if the constraint is added successfully.</para>
@@ -87,6 +90,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Constructs a new <see cref="T:System.Data.UniqueConstraint" /> with the specified name, <see cref="T:System.Data.DataColumn" />, and value that indicates whether the column is a primary key, and adds it to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new UniqueConstraint.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the UniqueConstraint. </param>
         <param name="column">
@@ -111,7 +118,6 @@
         <Parameter Name="foreignKeyColumn" Type="System.Data.DataColumn" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Constraint'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="E:System.Data.ConstraintCollection.CollectionChanged" /> event occurs if the constraint is added successfully.</para>
@@ -120,6 +126,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Constructs a new <see cref="T:System.Data.ForeignKeyConstraint" /> with the specified name, parent column, and child column, and adds the constraint to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new ForeignKeyConstraint.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Data.ForeignKeyConstraint" />. </param>
         <param name="primaryKeyColumn">
@@ -144,7 +154,6 @@
         <Parameter Name="primaryKey" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Constraint'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="E:System.Data.ConstraintCollection.CollectionChanged" /> event occurs if the constraint is added successfully.</para>
@@ -153,6 +162,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Constructs a new <see cref="T:System.Data.UniqueConstraint" /> with the specified name, array of <see cref="T:System.Data.DataColumn" /> objects, and value that indicates whether the column is a primary key, and adds it to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new UniqueConstraint.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Data.UniqueConstraint" />. </param>
         <param name="columns">
@@ -177,7 +190,6 @@
         <Parameter Name="foreignKeyColumns" Type="System.Data.DataColumn[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Constraint'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="E:System.Data.ConstraintCollection.CollectionChanged" /> event occurs if the constraint is added successfully.</para>
@@ -186,6 +198,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Constructs a new <see cref="T:System.Data.ForeignKeyConstraint" />, with the specified arrays of parent columns and child columns, and adds the constraint to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new ForeignKeyConstraint.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Data.ForeignKeyConstraint" />. </param>
         <param name="primaryKeyColumns">
@@ -234,7 +250,6 @@
         <Parameter Name="constraint" Type="System.Data.Constraint" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default behavior whenever a <see cref="T:System.Data.DataRelation" /> is added to a <see cref="T:System.Data.DataSet" />, is to add a <see cref="T:System.Data.ForeignKeyConstraint" /> to the parent table and a <see cref="T:System.Data.UniqueConstraint" /> to the child table. The <see cref="T:System.Data.UniqueConstraint" /> is applied to the primary key column of the parent table, and the <see cref="T:System.Data.ForeignKeyConstraint" /> is applied to the foreign key column of the child table. Because trying to remove the <see cref="T:System.Data.UniqueConstraint" /> before removing the <see cref="T:System.Data.ForeignKeyConstraint" /> causes an exception to be thrown, you should always use the <see cref="M:System.Data.ConstraintCollection.CanRemove(System.Data.Constraint)" /> method before calling Remove, to make sure that the <see cref="T:System.Data.UniqueConstraint" /> can be removed.</para>
@@ -243,6 +258,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a <see cref="T:System.Data.Constraint" /> can be removed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Data.Constraint" /> can be removed from collection; otherwise, false.</para>
+        </returns>
         <param name="constraint">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.Constraint" /> to be tested for removal from the collection. </param>
       </Docs>
@@ -305,7 +324,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Data.ConstraintCollection.Contains(System.String)" /> method to determine whether the specified <see cref="T:System.Data.Constraint" /> exists before trying to remove it from the collection. You can also use the <see cref="M:System.Data.ConstraintCollection.CanRemove(System.Data.Constraint)" /> method to determine whether a <see cref="T:System.Data.Constraint" /> can be removed.</para>
@@ -314,6 +332,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the <see cref="T:System.Data.Constraint" /> object specified by name exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the specified constraint; otherwise, false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Data.Constraint.ConstraintName" /> of the constraint. </param>
       </Docs>
@@ -357,7 +379,6 @@
         <Parameter Name="constraint" Type="System.Data.Constraint" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Data.ConstraintCollection.IndexOf(System.Data.Constraint)" /> method to return an index to be used with either the <see cref="M:System.Data.ConstraintCollection.Contains(System.String)" /> or <see cref="M:System.Data.ConstraintCollection.Remove(System.Data.Constraint)" /> method.</para>
@@ -366,6 +387,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the specified <see cref="T:System.Data.Constraint" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the <see cref="T:System.Data.Constraint" /> if it is in the collection; otherwise, -1.</para>
+        </returns>
         <param name="constraint">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.Constraint" /> to search for. </param>
       </Docs>
@@ -384,7 +409,6 @@
         <Parameter Name="constraintName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Data.ConstraintCollection.IndexOf(System.Data.Constraint)" /> method to return an index to be used with either the <see cref="M:System.Data.ConstraintCollection.Contains(System.String)" /> or <see cref="M:System.Data.ConstraintCollection.Remove(System.Data.Constraint)" /> method.</para>
@@ -393,6 +417,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the <see cref="T:System.Data.Constraint" /> specified by name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the <see cref="T:System.Data.Constraint" /> if it is in the collection; otherwise, -1.</para>
+        </returns>
         <param name="constraintName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Data.Constraint" />. </param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data/DataColumn.xml b/mcs/class/System.Data/Documentation/en/System.Data/DataColumn.xml
index 1fa145f1c17..e5adb090878 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data/DataColumn.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data/DataColumn.xml
@@ -1244,12 +1244,15 @@ myDataTable.Rows[0][0] = newValue;</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="P:System.Data.DataColumn.Expression" /> of the column, if one exists.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="P:System.Data.DataColumn.Expression" /> value, if the property is set; otherwise, the <see cref="P:System.Data.DataColumn.ColumnName" /> property.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data/DataColumnCollection.xml b/mcs/class/System.Data/Documentation/en/System.Data/DataColumnCollection.xml
index 3809dd585ef..a1513b55598 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data/DataColumnCollection.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data/DataColumnCollection.xml
@@ -42,7 +42,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'DataColumn'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A default name ("Column1", "Column2", and so on) is given to the column.</para>
@@ -52,6 +51,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and adds a <see cref="T:System.Data.DataColumn" /> object to the <see cref="T:System.Data.DataColumnCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created <see cref="T:System.Data.DataColumn" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -94,7 +97,6 @@
         <Parameter Name="columnName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataColumn'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>By default, the <see cref="P:System.Data.DataColumn.DataType" /> for the new column is string.</para>
@@ -106,6 +108,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and adds a <see cref="T:System.Data.DataColumn" /> object that has the specified name to the <see cref="T:System.Data.DataColumnCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created <see cref="T:System.Data.DataColumn" />.</para>
+        </returns>
         <param name="columnName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the column. </param>
       </Docs>
@@ -125,7 +131,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataColumn'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If null or an empty string ("") is passed in for the name, a default name ("Column1", "Column2", and so on) is given to the column.</para>
@@ -136,6 +141,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and adds a <see cref="T:System.Data.DataColumn" /> object that has the specified name and type to the <see cref="T:System.Data.DataColumnCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created <see cref="T:System.Data.DataColumn" />.</para>
+        </returns>
         <param name="columnName">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Data.DataColumn.ColumnName" /> to use when you create the column. </param>
         <param name="type">
@@ -158,7 +167,6 @@
         <Parameter Name="expression" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataColumn'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If null or an empty string ("") is passed in for the name, a default name ("Column1", "Column2", and so on) is given to the column.</para>
@@ -169,6 +177,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and adds a <see cref="T:System.Data.DataColumn" /> object that has the specified name, type, and expression to the <see cref="T:System.Data.DataColumnCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created <see cref="T:System.Data.DataColumn" />.</para>
+        </returns>
         <param name="columnName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name to use when you create the column. </param>
         <param name="type">
@@ -214,7 +226,6 @@
         <Parameter Name="column" Type="System.Data.DataColumn" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.DataColumnCollection.CanRemove(System.Data.DataColumn)" /> method performs several checks before returning a true or false result. This includes the following: whether the column exists, belongs to the table, or is involved in a constraint or relation.</para>
@@ -224,6 +235,24 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks whether a specific column can be removed from the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the column can be removed. false if,</para>
+          <list type="bullet">
+            <item>
+              <para>The <paramref name="column" /> parameter is null.</para>
+            </item>
+            <item>
+              <para>The column does not belong to this collection.</para>
+            </item>
+            <item>
+              <para>The column is part of a relationship.</para>
+            </item>
+            <item>
+              <para>Another column's expression depends on this column.</para>
+            </item>
+          </list>
+        </returns>
         <param name="column">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.DataColumn" /> in the collection.</param>
       </Docs>
@@ -286,7 +315,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Data.DataColumnCollection.Contains(System.String)" /> method to confirm the existence of a column before you perform additional operations on the column. The method returns false when two or more columns have the same name but different namespaces. The call does not succeed if there is any ambiguity when matching a column name to exactly one column.</para>
@@ -295,6 +323,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks whether the collection contains a column with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a column exists with this name; otherwise, false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Data.DataColumn.ColumnName" /> of the column to look for. </param>
       </Docs>
@@ -338,7 +370,6 @@
         <Parameter Name="column" Type="System.Data.DataColumn" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.DataColumnCollection.IndexOf(System.Data.DataColumn)" /> method is not case-sensitive.</para>
@@ -347,6 +378,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of a column specified by name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the column specified by <paramref name="column" /> if it is found; otherwise, -1.</para>
+        </returns>
         <param name="column">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the column to return. </param>
       </Docs>
@@ -365,12 +400,15 @@
         <Parameter Name="columnName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the column with the specific name (the name is not case sensitive).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the column with the specified name, or -1 if the column does not exist in the collection.</para>
+        </returns>
         <param name="columnName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the column to find. </param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data/DataRelation.xml b/mcs/class/System.Data/Documentation/en/System.Data/DataRelation.xml
index 05666103460..1cb58348b7c 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data/DataRelation.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data/DataRelation.xml
@@ -556,12 +556,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="P:System.Data.DataRelation.RelationName" />, if one exists.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the <see cref="P:System.Data.DataRelation.RelationName" /> property.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data/DataRelationCollection.xml b/mcs/class/System.Data/Documentation/en/System.Data/DataRelationCollection.xml
index ea17e863bed..8b759c6990a 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data/DataRelationCollection.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data/DataRelationCollection.xml
@@ -94,7 +94,6 @@
         <Parameter Name="childColumn" Type="System.Data.DataColumn" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataRelation'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When a <see cref="T:System.Data.DataRelation" /> object is added to the collection, <see cref="T:System.Data.ForeignKeyConstraint" /> and <see cref="T:System.Data.UniqueConstraint" /> objects are created by default if they do not already exist.</para>
@@ -103,6 +102,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Data.DataRelation" /> with a specified parent and child column, and adds it to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created relation.</para>
+        </returns>
         <param name="parentColumn">
           <attribution license="cc4" from="Microsoft" modified="false" />The parent column of the relation. </param>
         <param name="childColumn">
@@ -124,7 +127,6 @@
         <Parameter Name="childColumns" Type="System.Data.DataColumn[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataRelation'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When a <see cref="T:System.Data.DataRelation" /> object is added to the collection, <see cref="T:System.Data.ForeignKeyConstraint" /> and <see cref="T:System.Data.UniqueConstraint" /> objects are created by default if they do not already exist.</para>
@@ -133,6 +135,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Data.DataRelation" /> with the specified parent and child columns, and adds it to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created relation.</para>
+        </returns>
         <param name="parentColumns">
           <attribution license="cc4" from="Microsoft" modified="false" />The parent columns of the relation. </param>
         <param name="childColumns">
@@ -155,7 +161,6 @@
         <Parameter Name="childColumn" Type="System.Data.DataColumn" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataRelation'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When a <see cref="T:System.Data.DataRelation" /> object is added to the collection, <see cref="T:System.Data.ForeignKeyConstraint" /> and <see cref="T:System.Data.UniqueConstraint" /> objects are created by default if they do not already exist.</para>
@@ -164,6 +169,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Data.DataRelation" /> with the specified name, and parent and child columns, and adds it to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created relation.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the relation. </param>
         <param name="parentColumn">
@@ -188,7 +197,6 @@
         <Parameter Name="childColumns" Type="System.Data.DataColumn[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataRelation'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the relation is successfully added to the collection, the <see cref="E:System.Data.DataRelationCollection.CollectionChanged" /> event occurs.</para>
@@ -198,6 +206,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Data.DataRelation" /> with the specified name and arrays of parent and child columns, and adds it to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created DataRelation.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the DataRelation to create. </param>
         <param name="parentColumns">
@@ -223,7 +235,6 @@
         <Parameter Name="createConstraints" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataRelation'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When a <see cref="T:System.Data.DataRelation" /> object is added to the collection, <see cref="T:System.Data.ForeignKeyConstraint" /> and <see cref="T:System.Data.UniqueConstraint" /> objects are created by default if they do not already exist. To prevent this, you can set <paramref name="createConstraints" /> to false.</para>
@@ -232,6 +243,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Data.DataRelation" /> with the specified name, parent and child columns, with optional constraints according to the value of the <paramref name="createConstraints" /> parameter, and adds it to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created relation.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the relation. </param>
         <param name="parentColumn">
@@ -259,7 +274,6 @@
         <Parameter Name="createConstraints" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataRelation'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When a <see cref="T:System.Data.DataRelation" /> object is added to the collection, <see cref="T:System.Data.ForeignKeyConstraint" /> and <see cref="T:System.Data.UniqueConstraint" /> objects are created by default if they do not already exist.</para>
@@ -268,6 +282,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Data.DataRelation" /> with the specified name, arrays of parent and child columns, and value specifying whether to create a constraint, and adds it to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created relation.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the DataRelation to create. </param>
         <param name="parentColumns">
@@ -341,12 +359,15 @@
         <Parameter Name="relation" Type="System.Data.DataRelation" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies whether the specified <see cref="T:System.Data.DataRelation" /> can be removed from the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Data.DataRelation" /> can be removed; otherwise, false.</para>
+        </returns>
         <param name="relation">
           <attribution license="cc4" from="Microsoft" modified="false" />The relation to perform the check against. </param>
       </Docs>
@@ -403,12 +424,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies whether a <see cref="T:System.Data.DataRelation" /> with the specific name (case insensitive) exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if a relation with the specified name exists; otherwise false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the relation to find. </param>
       </Docs>
@@ -450,12 +474,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'DataSet'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method supports the .NET Framework infrastructure and is not intended to be used directly from your code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The referenced DataSet.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -472,12 +499,15 @@
         <Parameter Name="relation" Type="System.Data.DataRelation" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the specified <see cref="T:System.Data.DataRelation" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 0-based index of the relation, or -1 if the relation is not found in the collection.</para>
+        </returns>
         <param name="relation">
           <attribution license="cc4" from="Microsoft" modified="false" />The relation to search for. </param>
       </Docs>
@@ -496,12 +526,15 @@
         <Parameter Name="relationName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the <see cref="T:System.Data.DataRelation" /> specified by name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the relation with the specified name, or -1 if the relation does not exist in the collection.</para>
+        </returns>
         <param name="relationName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the relation to find. </param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data/DataRow.xml b/mcs/class/System.Data/Documentation/en/System.Data/DataRow.xml
index 7b785908236..2c142a4072d 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data/DataRow.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data/DataRow.xml
@@ -220,7 +220,6 @@
         <Parameter Name="relation" Type="System.Data.DataRelation" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataRow []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Data.DataTable" /> also contains a collection of <see cref="T:System.Data.DataRelation" /> objects that is returned by the <see cref="P:System.Data.DataTable.ChildRelations" /> property.</para>
@@ -229,6 +228,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the child rows of this <see cref="T:System.Data.DataRow" /> using the specified <see cref="T:System.Data.DataRelation" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Data.DataRow" /> objects or an array of length zero.</para>
+        </returns>
         <param name="relation">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.DataRelation" /> to use. </param>
       </Docs>
@@ -247,7 +250,6 @@
         <Parameter Name="relationName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataRow []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Data.DataTable" /> also contains a collection of <see cref="T:System.Data.DataRelation" /> objects that is returned by the <see cref="P:System.Data.DataTable.ChildRelations" /> property.</para>
@@ -256,6 +258,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the child rows of a <see cref="T:System.Data.DataRow" /> using the specified <see cref="P:System.Data.DataRelation.RelationName" /> of a <see cref="T:System.Data.DataRelation" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Data.DataRow" /> objects or an array of length zero.</para>
+        </returns>
         <param name="relationName">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Data.DataRelation.RelationName" /> of the <see cref="T:System.Data.DataRelation" /> to use. </param>
       </Docs>
@@ -275,7 +281,6 @@
         <Parameter Name="version" Type="System.Data.DataRowVersion" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataRow []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Data.DataTable" /> also contains a collection of <see cref="T:System.Data.DataRelation" /> objects that is returned by the <see cref="P:System.Data.DataTable.ChildRelations" /> property.</para>
@@ -286,6 +291,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the child rows of a <see cref="T:System.Data.DataRow" /> using the specified <see cref="T:System.Data.DataRelation" />, and <see cref="T:System.Data.DataRowVersion" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Data.DataRow" /> objects.</para>
+        </returns>
         <param name="relation">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.DataRelation" /> to use. </param>
         <param name="version">
@@ -307,7 +316,6 @@
         <Parameter Name="version" Type="System.Data.DataRowVersion" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataRow []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Data.DataTable" /> also contains a collection of <see cref="T:System.Data.DataRelation" /> objects that is returned by the <see cref="P:System.Data.DataTable.ChildRelations" /> property.</para>
@@ -318,6 +326,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the child rows of a <see cref="T:System.Data.DataRow" /> using the specified <see cref="P:System.Data.DataRelation.RelationName" /> of a <see cref="T:System.Data.DataRelation" />, and <see cref="T:System.Data.DataRowVersion" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Data.DataRow" /> objects or an array of length zero.</para>
+        </returns>
         <param name="relationName">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Data.DataRelation.RelationName" /> of the <see cref="T:System.Data.DataRelation" /> to use. </param>
         <param name="version">
@@ -338,7 +350,6 @@
         <Parameter Name="column" Type="System.Data.DataColumn" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Data.DataRow.SetColumnError(System.Int32,System.String)" /> method to set column errors.</para>
@@ -349,6 +360,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the error description of the specified <see cref="T:System.Data.DataColumn" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The text of the error description.</para>
+        </returns>
         <param name="column">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.DataColumn" />. </param>
       </Docs>
@@ -367,7 +382,6 @@
         <Parameter Name="columnIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Data.DataRow.SetColumnError(System.Int32,System.String)" /> method to set column errors.</para>
@@ -378,6 +392,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the error description for the column specified by index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The text of the error description.</para>
+        </returns>
         <param name="columnIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the column. </param>
       </Docs>
@@ -396,7 +414,6 @@
         <Parameter Name="columnName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Data.DataRow.SetColumnError(System.Int32,System.String)" /> method to set column errors.</para>
@@ -407,6 +424,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the error description for a column, specified by name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The text of the error description.</para>
+        </returns>
         <param name="columnName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the column. </param>
       </Docs>
@@ -423,7 +444,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'DataColumn []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.DataRow.GetColumnsInError" /> lets you reduce the number of <see cref="T:System.Data.DataColumn" /> objects that must be processed for errors by returning only those columns that have an error. Errors can be set to individual columns with the <see cref="M:System.Data.DataRow.SetColumnError(System.Int32,System.String)" /> method. To further reduce the number of processing, examine the <see cref="P:System.Data.DataRow.HasErrors" /> property of the <see cref="T:System.Data.DataRow" /> class to determine whether a <see cref="T:System.Data.DataRow" /> has errors before invoking <see cref="M:System.Data.DataRow.GetColumnsInError" />.</para>
@@ -433,6 +453,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of columns that have errors.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Data.DataColumn" /> objects that contain errors.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -449,7 +473,6 @@
         <Parameter Name="relation" Type="System.Data.DataRelation" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataRow'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In a <see cref="T:System.Data.DataSet" />, the collection of all parent <see cref="T:System.Data.DataRelation" /> objects for the data set is returned by the <see cref="M:System.Data.DataRow.GetParentRows(System.String)" /> method.</para>
@@ -459,6 +482,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the parent row of a <see cref="T:System.Data.DataRow" /> using the specified <see cref="T:System.Data.DataRelation" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The parent <see cref="T:System.Data.DataRow" /> of the current row.</para>
+        </returns>
         <param name="relation">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.DataRelation" /> to use. </param>
       </Docs>
@@ -477,7 +504,6 @@
         <Parameter Name="relationName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataRow'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In a <see cref="T:System.Data.DataSet" />, the collection of all parent <see cref="T:System.Data.DataRelation" /> objects for the data set is returned by the <see cref="M:System.Data.DataRow.GetParentRows(System.String)" /> method.</para>
@@ -487,6 +513,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the parent row of a <see cref="T:System.Data.DataRow" /> using the specified <see cref="P:System.Data.DataRelation.RelationName" /> of a <see cref="T:System.Data.DataRelation" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The parent <see cref="T:System.Data.DataRow" /> of the current row.</para>
+        </returns>
         <param name="relationName">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Data.DataRelation.RelationName" /> of a <see cref="T:System.Data.DataRelation" />. </param>
       </Docs>
@@ -506,7 +536,6 @@
         <Parameter Name="version" Type="System.Data.DataRowVersion" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataRow'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In a <see cref="T:System.Data.DataSet" />, the collection of all parent <see cref="T:System.Data.DataRelation" /> objects for the data set is returned by the <see cref="M:System.Data.DataRow.GetParentRows(System.String)" /> method.</para>
@@ -517,6 +546,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the parent row of a <see cref="T:System.Data.DataRow" /> using the specified <see cref="T:System.Data.DataRelation" />, and <see cref="T:System.Data.DataRowVersion" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The parent <see cref="T:System.Data.DataRow" /> of the current row.</para>
+        </returns>
         <param name="relation">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.DataRelation" /> to use. </param>
         <param name="version">
@@ -538,7 +571,6 @@
         <Parameter Name="version" Type="System.Data.DataRowVersion" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataRow'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In a <see cref="T:System.Data.DataSet" />, the collection of all parent <see cref="T:System.Data.DataRelation" /> objects for the data set is returned by the <see cref="M:System.Data.DataRow.GetParentRows(System.String)" /> method.</para>
@@ -549,6 +581,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the parent row of a <see cref="T:System.Data.DataRow" /> using the specified <see cref="P:System.Data.DataRelation.RelationName" /> of a <see cref="T:System.Data.DataRelation" />, and <see cref="T:System.Data.DataRowVersion" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The parent <see cref="T:System.Data.DataRow" /> of the current row.</para>
+        </returns>
         <param name="relationName">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Data.DataRelation.RelationName" /> of a <see cref="T:System.Data.DataRelation" />. </param>
         <param name="version">
@@ -569,7 +605,6 @@
         <Parameter Name="relation" Type="System.Data.DataRelation" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataRow []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In a <see cref="T:System.Data.DataSet" />, the collection of all parent <see cref="T:System.Data.DataRelation" /> objects for the data set is returned by the <see cref="M:System.Data.DataRow.GetParentRows(System.String)" /> method.</para>
@@ -579,6 +614,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the parent rows of a <see cref="T:System.Data.DataRow" /> using the specified <see cref="T:System.Data.DataRelation" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Data.DataRow" /> objects or an array of length zero.</para>
+        </returns>
         <param name="relation">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.DataRelation" /> to use. </param>
       </Docs>
@@ -597,7 +636,6 @@
         <Parameter Name="relationName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataRow []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In a <see cref="T:System.Data.DataSet" />, the collection of all parent <see cref="T:System.Data.DataRelation" /> objects for the data set is returned by the <see cref="M:System.Data.DataRow.GetParentRows(System.String)" /> method.</para>
@@ -607,6 +645,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the parent rows of a <see cref="T:System.Data.DataRow" /> using the specified <see cref="P:System.Data.DataRelation.RelationName" /> of a <see cref="T:System.Data.DataRelation" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Data.DataRow" /> objects or an array of length zero.</para>
+        </returns>
         <param name="relationName">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Data.DataRelation.RelationName" /> of a <see cref="T:System.Data.DataRelation" />. </param>
       </Docs>
@@ -626,7 +668,6 @@
         <Parameter Name="version" Type="System.Data.DataRowVersion" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataRow []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In a <see cref="T:System.Data.DataSet" />, the collection of all parent <see cref="T:System.Data.DataRelation" /> objects for the data set is returned by the <see cref="M:System.Data.DataRow.GetParentRows(System.String)" /> method.</para>
@@ -637,6 +678,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the parent rows of a <see cref="T:System.Data.DataRow" /> using the specified <see cref="T:System.Data.DataRelation" />, and <see cref="T:System.Data.DataRowVersion" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Data.DataRow" /> objects or an array of length zero.</para>
+        </returns>
         <param name="relation">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.DataRelation" /> to use. </param>
         <param name="version">
@@ -658,7 +703,6 @@
         <Parameter Name="version" Type="System.Data.DataRowVersion" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataRow []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In a <see cref="T:System.Data.DataSet" />, the collection of all parent <see cref="T:System.Data.DataRelation" /> objects for the data set is returned by the <see cref="M:System.Data.DataRow.GetParentRows(System.String)" /> method.</para>
@@ -669,6 +713,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the parent rows of a <see cref="T:System.Data.DataRow" /> using the specified <see cref="P:System.Data.DataRelation.RelationName" /> of a <see cref="T:System.Data.DataRelation" />, and <see cref="T:System.Data.DataRowVersion" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Data.DataRow" /> objects or an array of length zero.</para>
+        </returns>
         <param name="relationName">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Data.DataRelation.RelationName" /> of a <see cref="T:System.Data.DataRelation" />. </param>
         <param name="version">
@@ -715,7 +763,6 @@
         <Parameter Name="version" Type="System.Data.DataRowVersion" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.Data.DataRow.BeginEdit" /> method for more information.</para>
@@ -724,6 +771,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether a specified version exists.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the version exists; otherwise, false.</para>
+        </returns>
         <param name="version">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Data.DataRowVersion" /> values that specifies the row version. </param>
       </Docs>
@@ -742,12 +793,15 @@
         <Parameter Name="column" Type="System.Data.DataColumn" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the specified <see cref="T:System.Data.DataColumn" /> contains a null value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the column contains a null value; otherwise, false.</para>
+        </returns>
         <param name="column">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.DataColumn" />. </param>
       </Docs>
@@ -766,12 +820,15 @@
         <Parameter Name="columnIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the column at the specified index contains a null value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the column contains a null value; otherwise, false.</para>
+        </returns>
         <param name="columnIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the column. </param>
       </Docs>
@@ -790,12 +847,15 @@
         <Parameter Name="columnName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the named column contains a null value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the column contains a null value; otherwise, false.</para>
+        </returns>
         <param name="columnName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the column. </param>
       </Docs>
@@ -815,12 +875,15 @@
         <Parameter Name="version" Type="System.Data.DataRowVersion" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the specified <see cref="T:System.Data.DataColumn" /> and <see cref="T:System.Data.DataRowVersion" /> contains a null value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the column contains a null value; otherwise, false.</para>
+        </returns>
         <param name="column">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.DataColumn" />. </param>
         <param name="version">
diff --git a/mcs/class/System.Data/Documentation/en/System.Data/DataRowCollection.xml b/mcs/class/System.Data/Documentation/en/System.Data/DataRowCollection.xml
index 6944f51e6a1..fee1a2907b4 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data/DataRowCollection.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data/DataRowCollection.xml
@@ -70,7 +70,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataRow'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If a <see cref="T:System.Data.DataColumn" /> object has its <see cref="P:System.Data.DataColumn.AutoIncrement" /> set to True, null should be passed to get the default value for that column.</para>
@@ -80,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a row using specified values and adds it to the <see cref="T:System.Data.DataRowCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>None.</para>
+        </returns>
         <param name="values">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of values that are used to create the new row. </param>
       </Docs>
@@ -117,7 +120,6 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To use the <see cref="M:System.Data.DataRowCollection.Contains(System.Object)" /> method, the <see cref="T:System.Data.DataTable" /> object to which the <see cref="T:System.Data.DataRowCollection" /> object belongs to must have at least one column designated as a primary key column. See the <see cref="P:System.Data.DataTable.PrimaryKey" /> property for more information about how to create a primary key column.</para>
@@ -127,6 +129,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the primary key of any row in the collection contains the specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains a <see cref="T:System.Data.DataRow" /> with the specified primary key value; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The value of the primary key to test for. </param>
       </Docs>
@@ -145,7 +151,6 @@
         <Parameter Name="keys" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To use the <see cref="M:System.Data.DataRowCollection.Contains(System.Object)" /> method with an array of values, the <see cref="T:System.Data.DataTable" /> object to which the <see cref="T:System.Data.DataRowCollection" /> object belongs must have an array of columns designated as primary keys. See the <see cref="P:System.Data.DataTable.PrimaryKey" /> property for more information about how to create an array of primary key columns. The number of array elements must correspond to the number of primary key columns in the <see cref="T:System.Data.DataTable" />.</para>
@@ -155,6 +160,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the primary key columns of any row in the collection contain the values specified in the object array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Data.DataRowCollection" /> contains a <see cref="T:System.Data.DataRow" /> with the specified key values; otherwise, false.</para>
+        </returns>
         <param name="keys">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of primary key values to test for. </param>
       </Docs>
@@ -241,7 +250,6 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataRow'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To use the Find method, the <see cref="T:System.Data.DataTable" /> object to which the <see cref="T:System.Data.DataRowCollection" /> object belongs must have at least one column designated as a primary key column. See the <see cref="P:System.Data.DataTable.PrimaryKey" /> property for more information about how to create a primary key column.</para>
@@ -250,6 +258,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the row specified by the primary key value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataRow" /> that contains the primary key value specified; otherwise a null value if the primary key value does not exist in the <see cref="T:System.Data.DataRowCollection" />.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The primary key value of the <see cref="T:System.Data.DataRow" /> to find. </param>
       </Docs>
@@ -268,7 +280,6 @@
         <Parameter Name="keys" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataRow'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To use the <see cref="M:System.Data.DataRowCollection.Find(System.Object)" /> method, the <see cref="T:System.Data.DataTable" /> object to which the <see cref="T:System.Data.DataRowCollection" /> object belongs must have at least one column designated as a primary key column. When two or more rows have the same primary key value, then the first row found is returned. This occurs when <see cref="P:System.Data.DataSet.EnforceConstraints" /> is set to false. See the <see cref="P:System.Data.DataTable.PrimaryKey" /> property for more information about how to create a <see cref="P:System.Data.DataTable.PrimaryKey" /> column, or an array of <see cref="T:System.Data.DataColumn" /> objects when the table has more than one primary key.</para>
@@ -277,6 +288,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the row that contains the specified primary key values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataRow" /> object that contains the primary key values specified; otherwise a null value if the primary key value does not exist in the <see cref="T:System.Data.DataRowCollection" />.</para>
+        </returns>
         <param name="keys">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of primary key values to find. The type of the array is Object. </param>
       </Docs>
@@ -296,12 +311,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <see cref="T:System.Collections.IEnumerator" /> for this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for this collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IndexOf">
@@ -317,12 +335,15 @@
         <Parameter Name="row" Type="System.Data.DataRow" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the specified <see cref="T:System.Data.DataRow" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the row, or -1 if the row is not found in the collection.</para>
+        </returns>
         <param name="row">
           <attribution license="cc4" from="Microsoft" modified="false" />The DataRow to search for.</param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data/DataRowView.xml b/mcs/class/System.Data/Documentation/en/System.Data/DataRowView.xml
index 75bd5942d64..c97c28d7559 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data/DataRowView.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data/DataRowView.xml
@@ -94,12 +94,15 @@
         <Parameter Name="relation" Type="System.Data.DataRelation" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataView'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Data.DataView" /> for the child <see cref="T:System.Data.DataTable" /> with the specified child <see cref="T:System.Data.DataRelation" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>a <see cref="T:System.Data.DataView" /> for the child <see cref="T:System.Data.DataTable" />.</para>
+        </returns>
         <param name="relation">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.DataRelation" /> object. </param>
       </Docs>
@@ -118,12 +121,15 @@
         <Parameter Name="relationName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataView'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Data.DataView" /> for the child <see cref="T:System.Data.DataTable" /> with the specified child <see cref="T:System.Data.DataRelation" /> name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>a <see cref="T:System.Data.DataView" /> for the child <see cref="T:System.Data.DataTable" />.</para>
+        </returns>
         <param name="relationName">
           <attribution license="cc4" from="Microsoft" modified="false" />A string containing the <see cref="T:System.Data.DataRelation" /> name. </param>
       </Docs>
@@ -205,12 +211,15 @@
         <Parameter Name="other" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the current <see cref="T:System.Data.DataRowView" /> is identical to the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="object" /> is a <see cref="T:System.Data.DataRowView" /> and it returns the same row as the current <see cref="T:System.Data.DataRowView" />; otherwise false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Object" /> to be compared. </param>
       </Docs>
@@ -227,12 +236,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code of the <see cref="T:System.Data.DataRow" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code 1, which represents Boolean true if the value of this instance is nonzero; otherwise the integer zero, which represents Boolean false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -393,7 +405,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.DataRowView" /> instance is cast to an <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -402,6 +413,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of custom attributes for this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An AttributeCollection containing the attributes for this object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetClassName">
@@ -416,7 +431,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.DataRowView" /> instance is cast to an <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -425,6 +439,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the class name of this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The class name of this instance of a component.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetComponentName">
@@ -439,7 +457,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.DataRowView" /> instance is cast to an <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -448,6 +465,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of this instance of a component.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetConverter">
@@ -462,7 +483,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.DataRowView" /> instance is cast to an <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -471,6 +491,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a type converter for this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type converter for this instance of a component.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetDefaultEvent">
@@ -485,7 +509,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.DataRowView" /> instance is cast to an <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -494,6 +517,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the default event for this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The default event for this instance of a component.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetDefaultProperty">
@@ -508,7 +535,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.DataRowView" /> instance is cast to an <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -517,6 +543,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the default property for this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The default property for this instance of a component.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetEditor">
@@ -533,7 +563,6 @@
         <Parameter Name="editorBaseType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.DataRowView" /> instance is cast to an <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -542,6 +571,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an editor of the specified type for this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> of the specified type that is the editor for this object, or null if the editor cannot be found.</para>
+        </returns>
         <param name="editorBaseType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents the editor for this object. </param>
       </Docs>
@@ -558,7 +591,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.DataRowView" /> instance is cast to an <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -567,6 +599,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the events for this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The events for this instance of a component.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetEvents">
@@ -583,7 +619,6 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.DataRowView" /> instance is cast to an <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -592,6 +627,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the events for this instance of a component with specified attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The events for this instance of a component.</para>
+        </returns>
         <param name="attributes">
           <attribution license="cc4" from="Microsoft" modified="false" />The attributes</param>
       </Docs>
@@ -608,7 +647,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.DataRowView" /> instance is cast to an <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -617,6 +655,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the properties for this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The properties for this instance of a component.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetProperties">
@@ -633,7 +675,6 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.DataRowView" /> instance is cast to an <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -642,6 +683,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the properties for this instance of a component with specified attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The properties for this instance of a component.</para>
+        </returns>
         <param name="attributes">
           <attribution license="cc4" from="Microsoft" modified="false" />The attributes.</param>
       </Docs>
@@ -660,7 +705,6 @@
         <Parameter Name="pd" Type="System.ComponentModel.PropertyDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.DataRowView" /> instance is cast to an <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -669,6 +713,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that contains the property described by the specified property descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the owner of the specified property.</para>
+        </returns>
         <param name="pd">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.PropertyDescriptor" /> that represents the property whose owner is to be found. </param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data/DataSet.xml b/mcs/class/System.Data/Documentation/en/System.Data/DataSet.xml
index c015392c7a5..192b2cf89a0 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data/DataSet.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data/DataSet.xml
@@ -287,7 +287,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>A DataSet with the same structure as the current one, but with no data.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -298,6 +297,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the structure of the <see cref="T:System.Data.DataSet" />, including all <see cref="T:System.Data.DataTable" /> schemas, relations, and constraints. Does not copy any data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.DataSet" /> with the same schema as the current <see cref="T:System.Data.DataSet" />, but none of the data.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -312,12 +315,18 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>A new object which contains a copy of the current object's schema and data.</returns>
         <remarks>If the current object is a subclass of DataSet, the clone will also be of the same type.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies both the structure and data for this <see cref="T:System.Data.DataSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.DataSet" /> with the same structure (table schemas, relations, and constraints) and data as this <see cref="T:System.Data.DataSet" />.</para>
+          <block subset="none" type="note">
+            <para>If these classes have been subclassed, the copy will also be of the same subclasses.</para>
+          </block>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -335,7 +344,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In order to ensure the order of the result sets within the returned <see cref="T:System.Data.DataTableReader" />, if a <see cref="T:System.Data.DataTable" /> within the <see cref="T:System.Data.DataSet" /> is empty, it is represented by an empty result set within the returned DataTableReader.</para>
@@ -344,6 +352,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Data.DataTableReader" /> with one result set per <see cref="T:System.Data.DataTable" />, in the same sequence as the tables appear in the <see cref="P:System.Data.DataSet.Tables" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataTableReader" /> containing one or more result sets, corresponding to the <see cref="T:System.Data.DataTable" /> instances contained within the source <see cref="T:System.Data.DataSet" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateDataReader">
@@ -365,7 +377,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In order to ensure that the order of the result sets within the returned <see cref="T:System.Data.DataTableReader" />, if a <see cref="T:System.Data.DataTable" /> within the <see cref="T:System.Data.DataSet" /> is empty, it is represented by an empty result set within the returned DataTableReader. Because this overloaded version allows you to supply a list of DataTable instances as parameters, you can specify the order in which the result sets appear within the returned DataTableReader.</para>
@@ -374,6 +385,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Data.DataTableReader" /> with one result set per <see cref="T:System.Data.DataTable" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataTableReader" /> containing one or more result sets, corresponding to the <see cref="T:System.Data.DataTable" /> instances contained within the source <see cref="T:System.Data.DataSet" />. The returned result sets are in the order specified by the <paramref name="dataTables" /> parameter.</para>
+        </returns>
         <param name="dataTables">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of DataTables providing the order of the result sets to be returned in the <see cref="T:System.Data.DataTableReader" />.</param>
       </Docs>
@@ -445,7 +460,6 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be called when deserializing a typed <see cref="T:System.Data.DataSet" /> to determine its <see cref="P:System.Data.DataSet.SchemaSerializationMode" />.</para>
@@ -454,6 +468,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the <see cref="P:System.Data.DataSet.SchemaSerializationMode" /> for a <see cref="T:System.Data.DataSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Data.SchemaSerializationMode" /> enumeration indicating whether schema information has been omitted from the payload.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> instance that is passed during deserialization of the <see cref="T:System.Data.DataSet" />.</param>
       </Docs>
@@ -472,7 +490,6 @@
         <Parameter Name="context" Type="System.Runtime.Serialization.StreamingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be called when deserializing a typed <see cref="T:System.Data.DataSet" /> to determine its <see cref="P:System.Data.DataSet.SchemaSerializationMode" />.</para>
@@ -481,6 +498,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the <see cref="P:System.Data.DataSet.SchemaSerializationMode" /> for a <see cref="T:System.Data.DataSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Data.SchemaSerializationMode" /> enumeration indicating whether schema information has been omitted from the payload.</para>
+        </returns>
         <param name="info">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Runtime.Serialization.SerializationInfo" /> that a DataSet’s protected constructor <see cref="M:System.Data.DataSet.#ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)" /> is invoked with during deserialization in remoting scenarios. </param>
         <param name="context">
@@ -575,7 +596,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>A copy of all the changes which can be operated upon separately to the current object and then merged back in using <see cref="M:System.Data.DataSet.Merge" />, or null reference if no changes are found.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Data.DataSet" /> that contains a copy of all rows in the original <see cref="T:System.Data.DataSet" /> that have pending changes. Relationship constraints can cause additional unchanged rows to be added to the new <see cref="T:System.Data.DataSet" /> if the unchanged rows contain primary keys corresponding to foreign keys in the changed rows. The method returns null if there are no rows in the original <see cref="T:System.Data.DataSet" /> that have pending changes.</para>
@@ -584,6 +604,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a copy of the <see cref="T:System.Data.DataSet" /> that contains all changes made to it since it was loaded or since <see cref="M:System.Data.DataSet.AcceptChanges" /> was last called.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the changes from this <see cref="T:System.Data.DataSet" /> that can have actions performed on it and later be merged back in using <see cref="M:System.Data.DataSet.Merge(System.Data.DataSet)" />. If no changed rows are found, the method returns null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -600,7 +624,6 @@
         <Parameter Name="rowStates" Type="System.Data.DataRowState" />
       </Parameters>
       <Docs>
-        <returns>A filtered copy of all the changes which can be operated upon separately to the current object and then merged back in using DataSet.Merge, or null reference if no changes are found. </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.DataSet.GetChanges" /> method is used to produce a second <see cref="T:System.Data.DataSet" /> object that contains only the changes introduced into the original. Use the <paramref name="rowStates" /> argument to specify the type of changes the new object should include.</para>
@@ -610,6 +633,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a copy of the <see cref="T:System.Data.DataSet" /> containing all changes made to it since it was last loaded, or since <see cref="M:System.Data.DataSet.AcceptChanges" /> was called, filtered by <see cref="T:System.Data.DataRowState" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A filtered copy of the <see cref="T:System.Data.DataSet" /> that can have actions performed on it, and subsequently be merged back in using <see cref="M:System.Data.DataSet.Merge(System.Data.DataSet)" />. If no rows of the desired <see cref="T:System.Data.DataRowState" /> are found, the method returns null.</para>
+        </returns>
         <param name="rowStates">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Data.DataRowState" /> values. </param>
       </Docs>
@@ -631,12 +658,15 @@
         <Parameter Name="schemaSet" Type="System.Xml.Schema.XmlSchemaSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a copy of <see cref="T:System.Xml.Schema.XmlSchemaSet" /> for the DataSet.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
+        </returns>
         <param name="schemaSet">
           <attribution license="cc4" from="Microsoft" modified="false" />The specified schema set. </param>
       </Docs>
@@ -674,12 +704,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns />
         <remarks />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a serializable <see cref="T:System.Xml.Schema.XMLSchema" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.Schema.XMLSchema" /> instance.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -720,7 +753,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>A string which contains the XML representation of the data in the current DataSet.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method is identical to calling <see cref="M:System.Data.DataSet.WriteXml(System.IO.Stream)" /> with <see cref="T:System.Data.XmlWriteMode" /> set to <see cref="F:System.Data.XmlWriteMode.IgnoreSchema" />.</para>
@@ -732,6 +764,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML representation of the data stored in the <see cref="T:System.Data.DataSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that is a representation of the data stored in the <see cref="T:System.Data.DataSet" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -746,7 +782,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>A string which contains the XSD schema for the XML of the data in the current DataSet.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method is identical to calling <see cref="M:System.Data.DataSet.WriteXmlSchema(System.IO.Stream)" />, except that only the primary schema is written.</para>
@@ -758,6 +793,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema for the XML representation of the data stored in the <see cref="T:System.Data.DataSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>String that is the XML Schema for the XML representation of the data stored in the <see cref="T:System.Data.DataSet" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -772,13 +811,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <see langword="true" /> if the current DataSet has changes, <see langword="false" /> otherwise.</returns>
         <remarks>It is a good idea to call HasChanges before invoking <see cref="M:System.DataSet.GetChanges" />.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the <see cref="T:System.Data.DataSet" /> has changes, including new, deleted, or modified rows.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Data.DataSet" /> has changes; otherwise false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -795,8 +836,6 @@
         <Parameter Name="rowStates" Type="System.Data.DataRowState" />
       </Parameters>
       <Docs>
-        <returns>
-          <see langword="true" /> if the current DataSet has changes, <see langword="false" /> otherwise.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Examine the <see cref="M:System.Data.DataSet.HasChanges" /> property of the DataSet before invoking the <see cref="M:System.Data.DataSet.GetChanges" /> method.</para>
@@ -805,6 +844,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the <see cref="T:System.Data.DataSet" /> has changes, including new, deleted, or modified rows, filtered by <see cref="T:System.Data.DataRowState" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Data.DataSet" /> has changes; otherwise false.</para>
+        </returns>
         <param name="rowStates">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Data.DataRowState" /> values. </param>
       </Docs>
@@ -997,7 +1040,6 @@
         <Parameter Name="context" Type="System.Runtime.Serialization.StreamingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member supports the .NET Framework infrastructure and is not intended to be used directly from your code.</para>
@@ -1006,6 +1048,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inspects the format of the serialized representation of the DataSet.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Runtime.Serialization.SerializationInfo" /> represents a DataSet serialized in its binary format, false otherwise.</para>
+        </returns>
         <param name="info">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Runtime.Serialization.SerializationInfo" /> object.</param>
         <param name="context">
@@ -1638,7 +1684,6 @@
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>The <see cref="T:System.Data.XmlReadMode" /> used to read the data.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.DataSet.ReadXml(System.Xml.XmlReader)" /> method provides a way to read either data only, or both data and schema into a <see cref="T:System.Data.DataSet" /> from an XML document, whereas the <see cref="M:System.Data.DataSet.ReadXmlSchema(System.Xml.XmlReader)" /> method reads only the schema. To read both data and schema, use one of the ReadXML overloads that includes the <paramref name="mode" /> parameter, and set its value to ReadSchema.</para>
@@ -1667,6 +1712,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads XML schema and data into the <see cref="T:System.Data.DataSet" /> using the specified <see cref="T:System.IO.Stream" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Data.XmlReadMode" /> used to read the data.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that derives from <see cref="T:System.IO.Stream" />. </param>
       </Docs>
@@ -1685,7 +1734,6 @@
         <Parameter Name="reader" Type="System.IO.TextReader" />
       </Parameters>
       <Docs>
-        <returns>The <see cref="T:System.Data.XmlReadMode" /> used to read the data.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.DataSet.ReadXml(System.Xml.XmlReader)" /> method provides a way to read either data only, or both data and schema into a <see cref="T:System.Data.DataSet" /> from an XML document, whereas the <see cref="M:System.Data.DataSet.ReadXmlSchema(System.Xml.XmlReader)" /> method reads only the schema. To read both data and schema, use one of the ReadXML overloads that includes the <paramref name="mode" /> parameter, and set its value to ReadSchema.</para>
@@ -1715,6 +1763,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads XML schema and data into the <see cref="T:System.Data.DataSet" /> using the specified <see cref="T:System.IO.TextReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Data.XmlReadMode" /> used to read the data.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The TextReader from which to read the schema and data. </param>
       </Docs>
@@ -1733,7 +1785,6 @@
         <Parameter Name="fileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>The <see cref="T:System.Data.XmlReadMode" /> used to read the data.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.DataSet.ReadXml(System.Xml.XmlReader)" /> method provides a way to read either data only, or both data and schema into a <see cref="T:System.Data.DataSet" /> from an XML document, whereas the <see cref="M:System.Data.DataSet.ReadXmlSchema(System.Xml.XmlReader)" /> method reads only the schema. To read both data and schema, use one of the ReadXML overloads that includes the <paramref name="mode" /> parameter, and set its value to ReadSchema.</para>
@@ -1762,6 +1813,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads XML schema and data into the <see cref="T:System.Data.DataSet" /> using the specified file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XmlReadMode used to read the data.</para>
+        </returns>
         <param name="fileName">
           <attribution license="cc4" from="Microsoft" modified="false" />The filename (including the path) from which to read. </param>
       </Docs>
@@ -1780,7 +1835,6 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>The <see cref="T:System.Data.XmlReadMode" /> used to read the data.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.DataSet.ReadXml(System.Xml.XmlReader)" /> method provides a way to read either data only, or both data and schema into a <see cref="T:System.Data.DataSet" /> from an XML document, whereas the <see cref="M:System.Data.DataSet.ReadXmlSchema(System.Xml.XmlReader)" /> method reads only the schema. To read both data and schema, use one of the ReadXML overloads that includes the <paramref name="mode" /> parameter, and set its value to ReadSchema.</para>
@@ -1811,6 +1865,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads XML schema and data into the <see cref="T:System.Data.DataSet" /> using the specified <see cref="T:System.Xml.XmlReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XmlReadMode used to read the data.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> from which to read. </param>
       </Docs>
@@ -1830,7 +1888,6 @@
         <Parameter Name="mode" Type="System.Data.XmlReadMode" />
       </Parameters>
       <Docs>
-        <returns>The <see cref="T:System.Data.XmlReadMode" /> used to read the data.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.DataSet.ReadXml(System.Xml.XmlReader)" /> method provides a way to read either data only, or both data and schema into a <see cref="T:System.Data.DataSet" /> from an XML document, whereas the <see cref="M:System.Data.DataSet.ReadXmlSchema(System.Xml.XmlReader)" /> method reads only the schema. To read both data and schema, use one of the ReadXML overloads that includes the <paramref name="mode" /> parameter, and set its value to ReadSchema.</para>
@@ -1862,6 +1919,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads XML schema and data into the <see cref="T:System.Data.DataSet" /> using the specified <see cref="T:System.IO.Stream" /> and <see cref="T:System.Data.XmlReadMode" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XmlReadMode used to read the data.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.Stream" /> from which to read. </param>
         <param name="mode">
@@ -1883,7 +1944,6 @@
         <Parameter Name="mode" Type="System.Data.XmlReadMode" />
       </Parameters>
       <Docs>
-        <returns>The <see cref="T:System.Data.XmlReadMode" /> used to read the data.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.DataSet.ReadXml(System.Xml.XmlReader)" /> method provides a way to read either data only, or both data and schema into a <see cref="T:System.Data.DataSet" /> from an XML document, whereas the <see cref="M:System.Data.DataSet.ReadXmlSchema(System.Xml.XmlReader)" /> method reads only the schema. To read both data and schema, use one of the ReadXML overloads that includes the <paramref name="mode" /> parameter, and set its value to ReadSchema.</para>
@@ -1912,6 +1972,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads XML schema and data into the <see cref="T:System.Data.DataSet" /> using the specified <see cref="T:System.IO.TextReader" /> and <see cref="T:System.Data.XmlReadMode" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XmlReadMode used to read the data.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.TextReader" /> from which to read. </param>
         <param name="mode">
@@ -1933,7 +1997,6 @@
         <Parameter Name="mode" Type="System.Data.XmlReadMode" />
       </Parameters>
       <Docs>
-        <returns>The <see cref="T:System.Data.XmlReadMode" /> used to read the data.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.DataSet.ReadXml(System.Xml.XmlReader)" /> method provides a way to read either data only, or both data and schema into a <see cref="T:System.Data.DataSet" /> from an XML document, whereas the <see cref="M:System.Data.DataSet.ReadXmlSchema(System.Xml.XmlReader)" /> method reads only the schema. To read both data and schema, use one of the ReadXML overloads that includes the <paramref name="mode" /> parameter, and set its value to ReadSchema.</para>
@@ -1962,6 +2025,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads XML schema and data into the <see cref="T:System.Data.DataSet" /> using the specified file and <see cref="T:System.Data.XmlReadMode" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XmlReadMode used to read the data.</para>
+        </returns>
         <param name="fileName">
           <attribution license="cc4" from="Microsoft" modified="false" />The filename (including the path) from which to read. </param>
         <param name="mode">
@@ -1983,7 +2050,6 @@
         <Parameter Name="mode" Type="System.Data.XmlReadMode" />
       </Parameters>
       <Docs>
-        <returns>The <see cref="T:System.Data.XmlReadMode" /> used to read the data.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.DataSet.ReadXml(System.Xml.XmlReader)" /> method provides a way to read either data only, or both data and schema into a <see cref="T:System.Data.DataSet" /> from an XML document, whereas the <see cref="M:System.Data.DataSet.ReadXmlSchema(System.Xml.XmlReader)" /> method reads only the schema. To read both data and schema, use one of the ReadXML overloads that includes the <paramref name="mode" /> parameter, and set its value to ReadSchema.</para>
@@ -2012,6 +2078,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads XML schema and data into the <see cref="T:System.Data.DataSet" /> using the specified <see cref="T:System.Xml.XmlReader" /> and <see cref="T:System.Data.XmlReadMode" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XmlReadMode used to read the data.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> from which to read. </param>
         <param name="mode">
@@ -2320,8 +2390,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <see langword="true" /> if the <see cref="P:System.Data.DataSet.Relations" /> property has been modified from its default state, <see langword="false" /> otherwise.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You typically use this method if you are either creating a designer for the <see cref="T:System.Data.DataSet" />, or creating your own control incorporating the <see cref="T:System.Data.DataSet" />.</para>
@@ -2330,6 +2398,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether <see cref="P:System.Data.DataSet.Relations" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property value has been changed from its default; otherwise false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -2344,8 +2416,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <see langword="true" /> if the <see cref="P:System.Data.DataSet.Tables" /> property has been modified from its default state, <see langword="false" /> otherwise.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You typically use this method only if you are either creating a designer for the <see cref="T:System.Data.DataSet" />, or creating your own control incorporating the <see cref="T:System.Data.DataSet" />.</para>
@@ -2354,6 +2424,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether <see cref="P:System.Data.DataSet.Tables" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property value has been changed from its default; otherwise false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -2426,7 +2500,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.DataSet" /> instance is cast to an <see cref="T:System.ComponentModel.IListSource" /> interface.</para>
@@ -2435,6 +2508,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ComponentModel.IListSource.GetList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>For a description of this member, see <see cref="M:System.ComponentModel.IListSource.GetList" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Runtime.Serialization.ISerializable.GetObjectData">
@@ -2474,7 +2551,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.DataSet" /> instance is cast to an <see cref="T:System.Xml.Serialization.IXmlSerializable" /> interface.</para>
@@ -2483,6 +2559,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Xml.Serialization.IXmlSerializable.GetSchema" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>For a description of this member, see <see cref="M:System.Xml.Serialization.IXmlSerializable.GetSchema" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
diff --git a/mcs/class/System.Data/Documentation/en/System.Data/DataTable.xml b/mcs/class/System.Data/Documentation/en/System.Data/DataTable.xml
index a85d8273043..a27e3a20896 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data/DataTable.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data/DataTable.xml
@@ -352,14 +352,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>An empty copy of the DataTable. The new DataTable duplicates the Schema and constraints, but does not contain any of the Data from the old DataTable.
-</para>
-          <block subset="none" type="note">
-            <para>The clone will consist of the same derived classes, if any, as the original DataTable.
-  </para>
-          </block>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If these classes have been derived, the clone will also be of the same derived classes.</para>
@@ -369,6 +361,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clones the structure of the <see cref="T:System.Data.DataTable" />, including all <see cref="T:System.Data.DataTable" /> schemas and constraints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.DataTable" /> with the same schema as the current <see cref="T:System.Data.DataTable" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -457,7 +453,6 @@
         <Parameter Name="filter" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="expression" /> parameter requires an aggregate function. For example, the following is a legal expression:</para>
@@ -476,6 +471,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the given expression on the current rows that pass the filter criteria.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" />, set to the result of the computation. If the expression evaluates to null, the return value will be <see cref="F:System.DBNull.Value" />.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression to compute. </param>
         <param name="filter">
@@ -536,19 +535,18 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A duplicate of the original DataTable including the Schema, the constraints and the Data.
-</para>
-          <block subset="none" type="note">
-            <para>The duplicate will be an exact copy of the original DataTable and will consist of the same derived classes, if any.
-  </para>
-          </block>
-        </returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies both the structure and data for this <see cref="T:System.Data.DataTable" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.DataTable" /> with the same structure (table schemas and constraints) and data as this <see cref="T:System.Data.DataTable" />.</para>
+          <para>If these classes have been derived, the copy will also be of the same derived classes.</para>
+          <para>
+            <see cref="M:System.Data.DataTable.Copy" /> creates a new <see cref="T:System.Data.DataTable" /> with the same structure and data as the original <see cref="T:System.Data.DataTable" />. To copy the structure to a new <see cref="T:System.Data.DataTable" />, but not the data, use <see cref="M:System.Data.DataTable.Clone" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -566,12 +564,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Data.DataTableReader" /> corresponding to the data within this <see cref="T:System.Data.DataTable" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataTableReader" /> containing one result set, corresponding to the source <see cref="T:System.Data.DataTable" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateInstance">
@@ -582,12 +583,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'DataTable'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of <see cref="T:System.Data.DataTable" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new expression.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -775,7 +779,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'DataTable'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Data.DataSet" /> containing a copy of all rows in the original <see cref="T:System.Data.DataSet" /> that have pending changes. Relationship constraints can cause additional unchanged rows to be added to the new <see cref="T:System.Data.DataSet" /> if the unchanged rows contain primary keys corresponding to foreign keys in the changed rows. The method returns null (Nothing in Visual Basic) if there are no rows in the original <see cref="T:System.Data.DataSet" /> with pending changes.</para>
@@ -784,6 +787,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a copy of the <see cref="T:System.Data.DataTable" /> that contains all changes made to it since it was loaded or <see cref="M:System.Data.DataTable.AcceptChanges" /> was last called.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the changes from this <see cref="T:System.Data.DataTable" />, or null if no changes are found.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -800,7 +807,6 @@
         <Parameter Name="rowStates" Type="System.Data.DataRowState" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataTable'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.DataTable.GetChanges" /> method is used to produce a second <see cref="T:System.Data.DataTable" /> object that contains only the changes introduced into the original. Use the <paramref name="rowStates" /> argument to specify the type of changes the new object should include.</para>
@@ -810,6 +816,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a copy of the <see cref="T:System.Data.DataTable" /> containing all changes made to it since it was last loaded, or since <see cref="M:System.Data.DataTable.AcceptChanges" /> was called, filtered by <see cref="T:System.Data.DataRowState" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A filtered copy of the <see cref="T:System.Data.DataTable" /> that can have actions performed on it, and later be merged back in the <see cref="T:System.Data.DataTable" /> using <see cref="M:System.Data.DataSet.Merge(System.Data.DataSet)" />. If no rows of the desired <see cref="T:System.Data.DataRowState" /> are found, the method returns null.</para>
+        </returns>
         <param name="rowStates">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Data.DataRowState" /> values. </param>
       </Docs>
@@ -831,12 +841,15 @@
         <Parameter Name="schemaSet" Type="System.Xml.Schema.XmlSchemaSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns an <see cref="T:System.Xml.Schema.XmlSchemaSet" /> instance containing the Web Services Description Language (WSDL) that describes the <see cref="T:System.Data.DataTable" /> for Web Services.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.Schema.XmlSchemaSet" /> instance.</para>
+        </returns>
         <param name="schemaSet">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.Schema.XmlSchemaSet" /> instance.</param>
       </Docs>
@@ -849,7 +862,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'DataRow []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the list of <see cref="T:System.Data.DataRow" /> objects that have <see cref="P:System.Data.DataRow.RowError" /> set. For example, errors can occur when calling <see cref="M:System.Data.Common.DataAdapter.Update(System.Data.DataSet)" /> with <see cref="P:System.Data.Common.DataAdapter.ContinueUpdateOnError" /> set to <system>true</system>. Do not invoke <see cref="M:System.Data.DataTable.AcceptChanges" /> on the <see cref="T:System.Data.DataTable" /> until you resolve all errors and resubmit the <see cref="T:System.Data.DataSet" /> for updating.</para>
@@ -858,6 +870,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of <see cref="T:System.Data.DataRow" /> objects that contain errors.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Data.DataRow" /> objects that have errors.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -897,12 +913,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Type'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the row type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the type of the <see cref="T:System.Data.DataRow" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -920,12 +939,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Xml.Serialization.IXmlSerializable.GetSchema" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para> An <see cref="T:System.Xml.Schema.XmlSchema" /> that describes the XML representation of the object that is produced by the <see cref="M:System.Xml.Serialization.IXmlSerializable.WriteXml(System.Xml.XmlWriter)" /> method and consumed by the <see cref="M:System.Xml.Serialization.IXmlSerializable.ReadXml(System.Xml.XmlReader)" /> method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HasErrors">
@@ -1708,7 +1730,6 @@
         <Parameter Name="fAcceptChanges" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataRow'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.DataTable.LoadDataRow(System.Object[],System.Boolean)" /> method takes an array of values and finds the matching value(s) in the primary key column(s).</para>
@@ -1721,6 +1742,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds and updates a specific row. If no matching row is found, a new row is created using the given values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Data.DataRow" />.</para>
+        </returns>
         <param name="values">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of values used to create the new row. </param>
         <param name="fAcceptChanges">
@@ -1745,7 +1770,6 @@
         <Parameter Name="loadOption" Type="System.Data.LoadOption" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.DataTable.LoadDataRow(System.Object[],System.Boolean)" /> method takes an array of values and finds the matching value(s) in the primary key column(s).</para>
@@ -1758,6 +1782,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds and updates a specific row. If no matching row is found, a new row is created using the given values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Data.DataRow" />.</para>
+        </returns>
         <param name="values">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of values used to create the new row. </param>
         <param name="loadOption">
@@ -1951,7 +1979,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'DataRow'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You must use the <see cref="M:System.Data.DataTable.NewRow" /> method to create new <see cref="T:System.Data.DataRow" /> objects with the same schema as the <see cref="T:System.Data.DataTable" />. After creating a <see cref="T:System.Data.DataRow" />, you can add it to the <see cref="T:System.Data.DataRowCollection" />, through the <see cref="T:System.Data.DataTable" /> object's <see cref="P:System.Data.DataTable.Rows" /> property. When you use <see cref="M:System.Data.DataTable.NewRow" /> to create new rows, the rows must be added to or deleted from the data table before you call <see cref="M:System.Data.DataTable.Clear" />.</para>
@@ -1960,6 +1987,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Data.DataRow" /> with the same schema as the table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataRow" /> with the same schema as the <see cref="T:System.Data.DataTable" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1980,12 +2011,15 @@
         <Parameter Name="size" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of <see cref="T:System.Data.DataRow" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new array.</para>
+        </returns>
         <param name="size">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Int32" /> value that describes the size of the array.</param>
       </Docs>
@@ -2000,12 +2034,15 @@
         <Parameter Name="builder" Type="System.Data.DataRowBuilder" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataRow'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new row from an existing row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataRow" /> derived class.</para>
+        </returns>
         <param name="builder">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.DataRowBuilder" /> object. </param>
       </Docs>
@@ -2398,7 +2435,6 @@
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current <see cref="T:System.Data.DataTable" /> and its descendents are loaded with the data from the supplied <see cref="T:System.IO.Stream" />. The behavior of this method is identical to that of the <see cref="M:System.Data.DataSet.ReadXml(System.IO.Stream)" /> method, except that in this case, data is loaded only for the current table and its descendants.</para>
@@ -2417,6 +2453,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads XML schema and data into the <see cref="T:System.Data.DataTable" /> using the specified <see cref="T:System.IO.Stream" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Data.XmlReadMode" /> used to read the data.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that derives from <see cref="T:System.IO.Stream" /></param>
       </Docs>
@@ -2434,7 +2474,6 @@
         <Parameter Name="reader" Type="System.IO.TextReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current <see cref="T:System.Data.DataTable" /> and its descendents are loaded with the data from the supplied <see cref="T:System.IO.TextReader" />. The behavior of this method is identical to that of the <see cref="M:System.Data.DataSet.ReadXml(System.IO.TextReader)" /> method, except that in this case, data is loaded only for the current table and its descendants.</para>
@@ -2453,6 +2492,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads XML schema and data into the <see cref="T:System.Data.DataTable" /> using the specified <see cref="T:System.IO.TextReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Data.XmlReadMode" /> used to read the data.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.TextReader" /> that will be used to read the data.</param>
       </Docs>
@@ -2470,7 +2513,6 @@
         <Parameter Name="fileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current <see cref="T:System.Data.DataTable" /> and its descendents are loaded with the data from the file named in the supplied <see cref="T:System.String" />. The behavior of this method is identical to that of the <see cref="M:System.Data.DataSet.ReadXml(System.String)" /> method, except that in this case, data is loaded only for the current table and its descendants.</para>
@@ -2504,6 +2546,10 @@ public class A {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads XML schema and data into the <see cref="T:System.Data.DataTable" /> from the specified file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Data.XmlReadMode" /> used to read the data.</para>
+        </returns>
         <param name="fileName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the file from which to read the data. </param>
       </Docs>
@@ -2521,7 +2567,6 @@ public class A {
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current <see cref="T:System.Data.DataTable" /> and its descendents are loaded with the data from the file named in the supplied <see cref="T:System.Xml.XmlReader" />. The behavior of this method is identical to that of the <see cref="M:System.Data.DataTable.ReadXml(System.Xml.XmlReader)" /> method, except that in this case, data is loaded only for the current table and its descendants.</para>
@@ -2540,6 +2585,10 @@ public class A {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads XML Schema and Data into the <see cref="T:System.Data.DataTable" /> using the specified <see cref="T:System.Xml.XmlReader" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Data.XmlReadMode" /> used to read the data.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> that will be used to read the data. </param>
       </Docs>
@@ -2897,7 +2946,6 @@ public class A {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'DataRow []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To ensure the proper sort order, specify sort criteria with <see cref="M:System.Data.DataTable.Select(System.String,System.String)" /> or <see cref="M:System.Data.DataTable.Select(System.String,System.String,System.Data.DataViewRowState)" />.</para>
@@ -2906,6 +2954,10 @@ public class A {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of all <see cref="T:System.Data.DataRow" /> objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Data.DataRow" /> objects.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -2922,7 +2974,6 @@ public class A {
         <Parameter Name="filterExpression" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataRow []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To create the <paramref name="filterExpression" /> argument, use the same rules that apply to the <see cref="T:System.Data.DataColumn" /> class's <see cref="P:System.Data.DataColumn.Expression" /> property value for creating filters.</para>
@@ -2933,6 +2984,10 @@ public class A {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of all <see cref="T:System.Data.DataRow" /> objects that match the filter criteria.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Data.DataRow" /> objects.</para>
+        </returns>
         <param name="filterExpression">
           <attribution license="cc4" from="Microsoft" modified="false" />The criteria to use to filter the rows. For examples on how to filter rows, see <see cref="http://www.csharp-examples.net/dataview-rowfilter/">DataView RowFilter Syntax [C#]</see>.</param>
       </Docs>
@@ -2952,7 +3007,6 @@ public class A {
         <Parameter Name="sort" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataRow []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To form the <paramref name="filterExpression" /> argument, use the same rules for creating the <see cref="T:System.Data.DataColumn" /> class's <see cref="P:System.Data.DataColumn.Expression" /> property value. The <paramref name="Sort" /> argument also uses the same rules for creating class's <see cref="P:System.Data.DataColumn.Expression" /> strings.</para>
@@ -2962,6 +3016,10 @@ public class A {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of all <see cref="T:System.Data.DataRow" /> objects that match the filter criteria, in the specified sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Data.DataRow" /> objects matching the filter expression.</para>
+        </returns>
         <param name="filterExpression">
           <attribution license="cc4" from="Microsoft" modified="false" />The criteria to use to filter the rows. For examples on how to filter rows, see <see cref="http://www.csharp-examples.net/dataview-rowfilter/">DataView RowFilter Syntax [C#]</see>.</param>
         <param name="sort">
@@ -2984,7 +3042,6 @@ public class A {
         <Parameter Name="recordStates" Type="System.Data.DataViewRowState" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataRow []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To form the <paramref name="filterExpression" /> argument, use the same rules for creating the <see cref="T:System.Data.DataColumn" /> class's <see cref="P:System.Data.DataColumn.Expression" /> property value. The <paramref name="Sort" /> argument also uses the same rules for creating class's <see cref="P:System.Data.DataColumn.Expression" /> strings.</para>
@@ -2994,6 +3051,10 @@ public class A {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of all <see cref="T:System.Data.DataRow" /> objects that match the filter in the order of the sort that match the specified state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Data.DataRow" /> objects.</para>
+        </returns>
         <param name="filterExpression">
           <attribution license="cc4" from="Microsoft" modified="false" />The criteria to use to filter the rows. For examples on how to filter rows, see <see cref="http://www.csharp-examples.net/dataview-rowfilter/">DataView RowFilter Syntax [C#]</see>.</param>
         <param name="sort">
@@ -3072,7 +3133,6 @@ public class A {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.DataTable" /> instance is cast to an <see cref="T:System.ComponentModel.IListSource" /> interface.</para>
@@ -3081,6 +3141,10 @@ public class A {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ComponentModel.IListSource.GetList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IList" /> that can be bound to a data source from the object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Runtime.Serialization.ISerializable.GetObjectData">
@@ -3119,7 +3183,6 @@ public class A {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.DataSet" /> instance is cast to an <see cref="T:System.Xml.Serialization.IXmlSerializable" /> interface.</para>
@@ -3128,6 +3191,10 @@ public class A {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Xml.Serialization.IXmlSerializable.GetSchema" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para> An <see cref="T:System.Xml.Schema.XmlSchema" /> that describes the XML representation of the object that is produced by the <see cref="M:System.Xml.Serialization.IXmlSerializable.WriteXml(System.Xml.XmlWriter)" /> method and consumed by the <see cref="M:System.Xml.Serialization.IXmlSerializable.ReadXml(System.Xml.XmlReader)" /> method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
@@ -3280,7 +3347,6 @@ public class A {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="P:System.Data.DataTable.TableName" /> and <see cref="P:System.Data.DataTable.DisplayExpression" /> for the <see cref="T:System.Data.DataTable" />.</para>
@@ -3289,6 +3355,10 @@ public class A {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="P:System.Data.DataTable.TableName" /> and <see cref="P:System.Data.DataTable.DisplayExpression" />, if there is one as a concatenated string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string consisting of the <see cref="P:System.Data.DataTable.TableName" /> and the <see cref="P:System.Data.DataTable.DisplayExpression" /> values.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data/DataTableCollection.xml b/mcs/class/System.Data/Documentation/en/System.Data/DataTableCollection.xml
index 055a32f8b38..2bfd6c4b4f8 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data/DataTableCollection.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data/DataTableCollection.xml
@@ -47,7 +47,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'DataTable'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Because no name is specified, the DataTable is created by using a default name, relative to its order of addition. The default name is "Table1." </para>
@@ -57,6 +56,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Data.DataTable" /> object by using a default name and adds it to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created <see cref="T:System.Data.DataTable" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -99,7 +102,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataTable'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If either null or an empty string ("") is passed in, a default name is given to the newly created DataTable. This name is based on the order in which the table was added ("Table1", "Table2", and so on).</para>
@@ -109,6 +111,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Data.DataTable" /> object by using the specified name and adds it to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created <see cref="T:System.Data.DataTable" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name to give the created <see cref="T:System.Data.DataTable" />. </param>
       </Docs>
@@ -132,7 +138,6 @@
       </Parameters>
       <Docs>
         <param name="tbNamespace">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If either null or an empty string ("") is passed in, a default name is given to the newly created DataTable. This name is based on the order in which the table was added ("Table1", "Table2", and so on).</para>
@@ -142,6 +147,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Data.DataTable" /> object by using the specified name and adds it to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created <see cref="T:System.Data.DataTable" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name to give the created <see cref="T:System.Data.DataTable" />.</param>
       </Docs>
@@ -179,12 +188,15 @@
         <Parameter Name="table" Type="System.Data.DataTable" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies whether the specified <see cref="T:System.Data.DataTable" /> object can be removed from the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the table can be removed; otherwise false.</para>
+        </returns>
         <param name="table">
           <attribution license="cc4" from="Microsoft" modified="false" />The DataTable in the collection to perform the check against. </param>
       </Docs>
@@ -269,7 +281,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You specify the name of the <see cref="T:System.Data.DataTable" /> object by using the <see cref="P:System.Data.DataTable.TableName" /> property. If you add a <see cref="T:System.Data.DataTable" /> to the collection with the <see cref="M:System.Data.DataTableCollection.Add(System.Data.DataTable)" /> method, passing no arguments, the table is given a default name, based on the order in which the table was added ("Table1", "Table2", and so on).</para>
@@ -282,6 +293,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether a <see cref="T:System.Data.DataTable" /> object with the specified name exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified table exists; otherwise false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Data.DataTable" /> to find. </param>
       </Docs>
@@ -304,7 +319,6 @@
         <Parameter Name="tableNamespace" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You specify the name of the <see cref="T:System.Data.DataTable" /> object by using the <see cref="P:System.Data.DataTable.TableName" /> property. If you add a <see cref="T:System.Data.DataTable" /> to the collection with the <see cref="M:System.Data.DataTableCollection.Add(System.Data.DataTable)" /> method, passing no arguments, the table is given a default name, based on the order in which the table was added ("Table1", "Table2", and so on).</para>
@@ -317,6 +331,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether a <see cref="T:System.Data.DataTable" /> object with the specified name and table namespace exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified table exists; otherwise false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Data.DataTable" /> to find.</param>
         <param name="tableNamespace">
@@ -361,7 +379,6 @@
         <Parameter Name="table" Type="System.Data.DataTable" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Data.DataTableCollection.IndexOf(System.Data.DataTable)" /> method to determine the exact index of a given table.</para>
@@ -371,6 +388,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the specified <see cref="T:System.Data.DataTable" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the table, or -1 if the table is not found in the collection.</para>
+        </returns>
         <param name="table">
           <attribution license="cc4" from="Microsoft" modified="false" />The DataTable to search for. </param>
       </Docs>
@@ -389,7 +410,6 @@
         <Parameter Name="tableName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You specify the name of the DataTable object by using the <see cref="P:System.Data.DataTable.TableName" /> property.</para>
@@ -398,6 +418,13 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index in the collection of the <see cref="T:System.Data.DataTable" /> object with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the DataTable with the specified name, or -1 if the table does not exist in the collection.</para>
+          <block subset="none" type="note">
+            <para>Returns -1 when two or more tables have the same name but different namespaces. The call does not succeed if there is any ambiguity when matching a table name to exactly one table.</para>
+          </block>
+        </returns>
         <param name="tableName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the DataTable object to look for. </param>
       </Docs>
@@ -420,7 +447,6 @@
         <Parameter Name="tableNamespace" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You specify the name of the <see cref="T:System.Data.DataTable" /> object by using the <see cref="P:System.Data.DataTable.TableName" /> property.</para>
@@ -429,6 +455,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index in the collection of the specified <see cref="T:System.Data.DataTable" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the <see cref="T:System.Data.DataTable" /> with the specified name, or -1 if the table does not exist in the collection.</para>
+        </returns>
         <param name="tableName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Data.DataTable" /> object to look for.</param>
         <param name="tableNamespace">
diff --git a/mcs/class/System.Data/Documentation/en/System.Data/DataTableReader.xml b/mcs/class/System.Data/Documentation/en/System.Data/DataTableReader.xml
index f0f501346fd..dabc3ef915c 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data/DataTableReader.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data/DataTableReader.xml
@@ -140,7 +140,6 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -151,6 +150,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a <see cref="T:System.Boolean" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -167,7 +170,6 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -178,6 +180,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a byte.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -198,7 +204,6 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -210,6 +215,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a stream of bytes starting at the specified column offset into the buffer as an array starting at the specified buffer offset.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of bytes read.</para>
+        </returns>
         <param name="dataIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index within the field from which to start the read operation. </param>
         <param name="buffer">
@@ -234,7 +243,6 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -245,6 +253,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -265,7 +277,6 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -277,6 +288,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified column as a character array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of characters read.</para>
+        </returns>
         <param name="dataIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index within the field from which to start the read operation. </param>
         <param name="buffer">
@@ -301,7 +316,6 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -311,6 +325,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a string representing the data type of the specified column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representing the column's data type.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -327,7 +345,6 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -338,6 +355,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a <see cref="T:System.DateTime" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -354,7 +375,6 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -365,6 +385,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a <see cref="T:System.Decimal" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -381,7 +405,6 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -392,6 +415,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the column as a double-precision floating point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -405,7 +432,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -419,6 +445,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that can be used to iterate through the item collection. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> object that represents the item collection.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -435,13 +465,16 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Type" /> that is the data type of the object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> that is the data type of the object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -458,7 +491,6 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -469,6 +501,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a single-precision floating point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -485,7 +521,6 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -496,6 +531,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a globally-unique identifier (GUID).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -512,7 +551,6 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -523,6 +561,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a 16-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -539,7 +581,6 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -550,6 +591,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -566,7 +611,6 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -577,6 +621,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -593,7 +641,6 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -603,6 +650,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the specified column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -618,7 +669,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -631,6 +681,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the column ordinal, given the name of the column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based column ordinal.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the column. </param>
       </Docs>
@@ -649,7 +703,6 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -659,6 +712,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the type of the specified column in provider-specific format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> that is the data type of the object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -675,7 +732,6 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -685,6 +741,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column in provider-specific format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column in provider-specific format.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -700,7 +760,6 @@
         <Parameter Name="values" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -710,6 +769,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Fills the supplied array with provider-specific type information for all the columns in the <see cref="T:System.Data.DataTableReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of column values copied into the array.</para>
+        </returns>
         <param name="values">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of objects to be filled in with type information for the columns in the <see cref="T:System.Data.DataTableReader" />. </param>
       </Docs>
@@ -725,7 +788,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -947,6 +1009,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Data.DataTable" /> that describes the column metadata of the <see cref="T:System.Data.DataTableReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataTable" /> that describes the column metadata.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -963,7 +1029,6 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -973,6 +1038,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -989,7 +1058,6 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -999,6 +1067,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column in its native format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified column. This method returns DBNull for null columns.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1014,7 +1086,6 @@
         <Parameter Name="values" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1026,6 +1097,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Populates an array of objects with the column values of the current row.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of column values copied into the array.</para>
+        </returns>
         <param name="values">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Object" /> into which to copy the column values from the <see cref="T:System.Data.DataTableReader" />.</param>
       </Docs>
@@ -1090,7 +1165,6 @@
       </Parameters>
       <Docs>
         <param name="i">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1100,6 +1174,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the column contains non-existent or missing values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified column value is equivalent to <see cref="T:System.DBNull" />; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1153,7 +1231,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1164,6 +1241,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the <see cref="T:System.Data.DataTableReader" /> to the next result set, if any.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there was another result set; otherwise false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1177,7 +1258,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1187,6 +1267,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the <see cref="T:System.Data.DataTableReader" /> to the next record.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there was another row to read; otherwise false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data/DataView.xml b/mcs/class/System.Data/Documentation/en/System.Data/DataView.xml
index 284c2c31656..e5621dbf46f 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data/DataView.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data/DataView.xml
@@ -131,12 +131,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'DataRowView'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new row to the <see cref="T:System.Data.DataView" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.DataRowView" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -483,12 +486,15 @@
       </Parameters>
       <Docs>
         <param name="dv">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Data.DataView" /> instances are considered equal. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two <see cref="T:System.Data.DataView" /> instances are equal; otherwise, false. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Find">
@@ -501,12 +507,15 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds a row in the <see cref="T:System.Data.DataView" /> by the specified sort key value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the row in the <see cref="T:System.Data.DataView" /> that contains the sort key value specified; otherwise -1 if the sort key value does not exist.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to search for. </param>
       </Docs>
@@ -525,12 +534,15 @@
         <Parameter Name="key" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds a row in the <see cref="T:System.Data.DataView" /> by the specified sort key values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the position of the first row in the <see cref="T:System.Data.DataView" /> that matches the sort key values specified; otherwise -1 if there are no matching sort key values. </para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of values, typed as <see cref="T:System.Object" />. </param>
       </Docs>
@@ -549,12 +561,15 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataRowView []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of <see cref="T:System.Data.DataRowView" /> objects whose columns match the specified sort key value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of DataRowView objects whose columns match the specified sort key value; or, if no rows contain the specified sort key values, an empty DataRowView array.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The column value, typed as <see cref="T:System.Object" />, to search for. </param>
       </Docs>
@@ -573,12 +588,15 @@
         <Parameter Name="key" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataRowView []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of <see cref="T:System.Data.DataRowView" /> objects whose columns match the specified sort key value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of DataRowView objects whose columns match the specified sort key value; or, if no rows contain the specified sort key values, an empty DataRowView array.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of column values, typed as <see cref="T:System.Object" />, to search for. </param>
       </Docs>
@@ -595,12 +613,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IEnumerator'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an enumerator for this <see cref="T:System.Data.DataView" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for navigating through the list.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -960,7 +981,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.DataView" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -969,6 +989,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Collections.IList.Add(System.Object)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>For a description of this member, see <see cref="M:System.Collections.IList.Add(System.Object)" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="System.Object" /> value.</param>
       </Docs>
@@ -1009,7 +1033,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.DataView" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -1018,6 +1041,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Collections.IList.Contains(System.Object)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>For a description of this member, see <see cref="M:System.Collections.IList.Contains(System.Object)" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="System.Object" /> value.</param>
       </Docs>
@@ -1036,7 +1063,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.DataView" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -1045,6 +1071,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Collections.IList.IndexOf(System.Object)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>For a description of this member, see <see cref="M:System.Collections.IList.IndexOf(System.Object)" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="System.Object" /> value.</param>
       </Docs>
@@ -1232,7 +1262,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.DataView" /> instance is cast to an <see cref="T:System.ComponentModel.IBindingList" /> interface.</para>
@@ -1241,6 +1270,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ComponentModel.IBindingList.AddNew" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The item added to the list.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.IBindingList.AllowEdit">
@@ -1353,7 +1386,6 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.DataView" /> instance is cast to an <see cref="T:System.ComponentModel.IBindingList" /> interface.</para>
@@ -1362,6 +1394,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ComponentModel.IBindingList.Find(System.ComponentModel.PropertyDescriptor,System.Object)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>For a description of this member, see <see cref="M:System.ComponentModel.IBindingList.Find(System.ComponentModel.PropertyDescriptor,System.Object)" />.</para>
+        </returns>
         <param name="property">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="System.ComponentModel.PropertyDescriptor" /> object.</param>
         <param name="key">
@@ -1718,7 +1754,6 @@
         <Parameter Name="listAccessors" Type="System.ComponentModel.PropertyDescriptor[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.DataView" /> instance is cast to an <see cref="T:System.ComponentModel.ITypedList" /> interface.</para>
@@ -1727,6 +1762,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ComponentModel.ITypedList.GetListName(System.ComponentModel.PropertyDescriptor[])" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>For a description of this member, see <see cref="M:System.ComponentModel.ITypedList.GetListName(System.ComponentModel.PropertyDescriptor[])" />.</para>
+        </returns>
         <param name="listAccessors">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="System.ComponentModel.PropertyDescriptor" /> objects.</param>
       </Docs>
@@ -1778,7 +1817,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Because this method does not let you specify the name for the output <see cref="T:System.Data.DataTable" />, its name is the same as the name of the source DataTable. Because this method does not let you specify a subset of available columns, the output table contains the same columns as the input table.</para>
@@ -1787,6 +1825,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new <see cref="T:System.Data.DataTable" /> based on rows in an existing <see cref="T:System.Data.DataView" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.DataTable" /> instance that contains the requested rows and columns.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToTable">
@@ -1802,7 +1844,6 @@
         <Parameter Name="tableName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Because this method does not let you specify a subset of available columns, the output table contains the same columns as the input table.</para>
@@ -1811,6 +1852,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new <see cref="T:System.Data.DataTable" /> based on rows in an existing <see cref="T:System.Data.DataView" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.DataTable" /> instance that contains the requested rows and columns.</para>
+        </returns>
         <param name="tableName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the returned <see cref="T:System.Data.DataTable" />.</param>
       </Docs>
@@ -1836,7 +1881,6 @@
       </Parameters>
       <Docs>
         <param name="isDistinct">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Because this method does not let you specify the name for the output <see cref="T:System.Data.DataTable" />, its name is the same as the name of the source <see cref="T:System.Data.DataTable" />.</para>
@@ -1845,6 +1889,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new <see cref="T:System.Data.DataTable" /> based on rows in an existing <see cref="T:System.Data.DataView" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.DataTable" /> instance that contains the requested rows and columns.</para>
+        </returns>
         <param name="columnNames">
           <attribution license="cc4" from="Microsoft" modified="false" />A string array that contains a list of the column names to be included in the returned <see cref="T:System.Data.DataTable" />. The <see cref="T:System.Data.DataTable" /> contains the specified columns in the order they appear within this array.</param>
       </Docs>
@@ -1872,7 +1920,6 @@
       <Docs>
         <param name="tablename">To be added.</param>
         <param name="isDistinct">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this overloaded version of the <see cref="M:System.Data.DataView.ToTable" /> method if you have to retrieve distinct values in a subset of available columns, specifying a new name for the returned <see cref="T:System.Data.DataTable" />. If you do not need distinct rows or a subset of columns, see <see cref="M:System.Data.DataView.ToTable(System.String)" />.</para>
@@ -1881,6 +1928,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new <see cref="T:System.Data.DataTable" /> based on rows in an existing <see cref="T:System.Data.DataView" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.DataTable" /> instance that contains the requested rows and columns.</para>
+        </returns>
         <param name="columnNames">
           <attribution license="cc4" from="Microsoft" modified="false" />A string array that contains a list of the column names to be included in the returned <see cref="T:System.Data.DataTable" />. The DataTable contains the specified columns in the order they appear within this array.</param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data/DataViewManager.xml b/mcs/class/System.Data/Documentation/en/System.Data/DataViewManager.xml
index 9dc54138661..ae5a8f6b2c9 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data/DataViewManager.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data/DataViewManager.xml
@@ -81,12 +81,15 @@
         <Parameter Name="table" Type="System.Data.DataTable" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataView'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Data.DataView" /> for the specified <see cref="T:System.Data.DataTable" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataView" /> object.</para>
+        </returns>
         <param name="table">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Data.DataTable" /> to use in the <see cref="T:System.Data.DataView" />. </param>
       </Docs>
@@ -344,7 +347,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.DataViewManager" /> instance is cast to an <see cref="T:System.Collections.IEnumerable" /> interface.</para>
@@ -353,6 +355,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Collections.IEnumerable.GetEnumerator" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>For a description of this member, see <see cref="M:System.Collections.IEnumerable.GetEnumerator" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Add">
@@ -369,7 +375,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.DataViewManager" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -378,6 +383,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an item to the <see cref="T:System.Collections.IList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position into which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to add to the <see cref="T:System.Collections.IList" />. </param>
       </Docs>
@@ -418,7 +427,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.DataViewManager" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -427,6 +435,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Collections.IList" /> contains a specific value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Object" /> is found in the <see cref="T:System.Collections.IList" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the <see cref="T:System.Collections.IList" />. </param>
       </Docs>
@@ -445,7 +457,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.DataViewManager" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -454,6 +465,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of a specific item in the <see cref="T:System.Collections.IList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of <paramref name="value" /> if found in the list; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the <see cref="T:System.Collections.IList" />. </param>
       </Docs>
@@ -641,7 +656,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.DataViewManager" /> instance is cast to an <see cref="T:System.ComponentModel.IBindingList" /> interface.</para>
@@ -650,6 +664,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ComponentModel.IBindingList.AddNew" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>For a description of this member, see <see cref="M:System.ComponentModel.IBindingList.AddNew" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.IBindingList.AllowEdit">
@@ -762,7 +780,6 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.DataViewManager" /> instance is cast to an <see cref="T:System.ComponentModel.IBindingList" /> interface.</para>
@@ -771,6 +788,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the row that has the given <see cref="T:System.ComponentModel.PropertyDescriptor" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the row that has the given <see cref="T:System.ComponentModel.PropertyDescriptor" />.</para>
+        </returns>
         <param name="property">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.PropertyDescriptor" /> to search on.</param>
         <param name="key">
@@ -997,7 +1018,6 @@
         <Parameter Name="listAccessors" Type="System.ComponentModel.PropertyDescriptor[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Data.DataViewManager" /> instance is cast to an <see cref="T:System.ComponentModel.ITypedList" /> interface.</para>
@@ -1006,6 +1026,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the list.</para>
+        </returns>
         <param name="listAccessors">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.ComponentModel.PropertyDescriptor" /> objects, for which the list name is returned. This can be null. </param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data/DataViewSettingCollection.xml b/mcs/class/System.Data/Documentation/en/System.Data/DataViewSettingCollection.xml
index 0de1c46e951..1ecf4115163 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data/DataViewSettingCollection.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data/DataViewSettingCollection.xml
@@ -119,12 +119,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IEnumerator'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <see cref="T:System.Collections.IEnumerator" /> for the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data/ForeignKeyConstraint.xml b/mcs/class/System.Data/Documentation/en/System.Data/ForeignKeyConstraint.xml
index 69718328fc7..569f6e8b72a 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data/ForeignKeyConstraint.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data/ForeignKeyConstraint.xml
@@ -335,12 +335,15 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the current <see cref="T:System.Data.ForeignKeyConstraint" /> is identical to the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if the objects are identical; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to which this <see cref="T:System.Data.ForeignKeyConstraint" /> is compared. Two <see cref="T:System.Data.ForeignKeyConstraint" /> are equal if they constrain the same columns. </param>
       </Docs>
@@ -357,12 +360,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash code of this instance of the <see cref="T:System.Data.ForeignKeyConstraint" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data/IColumnMappingCollection.xml b/mcs/class/System.Data/Documentation/en/System.Data/IColumnMappingCollection.xml
index 244481ee862..04fc93fbc5d 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data/IColumnMappingCollection.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data/IColumnMappingCollection.xml
@@ -38,12 +38,15 @@
         <Parameter Name="dataSetColumnName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IColumnMapping'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a ColumnMapping object to the ColumnMapping collection using the source column and <see cref="T:System.Data.DataSet" /> column names.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The ColumnMapping object that was added to the collection.</para>
+        </returns>
         <param name="sourceColumnName">
           <attribution license="cc4" from="Microsoft" modified="false" />The case-sensitive name of the source column. </param>
         <param name="dataSetColumnName">
@@ -64,12 +67,15 @@
         <Parameter Name="sourceColumnName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the <see cref="T:System.Data.Common.DataColumnMappingCollection" /> contains a <see cref="T:System.Data.Common.DataColumnMapping" /> object with the specified source column name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a <see cref="T:System.Data.Common.DataColumnMapping" /> object with the specified source column name exists, otherwise false.</para>
+        </returns>
         <param name="sourceColumnName">
           <attribution license="cc4" from="Microsoft" modified="false" />The case-sensitive name of the source column. </param>
       </Docs>
@@ -88,12 +94,15 @@
         <Parameter Name="dataSetColumnName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IColumnMapping'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the ColumnMapping object with the specified <see cref="T:System.Data.DataSet" /> column name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The ColumnMapping object with the specified DataSet column name.</para>
+        </returns>
         <param name="dataSetColumnName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Data.DataSet" /> column within the collection. </param>
       </Docs>
@@ -112,12 +121,15 @@
         <Parameter Name="sourceColumnName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the location of the <see cref="T:System.Data.Common.DataColumnMapping" /> object with the specified source column name. The name is case-sensitive.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based location of the DataColumnMapping object with the specified source column name.</para>
+        </returns>
         <param name="sourceColumnName">
           <attribution license="cc4" from="Microsoft" modified="false" />The case-sensitive name of the source column. </param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data/IDataAdapter.xml b/mcs/class/System.Data/Documentation/en/System.Data/IDataAdapter.xml
index 7d514a1713b..a27dbcf6ba0 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data/IDataAdapter.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data/IDataAdapter.xml
@@ -35,7 +35,6 @@
         <Parameter Name="dataSet" Type="System.Data.DataSet" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -53,6 +52,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds or updates rows in the <see cref="T:System.Data.DataSet" /> to match those in the data source using the <see cref="T:System.Data.DataSet" /> name, and creates a <see cref="T:System.Data.DataTable" /> named "Table".</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows successfully added to or refreshed in the <see cref="T:System.Data.DataSet" />. This does not include rows affected by statements that do not return rows.</para>
+        </returns>
         <param name="dataSet">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Data.DataSet" /> to fill with records and, if necessary, schema. </param>
       </Docs>
@@ -72,7 +75,6 @@
         <Parameter Name="schemaType" Type="System.Data.SchemaType" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataTable []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Data.IDataAdapter.FillSchema(System.Data.DataSet,System.Data.SchemaType)" /> method retrieves the schema from the data source using the <see cref="P:System.Data.IDbDataAdapter.SelectCommand" />. The connection object associated with the <see cref="P:System.Data.IDbDataAdapter.SelectCommand" /> must be valid, but it does not need to be open. If the connection is closed before <see cref="M:System.Data.IDataAdapter.FillSchema(System.Data.DataSet,System.Data.SchemaType)" /> is called, it is opened to retrieve data, then closed. If the connection is open before <see cref="M:System.Data.IDataAdapter.FillSchema(System.Data.DataSet,System.Data.SchemaType)" /> is called, it remains open.</para>
@@ -122,6 +124,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Data.DataTable" /> named "Table" to the specified <see cref="T:System.Data.DataSet" /> and configures the schema to match that in the data source based on the specified <see cref="T:System.Data.SchemaType" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Data.DataTable" /> objects that contain schema information returned from the data source.</para>
+        </returns>
         <param name="dataSet">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.DataSet" /> to be filled with the schema from the data source. </param>
         <param name="schemaType">
@@ -140,7 +146,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IDataParameter []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <code>private static void GetParameters(String connectiongString) {
@@ -164,6 +169,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the parameters set by the user when executing an SQL SELECT statement.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Data.IDataParameter" /> objects that contains the parameters set by the user.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -247,7 +256,6 @@
         <Parameter Name="dataSet" Type="System.Data.DataSet" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When an application calls the <see cref="M:System.Data.IDataAdapter.Update(System.Data.DataSet)" /> method, the <see cref="T:System.Data.IDataAdapter" /> examines the <see cref="P:System.Data.DataRow.RowState" /> property, and executes the required INSERT, UPDATE, or DELETE statements iteratively for each row, based on the order of the indexes configured in the <see cref="T:System.Data.DataSet" />. For example, <see cref="M:System.Data.IDataAdapter.Update(System.Data.DataSet)" /> might execute a DELETE statement, followed by an INSERT statement, and then another DELETE statement, because of the ordering of the rows in the <see cref="T:System.Data.DataTable" />.</para>
@@ -328,6 +336,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calls the respective INSERT, UPDATE, or DELETE statements for each inserted, updated, or deleted row in the specified <see cref="T:System.Data.DataSet" /> from a <see cref="T:System.Data.DataTable" /> named "Table".</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows successfully updated from the <see cref="T:System.Data.DataSet" />.</para>
+        </returns>
         <param name="dataSet">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.DataSet" /> used to update the data source. </param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data/IDataParameterCollection.xml b/mcs/class/System.Data/Documentation/en/System.Data/IDataParameterCollection.xml
index e45061a2670..c51565d6a44 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data/IDataParameterCollection.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data/IDataParameterCollection.xml
@@ -37,12 +37,15 @@
         <Parameter Name="parameterName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether a parameter in the collection has the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the parameter; otherwise, false.</para>
+        </returns>
         <param name="parameterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the parameter. </param>
       </Docs>
@@ -61,12 +64,15 @@
         <Parameter Name="parameterName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the location of the <see cref="T:System.Data.IDataParameter" /> within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based location of the <see cref="T:System.Data.IDataParameter" /> within the collection.</para>
+        </returns>
         <param name="parameterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the parameter. </param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data/IDataReader.xml b/mcs/class/System.Data/Documentation/en/System.Data/IDataReader.xml
index d65c038f9f3..6ce2fc559a9 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data/IDataReader.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data/IDataReader.xml
@@ -83,7 +83,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'DataTable'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The implementation of <see cref="M:System.Data.IDataReader.GetSchemaTable" /> method for the .NET Framework Data Provider for OLE DB maps to the OLE DB IColumnsRowset::GetColumnsRowset method, while implementations for other .NET Framework data providers do not use an OLE DB provider layer. The order in which <see cref="M:System.Data.IDataReader.GetSchemaTable" /> returns metadata about each column in a table, and the DataReader columns that are returned, vary depending on which data provider you use. The following table lists data providers and members that implement <see cref="M:System.Data.IDataReader.GetSchemaTable" />.</para>
@@ -140,6 +139,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Data.DataTable" /> that describes the column metadata of the <see cref="T:System.Data.IDataReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataTable" /> that describes the column metadata.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -177,7 +180,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used to process multiple results, which can be obtained by executing batch SQL statements.</para>
@@ -188,6 +190,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the data reader to the next result, when reading the results of batch SQL statements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there are more rows; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -202,7 +208,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>true if a valid record was read by this invocation of Read()</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default position of the <see cref="T:System.Data.IDataReader" /> is prior to the first record. Therefore you must call <see cref="M:System.Data.IDataReader.Read" /> to begin accessing any data.</para>
@@ -212,6 +217,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the <see cref="T:System.Data.IDataReader" /> to the next record.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there are more rows; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data/IDataRecord.xml b/mcs/class/System.Data/Documentation/en/System.Data/IDataRecord.xml
index ac2fe486ba6..7cff2c8c165 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data/IDataRecord.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data/IDataRecord.xml
@@ -340,7 +340,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No conversions are performed. Therefore, the data retrieved must already be a Boolean; otherwise an exception is generated.</para>
@@ -349,6 +348,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified column as a Boolean.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -367,12 +370,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the 8-bit unsigned integer value of the specified column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 8-bit unsigned integer value of the specified column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -395,7 +401,6 @@
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -407,6 +412,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a stream of bytes from the specified column offset into the buffer as an array, starting at the given buffer offset.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of bytes read.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
         <param name="fieldOffset">
@@ -433,12 +442,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'char'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the character value of the specified column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The character value of the specified column.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
       </Docs>
@@ -461,7 +473,6 @@
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -473,6 +484,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a stream of characters from the specified column offset into the buffer as an array, starting at the given buffer offset.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of characters read.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based column ordinal. </param>
         <param name="fieldoffset">
@@ -499,12 +514,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IDataReader'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Data.IDataReader" /> for the specified column ordinal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Data.IDataReader" /> for the specified column ordinal.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the field to find. </param>
       </Docs>
@@ -523,7 +541,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The data type information can differ from the type information returned by GetFieldType, especially where the underlying data types do not map one for one to the runtime types supported by the language. (for example, DataTypeName may be "integer", while Type.Name may be "Int32".) </para>
@@ -532,6 +549,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the data type information for the specified field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The data type information for the specified field.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the field to find. </param>
       </Docs>
@@ -550,12 +571,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DateTime'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the date and time data value of the specified field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The date and time data value of the specified field.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the field to find. </param>
       </Docs>
@@ -574,12 +598,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'decimal'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the fixed-position numeric value of the specified field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The fixed-position numeric value of the specified field.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the field to find. </param>
       </Docs>
@@ -598,12 +625,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'double'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the double-precision floating point number of the specified field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The double-precision floating point number of the specified field.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the field to find. </param>
       </Docs>
@@ -622,7 +652,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Type'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This information can be used to increase performance by indicating the strongly-typed accessor to call. (for example, using GetInt32 is roughly ten times faster than using GetValue.) </para>
@@ -631,6 +660,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Type" /> information corresponding to the type of <see cref="T:System.Object" /> that would be returned from <see cref="M:System.Data.IDataRecord.GetValue(System.Int32)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> information corresponding to the type of <see cref="T:System.Object" /> that would be returned from <see cref="M:System.Data.IDataRecord.GetValue(System.Int32)" />.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the field to find. </param>
       </Docs>
@@ -649,12 +682,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'float'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the single-precision floating point number of the specified field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The single-precision floating point number of the specified field.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the field to find. </param>
       </Docs>
@@ -673,12 +709,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Guid'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the GUID value of the specified field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The GUID value of the specified field.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the field to find. </param>
       </Docs>
@@ -697,12 +736,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'short'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the 16-bit signed integer value of the specified field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 16-bit signed integer value of the specified field.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the field to find. </param>
       </Docs>
@@ -721,12 +763,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the 32-bit signed integer value of the specified field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 32-bit signed integer value of the specified field.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the field to find. </param>
       </Docs>
@@ -745,12 +790,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the 64-bit signed integer value of the specified field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 64-bit signed integer value of the specified field.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the field to find. </param>
       </Docs>
@@ -769,12 +817,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the name for the field to find.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the field or the empty string (""), if there is no value to return.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the field to find. </param>
       </Docs>
@@ -793,7 +844,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>GetOrdinal performs a case-sensitive lookup first. If it fails, a second case-insensitive search is made. GetOrdinal is kana-width insensitive. If the index of the named field is not found, an IndexOutOfRangeException is thrown. </para>
@@ -803,6 +853,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Return the index of the named field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the named field.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the field to find. </param>
       </Docs>
@@ -821,12 +875,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the string value of the specified field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string value of the specified field.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the field to find. </param>
       </Docs>
@@ -845,12 +902,15 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Return the value of the specified field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> which will contain the field value upon return.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the field to find. </param>
       </Docs>
@@ -869,7 +929,6 @@
         <Parameter Name="values" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For most applications, the <see cref="M:System.Data.IDataRecord.GetValues(System.Object[])" /> method provides an efficient means for retrieving all columns, instead of retrieving each column individually.</para>
@@ -879,6 +938,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Populates an array of objects with the column values of the current record.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of instances of <see cref="T:System.Object" /> in the array.</para>
+        </returns>
         <param name="values">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Object" /> to copy the attribute fields into. </param>
       </Docs>
@@ -897,7 +960,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this method to see if there are null column values before calling the typed get methods (for example, <see cref="M:System.Data.SqlClient.SqlDataReader.GetByte(System.Int32)" />, <see cref="M:System.Data.SqlClient.SqlDataReader.GetChar(System.Int32)" />, and so on) to avoid raising an error.</para>
@@ -906,6 +968,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Return whether the specified field is set to null.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified field is set to null; otherwise, false.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the field to find. </param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data/IDbCommand.xml b/mcs/class/System.Data/Documentation/en/System.Data/IDbCommand.xml
index 07c848540d7..1f206df7332 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data/IDbCommand.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data/IDbCommand.xml
@@ -147,7 +147,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IDbDataParameter'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When inheriting from <see cref="T:System.Data.IDbCommand" />, a .NET Framework data provider implements a strongly-typed version of <see cref="M:System.Data.IDbCommand.CreateParameter" />.</para>
@@ -156,6 +155,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of an <see cref="T:System.Data.IDbDataParameter" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An IDbDataParameter object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -170,7 +173,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the <see cref="M:System.Data.IDbCommand.ExecuteNonQuery" /> to perform catalog operations (for example, querying the structure of a database or creating database objects such as tables), or to change the data in a database without using a <see cref="T:System.Data.DataSet" /> by executing UPDATE, INSERT, or DELETE statements.</para>
@@ -181,6 +183,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes an SQL statement against the Connection object of a .NET Framework data provider, and returns the number of rows affected.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows affected.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -195,12 +201,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IDataReader'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the <see cref="P:System.Data.IDbCommand.CommandText" /> against the <see cref="P:System.Data.IDbCommand.Connection" /> and builds an <see cref="T:System.Data.IDataReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Data.IDataReader" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -217,7 +226,6 @@
         <Parameter Name="behavior" Type="System.Data.CommandBehavior" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IDataReader'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The caller must call the <see cref="M:System.Data.IDbConnection.Open" /> method of the <see cref="P:System.Data.IDbCommand.Connection" /> property.</para>
@@ -231,6 +239,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the <see cref="P:System.Data.IDbCommand.CommandText" /> against the <see cref="P:System.Data.IDbCommand.Connection" />, and builds an <see cref="T:System.Data.IDataReader" /> using one of the <see cref="T:System.Data.CommandBehavior" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Data.IDataReader" /> object.</para>
+        </returns>
         <param name="behavior">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Data.CommandBehavior" /> values. </param>
       </Docs>
@@ -247,7 +259,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Data.IDbCommand.ExecuteScalar" /> method to retrieve a single value (for example, an aggregate value) from a database. This requires less code than using the <see cref="M:System.Data.IDbCommand.ExecuteReader" /> method, and then performing the operations necessary to generate the single value using the data returned by an <see cref="T:System.Data.IDataReader" />.</para>
@@ -260,6 +271,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the query, and returns the first column of the first row in the resultset returned by the query. Extra columns or rows are ignored.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first column of the first row in the resultset.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data/IDbConnection.xml b/mcs/class/System.Data/Documentation/en/System.Data/IDbConnection.xml
index c2131bc942e..b7f04f52e72 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data/IDbConnection.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data/IDbConnection.xml
@@ -35,7 +35,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IDbTransaction'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Once the transaction has completed, you must explicitly commit or roll back the transaction by using the <see cref="M:System.Data.IDbTransaction.Commit" /> or <see cref="M:System.Data.IDbTransaction.Rollback" /> methods.</para>
@@ -44,6 +43,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins a database transaction.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the new transaction.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -60,7 +63,6 @@
         <Parameter Name="il" Type="System.Data.IsolationLevel" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IDbTransaction'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Once the transaction has completed, you must explicitly commit or roll back the transaction using the <see cref="M:System.Data.IDbTransaction.Commit" /> or <see cref="M:System.Data.IDbTransaction.Rollback" /> methods.</para>
@@ -69,6 +71,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins a database transaction with the specified <see cref="T:System.Data.IsolationLevel" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the new transaction.</para>
+        </returns>
         <param name="il">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Data.IsolationLevel" /> values. </param>
       </Docs>
@@ -177,12 +183,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IDbCommand'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a Command object associated with the connection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Command object associated with the connection.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data/ITableMappingCollection.xml b/mcs/class/System.Data/Documentation/en/System.Data/ITableMappingCollection.xml
index 5546e434422..82b052f79f5 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data/ITableMappingCollection.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data/ITableMappingCollection.xml
@@ -38,12 +38,15 @@
         <Parameter Name="dataSetTableName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ITableMapping'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a table mapping to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to the newly-mapped <see cref="T:System.Data.ITableMapping" /> object.</para>
+        </returns>
         <param name="sourceTableName">
           <attribution license="cc4" from="Microsoft" modified="false" />The case-sensitive name of the source table. </param>
         <param name="dataSetTableName">
@@ -64,12 +67,15 @@
         <Parameter Name="sourceTableName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the collection contains a table mapping with the specified source table name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a table mapping with the specified source table name exists, otherwise false.</para>
+        </returns>
         <param name="sourceTableName">
           <attribution license="cc4" from="Microsoft" modified="false" />The case-sensitive name of the source table. </param>
       </Docs>
@@ -88,12 +94,15 @@
         <Parameter Name="dataSetTableName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ITableMapping'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the TableMapping object with the specified <see cref="T:System.Data.DataSet" /> table name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The TableMapping object with the specified DataSet table name.</para>
+        </returns>
         <param name="dataSetTableName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the DataSet table within the collection. </param>
       </Docs>
@@ -112,12 +121,15 @@
         <Parameter Name="sourceTableName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the location of the <see cref="T:System.Data.ITableMapping" /> object within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based location of the <see cref="T:System.Data.ITableMapping" /> object within the collection.</para>
+        </returns>
         <param name="sourceTableName">
           <attribution license="cc4" from="Microsoft" modified="false" />The case-sensitive name of the source table. </param>
       </Docs>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data/InternalDataCollectionBase.xml b/mcs/class/System.Data/Documentation/en/System.Data/InternalDataCollectionBase.xml
index 861b64085f5..f2983091e88 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data/InternalDataCollectionBase.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data/InternalDataCollectionBase.xml
@@ -113,7 +113,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IEnumerator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Windows.Forms.BaseCollection" /> class and its members are not intended for use as a stand-alone component, but as the class from which other collection classes derive standard functionality.</para>
@@ -122,6 +121,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <see cref="T:System.Collections.IEnumerator" /> for the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the collection.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Data/TypedDataSetGenerator.xml b/mcs/class/System.Data/Documentation/en/System.Data/TypedDataSetGenerator.xml
index 71b501bf9db..7d084ffccc6 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data/TypedDataSetGenerator.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data/TypedDataSetGenerator.xml
@@ -87,7 +87,6 @@
         <Parameter Name="codeGen" Type="System.CodeDom.Compiler.ICodeGenerator" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Data.TypedDataSetGenerator" /> class is not intended for use as a stand-alone component, but as a class from which other classes derive standard functionality.</para>
@@ -96,6 +95,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Transforms a string in a valid, typed <see cref="T:System.Data.DataSet" /> name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that is the converted name.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The source name to transform into a valid, typed <see cref="T:System.Data.DataSet" /> name. </param>
         <param name="codeGen">
diff --git a/mcs/class/System.Data/Documentation/en/System.Data/UniqueConstraint.xml b/mcs/class/System.Data/Documentation/en/System.Data/UniqueConstraint.xml
index 378042c446f..4320050760c 100644
--- a/mcs/class/System.Data/Documentation/en/System.Data/UniqueConstraint.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Data/UniqueConstraint.xml
@@ -295,7 +295,6 @@
         <Parameter Name="key2" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Two constraints are equal if they constrain the same columns.</para>
@@ -304,6 +303,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this constraint to a second to determine if both are identical.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if the contraints are equal; otherwise, false.</para>
+        </returns>
         <param name="key2">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to which this <see cref="T:System.Data.UniqueConstraint" /> is compared. </param>
       </Docs>
@@ -320,12 +323,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash code of this instance of the <see cref="T:System.Data.UniqueConstraint" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Data/Documentation/en/System.Xml/XmlDataDocument.xml b/mcs/class/System.Data/Documentation/en/System.Xml/XmlDataDocument.xml
index e43f952448a..551e0b48d1f 100644
--- a/mcs/class/System.Data/Documentation/en/System.Xml/XmlDataDocument.xml
+++ b/mcs/class/System.Data/Documentation/en/System.Xml/XmlDataDocument.xml
@@ -82,7 +82,6 @@
         <Parameter Name="deep" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlNode'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Cloning the XmlDataDocument also clones the <see cref="T:System.Data.DataSet" /> schema.</para>
@@ -94,6 +93,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplicate of the current node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The cloned node.</para>
+        </returns>
         <param name="deep">
           <attribution license="cc4" from="Microsoft" modified="false" />true to recursively clone the subtree under the specified node; false to clone only the node itself. </param>
       </Docs>
@@ -114,7 +117,6 @@
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlElement'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Note to Inheritors If you overload this function, it cannot be used for extensibility. Instead, you can return an element created by the base class, in this case, XmlDataDocument. See the following example.</para>
@@ -131,6 +133,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an element with the specified <see cref="P:System.Xml.XmlNode.Prefix" />, <see cref="P:System.Xml.XmlDocument.LocalName" /> , and <see cref="P:System.Xml.XmlNode.NamespaceURI" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Xml.XmlElement" />.</para>
+        </returns>
         <param name="prefix">
           <attribution license="cc4" from="Microsoft" modified="false" />The prefix of the new element. If String.Empty or null, there is no prefix. </param>
         <param name="localName">
@@ -153,7 +159,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlEntityReference'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -163,6 +168,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XmlEntityReference" /> with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlEntityReference" /> with the specified name.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the entity reference.</param>
       </Docs>
@@ -181,7 +190,6 @@
         <Parameter Name="node" Type="System.Xml.XmlNode" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XPath.XPathNavigator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The XPathNavigator provides read-only, random access to data. Because it is optimized for XSLT transformations, it provides performance benefits when used as an input mechanism to the <see cref="M:System.Xml.Xsl.XslTransform.Transform(System.Xml.XPath.XPathNavigator,System.Xml.Xsl.XsltArgumentList,System.Xml.XmlResolver)" /> method.</para>
@@ -190,6 +198,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.XPath.XPathNavigator" /> object for navigating this document. The XPathNavigator is positioned on the node specified in the <paramref name="node" /> parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XPathNavigator used to navigate the document.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlNode" /> you want the navigator initially positioned on. </param>
       </Docs>
@@ -230,7 +242,6 @@
         <Parameter Name="elemId" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlElement'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is not supported by the <see cref="T:System.Xml.XmlDataDocument" /> class.</para>
@@ -239,6 +250,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Xml.XmlElement" /> with the specified ID. This method is not supported by the <see cref="T:System.Xml.XmlDataDocument" /> class. Calling this method throws an exception.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlElement" /> with the specified ID.</para>
+        </returns>
         <param name="elemId">
           <attribution license="cc4" from="Microsoft" modified="false" />The attribute ID to match.</param>
       </Docs>
@@ -257,12 +272,15 @@
         <Parameter Name="r" Type="System.Data.DataRow" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlElement'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the <see cref="T:System.Xml.XmlElement" /> associated with the specified <see cref="T:System.Data.DataRow" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XmlElement containing a representation of the specified DataRow.</para>
+        </returns>
         <param name="r">
           <attribution license="cc4" from="Microsoft" modified="false" />The DataRow whose associated XmlElement you want to retrieve. </param>
       </Docs>
@@ -281,12 +299,15 @@
         <Parameter Name="e" Type="System.Xml.XmlElement" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Data.DataRow'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the <see cref="T:System.Data.DataRow" /> associated with the specified <see cref="T:System.Xml.XmlElement" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The DataRow containing a representation of the XmlElement; null if there is no DataRow associated with the XmlElement.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />The XmlElement whose associated DataRow you want to retrieve. </param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DataSourceDescriptorCollection.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DataSourceDescriptorCollection.xml
index 1602fa59924..661c83576a8 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DataSourceDescriptorCollection.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DataSourceDescriptorCollection.xml
@@ -45,12 +45,15 @@
         <Parameter Name="value" Type="System.ComponentModel.Design.Data.DataSourceDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.ComponentModel.Design.Data.DataSourceDescriptor" /> to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the <see cref="T:System.ComponentModel.Design.Data.DataSourceDescriptor" /> that was added to the collection.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.Design.Data.DataSourceDescriptor" /> to add to the collection.</param>
       </Docs>
@@ -68,12 +71,15 @@
         <Parameter Name="value" Type="System.ComponentModel.Design.Data.DataSourceDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the <see cref="T:System.ComponentModel.Design.Data.DataSourceDescriptorCollection" /> contains the specified <see cref="T:System.ComponentModel.Design.Data.DataSourceDescriptor" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ComponentModel.Design.Data.DataSourceDescriptor" /> is contained in the collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Data.DataSourceDescriptor" /> to locate.</param>
       </Docs>
@@ -116,12 +122,15 @@
         <Parameter Name="value" Type="System.ComponentModel.Design.Data.DataSourceDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of a <see cref="T:System.ComponentModel.Design.Data.DataSourceDescriptor" /> in the <see cref="T:System.ComponentModel.Design.Data.DataSourceDescriptorCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the <see cref="T:System.ComponentModel.Design.Data.DataSourceDescriptor" /> of <paramref name="value" /> in the <see cref="T:System.ComponentModel.Design.Data.DataSourceDescriptorCollection" />, if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Data.DataSourceDescriptor" /> to locate.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DataSourceGroupCollection.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DataSourceGroupCollection.xml
index 74fc385d358..4bf07b8ea58 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DataSourceGroupCollection.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DataSourceGroupCollection.xml
@@ -45,12 +45,15 @@
         <Parameter Name="value" Type="System.ComponentModel.Design.Data.DataSourceGroup" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.ComponentModel.Design.Data.DataSourceGroup" /> to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the <see cref="T:System.ComponentModel.Design.Data.DataSourceGroup" /> that was added to the collection.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.Design.Data.DataSourceGroup" /> to add to the collection.</param>
       </Docs>
@@ -68,12 +71,15 @@
         <Parameter Name="value" Type="System.ComponentModel.Design.Data.DataSourceGroup" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the <see cref="T:System.ComponentModel.Design.Data.DataSourceGroupCollection" /> contains the specified <see cref="T:System.ComponentModel.Design.Data.DataSourceGroup" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ComponentModel.Design.Data.DataSourceGroup" /> is contained in the collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Data.DataSourceGroup" /> to locate.</param>
       </Docs>
@@ -116,12 +122,15 @@
         <Parameter Name="value" Type="System.ComponentModel.Design.Data.DataSourceGroup" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of a <see cref="T:System.ComponentModel.Design.Data.DataSourceGroup" /> in the <see cref="T:System.ComponentModel.Design.Data.DataSourceGroupCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the <see cref="T:System.ComponentModel.Design.Data.DataSourceGroup" /> of <paramref name="value" /> in the <see cref="T:System.ComponentModel.Design.Data.DataSourceGroupCollection" />, if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Data.DataSourceGroup" /> to locate.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DataSourceProviderService.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DataSourceProviderService.xml
index daa56da46c6..d23e9756760 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DataSourceProviderService.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DataSourceProviderService.xml
@@ -51,7 +51,6 @@
         <Parameter Name="dataSourceDescriptor" Type="System.ComponentModel.Design.Data.DataSourceDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You should only call the <see cref="M:System.ComponentModel.Design.Data.DataSourceProviderService.AddDataSourceInstance(System.ComponentModel.Design.IDesignerHost,System.ComponentModel.Design.Data.DataSourceDescriptor)" /> method on data sources that are designable for example, if the<see cref="P:System.ComponentModel.Design.Data.DataSourceDescriptor.IsDesignable" /> value is true.</para>
@@ -61,6 +60,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates and returns an instance of the given data source, and adds it to the design surface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> representing an instance of the added data source.</para>
+        </returns>
         <param name="host">
           <attribution license="cc4" from="Microsoft" modified="false" />The designer host.</param>
         <param name="dataSourceDescriptor">
@@ -78,12 +81,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, retrieves the collection of data sources at the EnvDTE.Project level.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.Design.Data.DataSourceGroupCollection" />, or null if there are no data sources at the EnvDTE.Project level.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InvokeAddNewDataSource">
@@ -100,12 +106,15 @@
         <Parameter Name="startPosition" Type="System.Windows.Forms.FormStartPosition" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, invokes the <ui>Add New Data Source Wizard</ui>.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.Design.Data.DataSourceGroup" /> collection of newly added data sources, or null if no data sources are added.</para>
+        </returns>
         <param name="parentWindow">
           <attribution license="cc4" from="Microsoft" modified="false" />The parent window.</param>
         <param name="startPosition">
@@ -127,12 +136,15 @@
         <Parameter Name="dataSourceDescriptor" Type="System.ComponentModel.Design.Data.DataSourceDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, invokes the <ui>Configure Data Source</ui> dialog box on the specified data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if any changes were made to that data source; otherwise, false.</para>
+        </returns>
         <param name="parentWindow">
           <attribution license="cc4" from="Microsoft" modified="false" />The parent window.</param>
         <param name="startPosition">
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DesignerDataStoredProcedure.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DesignerDataStoredProcedure.xml
index a46297ef0b6..e8ec3394b7a 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DesignerDataStoredProcedure.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DesignerDataStoredProcedure.xml
@@ -73,7 +73,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.Data.DesignerDataStoredProcedure.CreateParameters" /> method is called the first time the <see cref="P:System.ComponentModel.Design.Data.DesignerDataStoredProcedure.Parameters" /> property is accessed to populate the collection of stored-procedure parameters.</para>
@@ -82,6 +81,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns a collection of parameters for the stored procedure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of <see cref="T:System.ComponentModel.Design.Data.DesignerDataParameter" /> objects.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Name">
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DesignerDataTable.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DesignerDataTable.xml
index 74ac59e81de..41fa3639dbd 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DesignerDataTable.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DesignerDataTable.xml
@@ -73,7 +73,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.Data.DesignerDataTable.CreateRelationships" /> method is called the first time the <see cref="P:System.ComponentModel.Design.Data.DesignerDataTable.Relationships" /> property is accessed, to populate the collection of data table relationships.</para>
@@ -82,6 +81,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns a collection of relationship objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of <see cref="T:System.ComponentModel.Design.Data.DesignerDataRelationship" /> objects.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Relationships">
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DesignerDataTableBase.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DesignerDataTableBase.xml
index 63c8e738981..45eab988c21 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DesignerDataTableBase.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/DesignerDataTableBase.xml
@@ -101,7 +101,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.Data.DesignerDataTableBase.CreateColumns" /> method is called the first time the <see cref="P:System.ComponentModel.Design.Data.DesignerDataTableBase.Columns" /> property is accessed, to populate the collection of data-store columns.</para>
@@ -110,6 +109,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns a collection of data-store column objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of <see cref="T:System.ComponentModel.Design.Data.DesignerDataColumn" /> objects.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Name">
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/IDataEnvironment.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/IDataEnvironment.xml
index f11742066d4..4e1edef66da 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/IDataEnvironment.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/IDataEnvironment.xml
@@ -32,7 +32,6 @@
         <Parameter Name="initialConnection" Type="System.ComponentModel.Design.Data.DesignerDataConnection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.ComponentModel.Design.Data.IDataEnvironment.BuildConnection(System.Windows.Forms.IWin32Window,System.ComponentModel.Design.Data.DesignerDataConnection)" /> method to activate the design environment's user interface for creating or editing data connections. If the <paramref name="initialConnection" /> parameter is null, it indicates the user wants to create a new connection. If the <paramref name="initialConnection" /> parameter is a <see cref="T:System.ComponentModel.Design.Data.DesignerDataConnection" /> object, it indicates the user wants to edit an existing connection.</para>
@@ -44,6 +43,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new data connection or edits an existing connection using the design tool's new connection user interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new or edited <see cref="T:System.ComponentModel.Design.Data.DesignerDataConnection" /> object, or null if the user canceled.</para>
+        </returns>
         <param name="owner">
           <attribution license="cc4" from="Microsoft" modified="false" />The parent window for the connection dialog.</param>
         <param name="initialConnection">
@@ -66,7 +69,6 @@
         <Parameter Name="initialQueryText" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.Data.IDataEnvironment.BuildQuery(System.Windows.Forms.IWin32Window,System.ComponentModel.Design.Data.DesignerDataConnection,System.ComponentModel.Design.Data.QueryBuilderMode,System.String)" /> method launches the design environment's UI for editing or creating SQL query strings. If the <paramref name="initialQueryText" /> parameter is <see cref="F:System.String.Empty" />, it indicates the user wants to create a new query. If the <paramref name="initialQueryText" /> parameter contains a string, it indicates the user wants to edit the existing query. </para>
@@ -76,6 +78,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Launches a dialog to build a SQL query string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the SQL query, or null if the user canceled.</para>
+        </returns>
         <param name="owner">
           <attribution license="cc4" from="Microsoft" modified="false" />The parent window for the dialog.</param>
         <param name="connection">
@@ -101,7 +107,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.Data.IDataEnvironment.ConfigureConnection(System.Windows.Forms.IWin32Window,System.ComponentModel.Design.Data.DesignerDataConnection,System.String)" /> method writes a connection to the application's configuration file. The connection string and provider name are written to the <format type="text/html"><a href="b6ffbb2e-a4d1-410e-8f7e-9755e92c65de">connectionStrings</a></format> configuration element named according to the <paramref name="name" /> parameter. The <see cref="P:System.ComponentModel.Design.Data.DesignerDataConnection.Name" /> property of the <paramref name="connection" /> parameter is ignored. </para>
@@ -153,6 +158,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes a connection string to the application's configuration file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.Design.Data.DesignerDataConnection" /> object containing the saved connection data with the <see cref="P:System.ComponentModel.Design.Data.DesignerDataConnection.Name" /> property set to <paramref name="name" />, and the <see cref="P:System.ComponentModel.Design.Data.DesignerDataConnection.IsConfigured" /> property set to true.</para>
+        </returns>
         <param name="owner">
           <attribution license="cc4" from="Microsoft" modified="false" />The parent window for the dialog, if any.</param>
         <param name="connection">
@@ -196,12 +205,15 @@
         <Parameter Name="connection" Type="System.ComponentModel.Design.Data.DesignerDataConnection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a code expression that contains the source code required to retrieve a connection string from the application's configuration file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.CodeExpression" /> object containing the source code required to retrieve a connection string from the application's configuration file.</para>
+        </returns>
         <param name="connection">
           <attribution license="cc4" from="Microsoft" modified="false" />The connection to retrieve from the application's configuration file.</param>
       </Docs>
@@ -219,7 +231,6 @@
         <Parameter Name="connection" Type="System.ComponentModel.Design.Data.DesignerDataConnection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.Data.IDataEnvironment.GetConnectionSchema(System.ComponentModel.Design.Data.DesignerDataConnection)" /> method returns the database schema for the specified data connection. If the schema is unavailable, or if the provider for the connection is unavailable, the <see cref="M:System.ComponentModel.Design.Data.IDataEnvironment.GetConnectionSchema(System.ComponentModel.Design.Data.DesignerDataConnection)" /> should return null.</para>
@@ -228,6 +239,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the schema for the specified data connection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.Design.Data.IDesignerDataSchema" /> object containing the schema information for the specified data connection, or null if no schema information is available.</para>
+        </returns>
         <param name="connection">
           <attribution license="cc4" from="Microsoft" modified="false" />The data connection for which to return schema information.</param>
       </Docs>
@@ -245,7 +260,6 @@
         <Parameter Name="connection" Type="System.ComponentModel.Design.Data.DesignerDataConnection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.Data.IDataEnvironment.GetDesignTimeConnection(System.ComponentModel.Design.Data.DesignerDataConnection)" /> method returns a valid, open connection to the data store that can be used by the control designer. </para>
@@ -255,6 +269,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a database connection that can be used at design time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.Common.DbConnection" /> object that can be used at design time.</para>
+        </returns>
         <param name="connection">
           <attribution license="cc4" from="Microsoft" modified="false" />The desired data connection.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/IDesignerDataSchema.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/IDesignerDataSchema.xml
index 6bc4a3f744d..f09dc81e03b 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/IDesignerDataSchema.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Data/IDesignerDataSchema.xml
@@ -31,7 +31,6 @@
         <Parameter Name="schemaClass" Type="System.ComponentModel.Design.Data.DesignerDataSchemaClass" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.Data.IDesignerDataSchema.GetSchemaItems(System.ComponentModel.Design.Data.DesignerDataSchemaClass)" /> method returns a collection of all the specified schema objects in the data store. </para>
@@ -43,6 +42,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of specified schema items.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of schema objects of the specified type.</para>
+        </returns>
         <param name="schemaClass">
           <attribution license="cc4" from="Microsoft" modified="false" />The schema objects to return.</param>
       </Docs>
@@ -60,7 +63,6 @@
         <Parameter Name="schemaClass" Type="System.ComponentModel.Design.Data.DesignerDataSchemaClass" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.Data.IDesignerDataSchema.SupportsSchemaClass(System.ComponentModel.Design.Data.DesignerDataSchemaClass)" /> method indicates whether the data store supports a specified data-schema object. If the data store does not support the specified object, the <see cref="M:System.ComponentModel.Design.Data.IDesignerDataSchema.SupportsSchemaClass(System.ComponentModel.Design.Data.DesignerDataSchemaClass)" /> method should return false.</para>
@@ -70,6 +72,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the data store contains the specified data-schema object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the data store supports the specified data-schema object; otherwise, false.</para>
+        </returns>
         <param name="schemaClass">
           <attribution license="cc4" from="Microsoft" modified="false" />The schema objects to return.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/BasicDesignerLoader.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/BasicDesignerLoader.xml
index 2003df2c3d0..54aa7c1d4fb 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/BasicDesignerLoader.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/BasicDesignerLoader.xml
@@ -159,12 +159,15 @@
         <Parameter Name="enable" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Enables or disables component notification with the <see cref="T:System.ComponentModel.Design.Serialization.DesignerLoader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the component notification was enabled prior to this call; otherwise, false.</para>
+        </returns>
         <param name="enable">
           <attribution license="cc4" from="Microsoft" modified="false" />true to enable component notification by the <see cref="T:System.ComponentModel.Design.Serialization.DesignerLoader" />; false to disable component notification by the <see cref="T:System.ComponentModel.Design.Serialization.DesignerLoader" />.</param>
       </Docs>
@@ -203,7 +206,6 @@
         <Parameter Name="serviceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -213,6 +215,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the requested service.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The requested service, or null if the requested service cannot be found.</para>
+        </returns>
         <param name="serviceType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the service.</param>
       </Docs>
@@ -249,7 +255,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.Serialization.BasicDesignerLoader.IsReloadNeeded" /> method is used by some designer loaders to optimize reloading. This method can be overridden if your designer loader supports intelligent reloading. Some designer loaders can detect changes made to their underlying document and determine if a reload of the designer is actually necessary. If not, they should return false from this method. The default implementation always returns true, indicating that any call to <see cref="M:System.ComponentModel.Design.Serialization.BasicDesignerLoader.Reload(System.ComponentModel.Design.Serialization.BasicDesignerLoader.ReloadOptions)" /> will succeed.</para>
@@ -258,6 +263,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the designer should be reloaded.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the designer should be reloaded; otherwise, false. The default implementation always returns true.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="LoaderHost">
@@ -637,7 +646,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Any object can call the <see cref="M:System.ComponentModel.Design.Serialization.BasicDesignerLoader.System#ComponentModel#Design#Serialization#IDesignerLoaderService#Reload" /> method to request that the loader reload the design document. If the loader supports reloading and complies with the reload, the designer loader can return true. Otherwise, it returns false, indicating that the reload will not occur. Callers cannot rely on the reload happening immediately; the designer loader can schedule this for some other time, or it can try to reload the designer at once.</para>
@@ -647,6 +655,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reloads the design document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the reload request is accepted; false if the loader does not allow the reload.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomComponentSerializationService.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomComponentSerializationService.xml
index 05d78549630..dbb2741c5eb 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomComponentSerializationService.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomComponentSerializationService.xml
@@ -66,7 +66,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The serialization store can be passed to any of the <see cref="M:System.ComponentModel.Design.Serialization.CodeDomComponentSerializationService.Serialize(System.ComponentModel.Design.Serialization.SerializationStore,System.Object)" /> methods to build up serialization state for a group of objects.</para>
@@ -75,6 +74,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ComponentModel.Design.Serialization.SerializationStore" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new serialization store.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Deserialize">
@@ -90,12 +93,15 @@
         <Parameter Name="store" Type="System.ComponentModel.Design.Serialization.SerializationStore" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes the given store to produce a collection of objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of deserialized components.</para>
+        </returns>
         <param name="store">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.SerializationStore" /> from which objects will be deserialized.</param>
       </Docs>
@@ -114,7 +120,6 @@
         <Parameter Name="container" Type="System.ComponentModel.IContainer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Created objects that implement the <see cref="T:System.ComponentModel.IComponent" /> interface will be added to the <paramref name="container" /> parameter.</para>
@@ -123,6 +128,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes the given store and populates the given <see cref="T:System.ComponentModel.IContainer" /> with deserialized <see cref="T:System.ComponentModel.IComponent" /> objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of deserialized components.</para>
+        </returns>
         <param name="store">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.SerializationStore" /> from which objects will be deserialized.</param>
         <param name="container">
@@ -176,7 +185,6 @@
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the returned store to deserialize objects by passing it to the various <see cref="Overload:System.ComponentModel.Design.Serialization.CodeDomComponentSerializationService.Deserialize" /> methods.</para>
@@ -185,6 +193,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads a <see cref="T:System.ComponentModel.Design.Serialization.SerializationStore" /> from the given stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded <see cref="T:System.ComponentModel.Design.Serialization.SerializationStore" />.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream from which to load the <see cref="T:System.ComponentModel.Design.Serialization.SerializationStore" />.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomDesignerLoader.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomDesignerLoader.xml
index d36455b4f6f..94a62ad00fb 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomDesignerLoader.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomDesignerLoader.xml
@@ -164,7 +164,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.Serialization.CodeDomDesignerLoader.IsReloadNeeded" /> method checks for the presence of the <see cref="T:System.ComponentModel.Design.Serialization.ICodeDomDesignerReload" /> interface on the <see cref="P:System.ComponentModel.Design.Serialization.CodeDomDesignerLoader.CodeDomProvider" />. The provider will reparse the CodeDOM tree and pass the resulting parse tree to the <see cref="M:System.ComponentModel.Design.Serialization.ICodeDomDesignerReload.ShouldReloadDesigner(System.CodeDom.CodeCompileUnit)" /> method. If this method returns false, the designer will not be reloaded.</para>
@@ -173,6 +172,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether a reload is required.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="P:System.ComponentModel.Design.Serialization.CodeDomDesignerLoader.CodeDomProvider" /> decides a reload is required; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="OnBeginLoad">
@@ -284,7 +287,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.Serialization.CodeDomDesignerLoader.Parse" /> method is called when the <see cref="T:System.ComponentModel.Design.Serialization.CodeDomDesignerLoader" /> needs to parse the source code. The source code location and format must be specified by deriving classes.</para>
@@ -293,6 +295,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Parses the text or other persistent storage and returns a <see cref="T:System.CodeDom.CodeCompileUnit" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.CodeCompileUnit" /> resulting from a parse operation.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="PerformFlush">
@@ -365,12 +371,15 @@
         <Parameter Name="serializationData" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes the specified serialization data object and returns a collection of objects represented by that data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of objects represented by <paramref name="serializationData" />.</para>
+        </returns>
         <param name="serializationData">
           <attribution license="cc4" from="Microsoft" modified="false" />An object consisting of serialized data.</param>
       </Docs>
@@ -388,12 +397,15 @@
         <Parameter Name="objects" Type="System.Collections.ICollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serializes the specified collection of objects and stores them in a serialization data object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that contains the serialized state of the specified collection of objects.</para>
+        </returns>
         <param name="objects">
           <attribution license="cc4" from="Microsoft" modified="false" />A collection of objects to serialize.</param>
       </Docs>
@@ -412,12 +424,15 @@
         <Parameter Name="dataType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new name that is unique to all components in the specified container.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A unique name for the data type.</para>
+        </returns>
         <param name="container">
           <attribution license="cc4" from="Microsoft" modified="false" />The container where the new object is added.</param>
         <param name="dataType">
@@ -437,12 +452,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified name is valid.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the name is valid; otherwise, false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name to validate.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomLocalizationProvider.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomLocalizationProvider.xml
index b7f2e024981..f243fe97353 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomLocalizationProvider.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomLocalizationProvider.xml
@@ -118,7 +118,6 @@
         <Parameter Name="serializerType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.ComponentModel.Design.Serialization.CodeDomLocalizationProvider" /> instance is cast to an <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationProvider" /> interface.</para>
@@ -127,6 +126,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ComponentModel.Design.Serialization.IDesignerSerializationProvider.GetSerializer(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object,System.Type,System.Type)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of a serializer of the type requested, or null if the request cannot be satisfied.</para>
+        </returns>
         <param name="manager">
           <attribution license="cc4" from="Microsoft" modified="false" />The serialization manager requesting the serializer. </param>
         <param name="currentSerializer">
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomSerializer.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomSerializer.xml
index 3b3a73c7f81..87617f10b4e 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomSerializer.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomSerializer.xml
@@ -73,7 +73,6 @@
         <Parameter Name="codeObject" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses the serialization manager to create objects and resolve data types. The root of the object graph is returned.</para>
@@ -82,6 +81,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes the specified serialized CodeDOM object into an object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The deserialized CodeDOM object.</para>
+        </returns>
         <param name="manager">
           <attribution license="cc4" from="Microsoft" modified="false" />A serialization manager interface that is used during the deserialization process. </param>
         <param name="codeObject">
@@ -105,7 +108,6 @@
         <Parameter Name="statement" Type="System.CodeDom.CodeStatement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializer.DeserializeStatementToInstance(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.CodeDom.CodeStatement)" /> is equivalent of calling <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.DeserializeStatement(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.CodeDom.CodeStatement)" />, except that it returns an object instance if the resulting statement was a variable assign statement, a variable declaration with an init expression, or a field assignment statement.</para>
@@ -114,6 +116,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes a single statement.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object instance resulting from deserializing <paramref name="statement" />.</para>
+        </returns>
         <param name="manager">
           <attribution license="cc4" from="Microsoft" modified="false" />The serialization manager to use for serialization.</param>
         <param name="statement">
@@ -135,12 +141,15 @@
         <Parameter Name="targetType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines which statement group the given statement should belong to.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the component with which <paramref name="statement" /> should be grouped.</para>
+        </returns>
         <param name="statement">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeStatement" /> for which to determine the group.</param>
         <param name="expression">
@@ -160,12 +169,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serializes the specified object into a CodeDOM object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A CodeDOM object representing the object that has been serialized.</para>
+        </returns>
         <param name="manager">
           <attribution license="cc4" from="Microsoft" modified="false" />The serialization manager to use during serialization. </param>
         <param name="value">
@@ -189,12 +201,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serializes the given object, accounting for default values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A CodeDom object representing <paramref name="value" />.</para>
+        </returns>
         <param name="manager">
           <attribution license="cc4" from="Microsoft" modified="false" />The serialization manager to use for serialization.</param>
         <param name="value">
@@ -217,12 +232,15 @@
       </Parameters>
       <Docs>
         <param name="owningobject">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serializes the given member on the given object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.CodeStatementCollection" /> representing the serialized state of <paramref name="member" />.</para>
+        </returns>
         <param name="manager">
           <attribution license="cc4" from="Microsoft" modified="false" />The serialization manager to use for serialization.</param>
         <param name="member">
@@ -245,12 +263,15 @@
       </Parameters>
       <Docs>
         <param name="owningobject">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serializes the given member, accounting for default values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A CodeDom object representing <paramref name="member" />.</para>
+        </returns>
         <param name="manager">
           <attribution license="cc4" from="Microsoft" modified="false" />The serialization manager to use for serialization.</param>
         <param name="member">
@@ -268,7 +289,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is similar to <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.SerializeToExpression(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object)" />, except that it stops if it cannot obtain a simple reference expression for the value. Call this method when you expect the resulting expression to be used as a parameter or target of a statement.</para>
@@ -277,6 +297,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serializes the specified value to a CodeDOM expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The serialized value. This returns null if no reference expression can be obtained for the specified value, or the value cannot be serialized.</para>
+        </returns>
         <param name="manager">
           <attribution license="cc4" from="Microsoft" modified="false" />The serialization manager to use during serialization. </param>
         <param name="value">
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomSerializerBase.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomSerializerBase.xml
index 8fc69fc896b..c7ef3509a32 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomSerializerBase.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CodeDomSerializerBase.xml
@@ -40,7 +40,6 @@
         <Parameter Name="expression" Type="System.CodeDom.CodeExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is a helper method that derived classes can call to deserialize an expression. It deserializes the statement by interpreting and executing the CodeDOM expression specified by the <paramref name="expression" /> parameter, and then returns the results. If an object needs to be created as a result of this expression, it will be given the name specified by the <paramref name="name" /> parameter. The name can be null if there is no need to name the object. The following table describes how specific expressions are handled.</para>
@@ -109,6 +108,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes the given expression into an in-memory object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object resulting from interpretation of <paramref name="expression" />.</para>
+        </returns>
         <param name="manager">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationManager" /> to use for serialization.</param>
         <param name="name">
@@ -134,7 +137,6 @@
         <Parameter Name="addToContainer" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.DeserializeInstance(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Type,System.Object[],System.String,System.Boolean)" /> method is invoked during deserialization to obtain an instance of an object. When this is called, an instance of the requested type should be returned. The default implementation invokes the <see cref="M:System.ComponentModel.Design.Serialization.IDesignerSerializationManager.CreateInstance(System.Type,System.Collections.ICollection,System.String,System.Boolean)" /> method of the <paramref name="manager" /> parameter.</para>
@@ -143,6 +145,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an instance of the given type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <paramref name="type" />.</para>
+        </returns>
         <param name="manager">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationManager" /> to use for serialization.</param>
         <param name="type">
@@ -232,7 +238,6 @@
       </Parameters>
       <Docs>
         <param name="instance">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.GetExpression(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object)" /> method returns an expression representing the given object. It can return null, indicating that no expression has been set that describes the object. Expressions are acquired in one of three ways:</para>
@@ -254,6 +259,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an expression for the given object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.CodeExpression" /> representing v<paramref name="alue" />, or null if there is no existing expression for v<paramref name="alue" />.</para>
+        </returns>
         <param name="manager">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationManager" /> to use for serialization.</param>
       </Docs>
@@ -273,7 +282,6 @@
       </Parameters>
       <Docs>
         <param name="instance">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.GetSerializer(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object)" /> method is an extension to the <see cref="M:System.ComponentModel.Design.Serialization.IDesignerSerializationManager.GetSerializer(System.Type,System.Type)" /> method. The <see cref="M:System.ComponentModel.Design.Serialization.IDesignerSerializationManager.GetSerializer(System.Type,System.Type)" /> method takes an object type, rather than an object value. If an external party had overridden metadata for a specific object through <see cref="T:System.ComponentModel.TypeDescriptor" />, that metadata override would not be seen by the <see cref="M:System.ComponentModel.Design.Serialization.IDesignerSerializationManager.GetSerializer(System.Type,System.Type)" /> method, which only takes a type. The <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.GetSerializer(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object)" /> method checks the metadata of the value and the value’s type. If the two differ, <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.GetSerializer(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object)" /> will look to see if there is a custom designer serializer attribute on the value. If so, <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.GetSerializer(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object)" /> will attempt to use it. Otherwise, it will defer to <see cref="M:System.ComponentModel.Design.Serialization.IDesignerSerializationManager.GetSerializer(System.Type,System.Type)" />.</para>
@@ -282,6 +290,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Locates a serializer for the given object value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.Design.Serialization.CodeDomSerializer" /> that is appropriate for <paramref name="value" />.</para>
+        </returns>
         <param name="manager">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationManager" /> to use for serialization.</param>
       </Docs>
@@ -301,7 +313,6 @@
       </Parameters>
       <Docs>
         <param name="instanceType">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.GetSerializer(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Type)" /> method is an extension to the <see cref="M:System.ComponentModel.Design.Serialization.IDesignerSerializationManager.GetSerializer(System.Type,System.Type)" /> method. The <see cref="M:System.ComponentModel.Design.Serialization.IDesignerSerializationManager.GetSerializer(System.Type,System.Type)" /> method takes an object type, rather than an object value.</para>
@@ -310,6 +321,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Locates a serializer for the given type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.Design.Serialization.CodeDomSerializer" /> that is appropriate for <paramref name="valueType" />.</para>
+        </returns>
         <param name="manager">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationManager" /> to use for serialization.</param>
       </Docs>
@@ -329,7 +344,6 @@
       </Parameters>
       <Docs>
         <param name="instance">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.GetUniqueName(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object)" /> method calls the <see cref="M:System.ComponentModel.Design.Serialization.IDesignerSerializationManager.GetName(System.Object)" /> method. If this method does not return a name, then <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.GetUniqueName(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object)" /> uses <see cref="T:System.ComponentModel.Design.Serialization.INameCreationService" /> to fabricate a valid name for the object. If the service is not available, <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.GetUniqueName(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object)" /> will fabricate a name based on the short type name combined with an index number to make it unique. The resulting name is associated with the serialization manager by calling the <see cref="M:System.ComponentModel.Design.Serialization.IDesignerSerializationManager.SetName(System.Object,System.String)" /> method before the new name is returned.</para>
@@ -338,6 +352,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a unique name for the given object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A unique name for <paramref name="value" />.</para>
+        </returns>
         <param name="manager">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationManager" /> to use for serialization.</param>
       </Docs>
@@ -356,7 +374,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For the <paramref name="value" /> parameter to be considered serialized, the <paramref name="manager" /> parameter or another serializer must have called the <see cref="Overload:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.SetExpression" /> method to create a relationship between <paramref name="value" /> and a referring expression.</para>
@@ -365,6 +382,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the given object has been serialized.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> has been serialized; otherwise, false.</para>
+        </returns>
         <param name="manager">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationManager" /> to use for serialization.</param>
         <param name="value">
@@ -387,7 +408,6 @@
       </Parameters>
       <Docs>
         <param name="instance">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For the <paramref name="value" /> parameter to be considered serialized, the <paramref name="manager" /> parameter or another serializer must have called the <see cref="Overload:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.SetExpression" /> method to create a relationship between <paramref name="value" /> and a referring expression.</para>
@@ -396,6 +416,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the given object has been serialized, optionally considering preset expressions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> has been serialized; otherwise, false.</para>
+        </returns>
         <param name="manager">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationManager" /> to use for serialization.</param>
         <param name="honorPreset">
@@ -692,7 +716,6 @@
       </Parameters>
       <Docs>
         <param name="instance">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="value" /> parameter can be null, in which case a primitive expression will be returned.</para>
@@ -724,6 +747,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serializes the given object into an expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.CodeExpression" /> object if <paramref name="value" /> can be serialized; otherwise, null.</para>
+        </returns>
         <param name="manager">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationManager" /> to use for serialization.</param>
       </Docs>
@@ -742,7 +769,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.SerializeToResourceExpression" /> method is a helper method that serializes a value to a resource expression. This is in contrast to the <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.SerializeResource(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.String,System.Object)" /> method, which writes a value to a resource binary object. <see cref="Overload:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.SerializeToResourceExpression" /> goes one step further and returns an expression that can be used to recover the resource. For example, the return value might be "rm.GetValue("SomeBitmap");". The name of the resource is calculated from the <see cref="T:System.ComponentModel.Design.Serialization.ExpressionContext" />, if one can be found on the context stack. </para>
@@ -766,6 +792,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serializes the given object into an expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.CodeExpression" /> containing <paramref name="value" /> as a serialized expression.</para>
+        </returns>
         <param name="manager">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationManager" /> to use for serialization.</param>
         <param name="value">
@@ -787,7 +817,6 @@
         <Parameter Name="ensureInvariant" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <paramref name="ensureInvariant" /> parameter is true, the <see cref="M:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.SerializeToResourceExpression(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object,System.Boolean)" /> method will also write the resource value into the invariant culture’s resource file if the current ResourceCulture is not the invariant culture..</para>
@@ -796,6 +825,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serializes the given object into an expression appropriate for the invariant culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.CodeExpression" /> containing <paramref name="value" /> as a serialized expression.</para>
+        </returns>
         <param name="manager">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationManager" /> to use for serialization.</param>
         <param name="value">
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CollectionCodeDomSerializer.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CollectionCodeDomSerializer.xml
index 52bd86c5baa..a6964de0416 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CollectionCodeDomSerializer.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/CollectionCodeDomSerializer.xml
@@ -48,7 +48,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks the <paramref name="method" /> attributes to see if they support serialization.</para>
@@ -57,6 +56,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies serialization support by the <paramref name="method" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="method" /> supports serialization; otherwise, false.</para>
+        </returns>
         <param name="method">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.MethodInfo" /> to check for serialization attributes.</param>
       </Docs>
@@ -75,7 +78,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Collections are serialized as follows:</para>
@@ -105,6 +107,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serializes the given collection into a CodeDOM object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A CodeDOM object representing <paramref name="value" />.</para>
+        </returns>
         <param name="manager">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationManager" /> to use during serialization.</param>
         <param name="value">
@@ -128,7 +134,6 @@
         <Parameter Name="valuesToSerialize" Type="System.Collections.ICollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.CodeDom.CodeExpression" /> that refers to the collection can be null.</para>
@@ -137,6 +142,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serializes the given collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Serialized collection if the serialization process succeeded; otherwise, null.</para>
+        </returns>
         <param name="manager">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.IDesignerSerializationManager" /> to use during serialization.</param>
         <param name="targetExpression">
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/DesignerSerializationManager.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/DesignerSerializationManager.xml
index 2606f225b7b..093a18ae9b8 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/DesignerSerializationManager.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/DesignerSerializationManager.xml
@@ -231,7 +231,6 @@
         <Parameter Name="addToContainer" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called by serializers when they attempt to create an instance of a type. The default implementation creates a new instance of the type, or it may return an existing instance depending on the values of the <see cref="P:System.ComponentModel.Design.Serialization.DesignerSerializationManager.PreserveNames" /> and <see cref="P:System.ComponentModel.Design.Serialization.DesignerSerializationManager.RecycleInstances" /> properties. The <see cref="M:System.ComponentModel.Design.Serialization.IDesignerSerializationManager.CreateInstance(System.Type,System.Collections.ICollection,System.String,System.Boolean)" /> method uses reflection to create instances and will perform some generic <see cref="T:System.IConvertible" /> transformations on parameters to find a matching constructor.</para>
@@ -240,6 +239,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of a type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the type specified by <paramref name="type" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to create an instance of.</param>
         <param name="arguments">
@@ -261,7 +264,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Most data within the serialization manager is transient and only lives for the life of a serialization session. When a session is disposed, serialization is considered to be complete and this transient state is cleared. This allows a single instance of a serialization manager to be used to serialize multiple object trees. Some state, including the service provider and any custom serialization providers that were added to the serialization manager, span sessions.</para>
@@ -270,6 +272,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new serialization session.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IDisposable" /> that represents a new serialization session.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Errors">
@@ -308,7 +314,6 @@
       </Parameters>
       <Docs>
         <param name="componentType">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can request the type of serializer you would like. This method returns null if there is no serializer of the requested type for the specified object type.</para>
@@ -317,6 +322,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the serializer for the given object type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The serializer for <paramref name="objectType" />, or null, if not found.</para>
+        </returns>
         <param name="serializerType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of serializer to retrieve.</param>
       </Docs>
@@ -335,7 +344,6 @@
       </Parameters>
       <Docs>
         <param name="service">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.Serialization.DesignerSerializationManager.GetService(System.Type)" /> method provides access to the underlying container or service provider that was set in the constructor.</para>
@@ -344,6 +352,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the requested service.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The requested service, or null if the service cannot be resolved.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetType">
@@ -360,7 +372,6 @@
       </Parameters>
       <Docs>
         <param name="name">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.ComponentModel.Design.Serialization.DesignerSerializationManager.GetType" /> method will search the service provider for an <see cref="T:System.ComponentModel.Design.ITypeResolutionService" /> and, if available, it will delegate to that service to resolve the type. If an <see cref="T:System.ComponentModel.Design.ITypeResolutionService" /> is not available, <see cref="Overload:System.ComponentModel.Design.Serialization.DesignerSerializationManager.GetType" /> will call the <see cref="M:System.Object.GetType" /> method.</para>
@@ -369,6 +380,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the requested type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The requested type, or null if the type cannot be resolved.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="OnResolveName">
@@ -611,12 +626,15 @@
         <Parameter Name="addToContainer" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implements the <see cref="M:System.ComponentModel.Design.Serialization.IDesignerSerializationManager.CreateInstance(System.Type,System.Collections.ICollection,System.String,System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created object instance.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The data type to create. </param>
         <param name="arguments">
@@ -640,12 +658,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an instance of a created object of the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the object with the given name, or null if no object by that name can be found.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the object to retrieve.</param>
       </Docs>
@@ -664,7 +685,6 @@
       </Parameters>
       <Docs>
         <param name="instance">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="M:System.ComponentModel.Design.Serialization.DesignerSerializationManager.System#ComponentModel#Design#Serialization#IDesignerSerializationManager#GetName(System.Object)" /> method cannot find a corresponding name for the <paramref name="value" /> parameter, it raises the <see cref="E:System.ComponentModel.Design.Serialization.IDesignerSerializationManager.ResolveName" /> event before it returns null.</para>
@@ -673,6 +693,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a name for the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the object, or null if the object is unnamed.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.Design.Serialization.IDesignerSerializationManager.GetSerializer">
@@ -690,12 +714,15 @@
       </Parameters>
       <Docs>
         <param name="type">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a serializer of the requested type for the specified object type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the requested serializer, or null if no appropriate serializer can be located.</para>
+        </returns>
         <param name="serializerType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the serializer to retrieve.</param>
       </Docs>
@@ -714,12 +741,15 @@
       </Parameters>
       <Docs>
         <param name="name">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a type of the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the type, or null if the type cannot be loaded.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.Design.Serialization.IDesignerSerializationManager.Properties">
@@ -833,7 +863,6 @@
       </Parameters>
       <Docs>
         <param name="service">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.ComponentModel.Design.Serialization.DesignerSerializationManager" /> instance is cast to an <see cref="T:System.IServiceProvider" /> interface.</para>
@@ -842,6 +871,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see the <see cref="M:System.IServiceProvider.GetService(System.Type)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A service object of type <paramref name="serviceType" />.</para>
+          <para>-or-</para>
+          <para>null if there is no service object of type <paramref name="serviceType" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ValidateRecycledTypes">
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/ICodeDomDesignerReload.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/ICodeDomDesignerReload.xml
index 817e29472a8..74d1c053cd2 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/ICodeDomDesignerReload.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/ICodeDomDesignerReload.xml
@@ -29,12 +29,15 @@
         <Parameter Name="newTree" Type="System.CodeDom.CodeCompileUnit" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the designer should reload in order to import the specified compile unit correctly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the designer should reload; otherwise, false.</para>
+        </returns>
         <param name="newTree">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.CodeCompileUnit" /> containing the designer document code. </param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/MemberCodeDomSerializer.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/MemberCodeDomSerializer.xml
index 1c62359d6bc..3b803688586 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/MemberCodeDomSerializer.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/MemberCodeDomSerializer.xml
@@ -85,7 +85,6 @@
         <Parameter Name="descriptor" Type="System.ComponentModel.MemberDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns true if the given member descriptor should be serialized, or false if there is no need to serialize the member.</para>
@@ -94,6 +93,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the given member should be serialized.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if the member described by <paramref name="descriptor" /> should be serialized; otherwise, false.</para>
+        </returns>
         <param name="manager">
           <attribution license="cc4" from="Microsoft" modified="false" />The serialization manager to use for serialization.</param>
         <param name="value">
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/ObjectStatementCollection.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/ObjectStatementCollection.xml
index 8f1753840dc..fac5598ccbf 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/ObjectStatementCollection.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/ObjectStatementCollection.xml
@@ -34,12 +34,15 @@
         <Parameter Name="statementOwner" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the table contains the given statement owner.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="statementOwner" /> is in the table; otherwise, false.</para>
+        </returns>
         <param name="statementOwner">
           <attribution license="cc4" from="Microsoft" modified="false" />The owner of the statement collection.</param>
       </Docs>
@@ -55,12 +58,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.ComponentModel.Design.Serialization.ObjectStatementCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.ComponentModel.Design.Serialization.ObjectStatementCollection" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Item">
@@ -143,7 +149,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.ComponentModel.Design.Serialization.ObjectStatementCollection" /> instance is cast to an <see cref="T:System.Collections.IEnumerable" /> interface.</para>
@@ -152,6 +157,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see the <see cref="M:System.Collections.IEnumerable.GetEnumerator" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/SerializeAbsoluteContext.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/SerializeAbsoluteContext.xml
index 5f4f55e9f7e..bcea83d27e7 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/SerializeAbsoluteContext.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/SerializeAbsoluteContext.xml
@@ -91,12 +91,15 @@
         <Parameter Name="member" Type="System.ComponentModel.MemberDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the given member should be serialized in this context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the given member should be serialized in this context; otherwise, false.</para>
+        </returns>
         <param name="member">
           <attribution license="cc4" from="Microsoft" modified="false" />The member to be examined for serialization.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/TypeCodeDomSerializer.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/TypeCodeDomSerializer.xml
index 0586a1b4d91..d82203741da 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/TypeCodeDomSerializer.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design.Serialization/TypeCodeDomSerializer.xml
@@ -49,7 +49,6 @@
         <Parameter Name="declaration" Type="System.CodeDom.CodeTypeDeclaration" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.Serialization.TypeCodeDomSerializer.Deserialize(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.CodeDom.CodeTypeDeclaration)" /> method deserializes a previously serialized code type declaration. The following table shows the tasks default implementation performs.</para>
@@ -128,6 +127,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes the given type declaration.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The root object.</para>
+        </returns>
         <param name="manager">
           <attribution license="cc4" from="Microsoft" modified="false" />The serialization manager to use for serialization.</param>
         <param name="declaration">
@@ -149,7 +152,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.Serialization.TypeCodeDomSerializer.GetInitializeMethod(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.CodeDom.CodeTypeDeclaration,System.Object)" /> method returns the method to emit all of the initialization code for the given member. The default implementation returns an empty constructor. If the same method is to be returned for multiple values, the same instance of the method should be returned. You can use the <see cref="P:System.CodeDom.CodeObject.UserData" /> dictionary to remember methods you have created. The <paramref name="typeDecl" /> parameter can also be used to add infrastructure methods. For example, if you want to emit a separate method for each object, you need a single method that calls all of these methods in turn. This method can be added to the code type declaration as needed.</para>
@@ -158,6 +160,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the method where statements used to serialize a member are stored.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The method used to emit all of the initialization code for the given member.</para>
+        </returns>
         <param name="manager">
           <attribution license="cc4" from="Microsoft" modified="false" />The serialization manager to use for serialization.</param>
         <param name="declaration">
@@ -180,7 +186,6 @@
         <Parameter Name="declaration" Type="System.CodeDom.CodeTypeDeclaration" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default implementation returns a single-element array with the constructor in it.</para>
@@ -189,6 +194,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of methods to be interpreted during deserialization.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.CodeMemberMethod" /> array of methods to be interpreted during deserialization.</para>
+        </returns>
         <param name="manager">
           <attribution license="cc4" from="Microsoft" modified="false" />The serialization manager to use for serialization.</param>
         <param name="declaration">
@@ -210,7 +219,6 @@
         <Parameter Name="members" Type="System.Collections.ICollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.Serialization.TypeCodeDomSerializer.Serialize(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object,System.Collections.ICollection)" /> method serializes the given root object and optional collection of members to create a new type definition. If the <paramref name="members" /> collection contains values, these values are serialized. Values themselves may serialize as either member variables or local variables. This determination is done by searching for an extender property on the object called GenerateMember. If true, a member is generated. Otherwise, a local variable is generated. For convenience, the <paramref name="members" /> collection can contain the root object. In this case, the root object is not also added as a member or local variable. </para>
@@ -303,6 +311,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serializes the object root by creating a new type declaration that defines root.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.CodeTypeDeclaration" /> that defines the root object.</para>
+        </returns>
         <param name="manager">
           <attribution license="cc4" from="Microsoft" modified="false" />The serialization manager to use for serialization.</param>
         <param name="root">
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ArrayEditor.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ArrayEditor.xml
index a1cd237fc6b..19be7b9ca7f 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ArrayEditor.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ArrayEditor.xml
@@ -49,7 +49,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default implementation returns the item type of the array.</para>
@@ -58,6 +57,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the data type that this collection is designed to contain.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> that indicates the data type that the collection is designed to contain.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -74,12 +77,15 @@
         <Parameter Name="editValue" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the items in the array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array consisting of the items within the specified array. If the object specified in the <paramref name="editValue" /> parameter is not an array, a new empty object is returned.</para>
+        </returns>
         <param name="editValue">
           <attribution license="cc4" from="Microsoft" modified="false" />The array from which to retrieve the items. </param>
       </Docs>
@@ -99,12 +105,15 @@
         <Parameter Name="value" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the items in the array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the new array. If the object specified by the <paramref name="editValue" /> parameter is not an array, the object specified by the <paramref name="editValue" /> parameter is returned.</para>
+        </returns>
         <param name="editValue">
           <attribution license="cc4" from="Microsoft" modified="false" />The array to set the items to. </param>
         <param name="value">
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/BinaryEditor.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/BinaryEditor.xml
index d49340f71b8..b10d25c7886 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/BinaryEditor.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/BinaryEditor.xml
@@ -49,12 +49,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Edits the value of the specified object using the specified service provider and context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new value of the object. If the value of the object hasn't changed, this should return the same object it was passed.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
         <param name="provider">
@@ -77,12 +80,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the editor style used by the <see cref="M:System.ComponentModel.Design.BinaryEditor.EditValue(System.ComponentModel.ITypeDescriptorContext,System.IServiceProvider,System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enum value indicating the provided editing style.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ByteViewer.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ByteViewer.xml
index 2e18a1eef17..6791ba3ace2 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ByteViewer.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ByteViewer.xml
@@ -55,12 +55,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the bytes in the buffer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The unsigned byte array reference.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -75,12 +78,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the display mode for the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The display mode that this control uses. The returned value is defined in <see cref="T:System.ComponentModel.Design.DisplayMode" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/CollectionEditor.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/CollectionEditor.xml
index 6f8400598a1..c12af0168e6 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/CollectionEditor.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/CollectionEditor.xml
@@ -67,7 +67,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented in a derived class, this method indicates whether the specified value can be removed from the collection. By default, this method always returns true.</para>
@@ -77,6 +76,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether original members of the collection can be removed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if it is permissible to remove this value from the collection; otherwise, false. The default implementation always returns true.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to remove. </param>
       </Docs>
@@ -93,7 +96,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method indicates whether multiple collection members can be selected within the collection editor dialog box.</para>
@@ -102,6 +104,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether multiple collection items can be selected at once.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if it multiple collection members can be selected at the same time; otherwise, false. By default, this returns true.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -179,12 +185,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new form to display and edit the current collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.Design.CollectionEditor.CollectionForm" /> to provide as the user interface for editing the collection.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -199,7 +208,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can retrieve the data type of the items of the collection from the <see cref="P:System.ComponentModel.Design.CollectionEditor.CollectionItemType" /> property, which is faster than this method.</para>
@@ -210,6 +218,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the data type that this collection contains.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The data type of the items in the collection, or an <see cref="T:System.Object" /> if no Item property can be located on the collection.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -226,12 +238,15 @@
         <Parameter Name="itemType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the specified collection item type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the specified object.</para>
+        </returns>
         <param name="itemType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of item to create. </param>
       </Docs>
@@ -248,7 +263,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can retrieve the data type of the items of the collection from the <see cref="P:System.ComponentModel.Design.CollectionEditor.NewItemTypes" /> property, which is faster than this method.</para>
@@ -259,6 +273,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the data types that this collection editor can contain.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of data types that this collection can contain.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -300,12 +318,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Edits the value of the specified object using the specified service provider and context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new value of the object. If the value of the object has not changed, this should return the same object it was passed.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
         <param name="provider">
@@ -332,12 +353,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the display text for the given list item.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The display text for <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The list item for which to retrieve display text.</param>
       </Docs>
@@ -352,12 +376,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the edit style used by the <see cref="M:System.ComponentModel.Design.CollectionEditor.EditValue(System.ComponentModel.ITypeDescriptorContext,System.IServiceProvider,System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> enumeration value indicating the provided editing style. If the method is not supported in the specified context, this method will return the <see cref="F:System.Drawing.Design.UITypeEditorEditStyle.None" /> identifier.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
       </Docs>
@@ -376,12 +403,15 @@
         <Parameter Name="editValue" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of objects containing the specified collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array containing the collection objects, or an empty object array if the specified collection does not inherit from <see cref="T:System.Collections.ICollection" />.</para>
+        </returns>
         <param name="editValue">
           <attribution license="cc4" from="Microsoft" modified="false" />The collection to edit. </param>
       </Docs>
@@ -404,12 +434,15 @@
         <Parameter Name="instance" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a list containing the given object</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.ArrayList" /> which contains the individual objects to be created.</para>
+        </returns>
         <param name="instance">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.ArrayList" /> returned as an object.</param>
       </Docs>
@@ -424,12 +457,15 @@
         <Parameter Name="serviceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the requested service, if it is available.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the service, or null if the service cannot be found.</para>
+        </returns>
         <param name="serviceType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of service to retrieve. </param>
       </Docs>
@@ -493,7 +529,6 @@
         <Parameter Name="value" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If setting requires that a new object be created, the new object is returned. Otherwise, the <paramref name="editValue" /> parameter is returned.</para>
@@ -502,6 +537,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the specified array as the items of the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created collection object or, otherwise, the collection indicated by the <paramref name="editValue" /> parameter.</para>
+        </returns>
         <param name="editValue">
           <attribution license="cc4" from="Microsoft" modified="false" />The collection to edit. </param>
         <param name="value">
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ComponentDesigner.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ComponentDesigner.xml
index 735378ef696..65458520ae0 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ComponentDesigner.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ComponentDesigner.xml
@@ -236,7 +236,6 @@
       </Parameters>
       <Docs>
         <param name="service">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default implementation of this method requests the service from the site of the component.</para>
@@ -245,6 +244,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to retrieve the specified type of service from the design mode site of the designer's component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object implementing the requested service, or null if the service cannot be resolved.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -406,12 +409,15 @@
         <Parameter Name="toInvoke" Type="System.ComponentModel.Design.ComponentDesigner" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.ComponentModel.InheritanceAttribute" /> of the specified <see cref="T:System.ComponentModel.Design.ComponentDesigner" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ComponentModel.InheritanceAttribute" /> of the specified designer.</para>
+        </returns>
         <param name="toInvoke">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.ComponentDesigner" /> whose inheritance attribute to retrieve. </param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DateTimeEditor.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DateTimeEditor.xml
index 332292dbf65..e04a0c91196 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DateTimeEditor.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DateTimeEditor.xml
@@ -46,12 +46,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Edits the specified object value using the editor style provided by GetEditorStyle. A service provider is provided so that any required editing services can be obtained.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new value of the object. If the value of the object hasn't changed, this should return the same object it was passed.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A type descriptor context that can be used to provide additional context information. </param>
         <param name="provider">
@@ -74,12 +77,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the editing style of the <see cref="Overload:System.ComponentModel.Design.DateTimeEditor.EditValue" /> method. If the method is not supported, this will return None.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enum value indicating the provided editing style.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A type descriptor context that can be used to provide additional context information. </param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignSurface.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignSurface.xml
index 93c52d3bb8e..cb9182c4410 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignSurface.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignSurface.xml
@@ -404,7 +404,6 @@
         <Parameter Name="componentType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.DesignSurface.CreateComponent(System.Type)" /> method is called by the design surface’s <see cref="Overload:System.ComponentModel.Design.IDesignerHost.CreateComponent" /> method to create an instance of a component. The component should be created and added to the public container on the design surface.</para>
@@ -413,6 +412,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created component.</para>
+        </returns>
         <param name="componentType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of component to create.</param>
       </Docs>
@@ -431,7 +434,6 @@
         <Parameter Name="rootDesigner" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.DesignSurface.CreateDesigner(System.ComponentModel.IComponent,System.Boolean)" /> method is called by the design surface’s <see cref="T:System.ComponentModel.IContainer" /> when a component is added to the container. This method creates a designer, but does not initialize it. When it returns, the designer is initialized by the container.</para>
@@ -443,6 +445,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a designer when a component is added to the container.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the requested designer, or null if no matching designer could be found.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component for which the designer should be created.</param>
         <param name="rootDesigner">
@@ -462,7 +468,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="type" /> is an <see cref="T:System.ComponentModel.IComponent" />, <see cref="M:System.ComponentModel.Design.DesignSurface.CreateInstance(System.Type)" /> searches for a constructor of type <see cref="T:System.ComponentModel.IContainer" /> first, followed by an empty constructor.</para>
@@ -471,6 +476,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the given type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created object.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to create.</param>
       </Docs>
@@ -488,7 +497,6 @@
         <Parameter Name="owningComponent" Type="System.ComponentModel.IComponent" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adding a component to a nested container creates its designer and makes it eligible for all services available from the design surface. Components added to nested containers do not participate in serialization. </para>
@@ -497,6 +505,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a container suitable for nesting controls or components.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The nested container.</para>
+        </returns>
         <param name="owningComponent">
           <attribution license="cc4" from="Microsoft" modified="false" />The component that manages the nested container.</param>
       </Docs>
@@ -515,7 +527,6 @@
         <Parameter Name="containerName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adding a component to a nested container creates its designer and makes it eligible for all services available from the design surface. Components added to nested containers do not participate in serialization. </para>
@@ -525,6 +536,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a container suitable for nesting controls or components.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The nested container.</para>
+        </returns>
         <param name="owningComponent">
           <attribution license="cc4" from="Microsoft" modified="false" />The component that manages the nested container.</param>
         <param name="containerName">
@@ -663,7 +678,6 @@
         <Parameter Name="serviceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.DesignSurface.GetService(System.Type)" /> method retrieves a service in the design surface’s service container. In addition, this will forward to any service provider that was given to the design surface at construction time.</para>
@@ -672,6 +686,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a service from the service container.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that implements, or is a derived class of, <paramref name="serviceType" />, or null if the service does not exist in the service container.</para>
+        </returns>
         <param name="serviceType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of service to retrieve. </param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignSurfaceCollection.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignSurfaceCollection.xml
index 086152ef71d..2bcf325d96e 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignSurfaceCollection.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignSurfaceCollection.xml
@@ -78,12 +78,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that can iterate through the <see cref="T:System.ComponentModel.Design.DesignSurfaceCollection" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.ComponentModel.Design.DesignSurfaceCollection" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Item">
@@ -207,7 +210,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.ComponentModel.Design.DesignSurfaceCollection" /> instance is cast to an <see cref="T:System.Collections.IEnumerator" /> interface.</para>
@@ -216,6 +218,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see the <see cref="M:System.Collections.IEnumerable.GetEnumerator" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.ComponentModel.Design.DesignSurfaceCollection" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignSurfaceManager.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignSurfaceManager.xml
index c8cb3966a9a..427098a2704 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignSurfaceManager.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignSurfaceManager.xml
@@ -110,12 +110,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of a design surface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new design surface instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateDesignSurface">
@@ -131,7 +134,6 @@
         <Parameter Name="parentProvider" Type="System.IServiceProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you want to conveniently add additional per-designer services, use the <paramref name="parentProvider" /> parameter to provide a service provider for this design surface. The <see cref="M:System.ComponentModel.Design.DesignSurfaceManager.CreateDesignSurface(System.IServiceProvider)" /> method creates a merged service provider that can satisfy service requests from both the given service provider as well as the <see cref="T:System.ComponentModel.Design.DesignSurfaceManager" /> itself. The <see cref="M:System.ComponentModel.Design.DesignSurfaceManager.CreateDesignSurface(System.IServiceProvider)" /> method then passes this service provider into the <see cref="M:System.ComponentModel.Design.DesignSurfaceManager.CreateDesignSurfaceCore(System.IServiceProvider)" /> method.</para>
@@ -141,6 +143,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of a design surface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new design surface instance.</para>
+        </returns>
         <param name="parentProvider">
           <attribution license="cc4" from="Microsoft" modified="false" />A parent service provider. A new merged service provider will be created that will first ask this provider for a service, and then delegate any failures to the design surface manager object. This merged provider will be passed into the <see cref="M:System.ComponentModel.Design.DesignSurfaceManager.CreateDesignSurfaceCore(System.IServiceProvider)" /> method.</param>
       </Docs>
@@ -158,7 +164,6 @@
         <Parameter Name="parentProvider" Type="System.IServiceProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.DesignSurfaceManager.CreateDesignSurfaceCore(System.IServiceProvider)" /> method is called by both <see cref="Overload:System.ComponentModel.Design.DesignSurfaceManager.CreateDesignSurface" /> methods. It is the implementation that actually creates the design surface. The default implementation just returns a new <see cref="T:System.ComponentModel.Design.DesignSurface" />. You may override this method to provide a custom object that derives from the <see cref="T:System.ComponentModel.Design.DesignSurface" /> class.</para>
@@ -167,6 +172,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implementation that creates the design surface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new design surface instance.</para>
+        </returns>
         <param name="parentProvider">
           <attribution license="cc4" from="Microsoft" modified="false" />A service provider to pass to the design surface. This is either an instance of <see cref="T:System.ComponentModel.Design.DesignSurfaceManager" /> or an object that implements <see cref="T:System.IServiceProvider" />, and represents a merge between the service provider of the <see cref="T:System.ComponentModel.Design.DesignSurfaceManager" /> class and an externally passed provider.</param>
       </Docs>
@@ -294,7 +303,6 @@
       </Parameters>
       <Docs>
         <param name="service">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.DesignSurfaceManager.GetService(System.Type)" /> method forwards to any service provider that was given to the design surface manager at construction time.</para>
@@ -303,6 +311,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a service in the design surface manager’s service container.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that implements, or is a derived class of, the given service type; otherwise, null if the service does not exist in the service container.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SelectionChanged">
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionItemCollection.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionItemCollection.xml
index ce74b942a15..a679e718c7b 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionItemCollection.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionItemCollection.xml
@@ -45,12 +45,15 @@
         <Parameter Name="value" Type="System.ComponentModel.Design.DesignerActionItem" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the supplied <see cref="T:System.ComponentModel.Design.DesignerActionItem" /> to the current collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ComponentModel.Design.DesignerActionItemCollection" /> index at which the value has been added.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.DesignerActionItem" />  to add.</param>
       </Docs>
@@ -68,12 +71,15 @@
         <Parameter Name="value" Type="System.ComponentModel.Design.DesignerActionItem" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.ComponentModel.Design.DesignerActionItemCollection" /> contains a specific element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ComponentModel.Design.DesignerActionItemCollection" /> contains the specified value; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.DesignerActionItem" /> to locate in the <see cref="T:System.ComponentModel.Design.DesignerActionItemCollection" />.</param>
       </Docs>
@@ -116,12 +122,15 @@
         <Parameter Name="value" Type="System.ComponentModel.Design.DesignerActionItem" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of a specific item in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="value" /> within the entire <see cref="T:System.ComponentModel.Design.DesignerActionItemCollection" />, if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.DesignerActionItem" /> to locate in the collection.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionList.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionList.xml
index 3d923c64317..ac1225e2d5b 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionList.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionList.xml
@@ -103,12 +103,15 @@
         <Parameter Name="serviceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that represents a service provided by the component associated with the <see cref="T:System.ComponentModel.Design.DesignerActionList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents a service provided by the <see cref="T:System.ComponentModel.Component" />. This value is null if the <see cref="T:System.ComponentModel.Component" /> does not provide the specified service.</para>
+        </returns>
         <param name="serviceType">
           <attribution license="cc4" from="Microsoft" modified="false" />A service provided by the <see cref="T:System.ComponentModel.Component" />.</param>
       </Docs>
@@ -124,7 +127,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The virtual <see cref="M:System.ComponentModel.Design.DesignerActionList.GetSortedActionItems" /> method is implemented to return, in the expected display order, a collection of objects derived from the <see cref="T:System.ComponentModel.Design.DesignerActionItem" /> class. These items can be of the following specific types.</para>
@@ -196,6 +198,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the collection of <see cref="T:System.ComponentModel.Design.DesignerActionItem" /> objects contained in the list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.Design.DesignerActionItem" /> array that contains the items in this list.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionListCollection.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionListCollection.xml
index fb29221f7be..cad858d6441 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionListCollection.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionListCollection.xml
@@ -109,7 +109,6 @@
         <Parameter Name="value" Type="System.ComponentModel.Design.DesignerActionList" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The new element is added to the end of the internal list.</para>
@@ -118,6 +117,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the supplied <see cref="T:System.ComponentModel.Design.DesignerActionList" /> to the current collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position into which the new element is inserted into the collection's internal list.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.DesignerActionList" /> to add.</param>
       </Docs>
@@ -187,7 +190,6 @@
         <Parameter Name="value" Type="System.ComponentModel.Design.DesignerActionList" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A match is determined by value, not identity, comparison.</para>
@@ -196,6 +198,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the collection contains a specific value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the specified value; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.DesignerActionList" /> to search for.</param>
       </Docs>
@@ -241,7 +247,6 @@
         <Parameter Name="value" Type="System.ComponentModel.Design.DesignerActionList" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Internally, the <see cref="T:System.ComponentModel.Design.DesignerActionListCollection" /> class uses a <see cref="T:System.Collections.ArrayList" /> to contain its collection of <see cref="T:System.ComponentModel.Design.DesignerActionList" /> objects.</para>
@@ -250,6 +255,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of a specific item in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of <paramref name="value" /> if found in the internal list; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.DesignerActionList" /> to locate in the collection.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionService.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionService.xml
index cc3d7df861e..ab94def19d1 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionService.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionService.xml
@@ -178,7 +178,6 @@
         <Parameter Name="comp" Type="System.ComponentModel.IComponent" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.DesignerActionService.Contains(System.ComponentModel.IComponent)" /> method only recognizes push-model smart tags, which are associated to a component with the <see cref="Overload:System.ComponentModel.Design.DesignerActionService.Add" /> method.</para>
@@ -188,6 +187,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current smart tag service manages the action lists for the specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the component is managed by the current service; otherwise, false.</para>
+        </returns>
         <param name="comp">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.IComponent" /> to search for.</param>
       </Docs>
@@ -336,7 +339,6 @@
         <Parameter Name="component" Type="System.ComponentModel.IComponent" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.DesignerActionService.GetComponentActions(System.ComponentModel.IComponent)" /> method is equivalent to a call to the <see cref="M:System.ComponentModel.Design.DesignerActionService.GetComponentActions(System.ComponentModel.IComponent,System.ComponentModel.Design.ComponentActionsType)" /> method using a <paramref name="type" /> parameter of <see cref="F:System.ComponentModel.Design.ComponentActionsType.All" />. Therefore, the collection returned will contain both the push and pull lists of smart tags.</para>
@@ -346,6 +348,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the collection of smart tag item lists associated with a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The collection of smart tags for the specified component.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component that the smart tags are associated with.</param>
       </Docs>
@@ -364,7 +370,6 @@
         <Parameter Name="type" Type="System.ComponentModel.Design.ComponentActionsType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This version of the overloaded <see cref="Overload:System.ComponentModel.Design.DesignerActionService.GetComponentActions" /> method filters on the <paramref name="type" /> parameter, which can have one of the following values. </para>
@@ -413,6 +418,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the collection of smart tag item lists of the specified type associated with a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The collection of smart tags of the specified type for the specified component.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component that the smart tags are associated with.</param>
         <param name="type">
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionUIService.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionUIService.xml
index 5f8612a9603..b996fcd53b9 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionUIService.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerActionUIService.xml
@@ -183,12 +183,15 @@
         <Parameter Name="component" Type="System.ComponentModel.IComponent" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether to automatically show the smart tag panel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true to automatically show the smart tag panel; otherwise, false.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.IComponent" /> to automatically show.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerCommandSet.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerCommandSet.xml
index 99570964dc6..b155779cb27 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerCommandSet.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/DesignerCommandSet.xml
@@ -116,7 +116,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Although the base implementation always returns null, the overridden version supplied by the programmer should return a collection of command objects of the type described by <paramref name="name" />. The base implementation of the <see cref="P:System.ComponentModel.Design.DesignerCommandSet.Verbs" /> and <see cref="P:System.ComponentModel.Design.DesignerCommandSet.ActionLists" /> properties specify the following values and meanings for this parameter.</para>
@@ -153,6 +152,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of command objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection that contains the specified type—either <see cref="T:System.ComponentModel.Design.DesignerActionList" /> or <see cref="T:System.ComponentModel.Design.DesignerVerb" />—of command objects. The base implementation always returns null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of collection to return, indicating either a <see cref="T:System.ComponentModel.Design.DesignerActionListCollection" /> or a <see cref="T:System.ComponentModel.Design.DesignerVerbCollection" />.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/EventBindingService.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/EventBindingService.xml
index 92dbfcab72d..9f148c991bb 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/EventBindingService.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/EventBindingService.xml
@@ -58,7 +58,6 @@
       </Parameters>
       <Docs>
         <param name="eventDescriptor">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The name returned by the <see cref="M:System.ComponentModel.Design.EventBindingService.CreateUniqueMethodName(System.ComponentModel.IComponent,System.ComponentModel.EventDescriptor)" /> method must be compatible with the script language being used and it must not conflict with any other name in your code.</para>
@@ -67,6 +66,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a unique method name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The unique method name.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component for which the method name will be created.</param>
       </Docs>
@@ -116,7 +119,6 @@
       </Parameters>
       <Docs>
         <param name="eventDescriptor">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Each string returned in the collection is the method name of a method whose signature is compatible with the delegate contained in <paramref name="e" />. <see cref="M:System.ComponentModel.Design.EventBindingService.GetCompatibleMethods(System.ComponentModel.EventDescriptor)" /> should return an empty collection if no names are compatible.</para>
@@ -125,6 +127,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of names of compatible methods.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of strings that are names of compatible methods.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetService">
@@ -141,12 +147,15 @@
       </Parameters>
       <Docs>
         <param name="service">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the requested service from the service provider.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to the service specified by <paramref name="serviceType" />, or null if the requested service is not available.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ShowCode">
@@ -160,7 +169,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.EventBindingService.ShowCode" /> method does not display any particular code; generally it displays the last code the user typed. </para>
@@ -169,6 +177,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays user code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if it is possible to display the code; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ShowCode">
@@ -184,7 +196,6 @@
         <Parameter Name="lineNumber" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Line numbers are one-based.</para>
@@ -193,6 +204,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays the user code at the given line number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if it is possible to display the code; otherwise, false.</para>
+        </returns>
         <param name="lineNumber">
           <attribution license="cc4" from="Microsoft" modified="false" />The line number to show.</param>
       </Docs>
@@ -212,7 +227,6 @@
         <Parameter Name="methodName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.EventBindingService.ShowCode(System.ComponentModel.IComponent,System.ComponentModel.EventDescriptor,System.String)" /> method displays the body of the user code with the given method name.</para>
@@ -221,6 +235,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays the user code for the specified method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if it is possible to display the code; otherwise, false.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to which the method is bound.</param>
         <param name="e">
@@ -244,12 +262,15 @@
       </Parameters>
       <Docs>
         <param name="eventDescriptor">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a unique name for an event-handler method for the specified component and event.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The recommended name for the event-handler method for this event.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component instance the event is connected to.</param>
       </Docs>
@@ -268,7 +289,6 @@
       </Parameters>
       <Docs>
         <param name="eventDescriptor">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Each string returned in the collection is the method name of a method whose signature is compatible with the delegate contained in <paramref name="e" />. <see cref="M:System.ComponentModel.Design.EventBindingService.GetCompatibleMethods(System.ComponentModel.EventDescriptor)" /> should return an empty collection if no names are compatible.</para>
@@ -277,6 +297,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of event-handler methods that have a method signature compatible with the specified event.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of strings that are names of compatible methods.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.Design.IEventBindingService.GetEvent">
@@ -292,12 +316,15 @@
         <Parameter Name="property" Type="System.ComponentModel.PropertyDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <see cref="T:System.ComponentModel.EventDescriptor" /> for the event that the specified property descriptor represents, if it represents an event.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptor" /> for the event that the property represents, or null if the property does not represent an event.</para>
+        </returns>
         <param name="property">
           <attribution license="cc4" from="Microsoft" modified="false" />The property that represents an event.</param>
       </Docs>
@@ -315,12 +342,15 @@
         <Parameter Name="events" Type="System.ComponentModel.EventDescriptorCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a set of event descriptors to a set of property descriptors.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.ComponentModel.PropertyDescriptor" /> objects that describe the event set.</para>
+        </returns>
         <param name="events">
           <attribution license="cc4" from="Microsoft" modified="false" />The events to convert to properties.</param>
       </Docs>
@@ -339,12 +369,15 @@
       </Parameters>
       <Docs>
         <param name="eventDescriptor">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a single event descriptor to a property descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptor" /> that describes the event.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.Design.IEventBindingService.ShowCode">
@@ -358,12 +391,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays the user code for the designer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the code is displayed; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.Design.IEventBindingService.ShowCode">
@@ -379,12 +415,15 @@
         <Parameter Name="lineNumber" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays the user code for the designer at the specified line.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the code is displayed; otherwise, false.</para>
+        </returns>
         <param name="lineNumber">
           <attribution license="cc4" from="Microsoft" modified="false" />The line number to place the caret on.</param>
       </Docs>
@@ -404,12 +443,15 @@
       </Parameters>
       <Docs>
         <param name="eventDescriptor">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays the user code for the specified event.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the code is displayed; otherwise, false.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component that the event is connected to.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/IComponentDesignerStateService.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/IComponentDesignerStateService.xml
index a70106c0965..622af5c251c 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/IComponentDesignerStateService.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/IComponentDesignerStateService.xml
@@ -35,12 +35,15 @@
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a state item specified by the key for the given component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The designer state for <paramref name="component" /> specified by <paramref name="key" />.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component for which to retrieve the designer state item.</param>
         <param name="key">
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/InheritanceService.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/InheritanceService.xml
index 863fa33d7b3..0fec620ecef 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/InheritanceService.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/InheritanceService.xml
@@ -163,7 +163,6 @@
         <Parameter Name="component" Type="System.ComponentModel.IComponent" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the component is not inherited, this method returns the value <see cref="F:System.ComponentModel.InheritanceAttribute.NotInherited" />. Otherwise, it returns the inheritance attribute for this component.</para>
@@ -172,6 +171,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the inheritance attribute of the specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.InheritanceAttribute" /> that describes the level of inheritance that this component comes from.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to retrieve the inheritance attribute for. </param>
       </Docs>
@@ -191,12 +194,15 @@
         <Parameter Name="component" Type="System.ComponentModel.IComponent" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether to ignore the specified member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified member should be included in the set of inherited components; otherwise, false.</para>
+        </returns>
         <param name="member">
           <attribution license="cc4" from="Microsoft" modified="false" />The member to check. This member is either a <see cref="T:System.Reflection.FieldInfo" /> or a <see cref="T:System.Reflection.MethodInfo" />. </param>
         <param name="component">
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/LocalizationExtenderProvider.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/LocalizationExtenderProvider.xml
index 91738cce0b7..ba2b9205edc 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/LocalizationExtenderProvider.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/LocalizationExtenderProvider.xml
@@ -81,12 +81,15 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether this object can provide its extender properties to the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this object can provide extender properties to the specified object; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to receive the extender properties. </param>
       </Docs>
@@ -156,7 +159,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns the current resource culture used to access resource data for the specified object.</para>
@@ -165,6 +167,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the current resource culture for the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Globalization.CultureInfo" /> indicating the resource variety.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to get the current resource culture for. </param>
       </Docs>
@@ -191,12 +197,15 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the default resource culture to use when initializing the values of a localized object at design time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Globalization.CultureInfo" /> indicating the resource culture to use to initialize the values of the specified object.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to get the resource culture for. </param>
       </Docs>
@@ -226,12 +235,15 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified object supports resource localization.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified object supports resource localization; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to check for localization support. </param>
       </Docs>
@@ -336,12 +348,15 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified object must have its localizable values persisted in a resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the localizable values should be persisted in resources; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to get the language support persistence flag for. </param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/MenuCommandService.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/MenuCommandService.xml
index 957f304a974..1c3597b3170 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/MenuCommandService.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/MenuCommandService.xml
@@ -233,12 +233,15 @@
         <Parameter Name="commandID" Type="System.ComponentModel.Design.CommandID" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the <see cref="T:System.ComponentModel.Design.MenuCommand" /> associated with the given command ID.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ComponentModel.Design.MenuCommand" /> associated with the given command; otherwise, null if the command is not found.</para>
+        </returns>
         <param name="commandID">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.CommandID" /> to find.</param>
       </Docs>
@@ -257,12 +260,15 @@
         <Parameter Name="id" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the <see cref="T:System.ComponentModel.Design.MenuCommand" /> associated with the given command.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ComponentModel.Design.MenuCommand" /> associated with the given command; otherwise, null if the command is not found.</para>
+        </returns>
         <param name="guid">
           <attribution license="cc4" from="Microsoft" modified="false" />The GUID of the command.</param>
         <param name="id">
@@ -282,12 +288,15 @@
         <Parameter Name="guid" Type="System.Guid" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the command list for a given GUID.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.ICollection" /> of commands.</para>
+        </returns>
         <param name="guid">
           <attribution license="cc4" from="Microsoft" modified="false" />The GUID of the command list.</param>
       </Docs>
@@ -305,12 +314,15 @@
         <Parameter Name="serviceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a reference to the requested service.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to <paramref name="serviceType" />; otherwise, null if the service is not found.</para>
+        </returns>
         <param name="serviceType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the service to retrieve.</param>
       </Docs>
@@ -328,7 +340,6 @@
         <Parameter Name="commandID" Type="System.ComponentModel.Design.CommandID" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The local form is first searched for the given command ID. If it is found, it is invoked. Otherwise, the command ID is passed to the global environment command handler, if one is available.</para>
@@ -337,6 +348,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes the given command on the local form or in the global environment.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if the command was found; otherwise, false.</para>
+        </returns>
         <param name="commandID">
           <attribution license="cc4" from="Microsoft" modified="false" />The command to invoke.</param>
       </Docs>
@@ -356,7 +371,6 @@
       </Parameters>
       <Docs>
         <param name="commandID">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The local form is first searched for the given command ID. If it is found, it is invoked. Otherwise, the command ID is passed to the global environment command handler, if one is available.</para>
@@ -365,6 +379,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes the given command with the given parameter on the local form or in the global environment.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if the command was found; otherwise, false.</para>
+        </returns>
         <param name="arg">
           <attribution license="cc4" from="Microsoft" modified="false" />A parameter for the invocation.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/MultilineStringEditor.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/MultilineStringEditor.xml
index f4abc7ee9a6..1ae92249ac8 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/MultilineStringEditor.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/MultilineStringEditor.xml
@@ -47,12 +47,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Edits the specified object value using the edit style provided by <see cref="M:System.Drawing.Design.ImageEditor.GetEditStyle(System.ComponentModel.ITypeDescriptorContext)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new value of the object. If the value of the object has not changed, this method should return the same object passed to it.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
         <param name="provider">
@@ -74,12 +77,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the editing style of the <see cref="M:System.Drawing.Design.ImageEditor.EditValue(System.ComponentModel.ITypeDescriptorContext,System.IServiceProvider,System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> enumeration value indicating the supported editing style.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
       </Docs>
@@ -97,12 +103,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this editor supports painting a representation of an object's value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>false, indicating that this <see cref="T:System.Drawing.Design.UITypeEditor" /> does not display a visual representation in the Properties Window.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ObjectSelectorEditor.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ObjectSelectorEditor.xml
index a4f491f1924..e431ea88a8e 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ObjectSelectorEditor.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/ObjectSelectorEditor.xml
@@ -84,7 +84,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A service provider is provided so that the editor can obtain any required services.</para>
@@ -93,6 +92,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Edits the value of the specified object using the editor style indicated by <see cref="Overload:System.ComponentModel.Design.ObjectSelectorEditor.GetEditStyle" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new value of the object. If the value of the object has not changed, the method should return the same object it was passed.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information.</param>
         <param name="provider">
@@ -115,12 +118,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Object" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Object" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to compare with the current <see cref="T:System.Object" />.</param>
       </Docs>
@@ -162,12 +168,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the editor style used by the <see cref="Overload:System.ComponentModel.Design.ObjectSelectorEditor.EditValue" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> value that indicates the style of editor used by <see cref="Overload:System.ComponentModel.Design.ObjectSelectorEditor.EditValue" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" />  that can be used to gain additional context information.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/UndoEngine.xml b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/UndoEngine.xml
index 17e964dadc7..3777e2c9da3 100644
--- a/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/UndoEngine.xml
+++ b/mcs/class/System.Design/Documentation/en/System.ComponentModel.Design/UndoEngine.xml
@@ -142,7 +142,6 @@
         <Parameter Name="primary" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default implementation of the <see cref="M:System.ComponentModel.Design.UndoEngine.CreateUndoUnit(System.String,System.Boolean)" /> method simply returns a new <see cref="T:System.ComponentModel.Design.UndoEngine.UndoUnit" />. </para>
@@ -152,6 +151,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ComponentModel.Design.UndoEngine.UndoUnit" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ComponentModel.Design.UndoEngine.UndoUnit" /> with a specified name.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the unit to create. </param>
         <param name="primary">
@@ -247,12 +250,15 @@
         <Parameter Name="serviceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the requested service.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The requested service, if found.</para>
+        </returns>
         <param name="serviceType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of service to retrieve.</param>
       </Docs>
@@ -270,12 +276,15 @@
         <Parameter Name="serviceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the requested service.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The requested service, or null if the requested service is not found.</para>
+        </returns>
         <param name="serviceType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of service to retrieve.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Data.Design/MethodSignatureGenerator.xml b/mcs/class/System.Design/Documentation/en/System.Data.Design/MethodSignatureGenerator.xml
index ecad95679d3..ef8e8183fce 100644
--- a/mcs/class/System.Design/Documentation/en/System.Data.Design/MethodSignatureGenerator.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Data.Design/MethodSignatureGenerator.xml
@@ -97,12 +97,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the code member method representing the database query, as generated by the typed dataset generator.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.CodeDom.CodeMemberMethod" /> object representing the database query, as generated by the typed dataset generator.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GenerateMethodSignature">
@@ -116,12 +119,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representing the database query method signature, as generated by the typed dataset generator.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representing the database query method signature, as generated by the typed dataset generator.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GenerateUpdatingMethods">
@@ -135,12 +141,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a code type declaration containing the Insert, Update, and Delete methods associated with the database query.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.CodeTypeDeclaration" /> object containing the Insert, Update, and Delete methods associated with the database query.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsGetMethod">
diff --git a/mcs/class/System.Design/Documentation/en/System.Data.Design/TypedDataSetGenerator.xml b/mcs/class/System.Design/Documentation/en/System.Data.Design/TypedDataSetGenerator.xml
index 39894de4bf3..b64510fe9e1 100644
--- a/mcs/class/System.Design/Documentation/en/System.Data.Design/TypedDataSetGenerator.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Data.Design/TypedDataSetGenerator.xml
@@ -35,7 +35,6 @@
         <Parameter Name="codeProvider" Type="System.CodeDom.Compiler.CodeDomProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a strongly typed <see cref="T:System.Data.DataSet" />. The dataset is created in the namespace indicated in the <paramref name="codeNamespace" /> parameter, and the dataset is generated in the managed programming language indicated in the <paramref name="codeProvider" /> parameter.</para>
@@ -44,6 +43,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a strongly typed <see cref="T:System.Data.DataSet" /> based on an existing <see cref="T:System.Data.DataSet" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A strongly typed <see cref="T:System.Data.DataSet" />.</para>
+        </returns>
         <param name="dataSet">
           <attribution license="cc4" from="Microsoft" modified="false" />The source <see cref="T:System.Data.DataSet" /> that specifies the metadata for the typed <see cref="T:System.Data.DataSet" />.</param>
         <param name="codeNamespace">
@@ -68,7 +71,6 @@
         <Parameter Name="codeProvider" Type="System.CodeDom.Compiler.CodeDomProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -80,6 +82,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a strongly typed <see cref="T:System.Data.DataSet" /> based on the provided input file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A strongly typed <see cref="T:System.Data.DataSet" />.</para>
+        </returns>
         <param name="inputFileContent">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents the XML schema to base the <see cref="T:System.Data.DataSet" /> on.</param>
         <param name="compileUnit">
@@ -118,6 +124,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a strongly typed <see cref="T:System.Data.DataSet" /> based on the provided input file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A strongly typed <see cref="T:System.Data.DataSet" />.</para>
+        </returns>
         <param name="inputFileContent">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents the XML schema to base the <see cref="T:System.Data.DataSet" /> on.</param>
         <param name="compileUnit">
@@ -158,6 +168,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a strongly typed <see cref="T:System.Data.DataSet" /> based on the provided input file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A strongly typed <see cref="T:System.Data.DataSet" />.</para>
+        </returns>
         <param name="inputFileContent">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents the XML schema to base the <see cref="T:System.Data.DataSet" /> on.</param>
         <param name="compileUnit">
@@ -238,7 +252,6 @@
         <Parameter Name="inputFileContent" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -250,6 +263,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the first provider name found in the provided input file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the specific provider for this <see cref="T:System.Data.DataSet" />.</para>
+        </returns>
         <param name="inputFileContent">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents the XML schema to base the <see cref="T:System.Data.DataSet" /> on.</param>
       </Docs>
@@ -268,7 +285,6 @@
         <Parameter Name="tableName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -280,6 +296,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the provider name for the <paramref name="tableName" /> in the input file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the provider name for the specific table passed in to the <paramref name="tableName" /> parameter.</para>
+        </returns>
         <param name="inputFileContent">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents the XML schema to base the <see cref="T:System.Data.DataSet" /> on.</param>
         <param name="tableName">
diff --git a/mcs/class/System.Design/Documentation/en/System.Data.Design/TypedDataSetSchemaImporterExtension.xml b/mcs/class/System.Design/Documentation/en/System.Data.Design/TypedDataSetSchemaImporterExtension.xml
index 1d49cab94f6..13758874320 100644
--- a/mcs/class/System.Design/Documentation/en/System.Data.Design/TypedDataSetSchemaImporterExtension.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Data.Design/TypedDataSetSchemaImporterExtension.xml
@@ -73,7 +73,6 @@
         <Parameter Name="codeProvider" Type="System.CodeDom.Compiler.CodeDomProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -85,6 +84,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates internal type mapping information for an element defined in an XML schema document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a <see cref="T:System.String" /> representing the name of the typed dataset class.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />XMLSchemaType</param>
         <param name="context">
@@ -124,7 +127,6 @@
         <Parameter Name="codeProvider" Type="System.CodeDom.Compiler.CodeDomProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -136,6 +138,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates internal type mapping information for an element defined in an XML schema document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a <see cref="T:System.String" /> representing the name of the typed dataset class.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> representing the name of the schema to import.</param>
         <param name="namespaceName">
diff --git a/mcs/class/System.Design/Documentation/en/System.Diagnostics.Design/LogConverter.xml b/mcs/class/System.Design/Documentation/en/System.Diagnostics.Design/LogConverter.xml
index d17f453f167..ea71d486aa2 100644
--- a/mcs/class/System.Design/Documentation/en/System.Diagnostics.Design/LogConverter.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Diagnostics.Design/LogConverter.xml
@@ -49,12 +49,15 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether this converter can convert an object of the given type to the type of this converter, using the specified context. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the conversion can be performed; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
         <param name="sourceType">
@@ -77,12 +80,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given object to a string, using the specified context and culture information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An T:System.ComponentModel.ITypeDescriptorContext  that provides a format context.</param>
         <param name="culture">
@@ -105,7 +111,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -114,6 +119,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of standard values for the data type this validator is designed for.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> that holds a standard set of valid values, or null if the data type does not support a standard set of values.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
@@ -132,7 +141,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -141,6 +149,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether this object supports a standard set of values that can be picked from a list using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true because <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> should be called to find a common set of values the object supports. This method never returns false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Resources.Tools/StronglyTypedResourceBuilder.xml b/mcs/class/System.Design/Documentation/en/System.Resources.Tools/StronglyTypedResourceBuilder.xml
index 18bf330d0cd..69aa248866e 100644
--- a/mcs/class/System.Design/Documentation/en/System.Resources.Tools/StronglyTypedResourceBuilder.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Resources.Tools/StronglyTypedResourceBuilder.xml
@@ -156,7 +156,6 @@
         <Parameter Name="provider" Type="System.CodeDom.Compiler.CodeDomProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <paramref name="key" /> parameter is a valid string of characters, that string is returned. If the <paramref name="key" /> parameter is an invalid string or a string that contains invalid characters, the <see cref="M:System.Resources.Tools.StronglyTypedResourceBuilder.VerifyResourceName(System.String,System.CodeDom.Compiler.CodeDomProvider)" /> method attempts to generate a valid string based on the <paramref name="key" /> and <paramref name="provider" /> parameters. If a valid string can be generated, that string is returned; otherwise, null is returned.</para>
@@ -170,6 +169,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a valid resource string based on the specified input string and code provider.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A valid resource name derived from the <paramref name="key" /> parameter. Any invalid tokens are replaced with the underscore (_) character, or null if the derived string still contains invalid characters according to the language specified by the <paramref name="provider" /> parameter.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to verify and, if necessary, convert to a valid resource name.</param>
         <param name="provider">
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/AdRotatorDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/AdRotatorDesigner.xml
index 7df68e95473..319d5deecdc 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/AdRotatorDesigner.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/AdRotatorDesigner.xml
@@ -45,12 +45,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates the markup that is used to render the control on the design surface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The markup that represents the control on the design surface.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseDataBoundControlDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseDataBoundControlDesigner.xml
index 13c903dd0fa..98d3a28f7d3 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseDataBoundControlDesigner.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseDataBoundControlDesigner.xml
@@ -50,7 +50,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The implementation of the <see cref="M:System.Web.UI.Design.WebControls.BaseDataBoundControlDesigner.ConnectToDataSource" /> method typically involves unhooking events from the previous data source, and then attaching new events to the new data source.</para>
@@ -59,6 +58,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, typically unhooks events from the previous data source, and then attaches new events to the new data source. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a connection to a new data source was performed, typically; false if the old and new data sources are the same.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateDataSource">
@@ -200,7 +203,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Web.UI.Design.WebControls.BaseDataBoundControlDesigner" /> class retrieves sample data that is used for binding purposes at design time before rendering the control. If the control is not data bound, it calls the <see cref="M:System.Web.UI.Design.WebControls.BaseDataBoundControlDesigner.GetEmptyDesignTimeHtml" /> method. If there is an error rendering the control, it calls the <see cref="M:System.Web.UI.Design.WebControls.BaseDataBoundControlDesigner.GetErrorDesignTimeHtml(System.Exception)" /> method.</para>
@@ -209,6 +211,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates the markup that is used to render the control at design time. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The markup used to render the control at design time.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetEmptyDesignTimeHtml">
@@ -222,7 +228,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Web.UI.Design.WebControls.BaseDataBoundControlDesigner" /> class retrieves sample data that is used for binding purposes at design time before rendering the control. The empty design-time control renders as a placeholder that contains the type name and control name.</para>
@@ -231,6 +236,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides the markup that is used to render the control at design time if the control is empty or if the data source cannot be retrieved. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The markup used to render the control at design time with an empty data source.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetErrorDesignTimeHtml">
@@ -246,7 +255,6 @@
         <Parameter Name="e" Type="System.Exception" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The error design-time control renders as a placeholder that contains the type name, the control name, and a message describing the error.</para>
@@ -255,6 +263,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides the markup that is used to render the control at design time when an error has occurred.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The markup used to render the control at design time when an error has occurred.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Exception" /> that was thrown.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseDataListComponentEditor.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseDataListComponentEditor.xml
index accf497f9bf..1743dea4396 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseDataListComponentEditor.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseDataListComponentEditor.xml
@@ -56,7 +56,6 @@
         <Parameter Name="parent" Type="System.Windows.Forms.IWin32Window" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.Web.UI.Design.WebControls.BaseDataListComponentEditor.EditComponent" /> method gets a <see cref="T:System.Type" /> array of page control types by using the <see cref="M:System.Windows.Forms.Design.WindowsFormsComponentEditor.GetComponentEditorPages" /> method. It creates a <see cref="T:System.Windows.Forms.Design.ComponentEditorForm" /> object, and then calls its <see cref="M:System.Windows.Forms.Design.ComponentEditorForm.ShowForm" /> method to display the component editor.</para>
@@ -65,6 +64,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Edits the specified component by using the specified context descriptor and parent window.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true the component was successfully edited; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that can be used to gain additional context information. </param>
         <param name="obj">
@@ -85,7 +88,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The initial page is specified when the <see cref="T:System.Web.UI.Design.WebControls.BaseDataListComponentEditor" /> object is created. </para>
@@ -94,6 +96,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the initial page to display in the component editor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the initial page in the array.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseDataListDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseDataListDesigner.xml
index 80418019bfa..33764ec276a 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseDataListDesigner.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseDataListDesigner.xml
@@ -232,7 +232,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.WebControls.BaseDataListDesigner.GetSelectedDataSource" /> method uses the <see cref="M:System.Web.UI.Design.DesignTimeData.GetSelectedDataSource(System.ComponentModel.IComponent,System.String,System.String)" /> method to construct a data source from the object that is specified by the <see cref="P:System.Web.UI.WebControls.BaseDataList.DataSource" /> and <see cref="P:System.Web.UI.WebControls.BaseDataList.DataMember" /> properties of the associated control derived from the <see cref="T:System.Web.UI.WebControls.BaseDataList" /> class.</para>
@@ -241,6 +240,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the data source component from the associated control container, resolved to a specific data member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object implementing an <see cref="T:System.Collections.IEnumerable" /> interface containing the design-time <see cref="P:System.Web.UI.WebControls.BaseDataList.DataSource" /> of the associated control, resolved to the <see cref="P:System.Web.UI.WebControls.BaseDataList.DataMember" /> parameter; otherwise, null if a data source is not found.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -255,7 +258,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.WebControls.BaseDataListDesigner.GetSelectedDataSource" /> method uses the <see cref="M:System.Web.UI.Design.DesignTimeData.GetSelectedDataSource(System.ComponentModel.IComponent,System.String)" /> method to construct a data source from the object that is specified by the <see cref="P:System.Web.UI.WebControls.BaseDataList.DataSource" /> property of the associated control derived from the <see cref="T:System.Web.UI.WebControls.BaseDataList" /> class.</para>
@@ -264,6 +266,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the data source component from the associated control container.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object implementing an <see cref="T:System.Collections.IEnumerable" /> interface containing the design-time <see cref="P:System.Web.UI.WebControls.BaseDataList.DataSource" /> property of the associated control; otherwise, null if a data source is not found.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -281,7 +287,6 @@
       </Parameters>
       <Docs>
         <param name="template_name">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.WebControls.BaseDataListDesigner.GetTemplateContainerDataSource(System.String)" /> method calls the <see cref="M:System.Web.UI.Design.WebControls.BaseDataListDesigner.GetResolvedSelectedDataSource" /> method to construct a data source from the object that is specified by the <see cref="P:System.Web.UI.WebControls.BaseDataList.DataSource" /> and <see cref="P:System.Web.UI.WebControls.BaseDataList.DataMember" /> properties of the associated control derived from <see cref="T:System.Web.UI.WebControls.BaseDataList" /> class.</para>
@@ -290,6 +295,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the data source of the template's container.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that implements an <see cref="T:System.Collections.IEnumerable" /> interface containing a design-time <see cref="P:System.Web.UI.WebControls.BaseDataList.DataSource" /> property.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseValidatorDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseValidatorDesigner.xml
index fcba77b14be..ff129c501bc 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseValidatorDesigner.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/BaseValidatorDesigner.xml
@@ -49,7 +49,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="P:System.Web.UI.WebControls.BaseValidator.ErrorMessage" /> or <see cref="P:System.Web.UI.WebControls.BaseValidator.Text" /> property of the associated control that is derived from the <see cref="T:System.Web.UI.WebControls.BaseValidator" /> class is an empty string (""), or if the <see cref="P:System.Web.UI.WebControls.BaseValidator.Display" /> property is set to the <see cref="F:System.Web.UI.WebControls.ValidatorDisplay.None" /> field, the <see cref="M:System.Web.UI.Design.WebControls.BaseValidatorDesigner.GetDesignTimeHtml" /> method sets the <see cref="P:System.Web.UI.WebControls.BaseValidator.ErrorMessage" /> property to the control ID, which is enclosed in brackets ([]) and sets the <see cref="P:System.Web.UI.WebControls.BaseValidator.Display" /> property to the <see cref="F:System.Web.UI.WebControls.ValidatorDisplay.Static" /> field. The <see cref="M:System.Web.UI.Design.WebControls.BaseValidatorDesigner.GetDesignTimeHtml" /> then calls the <see cref="M:System.Web.UI.Design.ControlDesigner.GetDesignTimeHtml" /> base method to generate the markup, and restores the control properties to their original values, if necessary.</para>
@@ -58,6 +57,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the markup that is used to render the associated control at design time. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the markup used to render the <see cref="T:System.Web.UI.WebControls.BaseValidator" /> at design time.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/ButtonDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/ButtonDesigner.xml
index 701a505f847..53952372285 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/ButtonDesigner.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/ButtonDesigner.xml
@@ -48,7 +48,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.WebControls.ButtonDesigner.GetDesignTimeHtml" /> method replaces the <see cref="P:System.Web.UI.WebControls.Button.Text" /> property with the <see cref="P:System.Web.UI.Control.ID" /> property of the <see cref="T:System.Web.UI.WebControls.Button" /> control if the <see cref="P:System.Web.UI.WebControls.Button.Text" /> contains no displayable characters. Then, the <see cref="M:System.Web.UI.Design.WebControls.ButtonDesigner.GetDesignTimeHtml" /> method calls its base method, <see cref="M:System.Web.UI.Design.ControlDesigner.GetDesignTimeHtml" />, which calls into the <see cref="M:System.Web.UI.Control.RenderControl(System.Web.UI.HtmlTextWriter)" /> method to generate the markup.</para>
@@ -57,6 +56,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the markup that is used to render the associated control at design time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the markup used to render the <see cref="T:System.Web.UI.WebControls.Button" /> at design time.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/CheckBoxDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/CheckBoxDesigner.xml
index d52d9ba748f..f21b4f0bf70 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/CheckBoxDesigner.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/CheckBoxDesigner.xml
@@ -45,7 +45,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="P:System.Web.UI.WebControls.Button.Text" /> property is empty or consists only of white space, then the generated HTML contains the <see cref="P:System.Web.UI.Control.ID" /> of the check box control; otherwise, the generated HTML contains the contents of the control's <see cref="P:System.Web.UI.WebControls.Button.Text" /> property.</para>
@@ -55,6 +54,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the markup that is used to represent the control at design time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The markup that is used to represent the control at design time.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/DataBoundControlDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/DataBoundControlDesigner.xml
index e082de7cf76..ac83372f4c9 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/DataBoundControlDesigner.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/DataBoundControlDesigner.xml
@@ -71,12 +71,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Disconnects events from the previous data source and connects them to the current data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the data-bound control connected to a new data source; false if the data source did not change.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateDataSource">
@@ -227,12 +230,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the design-time data source from either the associated DataSourceDesigner or the DataSource property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that implements an <see cref="T:System.Collections.IEnumerable" /> interface referencing the design-time data source.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetSampleDataSource">
@@ -246,12 +252,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets dummy sample data to render the data-bound control on the design surface if sample data cannot be created from the DataSourceDesigner or DataSource properties.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that implements the <see cref="T:System.Collections.IEnumerable" /> interface containing dummy sample data used to render the data-bound control on the design surface.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="PreFilterProperties">
@@ -375,7 +384,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.Design.WebControls.DataBoundControlDesigner" /> instance is cast to an <see cref="T:System.Web.UI.Design.IDataSourceProvider" /> interface.</para>
@@ -384,6 +392,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Web.UI.Design.IDataSourceProvider.GetResolvedSelectedDataSource" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The selected data member from the selected data source, if the control allows the user to select an IListSource object (such as a <see cref="T:System.Data.DataSet" /> object) for the data source, and provides a <see cref="P:System.Web.UI.WebControls.DataBoundControl.DataMember" /> property to select a particular list (or <see cref="T:System.Data.DataTable" /> object) within the data source.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.Design.IDataSourceProvider.GetSelectedDataSource">
@@ -397,7 +409,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.Design.WebControls.DataBoundControlDesigner" /> instance is cast to an <see cref="T:System.Web.UI.Design.IDataSourceProvider" /> interface.</para>
@@ -406,6 +417,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Web.UI.Design.IDataSourceProvider.GetSelectedDataSource" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object implementing an <see cref="T:System.Collections.IEnumerable" /> interface containing the design-time <see cref="P:System.Web.UI.WebControls.BaseDataBoundControl.DataSource" /> property of the associated control, or null if a data source is not found.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="UseDataSourcePickerActionList">
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/DataListComponentEditor.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/DataListComponentEditor.xml
index b7fc6450ce0..e857e38b070 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/DataListComponentEditor.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/DataListComponentEditor.xml
@@ -88,12 +88,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of <see cref="T:System.Type" /> objects corresponding to the pages that can be edited using this editor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Type" /> objects corresponding to the pages that can be edited using this editor.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/DataProviderNameConverter.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/DataProviderNameConverter.xml
index 20ba179710b..a141c73f81e 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/DataProviderNameConverter.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/DataProviderNameConverter.xml
@@ -52,7 +52,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -63,6 +62,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a list of the available ActiveX® Data Objects (ADO) for the .NET Framework (ADO.NET) provider names.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> containing the names of the available ADO.NET providers.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An object implementing the <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides information about a context to a type converter so that the type converter can perform a conversion.</param>
       </Docs>
@@ -80,7 +83,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -91,6 +93,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the returned ActiveX® Data Objects (ADO) for the .NET Framework (ADO.NET) provider names are an exclusive list of possible values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An object implementing the <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides information about a context to a type converter so that the type converter can perform a conversion.</param>
       </Docs>
@@ -108,7 +114,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -118,6 +123,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this object returns a standard set of ActiveX® Data Objects (ADO) for the .NET Framework (ADO.NET) provider names that can be picked from a list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always true.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An object implementing the <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides information about a context to a type converter so that the type converter can perform a conversion.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/HyperLinkDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/HyperLinkDesigner.xml
index ef7b3fc64de..5435dd05fa7 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/HyperLinkDesigner.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/HyperLinkDesigner.xml
@@ -50,7 +50,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.WebControls.HyperLinkDesigner.GetDesignTimeHtml" /> method generates the design-time markup for the associated <see cref="T:System.Web.UI.WebControls.HyperLink" /> control. The method first saves local copies of the <see cref="P:System.Web.UI.WebControls.HyperLink.Text" />, <see cref="P:System.Web.UI.WebControls.HyperLink.NavigateUrl" />, and <see cref="P:System.Web.UI.WebControls.HyperLink.ImageUrl" /> properties, as well as the <see cref="P:System.Web.UI.Control.Controls" /> child collection. It provides default values for these properties if the original values are null or blank. The <see cref="M:System.Web.UI.Design.WebControls.HyperLinkDesigner.GetDesignTimeHtml" /> method then calls the <see cref="M:System.Web.UI.Design.TextControlDesigner.GetDesignTimeHtml" /> base method to generate the markup and restores the properties and child control collection to their original values, if necessary.</para>
@@ -59,6 +58,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the markup that is used to render the associated control at design time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the markup used to render the associated hyperlink control at design time.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/RegexTypeEditor.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/RegexTypeEditor.xml
index 2fbc22a475c..e43e81e2a3b 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/RegexTypeEditor.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/RegexTypeEditor.xml
@@ -46,12 +46,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Edits the value of the given regular expression object using the given service provider and context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new value of the object. If the value of the object hasn't changed, this method returns the same object it received.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can provide additional context information.</param>
         <param name="provider">
@@ -74,12 +77,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the editor style used by the <see cref="M:System.Web.UI.Design.WebControls.RegexTypeEditor.EditValue(System.ComponentModel.ITypeDescriptorContext,System.IServiceProvider,System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> value that indicates the editor style used by the method.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/RepeaterDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/RepeaterDesigner.xml
index 5b7e5899c72..bc7c8c5a74c 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/RepeaterDesigner.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/RepeaterDesigner.xml
@@ -113,12 +113,15 @@
       </Parameters>
       <Docs>
         <param name="minimum_rows">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns design-time sample data based on the <see cref="M:System.Web.UI.Design.WebControls.RepeaterDesigner.GetResolvedSelectedDataSource" /> method and using the specified number of rows.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerable" /> object containing sample data for use at design time.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -138,12 +141,15 @@
       <Docs>
         <param name="selected_data_source">To be added.</param>
         <param name="minimum_rows">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns design-time sample data based on the provided data and using the specified number of rows.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerable" /> object containing sample data for use at design time.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -158,12 +164,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the HTML markup to be used for the design-time representation of the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Design-time HTML markup.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -222,7 +231,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.WebControls.RepeaterDesigner.GetResolvedSelectedDataSource" /> method uses the <see cref="M:System.Web.UI.Design.WebControls.RepeaterDesigner.GetSelectedDataSource" /> method to construct a data source from the object that is specified by the <see cref="P:System.Web.UI.Design.WebControls.RepeaterDesigner.DataSource" /> and <see cref="P:System.Web.UI.Design.WebControls.RepeaterDesigner.DataMember" /> properties.</para>
@@ -231,6 +239,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the selected data member from the selected data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerable" /> that contains a collection of values used to supply design-time data. The default value is null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -245,7 +257,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.WebControls.RepeaterDesigner.GetSelectedDataSource" /> method uses the <see cref="M:System.Web.UI.Design.DesignTimeData.GetSelectedDataSource(System.ComponentModel.IComponent,System.String)" /> method to construct a data source from the object that is specified by the <see cref="P:System.Web.UI.Design.WebControls.RepeaterDesigner.DataSource" /> property.</para>
@@ -254,6 +265,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the selected data source component from the container of the associated <see cref="T:System.Web.UI.WebControls.Repeater" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The selected data source; null if a data source is not found or if a data source with the selected name does not exist.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/TableCellsCollectionEditor.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/TableCellsCollectionEditor.xml
index 4797dbb88c2..316e8791896 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/TableCellsCollectionEditor.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/TableCellsCollectionEditor.xml
@@ -46,12 +46,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether multiple table cells can be selected at the same time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if multiple cells can be selected at the same time; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -69,12 +72,15 @@
       </Parameters>
       <Docs>
         <param name="item_type">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the editor for use with the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object of the specified type.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/TableDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/TableDesigner.xml
index b2233633c7b..268ae16386e 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/TableDesigner.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/TableDesigner.xml
@@ -42,7 +42,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.WebControls.TableDesigner.GetDesignTimeHtml" /> method ensures that the table has at least one row and cell and that the cells contain some text for display at design time.</para>
@@ -51,6 +50,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the HTML that is used to represent the control at design time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The HTML used to represent the control at design time.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -65,12 +68,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member overrides <see cref="M:System.Web.UI.Design.ControlDesigner.GetPersistInnerHtml" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The persistable inner HTML markup of the control.</para>
+          <para />
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/TableRowsCollectionEditor.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/TableRowsCollectionEditor.xml
index 04d5d68f0bb..bd9bf55657b 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/TableRowsCollectionEditor.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/TableRowsCollectionEditor.xml
@@ -46,12 +46,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether multiple instances may be selected.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if multiple items can be selected at once; otherwise, false. This implementation always returns false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -69,12 +72,15 @@
       </Parameters>
       <Docs>
         <param name="item_type">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object of the specified type.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/XmlDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/XmlDesigner.xml
index 9db23765107..004cbc5d9f2 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/XmlDesigner.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design.WebControls/XmlDesigner.xml
@@ -93,12 +93,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the HTML that is used to fill an empty control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The HTML used to fill an empty control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/AppSettingsExpressionEditor.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/AppSettingsExpressionEditor.xml
index 3ffce919f0a..bc93a66a666 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/AppSettingsExpressionEditor.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/AppSettingsExpressionEditor.xml
@@ -57,7 +57,6 @@
         <Parameter Name="serviceProvider" Type="System.IServiceProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -69,6 +68,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates an application setting expression string and provides the design-time value for a control property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object referenced by <paramref name="expression" />, if the expression evaluation succeeded; otherwise, null.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An application setting expression string to evaluate. <paramref name="expression" /> does not include the AppSettings expression prefix.</param>
         <param name="parseTimeData">
@@ -93,7 +96,6 @@
         <Parameter Name="serviceProvider" Type="System.IServiceProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -103,6 +105,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an expression editor sheet for an application setting expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.Design.ExpressionEditorSheet" /> implementation that defines the application setting expression properties.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression string set for a control property, used to initialize the expression editor sheet. <paramref name="expression" /> does not include the AppSettings expression prefix.</param>
         <param name="serviceProvider">
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ColorBuilder.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ColorBuilder.xml
index b97c3e19414..a063055d847 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ColorBuilder.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ColorBuilder.xml
@@ -34,7 +34,6 @@
         <Parameter Name="initialColor" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned string, if other than null, indicates a color in a valid HTML color format. Valid formats include named colors and color codes in RGB format (#RRGGBB).</para>
@@ -43,6 +42,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Starts a color editor to build an HTML color property value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The color value, represented as a string in an HTML color format, or null if the builder service could not be retrieved.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.IComponent" /> whose site is to be used to access design-time services. </param>
         <param name="owner">
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ConnectionStringEditor.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ConnectionStringEditor.xml
index 5ddfd0ab619..9b0464755bb 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ConnectionStringEditor.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ConnectionStringEditor.xml
@@ -51,7 +51,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.Web.UI.Design.ConnectionStringEditor.EditValue" /> method starts the user interface for editing the <paramref name="value" /> object. The designer host calls the <see cref="Overload:System.Web.UI.Design.ConnectionStringEditor.EditValue" /> method when you edit the value of a property that the connection string editor is associated with. The input service provider is used to obtain any editing services that are required within the <see cref="Overload:System.Web.UI.Design.ConnectionStringEditor.EditValue" /> method.</para>
@@ -62,6 +61,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Edits the value of the specified object by using the specified service provider and context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The selected connection expression, as a string object; otherwise, if a connection expression was not selected, the same <paramref name="value" /> that was passed in.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> to use to gain additional context information.</param>
         <param name="provider">
@@ -83,7 +86,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>By default, the <see cref="Overload:System.Web.UI.Design.ConnectionStringEditor.GetEditStyle" /> method of the <see cref="T:System.Web.UI.Design.ConnectionStringEditor" /> class returns the <see cref="F:System.Drawing.Design.UITypeEditorEditStyle.Modal" /> value. If an <see cref="T:System.ComponentModel.Design.Data.IDataEnvironment" /> service implementation is supported in the specified context, the <see cref="Overload:System.Web.UI.Design.ConnectionStringEditor.GetEditStyle" /> method returns the <see cref="F:System.Drawing.Design.UITypeEditorEditStyle.DropDown" /> value.</para>
@@ -93,6 +95,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the editing style that is associated with the connection string editor for the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> enumeration value that indicates the editing style for the provided user interface.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> to use to gain additional context information.</param>
       </Docs>
@@ -110,7 +116,6 @@
         <Parameter Name="instance" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.ConnectionStringEditor.GetProviderName(System.Object)" /> method gets the provider name for the current instance of the <see cref="T:System.Web.UI.Design.ConnectionStringEditor" /> class. For example, in the <see cref="T:System.Web.UI.Design.WebControls.SqlDataSourceConnectionStringEditor" /> class, which is derived from <see cref="T:System.Web.UI.Design.ConnectionStringEditor" /> class, the <see cref="M:System.Web.UI.Design.ConnectionStringEditor.GetProviderName(System.Object)" /> method returns the provider name.</para>
@@ -119,6 +124,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the provider name for the provided instance of the <see cref="T:System.Web.UI.Design.ConnectionStringEditor" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always an empty string ("").</para>
+        </returns>
         <param name="instance">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.Design.ConnectionStringEditor" /> or an instance of a derived class.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ConnectionStringsExpressionEditor.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ConnectionStringsExpressionEditor.xml
index b81db4d7c8c..dcb8d2c65ec 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ConnectionStringsExpressionEditor.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ConnectionStringsExpressionEditor.xml
@@ -51,7 +51,6 @@
         <Parameter Name="serviceProvider" Type="System.IServiceProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -63,6 +62,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates a connection string expression and provides the design-time value for a control property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object referenced by the evaluated expression string if the expression evaluation succeeded; otherwise, null.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />A connection string expression to evaluate. The expression does not include the ConnectionStrings expression prefix.</param>
         <param name="parseTimeData">
@@ -87,7 +90,6 @@
         <Parameter Name="serviceProvider" Type="System.IServiceProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -97,6 +99,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an expression editor sheet for a connection string expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.Design.ExpressionEditorSheet" /> instance that defines the connection string expression properties.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression string set for a control property, used to initialize the expression editor sheet. The expression does not include the ConnectionStrings expression prefix.</param>
         <param name="serviceProvider">
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ContainerControlDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ContainerControlDesigner.xml
index 461ea21a2ea..5e703323b08 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ContainerControlDesigner.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ContainerControlDesigner.xml
@@ -161,7 +161,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.ContainerControlDesigner.GetDesignTimeCssAttributes" /> method returns a collection of style attributes for the design-time representation of the control.</para>
@@ -172,6 +171,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the collection of style attributes for the control at design time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of style attributes applied to the control on the design surface. The style attribute names are keys used to access the style attribute values in the <see cref="T:System.Collections.IDictionary" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetDesignTimeHtml">
@@ -187,7 +190,6 @@
         <Parameter Name="regions" Type="System.Web.UI.Design.DesignerRegionCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.Design.ContainerControlDesigner.GetDesignTimeHtml(System.Web.UI.Design.DesignerRegionCollection)" /> method to get the HTML for the control. Child controls that are contained in the editable design region are rendered using their associated control designers.</para>
@@ -197,6 +199,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the HTML markup that is used to represent the control at design time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An HTML markup string that represents the control.</para>
+        </returns>
         <param name="regions">
           <attribution license="cc4" from="Microsoft" modified="false" />A collection of designer regions.</param>
       </Docs>
@@ -214,7 +220,6 @@
         <Parameter Name="region" Type="System.Web.UI.Design.EditableDesignerRegion" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Web.UI.Design.ContainerControlDesigner" /> class implements a single designer region instead of a collection of designer regions. Therefore, the <paramref name="region" /> parameter is ignored, and the <see cref="M:System.Web.UI.Design.ContainerControlDesigner.GetEditableDesignerRegionContent(System.Web.UI.Design.EditableDesignerRegion)" /> method returns the content for the single designer region that is contained in the control designer.</para>
@@ -223,6 +228,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the content for the editable region of the control at design time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The persisted content of the region contained within the <see cref="T:System.Web.UI.Design.ContainerControlDesigner" />.</para>
+        </returns>
         <param name="region">
           <attribution license="cc4" from="Microsoft" modified="false" />An editable design region contained within the control.</param>
       </Docs>
@@ -238,7 +247,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.ContainerControlDesigner.GetPersistenceContent" /> method returns null to indicate that the <see cref="T:System.Web.UI.Design.ContainerControlDesigner" /> class does not have persisted inner content.</para>
@@ -247,6 +255,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the persistable content of the control at design time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SetEditableDesignerRegionContent">
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ControlDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ControlDesigner.xml
index bdb262513db..1a039867fc2 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ControlDesigner.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ControlDesigner.xml
@@ -222,7 +222,6 @@
         <Parameter Name="errorMessage" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.Design.ControlDesigner.CreateErrorDesignTimeHtml(System.String)" /> method to create HTML markup to display an error message for a control at design time. The value for <paramref name="errorMessage" /> specifies a localized string that is displayed to the user of the control at design time.</para>
@@ -241,6 +240,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates HTML markup to display a specified error message at design time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An HTML markup string that contains the specified error message.</para>
+        </returns>
         <param name="errorMessage">
           <attribution license="cc4" from="Microsoft" modified="false" />The error message to include in the generated HTML markup.</param>
       </Docs>
@@ -259,7 +262,6 @@
         <Parameter Name="e" Type="System.Exception" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.Design.ControlDesigner.CreateErrorDesignTimeHtml(System.String,System.Exception)" /> method to provide simple HTML markup that can be used to display error and exception details for a control at design time. The value for <paramref name="errorMessage" /> specifies a localized string that is displayed to the user of the control at design time.</para>
@@ -278,6 +280,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the HTML markup to display a specified exception error message at design time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>HTML markup that contains the specified <paramref name="errorMessage" /> and <paramref name="e" />.</para>
+        </returns>
         <param name="errorMessage">
           <attribution license="cc4" from="Microsoft" modified="false" />The error message to include in the generated HTML string.</param>
         <param name="e">
@@ -292,12 +298,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides a simple rectangular placeholder representation that displays the type and ID of the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains design-time HTML markup providing basic information about the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -314,12 +323,15 @@
         <Parameter Name="instruction" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides a simple rectangular placeholder representation that displays the type and ID of the control, and also additional specified instructions or information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains design-time HTML markup providing information about the control.</para>
+        </returns>
         <param name="instruction">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains text and markup to add to the HTML output. </param>
       </Docs>
@@ -339,12 +351,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a copy of the associated control for viewing or rendering on the design surface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Web server control.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DataBindingsEnabled">
@@ -457,12 +472,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the coordinates of the rectangle representing the boundaries for the control as displayed on the design surface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> object representing the boundaries for the control on the design surface relative to the control, not the document.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetDesignTimeHtml">
@@ -473,12 +491,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the HTML markup that is used to represent the control at design time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The HTML markup used to represent the control at design time.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -498,7 +519,6 @@
         <Parameter Name="regions" Type="System.Web.UI.Design.DesignerRegionCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The design host calls the <see cref="M:System.Web.UI.Design.ControlDesigner.GetDesignTimeHtml(System.Web.UI.Design.DesignerRegionCollection)" /> method to get the design-time HTML markup and the current list of control designer regions. Using the DesignerRegionCollection, the design host can then request the markup for each editable control designer region.</para>
@@ -508,6 +528,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the HTML markup to display the control and populates the collection with the current control designer regions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The design-time HTML markup for the associated control, including all control designer regions.</para>
+        </returns>
         <param name="regions">
           <attribution license="cc4" from="Microsoft" modified="false" />A collection of control designer regions for the associated control.</param>
       </Docs>
@@ -525,7 +549,6 @@
         <Parameter Name="serviceProvider" Type="System.IServiceProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A resource provider factory creates resource providers and resource writers, depending on the current settings in the system.web/globalization section of the configuration file (either the Machine.config or Web.config files for both global and local resources). If no globalization settings are found, the <paramref name="serviceProvider" /> parameter is used to create a <see cref="T:System.Web.UI.Design.DesignTimeResourceProviderFactory" /> object using the default implementation for the design host.</para>
@@ -535,6 +558,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an appropriate resource provider factory, depending on the globalization settings in the configuration file for the site.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.Design.DesignTimeResourceProviderFactory" /> object, if any are defined in the configuration file; otherwise, null.</para>
+        </returns>
         <param name="serviceProvider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IServiceProvider" /> object that can retrieve global and local services.</param>
       </Docs>
@@ -552,7 +579,6 @@
         <Parameter Name="region" Type="System.Web.UI.Design.EditableDesignerRegion" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default implementation of the <see cref="M:System.Web.UI.Design.ControlDesigner.GetEditableDesignerRegionContent(System.Web.UI.Design.EditableDesignerRegion)" /> method returns an empty string (""). </para>
@@ -562,6 +588,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the content for an editable region of the design-time view of the associated control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The persisted content for the region, if the control designer supports editable regions; otherwise, an empty string ("").</para>
+        </returns>
         <param name="region">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.EditableDesignerRegion" /> object to get content for.</param>
       </Docs>
@@ -574,7 +604,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default behavior of the <see cref="M:System.Web.UI.Design.ControlDesigner.GetEmptyDesignTimeHtml" /> method is to return a string that contains the name of the component. The <see cref="M:System.Web.UI.Design.ControlDesigner.GetEmptyDesignTimeHtml" /> method should be called in the implementation of the <see cref="M:System.Web.UI.Design.ControlDesigner.GetDesignTimeHtml" /> method when there is no design-time HTML markup.</para>
@@ -583,6 +612,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the HTML markup to represent a Web server control at design time that will have no visual representation at run time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The HTML markup used to represent a control at design time that would otherwise have no visual representation. The default is a rectangle that contains the type and ID of the component.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -599,7 +632,6 @@
         <Parameter Name="e" Type="System.Exception" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.ControlDesigner.GetErrorDesignTimeHtml(System.Exception)" /> method is typically called, if an exception is thrown in the <see cref="Overload:System.Web.UI.Design.ControlDesigner.GetDesignTimeHtml" /> method.</para>
@@ -608,6 +640,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the HTML markup that provides information about the specified exception. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The design-time HTML markup for the specified exception.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />The exception that occurred. </param>
       </Docs>
@@ -627,12 +663,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the persistable inner HTML markup of the control at design time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representing the persistable inner HTML markup for the associated control. The default is null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetPersistInnerHtml">
@@ -643,7 +682,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -654,6 +692,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the persistable inner HTML markup of the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The persistable inner HTML markup of the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -676,12 +718,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an object that contains the design-time markup for the content and regions of the associated control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.Design.ViewRendering" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetViewRendering">
@@ -697,12 +742,15 @@
         <Parameter Name="control" Type="System.Web.UI.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an object that contains the design-time markup for the content and regions of the specified control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.Design.ViewRendering" /> object.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.Control" /> object.</param>
       </Docs>
@@ -720,12 +768,15 @@
         <Parameter Name="designer" Type="System.Web.UI.Design.ControlDesigner" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an object that contains the design-time markup for the content and regions of the associated control for the specified control designer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.Design.ViewRendering" /> object.</para>
+        </returns>
         <param name="designer">
           <attribution license="cc4" from="Microsoft" modified="false" />A control designer that derives from <see cref="T:System.Web.UI.Design.ControlDesigner" />.</param>
       </Docs>
@@ -1033,7 +1084,6 @@
         <Parameter Name="propName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1044,6 +1094,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a value indicating whether the specified property on the associated control is data-bound.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if the property is data-bound; otherwise, false.</para>
+        </returns>
         <param name="propName">
           <attribution license="cc4" from="Microsoft" modified="false" />The property to test for data binding. </param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ControlParser.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ControlParser.xml
index 5080b162ac8..72db6f56e56 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ControlParser.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ControlParser.xml
@@ -32,7 +32,6 @@
         <Parameter Name="controlText" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.ControlParser.ParseControl(System.ComponentModel.Design.IDesignerHost,System.String)" /> method accesses the string representing the register directives on the ASP.NET Web page using the services of the designer host. Designer host services are acquired through the <see cref="P:System.Web.UI.Design.WebFormsRootDesigner.ReferenceManager" /> property of the <see cref="P:System.Web.UI.Design.ControlDesigner.RootDesigner" /> object, or if that is not available, the <see cref="T:System.Web.UI.Design.IWebFormReferenceManager" /> service.</para>
@@ -42,6 +41,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a control from the specified markup using the specified designer host.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.UI.Control" /> that controlText represents; otherwise, null, if the parser cannot build the control.</para>
+        </returns>
         <param name="designerHost">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.Design.IDesignerHost" /> instance that is the designer host for the page. </param>
         <param name="controlText">
@@ -64,7 +67,6 @@
         <Parameter Name="directives" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.ControlParser.ParseControl(System.ComponentModel.Design.IDesignerHost,System.String,System.String)" /> method accesses the string representing the register directives on the ASP.NET Web page using the services of the designer host. Designer host services are acquired through the <see cref="P:System.Web.UI.Design.WebFormsRootDesigner.ReferenceManager" /> property of the <see cref="P:System.Web.UI.Design.ControlDesigner.RootDesigner" /> object, or if that is not available, the <see cref="T:System.Web.UI.Design.IWebFormReferenceManager" /> service.</para>
@@ -74,6 +76,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a control from the specified markup using the specified designer host and directives.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.UI.Control" /> that <paramref name="controlText" /> represents.</para>
+        </returns>
         <param name="designerHost">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.Design.IDesignerHost" /> instance that is the designer host for the page.</param>
         <param name="controlText">
@@ -100,7 +106,6 @@
         <Parameter Name="controlText" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.ControlParser.ParseControls(System.ComponentModel.Design.IDesignerHost,System.String)" /> method accesses the string representing the register directives on the ASP.NET Web page using the services of the designer host. Designer host services are acquired through the <see cref="P:System.Web.UI.Design.WebFormsRootDesigner.ReferenceManager" /> property of the <see cref="P:System.Web.UI.Design.ControlDesigner.RootDesigner" /> object, or if that is not available, the <see cref="T:System.Web.UI.Design.IWebFormReferenceManager" /> service.</para>
@@ -110,6 +115,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an array of controls from the specified markup using the specified designer host.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Web.UI.Control" /> elements, parsed from <paramref name="controlText" />; otherwise, null, if the parser cannot build the controls.</para>
+        </returns>
         <param name="designerHost">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.Design.IDesignerHost" /> instance that is the designer host for the page.</param>
         <param name="controlText">
@@ -127,7 +136,6 @@
         <Parameter Name="templateText" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.ControlParser.ParseTemplate(System.ComponentModel.Design.IDesignerHost,System.String)" /> method accesses the string representing the register directives on the ASP.NET Web page using the services of the designer host. Designer host services are acquired through the <see cref="P:System.Web.UI.Design.WebFormsRootDesigner.ReferenceManager" /> property of the <see cref="P:System.Web.UI.Design.ControlDesigner.RootDesigner" /> object, or if that is not available, the <see cref="T:System.Web.UI.Design.IWebFormReferenceManager" /> service.</para>
@@ -136,6 +144,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Web.UI.ITemplate" /> interface from the specified template markup.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.ITemplate" /> instance created by parsing <paramref name="templateText" />.</para>
+        </returns>
         <param name="designerHost">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.Design.IDesignerHost" /> instance that is the designer host for the page. </param>
         <param name="templateText">
@@ -158,7 +170,6 @@
         <Parameter Name="directives" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.ControlParser.ParseTemplate(System.ComponentModel.Design.IDesignerHost,System.String,System.String)" /> method accesses the string representing the register directives on the ASP.NET Web page using the services of the designer host. Designer host services are acquired through the <see cref="P:System.Web.UI.Design.WebFormsRootDesigner.ReferenceManager" /> property of the <see cref="P:System.Web.UI.Design.ControlDesigner.RootDesigner" /> object, or if that is not available, the <see cref="T:System.Web.UI.Design.IWebFormReferenceManager" /> service.</para>
@@ -167,6 +178,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Parses the specified template markup and creates an <see cref="T:System.Web.UI.ITemplate" /> interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.ITemplate" /> instance created by parsing <paramref name="templateText" />.</para>
+        </returns>
         <param name="designerHost">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.Design.IDesignerHost" /> instance that is the designer host for the page. </param>
         <param name="templateText">
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ControlPersister.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ControlPersister.xml
index a29f8690c8f..dcbd7e1d163 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ControlPersister.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ControlPersister.xml
@@ -35,7 +35,6 @@
         <Parameter Name="control" Type="System.Web.UI.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method requires an <see cref="T:System.ComponentModel.Design.IDesignerHost" /> implementation to work correctly. This method uses the <see cref="P:System.Web.UI.Control.Site" /> of the specified control to retrieve the designer host.</para>
@@ -44,6 +43,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a string of data that represents the persisted form of the specified control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the persisted form of the control.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Control" /> to persist. </param>
       </Docs>
@@ -92,7 +95,6 @@
         <Parameter Name="host" Type="System.ComponentModel.Design.IDesignerHost" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method requires an <see cref="T:System.ComponentModel.Design.IDesignerHost" /> implementation to work correctly.</para>
@@ -101,6 +103,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a string of data that represents the persisted form of the specified control, using the specified designer host.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the persisted form of the control.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Control" /> to persist. </param>
         <param name="host">
@@ -154,7 +160,6 @@
         <Parameter Name="host" Type="System.ComponentModel.Design.IDesignerHost" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method requires an <see cref="T:System.ComponentModel.Design.IDesignerHost" /> implementation to work correctly.</para>
@@ -163,6 +168,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a string of data that can persist the inner properties of the specified control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the information to persist about the inner properties of the control.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to persist the inner properties of. </param>
         <param name="host">
@@ -219,7 +228,6 @@
         <Parameter Name="host" Type="System.ComponentModel.Design.IDesignerHost" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.ControlPersister.PersistTemplate(System.Web.UI.ITemplate,System.ComponentModel.Design.IDesignerHost)" /> method requires an <see cref="T:System.ComponentModel.Design.IDesignerHost" /> interface implementation in order to work correctly.</para>
@@ -228,6 +236,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a string of data that represents the persisted form of the specified template.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the persisted form of the template.</para>
+        </returns>
         <param name="template">
           <attribution license="cc4" from="Microsoft" modified="false" />The template to persist.</param>
         <param name="host">
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataBindingCollectionConverter.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataBindingCollectionConverter.xml
index 5e13787071f..5996bd4e240 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataBindingCollectionConverter.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataBindingCollectionConverter.xml
@@ -50,7 +50,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns an empty string if the <paramref name="destinationType" /> parameter is of type <see cref="T:System.String" />. Otherwise this method calls the <see cref="M:System.ComponentModel.TypeConverter.ConvertTo(System.Object,System.Type)" /> method of the base <see cref="T:System.ComponentModel.TypeConverter" /> class.</para>
@@ -59,6 +58,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a data binding collection to the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object produced by the type conversion. If the <paramref name="destinationType" /> parameter is of type <see cref="T:System.String" />, this method returns an empty string ("").</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that indicates the component or control to which the data binding collection belongs. </param>
         <param name="culture">
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataBindingCollectionEditor.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataBindingCollectionEditor.xml
index 0ca26fc908c..cbc92ca2eb6 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataBindingCollectionEditor.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataBindingCollectionEditor.xml
@@ -49,12 +49,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Edits the value of the specified data-binding collection using the specified service provider and context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new collection.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that identifies the component or control the collection belongs to. </param>
         <param name="provider">
@@ -77,7 +80,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This editor provides a modal editor style.</para>
@@ -86,6 +88,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the editor style used by the <see cref="M:System.Web.UI.Design.DataBindingCollectionEditor.EditValue(System.ComponentModel.ITypeDescriptorContext,System.IServiceProvider,System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> object that specifies the editor style of the component or control.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that identifies the component or control to retrieve the edit style for. </param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataColumnSelectionConverter.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataColumnSelectionConverter.xml
index d170e7828f6..4e209b79334 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataColumnSelectionConverter.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataColumnSelectionConverter.xml
@@ -60,7 +60,6 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call the <see cref="M:System.Web.UI.Design.DataColumnSelectionConverter.CanConvertFrom(System.ComponentModel.ITypeDescriptorContext,System.Type)" /> method to determine whether the <see cref="M:System.Web.UI.Design.DataColumnSelectionConverter.ConvertFrom(System.ComponentModel.ITypeDescriptorContext,System.Globalization.CultureInfo,System.Object)" /> method supports converting the source type.</para>
@@ -70,6 +69,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified source type can be converted to the type of the associated control property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" />  implementation that can be used to gain additional context information.</param>
         <param name="sourceType">
@@ -91,7 +94,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="value" /> is a string, then the string representation of <paramref name="value" /> is returned. If <paramref name="value" /> is null, an empty string ("") is returned. For all other values, a <see cref="T:System.NotSupportedException" /> exception is thrown. </para>
@@ -101,6 +103,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object to the type of the associated control property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> instance that represents the converted object.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" />  implementation that can be used to gain additional context information.</param>
         <param name="culture">
@@ -122,7 +128,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.DataColumnSelectionConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> method uses the <see cref="P:System.ComponentModel.ITypeDescriptorContext.Instance" /> property of the specified <paramref name="context" /> object to obtain an <see cref="T:System.ComponentModel.IComponent" /> implementation. If the <see cref="T:System.ComponentModel.IComponent" /> implementation is available, it is used to access the associated control at design time and retrieve the list of available values from the associated <see cref="T:System.Web.UI.WebControls.GridView" /> component.</para>
@@ -132,6 +137,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a list of available values that can be assigned to the associated control property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> instance containing available values for assignment to the associated control property.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" />  implementation that can be used to gain additional context information.</param>
       </Docs>
@@ -149,7 +158,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.Web.UI.Design.DataColumnSelectionConverter.GetStandardValuesExclusive" /> method for a <see cref="T:System.Web.UI.Design.DataColumnSelectionConverter" /> instance returns false, indicating that the list returned by the <see cref="Overload:System.Web.UI.Design.DataColumnSelectionConverter.GetStandardValues" /> method is not an exclusive list of all possible assignable values.</para>
@@ -158,6 +166,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether this converter returns a list containing all possible values that can be assigned to the associated control property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter returns a list containing all possible values that can be assigned to the associated control property; otherwise false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" />  implementation that can be used to gain additional context information.</param>
       </Docs>
@@ -175,7 +187,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.DataColumnSelectionConverter.GetStandardValuesSupported(System.ComponentModel.ITypeDescriptorContext)" /> method indicates whether the converter supports returning a list of available values through the <see cref="M:System.Web.UI.Design.DataColumnSelectionConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> method. </para>
@@ -185,6 +196,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether this converter returns a set of available values for assignment to a control property, within the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter returns a standard set of available values for assignment to the associated control property; otherwise false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" />  implementation that can be used to gain additional context information.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataFieldConverter.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataFieldConverter.xml
index 52a6270bfce..24fb89bb57a 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataFieldConverter.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataFieldConverter.xml
@@ -54,7 +54,6 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns true if the source type is a string. Otherwise, this method always returns false.</para>
@@ -63,6 +62,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the converter can convert an object of the specified source type to the native type of the converter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that can be used to gain additional context information. </param>
         <param name="sourceType">
@@ -85,12 +88,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object to the native type of the converter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the specified object after conversion.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that can be used to gain additional context information. </param>
         <param name="culture">
@@ -113,7 +119,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses the <see cref="T:System.Web.UI.Design.IDataSourceProvider" /> implementation on the component's designer to retrieve the selected data source.</para>
@@ -122,6 +127,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the data fields present within the selected data source if information about them is available.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> listing the standard accessible data sources.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object indicating the component or control to get values for. </param>
       </Docs>
@@ -140,7 +149,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the list is exclusive, such as in an enumeration data type, then no other values are valid. If the list is not exclusive, then there are other valid values besides the list of standard values that <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> provides.</para>
@@ -149,6 +157,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the collection of standard values returned from <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> is a list of all possible values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> returned from <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> is an exclusive list of all possible values that are valid; false if other values are possible.</para>
+          <para>As implemented in this class, this method always returns false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that can be used to gain additional context information. </param>
       </Docs>
@@ -167,12 +180,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the converter supports a standard set of values that can be picked from a list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> can be called to find a common set of values the object supports; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataMemberConverter.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataMemberConverter.xml
index 44f1afa06e2..cfe0750e98a 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataMemberConverter.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataMemberConverter.xml
@@ -54,12 +54,15 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the converter can convert an object of the specified source type to the native type of the converter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that can be used to gain additional context information. </param>
         <param name="sourceType">
@@ -82,12 +85,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object to the native type of the converter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the specified object after conversion.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that can be used to gain additional context information. </param>
         <param name="culture">
@@ -110,7 +116,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The converter uses the <see cref="T:System.Web.UI.Design.IDataSourceProvider" /> implementation of the associated component's designer to retrieve the current data source selection.</para>
@@ -119,6 +124,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the data members present within the selected data source, if information about them is available.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> listing the data members of the data source selected for the component. </para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object indicating the component or control to get values for. </param>
       </Docs>
@@ -137,7 +146,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the list is exclusive, such as in an enumeration data type, then no other values are valid. If the list is not exclusive, then there are other valid values besides the list of standard values that <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> provides.</para>
@@ -146,6 +154,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the collection of standard values returned from <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> is a list of all possible values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> returned from <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> is an exclusive list of all possible values that are valid; false if other values are possible.</para>
+          <para>As implemented in this class, this method always returns false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that provides a format context. </param>
       </Docs>
@@ -164,12 +177,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the converter supports a standard set of values that can be picked from a list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> should be called to find a common set of values the object supports; otherwise, false. This implementation always returns true.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that can be used to gain additional context information. </param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSetSchema.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSetSchema.xml
index c3c2136c7a8..30df011e5ba 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSetSchema.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSetSchema.xml
@@ -73,7 +73,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Each of the <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" /> objects returned by this method can be converted to a <see cref="T:System.Web.UI.Design.DataSetViewSchema" /> object.</para>
@@ -82,6 +81,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array containing information about each view in the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" /> objects.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSetViewSchema.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSetViewSchema.xml
index d707bb6404c..750e2103aa1 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSetViewSchema.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSetViewSchema.xml
@@ -73,7 +73,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.DataSetViewSchema.GetChildren" /> method inherited from <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" /> is not implemented in this class and always returns null.</para>
@@ -82,6 +81,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array representing the child views contained in the current view.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetFields">
@@ -95,7 +98,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.DataSetViewSchema.GetFields" /> method does not return information about hidden fields.</para>
@@ -104,6 +106,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array containing information about each data field in the view.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Web.UI.Design.IDataSourceFieldSchema" /> objects.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Name">
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceBooleanViewSchemaConverter.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceBooleanViewSchemaConverter.xml
index 24a1301b6c9..130396fbc24 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceBooleanViewSchemaConverter.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceBooleanViewSchemaConverter.xml
@@ -45,12 +45,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a list of available Boolean values that can be assigned to the associated field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of Boolean values.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceConverter.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceConverter.xml
index 5cd57eaf8b0..c98dca8d93c 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceConverter.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceConverter.xml
@@ -54,12 +54,16 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the converter can convert an object of the specified source type to the native type of the converter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the converter can perform the conversion; otherwise, false.</para>
+          <para>As implemented in this class, this method always returns false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
         <param name="sourceType">
@@ -82,12 +86,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object to the native type of the converter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the specified object after conversion.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
         <param name="culture">
@@ -110,7 +117,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The data sources that are accessible to the component are determined by retrieving a list of components from the designer, testing each component with the <see cref="M:System.Web.UI.Design.DataSourceConverter.IsValidDataSource(System.ComponentModel.IComponent)" /> method, and then returning the components that are valid data sources.</para>
@@ -119,6 +125,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the standard data sources accessible to the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> listing the standard accessible data sources.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> indicating the component or control to get values for. </param>
       </Docs>
@@ -137,7 +147,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the list is exclusive, such as in an enumeration data type, then no other values are valid. If the list is not exclusive, then there are other valid values besides the list of standard values that <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> provides.</para>
@@ -146,6 +155,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the collection of standard values returned from <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> is a list of all possible values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> returned from <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> is an exclusive list of all possible values; false if other values are possible.</para>
+          <para>As implemented in this class, this method always returns false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
       </Docs>
@@ -164,12 +178,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the converter supports a standard set of values that can be picked from a list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> should be called to find a common set of values the object supports; otherwise, false. This implementation always returns true.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
       </Docs>
@@ -191,7 +208,6 @@
         <Parameter Name="component" Type="System.ComponentModel.IComponent" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.DataSourceConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> method uses the <see cref="M:System.Web.UI.Design.DataSourceConverter.IsValidDataSource(System.ComponentModel.IComponent)" /> method to determine the components that are available as standard accessible data sources. For the <see cref="T:System.Web.UI.Design.DataSourceConverter" /> class, a valid data source is a component that implements the <see cref="T:System.Collections.IEnumerable" /> or <see cref="T:System.ComponentModel.IListSource" /> interface. </para>
@@ -200,6 +216,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified component is a valid data source for this converter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="component" /> implements <see cref="T:System.Collections.IEnumerable" /> or <see cref="T:System.ComponentModel.IListSource" />; otherwise, false.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to check as a valid data source.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceDesigner.xml
index 5a1132573f3..be25a687c69 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceDesigner.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceDesigner.xml
@@ -187,7 +187,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default implementation of the <see cref="M:System.Web.UI.Design.DataSourceDesigner.GetDesignTimeHtml" /> method returns the result from the base <see cref="M:System.Web.UI.Design.ControlDesigner.CreatePlaceHolderDesignTimeHtml" /> method.</para>
@@ -196,6 +195,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the HTML markup for displaying the associated data source control at design time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The markup for the design-time display.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetView">
@@ -211,7 +214,6 @@
         <Parameter Name="viewName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In derived classes, if <paramref name="viewName" /> does not exist, the <see cref="M:System.Web.UI.Design.DataSourceDesigner.GetView(System.String)" /> method should return null.</para>
@@ -220,6 +222,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a <see cref="T:System.Web.UI.Design.DesignerDataSourceView" /> object that is identified by the view name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This implementation always returns null.</para>
+        </returns>
         <param name="viewName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the view.</param>
       </Docs>
@@ -235,12 +241,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of the view names that are available in this data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of view names.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="OnDataSourceChanged">
@@ -370,7 +379,6 @@
         <Parameter Name="schema2" Type="System.Web.UI.Design.IDataSourceSchema" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Comparison of the two schemas is based on the views, as well as the names and types of the fields that are contained in the views. The <see cref="M:System.Web.UI.Design.DataSourceDesigner.SchemasEquivalent(System.Web.UI.Design.IDataSourceSchema,System.Web.UI.Design.IDataSourceSchema)" /> method can be used without an instance of the <see cref="T:System.Web.UI.Design.DataSourceDesigner" /> class.</para>
@@ -379,6 +387,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides a value that indicates whether two schemas are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if both schemas are equivalent; otherwise, false.</para>
+        </returns>
         <param name="schema1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first schema to compare (derived from the <see cref="T:System.Web.UI.Design.IDataSourceSchema" />).</param>
         <param name="schema2">
@@ -438,7 +450,6 @@
         <Parameter Name="viewSchema2" Type="System.Web.UI.Design.IDataSourceViewSchema" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.DataSourceDesigner.ViewSchemasEquivalent(System.Web.UI.Design.IDataSourceViewSchema,System.Web.UI.Design.IDataSourceViewSchema)" /> method can be used without an instance of the <see cref="T:System.Web.UI.Design.DataSourceDesigner" /> class.</para>
@@ -447,6 +458,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides a value that determines whether two schema views are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if both views are equivalent; otherwise, false. </para>
+        </returns>
         <param name="viewSchema1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first view to compare (derived from the <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" />).</param>
         <param name="viewSchema2">
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceViewSchemaConverter.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceViewSchemaConverter.xml
index 2bbed2230e7..f73080afb55 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceViewSchemaConverter.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DataSourceViewSchemaConverter.xml
@@ -60,7 +60,6 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call the <see cref="M:System.Web.UI.Design.DataSourceViewSchemaConverter.CanConvertFrom(System.ComponentModel.ITypeDescriptorContext,System.Type)" /> method to determine whether the <see cref="M:System.Web.UI.Design.DataSourceViewSchemaConverter.ConvertFrom(System.ComponentModel.ITypeDescriptorContext,System.Globalization.CultureInfo,System.Object)" /> method supports converting the source type.</para>
@@ -70,6 +69,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified source type can be converted to the type of the associated control property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> implementation that can be used to gain additional context information.</param>
         <param name="sourceType">
@@ -91,7 +94,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="value" /> is a string, then the string representation of <paramref name="value" /> is returned. If <paramref name="value" /> is null, an empty string ("") is returned. For all other specified values, a <see cref="T:System.NotSupportedException" /> exception is thrown. </para>
@@ -101,6 +103,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object to the type of the associated control property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> instance that represents the converted object.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" />  implementation that can be used to gain additional context information.</param>
         <param name="culture">
@@ -122,7 +128,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.DataSourceViewSchemaConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> method uses the <see cref="P:System.ComponentModel.ITypeDescriptorContext.Instance" /> property of the specified <paramref name="context" /> object to obtain an <see cref="T:System.Web.UI.IDataSourceViewSchemaAccessor" /> implementation. If the <see cref="T:System.Web.UI.IDataSourceViewSchemaAccessor" /> implementation is available, it is used to access the data source schema for the associated control at design time and retrieve the list of available fields from the associated data source schema view.</para>
@@ -132,6 +137,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a list of available values that can be assigned to the associated control property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> containing available values for assignment to the associated control property.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> implementation that can be used to gain additional context information.</param>
       </Docs>
@@ -150,12 +159,15 @@
         <Parameter Name="typeFilter" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a list of available values that can be assigned to the associated control property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> containing available values for assignment to the associated control property.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" />  implementation that can be used to gain additional context information.</param>
         <param name="typeFilter">
@@ -175,7 +187,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.Web.UI.Design.DataSourceViewSchemaConverter.GetStandardValuesExclusive" /> method for a <see cref="T:System.Web.UI.Design.DataSourceViewSchemaConverter" /> returns false, indicating that the list returned by the <see cref="Overload:System.Web.UI.Design.DataSourceViewSchemaConverter.GetStandardValues" /> method is not an exclusive list of all possible assignable values.</para>
@@ -184,6 +195,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether this converter returns a list containing all possible values that can be assigned to the associated control property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter returns a list containing all possible values that can be assigned to the associated control property; otherwise false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" />  implementation that can be used to gain additional context information.</param>
       </Docs>
@@ -201,7 +216,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.DataSourceViewSchemaConverter.GetStandardValuesSupported(System.ComponentModel.ITypeDescriptorContext)" /> method indicates whether the converter supports returning a list of available values through the <see cref="M:System.Web.UI.Design.DataSourceViewSchemaConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> method.</para>
@@ -211,6 +225,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether this converter returns a set of available values for assignment to a control property within the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter returns a standard set of available values for assignment to the associated control property; otherwise false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" />  implementation that can be used to gain additional context information.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignTimeData.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignTimeData.xml
index c881813d4f3..01e30855f4d 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignTimeData.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignTimeData.xml
@@ -29,7 +29,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The table is not actually bound to a data source. Each column name simply indicates that it is a data-bound column. The column data types are string, integer, and string. The calling designer component must add rows and data to the resulting table.</para>
@@ -38,6 +37,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Data.DataTable" /> object that contains three columns with names indicating that the columns are connected to a data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.DataTable" /> object with three columns and no data.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateDummyDataTable">
@@ -48,7 +51,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The column data types are all string. The calling designer component can call the <see cref="M:System.Web.UI.Design.DesignTimeData.GetDesignTimeDataSource(System.Data.DataTable,System.Int32)" /> method to add rows of data to the resulting table.</para>
@@ -57,6 +59,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Data.DataTable" /> object that contains three columns with names that indicate that the columns contain sample data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Data.DataTable" /> with three columns. These columns can contain data of type string.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -73,7 +79,6 @@
         <Parameter Name="referenceData" Type="System.Collections.IEnumerable" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The data types that can be created are the primitive types, such as number, string, and date types. Any other types are replaced by columns of type String. The calling designer component can call the <see cref="M:System.Web.UI.Design.DesignTimeData.GetDesignTimeDataSource(System.Data.DataTable,System.Int32)" /> method to add rows of data to the resulting table.</para>
@@ -82,6 +87,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a sample <see cref="T:System.Data.DataTable" /> object with the same schema as the provided data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataTable" /> object that contains columns with the same names and data types as the provided <paramref name="referenceData" />.</para>
+        </returns>
         <param name="referenceData">
           <attribution license="cc4" from="Microsoft" modified="false" />A data source with the desired schema to use as the format for the sample <see cref="T:System.Data.DataTable" /> object. </param>
       </Docs>
@@ -104,7 +113,6 @@
         <Parameter Name="useDataBoundData" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The data types that can be created are the primitive types, such as number, string, and date types. Any other types are replaced by columns of type String. The calling designer component can use <see cref="M:System.Web.UI.Design.DesignTimeData.GetDesignTimeDataSource(System.Data.DataTable,System.Int32)" /> to add rows of data to the resulting table.</para>
@@ -113,6 +121,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Data.DataTable" /> object with the same schema as the provided data and optionally containing column names indicating that the data is bound data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.DataTable" /> object.</para>
+        </returns>
         <param name="referenceData">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.IEnumerable" /> object containing data.</param>
         <param name="useDataBoundData">
@@ -147,12 +159,15 @@
         <Parameter Name="dataSource" Type="System.Collections.IEnumerable" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of property descriptors for the data fields of the specified data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> object that describes the data fields of the specified data source.</para>
+        </returns>
         <param name="dataSource">
           <attribution license="cc4" from="Microsoft" modified="false" />The data source from which to retrieve the data fields. </param>
       </Docs>
@@ -172,7 +187,6 @@
         <Parameter Name="dataMember" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method searches the specified data source for the specified data member. If <paramref name="dataMember" /> is null, the first data member in the specified data source is returned.</para>
@@ -181,6 +195,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the specified data member from the specified data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object implementing <see cref="T:System.Collections.IEnumerable" /> containing the specified data member from the specified data source, if it exists.</para>
+        </returns>
         <param name="dataSource">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.IListSource" /> that contains the data in which to find the member. </param>
         <param name="dataMember">
@@ -201,12 +219,15 @@
         <Parameter Name="dataSource" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the names of the data members in the specified data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type String that contains the names of the data members in the specified data source.</para>
+        </returns>
         <param name="dataSource">
           <attribution license="cc4" from="Microsoft" modified="false" />The data source from which to retrieve the names of the members. </param>
       </Docs>
@@ -226,12 +247,15 @@
         <Parameter Name="minimumRows" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified number of sample rows to the specified data table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object implementing <see cref="T:System.Collections.IEnumerable" /> containing sample data for use at design time.</para>
+        </returns>
         <param name="dataTable">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Data.DataTable" /> object to which the sample rows are added. </param>
         <param name="minimumRows">
@@ -253,12 +277,15 @@
         <Parameter Name="dataSource" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a data source selected by name in the design host, represented by the specified component's site property and identified by the specified data source name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object implementing either <see cref="T:System.ComponentModel.IListSource" /> or <see cref="T:System.Collections.IEnumerable" /> representing the selected data source, or null if the data source or the designer host could not be accessed.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.IComponent" /> object that contains the data source. </param>
         <param name="dataSource">
@@ -281,12 +308,15 @@
         <Parameter Name="dataMember" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a data source selected by name in the design host, represented by the specified component's site property and identified by the specified data-source name and member name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object implementing <see cref="T:System.Collections.IEnumerable" /> containing the data member, or null if the data source, member, or component's site could not be accessed.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The object implementing <see cref="T:System.ComponentModel.IComponent" /> that contains the data sourced property. </param>
         <param name="dataSource">
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignTimeResourceProviderFactory.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignTimeResourceProviderFactory.xml
index 31d2123cd48..b24d573e302 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignTimeResourceProviderFactory.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignTimeResourceProviderFactory.xml
@@ -46,12 +46,15 @@
         <Parameter Name="classKey" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates a global resource provider using the provided <see cref="T:System.IServiceProvider" /> interface and resource class name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Either an <see cref="T:System.Web.Compilation.IResourceProvider" /> or an <see cref="T:System.Web.UI.Design.IDesignTimeResourceWriter" />.</para>
+        </returns>
         <param name="serviceProvider">
           <attribution license="cc4" from="Microsoft" modified="false" />A reference to the design host.</param>
         <param name="classKey">
@@ -71,12 +74,15 @@
         <Parameter Name="serviceProvider" Type="System.IServiceProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates a local resource provider using the provided reference to the design host.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.Compilation.IResourceProvider" /> or a class derived from <see cref="T:System.Web.Compilation.IResourceProvider" />.</para>
+        </returns>
         <param name="serviceProvider">
           <attribution license="cc4" from="Microsoft" modified="false" />A reference to the design host.</param>
       </Docs>
@@ -94,12 +100,15 @@
         <Parameter Name="serviceProvider" Type="System.IServiceProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates a local resource writer for using the provided reference to the design host.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A local resource writer for using the provided reference to the design host.</para>
+        </returns>
         <param name="serviceProvider">
           <attribution license="cc4" from="Microsoft" modified="false" />A reference to the design host.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerAutoFormat.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerAutoFormat.xml
index 27aa4b0da9c..c20801b68fe 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerAutoFormat.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerAutoFormat.xml
@@ -109,7 +109,6 @@
         <Parameter Name="runtimeControl" Type="System.Web.UI.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.DesignerAutoFormat.GetPreviewControl(System.Web.UI.Control)" /> method is used by visual designers, such as vsprvslong, in an <ui>AutoFormat</ui> dialog box to display a formatted run-time preview of the control at design time before applying the format to the actual control.</para>
@@ -119,6 +118,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a copy of the associated control in order to provide a preview before applying the format to the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="M:System.Web.UI.Design.DesignerAutoFormat.GetPreviewControl(System.Web.UI.Control)" /> method returns a copy of the associated Web server control.</para>
+        </returns>
         <param name="runtimeControl">
           <attribution license="cc4" from="Microsoft" modified="false" />A run-time version of the Web server control.</param>
       </Docs>
@@ -176,7 +179,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.DesignerAutoFormat.ToString" /> method returns a string that contains the value of the <see cref="P:System.Web.UI.Design.DesignerAutoFormat.Name" /> property of the <see cref="T:System.Web.UI.Design.DesignerAutoFormat" /> object.</para>
@@ -185,6 +187,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Web.UI.Design.DesignerAutoFormat" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="P:System.Web.UI.Design.DesignerAutoFormat.Name" /> property of the current <see cref="T:System.Web.UI.Design.DesignerAutoFormat" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerAutoFormatCollection.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerAutoFormatCollection.xml
index da7bc87de49..c6f7d6ce9ac 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerAutoFormatCollection.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerAutoFormatCollection.xml
@@ -89,7 +89,6 @@
         <Parameter Name="format" Type="System.Web.UI.Design.DesignerAutoFormat" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.DesignerAutoFormatCollection.Add(System.Web.UI.Design.DesignerAutoFormat)" /> method adds the specified <see cref="T:System.Web.UI.Design.DesignerAutoFormat" /> object to the end of the collection. To add a <see cref="T:System.Web.UI.Design.DesignerAutoFormat" /> object to the collection at a specific index location, use the <see cref="M:System.Web.UI.Design.DesignerAutoFormatCollection.Insert(System.Int32,System.Web.UI.Design.DesignerAutoFormat)" /> method.</para>
@@ -98,6 +97,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Web.UI.Design.DesignerAutoFormat" /> object to the end of the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the format was added to the collection.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of <see cref="T:System.Web.UI.Design.DesignerAutoFormat" />.</param>
       </Docs>
@@ -136,7 +139,6 @@
         <Parameter Name="format" Type="System.Web.UI.Design.DesignerAutoFormat" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.DesignerAutoFormatCollection.Contains(System.Web.UI.Design.DesignerAutoFormat)" /> method determines equality by using the <see cref="M:System.Object.Equals(System.Object)" /> method on the <see cref="T:System.Web.UI.Design.DesignerAutoFormat" /> objects that are being compared.</para>
@@ -145,6 +147,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified format is contained within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if the specified format is in the collection; otherwise, false.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of <see cref="T:System.Web.UI.Design.DesignerAutoFormat" />.</param>
       </Docs>
@@ -183,7 +189,6 @@
         <Parameter Name="format" Type="System.Web.UI.Design.DesignerAutoFormat" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.DesignerAutoFormatCollection.IndexOf(System.Web.UI.Design.DesignerAutoFormat)" /> method determines equality by using the <see cref="M:System.Object.Equals(System.Object)" /> method on the <see cref="T:System.Web.UI.Design.DesignerAutoFormat" /> objects that are being compared.</para>
@@ -192,6 +197,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the specified <see cref="T:System.Web.UI.Design.DesignerAutoFormat" /> object within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="format" /> within the collection; otherwise, -1, if the format is not in the collection.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.DesignerAutoFormat" /> to locate within the collection.</param>
       </Docs>
@@ -429,7 +438,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.Design.DesignerAutoFormatCollection" /> object is cast to an <see cref="T:System.Collections.IEnumerable" /> interface.</para>
@@ -438,6 +446,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IEnumerator" /> interface that iterates through the collection when the <see cref="T:System.Web.UI.Design.DesignerAutoFormatCollection" /> object is cast to an <see cref="T:System.Collections.IEnumerable" /> interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.Web.UI.Design.DesignerAutoFormatCollection" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Add">
@@ -454,7 +466,6 @@
       </Parameters>
       <Docs>
         <param name="item">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.Design.DesignerAutoFormatCollection" /> object is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -463,6 +474,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an item to the collection when the <see cref="T:System.Web.UI.Design.DesignerAutoFormatCollection" /> object is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the added item.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Contains">
@@ -479,7 +494,6 @@
       </Parameters>
       <Docs>
         <param name="item">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.Design.DesignerAutoFormatCollection" /> object is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -488,6 +502,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the collection contains a specific value when the <see cref="T:System.Web.UI.Design.DesignerAutoFormatCollection" /> object is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if the object is in the <see cref="T:System.Web.UI.Design.DesignerAutoFormatCollection" />; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.IndexOf">
@@ -504,7 +522,6 @@
       </Parameters>
       <Docs>
         <param name="item">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.Design.DesignerAutoFormatCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -513,6 +530,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of a specific item in the collection when the <see cref="T:System.Web.UI.Design.DesignerAutoFormatCollection" /> object is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of a item in the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Insert">
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerObject.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerObject.xml
index aeb75bf625f..2f6a121008d 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerObject.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerObject.xml
@@ -74,12 +74,15 @@
         <Parameter Name="serviceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a service from the design host, as identified by the provided type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The requested service.</para>
+        </returns>
         <param name="serviceType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of service being requested.</param>
       </Docs>
@@ -133,12 +136,15 @@
         <Parameter Name="serviceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IServiceProvider.GetService(System.Type)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The requested service.</para>
+        </returns>
         <param name="serviceType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of service being requested.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerRegion.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerRegion.xml
index 05b821e19c3..182450622cb 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerRegion.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerRegion.xml
@@ -383,7 +383,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.DesignerRegion.GetBounds" /> method returns a value that is equivalent to calling the <see cref="M:System.Web.UI.Design.IControlDesignerView.GetBounds(System.Web.UI.Design.DesignerRegion)" /> method on the <see cref="P:System.Web.UI.Design.DesignerObject.Designer" /> object with this designer region.</para>
@@ -392,6 +391,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the size of the designer region on the design surface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> representing the designer region size on the design surface.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Highlight">
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerRegionCollection.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerRegionCollection.xml
index ef83c4742ca..e8d6a2d110f 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerRegionCollection.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/DesignerRegionCollection.xml
@@ -107,7 +107,6 @@
         <Parameter Name="region" Type="System.Web.UI.Design.DesignerRegion" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.DesignerRegionCollection.Add(System.Web.UI.Design.DesignerRegion)" /> method adds the specified <see cref="T:System.Web.UI.Design.DesignerRegion" /> object to the end of the collection. To add a <see cref="T:System.Web.UI.Design.DesignerRegion" /> object to the collection at a specific index location, use the <see cref="M:System.Web.UI.Design.DesignerRegionCollection.Insert(System.Int32,System.Web.UI.Design.DesignerRegion)" /> method.</para>
@@ -116,6 +115,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Web.UI.Design.DesignerRegion" /> object to the end of the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the region was added to the collection.</para>
+        </returns>
         <param name="region">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.DesignerRegion" /> to add to the collection.</param>
       </Docs>
@@ -154,7 +157,6 @@
         <Parameter Name="region" Type="System.Web.UI.Design.DesignerRegion" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.DesignerRegionCollection.Contains(System.Web.UI.Design.DesignerRegion)" /> method determines equality by using the <see cref="M:System.Object.Equals(System.Object)" /> method on the <see cref="T:System.Web.UI.Design.DesignerRegion" /> objects.</para>
@@ -164,6 +166,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified region is contained within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if the region is in the collection; otherwise, false.</para>
+        </returns>
         <param name="region">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.DesignerRegion" /> to locate within the collection.</param>
       </Docs>
@@ -228,7 +234,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="P:System.Web.UI.Design.DesignerRegionCollection.Count" /> property together with a loop construct, such as while, for, or foreach statements, to enumerate through the <see cref="T:System.Web.UI.Design.DesignerRegionCollection" /> object.</para>
@@ -237,6 +242,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IndexOf">
@@ -252,7 +261,6 @@
         <Parameter Name="region" Type="System.Web.UI.Design.DesignerRegion" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.DesignerRegionCollection.IndexOf(System.Web.UI.Design.DesignerRegion)" /> method determines equality by using the <see cref="M:System.Object.Equals(System.Object)" /> method on the <see cref="T:System.Web.UI.Design.DesignerRegion" /> objects.</para>
@@ -262,6 +270,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the specified <see cref="T:System.Web.UI.Design.DesignerRegion" /> object within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="region" /> within the collection; otherwise, -1, if <paramref name="region" /> is not in the collection.</para>
+        </returns>
         <param name="region">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.DesignerRegion" /> to locate within the collection.</param>
       </Docs>
@@ -578,7 +590,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.Design.DesignerRegionCollection" /> instance is cast to an <see cref="T:System.Collections.IEnumerable" /> interface.</para>
@@ -587,6 +598,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Collections.IEnumerable.GetEnumerator" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Add">
@@ -602,7 +617,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.Design.DesignerRegionCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -611,6 +625,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Collections.IList.Add(System.Object)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the item was added to the collection.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The item to add to the collection.</param>
       </Docs>
@@ -649,7 +667,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.Design.DesignerRegionCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -658,6 +675,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Collections.IList.Contains(System.Object)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if the region is in the collection; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.DesignerRegion" /> to locate within the collection.</param>
       </Docs>
@@ -675,7 +696,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.Design.DesignerRegionCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -684,6 +704,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Collections.IList.IndexOf(System.Object)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of the object within the collection; otherwise, -1, if the object is not in the collection.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.DesignerRegion" /> to locate within the collection.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/EditableDesignerRegion.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/EditableDesignerRegion.xml
index f98282f46af..d0313687e23 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/EditableDesignerRegion.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/EditableDesignerRegion.xml
@@ -98,12 +98,15 @@
         <Parameter Name="control" Type="System.Web.UI.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Web.UI.Design.ViewRendering" /> object containing the design-time HTML markup for the given control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.Design.ViewRendering" /> object.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The control for which to get the <see cref="T:System.Web.UI.Design.ViewRendering" /> object for the current region.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionEditor.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionEditor.xml
index d9bd5fa8522..65bcd635136 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionEditor.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionEditor.xml
@@ -57,7 +57,6 @@
         <Parameter Name="serviceProvider" Type="System.IServiceProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -68,6 +67,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates an expression string and provides the design-time value for a control property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object referenced by the evaluated expression string, if the expression evaluation succeeded; otherwise, null.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An expression string to evaluate. The expression does not include the expression prefix.</param>
         <param name="parseTimeData">
@@ -115,7 +118,6 @@
         <Parameter Name="serviceProvider" Type="System.IServiceProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -128,6 +130,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Web.UI.Design.ExpressionEditor" /> implementation that is associated with the specified expression prefix.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.Design.ExpressionEditor" /> implementation associated with <paramref name="expressionPrefix" />; otherwise, null, if <paramref name="expressionPrefix" /> is not defined or is not associated with an <see cref="T:System.Web.UI.Design.ExpressionEditor" />.</para>
+        </returns>
         <param name="expressionPrefix">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression prefix used to find the associated expression editor.</param>
         <param name="serviceProvider">
@@ -148,7 +154,6 @@
         <Parameter Name="serviceProvider" Type="System.IServiceProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -161,6 +166,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Web.UI.Design.ExpressionEditor" /> implementation that is associated with the specified expression builder type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.Design.ExpressionEditor" /> implementation associated with <paramref name="expressionBuilderType" />; otherwise, null, if <paramref name="expressionBuilderType" /> cannot be located or has no associated <see cref="T:System.Web.UI.Design.ExpressionEditor" />.</para>
+        </returns>
         <param name="expressionBuilderType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the derived expression builder class, used to locate the associated expression editor.</param>
         <param name="serviceProvider">
@@ -181,7 +190,6 @@
         <Parameter Name="serviceProvider" Type="System.IServiceProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -193,6 +201,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an expression editor sheet that is associated with the current expression editor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.Design.ExpressionEditorSheet" /> that defines the custom expression properties.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression string set for a control property, used to initialize the expression editor sheet.</param>
         <param name="serviceProvider">
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionEditorSheet.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionEditorSheet.xml
index 8c34c42a356..3cb4ec6db86 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionEditorSheet.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionEditorSheet.xml
@@ -65,7 +65,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -76,6 +75,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the expression string that is formed by the expression editor sheet property values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The custom expression string for the current property values.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionsCollectionConverter.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionsCollectionConverter.xml
index de20065b1fe..0b18b4a5572 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionsCollectionConverter.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionsCollectionConverter.xml
@@ -60,7 +60,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -71,6 +70,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an expression binding collection to the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If <paramref name="destinationType" /> is not of type <see cref="T:System.String" />, the object produced by the type conversion; otherwise, if <paramref name="destinationType" /> is a string, an empty string ("").</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that indicates the component or control the expression binding collection belongs to. </param>
         <param name="culture">
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionsCollectionEditor.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionsCollectionEditor.xml
index 279853aacda..818a5ab6508 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionsCollectionEditor.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ExpressionsCollectionEditor.xml
@@ -51,7 +51,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.Web.UI.Design.ExpressionsCollectionEditor.EditValue" /> method launches the user interface for editing the <paramref name="value" /> object. The designer host calls the <see cref="Overload:System.Web.UI.Design.ExpressionsCollectionEditor.EditValue" /> method when you attempt to edit the value of a property that this editor is associated with. The input service provider is used to obtain any editing services that are required within the <see cref="Overload:System.Web.UI.Design.ExpressionsCollectionEditor.EditValue" />.</para>
@@ -62,6 +61,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Edits the value of the specified object with the specified service provider and context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.ExpressionBindingCollection" /> object containing the selected expressions; otherwise, if no expressions are selected, the <paramref name="value" /> object.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that can be used to gain additional context information such as the associated control.</param>
         <param name="provider">
@@ -83,7 +86,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.Web.UI.Design.ExpressionsCollectionEditor.GetEditStyle" /> method returns the <see cref="F:System.Drawing.Design.UITypeEditorEditStyle.Modal" /> value by default. </para>
@@ -93,6 +95,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the editing style that is associated with this editor for the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> enumeration value indicating the editing style for the provided user interface.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that can be used to gain additional context information.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/HierarchicalDataSourceConverter.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/HierarchicalDataSourceConverter.xml
index ce58b096ba5..578f49e953b 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/HierarchicalDataSourceConverter.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/HierarchicalDataSourceConverter.xml
@@ -53,7 +53,6 @@
         <Parameter Name="component" Type="System.ComponentModel.IComponent" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.DataSourceConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> method uses the <see cref="M:System.Web.UI.Design.HierarchicalDataSourceConverter.IsValidDataSource(System.ComponentModel.IComponent)" /> method to determine which components are available as standard accessible data sources. For the <see cref="T:System.Web.UI.Design.HierarchicalDataSourceConverter" /> class, a valid data source is a component that implements the <see cref="T:System.Web.UI.IHierarchicalEnumerable" /> interface. </para>
@@ -62,6 +61,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified component is a valid data source for this converter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="component" /> implements <see cref="T:System.Web.UI.IHierarchicalEnumerable" />; otherwise, false.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to check as a valid data source.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/HierarchicalDataSourceDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/HierarchicalDataSourceDesigner.xml
index 44e0306d057..4b39f050ea1 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/HierarchicalDataSourceDesigner.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/HierarchicalDataSourceDesigner.xml
@@ -169,12 +169,15 @@
         <Parameter Name="viewPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the named data source view associated with the data source control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.Design.DesignerHierarchicalDataSourceView" /> object.</para>
+        </returns>
         <param name="viewPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique path to the block of data to use in creating the view.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IContentResolutionService.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IContentResolutionService.xml
index 79c9f92d73c..1a7a59955c8 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IContentResolutionService.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IContentResolutionService.xml
@@ -45,12 +45,15 @@
         <Parameter Name="identifier" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the current state of the identified content place holder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current state of the identified content placeholder.</para>
+        </returns>
         <param name="identifier">
           <attribution license="cc4" from="Microsoft" modified="false" />The identifier for a content place holder.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IControlDesignerTag.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IControlDesignerTag.xml
index 6c586809988..1c6f1e161ab 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IControlDesignerTag.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IControlDesignerTag.xml
@@ -30,12 +30,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the value of the identified attribute on the tag.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the value of the attribute.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the attribute.</param>
       </Docs>
@@ -51,12 +54,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the HTML markup for the content of the tag.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The HTML markup for the content of the tag.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOuterContent">
@@ -70,12 +76,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the complete HTML markup for the control, including the outer tags.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The outer HTML markup for the control.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsDirty">
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IControlDesignerView.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IControlDesignerView.xml
index 19345ad712b..40c05ec217c 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IControlDesignerView.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IControlDesignerView.xml
@@ -48,12 +48,15 @@
         <Parameter Name="region" Type="System.Web.UI.Design.DesignerRegion" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the outer bounds of the designer view.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> containing information about the location and measurements of the view at design time.</para>
+        </returns>
         <param name="region">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.DesignerRegion" /> for which you want to retrieve the bounds.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceDesigner.xml
index 8c170e18a43..15dc02bdf8d 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceDesigner.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceDesigner.xml
@@ -111,7 +111,6 @@
         <Parameter Name="viewName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A class that implements <see cref="T:System.Web.UI.Design.IDataSourceDesigner" /> can define a view in a way that is useful within the context of that class.</para>
@@ -121,6 +120,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Web.UI.Design.DesignerDataSourceView" /> for the specified view.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.Design.DesignerDataSourceView" /> containing information about the identified view, or null if a view with the specified name is not found.</para>
+        </returns>
         <param name="viewName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a view in the underlying data source.</param>
       </Docs>
@@ -136,12 +139,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the names of the views in the underlying data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.String" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="RefreshSchema">
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceProvider.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceProvider.xml
index 6778351b7b9..485f960fd85 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceProvider.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceProvider.xml
@@ -26,12 +26,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the selected data member from the selected data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The selected data member from the selected data source, if the control allows the user to select an <see cref="T:System.ComponentModel.IListSource" /> (such as a <see cref="T:System.Data.DataSet" />) for the data source, and provides a DataMember property to select a particular list (or <see cref="T:System.Data.DataTable" />) within the data source.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -46,12 +49,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a reference to the selected data source from the data source provider.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The currently selected data source object of this data source provider.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceSchema.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceSchema.xml
index f81f0aa91c4..5b002a42300 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceSchema.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceSchema.xml
@@ -29,7 +29,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A class that implements the <see cref="M:System.Web.UI.Design.IDataSourceSchema.GetViews" /> method returns an array of objects that implement the <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" /> interface. For example, in the array returned by the <see cref="M:System.Web.UI.Design.DataSetSchema.GetViews" /> method, each element of the array is a <see cref="T:System.Web.UI.Design.DataSetViewSchema" /> object that implements <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" />.</para>
@@ -38,6 +37,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of schema descriptors for views contained in the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" /> objects.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceViewSchema.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceViewSchema.xml
index 0c5c34bc777..faaa5978a2c 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceViewSchema.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDataSourceViewSchema.xml
@@ -28,7 +28,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Web.UI.Design.XmlDocumentSchema" /> class implements the <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" /> interface. It uses its implementation of the <see cref="M:System.Web.UI.Design.IDataSourceViewSchema.GetChildren" /> method to create an array of <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" /> objects.</para>
@@ -37,6 +36,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array representing the child views contained in the current view.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" /> objects that represent the child views contained in the current view.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetFields">
@@ -50,7 +53,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Web.UI.Design.DataSetSchema" /> class implements the <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" /> interface; its implementation of the <see cref="M:System.Web.UI.Design.DataSetViewSchema.GetFields" /> method returns an array of <see cref="T:System.Web.UI.Design.DataSetFieldSchema" /> objects, each of which derives from the <see cref="T:System.Web.UI.Design.IDataSourceFieldSchema" /> interface.</para>
@@ -59,6 +61,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array containing information about each field in the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Web.UI.Design.IDataSourceFieldSchema" /> objects representing each of the fields in the data source.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Name">
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDesignTimeResourceProviderFactoryService.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDesignTimeResourceProviderFactoryService.xml
index 8a65b3e3f79..d947d87712a 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDesignTimeResourceProviderFactoryService.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDesignTimeResourceProviderFactoryService.xml
@@ -25,12 +25,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Web.UI.Design.DesignTimeResourceProviderFactory" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A design time resource provider factory.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDesignTimeResourceWriter.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDesignTimeResourceWriter.xml
index 2e211a63481..7423283311c 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDesignTimeResourceWriter.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDesignTimeResourceWriter.xml
@@ -32,12 +32,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a key, using the provided string, to use to retrieve data from the given resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The key used to write or retrieve <paramref name="obj" /> from <paramref name="resourceName" />.</para>
+        </returns>
         <param name="resourceName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the resource.</param>
         <param name="obj">
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDocumentProjectItem.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDocumentProjectItem.xml
index c314979d04f..3ec1e8d0cde 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDocumentProjectItem.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IDocumentProjectItem.xml
@@ -25,12 +25,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides access to the contents of a document item that is retrieved from the design host.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Open">
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IFolderProjectItem.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IFolderProjectItem.xml
index 48999b6b7e3..4959b5b5065 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IFolderProjectItem.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IFolderProjectItem.xml
@@ -28,12 +28,15 @@
         <Parameter Name="content" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a document to a project folder in a design host, such as vsprvslong.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.Design.IDocumentProjectItem" /> representing the added document.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the document.</param>
         <param name="content">
@@ -53,12 +56,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new folder in a project folder of a design host, such as vsprvslong.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.Design.IFolderProjectItem" /> representing the new folder.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name for the new folder.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IHierarchicalDataSourceDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IHierarchicalDataSourceDesigner.xml
index 82d3c8b1081..50ffe92f352 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IHierarchicalDataSourceDesigner.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IHierarchicalDataSourceDesigner.xml
@@ -107,12 +107,15 @@
         <Parameter Name="viewPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the named data source view that is associated with the data source control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The named data source view that is associated with the data source control.</para>
+        </returns>
         <param name="viewPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The XPath for the part of the data source to retrieve.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IHtmlControlDesignerBehavior.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IHtmlControlDesignerBehavior.xml
index dd85eb3e108..ad009fe148b 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IHtmlControlDesignerBehavior.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IHtmlControlDesignerBehavior.xml
@@ -69,7 +69,6 @@
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -80,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the specified attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The attribute that was retrieved.</para>
+        </returns>
         <param name="attribute">
           <attribution license="cc4" from="Microsoft" modified="false" />The attribute to retrieve. </param>
         <param name="ignoreCase">
@@ -102,7 +105,6 @@
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -113,6 +115,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the specified style attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The style attribute that was retrieved.</para>
+        </returns>
         <param name="attribute">
           <attribution license="cc4" from="Microsoft" modified="false" />The style attribute to retrieve. </param>
         <param name="designTimeOnly">
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ITemplateEditingService.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ITemplateEditingService.xml
index 1dc081f17d0..6ecd8d758a4 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ITemplateEditingService.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ITemplateEditingService.xml
@@ -32,7 +32,6 @@
         <Parameter Name="templateNames" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -43,6 +42,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new template editing frame for the specified templated control designer, using the specified name and templates.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Web.UI.Design.ITemplateEditingFrame" />.</para>
+        </returns>
         <param name="designer">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.TemplatedControlDesigner" /> that will use the template editing frame. </param>
         <param name="frameName">
@@ -69,7 +72,6 @@
         <Parameter Name="templateStyles" Type="System.Web.UI.WebControls.Style[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -80,6 +82,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new template editing frame for the specified <see cref="T:System.Web.UI.Design.TemplatedControlDesigner" />, using the specified name, template names, control style, and template styles.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Web.UI.Design.ITemplateEditingFrame" />.</para>
+        </returns>
         <param name="designer">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.TemplatedControlDesigner" /> that will use the template editing frame. </param>
         <param name="frameName">
@@ -106,7 +112,6 @@
         <Parameter Name="control" Type="System.Web.UI.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -117,6 +122,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the name of the parent template.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the parent template.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Control" /> for which to get the name of the parent template. </param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebApplication.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebApplication.xml
index c1951d215e9..ccab5661ae8 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebApplication.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebApplication.xml
@@ -34,13 +34,16 @@
         <Parameter Name="appRelativeUrl" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a project item from a design host based on its URL.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A project item from a design host based on its URL.</para>
+        </returns>
         <param name="appRelativeUrl">
           <attribution license="cc4" from="Microsoft" modified="false" />The relative path to the project item to retrieve.</param>
       </Docs>
@@ -58,13 +61,16 @@
         <Parameter Name="isReadOnly" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Configuration.Configuration" /> object representing the current Web application in the design host.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the current Web application in the design host.</para>
+        </returns>
         <param name="isReadOnly">
           <attribution license="cc4" from="Microsoft" modified="false" />true to indicate the returned <see cref="T:System.Configuration.Configuration" /> is editable; otherwise, false.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebFormReferenceManager.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebFormReferenceManager.xml
index b70a8bc1d35..ff35398b29d 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebFormReferenceManager.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebFormReferenceManager.xml
@@ -32,7 +32,6 @@
         <Parameter Name="typeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -43,6 +42,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the type of the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> of the object, if it could be resolved.</para>
+        </returns>
         <param name="tagPrefix">
           <attribution license="cc4" from="Microsoft" modified="false" />The tag prefix for the type. </param>
         <param name="typeName">
@@ -61,7 +64,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -72,6 +74,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the register directives for the current project.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The register directives for the current project.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -88,7 +94,6 @@
         <Parameter Name="objectType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -99,6 +104,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the tag prefix for the specified type of object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The tag prefix for the specified object type, if it could be located.</para>
+        </returns>
         <param name="objectType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the object. </param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebFormsBuilderUIService.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebFormsBuilderUIService.xml
index 54a70d0f491..424aac83a26 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebFormsBuilderUIService.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebFormsBuilderUIService.xml
@@ -26,7 +26,6 @@
         <Parameter Name="initialColor" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="initialColor" /> parameter should be a named color, or an RGB color expressed in HTML color format (#RRGGBB).</para>
@@ -35,6 +34,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Starts a <see cref="T:System.Web.UI.Design.ColorBuilder" /> to build a color property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The color that was selected. This value will be a named color, or an RGB color expressed in HTML color format (#RRGGBB).</para>
+        </returns>
         <param name="owner">
           <attribution license="cc4" from="Microsoft" modified="false" />The control used to parent the dialog shown by the <see cref="T:System.Web.UI.Design.ColorBuilder" />. </param>
         <param name="initialColor">
@@ -60,12 +63,15 @@
         <Parameter Name="options" Type="System.Web.UI.Design.UrlBuilderOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Launches an editor to build a URL property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the URL returned by the <see cref="T:System.Web.UI.Design.UrlBuilder" />.</para>
+        </returns>
         <param name="owner">
           <attribution license="cc4" from="Microsoft" modified="false" />The control used to parent the dialog shown by the <see cref="T:System.Web.UI.Design.UrlBuilder" />. </param>
         <param name="initialUrl">
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebFormsDocumentService.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebFormsDocumentService.xml
index b952efa5547..9869082d307 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebFormsDocumentService.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/IWebFormsDocumentService.xml
@@ -28,7 +28,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is obsolete and there is no equivalent functionality.</para>
@@ -37,6 +36,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a discardable undo unit.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new discardable undo unit.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ReadWriteControlDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ReadWriteControlDesigner.xml
index a60b208e986..cc408d9c032 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ReadWriteControlDesigner.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ReadWriteControlDesigner.xml
@@ -56,7 +56,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -67,6 +66,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the HTML that is used to represent the control at design time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The HTML that is used to represent the control at design time.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MapPropertyToStyle">
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ResourceExpressionEditor.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ResourceExpressionEditor.xml
index a0b0073e5e0..31e55c2d210 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ResourceExpressionEditor.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ResourceExpressionEditor.xml
@@ -57,7 +57,6 @@
         <Parameter Name="serviceProvider" Type="System.IServiceProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -69,6 +68,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates a resource expression and provides the design-time value for a control property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object referenced by the evaluated expression string, if the expression evaluation succeeded; otherwise, null.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />A resource expression to evaluate. <paramref name="expression" /> does not include the Resources expression prefix.</param>
         <param name="parseTimeData">
@@ -93,7 +96,6 @@
         <Parameter Name="serviceProvider" Type="System.IServiceProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -103,6 +105,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a resource expression editor sheet that is initialized with the input expression string and service provider implementation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.Design.ResourceExpressionEditorSheet" /> that defines the resource expression properties.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />A resource expression, used to initialize the expression editor sheet.</param>
         <param name="serviceProvider">
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ResourceExpressionEditorSheet.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ResourceExpressionEditorSheet.xml
index dfaf4d32755..90bc2f743d2 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ResourceExpressionEditorSheet.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/ResourceExpressionEditorSheet.xml
@@ -84,12 +84,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a resource expression that is formed by the expression editor sheet property values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The resource expression string for the current settings in the sheet.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsValid">
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/SkinIDTypeConverter.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/SkinIDTypeConverter.xml
index 29704696a6a..01f43801e30 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/SkinIDTypeConverter.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/SkinIDTypeConverter.xml
@@ -46,12 +46,15 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this converter can convert a <see cref="P:System.Web.UI.Control.SkinID" /> object to a string using the provided format context and type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if the conversion can be made; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An T:System.ComponentModel.ITypeDescriptorContext that provides a format context for the control being designed.</param>
         <param name="sourceType">
@@ -72,12 +75,15 @@
         <Parameter Name="destType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this converter can convert a <see cref="P:System.Web.UI.Control.SkinID" /> object to the specified type, using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if a conversion can be made; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An T:System.ComponentModel.ITypeDescriptorContext that provides a format context for the control being designed.</param>
         <param name="destType">
@@ -99,12 +105,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given string to a <see cref="P:System.Web.UI.Control.SkinID" /> object using the specified context and culture information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that can be cast as a <see cref="P:System.Web.UI.DataSourceControl.SkinID" /> object, if the conversion can be made; otherwise, null.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An T:System.ComponentModel.ITypeDescriptorContext that provides a format context that represents the control being designed.</param>
         <param name="culture">
@@ -129,12 +138,15 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given <see cref="P:System.Web.UI.Control.SkinID" /> object to a string using the specified context and culture information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An T:System.ComponentModel.ITypeDescriptorContext that provides a format context that represents the control being designed.</param>
         <param name="culture">
@@ -158,12 +170,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a set of <see cref="P:System.Web.UI.Control.SkinID" /> objects that can be applied to the control that is represented by the given format context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> that holds a set of <see cref="P:System.Web.UI.Control.SkinID" /> objects; otherwise, null, if the control does not support skins.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An T:System.ComponentModel.ITypeDescriptorContext that provides a format context that represents the control being designed. <paramref name="context" /> or properties of <paramref name="context" /> can be null.</param>
       </Docs>
@@ -181,12 +196,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the control that is represented by the given context supports a set of <see cref="P:System.Web.UI.Control.SkinID" /> objects that can be picked from a list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if <see cref="Overload:System.Web.UI.Design.SkinIDTypeConverter.GetStandardValues" /> should be called to find a common set of values the object supports; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> for the control being designed.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/SupportsPreviewControlAttribute.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/SupportsPreviewControlAttribute.xml
index 8264816d38e..2f07cc438f7 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/SupportsPreviewControlAttribute.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/SupportsPreviewControlAttribute.xml
@@ -90,7 +90,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.SupportsPreviewControlAttribute.Equals(System.Object)" /> method overrides the <see cref="M:System.Object.Equals(System.Object)" /> method.</para>
@@ -100,6 +99,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified object represents the same preview attribute setting as the current instance of the <see cref="T:System.Web.UI.Design.SupportsPreviewControlAttribute" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is a <see cref="T:System.Web.UI.Design.SupportsPreviewControlAttribute" /> attribute and its value is the same as this instance of <see cref="T:System.Web.UI.Design.SupportsPreviewControlAttribute" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current instance of <see cref="T:System.Web.UI.Design.SupportsPreviewControlAttribute" />.</param>
       </Docs>
@@ -115,7 +118,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.SupportsPreviewControlAttribute.GetHashCode" /> method overrides the <see cref="M:System.Object.GetHashCode" /> method.</para>
@@ -125,6 +127,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance of the <see cref="T:System.Web.UI.Design.SupportsPreviewControlAttribute" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code for the current instance of <see cref="T:System.Web.UI.Design.SupportsPreviewControlAttribute" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsDefaultAttribute">
@@ -138,7 +144,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.SupportsPreviewControlAttribute.IsDefaultAttribute" /> method compares the value for the <see cref="P:System.Web.UI.Design.SupportsPreviewControlAttribute.SupportsPreviewControl" /> property of the current <see cref="T:System.Web.UI.Design.SupportsPreviewControlAttribute" /> object with the value for the <see cref="P:System.Web.UI.Design.SupportsPreviewControlAttribute.SupportsPreviewControl" /> property of the static <see cref="F:System.Web.UI.Design.SupportsPreviewControlAttribute.Default" /> field.</para>
@@ -147,6 +152,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the current instance of the <see cref="T:System.Web.UI.Design.SupportsPreviewControlAttribute" /> class is set to the default preview attribute value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current instance of <see cref="T:System.Web.UI.Design.SupportsPreviewControlAttribute" /> is equal to the default preview attribute value; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SupportsPreviewControl">
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TemplateEditingService.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TemplateEditingService.xml
index 283c9d6f827..bb71b403f29 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TemplateEditingService.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TemplateEditingService.xml
@@ -67,7 +67,6 @@
         <Parameter Name="templateNames" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -78,6 +77,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new template editing frame for the specified templated control designer, using the specified name and templates.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Web.UI.Design.ITemplateEditingFrame" />.</para>
+        </returns>
         <param name="designer">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.TemplatedControlDesigner" /> that will use the template editing frame.</param>
         <param name="frameName">
@@ -104,7 +107,6 @@
         <Parameter Name="templateStyles" Type="System.Web.UI.WebControls.Style[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -115,6 +117,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new template editing frame for the specified <see cref="T:System.Web.UI.Design.TemplatedControlDesigner" /> object, using the specified name, template names, control style, and template styles.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Web.UI.Design.ITemplateEditingFrame" />.</para>
+        </returns>
         <param name="designer">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.TemplatedControlDesigner" /> that will use the template editing frame. </param>
         <param name="frameName">
@@ -176,7 +182,6 @@
         <Parameter Name="control" Type="System.Web.UI.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -187,6 +192,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the name of the parent template.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the parent template.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Control" /> for which to get the name of the parent template. </param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TemplateGroupCollection.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TemplateGroupCollection.xml
index b580ae3fc54..c56d0fe9687 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TemplateGroupCollection.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TemplateGroupCollection.xml
@@ -87,7 +87,6 @@
         <Parameter Name="group" Type="System.Web.UI.Design.TemplateGroup" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.TemplateGroupCollection.Add(System.Web.UI.Design.TemplateGroup)" /> method adds the specified <see cref="T:System.Web.UI.Design.TemplateGroup" /> object to the end of the collection. To add a <see cref="T:System.Web.UI.Design.TemplateGroup" /> object to the collection at a specific index location, use the <see cref="M:System.Web.UI.Design.TemplateGroupCollection.Insert(System.Int32,System.Web.UI.Design.TemplateGroup)" /> method.</para>
@@ -97,6 +96,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Web.UI.Design.TemplateGroup" /> object to the end of the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the <see cref="T:System.Web.UI.Design.TemplateGroup" /> was added to the collection.</para>
+        </returns>
         <param name="group">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.TemplateGroup" /> to add to the collection.</param>
       </Docs>
@@ -160,7 +163,6 @@
         <Parameter Name="group" Type="System.Web.UI.Design.TemplateGroup" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.TemplateGroupCollection.Contains(System.Web.UI.Design.TemplateGroup)" /> method determines equality by using the <see cref="M:System.Object.Equals(System.Object)" /> method on the <see cref="T:System.Web.UI.Design.TemplateGroup" /> objects.</para>
@@ -170,6 +172,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified group is contained within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="group" /> is in the collection; otherwise, false.</para>
+        </returns>
         <param name="group">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.TemplateGroup" /> to locate within the collection.</param>
       </Docs>
@@ -236,7 +242,6 @@
         <Parameter Name="group" Type="System.Web.UI.Design.TemplateGroup" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.TemplateGroupCollection.IndexOf(System.Web.UI.Design.TemplateGroup)" /> method determines equality by using the <see cref="M:System.Object.Equals(System.Object)" /> method on the <see cref="T:System.Web.UI.Design.TemplateGroup" /> objects.</para>
@@ -246,6 +251,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the specified <see cref="T:System.Web.UI.Design.TemplateGroup" /> object within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="group" /> within the collection; otherwise, -1, if <paramref name="group" /> is not in the collection.</para>
+        </returns>
         <param name="group">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.TemplateGroup" /> to locate within the collection.</param>
       </Docs>
@@ -461,7 +470,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.Design.TemplateGroupCollection" /> instance is cast to an <see cref="T:System.Collections.IEnumerable" /> interface.</para>
@@ -470,6 +478,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Collections.IEnumerable.GetEnumerator" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> to use to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Add">
@@ -485,7 +497,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.Design.TemplateGroupCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -494,6 +505,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Collections.IList.Add(System.Object)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which <paramref name="o" /> was added to the collection.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.TemplateGroup" /> to add to the collection.</param>
       </Docs>
@@ -532,7 +547,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.Design.TemplateGroupCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -541,6 +555,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Collections.IList.Contains(System.Object)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if <paramref name="o" /> is in the collection; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.TemplateGroup" /> to locate within the collection.</param>
       </Docs>
@@ -558,7 +576,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.Design.TemplateGroupCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -567,6 +584,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Collections.IList.IndexOf(System.Object)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="o" /> within the collection; otherwise, -1, if <paramref name="o" /> is not in the collection.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Design.TemplateGroup" /> to locate within the collection.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TemplatedControlDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TemplatedControlDesigner.xml
index f033eb782d9..efee40c1d20 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TemplatedControlDesigner.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TemplatedControlDesigner.xml
@@ -92,12 +92,15 @@
         <Parameter Name="verb" Type="System.Web.UI.Design.TemplateEditingVerb" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates a template editing frame for the specified verb.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new template editing frame.</para>
+        </returns>
         <param name="verb">
           <attribution license="cc4" from="Microsoft" modified="false" />The template editing verb to create a template editing frame for. </param>
       </Docs>
@@ -210,7 +213,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -221,6 +223,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the cached template editing verbs.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Web.UI.Design.TemplateEditingVerb" /> objects, if any.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -240,12 +246,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the markup to persist for the content that is in the associated server control runtime.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The persistable inner HTML.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -261,7 +270,6 @@
         <Parameter Name="templateName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -272,6 +280,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the data item property of the template's container.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representing the data.</para>
+        </returns>
         <param name="templateName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the template. </param>
       </Docs>
@@ -295,12 +307,15 @@
         <Parameter Name="templateName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the data source of the template's container.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The data source of the container of the specified template.</para>
+        </returns>
         <param name="templateName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the template. </param>
       </Docs>
@@ -351,12 +366,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the template editing verbs available to the designer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The template editing verbs available to the designer.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -378,12 +396,15 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a template from the specified text.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.ITemplate" /> from the specified text.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to retrieve a template from. </param>
       </Docs>
@@ -402,7 +423,6 @@
         <Parameter Name="templateName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -413,6 +433,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the type of the parent of the template property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type of the object that has the template property.</para>
+        </returns>
         <param name="templateName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the template to return the type of the parent for. </param>
       </Docs>
@@ -436,12 +460,15 @@
         <Parameter Name="template" Type="System.Web.UI.ITemplate" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a string of text that represents the specified template.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the specified template.</para>
+        </returns>
         <param name="template">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.ITemplate" /> to convert to text. </param>
       </Docs>
@@ -645,6 +672,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Allows a designer to filter the set of member attributes the component it is designing through a <see cref="T:System.ComponentModel.TypeDescriptor" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The augmented set of attributes. If the method does not modify any attributes, it returns a reference to its input parameter. If you do make a change to the attributes, you must create a new array.</para>
+        </returns>
         <param name="properties">
           <attribution license="cc4" from="Microsoft" modified="false" />The member attributes for component. </param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TextControlDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TextControlDesigner.xml
index 59a3c0eca93..1c371dcbdf5 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TextControlDesigner.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TextControlDesigner.xml
@@ -45,7 +45,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class overrides this method to ensure that a non-empty Text property value is available when the control is rendered for display on the design surface. This makes sure that the class has a meaningful representation. This method sets any empty Text property of the control to the <see cref="P:System.Web.UI.Control.ID" /> property of the control.</para>
@@ -54,6 +53,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the markup that is used to represent the associated control at design time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The markup that is used to represent the control at design time.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -68,12 +71,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the markup to persist for the inner tags of the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The markup for the tags of the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TypeSchema.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TypeSchema.xml
index 0a4ecc1e0d8..26803a9714c 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TypeSchema.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/TypeSchema.xml
@@ -55,7 +55,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Although the <see cref="M:System.Web.UI.Design.TypeSchema.GetViews" /> method always returns an array of <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" /> objects that implement the <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" /> interface, the exact return value is dependent on the object that is provided when creating the instance of the <see cref="T:System.Web.UI.Design.TypeSchema" /> class.</para>
@@ -109,6 +108,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of schema descriptors for views into a data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of instances of <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" />, or of instances of a class that implements the <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" /> interface.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/UrlBuilder.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/UrlBuilder.xml
index 72a13ef7fe4..5624b1d2656 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/UrlBuilder.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/UrlBuilder.xml
@@ -35,12 +35,15 @@
         <Parameter Name="filter" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a UI to create or pick a URL.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The URL returned from the UI.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.IComponent" /> whose site is to be used to access design-time services. </param>
         <param name="owner">
@@ -72,12 +75,15 @@
         <Parameter Name="options" Type="System.Web.UI.Design.UrlBuilderOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a UI to create or pick a URL, using the specified <see cref="T:System.Web.UI.Design.UrlBuilderOptions" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The URL returned from the UI.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.IComponent" /> whose site is to be used to access design-time services. </param>
         <param name="owner">
@@ -114,7 +120,6 @@
         <Parameter Name="options" Type="System.Web.UI.Design.UrlBuilderOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.IServiceProvider" /> interface is used to obtain the <see cref="T:System.ComponentModel.Design.IDesignerHost" /> implementation for the designer host. </para>
@@ -123,6 +128,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a UI to create or pick a URL, using the specified <see cref="T:System.Web.UI.Design.UrlBuilderOptions" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The URL returned from the UI.</para>
+        </returns>
         <param name="serviceProvider">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IServiceProvider" /> to be used to access design-time services.</param>
         <param name="owner">
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/UrlEditor.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/UrlEditor.xml
index aa456779968..84379eb1007 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/UrlEditor.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/UrlEditor.xml
@@ -69,12 +69,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Edits the value of the specified object using the editor style provided by the <see cref="M:System.Web.UI.Design.UrlEditor.GetEditStyle(System.ComponentModel.ITypeDescriptorContext)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new value of the object. If the value of the object hasn't changed, this method should return the same object it was passed.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that can be used to gain additional context information. </param>
         <param name="provider">
@@ -124,12 +127,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the editing style of the <see cref="M:System.Web.UI.Design.UrlEditor.EditValue(System.ComponentModel.ITypeDescriptorContext,System.IServiceProvider,System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> values indicating the provided editing style. If the method is not supported, this method will return <see cref="F:System.Drawing.Design.UITypeEditorEditStyle.None" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that can be used to gain additional context information. </param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/UserControlDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/UserControlDesigner.xml
index 6ceebca4bd7..941ab7b43b7 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/UserControlDesigner.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/UserControlDesigner.xml
@@ -85,12 +85,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the HTML markup that is used to represent the user control at design time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The markup that is used to represent the control at design time.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -105,12 +108,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member overrides <see cref="M:System.Web.UI.Design.ControlDesigner.GetPersistInnerHtml" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The persistable inner HTML markup of the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/WebControlToolboxItem.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/WebControlToolboxItem.xml
index ad463507623..7d2c6278932 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/WebControlToolboxItem.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/WebControlToolboxItem.xml
@@ -110,7 +110,6 @@
         <Parameter Name="host" Type="System.ComponentModel.Design.IDesignerHost" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -120,6 +119,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates objects from each type contained in this <see cref="T:System.Drawing.Design.ToolboxItem" />, and adds them to the specified designer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of created <see cref="T:System.ComponentModel.IComponent" /> objects.</para>
+        </returns>
         <param name="host">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.IDesignerHost" /> for the current design document. </param>
       </Docs>
@@ -165,7 +168,6 @@
         <Parameter Name="attributeType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default implementation will throw an <see cref="T:System.ArgumentException" /> if the <paramref name="attributeType" /> parameter is anything other than a <see cref="T:System.Web.UI.PersistChildrenAttribute" />.</para>
@@ -174,6 +176,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified type of attribute of the toolbox item.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified type of attribute.</para>
+        </returns>
         <param name="host">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.IDesignerHost" /> for the current design document. </param>
         <param name="attributeType">
@@ -194,12 +200,15 @@
         <Parameter Name="host" Type="System.ComponentModel.Design.IDesignerHost" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the HTML for the Web control that the tool creates.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The HTML for the Web control that the tool creates.</para>
+        </returns>
         <param name="host">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.IDesignerHost" /> for the current design document. </param>
       </Docs>
@@ -218,12 +227,15 @@
         <Parameter Name="host" Type="System.ComponentModel.Design.IDesignerHost" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the type of this toolbox item.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> of this toolbox item.</para>
+        </returns>
         <param name="host">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.IDesignerHost" /> for the current design document. </param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/WebFormsReferenceManager.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/WebFormsReferenceManager.xml
index e0eb9f696c4..a042504817d 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/WebFormsReferenceManager.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/WebFormsReferenceManager.xml
@@ -63,12 +63,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the register directives for the current project document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of strings representing the register directives defined in the current document.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetTagPrefix">
@@ -84,12 +87,15 @@
         <Parameter Name="objectType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the tag prefix for the specified object type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The tag prefix for the specified object type, if found; otherwise, null.</para>
+        </returns>
         <param name="objectType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the object.</param>
       </Docs>
@@ -108,12 +114,15 @@
         <Parameter Name="tagName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the object type with the specified tag prefix and tag name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> of the object with the specified tag prefix and name, if found; otherwise, null.</para>
+        </returns>
         <param name="tagPrefix">
           <attribution license="cc4" from="Microsoft" modified="false" />The tag prefix of the type to retrieve.</param>
         <param name="tagName">
@@ -134,7 +143,6 @@
         <Parameter Name="tagName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -144,6 +152,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the relative URL path for the user control with the specified tag prefix and tag name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representing the relative URL path for the specified user control, if found; otherwise, null.</para>
+        </returns>
         <param name="tagPrefix">
           <attribution license="cc4" from="Microsoft" modified="false" />The tag prefix of the user control to retrieve.</param>
         <param name="tagName">
@@ -163,7 +175,6 @@
         <Parameter Name="objectType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the tag prefix already exists, then a new register directive is not added.</para>
@@ -172,6 +183,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a tag prefix for the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The tag prefix string.</para>
+        </returns>
         <param name="objectType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to add a tag prefix for in the current document.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/WebFormsRootDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/WebFormsRootDesigner.xml
index 1b7520eedc2..af260b8607e 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/WebFormsRootDesigner.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/WebFormsRootDesigner.xml
@@ -79,7 +79,6 @@
         <Parameter Name="location" Type="System.Web.UI.Design.ControlLocation" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Although a control might already have an ID assigned to it, if there is already a control in the Web Forms page with the same ID, a new ID is assigned.</para>
@@ -88,6 +87,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, adds a Web server control to the Web Forms page.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The ID of the control that was added.</para>
+        </returns>
         <param name="newControl">
           <attribution license="cc4" from="Microsoft" modified="false" />The control to add to the Web Forms page.</param>
         <param name="referenceControl">
@@ -130,7 +133,6 @@
         <Parameter Name="serviceProvider" Type="System.IServiceProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.WebFormsRootDesigner.CreateDesignerActionService(System.IServiceProvider)" /> method is called by a control designer and provides a way for action items for the control designer to be implemented in the Web Forms page through a design host, such as vsprvslong.</para>
@@ -139,6 +141,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a design-time <see cref="T:System.ComponentModel.Design.DesignerActionService" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A design-time designer action service object.</para>
+        </returns>
         <param name="serviceProvider">
           <attribution license="cc4" from="Microsoft" modified="false" />A design host, such as vsprvslong, cast as an <see cref="T:System.IServiceProvider" />.</param>
       </Docs>
@@ -154,12 +160,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Web.UI.IUrlResolutionService" /> that resolves relative URLs.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that resolves relative URLs.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CurrentCulture">
@@ -251,7 +260,6 @@
         <Parameter Name="control" Type="System.Web.UI.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Design.WebFormsRootDesigner.GenerateEmptyDesignTimeHtml(System.Web.UI.Control)" /> method enables a consistent display of empty controls at design time.</para>
@@ -260,6 +268,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates empty HTML markup for a control at design time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>HTML markup for an empty control.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The control to generate HTML markup for.</param>
       </Docs>
@@ -279,12 +291,15 @@
         <Parameter Name="errorMessage" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates HTML markup that is used to display an error message at design time by using the specified control, exception, and message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>HTML markup for a control and exception information.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The control that raised the exception.</param>
         <param name="e">
@@ -304,12 +319,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns a <see cref="T:System.Web.UI.Design.ClientScriptItemCollection" />  object that contains all client script items that are on the page.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that contains all client script items that are on the page.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetControlViewAndTag">
@@ -347,12 +365,15 @@
         <Parameter Name="serviceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the requested service.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The requested service; otherwise, null, if the service cannot be resolved.</para>
+        </returns>
         <param name="serviceType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of service to retrieve.</param>
       </Docs>
@@ -370,12 +391,15 @@
         <Parameter Name="viewTechnology" Type="System.ComponentModel.Design.ViewTechnology" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a view object that is determined by the provided <see cref="T:System.ComponentModel.Design.ViewTechnology" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object containing the current view of the component.</para>
+        </returns>
         <param name="viewTechnology">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.Design.ViewTechnology" /> obtained from the <see cref="P:System.Web.UI.Design.WebFormsRootDesigner.SupportedTechnologies" /> property.</param>
       </Docs>
@@ -684,12 +708,15 @@
         <Parameter Name="relativeUrl" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a relative URL into a fully qualified URL.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A fully qualified URL resolved from <paramref name="relativeUrl" />.</para>
+        </returns>
         <param name="relativeUrl">
           <attribution license="cc4" from="Microsoft" modified="false" />A relative URL for a resource on the site.</param>
       </Docs>
@@ -942,7 +969,6 @@
         <Parameter Name="viewTechnology" Type="System.ComponentModel.Design.ViewTechnology" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.Design.WebFormsRootDesigner" /> instance is cast to an <see cref="T:System.ComponentModel.Design.IRootDesigner" /> interface.</para>
@@ -951,6 +977,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a view object for the specified view technology. For a description of this member, see <see cref="M:System.ComponentModel.Design.IRootDesigner.GetView(System.ComponentModel.Design.ViewTechnology)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The view object for the specified view technology.</para>
+        </returns>
         <param name="viewTechnology">
           <attribution license="cc4" from="Microsoft" modified="false" /> The view technology.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/XmlDocumentSchema.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/XmlDocumentSchema.xml
index 96806c5e1d7..f35af22e205 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/XmlDocumentSchema.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/XmlDocumentSchema.xml
@@ -60,12 +60,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array containing information about each child node starting at the node identified by the <paramref name="xPath" /> parameter in the constructor, or each child node starting at the document root if the <paramref name="xPath" /> parameter is empty.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Web.UI.Design.IDataSourceViewSchema" /> objects.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/XmlFileEditor.xml b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/XmlFileEditor.xml
index c87ee926ab7..86b809ad941 100644
--- a/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/XmlFileEditor.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Web.UI.Design/XmlFileEditor.xml
@@ -50,7 +50,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A service provider is provided so that any required editing services can be obtained.</para>
@@ -59,6 +58,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Edits the value of the specified object using the specified service provider and context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new value of the object. If the value of the object has not changed, this method should return the same object it was passed.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
         <param name="provider">
@@ -81,12 +84,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the editing style associated with this editor, using the specified <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> enumeration value indicating the provided editing style. If the method is not supported in the specified context, this will return the <see cref="F:System.Drawing.Design.UITypeEditorEditStyle.None" /> identifier.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/Behavior.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/Behavior.xml
index 0bc3b2718ac..de399da0552 100644
--- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/Behavior.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/Behavior.xml
@@ -157,7 +157,6 @@
         <Parameter Name="commandId" Type="System.ComponentModel.Design.CommandID" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.Design.Behavior.Behavior.FindCommand(System.ComponentModel.Design.CommandID)" /> method is called from the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />. It provides an opportunity for the <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> to return its own custom <see cref="T:System.ComponentModel.Design.MenuCommand" />, thereby intercepting this message.</para>
@@ -166,6 +165,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Intercepts commands.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.Design.MenuCommand" />. By default, <see cref="M:System.Windows.Forms.Design.Behavior.Behavior.FindCommand(System.ComponentModel.Design.CommandID)" /> returns null.</para>
+        </returns>
         <param name="commandId">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.Design.CommandID" /> object.</param>
       </Docs>
@@ -350,7 +353,6 @@
         <Parameter Name="mouseLoc" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.Design.Behavior.Behavior.OnMouseDoubleClick(System.Windows.Forms.Design.Behavior.Glyph,System.Windows.Forms.MouseButtons,System.Drawing.Point)" /> method is called when any double-click message enters the WndProc of the adorner window of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />. The message is first passed here, to the top-most <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> in the behavior stack. Returning true from this method signifies that the message was handled by the <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> and should not continue to be processed. From here, the message is sent to the appropriate behavior.</para>
@@ -359,6 +361,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called when any double-click message enters the adorner window of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the message was handled; otherwise, false.</para>
+        </returns>
         <param name="g">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" />.</param>
         <param name="button">
@@ -382,7 +388,6 @@
         <Parameter Name="mouseLoc" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.Design.Behavior.Behavior.OnMouseDoubleClick(System.Windows.Forms.Design.Behavior.Glyph,System.Windows.Forms.MouseButtons,System.Drawing.Point)" /> method is called when any mouse-down message enters the WndProc of the adorner window of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />. The message is first passed here, to the top-most <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> in the behavior stack. Returning true from this method signifies that the message was handled by the <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> and should not continue to be processed. From here, the message is sent to the appropriate behavior.</para>
@@ -391,6 +396,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called when any mouse-down message enters the adorner window of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the message was handled; otherwise, false.</para>
+        </returns>
         <param name="g">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" />. </param>
         <param name="button">
@@ -412,7 +421,6 @@
         <Parameter Name="g" Type="System.Windows.Forms.Design.Behavior.Glyph" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.Design.Behavior.Behavior.OnMouseDoubleClick(System.Windows.Forms.Design.Behavior.Glyph,System.Windows.Forms.MouseButtons,System.Drawing.Point)" /> method is called when any mouse-enter message enters the WndProc of the adorner window of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />. From here, the message is sent to the appropriate behavior.</para>
@@ -422,6 +430,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called when any mouse-enter message enters the adorner window of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the message was handled; otherwise, false.</para>
+        </returns>
         <param name="g">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" />. </param>
       </Docs>
@@ -440,7 +452,6 @@
         <Parameter Name="mouseLoc" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.Design.Behavior.Behavior.OnMouseDoubleClick(System.Windows.Forms.Design.Behavior.Glyph,System.Windows.Forms.MouseButtons,System.Drawing.Point)" /> method is called when any mouse-hover message enters the WndProc of the adorner window of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />. The message is first passed here, to the top-most <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> in the behavior stack. Returning true from this method signifies that the message was handled by the <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> and should not continue to be processed. From here, the message is sent to the appropriate behavior.</para>
@@ -449,6 +460,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called when any mouse-hover message enters the adorner window of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the message was handled; otherwise, false.</para>
+        </returns>
         <param name="g">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" />. </param>
         <param name="mouseLoc">
@@ -468,7 +483,6 @@
         <Parameter Name="g" Type="System.Windows.Forms.Design.Behavior.Glyph" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.Design.Behavior.Behavior.OnMouseDoubleClick(System.Windows.Forms.Design.Behavior.Glyph,System.Windows.Forms.MouseButtons,System.Drawing.Point)" /> method is called when any mouse-leave message enters the WndProc of the adorner window of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />. From here, the message is sent to the appropriate behavior.</para>
@@ -478,6 +492,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called when any mouse-leave message enters the adorner window of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the message was handled; otherwise, false.</para>
+        </returns>
         <param name="g">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" />.</param>
       </Docs>
@@ -497,7 +515,6 @@
         <Parameter Name="mouseLoc" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.Design.Behavior.Behavior.OnMouseDoubleClick(System.Windows.Forms.Design.Behavior.Glyph,System.Windows.Forms.MouseButtons,System.Drawing.Point)" /> method is called when any mouse-move message enters the WndProc of the adorner window of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />. The message is first passed here, to the top-most <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> in the behavior stack. Returning true from this method signifies that the message was handled by the <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> and should not continue to be processed. From here, the message is sent to the appropriate behavior.</para>
@@ -506,6 +523,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called when any mouse-move message enters the adorner window of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the message was handled; otherwise, false.</para>
+        </returns>
         <param name="g">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" />. </param>
         <param name="button">
@@ -528,7 +549,6 @@
         <Parameter Name="button" Type="System.Windows.Forms.MouseButtons" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.Design.Behavior.Behavior.OnMouseDoubleClick(System.Windows.Forms.Design.Behavior.Glyph,System.Windows.Forms.MouseButtons,System.Drawing.Point)" /> method is called when any mouse-up message enters the WndProc of the adorner window of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />. The message is first passed here, to the top-most <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> in the behavior stack. Returning true from this method signifies that the message was handled by the <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> and should not continue to be processed. From here, the message is sent to the appropriate behavior.</para>
@@ -537,6 +557,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called when any mouse-up message enters the adorner window of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the message was handled; otherwise, false.</para>
+        </returns>
         <param name="g">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" />. </param>
         <param name="button">
diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/BehaviorService.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/BehaviorService.xml
index 953807914c3..286193083f6 100644
--- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/BehaviorService.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/BehaviorService.xml
@@ -78,12 +78,15 @@
         <Parameter Name="p" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Translates a <see cref="T:System.Drawing.Point" /> in the adorner window to screen coordinates.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The transformed <see cref="T:System.Drawing.Point" /> value, in screen coordinates.</para>
+        </returns>
         <param name="p">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Point" /> value to transform.</param>
       </Docs>
@@ -99,12 +102,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the location of the adorner window in screen coordinates.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The location, from the upper-left corner of the adorner window, in screen coordinates.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="BeginDrag">
@@ -141,7 +147,6 @@
         <Parameter Name="c" Type="System.Windows.Forms.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The adorner window is a transparent window that resides on top of the designer's frame. This window is used by the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" /> to intercept all messages. It also serves as a unified canvas on which to paint a <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" />.</para>
@@ -150,6 +155,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the bounding <see cref="T:System.Drawing.Rectangle" /> of a <see cref="T:System.Windows.Forms.Control" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The bounding <see cref="T:System.Drawing.Rectangle" /> of a <see cref="T:System.Windows.Forms.Control" /> translated to the adorner window coordinates.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Control" /> to translate.</param>
       </Docs>
@@ -167,12 +176,15 @@
         <Parameter Name="c" Type="System.Windows.Forms.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the location of a <see cref="T:System.Windows.Forms.Control" /> translated to adorner window coordinates.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Point" /> value indicating the location of <paramref name="c" /> in adorner window coordinates.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Control" /> to translate.</param>
       </Docs>
@@ -253,12 +265,15 @@
         <Parameter Name="behavior" Type="System.Windows.Forms.Design.Behavior.Behavior" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> immediately after the given <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> in the behavior stack.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> immediately after <paramref name="behavior" /> in the behavior stack, or null if there is no following behavior.</para>
+        </returns>
         <param name="behavior">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> preceding the <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> to be returned.</param>
       </Docs>
@@ -348,12 +363,15 @@
         <Parameter Name="pt" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a point in a handle's coordinate system to the adorner window coordinates.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Point" /> in the adorner window coordinates.</para>
+        </returns>
         <param name="handle">
           <attribution license="cc4" from="Microsoft" modified="false" />An adorner window's handle.</param>
         <param name="pt">
@@ -373,7 +391,6 @@
         <Parameter Name="behavior" Type="System.Windows.Forms.Design.Behavior.Behavior" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the current <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> from the behavior stack internally maintained by the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />.</para>
@@ -382,6 +399,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes and returns the <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> at the top of the stack.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> that was removed from the stack.</para>
+        </returns>
         <param name="behavior">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Design.Behavior.Behavior" /> to remove from the stack.</param>
       </Docs>
@@ -449,12 +470,15 @@
         <Parameter Name="p" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Translates a point in screen coordinates into the adorner window coordinates of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The transformed <see cref="T:System.Drawing.Point" /> value, in adorner window coordinates.</para>
+        </returns>
         <param name="p">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Point" /> value to transform.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/BehaviorServiceAdornerCollection.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/BehaviorServiceAdornerCollection.xml
index c4502eede27..79864b11b0d 100644
--- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/BehaviorServiceAdornerCollection.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/BehaviorServiceAdornerCollection.xml
@@ -87,12 +87,15 @@
         <Parameter Name="value" Type="System.Windows.Forms.Design.Behavior.Adorner" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an <see cref="T:System.Windows.Forms.Design.Behavior.Adorner" /> with the specified value to the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorServiceAdornerCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Windows.Forms.Design.Behavior.Adorner" /> to add to the end of the collection.</param>
       </Docs>
@@ -154,12 +157,15 @@
         <Parameter Name="value" Type="System.Windows.Forms.Design.Behavior.Adorner" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorServiceAdornerCollection" /> contains the specified <see cref="T:System.Windows.Forms.Design.Behavior.Adorner" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Windows.Forms.Design.Behavior.Adorner" /> is contained in the collection; otherwise, false</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Design.Behavior.Adorner" /> to locate.</param>
       </Docs>
@@ -200,12 +206,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that can iterate through the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorServiceAdornerCollection" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorServiceAdornerCollection" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IndexOf">
@@ -221,12 +230,15 @@
         <Parameter Name="value" Type="System.Windows.Forms.Design.Behavior.Adorner" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of an <see cref="T:System.Windows.Forms.Design.Behavior.Adorner" /> in the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorServiceAdornerCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the <see cref="T:System.Windows.Forms.Design.Behavior.Adorner" /> of <paramref name="value" /> in the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorServiceAdornerCollection" />, if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Design.Behavior.Adorner" /> to locate.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/BehaviorServiceAdornerCollectionEnumerator.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/BehaviorServiceAdornerCollectionEnumerator.xml
index f20dcea85cb..d5b549a261c 100644
--- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/BehaviorServiceAdornerCollectionEnumerator.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/BehaviorServiceAdornerCollectionEnumerator.xml
@@ -69,12 +69,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the enumerator to the next element of the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorServiceAdornerCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the enumerator was successfully advanced to the next element; false if the enumerator was past the end of the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Reset">
@@ -127,7 +130,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorServiceAdornerCollectionEnumerator" /> instance is cast to an <see cref="T:System.Collections.IEnumerator" /> interface.</para>
@@ -136,6 +138,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see the <see cref="M:System.Collections.IEnumerator.MoveNext" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the enumerator was successfully advanced to the next element; false if the enumerator was past the end of the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IEnumerator.Reset">
diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/ComponentGlyph.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/ComponentGlyph.xml
index b3c0a53807f..3e1d8ca2643 100644
--- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/ComponentGlyph.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/ComponentGlyph.xml
@@ -74,7 +74,6 @@
         <Parameter Name="p" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default implementation does nothing and returns null.</para>
@@ -83,6 +82,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a mouse click at the specified point should be handled by the <see cref="T:System.Windows.Forms.Design.Behavior.ComponentGlyph" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.Cursor" /> if the <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> is associated with <paramref name="p" />; otherwise, null.</para>
+        </returns>
         <param name="p">
           <attribution license="cc4" from="Microsoft" modified="false" />A point to hit-test.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/ControlBodyGlyph.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/ControlBodyGlyph.xml
index 2a39c07c08d..01479e1c3b6 100644
--- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/ControlBodyGlyph.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/ControlBodyGlyph.xml
@@ -107,12 +107,15 @@
         <Parameter Name="p" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a mouse click at the specified point should be handled by the <see cref="T:System.Windows.Forms.Design.Behavior.ControlBodyGlyph" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.Cursor" /> if the <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> is associated with <paramref name="p" />; otherwise, null.</para>
+        </returns>
         <param name="p">
           <attribution license="cc4" from="Microsoft" modified="false" />A point to hit test.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/Glyph.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/Glyph.xml
index 5d374738ecf..83d75150d69 100644
--- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/Glyph.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/Glyph.xml
@@ -89,7 +89,6 @@
         <Parameter Name="p" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.Design.Behavior.Glyph.GetHitTest(System.Drawing.Point)" /> method is an abstract method that forces <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> implementations to provide hit test logic. Given any point, if the <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> has decided to be involved with that location, it will need to return a valid <see cref="T:System.Windows.Forms.Cursor" />. Otherwise, returning null will cause the <see cref="T:System.Windows.Forms.Design.Behavior.BehaviorService" /> to ignore the location.</para>
@@ -98,6 +97,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides hit test logic.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.Cursor" /> if the <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> is associated with <paramref name="p" />; otherwise, null.</para>
+        </returns>
         <param name="p">
           <attribution license="cc4" from="Microsoft" modified="false" />A point to hit-test.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/GlyphCollection.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/GlyphCollection.xml
index fb4251a0407..48565b846be 100644
--- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/GlyphCollection.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/GlyphCollection.xml
@@ -83,12 +83,15 @@
         <Parameter Name="value" Type="System.Windows.Forms.Design.Behavior.Glyph" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> with the specified value to the <see cref="T:System.Windows.Forms.Design.Behavior.GlyphCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> to add to the end of the collection.</param>
       </Docs>
@@ -150,12 +153,15 @@
         <Parameter Name="value" Type="System.Windows.Forms.Design.Behavior.Glyph" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the <see cref="T:System.Windows.Forms.Design.Behavior.GlyphCollection" /> contains the specified <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> is contained in the collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> to locate.</param>
       </Docs>
@@ -198,12 +204,15 @@
         <Parameter Name="value" Type="System.Windows.Forms.Design.Behavior.Glyph" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of a <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> in the <see cref="T:System.Windows.Forms.Design.Behavior.GlyphCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> of <paramref name="value" /> in the <see cref="T:System.Windows.Forms.Design.Behavior.GlyphCollection" />, if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> to locate.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/SnapLine.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/SnapLine.xml
index 219c2357ac1..93b5a97b44c 100644
--- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/SnapLine.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design.Behavior/SnapLine.xml
@@ -385,12 +385,15 @@
         <Parameter Name="line2" Type="System.Windows.Forms.Design.Behavior.SnapLine" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified <see cref="T:System.Windows.Forms.Design.Behavior.SnapLine" /> should snap to another <see cref="T:System.Windows.Forms.Design.Behavior.SnapLine" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="line1" /> should snap to <paramref name="line2" />; otherwise, false.</para>
+        </returns>
         <param name="line1">
           <attribution license="cc4" from="Microsoft" modified="false" />The specified <see cref="T:System.Windows.Forms.Design.Behavior.SnapLine" />.</param>
         <param name="line2">
@@ -430,7 +433,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns a string that contains details about the type, offset, priority, and filter values of the snapline.</para>
@@ -439,6 +441,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of the current snapline.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that represents the current <see cref="T:System.Windows.Forms.Design.Behavior.SnapLine" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/AnchorEditor.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/AnchorEditor.xml
index 97da8380bbd..909379e6909 100644
--- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/AnchorEditor.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/AnchorEditor.xml
@@ -49,7 +49,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A service provider is provided so that any required editing services can be obtained.</para>
@@ -58,6 +57,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Edits the value of the specified object using the specified service provider and context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new value of the object. If the value of the object hasn't changed, this should return the same object it was passed.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
         <param name="provider">
@@ -80,12 +83,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the editor style used by the <see cref="M:System.Windows.Forms.Design.AnchorEditor.EditValue(System.ComponentModel.ITypeDescriptorContext,System.IServiceProvider,System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> values indicating the provided editing style. If the method is not supported, this method will return <see cref="F:System.Drawing.Design.UITypeEditorEditStyle.None" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/AxImporter.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/AxImporter.xml
index d20488494ee..fa4c39872c3 100644
--- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/AxImporter.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/AxImporter.xml
@@ -104,12 +104,15 @@
         <Parameter Name="file" Type="System.IO.FileInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a wrapper for an ActiveX control for use in the design-time environment.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An assembly qualified name for the type of ActiveX control for which a wrapper was generated.</para>
+        </returns>
         <param name="file">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IO.FileInfo" /> indicating the file that contains the control. </param>
       </Docs>
@@ -128,12 +131,15 @@
         <Parameter Name="typeLib" Type="System.Runtime.InteropServices.UCOMITypeLib" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a wrapper for an ActiveX control for use in the design-time environment.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An assembly qualified name for the type of ActiveX control for which a wrapper was generated.</para>
+        </returns>
         <param name="typeLib">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Runtime.InteropServices.UCOMITypeLib" /> that indicates the type library to generate the control from. </param>
       </Docs>
@@ -153,12 +159,15 @@
         <Parameter Name="clsid" Type="System.Guid" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a wrapper for an ActiveX control for use in the design-time environment.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An assembly qualified name for the type of ActiveX control for which a wrapper was generated.</para>
+        </returns>
         <param name="typeLib">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Runtime.InteropServices.UCOMITypeLib" /> that indicates the type library to generate the control from. </param>
         <param name="clsid">
diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/AxParameterData.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/AxParameterData.xml
index a99223a341f..9bb24a05174 100644
--- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/AxParameterData.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/AxParameterData.xml
@@ -117,12 +117,15 @@
         <Parameter Name="infos" Type="System.Reflection.ParameterInfo[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified parameter information to an <see cref="T:System.Windows.Forms.Design.AxParameterData" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Windows.Forms.Design.AxParameterData" /> objects representing the specified array of <see cref="T:System.Reflection.ParameterInfo" /> objects.</para>
+        </returns>
         <param name="infos">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Reflection.ParameterInfo" /> objects to convert. </param>
       </Docs>
@@ -142,12 +145,15 @@
         <Parameter Name="ignoreByRefs" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified parameter information to an <see cref="T:System.Windows.Forms.Design.AxParameterData" /> object, according to the specified value indicating whether to ignore by reference parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Windows.Forms.Design.AxParameterData" /> objects representing the specified array of <see cref="T:System.Reflection.ParameterInfo" /> objects.</para>
+        </returns>
         <param name="infos">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Reflection.ParameterInfo" /> objects to convert. </param>
         <param name="ignoreByRefs">
diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/BorderSidesEditor.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/BorderSidesEditor.xml
index e170479883f..f9163cf6180 100644
--- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/BorderSidesEditor.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/BorderSidesEditor.xml
@@ -47,12 +47,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Edits the given object value using the editor style provided by <see cref="M:System.Windows.Forms.Design.BorderSidesEditor.GetEditStyle(System.ComponentModel.ITypeDescriptorContext)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The edited object.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> providing information about the control or component.</param>
         <param name="provider">
@@ -74,12 +77,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the editing style of the EditValue method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> values. If the method is not supported, this method returns <see cref="F:System.Drawing.Design.UITypeEditorEditStyle.None" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> providing information about the control or component.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ComponentDocumentDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ComponentDocumentDesigner.xml
index 1c72b271363..ce75f6b9f28 100644
--- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ComponentDocumentDesigner.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ComponentDocumentDesigner.xml
@@ -111,7 +111,6 @@
         <Parameter Name="tool" Type="System.Drawing.Design.ToolboxItem" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If a tool is supported, it will be enabled in the toolbox when the designer regains focus. Otherwise, it will be disabled. Once a tool is marked as enabled or disabled it cannot be queried again.</para>
@@ -120,6 +119,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified tool is supported by the designer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the tool should be enabled on the toolbox; false if the document designer doesn't know how to use the tool.</para>
+        </returns>
         <param name="tool">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Design.ToolboxItem" /> to test for toolbox support. </param>
       </Docs>
@@ -191,7 +194,6 @@
         <Parameter Name="technology" Type="System.ComponentModel.Design.ViewTechnology" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.Design.ComponentDocumentDesigner" /> instance is cast to an <see cref="T:System.ComponentModel.Design.IRootDesigner" /> interface.</para>
@@ -200,6 +202,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="T:System.ComponentModel.Design.ViewTechnology" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the view for this designer.</para>
+        </returns>
         <param name="technology">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.Design.ViewTechnology" /> that indicates a particular view technology.</param>
       </Docs>
@@ -241,7 +247,6 @@
         <Parameter Name="attributes" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.Design.ComponentDocumentDesigner" /> instance is cast to an <see cref="T:System.ComponentModel.Design.ITypeDescriptorFilterService" /> interface.</para>
@@ -250,6 +255,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ComponentModel.Design.ITypeDescriptorFilterService.FilterAttributes(System.ComponentModel.IComponent,System.Collections.IDictionary)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the set of filtered attributes is to be cached; false if the filter service must query again.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to filter the attributes of.</param>
         <param name="attributes">
@@ -271,7 +280,6 @@
         <Parameter Name="events" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.Design.ComponentDocumentDesigner" /> instance is cast to an <see cref="T:System.ComponentModel.Design.ITypeDescriptorFilterService" /> interface.</para>
@@ -280,6 +288,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ComponentModel.Design.ITypeDescriptorFilterService.FilterEvents(System.ComponentModel.IComponent,System.Collections.IDictionary)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the set of filtered events is to be cached; false if the filter service must query again.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to filter events for.</param>
         <param name="events">
@@ -301,7 +313,6 @@
         <Parameter Name="properties" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.Design.ComponentDocumentDesigner" /> instance is cast to an <see cref="T:System.ComponentModel.Design.ITypeDescriptorFilterService" /> interface.</para>
@@ -310,6 +321,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ComponentModel.Design.ITypeDescriptorFilterService.FilterProperties(System.ComponentModel.IComponent,System.Collections.IDictionary)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the set of filtered properties is to be cached; false if the filter service must query again.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to filter properties for.</param>
         <param name="properties">
@@ -330,7 +345,6 @@
         <Parameter Name="tool" Type="System.Drawing.Design.ToolboxItem" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.Design.ComponentDocumentDesigner" /> instance is cast to an <see cref="T:System.Drawing.Design.IToolboxUser" /> interface.</para>
@@ -339,6 +353,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Drawing.Design.IToolboxUser.GetToolSupported(System.Drawing.Design.ToolboxItem)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the tool is supported by the toolbox and can be enabled; false if the document designer does not know how to use the tool.</para>
+        </returns>
         <param name="tool">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Design.ToolboxItem" /> to be tested for toolbox support.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ComponentTray.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ComponentTray.xml
index 463e7babb8b..4199ab1b0ec 100644
--- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ComponentTray.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ComponentTray.xml
@@ -116,12 +116,15 @@
         <Parameter Name="tool" Type="System.Drawing.Design.ToolboxItem" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified tool can be used to create a new component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified tool can be used to create a component; otherwise, false.</para>
+        </returns>
         <param name="tool">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Design.ToolboxItem" /> to test. </param>
       </Docs>
@@ -140,7 +143,6 @@
         <Parameter Name="component" Type="System.ComponentModel.IComponent" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method tests the specified component for the existence of a <see cref="T:System.ComponentModel.DesignTimeVisibleAttribute" />, which indicates whether the component has a user interface that can be displayed.</para>
@@ -149,6 +151,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified component can be displayed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the component can be displayed; otherwise, false.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.IComponent" /> to test. </param>
       </Docs>
@@ -262,7 +268,6 @@
         <Parameter Name="receiver" Type="System.ComponentModel.IComponent" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -272,6 +277,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the location of the specified component, relative to the upper-left corner of the component tray.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Point" /> indicating the coordinates of the specified component, or an empty <see cref="T:System.Drawing.Point" /> if the specified component could not be found in the component tray. An empty <see cref="T:System.Drawing.Point" /> has an <see cref="P:System.Drawing.Point.IsEmpty" /> property equal to true and typically has <see cref="P:System.Drawing.Point.X" /> and <see cref="P:System.Drawing.Point.Y" /> properties that are each equal to zero.</para>
+        </returns>
         <param name="receiver">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.IComponent" /> to retrieve the location of. </param>
       </Docs>
@@ -311,12 +320,15 @@
         <Parameter Name="forward" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Similar to <see cref="M:System.Windows.Forms.Control.GetNextControl(System.Windows.Forms.Control,System.Boolean)" />, this method returns the next component in the tray, given a starting component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The next component in the component tray, or null, if the end of the list is encountered (or the beginning, if <paramref name="forward" /> is false).</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component from which to start enumerating.</param>
         <param name="forward">
@@ -334,12 +346,15 @@
       </Parameters>
       <Docs>
         <param name="service">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the requested service type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the requested service, or null if the service could not be found.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -373,7 +388,6 @@
         <Parameter Name="receiver" Type="System.ComponentModel.IComponent" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The Location extender property is offered to all non-visual components. The returned value takes into account the value of <see cref="P:System.Windows.Forms.ScrollableControl.AutoScrollPosition" />. If <paramref name="receiver" /> does not have a component view, the returned value is an empty <see cref="T:System.Drawing.Point" />.</para>
@@ -382,6 +396,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the Location extender property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Point" /> representing the location of <paramref name="receiver" />. </para>
+        </returns>
         <param name="receiver">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.IComponent" /> that receives the location extender property.</param>
       </Docs>
@@ -399,12 +417,15 @@
         <Parameter Name="comp" Type="System.ComponentModel.IComponent" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests a component for presence in the component tray.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="comp" /> is being shown on the tray; otherwise, false.</para>
+        </returns>
         <param name="comp">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to test for presence in the component tray.</param>
       </Docs>
@@ -827,7 +848,6 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.Design.ComponentTray" /> instance is cast to an <see cref="T:System.ComponentModel.IExtenderProvider" /> interface.</para>
@@ -836,6 +856,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ComponentModel.IExtenderProvider.CanExtend(System.Object)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this object can provide extender properties to the specified object; otherwise, false.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to receive the extender properties.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ControlDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ControlDesigner.xml
index 16451f75d7d..f838d4e85a4 100644
--- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ControlDesigner.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ControlDesigner.xml
@@ -175,7 +175,6 @@
         <Parameter Name="parentDesigner" Type="System.ComponentModel.Design.IDesigner" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is useful for testing whether a control can be parented by a particular type of parent. For example, <see cref="T:System.Windows.Forms.TabPage" /> controls can only be parented by <see cref="T:System.Windows.Forms.TabControl" /> controls.</para>
@@ -187,6 +186,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates if this designer's control can be parented by the control of the specified designer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the control managed by the specified designer can parent the control managed by this designer; otherwise, false.</para>
+        </returns>
         <param name="parentDesigner">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.IDesigner" /> that manages the control to check. </param>
       </Docs>
@@ -297,7 +300,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The child control specified by <paramref name="child" /> is a child of this control designer's control. The child does not directly participate in persistence, but it will if it is exposed as a property of the main control. Consider a control like the <see cref="T:System.Windows.Forms.SplitContainer" />: it has two panels, Panel1 and Panel2. These panels are exposed through read only <see cref="P:System.Windows.Forms.SplitContainer.Panel1" /> and <see cref="P:System.Windows.Forms.SplitContainer.Panel2" /> properties on the <see cref="T:System.Windows.Forms.SplitContainer" /> control. The <see cref="T:System.Windows.Forms.SplitContainer" /> control's designer calls <see cref="M:System.Windows.Forms.Design.ControlDesigner.EnableDesignMode(System.Windows.Forms.Control,System.String)" /> for each panel, which allows other components to be dropped on them. But, in order for the contents of <see cref="P:System.Windows.Forms.SplitContainer.Panel1" /> and <see cref="P:System.Windows.Forms.SplitContainer.Panel2" /> to be saved, the <see cref="T:System.Windows.Forms.SplitContainer" /> control itself must expose the panels as public properties.</para>
@@ -308,6 +310,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Enables design time functionality for a child control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the child control could be enabled for design time; false if the hosting infrastructure does not support it.</para>
+        </returns>
         <param name="child">
           <attribution license="cc4" from="Microsoft" modified="false" />The child control for which design mode will be enabled.</param>
         <param name="name">
@@ -372,12 +378,15 @@
         <Parameter Name="selectionType" Type="System.Windows.Forms.Design.Behavior.GlyphSelectionType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Windows.Forms.Design.Behavior.ControlBodyGlyph" /> representing the bounds of this control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.Design.Behavior.ControlBodyGlyph" /> representing the bounds of this control.</para>
+        </returns>
         <param name="selectionType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Design.Behavior.GlyphSelectionType" /> value that specifies the selection state.</param>
       </Docs>
@@ -395,7 +404,6 @@
         <Parameter Name="selectionType" Type="System.Windows.Forms.Design.Behavior.GlyphSelectionType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Note that based on <paramref name="selectionType" />, the <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> objects returned will represent one of these selection states:</para>
@@ -415,6 +423,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> objects representing the selection borders and grab handles for a standard control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> objects.</para>
+        </returns>
         <param name="selectionType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Design.Behavior.GlyphSelectionType" /> value that specifies the selection state.</param>
       </Docs>
@@ -429,7 +441,6 @@
         <Parameter Name="point" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.Design.ControlDesigner.GetHitTest(System.Drawing.Point)" /> method determines whether a click at the specified point should be passed to the control, while the control is in design mode. You can override and implement this method to enable your control to receive clicks in the design-time environment.</para>
@@ -442,6 +453,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a mouse click at the specified point should be handled by the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a click at the specified point is to be handled by the control; otherwise, false.</para>
+        </returns>
         <param name="point">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Point" /> indicating the position at which the mouse was clicked, in screen coordinates. </param>
       </Docs>
@@ -580,7 +595,6 @@
         <Parameter Name="internalControlIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An internal control is a control that is not in the <see cref="P:System.ComponentModel.IContainer.Components" /> collection of the <see cref="P:System.ComponentModel.Design.IDesignerHost.Container" />. <see cref="T:System.Windows.Forms.SplitterPanel" /> is an example of one such control.</para>
@@ -589,6 +603,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the internal control designer with the specified index in the <see cref="T:System.Windows.Forms.Design.ControlDesigner" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Windows.Forms.Design.ControlDesigner" /> at the specified index.</para>
+        </returns>
         <param name="internalControlIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />A specified index to select the internal control designer. This index is zero-based.</param>
       </Docs>
@@ -626,7 +644,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An internal control is a control that is not in the <see cref="P:System.ComponentModel.IContainer.Components" /> collection of the <see cref="P:System.ComponentModel.Design.IDesignerHost.Container" />. <see cref="T:System.Windows.Forms.SplitterPanel" /> is an example of one such control.</para>
@@ -635,6 +652,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of internal control designers in the <see cref="T:System.Windows.Forms.Design.ControlDesigner" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of internal control designers in the <see cref="T:System.Windows.Forms.Design.ControlDesigner" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="OnContextMenu">
diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/DockEditor.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/DockEditor.xml
index 33a7df14059..5c7c5987f3f 100644
--- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/DockEditor.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/DockEditor.xml
@@ -46,12 +46,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Edits the specified object value using the editor style provided by GetEditorStyle. A service provider is provided so that any required editing services can be obtained.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new value of the object. If the value of the object hasn't changed, this should return the same object it was passed.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
         <param name="provider">
@@ -74,12 +77,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the editing style of the EditValue method. If the method is not supported, this will return None.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enum value indicating the provided editing style.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/DocumentDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/DocumentDesigner.xml
index 66d07c0f97f..946799ff40a 100644
--- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/DocumentDesigner.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/DocumentDesigner.xml
@@ -107,12 +107,15 @@
         <Parameter Name="selectionType" Type="System.Windows.Forms.Design.Behavior.GlyphSelectionType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Windows.Forms.Design.Behavior.GlyphCollection" /> representing the <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> objects.</para>
+        </returns>
         <param name="selectionType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Design.Behavior.GlyphSelectionType" />  value that specifies the selection state.</param>
       </Docs>
@@ -127,7 +130,6 @@
         <Parameter Name="tool" Type="System.Drawing.Design.ToolboxItem" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If a tool is supported, it will be enabled in the toolbox when the designer receives focus. Otherwise, it will be disabled. Once a tool is marked as enabled or disabled it can not be queried again.</para>
@@ -136,6 +138,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified tool is supported by the designer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the tool should be enabled on the toolbox; false if the document designer doesn't know how to use the tool.</para>
+        </returns>
         <param name="tool">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Design.ToolboxItem" /> to test for toolbox support. </param>
       </Docs>
@@ -310,7 +316,6 @@
         <Parameter Name="technology" Type="System.ComponentModel.Design.ViewTechnology" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.Design.DocumentDesigner" /> instance is cast to an <see cref="T:System.ComponentModel.Design.IRootDesigner" /> interface.</para>
@@ -319,6 +324,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="T:System.ComponentModel.Design.ViewTechnology" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the view for this designer.</para>
+        </returns>
         <param name="technology">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.Design.ViewTechnology" /> that indicates a particular view technology.</param>
       </Docs>
@@ -359,7 +368,6 @@
         <Parameter Name="tool" Type="System.Drawing.Design.ToolboxItem" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Windows.Forms.Design.DocumentDesigner" /> instance is cast to an <see cref="T:System.ComponentModel.Design.IRootDesigner" /> interface.</para>
@@ -368,6 +376,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Drawing.Design.IToolboxUser.GetToolSupported(System.Drawing.Design.ToolboxItem)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the tool is supported by the toolbox and can be enabled; false if the document designer does not know how to use the tool.</para>
+        </returns>
         <param name="tool">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Design.ToolboxItem" /> to be tested for toolbox support.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/EventHandlerService.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/EventHandlerService.xml
index 865323057ff..74df61e6fc0 100644
--- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/EventHandlerService.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/EventHandlerService.xml
@@ -93,7 +93,6 @@
         <Parameter Name="handlerType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You should never cache this value because other components are free to change it. This call is fairly quick, however, especially for cases when you are always asking for the same type of handler.</para>
@@ -102,6 +101,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the currently active event handler of the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the handler, or null if there is no handler of the requested type.</para>
+        </returns>
         <param name="handlerType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the handler to get. </param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/FileNameEditor.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/FileNameEditor.xml
index 7c79f07d4e6..e5741f42cdb 100644
--- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/FileNameEditor.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/FileNameEditor.xml
@@ -50,7 +50,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A service provider is provided so that any required editing services can be obtained.</para>
@@ -59,6 +58,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Edits the specified object using the editor style provided by the <see cref="M:System.Windows.Forms.Design.FileNameEditor.GetEditStyle(System.ComponentModel.ITypeDescriptorContext)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new value of the object. If the value of the object hasn't changed, this should return the same object it was passed.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
         <param name="provider">
@@ -81,7 +84,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="M:System.Windows.Forms.Design.FileNameEditor.EditValue(System.ComponentModel.ITypeDescriptorContext,System.IServiceProvider,System.Object)" /> method is not supported, this method will return <see cref="F:System.Drawing.Design.UITypeEditorEditStyle.None" />.</para>
@@ -90,6 +92,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the editing style used by the <see cref="M:System.Windows.Forms.Design.FileNameEditor.EditValue(System.ComponentModel.ITypeDescriptorContext,System.IServiceProvider,System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> values indicating the provided editing style.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/FolderNameEditor.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/FolderNameEditor.xml
index 8eff80bca5f..c3f2af411ee 100644
--- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/FolderNameEditor.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/FolderNameEditor.xml
@@ -49,12 +49,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Edits the specified object using the editor style provided by <see cref="M:System.Windows.Forms.Design.FolderNameEditor.GetEditStyle(System.ComponentModel.ITypeDescriptorContext)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new value of the object, or the old value if the object couldn't be updated.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
         <param name="provider">
@@ -77,7 +80,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="M:System.Windows.Forms.Design.FolderNameEditor.EditValue(System.ComponentModel.ITypeDescriptorContext,System.IServiceProvider,System.Object)" /> method is not supported, this will return <see cref="F:System.Drawing.Design.UITypeEditorEditStyle.None" />.</para>
@@ -86,6 +88,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the editing style used by the <see cref="M:System.Windows.Forms.Design.FolderNameEditor.EditValue(System.ComponentModel.ITypeDescriptorContext,System.IServiceProvider,System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> enumeration value indicating the provided editing style.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/IMenuEditorService.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/IMenuEditorService.xml
index 0adf90a2d15..b82a72540bd 100644
--- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/IMenuEditorService.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/IMenuEditorService.xml
@@ -26,12 +26,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the current menu.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current <see cref="T:System.Windows.Forms.Menu" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -46,12 +49,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the current menu is active.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current menu is currently active; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ImageListCodeDomSerializer.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ImageListCodeDomSerializer.xml
index 9e2e5b3b223..0e73ad21332 100644
--- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ImageListCodeDomSerializer.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ImageListCodeDomSerializer.xml
@@ -46,7 +46,6 @@
         <Parameter Name="codeObject" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.Design.ImageListCodeDomSerializer.Deserialize(System.ComponentModel.Design.Serialization.IDesignerSerializationManager,System.Object)" /> method uses the serialization manager to create objects and resolve data types.</para>
@@ -55,6 +54,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes the specified serialized Code Document Object Model (CodeDOM) object into an object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The deserialized CodeDOM object.</para>
+        </returns>
         <param name="manager">
           <attribution license="cc4" from="Microsoft" modified="false" />A serialization manager interface that is used during the deserialization process.</param>
         <param name="codeObject">
@@ -75,12 +78,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serializes the specified object into a Code Document Object Model (CodeDOM) object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A CodeDOM object representing the object that has been serialized.</para>
+        </returns>
         <param name="manager">
           <attribution license="cc4" from="Microsoft" modified="false" />The serialization manager to use during serialization.</param>
         <param name="value">
diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ImageListImageEditor.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ImageListImageEditor.xml
index 0867a0736ce..6c1a103fbbf 100644
--- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ImageListImageEditor.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ImageListImageEditor.xml
@@ -47,7 +47,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This editor uses a service provider to obtain any necessary editing services.</para>
@@ -56,6 +55,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Edits the specified object value using the edit style provided by the <see cref="M:System.Drawing.Design.ImageEditor.GetEditStyle(System.ComponentModel.ITypeDescriptorContext)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> representing the new value. If the value of the object has not changed, the <see cref="M:System.Windows.Forms.Design.ImageListImageEditor.EditValue(System.ComponentModel.ITypeDescriptorContext,System.IServiceProvider,System.Object)" /> method returns the object that was passed to it.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
         <param name="provider">
@@ -75,7 +78,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The file dialog box description appears in the file-list filter drop-down list box.</para>
@@ -84,6 +86,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the description for the default file-list filter provided by this editor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The description for the default file-list filter.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetImageExtenders">
@@ -97,12 +103,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of supported image types.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Type" /> representing supported image types.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetPaintValueSupported">
@@ -118,12 +127,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this editor supports painting a representation of an object's value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <see cref="M:System.Drawing.Design.ImageEditor.PaintValue(System.Drawing.Design.PaintValueEventArgs)" /> is implemented; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/MaskDescriptor.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/MaskDescriptor.xml
index 3ff2771d1b1..97cc98b26c5 100644
--- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/MaskDescriptor.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/MaskDescriptor.xml
@@ -71,7 +71,6 @@
         <Parameter Name="maskDescriptor" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.Design.MaskDescriptor.Equals(System.Object)" /> method determines whether <paramref name="maskDescriptor" /> and the current mask descriptor describe the same mask.</para>
@@ -86,6 +85,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Windows.Forms.Design.MaskDescriptor" /> is equal to the current <see cref="T:System.Windows.Forms.Design.MaskDescriptor" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Windows.Forms.Design.MaskDescriptor" /> is equal to the current <see cref="T:System.Windows.Forms.Design.MaskDescriptor" />; otherwise, false. </para>
+        </returns>
         <param name="maskDescriptor">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Design.MaskDescriptor" /> to compare with the current <see cref="T:System.Windows.Forms.Design.MaskDescriptor" />.</param>
       </Docs>
@@ -119,7 +122,6 @@
         <Parameter Name="maskDescriptor" Type="System.Windows.Forms.Design.MaskDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.Design.MaskDescriptor.IsValidMaskDescriptor(System.Windows.Forms.Design.MaskDescriptor)" /> method determines whether <paramref name="maskDescriptor" /> is valid and can be added to the masks list.</para>
@@ -149,6 +151,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified mask descriptor is valid and can be added to the masks list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="maskDescriptor" /> is valid; otherwise, false. </para>
+        </returns>
         <param name="maskDescriptor">
           <attribution license="cc4" from="Microsoft" modified="false" />The mask descriptor to test for validity.</param>
       </Docs>
diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ParentControlDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ParentControlDesigner.xml
index 623cbbf6d5f..b4b8a89c1f0 100644
--- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ParentControlDesigner.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ParentControlDesigner.xml
@@ -128,7 +128,6 @@
         <Parameter Name="control" Type="System.Windows.Forms.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method indicates whether the control managed by the designer can parent the specified <see cref="T:System.Windows.Forms.Design.ControlDesigner" />.</para>
@@ -137,6 +136,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified control can be a child of the control managed by this designer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified control can be a child of the control managed by this designer; otherwise, false.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Windows.Forms.Control" /> to test. </param>
       </Docs>
@@ -156,7 +159,6 @@
       </Parameters>
       <Docs>
         <param name="designer">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method indicates whether the control managed by this designer can parent the control of the specified <see cref="T:System.Windows.Forms.Design.ControlDesigner" />.</para>
@@ -165,6 +167,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the control managed by the specified designer can be a child of the control managed by this designer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the control managed by the specified designer can be a child of the control managed by this designer; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -273,7 +279,6 @@
         <Parameter Name="hasSize" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the only <see cref="Overload:System.Windows.Forms.Design.ParentControlDesigner.CreateTool" /> method that can be overridden.</para>
@@ -282,6 +287,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides core functionality for all the <see cref="M:System.Windows.Forms.Design.ParentControlDesigner.CreateTool(System.Drawing.Design.ToolboxItem)" /> methods.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of components created from the tool.</para>
+        </returns>
         <param name="tool">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Design.ToolboxItem" /> to create a component from. </param>
         <param name="x">
@@ -399,12 +408,15 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the control from the designer of the specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Windows.Forms.Control" /> that the specified component belongs to.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to retrieve the control for. </param>
       </Docs>
@@ -426,7 +438,6 @@
         <Parameter Name="selectionType" Type="System.Windows.Forms.Design.Behavior.GlyphSelectionType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <newTerm>body glyph</newTerm> is responsible for hit testing the control's designer and forwarding messages directly to the designer.</para>
@@ -435,6 +446,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a body glyph that represents the bounds of the control. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A body glyph that represents the bounds of the control.</para>
+        </returns>
         <param name="selectionType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Design.Behavior.GlyphSelectionType" />  value that specifies the selection state.</param>
       </Docs>
@@ -452,7 +467,6 @@
         <Parameter Name="selectionType" Type="System.Windows.Forms.Design.Behavior.GlyphSelectionType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.Design.ParentControlDesigner.GetGlyphs(System.Windows.Forms.Design.Behavior.GlyphSelectionType)" /> method adds a container selector <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> to the selection glyphs collection.</para>
@@ -461,6 +475,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> objects representing the selection borders and grab handles for a standard control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of <see cref="T:System.Windows.Forms.Design.Behavior.Glyph" /> objects.</para>
+        </returns>
         <param name="selectionType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Windows.Forms.Design.Behavior.GlyphSelectionType" />  value that specifies the selection state.</param>
       </Docs>
@@ -478,12 +496,15 @@
         <Parameter Name="component" Type="System.ComponentModel.IComponent" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used by deriving classes to determine if it returns the control being designed or some other <see cref="T:System.ComponentModel.Container" /> while adding a component to it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The parent <see cref="T:System.Windows.Forms.Control" /> for the component.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component for which to retrieve the parent <see cref="T:System.Windows.Forms.Control" />.</param>
       </Docs>
@@ -500,7 +521,6 @@
         <Parameter Name="updateSize" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method aligns the specified rectangle to the grid if grid alignment is enabled.</para>
@@ -509,6 +529,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Updates the position of the specified rectangle, adjusting it for grid alignment if grid alignment mode is enabled.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A rectangle indicating the position of the component in design-time view screen coordinates. If no changes have been made, this method returns the original rectangle.</para>
+        </returns>
         <param name="originalRect">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Rectangle" /> indicating the initial position of the component being updated. </param>
         <param name="dragRect">
diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ScrollableControlDesigner.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ScrollableControlDesigner.xml
index 71ec4e5a177..230e56203b0 100644
--- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ScrollableControlDesigner.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ScrollableControlDesigner.xml
@@ -53,7 +53,6 @@
       </Parameters>
       <Docs>
         <param name="point">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Windows.Forms.Design.ScrollableControlDesigner.GetHitTest(System.Drawing.Point)" /> method determines whether a click at the specified point should be passed to the control, while the control is in design mode. You can override and implement this method to enable your control to receive clicks in the design-time environment.</para>
@@ -65,6 +64,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a mouse click at the specified point should be handled by the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a click at the specified point is to be handled by the control; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ShortcutKeysEditor.xml b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ShortcutKeysEditor.xml
index 9693924c722..d11b867a194 100644
--- a/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ShortcutKeysEditor.xml
+++ b/mcs/class/System.Design/Documentation/en/System.Windows.Forms.Design/ShortcutKeysEditor.xml
@@ -47,12 +47,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Edits the given object value using the editor style provided by the <see cref="M:System.Windows.Forms.Design.ShortcutKeysEditor.GetEditStyle(System.ComponentModel.ITypeDescriptorContext)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new value of the <see cref="T:System.Object" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information.</param>
         <param name="provider">
@@ -74,7 +77,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the method is not supported, this method will return <see cref="F:System.Drawing.Design.UITypeEditorEditStyle.None" />.</para>
@@ -83,6 +85,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the editor style used by the <see cref="Overload:System.Windows.Forms.Design.ShortcutKeysEditor.EditValue" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> value that indicates the style of editor used by the <see cref="Overload:System.Windows.Forms.Design.ShortcutKeysEditor.EditValue" /> method.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information.</param>
       </Docs>
diff --git a/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/DirectoryEntries.xml b/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/DirectoryEntries.xml
index aad3dc02435..6e3e0a9a987 100644
--- a/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/DirectoryEntries.xml
+++ b/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/DirectoryEntries.xml
@@ -82,12 +82,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para> Returns an enumerator that iterates through the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> object that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Add">
@@ -101,7 +104,6 @@
         <Parameter Name="schemaClassName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You must call the <see cref="M:System.DirectoryServices.DirectoryEntry.CommitChanges" /> method on the new entry to make the creation permanent. When you call this method, you can then set mandatory property values on the new entry. The providers each have different requirements for properties that need to be set before a call to the <see cref="M:System.DirectoryServices.DirectoryEntry.CommitChanges" /> method is made. If those requirements are not met, the provider might throw an exception. Check with your provider to determine which properties must be set before committing changes.</para>
@@ -110,6 +112,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new entry in the container.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DirectoryServices.DirectoryEntry" /> object that represents the new entry.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" /> The name of the new entry.</param>
         <param name="schemaClassName">
@@ -149,7 +155,6 @@
       </Parameters>
       <Docs>
         <param name="filter">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If child objects of different types have the same name, the first matching child object is returned.</para>
@@ -162,6 +167,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the member of this collection with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DirectoryServices.DirectoryEntry" /> that represents the child object that was found.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Find">
@@ -177,7 +186,6 @@
       <Docs>
         <param name="filter">To be added.</param>
         <param name="otype">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If no matching result is found, a <see cref="T:System.DirectoryServices.DirectoryServicesCOMException" /> with error code 0x2030 is thrown.</para>
@@ -186,6 +194,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the member of this collection with the specified name and of the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DirectoryServices.DirectoryEntry" /> object that represents the child object that was found.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SchemaFilter">
diff --git a/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/DirectoryEntry.xml b/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/DirectoryEntry.xml
index 0d6d6f1164b..74c7cd70212 100644
--- a/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/DirectoryEntry.xml
+++ b/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/DirectoryEntry.xml
@@ -190,7 +190,6 @@
         <Parameter Name="newParent" Type="System.DirectoryServices.DirectoryEntry" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <see cref="P:System.DirectoryServices.DirectoryEntry.UsePropertyCache" /> is true, call <see cref="M:System.DirectoryServices.DirectoryEntry.CommitChanges" /> on the new object to make the copy permanent.</para>
@@ -200,6 +199,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of this entry as a child of the specified parent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DirectoryServices.DirectoryEntry" /> object that represents the copy of this entry as a child of the new parent.</para>
+        </returns>
         <param name="newParent">
           <attribution license="cc4" from="Microsoft" modified="false" />The distinguished name of the <see cref="T:System.DirectoryServices.DirectoryEntry" /> object that will be the parent for the copy that is being created.</param>
       </Docs>
@@ -243,12 +246,15 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the specified path represents an actual entry in the directory service.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified path represents a valid entry in the directory service; otherwise, false.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path of the entry to verify.</param>
       </Docs>
@@ -342,7 +348,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the return value of the native method implements the IADs interface, a corresponding <see cref="T:System.DirectoryServices.DirectoryEntry" /> is returned. For more information about the IADs interface, see the topic <see cref="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/adsi/adsi/iads.asp">IADs</see> in the MSDN Library at <see cref="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/adsi/adsi/iads.asp">http://msdn.microsoft.com/library</see>.</para>
@@ -351,6 +356,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calls a method on the native Active Directory Domain Services object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value of the invoked method.</para>
+        </returns>
         <param name="methodName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the method to invoke.</param>
         <param name="args">
@@ -368,7 +377,6 @@
         <Parameter Name="newName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The Lightweight Directory Access Protocol (LDAP) provider does not currently support this method.</para>
@@ -378,6 +386,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of this <see cref="T:System.DirectoryServices.DirectoryEntry" /> object, as a child of the specified parent <see cref="T:System.DirectoryServices.DirectoryEntry" /> object, with the specified new name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A renamed copy of this entry as a child of the specified parent.</para>
+        </returns>
         <param name="newParent">
           <attribution license="cc4" from="Microsoft" modified="false" />The DN of the <see cref="T:System.DirectoryServices.DirectoryEntry" /> object that will be the parent for the copy that is being created.</param>
         <param name="newName">
diff --git a/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/DirectorySearcher.xml b/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/DirectorySearcher.xml
index a7bb03a279b..16e7cdff2ec 100644
--- a/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/DirectorySearcher.xml
+++ b/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/DirectorySearcher.xml
@@ -499,7 +499,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If more than one entry is found during the search, only the first entry is returned. If no entries are found to match the search criteria, a null reference (Nothing in Visual Basic) is returned.</para>
@@ -508,6 +507,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the search and returns only the first entry that is found.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DirectoryServices.SearchResult" /> object that contains the first entry that is found during the search.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="FindAll">
@@ -518,7 +521,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Due to implementation restrictions, the <see cref="T:System.DirectoryServices.SearchResultCollection" /> class cannot release all of its unmanaged resources when it is garbage collected. To prevent a memory leak, you must call the <see cref="M:System.DirectoryServices.SearchResultCollection.Dispose" /> method when the <see cref="T:System.DirectoryServices.SearchResultCollection" /> object is no longer needed.</para>
@@ -527,6 +529,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the search and returns a collection of the entries that are found.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DirectoryServices.SearchResultCollection" /> object that contains the results of the search.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CacheResults">
diff --git a/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/DirectoryServicesPermissionEntryCollection.xml b/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/DirectoryServicesPermissionEntryCollection.xml
index 249b8736a94..c2ae708d710 100644
--- a/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/DirectoryServicesPermissionEntryCollection.xml
+++ b/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/DirectoryServicesPermissionEntryCollection.xml
@@ -85,12 +85,15 @@
       </Parameters>
       <Docs>
         <param name="entry">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the specified <see cref="T:System.DirectoryServices.DirectoryServicesPermissionEntry" /> object to this collection.          </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the added <see cref="T:System.DirectoryServices.DirectoryServicesPermissionEntry" /> object that is appended to this collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="AddRange">
@@ -161,12 +164,15 @@
       </Parameters>
       <Docs>
         <param name="entry">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the specified <see cref="T:System.DirectoryServices.DirectoryServicesPermissionEntry" /> object is in this collection.          </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.DirectoryServices.DirectoryServicesPermissionEntry" /> object is in this collection; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IndexOf">
@@ -180,12 +186,15 @@
       </Parameters>
       <Docs>
         <param name="entry">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the first occurrence of the specified <see cref="T:System.DirectoryServices.DirectoryServicesPermissionEntry" /> object in this collection.          </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first matching object.  Returns -1 if no member of this collection is identical to the <see cref="T:System.DirectoryServices.DirectoryServicesPermissionEntry" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Insert">
diff --git a/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/PropertyCollection.xml b/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/PropertyCollection.xml
index 18d960c8070..1fb231426ab 100644
--- a/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/PropertyCollection.xml
+++ b/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/PropertyCollection.xml
@@ -128,12 +128,15 @@
         <Parameter Name="propertyName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified property is in this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value is true if the specified property belongs to this collection; otherwise, false.</para>
+        </returns>
         <param name="propertyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the property to find.</param>
       </Docs>
@@ -146,12 +149,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that you can use to iterate through this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IDictionaryEnumerator" /> that you can use to iterate through this collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Count">
diff --git a/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/PropertyValueCollection.xml b/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/PropertyValueCollection.xml
index 3a4c6823410..8957b1b1b96 100644
--- a/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/PropertyValueCollection.xml
+++ b/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/PropertyValueCollection.xml
@@ -84,12 +84,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the specified <see cref="T:System.DirectoryServices.PropertyValueCollection" /> object to this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the <see cref="T:System.DirectoryServices.PropertyValueCollection" /> object that is appended to this collection.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DirectoryServices.PropertyValueCollection" />  object to append to this collection.</param>
       </Docs>
@@ -140,12 +143,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the index of a specified property value in this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the specified property value. If the object is not found, the return value is -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The property value to find.</param>
       </Docs>
@@ -203,12 +209,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.DirectoryServices.PropertyValueCollection" /> object is in this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified property belongs to this collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DirectoryServices.PropertyValueCollection" /> object to search for in this collection.</param>
       </Docs>
diff --git a/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/ResultPropertyCollection.xml b/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/ResultPropertyCollection.xml
index 5982d2f9ae5..3797923fac5 100644
--- a/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/ResultPropertyCollection.xml
+++ b/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/ResultPropertyCollection.xml
@@ -85,12 +85,15 @@
       </Parameters>
       <Docs>
         <param name="key">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the property that has the specified name belongs to this collection.          </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value is true if the specified property belongs to this collection; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CopyTo">
diff --git a/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/ResultPropertyValueCollection.xml b/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/ResultPropertyValueCollection.xml
index 36f22fbaa05..7cfceb0531d 100644
--- a/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/ResultPropertyValueCollection.xml
+++ b/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/ResultPropertyValueCollection.xml
@@ -81,12 +81,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.DirectoryServices.ResultPropertyValueCollection.Contains(System.Object)" /> method determines whether a specified property value is in this collection.          </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value is true if the specified property belongs to this collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The property value to find.</param>
       </Docs>
@@ -122,12 +125,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.DirectoryServices.ResultPropertyValueCollection.IndexOf(System.Object)" /> method retrieves the index of a specified property value in this collection.          </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the specified property value. If the object is not found, the return value is -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The property value to find.</param>
       </Docs>
diff --git a/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/SchemaNameCollection.xml b/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/SchemaNameCollection.xml
index a200d04351b..901daf7a0b5 100644
--- a/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/SchemaNameCollection.xml
+++ b/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/SchemaNameCollection.xml
@@ -84,12 +84,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends a specified schema name to this collection.          </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the specified property value. If the object is not found, the return value is -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The schema name to add to this collection.</param>
       </Docs>
@@ -136,12 +139,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that you can use to iterate through this collection.          </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator that you can used to iterate through this collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="AddRange">
@@ -191,12 +197,15 @@
       </Parameters>
       <Docs>
         <param name="s">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether this collection contains a specified schema name.          </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value is true if the specified property belongs to this collection; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CopyTo">
@@ -230,12 +239,15 @@
       </Parameters>
       <Docs>
         <param name="s">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of a specified schema name in this collection.          </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the specified schema name, or -1 if the schema name was not found in the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Insert">
diff --git a/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/SearchResult.xml b/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/SearchResult.xml
index 90c20783cff..1d7cf8cca5f 100644
--- a/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/SearchResult.xml
+++ b/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/SearchResult.xml
@@ -67,7 +67,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use <see cref="M:System.DirectoryServices.SearchResult.GetDirectoryEntry" /> when you want to look at the live entry instead of the entry that was returned through <see cref="T:System.DirectoryServices.DirectorySearcher" />, or when you want to invoke a method on the object that was returned.</para>
@@ -79,6 +78,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the <see cref="T:System.DirectoryServices.DirectoryEntry" /> that corresponds to the <see cref="T:System.DirectoryServices.SearchResult" /> from the Active Directory Domain Services hierarchy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DirectoryServices.DirectoryEntry" /> that corresponds to the <see cref="T:System.DirectoryServices.SearchResult" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Properties">
diff --git a/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/SearchResultCollection.xml b/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/SearchResultCollection.xml
index 1093a6331d1..70cd2517c24 100644
--- a/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/SearchResultCollection.xml
+++ b/mcs/class/System.DirectoryServices/Documentation/en/System.DirectoryServices/SearchResultCollection.xml
@@ -116,12 +116,15 @@
       </Parameters>
       <Docs>
         <param name="result">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if a specified <see cref="T:System.DirectoryServices.SearchResult" /> object is in this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified property belongs to this collection; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IndexOf">
@@ -134,12 +137,15 @@
         <Parameter Name="result" Type="System.DirectoryServices.SearchResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the first occurrence of the specified <see cref="T:System.DirectoryServices.SearchResult" /> object in this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first matching object. Returns -1 if no member of this collection is identical to the <see cref="T:System.DirectoryServices.SearchResult" /> object.</para>
+        </returns>
         <param name="result">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DirectoryServices.SearchResult" /> object to search for in this collection.</param>
       </Docs>
@@ -152,12 +158,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that you can use to iterate through this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> object that you can use to iterate through this collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Dispose">
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Design/CategoryNameCollection.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Design/CategoryNameCollection.xml
index 7efdef71d47..e5012278030 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Design/CategoryNameCollection.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Design/CategoryNameCollection.xml
@@ -77,12 +77,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified category is contained in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified category is contained in the collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to check for in the collection. </param>
       </Docs>
@@ -127,12 +130,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index in the collection, or null if the string does not exist in the collection.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The category name to retrieve the index of in the collection. </param>
       </Docs>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Design/IPropertyValueUIService.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Design/IPropertyValueUIService.xml
index 4e8d53a2a03..dab9bfdcb2a 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Design/IPropertyValueUIService.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Design/IPropertyValueUIService.xml
@@ -61,12 +61,15 @@
         <Parameter Name="propDesc" Type="System.ComponentModel.PropertyDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyValueUIItem []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Drawing.Design.PropertyValueUIItem" /> objects that match the specified context and property descriptor characteristics.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Drawing.Design.PropertyValueUIItem" /> objects that match the specified parameters.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
         <param name="propDesc">
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Design/IToolboxService.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Design/IToolboxService.xml
index 642056f25a3..b6e157f5abd 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Design/IToolboxService.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Design/IToolboxService.xml
@@ -293,12 +293,15 @@
         <Parameter Name="serializedObject" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ToolboxItem'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a toolbox item from the specified object that represents a toolbox item in serialized form.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Design.ToolboxItem" /> created from the serialized object.</para>
+        </returns>
         <param name="serializedObject">
           <attribution license="cc4" from="Microsoft" modified="false" />The object that contains the <see cref="T:System.Drawing.Design.ToolboxItem" /> to retrieve. </param>
       </Docs>
@@ -318,12 +321,15 @@
         <Parameter Name="host" Type="System.ComponentModel.Design.IDesignerHost" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ToolboxItem'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a toolbox item from the specified object that represents a toolbox item in serialized form, using the specified designer host.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Design.ToolboxItem" /> created from deserialization.</para>
+        </returns>
         <param name="serializedObject">
           <attribution license="cc4" from="Microsoft" modified="false" />The object that contains the <see cref="T:System.Drawing.Design.ToolboxItem" /> to retrieve. </param>
         <param name="host">
@@ -342,12 +348,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ToolboxItem'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the currently selected toolbox item.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Design.ToolboxItem" /> that is currently selected, or null if no toolbox item has been selected.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -364,7 +373,6 @@
         <Parameter Name="host" Type="System.ComponentModel.Design.IDesignerHost" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ToolboxItem'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns the currently selected <see cref="T:System.Drawing.Design.ToolboxItem" /> if it is not designer specific, and only returns a designer-specific currently selected <see cref="T:System.Drawing.Design.ToolboxItem" /> if the type of the designer host specified in the <paramref name="host" /> parameter matches the type of designer that the currently selected <see cref="T:System.Drawing.Design.ToolboxItem" /> supports.</para>
@@ -373,6 +381,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the currently selected toolbox item if it is available to all designers, or if it supports the specified designer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Design.ToolboxItem" /> that is currently selected, or null if no toolbox item is currently selected.</para>
+        </returns>
         <param name="host">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.IDesignerHost" /> that the selected tool must be associated with for it to be returned. </param>
       </Docs>
@@ -389,12 +401,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ToolboxItemCollection'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the entire collection of toolbox items from the toolbox.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Design.ToolboxItemCollection" /> that contains the current toolbox items.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -411,12 +426,15 @@
         <Parameter Name="host" Type="System.ComponentModel.Design.IDesignerHost" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ToolboxItemCollection'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the collection of toolbox items that are associated with the specified designer host from the toolbox.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Design.ToolboxItemCollection" /> that contains the current toolbox items that are associated with the specified designer host.</para>
+        </returns>
         <param name="host">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.IDesignerHost" /> that is associated with the toolbox items to retrieve. </param>
       </Docs>
@@ -435,12 +453,15 @@
         <Parameter Name="category" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ToolboxItemCollection'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of toolbox items from the toolbox that match the specified category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Design.ToolboxItemCollection" /> that contains the current toolbox items that are associated with the specified category.</para>
+        </returns>
         <param name="category">
           <attribution license="cc4" from="Microsoft" modified="false" />The toolbox item category to retrieve all the toolbox items from. </param>
       </Docs>
@@ -460,12 +481,15 @@
         <Parameter Name="host" Type="System.ComponentModel.Design.IDesignerHost" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ToolboxItemCollection'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the collection of toolbox items that are associated with the specified designer host and category from the toolbox.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Design.ToolboxItemCollection" /> that contains the current toolbox items that are associated with the specified category and designer host.</para>
+        </returns>
         <param name="category">
           <attribution license="cc4" from="Microsoft" modified="false" />The toolbox item category to retrieve the toolbox items from. </param>
         <param name="host">
@@ -487,12 +511,15 @@
         <Parameter Name="filterAttributes" Type="System.Collections.ICollection" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified object which represents a serialized toolbox item matches the specified attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object matches the specified attributes; otherwise, false.</para>
+        </returns>
         <param name="serializedObject">
           <attribution license="cc4" from="Microsoft" modified="false" />The object that contains the <see cref="T:System.Drawing.Design.ToolboxItem" /> to retrieve. </param>
         <param name="filterAttributes">
@@ -514,12 +541,15 @@
         <Parameter Name="host" Type="System.ComponentModel.Design.IDesignerHost" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified object which represents a serialized toolbox item can be used by the specified designer host.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified object is compatible with the specified designer host; otherwise, false.</para>
+        </returns>
         <param name="serializedObject">
           <attribution license="cc4" from="Microsoft" modified="false" />The object that contains the <see cref="T:System.Drawing.Design.ToolboxItem" /> to retrieve. </param>
         <param name="host">
@@ -540,12 +570,15 @@
         <Parameter Name="serializedObject" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified object is a serialized toolbox item.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object contains a toolbox item object; otherwise, false.</para>
+        </returns>
         <param name="serializedObject">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to inspect. </param>
       </Docs>
@@ -565,12 +598,15 @@
         <Parameter Name="host" Type="System.ComponentModel.Design.IDesignerHost" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified object is a serialized toolbox item, using the specified designer host.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object contains a toolbox item object; otherwise, false.</para>
+        </returns>
         <param name="serializedObject">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to inspect. </param>
         <param name="host">
@@ -751,7 +787,6 @@
         <Parameter Name="toolboxItem" Type="System.Drawing.Design.ToolboxItem" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method serializes the specified <see cref="T:System.Drawing.Design.ToolboxItem" /> to an object that can be persisted. The returned object can be stored in a stream or passed around in a drag-and-drop or clipboard operation.</para>
@@ -760,6 +795,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a serializable object that represents the specified toolbox item.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the specified <see cref="T:System.Drawing.Design.ToolboxItem" />.</para>
+        </returns>
         <param name="toolboxItem">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Design.ToolboxItem" /> to serialize. </param>
       </Docs>
@@ -776,7 +815,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If no tool is selected, the cursor will default to the standard Windows cursor.</para>
@@ -785,6 +823,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the current application's cursor to a cursor that represents the currently selected tool.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the cursor is set by the currently selected tool, false if there is no tool selected and the cursor is set to the standard windows cursor.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Design/IToolboxUser.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Design/IToolboxUser.xml
index f8483f06595..3ac23c2ae20 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Design/IToolboxUser.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Design/IToolboxUser.xml
@@ -31,7 +31,6 @@
         <Parameter Name="tool" Type="System.Drawing.Design.ToolboxItem" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the specified tool is supported by the designer implementing the <see cref="T:System.Drawing.Design.IToolboxUser" /> interface, then the tool will be enabled in the toolbox when this designer has focus. Otherwise, it will be disabled. Once a tool is marked as enabled or disabled, it may not be tested for support with the same designer again.</para>
@@ -40,6 +39,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified tool is supported by the current designer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the tool is supported by the toolbox and can be enabled; false if the document designer does not know how to use the tool.</para>
+        </returns>
         <param name="tool">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Design.ToolboxItem" /> to be tested for toolbox support. </param>
       </Docs>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Design/ToolboxItem.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Design/ToolboxItem.xml
index 2db9755f95a..23a988baa34 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Design/ToolboxItem.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Design/ToolboxItem.xml
@@ -262,7 +262,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ComponentModel.IComponent []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Drawing.Design.ToolboxItem.CreateComponents" /> method calls the <see cref="M:System.Drawing.Design.ToolboxItem.CreateComponentsCore(System.ComponentModel.Design.IDesignerHost)" /> method to retrieve an array of type <see cref="T:System.ComponentModel.IComponent" /> containing the components to create.</para>
@@ -271,6 +270,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the components that the toolbox item is configured to create.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of created <see cref="T:System.ComponentModel.IComponent" /> objects.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -287,7 +290,6 @@
         <Parameter Name="host" Type="System.ComponentModel.Design.IDesignerHost" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ComponentModel.IComponent []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Drawing.Design.ToolboxItem.CreateComponents(System.ComponentModel.Design.IDesignerHost)" /> method calls the <see cref="M:System.Drawing.Design.ToolboxItem.CreateComponentsCore(System.ComponentModel.Design.IDesignerHost)" /> method to retrieve an array of type <see cref="T:System.ComponentModel.IComponent" /> containing the components to create.</para>
@@ -296,6 +298,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the components that the toolbox item is configured to create, using the specified designer host.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of created <see cref="T:System.ComponentModel.IComponent" /> objects.</para>
+        </returns>
         <param name="host">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.IDesignerHost" /> to use when creating the components. </param>
       </Docs>
@@ -318,7 +324,6 @@
         <Parameter Name="defaultValues" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Drawing.Design.ToolboxItem.CreateComponents(System.ComponentModel.Design.IDesignerHost,System.Collections.IDictionary)" /> method calls the <see cref="M:System.Drawing.Design.ToolboxItem.CreateComponentsCore(System.ComponentModel.Design.IDesignerHost,System.Collections.IDictionary)" /> method to retrieve an array of type <see cref="T:System.ComponentModel.IComponent" /> containing the components to create.</para>
@@ -327,6 +332,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the components that the toolbox item is configured to create, using the specified designer host and default values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of created <see cref="T:System.ComponentModel.IComponent" /> objects.</para>
+        </returns>
         <param name="host">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.IDesignerHost" /> to use when creating the components.</param>
         <param name="defaultValues">
@@ -343,7 +352,6 @@
         <Parameter Name="host" Type="System.ComponentModel.Design.IDesignerHost" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ComponentModel.IComponent []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="host" /> is not null, the <see cref="M:System.Drawing.Design.ToolboxItem.CreateComponentsCore(System.ComponentModel.Design.IDesignerHost)" /> method adds the new components to the designer.</para>
@@ -352,6 +360,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a component or an array of components when the toolbox item is invoked.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of created <see cref="T:System.ComponentModel.IComponent" /> objects.</para>
+        </returns>
         <param name="host">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.IDesignerHost" /> to host the toolbox item. </param>
       </Docs>
@@ -374,7 +386,6 @@
         <Parameter Name="defaultValues" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="host" /> is not null, the <see cref="M:System.Drawing.Design.ToolboxItem.CreateComponentsCore(System.ComponentModel.Design.IDesignerHost,System.Collections.IDictionary)" /> method adds the new components to the designer.</para>
@@ -383,6 +394,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an array of components when the toolbox item is invoked.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of created <see cref="T:System.ComponentModel.IComponent" /> objects.</para>
+        </returns>
         <param name="host">
           <attribution license="cc4" from="Microsoft" modified="false" />The designer host to use when creating components.</param>
         <param name="defaultValues">
@@ -489,12 +504,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two <see cref="T:System.Drawing.Design.ToolboxItem" /> instances are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Drawing.Design.ToolboxItem" /> is equal to the current <see cref="T:System.Drawing.Design.ToolboxItem" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Design.ToolboxItem" /> to compare with the current <see cref="T:System.Drawing.Design.ToolboxItem" />.</param>
       </Docs>
@@ -542,7 +560,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Drawing.Design.ToolboxItem.FilterPropertyValue(System.String,System.Object)" /> method enables a property to always clone values, or to provide a default value when none exists.</para>
@@ -551,6 +568,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Filters a property value before returning it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A filtered property value.</para>
+        </returns>
         <param name="propertyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the property to filter.</param>
         <param name="value">
@@ -565,12 +586,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.Drawing.Design.ToolboxItem" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -590,7 +614,6 @@
         <Parameter Name="host" Type="System.ComponentModel.Design.IDesignerHost" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The designer host is used to access an implementation of the <see cref="T:System.ComponentModel.Design.ITypeResolutionService" /> interface. However, the loaded type is not added to the list of references in the designer host.</para>
@@ -599,6 +622,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Enables access to the type associated with the toolbox item.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type associated with the toolbox item.</para>
+        </returns>
         <param name="host">
           <attribution license="cc4" from="Microsoft" modified="false" />The designer host to query for <see cref="T:System.ComponentModel.Design.ITypeResolutionService" />.</param>
       </Docs>
@@ -616,12 +643,15 @@
         <Parameter Name="reference" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Type'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the specified type, optionally using a specified designer host and assembly name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the specified type, if it can be located.</para>
+        </returns>
         <param name="host">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.IDesignerHost" /> for the current document. This can be null. </param>
         <param name="assemblyName">
@@ -880,12 +910,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.String" /> that represents the current <see cref="T:System.Drawing.Design.ToolboxItem" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that represents the current <see cref="T:System.Drawing.Design.ToolboxItem" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -964,7 +997,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Drawing.Design.ToolboxItem.ValidatePropertyValue(System.String,System.Object)" /> method is called whenever a value is set in the property dictionary. With this method, you can change the value of an object before committing it, or reject it by throwing an exception.</para>
@@ -973,6 +1005,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates a property before it is assigned to the property dictionary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value used to perform validation.</para>
+        </returns>
         <param name="propertyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the property to validate.</param>
         <param name="value">
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Design/ToolboxItemCollection.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Design/ToolboxItemCollection.xml
index 944a6064a56..0a40b7e9a76 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Design/ToolboxItemCollection.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Design/ToolboxItemCollection.xml
@@ -74,12 +74,15 @@
         <Parameter Name="value" Type="System.Drawing.Design.ToolboxItem" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the collection contains the specified <see cref="T:System.Drawing.Design.ToolboxItem" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the specified object; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Design.ToolboxItem" /> to search the collection for. </param>
       </Docs>
@@ -124,12 +127,15 @@
         <Parameter Name="value" Type="System.Drawing.Design.ToolboxItem" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the specified <see cref="T:System.Drawing.Design.ToolboxItem" />, if it exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified <see cref="T:System.Drawing.Design.ToolboxItem" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Design.ToolboxItem" /> to get the index of in the collection. </param>
       </Docs>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Design/UITypeEditor.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Design/UITypeEditor.xml
index 4de8f0f2722..308654d5ca0 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Design/UITypeEditor.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Design/UITypeEditor.xml
@@ -81,7 +81,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method launches the user interface for value editing, and is called by the Properties window when a user attempts to edit the value of a type that this editor is configured to edit the value of. A service provider is provided so that the editor can obtain any required services.</para>
@@ -90,6 +89,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Edits the value of the specified object using the editor style indicated by the <see cref="M:System.Drawing.Design.UITypeEditor.GetEditStyle" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new value of the object.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IServiceProvider" /> that this editor can use to obtain services. </param>
         <param name="value">
@@ -112,7 +115,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A service provider is provided so that the editor can obtain any required services.</para>
@@ -121,6 +123,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Edits the specified object's value using the editor style indicated by the <see cref="M:System.Drawing.Design.UITypeEditor.GetEditStyle" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new value of the object. If the value of the object has not changed, this should return the same object it was passed.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
         <param name="provider">
@@ -141,7 +147,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'UITypeEditorEditStyle'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If a <see cref="T:System.Drawing.Design.UITypeEditor" /> does not override and implement this method, <see cref="M:System.Drawing.Design.UITypeEditor.GetEditStyle" /> will return <see cref="F:System.Drawing.Design.UITypeEditorEditStyle.None" /> by default.</para>
@@ -150,6 +155,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the editor style used by the <see cref="M:System.Drawing.Design.UITypeEditor.EditValue(System.IServiceProvider,System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> enumeration value that indicates the style of editor used by the current <see cref="T:System.Drawing.Design.UITypeEditor" />. By default, this method will return <see cref="F:System.Drawing.Design.UITypeEditorEditStyle.None" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -166,12 +175,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'UITypeEditorEditStyle'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the editor style used by the <see cref="M:System.Drawing.Design.UITypeEditor.EditValue(System.IServiceProvider,System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Design.UITypeEditorEditStyle" /> value that indicates the style of editor used by the <see cref="M:System.Drawing.Design.UITypeEditor.EditValue(System.IServiceProvider,System.Object)" /> method. If the <see cref="T:System.Drawing.Design.UITypeEditor" /> does not support this method, then <see cref="M:System.Drawing.Design.UITypeEditor.GetEditStyle" /> will return <see cref="F:System.Drawing.Design.UITypeEditorEditStyle.None" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
       </Docs>
@@ -188,12 +200,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether this editor supports painting a representation of an object's value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <see cref="M:System.Drawing.Design.UITypeEditor.PaintValue(System.Object,System.Drawing.Graphics,System.Drawing.Rectangle)" /> is implemented; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -210,12 +225,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified context supports painting a representation of an object's value within the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <see cref="M:System.Drawing.Design.UITypeEditor.PaintValue(System.Object,System.Drawing.Graphics,System.Drawing.Rectangle)" /> is implemented; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to gain additional context information. </param>
       </Docs>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Drawing2D/CustomLineCap.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Drawing2D/CustomLineCap.xml
index cdc1962cb8a..a6a52bc3245 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Drawing2D/CustomLineCap.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Drawing2D/CustomLineCap.xml
@@ -177,12 +177,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this <see cref="T:System.Drawing.Drawing2D.CustomLineCap" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Drawing2D.CustomLineCap" /> this method creates, cast as an object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -205,6 +208,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Releases all resources used by this <see cref="T:System.Drawing.Drawing2D.CustomLineCap" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Drawing2D/GraphicsPath.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Drawing2D/GraphicsPath.xml
index f1c52f73b87..a16031098f5 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Drawing2D/GraphicsPath.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Drawing2D/GraphicsPath.xml
@@ -1588,12 +1588,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Drawing2D.GraphicsPath" /> this method creates, cast as an object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1654,6 +1657,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Releases all resources used by this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1773,7 +1780,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Drawing.RectangleF'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The size of the returned bounding rectangle is influenced by the type of end caps, pen width, and pen miter limit, and therefore produces a "loose fit" to the bounded path. The approximate formula is: the initial bounding rectangle is inflated by pen width, and this result is multiplied by the miter limit, plus some additional margin to allow for end caps.</para>
@@ -1782,6 +1788,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a rectangle that bounds this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.RectangleF" /> that represents a rectangle that bounds this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1798,7 +1808,6 @@
         <Parameter Name="matrix" Type="System.Drawing.Drawing2D.Matrix" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Drawing.RectangleF'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The size of the returned bounding rectangle is influenced by the type of end caps, pen width, and pen miter limit, and therefore produces a "loose fit" to the bounded path. The approximate formula is: the initial bounding rectangle is inflated by pen width, and this result is multiplied by the miter limit, plus some additional margin to allow for end caps.</para>
@@ -1807,6 +1816,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a rectangle that bounds this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" /> when this path is transformed by the specified <see cref="T:System.Drawing.Drawing2D.Matrix" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.RectangleF" /> that represents a rectangle that bounds this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" />.</para>
+        </returns>
         <param name="matrix">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Drawing2D.Matrix" /> that specifies a transformation to be applied to this path before the bounding rectangle is calculated. This path is not permanently transformed; the transformation is used only during the process of calculating the bounding rectangle. </param>
       </Docs>
@@ -1826,7 +1839,6 @@
         <Parameter Name="pen" Type="System.Drawing.Pen" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Drawing.RectangleF'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The size of the returned bounding rectangle is influenced by the type of end caps, pen width, and pen miter limit, and therefore produces a "loose fit" to the bounded path. The approximate formula is: the initial bounding rectangle is inflated by pen width, and this result is multiplied by the miter limit, plus some additional margin to allow for end caps.</para>
@@ -1835,6 +1847,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a rectangle that bounds this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" /> when the current path is transformed by the specified <see cref="T:System.Drawing.Drawing2D.Matrix" /> and drawn with the specified <see cref="T:System.Drawing.Pen" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.RectangleF" /> that represents a rectangle that bounds this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" />.</para>
+        </returns>
         <param name="matrix">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Drawing2D.Matrix" /> that specifies a transformation to be applied to this path before the bounding rectangle is calculated. This path is not permanently transformed; the transformation is used only during the process of calculating the bounding rectangle. </param>
         <param name="pen">
@@ -1853,12 +1869,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Drawing.PointF'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the last point in the <see cref="P:System.Drawing.Drawing2D.GraphicsPath.PathPoints" /> array of this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.PointF" /> that represents the last point in this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1876,7 +1895,6 @@
         <Parameter Name="pen" Type="System.Drawing.Pen" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method tests to see if the outline of a given path is rendered visible at the specified point.</para>
@@ -1885,6 +1903,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified point is contained within (under) the outline of this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" /> when drawn with the specified <see cref="T:System.Drawing.Pen" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if the specified point is contained within the outline of this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" /> when drawn with the specified <see cref="T:System.Drawing.Pen" />; otherwise, false.</para>
+        </returns>
         <param name="point">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Point" /> that specifies the location to test. </param>
         <param name="pen">
@@ -1906,7 +1928,6 @@
         <Parameter Name="pen" Type="System.Drawing.Pen" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method tests to see if the outline of a given path is rendered visible at the specified point.</para>
@@ -1915,6 +1936,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified point is contained within (under) the outline of this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" /> when drawn with the specified <see cref="T:System.Drawing.Pen" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if the specified point is contained within the outline of this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" /> when drawn with the specified <see cref="T:System.Drawing.Pen" />; otherwise, false.</para>
+        </returns>
         <param name="point">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.PointF" /> that specifies the location to test. </param>
         <param name="pen">
@@ -1937,7 +1962,6 @@
         <Parameter Name="graphics" Type="System.Drawing.Graphics" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method tests to see if the outline of a given path is rendered visible at the specified point. The coordinates of the point to be tested are given in world coordinates. The transform matrix of <paramref name="graphics" /> is temporarily applied before testing for visibility.</para>
@@ -1946,6 +1970,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified point is contained within (under) the outline of this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" /> when drawn with the specified <see cref="T:System.Drawing.Pen" /> and using the specified <see cref="T:System.Drawing.Graphics" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if the specified point is contained within the outline of this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" /> as drawn with the specified <see cref="T:System.Drawing.Pen" />; otherwise, false.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Point" /> that specifies the location to test. </param>
         <param name="pen">
@@ -1970,7 +1998,6 @@
         <Parameter Name="graphics" Type="System.Drawing.Graphics" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method tests to see if the outline of a given path is rendered visible at the specified point. The coordinates of the point to be tested are given in world coordinates. The transform matrix of <paramref name="graphics" /> is temporarily applied before testing for visibility.</para>
@@ -1979,6 +2006,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified point is contained within (under) the outline of this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" /> when drawn with the specified <see cref="T:System.Drawing.Pen" /> and using the specified <see cref="T:System.Drawing.Graphics" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if the specified point is contained within (under) the outline of this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" /> as drawn with the specified <see cref="T:System.Drawing.Pen" />; otherwise, false.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.PointF" /> that specifies the location to test. </param>
         <param name="pen">
@@ -2003,7 +2034,6 @@
         <Parameter Name="pen" Type="System.Drawing.Pen" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method tests to see if the outline of a given path is rendered visible at the specified point.</para>
@@ -2012,6 +2042,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified point is contained within (under) the outline of this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" /> when drawn with the specified <see cref="T:System.Drawing.Pen" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if the specified point is contained within the outline of this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" /> when drawn with the specified <see cref="T:System.Drawing.Pen" />; otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate of the point to test. </param>
         <param name="y">
@@ -2036,7 +2070,6 @@
         <Parameter Name="pen" Type="System.Drawing.Pen" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method tests to see if the outline of a given path is rendered visible at the specified point.</para>
@@ -2045,6 +2078,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified point is contained within (under) the outline of this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" /> when drawn with the specified <see cref="T:System.Drawing.Pen" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if the specified point is contained within the outline of this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" /> when drawn with the specified <see cref="T:System.Drawing.Pen" />; otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate of the point to test. </param>
         <param name="y">
@@ -2070,7 +2107,6 @@
         <Parameter Name="graphics" Type="System.Drawing.Graphics" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method tests to see if the outline of a given path is rendered visible at the specified point. The coordinates of the point to be tested are given in world coordinates. The transform matrix of <paramref name="graphics" /> is temporarily applied before testing for visibility.</para>
@@ -2079,6 +2115,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified point is contained within (under) the outline of this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" /> when drawn with the specified <see cref="T:System.Drawing.Pen" /> and using the specified <see cref="T:System.Drawing.Graphics" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if the specified point is contained within the outline of this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" /> as drawn with the specified <see cref="T:System.Drawing.Pen" />; otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate of the point to test. </param>
         <param name="y">
@@ -2106,7 +2146,6 @@
         <Parameter Name="graphics" Type="System.Drawing.Graphics" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method tests to see if the outline of a given path is rendered visible at the specified point. The coordinates of the point to be tested are given in world coordinates. The transform matrix of the <paramref name="graphics" /> parameter is temporarily applied before testing for visibility.</para>
@@ -2115,6 +2154,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified point is contained within (under) the outline of this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" /> when drawn with the specified <see cref="T:System.Drawing.Pen" /> and using the specified <see cref="T:System.Drawing.Graphics" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if the specified point is contained within (under) the outline of this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" /> as drawn with the specified <see cref="T:System.Drawing.Pen" />; otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate of the point to test. </param>
         <param name="y">
@@ -2139,12 +2182,15 @@
         <Parameter Name="point" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified point is contained within this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if the specified point is contained within this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" />; otherwise, false.</para>
+        </returns>
         <param name="point">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Point" /> that represents the point to test. </param>
       </Docs>
@@ -2163,12 +2209,15 @@
         <Parameter Name="point" Type="System.Drawing.PointF" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified point is contained within this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if the specified point is contained within this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" />; otherwise, false.</para>
+        </returns>
         <param name="point">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.PointF" /> that represents the point to test. </param>
       </Docs>
@@ -2188,7 +2237,6 @@
         <Parameter Name="graphics" Type="System.Drawing.Graphics" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The coordinates of the point to be tested are given in world coordinates. The transform matrix of the <paramref name="graphics" /> parameter is temporarily applied before testing for visibility.</para>
@@ -2197,6 +2245,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified point is contained within this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if the specified point is contained within this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" />; otherwise, false.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Point" /> that represents the point to test. </param>
         <param name="graphics">
@@ -2218,7 +2270,6 @@
         <Parameter Name="graphics" Type="System.Drawing.Graphics" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The coordinates of the point to be tested are given in world coordinates. The transform matrix of the <paramref name="graphics" /> parameter is temporarily applied before testing for visibility.</para>
@@ -2227,6 +2278,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified point is contained within this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if the specified point is contained within this; otherwise, false.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.PointF" /> that represents the point to test. </param>
         <param name="graphics">
@@ -2248,12 +2303,15 @@
         <Parameter Name="y" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified point is contained within this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if the specified point is contained within this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" />; otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate of the point to test. </param>
         <param name="y">
@@ -2275,12 +2333,15 @@
         <Parameter Name="y" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified point is contained within this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if the specified point is contained within this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" />; otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate of the point to test. </param>
         <param name="y">
@@ -2303,7 +2364,6 @@
         <Parameter Name="graphics" Type="System.Drawing.Graphics" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The coordinates of the point to be tested are given in world coordinates. The transform matrix of <paramref name="graphics" /> is temporarily applied before testing for visibility.</para>
@@ -2312,6 +2372,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified point is contained within this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" />, using the specified <see cref="T:System.Drawing.Graphics" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if the specified point is contained within this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" />; otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate of the point to test. </param>
         <param name="y">
@@ -2336,7 +2400,6 @@
         <Parameter Name="graphics" Type="System.Drawing.Graphics" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The coordinates of the point to be tested are given in world coordinates. The transform matrix of the <paramref name="graphics" /> parameter is temporarily applied before testing for visibility.</para>
@@ -2345,6 +2408,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified point is contained within this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" /> in the visible clip region of the specified <see cref="T:System.Drawing.Graphics" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if the specified point is contained within this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" />; otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate of the point to test. </param>
         <param name="y">
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Drawing2D/GraphicsPathIterator.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Drawing2D/GraphicsPathIterator.xml
index 8d624b2d2e6..39077d1a92e 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Drawing2D/GraphicsPathIterator.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Drawing2D/GraphicsPathIterator.xml
@@ -107,6 +107,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Releases all resources used by this <see cref="T:System.Drawing.Drawing2D.GraphicsPathIterator" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -159,7 +163,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>All curves in a path are stored as sequences of Bézier splines. For example, when you add an ellipse to a path, you specify the upper-left corner, the width, and the height of the ellipse's bounding rectangle. Those numbers (upper-left corner, width, and height) are not stored in the path; instead; the ellipse is converted to a sequence of four Bézier splines. The path stores the endpoints and control points of those Bézier splines.</para>
@@ -170,6 +173,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the path associated with this <see cref="T:System.Drawing.Drawing2D.GraphicsPathIterator" /> contains a curve.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if the current subpath contains a curve; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -186,7 +193,6 @@
         <Parameter Name="path" Type="System.Drawing.Drawing2D.GraphicsPath" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Drawing.Drawing2D.GraphicsPath.SetMarkers" /> method to set markers in a path. Markers are used to create groups of subpaths. One or more subpaths can be between two markers.</para>
@@ -195,6 +201,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This <see cref="T:System.Drawing.Drawing2D.GraphicsPathIterator" /> object has a <see cref="T:System.Drawing.Drawing2D.GraphicsPath" /> object associated with it. The <see cref="M:System.Drawing.Drawing2D.GraphicsPathIterator.NextMarker(System.Drawing.Drawing2D.GraphicsPath)" /> method increments the associated <see cref="T:System.Drawing.Drawing2D.GraphicsPath" /> to the next marker in its path and copies all the points contained between the current marker and the next marker (or end of path) to a second <see cref="T:System.Drawing.Drawing2D.GraphicsPath" /> object passed in to the parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of points between this marker and the next.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Drawing2D.GraphicsPath" /> object to which the points will be copied. </param>
       </Docs>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Drawing2D/HatchBrush.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Drawing2D/HatchBrush.xml
index e1be29dcedc..842ccea6a7f 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Drawing2D/HatchBrush.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Drawing2D/HatchBrush.xml
@@ -114,12 +114,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this <see cref="T:System.Drawing.Drawing2D.HatchBrush" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Drawing2D.HatchBrush" /> this method creates, cast as an object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Drawing2D/LinearGradientBrush.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Drawing2D/LinearGradientBrush.xml
index 04bb3f52a79..f7b6e3f3fc8 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Drawing2D/LinearGradientBrush.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Drawing2D/LinearGradientBrush.xml
@@ -327,12 +327,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this <see cref="T:System.Drawing.Drawing2D.LinearGradientBrush" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Drawing2D.LinearGradientBrush" /> this method creates, cast as an object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Drawing2D/Matrix.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Drawing2D/Matrix.xml
index 7a6d3821809..45345ec86e7 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Drawing2D/Matrix.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Drawing2D/Matrix.xml
@@ -190,12 +190,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Matrix'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this <see cref="T:System.Drawing.Drawing2D.Matrix" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Drawing2D.Matrix" /> that this method creates.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -218,6 +221,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Releases all resources used by this <see cref="T:System.Drawing.Drawing2D.Matrix" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -256,12 +263,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether the specified object is a <see cref="T:System.Drawing.Drawing2D.Matrix" /> and is identical to this <see cref="T:System.Drawing.Drawing2D.Matrix" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if <paramref name="obj" /> is the specified <see cref="T:System.Drawing.Drawing2D.Matrix" /> identical to this <see cref="T:System.Drawing.Drawing2D.Matrix" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test. </param>
       </Docs>
@@ -294,12 +304,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for this <see cref="T:System.Drawing.Drawing2D.Matrix" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Drawing2D/PathGradientBrush.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Drawing2D/PathGradientBrush.xml
index c2e3478cf66..39ee47718ce 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Drawing2D/PathGradientBrush.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Drawing2D/PathGradientBrush.xml
@@ -211,12 +211,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this <see cref="T:System.Drawing.Drawing2D.PathGradientBrush" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Drawing2D.PathGradientBrush" /> this method creates, cast as an object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/EncoderParameter.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/EncoderParameter.xml
index 08629c7fdad..11ac0990977 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/EncoderParameter.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/EncoderParameter.xml
@@ -467,6 +467,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Releases all resources used by this <see cref="T:System.Drawing.Imaging.EncoderParameter" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/EncoderParameters.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/EncoderParameters.xml
index 91a84d8bdaf..c7dc4f98be4 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/EncoderParameters.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/EncoderParameters.xml
@@ -82,6 +82,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Releases all resources used by this <see cref="T:System.Drawing.Imaging.EncoderParameters" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/FrameDimension.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/FrameDimension.xml
index 2cf516bce70..5e222de22a5 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/FrameDimension.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/FrameDimension.xml
@@ -52,12 +52,15 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the specified object is a <see cref="T:System.Drawing.Imaging.FrameDimension" /> equivalent to this <see cref="T:System.Drawing.Imaging.FrameDimension" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if <paramref name="o" /> is a <see cref="T:System.Drawing.Imaging.FrameDimension" /> equivalent to this <see cref="T:System.Drawing.Imaging.FrameDimension" /> object; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test. </param>
       </Docs>
@@ -74,12 +77,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash code for this <see cref="T:System.Drawing.Imaging.FrameDimension" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an int value that is the hash code of this <see cref="T:System.Drawing.Imaging.FrameDimension" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -170,12 +176,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Drawing.Imaging.FrameDimension" /> object to a human-readable string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents this <see cref="T:System.Drawing.Imaging.FrameDimension" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/ImageAttributes.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/ImageAttributes.xml
index 50895f02d6e..8faef2b094b 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/ImageAttributes.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/ImageAttributes.xml
@@ -66,6 +66,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clears the brush color-remap table of this <see cref="T:System.Drawing.Imaging.ImageAttributes" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -115,6 +119,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clears the color key (transparency range) for a specified category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />An element of <see cref="T:System.Drawing.Imaging.ColorAdjustType" /> that specifies the category for which the color key is cleared. </param>
       </Docs>
@@ -140,6 +148,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clears the color-adjustment matrix for the default category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -166,6 +178,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clears the color-adjustment matrix for a specified category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />An element of <see cref="T:System.Drawing.Imaging.ColorAdjustType" /> that specifies the category for which the color-adjustment matrix is cleared. </param>
       </Docs>
@@ -217,6 +233,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Disables gamma correction for a specified category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />An element of <see cref="T:System.Drawing.Imaging.ColorAdjustType" /> that specifies the category for which gamma correction is disabled. </param>
       </Docs>
@@ -267,6 +287,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clears the NoOp setting for a specified category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />An element of <see cref="T:System.Drawing.Imaging.ColorAdjustType" /> that specifies the category for which the NoOp setting is cleared. </param>
       </Docs>
@@ -318,6 +342,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clears the (cyan-magenta-yellow-black) output channel setting for a specified category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />An element of <see cref="T:System.Drawing.Imaging.ColorAdjustType" /> that specifies the category for which the output channel setting is cleared. </param>
       </Docs>
@@ -369,6 +397,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clears the output channel color profile setting for a specified category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />An element of <see cref="T:System.Drawing.Imaging.ColorAdjustType" /> that specifies the category for which the output channel profile setting is cleared. </param>
       </Docs>
@@ -420,6 +452,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clears the color-remap table for a specified category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />An element of <see cref="T:System.Drawing.Imaging.ColorAdjustType" /> that specifies the category for which the remap table is cleared. </param>
       </Docs>
@@ -446,6 +482,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clears the threshold value for the default category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -473,6 +513,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clears the threshold value for a specified category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />An element of <see cref="T:System.Drawing.Imaging.ColorAdjustType" /> that specifies the category for which the threshold is cleared. </param>
       </Docs>
@@ -489,12 +533,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this <see cref="T:System.Drawing.Imaging.ImageAttributes" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Imaging.ImageAttributes" /> object this class creates, cast as an object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -520,6 +567,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Releases all resources used by this <see cref="T:System.Drawing.Imaging.ImageAttributes" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -562,6 +613,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adjusts the colors in a palette according to the adjustment settings of a specified category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="palette">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Imaging.ColorPalette" /> that on input contains the palette to be adjusted, and on output contains the adjusted palette. </param>
         <param name="type">
@@ -592,6 +647,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the color-remap table for the brush category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="map">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Drawing.Imaging.ColorMap" /> objects. </param>
       </Docs>
@@ -621,6 +680,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the color key for the default category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="colorLow">
           <attribution license="cc4" from="Microsoft" modified="false" />The low color-key value. </param>
         <param name="colorHigh">
@@ -654,6 +717,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the color key (transparency range) for a specified category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="colorLow">
           <attribution license="cc4" from="Microsoft" modified="false" />The low color-key value. </param>
         <param name="colorHigh">
@@ -687,6 +754,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the color-adjustment matrix and the grayscale-adjustment matrix for the default category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="newColorMatrix">
           <attribution license="cc4" from="Microsoft" modified="false" />The color-adjustment matrix. </param>
         <param name="grayMatrix">
@@ -718,6 +789,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the color-adjustment matrix and the grayscale-adjustment matrix for the default category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="newColorMatrix">
           <attribution license="cc4" from="Microsoft" modified="false" />The color-adjustment matrix. </param>
         <param name="grayMatrix">
@@ -753,6 +828,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the color-adjustment matrix and the grayscale-adjustment matrix for a specified category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="newColorMatrix">
           <attribution license="cc4" from="Microsoft" modified="false" />The color-adjustment matrix. </param>
         <param name="grayMatrix">
@@ -788,6 +867,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the color-adjustment matrix for the default category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -816,6 +899,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the color-adjustment matrix for the default category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -847,6 +934,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the color-adjustment matrix for a specified category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -874,6 +965,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the gamma value for the default category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="gamma">
           <attribution license="cc4" from="Microsoft" modified="false" />The gamma correction value. </param>
       </Docs>
@@ -906,6 +1001,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the gamma value for a specified category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="gamma">
           <attribution license="cc4" from="Microsoft" modified="false" />The gamma correction value. </param>
       </Docs>
@@ -955,6 +1054,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Turns off color adjustment for a specified category. You can call the <see cref="Overload:System.Drawing.Imaging.ImageAttributes.ClearNoOp" /> method to reinstate the color-adjustment settings that were in place before the call to the <see cref="Overload:System.Drawing.Imaging.ImageAttributes.SetNoOp" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />An element of <see cref="T:System.Drawing.Imaging.ColorAdjustType" /> that specifies the category for which color correction is turned off. </param>
       </Docs>
@@ -1062,6 +1165,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the output channel color-profile file for the default category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="colorProfileFilename">
           <attribution license="cc4" from="Microsoft" modified="false" />The path name of a color-profile file. If the color-profile file is in the %SystemRoot%\System32\Spool\Drivers\Color directory, this parameter can be the file name. Otherwise, this parameter must be the fully qualified path name. </param>
       </Docs>
@@ -1110,6 +1217,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the output channel color-profile file for a specified category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="colorProfileFilename">
           <attribution license="cc4" from="Microsoft" modified="false" />The path name of a color-profile file. If the color-profile file is in the %SystemRoot%\System32\Spool\Drivers\Color directory, this parameter can be the file name. Otherwise, this parameter must be the fully qualified path name. </param>
         <param name="type">
@@ -1140,6 +1251,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the color-remap table for the default category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="map">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of color pairs of type <see cref="T:System.Drawing.Imaging.ColorMap" />. Each color pair contains an existing color (the first value) and the color that it will be mapped to (the second value). </param>
       </Docs>
@@ -1170,6 +1285,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the color-remap table for a specified category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="map">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of color pairs of type <see cref="T:System.Drawing.Imaging.ColorMap" />. Each color pair contains an existing color (the first value) and the color that it will be mapped to (the second value). </param>
         <param name="type">
@@ -1200,6 +1319,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the threshold (transparency range) for the default category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="threshold">
           <attribution license="cc4" from="Microsoft" modified="false" />A real number that specifies the threshold value. </param>
       </Docs>
@@ -1230,6 +1353,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the threshold (transparency range) for a specified category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="threshold">
           <attribution license="cc4" from="Microsoft" modified="false" />A threshold value from 0.0 to 1.0 that is used as a breakpoint to sort colors that will be mapped to either a maximum or a minimum value. </param>
         <param name="type">
@@ -1258,6 +1385,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the wrap mode that is used to decide how to tile a texture across a shape, or at shape boundaries. A texture is tiled across a shape to fill it in when the texture is smaller than the shape it is filling.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="mode">
           <attribution license="cc4" from="Microsoft" modified="false" />An element of <see cref="T:System.Drawing.Drawing2D.WrapMode" /> that specifies how repeated copies of an image are used to tile an area. </param>
       </Docs>
@@ -1282,6 +1413,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the wrap mode and color used to decide how to tile a texture across a shape, or at shape boundaries. A texture is tiled across a shape to fill it in when the texture is smaller than the shape it is filling.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="mode">
           <attribution license="cc4" from="Microsoft" modified="false" />An element of <see cref="T:System.Drawing.Drawing2D.WrapMode" /> that specifies how repeated copies of an image are used to tile an area. </param>
         <param name="color">
@@ -1309,6 +1444,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the wrap mode and color used to decide how to tile a texture across a shape, or at shape boundaries. A texture is tiled across a shape to fill it in when the texture is smaller than the shape it is filling.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="mode">
           <attribution license="cc4" from="Microsoft" modified="false" />An element of <see cref="T:System.Drawing.Drawing2D.WrapMode" /> that specifies how repeated copies of an image are used to tile an area. </param>
         <param name="color">
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/ImageCodecInfo.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/ImageCodecInfo.xml
index c4c5c0215e2..c1bebe341fa 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/ImageCodecInfo.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/ImageCodecInfo.xml
@@ -179,12 +179,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ImageCodecInfo []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of <see cref="T:System.Drawing.Imaging.ImageCodecInfo" /> objects that contain information about the image decoders built into GDI+.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Drawing.Imaging.ImageCodecInfo" /> objects. Each <see cref="T:System.Drawing.Imaging.ImageCodecInfo" /> object in the array contains information about one of the built-in image decoders.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -199,12 +202,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ImageCodecInfo []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of <see cref="T:System.Drawing.Imaging.ImageCodecInfo" /> objects that contain information about the image encoders built into GDI+.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Drawing.Imaging.ImageCodecInfo" /> objects. Each <see cref="T:System.Drawing.Imaging.ImageCodecInfo" /> object in the array contains information about one of the built-in image encoders.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/ImageFormat.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/ImageFormat.xml
index 6cfb436f6e3..91503e23b78 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/ImageFormat.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/ImageFormat.xml
@@ -101,12 +101,15 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the specified object is an <see cref="T:System.Drawing.Imaging.ImageFormat" /> object that is equivalent to this <see cref="T:System.Drawing.Imaging.ImageFormat" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="o" /> is an <see cref="T:System.Drawing.Imaging.ImageFormat" /> object that is equivalent to this <see cref="T:System.Drawing.Imaging.ImageFormat" /> object; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test. </param>
       </Docs>
@@ -142,12 +145,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash code value that represents this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code that represents this object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -295,12 +301,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Drawing.Imaging.ImageFormat" /> object to a human-readable string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents this <see cref="T:System.Drawing.Imaging.ImageFormat" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/Metafile.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/Metafile.xml
index 681976ce1e9..0382ece2609 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/Metafile.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/Metafile.xml
@@ -1164,12 +1164,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Windows handle to an enhanced <see cref="T:System.Drawing.Imaging.Metafile" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Windows handle to this enhanced <see cref="T:System.Drawing.Imaging.Metafile" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1184,12 +1187,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'MetafileHeader'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Drawing.Imaging.MetafileHeader" /> associated with this <see cref="T:System.Drawing.Imaging.Metafile" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Imaging.MetafileHeader" /> associated with this <see cref="T:System.Drawing.Imaging.Metafile" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1206,12 +1212,15 @@
         <Parameter Name="henhmetafile" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MetafileHeader'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Drawing.Imaging.MetafileHeader" /> associated with the specified <see cref="T:System.Drawing.Imaging.Metafile" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Imaging.MetafileHeader" /> associated with the specified <see cref="T:System.Drawing.Imaging.Metafile" />.</para>
+        </returns>
         <param name="henhmetafile">
           <attribution license="cc4" from="Microsoft" modified="false" />The handle to the enhanced <see cref="T:System.Drawing.Imaging.Metafile" /> for which a header is returned. </param>
       </Docs>
@@ -1230,12 +1239,15 @@
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MetafileHeader'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Drawing.Imaging.MetafileHeader" /> associated with the specified <see cref="T:System.Drawing.Imaging.Metafile" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Imaging.MetafileHeader" /> associated with the specified <see cref="T:System.Drawing.Imaging.Metafile" />.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IO.Stream" /> containing the <see cref="T:System.Drawing.Imaging.Metafile" /> for which a header is retrieved. </param>
       </Docs>
@@ -1254,12 +1266,15 @@
         <Parameter Name="fileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MetafileHeader'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Drawing.Imaging.MetafileHeader" /> associated with the specified <see cref="T:System.Drawing.Imaging.Metafile" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Imaging.MetafileHeader" /> associated with the specified <see cref="T:System.Drawing.Imaging.Metafile" />.</para>
+        </returns>
         <param name="fileName">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> containing the name of the <see cref="T:System.Drawing.Imaging.Metafile" /> for which a header is retrieved. </param>
       </Docs>
@@ -1280,12 +1295,15 @@
       </Parameters>
       <Docs>
         <param name="henhmetafile">To be added.</param>
-        <returns>To be added: an object of type 'MetafileHeader'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Drawing.Imaging.MetafileHeader" /> associated with the specified <see cref="T:System.Drawing.Imaging.Metafile" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Imaging.MetafileHeader" /> associated with the specified <see cref="T:System.Drawing.Imaging.Metafile" />.</para>
+        </returns>
         <param name="wmfHeader">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Imaging.WmfPlaceableFileHeader" />. </param>
       </Docs>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/MetafileHeader.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/MetafileHeader.xml
index ee4a5326387..16532f39980 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/MetafileHeader.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Imaging/MetafileHeader.xml
@@ -105,12 +105,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the associated <see cref="T:System.Drawing.Imaging.Metafile" /> is device dependent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the associated <see cref="T:System.Drawing.Imaging.Metafile" /> is device dependent; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -125,12 +128,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the associated <see cref="T:System.Drawing.Imaging.Metafile" /> is in the Windows enhanced metafile format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the associated <see cref="T:System.Drawing.Imaging.Metafile" /> is in the Windows enhanced metafile format; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -145,12 +151,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the associated <see cref="T:System.Drawing.Imaging.Metafile" /> is in the Windows enhanced metafile format or the Windows enhanced metafile plus format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the associated <see cref="T:System.Drawing.Imaging.Metafile" /> is in the Windows enhanced metafile format or the Windows enhanced metafile plus format; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -165,12 +174,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the associated <see cref="T:System.Drawing.Imaging.Metafile" /> is in the Windows enhanced metafile plus format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the associated <see cref="T:System.Drawing.Imaging.Metafile" /> is in the Windows enhanced metafile plus format; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -185,12 +197,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the associated <see cref="T:System.Drawing.Imaging.Metafile" /> is in the Dual enhanced metafile format. This format supports both the enhanced and the enhanced plus format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the associated <see cref="T:System.Drawing.Imaging.Metafile" /> is in the Dual enhanced metafile format; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -205,12 +220,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the associated <see cref="T:System.Drawing.Imaging.Metafile" /> supports only the Windows enhanced metafile plus format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the associated <see cref="T:System.Drawing.Imaging.Metafile" /> supports only the Windows enhanced metafile plus format; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -225,12 +243,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the associated <see cref="T:System.Drawing.Imaging.Metafile" /> is in the Windows metafile format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the associated <see cref="T:System.Drawing.Imaging.Metafile" /> is in the Windows metafile format; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -245,12 +266,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the associated <see cref="T:System.Drawing.Imaging.Metafile" /> is in the Windows placeable metafile format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the associated <see cref="T:System.Drawing.Imaging.Metafile" /> is in the Windows placeable metafile format; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/Margins.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/Margins.xml
index 40176129edb..5c2bd9c9ddb 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/Margins.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/Margins.xml
@@ -115,12 +115,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a duplicate of this object, member by member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A duplicate of this object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -137,12 +140,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this <see cref="T:System.Drawing.Printing.Margins" /> to the specified <see cref="T:System.Object" /> to determine whether they have the same dimensions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified object is a <see cref="T:System.Drawing.Printing.Margins" /> and has the same <see cref="P:System.Drawing.Printing.Margins.Top" />, <see cref="P:System.Drawing.Printing.Margins.Bottom" />, <see cref="P:System.Drawing.Printing.Margins.Right" /> and <see cref="P:System.Drawing.Printing.Margins.Left" /> values as this <see cref="T:System.Drawing.Printing.Margins" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to which to compare this <see cref="T:System.Drawing.Printing.Margins" />. </param>
       </Docs>
@@ -159,12 +165,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates and retrieves a hash code based on the width of the left, right, top, and bottom margins.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code based on the left, right, top, and bottom margins.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -209,12 +218,15 @@
         <Parameter Name="m2" Type="System.Drawing.Printing.Margins" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Drawing.Printing.Margins" /> to determine if they have the same dimensions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true to indicate the <see cref="P:System.Drawing.Printing.Margins.Left" />, <see cref="P:System.Drawing.Printing.Margins.Right" />, <see cref="P:System.Drawing.Printing.Margins.Top" />, and <see cref="P:System.Drawing.Printing.Margins.Bottom" /> properties of both margins have the same value; otherwise, false.</para>
+        </returns>
         <param name="m1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Drawing.Printing.Margins" /> to compare for equality.</param>
         <param name="m2">
@@ -235,12 +247,15 @@
         <Parameter Name="m2" Type="System.Drawing.Printing.Margins" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Drawing.Printing.Margins" /> to determine whether they are of unequal width.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true to indicate if the <see cref="P:System.Drawing.Printing.Margins.Left" />, <see cref="P:System.Drawing.Printing.Margins.Right" />, <see cref="P:System.Drawing.Printing.Margins.Top" />, or <see cref="P:System.Drawing.Printing.Margins.Bottom" /> properties of both margins are not equal; otherwise, false.</para>
+        </returns>
         <param name="m1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Drawing.Printing.Margins" /> to compare for inequality.</param>
         <param name="m2">
@@ -303,12 +318,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.Drawing.Printing.Margins" /> to a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> representation of the <see cref="T:System.Drawing.Printing.Margins" />. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/MarginsConverter.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/MarginsConverter.xml
index 6169d444902..723096c399b 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/MarginsConverter.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/MarginsConverter.xml
@@ -57,7 +57,6 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment from which this converter is being invoked. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -66,6 +65,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether this converter can convert an object of the specified source type to the native type of the converter using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if an object can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="sourceType">
@@ -87,7 +90,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment from which this converter is being invoked. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -96,6 +98,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether this converter can convert an object to the given destination type using the context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="destinationType">
@@ -118,7 +124,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment from which this converter is being invoked. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -127,6 +132,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object to the converter's native type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
@@ -152,7 +161,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment from which this converter is being invoked. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -161,6 +169,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given value object to the specified destination type using the specified context and arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
@@ -186,7 +198,6 @@
         <Parameter Name="propertyValues" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment from which this converter is being invoked. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -195,6 +206,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Object" /> given a set of property values for the object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> representing the specified <see cref="T:System.Collections.IDictionary" />, or null if the object cannot be created.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="propertyValues">
@@ -215,7 +230,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment from which this converter is being invoked. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -224,6 +238,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether changing a value on this object requires a call to the <see cref="M:System.Drawing.Printing.MarginsConverter.CreateInstance(System.ComponentModel.ITypeDescriptorContext,System.Collections.IDictionary)" /> method to create a new value, using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if changing a property on this object requires a call to <see cref="M:System.Drawing.Printing.MarginsConverter.CreateInstance(System.ComponentModel.ITypeDescriptorContext,System.Collections.IDictionary)" /> to create a new value; otherwise, false. This method always returns true.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PageSettings.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PageSettings.xml
index 0c89bd1f7e3..50c91e9d2ad 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PageSettings.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PageSettings.xml
@@ -104,12 +104,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of this <see cref="T:System.Drawing.Printing.PageSettings" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of this object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -414,12 +417,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.Drawing.Printing.PageSettings" /> to string form.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string showing the various property settings for the <see cref="T:System.Drawing.Printing.PageSettings" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PaperSize.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PaperSize.xml
index 5ed0fbcd77c..e0c3575d59c 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PaperSize.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PaperSize.xml
@@ -1350,12 +1350,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides information about the <see cref="T:System.Drawing.Printing.PaperSize" /> in string form.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PaperSource.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PaperSource.xml
index b98a00d4575..c1a4ce805e1 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PaperSource.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PaperSource.xml
@@ -288,12 +288,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides information about the <see cref="T:System.Drawing.Printing.PaperSource" /> in string form.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PreviewPrintController.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PreviewPrintController.xml
index 0dc56ef7d65..ace8603423e 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PreviewPrintController.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PreviewPrintController.xml
@@ -52,7 +52,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'PreviewPageInfo []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the <see cref="T:System.Drawing.Printing.PrintDocument" /> image representation contained in a <see cref="T:System.Drawing.Printing.PreviewPageInfo" /> to implement your own print preview form.</para>
@@ -61,6 +60,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Captures the pages of a document as a series of images.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Drawing.Printing.PreviewPageInfo" /> that contains the pages of a <see cref="T:System.Drawing.Printing.PrintDocument" /> as a series of images.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -159,7 +162,6 @@
         <Parameter Name="e" Type="System.Drawing.Printing.PrintPageEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Drawing.Graphics'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -174,6 +176,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins the control sequence that determines when and how to preview a page in a print document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Graphics" /> that represents a page from a <see cref="T:System.Drawing.Printing.PrintDocument" />.</para>
+        </returns>
         <param name="document">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Printing.PrintDocument" /> that represents the document being previewed. </param>
         <param name="e">
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PrintController.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PrintController.xml
index 6502a388a85..4f7da93c5bc 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PrintController.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PrintController.xml
@@ -138,7 +138,6 @@
         <Parameter Name="e" Type="System.Drawing.Printing.PrintPageEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Drawing.Graphics'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -151,6 +150,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, begins the control sequence that determines when and how to print a page of a document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Graphics" /> that represents a page from a <see cref="T:System.Drawing.Printing.PrintDocument" />.</para>
+        </returns>
         <param name="document">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Printing.PrintDocument" /> that represents the document currently being printed. </param>
         <param name="e">
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PrintDocument.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PrintDocument.xml
index b1ed84c6f88..6ef171bb54a 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PrintDocument.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PrintDocument.xml
@@ -453,12 +453,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides information about the print document, in string form.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PrinterResolution.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PrinterResolution.xml
index d5b6848b757..43c11e621df 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PrinterResolution.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PrinterResolution.xml
@@ -94,12 +94,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member overrides the <see cref="M:System.Object.ToString" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that contains information about the <see cref="T:System.Drawing.Printing.PrinterResolution" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PrinterSettings.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PrinterSettings.xml
index 823fe2bff6e..ca394d701de 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PrinterSettings.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PrinterSettings.xml
@@ -80,12 +80,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of this <see cref="T:System.Drawing.Printing.PrinterSettings" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of this object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -152,7 +155,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Drawing.Graphics'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>With the <see cref="M:System.Drawing.Printing.PrinterSettings.CreateMeasurementGraphics" /> method, you can obtain a <see cref="T:System.Drawing.Graphics" /> for the printer without creating a print job. You can use the <see cref="T:System.Drawing.Graphics" /> to make decisions on how to layout visual elements like fonts, sizes, and type styles of a complex print job.</para>
@@ -161,6 +163,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Drawing.Graphics" /> that contains printer information that is useful when creating a <see cref="T:System.Drawing.Printing.PrintDocument" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Graphics" /> that contains information from a printer.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -180,7 +186,6 @@
         <Parameter Name="honorOriginAtMargins" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>With the <see cref="M:System.Drawing.Printing.PrinterSettings.CreateMeasurementGraphics" /> method, you can obtain a <see cref="T:System.Drawing.Graphics" /> for the printer without creating a print job. Use the <see cref="T:System.Drawing.Graphics" /> to make decisions on how to layout visual elements like fonts, sizes, and type styles of a complex print job.</para>
@@ -189,6 +194,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Drawing.Graphics" /> that contains printer information, optionally specifying the origin at the margins.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Graphics" /> that contains printer information from the <see cref="T:System.Drawing.Printing.PageSettings" />.</para>
+        </returns>
         <param name="honorOriginAtMargins">
           <attribution license="cc4" from="Microsoft" modified="false" />true to indicate the origin at the margins; otherwise, false. </param>
       </Docs>
@@ -206,7 +215,6 @@
         <Parameter Name="pageSettings" Type="System.Drawing.Printing.PageSettings" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>With the <see cref="M:System.Drawing.Printing.PrinterSettings.CreateMeasurementGraphics" /> method, you can obtain a <see cref="T:System.Drawing.Graphics" /> for the printer without creating a print job. Use the <see cref="T:System.Drawing.Graphics" /> to make decisions on how to layout visual elements like fonts, sizes, and type styles of a complex print job.</para>
@@ -215,6 +223,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Drawing.Graphics" /> that contains printer information associated with the specified <see cref="T:System.Drawing.Printing.PageSettings" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Graphics" /> that contains printer information from the <see cref="T:System.Drawing.Printing.PageSettings" />.</para>
+        </returns>
         <param name="pageSettings">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Printing.PageSettings" /> to retrieve a graphics object for.</param>
       </Docs>
@@ -233,7 +245,6 @@
         <Parameter Name="honorOriginAtMargins" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Drawing.Printing.PrinterSettings.CreateMeasurementGraphics" /> method allows you to obtain a <see cref="T:System.Drawing.Graphics" /> for the printer without creating a print job. Use the <see cref="T:System.Drawing.Graphics" /> to make decisions on how to layout visual elements like fonts, sizes, and type styles of a complex print job.</para>
@@ -242,6 +253,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Drawing.Graphics" /> associated with the specified page settings and optionally specifying the origin at the margins.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Graphics" /> that contains printer information from the <see cref="T:System.Drawing.Printing.PageSettings" />.</para>
+        </returns>
         <param name="pageSettings">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Printing.PageSettings" /> to retrieve a <see cref="T:System.Drawing.Graphics" /> object for.</param>
         <param name="honorOriginAtMargins">
@@ -328,7 +343,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>DEVMODE structures are device specific. Copying a DEVMODE structure from one <see cref="T:System.Drawing.Printing.PrinterSettings" /> to a <see cref="T:System.Drawing.Printing.PrinterSettings" /> for a different printer is not supported. When you are done with the handle that is created through this method, you must deallocate it yourself by calling the native Win32 GlobalFree method. When you call this method, you pass as a parameter the return value from the <see cref="M:System.Drawing.Printing.PrinterSettings.GetHdevmode" /> method.</para>
@@ -337,6 +351,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a handle to a DEVMODE structure that corresponds to the printer settings.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A handle to a DEVMODE structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -353,7 +371,6 @@
         <Parameter Name="pageSettings" Type="System.Drawing.Printing.PageSettings" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>DEVMODE structures are device specific. Copying a DEVMODE structure from one <see cref="T:System.Drawing.Printing.PrinterSettings" /> to a <see cref="T:System.Drawing.Printing.PrinterSettings" /> for a different printer is not supported.</para>
@@ -363,6 +380,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a handle to a DEVMODE structure that corresponds to the printer and the page settings specified through the <paramref name="pageSettings" /> parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A handle to a DEVMODE structure.</para>
+        </returns>
         <param name="pageSettings">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Printing.PageSettings" /> object that the DEVMODE structure's handle corresponds to. </param>
       </Docs>
@@ -379,7 +400,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When you are done with the handle that is created through this method, you must deallocate it yourself by calling the native Win32 GlobalFree method. When you call this method, you pass as a parameter the return value from the <see cref="M:System.Drawing.Printing.PrinterSettings.GetHdevnames" /> method.</para>
@@ -388,6 +408,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a handle to a DEVNAMES structure that corresponds to the printer settings.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A handle to a DEVNAMES structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -452,12 +476,15 @@
         <Parameter Name="image" Type="System.Drawing.Image" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the printer supports printing the specified image file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the printer supports printing the specified image; otherwise, false.</para>
+        </returns>
         <param name="image">
           <attribution license="cc4" from="Microsoft" modified="false" />The image to print.</param>
       </Docs>
@@ -475,12 +502,15 @@
         <Parameter Name="imageFormat" Type="System.Drawing.Imaging.ImageFormat" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the printer supports printing the specified image format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the printer supports printing the specified image format; otherwise, false.</para>
+        </returns>
         <param name="imageFormat">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Drawing.Imaging.ImageFormat" /> to print.</param>
       </Docs>
@@ -893,12 +923,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides information about the <see cref="T:System.Drawing.Printing.PrinterSettings" /> in string form.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PrinterUnitConvert.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PrinterUnitConvert.xml
index 04348acd0b0..74de8d9246c 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PrinterUnitConvert.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PrinterUnitConvert.xml
@@ -37,7 +37,6 @@
         <Parameter Name="toUnit" Type="System.Drawing.Printing.PrinterUnit" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'double'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following table shows the <see cref="T:System.Drawing.Printing.PrinterUnit" /> values.</para>
@@ -90,6 +89,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a double-precision floating-point number from one <see cref="T:System.Drawing.Printing.PrinterUnit" /> type to another <see cref="T:System.Drawing.Printing.PrinterUnit" /> type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A double-precision floating-point number that represents the converted <see cref="T:System.Drawing.Printing.PrinterUnit" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Point" /> being converted. </param>
         <param name="fromUnit">
@@ -114,7 +117,6 @@
         <Parameter Name="toUnit" Type="System.Drawing.Printing.PrinterUnit" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Drawing.Point'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following table shows the <see cref="T:System.Drawing.Printing.PrinterUnit" /> values.</para>
@@ -167,6 +169,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a <see cref="T:System.Drawing.Point" /> from one <see cref="T:System.Drawing.Printing.PrinterUnit" /> type to another <see cref="T:System.Drawing.Printing.PrinterUnit" /> type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Point" /> that represents the converted <see cref="T:System.Drawing.Printing.PrinterUnit" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Point" /> being converted. </param>
         <param name="fromUnit">
@@ -191,7 +197,6 @@
         <Parameter Name="toUnit" Type="System.Drawing.Printing.PrinterUnit" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Margins'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following table shows the <see cref="T:System.Drawing.Printing.PrinterUnit" /> values.</para>
@@ -244,6 +249,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a <see cref="T:System.Drawing.Printing.Margins" /> from one <see cref="T:System.Drawing.Printing.PrinterUnit" /> type to another <see cref="T:System.Drawing.Printing.PrinterUnit" /> type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Printing.Margins" /> that represents the converted <see cref="T:System.Drawing.Printing.PrinterUnit" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Printing.Margins" /> being converted. </param>
         <param name="fromUnit">
@@ -268,7 +277,6 @@
         <Parameter Name="toUnit" Type="System.Drawing.Printing.PrinterUnit" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Drawing.Rectangle'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following table shows the <see cref="T:System.Drawing.Printing.PrinterUnit" /> values.</para>
@@ -321,6 +329,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a <see cref="T:System.Drawing.Rectangle" /> from one <see cref="T:System.Drawing.Printing.PrinterUnit" /> type to another <see cref="T:System.Drawing.Printing.PrinterUnit" /> type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> that represents the converted <see cref="T:System.Drawing.Printing.PrinterUnit" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Rectangle" /> being converted. </param>
         <param name="fromUnit">
@@ -345,7 +357,6 @@
         <Parameter Name="toUnit" Type="System.Drawing.Printing.PrinterUnit" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Drawing.Size'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following table shows the <see cref="T:System.Drawing.Printing.PrinterUnit" /> values.</para>
@@ -398,6 +409,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a <see cref="T:System.Drawing.Size" /> from one <see cref="T:System.Drawing.Printing.PrinterUnit" /> type to another <see cref="T:System.Drawing.Printing.PrinterUnit" /> type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Size" /> that represents the converted <see cref="T:System.Drawing.Printing.PrinterUnit" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Size" /> being converted. </param>
         <param name="fromUnit">
@@ -422,7 +437,6 @@
         <Parameter Name="toUnit" Type="System.Drawing.Printing.PrinterUnit" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following table shows the <see cref="T:System.Drawing.Printing.PrinterUnit" /> values.</para>
@@ -475,6 +489,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a 32-bit signed integer from one <see cref="T:System.Drawing.Printing.PrinterUnit" /> type to another <see cref="T:System.Drawing.Printing.PrinterUnit" /> type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer that represents the converted <see cref="T:System.Drawing.Printing.PrinterUnit" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value being converted. </param>
         <param name="fromUnit">
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PrintingPermission.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PrintingPermission.xml
index 286af86ffe6..ca61bc7bf90 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PrintingPermission.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PrintingPermission.xml
@@ -78,7 +78,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Security.IPermission'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A copy of the permission object represents the same access to resources as the original permission object.</para>
@@ -87,6 +86,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an identical copy of the current permission object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current permission object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -108,6 +111,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reconstructs a security object with a specified state from an XML encoding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>None.</para>
+        </returns>
         <param name="esd">
           <attribution license="cc4" from="Microsoft" modified="false" />The XML encoding to use to reconstruct the security object. </param>
       </Docs>
@@ -126,7 +133,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Security.IPermission'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The intersection of two permissions is a permission that describes the set of operations they both hold in common. Specifically, it represents the minimum permissions required for a demand to pass both permissions.</para>
@@ -135,6 +141,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a permission that is the intersection of the current permission object and a target permission object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission object that represents the intersection of the current object and the specified target. This object is null if the intersection is empty.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission object of the same type as the current permission object. </param>
       </Docs>
@@ -153,12 +163,15 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current permission object is a subset of the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission object is a subset of <paramref name="target" />; otherwise, false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission object that is to be tested for the subset relationship. This object must be of the same type as the current permission object. </param>
       </Docs>
@@ -175,7 +188,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An unrestricted permission object represents access to any and all resources protected by the permission.</para>
@@ -184,6 +196,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the permission is unrestricted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if permission is unrestricted; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -219,12 +235,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Security.SecurityElement'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the security object and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the security object, including any state information.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -241,7 +260,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Security.IPermission'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The result of a call to <see cref="M:System.Security.Permissions.UIPermission.Union(System.Security.IPermission)" /> is a permission that represents all the operations represented by the current permission object, and all the operations represented by the specified permission object.</para>
@@ -250,6 +268,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a permission that combines the permission object and the target permission object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission object that represents the union of the current permission object and the specified permission object.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission object of the same type as the current permission object. </param>
       </Docs>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PrintingPermissionAttribute.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PrintingPermissionAttribute.xml
index 356b9d70b40..b42de1dfb19 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PrintingPermissionAttribute.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/PrintingPermissionAttribute.xml
@@ -58,12 +58,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Security.IPermission'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the permission based on the requested access levels, which are set through the <see cref="P:System.Drawing.Printing.PrintingPermissionAttribute.Level" /> property on the attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.IPermission" /> that represents the created permission.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/StandardPrintController.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/StandardPrintController.xml
index 8a98e03620d..ca07bc0e870 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/StandardPrintController.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Printing/StandardPrintController.xml
@@ -119,7 +119,6 @@
         <Parameter Name="e" Type="System.Drawing.Printing.PrintPageEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Drawing.Graphics'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -131,6 +130,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins the control sequence that determines when and how to print a page in a document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Graphics" /> object that represents a page from a <see cref="T:System.Drawing.Printing.PrintDocument" />.</para>
+        </returns>
         <param name="document">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Printing.PrintDocument" /> that represents the document being printed. </param>
         <param name="e">
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Text/FontCollection.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Text/FontCollection.xml
index 3ab56e0aa8d..ab2402b97f2 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing.Text/FontCollection.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing.Text/FontCollection.xml
@@ -47,6 +47,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Releases all resources used by this <see cref="T:System.Drawing.Text.FontCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/Bitmap.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/Bitmap.xml
index 5d2c32e2405..536b1514383 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/Bitmap.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/Bitmap.xml
@@ -372,12 +372,15 @@
         <Parameter Name="format" Type="System.Drawing.Imaging.PixelFormat" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Bitmap'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the section of this <see cref="T:System.Drawing.Bitmap" /> defined by <see cref="T:System.Drawing.Rectangle" /> structure and with a specified <see cref="T:System.Drawing.Imaging.PixelFormat" /> enumeration.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Drawing.Bitmap" /> that this method creates.</para>
+        </returns>
         <param name="rect">
           <attribution license="cc4" from="Microsoft" modified="false" />Defines the portion of this <see cref="T:System.Drawing.Bitmap" /> to copy. Coordinates are relative to this <see cref="T:System.Drawing.Bitmap" />. </param>
         <param name="format">
@@ -399,12 +402,15 @@
         <Parameter Name="format" Type="System.Drawing.Imaging.PixelFormat" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Bitmap'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the section of this <see cref="T:System.Drawing.Bitmap" /> defined with a specified <see cref="T:System.Drawing.Imaging.PixelFormat" /> enumeration.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Bitmap" /> that this method creates.</para>
+        </returns>
         <param name="rect">
           <attribution license="cc4" from="Microsoft" modified="false" />Defines the portion of this <see cref="T:System.Drawing.Bitmap" /> to copy. </param>
         <param name="format">
@@ -425,12 +431,15 @@
         <Parameter Name="hicon" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Bitmap'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Drawing.Bitmap" /> from a Windows handle to an icon.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Bitmap" /> that this method creates.</para>
+        </returns>
         <param name="hicon">
           <attribution license="cc4" from="Microsoft" modified="false" />A handle to an icon. </param>
       </Docs>
@@ -450,7 +459,6 @@
         <Parameter Name="bitmapName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Bitmap'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -460,6 +468,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Drawing.Bitmap" /> from the specified Windows resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Bitmap" /> that this method creates.</para>
+        </returns>
         <param name="hinstance">
           <attribution license="cc4" from="Microsoft" modified="false" />A handle to an instance of the executable file that contains the resource. </param>
         <param name="bitmapName">
@@ -478,7 +490,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You are responsible for calling the ndptecgdi <unmanagedCodeEntityReference>DeleteObject</unmanagedCodeEntityReference> method to free the memory used by the ndptecgdi bitmap object. For more information about GDI bitmaps, see <see cref="http://go.microsoft.com/fwlink/?LinkId=205685">Bitmaps</see> in the Windows GDI documentation.</para>
@@ -487,6 +498,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a ndptecgdi bitmap object from this <see cref="T:System.Drawing.Bitmap" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A handle to the ndptecgdi bitmap object that this method creates.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -508,7 +523,6 @@
         <Parameter Name="background" Type="System.Drawing.Color" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You are responsible for calling the ndptecgdi <unmanagedCodeEntityReference>DeleteObject</unmanagedCodeEntityReference> method to free the memory used by the ndptecgdi bitmap object. For more information about GDI bitmaps, see <see cref="http://go.microsoft.com/fwlink/?LinkId=205685">Bitmaps</see> in the Windows GDI documentation.</para>
@@ -517,6 +531,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a ndptecgdi bitmap object from this <see cref="T:System.Drawing.Bitmap" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A handle to the ndptecgdi bitmap object that this method creates.</para>
+        </returns>
         <param name="background">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Color" /> structure that specifies the background color. This parameter is ignored if the bitmap is totally opaque. </param>
       </Docs>
@@ -538,7 +556,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initially, an icon created from the handle will have the same size as the original bitmap.</para>
@@ -547,6 +564,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the handle to an icon.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Windows handle to an icon with the same image as the <see cref="T:System.Drawing.Bitmap" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -569,12 +590,15 @@
         <Parameter Name="y" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Color'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the color of the specified pixel in this <see cref="T:System.Drawing.Bitmap" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Color" /> structure that represents the color of the specified pixel.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate of the pixel to retrieve. </param>
         <param name="y">
@@ -597,7 +621,6 @@
         <Parameter Name="format" Type="System.Drawing.Imaging.PixelFormat" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Imaging.BitmapData'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="Overload:System.Drawing.Bitmap.LockBits" /> method to lock an existing bitmap in system memory so that it can be changed programmatically. You can change the color of an image with the <see cref="M:System.Drawing.Bitmap.SetPixel(System.Int32,System.Int32,System.Drawing.Color)" /> method, although the <see cref="Overload:System.Drawing.Bitmap.LockBits" /> method offers better performance for large-scale changes. </para>
@@ -608,6 +631,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Locks a <see cref="T:System.Drawing.Bitmap" /> into system memory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Imaging.BitmapData" /> that contains information about this lock operation.</para>
+        </returns>
         <param name="rect">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Rectangle" /> structure that specifies the portion of the <see cref="T:System.Drawing.Bitmap" /> to lock. </param>
         <param name="flags">
@@ -636,7 +663,6 @@
         <Parameter Name="bitmapData" Type="System.Drawing.Imaging.BitmapData" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="Overload:System.Drawing.Bitmap.LockBits" /> method to lock an existing bitmap in system memory so that it can be changed programmatically. You can change the color of an image with the <see cref="M:System.Drawing.Bitmap.SetPixel(System.Int32,System.Int32,System.Drawing.Color)" /> method, although the <see cref="Overload:System.Drawing.Bitmap.LockBits" /> method offers better performance for large-scale changes. </para>
@@ -647,6 +673,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Locks a <see cref="T:System.Drawing.Bitmap" /> into system memory </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Imaging.BitmapData" /> that contains information about the lock operation.</para>
+        </returns>
         <param name="rect">
           <attribution license="cc4" from="Microsoft" modified="false" />A rectangle structure that specifies the portion of the <see cref="T:System.Drawing.Bitmap" /> to lock.</param>
         <param name="flags">
@@ -674,6 +704,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Makes the default transparent color transparent for this <see cref="T:System.Drawing.Bitmap" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -726,6 +760,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the color of the specified pixel in this <see cref="T:System.Drawing.Bitmap" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate of the pixel to set. </param>
         <param name="y">
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/Brush.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/Brush.xml
index d83115b69b7..64772a61a89 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/Brush.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/Brush.xml
@@ -54,12 +54,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates an exact copy of this <see cref="T:System.Drawing.Brush" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Drawing.Brush" /> that this method creates.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -86,6 +89,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Releases all resources used by this <see cref="T:System.Drawing.Brush" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/BufferedGraphicsContext.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/BufferedGraphicsContext.xml
index 30a32c12fa9..af1cb4638ca 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/BufferedGraphicsContext.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/BufferedGraphicsContext.xml
@@ -65,7 +65,6 @@
         <Parameter Name="targetRectangle" Type="System.Drawing.Rectangle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -75,6 +74,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a graphics buffer of the specified size using the pixel format of the specified <see cref="T:System.Drawing.Graphics" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.BufferedGraphics" /> that can be used to draw to a buffer of the specified dimensions.</para>
+        </returns>
         <param name="targetGraphics">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Graphics" /> to match the pixel format for the new buffer to. </param>
         <param name="targetRectangle">
@@ -95,7 +98,6 @@
         <Parameter Name="targetRectangle" Type="System.Drawing.Rectangle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -105,6 +107,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a graphics buffer of the specified size using the pixel format of the specified <see cref="T:System.Drawing.Graphics" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.BufferedGraphics" /> that can be used to draw to a buffer of the specified dimensions.</para>
+        </returns>
         <param name="targetDC">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IntPtr" /> to a device context to match the pixel format of the new buffer to. </param>
         <param name="targetRectangle">
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/CharacterRange.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/CharacterRange.xml
index ed21ddc2ebb..4adcb9cd543 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/CharacterRange.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/CharacterRange.xml
@@ -58,7 +58,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can also use <see cref="M:System.Drawing.CharacterRange.op_Equality(System.Drawing.CharacterRange,System.Drawing.CharacterRange)" /> to test for equality.</para>
@@ -67,6 +66,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this object is equivalent to the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true to indicate the specified object is an instance with the same <see cref="P:System.Drawing.CharacterRange.First" /> and <see cref="P:System.Drawing.CharacterRange.Length" /> value as this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to for equality.</param>
       </Docs>
@@ -143,7 +146,6 @@
         <Parameter Name="cr2" Type="System.Drawing.CharacterRange" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can also test for equality using the <see cref="M:System.Drawing.CharacterRange.Equals(System.Object)" /> method.</para>
@@ -152,6 +154,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Drawing.CharacterRange" /> objects. Gets a value indicating whether the <see cref="P:System.Drawing.CharacterRange.First" /> and <see cref="P:System.Drawing.CharacterRange.Length" /> values of the two <see cref="T:System.Drawing.CharacterRange" /> objects are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true to indicate the two <see cref="T:System.Drawing.CharacterRange" /> objects have the same <see cref="P:System.Drawing.CharacterRange.First" /> and <see cref="P:System.Drawing.CharacterRange.Length" /> values; otherwise, false. </para>
+        </returns>
         <param name="cr1">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.CharacterRange" /> to compare for equality.</param>
         <param name="cr2">
@@ -172,7 +178,6 @@
         <Parameter Name="cr2" Type="System.Drawing.CharacterRange" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Drawing.CharacterRange.op_Inequality(System.Drawing.CharacterRange,System.Drawing.CharacterRange)" /> method returns the opposite of the <see cref="M:System.Drawing.CharacterRange.op_Equality(System.Drawing.CharacterRange,System.Drawing.CharacterRange)" /> method.</para>
@@ -181,6 +186,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Drawing.CharacterRange" /> objects. Gets a value indicating whether the <see cref="P:System.Drawing.CharacterRange.First" /> or <see cref="P:System.Drawing.CharacterRange.Length" /> values of the two <see cref="T:System.Drawing.CharacterRange" /> objects are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true to indicate the either the <see cref="P:System.Drawing.CharacterRange.First" /> or <see cref="P:System.Drawing.CharacterRange.Length" /> values of the two <see cref="T:System.Drawing.CharacterRange" /> objects differ; otherwise, false. </para>
+        </returns>
         <param name="cr1">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.CharacterRange" /> to compare for inequality.</param>
         <param name="cr2">
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/Color.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/Color.xml
index 4254f40b8ae..f7b46a806cd 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/Color.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/Color.xml
@@ -1030,7 +1030,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This structure only does comparisons with other <see cref="T:System.Drawing.Color" /> structures. To compare colors based solely on their ARGB values, you should use the <see cref="M:System.Drawing.Color.ToArgb" /> method. This is because the <see cref="M:System.Drawing.Color.Equals(System.Object)" /> and <see cref="M:System.Drawing.Color.op_Equality(System.Drawing.Color,System.Drawing.Color)" /> members determine equivalency using more than just the ARGB value of the colors. For example, <see cref="P:System.Drawing.Color.Black" /> and FromArgb(0,0,0) are not considered equal, since <see cref="P:System.Drawing.Color.Black" /> is a named color and FromArgb(0,0,0) is not.</para>
@@ -1039,6 +1038,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether the specified object is a <see cref="T:System.Drawing.Color" /> structure and is equivalent to this <see cref="T:System.Drawing.Color" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is a <see cref="T:System.Drawing.Color" /> structure equivalent to this <see cref="T:System.Drawing.Color" /> structure; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test. </param>
       </Docs>
@@ -1123,7 +1126,6 @@
         <Parameter Name="argb" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Color'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The byte-ordering of the 32-bit ARGB value is AARRGGBB. The most significant byte (MSB), represented by AA, is the alpha component value. The second, third, and fourth bytes, represented by RR, GG, and BB, respectively, are the color components red, green, and blue, respectively.</para>
@@ -1132,6 +1134,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Drawing.Color" /> structure from a 32-bit ARGB value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Color" /> structure that this method creates.</para>
+        </returns>
         <param name="argb">
           <attribution license="cc4" from="Microsoft" modified="false" />A value specifying the 32-bit ARGB value. </param>
       </Docs>
@@ -1151,7 +1157,6 @@
         <Parameter Name="baseColor" Type="System.Drawing.Color" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Color'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To create an opaque color, set <paramref name="alpha" /> to 255. To create a semitransparent color, set <paramref name="alpha" /> to any value from 1 through 254.</para>
@@ -1160,6 +1165,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Drawing.Color" /> structure from the specified <see cref="T:System.Drawing.Color" /> structure, but with the new specified alpha value. Although this method allows a 32-bit value to be passed for the alpha value, the value is limited to 8 bits.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Color" /> that this method creates.</para>
+        </returns>
         <param name="alpha">
           <attribution license="cc4" from="Microsoft" modified="false" />The alpha value for the new <see cref="T:System.Drawing.Color" />. Valid values are 0 through 255. </param>
         <param name="baseColor">
@@ -1182,12 +1191,15 @@
         <Parameter Name="blue" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Color'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Drawing.Color" /> structure from the specified 8-bit color values (red, green, and blue). The alpha value is implicitly 255 (fully opaque). Although this method allows a 32-bit value to be passed for each color component, the value of each component is limited to 8 bits.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Color" /> that this method creates.</para>
+        </returns>
         <param name="red">
           <attribution license="cc4" from="Microsoft" modified="false" />The red component value for the new <see cref="T:System.Drawing.Color" />. Valid values are 0 through 255. </param>
         <param name="green">
@@ -1213,7 +1225,6 @@
         <Parameter Name="blue" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Color'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To create an opaque color, set <paramref name="alpha" /> to 255. To create a semitransparent color, set <paramref name="alpha" /> to any value from 1 through 254.</para>
@@ -1222,6 +1233,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Drawing.Color" /> structure from the four ARGB component (alpha, red, green, and blue) values. Although this method allows a 32-bit value to be passed for each component, the value of each component is limited to 8 bits.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Color" /> that this method creates.</para>
+        </returns>
         <param name="alpha">
           <attribution license="cc4" from="Microsoft" modified="false" />The alpha component. Valid values are 0 through 255. </param>
         <param name="red">
@@ -1246,7 +1261,6 @@
         <Parameter Name="color" Type="System.Drawing.KnownColor" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Color'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A predefined color is also called a known color and is represented by an element of the <see cref="T:System.Drawing.KnownColor" /> enumeration.</para>
@@ -1255,6 +1269,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Drawing.Color" /> structure from the specified predefined color.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Color" /> that this method creates.</para>
+        </returns>
         <param name="color">
           <attribution license="cc4" from="Microsoft" modified="false" />An element of the <see cref="T:System.Drawing.KnownColor" /> enumeration. </param>
       </Docs>
@@ -1273,7 +1291,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Color'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A predefined color is also called a known color and is represented by an element of the <see cref="T:System.Drawing.KnownColor" /> enumeration. If the <paramref name="name" /> parameter is not the valid name of a predefined color, the <see cref="M:System.Drawing.Color.FromName(System.String)" /> method creates a <see cref="T:System.Drawing.Color" /> structure that has an ARGB value of 0 (that is, all ARGB components are 0).</para>
@@ -1282,6 +1299,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Drawing.Color" /> structure from the specified name of a predefined color.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Color" /> that this method creates.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that is the name of a predefined color. Valid names are the same as the names of the elements of the <see cref="T:System.Drawing.KnownColor" /> enumeration. </param>
       </Docs>
@@ -1364,12 +1385,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'float'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hue-saturation-brightness (HSB) brightness value for this <see cref="T:System.Drawing.Color" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The brightness of this <see cref="T:System.Drawing.Color" />. The brightness ranges from 0.0 through 1.0, where 0.0 represents black and 1.0 represents white.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1384,12 +1408,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash code for this <see cref="T:System.Drawing.Color" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer value that specifies the hash code for this <see cref="T:System.Drawing.Color" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1404,12 +1431,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'float'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hue-saturation-brightness (HSB) hue value, in degrees, for this <see cref="T:System.Drawing.Color" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hue, in degrees, of this <see cref="T:System.Drawing.Color" />. The hue is measured in degrees, ranging from 0.0 through 360.0, in HSB color space.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1424,12 +1454,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'float'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hue-saturation-brightness (HSB) saturation value for this <see cref="T:System.Drawing.Color" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The saturation of this <see cref="T:System.Drawing.Color" />. The saturation ranges from 0.0 through 1.0, where 0.0 is grayscale and 1.0 is the most saturated.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -2698,7 +2731,6 @@
         <Parameter Name="right" Type="System.Drawing.Color" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method compares more than the ARGB values of the <see cref="T:System.Drawing.Color" /> structures. It also does a comparison of some state flags. If you want to compare just the ARGB values of two <see cref="T:System.Drawing.Color" /> structures, compare them using the <see cref="M:System.Drawing.Color.ToArgb" /> method.</para>
@@ -2707,6 +2739,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether two specified <see cref="T:System.Drawing.Color" /> structures are equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two <see cref="T:System.Drawing.Color" /> structures are equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Color" /> that is to the left of the equality operator. </param>
         <param name="right">
@@ -2728,7 +2764,6 @@
         <Parameter Name="right" Type="System.Drawing.Color" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method compares more than the ARGB values of the <see cref="T:System.Drawing.Color" /> structures. It also does a comparison of some state flags. If you want to compare just the ARGB values of two <see cref="T:System.Drawing.Color" /> structures, use the <see cref="M:System.Drawing.Color.ToArgb" /> method.</para>
@@ -2737,6 +2772,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether two specified <see cref="T:System.Drawing.Color" /> structures are different.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two <see cref="T:System.Drawing.Color" /> structures are different; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Color" /> that is to the left of the inequality operator. </param>
         <param name="right">
@@ -3505,7 +3544,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The byte-ordering of the 32-bit ARGB value is AARRGGBB. The most significant byte (MSB), represented by AA, is the alpha component value. The second, third, and fourth bytes, represented by RR, GG, and BB, respectively, are the color components red, green, and blue, respectively </para>
@@ -3514,6 +3552,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the 32-bit ARGB value of this <see cref="T:System.Drawing.Color" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 32-bit ARGB value of this <see cref="T:System.Drawing.Color" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -3528,7 +3570,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'KnownColor'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A predefined color is also called a known color and is represented by an element of the <see cref="T:System.Drawing.KnownColor" /> enumeration. When the <see cref="M:System.Drawing.Color.ToKnownColor" /> method is applied to a <see cref="T:System.Drawing.Color" /> structure that is created by using the <see cref="Overload:System.Drawing.Color.FromArgb" /> method, <see cref="M:System.Drawing.Color.ToKnownColor" /> returns 0, even if the ARGB value matches the ARGB value of a predefined color. <see cref="M:System.Drawing.Color.ToKnownColor" /> also returns 0 when it is applied to a <see cref="T:System.Drawing.Color" /> structure that is created by using the <see cref="M:System.Drawing.Color.FromName(System.String)" /> method with a string name that is not valid.</para>
@@ -3537,6 +3578,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Drawing.KnownColor" /> value of this <see cref="T:System.Drawing.Color" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An element of the <see cref="T:System.Drawing.KnownColor" /> enumeration, if the <see cref="T:System.Drawing.Color" /> is created from a predefined color by using either the <see cref="M:System.Drawing.Color.FromName(System.String)" /> method or the <see cref="M:System.Drawing.Color.FromKnownColor(System.Drawing.KnownColor)" /> method; otherwise, 0.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -3573,7 +3618,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A predefined color is also called a known color and is represented by an element of the <see cref="T:System.Drawing.KnownColor" /> enumeration. When the <see cref="M:System.Drawing.Color.ToString" /> method is applied to a <see cref="T:System.Drawing.Color" /> structure that is created by using the <see cref="Overload:System.Drawing.Color.FromArgb" /> method, <see cref="M:System.Drawing.Color.ToString" /> returns a string that consists of the ARGB component names and their values, even if the ARGB value matches the ARGB value of a predefined color.</para>
@@ -3582,6 +3626,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Drawing.Color" /> structure to a human-readable string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that is the name of this <see cref="T:System.Drawing.Color" />, if the <see cref="T:System.Drawing.Color" /> is created from a predefined color by using either the <see cref="M:System.Drawing.Color.FromName(System.String)" /> method or the <see cref="M:System.Drawing.Color.FromKnownColor(System.Drawing.KnownColor)" /> method; otherwise, a string that consists of the ARGB component names and their values.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/ColorConverter.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/ColorConverter.xml
index 07d0f09938e..5eb077f9284 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/ColorConverter.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/ColorConverter.xml
@@ -52,12 +52,15 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if this converter can convert an object in the given source type to the native type of the converter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this object can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. You can use this object to get additional information about the environment from which this converter is being invoked. </param>
         <param name="sourceType">
@@ -79,12 +82,15 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this converter can convert an object to the given destination type using the context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the operation; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="destinationType">
@@ -107,7 +113,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When converting from a string to a <see cref="T:System.Drawing.Color" /> the <see cref="T:System.Drawing.ColorConverter" /> expects the unqualified color name; otherwise, an exception will occur in the conversion process. For example, you should pass "Blue", not "System.Drawing.Color.Blue" or "Color.Blue", to the <see cref="Overload:System.Drawing.ColorConverter.ConvertFrom" /> method. </para>
@@ -116,6 +121,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given object to the converter's native type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> representing the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.TypeDescriptor" /> that provides a format context. You can use this object to get additional information about the environment from which this converter is being invoked. </param>
         <param name="culture">
@@ -141,7 +150,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The most common conversion is to or from a string.</para>
@@ -150,6 +158,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object to another type. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> representing the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A formatter context. Use this object to extract additional information about the environment from which this converter is being invoked. Always check whether this value is null. Also, properties on the context object may return null. </param>
         <param name="culture">
@@ -174,12 +186,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ComponentModel.TypeConverter+StandardValuesCollection'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection containing a set of standard values for the data type for which this validator is designed. This will return null if the data type does not support a standard set of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection containing null or a standard set of valid values. The default implementation always returns null.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A formatter context. Use this object to extract additional information about the environment from which this converter is being invoked. Always check whether this value is null. Also, properties on the context object may return null. </param>
       </Docs>
@@ -198,12 +213,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if this object supports a standard set of values that can be chosen from a list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <see cref="Overload:System.Drawing.ColorConverter.GetStandardValues" /> must be called to find a common set of values the object supports; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.TypeDescriptor" /> through which additional context can be provided. </param>
       </Docs>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/ColorTranslator.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/ColorTranslator.xml
index 70913a5b85c..fca120aca42 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/ColorTranslator.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/ColorTranslator.xml
@@ -31,7 +31,6 @@
         <Parameter Name="htmlColor" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Color'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method translates a string representation of an HTML color name, such as Blue or Red, to a GDI+ <see cref="T:System.Drawing.Color" /> structure.</para>
@@ -40,6 +39,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Translates an HTML color representation to a GDI+ <see cref="T:System.Drawing.Color" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Color" /> structure that represents the translated HTML color or <see cref="F:System.Drawing.Color.Empty" /> if <paramref name="htmlColor" /> is null.</para>
+        </returns>
         <param name="htmlColor">
           <attribution license="cc4" from="Microsoft" modified="false" />The string representation of the Html color to translate. </param>
       </Docs>
@@ -58,12 +61,15 @@
         <Parameter Name="oleColor" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Color'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Translates an OLE color value to a GDI+ <see cref="T:System.Drawing.Color" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Color" /> structure that represents the translated OLE color.</para>
+        </returns>
         <param name="oleColor">
           <attribution license="cc4" from="Microsoft" modified="false" />The OLE color to translate. </param>
       </Docs>
@@ -82,12 +88,15 @@
         <Parameter Name="win32Color" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Color'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Translates a Windows color value to a GDI+ <see cref="T:System.Drawing.Color" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Color" /> structure that represents the translated Windows color.</para>
+        </returns>
         <param name="win32Color">
           <attribution license="cc4" from="Microsoft" modified="false" />The Windows color to translate. </param>
       </Docs>
@@ -106,7 +115,6 @@
         <Parameter Name="c" Type="System.Drawing.Color" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method translates a <see cref="T:System.Drawing.Color" /> structure to a string representation of an HTML color. This is the commonly used name of a color, such as "Red", "Blue", or "Green", and not string representation of a numeric color value, such as "FF33AA".</para>
@@ -115,6 +123,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Translates the specified <see cref="T:System.Drawing.Color" /> structure to an HTML string color representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string that represents the HTML color.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Color" /> structure to translate. </param>
       </Docs>
@@ -133,12 +145,15 @@
         <Parameter Name="c" Type="System.Drawing.Color" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Translates the specified <see cref="T:System.Drawing.Color" /> structure to an OLE color.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The OLE color value.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Color" /> structure to translate. </param>
       </Docs>
@@ -157,12 +172,15 @@
         <Parameter Name="c" Type="System.Drawing.Color" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Translates the specified <see cref="T:System.Drawing.Color" /> structure to a Windows color.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The Windows color value.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Color" /> structure to translate. </param>
       </Docs>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/Font.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/Font.xml
index 2499d84952a..4dabb501d63 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/Font.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/Font.xml
@@ -491,12 +491,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this <see cref="T:System.Drawing.Font" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Font" /> this method creates, cast as an <see cref="T:System.Object" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -523,6 +526,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Releases all resources used by this <see cref="T:System.Drawing.Font" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -539,12 +546,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified object is a <see cref="T:System.Drawing.Font" /> and has the same <see cref="P:System.Drawing.Font.FontFamily" />, <see cref="P:System.Drawing.Font.GdiVerticalFont" />, <see cref="P:System.Drawing.Font.GdiCharSet" />, <see cref="P:System.Drawing.Font.Style" />, <see cref="P:System.Drawing.Font.Size" />, and <see cref="P:System.Drawing.Font.Unit" /> property values as this <see cref="T:System.Drawing.Font" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="obj" /> parameter is a <see cref="T:System.Drawing.Font" /> and has the same <see cref="P:System.Drawing.Font.FontFamily" />, <see cref="P:System.Drawing.Font.GdiVerticalFont" />, <see cref="P:System.Drawing.Font.GdiCharSet" />, <see cref="P:System.Drawing.Font.Style" />, <see cref="P:System.Drawing.Font.Size" />, and <see cref="P:System.Drawing.Font.Unit" /> property values as this <see cref="T:System.Drawing.Font" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test. </param>
       </Docs>
@@ -606,7 +616,6 @@
         <Parameter Name="hdc" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Font'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For this method to work, the <paramref name="hdc" /> parameter must contain a handle to a device context in which a font is selected. This method will not work with an <paramref name="hdc" /> handle acquired from a ndptecgdiplus <see cref="T:System.Drawing.Graphics" /> object because the <paramref name="hdc" /> handle does not have a font selected.</para>
@@ -615,6 +624,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Drawing.Font" /> from the specified Windows handle to a device context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Font" /> this method creates.</para>
+        </returns>
         <param name="hdc">
           <attribution license="cc4" from="Microsoft" modified="false" />A handle to a device context. </param>
       </Docs>
@@ -633,12 +646,15 @@
         <Parameter Name="hfont" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Font'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Drawing.Font" /> from the specified Windows handle.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Font" /> this method creates.</para>
+        </returns>
         <param name="hfont">
           <attribution license="cc4" from="Microsoft" modified="false" />A Windows handle to a ndptecgdi font. </param>
       </Docs>
@@ -657,7 +673,6 @@
         <Parameter Name="lf" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Font'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A ndptecgdi <unmanagedCodeEntityReference>LOGFONT</unmanagedCodeEntityReference>, or logical font, is a structure that contains 14 properties that describe a particular font. For more information, see "The Logical Font" in the Windows Development documentation at <see cref="http://msdn.microsoft.com/library">http://msdn.microsoft.com/library</see>.</para>
@@ -666,6 +681,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Drawing.Font" /> from the specified GDI logical font (<unmanagedCodeEntityReference>LOGFONT</unmanagedCodeEntityReference>) structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Font" /> that this method creates.</para>
+        </returns>
         <param name="lf">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Object" /> that represents the ndptecgdi LOGFONT structure from which to create the <see cref="T:System.Drawing.Font" />. </param>
       </Docs>
@@ -685,7 +704,6 @@
         <Parameter Name="hdc" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Font'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A ndptecgdi <unmanagedCodeEntityReference>LOGFONT</unmanagedCodeEntityReference>, or logical font, is a structure that contains 14 properties that describe a particular font. For more information, see "The Logical Font" in the Windows Development documentation at <see cref="http://msdn.microsoft.com/library">http://msdn.microsoft.com/library</see>.</para>
@@ -694,6 +712,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Drawing.Font" /> from the specified GDI logical font (<unmanagedCodeEntityReference>LOGFONT</unmanagedCodeEntityReference>) structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Font" /> that this method creates.</para>
+        </returns>
         <param name="lf">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Object" /> that represents the ndptecgdi LOGFONT structure from which to create the <see cref="T:System.Drawing.Font" />. </param>
         <param name="hdc">
@@ -941,12 +963,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash code for this <see cref="T:System.Drawing.Font" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for this <see cref="T:System.Drawing.Font" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -961,7 +986,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'float'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The line spacing of a <see cref="T:System.Drawing.Font" /> is the vertical distance between the base lines of two consecutive lines of text. Thus, the line spacing includes the blank space between lines along with the height of the character itself.</para>
@@ -972,6 +996,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the line spacing, in pixels, of this font. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The line spacing, in pixels, of this font.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -988,7 +1016,6 @@
         <Parameter Name="graphics" Type="System.Drawing.Graphics" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'float'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The line spacing of a <see cref="T:System.Drawing.Font" /> is the vertical distance between the base lines of two consecutive lines of text. Thus, the line spacing includes the blank space between lines along with the height of the character itself.</para>
@@ -1001,6 +1028,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the line spacing, in the current unit of a specified <see cref="T:System.Drawing.Graphics" />, of this font. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The line spacing, in pixels, of this font.</para>
+        </returns>
         <param name="graphics">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Graphics" /> that holds the vertical resolution, in dots per inch, of the display device as well as settings for page unit and page scale. </param>
       </Docs>
@@ -1019,7 +1050,6 @@
         <Parameter Name="dpi" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'float'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="P:System.Drawing.Font.Unit" /> property of the font is set to anything other than <see cref="F:System.Drawing.GraphicsUnit.Pixel" />, the height (in pixels) is calculated using the vertical resolution of the screen display. For example, suppose the font unit is inches and the font size is 0.3. Also suppose that for the corresponding font family, the em-height is 2048 and the line spacing is 2355. If the specified vertical resolution is 96 dots per inch, the height is calculated as follows: </para>
@@ -1029,6 +1059,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the height, in pixels, of this <see cref="T:System.Drawing.Font" /> when drawn to a device with the specified vertical resolution.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The height, in pixels, of this <see cref="T:System.Drawing.Font" />.</para>
+        </returns>
         <param name="dpi">
           <attribution license="cc4" from="Microsoft" modified="false" />The vertical resolution, in dots per inch, used to calculate the height of the font. </param>
       </Docs>
@@ -1298,7 +1332,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When using this method, you must dispose of the resulting <unmanagedCodeEntityReference>Hfont</unmanagedCodeEntityReference> using the ndptecgdi <unmanagedCodeEntityReference>DeleteObject</unmanagedCodeEntityReference> method to ensure the resources are released.</para>
@@ -1307,6 +1340,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a handle to this <see cref="T:System.Drawing.Font" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Windows handle to this <see cref="T:System.Drawing.Font" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1376,7 +1413,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned string has the following format:</para>
@@ -1386,6 +1422,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a human-readable string representation of this <see cref="T:System.Drawing.Font" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents this <see cref="T:System.Drawing.Font" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/FontConverter.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/FontConverter.xml
index 514f37eb7d3..dd42c3d1dc2 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/FontConverter.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/FontConverter.xml
@@ -55,12 +55,15 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether this converter can convert an object in the specified source type to the native type of the converter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if this object can perform the conversion.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A formatter context. This object can be used to get additional information about the environment this converter is being called from. This may be null, so you should always check. Also, properties on the context object may also return null. </param>
         <param name="sourceType">
@@ -82,7 +85,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -91,6 +93,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this converter can convert an object to the given destination type using the context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An ITypeDescriptorContext object that provides a format context. </param>
         <param name="destinationType">
@@ -113,12 +119,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object to the native type of the converter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted object. </para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A formatter context. This object can be used to get additional information about the environment this converter is being called from. This may be null, so you should always check. Also, properties on the context object may also return null. </param>
         <param name="culture">
@@ -144,7 +153,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The most common type conversion is to and from a string type. The default implementation calls the <see cref="M:System.Object.ToString" /> method of the object if the object is valid and if the destination type is string.</para>
@@ -153,6 +161,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object to another type. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted object. </para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A formatter context. This object can be used to get additional information about the environment this converter is being called from. This may be null, so you should always check. Also, properties on the context object may also return null. </param>
         <param name="culture">
@@ -178,12 +190,17 @@
         <Parameter Name="propertyValues" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an object of this type by using a specified set of property values for the object. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created object, or null if the object could not be created. The default implementation returns null.</para>
+          <para>
+            <see cref="M:System.Drawing.FontConverter.CreateInstance(System.ComponentModel.ITypeDescriptorContext,System.Collections.IDictionary)" /> useful for creating non-changeable objects that have changeable properties.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A type descriptor through which additional context can be provided. </param>
         <param name="propertyValues">
@@ -223,12 +240,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether changing a value on this object should require a call to the <see cref="Overload:System.Drawing.FontConverter.CreateInstance" /> method to create a new value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if the CreateInstance object should be called when a change is made to one or more properties of this object; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A type descriptor through which additional context can be provided. </param>
       </Docs>
@@ -249,12 +269,16 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ComponentModel.PropertyDescriptorCollection'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the set of properties for this type. By default, a type does not have any properties to return. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The set of properties that should be exposed for this data type. If no properties should be exposed, this may return null. The default implementation always returns null.</para>
+          <para>An easy implementation of this method can call the <see cref="Overload:System.ComponentModel.TypeConverter.GetProperties" /> method for the correct data type.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A type descriptor through which additional context can be provided. </param>
         <param name="value">
@@ -277,12 +301,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether this object supports properties. The default is false.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if the <see cref="M:System.Drawing.FontConverter.GetPropertiesSupported(System.ComponentModel.ITypeDescriptorContext)" /> method should be called to find the properties of this object; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A type descriptor through which additional context can be provided. </param>
       </Docs>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/FontFamily.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/FontFamily.xml
index f8c566d9fc7..bffaa0c4e9e 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/FontFamily.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/FontFamily.xml
@@ -114,6 +114,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Releases all resources used by this <see cref="T:System.Drawing.FontFamily" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -130,12 +134,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified object is a <see cref="T:System.Drawing.FontFamily" /> and is identical to this <see cref="T:System.Drawing.FontFamily" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is a <see cref="T:System.Drawing.FontFamily" /> and is identical to this <see cref="T:System.Drawing.FontFamily" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test. </param>
       </Docs>
@@ -246,12 +253,15 @@
         <Parameter Name="style" Type="System.Drawing.FontStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the cell ascent, in design units, of the <see cref="T:System.Drawing.FontFamily" /> of the specified style.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The cell ascent for this <see cref="T:System.Drawing.FontFamily" /> that uses the specified <see cref="T:System.Drawing.FontStyle" />.</para>
+        </returns>
         <param name="style">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.FontStyle" /> that contains style information for the font. </param>
       </Docs>
@@ -270,12 +280,15 @@
         <Parameter Name="style" Type="System.Drawing.FontStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the cell descent, in design units, of the <see cref="T:System.Drawing.FontFamily" /> of the specified style. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The cell descent metric for this <see cref="T:System.Drawing.FontFamily" /> that uses the specified <see cref="T:System.Drawing.FontStyle" />.</para>
+        </returns>
         <param name="style">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.FontStyle" /> that contains style information for the font. </param>
       </Docs>
@@ -294,7 +307,6 @@
         <Parameter Name="style" Type="System.Drawing.FontStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -304,6 +316,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the height, in font design units, of the em square for the specified style.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The height of the em square.</para>
+        </returns>
         <param name="style">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.FontStyle" /> for which to get the em height. </param>
       </Docs>
@@ -322,12 +338,15 @@
         <Parameter Name="graphics" Type="System.Drawing.Graphics" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'FontFamily []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array that contains all the <see cref="T:System.Drawing.FontFamily" /> objects available for the specified graphics context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Drawing.FontFamily" /> objects available for the specified <see cref="T:System.Drawing.Graphics" /> object.</para>
+        </returns>
         <param name="graphics">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Graphics" /> object from which to return <see cref="T:System.Drawing.FontFamily" /> objects. </param>
       </Docs>
@@ -344,12 +363,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a hash code for this <see cref="T:System.Drawing.FontFamily" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for this <see cref="T:System.Drawing.FontFamily" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -366,12 +388,15 @@
         <Parameter Name="style" Type="System.Drawing.FontStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the line spacing, in design units, of the <see cref="T:System.Drawing.FontFamily" /> of the specified style. The line spacing is the vertical distance between the base lines of two consecutive lines of text. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The distance between two consecutive lines of text.</para>
+        </returns>
         <param name="style">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.FontStyle" /> to apply. </param>
       </Docs>
@@ -390,7 +415,6 @@
         <Parameter Name="language" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To indicate language neutral, you should specify 0 for the <paramref name="language" /> parameter. For a listing of the available languages and sublanguages, see the Winnt.h header file. If you have vsprvs installed, this header file can typically be found relative to the vsprvs installation directory at \\VC\PlatformSDK\Include.</para>
@@ -399,6 +423,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name, in the specified language, of this <see cref="T:System.Drawing.FontFamily" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that represents the name, in the specified language, of this <see cref="T:System.Drawing.FontFamily" />. </para>
+        </returns>
         <param name="language">
           <attribution license="cc4" from="Microsoft" modified="false" />The language in which the name is returned. </param>
       </Docs>
@@ -417,12 +445,15 @@
         <Parameter Name="style" Type="System.Drawing.FontStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified <see cref="T:System.Drawing.FontStyle" /> enumeration is available.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Drawing.FontStyle" /> is available; otherwise, false.</para>
+        </returns>
         <param name="style">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.FontStyle" /> to test. </param>
       </Docs>
@@ -458,12 +489,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Drawing.FontFamily" /> to a human-readable string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string that represents this <see cref="T:System.Drawing.FontFamily" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/Graphics.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/Graphics.xml
index 4b31709dec7..07c191a3223 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/Graphics.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/Graphics.xml
@@ -66,7 +66,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Drawing2D.GraphicsContainer'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method with the <see cref="M:System.Drawing.Graphics.EndContainer(System.Drawing.Drawing2D.GraphicsContainer)" /> method to create nested graphics containers. Graphics containers retain graphics state, such as transformation, clipping region, and rendering properties.</para>
@@ -80,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves a graphics container with the current state of this <see cref="T:System.Drawing.Graphics" /> and opens and uses a new graphics container.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns a <see cref="T:System.Drawing.Drawing2D.GraphicsContainer" /> that represents the state of this <see cref="T:System.Drawing.Graphics" /> at the time of the method call.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -98,7 +101,6 @@
         <Parameter Name="unit" Type="System.Drawing.GraphicsUnit" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Drawing2D.GraphicsContainer'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method with the <see cref="M:System.Drawing.Graphics.EndContainer(System.Drawing.Drawing2D.GraphicsContainer)" /> method to create nested graphics containers. Graphics containers retain graphics state, such as transformation, clipping region, and rendering properties.</para>
@@ -113,6 +115,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves a graphics container with the current state of this <see cref="T:System.Drawing.Graphics" /> and opens and uses a new graphics container with the specified scale transformation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns a <see cref="T:System.Drawing.Drawing2D.GraphicsContainer" /> that represents the state of this <see cref="T:System.Drawing.Graphics" /> at the time of the method call.</para>
+        </returns>
         <param name="dstrect">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.Drawing.Rectangle" /> structure that, together with the <paramref name="srcrect" /> parameter, specifies a scale transformation for the container. </param>
@@ -139,7 +145,6 @@
         <Parameter Name="unit" Type="System.Drawing.GraphicsUnit" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Drawing2D.GraphicsContainer'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method with the <see cref="M:System.Drawing.Graphics.EndContainer(System.Drawing.Drawing2D.GraphicsContainer)" /> method to create nested graphics containers. Graphics containers retain graphics state, such as transformation, clipping region, and rendering properties.</para>
@@ -154,6 +159,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves a graphics container with the current state of this <see cref="T:System.Drawing.Graphics" /> and opens and uses a new graphics container with the specified scale transformation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns a <see cref="T:System.Drawing.Drawing2D.GraphicsContainer" /> that represents the state of this <see cref="T:System.Drawing.Graphics" /> at the time of the method call.</para>
+        </returns>
         <param name="dstrect">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.Drawing.RectangleF" /> structure that, together with the <paramref name="srcrect" /> parameter, specifies a scale transformation for the new graphics container. </param>
@@ -451,6 +460,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Releases all resources used by this <see cref="T:System.Drawing.Graphics" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -5616,7 +5629,6 @@ The pen must be non-null, or an ArgumentNullException is raised.
         <Parameter Name="hdc" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Graphics'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You should always call the <see cref="M:System.Drawing.Graphics.Dispose" /> method to release the <see cref="T:System.Drawing.Graphics" /> and related resources created by the <see cref="M:System.Drawing.Graphics.FromHdc(System.IntPtr)" /> method.</para>
@@ -5627,6 +5639,10 @@ The pen must be non-null, or an ArgumentNullException is raised.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Drawing.Graphics" /> from the specified handle to a device context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns a new <see cref="T:System.Drawing.Graphics" /> for the specified device context.</para>
+        </returns>
         <param name="hdc">
           <attribution license="cc4" from="Microsoft" modified="false" />Handle to a device context. </param>
       </Docs>
@@ -5651,7 +5667,6 @@ The pen must be non-null, or an ArgumentNullException is raised.
         <Parameter Name="hdevice" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Graphics'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You should always call the <see cref="M:System.Drawing.Graphics.Dispose" /> method to release the <see cref="T:System.Drawing.Graphics" /> and related resources created by the <see cref="M:System.Drawing.Graphics.FromHdc(System.IntPtr,System.IntPtr)" /> method.</para>
@@ -5663,6 +5678,10 @@ The pen must be non-null, or an ArgumentNullException is raised.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Drawing.Graphics" /> from the specified handle to a device context and handle to a device.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns a new <see cref="T:System.Drawing.Graphics" /> for the specified device context and device.</para>
+        </returns>
         <param name="hdc">
           <attribution license="cc4" from="Microsoft" modified="false" />Handle to a device context. </param>
         <param name="hdevice">
@@ -5688,7 +5707,6 @@ The pen must be non-null, or an ArgumentNullException is raised.
         <Parameter Name="hdc" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Graphics'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method should not be used.</para>
@@ -5697,6 +5715,10 @@ The pen must be non-null, or an ArgumentNullException is raised.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Drawing.Graphics" /> for the specified device context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Graphics" /> for the specified device context.</para>
+        </returns>
         <param name="hdc">
           <attribution license="cc4" from="Microsoft" modified="false" />Handle to a device context. </param>
       </Docs>
@@ -5720,7 +5742,6 @@ The pen must be non-null, or an ArgumentNullException is raised.
         <Parameter Name="hwnd" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Graphics'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You should always call the <see cref="M:System.Drawing.Graphics.Dispose" /> method to release the <see cref="T:System.Drawing.Graphics" /> and related resources created by the <see cref="M:System.Drawing.Graphics.FromHwnd(System.IntPtr)" /> method.</para>
@@ -5729,6 +5750,10 @@ The pen must be non-null, or an ArgumentNullException is raised.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Drawing.Graphics" /> from the specified handle to a window.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns a new <see cref="T:System.Drawing.Graphics" /> for the specified window handle.</para>
+        </returns>
         <param name="hwnd">
           <attribution license="cc4" from="Microsoft" modified="false" />Handle to a window. </param>
       </Docs>
@@ -5752,7 +5777,6 @@ The pen must be non-null, or an ArgumentNullException is raised.
         <Parameter Name="hwnd" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Graphics'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method should not be used.</para>
@@ -5761,6 +5785,10 @@ The pen must be non-null, or an ArgumentNullException is raised.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Drawing.Graphics" /> for the specified windows handle.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Graphics" /> for the specified window handle.</para>
+        </returns>
         <param name="hwnd">
           <attribution license="cc4" from="Microsoft" modified="false" />Handle to a window. </param>
       </Docs>
@@ -5784,7 +5812,6 @@ The pen must be non-null, or an ArgumentNullException is raised.
         <Parameter Name="image" Type="System.Drawing.Image" />
       </Parameters>
       <Docs>
-        <returns>A Graphics context that can be used to draw on the given image.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the image has an indexed pixel format, this method throws an exception with the message, "A Graphics object cannot be created from an image that has an indexed pixel format." The indexed pixel formats are shown in the following list.</para>
@@ -5835,6 +5862,10 @@ The pen must be non-null, or an ArgumentNullException is raised.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Drawing.Graphics" /> from the specified <see cref="T:System.Drawing.Image" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns a new <see cref="T:System.Drawing.Graphics" /> for the specified <see cref="T:System.Drawing.Image" />.</para>
+        </returns>
         <param name="image">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.Drawing.Image" /> from which to create the new <see cref="T:System.Drawing.Graphics" />. </param>
@@ -5860,7 +5891,6 @@ The pen must be non-null, or an ArgumentNullException is raised.
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is an object array where the first element contains the cumulative clip region and the second element contains the cumulative translate/transform matrix.</para>
@@ -5869,6 +5899,10 @@ The pen must be non-null, or an ArgumentNullException is raised.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the cumulative graphics context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> representing the cumulative graphics context.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHalftonePalette">
@@ -5879,7 +5913,6 @@ The pen must be non-null, or an ArgumentNullException is raised.
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The purpose of the <see cref="M:System.Drawing.Graphics.GetHalftonePalette" /> method is to enable ndptecgdiplus to produce a better quality halftone when the display uses 8 bits per pixel. To display an image using the halftone palette, use the following procedure.</para>
@@ -5888,6 +5921,10 @@ The pen must be non-null, or an ArgumentNullException is raised.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a handle to the current Windows halftone palette.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Internal pointer that specifies the handle to the palette.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -5902,7 +5939,6 @@ The pen must be non-null, or an ArgumentNullException is raised.
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The device context is a Windows structure based on ndptecgdi that defines a set of graphical objects and their associated attributes, as well as the graphical modes that affect output. This method returns that device context with the exception of a font. Because a font is not selected, calls to the <see cref="M:System.Drawing.Font.FromHdc(System.IntPtr)" /> method using a handle returned from the <see cref="M:System.Drawing.Graphics.GetHdc" /> method will fail.</para>
@@ -5912,6 +5948,10 @@ The pen must be non-null, or an ArgumentNullException is raised.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the handle to the device context associated with this <see cref="T:System.Drawing.Graphics" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Handle to the device context associated with this <see cref="T:System.Drawing.Graphics" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -5928,12 +5968,15 @@ The pen must be non-null, or an ArgumentNullException is raised.
         <Parameter Name="color" Type="System.Drawing.Color" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Color'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the nearest color to the specified <see cref="T:System.Drawing.Color" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Color" /> structure that represents the nearest color to the one specified with the <paramref name="color" /> parameter.</para>
+        </returns>
         <param name="color">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.Drawing.Color" /> structure for which to find a match. </param>
@@ -6077,12 +6120,15 @@ The pen must be non-null, or an ArgumentNullException is raised.
         <Parameter Name="point" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified <see cref="T:System.Drawing.Point" /> structure is contained within the visible clip region of this <see cref="T:System.Drawing.Graphics" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the point specified by the <paramref name="point" /> parameter is contained within the visible clip region of this <see cref="T:System.Drawing.Graphics" />; otherwise, false.</para>
+        </returns>
         <param name="point">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.Drawing.Point" /> structure to test for visibility. </param>
@@ -6102,12 +6148,15 @@ The pen must be non-null, or an ArgumentNullException is raised.
         <Parameter Name="point" Type="System.Drawing.PointF" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified <see cref="T:System.Drawing.PointF" /> structure is contained within the visible clip region of this <see cref="T:System.Drawing.Graphics" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the point specified by the <paramref name="point" /> parameter is contained within the visible clip region of this <see cref="T:System.Drawing.Graphics" />; otherwise, false.</para>
+        </returns>
         <param name="point">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.Drawing.PointF" /> structure to test for visibility. </param>
@@ -6127,12 +6176,15 @@ The pen must be non-null, or an ArgumentNullException is raised.
         <Parameter Name="rect" Type="System.Drawing.Rectangle" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the rectangle specified by a <see cref="T:System.Drawing.Rectangle" /> structure is contained within the visible clip region of this <see cref="T:System.Drawing.Graphics" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the rectangle specified by the <paramref name="rect" /> parameter is contained within the visible clip region of this <see cref="T:System.Drawing.Graphics" />; otherwise, false.</para>
+        </returns>
         <param name="rect">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.Drawing.Rectangle" /> structure to test for visibility. </param>
@@ -6152,12 +6204,15 @@ The pen must be non-null, or an ArgumentNullException is raised.
         <Parameter Name="rect" Type="System.Drawing.RectangleF" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the rectangle specified by a <see cref="T:System.Drawing.RectangleF" /> structure is contained within the visible clip region of this <see cref="T:System.Drawing.Graphics" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the rectangle specified by the <paramref name="rect" /> parameter is contained within the visible clip region of this <see cref="T:System.Drawing.Graphics" />; otherwise, false.</para>
+        </returns>
         <param name="rect">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.Drawing.RectangleF" /> structure to test for visibility. </param>
@@ -6178,12 +6233,15 @@ The pen must be non-null, or an ArgumentNullException is raised.
         <Parameter Name="y" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the point specified by a pair of coordinates is contained within the visible clip region of this <see cref="T:System.Drawing.Graphics" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the point defined by the <paramref name="x" /> and <paramref name="y" /> parameters is contained within the visible clip region of this <see cref="T:System.Drawing.Graphics" />; otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate of the point to test for visibility. </param>
         <param name="y">
@@ -6205,12 +6263,15 @@ The pen must be non-null, or an ArgumentNullException is raised.
         <Parameter Name="y" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the point specified by a pair of coordinates is contained within the visible clip region of this <see cref="T:System.Drawing.Graphics" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the point defined by the <paramref name="x" /> and <paramref name="y" /> parameters is contained within the visible clip region of this <see cref="T:System.Drawing.Graphics" />; otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate of the point to test for visibility. </param>
         <param name="y">
@@ -6234,12 +6295,15 @@ The pen must be non-null, or an ArgumentNullException is raised.
         <Parameter Name="height" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the rectangle specified by a pair of coordinates, a width, and a height is contained within the visible clip region of this <see cref="T:System.Drawing.Graphics" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the rectangle defined by the <paramref name="x" />, <paramref name="y" />, <paramref name="width" />, and <paramref name="height" /> parameters is contained within the visible clip region of this <see cref="T:System.Drawing.Graphics" />; otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate of the upper-left corner of the rectangle to test for visibility. </param>
         <param name="y">
@@ -6267,12 +6331,15 @@ The pen must be non-null, or an ArgumentNullException is raised.
         <Parameter Name="height" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the rectangle specified by a pair of coordinates, a width, and a height is contained within the visible clip region of this <see cref="T:System.Drawing.Graphics" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the rectangle defined by the <paramref name="x" />, <paramref name="y" />, <paramref name="width" />, and <paramref name="height" /> parameters is contained within the visible clip region of this <see cref="T:System.Drawing.Graphics" />; otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate of the upper-left corner of the rectangle to test for visibility. </param>
         <param name="y">
@@ -6322,7 +6389,6 @@ The pen must be non-null, or an ArgumentNullException is raised.
         <Parameter Name="stringFormat" Type="System.Drawing.StringFormat" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Region []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The regions returned by this method are resolution-dependent, so there might be a slight loss of accuracy if strings are recorded in a metafile at one resolution and later played back at a different resolution.</para>
@@ -6331,6 +6397,10 @@ The pen must be non-null, or an ArgumentNullException is raised.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of <see cref="T:System.Drawing.Region" /> objects, each of which bounds a range of character positions within the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns an array of <see cref="T:System.Drawing.Region" /> objects, each of which bounds a range of character positions within the specified string.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />String to measure. </param>
         <param name="font">
@@ -6359,7 +6429,6 @@ The pen must be non-null, or an ArgumentNullException is raised.
         <Parameter Name="font" Type="System.Drawing.Font" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SizeF'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.Drawing.Graphics.MeasureString" /> method is designed for use with individual strings and includes a small amount of extra space before and after the string to allow for overhanging glyphs. Also, the <see cref="Overload:System.Drawing.Graphics.DrawString" /> method adjusts glyph points to optimize display quality and might display a string narrower than reported by <see cref="Overload:System.Drawing.Graphics.MeasureString" />. To obtain metrics suitable for adjacent strings in layout (for example, when implementing formatted text), use the <see cref="M:System.Drawing.Graphics.MeasureCharacterRanges(System.String,System.Drawing.Font,System.Drawing.RectangleF,System.Drawing.StringFormat)" /> method or one of the <see cref="M:System.Drawing.Graphics.MeasureString(System.String,System.Drawing.Font,System.Drawing.PointF,System.Drawing.StringFormat)" /> methods that takes a <see cref="T:System.Drawing.StringFormat" />, and pass <see cref="P:System.Drawing.StringFormat.GenericTypographic" />. Also, ensure the <see cref="P:System.Drawing.Graphics.TextRenderingHint" /> for the <see cref="T:System.Drawing.Graphics" /> is <see cref="F:System.Drawing.Text.TextRenderingHint.AntiAlias" />.</para>
@@ -6368,6 +6437,10 @@ The pen must be non-null, or an ArgumentNullException is raised.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Measures the specified string when drawn with the specified <see cref="T:System.Drawing.Font" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns a <see cref="T:System.Drawing.SizeF" /> structure that represents the size, in the units specified by the <see cref="P:System.Drawing.Graphics.PageUnit" /> property, of the string specified by the <paramref name="text" /> parameter as drawn with the <paramref name="font" /> parameter.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />String to measure. </param>
         <param name="font">
@@ -6391,7 +6464,6 @@ The pen must be non-null, or an ArgumentNullException is raised.
         <Parameter Name="layoutArea" Type="System.Drawing.SizeF" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SizeF'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.Drawing.Graphics.MeasureString" /> method is designed for use with individual strings and includes a small amount of extra space before and after the string to allow for overhanging glyphs. Also, the <see cref="Overload:System.Drawing.Graphics.DrawString" /> method adjusts glyph points to optimize display quality and might display a string narrower than reported by <see cref="Overload:System.Drawing.Graphics.MeasureString" />. To obtain metrics suitable for adjacent strings in layout (for example, when implementing formatted text), use the <see cref="M:System.Drawing.Graphics.MeasureCharacterRanges(System.String,System.Drawing.Font,System.Drawing.RectangleF,System.Drawing.StringFormat)" /> method or one of the <see cref="M:System.Drawing.Graphics.MeasureString(System.String,System.Drawing.Font,System.Drawing.PointF,System.Drawing.StringFormat)" /> methods that takes a <see cref="T:System.Drawing.StringFormat" />, and pass <see cref="P:System.Drawing.StringFormat.GenericTypographic" />. Also, ensure the <see cref="P:System.Drawing.Graphics.TextRenderingHint" /> for the <see cref="T:System.Drawing.Graphics" /> is <see cref="F:System.Drawing.Text.TextRenderingHint.AntiAlias" />.</para>
@@ -6400,6 +6472,10 @@ The pen must be non-null, or an ArgumentNullException is raised.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Measures the specified string when drawn with the specified <see cref="T:System.Drawing.Font" /> within the specified layout area.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns a <see cref="T:System.Drawing.SizeF" /> structure that represents the size, in the units specified by the <see cref="P:System.Drawing.Graphics.PageUnit" /> property, of the string specified by the <paramref name="text" /> parameter as drawn with the <paramref name="font" /> parameter.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />String to measure. </param>
         <param name="font">
@@ -6426,7 +6502,6 @@ The pen must be non-null, or an ArgumentNullException is raised.
         <Parameter Name="width" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SizeF'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="width" /> parameter specifies the maximum value of the width component of the returned <see cref="T:System.Drawing.SizeF" /> structure (<see cref="P:System.Drawing.SizeF.Width" />). If the <paramref name="width" /> parameter is less than the actual width of the string, the returned <see cref="P:System.Drawing.SizeF.Width" /> component is truncated to a value representing the maximum number of characters that will fit within the specified width. To accommodate the entire string, the returned <see cref="P:System.Drawing.SizeF.Height" /> component is adjusted to a value that allows displaying the string with character wrap.</para>
@@ -6436,6 +6511,10 @@ The pen must be non-null, or an ArgumentNullException is raised.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Measures the specified string when drawn with the specified <see cref="T:System.Drawing.Font" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns a <see cref="T:System.Drawing.SizeF" /> structure that represents the size, in the units specified by the <see cref="P:System.Drawing.Graphics.PageUnit" /> property, of the string specified in the <paramref name="text" /> parameter as drawn with the <paramref name="font" /> parameter.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />String to measure. </param>
         <param name="font">
@@ -6462,7 +6541,6 @@ The pen must be non-null, or an ArgumentNullException is raised.
         <Parameter Name="stringFormat" Type="System.Drawing.StringFormat" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SizeF'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.Drawing.Graphics.MeasureString" /> method is designed for use with individual strings and includes a small amount of extra space before and after the string to allow for overhanging glyphs. Also, the <see cref="Overload:System.Drawing.Graphics.DrawString" /> method adjusts glyph points to optimize display quality and might display a string narrower than reported by <see cref="Overload:System.Drawing.Graphics.MeasureString" />. To obtain metrics suitable for adjacent strings in layout (for example, when implementing formatted text), use the <see cref="M:System.Drawing.Graphics.MeasureCharacterRanges(System.String,System.Drawing.Font,System.Drawing.RectangleF,System.Drawing.StringFormat)" /> method or one of the <see cref="M:System.Drawing.Graphics.MeasureString(System.String,System.Drawing.Font,System.Drawing.PointF,System.Drawing.StringFormat)" /> methods that takes a <see cref="T:System.Drawing.StringFormat" />, and pass <see cref="P:System.Drawing.StringFormat.GenericTypographic" />. Also, ensure the <see cref="P:System.Drawing.Graphics.TextRenderingHint" /> for the <see cref="T:System.Drawing.Graphics" /> is <see cref="F:System.Drawing.Text.TextRenderingHint.AntiAlias" />.</para>
@@ -6471,6 +6549,10 @@ The pen must be non-null, or an ArgumentNullException is raised.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Measures the specified string when drawn with the specified <see cref="T:System.Drawing.Font" /> and formatted with the specified <see cref="T:System.Drawing.StringFormat" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns a <see cref="T:System.Drawing.SizeF" /> structure that represents the size, in the units specified by the <see cref="P:System.Drawing.Graphics.PageUnit" /> property, of the string specified by the <paramref name="text" /> parameter as drawn with the <paramref name="font" /> parameter and the <paramref name="stringFormat" /> parameter.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />String to measure. </param>
         <param name="font">
@@ -6501,7 +6583,6 @@ The pen must be non-null, or an ArgumentNullException is raised.
         <Parameter Name="stringFormat" Type="System.Drawing.StringFormat" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SizeF'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.Drawing.Graphics.MeasureString" /> method is designed for use with individual strings and includes a small amount of extra space before and after the string to allow for overhanging glyphs. Also, the <see cref="Overload:System.Drawing.Graphics.DrawString" /> method adjusts glyph points to optimize display quality and might display a string narrower than reported by <see cref="Overload:System.Drawing.Graphics.MeasureString" />. To obtain metrics suitable for adjacent strings in layout (for example, when implementing formatted text), use the <see cref="M:System.Drawing.Graphics.MeasureCharacterRanges(System.String,System.Drawing.Font,System.Drawing.RectangleF,System.Drawing.StringFormat)" /> method or one of the <see cref="M:System.Drawing.Graphics.MeasureString(System.String,System.Drawing.Font,System.Drawing.PointF,System.Drawing.StringFormat)" /> methods that takes a <see cref="T:System.Drawing.StringFormat" />, and pass <see cref="P:System.Drawing.StringFormat.GenericTypographic" />. Also, ensure the <see cref="P:System.Drawing.Graphics.TextRenderingHint" /> for the <see cref="T:System.Drawing.Graphics" /> is <see cref="F:System.Drawing.Text.TextRenderingHint.AntiAlias" />.</para>
@@ -6510,6 +6591,10 @@ The pen must be non-null, or an ArgumentNullException is raised.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Measures the specified string when drawn with the specified <see cref="T:System.Drawing.Font" /> and formatted with the specified <see cref="T:System.Drawing.StringFormat" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns a <see cref="T:System.Drawing.SizeF" /> structure that represents the size, in the units specified by the <see cref="P:System.Drawing.Graphics.PageUnit" /> property, of the string specified in the <paramref name="text" /> parameter as drawn with the <paramref name="font" /> parameter and the <paramref name="stringFormat" /> parameter.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />String to measure. </param>
         <param name="font">
@@ -6540,7 +6625,6 @@ The pen must be non-null, or an ArgumentNullException is raised.
         <Parameter Name="format" Type="System.Drawing.StringFormat" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SizeF'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.Drawing.Graphics.MeasureString" /> method is designed for use with individual strings and includes a small amount of extra space before and after the string to allow for overhanging glyphs. Also, the <see cref="Overload:System.Drawing.Graphics.DrawString" /> method adjusts glyph points to optimize display quality and might display a string narrower than reported by <see cref="Overload:System.Drawing.Graphics.MeasureString" />. To obtain metrics suitable for adjacent strings in layout (for example, when implementing formatted text), use the <see cref="M:System.Drawing.Graphics.MeasureCharacterRanges(System.String,System.Drawing.Font,System.Drawing.RectangleF,System.Drawing.StringFormat)" /> method or one of the <see cref="M:System.Drawing.Graphics.MeasureString(System.String,System.Drawing.Font,System.Drawing.PointF,System.Drawing.StringFormat)" /> methods that takes a <see cref="T:System.Drawing.StringFormat" />, and pass <see cref="P:System.Drawing.StringFormat.GenericTypographic" />. Also, ensure the <see cref="P:System.Drawing.Graphics.TextRenderingHint" /> for the <see cref="T:System.Drawing.Graphics" /> is <see cref="F:System.Drawing.Text.TextRenderingHint.AntiAlias" />.</para>
@@ -6549,6 +6633,10 @@ The pen must be non-null, or an ArgumentNullException is raised.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Measures the specified string when drawn with the specified <see cref="T:System.Drawing.Font" /> and formatted with the specified <see cref="T:System.Drawing.StringFormat" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns a <see cref="T:System.Drawing.SizeF" /> structure that represents the size, in the units specified by the <see cref="P:System.Drawing.Graphics.PageUnit" /> property, of the string specified in the <paramref name="text" /> parameter as drawn with the <paramref name="font" /> parameter and the <paramref name="stringFormat" /> parameter.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />String to measure. </param>
         <param name="font">
@@ -6959,7 +7047,6 @@ The pen must be non-null, or an ArgumentNullException is raised.
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>A saved copy of the internal graphics state.  You can restore the state on the Graphics context by calling the <see cref="M:System.Drawing.Graphics.Restore" /> method.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When you call the <see cref="M:System.Drawing.Graphics.Save" /> method of a <see cref="T:System.Drawing.Graphics" />, an information block that holds the state of the <see cref="T:System.Drawing.Graphics" /> is put on a stack. The <see cref="M:System.Drawing.Graphics.Save" /> method returns a <see cref="T:System.Drawing.Drawing2D.GraphicsState" /> that identifies that information block. When you pass the identifying <see cref="T:System.Drawing.Drawing2D.GraphicsState" /> to the <see cref="M:System.Drawing.Graphics.Restore(System.Drawing.Drawing2D.GraphicsState)" /> method, the information block is removed from the stack and is used to restore the <see cref="T:System.Drawing.Graphics" /> to the state it was in at the time of the <see cref="M:System.Drawing.Graphics.Save" /> method call. Note that the <see cref="T:System.Drawing.Drawing2D.GraphicsState" /> returned by a given call to the <see cref="M:System.Drawing.Graphics.Save" /> method can be passed only once to the <see cref="M:System.Drawing.Graphics.Restore(System.Drawing.Drawing2D.GraphicsState)" /> method.</para>
@@ -6971,6 +7058,10 @@ The pen must be non-null, or an ArgumentNullException is raised.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the current state of this <see cref="T:System.Drawing.Graphics" /> and identifies the saved state with a <see cref="T:System.Drawing.Drawing2D.GraphicsState" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns a <see cref="T:System.Drawing.Drawing2D.GraphicsState" /> that represents the saved state of this <see cref="T:System.Drawing.Graphics" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/IDeviceContext.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/IDeviceContext.xml
index e3c2e3ab90e..4ddb4eb6d9c 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/IDeviceContext.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/IDeviceContext.xml
@@ -30,7 +30,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -43,6 +42,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the handle to a Windows device context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IntPtr" /> representing the handle of a device context.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/Icon.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/Icon.xml
index dd2ad182017..9b8eed7c52d 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/Icon.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/Icon.xml
@@ -323,12 +323,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clones the <see cref="T:System.Drawing.Icon" />, creating a duplicate image.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that can be cast to an <see cref="T:System.Drawing.Icon" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -351,6 +354,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Releases all resources used by this <see cref="T:System.Drawing.Icon" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -370,7 +377,6 @@
         <Parameter Name="filePath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A relative path is assumed to be relative to the current working directory.</para>
@@ -380,6 +386,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an icon representation of an image that is contained in the specified file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Icon" /> representation of the image that is contained in the specified file.</para>
+        </returns>
         <param name="filePath">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to the file that contains an image.</param>
       </Docs>
@@ -410,7 +420,6 @@
         <Parameter Name="handle" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Icon'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When using this method, you must dispose of the original icon by using the <unmanagedCodeEntityReference>DestroyIcon</unmanagedCodeEntityReference> method in the Win32 API to ensure that the resources are released.</para>
@@ -419,6 +428,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a GDI+ <see cref="T:System.Drawing.Icon" /> from the specified Windows handle to an icon (HICON).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Icon" /> this method creates.</para>
+        </returns>
         <param name="handle">
           <attribution license="cc4" from="Microsoft" modified="false" />A Windows handle to an icon. </param>
       </Docs>
@@ -551,7 +564,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Bitmap'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The transparent areas of the icon are lost when it is converted to a bitmap, and the transparent color of the resulting bitmap is set to RGB(13,11,12). The returned bitmap has the same height and width as the original icon.</para>
@@ -560,6 +572,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Drawing.Icon" /> to a GDI+ <see cref="T:System.Drawing.Bitmap" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Bitmap" /> that represents the converted <see cref="T:System.Drawing.Icon" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -574,12 +590,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a human-readable string that describes the <see cref="T:System.Drawing.Icon" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that describes the <see cref="T:System.Drawing.Icon" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/IconConverter.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/IconConverter.xml
index 8abe1bbe2f0..6326161aa8e 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/IconConverter.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/IconConverter.xml
@@ -49,7 +49,6 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns true only if <paramref name="sourceType" /> is equal to a byte array.</para>
@@ -58,6 +57,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether this <see cref="T:System.Drawing.IconConverter" /> can convert an instance of a specified type to an <see cref="T:System.Drawing.Icon" />, using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if this <see cref="T:System.Drawing.IconConverter" /> can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="sourceType">
@@ -79,7 +82,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns true only if <paramref name="destinationType" /> is equal to a byte array or string.</para>
@@ -88,6 +90,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether this <see cref="T:System.Drawing.IconConverter" /> can convert an <see cref="T:System.Drawing.Icon" /> to an instance of a specified type, using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if this <see cref="T:System.Drawing.IconConverter" /> can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="destinationType">
@@ -110,12 +116,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a specified object to an <see cref="T:System.Drawing.Icon" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If this method succeeds, it returns the <see cref="T:System.Drawing.Icon" /> that it created by converting the specified object. Otherwise, it throws an exception.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
@@ -141,7 +150,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default implementation calls the <see cref="M:System.Object.ToString" /> method on the object if the object is valid and if the destination type is string. If this method cannot convert to the destination type, it throws a <see cref="T:System.NotSupportedException" /> exception.</para>
@@ -150,6 +158,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an <see cref="T:System.Drawing.Icon" /> (or an object that can be cast to an <see cref="T:System.Drawing.Icon" />) to a specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns the converted object.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/Image.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/Image.xml
index a88ebbf39bc..4ca4b1f2798 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/Image.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/Image.xml
@@ -56,12 +56,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this <see cref="T:System.Drawing.Image" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Image" /> this method creates, cast as an object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -88,6 +91,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Releases all resources used by this <see cref="T:System.Drawing.Image" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -330,7 +337,6 @@
         <Parameter Name="filename" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Image'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Managed GDI+ has built-in encoders and decoders that support the following file types: </para>
@@ -361,6 +367,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Drawing.Image" /> from the specified file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Image" /> this method creates.</para>
+        </returns>
         <param name="filename">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the name of the file from which to create the <see cref="T:System.Drawing.Image" />. </param>
       </Docs>
@@ -380,7 +390,6 @@
         <Parameter Name="useEmbeddedColorManagement" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Image'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Managed GDI+ has built-in encoders and decoders that support the following file types: </para>
@@ -412,6 +421,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Drawing.Image" /> from the specified file using embedded color management information in that file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Image" /> this method creates.</para>
+        </returns>
         <param name="filename">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the name of the file from which to create the <see cref="T:System.Drawing.Image" />. </param>
         <param name="useEmbeddedColorManagement">
@@ -432,7 +445,6 @@
         <Parameter Name="hbitmap" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Bitmap'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Drawing.Image.FromHbitmap(System.IntPtr)" /> method makes a copy of the ndptecgdi bitmap; so you can release the incoming ndptecgdi bitmap using the ndptecgdi DeleteObject method immediately after creating the new <see cref="T:System.Drawing.Image" />.</para>
@@ -441,6 +453,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Drawing.Bitmap" /> from a handle to a GDI bitmap.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Bitmap" /> this method creates.</para>
+        </returns>
         <param name="hbitmap">
           <attribution license="cc4" from="Microsoft" modified="false" />The ndptecgdi bitmap handle from which to create the <see cref="T:System.Drawing.Bitmap" />. </param>
       </Docs>
@@ -460,7 +476,6 @@
         <Parameter Name="hpalette" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Bitmap'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Drawing.Image.FromHbitmap(System.IntPtr,System.IntPtr)" /> method makes a copy of the ndptecgdi bitmap; so you can release the incoming ndptecgdi bitmap using the ndptecgdi DeleteObject method immediately after creating the new <see cref="T:System.Drawing.Image" />.</para>
@@ -469,6 +484,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Drawing.Bitmap" /> from a handle to a GDI bitmap and a handle to a GDI palette.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Bitmap" /> this method creates.</para>
+        </returns>
         <param name="hbitmap">
           <attribution license="cc4" from="Microsoft" modified="false" />The ndptecgdi bitmap handle from which to create the <see cref="T:System.Drawing.Bitmap" />. </param>
         <param name="hpalette">
@@ -489,7 +508,6 @@
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Image'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You must keep the stream open for the lifetime of the <see cref="T:System.Drawing.Image" />.</para>
@@ -502,6 +520,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Drawing.Image" /> from the specified data stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Image" /> this method creates.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IO.Stream" /> that contains the data for this <see cref="T:System.Drawing.Image" />. </param>
       </Docs>
@@ -521,7 +543,6 @@
         <Parameter Name="useEmbeddedColorManagement" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Image'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You must keep the stream open for the lifetime of the <see cref="T:System.Drawing.Image" />.</para>
@@ -535,6 +556,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Drawing.Image" /> from the specified data stream, optionally using embedded color management information in that stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Image" /> this method creates.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IO.Stream" /> that contains the data for this <see cref="T:System.Drawing.Image" />. </param>
         <param name="useEmbeddedColorManagement">
@@ -561,7 +586,6 @@
         <Parameter Name="validateImageData" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="useEmbeddedColorManagement" /> parameter specifies whether the new <see cref="T:System.Drawing.Image" /> applies color correction according to color management information that is embedded in the data stream. Embedded information can include International Color Consortium (ICC) profiles, gamma values, and chromaticity information.</para>
@@ -573,6 +597,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Drawing.Image" /> from the specified data stream, optionally using embedded color management information and validating the image data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Image" /> this method creates.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IO.Stream" /> that contains the data for this <see cref="T:System.Drawing.Image" />. </param>
         <param name="useEmbeddedColorManagement">
@@ -611,12 +639,15 @@
         <Parameter Name="encoder" Type="System.Guid" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Imaging.EncoderParameters'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns information about the parameters supported by the specified image encoder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Drawing.Imaging.EncoderParameters" /> that contains an array of <see cref="T:System.Drawing.Imaging.EncoderParameter" /> objects. Each <see cref="T:System.Drawing.Imaging.EncoderParameter" /> contains information about one of the parameters supported by the specified image encoder.</para>
+        </returns>
         <param name="encoder">
           <attribution license="cc4" from="Microsoft" modified="false" />A GUID that specifies the image encoder. </param>
       </Docs>
@@ -635,7 +666,6 @@
         <Parameter Name="dimension" Type="System.Drawing.Imaging.FrameDimension" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns information about multiple-frame images, which come in two styles: multiple page and multiple resolution.</para>
@@ -646,6 +676,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of frames of the specified dimension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of frames in the specified dimension.</para>
+        </returns>
         <param name="dimension">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Imaging.FrameDimension" /> that specifies the identity of the dimension type. </param>
       </Docs>
@@ -664,12 +698,15 @@
         <Parameter Name="pixfmt" Type="System.Drawing.Imaging.PixelFormat" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the color depth, in number of bits per pixel, of the specified pixel format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The color depth of the specified pixel format.</para>
+        </returns>
         <param name="pixfmt">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Imaging.PixelFormat" /> member that specifies the format for which to find the size. </param>
       </Docs>
@@ -688,7 +725,6 @@
         <Parameter Name="propid" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Imaging.PropertyItem'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a list of property item IDs and links to more information, see <see cref="P:System.Drawing.Imaging.PropertyItem.Id" />. </para>
@@ -698,6 +734,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the specified property item from this <see cref="T:System.Drawing.Image" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Imaging.PropertyItem" /> this method gets.</para>
+        </returns>
         <param name="propid">
           <attribution license="cc4" from="Microsoft" modified="false" />The ID of the property item to get. </param>
       </Docs>
@@ -791,12 +831,15 @@
         <Parameter Name="pixfmt" Type="System.Drawing.Imaging.PixelFormat" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the pixel format for this <see cref="T:System.Drawing.Image" /> contains alpha information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="pixfmt" /> contains alpha information; otherwise, false.</para>
+        </returns>
         <param name="pixfmt">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Imaging.PixelFormat" /> to test. </param>
       </Docs>
@@ -815,7 +858,6 @@
         <Parameter Name="pixfmt" Type="System.Drawing.Imaging.PixelFormat" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The canonical pixel format indicates a pixel format of 32 bits per pixel. This format specifies 24-bit color depth and an 8-bit alpha channel. </para>
@@ -824,6 +866,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the pixel format is 32 bits per pixel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="pixfmt" /> is canonical; otherwise, false.</para>
+        </returns>
         <param name="pixfmt">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Imaging.PixelFormat" /> to test. </param>
       </Docs>
@@ -842,12 +888,15 @@
         <Parameter Name="pixfmt" Type="System.Drawing.Imaging.PixelFormat" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the pixel format is 64 bits per pixel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="pixfmt" /> is extended; otherwise, false.</para>
+        </returns>
         <param name="pixfmt">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Imaging.PixelFormat" /> enumeration to test. </param>
       </Docs>
@@ -1215,6 +1264,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a frame to the file or stream specified in a previous call to the <see cref="Overload:System.Drawing.Image.Save" /> method. Use this method to save selected frames from a multiple-frame image to another multiple-frame image.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="encoderParams">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Drawing.Imaging.EncoderParameters" /> that holds parameters required by the image encoder that is used by the save-add operation. </param>
       </Docs>
@@ -1239,6 +1292,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a frame to the file or stream specified in a previous call to the <see cref="Overload:System.Drawing.Image.Save" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="image">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Drawing.Image" /> that contains the frame to add. </param>
         <param name="encoderParams">
@@ -1260,7 +1317,6 @@
         <Parameter Name="frameIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The possible values of the <paramref name="dimensionID" /> parameter are properties of the <see cref="T:System.Drawing.Imaging.FrameDimension" />. These can be used to identify an image by its time, resolution, or page number.</para>
@@ -1270,6 +1326,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Selects the frame specified by the dimension and index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always returns 0.</para>
+        </returns>
         <param name="dimension">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Imaging.FrameDimension" /> that specifies the identity of the dimension type. </param>
         <param name="frameIndex">
@@ -1299,6 +1359,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Stores a property item (piece of metadata) in this <see cref="T:System.Drawing.Image" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="propitem">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Imaging.PropertyItem" /> to be stored. </param>
       </Docs>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/ImageAnimator.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/ImageAnimator.xml
index 46539f7e22a..613291deeb7 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/ImageAnimator.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/ImageAnimator.xml
@@ -37,6 +37,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a multiple-frame image as an animation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="image">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Image" /> object to animate. </param>
         <param name="onFrameChangedHandler">
@@ -57,12 +61,15 @@
         <Parameter Name="image" Type="System.Drawing.Image" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Boolean value indicating whether the specified image contains time-based frames.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if the specified image contains time-based frames; otherwise, false.</para>
+        </returns>
         <param name="image">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Image" /> object to test. </param>
       </Docs>
@@ -87,6 +94,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Terminates a running animation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="image">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Image" /> object to stop animating. </param>
         <param name="onFrameChangedHandler">
@@ -110,6 +121,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the frame in all images currently being animated. The new frame is drawn the next time the image is rendered.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -131,6 +146,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the frame in the specified image. The new frame is drawn the next time the image is rendered. This method applies only to images with time-based frames.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="image">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Image" /> object for which to update frames. </param>
       </Docs>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/ImageConverter.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/ImageConverter.xml
index d42c6fde72e..ab90361644d 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/ImageConverter.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/ImageConverter.xml
@@ -50,7 +50,6 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns true only if <paramref name="sourceType" /> is equal to a byte array.</para>
@@ -59,6 +58,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether this <see cref="T:System.Drawing.ImageConverter" /> can convert an instance of a specified type to an <see cref="T:System.Drawing.Image" />, using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if this <see cref="T:System.Drawing.ImageConverter" /> can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="sourceType">
@@ -80,7 +83,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns true only if <paramref name="sourceType" /> is equal to a byte array or string.</para>
@@ -89,6 +91,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether this <see cref="T:System.Drawing.ImageConverter" /> can convert an <see cref="T:System.Drawing.Image" /> to an instance of a specified type, using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if this <see cref="T:System.Drawing.ImageConverter" /> can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="destinationType">
@@ -111,12 +117,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a specified object to an <see cref="T:System.Drawing.Image" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If this method succeeds, it returns the <see cref="T:System.Drawing.Image" /> that it created by converting the specified object. Otherwise, it throws an exception.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
@@ -142,7 +151,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The most common type conversion is to and from a string type. The default implementation calls the <see cref="M:System.Object.ToString" /> method of the object if the object is valid and if the destination type is string. If this method cannot convert the specified object to the destination type, it throws a <see cref="T:System.NotSupportedException" /> exception.</para>
@@ -151,6 +159,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an <see cref="T:System.Drawing.Image" /> (or an object that can be cast to an <see cref="T:System.Drawing.Image" />) to the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns the converted object.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A formatter context. This object can be used to get more information about the environment this converter is being called from. This may be null, so you should always check. Also, properties on the context object may also return null. </param>
         <param name="culture">
@@ -177,7 +189,6 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ComponentModel.PropertyDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>By default, a type does not return any properties. An easy implementation of this method calls the <see cref="Overload:System.ComponentModel.TypeConverter.GetProperties" /> method for the correct data type.</para>
@@ -186,6 +197,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the set of properties for this type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The set of properties that should be exposed for this data type. If no properties should be exposed, this can return null. The default implementation always returns null.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A type descriptor through which additional context can be provided. </param>
         <param name="value">
@@ -208,12 +223,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether this object supports properties. By default, this is false.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if the <see cref="Overload:System.Drawing.ImageConverter.GetProperties" /> method should be called to find the properties of this object.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A type descriptor through which additional context can be provided. </param>
       </Docs>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/ImageFormatConverter.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/ImageFormatConverter.xml
index dfe90bb1a96..c125a78c49a 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/ImageFormatConverter.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/ImageFormatConverter.xml
@@ -60,7 +60,6 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Drawing.ImageFormatConverter" /> converts to and from known image formats, as specified in the <see cref="T:System.Drawing.Imaging.ImageFormat" /> class.</para>
@@ -69,6 +68,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether this converter can convert an object in the specified source type to the native type of the converter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if this object can perform the conversion.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A formatter context. This object can be used to get more information about the environment this converter is being called from. This may be null, so you should always check. Also, properties on the context object may also return null. </param>
         <param name="sourceType">
@@ -90,7 +93,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Drawing.ImageFormatConverter" /> converts to and from known image formats, as specified in the <see cref="T:System.Drawing.Imaging.ImageFormat" /> class.</para>
@@ -99,6 +101,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this converter can convert an object to the specified destination type using the context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if this object can perform the conversion.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that specifies the context for this type conversion. </param>
         <param name="destinationType">
@@ -121,7 +127,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Drawing.ImageFormatConverter" /> converts to and from known image formats, as specified in the <see cref="T:System.Drawing.Imaging.ImageFormat" /> class.</para>
@@ -130,6 +135,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object to an <see cref="T:System.Drawing.Imaging.ImageFormat" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted object.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A formatter context. This object can be used to get more information about the environment this converter is being called from. This may be null, so you should always check. Also, properties on the context object may also return null. </param>
         <param name="culture">
@@ -155,7 +164,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Drawing.ImageFormatConverter" /> converts to and from known image formats, as specified in the <see cref="T:System.Drawing.Imaging.ImageFormat" /> class.</para>
@@ -165,6 +173,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object to the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted object.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A formatter context. This object can be used to get more information about the environment this converter is being called from. This may be null, so you should always check. Also, properties on the context object may also return null. </param>
         <param name="culture">
@@ -189,12 +201,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ComponentModel.TypeConverter+StandardValuesCollection'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection that contains a set of standard values for the data type this validator is designed for. Returns null if the data type does not support a standard set of values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection that contains a standard set of valid values, or null. The default implementation always returns null.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A formatter context. This object can be used to get more information about the environment this converter is being called from. This may be null, so you should always check. Also, properties on the context object may also return null. </param>
       </Docs>
@@ -213,12 +228,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether this object supports a standard set of values that can be picked from a list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if the <see cref="Overload:System.Drawing.ImageFormatConverter.GetStandardValues" /> method should be called to find a common set of values the object supports.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A type descriptor through which additional context can be provided. </param>
       </Docs>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/Pen.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/Pen.xml
index 5d25235d5bc..eccc47c5636 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/Pen.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/Pen.xml
@@ -193,12 +193,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this <see cref="T:System.Drawing.Pen" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that can be cast to a <see cref="T:System.Drawing.Pen" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -594,6 +597,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resets the geometric transformation matrix for this <see cref="T:System.Drawing.Pen" /> to identity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/Point.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/Point.xml
index 69a2e738ff9..7afc63c7126 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/Point.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/Point.xml
@@ -115,7 +115,6 @@
         <Parameter Name="sz" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Drawing.Point.Add(System.Drawing.Point,System.Drawing.Size)" /> adds the <see cref="P:System.Drawing.Size.Width" /> and <see cref="P:System.Drawing.Size.Height" /> of the specified <see cref="T:System.Drawing.Size" /> to the <see cref="P:System.Drawing.Point.X" /> and <see cref="P:System.Drawing.Point.Y" /> values of the specified point.</para>
@@ -124,6 +123,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Drawing.Size" /> to the specified <see cref="T:System.Drawing.Point" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Point" /> that is the result of the addition operation.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Point" /> to add.</param>
         <param name="sz">
@@ -140,12 +143,15 @@
         <Parameter Name="value" Type="System.Drawing.PointF" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Point'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.Drawing.PointF" /> to a <see cref="T:System.Drawing.Point" /> by rounding the values of the <see cref="T:System.Drawing.PointF" /> to the next higher integer values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Point" /> this method converts to.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.PointF" /> to convert. </param>
       </Docs>
@@ -183,12 +189,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Specifies whether this <see cref="T:System.Drawing.Point" /> contains the same coordinates as the specified <see cref="T:System.Object" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is a <see cref="T:System.Drawing.Point" /> and has the same coordinates as this <see cref="T:System.Drawing.Point" />.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to test. </param>
       </Docs>
@@ -205,7 +214,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You should avoid depending on <see cref="M:System.Drawing.Point.GetHashCode" /> for unique values, as two <see cref="T:System.Drawing.Point" /> objects with the same values for their <see cref="P:System.Drawing.Point.X" /> and <see cref="P:System.Drawing.Point.Y" /> properties may return the same hash code. This behavior could change in a future release.</para>
@@ -214,6 +222,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash code for this <see cref="T:System.Drawing.Point" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer value that specifies a hash value for this <see cref="T:System.Drawing.Point" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -285,6 +297,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Translates this <see cref="T:System.Drawing.Point" /> by the specified amount.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="dx">
           <attribution license="cc4" from="Microsoft" modified="false" />The amount to offset the x-coordinate. </param>
         <param name="dy">
@@ -306,12 +322,15 @@
         <Parameter Name="sz" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Translates a <see cref="T:System.Drawing.Point" /> by a given <see cref="T:System.Drawing.Size" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The translated <see cref="T:System.Drawing.Point" />.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Point" /> to translate. </param>
         <param name="sz">
@@ -333,12 +352,15 @@
         <Parameter Name="right" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Drawing.Point" /> objects. The result specifies whether the values of the <see cref="P:System.Drawing.Point.X" /> and <see cref="P:System.Drawing.Point.Y" /> properties of the two <see cref="T:System.Drawing.Point" /> objects are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="P:System.Drawing.Point.X" /> and <see cref="P:System.Drawing.Point.Y" /> values of <paramref name="left" /> and <paramref name="right" /> are equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Point" /> to compare. </param>
         <param name="right">
@@ -400,12 +422,15 @@
         <Parameter Name="right" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Drawing.Point" /> objects. The result specifies whether the values of the <see cref="P:System.Drawing.Point.X" /> or <see cref="P:System.Drawing.Point.Y" /> properties of the two <see cref="T:System.Drawing.Point" /> objects are unequal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the values of either the <see cref="P:System.Drawing.Point.X" /> properties or the <see cref="P:System.Drawing.Point.Y" /> properties of <paramref name="left" /> and <paramref name="right" /> differ; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Point" /> to compare. </param>
         <param name="right">
@@ -427,12 +452,15 @@
         <Parameter Name="sz" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Translates a <see cref="T:System.Drawing.Point" /> by the negative of a given <see cref="T:System.Drawing.Size" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Point" /> structure that is translated by the negative of a given <see cref="T:System.Drawing.Size" /> structure.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Point" /> to translate. </param>
         <param name="sz">
@@ -453,12 +481,15 @@
         <Parameter Name="value" Type="System.Drawing.PointF" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Point'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.Drawing.PointF" /> to a <see cref="T:System.Drawing.Point" /> object by rounding the <see cref="T:System.Drawing.Point" /> values to the nearest integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Point" /> this method converts to.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.PointF" /> to convert. </param>
       </Docs>
@@ -481,7 +512,6 @@
         <Parameter Name="sz" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Drawing.Point.Subtract(System.Drawing.Point,System.Drawing.Size)" /> subtracts the <see cref="P:System.Drawing.Size.Width" /> and <see cref="P:System.Drawing.Size.Height" /> of the specified <see cref="T:System.Drawing.Size" /> from the <see cref="P:System.Drawing.Point.X" /> and <see cref="P:System.Drawing.Point.Y" /> values of the specified point.</para>
@@ -490,6 +520,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the result of subtracting specified <see cref="T:System.Drawing.Size" /> from the specified <see cref="T:System.Drawing.Point" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Point" /> that is the result of the subtraction operation.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Point" /> to be subtracted from. </param>
         <param name="sz">
@@ -504,12 +538,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Drawing.Point" /> to a human-readable string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents this <see cref="T:System.Drawing.Point" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -526,12 +563,15 @@
         <Parameter Name="value" Type="System.Drawing.PointF" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Point'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.Drawing.PointF" /> to a <see cref="T:System.Drawing.Point" /> by truncating the values of the <see cref="T:System.Drawing.Point" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Point" /> this method converts to.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.PointF" /> to convert. </param>
       </Docs>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/PointConverter.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/PointConverter.xml
index d61ce520a6f..76ca921cc80 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/PointConverter.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/PointConverter.xml
@@ -52,12 +52,15 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if this converter can convert an object in the given source type to the native type of the converter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this object can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A formatter context. This object can be used to get additional information about the environment this converter is being called from. This may be null, so you should always check. Also, properties on the context object may also return null. </param>
         <param name="sourceType">
@@ -79,7 +82,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to get additional information about the environment this converter is being called from. This can be null, so you should always check. Also, properties on the context object can also return null.</para>
@@ -88,6 +90,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this converter can convert an object to the given destination type using the context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that provides a format context. </param>
         <param name="destinationType">
@@ -110,12 +116,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object to a <see cref="T:System.Drawing.Point" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted object. </para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A formatter context. This object can be used to get additional information about the environment this converter is being called from. This may be null, so you should always check. Also, properties on the context object may also return null. </param>
         <param name="culture">
@@ -141,7 +150,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The most common types to convert are to and from a string object. The default implementation calls the object's <see cref="M:System.Object.ToString" /> method if the object is valid and if the destination type is string. If this method cannot convert to the destination type, this will throw a <see cref="T:System.NotSupportedException" /> exception.</para>
@@ -150,6 +158,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object to the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted object.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A formatter context. This object can be used to get additional information about the environment this converter is being called from. This may be null, so you should always check. Also, properties on the context object may also return null. </param>
         <param name="culture">
@@ -175,7 +187,6 @@
         <Parameter Name="propertyValues" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -185,6 +196,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of this type given a set of property values for the object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created object, or null if the object could not be created. The default implementation returns null.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A type descriptor through which additional context can be provided. </param>
         <param name="propertyValues">
@@ -205,12 +220,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if changing a value on this object should require a call to <see cref="M:System.Drawing.PointConverter.CreateInstance(System.ComponentModel.ITypeDescriptorContext,System.Collections.IDictionary)" /> to create a new value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="M:System.Drawing.PointConverter.CreateInstance(System.ComponentModel.ITypeDescriptorContext,System.Collections.IDictionary)" /> method should be called when a change is made to one or more properties of this object; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.TypeDescriptor" /> through which additional context can be provided. </param>
       </Docs>
@@ -231,7 +249,6 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ComponentModel.PropertyDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A simple implementation of this method can just call <see cref="Overload:System.ComponentModel.TypeDescriptor.GetProperties" /> for the correct data type.</para>
@@ -240,6 +257,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the set of properties for this type. By default, a type does not return any properties. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The set of properties that are exposed for this data type. If no properties are exposed, this method might return null. The default implementation always returns null.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A type descriptor through which additional context can be provided. </param>
         <param name="value">
@@ -262,12 +283,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if this object supports properties. By default, this is false.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <see cref="M:System.Drawing.PointConverter.GetProperties(System.ComponentModel.ITypeDescriptorContext,System.Object,System.Attribute[])" /> should be called to find the properties of this object; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.TypeDescriptor" /> through which additional context can be provided. </param>
       </Docs>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/PointF.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/PointF.xml
index 81e048ca5bb..e15dfe7a99e 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/PointF.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/PointF.xml
@@ -67,7 +67,6 @@
         <Parameter Name="sz" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Drawing.PointF.Add(System.Drawing.PointF,System.Drawing.SizeF)" /> method adds the <see cref="P:System.Drawing.Size.Width" /> of the specified size to the x-coordinate of the <see cref="T:System.Drawing.PointF" /> and the <see cref="P:System.Drawing.Size.Height" /> to the y-coordinate of the <see cref="T:System.Drawing.PointF" />.</para>
@@ -76,6 +75,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Translates a given <see cref="T:System.Drawing.PointF" /> by the specified <see cref="T:System.Drawing.Size" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The translated <see cref="T:System.Drawing.PointF" />.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.PointF" /> to translate.</param>
         <param name="sz">
@@ -96,7 +99,6 @@
         <Parameter Name="sz" Type="System.Drawing.SizeF" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Drawing.PointF.Add(System.Drawing.PointF,System.Drawing.SizeF)" /> method adds the <see cref="P:System.Drawing.SizeF.Width" /> of the specified size to the x-coordinate of the <see cref="T:System.Drawing.PointF" /> and the <see cref="P:System.Drawing.SizeF.Height" /> to the y-coordinate of the <see cref="T:System.Drawing.PointF" />.</para>
@@ -105,6 +107,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Translates a given <see cref="T:System.Drawing.PointF" /> by a specified <see cref="T:System.Drawing.SizeF" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The translated <see cref="T:System.Drawing.PointF" />.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.PointF" /> to translate.</param>
         <param name="sz">
@@ -140,12 +146,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Specifies whether this <see cref="T:System.Drawing.PointF" /> contains the same coordinates as the specified <see cref="T:System.Object" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if <paramref name="obj" /> is a <see cref="T:System.Drawing.PointF" /> and has the same coordinates as this <see cref="T:System.Drawing.Point" />.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to test. </param>
       </Docs>
@@ -162,12 +171,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash code for this <see cref="T:System.Drawing.PointF" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer value that specifies a hash value for this <see cref="T:System.Drawing.PointF" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -209,12 +221,15 @@
         <Parameter Name="sz" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Translates a <see cref="T:System.Drawing.PointF" /> by a given <see cref="T:System.Drawing.Size" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the translated <see cref="T:System.Drawing.PointF" />.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.PointF" /> to translate. </param>
         <param name="sz">
@@ -239,7 +254,6 @@
         <Parameter Name="sz" Type="System.Drawing.SizeF" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Drawing.PointF.op_Addition(System.Drawing.PointF,System.Drawing.SizeF)" /> operator adds the <see cref="P:System.Drawing.SizeF.Width" /> of the specified size to the x-coordinate of the <see cref="T:System.Drawing.PointF" /> and the <see cref="P:System.Drawing.SizeF.Height" /> to the y-coordinate of the <see cref="T:System.Drawing.PointF" />.</para>
@@ -248,6 +262,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Translates the <see cref="T:System.Drawing.PointF" /> by the specified <see cref="T:System.Drawing.SizeF" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The translated <see cref="T:System.Drawing.PointF" />.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.PointF" /> to translate.</param>
         <param name="sz">
@@ -265,12 +283,15 @@
         <Parameter Name="right" Type="System.Drawing.PointF" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Drawing.PointF" /> structures. The result specifies whether the values of the <see cref="P:System.Drawing.PointF.X" /> and <see cref="P:System.Drawing.PointF.Y" /> properties of the two <see cref="T:System.Drawing.PointF" /> structures are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="P:System.Drawing.PointF.X" /> and <see cref="P:System.Drawing.PointF.Y" /> values of the left and right <see cref="T:System.Drawing.PointF" /> structures are equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.PointF" /> to compare. </param>
         <param name="right">
@@ -292,12 +313,15 @@
         <Parameter Name="right" Type="System.Drawing.PointF" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the coordinates of the specified points are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true to indicate the <see cref="P:System.Drawing.PointF.X" /> and <see cref="P:System.Drawing.PointF.Y" /> values of <paramref name="left" /> and <paramref name="right" /> are not equal; otherwise, false. </para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.PointF" /> to compare.</param>
         <param name="right">
@@ -319,12 +343,15 @@
         <Parameter Name="sz" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Translates a <see cref="T:System.Drawing.PointF" /> by the negative of a given <see cref="T:System.Drawing.Size" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The translated <see cref="T:System.Drawing.PointF" />.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.PointF" /> to translate.</param>
         <param name="sz">
@@ -349,7 +376,6 @@
         <Parameter Name="sz" Type="System.Drawing.SizeF" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Drawing.PointF.op_Subtraction(System.Drawing.PointF,System.Drawing.SizeF)" /> operator subtracts the <see cref="P:System.Drawing.SizeF.Width" /> of the specified size from the x-coordinate of the <see cref="T:System.Drawing.PointF" /> and the <see cref="P:System.Drawing.SizeF.Height" /> from the y-coordinate of the <see cref="T:System.Drawing.PointF" />.</para>
@@ -358,6 +384,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Translates a <see cref="T:System.Drawing.PointF" /> by the negative of a specified <see cref="T:System.Drawing.SizeF" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The translated <see cref="T:System.Drawing.PointF" />.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.PointF" /> to translate.</param>
         <param name="sz">
@@ -378,7 +408,6 @@
         <Parameter Name="sz" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Drawing.PointF.Subtract(System.Drawing.PointF,System.Drawing.Size)" /> method subtracts the <see cref="P:System.Drawing.Size.Width" /> of the specified size from the x-coordinate of the <see cref="T:System.Drawing.PointF" /> and the <see cref="P:System.Drawing.Size.Height" /> from the y-coordinate of the <see cref="T:System.Drawing.PointF" />.</para>
@@ -387,6 +416,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Translates a <see cref="T:System.Drawing.PointF" /> by the negative of a specified size.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The translated <see cref="T:System.Drawing.PointF" />.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.PointF" /> to translate.</param>
         <param name="sz">
@@ -407,7 +440,6 @@
         <Parameter Name="sz" Type="System.Drawing.SizeF" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Drawing.PointF.Subtract(System.Drawing.PointF,System.Drawing.SizeF)" /> method subtracts the <see cref="P:System.Drawing.SizeF.Width" /> of the specified size from the x-coordinate of the <see cref="T:System.Drawing.PointF" /> and the <see cref="P:System.Drawing.SizeF.Height" /> from the y-coordinate of the <see cref="T:System.Drawing.PointF" />.</para>
@@ -416,6 +448,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Translates a <see cref="T:System.Drawing.PointF" /> by the negative of a specified size.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The translated <see cref="T:System.Drawing.PointF" />.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.PointF" /> to translate.</param>
         <param name="sz">
@@ -430,12 +466,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Drawing.PointF" /> to a human readable string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents this <see cref="T:System.Drawing.PointF" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/Rectangle.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/Rectangle.xml
index 5442a256aac..618b5083776 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/Rectangle.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/Rectangle.xml
@@ -126,12 +126,15 @@
         <Parameter Name="value" Type="System.Drawing.RectangleF" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Rectangle'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.Drawing.RectangleF" /> structure to a <see cref="T:System.Drawing.Rectangle" /> structure by rounding the <see cref="T:System.Drawing.RectangleF" /> values to the next higher integer values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a <see cref="T:System.Drawing.Rectangle" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.RectangleF" /> structure to be converted. </param>
       </Docs>
@@ -150,7 +153,6 @@
         <Parameter Name="pt" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The containing rectangle must be normalized for this method to return accurate results.</para>
@@ -159,6 +161,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the specified point is contained within this <see cref="T:System.Drawing.Rectangle" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if the point represented by <paramref name="pt" /> is contained within this <see cref="T:System.Drawing.Rectangle" /> structure; otherwise false.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Point" /> to test. </param>
       </Docs>
@@ -177,7 +183,6 @@
         <Parameter Name="rect" Type="System.Drawing.Rectangle" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The containing rectangle must be normalized for this method to return accurate results.</para>
@@ -186,6 +191,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the rectangular region represented by <paramref name="rect" /> is entirely contained within this <see cref="T:System.Drawing.Rectangle" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if the rectangular region represented by <paramref name="rect" /> is entirely contained within this <see cref="T:System.Drawing.Rectangle" /> structure; otherwise false.</para>
+        </returns>
         <param name="rect">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Rectangle" /> to test. </param>
       </Docs>
@@ -205,7 +214,6 @@
         <Parameter Name="y" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The containing rectangle must be normalized for this method to return accurate results.</para>
@@ -214,6 +222,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the specified point is contained within this <see cref="T:System.Drawing.Rectangle" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if the point defined by <paramref name="x" /> and <paramref name="y" /> is contained within this <see cref="T:System.Drawing.Rectangle" /> structure; otherwise false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate of the point to test. </param>
         <param name="y">
@@ -256,12 +268,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether <paramref name="obj" /> is a <see cref="T:System.Drawing.Rectangle" /> structure with the same location and size of this <see cref="T:System.Drawing.Rectangle" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if <paramref name="obj" /> is a <see cref="T:System.Drawing.Rectangle" /> structure and its <see cref="P:System.Drawing.Rectangle.X" />, <see cref="P:System.Drawing.Rectangle.Y" />, <see cref="P:System.Drawing.Rectangle.Width" />, and <see cref="P:System.Drawing.Rectangle.Height" /> properties are equal to the corresponding properties of this <see cref="T:System.Drawing.Rectangle" /> structure; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to test. </param>
       </Docs>
@@ -283,7 +298,6 @@
         <Parameter Name="bottom" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Rectangle'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates a <see cref="T:System.Drawing.Rectangle" /> with the specified upper-left and lower-right corners.</para>
@@ -292,6 +306,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Drawing.Rectangle" /> structure with the specified edge locations.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Drawing.Rectangle" /> that this method creates.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate of the upper-left corner of this <see cref="T:System.Drawing.Rectangle" /> structure. </param>
         <param name="top">
@@ -314,12 +332,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this <see cref="T:System.Drawing.Rectangle" /> structure. For information about the use of hash codes, see <see cref="M:System.Object.GetHashCode" /> .</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that represents the hash code for this rectangle.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -418,7 +439,6 @@
         <Parameter Name="y" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Rectangle'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method makes a copy of <paramref name="rect" />, enlarges the copy, and then returns the enlarged copy. The rectangle is enlarged in both directions along an axis. For example, if a 50 by 50 rectangle is enlarged by 50 in the x-axis, the resultant rectangle will be 150 units long (the original 50, the 50 in the minus direction, and the 50 in the plus direction) maintaining the rectangle's geometric center.</para>
@@ -427,6 +447,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an enlarged copy of the specified <see cref="T:System.Drawing.Rectangle" /> structure. The copy is enlarged by the specified amount. The original <see cref="T:System.Drawing.Rectangle" /> structure remains unmodified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The enlarged <see cref="T:System.Drawing.Rectangle" />.</para>
+        </returns>
         <param name="rect">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Rectangle" /> with which to start. This rectangle is not modified. </param>
         <param name="x">
@@ -473,12 +497,15 @@
         <Parameter Name="b" Type="System.Drawing.Rectangle" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Rectangle'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a third <see cref="T:System.Drawing.Rectangle" /> structure that represents the intersection of two other <see cref="T:System.Drawing.Rectangle" /> structures. If there is no intersection, an empty <see cref="T:System.Drawing.Rectangle" /> is returned.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> that represents the intersection of <paramref name="a" /> and <paramref name="b" />.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />A rectangle to intersect. </param>
         <param name="b">
@@ -499,12 +526,15 @@
         <Parameter Name="rect" Type="System.Drawing.Rectangle" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if this rectangle intersects with <paramref name="rect" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if there is any intersection, otherwise false.</para>
+        </returns>
         <param name="rect">
           <attribution license="cc4" from="Microsoft" modified="false" />The rectangle to test. </param>
       </Docs>
@@ -650,12 +680,15 @@
         <Parameter Name="right" Type="System.Drawing.Rectangle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether two <see cref="T:System.Drawing.Rectangle" /> structures have equal location and size.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This operator returns true if the two <see cref="T:System.Drawing.Rectangle" /> structures have equal <see cref="P:System.Drawing.Rectangle.X" />, <see cref="P:System.Drawing.Rectangle.Y" />, <see cref="P:System.Drawing.Rectangle.Width" />, and <see cref="P:System.Drawing.Rectangle.Height" /> properties.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Rectangle" /> structure that is to the left of the equality operator. </param>
         <param name="right">
@@ -677,12 +710,15 @@
         <Parameter Name="right" Type="System.Drawing.Rectangle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether two <see cref="T:System.Drawing.Rectangle" /> structures differ in location or size.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This operator returns true if any of the <see cref="P:System.Drawing.Rectangle.X" />, <see cref="P:System.Drawing.Rectangle.Y" />, <see cref="P:System.Drawing.Rectangle.Width" /> or <see cref="P:System.Drawing.Rectangle.Height" /> properties of the two <see cref="T:System.Drawing.Rectangle" /> structures are unequal; otherwise false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Rectangle" /> structure that is to the left of the inequality operator. </param>
         <param name="right">
@@ -730,12 +766,15 @@
         <Parameter Name="value" Type="System.Drawing.RectangleF" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Rectangle'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.Drawing.RectangleF" /> to a <see cref="T:System.Drawing.Rectangle" /> by rounding the <see cref="T:System.Drawing.RectangleF" /> values to the nearest integer values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The rounded interger value of the <see cref="T:System.Drawing.Rectangle" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.RectangleF" /> to be converted. </param>
       </Docs>
@@ -802,12 +841,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the attributes of this <see cref="T:System.Drawing.Rectangle" /> to a human-readable string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the position, width, and height of this <see cref="T:System.Drawing.Rectangle" /> structure ¾ for example, {X=20, Y=20, Width=100, Height=50} </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -824,12 +866,15 @@
         <Parameter Name="value" Type="System.Drawing.RectangleF" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Rectangle'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.Drawing.RectangleF" /> to a <see cref="T:System.Drawing.Rectangle" /> by truncating the <see cref="T:System.Drawing.RectangleF" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The truncated value of the  <see cref="T:System.Drawing.Rectangle" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.RectangleF" /> to be converted. </param>
       </Docs>
@@ -849,7 +894,6 @@
         <Parameter Name="b" Type="System.Drawing.Rectangle" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Rectangle'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When one of the two rectangles is empty, meaning all of its values are zero, the <see cref="M:System.Drawing.Rectangle.Union(System.Drawing.Rectangle,System.Drawing.Rectangle)" /> method returns a rectangle with a starting point of (0, 0), and the height and width of the non-empty rectangle. For example, if you have two rectangles: A = (0, 0; 0, 0) and B = (1, 1; 2, 2), then the union of A and B is (0, 0; 2, 2).</para>
@@ -858,6 +902,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Drawing.Rectangle" /> structure that contains the union of two <see cref="T:System.Drawing.Rectangle" /> structures.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Rectangle" /> structure that bounds the union of the two <see cref="T:System.Drawing.Rectangle" /> structures.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />A rectangle to union. </param>
         <param name="b">
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/RectangleConverter.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/RectangleConverter.xml
index 8214d9c4065..a2415502c68 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/RectangleConverter.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/RectangleConverter.xml
@@ -49,12 +49,15 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if this converter can convert an object in the given source type to the native type of the converter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if this object can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A formatter context. This object can be used to get additional information about the environment this converter is being called from. This may be null, so you should always check. Also, properties on the context object may also return null. </param>
         <param name="sourceType">
@@ -76,7 +79,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to get additional information about the environment this converter is being called from. </para>
@@ -85,6 +87,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this converter can convert an object to the given destination type using the context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that provides a format context. This can be null, so you should always check. Also, properties on the context object can also return null.</param>
         <param name="destinationType">
@@ -107,12 +113,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given object to a <see cref="T:System.Drawing.Rectangle" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted object. </para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to get additional information about the environment this converter is being called from. This may be null, so you should always check. Also, properties on the context object may also return null. </param>
         <param name="culture">
@@ -138,7 +147,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The most common types to convert are to and from a string object. The default implementation calls the object's <see cref="M:System.Object.ToString" /> method if the object is valid and if the destination type is string. If this method cannot convert to the destination type, it throws a <see cref="T:System.NotSupportedException" /> exception.</para>
@@ -147,6 +155,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object to the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted object.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to get additional information about the environment this converter is being called from. This may be null, so you should always check. Also, properties on the context object may also return null. </param>
         <param name="culture">
@@ -172,12 +184,15 @@
         <Parameter Name="propertyValues" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of this type given a set of property values for the object. This is useful for objects that are immutable but still want to provide changeable properties.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created object, or null if the object could not be created. The default implementation returns null.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> through which additional context can be provided. </param>
         <param name="propertyValues">
@@ -198,12 +213,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if changing a value on this object should require a call to <see cref="M:System.Drawing.RectangleConverter.CreateInstance(System.ComponentModel.ITypeDescriptorContext,System.Collections.IDictionary)" /> to create a new value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if <see cref="M:System.Drawing.RectangleConverter.CreateInstance(System.ComponentModel.ITypeDescriptorContext,System.Collections.IDictionary)" /> should be called when a change is made to one or more properties of this object; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A type descriptor through which additional context can be provided. </param>
       </Docs>
@@ -224,7 +242,6 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ComponentModel.PropertyDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A simple implementation of this method can just call the <see cref="Overload:System.ComponentModel.TypeDescriptor.GetProperties" /> method for the correct data type.</para>
@@ -233,6 +250,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the set of properties for this type. By default, a type does not return any properties. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The set of properties that should be exposed for this data type. If no properties should be exposed, this may return null. The default implementation always returns null.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> through which additional context can be provided. </param>
         <param name="value">
@@ -255,12 +276,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if this object supports properties. By default, this is false.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if <see cref="M:System.Drawing.RectangleConverter.GetProperties(System.ComponentModel.ITypeDescriptorContext,System.Object,System.Attribute[])" /> should be called to find the properties of this object; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> through which additional context can be provided. </param>
       </Docs>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/RectangleF.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/RectangleF.xml
index f64243debc1..646cfa62c98 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/RectangleF.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/RectangleF.xml
@@ -115,12 +115,15 @@
         <Parameter Name="pt" Type="System.Drawing.PointF" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the specified point is contained within this <see cref="T:System.Drawing.RectangleF" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if the point represented by the <paramref name="pt" /> parameter is contained within this <see cref="T:System.Drawing.RectangleF" /> structure; otherwise false.</para>
+        </returns>
         <param name="pt">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.PointF" /> to test. </param>
       </Docs>
@@ -139,12 +142,15 @@
         <Parameter Name="rect" Type="System.Drawing.RectangleF" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the rectangular region represented by <paramref name="rect" /> is entirely contained within this <see cref="T:System.Drawing.RectangleF" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if the rectangular region represented by <paramref name="rect" /> is entirely contained within the rectangular region represented by this <see cref="T:System.Drawing.RectangleF" />; otherwise false.</para>
+        </returns>
         <param name="rect">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.RectangleF" /> to test. </param>
       </Docs>
@@ -164,12 +170,15 @@
         <Parameter Name="y" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the specified point is contained within this <see cref="T:System.Drawing.RectangleF" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if the point defined by <paramref name="x" /> and <paramref name="y" /> is contained within this <see cref="T:System.Drawing.RectangleF" /> structure; otherwise false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate of the point to test. </param>
         <param name="y">
@@ -212,12 +221,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether <paramref name="obj" /> is a <see cref="T:System.Drawing.RectangleF" /> with the same location and size of this <see cref="T:System.Drawing.RectangleF" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if <paramref name="obj" /> is a <see cref="T:System.Drawing.RectangleF" /> and its X, Y, Width, and Height properties are equal to the corresponding properties of this <see cref="T:System.Drawing.RectangleF" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to test. </param>
       </Docs>
@@ -239,7 +251,6 @@
         <Parameter Name="bottom" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'RectangleF'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates a <see cref="T:System.Drawing.RectangleF" /> with the specified upper-left and lower-right corners.</para>
@@ -248,6 +259,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Drawing.RectangleF" /> structure with upper-left corner and lower-right corner at the specified locations.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Drawing.RectangleF" /> that this method creates.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate of the upper-left corner of the rectangular region. </param>
         <param name="top">
@@ -270,12 +285,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash code for this <see cref="T:System.Drawing.RectangleF" /> structure. For information about the use of hash codes, see Object.GetHashCode.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for this <see cref="T:System.Drawing.RectangleF" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -371,7 +389,6 @@
         <Parameter Name="y" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'RectangleF'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method makes a copy of <paramref name="rect" />, enlarges the copy, and then returns the enlarged copy. The rectangle is enlarged in both directions along an axis. For example, if a 50 by 50 rectangle is inflated by 50 in the x-axis, the resultant rectangle will be 150 units long (the original 50, the 50 in the minus direction, and the 50 in the plus direction) maintaining the rectangle's geometric center.</para>
@@ -380,6 +397,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an enlarged copy of the specified <see cref="T:System.Drawing.RectangleF" /> structure. The copy is enlarged by the specified amount and the original rectangle remains unmodified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The enlarged <see cref="T:System.Drawing.RectangleF" />.</para>
+        </returns>
         <param name="rect">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.RectangleF" /> to be copied. This rectangle is not modified. </param>
         <param name="x">
@@ -407,6 +428,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Replaces this <see cref="T:System.Drawing.RectangleF" /> structure with the intersection of itself and the specified <see cref="T:System.Drawing.RectangleF" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="rect">
           <attribution license="cc4" from="Microsoft" modified="false" />The rectangle to intersect. </param>
       </Docs>
@@ -426,12 +451,15 @@
         <Parameter Name="b" Type="System.Drawing.RectangleF" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'RectangleF'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Drawing.RectangleF" /> structure that represents the intersection of two rectangles. If there is no intersection, and empty <see cref="T:System.Drawing.RectangleF" /> is returned.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A third <see cref="T:System.Drawing.RectangleF" /> structure the size of which represents the overlapped area of the two specified rectangles.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />A rectangle to intersect. </param>
         <param name="b">
@@ -452,12 +480,15 @@
         <Parameter Name="rect" Type="System.Drawing.RectangleF" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if this rectangle intersects with <paramref name="rect" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if there is any intersection.</para>
+        </returns>
         <param name="rect">
           <attribution license="cc4" from="Microsoft" modified="false" />The rectangle to test. </param>
       </Docs>
@@ -555,6 +586,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adjusts the location of this rectangle by the specified amount.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="pos">
           <attribution license="cc4" from="Microsoft" modified="false" />The amount to offset the location. </param>
       </Docs>
@@ -579,6 +614,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adjusts the location of this rectangle by the specified amount.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The amount to offset the location horizontally. </param>
         <param name="y">
@@ -600,12 +639,15 @@
         <Parameter Name="right" Type="System.Drawing.RectangleF" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether two <see cref="T:System.Drawing.RectangleF" /> structures have equal location and size.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This operator returns true if the two specified <see cref="T:System.Drawing.RectangleF" /> structures have equal <see cref="P:System.Drawing.RectangleF.X" />, <see cref="P:System.Drawing.RectangleF.Y" />, <see cref="P:System.Drawing.RectangleF.Width" />, and <see cref="P:System.Drawing.RectangleF.Height" /> properties.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.RectangleF" /> structure that is to the left of the equality operator. </param>
         <param name="right">
@@ -647,12 +689,15 @@
         <Parameter Name="right" Type="System.Drawing.RectangleF" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether two <see cref="T:System.Drawing.RectangleF" /> structures differ in location or size.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This operator returns true if any of the <see cref="P:System.Drawing.RectangleF.X" /> , <see cref="P:System.Drawing.RectangleF.Y" />, <see cref="P:System.Drawing.RectangleF.Width" />, or <see cref="P:System.Drawing.RectangleF.Height" /> properties of the two <see cref="T:System.Drawing.Rectangle" /> structures are unequal; otherwise false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.RectangleF" /> structure that is to the left of the inequality operator. </param>
         <param name="right">
@@ -748,12 +793,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the Location and <see cref="T:System.Drawing.Size" /> of this <see cref="T:System.Drawing.RectangleF" /> to a human-readable string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the position, width, and height of this <see cref="T:System.Drawing.RectangleF" /> structure. For example, "{X=20, Y=20, Width=100, Height=50}".</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -771,7 +819,6 @@
         <Parameter Name="b" Type="System.Drawing.RectangleF" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'RectangleF'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When one of the two rectangles is empty, meaning all of its values are zero, the <see cref="M:System.Drawing.Rectangle.Union(System.Drawing.Rectangle,System.Drawing.Rectangle)" /> method returns a rectangle with a starting point of (0, 0), and the height and width of the non-empty rectangle. For example, if you have two rectangles A = (0, 0; 0, 0) and B = (1, 1; 2, 2), then the union of A and B is (0, 0; 2, 2).</para>
@@ -780,6 +827,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the smallest possible third rectangle that can contain both of two rectangles that form a union.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A third <see cref="T:System.Drawing.RectangleF" /> structure that contains both of the two rectangles that form the union.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />A rectangle to union. </param>
         <param name="b">
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/Region.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/Region.xml
index 0887b75048c..97af9a396ea 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/Region.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/Region.xml
@@ -154,12 +154,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Region'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this <see cref="T:System.Drawing.Region" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Region" /> that this method creates.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -278,6 +281,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Releases all resources used by this <see cref="T:System.Drawing.Region" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -295,7 +302,6 @@
         <Parameter Name="g" Type="System.Drawing.Graphics" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current transformation of the graphics context <paramref name="g" /> is used to compute the region interiors on the drawing surface.</para>
@@ -304,6 +310,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether the specified <see cref="T:System.Drawing.Region" /> is identical to this <see cref="T:System.Drawing.Region" /> on the specified drawing surface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the interior of region is identical to the interior of this region when the transformation associated with the <paramref name="g" /> parameter is applied; otherwise, false.</para>
+        </returns>
         <param name="region">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Region" /> to test. </param>
         <param name="g">
@@ -432,7 +442,6 @@
         <Parameter Name="hrgn" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Region'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates a new <see cref="T:System.Drawing.Region" /> with an interior defined by the existing <see cref="T:System.Drawing.Region" /> referred to by the handle in the <paramref name="hrgn" /> parameter.</para>
@@ -441,6 +450,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new <see cref="T:System.Drawing.Region" /> from a handle to the specified existing ndptecgdi region.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Drawing.Region" />.</para>
+        </returns>
         <param name="hrgn">
           <attribution license="cc4" from="Microsoft" modified="false" />A handle to an existing <see cref="T:System.Drawing.Region" />. </param>
       </Docs>
@@ -459,7 +472,6 @@
         <Parameter Name="g" Type="System.Drawing.Graphics" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'RectangleF'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current transformation of the graphics context is used to compute the region interior on the drawing surface. The bounding rectangle is not always the smallest possible bounding rectangle depending on the current transformation.</para>
@@ -468,6 +480,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Drawing.RectangleF" /> structure that represents a rectangle that bounds this <see cref="T:System.Drawing.Region" /> on the drawing surface of a <see cref="T:System.Drawing.Graphics" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.RectangleF" /> structure that represents the bounding rectangle for this <see cref="T:System.Drawing.Region" /> on the specified drawing surface.</para>
+        </returns>
         <param name="g">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Graphics" /> on which this <see cref="T:System.Drawing.Region" /> is drawn. </param>
       </Docs>
@@ -486,12 +502,15 @@
         <Parameter Name="g" Type="System.Drawing.Graphics" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Windows handle to this <see cref="T:System.Drawing.Region" /> in the specified graphics context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Windows handle to this <see cref="T:System.Drawing.Region" />.</para>
+        </returns>
         <param name="g">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Graphics" /> on which this <see cref="T:System.Drawing.Region" /> is drawn. </param>
       </Docs>
@@ -508,7 +527,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Drawing2D.RegionData'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Drawing.Region" /> class allows you to define a custom shape. The shape can be made up of lines, polygons, and curves. <see cref="M:System.Drawing.Region.GetRegionData" /> describes the  shape contained in this <see cref="T:System.Drawing.Region" />. </para>
@@ -517,6 +535,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Drawing.Drawing2D.RegionData" /> that represents the information that describes this <see cref="T:System.Drawing.Region" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Drawing2D.RegionData" /> that represents the information that describes this <see cref="T:System.Drawing.Region" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -533,12 +555,15 @@
         <Parameter Name="matrix" Type="System.Drawing.Drawing2D.Matrix" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'RectangleF []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of <see cref="T:System.Drawing.RectangleF" /> structures that approximate this <see cref="T:System.Drawing.Region" /> after the specified matrix transformation is applied.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Drawing.RectangleF" /> structures that approximate this <see cref="T:System.Drawing.Region" /> after the specified matrix transformation is applied.</para>
+        </returns>
         <param name="matrix">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Drawing2D.Matrix" /> that represents a geometric transformation to apply to the region. </param>
       </Docs>
@@ -585,6 +610,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Updates this <see cref="T:System.Drawing.Region" /> to the intersection of itself with the specified <see cref="T:System.Drawing.Rectangle" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="rect">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Rectangle" /> structure to intersect with this <see cref="T:System.Drawing.Region" />. </param>
       </Docs>
@@ -631,6 +660,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Updates this <see cref="T:System.Drawing.Region" /> to the intersection of itself with the specified <see cref="T:System.Drawing.Region" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="region">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Region" /> to intersect with this <see cref="T:System.Drawing.Region" />. </param>
       </Docs>
@@ -649,7 +682,6 @@
         <Parameter Name="g" Type="System.Drawing.Graphics" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current transformation of the graphics context <paramref name="g" /> is used to compute the region interior on the drawing surface.</para>
@@ -658,6 +690,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether this <see cref="T:System.Drawing.Region" /> has an empty interior on the specified drawing surface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the interior of this <see cref="T:System.Drawing.Region" /> is empty when the transformation associated with <paramref name="g" /> is applied; otherwise, false.</para>
+        </returns>
         <param name="g">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Graphics" /> that represents a drawing surface. </param>
       </Docs>
@@ -676,7 +712,6 @@
         <Parameter Name="g" Type="System.Drawing.Graphics" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current transformation of the graphics context <paramref name="g" /> is used to compute the region interior on the drawing surface.</para>
@@ -685,6 +720,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether this <see cref="T:System.Drawing.Region" /> has an infinite interior on the specified drawing surface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the interior of this <see cref="T:System.Drawing.Region" /> is infinite when the transformation associated with <paramref name="g" /> is applied; otherwise, false.</para>
+        </returns>
         <param name="g">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Drawing.Graphics" /> that represents a drawing surface. </param>
       </Docs>
@@ -703,12 +742,15 @@
         <Parameter Name="point" Type="System.Drawing.Point" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether the specified <see cref="T:System.Drawing.Point" /> structure is contained within this <see cref="T:System.Drawing.Region" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true when <paramref name="point" /> is contained within this <see cref="T:System.Drawing.Region" />; otherwise, false.</para>
+        </returns>
         <param name="point">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Point" /> structure to test. </param>
       </Docs>
@@ -727,12 +769,15 @@
         <Parameter Name="point" Type="System.Drawing.PointF" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether the specified <see cref="T:System.Drawing.PointF" /> structure is contained within this <see cref="T:System.Drawing.Region" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true when <paramref name="point" /> is contained within this <see cref="T:System.Drawing.Region" />; otherwise, false.</para>
+        </returns>
         <param name="point">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.PointF" /> structure to test. </param>
       </Docs>
@@ -751,12 +796,15 @@
         <Parameter Name="rect" Type="System.Drawing.Rectangle" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether any portion of the specified <see cref="T:System.Drawing.Rectangle" /> structure is contained within this <see cref="T:System.Drawing.Region" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true when any portion of <paramref name="rect" /> is contained within this <see cref="T:System.Drawing.Region" />; otherwise, false.</para>
+        </returns>
         <param name="rect">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Rectangle" /> structure to test. </param>
       </Docs>
@@ -775,12 +823,15 @@
         <Parameter Name="rect" Type="System.Drawing.RectangleF" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether any portion of the specified <see cref="T:System.Drawing.RectangleF" /> structure is contained within this <see cref="T:System.Drawing.Region" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true when any portion of <paramref name="rect" /> is contained within this <see cref="T:System.Drawing.Region" />; otherwise, false.</para>
+        </returns>
         <param name="rect">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.RectangleF" /> structure to test. </param>
       </Docs>
@@ -800,7 +851,6 @@
         <Parameter Name="g" Type="System.Drawing.Graphics" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current transformation of the graphics context is used to compute the region interior and the point coordinates on the drawing surface.</para>
@@ -809,6 +859,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether the specified <see cref="T:System.Drawing.Point" /> structure is contained within this <see cref="T:System.Drawing.Region" /> when drawn using the specified <see cref="T:System.Drawing.Graphics" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true when <paramref name="point" /> is contained within this <see cref="T:System.Drawing.Region" />; otherwise, false.</para>
+        </returns>
         <param name="point">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Point" /> structure to test. </param>
         <param name="g">
@@ -830,7 +884,6 @@
         <Parameter Name="g" Type="System.Drawing.Graphics" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current transformation of the graphics context is used to compute the region interior and the point coordinates on the drawing surface.</para>
@@ -839,6 +892,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether the specified <see cref="T:System.Drawing.PointF" /> structure is contained within this <see cref="T:System.Drawing.Region" /> when drawn using the specified <see cref="T:System.Drawing.Graphics" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true when <paramref name="point" /> is contained within this <see cref="T:System.Drawing.Region" />; otherwise, false.</para>
+        </returns>
         <param name="point">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.PointF" /> structure to test. </param>
         <param name="g">
@@ -860,7 +917,6 @@
         <Parameter Name="g" Type="System.Drawing.Graphics" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current transformation of the graphics context is used to compute the region interior and the rectangle coordinates on the drawing surface.</para>
@@ -869,6 +925,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether any portion of the specified <see cref="T:System.Drawing.Rectangle" /> structure is contained within this <see cref="T:System.Drawing.Region" /> when drawn using the specified <see cref="T:System.Drawing.Graphics" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true when any portion of the <paramref name="rect" /> is contained within this <see cref="T:System.Drawing.Region" />; otherwise, false.</para>
+        </returns>
         <param name="rect">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Rectangle" /> structure to test. </param>
         <param name="g">
@@ -890,7 +950,6 @@
         <Parameter Name="g" Type="System.Drawing.Graphics" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current transformation of the graphics context is used to compute the region interior and the rectangle coordinates on the drawing surface.</para>
@@ -899,6 +958,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether any portion of the specified <see cref="T:System.Drawing.RectangleF" /> structure is contained within this <see cref="T:System.Drawing.Region" /> when drawn using the specified <see cref="T:System.Drawing.Graphics" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true when <paramref name="rect" /> is contained within this <see cref="T:System.Drawing.Region" />; otherwise, false.</para>
+        </returns>
         <param name="rect">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.RectangleF" /> structure to test. </param>
         <param name="g">
@@ -920,12 +983,15 @@
         <Parameter Name="y" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether the specified point is contained within this <see cref="T:System.Drawing.Region" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true when the specified point is contained within this <see cref="T:System.Drawing.Region" />; otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate of the point to test. </param>
         <param name="y">
@@ -948,7 +1014,6 @@
         <Parameter Name="g" Type="System.Drawing.Graphics" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current transformation of the graphics context is used to compute the region interior and the point coordinates on the drawing surface.</para>
@@ -957,6 +1022,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether the specified point is contained within this <see cref="T:System.Drawing.Region" /> object when drawn using the specified <see cref="T:System.Drawing.Graphics" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true when the specified point is contained within this <see cref="T:System.Drawing.Region" />; otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate of the point to test. </param>
         <param name="y">
@@ -981,7 +1050,6 @@
         <Parameter Name="g" Type="System.Drawing.Graphics" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current transformation of the graphics context is used to compute the region interior and the point coordinates on the drawing surface.</para>
@@ -990,6 +1058,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether the specified point is contained within this <see cref="T:System.Drawing.Region" /> when drawn using the specified <see cref="T:System.Drawing.Graphics" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true when the specified point is contained within this <see cref="T:System.Drawing.Region" />; otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate of the point to test. </param>
         <param name="y">
@@ -1015,12 +1087,15 @@
         <Parameter Name="height" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether any portion of the specified rectangle is contained within this <see cref="T:System.Drawing.Region" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true when any portion of the specified rectangle is contained within this <see cref="T:System.Drawing.Region" />; otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate of the upper-left corner of the rectangle to test. </param>
         <param name="y">
@@ -1048,12 +1123,15 @@
         <Parameter Name="height" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether any portion of the specified rectangle is contained within this <see cref="T:System.Drawing.Region" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true when any portion of the specified rectangle is contained within this <see cref="T:System.Drawing.Region" /> object; otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate of the upper-left corner of the rectangle to test. </param>
         <param name="y">
@@ -1082,7 +1160,6 @@
         <Parameter Name="g" Type="System.Drawing.Graphics" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current transformation of the graphics context is used to compute the region interior and the rectangle coordinates on the drawing surface.</para>
@@ -1091,6 +1168,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether any portion of the specified rectangle is contained within this <see cref="T:System.Drawing.Region" /> when drawn using the specified <see cref="T:System.Drawing.Graphics" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true when any portion of the specified rectangle is contained within this <see cref="T:System.Drawing.Region" />; otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate of the upper-left corner of the rectangle to test. </param>
         <param name="y">
@@ -1121,7 +1202,6 @@
         <Parameter Name="g" Type="System.Drawing.Graphics" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current transformation of the graphics context is used to compute the region interior and the rectangle coordinates on the drawing surface.</para>
@@ -1130,6 +1210,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether any portion of the specified rectangle is contained within this <see cref="T:System.Drawing.Region" /> when drawn using the specified <see cref="T:System.Drawing.Graphics" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true when any portion of the specified rectangle is contained within this <see cref="T:System.Drawing.Region" />; otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The x-coordinate of the upper-left corner of the rectangle to test. </param>
         <param name="y">
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/Size.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/Size.xml
index b6350bf99b2..d73c3e925c4 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/Size.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/Size.xml
@@ -91,12 +91,15 @@
         <Parameter Name="sz2" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the width and height of one <see cref="T:System.Drawing.Size" /> structure to the width and height of another <see cref="T:System.Drawing.Size" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Size" /> structure that is the result of the addition operation.</para>
+        </returns>
         <param name="sz1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Drawing.Size" /> structure to add.</param>
         <param name="sz2">
@@ -113,12 +116,15 @@
         <Parameter Name="value" Type="System.Drawing.SizeF" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Size'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.Drawing.SizeF" /> structure to a <see cref="T:System.Drawing.Size" /> structure by rounding the values of the <see cref="T:System.Drawing.Size" /> structure to the next higher integer values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Size" /> structure this method converts to.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.SizeF" /> structure to convert. </param>
       </Docs>
@@ -156,12 +162,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests to see whether the specified object is a <see cref="T:System.Drawing.Size" /> structure with the same dimensions as this <see cref="T:System.Drawing.Size" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is a <see cref="T:System.Drawing.Size" /> and has the same width and height as this <see cref="T:System.Drawing.Size" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to test. </param>
       </Docs>
@@ -178,7 +187,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You should avoid depending on <see cref="M:System.Drawing.Size.GetHashCode" /> for unique values, as two <see cref="T:System.Drawing.Size" /> objects with the same values for their <see cref="P:System.Drawing.Size.Width" /> and <see cref="P:System.Drawing.Size.Height" /> properties may return the same hash code. This behavior could change in a future release.</para>
@@ -187,6 +195,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash code for this <see cref="T:System.Drawing.Size" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer value that specifies a hash value for this <see cref="T:System.Drawing.Size" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -252,12 +264,15 @@
         <Parameter Name="sz2" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the width and height of one <see cref="T:System.Drawing.Size" /> structure to the width and height of another <see cref="T:System.Drawing.Size" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Size" /> structure that is the result of the addition operation.</para>
+        </returns>
         <param name="sz1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Drawing.Size" /> to add. </param>
         <param name="sz2">
@@ -279,12 +294,15 @@
         <Parameter Name="sz2" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether two <see cref="T:System.Drawing.Size" /> structures are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="sz1" /> and <paramref name="sz2" /> have equal width and height; otherwise, false.</para>
+        </returns>
         <param name="sz1">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Size" /> structure on the left side of the equality operator. </param>
         <param name="sz2">
@@ -346,12 +364,15 @@
         <Parameter Name="sz2" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether two <see cref="T:System.Drawing.Size" /> structures are different.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="sz1" /> and <paramref name="sz2" /> differ either in width or height; false if <paramref name="sz1" /> and <paramref name="sz2" /> are equal.</para>
+        </returns>
         <param name="sz1">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Size" /> structure on the left of the inequality operator. </param>
         <param name="sz2">
@@ -373,12 +394,15 @@
         <Parameter Name="sz2" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts the width and height of one <see cref="T:System.Drawing.Size" /> structure from the width and height of another <see cref="T:System.Drawing.Size" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Size" /> structure that is the result of the subtraction operation.</para>
+        </returns>
         <param name="sz1">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Size" /> structure on the left side of the subtraction operator. </param>
         <param name="sz2">
@@ -399,12 +423,15 @@
         <Parameter Name="value" Type="System.Drawing.SizeF" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Size'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.Drawing.SizeF" /> structure to a <see cref="T:System.Drawing.Size" /> structure by rounding the values of the <see cref="T:System.Drawing.SizeF" /> structure to the nearest integer values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Size" /> structure this method converts to.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.SizeF" /> structure to convert. </param>
       </Docs>
@@ -427,12 +454,15 @@
         <Parameter Name="sz2" Type="System.Drawing.Size" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts the width and height of one <see cref="T:System.Drawing.Size" /> structure from the width and height of another <see cref="T:System.Drawing.Size" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Size" /> structure that is a result of the subtraction operation.</para>
+        </returns>
         <param name="sz1">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Size" /> structure on the left side of the subtraction operator. </param>
         <param name="sz2">
@@ -447,12 +477,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a human-readable string that represents this <see cref="T:System.Drawing.Size" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents this <see cref="T:System.Drawing.Size" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -469,12 +502,15 @@
         <Parameter Name="value" Type="System.Drawing.SizeF" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Size'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.Drawing.SizeF" /> structure to a <see cref="T:System.Drawing.Size" /> structure by truncating the values of the <see cref="T:System.Drawing.SizeF" /> structure to the next lower integer values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Size" /> structure this method converts to.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.SizeF" /> structure to convert. </param>
       </Docs>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/SizeConverter.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/SizeConverter.xml
index 92250a9efb5..ee86feb48cb 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/SizeConverter.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/SizeConverter.xml
@@ -49,12 +49,15 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether this converter can convert an object in the specified source type to the native type of the converter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if this object can perform the conversion.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to get additional information about the environment this converter is being called from. This may be null, so you should always check. Also, properties on the context object may also return null. </param>
         <param name="sourceType">
@@ -76,7 +79,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. </para>
@@ -85,6 +87,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this converter can convert an object to the given destination type using the context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to get additional information about the environment this converter is being called from. This can be null, so always check. Also, properties on the context object can return null.</param>
         <param name="destinationType">
@@ -107,12 +113,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object to the converter's native type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted object. </para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to get additional information about the environment this converter is being called from. This may be null, so you should always check. Also, properties on the context object may also return null. </param>
         <param name="culture">
@@ -138,7 +147,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The most common type conversion is to and from a string type. The default implementation calls the <see cref="M:System.Object.ToString" /> method of the object if the object is valid and if the destination type is string. If this method cannot convert the specified object to the destination type, it passes a <see cref="T:System.NotSupportedException" /> exception.</para>
@@ -147,6 +155,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object to the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted object.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that can be used to get additional information about the environment this converter is being called from. This may be null, so you should always check. Also, properties on the context object may also return null. </param>
         <param name="culture">
@@ -172,12 +184,15 @@
         <Parameter Name="propertyValues" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an object of this type by using a specified set of property values for the object. This is useful for creating non-changeable objects that have changeable properties.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created object, or null if the object could not be created. The default implementation returns null.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.TypeDescriptor" /> through which additional context can be provided. </param>
         <param name="propertyValues">
@@ -198,12 +213,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether changing a value on this object should require a call to the <see cref="M:System.Drawing.SizeConverter.CreateInstance(System.ComponentModel.ITypeDescriptorContext,System.Collections.IDictionary)" /> method to create a new value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="M:System.Drawing.SizeConverter.CreateInstance(System.ComponentModel.ITypeDescriptorContext,System.Collections.IDictionary)" /> object should be called when a change is made to one or more properties of this object.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.TypeDescriptor" /> through which additional context can be provided. </param>
       </Docs>
@@ -224,7 +242,6 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ComponentModel.PropertyDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An easy implementation of this method can call the <see cref="Overload:System.ComponentModel.TypeConverter.GetProperties" /> method for the correct data type.</para>
@@ -233,6 +250,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the set of properties for this type. By default, a type does not have any properties to return. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The set of properties that should be exposed for this data type. If no properties should be exposed, this may return null. The default implementation always returns null.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.TypeDescriptor" /> through which additional context can be provided. </param>
         <param name="value">
@@ -255,12 +276,15 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether this object supports properties. By default, this is false.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="M:System.Drawing.SizeConverter.GetProperties(System.ComponentModel.ITypeDescriptorContext,System.Object,System.Attribute[])" /> method should be called to find the properties of this object.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.TypeDescriptor" /> through which additional context can be provided. </param>
       </Docs>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/SizeF.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/SizeF.xml
index 6534c2c4eab..3b4d7f47af6 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/SizeF.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/SizeF.xml
@@ -112,12 +112,15 @@
         <Parameter Name="sz2" Type="System.Drawing.SizeF" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the width and height of one <see cref="T:System.Drawing.SizeF" /> structure to the width and height of another <see cref="T:System.Drawing.SizeF" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.SizeF" /> structure that is the result of the addition operation.</para>
+        </returns>
         <param name="sz1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Drawing.SizeF" /> structure to add.</param>
         <param name="sz2">
@@ -153,12 +156,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests to see whether the specified object is a <see cref="T:System.Drawing.SizeF" /> structure with the same dimensions as this <see cref="T:System.Drawing.SizeF" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if <paramref name="obj" /> is a <see cref="T:System.Drawing.SizeF" /> and has the same width and height as this <see cref="T:System.Drawing.SizeF" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to test. </param>
       </Docs>
@@ -175,12 +181,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash code for this <see cref="T:System.Drawing.Size" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer value that specifies a hash value for this <see cref="T:System.Drawing.Size" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -246,12 +255,15 @@
         <Parameter Name="sz2" Type="System.Drawing.SizeF" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the width and height of one <see cref="T:System.Drawing.SizeF" /> structure to the width and height of another <see cref="T:System.Drawing.SizeF" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Size" /> structure that is the result of the addition operation.</para>
+        </returns>
         <param name="sz1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Drawing.SizeF" /> structure to add. </param>
         <param name="sz2">
@@ -273,12 +285,15 @@
         <Parameter Name="sz2" Type="System.Drawing.SizeF" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether two <see cref="T:System.Drawing.SizeF" /> structures are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This operator returns true if <paramref name="sz1" /> and <paramref name="sz2" /> have equal width and height; otherwise, false.</para>
+        </returns>
         <param name="sz1">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.SizeF" /> structure on the left side of the equality operator. </param>
         <param name="sz2">
@@ -320,12 +335,15 @@
         <Parameter Name="sz2" Type="System.Drawing.SizeF" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether two <see cref="T:System.Drawing.SizeF" /> structures are different.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This operator returns true if <paramref name="sz1" /> and <paramref name="sz2" /> differ either in width or height; false if <paramref name="sz1" /> and <paramref name="sz2" /> are equal.</para>
+        </returns>
         <param name="sz1">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.SizeF" /> structure on the left of the inequality operator. </param>
         <param name="sz2">
@@ -347,12 +365,15 @@
         <Parameter Name="sz2" Type="System.Drawing.SizeF" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts the width and height of one <see cref="T:System.Drawing.SizeF" /> structure from the width and height of another <see cref="T:System.Drawing.SizeF" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.SizeF" /> that is the result of the subtraction operation.</para>
+        </returns>
         <param name="sz1">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.SizeF" /> structure on the left side of the subtraction operator. </param>
         <param name="sz2">
@@ -377,12 +398,15 @@
         <Parameter Name="sz2" Type="System.Drawing.SizeF" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts the width and height of one <see cref="T:System.Drawing.SizeF" /> structure from the width and height of another <see cref="T:System.Drawing.SizeF" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.SizeF" /> structure that is a result of the subtraction operation.</para>
+        </returns>
         <param name="sz1">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.SizeF" /> structure on the left side of the subtraction operator. </param>
         <param name="sz2">
@@ -397,12 +421,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'PointF'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a <see cref="T:System.Drawing.SizeF" /> structure to a <see cref="T:System.Drawing.PointF" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a <see cref="T:System.Drawing.PointF" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -417,7 +444,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Size'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Drawing.SizeF" /> structure is converted to a <see cref="T:System.Drawing.Size" /> structure by truncating the values of the <see cref="T:System.Drawing.SizeF" /> to the next lower integer values.</para>
@@ -426,6 +452,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a <see cref="T:System.Drawing.SizeF" /> structure to a <see cref="T:System.Drawing.Size" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a <see cref="T:System.Drawing.Size" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -440,12 +470,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a human-readable string that represents this <see cref="T:System.Drawing.SizeF" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents this <see cref="T:System.Drawing.SizeF" /> structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/SizeFConverter.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/SizeFConverter.xml
index 0d99d38eabe..410500ca56c 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/SizeFConverter.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/SizeFConverter.xml
@@ -48,7 +48,6 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -58,6 +57,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the converter can convert from the type specified to the <see cref="T:System.Drawing.SizeF" /> type, using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true to indicate the conversion can be performed; otherwise, false. </para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> through which additional context can be supplied.</param>
         <param name="sourceType">
@@ -78,13 +81,16 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the <see cref="T:System.Drawing.SizeFConverter" /> can convert a <see cref="T:System.Drawing.SizeF" /> to the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> through which additional context can be supplied.</param>
         <param name="destinationType">
@@ -155,13 +161,16 @@
         <Parameter Name="propertyValues" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of a <see cref="T:System.Drawing.SizeF" /> with the specified property values using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> representing the new <see cref="T:System.Drawing.SizeF" />, or null if the object cannot be created.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> through which additional context can be supplied.</param>
         <param name="propertyValues">
@@ -181,13 +190,16 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether changing a value on this object requires a call to the <see cref="Overload:System.Drawing.SizeFConverter.CreateInstance" /> method to create a new value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always returns true.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. This may be null.</param>
       </Docs>
@@ -207,7 +219,6 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -217,6 +228,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a set of properties for the <see cref="T:System.Drawing.SizeF" /> type using the specified context and attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> containing the properties.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> through which additional context can be supplied.</param>
         <param name="value">
@@ -238,13 +253,16 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the <see cref="T:System.Drawing.SizeF" /> type supports properties.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always returns true.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> through which additional context can be supplied.</param>
       </Docs>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/SolidBrush.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/SolidBrush.xml
index 6cf6955f106..981c9e42c37 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/SolidBrush.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/SolidBrush.xml
@@ -54,12 +54,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this <see cref="T:System.Drawing.SolidBrush" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.SolidBrush" /> object that this method creates.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/StringFormat.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/StringFormat.xml
index 2803bcb5691..bc7c2f20c8c 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/StringFormat.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/StringFormat.xml
@@ -181,12 +181,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this <see cref="T:System.Drawing.StringFormat" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.StringFormat" /> object this method creates.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -247,6 +250,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Releases all resources used by this <see cref="T:System.Drawing.StringFormat" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -590,6 +597,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Specifies the language and method to be used when local digits are substituted for western digits.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="language">
           <attribution license="cc4" from="Microsoft" modified="false" />A National Language Support (NLS) language identifier that identifies the language that will be used when local digits are substituted for western digits. You can pass the <see cref="P:System.Globalization.CultureInfo.LCID" /> property of a <see cref="T:System.Globalization.CultureInfo" /> object as the NLS language identifier. For example, suppose you create a <see cref="T:System.Globalization.CultureInfo" /> object by passing the string "ar-EG" to a <see cref="T:System.Globalization.CultureInfo" /> constructor. If you pass the <see cref="P:System.Globalization.CultureInfo.LCID" /> property of that <see cref="T:System.Globalization.CultureInfo" /> object along with <see cref="F:System.Drawing.StringDigitSubstitute.Traditional" /> to the <see cref="M:System.Drawing.StringFormat.SetDigitSubstitution(System.Int32,System.Drawing.StringDigitSubstitute)" /> method, then Arabic-Indic digits will be substituted for western digits at display time. </param>
         <param name="substitute">
@@ -618,6 +629,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Specifies an array of <see cref="T:System.Drawing.CharacterRange" /> structures that represent the ranges of characters measured by a call to the <see cref="M:System.Drawing.Graphics.MeasureCharacterRanges(System.String,System.Drawing.Font,System.Drawing.RectangleF,System.Drawing.StringFormat)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="ranges">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Drawing.CharacterRange" /> structures that specifies the ranges of characters measured by a call to the <see cref="M:System.Drawing.Graphics.MeasureCharacterRanges(System.String,System.Drawing.Font,System.Drawing.RectangleF,System.Drawing.StringFormat)" /> method. </param>
       </Docs>
@@ -663,7 +678,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Only the value of the <see cref="P:System.Drawing.StringFormat.FormatFlags" /> property is converted.</para>
@@ -672,6 +686,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this <see cref="T:System.Drawing.StringFormat" /> object to a human-readable string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of this <see cref="T:System.Drawing.StringFormat" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/SystemBrushes.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/SystemBrushes.xml
index b1de27ec11a..98d945087da 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/SystemBrushes.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/SystemBrushes.xml
@@ -315,12 +315,15 @@
         <Parameter Name="c" Type="System.Drawing.Color" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Brush'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Drawing.Brush" /> from the specified <see cref="T:System.Drawing.Color" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Brush" /> this method creates.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Color" /> structure from which to create the <see cref="T:System.Drawing.Brush" />. </param>
       </Docs>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/SystemFonts.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/SystemFonts.xml
index e83f9dbef73..6ea308fb9eb 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/SystemFonts.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/SystemFonts.xml
@@ -133,7 +133,6 @@
         <Parameter Name="systemFontName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -143,6 +142,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a font object that corresponds to the specified system font name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Drawing.Font" /> if the specified name matches a value in <see cref="T:System.Drawing.SystemFonts" />; otherwise, null.</para>
+        </returns>
         <param name="systemFontName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the system font you need a font object for.</param>
       </Docs>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/SystemPens.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/SystemPens.xml
index fb3979b8ce4..762b0cc1221 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/SystemPens.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/SystemPens.xml
@@ -311,12 +311,15 @@
         <Parameter Name="c" Type="System.Drawing.Color" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Pen'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Drawing.Pen" /> from the specified <see cref="T:System.Drawing.Color" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.Pen" /> this method creates.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Color" /> for the new <see cref="T:System.Drawing.Pen" />. </param>
       </Docs>
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/TextureBrush.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/TextureBrush.xml
index 978e8f38276..d4cdcfd8069 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/TextureBrush.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/TextureBrush.xml
@@ -231,12 +231,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an exact copy of this <see cref="T:System.Drawing.TextureBrush" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Drawing.TextureBrush" /> object this method creates, cast as an <see cref="T:System.Object" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -280,6 +283,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Multiplies the <see cref="T:System.Drawing.Drawing2D.Matrix" /> object that represents the local geometric transformation of this <see cref="T:System.Drawing.TextureBrush" /> object by the specified <see cref="T:System.Drawing.Drawing2D.Matrix" /> object by prepending the specified <see cref="T:System.Drawing.Drawing2D.Matrix" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="matrix">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Drawing2D.Matrix" /> object by which to multiply the geometric transformation. </param>
       </Docs>
@@ -307,6 +314,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Multiplies the <see cref="T:System.Drawing.Drawing2D.Matrix" /> object that represents the local geometric transformation of this <see cref="T:System.Drawing.TextureBrush" /> object by the specified <see cref="T:System.Drawing.Drawing2D.Matrix" /> object in the specified order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="matrix">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Drawing.Drawing2D.Matrix" /> object by which to multiply the geometric transformation. </param>
         <param name="order">
@@ -330,6 +341,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resets the Transform property of this <see cref="T:System.Drawing.TextureBrush" /> object to identity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -351,6 +366,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Rotates the local geometric transformation of this <see cref="T:System.Drawing.TextureBrush" /> object by the specified amount. This method prepends the rotation to the transformation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="angle">
           <attribution license="cc4" from="Microsoft" modified="false" />The angle of rotation. </param>
       </Docs>
@@ -375,6 +394,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Rotates the local geometric transformation of this <see cref="T:System.Drawing.TextureBrush" /> object by the specified amount in the specified order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="angle">
           <attribution license="cc4" from="Microsoft" modified="false" />The angle of rotation. </param>
         <param name="order">
@@ -401,6 +424,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Scales the local geometric transformation of this <see cref="T:System.Drawing.TextureBrush" /> object by the specified amounts. This method prepends the scaling matrix to the transformation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="sx">
           <attribution license="cc4" from="Microsoft" modified="false" />The amount by which to scale the transformation in the x direction. </param>
         <param name="sy">
@@ -428,6 +455,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Scales the local geometric transformation of this <see cref="T:System.Drawing.TextureBrush" /> object by the specified amounts in the specified order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="sx">
           <attribution license="cc4" from="Microsoft" modified="false" />The amount by which to scale the transformation in the x direction. </param>
         <param name="sy">
@@ -480,6 +511,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Translates the local geometric transformation of this <see cref="T:System.Drawing.TextureBrush" /> object by the specified dimensions. This method prepends the translation to the transformation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="dx">
           <attribution license="cc4" from="Microsoft" modified="false" />The dimension by which to translate the transformation in the x direction. </param>
         <param name="dy">
@@ -507,6 +542,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Translates the local geometric transformation of this <see cref="T:System.Drawing.TextureBrush" /> object by the specified dimensions in the specified order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method does not return a value.</para>
+        </returns>
         <param name="dx">
           <attribution license="cc4" from="Microsoft" modified="false" />The dimension by which to translate the transformation in the x direction. </param>
         <param name="dy">
diff --git a/mcs/class/System.Drawing/Documentation/en/System.Drawing/ToolboxBitmapAttribute.xml b/mcs/class/System.Drawing/Documentation/en/System.Drawing/ToolboxBitmapAttribute.xml
index c80184ca949..ac83f01ebe9 100644
--- a/mcs/class/System.Drawing/Documentation/en/System.Drawing/ToolboxBitmapAttribute.xml
+++ b/mcs/class/System.Drawing/Documentation/en/System.Drawing/ToolboxBitmapAttribute.xml
@@ -131,12 +131,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified object is a <see cref="T:System.Drawing.ToolboxBitmapAttribute" /> object and is identical to this <see cref="T:System.Drawing.ToolboxBitmapAttribute" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns true if <paramref name="value" /> is both a <see cref="T:System.Drawing.ToolboxBitmapAttribute" /> object and is identical to this <see cref="T:System.Drawing.ToolboxBitmapAttribute" /> object.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to test. </param>
       </Docs>
@@ -153,12 +156,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a hash code for this <see cref="T:System.Drawing.ToolboxBitmapAttribute" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for this <see cref="T:System.Drawing.ToolboxBitmapAttribute" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -175,7 +181,6 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Image'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method searches for a resource named namespace.classname.bmp, where namespace is the namespace containing the definition of the type of the object specified by the <paramref name="component" /> parameter. For example, suppose you pass an object of type ControlA to the <paramref name="component" /> parameter. If ControlA is in NamespaceA in AssemblyA.dll, then this method searches AssemblyA.dll for a resource named NamespaceA.ControlA.bmp.</para>
@@ -184,6 +189,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the small <see cref="T:System.Drawing.Image" /> associated with this <see cref="T:System.Drawing.ToolboxBitmapAttribute" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The small <see cref="T:System.Drawing.Image" /> associated with this <see cref="T:System.Drawing.ToolboxBitmapAttribute" /> object.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />If this <see cref="T:System.Drawing.ToolboxBitmapAttribute" /> object does not already have a small image, this method searches for a bitmap resource in the assembly that defines the type of the object specified by the component parameter. For example, if you pass an object of type ControlA to the component parameter, then this method searches the assembly that defines ControlA. </param>
       </Docs>
@@ -202,7 +211,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Image'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method searches for a resource named namespace.classname.bmp, where namespace is the namespace containing the definition of the type specified by the <paramref name="type" /> parameter. For example, suppose you pass typeof(ControlA) to the <paramref name="type" /> parameter. If ControlA is in NamespaceA in AssemblyA.dll, then this method searches AssemblyA.dll for a resource named NamespaceA.ControlA.bmp.</para>
@@ -211,6 +219,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the small <see cref="T:System.Drawing.Image" /> associated with this <see cref="T:System.Drawing.ToolboxBitmapAttribute" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The small <see cref="T:System.Drawing.Image" /> associated with this <see cref="T:System.Drawing.ToolboxBitmapAttribute" /> object.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />If this <see cref="T:System.Drawing.ToolboxBitmapAttribute" /> object does not already have a small image, this method searches for a bitmap resource in the assembly that defines the type specified by the type parameter. For example, if you pass typeof(ControlA) to the type parameter, then this method searches the assembly that defines ControlA. </param>
       </Docs>
@@ -230,7 +242,6 @@
         <Parameter Name="large" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Image'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method searches for a resource named namespace.classname.bmp, where namespace is the namespace containing the definition of the type of the object specified by the <paramref name="component" /> parameter. For example, suppose you pass an object of type ControlA to the <paramref name="component" /> parameter. If ControlA is in NamespaceA in AssemblyA.dll, then this method searches AssemblyA.dll for a resource named NamespaceA.ControlA.bmp.</para>
@@ -240,6 +251,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the small or large <see cref="T:System.Drawing.Image" /> associated with this <see cref="T:System.Drawing.ToolboxBitmapAttribute" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Drawing.Image" /> object associated with this <see cref="T:System.Drawing.ToolboxBitmapAttribute" /> object.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />If this <see cref="T:System.Drawing.ToolboxBitmapAttribute" /> object does not already have a small image, this method searches for a bitmap resource in the assembly that defines the type of the object specified by the component parameter. For example, if you pass an object of type ControlA to the component parameter, then this method searches the assembly that defines ControlA. </param>
         <param name="large">
@@ -261,7 +276,6 @@
         <Parameter Name="large" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Image'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method searches for a resource named namespace.classname.bmp, where namespace is the namespace containing the definition of the type specified by the <paramref name="type" /> parameter. For example, suppose you pass an typeof(ControlA) to the <paramref name="type" /> parameter. If ControlA is in NamespaceA in AssemblyA.dll, then this method searches AssemblyA.dll for a resource named NamespaceA.ControlA.bmp.</para>
@@ -271,6 +285,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the small or large <see cref="T:System.Drawing.Image" /> associated with this <see cref="T:System.Drawing.ToolboxBitmapAttribute" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Drawing.Image" /> associated with this <see cref="T:System.Drawing.ToolboxBitmapAttribute" /> object.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />If this <see cref="T:System.Drawing.ToolboxBitmapAttribute" /> object does not already have a small image, this method searches for a bitmap resource in the assembly that defines the type specified by the component type. For example, if you pass typeof(ControlA) to the type parameter, then this method searches the assembly that defines ControlA. </param>
         <param name="large">
@@ -293,7 +311,6 @@
         <Parameter Name="large" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Image'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method searches for a resource named namespace.imgName, where namespace is the namespace containing the definition of the type specified by the <paramref name="type" /> parameter. For example, suppose you pass typeof(ControlA) to the <paramref name="type" /> parameter and that you passed "MyBitmap.bmp" to the imgName parameter. If ControlA is in NamespaceA in AssemblyA.dll, then this method searches AssemblyA.dll for a resource named NamespaceA.MyBitmap.bmp.</para>
@@ -303,6 +320,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the small or large <see cref="T:System.Drawing.Image" /> associated with this <see cref="T:System.Drawing.ToolboxBitmapAttribute" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Drawing.Image" /> associated with this <see cref="T:System.Drawing.ToolboxBitmapAttribute" /> object.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />If this <see cref="T:System.Drawing.ToolboxBitmapAttribute" /> object does not already have a small image, this method searches for an embedded bitmap resource in the assembly that defines the type specified by the component type. For example, if you pass typeof(ControlA) to the type parameter, then this method searches the assembly that defines ControlA. </param>
         <param name="imgName">
@@ -327,7 +348,6 @@
         <Parameter Name="large" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Image'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method searches for a resource named namespace.imgName, where namespace is the namespace containing the definition of the type specified by the <paramref name="t" /> parameter. For example, suppose you pass typeof(ControlA) to the <paramref name="t" /> parameter and you pass "MyBitmap.bmp" to the imgName parameter. If ControlA is in NamespaceA in AssemblyA.dll, then this method searches AssemblyA.dll for a resource named NamespaceA.MyBitmap.bmp.</para>
@@ -337,6 +357,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Drawing.Image" /> object based on a bitmap resource that is embedded in an assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Drawing.Image" /> object based on the retrieved bitmap.</para>
+        </returns>
         <param name="t">
           <attribution license="cc4" from="Microsoft" modified="false" />This method searches for an embedded bitmap resource in the assembly that defines the type specified by the t parameter. For example, if you pass typeof(ControlA) to the t parameter, then this method searches the assembly that defines ControlA. </param>
         <param name="imageName">
diff --git a/mcs/class/System.IO.Compression/Documentation/en/System.IO.Compression/ZipArchive.xml b/mcs/class/System.IO.Compression/Documentation/en/System.IO.Compression/ZipArchive.xml
index 8583eafec7d..3808ee18ed8 100644
--- a/mcs/class/System.IO.Compression/Documentation/en/System.IO.Compression/ZipArchive.xml
+++ b/mcs/class/System.IO.Compression/Documentation/en/System.IO.Compression/ZipArchive.xml
@@ -188,7 +188,6 @@
         <Parameter Name="entryName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="entryName" /> string should reflect the relative path of the entry you want to create within the zip archive. There is no restriction on the string you provide. However, if it is not formatted as a relative path, the entry is created, but you may get an exception when you extract the contents of the zip archive. If an entry with the specified path and name already exists in the archive, a second entry is created with the same path and name.</para>
@@ -198,6 +197,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an empty entry that has the specified path and entry name in the zip archive.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An empty entry in the zip archive.</para>
+        </returns>
         <param name="entryName">
           <attribution license="cc4" from="Microsoft" modified="false" />A path, relative to the root of the archive, that specifies the name of the entry to be created.</param>
       </Docs>
@@ -217,7 +220,6 @@
         <Parameter Name="compressionLevel" Type="System.IO.Compression.CompressionLevel" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="entryName" /> string should reflect the relative path of the entry you want to create within the zip archive. There is no restriction on the string you provide. However, if it is not formatted as a relative path, the entry is created, but you may get an exception when you extract the contents of the zip archive. If an entry with the specified name already exists in the archive, a second entry is created with the same name.</para>
@@ -227,6 +229,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an empty entry that has the specified entry name and compression level in the zip archive.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An empty entry in the zip archive.</para>
+        </returns>
         <param name="entryName">
           <attribution license="cc4" from="Microsoft" modified="false" />A path, relative to the root of the archive, that specifies the name of the entry to be created.</param>
         <param name="compressionLevel">
@@ -331,7 +337,6 @@
         <Parameter Name="entryName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If multiple entries that have the specified name exist in the archive, the first one is returned. The name of the entry is compared to <paramref name="entryName" /> using ordinal comparison. </para>
@@ -340,6 +345,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a wrapper for the specified entry in the zip archive.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A wrapper for the specified entry in the archive; null if the entry does not exist in the archive.</para>
+        </returns>
         <param name="entryName">
           <attribution license="cc4" from="Microsoft" modified="false" />A path, relative to the root of the archive, that identifies the entry to retrieve.</param>
       </Docs>
diff --git a/mcs/class/System.IO.Compression/Documentation/en/System.IO.Compression/ZipArchiveEntry.xml b/mcs/class/System.IO.Compression/Documentation/en/System.IO.Compression/ZipArchiveEntry.xml
index f7187461349..6863498f444 100644
--- a/mcs/class/System.IO.Compression/Documentation/en/System.IO.Compression/ZipArchiveEntry.xml
+++ b/mcs/class/System.IO.Compression/Documentation/en/System.IO.Compression/ZipArchiveEntry.xml
@@ -199,7 +199,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You use this method to access the stream for an entry in a zip archive. After retrieving the stream, you can read from or write to the stream. When you write to the stream, the modifications you make to the entry will appear in the zip archive.</para>
@@ -208,6 +207,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens the entry from the zip archive.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The stream that represents the contents of the entry.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Json/Documentation/en/System.Json/JsonArray.xml b/mcs/class/System.Json/Documentation/en/System.Json/JsonArray.xml
index 763bfd44f10..d7ebc3c0dba 100644
--- a/mcs/class/System.Json/Documentation/en/System.Json/JsonArray.xml
+++ b/mcs/class/System.Json/Documentation/en/System.Json/JsonArray.xml
@@ -182,12 +182,15 @@
         <Parameter Name="item" Type="System.Json.JsonValue" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a specified JSON CLR type is in the <see cref="T:System.Json.JsonArray" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the item is found in the <see cref="T:System.Json.JsonArray" />; otherwise, false.</para>
+        </returns>
         <param name="item">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Json.JsonValue" /> to check for in the array.</param>
       </Docs>
@@ -251,12 +254,15 @@
         <Parameter Name="item" Type="System.Json.JsonValue" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for a specified object and returns the zero-based index of its first occurrence within the array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of item within the array, if found; otherwise, -1.</para>
+        </returns>
         <param name="item">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Json.JsonValue" /> object to look up.</param>
       </Docs>
@@ -359,12 +365,15 @@
         <Parameter Name="item" Type="System.Json.JsonValue" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the first occurrence of the specified JSON value from the array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the item is successfully removed; otherwise, false. This method also returns false if the item was not found in the array.</para>
+        </returns>
         <param name="item">
           <attribution license="cc4" from="Microsoft" modified="false" />The JSON value to remove from the array.</param>
       </Docs>
@@ -440,12 +449,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the <see cref="T:System.Json.JsonValue" /> objects in the array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator that iterates through the <see cref="T:System.Json.JsonValue" /> elements in the array.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Json/Documentation/en/System.Json/JsonObject.xml b/mcs/class/System.Json/Documentation/en/System.Json/JsonObject.xml
index 5a56e7f61a1..d2691d90df2 100644
--- a/mcs/class/System.Json/Documentation/en/System.Json/JsonObject.xml
+++ b/mcs/class/System.Json/Documentation/en/System.Json/JsonObject.xml
@@ -207,12 +207,15 @@
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks whether a key/value pair with a specified key exists in the JSON CLR object type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True if the JSON CLR object contains the key; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key to check for.</param>
       </Docs>
@@ -351,12 +354,15 @@
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the key/value pair with a specified from the JSON CLR object type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True if the element is successfully found and removed; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key of the item to remove.</param>
       </Docs>
@@ -448,12 +454,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the key/value pairs in the JsonObject.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator that iterates through the key/value pairs in the JsonObject.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryGetValue">
diff --git a/mcs/class/System.Json/Documentation/en/System.Json/JsonValue.xml b/mcs/class/System.Json/Documentation/en/System.Json/JsonValue.xml
index 038ef4ece0b..fac076dc914 100644
--- a/mcs/class/System.Json/Documentation/en/System.Json/JsonValue.xml
+++ b/mcs/class/System.Json/Documentation/en/System.Json/JsonValue.xml
@@ -49,12 +49,15 @@
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Throws an InvalidOperationException.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True if the operation exception is invalid; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key to check.</param>
       </Docs>
@@ -151,12 +154,15 @@
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes the text-based JSON from a stream into JSON CLR type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The text-based JSON from a stream.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />A stream that contains text-based JSON content.</param>
       </Docs>
@@ -175,12 +181,15 @@
         <Parameter Name="textReader" Type="System.IO.TextReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes the text-based JSON from a text reader into a JSON CLR type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The text-based JSON from a text reader.</para>
+        </returns>
         <param name="textReader">
           <attribution license="cc4" from="Microsoft" modified="false" />A TextReader over text-based JSON content.</param>
       </Docs>
@@ -960,12 +969,15 @@
       </Parameters>
       <Docs>
         <param name="jsonString">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes the text-based JSON into a JSON CLR type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The text-based JSON into a JSON CLR type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Save">
@@ -1026,12 +1038,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Json.JsonValue" /> enumerator.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The enumerator.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -1046,12 +1061,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves (serializes) this JSON CLR type into text-based JSON.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns string, which contains text-based JSON.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/AuthenticationHeaderValue.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/AuthenticationHeaderValue.xml
index c61d4f74202..f61a05aa91d 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/AuthenticationHeaderValue.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/AuthenticationHeaderValue.xml
@@ -82,12 +82,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Net.Http.Headers.AuthenticationHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current object. </param>
       </Docs>
@@ -104,7 +108,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A hash code is a numeric value that is used to identify an object during equality testing. It can also serve as an index for an object in a collection.</para>
@@ -114,6 +117,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for an  <see cref="T:System.Net.Http.Headers.AuthenticationHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Int32" />.</para>
+          <para>A hash code for the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parameter">
@@ -149,12 +157,16 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string to an <see cref="T:System.Net.Http.Headers.AuthenticationHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Net.Http.Headers.AuthenticationHeaderValue" />.</para>
+          <para>An <see cref="T:System.Net.Http.Headers.AuthenticationHeaderValue" /> instance.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents authentication header value information.</param>
       </Docs>
@@ -190,12 +202,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new object that is a copy of the current <see cref="T:System.Net.Http.Headers.AuthenticationHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Object" />.</para>
+          <para>A copy of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -210,12 +226,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Net.Http.Headers.AuthenticationHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.String" />.</para>
+          <para>A string that represents the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParse">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/CacheControlHeaderValue.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/CacheControlHeaderValue.xml
index 30dddc56311..0fde0665ffa 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/CacheControlHeaderValue.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/CacheControlHeaderValue.xml
@@ -52,12 +52,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Net.Http.Headers.CacheControlHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current object.</param>
       </Docs>
@@ -96,7 +100,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A hash code is a numeric value that is used to identify an object during equality testing. It can also serve as an index for an object in a collection.</para>
@@ -106,6 +109,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for a  <see cref="T:System.Net.Http.Headers.CacheControlHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Int32" />.</para>
+          <para>A hash code for the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MaxAge">
@@ -348,12 +356,16 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string to an <see cref="T:System.Net.Http.Headers.CacheControlHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Net.Http.Headers.CacheControlHeaderValue" />.</para>
+          <para>A <see cref="T:System.Net.Http.Headers.CacheControlHeaderValue" /> instance.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents cache-control header value information.</param>
       </Docs>
@@ -481,12 +493,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new object that is a copy of the current <see cref="T:System.Net.Http.Headers.CacheControlHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Object" />.</para>
+          <para>A copy of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -501,12 +517,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Net.Http.Headers.CacheControlHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.String" />.</para>
+          <para>A string that represents the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParse">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/ContentDispositionHeaderValue.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/ContentDispositionHeaderValue.xml
index ca2cb76dd7c..4997d3e4ff3 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/ContentDispositionHeaderValue.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/ContentDispositionHeaderValue.xml
@@ -129,12 +129,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Net.Http.Headers.ContentDispositionHeaderValue" />  object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current object.</param>
       </Docs>
@@ -195,7 +199,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A hash code is a numeric value that is used to identify an object during equality testing. It can also serve as an index for an object in a collection.</para>
@@ -205,6 +208,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for an  <see cref="T:System.Net.Http.Headers.ContentDispositionHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Int32" />.</para>
+          <para>A hash code for the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ModificationDate">
@@ -278,12 +286,16 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string to an <see cref="T:System.Net.Http.Headers.ContentDispositionHeaderValue" />  instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Net.Http.Headers.ContentDispositionHeaderValue" />.</para>
+          <para>An <see cref="T:System.Net.Http.Headers.ContentDispositionHeaderValue" />  instance.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents content disposition header value information.</param>
       </Docs>
@@ -338,12 +350,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new object that is a copy of the current <see cref="T:System.Net.Http.Headers.ContentDispositionHeaderValue" />  instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Object" />.</para>
+          <para>A copy of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -358,12 +374,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Net.Http.Headers.ContentDispositionHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.String" />.</para>
+          <para>A string that represents the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParse">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/ContentRangeHeaderValue.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/ContentRangeHeaderValue.xml
index e936a5de131..dcb488c4aca 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/ContentRangeHeaderValue.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/ContentRangeHeaderValue.xml
@@ -105,12 +105,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified Object is equal to the current <see cref="T:System.Net.Http.Headers.ContentRangeHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current object.</param>
       </Docs>
@@ -146,7 +150,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A hash code is a numeric value that is used to identify an object during equality testing. It can also serve as an index for an object in a collection.</para>
@@ -156,6 +159,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for an <see cref="T:System.Net.Http.Headers.ContentRangeHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Int32" />.</para>
+          <para>A hash code for the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HasLength">
@@ -229,12 +237,16 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string to an <see cref="T:System.Net.Http.Headers.ContentRangeHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Net.Http.Headers.ContentRangeHeaderValue" />.</para>
+          <para>An <see cref="T:System.Net.Http.Headers.ContentRangeHeaderValue" /> instance.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents content range header value information.</param>
       </Docs>
@@ -251,12 +263,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new object that is a copy of the current <see cref="T:System.Net.Http.Headers.ContentRangeHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Object" />.</para>
+          <para>A copy of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="To">
@@ -290,12 +306,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Net.Http.Headers.ContentRangeHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.String" />.</para>
+          <para>A string that represents the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParse">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/EntityTagHeaderValue.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/EntityTagHeaderValue.xml
index 27546f1848c..8406d30dee1 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/EntityTagHeaderValue.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/EntityTagHeaderValue.xml
@@ -104,12 +104,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Net.Http.Headers.EntityTagHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current object.</param>
       </Docs>
@@ -126,7 +130,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A hash code is a numeric value that is used to identify an object during equality testing. It can also serve as an index for an object in a collection.</para>
@@ -136,6 +139,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for an <see cref="T:System.Net.Http.Headers.EntityTagHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Int32" />.</para>
+          <para>A hash code for the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsWeak">
@@ -171,12 +179,16 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string to an <see cref="T:System.Net.Http.Headers.EntityTagHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Net.Http.Headers.EntityTagHeaderValue" />.</para>
+          <para>An <see cref="T:System.Net.Http.Headers.EntityTagHeaderValue" /> instance.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents entity tag header value information.</param>
       </Docs>
@@ -193,12 +205,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new object that is a copy of the current <see cref="T:System.Net.Http.Headers.EntityTagHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Object" />.</para>
+          <para>A copy of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Tag">
@@ -232,12 +248,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Net.Http.Headers.EntityTagHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.String" />.</para>
+          <para>A string that represents the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParse">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/HttpHeaderValueCollection`1.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/HttpHeaderValueCollection`1.xml
index 2ce312089fa..c23f098c0a4 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/HttpHeaderValueCollection`1.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/HttpHeaderValueCollection`1.xml
@@ -143,7 +143,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This enumerator returns the keys of the collection as strings.The foreach statement of the C# language (for each in Visual Basic) hides the complexity of the enumerators. Therefore, using foreach is recommended, instead of directly manipulating the enumerator.</para>
@@ -154,6 +153,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the <see cref="T:System.Net.Http.Headers.HttpHeaderValueCollection`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Collections.Generic.IEnumerator`1" />.</para>
+          <para>An enumerator for the <see cref="T:System.Net.Http.Headers.HttpHeaderValueCollection`1" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsReadOnly">
@@ -230,12 +234,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the <see cref="T:System.Net.Http.Headers.HttpHeaderValueCollection`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Collections.IEnumerator" />.</para>
+          <para>An enumerator for the <see cref="T:System.Net.Http.Headers.HttpHeaderValueCollection`1" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -250,12 +258,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Net.Http.Headers.HttpHeaderValueCollection`1" /> object. object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.String" />.</para>
+          <para>A string that represents the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParseAdd">
@@ -272,12 +284,16 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the input could be parsed and added to the <see cref="T:System.Net.Http.Headers.HttpHeaderValueCollection`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if the <paramref name="input" /> could be parsed and added to the <see cref="T:System.Net.Http.Headers.HttpHeaderValueCollection`1" /> instance; otherwise, false</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The entry to validate.</param>
       </Docs>
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/HttpHeaders.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/HttpHeaders.xml
index 9feb90be9c9..665db3556c1 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/HttpHeaders.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/HttpHeaders.xml
@@ -133,12 +133,16 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns if  a specific header exists in the <see cref="T:System.Net.Http.Headers.HttpHeaders" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true is the specified header exists in the collection; otherwise false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The specific header.</param>
       </Docs>
@@ -155,12 +159,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that can iterate through the <see cref="T:System.Net.Http.Headers.HttpHeaders" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Collections.Generic.IEnumerator`1" />.</para>
+          <para>An enumerator for the <see cref="T:System.Net.Http.Headers.HttpHeaders" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetValues">
@@ -177,12 +185,16 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all header values for a specified header stored in the <see cref="T:System.Net.Http.Headers.HttpHeaders" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Collections.Generic.IEnumerable`1" />.</para>
+          <para>An array of header strings.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The specified header to return values for.</param>
       </Docs>
@@ -201,12 +213,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the specified header from the <see cref="T:System.Net.Http.Headers.HttpHeaders" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the header to remove from the collection. </param>
       </Docs>
@@ -223,12 +238,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an enumerator that can iterate through a <see cref="T:System.Net.Http.Headers.HttpHeaders" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Collections.IEnumerator" />.</para>
+          <para>An instance of an implementation of an <see cref="T:System.Collections.IEnumerator" /> that can iterate through a <see cref="T:System.Net.Http.Headers.HttpHeaders" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -243,12 +262,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Net.Http.Headers.HttpHeaders" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.String" />.</para>
+          <para>A string that represents the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryAddWithoutValidation">
@@ -266,12 +289,16 @@
         <Parameter Name="values" Type="System.Collections.Generic.IEnumerable&lt;System.String&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the specified header and its values were added to the <see cref="T:System.Net.Http.Headers.HttpHeaders" /> collection without validating the provided information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if the specified header <paramref name="name" /> and <paramref name="values" /> could be added to the collection; otherwise false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The header to add to the collection.</param>
         <param name="values">
@@ -293,12 +320,16 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the specified header and its value were added to the <see cref="T:System.Net.Http.Headers.HttpHeaders" /> collection without validating the provided information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if the specified header <paramref name="name" /> and <paramref name="value" /> could be added to the collection; otherwise false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The header to add to the collection.</param>
         <param name="value">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/MediaTypeHeaderValue.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/MediaTypeHeaderValue.xml
index a885531fc1a..92a846d2fc0 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/MediaTypeHeaderValue.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/MediaTypeHeaderValue.xml
@@ -99,12 +99,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Net.Http.Headers.MediaTypeHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current object.</param>
       </Docs>
@@ -121,7 +125,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A hash code is a numeric value that is used to identify an object during equality testing. It can also serve as an index for an object in a collection.</para>
@@ -131,6 +134,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for an <see cref="T:System.Net.Http.Headers.MediaTypeHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Int32" />.</para>
+          <para>A hash code for the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MediaType">
@@ -188,12 +196,16 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string to an <see cref="T:System.Net.Http.Headers.MediaTypeHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Net.Http.Headers.MediaTypeHeaderValue" />.</para>
+          <para>An <see cref="T:System.Net.Http.Headers.MediaTypeHeaderValue" /> instance.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents media type header value information.</param>
       </Docs>
@@ -210,12 +222,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new object that is a copy of the current <see cref="T:System.Net.Http.Headers.MediaTypeHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Object" />.</para>
+          <para>A copy of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -230,12 +246,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Net.Http.Headers.MediaTypeHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.String" />.</para>
+          <para>A string that represents the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParse">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/MediaTypeWithQualityHeaderValue.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/MediaTypeWithQualityHeaderValue.xml
index 4c4c6f418d2..9a29f9fe4d5 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/MediaTypeWithQualityHeaderValue.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/MediaTypeWithQualityHeaderValue.xml
@@ -80,12 +80,16 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string to an <see cref="T:System.Net.Http.Headers.MediaTypeWithQualityHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Net.Http.Headers.MediaTypeWithQualityHeaderValue" />.</para>
+          <para>An <see cref="T:System.Net.Http.Headers.MediaTypeWithQualityHeaderValue" /> instance.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents media type with quality header value information.</param>
       </Docs>
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/NameValueHeaderValue.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/NameValueHeaderValue.xml
index 9e6876c0a07..9abaaaccec5 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/NameValueHeaderValue.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/NameValueHeaderValue.xml
@@ -102,12 +102,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Net.Http.Headers.NameValueHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current object.</param>
       </Docs>
@@ -124,7 +128,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A hash code is a numeric value that is used to identify an object during equality testing. It can also serve as an index for an object in a collection.</para>
@@ -134,6 +137,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for an <see cref="T:System.Net.Http.Headers.NameValueHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Int32" />.</para>
+          <para>A hash code for the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Name">
@@ -169,12 +177,16 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string to an <see cref="T:System.Net.Http.Headers.NameValueHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Net.Http.Headers.NameValueHeaderValue" />.</para>
+          <para>An <see cref="T:System.Net.Http.Headers.NameValueHeaderValue" /> instance.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents name value header value information.</param>
       </Docs>
@@ -191,12 +203,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new object that is a copy of the current <see cref="T:System.Net.Http.Headers.NameValueHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Object" />.</para>
+          <para>A copy of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -211,12 +227,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Net.Http.Headers.NameValueHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.String" />.</para>
+          <para>A string that represents the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParse">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/NameValueWithParametersHeaderValue.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/NameValueWithParametersHeaderValue.xml
index 00e6f588735..b423d8e39c9 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/NameValueWithParametersHeaderValue.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/NameValueWithParametersHeaderValue.xml
@@ -102,12 +102,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Net.Http.Headers.NameValueWithParametersHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current object.</param>
       </Docs>
@@ -124,7 +128,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A hash code is a numeric value that is used to identify an object during equality testing. It can also serve as an index for an object in a collection.</para>
@@ -134,6 +137,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for an <see cref="T:System.Net.Http.Headers.NameValueWithParametersHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Int32" />.</para>
+          <para>A hash code for the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parameters">
@@ -169,12 +177,16 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string to an <see cref="T:System.Net.Http.Headers.NameValueWithParametersHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Net.Http.Headers.NameValueWithParametersHeaderValue" />.</para>
+          <para>An <see cref="T:System.Net.Http.Headers.NameValueWithParametersHeaderValue" /> instance.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents name value with parameter header value information.</param>
       </Docs>
@@ -191,12 +203,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new object that is a copy of the current <see cref="T:System.Net.Http.Headers.NameValueWithParametersHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Object" />.</para>
+          <para>A copy of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -211,12 +227,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Net.Http.Headers.NameValueWithParametersHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.String" />.</para>
+          <para>A string that represents the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParse">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/ProductHeaderValue.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/ProductHeaderValue.xml
index 453d26788e1..1af4556509f 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/ProductHeaderValue.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/ProductHeaderValue.xml
@@ -82,12 +82,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Net.Http.Headers.ProductHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current object.</param>
       </Docs>
@@ -104,7 +108,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A hash code is a numeric value that is used to identify an object during equality testing. It can also serve as an index for an object in a collection.</para>
@@ -114,6 +117,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for an <see cref="T:System.Net.Http.Headers.ProductHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Int32" />.</para>
+          <para>A hash code for the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Name">
@@ -149,12 +157,16 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string to an <see cref="T:System.Net.Http.Headers.ProductHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Net.Http.Headers.ProductHeaderValue" />.</para>
+          <para>An <see cref="T:System.Net.Http.Headers.ProductHeaderValue" /> instance.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents product header value information.</param>
       </Docs>
@@ -171,12 +183,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new object that is a copy of the current <see cref="T:System.Net.Http.Headers.ProductHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Object" />.</para>
+          <para>A copy of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -191,12 +207,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Net.Http.Headers.ProductHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.String" />.</para>
+          <para>A string that represents the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParse">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/ProductInfoHeaderValue.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/ProductInfoHeaderValue.xml
index 9d80a49f248..408cd3b56b5 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/ProductInfoHeaderValue.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/ProductInfoHeaderValue.xml
@@ -122,12 +122,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Net.Http.Headers.ProductInfoHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current object.</param>
       </Docs>
@@ -144,7 +148,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A hash code is a numeric value that is used to identify an object during equality testing. It can also serve as an index for an object in a collection.</para>
@@ -154,6 +157,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for an <see cref="T:System.Net.Http.Headers.ProductInfoHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Int32" />.</para>
+          <para>A hash code for the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -170,12 +178,16 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string to an <see cref="T:System.Net.Http.Headers.ProductInfoHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Net.Http.Headers.ProductInfoHeaderValue" />.</para>
+          <para>An <see cref="T:System.Net.Http.Headers.ProductInfoHeaderValue" /> instance.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents product info header value information.</param>
       </Docs>
@@ -211,12 +223,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new object that is a copy of the current <see cref="T:System.Net.Http.Headers.ProductInfoHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Object" />.</para>
+          <para>A copy of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -231,12 +247,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Net.Http.Headers.ProductInfoHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.String" />.</para>
+          <para>A string that represents the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParse">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/RangeConditionHeaderValue.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/RangeConditionHeaderValue.xml
index 90d8c162232..8f07ebca0f2 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/RangeConditionHeaderValue.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/RangeConditionHeaderValue.xml
@@ -137,12 +137,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Net.Http.Headers.RangeConditionHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current object.</param>
       </Docs>
@@ -159,7 +163,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A hash code is a numeric value that is used to identify an object during equality testing. It can also serve as an index for an object in a collection.</para>
@@ -169,6 +172,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for an <see cref="T:System.Net.Http.Headers.RangeConditionHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Int32" />.</para>
+          <para>A hash code for the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -185,12 +193,16 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string to an <see cref="T:System.Net.Http.Headers.RangeConditionHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Net.Http.Headers.RangeConditionHeaderValue" />.</para>
+          <para>An <see cref="T:System.Net.Http.Headers.RangeConditionHeaderValue" /> instance.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents range condition header value information.</param>
       </Docs>
@@ -207,12 +219,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new object that is a copy of the current <see cref="T:System.Net.Http.Headers.RangeConditionHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Object" />.</para>
+          <para>A copy of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -227,12 +243,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Net.Http.Headers.RangeConditionHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.String" />.</para>
+          <para>A string that represents the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParse">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/RangeHeaderValue.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/RangeHeaderValue.xml
index 20d999be615..0ab4364e537 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/RangeHeaderValue.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/RangeHeaderValue.xml
@@ -92,12 +92,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Net.Http.Headers.RangeHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current object.</param>
       </Docs>
@@ -114,7 +118,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A hash code is a numeric value that is used to identify an object during equality testing. It can also serve as an index for an object in a collection.</para>
@@ -124,6 +127,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for an <see cref="T:System.Net.Http.Headers.RangeHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Int32" />.</para>
+          <para>A hash code for the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -140,12 +148,16 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string to an <see cref="T:System.Net.Http.Headers.RangeHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Net.Http.Headers.RangeHeaderValue" />.</para>
+          <para>An <see cref="T:System.Net.Http.Headers.RangeHeaderValue" /> instance.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents range header value information.</param>
       </Docs>
@@ -181,12 +193,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new object that is a copy of the current <see cref="T:System.Net.Http.Headers.RangeHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Object" />.</para>
+          <para>A copy of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -201,12 +217,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Net.Http.Headers.RangeHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.String" />.</para>
+          <para>A string that represents the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParse">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/RangeItemHeaderValue.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/RangeItemHeaderValue.xml
index b13f38db7e5..94b06d80a8f 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/RangeItemHeaderValue.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/RangeItemHeaderValue.xml
@@ -74,12 +74,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Net.Http.Headers.RangeItemHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current object.</param>
       </Docs>
@@ -115,7 +119,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A hash code is a numeric value that is used to identify an object during equality testing. It can also serve as an index for an object in a collection.</para>
@@ -125,6 +128,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for an <see cref="T:System.Net.Http.Headers.RangeItemHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Int32" />.</para>
+          <para>A hash code for the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ICloneable.Clone">
@@ -139,12 +147,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new object that is a copy of the current <see cref="T:System.Net.Http.Headers.RangeItemHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Object" />.</para>
+          <para>A copy of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="To">
@@ -178,12 +190,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Net.Http.Headers.RangeItemHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.String" />.</para>
+          <para>A string that represents the current object.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/RetryConditionHeaderValue.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/RetryConditionHeaderValue.xml
index 89144b7f81d..404ae1bb92e 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/RetryConditionHeaderValue.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/RetryConditionHeaderValue.xml
@@ -117,12 +117,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Net.Http.Headers.RetryConditionHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current object.</param>
       </Docs>
@@ -139,7 +143,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A hash code is a numeric value that is used to identify an object during equality testing. It can also serve as an index for an object in a collection.</para>
@@ -149,6 +152,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for an <see cref="T:System.Net.Http.Headers.RetryConditionHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Int32" />.</para>
+          <para>A hash code for the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -165,12 +173,16 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string to an <see cref="T:System.Net.Http.Headers.RetryConditionHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Net.Http.Headers.RetryConditionHeaderValue" />.</para>
+          <para>An <see cref="T:System.Net.Http.Headers.RetryConditionHeaderValue" /> instance.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents retry condition header value information.</param>
       </Docs>
@@ -187,12 +199,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new object that is a copy of the current <see cref="T:System.Net.Http.Headers.RetryConditionHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Object" />.</para>
+          <para>A copy of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -207,12 +223,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Net.Http.Headers.RetryConditionHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.String" />.</para>
+          <para>A string that represents the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParse">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/StringWithQualityHeaderValue.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/StringWithQualityHeaderValue.xml
index 2bb658356e9..d682969e7cd 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/StringWithQualityHeaderValue.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/StringWithQualityHeaderValue.xml
@@ -83,12 +83,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified Object is equal to the current <see cref="T:System.Net.Http.Headers.StringWithQualityHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current object.</param>
       </Docs>
@@ -105,7 +109,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A hash code is a numeric value that is used to identify an object during equality testing. It can also serve as an index for an object in a collection.</para>
@@ -115,6 +118,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for an <see cref="T:System.Net.Http.Headers.StringWithQualityHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Int32" />.</para>
+          <para>A hash code for the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -131,12 +139,16 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string to an <see cref="T:System.Net.Http.Headers.StringWithQualityHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Net.Http.Headers.StringWithQualityHeaderValue" />.</para>
+          <para>An <see cref="T:System.Net.Http.Headers.AuthenticationHeaderValue" /> instance.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents quality header value information.</param>
       </Docs>
@@ -172,12 +184,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new object that is a copy of the current <see cref="T:System.Net.Http.Headers.StringWithQualityHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Object" />.</para>
+          <para>A copy of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -192,12 +208,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Net.Http.Headers.StringWithQualityHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.String" />.</para>
+          <para>A string that represents the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParse">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/TransferCodingHeaderValue.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/TransferCodingHeaderValue.xml
index 83b68d87fe0..20417714159 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/TransferCodingHeaderValue.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/TransferCodingHeaderValue.xml
@@ -79,12 +79,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified Object is equal to the current <see cref="T:System.Net.Http.Headers.TransferCodingHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current object.</param>
       </Docs>
@@ -101,7 +105,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A hash code is a numeric value that is used to identify an object during equality testing. It can also serve as an index for an object in a collection.</para>
@@ -111,6 +114,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for an <see cref="T:System.Net.Http.Headers.TransferCodingHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Int32" />.</para>
+          <para>A hash code for the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parameters">
@@ -146,12 +154,16 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string to an <see cref="T:System.Net.Http.Headers.TransferCodingHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Net.Http.Headers.TransferCodingHeaderValue" />.</para>
+          <para>An <see cref="T:System.Net.Http.Headers.AuthenticationHeaderValue" /> instance.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents transfer-coding header value information.</param>
       </Docs>
@@ -168,12 +180,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new object that is a copy of the current <see cref="T:System.Net.Http.Headers.TransferCodingHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Object" />.</para>
+          <para>A copy of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -188,12 +204,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Net.Http.Headers.TransferCodingHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.String" />.</para>
+          <para>A string that represents the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParse">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/TransferCodingWithQualityHeaderValue.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/TransferCodingWithQualityHeaderValue.xml
index df7fac096e7..0d9520de07a 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/TransferCodingWithQualityHeaderValue.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/TransferCodingWithQualityHeaderValue.xml
@@ -80,12 +80,16 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string to an <see cref="T:System.Net.Http.Headers.TransferCodingWithQualityHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Net.Http.Headers.TransferCodingWithQualityHeaderValue" />.</para>
+          <para>An <see cref="T:System.Net.Http.Headers.TransferCodingWithQualityHeaderValue" /> instance.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents transfer-coding value information.</param>
       </Docs>
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/ViaHeaderValue.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/ViaHeaderValue.xml
index 707b052c78c..be592dc10fe 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/ViaHeaderValue.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/ViaHeaderValue.xml
@@ -133,12 +133,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Net.Http.Headers.ViaHeaderValue" />object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current object.</param>
       </Docs>
@@ -155,7 +159,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A hash code is a numeric value that is used to identify an object during equality testing. It can also serve as an index for an object in a collection.</para>
@@ -165,6 +168,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for an <see cref="T:System.Net.Http.Headers.ViaHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Int32" />.</para>
+          <para>Returns a hash code for the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -181,12 +189,16 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string to an <see cref="T:System.Net.Http.Headers.ViaHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Net.Http.Headers.ViaHeaderValue" />.</para>
+          <para>An <see cref="T:System.Net.Http.Headers.ViaHeaderValue" /> instance.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents via header value information.</param>
       </Docs>
@@ -263,12 +275,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new object that is a copy of the current <see cref="T:System.Net.Http.Headers.ViaHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Object" />.</para>
+          <para>A copy of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -283,12 +299,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Net.Http.Headers.ViaHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.String" />.</para>
+          <para>A string that represents the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParse">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/WarningHeaderValue.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/WarningHeaderValue.xml
index 280cb8c835f..51588ba7fbe 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/WarningHeaderValue.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http.Headers/WarningHeaderValue.xml
@@ -148,12 +148,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Net.Http.Headers.WarningHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current object.</param>
       </Docs>
@@ -170,7 +174,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A hash code is a numeric value that is used to identify an object during equality testing. It can also serve as an index for an object in a collection.</para>
@@ -180,6 +183,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for an <see cref="T:System.Net.Http.Headers.WarningHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Int32" />.</para>
+          <para>A hash code for the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -196,12 +204,15 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string to an <see cref="T:System.Net.Http.Headers.WarningHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an <see cref="T:System.Net.Http.Headers.WarningHeaderValue" /> instance.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents authentication header value information.</param>
       </Docs>
@@ -218,12 +229,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new object that is a copy of the current <see cref="T:System.Net.Http.Headers.WarningHeaderValue" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Object" />.</para>
+          <para>Returns a copy of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Text">
@@ -257,12 +272,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Net.Http.Headers.WarningHeaderValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.String" />.</para>
+          <para>A string that represents the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParse">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/ByteArrayContent.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/ByteArrayContent.xml
index b95cd92febd..77f02960298 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/ByteArrayContent.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/ByteArrayContent.xml
@@ -79,7 +79,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" />object will complete after all of the content stream has been created.</para>
@@ -88,6 +87,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an HTTP content stream as an asynchronous operation for reading whose backing store is memory from the <see cref="T:System.Net.Http.ByteArrayContent" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SerializeToStreamAsync">
@@ -105,7 +109,6 @@
         <Parameter Name="context" Type="System.Net.TransportContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation does not block. When the returned <see cref="T:System.Threading.Tasks.Task" /> object completes, the whole byte array has been written to the <paramref name="stream" /> parameter.</para>
@@ -114,6 +117,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serialize and write the byte array provided in the constructor to an HTTP content stream as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task" />. </para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The target stream.</param>
         <param name="context">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/DelegatingHandler.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/DelegatingHandler.xml
index fca4ab986d5..347c007e6c6 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/DelegatingHandler.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/DelegatingHandler.xml
@@ -122,7 +122,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation does not block. This overridable implementation of <see cref="M:System.Net.Http.HttpClientHandler.SendAsync(System.Net.Http.HttpRequestMessage,System.Threading.CancellationToken)" /> method forwards the HTTP request to the inner handler to send to the server as an asynchronous operation.</para>
@@ -132,6 +131,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends an HTTP request to the inner handler to send to the server as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />. </para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="request">
           <attribution license="cc4" from="Microsoft" modified="false" />The HTTP request message to send to the server.</param>
         <param name="cancellationToken">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpClient.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpClient.xml
index 7b66d380c47..6cc65954575 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpClient.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpClient.xml
@@ -214,7 +214,6 @@
         <Parameter Name="requestUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the whole response (including content) is read.</para>
@@ -223,6 +222,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send a DELETE request to the specified Uri as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="requestUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uri the request is sent to.</param>
       </Docs>
@@ -241,7 +245,6 @@
         <Parameter Name="requestUri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the whole response (including content) is read.</para>
@@ -250,6 +253,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send a DELETE request to the specified Uri as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="requestUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uri the request is sent to.</param>
       </Docs>
@@ -269,7 +277,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the whole response (including content) is read.</para>
@@ -278,6 +285,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send a DELETE request to the specified Uri with a cancellation token as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="requestUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uri the request is sent to.</param>
         <param name="cancellationToken">
@@ -299,7 +311,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the whole response (including content) is read.</para>
@@ -308,6 +319,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send a DELETE request to the specified Uri with a cancellation token as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="requestUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uri the request is sent to.</param>
         <param name="cancellationToken">
@@ -356,7 +372,6 @@
         <Parameter Name="requestUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the whole response (including content) is read.</para>
@@ -365,6 +380,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send a GET request to the specified Uri as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="requestUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uri the request is sent to.</param>
       </Docs>
@@ -383,7 +403,6 @@
         <Parameter Name="requestUri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the whole response (including content) is read.</para>
@@ -392,6 +411,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send a GET request to the specified Uri as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="requestUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uri the request is sent to.</param>
       </Docs>
@@ -411,7 +435,6 @@
         <Parameter Name="completionOption" Type="System.Net.Http.HttpCompletionOption" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete based on the <paramref name="completionOption" /> parameter after the part or all of the response (including content) is read.</para>
@@ -420,6 +443,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send a GET request to the specified Uri with an HTTP completion option as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="requestUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uri the request is sent to.</param>
         <param name="completionOption">
@@ -441,7 +468,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the whole response (including content) is read.</para>
@@ -450,6 +476,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send a GET request to the specified Uri with a cancellation token as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="requestUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uri the request is sent to.</param>
         <param name="cancellationToken">
@@ -471,7 +501,6 @@
         <Parameter Name="completionOption" Type="System.Net.Http.HttpCompletionOption" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete based on the <paramref name="completionOption" /> parameter after the part or all of the response (including content) is read.</para>
@@ -480,6 +509,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send a GET request to the specified Uri with an HTTP completion option as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="requestUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uri the request is sent to.</param>
         <param name="completionOption">
@@ -501,7 +535,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the whole response (including content) is read.</para>
@@ -510,6 +543,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send a GET request to the specified Uri with a cancellation token as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="requestUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uri the request is sent to.</param>
         <param name="cancellationToken">
@@ -532,7 +570,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete based on the <paramref name="completionOption" /> parameter after the part or all of the response (including content) is read.</para>
@@ -541,6 +578,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send a GET request to the specified Uri with an HTTP completion option and a cancellation token as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="requestUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uri the request is sent to.</param>
         <param name="completionOption">
@@ -565,7 +606,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete based on the <paramref name="completionOption" /> parameter after the part or all of the response (including content) is read.</para>
@@ -574,6 +614,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send a GET request to the specified Uri with an HTTP completion option and a cancellation token as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="requestUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uri the request is sent to.</param>
         <param name="completionOption">
@@ -604,7 +649,6 @@
         <Parameter Name="requestUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the whole response body is read. </para>
@@ -613,6 +657,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send a GET request to the specified Uri and return the response body as a byte array in an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="requestUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uri the request is sent to.</param>
       </Docs>
@@ -639,7 +688,6 @@
         <Parameter Name="requestUri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the whole response body is read.</para>
@@ -648,6 +696,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send a GET request to the specified Uri and return the response body as a byte array in an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="requestUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uri the request is sent to.</param>
       </Docs>
@@ -674,7 +727,6 @@
         <Parameter Name="requestUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the whole response body is read. This method does not buffer the stream.</para>
@@ -683,6 +735,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send a GET request to the specified Uri and return the response body as a stream in an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="requestUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uri the request is sent to.</param>
       </Docs>
@@ -709,7 +766,6 @@
         <Parameter Name="requestUri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the whole response body is read. This method does not buffer the stream.</para>
@@ -718,6 +774,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send a GET request to the specified Uri and return the response body as a stream in an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="requestUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uri the request is sent to.</param>
       </Docs>
@@ -744,7 +805,6 @@
         <Parameter Name="requestUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the whole response body is read.</para>
@@ -753,6 +813,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send a GET request to the specified Uri and return the response body as a string in an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="requestUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uri the request is sent to.</param>
       </Docs>
@@ -779,7 +844,6 @@
         <Parameter Name="requestUri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the whole response body is read.</para>
@@ -788,6 +852,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send a GET request to the specified Uri and return the response body as a string in an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="requestUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uri the request is sent to.</param>
       </Docs>
@@ -829,7 +898,6 @@
         <Parameter Name="content" Type="System.Net.Http.HttpContent" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the whole response (including content) is read.</para>
@@ -838,6 +906,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send a POST request to the specified Uri as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="requestUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uri the request is sent to.</param>
         <param name="content">
@@ -859,7 +932,6 @@
         <Parameter Name="content" Type="System.Net.Http.HttpContent" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the whole response (including content) is read.</para>
@@ -868,6 +940,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send a POST request to the specified Uri as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="requestUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uri the request is sent to.</param>
         <param name="content">
@@ -890,7 +967,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the whole response (including content) is read.</para>
@@ -899,6 +975,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send a POST request with a cancellation token as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="requestUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uri the request is sent to.</param>
         <param name="content">
@@ -923,7 +1004,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the whole response (including content) is read.</para>
@@ -932,6 +1012,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send a POST request with a cancellation token as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="requestUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uri the request is sent to.</param>
         <param name="content">
@@ -955,7 +1040,6 @@
         <Parameter Name="content" Type="System.Net.Http.HttpContent" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the whole response (including content) is read.</para>
@@ -964,6 +1048,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send a PUT request to the specified Uri as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="requestUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uri the request is sent to.</param>
         <param name="content">
@@ -985,7 +1074,6 @@
         <Parameter Name="content" Type="System.Net.Http.HttpContent" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the whole response (including content) is read.</para>
@@ -994,6 +1082,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send a PUT request to the specified Uri as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="requestUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uri the request is sent to.</param>
         <param name="content">
@@ -1016,7 +1109,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the whole response (including content) is read.</para>
@@ -1025,6 +1117,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send a PUT request with a cancellation token as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="requestUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uri the request is sent to.</param>
         <param name="content">
@@ -1049,7 +1146,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the whole response (including content) is read.</para>
@@ -1058,6 +1154,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send a PUT request with a cancellation token as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="requestUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The Uri the request is sent to.</param>
         <param name="content">
@@ -1080,7 +1181,6 @@
         <Parameter Name="request" Type="System.Net.Http.HttpRequestMessage" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete once the entire response including content is read.</para>
@@ -1089,6 +1189,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send an HTTP request as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="request">
           <attribution license="cc4" from="Microsoft" modified="false" />The HTTP request message to send.</param>
       </Docs>
@@ -1108,7 +1213,6 @@
         <Parameter Name="completionOption" Type="System.Net.Http.HttpCompletionOption" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. Depending on the value of the <paramref name="completionOption" /> parameter, the returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete as soon as a response is available or the entire response including content is read.</para>
@@ -1117,6 +1221,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send an HTTP request as an asynchronous operation. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="request">
           <attribution license="cc4" from="Microsoft" modified="false" />The HTTP request message to send.</param>
         <param name="completionOption">
@@ -1138,7 +1247,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete once the entire response including content is read.</para>
@@ -1147,6 +1255,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send an HTTP request as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="request">
           <attribution license="cc4" from="Microsoft" modified="false" />The HTTP request message to send.</param>
         <param name="cancellationToken">
@@ -1169,7 +1282,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. Depending on the value of the <paramref name="completionOption" /> parameter, the returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete as soon as a response is available or the entire response including content is read.</para>
@@ -1178,6 +1290,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send an HTTP request as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="request">
           <attribution license="cc4" from="Microsoft" modified="false" />The HTTP request message to send.</param>
         <param name="completionOption">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpClientHandler.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpClientHandler.xml
index 25f6495f2ff..eb2d8d6735a 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpClientHandler.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpClientHandler.xml
@@ -295,7 +295,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation is does not block. It returns an instance of <see cref="T:System.Threading.Tasks.Task`1" /> to represent the asynchronous operation. When the operation completes, <see cref="P:System.Threading.Tasks.Task`1.Result" /> contains the response message.</para>
@@ -304,6 +303,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of  <see cref="T:System.Net.Http.HttpResponseMessage" /> based on the information provided in the <see cref="T:System.Net.Http.HttpRequestMessage" /> as an operation that will not block.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="request">
           <attribution license="cc4" from="Microsoft" modified="false" />The HTTP request message.</param>
         <param name="cancellationToken">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpContent.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpContent.xml
index e4057664172..27f1638ef25 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpContent.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpContent.xml
@@ -52,7 +52,6 @@
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after all of the content has been written to the stream object passed as the <paramref name="stream" /> parameter.</para>
@@ -61,6 +60,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serialize the HTTP content into a stream of bytes and copies it to the stream object provided as the <paramref name="stream" /> parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The target stream.</param>
       </Docs>
@@ -80,7 +84,6 @@
         <Parameter Name="context" Type="System.Net.TransportContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after all of the content has been written to the stream object passed as the <paramref name="stream" /> parameter.</para>
@@ -89,6 +92,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serialize the HTTP content into a stream of bytes and copies it to the stream object provided as the <paramref name="stream" /> parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The target stream.</param>
         <param name="context">
@@ -115,7 +123,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after all of the content has been written to the memory stream.</para>
@@ -126,6 +133,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serialize the HTTP content to a memory stream as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Dispose">
@@ -204,7 +216,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task" /> object will complete after all of the content has been serialized to the memory buffer.</para>
@@ -214,6 +225,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serialize the HTTP content to a memory buffer as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="LoadIntoBufferAsync">
@@ -238,7 +254,6 @@
         <Parameter Name="maxBufferSize" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task" />  object will complete after all of the content has been serialized to the memory buffer.</para>
@@ -249,6 +264,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serialize the HTTP content to a memory buffer as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="maxBufferSize">
           <attribution license="cc4" from="Microsoft" modified="false" />The maximum size, in bytes, of the buffer to use.</param>
       </Docs>
@@ -273,7 +293,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after all of the content has been written as a byte array.</para>
@@ -283,6 +302,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serialize the HTTP content to a byte array as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadAsStreamAsync">
@@ -305,7 +329,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after all of the stream that represents content has been read. </para>
@@ -315,6 +338,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serialize the HTTP content and return a stream that represents the content as an asynchronous operation. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadAsStringAsync">
@@ -337,7 +365,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after all of the content has been written as a string.</para>
@@ -347,6 +374,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serialize the HTTP content to a string as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SerializeToStreamAsync">
@@ -364,7 +396,6 @@
         <Parameter Name="context" Type="System.Net.TransportContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after all of the content has been serialized to the stream object passed in the <paramref name="stream" /> parameter.</para>
@@ -373,6 +404,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serialize the HTTP content to a stream as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The target stream.</param>
         <param name="context">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpMessageHandler.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpMessageHandler.xml
index 12521cece54..80546408998 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpMessageHandler.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpMessageHandler.xml
@@ -121,7 +121,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete once the entire response including content is read.</para>
@@ -131,6 +130,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send an HTTP request as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="request">
           <attribution license="cc4" from="Microsoft" modified="false" />The HTTP request message to send.</param>
         <param name="cancellationToken">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpMessageInvoker.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpMessageInvoker.xml
index 651128890cf..7940495a9a7 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpMessageInvoker.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpMessageInvoker.xml
@@ -126,7 +126,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete once the entire response including content is read.</para>
@@ -136,6 +135,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send an HTTP request as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="request">
           <attribution license="cc4" from="Microsoft" modified="false" />The HTTP request message to send.</param>
         <param name="cancellationToken">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpMethod.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpMethod.xml
index 30ac2ee769c..b25c777aed3 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpMethod.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpMethod.xml
@@ -81,12 +81,16 @@
         <Parameter Name="other" Type="System.Net.Http.HttpMethod" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Net.Http.HttpMethod" /> is equal to the current <see cref="T:System.Object" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if the specified object is equal to the current object; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The HTTP method to compare with the current object.</param>
       </Docs>
@@ -105,12 +109,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Object" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if the specified object is equal to the current object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current object.</param>
       </Docs>
@@ -146,7 +154,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A hash code is a numeric value that is used to identify an object during equality testing. It can also serve as an index for an object in a collection.The <see cref="M:System.Net.Http.HttpMethod.GetHashCode" /> method is suitable for use in hashing algorithms and data structures such as a hash table. </para>
@@ -155,6 +162,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for this type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Int32" />.</para>
+          <para>A hash code for the current <see cref="T:System.Object" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Head">
@@ -210,12 +222,16 @@
         <Parameter Name="right" Type="System.Net.Http.HttpMethod" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The equality operator for comparing two <see cref="T:System.Net.Http.HttpMethod" /> objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if the specified <paramref name="left" /> and <paramref name="right" /> parameters are equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The left <see cref="T:System.Net.Http.HttpMethod" /> to an equality operator.</param>
         <param name="right">
@@ -237,12 +253,16 @@
         <Parameter Name="right" Type="System.Net.Http.HttpMethod" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The inequality operator for comparing two <see cref="T:System.Net.Http.HttpMethod" /> objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if the specified <paramref name="left" /> and <paramref name="right" /> parameters are inequal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The left <see cref="T:System.Net.Http.HttpMethod" /> to an inequality operator.</param>
         <param name="right">
@@ -318,12 +338,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.String" />.</para>
+          <para>A string representing the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Trace">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpRequestMessage.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpRequestMessage.xml
index b8729f6d5ab..e631dc48d1c 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpRequestMessage.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpRequestMessage.xml
@@ -272,12 +272,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.String" />.</para>
+          <para>A string representation of the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Version">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpResponseMessage.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpResponseMessage.xml
index 4807f2cba43..9156b766351 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpResponseMessage.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/HttpResponseMessage.xml
@@ -140,7 +140,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.Http.HttpResponseMessage.EnsureSuccessStatusCode" /> method throws an exception if the HTTP response was unsuccessful. If the <see cref="P:System.Net.Http.HttpResponseMessage.Content" /> is not null, this method will also call <see cref="M:System.Net.Http.HttpResponseMessage.Dispose" /> to free managed and unmanaged resources. </para>
@@ -149,6 +148,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Throws an exception if the <see cref="P:System.Net.Http.HttpResponseMessage.IsSuccessStatusCode" /> property for the HTTP response is false.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Net.Http.HttpResponseMessage" />.</para>
+          <para>The HTTP response message if the call is successful.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Headers">
@@ -261,12 +265,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.String" />.</para>
+          <para>A string representation of the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Version">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/MessageProcessingHandler.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/MessageProcessingHandler.xml
index b3899b6333a..7977bdfb0d3 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/MessageProcessingHandler.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/MessageProcessingHandler.xml
@@ -73,7 +73,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An application would override this method to implement custom processing of the HTTP request message before it is sent to the server.</para>
@@ -82,6 +81,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs processing on each request sent to the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Net.Http.HttpRequestMessage" />.</para>
+          <para>The HTTP request message that was processed.</para>
+        </returns>
         <param name="request">
           <attribution license="cc4" from="Microsoft" modified="false" />The HTTP request message to process.</param>
         <param name="cancellationToken">
@@ -103,7 +107,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An application would override this method to implement custom processing of the HTTP response message after it is received from the server.</para>
@@ -112,6 +115,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Perform processing on each response from the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Net.Http.HttpResponseMessage" />.</para>
+          <para>The HTTP response message that was processed.</para>
+        </returns>
         <param name="response">
           <attribution license="cc4" from="Microsoft" modified="false" />The HTTP response message to process.</param>
         <param name="cancellationToken">
@@ -141,7 +149,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation does not block. This overridable implementation of <see cref="M:System.Net.Http.MessageProcessingHandler.SendAsync(System.Net.Http.HttpRequestMessage,System.Threading.CancellationToken)" /> method forwards the HTTP request to the inner handler to send to the server as an asynchronous operation.</para>
@@ -150,6 +157,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends an HTTP request to the inner handler to send to the server as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="request">
           <attribution license="cc4" from="Microsoft" modified="false" />The HTTP request message to send to the server.</param>
         <param name="cancellationToken">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/MultipartContent.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/MultipartContent.xml
index 84d321efe20..a70b5d53409 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/MultipartContent.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/MultipartContent.xml
@@ -142,7 +142,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The foreach statement of the C# language (For Each in Visual Basic) hides the complexity of the enumerators. Therefore, using foreach is recommended, instead of directly manipulating the enumerator.</para>
@@ -153,6 +152,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the collection of <see cref="T:System.Net.Http.HttpContent" /> objects that get serialized using the multipart/* content type specification..</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Collections.Generic.IEnumerator`1" />.</para>
+          <para>An object that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SerializeToStreamAsync">
@@ -178,7 +182,6 @@
         <Parameter Name="context" Type="System.Net.TransportContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after all of the content has been serialized to the target stream.</para>
@@ -187,6 +190,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serialize the multipart HTTP content to a stream as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The target stream.</param>
         <param name="context">
@@ -205,12 +213,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The explicit implementation of the <see cref="M:System.Net.Http.MultipartContent.GetEnumerator" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Collections.IEnumerator" />.</para>
+          <para>An object that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryComputeLength">
diff --git a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/StreamContent.xml b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/StreamContent.xml
index 58d6f802672..ba6f26abefa 100644
--- a/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/StreamContent.xml
+++ b/mcs/class/System.Net.Http/Documentation/en/System.Net.Http/StreamContent.xml
@@ -73,7 +73,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after all of the content has been written to the memory stream.</para>
@@ -83,6 +82,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Write the HTTP stream content to a memory stream as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Dispose">
@@ -126,7 +130,6 @@
         <Parameter Name="context" Type="System.Net.TransportContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task" /> object will complete after all of the content has been serialized to the target stream.</para>
@@ -135,6 +138,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serialize the HTTP content to a stream as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The target stream.</param>
         <param name="context">
diff --git a/mcs/class/System.Numerics/Documentation/en/System.Numerics/BigInteger.xml b/mcs/class/System.Numerics/Documentation/en/System.Numerics/BigInteger.xml
index 1664b50b609..239106ef4cc 100644
--- a/mcs/class/System.Numerics/Documentation/en/System.Numerics/BigInteger.xml
+++ b/mcs/class/System.Numerics/Documentation/en/System.Numerics/BigInteger.xml
@@ -385,7 +385,6 @@
         <Parameter Name="value" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The absolute value of a number is that number without its sign, as shown in the following table.</para>
@@ -429,6 +428,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the absolute value of a <see cref="T:System.Numerics.BigInteger" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The absolute value of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A number.</param>
       </Docs>
@@ -448,7 +451,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Languages that do not support operator overloading or custom operators can use the <see cref="M:System.Numerics.BigInteger.Add(System.Numerics.BigInteger,System.Numerics.BigInteger)" /> method to perform addition using <see cref="T:System.Numerics.BigInteger" /> values.</para>
@@ -459,6 +461,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds two <see cref="T:System.Numerics.BigInteger" /> values and returns the result.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of <paramref name="left" /> and <paramref name="right" />.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to add.</param>
         <param name="right">
@@ -480,7 +486,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Although the <see cref="T:System.Numerics.BigInteger" /> type has no fixed range, comparisons of <see cref="T:System.Numerics.BigInteger" /> values are not characterized by the lack of precision that characterizes the comparison of floating-point numbers. The following example compares two <see cref="T:System.Numerics.BigInteger" /> values that differ by one and that each have 1,896 digits. The <see cref="M:System.Numerics.BigInteger.Compare(System.Numerics.BigInteger,System.Numerics.BigInteger)" /> method correctly reports that the two values are not equal.</para>
@@ -490,6 +495,49 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Numerics.BigInteger" /> values and returns an integer that indicates whether the first value is less than, equal to, or greater than the second value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative values of <paramref name="left" /> and <paramref name="right" />, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value</para>
+                </term>
+                <description>
+                  <para>Condition</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero</para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="left" /> is less than <paramref name="right" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="left" /> equals <paramref name="right" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero</para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="left" /> is greater than <paramref name="right" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -510,7 +558,6 @@
         <Parameter Name="other" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="other" /> is a <see cref="T:System.Byte" />, <see cref="T:System.Int16" />, <see cref="T:System.Int32" />, <see cref="T:System.SByte" />, <see cref="T:System.UInt16" />, or <see cref="T:System.UInt32" /> value, it is implicitly converted to an <see cref="T:System.Int64" /> value when the <see cref="M:System.Numerics.BigInteger.CompareTo(System.Int64)" /> method is called.</para>
@@ -519,6 +566,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this instance to a signed 64-bit integer and returns an integer that indicates whether the value of this instance is less than, equal to, or greater than the value of the signed 64-bit integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer value that indicates the relationship of this instance to <paramref name="other" />, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero</para>
+              </term>
+              <description>
+                <para>The current instance is less than <paramref name="other" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>The current instance equals <paramref name="other" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero</para>
+              </term>
+              <description>
+                <para>The current instance is greater than <paramref name="other" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The signed 64-bit integer to compare.</param>
       </Docs>
@@ -537,7 +624,6 @@
         <Parameter Name="other" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload of the <see cref="Overload:System.Numerics.BigInteger.CompareTo" /> method implements the <see cref="M:System.IComparable`1.CompareTo(`0)" /> method. It is used by generic collection objects to order the items in the collection.</para>
@@ -546,6 +632,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this instance to a second <see cref="T:System.Numerics.BigInteger" /> and returns an integer that indicates whether the value of this instance is less than, equal to, or greater than the value of the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer value that indicates the relationship of this instance to <paramref name="other" />, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero</para>
+              </term>
+              <description>
+                <para>The current instance is less than <paramref name="other" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>The current instance equals <paramref name="other" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero</para>
+              </term>
+              <description>
+                <para>The current instance is greater than <paramref name="other" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare.</param>
       </Docs>
@@ -564,7 +690,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload of the <see cref="Overload:System.Numerics.BigInteger.CompareTo" /> method implements the <see cref="M:System.IComparable.CompareTo(System.Object)" /> method. It is used by non-generic collection objects to order the items in the collection.</para>
@@ -582,6 +707,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this instance to a specified object and returns an integer that indicates whether the value of this instance is less than, equal to, or greater than the value of the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relationship of the current instance to the <paramref name="obj" /> parameter, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero</para>
+              </term>
+              <description>
+                <para>The current instance is less than <paramref name="obj" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>The current instance equals <paramref name="obj" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero</para>
+              </term>
+              <description>
+                <para>The current instance is greater than <paramref name="obj" />, or the <paramref name="obj" /> parameter is null. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare.</param>
       </Docs>
@@ -605,12 +770,51 @@
         <Parameter Name="other" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this instance to an unsigned 64-bit integer and returns an integer that indicates whether the value of this instance is less than, equal to, or greater than the value of the unsigned 64-bit integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative value of this instance and <paramref name="other" />, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero</para>
+              </term>
+              <description>
+                <para>The current instance is less than <paramref name="other" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>The current instance equals <paramref name="other" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero</para>
+              </term>
+              <description>
+                <para>The current instance is greater than <paramref name="other" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The unsigned 64-bit integer to compare.</param>
       </Docs>
@@ -630,7 +834,6 @@
         <Parameter Name="divisor" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.Divide(System.Numerics.BigInteger,System.Numerics.BigInteger)" /> method performs integer division; any remainder that results from the division is discarded. To perform integer division while preserving the remainder, call the <see cref="M:System.Numerics.BigInteger.DivRem(System.Numerics.BigInteger,System.Numerics.BigInteger,System.Numerics.BigInteger@)" /> method. To retrieve only the remainder, call the <see cref="M:System.Numerics.BigInteger.Remainder(System.Numerics.BigInteger,System.Numerics.BigInteger)" /> method.</para>
@@ -640,6 +843,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Divides one <see cref="T:System.Numerics.BigInteger" /> value by another and returns the result.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The quotient of the division.</para>
+        </returns>
         <param name="dividend">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to be divided.</param>
         <param name="divisor">
@@ -684,7 +891,6 @@
         <Parameter Name="other" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="other" /> is a <see cref="T:System.Byte" />, <see cref="T:System.Int16" />, <see cref="T:System.Int32" />, <see cref="T:System.SByte" />, <see cref="T:System.UInt16" />, or <see cref="T:System.UInt32" /> value, it is implicitly converted to an <see cref="T:System.Int64" /> value when the method is called.</para>
@@ -694,6 +900,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current instance and a signed 64-bit integer have the same value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the signed 64-bit integer and the current instance have the same value; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The signed 64-bit integer value to compare.</param>
       </Docs>
@@ -712,7 +922,6 @@
         <Parameter Name="other" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method implements the <see cref="T:System.IEquatable`1" /> interface and performs slightly better than <see cref="M:System.Numerics.BigInteger.Equals(System.Object)" /> because it does not have to convert the <paramref name="other" /> parameter to a <see cref="T:System.Numerics.BigInteger" /> object.</para>
@@ -722,6 +931,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current instance and a specified <see cref="T:System.Numerics.BigInteger" /> object have the same value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this <see cref="T:System.Numerics.BigInteger" /> object and <paramref name="other" /> have the same value; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare.</param>
       </Docs>
@@ -740,7 +953,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <paramref name="obj" /> parameter is not a <see cref="T:System.Numerics.BigInteger" /> value, but it is a data type for which an implicit conversion is defined, the <see cref="M:System.Numerics.BigInteger.Equals(System.Object)" /> method converts <paramref name="obj" /> to a <see cref="T:System.Numerics.BigInteger" /> value before it performs the comparison. If <paramref name="obj" /> is not a <see cref="T:System.Numerics.BigInteger" /> value and cannot be implicitly converted to <see cref="T:System.Numerics.BigInteger" />, the method returns false. If no conversion from <paramref name="obj" /> to a <see cref="T:System.Numerics.BigInteger" /> value exists, the method does not throw an exception; instead, it returns false.</para>
@@ -750,6 +962,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current instance and a specified object have the same value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="obj" /> parameter is a <see cref="T:System.Numerics.BigInteger" /> object or a type capable of implicit conversion to a <see cref="T:System.Numerics.BigInteger" /> value, and its value is equal to the value of the current <see cref="T:System.Numerics.BigInteger" /> object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare. </param>
       </Docs>
@@ -773,7 +989,6 @@
         <Parameter Name="other" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To determine the relationship between the two objects instead of just testing for equality, call the <see cref="M:System.Numerics.BigInteger.CompareTo(System.UInt64)" /> method.</para>
@@ -782,6 +997,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current instance and an unsigned 64-bit integer have the same value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current instance and the unsigned 64-bit integer have the same value; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The unsigned 64-bit integer to compare.</param>
       </Docs>
@@ -798,12 +1017,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for the current <see cref="T:System.Numerics.BigInteger" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GreatestCommonDivisor">
@@ -821,7 +1043,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The greatest common divisor is the largest number into which the two <see cref="T:System.Numerics.BigInteger" /> values can be divided without returning a remainder.</para>
@@ -835,6 +1056,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds the greatest common divisor of two <see cref="T:System.Numerics.BigInteger" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The greatest common divisor of <paramref name="left" /> and <paramref name="right" />.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value.</param>
         <param name="right">
@@ -948,7 +1173,6 @@
         <Parameter Name="value" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="value" /> parameter is specified as a base 10 number.</para>
@@ -1000,6 +1224,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the natural (base e) logarithm of a specified number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The natural (base e) logarithm of <paramref name="value" />, as shown in the table in the Remarks section.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The number whose logarithm is to be found.</param>
       </Docs>
@@ -1019,7 +1247,6 @@
         <Parameter Name="baseValue" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="value" /> and <paramref name="baseValue" /> parameters are specified as base 10 numbers.</para>
@@ -1200,6 +1427,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the logarithm of a specified number in a specified base.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The base <paramref name="baseValue" /> logarithm of <paramref name="value" />, as shown in the table in the Remarks section.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A number whose logarithm is to be found.</param>
         <param name="baseValue">
@@ -1220,7 +1451,6 @@
         <Parameter Name="value" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="value" /> parameter is specified as a base 10 number.</para>
@@ -1270,6 +1500,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the base 10 logarithm of a specified number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The base 10 logarithm of <paramref name="value" />, as shown in the table in the Remarks section.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A number whose logarithm is to be found.</param>
       </Docs>
@@ -1289,7 +1523,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method corresponds to the <see cref="M:System.Math.Max(System.Int32,System.Int32)" /> method for primitive numeric types.</para>
@@ -1298,6 +1531,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the larger of two <see cref="T:System.Numerics.BigInteger" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <paramref name="left" /> or <paramref name="right" /> parameter, whichever is larger.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -1319,7 +1556,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method corresponds to the <see cref="M:System.Math.Min(System.Int32,System.Int32)" /> method for primitive numeric types.</para>
@@ -1328,6 +1564,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the smaller of two <see cref="T:System.Numerics.BigInteger" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <paramref name="left" /> or <paramref name="right" /> parameter, whichever is smaller.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -1372,7 +1612,6 @@
         <Parameter Name="modulus" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.ModPow(System.Numerics.BigInteger,System.Numerics.BigInteger,System.Numerics.BigInteger)" /> method evaluates the following expression:</para>
@@ -1385,6 +1624,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs modulus division on a number raised to the power of another number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The remainder after dividing <paramref name="value" /><superscript>exponent</superscript> by <paramref name="modulus" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The number to raise to the <paramref name="exponent" /> power.</param>
         <param name="exponent">
@@ -1408,7 +1651,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.Multiply(System.Numerics.BigInteger,System.Numerics.BigInteger)" /> method is implemented for languages that do not support operator overloading. Its behavior is identical to multiplication using the multiplication operator. In addition, the <see cref="M:System.Numerics.BigInteger.Multiply(System.Numerics.BigInteger,System.Numerics.BigInteger)" /> method is a useful substitute for the multiplication operator when instantiating a <see cref="T:System.Numerics.BigInteger" /> variable by assigning it a product that results from multiplication, as shown in the following example.</para>
@@ -1419,6 +1661,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the product of two <see cref="T:System.Numerics.BigInteger" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The product of the <paramref name="left" /> and <paramref name="right" /> parameters.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first number to multiply.</param>
         <param name="right">
@@ -1439,7 +1685,6 @@
         <Parameter Name="value" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Negation obtains the additive inverse of a number. The additive inverse of a number is a number that produces a value of zero when it is added to the original number.</para>
@@ -1450,6 +1695,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Negates a specified <see cref="T:System.Numerics.BigInteger" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of the <paramref name="value" /> parameter multiplied by negative one (-1).</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to negate.</param>
       </Docs>
@@ -1491,7 +1740,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_Addition(System.Numerics.BigInteger,System.Numerics.BigInteger)" /> method defines the addition operation for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -1502,6 +1750,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the values of two specified <see cref="T:System.Numerics.BigInteger" /> objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of <paramref name="left" /> and <paramref name="right" />.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to add.</param>
         <param name="right">
@@ -1523,7 +1775,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_BitwiseAnd(System.Numerics.BigInteger,System.Numerics.BigInteger)" /> method defines the bitwise And operation for <see cref="T:System.Numerics.BigInteger" /> values. The bitwise And operation sets a result bit only if the corresponding bits in <paramref name="left" /> and <paramref name="right" /> are also set, as shown in the following table.</para>
@@ -1594,6 +1845,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a bitwise And operation on two <see cref="T:System.Numerics.BigInteger" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of the bitwise And operation.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value.</param>
         <param name="right">
@@ -1615,7 +1870,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_BitwiseOr(System.Numerics.BigInteger,System.Numerics.BigInteger)" /> method defines the bitwise Or operation for <see cref="T:System.Numerics.BigInteger" /> values. The bitwise Or operation sets a result bit only if either or both of the corresponding bits in <paramref name="left" /> and <paramref name="right" /> are set, as shown in the following table.</para>
@@ -1686,6 +1940,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a bitwise Or operation on two <see cref="T:System.Numerics.BigInteger" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of the bitwise Or operation.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value.</param>
         <param name="right">
@@ -1706,7 +1964,6 @@
         <Parameter Name="value" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_Decrement(System.Numerics.BigInteger)" /> method defines the decrement operation for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -1719,6 +1976,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decrements a <see cref="T:System.Numerics.BigInteger" /> value by 1.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the <paramref name="value" /> parameter decremented by 1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to decrement.</param>
       </Docs>
@@ -1738,7 +1999,6 @@
         <Parameter Name="divisor" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_Division(System.Numerics.BigInteger,System.Numerics.BigInteger)" /> method defines the division operation for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -1749,6 +2009,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Divides a specified <see cref="T:System.Numerics.BigInteger" /> value by another specified <see cref="T:System.Numerics.BigInteger" /> value by using integer division.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The integral result of the division.</para>
+        </returns>
         <param name="dividend">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to be divided.</param>
         <param name="divisor">
@@ -1770,7 +2034,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_Equality(System.Int64,System.Numerics.BigInteger)" /> method defines the equality comparison operation for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -1782,6 +2045,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a signed long integer value and a <see cref="T:System.Numerics.BigInteger" /> value are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="left" /> and <paramref name="right" /> parameters have the same value; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -1803,7 +2070,6 @@
         <Parameter Name="right" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_Equality(System.Numerics.BigInteger,System.Int64)" /> method defines the equality comparison operation for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -1815,6 +2081,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a <see cref="T:System.Numerics.BigInteger" /> value and a signed long integer value are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="left" /> and <paramref name="right" /> parameters have the same value; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -1836,7 +2106,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_Equality(System.Numerics.BigInteger,System.Numerics.BigInteger)" /> method defines the operation of the equality operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -1847,6 +2116,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the values of two <see cref="T:System.Numerics.BigInteger" /> objects are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="left" /> and <paramref name="right" /> parameters have the same value; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -1873,7 +2146,6 @@
         <Parameter Name="right" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_Equality(System.Numerics.BigInteger,System.UInt64)" /> method defines the equality comparison operation for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -1884,6 +2156,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a <see cref="T:System.Numerics.BigInteger" /> value and an unsigned long integer value are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="left" /> and <paramref name="right" /> parameters have the same value; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -1910,7 +2186,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_Equality(System.UInt64,System.Numerics.BigInteger)" /> method defines the equality comparison operation for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -1921,6 +2196,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether an unsigned long integer value and a <see cref="T:System.Numerics.BigInteger" /> value are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="left" /> and <paramref name="right" /> parameters have the same value; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -1942,7 +2221,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The result of a bitwise exclusive Or operation is true if the values of the two bits are different; otherwise, it is false. The following table illustrates the exclusive Or operation.</para>
@@ -2013,6 +2291,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a bitwise exclusive Or (XOr) operation on two <see cref="T:System.Numerics.BigInteger" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of the bitwise Or operation.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value.</param>
         <param name="right">
@@ -2334,7 +2616,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_GreaterThan(System.Int64,System.Numerics.BigInteger)" /> method defines the operation of the greater than operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -2347,6 +2628,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a 64-bit signed integer is greater than a <see cref="T:System.Numerics.BigInteger" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is greater than <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -2368,7 +2653,6 @@
         <Parameter Name="right" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_GreaterThan(System.Int64,System.Numerics.BigInteger)" /> method defines the operation of the greater than operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -2381,6 +2665,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a <see cref="T:System.Numerics.BigInteger" /> is greater than a 64-bit signed integer value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is greater than <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -2402,7 +2690,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_GreaterThan(System.Numerics.BigInteger,System.Numerics.BigInteger)" /> method defines the operation of the greater than operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -2414,6 +2701,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a <see cref="T:System.Numerics.BigInteger" /> value is greater than another <see cref="T:System.Numerics.BigInteger" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is greater than <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -2440,7 +2731,6 @@
         <Parameter Name="right" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_GreaterThan(System.Int64,System.Numerics.BigInteger)" /> method defines the operation of the greater than operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -2452,6 +2742,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a <see cref="T:System.Numerics.BigInteger" /> value is greater than a 64-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is greater than <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -2478,7 +2772,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_GreaterThan(System.UInt64,System.Numerics.BigInteger)" /> method defines the operation of the greater than operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -2490,6 +2783,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a <see cref="T:System.Numerics.BigInteger" /> value is greater than a 64-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is greater than <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -2511,7 +2808,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_GreaterThanOrEqual(System.Numerics.BigInteger,System.Numerics.BigInteger)" /> method defines the operation of the greater than or equal to operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -2524,6 +2820,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a 64-bit signed integer is greater than or equal to a <see cref="T:System.Numerics.BigInteger" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is greater than <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -2545,7 +2845,6 @@
         <Parameter Name="right" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_GreaterThanOrEqual(System.Numerics.BigInteger,System.Numerics.BigInteger)" /> method defines the operation of the greater than or equal to operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -2558,6 +2857,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a <see cref="T:System.Numerics.BigInteger" /> value is greater than or equal to a 64-bit signed integer value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is greater than <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -2579,7 +2882,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_GreaterThanOrEqual(System.Numerics.BigInteger,System.Numerics.BigInteger)" /> method defines the operation of the greater than or equal to operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -2591,6 +2893,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a <see cref="T:System.Numerics.BigInteger" /> value is greater than or equal to another <see cref="T:System.Numerics.BigInteger" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is greater than <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -2617,7 +2923,6 @@
         <Parameter Name="right" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_GreaterThanOrEqual(System.Numerics.BigInteger,System.Numerics.BigInteger)" /> method defines the operation of the greater than or equal to operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -2629,6 +2934,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a <see cref="T:System.Numerics.BigInteger" /> value is greater than or equal to a 64-bit unsigned integer value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is greater than <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -2655,7 +2964,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_GreaterThanOrEqual(System.Numerics.BigInteger,System.Numerics.BigInteger)" /> method defines the operation of the greater than or equal to operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -2667,6 +2975,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a 64-bit unsigned integer is greater than or equal to a <see cref="T:System.Numerics.BigInteger" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is greater than <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -2867,7 +3179,6 @@
         <Parameter Name="value" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_Increment(System.Numerics.BigInteger)" /> method defines the increment operation for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -2880,6 +3191,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Increments a <see cref="T:System.Numerics.BigInteger" /> value by 1.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the <paramref name="value" /> parameter incremented by 1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to increment.</param>
       </Docs>
@@ -2899,7 +3214,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_Inequality(System.Int64,System.Numerics.BigInteger)" /> method defines the operation of the inequality operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -2919,6 +3233,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a 64-bit signed integer and a <see cref="T:System.Numerics.BigInteger" /> value are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> and <paramref name="right" /> are not equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -2940,7 +3258,6 @@
         <Parameter Name="right" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_Inequality(System.Int64,System.Numerics.BigInteger)" /> method defines the operation of the inequality operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -2960,6 +3277,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a <see cref="T:System.Numerics.BigInteger" /> value and a 64-bit signed integer are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> and <paramref name="right" /> are not equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -2981,7 +3302,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_Inequality(System.Int64,System.Numerics.BigInteger)" /> method defines the operation of the inequality operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -3000,6 +3320,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether two <see cref="T:System.Numerics.BigInteger" /> objects have different values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> and <paramref name="right" /> are not equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -3026,7 +3350,6 @@
         <Parameter Name="right" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_Inequality(System.Int64,System.Numerics.BigInteger)" /> method defines the operation of the inequality operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -3045,6 +3368,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a <see cref="T:System.Numerics.BigInteger" /> value and a 64-bit unsigned integer are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> and <paramref name="right" /> are not equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -3071,7 +3398,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_Inequality(System.Int64,System.Numerics.BigInteger)" /> method defines the operation of the inequality operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -3090,6 +3416,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a 64-bit unsigned integer and a <see cref="T:System.Numerics.BigInteger" /> value are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> and <paramref name="right" /> are not equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -3111,7 +3441,6 @@
         <Parameter Name="shift" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_LeftShift(System.Numerics.BigInteger,System.Int32)" /> method defines the operation of the bitwise left-shift operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -3126,6 +3455,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Shifts a <see cref="T:System.Numerics.BigInteger" /> value a specified number of bits to the left.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that has been shifted to the left by the specified number of bits.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value whose bits are to be shifted.</param>
         <param name="shift">
@@ -3147,7 +3480,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_LessThan(System.Int64,System.Numerics.BigInteger)" /> method defines the operation of the less than operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -3160,6 +3492,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a 64-bit signed integer is less than a <see cref="T:System.Numerics.BigInteger" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is less than <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -3181,7 +3517,6 @@
         <Parameter Name="right" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_LessThan(System.Int64,System.Numerics.BigInteger)" /> method defines the operation of the less than operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -3194,6 +3529,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a <see cref="T:System.Numerics.BigInteger" /> value is less than a 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is less than <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -3215,7 +3554,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_LessThan(System.Int64,System.Numerics.BigInteger)" /> method defines the operation of the less than operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -3227,6 +3565,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a <see cref="T:System.Numerics.BigInteger" /> value is less than another <see cref="T:System.Numerics.BigInteger" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is less than <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -3253,7 +3595,6 @@
         <Parameter Name="right" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_LessThan(System.Int64,System.Numerics.BigInteger)" /> method defines the operation of the less than operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -3265,6 +3606,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a <see cref="T:System.Numerics.BigInteger" /> value is less than a 64-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is less than <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -3291,7 +3636,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_LessThan(System.Int64,System.Numerics.BigInteger)" /> method defines the operation of the less than operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -3303,6 +3647,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a 64-bit unsigned integer is less than a <see cref="T:System.Numerics.BigInteger" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is less than <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -3324,7 +3672,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_LessThanOrEqual(System.Int64,System.Numerics.BigInteger)" /> method defines the operation of the less than or equal to operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -3337,6 +3684,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a 64-bit signed integer is less than or equal to a <see cref="T:System.Numerics.BigInteger" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is less than or equal to <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -3358,7 +3709,6 @@
         <Parameter Name="right" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_LessThanOrEqual(System.Int64,System.Numerics.BigInteger)" /> method defines the operation of the less than or equal to operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -3371,6 +3721,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a <see cref="T:System.Numerics.BigInteger" /> value is less than or equal to a 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is less than or equal to <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -3392,7 +3746,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_LessThanOrEqual(System.Int64,System.Numerics.BigInteger)" /> method defines the operation of the less than or equal to operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -3404,6 +3757,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a <see cref="T:System.Numerics.BigInteger" /> value is less than or equal to another <see cref="T:System.Numerics.BigInteger" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is less than or equal to <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -3430,7 +3787,6 @@
         <Parameter Name="right" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_LessThanOrEqual(System.Int64,System.Numerics.BigInteger)" /> method defines the operation of the less than or equal to operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -3442,6 +3798,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a <see cref="T:System.Numerics.BigInteger" /> value is less than or equal to a 64-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is less than or equal to <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -3468,7 +3828,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_LessThanOrEqual(System.Int64,System.Numerics.BigInteger)" /> method defines the operation of the less than or equal to operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -3480,6 +3839,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a 64-bit unsigned integer is less than or equal to a <see cref="T:System.Numerics.BigInteger" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is less than or equal to <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -3501,7 +3864,6 @@
         <Parameter Name="divisor" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_Modulus(System.Numerics.BigInteger,System.Numerics.BigInteger)" /> method defines the operation of the modulus operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -3513,6 +3875,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the remainder that results from division with two specified <see cref="T:System.Numerics.BigInteger" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The remainder that results from the division.</para>
+        </returns>
         <param name="dividend">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to be divided.</param>
         <param name="divisor">
@@ -3534,7 +3900,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_Multiply(System.Numerics.BigInteger,System.Numerics.BigInteger)" /> method defines the operation of the multiplication operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -3544,6 +3909,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Multiplies two specified <see cref="T:System.Numerics.BigInteger" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The product of <paramref name="left" /> and <paramref name="right" />.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to multiply.</param>
         <param name="right">
@@ -3564,7 +3933,6 @@
         <Parameter Name="value" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_OnesComplement(System.Numerics.BigInteger)" /> method defines the operation of the bitwise one's complement operator for <see cref="T:System.Numerics.BigInteger" /> values. The bitwise one's complement operator reverses each bit in a numeric value. That is, bits in <paramref name="value" /> that are 0 are set to 1 in the result, and bits that are 1 are set to 0 in the result. The <see cref="M:System.Numerics.BigInteger.op_OnesComplement(System.Numerics.BigInteger)" /> method enables code such as the following:</para>
@@ -3576,6 +3944,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the bitwise one's complement of a <see cref="T:System.Numerics.BigInteger" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The bitwise one's complement of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer value.</param>
       </Docs>
@@ -3595,7 +3967,6 @@
         <Parameter Name="shift" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_RightShift(System.Numerics.BigInteger,System.Int32)" /> method defines the operation of the bitwise right-shift operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -3608,6 +3979,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Shifts a <see cref="T:System.Numerics.BigInteger" /> value a specified number of bits to the right.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that has been shifted to the right by the specified number of bits.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value whose bits are to be shifted.</param>
         <param name="shift">
@@ -3629,7 +4004,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_Subtraction(System.Numerics.BigInteger,System.Numerics.BigInteger)" /> method defines the operation of the subtraction operator for <see cref="T:System.Numerics.BigInteger" /> values. It enables code such as the following:</para>
@@ -3640,6 +4014,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts a <see cref="T:System.Numerics.BigInteger" /> value from another <see cref="T:System.Numerics.BigInteger" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of subtracting <paramref name="right" /> from <paramref name="left" />.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to subtract from (the minuend).</param>
         <param name="right">
@@ -3660,7 +4038,6 @@
         <Parameter Name="value" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_UnaryNegation(System.Numerics.BigInteger)" /> method defines the operation of the unary negation operator (or the additive inverse operator) for <see cref="T:System.Numerics.BigInteger" /> values. The operation produces a value that results in 0 (zero) when it is added to the original number. Languages that do not support custom operators can call the <see cref="M:System.Numerics.BigInteger.Negate(System.Numerics.BigInteger)" /> method instead.</para>
@@ -3669,6 +4046,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Negates a specified BigInteger value. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of the <paramref name="value" /> parameter multiplied by negative one (-1).</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to negate.</param>
       </Docs>
@@ -3687,7 +4068,6 @@
         <Parameter Name="value" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.op_UnaryPlus(System.Numerics.BigInteger)" /> method defines the operation of the unary positive operator for <see cref="T:System.Numerics.BigInteger" /> values.</para>
@@ -3696,6 +4076,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the <see cref="T:System.Numerics.BigInteger" /> operand. (The sign of the operand is unchanged.)</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the <paramref name="value" /> operand.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer value.</param>
       </Docs>
@@ -3714,7 +4098,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="value" /> parameter should be the string representation of a number in the following form.  </para>
@@ -3768,6 +4151,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number to its <see cref="T:System.Numerics.BigInteger" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that is equivalent to the number specified in the <paramref name="value" /> parameter.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the number to convert.</param>
       </Docs>
@@ -3787,7 +4174,6 @@
         <Parameter Name="style" Type="System.Globalization.NumberStyles" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="style" /> parameter defines the style elements (such as white space, the positive or negative sign symbol, the group separator symbol, or the decimal point symbol) that are allowed in the <paramref name="value" /> parameter for the parse operation to succeed. <paramref name="styles" /> must be a combination of bit flags from the <see cref="T:System.Globalization.NumberStyles" /> enumeration. The <paramref name="style" /> parameter makes this method overload useful when <paramref name="value" /> contains the string representation of a hexadecimal value, when the number system (decimal or hexadecimal) represented by <paramref name="value" /> is known only at run time, or when you want to disallow white space or a sign symbol in <paramref name="value" />.</para>
@@ -4042,6 +4428,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified style to its <see cref="T:System.Numerics.BigInteger" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that is equivalent to the number specified in the <paramref name="value" /> parameter.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a number to convert. </param>
         <param name="style">
@@ -4063,7 +4453,6 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="value" /> parameter should be the string representation of a number in the following form:</para>
@@ -4129,6 +4518,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified culture-specific format to its <see cref="T:System.Numerics.BigInteger" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that is equivalent to the number specified in the <paramref name="value" /> parameter.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a number to convert.</param>
         <param name="provider">
@@ -4151,7 +4544,6 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="style" /> parameter defines the style elements (such as white space, the positive or negative sign symbol, the group separator symbol, or the decimal point symbol) that are allowed in the <paramref name="value" /> parameter for the parse operation to succeed. <paramref name="styles" /> must be a combination of bit flags from the <see cref="T:System.Globalization.NumberStyles" /> enumeration. The <paramref name="style" /> parameter makes this method overload useful when <paramref name="value" /> contains the string representation of a hexadecimal value, when the number system (decimal or hexadecimal) represented by <paramref name="value" /> is known only at run time, or when you want to disallow white space or a sign symbol in <paramref name="value" />.</para>
@@ -4418,6 +4810,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified style and culture-specific format to its <see cref="T:System.Numerics.BigInteger" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that is equivalent to the number specified in the <paramref name="value" /> parameter.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a number to convert.</param>
         <param name="style">
@@ -4441,7 +4837,6 @@
         <Parameter Name="exponent" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.Pow(System.Numerics.BigInteger,System.Int32)" /> method returns 1 if the value of the exponent parameter is 0, or if the values of both the <paramref name="value" /> and <paramref name="exponent" /> parameters are 0. If <paramref name="exponent" /> is 1, the <see cref="M:System.Numerics.BigInteger.Pow(System.Numerics.BigInteger,System.Int32)" /> method returns <paramref name="value" />. If <paramref name="value" /> is negative, the method returns a negative result.</para>
@@ -4451,6 +4846,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Raises a <see cref="T:System.Numerics.BigInteger" /> value to the power of a specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of raising <paramref name="value" /> to the <paramref name="exponent" /> power.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The number to raise to the <paramref name="exponent" /> power.</param>
         <param name="exponent">
@@ -4472,7 +4871,6 @@
         <Parameter Name="divisor" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The sign of the remainder is the sign of the <paramref name="dividend" /> parameter.</para>
@@ -4483,6 +4881,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs integer division on two <see cref="T:System.Numerics.BigInteger" /> values and returns the remainder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The remainder after dividing <paramref name="dividend" /> by <paramref name="divisor" />.</para>
+        </returns>
         <param name="dividend">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to be divided.</param>
         <param name="divisor">
@@ -4526,7 +4928,6 @@
         <Parameter Name="right" Type="System.Numerics.BigInteger" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Languages that do not support custom operators can use the <see cref="M:System.Numerics.BigInteger.Subtract(System.Numerics.BigInteger,System.Numerics.BigInteger)" /> method to perform subtraction using <see cref="T:System.Numerics.BigInteger" /> values. </para>
@@ -4537,6 +4938,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts one <see cref="T:System.Numerics.BigInteger" /> value from another and returns the result.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of subtracting <paramref name="right" /> from <paramref name="left" />.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to subtract from (the minuend).</param>
         <param name="right">
@@ -4555,7 +4960,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The individual bytes in the array returned by this method appear in little-endian order. That is, the lower-order bytes of the value precede the higher-order bytes. The first byte of the array reflects the first eight bits of the <see cref="T:System.Numerics.BigInteger" /> value, the second byte reflects the next eight bits, and so on. For example, the value 1024, or 0x0400, is stored as the following array of two bytes:</para>
@@ -4598,6 +5002,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a <see cref="T:System.Numerics.BigInteger" /> value to a byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current <see cref="T:System.Numerics.BigInteger" /> object converted to an array of bytes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -4612,7 +5020,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.ToString" /> method formats a <see cref="T:System.Numerics.BigInteger" /> value in the default ("G", or general) format of the current culture. If you want to specify a different format or culture, use the other overloads of the <see cref="M:System.Numerics.BigInteger.ToString(System.String)" /> method, as follows:</para>
@@ -4678,6 +5085,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of the current <see cref="T:System.Numerics.BigInteger" /> object to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the current <see cref="T:System.Numerics.BigInteger" /> value.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -4694,7 +5105,6 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.ToString(System.IFormatProvider)" /> method formats a <see cref="T:System.Numerics.BigInteger" /> value in the default ("G", or general) format by using the <see cref="T:System.Globalization.NumberFormatInfo" /> object of a specified culture. If you want to specify a different format or the current culture, use the other overloads of the <see cref="M:System.Numerics.BigInteger.ToString(System.String)" /> method, as follows:</para>
@@ -4772,6 +5182,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of the current <see cref="T:System.Numerics.BigInteger" /> object to its equivalent string representation by using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the current <see cref="T:System.Numerics.BigInteger" /> value in the format specified by the <paramref name="provider" /> parameter.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information.</param>
       </Docs>
@@ -4790,7 +5204,6 @@
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.ToString(System.String)" /> method formats a <see cref="T:System.Numerics.BigInteger" /> value in a specified format by using a <see cref="T:System.Globalization.NumberFormatInfo" /> object that represents the conventions of the current culture. If you want to use the default ("G", or general) format or specify a different culture, use the other overloads of the <see cref="M:System.Numerics.BigInteger.ToString(System.String)" /> method, as follows:</para>
@@ -4867,6 +5280,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of the current <see cref="T:System.Numerics.BigInteger" /> object to its equivalent string representation by using the specified format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the current <see cref="T:System.Numerics.BigInteger" /> value in the format specified by the <paramref name="format" /> parameter.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A standard or custom numeric format string.</param>
       </Docs>
@@ -4886,7 +5303,6 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.BigInteger.ToString(System.String,System.IFormatProvider)" /> method formats a <see cref="T:System.Numerics.BigInteger" /> value in a specified format by using the <see cref="T:System.Globalization.NumberFormatInfo" /> object of a specified culture. If you want to use default format or culture settings, use the other overloads of the <see cref="M:System.Numerics.BigInteger.ToString(System.String)" /> method, as follows:</para>
@@ -4974,6 +5390,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of the current <see cref="T:System.Numerics.BigInteger" /> object to its equivalent string representation by using the specified format and culture-specific format information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the current <see cref="T:System.Numerics.BigInteger" /> value as specified by the <paramref name="format" /> and <paramref name="provider" /> parameters.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A standard or custom numeric format string.</param>
         <param name="provider">
diff --git a/mcs/class/System.Numerics/Documentation/en/System.Numerics/Complex.xml b/mcs/class/System.Numerics/Documentation/en/System.Numerics/Complex.xml
index dfcb3dc1192..64eb2ee06b3 100644
--- a/mcs/class/System.Numerics/Documentation/en/System.Numerics/Complex.xml
+++ b/mcs/class/System.Numerics/Documentation/en/System.Numerics/Complex.xml
@@ -164,7 +164,6 @@
         <Parameter Name="value" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The absolute value of a complex number is equivalent to its <see cref="P:System.Numerics.Complex.Magnitude" /> property. The absolute value of a real number <math>a + bi</math> is calculated as follows:</para>
@@ -185,6 +184,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the absolute value (or magnitude) of a complex number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The absolute value of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A complex number.</param>
       </Docs>
@@ -203,7 +206,6 @@
         <Parameter Name="value" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.Complex.Acos(System.Numerics.Complex)" /> method for complex numbers corresponds to the <see cref="M:System.Math.Acos(System.Double)" /> method for real numbers.</para>
@@ -222,6 +224,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the angle that is the arc cosine of the specified complex number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The angle, measured in radians, which is the arc cosine of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A complex number that represents a cosine.</param>
       </Docs>
@@ -241,7 +247,6 @@
         <Parameter Name="right" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The addition of a complex number, <math>a + bi</math>, and a second complex number, <math>c + di</math>, takes the following form: </para>
@@ -255,6 +260,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds two complex numbers and returns the result.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of <paramref name="left" /> and <paramref name="right" />.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first complex number to add.</param>
         <param name="right">
@@ -275,7 +284,6 @@
         <Parameter Name="value" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.Complex.Asin(System.Numerics.Complex)" /> method for complex numbers corresponds to the <see cref="M:System.Math.Asin(System.Double)" /> method for real numbers.</para>
@@ -298,6 +306,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the angle that is the arc sine of the specified complex number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The angle which is the arc sine of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A complex number.</param>
       </Docs>
@@ -316,7 +328,6 @@
         <Parameter Name="value" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.Complex.Atan(System.Numerics.Complex)" /> method for complex numbers corresponds to the <see cref="M:System.Math.Atan(System.Double)" /> method for real numbers.</para>
@@ -340,6 +351,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the angle that is the arc tangent of the specified complex number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The angle that is the arc tangent of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A complex number.</param>
       </Docs>
@@ -358,7 +373,6 @@
         <Parameter Name="value" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The conjugate of a complex number inverts the sign of the imaginary component; that is, it applies unary negation to the imaginary component. If <math>a + bi</math> is a complex number, its conjugate is <math>a - bi</math>.</para>
@@ -367,6 +381,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the conjugate of a complex number and returns the result.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The conjugate of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A complex number.</param>
       </Docs>
@@ -385,7 +403,6 @@
         <Parameter Name="value" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.Complex.Cos(System.Numerics.Complex)" /> method for complex numbers corresponds to the <see cref="M:System.Math.Cos(System.Double)" /> method for real numbers.</para>
@@ -406,6 +423,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the cosine of the specified complex number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The cosine of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A complex number.</param>
       </Docs>
@@ -424,7 +445,6 @@
         <Parameter Name="value" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.Complex.Cosh(System.Numerics.Complex)" /> method for complex numbers corresponds to the <see cref="M:System.Math.Cosh(System.Double)" /> method for real numbers.</para>
@@ -435,6 +455,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hyperbolic cosine of the specified complex number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hyperbolic cosine of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A complex number.</param>
       </Docs>
@@ -454,7 +478,6 @@
         <Parameter Name="divisor" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The division of a complex number, <math>a + bi</math>, by a second complex number, number, <math>c + di</math>, takes the following form:</para>
@@ -476,6 +499,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Divides one complex number by another and returns the result.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The quotient of the division.</para>
+        </returns>
         <param name="dividend">
           <attribution license="cc4" from="Microsoft" modified="false" />The complex number to be divided.</param>
         <param name="divisor">
@@ -496,7 +523,6 @@
         <Parameter Name="value" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.Complex.Equals(System.Numerics.Complex)" /> method provides the <see cref="T:System.IEquatable`1" /> implementation for the <see cref="T:System.Numerics.Complex" /> structure. It performs slightly better than <see cref="M:System.Numerics.Complex.Equals(System.Object)" /> method because it does not have to convert its parameter to a complex number.</para>
@@ -507,6 +533,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current instance and a specified complex number have the same value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this complex number and <paramref name="value" /> have the same value; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The complex number to compare.</param>
       </Docs>
@@ -525,7 +555,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Two complex numbers are equal if their real parts are equal and their imaginary parts are equal. The <see cref="M:System.Numerics.Complex.Equals(System.Object)" /> method is equivalent to the following expression:</para>
@@ -537,6 +566,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current instance and a specified object have the same value. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="obj" /> parameter is a <see cref="T:System.Numerics.Complex" /> object or a type capable of implicit conversion to a <see cref="T:System.Numerics.Complex" /> object, and its value is equal to the current <see cref="T:System.Numerics.Complex" /> object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare.</param>
       </Docs>
@@ -555,7 +588,6 @@
         <Parameter Name="value" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="Overload:System.Numerics.Complex.Pow" /> method to calculate the powers of other bases.</para>
@@ -565,6 +597,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns e raised to the power specified by a complex number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number e raised to the power <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A complex number that specifies a power.</param>
       </Docs>
@@ -584,7 +620,6 @@
         <Parameter Name="phase" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.Complex.FromPolarCoordinates(System.Double,System.Double)" /> method instantiates a complex number based on its polar coordinates. </para>
@@ -595,6 +630,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a complex number from a point's polar coordinates.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A complex number.</para>
+        </returns>
         <param name="magnitude">
           <attribution license="cc4" from="Microsoft" modified="false" />The magnitude, which is the distance from the origin (the intersection of the x-axis and the y-axis) to the number.</param>
         <param name="phase">
@@ -613,12 +652,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for the current <see cref="T:System.Numerics.Complex" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Imaginary">
@@ -675,7 +717,6 @@
         <Parameter Name="value" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.Complex.Log(System.Numerics.Complex)" /> method for complex numbers corresponds to the <see cref="M:System.Math.Log(System.Double)" /> method for real numbers.</para>
@@ -684,6 +725,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the natural (base e) logarithm of a specified complex number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The natural (base e) logarithm of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A complex number.</param>
       </Docs>
@@ -703,7 +748,6 @@
         <Parameter Name="baseValue" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.Complex.Log(System.Numerics.Complex,System.Double)" /> method for complex numbers corresponds to the <see cref="M:System.Math.Log(System.Double,System.Double)" /> method for real numbers.</para>
@@ -712,6 +756,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the logarithm of a specified complex number in a specified base.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The logarithm of <paramref name="value" /> in base <paramref name="baseValue" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A complex number.</param>
         <param name="baseValue">
@@ -732,7 +780,6 @@
         <Parameter Name="value" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.Complex.Log10(System.Numerics.Complex)" /> method for complex numbers corresponds to the <see cref="M:System.Math.Log10(System.Double)" /> method for real numbers.</para>
@@ -741,6 +788,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the base-10 logarithm of a specified complex number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The base-10 logarithm of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A complex number.</param>
       </Docs>
@@ -790,7 +841,6 @@
         <Parameter Name="right" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The multiplication of a complex number, <math>a + bi</math>, and a second complex number, <math>c + di</math>, takes the following form: </para>
@@ -804,6 +854,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the product of two complex numbers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The product of the <paramref name="left" /> and <paramref name="right" /> parameters.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first complex number to multiply.</param>
         <param name="right">
@@ -824,7 +878,6 @@
         <Parameter Name="value" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The additive inverse of a complex number is a complex number that produces a value of <see cref="F:System.Numerics.Complex.Zero" /> when it is added to the original complex number. This method returns a complex number in which the real and imaginary components of the original complex number are multiplied by -1.</para>
@@ -834,6 +887,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the additive inverse of a specified complex number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of the <see cref="P:System.Numerics.Complex.Real" /> and <see cref="P:System.Numerics.Complex.Imaginary" /> components of the <paramref name="value" /> parameter multiplied by -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A complex number.</param>
       </Docs>
@@ -871,7 +928,6 @@
         <Parameter Name="right" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.Complex.op_Addition(System.Numerics.Complex,System.Numerics.Complex)" /> method defines the addition operation for complex numbers. It enables code such as the following:</para>
@@ -887,6 +943,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds two complex numbers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of <paramref name="left" /> and <paramref name="right" />.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to add.</param>
         <param name="right">
@@ -908,7 +968,6 @@
         <Parameter Name="right" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.Complex.op_Division(System.Numerics.Complex,System.Numerics.Complex)" /> method defines the division operation for complex numbers. It enables code such as the following:</para>
@@ -932,6 +991,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Divides a specified complex number by another specified complex number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of dividing <paramref name="left" /> by <paramref name="right" />.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to be divided.</param>
         <param name="right">
@@ -953,7 +1016,6 @@
         <Parameter Name="right" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.Complex.op_Equality(System.Numerics.Complex,System.Numerics.Complex)" /> method defines the operation of the equality operator for <see cref="T:System.Numerics.Complex" /> values. It enables code such as the following:</para>
@@ -967,6 +1029,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether two complex numbers are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="left" /> and <paramref name="right" /> parameters have the same value; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first complex number to compare.</param>
         <param name="right">
@@ -1248,7 +1314,6 @@
         <Parameter Name="right" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.Complex.op_Equality(System.Numerics.Complex,System.Numerics.Complex)" /> method defines the operation of the inequality operator for complex numbers. It enables code such as the following: </para>
@@ -1260,6 +1325,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether two complex numbers are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> and <paramref name="right" /> are not equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -1281,7 +1350,6 @@
         <Parameter Name="right" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.Complex.op_Multiply(System.Numerics.Complex,System.Numerics.Complex)" /> method defines the operation of the multiplication operator for complex numbers. It enables code such as the following:</para>
@@ -1297,6 +1365,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Multiplies two specified complex numbers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The product of <paramref name="left" /> and <paramref name="right" />.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to multiply.</param>
         <param name="right">
@@ -1318,7 +1390,6 @@
         <Parameter Name="right" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.Complex.op_Subtraction(System.Numerics.Complex,System.Numerics.Complex)" /> method defines the operation of the subtraction operator for complex numbers. It enables code such as the following:</para>
@@ -1334,6 +1405,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts a complex number from another complex number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of subtracting <paramref name="right" /> from <paramref name="left" />.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to subtract from (the minuend).</param>
         <param name="right">
@@ -1354,7 +1429,6 @@
         <Parameter Name="value" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.Complex.op_UnaryNegation(System.Numerics.Complex)" /> method defines the operation of the unary negation (additive inverse) operator for complex numbers. It enables code such as the following: </para>
@@ -1365,6 +1439,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the additive inverse of a specified complex number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of the <see cref="P:System.Numerics.Complex.Real" /> and <see cref="P:System.Numerics.Complex.Imaginary" /> components of the <paramref name="value" /> parameter multiplied by -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to negate.</param>
       </Docs>
@@ -1409,7 +1487,6 @@
         <Parameter Name="power" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="value" /> is <see cref="F:System.Numerics.Complex.Zero" />, the method returns <see cref="F:System.Numerics.Complex.Zero" />. For other values, if <paramref name="power" /> is 0, the method returns <see cref="F:System.Numerics.Complex.One" />, and if <paramref name="power" /> is 1, it returns <paramref name="value" />. </para>
@@ -1419,6 +1496,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a specified complex number raised to a power specified by a double-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The complex number <paramref name="value" /> raised to the power <paramref name="power" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A complex number to be raised to a power.</param>
         <param name="power">
@@ -1440,12 +1521,15 @@
         <Parameter Name="power" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a specified complex number raised to a power specified by a complex number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The complex number <paramref name="value" /> raised to the power <paramref name="power" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A complex number to be raised to a power.</param>
         <param name="power">
@@ -1488,7 +1572,6 @@
         <Parameter Name="value" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The reciprocal, or multiplicative inverse, of a number x is a number y where x multiplied by y yields 1. The reciprocal of a complex number is the complex number that produces <see cref="F:System.Numerics.Complex.One" /> when the two numbers are multiplied. If a complex number is represented by <math>a +bi</math>, its reciprocal is represented by the expression <math>a/(a</math><superscript>2</superscript><math>+b</math><superscript>2</superscript><math>) + -b/(a</math><superscript>2</superscript><math> + b</math><superscript>2</superscript><math>)</math>.</para>
@@ -1498,6 +1581,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the multiplicative inverse of a complex number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The reciprocal of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A complex number.</param>
       </Docs>
@@ -1516,7 +1603,6 @@
         <Parameter Name="value" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.Complex.Sin(System.Numerics.Complex)" /> method for complex numbers corresponds to the <see cref="M:System.Math.Sin(System.Double)" /> method for real numbers.</para>
@@ -1537,6 +1623,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the sine of the specified complex number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sine of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A complex number.</param>
       </Docs>
@@ -1555,7 +1645,6 @@
         <Parameter Name="value" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.Complex.Sinh(System.Numerics.Complex)" /> method for complex numbers corresponds to the <see cref="M:System.Math.Sinh(System.Double)" /> method for real numbers.</para>
@@ -1576,6 +1665,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hyperbolic sine of the specified complex number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hyperbolic sine of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A complex number.</param>
       </Docs>
@@ -1594,7 +1687,6 @@
         <Parameter Name="value" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The square root of the complex number <paramref name="value" /> is calculated by using the following formula:</para>
@@ -1618,6 +1710,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the square root of a specified complex number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The square root of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A complex number.</param>
       </Docs>
@@ -1637,7 +1733,6 @@
         <Parameter Name="right" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The subtraction of a complex number, <math>c + di</math>, from another complex number, <math>a + bi</math>, takes the following form: </para>
@@ -1651,6 +1746,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts one complex number from another and returns the result.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of subtracting <paramref name="right" /> from <paramref name="left" />.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to subtract from (the minuend).</param>
         <param name="right">
@@ -1671,7 +1770,6 @@
         <Parameter Name="value" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.Complex.Tan(System.Numerics.Complex)" /> method for complex numbers corresponds to the <see cref="M:System.Math.Tan(System.Double)" /> method for real numbers.</para>
@@ -1691,6 +1789,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the tangent of the specified complex number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The tangent of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A complex number.</param>
       </Docs>
@@ -1709,7 +1811,6 @@
         <Parameter Name="value" Type="System.Numerics.Complex" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Numerics.Complex.Tanh(System.Numerics.Complex)" /> method for complex numbers corresponds to the <see cref="M:System.Math.Tanh(System.Double)" /> method for real numbers.</para>
@@ -1729,6 +1830,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hyperbolic tangent of the specified complex number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hyperbolic tangent of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A complex number.</param>
       </Docs>
@@ -1745,7 +1850,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default string representation of a complex number displays the number using its Cartesian coordinates in the form (a, b), where a is the real part of the complex number, and b is its imaginary part. Both a and b are formatted using the general format specifier ("G") and the conventions of the current system culture.</para>
@@ -1754,6 +1858,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current complex number to its equivalent string representation in Cartesian form.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the current instance in Cartesian form.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -1770,7 +1878,6 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The string representation of the complex number returned by this method displays the number using its Cartesian coordinates in the form (a, b), where a is the real part of the complex number, and b is its imaginary part. Both a and b are formatted using the general format specifier ("G") and the conventions of the culture defined by <paramref name="provider" />. </para>
@@ -1792,6 +1899,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current complex number to its equivalent string representation in Cartesian form by using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the current instance in Cartesian form, as specified by <paramref name="provider" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information.</param>
       </Docs>
@@ -1810,7 +1921,6 @@
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The string representation of the complex number returned by this method displays the number using its Cartesian coordinates in the form (a, b), where a is the real part of the complex number, and b is its imaginary part. Both a and b are formatted using the format string specified by <paramref name="format" />. The <paramref name="format" /> parameter can be any valid standard numeric format specifier, or any combination of custom numeric format specifiers. If <paramref name="format" /> is equal to <see cref="F:System.String.Empty" /> or is null, the real and imaginary parts of the complex number are formatted with the general format specifier ("G"). If <paramref name="format" /> is any other value, the method throws a <see cref="T:System.FormatException" />.</para>
@@ -1829,6 +1939,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current complex number to its equivalent string representation in Cartesian form by using the specified format for its real and imaginary parts.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the current instance in Cartesian form.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A standard or custom numeric format string.</param>
       </Docs>
@@ -1848,7 +1962,6 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The string representation of the complex number returned by this method displays the number using its Cartesian coordinates in the form (a, b), where a is the real part of the complex number, and b is its imaginary part. Both a and b are formatted using the format string specified by <paramref name="format" />. The <paramref name="format" /> parameter can be any valid standard numeric format specifier, or any combination of custom numeric format specifiers. If <paramref name="format" /> is equal to <see cref="F:System.String.Empty" /> or is null, the real and imaginary parts of the complex number are formatted with the general format specifier ("G"). If <paramref name="format" /> is any other value, the method throws a <see cref="T:System.FormatException" />.</para>
@@ -1879,6 +1992,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current complex number to its equivalent string representation in Cartesian form by using the specified format and culture-specific format information for its real and imaginary parts.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the current instance in Cartesian form, as specified by <paramref name="format" /> and <paramref name="provider" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A standard or custom numeric format string.</param>
         <param name="provider">
diff --git a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels.Http/HttpChannel.xml b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels.Http/HttpChannel.xml
index ab0259bb88e..a23fed1d9b5 100644
--- a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels.Http/HttpChannel.xml
+++ b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels.Http/HttpChannel.xml
@@ -287,7 +287,6 @@
         <Parameter Name="objectURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is used by <see cref="M:System.Runtime.Remoting.Channels.ChannelServices.GetUrlsForObject(System.MarshalByRefObject)" />.</para>
@@ -296,6 +295,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of all the URLs for an object with the specified URI, hosted on the current <see cref="T:System.Runtime.Remoting.Channels.Http.HttpChannel" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of the URLs for an object with the specified URI, hosted on the current <see cref="T:System.Runtime.Remoting.Channels.Http.HttpChannel" />.</para>
+        </returns>
         <param name="objectURI">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the object for which URL's are required. </param>
       </Docs>
diff --git a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels.Http/HttpRemotingHandlerFactory.xml b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels.Http/HttpRemotingHandlerFactory.xml
index 5c5f612950c..e886dc974e1 100644
--- a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels.Http/HttpRemotingHandlerFactory.xml
+++ b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels.Http/HttpRemotingHandlerFactory.xml
@@ -58,7 +58,6 @@
         <Parameter Name="filePath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Web.IHttpHandler'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information about the current method, see <see cref="M:System.Web.IHttpHandlerFactory.GetHandler(System.Web.HttpContext,System.String,System.String,System.String)" />.</para>
@@ -67,6 +66,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an instance of the <see cref="T:System.Runtime.Remoting.Channels.Http.HttpRemotingHandler" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Runtime.Remoting.Channels.Http.HttpRemotingHandler" /> that processes the request.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of the <see cref="T:System.Web.HttpContext" /> class that provides references to intrinsic server objects (for example, Request, Response, Session, and Server) used to service HTTP requests. </param>
         <param name="verb">
diff --git a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels.Http/HttpServerChannel.xml b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels.Http/HttpServerChannel.xml
index b4e05ff26d5..f97d38380ed 100644
--- a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels.Http/HttpServerChannel.xml
+++ b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels.Http/HttpServerChannel.xml
@@ -307,12 +307,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the URI of the current channel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The URI of the current channel.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -329,7 +332,6 @@
         <Parameter Name="objectUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current method is used by <see cref="M:System.Runtime.Remoting.Channels.ChannelServices.GetUrlsForObject(System.MarshalByRefObject)" />.</para>
@@ -338,6 +340,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of all the URLs for an object with the specified URI, hosted on the current <see cref="T:System.Runtime.Remoting.Channels.Http.HttpChannel" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of the URLs for an object with the specified URI, hosted on the current <see cref="T:System.Runtime.Remoting.Channels.Http.HttpChannel" />.</para>
+        </returns>
         <param name="objectUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the object for which URLs are required. </param>
       </Docs>
diff --git a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels.Ipc/IpcChannel.xml b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels.Ipc/IpcChannel.xml
index 58415ff3542..c393debb689 100644
--- a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels.Ipc/IpcChannel.xml
+++ b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels.Ipc/IpcChannel.xml
@@ -202,7 +202,6 @@
       </Parameters>
       <Docs>
         <param name="objectUri">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -212,6 +211,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of all the URLs for an object with the specified URI, hosted on the current <see cref="T:System.Runtime.Remoting.Channels.Ipc.IpcChannel" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of the URLs for an object with the specified URI, hosted on the current <see cref="T:System.Runtime.Remoting.Channels.Ipc.IpcChannel" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels.Ipc/IpcServerChannel.xml b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels.Ipc/IpcServerChannel.xml
index cfd82667bc7..cfc4013b072 100644
--- a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels.Ipc/IpcServerChannel.xml
+++ b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels.Ipc/IpcServerChannel.xml
@@ -210,7 +210,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -220,6 +219,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the URI of the current channel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that contains the URI of the channel.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -235,7 +238,6 @@
         <Parameter Name="objectUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -245,6 +247,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of all the URLs for the object with the specified URI, hosted on the current <see cref="T:System.Runtime.Remoting.Channels.Ipc.IpcChannel" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of the URLs for an object with the specified URI, hosted on the current <see cref="T:System.Runtime.Remoting.Channels.Tcp.TcpChannel" /> instance.</para>
+        </returns>
         <param name="objectUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the object for which URLs are required.</param>
       </Docs>
diff --git a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels.Tcp/TcpChannel.xml b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels.Tcp/TcpChannel.xml
index c4c30ec91a4..8be759b0289 100644
--- a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels.Tcp/TcpChannel.xml
+++ b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels.Tcp/TcpChannel.xml
@@ -214,7 +214,6 @@
       </Parameters>
       <Docs>
         <param name="uri">To be added: an object of type 'string'</param>
-        <returns>To be added: an object of type 'string []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is used by <see cref="M:System.Runtime.Remoting.Channels.ChannelServices.GetUrlsForObject(System.MarshalByRefObject)" />.</para>
@@ -223,6 +222,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of all the URLs for an object with the specified URI, hosted on the current <see cref="T:System.Runtime.Remoting.Channels.Tcp.TcpChannel" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of the URLs for an object with the specified URI, hosted on the current <see cref="T:System.Runtime.Remoting.Channels.Tcp.TcpChannel" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels.Tcp/TcpServerChannel.xml b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels.Tcp/TcpServerChannel.xml
index 7c221d05082..436fd141ccc 100644
--- a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels.Tcp/TcpServerChannel.xml
+++ b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels.Tcp/TcpServerChannel.xml
@@ -222,12 +222,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the URI of the current channel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The URI of the current channel.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -245,7 +248,6 @@
       </Parameters>
       <Docs>
         <param name="uri">To be added: an object of type 'string'</param>
-        <returns>To be added: an object of type 'string []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is used by <see cref="M:System.Runtime.Remoting.Channels.ChannelServices.GetUrlsForObject(System.MarshalByRefObject)" />.</para>
@@ -254,6 +256,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of all the URLs for an object with the specified URI, hosted on the current <see cref="T:System.Runtime.Remoting.Channels.Tcp.TcpChannel" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of the URLs for an object with the specified URI, hosted on the current <see cref="T:System.Runtime.Remoting.Channels.Tcp.TcpChannel" /> instance.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/BinaryClientFormatterSink.xml b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/BinaryClientFormatterSink.xml
index 732c3bd706e..339249899cf 100644
--- a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/BinaryClientFormatterSink.xml
+++ b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/BinaryClientFormatterSink.xml
@@ -83,12 +83,15 @@
         <Parameter Name="replySink" Type="System.Runtime.Remoting.Messaging.IMessageSink" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.Messaging.IMessageCtrl'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously processes the provided message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Messaging.IMessageCtrl" /> that provides a way to control the asynchronous message after it has been dispatched.</para>
+        </returns>
         <param name="msg">
           <attribution license="cc4" from="Microsoft" modified="false" />The message to process. </param>
         <param name="replySink">
@@ -174,7 +177,6 @@
         <Parameter Name="headers" Type="System.Runtime.Remoting.Channels.ITransportHeaders" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IO.Stream'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Runtime.Remoting.Channels.BinaryClientFormatterSink.GetRequestStream(System.Runtime.Remoting.Messaging.IMessage,System.Runtime.Remoting.Channels.ITransportHeaders)" /> method is called by the formatter sink before it serializes the message.</para>
@@ -183,6 +185,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.IO.Stream" /> onto which the provided message is to be serialized.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IO.Stream" /> onto which the provided message is to be serialized.</para>
+        </returns>
         <param name="msg">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Runtime.Remoting.Messaging.IMethodCallMessage" /> that contains details about the method call. </param>
         <param name="headers">
@@ -290,12 +296,15 @@
         <Parameter Name="msg" Type="System.Runtime.Remoting.Messaging.IMessage" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.Messaging.IMessage'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Synchronously processes the provided message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The response to the processed message.</para>
+        </returns>
         <param name="msg">
           <attribution license="cc4" from="Microsoft" modified="false" />The message to process. </param>
       </Docs>
diff --git a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/BinaryClientFormatterSinkProvider.xml b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/BinaryClientFormatterSinkProvider.xml
index 8b4d6cdc475..0e644e3dd5c 100644
--- a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/BinaryClientFormatterSinkProvider.xml
+++ b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/BinaryClientFormatterSinkProvider.xml
@@ -107,7 +107,6 @@
         <Parameter Name="remoteChannelData" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IClientChannelSink'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When the <see cref="M:System.Runtime.Remoting.Channels.IClientChannelSinkProvider.CreateSink(System.Runtime.Remoting.Channels.IChannelSender,System.String,System.Object)" /> method is called, it creates its own channel sink, forwards the <see cref="M:System.Runtime.Remoting.Channels.IClientChannelSinkProvider.CreateSink(System.Runtime.Remoting.Channels.IChannelSender,System.String,System.Object)" /> call to the next sink provider in the chain (if there is one), and ensures that the next sink and the current one are linked together.</para>
@@ -116,6 +115,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a sink chain.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first sink of the newly formed channel sink chain, or null, which indicates that this provider will not or cannot provide a connection for this endpoint.</para>
+        </returns>
         <param name="channel">
           <attribution license="cc4" from="Microsoft" modified="false" />Channel for which this sink chain is being constructed. </param>
         <param name="url">
diff --git a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/BinaryServerFormatterSink.xml b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/BinaryServerFormatterSink.xml
index e33c9903cc5..7c82a74daf7 100644
--- a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/BinaryServerFormatterSink.xml
+++ b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/BinaryServerFormatterSink.xml
@@ -137,7 +137,6 @@
         <Parameter Name="headers" Type="System.Runtime.Remoting.Channels.ITransportHeaders" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IO.Stream'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called when a response stream needs to be created.</para>
@@ -146,6 +145,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.IO.Stream" /> onto which the provided response message is to be serialized.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IO.Stream" /> onto which the provided response message is to be serialized.</para>
+        </returns>
         <param name="sinkStack">
           <attribution license="cc4" from="Microsoft" modified="false" />A stack of sinks that is leading back to the server transport sink. </param>
         <param name="state">
diff --git a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/BinaryServerFormatterSinkProvider.xml b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/BinaryServerFormatterSinkProvider.xml
index 363858d18bb..370d2f02fa0 100644
--- a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/BinaryServerFormatterSinkProvider.xml
+++ b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/BinaryServerFormatterSinkProvider.xml
@@ -106,12 +106,15 @@
         <Parameter Name="channel" Type="System.Runtime.Remoting.Channels.IChannelReceiver" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IServerChannelSink'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a sink chain.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first sink of the newly formed channel sink chain.</para>
+        </returns>
         <param name="channel">
           <attribution license="cc4" from="Microsoft" modified="false" />The channel for which to create the channel sink chain. </param>
       </Docs>
diff --git a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/IAuthorizeRemotingConnection.xml b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/IAuthorizeRemotingConnection.xml
index 90b8e956b74..36380a2699a 100644
--- a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/IAuthorizeRemotingConnection.xml
+++ b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/IAuthorizeRemotingConnection.xml
@@ -28,7 +28,6 @@
         <Parameter Name="endPoint" Type="System.Net.EndPoint" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -38,6 +37,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a Boolean value that indicates whether the network address of the client is authorized to connect on the current channel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the network address of the client is authorized; otherwise, false.</para>
+        </returns>
         <param name="endPoint">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.EndPoint" /> that identifies the network address of the client.</param>
       </Docs>
@@ -55,7 +58,6 @@
         <Parameter Name="identity" Type="System.Security.Principal.IIdentity" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -65,6 +67,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a Boolean value that indicates whether the user identity of the client is authorized to connect on the current channel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the user identity of the client is authorized; otherwise, false.</para>
+        </returns>
         <param name="identity">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Principal.IIdentity" /> that represents the user identity of the client.</param>
       </Docs>
diff --git a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/SoapClientFormatterSink.xml b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/SoapClientFormatterSink.xml
index 9cf5c0632f8..c08161d359a 100644
--- a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/SoapClientFormatterSink.xml
+++ b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/SoapClientFormatterSink.xml
@@ -82,12 +82,15 @@
         <Parameter Name="replySink" Type="System.Runtime.Remoting.Messaging.IMessageSink" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.Messaging.IMessageCtrl'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously processes the provided message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Messaging.IMessageCtrl" /> that provides a way to control the asynchronous message after it has been dispatched.</para>
+        </returns>
         <param name="msg">
           <attribution license="cc4" from="Microsoft" modified="false" />The message to process. </param>
         <param name="replySink">
@@ -173,12 +176,15 @@
         <Parameter Name="headers" Type="System.Runtime.Remoting.Channels.ITransportHeaders" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IO.Stream'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.IO.Stream" /> onto which the provided message is to be serialized.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IO.Stream" /> onto which the provided message is to be serialized.</para>
+        </returns>
         <param name="msg">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Runtime.Remoting.Messaging.IMethodCallMessage" /> containing details about the method call. </param>
         <param name="headers">
@@ -283,12 +289,15 @@
         <Parameter Name="msg" Type="System.Runtime.Remoting.Messaging.IMessage" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.Messaging.IMessage'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Synchronously processes the provided message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The response to the processed message.</para>
+        </returns>
         <param name="msg">
           <attribution license="cc4" from="Microsoft" modified="false" />The message to process. </param>
       </Docs>
diff --git a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/SoapClientFormatterSinkProvider.xml b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/SoapClientFormatterSinkProvider.xml
index 372aef2e455..6a281493aca 100644
--- a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/SoapClientFormatterSinkProvider.xml
+++ b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/SoapClientFormatterSinkProvider.xml
@@ -107,7 +107,6 @@
         <Parameter Name="remoteChannelData" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IClientChannelSink'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When the <see cref="M:System.Runtime.Remoting.Channels.IClientChannelSinkProvider.CreateSink(System.Runtime.Remoting.Channels.IChannelSender,System.String,System.Object)" /> method is called, it creates its own channel sink, forwards the <see cref="M:System.Runtime.Remoting.Channels.IClientChannelSinkProvider.CreateSink(System.Runtime.Remoting.Channels.IChannelSender,System.String,System.Object)" /> call to the next sink provider in the chain (if there is one), and ensures that the next sink and the current one are linked together.</para>
@@ -116,6 +115,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a sink chain.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first sink of the newly formed channel sink chain, or null, which indicates that this provider will not or cannot provide a connection for this endpoint.</para>
+        </returns>
         <param name="channel">
           <attribution license="cc4" from="Microsoft" modified="false" />Channel for which this sink chain is being constructed. </param>
         <param name="url">
diff --git a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/SoapServerFormatterSink.xml b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/SoapServerFormatterSink.xml
index 03cca84aded..a5b410e9989 100644
--- a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/SoapServerFormatterSink.xml
+++ b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/SoapServerFormatterSink.xml
@@ -137,7 +137,6 @@
         <Parameter Name="headers" Type="System.Runtime.Remoting.Channels.ITransportHeaders" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IO.Stream'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called when a response stream needs to be created.</para>
@@ -146,6 +145,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.IO.Stream" /> onto which the provided response message is to be serialized.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IO.Stream" /> onto which the provided response message is to be serialized.</para>
+        </returns>
         <param name="sinkStack">
           <attribution license="cc4" from="Microsoft" modified="false" />A stack of sinks leading back to the server transport sink. </param>
         <param name="state">
diff --git a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/SoapServerFormatterSinkProvider.xml b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/SoapServerFormatterSinkProvider.xml
index c44a2e083bb..b1498728664 100644
--- a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/SoapServerFormatterSinkProvider.xml
+++ b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.Channels/SoapServerFormatterSinkProvider.xml
@@ -106,12 +106,15 @@
         <Parameter Name="channel" Type="System.Runtime.Remoting.Channels.IChannelReceiver" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IServerChannelSink'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a sink chain.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first sink of the newly formed channel sink chain.</para>
+        </returns>
         <param name="channel">
           <attribution license="cc4" from="Microsoft" modified="false" />The channel for which to create the channel sink chain. </param>
       </Docs>
diff --git a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.MetadataServices/SdlChannelSink.xml b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.MetadataServices/SdlChannelSink.xml
index 503a57c3928..b2c0a4b6ee6 100644
--- a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.MetadataServices/SdlChannelSink.xml
+++ b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.MetadataServices/SdlChannelSink.xml
@@ -129,7 +129,6 @@
         <Parameter Name="headers" Type="System.Runtime.Remoting.Channels.ITransportHeaders" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IO.Stream'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current method is called when a response stream needs to be created.</para>
@@ -138,6 +137,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.IO.Stream" /> onto which the provided response message is to be serialized.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IO.Stream" /> onto which the provided response message is to be serialized.</para>
+        </returns>
         <param name="sinkStack">
           <attribution license="cc4" from="Microsoft" modified="false" />A stack of sinks that lead back to the server transport sink. </param>
         <param name="state">
diff --git a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.MetadataServices/SdlChannelSinkProvider.xml b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.MetadataServices/SdlChannelSinkProvider.xml
index 8c21f45d45f..711f6b323e3 100644
--- a/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.MetadataServices/SdlChannelSinkProvider.xml
+++ b/mcs/class/System.Runtime.Remoting/Documentation/en/System.Runtime.Remoting.MetadataServices/SdlChannelSinkProvider.xml
@@ -79,12 +79,15 @@
         <Parameter Name="channel" Type="System.Runtime.Remoting.Channels.IChannelReceiver" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.Channels.IServerChannelSink'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a sink chain.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first sink of the newly formed channel sink chain.</para>
+        </returns>
         <param name="channel">
           <attribution license="cc4" from="Microsoft" modified="false" />The channel for which to create the channel sink chain. </param>
       </Docs>
diff --git a/mcs/class/System.Runtime.Serialization.Formatters.Soap/Documentation/en/System.Runtime.Serialization.Formatters.Soap/SoapFormatter.xml b/mcs/class/System.Runtime.Serialization.Formatters.Soap/Documentation/en/System.Runtime.Serialization.Formatters.Soap/SoapFormatter.xml
index 09ba73c4dd8..c92ad02985b 100644
--- a/mcs/class/System.Runtime.Serialization.Formatters.Soap/Documentation/en/System.Runtime.Serialization.Formatters.Soap/SoapFormatter.xml
+++ b/mcs/class/System.Runtime.Serialization.Formatters.Soap/Documentation/en/System.Runtime.Serialization.Formatters.Soap/SoapFormatter.xml
@@ -199,7 +199,6 @@
         <Parameter Name="serializationStream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For successful deserialization, the current position in the stream must be at the beginning of the object graph.</para>
@@ -211,6 +210,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes the data on the provided stream and reconstitutes the graph of objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The top object of the deserialized graph (root).</para>
+        </returns>
         <param name="serializationStream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream that contains the data to deserialize. </param>
       </Docs>
@@ -230,7 +233,6 @@
         <Parameter Name="handler" Type="System.Runtime.Remoting.Messaging.HeaderHandler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Headers are used only for specific remoting applications. The <see cref="T:System.Runtime.Remoting.Messaging.HeaderHandler" /> parameter is one of two ways to return headers from a stream in SOAP Remote Procedure Call (RPC) format. The other way is to use the <see cref="P:System.Runtime.Serialization.Formatters.Soap.SoapFormatter.TopObject" /> property.</para>
@@ -247,6 +249,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes the stream into an object graph with any headers in that stream being handled by the given <see cref="T:System.Runtime.Remoting.Messaging.HeaderHandler" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The top object of the deserialized graph (root).</para>
+        </returns>
         <param name="serializationStream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream that contains the data to deserialize.</param>
         <param name="handler">
diff --git a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization.Configuration/DeclaredTypeElementCollection.xml b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization.Configuration/DeclaredTypeElementCollection.xml
index 1a8bdb031b2..1ae36e75cd7 100644
--- a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization.Configuration/DeclaredTypeElementCollection.xml
+++ b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization.Configuration/DeclaredTypeElementCollection.xml
@@ -98,12 +98,15 @@
         <Parameter Name="typeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value if the collection contains the item specified by its type name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the specified item; otherwise, false.</para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the configuration element to search for.</param>
       </Docs>
@@ -159,12 +162,15 @@
         <Parameter Name="element" Type="System.Runtime.Serialization.Configuration.DeclaredTypeElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the specified configuration element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified configuration element; otherwise, -1.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Runtime.Serialization.Configuration.DeclaredTypeElement" /> to find.</param>
       </Docs>
diff --git a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization.Configuration/ParameterElementCollection.xml b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization.Configuration/ParameterElementCollection.xml
index 604f7e18347..2bd9a2f624b 100644
--- a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization.Configuration/ParameterElementCollection.xml
+++ b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization.Configuration/ParameterElementCollection.xml
@@ -117,12 +117,15 @@
         <Parameter Name="typeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets or sets a value specifying whether the named type is found in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the element is present; otherwise, false.</para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the type to find.</param>
       </Docs>
@@ -194,12 +197,15 @@
         <Parameter Name="element" Type="System.Runtime.Serialization.Configuration.ParameterElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the position of the specified element in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position of the specified element.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Runtime.Serialization.Configuration.ParameterElement" /> element to find.</param>
       </Docs>
diff --git a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization.Configuration/SerializationSectionGroup.xml b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization.Configuration/SerializationSectionGroup.xml
index ae870a1784c..4325de0384f 100644
--- a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization.Configuration/SerializationSectionGroup.xml
+++ b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization.Configuration/SerializationSectionGroup.xml
@@ -71,12 +71,15 @@
         <Parameter Name="config" Type="System.Configuration.Configuration" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the serialization configuration section for the specified configuration.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Serialization.Configuration.SerializationSectionGroup" /> that represents the configuration section.</para>
+        </returns>
         <param name="config">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Configuration.Configuration" /> that represents the configuration to retrieve.</param>
       </Docs>
diff --git a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization.Configuration/TypeElementCollection.xml b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization.Configuration/TypeElementCollection.xml
index e80bd160c6e..308bcc87126 100644
--- a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization.Configuration/TypeElementCollection.xml
+++ b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization.Configuration/TypeElementCollection.xml
@@ -171,12 +171,15 @@
         <Parameter Name="element" Type="System.Runtime.Serialization.Configuration.TypeElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the position of the specified element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position of the specified element.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Runtime.Serialization.Configuration.TypeElement" /> to find in the collection.</param>
       </Docs>
diff --git a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization.Json/DataContractJsonSerializer.xml b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization.Json/DataContractJsonSerializer.xml
index 51430f88afe..10650847d31 100644
--- a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization.Json/DataContractJsonSerializer.xml
+++ b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization.Json/DataContractJsonSerializer.xml
@@ -393,7 +393,6 @@
         <Parameter Name="reader" Type="System.Xml.XmlDictionaryReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Runtime.Serialization.Json.DataContractJsonSerializer.IsStartObject(System.Xml.XmlDictionaryReader)" /> determines whether it can read a object by checking that it is positioned on an XML element. It also examines the name and namespace of the XML element that the reader is positioned at and compares the values to the expected name and namespace. The expected name can be set with the <paramref name="rootName" /> value passed into the constructor (if present), or is "root" if absent. The expected namespace is the empty string.</para>
@@ -403,6 +402,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that specifies whether the <see cref="T:System.Xml.XmlDictionaryReader" /> is positioned over an XML element that represents an object the serializer can deserialize from.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the reader is positioned correctly; otherwise, false.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlDictionaryReader" /> used to read the XML stream mapped from JSON.</param>
       </Docs>
@@ -421,7 +424,6 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method checks whether the reader is positioned on an element that can be deserialized, and returns true if it is. To return true, the found element must have the expected name. </para>
@@ -430,6 +432,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Xml.XmlReader" /> is positioned on an object that can be deserialized.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the reader is positioned correctly; otherwise, false.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> used to read the XML stream.</param>
       </Docs>
@@ -490,12 +496,15 @@
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a document stream in the JSON (JavaScript Object Notation) format and returns the deserialized object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The deserialized object.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.Stream" /> to be read.</param>
       </Docs>
@@ -514,12 +523,15 @@
         <Parameter Name="reader" Type="System.Xml.XmlDictionaryReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the XML document mapped from JSON (JavaScript Object Notation) with an <see cref="T:System.Xml.XmlDictionaryReader" /> and returns the deserialized object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The deserialized object.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlDictionaryReader" /> used to read the XML document mapped from JSON.</param>
       </Docs>
@@ -538,12 +550,15 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the XML document mapped from JSON (JavaScript Object Notation) with an <see cref="T:System.Xml.XmlReader" /> and returns the deserialized object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The deserialized object.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlReader" /> used to read the XML document mapped from JSON.</param>
       </Docs>
@@ -563,12 +578,15 @@
         <Parameter Name="verifyObjectName" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the XML document mapped from JSON with an <see cref="T:System.Xml.XmlDictionaryReader" /> and returns the deserialized object; it also enables you to specify whether the serializer should verify that it is positioned on an appropriate element before attempting to deserialize.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The deserialized object.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlDictionaryReader" /> used to read the XML document mapped from JSON.</param>
         <param name="verifyObjectName">
@@ -590,12 +608,15 @@
         <Parameter Name="verifyObjectName" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads an XML document mapped from JSON with an <see cref="T:System.Xml.XmlReader" /> and returns the deserialized object; it also enables you to specify whether the serializer should verify that it is positioned on an appropriate element before attempting to deserialize.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The deserialized object.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlReader" /> used to read the XML document mapped from JSON.</param>
         <param name="verifyObjectName">
diff --git a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization.Json/JsonReaderWriterFactory.xml b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization.Json/JsonReaderWriterFactory.xml
index e500313b5c8..4d6dfc1b15c 100644
--- a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization.Json/JsonReaderWriterFactory.xml
+++ b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization.Json/JsonReaderWriterFactory.xml
@@ -36,7 +36,6 @@
         <Parameter Name="quotas" Type="System.Xml.XmlDictionaryReaderQuotas" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload does not accept an <see cref="T:System.Text.Encoding" /> parameter. The character encoding (UTF-8, Unicode or Big-Endian Unicode) is auto-detected when the data is read.</para>
@@ -46,6 +45,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XmlDictionaryReader" /> that can map buffers encoded with JavaScript Object Notation (JSON) to an XML Infoset.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlDictionaryReader" /> that can process JavaScript Object Notation (JSON) data.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The input <see cref="T:System.Byte" /> buffer array from which to read.</param>
         <param name="quotas">
@@ -67,7 +70,6 @@
         <Parameter Name="quotas" Type="System.Xml.XmlDictionaryReaderQuotas" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload does not take an <see cref="T:System.Text.Encoding" /> parameter. The character encoding (UTF-8, Unicode or Big-Endian Unicode) is auto-detected when the data is read.</para>
@@ -77,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XmlDictionaryReader" /> that can map streams encoded with JavaScript Object Notation (JSON) to an XML Infoset.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlDictionaryReader" /> that can read JavaScript Object Notation (JSON).</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The input <see cref="T:System.IO.Stream" /> from which to read.</param>
         <param name="quotas">
@@ -100,7 +106,6 @@
         <Parameter Name="quotas" Type="System.Xml.XmlDictionaryReaderQuotas" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload does not take an <see cref="T:System.Text.Encoding" /> parameter. The character encoding (UTF-8, Unicode or Big-Endian Unicode) is auto-detected when the data is read.</para>
@@ -110,6 +115,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XmlDictionaryReader" /> that can map buffers encoded with JavaScript Object Notation (JSON), of a specified size and offset, to an XML Infoset.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlDictionaryReader" /> that can read JavaScript Object Notation (JSON).</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The input <see cref="T:System.Byte" /> buffer array from which to read.</param>
         <param name="offset">
@@ -137,7 +146,6 @@
         <Parameter Name="onClose" Type="System.Xml.OnXmlDictionaryReaderClose" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>crabout using <see cref="T:System.Xml.XmlDictionaryReaderQuotas" /> to prevent Denial of Service attacks when reading untrusted data, see <format type="text/html"><a href="a7eb98da-4a93-4692-8b59-9d670c79ffb2">Security Considerations for Data</a></format>.</para>
@@ -146,6 +154,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XmlDictionaryReader" /> that can map streams encoded with JavaScript Object Notation (JSON), of a specified size and offset, to an XML Infoset.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlDictionaryReader" /> that can read JavaScript Object Notation (JSON).</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The input <see cref="T:System.IO.Stream" /> from which to read.</param>
         <param name="encoding">
@@ -175,7 +187,6 @@
         <Parameter Name="onClose" Type="System.Xml.OnXmlDictionaryReaderClose" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>crabout using <see cref="T:System.Xml.XmlDictionaryReaderQuotas" /> to prevent Denial of Service attacks when reading untrusted data, see <format type="text/html"><a href="a7eb98da-4a93-4692-8b59-9d670c79ffb2">Security Considerations for Data</a></format>.</para>
@@ -184,6 +195,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XmlDictionaryReader" /> that can map buffers encoded with JavaScript Object Notation (JSON), with a specified size and offset and character encoding, to an XML Infoset. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlDictionaryReader" /> that can read JavaScript Object Notation (JSON).</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The input <see cref="T:System.Byte" /> buffer array from which to read.</param>
         <param name="offset">
@@ -212,7 +227,6 @@
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default character encoding is UTF-8. When the writer is closed, the stream is closed as well.</para>
@@ -221,6 +235,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XmlDictionaryWriter" /> that writes data encoded with JSON to a stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlDictionaryWriter" /> that writes data encoded with JSON to the stream based on an XML Infoset.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The output <see cref="T:System.IO.Stream" /> for the JSON writer.</param>
       </Docs>
@@ -240,7 +258,6 @@
         <Parameter Name="encoding" Type="System.Text.Encoding" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When the writer is closed, the stream is closed as well.</para>
@@ -249,6 +266,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XmlDictionaryWriter" /> that writes data encoded with JSON to a stream with a specified character encoding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlDictionaryWriter" /> that writes data encoded with JSON to the stream based on an XML Infoset.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The output <see cref="T:System.IO.Stream" /> for the JSON writer.</param>
         <param name="encoding">
@@ -271,12 +292,15 @@
         <Parameter Name="ownsStream" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XmlDictionaryWriter" /> that writes data encoded with JSON to a stream with a specified character encoding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlDictionaryWriter" /> that writes data encoded with JSON to the stream based on an XML Infoset.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The output <see cref="T:System.IO.Stream" /> for the JSON writer.</param>
         <param name="encoding">
diff --git a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/DataContractResolver.xml b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/DataContractResolver.xml
index 655693b1764..b528e40ce74 100644
--- a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/DataContractResolver.xml
+++ b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/DataContractResolver.xml
@@ -57,7 +57,6 @@
         <Parameter Name="knownTypeResolver" Type="System.Runtime.Serialization.DataContractResolver" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you want to use the known type resolution logic inside your implementation, a reference to it is passed in as the <paramref name="knownTypeResolver" /> parameter.</para>
@@ -66,6 +65,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Override this method to map the specified xsi:type name and namespace to a data contract type during deserialization.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type the xsi:type name and namespace is mapped to. </para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The xsi:type name to map.</param>
         <param name="typeNamespace">
diff --git a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/DataContractSerializer.xml b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/DataContractSerializer.xml
index 954ce6ec1c0..9f5711fc0ff 100644
--- a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/DataContractSerializer.xml
+++ b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/DataContractSerializer.xml
@@ -556,7 +556,6 @@
         <Parameter Name="reader" Type="System.Xml.XmlDictionaryReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Runtime.Serialization.DataContractSerializer.IsStartObject(System.Xml.XmlDictionaryReader)" /> determines whether it can read an object by checking that it is positioned on an XML element. It also examines the name and namespace of the XML element that the reader is positioned at and compares the values to the expected name and namespace. The expected name and namespace can be set with the following: the data contract name and namespace of the type passed into the constructor, or the <paramref name="rootName" /> and <paramref name="rootNamespace" /> values passed into the constructor (if present).</para>
@@ -565,6 +564,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Xml.XmlDictionaryReader" /> is positioned on an object that can be deserialized.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the reader is at the start element of the stream to read; otherwise, false.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlDictionaryReader" /> used to read the XML stream.</param>
       </Docs>
@@ -583,12 +586,15 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Xml.XmlReader" /> is positioned on an object that can be deserialized.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the reader is at the start element of the stream to read; otherwise, false.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> used to read the XML stream.</param>
       </Docs>
@@ -676,12 +682,15 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the XML stream with an <see cref="T:System.Xml.XmlReader" /> and returns the deserialized object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The deserialized object.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> used to read the XML stream.</param>
       </Docs>
@@ -701,12 +710,15 @@
         <Parameter Name="verifyObjectName" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the XML stream with an <see cref="T:System.Xml.XmlDictionaryReader" /> and returns the deserialized object, and also specifies whether a check is made to verify the object name before reading its value. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The deserialized object.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlDictionaryReader" /> used to read the XML stream.</param>
         <param name="verifyObjectName">
@@ -728,12 +740,15 @@
         <Parameter Name="verifyObjectName" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the XML stream with an <see cref="T:System.Xml.XmlReader" /> and returns the deserialized object, and also specifies whether a check is made to verify the object name before reading its value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The deserialized object.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> used to read the XML stream.</param>
         <param name="verifyObjectName">
@@ -757,12 +772,15 @@
       </Parameters>
       <Docs>
         <param name="resolver">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads an XML document or document stream and returns the deserialized object.  The method includes a parameter to specify whether the object name is verified is validated, and a resolver for mapping xsi:type declarations at runtime.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The deserialized object.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The XML reader used to read the content.</param>
         <param name="verifyObjectName">
diff --git a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/IDataContractSurrogate.xml b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/IDataContractSurrogate.xml
index f090c131318..63311e28fd4 100644
--- a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/IDataContractSurrogate.xml
+++ b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/IDataContractSurrogate.xml
@@ -35,12 +35,15 @@
         <Parameter Name="dataContractType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>During schema export operations, inserts annotations into the schema for non-null return values. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the annotation to be inserted into the XML schema definition. </para>
+        </returns>
         <param name="memberInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Reflection.MemberInfo" /> that describes the member. </param>
         <param name="dataContractType">
@@ -62,12 +65,15 @@
         <Parameter Name="dataContractType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>During schema export operations, inserts annotations into the schema for non-null return values. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the annotation to be inserted into the XML schema definition. </para>
+        </returns>
         <param name="clrType">
           <attribution license="cc4" from="Microsoft" modified="false" />The CLR type to be replaced. </param>
         <param name="dataContractType">
@@ -88,12 +94,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>During serialization, deserialization, and schema import and export, returns a data contract type that substitutes the specified type. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> to substitute for the <paramref name="type" /> value. This type must be serializable by the <see cref="T:System.Runtime.Serialization.DataContractSerializer" />. For example, it must be marked with the <see cref="T:System.Runtime.Serialization.DataContractAttribute" /> attribute or other mechanisms that the serializer recognizes.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The CLR type <see cref="T:System.Type" /> to substitute. </param>
       </Docs>
@@ -113,7 +122,6 @@
         <Parameter Name="targetType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In a simple implementation, use an if…then…else control structure to test whether the <paramref name="obj" /> value is of the surrogated type. If so, transform it as necessary and return the substituted object. The substituted object can be a new instance or the same <paramref name="obj" /> instance.</para>
@@ -122,6 +130,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>During deserialization, returns an object that is a substitute for the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The substituted deserialized object. This object must be of a type that is serializable by the <see cref="T:System.Runtime.Serialization.DataContractSerializer" />. For example, it must be marked with the <see cref="T:System.Runtime.Serialization.DataContractAttribute" /> attribute or other mechanisms that the serializer recognizes.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The deserialized object to be substituted.</param>
         <param name="targetType">
@@ -169,7 +181,6 @@
         <Parameter Name="targetType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method must not return null because on deserialization the data will be cast to type <see cref="T:System.Object" /> and an <see cref="T:System.InvalidCastException" /> is thrown.  </para>
@@ -178,6 +189,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>During serialization, returns an object that substitutes the specified object. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The substituted object that will be serialized. The object must be serializable by the <see cref="T:System.Runtime.Serialization.DataContractSerializer" />. For example, it must be marked with the <see cref="T:System.Runtime.Serialization.DataContractAttribute" /> attribute or other mechanisms that the serializer recognizes.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to substitute. </param>
         <param name="targetType">
@@ -200,7 +215,6 @@
         <Parameter Name="customData" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Null should be returned if a CLR type does not exist for representing the schema type. This will cause a new type to be generated during schema import.</para>
@@ -209,6 +223,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>During schema import, returns the type referenced by the schema.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> to use for the referenced type.</para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the type in schema.</param>
         <param name="typeNamespace">
@@ -232,7 +250,6 @@
         <Parameter Name="compileUnit" Type="System.CodeDom.CodeCompileUnit" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The input <see cref="T:System.CodeDom.CodeTypeDeclaration" /> or other information in the <see cref="T:System.CodeDom.CodeCompileUnit" /> can be modified by the user in this method. If null is returned, it will cause the type to not be generated. If a new <see cref="T:System.CodeDom.CodeTypeDeclaration" /> is returned, it will replace the original type generated.</para>
@@ -241,6 +258,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the type that has been generated from the imported schema.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.CodeTypeDeclaration" /> that contains the processed type.</para>
+        </returns>
         <param name="typeDeclaration">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.CodeTypeDeclaration" /> to process that represents the type declaration generated during schema import.</param>
         <param name="compileUnit">
diff --git a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/NetDataContractSerializer.xml b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/NetDataContractSerializer.xml
index ac30b57b320..c66e94f4b73 100644
--- a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/NetDataContractSerializer.xml
+++ b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/NetDataContractSerializer.xml
@@ -313,7 +313,6 @@
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method assumes the default format is text XML.</para>
@@ -325,6 +324,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes an XML document or stream into an object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The deserialized object.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IO.Stream" /> that contains the XML to deserialize.</param>
       </Docs>
@@ -365,7 +368,6 @@
         <Parameter Name="reader" Type="System.Xml.XmlDictionaryReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Runtime.Serialization.DataContractSerializer.IsStartObject(System.Xml.XmlDictionaryReader)" /> determines whether it can read an object by examining the name and namespace of the XML element the reader is positioned at, and comparing the values to expected name and namespace. The expected name and namespace can be set with the following: the data contract name and namespace of the type passed into the constructor, or the <paramref name="rootName" /> and <paramref name="rootNamespace" /> values passed into the constructor (if present).</para>
@@ -375,6 +377,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Xml.XmlDictionaryReader" /> is positioned on an object that can be deserialized using the specified reader.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if the reader is at the start element of the stream to read; otherwise, false.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlDictionaryReader" /> that contains the XML to read.</param>
       </Docs>
@@ -417,7 +423,6 @@
       </Parameters>
       <Docs>
         <param name="readContentOnly">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="verifyObjectName" /> parameter determines whether it can read an object by examining the name and namespace of the XML element the reader is positioned at, and comparing the values to expected name and namespace. The expected name and namespace can be set with the following: the data contract name and namespace of the type passed into the constructor, or the <paramref name="rootName" /> and <paramref name="rootNamespace" /> values passed into the constructor (if present).</para>
@@ -430,6 +435,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the XML stream or document with an <see cref="T:System.Xml.XmlDictionaryReader" /> and returns the deserialized object; also checks whether the object data conforms to the name and namespace used to create the serializer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The deserialized object.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlDictionaryReader" /> used to read the XML stream or document.</param>
       </Docs>
diff --git a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/XmlObjectSerializer.xml b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/XmlObjectSerializer.xml
index 41d3b271ac5..c42eee9a307 100644
--- a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/XmlObjectSerializer.xml
+++ b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/XmlObjectSerializer.xml
@@ -54,7 +54,6 @@
         <Parameter Name="reader" Type="System.Xml.XmlDictionaryReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method checks if the reader is positioned on an element to read, and returns true if the element is the top-level element for the object found in the XML stream or document. The <see cref="T:System.Runtime.Serialization.XmlObjectSerializer" /> implementation determines when to return true. Implementations may check that they are positioned on an element or look for an expected element name. One implementation of the <see cref="T:System.Runtime.Serialization.XmlObjectSerializer" />, the <see cref="T:System.Runtime.Serialization.DataContractSerializer" />, checks that it is positioned on an element and also checks that the element name is the top level expected name for the type currently being deserialized. </para>
@@ -64,6 +63,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that specifies whether the <see cref="T:System.Xml.XmlDictionaryReader" /> is positioned over an XML element that can be read.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the reader can read the data; otherwise, false.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlDictionaryReader" /> used to read the XML stream or document.</param>
       </Docs>
@@ -82,7 +85,6 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method checks whether the reader is positioned on an element to read, and returns true if the element is the top-level element for the object found in the XML stream or document. To return true, the found element must have an expected name. The actual expected element name depends on the implementation of the serializer. </para>
@@ -92,6 +94,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that specifies whether the <see cref="T:System.Xml.XmlReader" /> is positioned over an XML element that can be read. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the reader is positioned over the starting element; otherwise, false.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlReader" /> used to read the XML stream or document.</param>
       </Docs>
@@ -110,7 +116,6 @@
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is a virtual method, and has a default implementation that creates a dictionary reader to read the underlying stream and deserialize it. The default implementation assumes the stream is text or XML. </para>
@@ -119,6 +124,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the XML stream or document with a <see cref="T:System.IO.Stream" /> and returns the deserialized object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The deserialized object.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IO.Stream" /> used to read the XML stream or document.</param>
       </Docs>
@@ -137,7 +146,6 @@
         <Parameter Name="reader" Type="System.Xml.XmlDictionaryReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is a virtual method, and has a default implementation that creates a dictionary reader to read the underlying stream and deserialize it. The default implementation assumes the stream is text or XML. </para>
@@ -146,6 +154,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the XML document or stream with an <see cref="T:System.Xml.XmlDictionaryReader" /> and returns the deserialized object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The deserialized object.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlDictionaryReader" /> used to read the XML document.</param>
       </Docs>
@@ -164,12 +176,15 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the XML document or stream with an <see cref="T:System.Xml.XmlReader" /> and returns the deserialized object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The deserialized object.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlReader" /> used to read the XML stream or document.</param>
       </Docs>
@@ -190,7 +205,6 @@
       </Parameters>
       <Docs>
         <param name="readContentOnly">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="verifyObjectName" /> parameter uses the same code as the <see cref="Overload:System.Runtime.Serialization.XmlObjectSerializer.IsStartObject" /> method to determine whether the element is the start of the object.</para>
@@ -199,6 +213,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the XML stream or document with an <see cref="T:System.Xml.XmlDictionaryReader" /> and returns the deserialized object; it also enables you to specify whether the serializer can read the data before attempting to read it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The deserialized object.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlDictionaryReader" /> used to read the XML document.</param>
       </Docs>
@@ -219,7 +237,6 @@
       </Parameters>
       <Docs>
         <param name="readContentOnly">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="verifyObjectName" /> parameter uses the same code as the <see cref="Overload:System.Runtime.Serialization.XmlObjectSerializer.IsStartObject" /> method to determine whether the element is the start of the object.</para>
@@ -228,6 +245,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the XML document or stream with an <see cref="T:System.Xml.XmlReader" /> and returns the deserialized object; it also enables you to specify whether the serializer can read the data before attempting to read it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The deserialized object.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlReader" /> used to read the XML document or stream.</param>
       </Docs>
diff --git a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/XmlSerializableServices.xml b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/XmlSerializableServices.xml
index ece075a65dc..4dc9a052b21 100644
--- a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/XmlSerializableServices.xml
+++ b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/XmlSerializableServices.xml
@@ -65,7 +65,6 @@
         <Parameter Name="xmlReader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method reads all XML contained within the node the reader is positioned on when this call is made. This enables it to read and store all XML as an array of <see cref="T:System.Xml.XmlNode" /> objects. It is a helper method used by the types that implement <see cref="T:System.Xml.Serialization.IXmlSerializable" /> and that use the <see cref="M:System.Xml.Serialization.IXmlSerializable.ReadXml(System.Xml.XmlReader)" /> method.</para>
@@ -74,6 +73,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a set of XML nodes from the specified reader and returns the result.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Xml.XmlNode" />. </para>
+        </returns>
         <param name="xmlReader">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlReader" /> used for reading.</param>
       </Docs>
diff --git a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/XsdDataContractExporter.xml b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/XsdDataContractExporter.xml
index 7686d3fde03..14c42953bfc 100644
--- a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/XsdDataContractExporter.xml
+++ b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/XsdDataContractExporter.xml
@@ -99,12 +99,15 @@
         <Parameter Name="assemblies" Type="System.Collections.Generic.ICollection&lt;System.Reflection.Assembly&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the set of .common language runtime (CLR) types contained in a set of assemblies can be exported. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the types can be exported; otherwise, false.</para>
+        </returns>
         <param name="assemblies">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Collections.Generic.ICollection`1" />   of <see cref="T:System.Reflection.Assembly" /> that contains the assemblies with the types to export.</param>
       </Docs>
@@ -123,12 +126,15 @@
         <Parameter Name="types" Type="System.Collections.Generic.ICollection&lt;System.Type&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the set of .common language runtime (CLR) types contained in a <see cref="T:System.Collections.Generic.ICollection`1" /> can be exported. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the types can be exported; otherwise, false.</para>
+        </returns>
         <param name="types">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Collections.Generic.ICollection`1" />   that contains the specified types to export.</param>
       </Docs>
@@ -147,12 +153,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the specified common language runtime (CLR) type can be exported. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the type can be exported; otherwise, false. </para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> to export. </param>
       </Docs>
@@ -243,12 +252,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the top-level name and namespace for the <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.XmlQualifiedName" /> that represents the top-level name and namespace for this <see cref="T:System.Type" />, which is written to the stream when writing this object. </para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> to query.</param>
       </Docs>
@@ -267,7 +279,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The main purpose of this method is to allow anonymous types in XML schema to be represented. Because anonymous types do not have a contract name and namespace, they cannot be looked up using the <see cref="M:System.Runtime.Serialization.XsdDataContractExporter.GetSchemaTypeName(System.Type)" />. This method returns the <see cref="T:System.Xml.Schema.XmlSchemaType" /> definition for such types. The types for which the <see cref="M:System.Runtime.Serialization.XsdDataContractExporter.GetSchemaTypeName(System.Type)" /> method returns a valid name, this method returns null.</para>
@@ -276,6 +287,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML schema type for the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Schema.XmlSchemaType" /> that contains the XML schema. </para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to return a schema for.</param>
       </Docs>
@@ -294,12 +309,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the contract name and contract namespace for the <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlQualifiedName" /> that represents the contract name of the type and its namespace.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> that was exported. </param>
       </Docs>
diff --git a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/XsdDataContractImporter.xml b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/XsdDataContractImporter.xml
index 22371562c5c..8ef39ea8c26 100644
--- a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/XsdDataContractImporter.xml
+++ b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Runtime.Serialization/XsdDataContractImporter.xml
@@ -78,12 +78,15 @@
         <Parameter Name="schemas" Type="System.Xml.Schema.XmlSchemaSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the schemas contained in an <see cref="T:System.Xml.Schema.XmlSchemaSet" /> can be transformed into a <see cref="T:System.CodeDom.CodeCompileUnit" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the schemas can be transformed to data contract types; otherwise, false. </para>
+        </returns>
         <param name="schemas">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.Schema.XmlSchemaSet" /> that contains the schemas to transform. </param>
       </Docs>
@@ -103,12 +106,15 @@
         <Parameter Name="typeNames" Type="System.Collections.Generic.ICollection&lt;System.Xml.XmlQualifiedName&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the specified set of types contained in an <see cref="T:System.Xml.Schema.XmlSchemaSet" /> can be transformed into CLR types generated into a <see cref="T:System.CodeDom.CodeCompileUnit" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the schemas can be transformed; otherwise, false. </para>
+        </returns>
         <param name="schemas">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.Schema.XmlSchemaSet" /> that contains the schemas to transform.</param>
         <param name="typeNames">
@@ -130,7 +136,6 @@
         <Parameter Name="element" Type="System.Xml.Schema.XmlSchemaElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method checks the type and all schema types referenced from it.</para>
@@ -139,6 +144,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether a specific schema element contained in an <see cref="T:System.Xml.Schema.XmlSchemaSet" /> can be imported.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the element can be imported; otherwise, false.</para>
+        </returns>
         <param name="schemas">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.Schema.XmlSchemaSet" /> to import.</param>
         <param name="element">
@@ -160,7 +169,6 @@
         <Parameter Name="typeName" Type="System.Xml.XmlQualifiedName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information about types that can be imported, see <format type="text/html"><a href="7381b200-437a-4506-9556-d77bf1bc3f34">Types Supported by the Data Contract Serializer</a></format>.</para>
@@ -169,6 +177,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the schemas contained in an <see cref="T:System.Xml.Schema.XmlSchemaSet" /> can be transformed into a <see cref="T:System.CodeDom.CodeCompileUnit" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the schemas can be transformed to data contract types; otherwise, false.</para>
+        </returns>
         <param name="schemas">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.Schema.XmlSchemaSet" /> that contains the schema representations. </param>
         <param name="typeName">
@@ -211,7 +223,6 @@
         <Parameter Name="typeName" Type="System.Xml.XmlQualifiedName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to look up the reference to a generated CLR type after calling the <see cref="Overload:System.Runtime.Serialization.XsdDataContractImporter.Import" /> method. The <see cref="T:System.CodeDom.CodeTypeReference" /> contains the name of the generated type and can be used to look up the corresponding <see cref="T:System.CodeDom.CodeTypeDeclaration" /> in the <see cref="T:System.CodeDom.CodeCompileUnit" />.</para>
@@ -220,6 +231,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.CodeDom.CodeTypeReference" /> to the CLR type generated for the schema type with the specified <see cref="T:System.Xml.XmlQualifiedName" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.CodeTypeReference" /> reference to the CLR type generated for the schema type with the <paramref name="typeName" /> specified.</para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlQualifiedName" /> that specifies the schema type to look up.</param>
       </Docs>
@@ -239,7 +254,6 @@
         <Parameter Name="element" Type="System.Xml.Schema.XmlSchemaElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The schema element is needed for data about the type that is specified at the element scope. The main example of this is the XSD attribute nillable. In schema, setting nillable to true is specified on the containing schema element whereas the concept of null is expressed in the CLR type <see cref="T:System.Nullable`1" />. The element is passed in so that this importer can look up the element-level information and return the correct type reference accordingly. </para>
@@ -249,6 +263,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.CodeDom.CodeTypeReference" /> for the specified XML qualified element and schema element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.CodeTypeReference" /> that represents the type that was generated for the specified schema type.</para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlQualifiedName" /> that specifies the XML qualified name of the schema type to look up.</param>
         <param name="element">
@@ -269,7 +287,6 @@
         <Parameter Name="typeName" Type="System.Xml.XmlQualifiedName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When generating CLR types for schema types, known types are also generated for all derived types that are present in the schema. In many cases, these known types are added using attributes to the generated code. (For example, see the <see cref="T:System.Runtime.Serialization.KnownTypeAttribute" /> class. ) However, for the top-level type, there needs to be a way to return the set of known types generated. This method returns the <see cref="T:System.CodeDom.CodeTypeReference" /> for known types that were generated for a specific schema type.</para>
@@ -279,6 +296,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a list of <see cref="T:System.CodeDom.CodeTypeReference" /> objects that represents the known types generated when generating code for the specified schema type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.Generic.IList`1" /> of type <see cref="T:System.CodeDom.CodeTypeReference" />.</para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlQualifiedName" /> that represents the schema type to look up known types for.</param>
       </Docs>
@@ -347,12 +368,15 @@
         <Parameter Name="element" Type="System.Xml.Schema.XmlSchemaElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Transforms the specified schema element in the set of specified XML schemas into a <see cref="T:System.CodeDom.CodeCompileUnit" /> and returns an <see cref="T:System.Xml.XmlQualifiedName" /> that represents the data contract name for the specified element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlQualifiedName" /> that represents the specified element.</para>
+        </returns>
         <param name="schemas">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.Schema.XmlSchemaSet" /> that contains the schemas to transform.</param>
         <param name="element">
diff --git a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Xml/IStreamProvider.xml b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Xml/IStreamProvider.xml
index 2ef96495758..7a9a3fac54a 100644
--- a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Xml/IStreamProvider.xml
+++ b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Xml/IStreamProvider.xml
@@ -55,7 +55,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to return the stream to be written.</para>
@@ -64,6 +63,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReleaseStream">
diff --git a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Xml/UniqueId.xml b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Xml/UniqueId.xml
index c93c2801c89..06479c1d1c4 100644
--- a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Xml/UniqueId.xml
+++ b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Xml/UniqueId.xml
@@ -216,12 +216,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether an object equals this <see cref="T:System.Xml.UniqueId" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object equals this <see cref="T:System.Xml.UniqueId" />; otherwise false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare.</param>
       </Docs>
@@ -238,12 +241,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a hash-code representation of this <see cref="T:System.Xml.UniqueId" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer hash-code representation of this <see cref="T:System.Xml.UniqueId" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsGuid">
@@ -280,12 +286,15 @@
         <Parameter Name="id2" Type="System.Xml.UniqueId" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Overrides the equality operator to test for equality of two <see cref="T:System.Xml.UniqueId" />s.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two <see cref="T:System.Xml.UniqueId" />s are equal, or are both null; false if they are not equal, or if only one of them is null.</para>
+        </returns>
         <param name="id1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Xml.UniqueId" />.</param>
         <param name="id2">
@@ -307,12 +316,15 @@
         <Parameter Name="id2" Type="System.Xml.UniqueId" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Overrides the equality operator to test for inequality of two <see cref="T:System.Xml.UniqueId" />s.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the overridden equality operator returns false; otherwise false.</para>
+        </returns>
         <param name="id1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Xml.UniqueId" />.</param>
         <param name="id2">
@@ -343,7 +355,6 @@
       </Parameters>
       <Docs>
         <param name="array">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is unsafe.</para>
@@ -352,6 +363,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Puts the <see cref="T:System.Xml.UniqueId" /> value into a char array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Number of entries in the char array filled by the <see cref="T:System.Xml.UniqueId" /> value.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />Position in the char array to start inserting the <see cref="T:System.Xml.UniqueId" /> value.</param>
       </Docs>
@@ -376,12 +391,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays the <see cref="T:System.Xml.UniqueId" /> value in string format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the <see cref="T:System.Xml.UniqueId" /> value.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryGetGuid">
@@ -427,7 +445,6 @@
         <Parameter Name="offset" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is unsafe.</para>
@@ -436,6 +453,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tries to get the value of the <see cref="T:System.Xml.UniqueId" /> as a <see cref="T:System.Guid" /> and store it in the given byte array at the specified offest.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value stored in this instance of <see cref="T:System.Xml.UniqueId" /> is a <see cref="T:System.Guid" />; otherwise false.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />byte array that will contain the <see cref="T:System.Guid" />.</param>
         <param name="offset">
diff --git a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Xml/XmlBinaryReaderSession.xml b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Xml/XmlBinaryReaderSession.xml
index 81b825b02ed..6ca6514d65d 100644
--- a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Xml/XmlBinaryReaderSession.xml
+++ b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Xml/XmlBinaryReaderSession.xml
@@ -59,12 +59,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XmlDictionaryString" /> from the input parameters and adds it to an internal collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created <see cref="T:System.Xml.XmlDictionaryString" /> that is added to an internal collection.</para>
+        </returns>
         <param name="id">
           <attribution license="cc4" from="Microsoft" modified="false" />The key value.</param>
         <param name="value">
diff --git a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Xml/XmlDictionary.xml b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Xml/XmlDictionary.xml
index 31c74bb1737..dd5fb5326d0 100644
--- a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Xml/XmlDictionary.xml
+++ b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Xml/XmlDictionary.xml
@@ -80,7 +80,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A <see cref="T:System.Xml.XmlDictionaryString" /> is built from <paramref name="value" />.</para>
@@ -90,6 +89,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a string to the <see cref="T:System.Xml.XmlDictionary" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.XmlDictionaryString" /> that was added.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />String to add to the dictionary.</param>
       </Docs>
diff --git a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Xml/XmlDictionaryReader.xml b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Xml/XmlDictionaryReader.xml
index 54d741e7920..dc8d7aa3884 100644
--- a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Xml/XmlDictionaryReader.xml
+++ b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Xml/XmlDictionaryReader.xml
@@ -79,7 +79,6 @@
         <Parameter Name="quotas" Type="System.Xml.XmlDictionaryReaderQuotas" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Other <see cref="T:System.Xml.XmlDictionaryReader" /> properties are set to default values or null.</para>
@@ -88,6 +87,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryReader" /> that can read .NET Binary XML Format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryReader" />.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer from which to read.</param>
         <param name="quotas">
@@ -109,7 +112,6 @@
         <Parameter Name="quotas" Type="System.Xml.XmlDictionaryReaderQuotas" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Other <see cref="T:System.Xml.XmlDictionaryReader" /> properties are set to default values or null.</para>
@@ -118,6 +120,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryReader" /> that can read .NET Binary XML Format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryReader" />.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream from which to read.</param>
         <param name="quotas">
@@ -140,7 +146,6 @@
         <Parameter Name="quotas" Type="System.Xml.XmlDictionaryReaderQuotas" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Other <see cref="T:System.Xml.XmlDictionaryReader" /> properties are set to default values or null.</para>
@@ -149,6 +154,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryReader" /> that can read .NET Binary XML Format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryReader" />.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream from which to read.</param>
         <param name="dictionary">
@@ -175,7 +184,6 @@
         <Parameter Name="quotas" Type="System.Xml.XmlDictionaryReaderQuotas" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Other <see cref="T:System.Xml.XmlDictionaryReader" /> properties are set to default values or null.</para>
@@ -184,6 +192,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryReader" /> that can read .NET Binary XML Format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryReader" />.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer from which to read.</param>
         <param name="offset">
@@ -211,7 +223,6 @@
         <Parameter Name="session" Type="System.Xml.XmlBinaryReaderSession" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Other <see cref="T:System.Xml.XmlDictionaryReader" /> properties are set to default values or null.</para>
@@ -220,6 +231,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryReader" /> that can read .NET Binary XML Format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryReader" />.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream from which to read.</param>
         <param name="dictionary">
@@ -250,7 +265,6 @@
         <Parameter Name="quotas" Type="System.Xml.XmlDictionaryReaderQuotas" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Other <see cref="T:System.Xml.XmlDictionaryReader" /> properties are set to default values or null.</para>
@@ -259,6 +273,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryReader" /> that can read .NET Binary XML Format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryReader" />.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer from which to read.</param>
         <param name="offset">
@@ -290,7 +308,6 @@
         <Parameter Name="onClose" Type="System.Xml.OnXmlDictionaryReaderClose" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Other <see cref="T:System.Xml.XmlDictionaryReader" /> properties are set to default values or null.</para>
@@ -299,6 +316,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryReader" /> that can read .NET Binary XML Format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryReader" />.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream from which to read.</param>
         <param name="dictionary">
@@ -333,7 +354,6 @@
         <Parameter Name="session" Type="System.Xml.XmlBinaryReaderSession" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Other <see cref="T:System.Xml.XmlDictionaryReader" /> properties are set to default values or null.</para>
@@ -342,6 +362,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryReader" /> that can read .NET Binary XML Format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryReader" />.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer from which to read.</param>
         <param name="offset">
@@ -376,7 +400,6 @@
         <Parameter Name="onClose" Type="System.Xml.OnXmlDictionaryReaderClose" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Other <see cref="T:System.Xml.XmlDictionaryReader" /> properties are set to default values or null.</para>
@@ -385,6 +408,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryReader" /> that can read .NET Binary XML Format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryReader" />.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer from which to read.</param>
         <param name="offset">
@@ -415,12 +442,15 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryReader" /> from an existing <see cref="T:System.Xml.XmlReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryReader" />.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of <see cref="T:System.Xml.XmlReader" />.</param>
       </Docs>
@@ -441,7 +471,6 @@
         <Parameter Name="quotas" Type="System.Xml.XmlDictionaryReaderQuotas" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method reads from a stream, using the character encoding specified by <paramref name="encoding" />, an instance of <see cref="T:System.Text.Encoding" />.</para>
@@ -450,6 +479,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryReader" /> that reads XML in the MTOM format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryReader" />.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream from which to read.</param>
         <param name="encoding">
@@ -474,7 +507,6 @@
         <Parameter Name="quotas" Type="System.Xml.XmlDictionaryReaderQuotas" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method reads from a stream, using one of the character encodings specified by <paramref name="encodings" />, an array of instances of <see cref="T:System.Text.Encoding" />.</para>
@@ -483,6 +515,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryReader" /> that reads XML in the MTOM format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryReader" />.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream from which to read.</param>
         <param name="encodings">
@@ -508,7 +544,6 @@
         <Parameter Name="quotas" Type="System.Xml.XmlDictionaryReaderQuotas" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method reads from a stream, using one of the character encodings specified by <paramref name="encodings" />, an array of instances of <see cref="T:System.Text.Encoding" />. The message is of the specified MIME type. If <paramref name="contentType" /> is null, the Content-Type MIME header must be present in the message.</para>
@@ -517,6 +552,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryReader" /> that reads XML in the MTOM format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryReader" />.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream from which to read.</param>
         <param name="encodings">
@@ -545,7 +584,6 @@
         <Parameter Name="quotas" Type="System.Xml.XmlDictionaryReaderQuotas" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method reads from a buffer with a specified offset and count, using the character encoding specified by <paramref name="encoding" />, an instance of <see cref="T:System.Text.Encoding" />.</para>
@@ -554,6 +592,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryReader" /> that reads XML in the MTOM format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryReader" />.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer from which to read.</param>
         <param name="offset">
@@ -584,7 +626,6 @@
         <Parameter Name="quotas" Type="System.Xml.XmlDictionaryReaderQuotas" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method reads from a buffer with a specified offset and count, using one of the character encodings specified by <paramref name="encodings" />, an array of instances of <see cref="T:System.Text.Encoding" />.</para>
@@ -593,6 +634,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryReader" /> that reads XML in the MTOM format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryReader" />.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer from which to read.</param>
         <param name="offset">
@@ -624,7 +669,6 @@
         <Parameter Name="quotas" Type="System.Xml.XmlDictionaryReaderQuotas" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method reads from a buffer with a specified offset and count, using one of the  character encodings specified by <paramref name="encodings" />, an array of instances of <see cref="T:System.Text.Encoding" />. The message is of the specified MIME type. If <paramref name="contentType" /> is null, the Content-Type MIME header must be present in the message.</para>
@@ -633,6 +677,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryReader" /> that reads XML in the MTOM format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryReader" />.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer from which to read.</param>
         <param name="offset">
@@ -666,7 +714,6 @@
         <Parameter Name="onClose" Type="System.Xml.OnXmlDictionaryReaderClose" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method reads from a stream, using one of the character encodings specified by <paramref name="encodings" />, an array of instances of <see cref="T:System.Text.Encoding" />. The message is of the specified MIME type. If <paramref name="contentType" /> is null, the Content-Type MIME header must be present in the message.</para>
@@ -675,6 +722,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryReader" /> that reads XML in the MTOM format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryReader" />.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream from which to read.</param>
         <param name="encodings">
@@ -710,7 +761,6 @@
         <Parameter Name="onClose" Type="System.Xml.OnXmlDictionaryReaderClose" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method reads from a buffer with a specified offset and count, using one of the character encodings specified by <paramref name="encodings" />, an array of instances of <see cref="T:System.Text.Encoding" />. The message is of the specified MIME type. If <paramref name="contentType" /> is null, the Content-Type MIME header must be present in the message.</para>
@@ -719,6 +769,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryReader" /> that reads XML in the MTOM format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryReader" />.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer from which to read.</param>
         <param name="offset">
@@ -752,7 +806,6 @@
         <Parameter Name="quotas" Type="System.Xml.XmlDictionaryReaderQuotas" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The reader created is optimized for reading UTF-8 text.</para>
@@ -761,6 +814,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryReader" />.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer from which to read.</param>
         <param name="quotas">
@@ -782,7 +839,6 @@
         <Parameter Name="quotas" Type="System.Xml.XmlDictionaryReaderQuotas" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The reader created is optimized for reading UTF-8 text.</para>
@@ -791,6 +847,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryReader" />.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream from which to read.</param>
         <param name="quotas">
@@ -814,7 +874,6 @@
         <Parameter Name="quotas" Type="System.Xml.XmlDictionaryReaderQuotas" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The reader created is optimized for reading UTF-8 text.</para>
@@ -823,6 +882,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryReader" />.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer from which to read.</param>
         <param name="offset">
@@ -850,7 +913,6 @@
         <Parameter Name="onClose" Type="System.Xml.OnXmlDictionaryReaderClose" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The reader created is optimized for reading UTF-8 text.</para>
@@ -859,6 +921,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryReader" />.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream from which to read.</param>
         <param name="encoding">
@@ -888,7 +954,6 @@
         <Parameter Name="onClose" Type="System.Xml.OnXmlDictionaryReaderClose" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The reader created is optimized for reading UTF-8 text.</para>
@@ -897,6 +962,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryReader" />.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer from which to read.</param>
         <param name="offset">
@@ -945,12 +1014,15 @@
         <Parameter Name="namespaceUri" Type="System.Xml.XmlDictionaryString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, gets the value of an attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the attribute.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlDictionaryString" /> that represents the local name of the attribute.</param>
         <param name="namespaceUri">
@@ -972,7 +1044,6 @@
         <Parameter Name="namespaceUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -982,6 +1053,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the local name of the current node within an array of names.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the local name of the current node within an array of names.</para>
+        </returns>
         <param name="localNames">
           <attribution license="cc4" from="Microsoft" modified="false" />The string array of local names to be searched.</param>
         <param name="namespaceUri">
@@ -1003,7 +1078,6 @@
         <Parameter Name="namespaceUri" Type="System.Xml.XmlDictionaryString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -1013,6 +1087,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the local name of the current node within an array of names.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the local name of the current node within an array of names.</para>
+        </returns>
         <param name="localNames">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlDictionaryString" /> array of local names to be searched.</param>
         <param name="namespaceUri">
@@ -1053,12 +1131,15 @@
         <Parameter Name="localName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks whether the parameter, <paramref name="localName" />, is the local name of the current node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="localName" /> matches local name of the current node; otherwise false.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the current node.</param>
       </Docs>
@@ -1077,12 +1158,15 @@
         <Parameter Name="localName" Type="System.Xml.XmlDictionaryString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks whether the parameter, <paramref name="localName" />, is the local name of the current node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="localName" /> matches local name of the current node; otherwise false.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlDictionaryString" /> that represents the local name of the current node.</param>
       </Docs>
@@ -1101,12 +1185,15 @@
         <Parameter Name="namespaceUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks whether the parameter, <paramref name="namespaceUri" />, is the namespace of the current node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="namespaceUri" /> matches namespace of the current node; otherwise false.</para>
+        </returns>
         <param name="namespaceUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The namespace of current node.</param>
       </Docs>
@@ -1125,12 +1212,15 @@
         <Parameter Name="namespaceUri" Type="System.Xml.XmlDictionaryString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks whether the parameter, <paramref name="namespaceUri" />, is the namespace of the current node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="namespaceUri" /> matches namespace of the current node; otherwise false.</para>
+        </returns>
         <param name="namespaceUri">
           <attribution license="cc4" from="Microsoft" modified="false" />Namespace of current node.</param>
       </Docs>
@@ -1170,12 +1260,15 @@
         <Parameter Name="namespaceUri" Type="System.Xml.XmlDictionaryString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether the first tag is a start tag or empty element tag and if the local name and namespace URI match those of the current node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the first tag in the array is a start tag or empty element tag and matches <paramref name="localName" /> and <paramref name="namespaceUri" />; otherwise false.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlDictionaryString" /> that represents the local name of the attribute.</param>
         <param name="namespaceUri">
@@ -1196,12 +1289,15 @@
         <Parameter Name="nodeType" Type="System.Xml.XmlNodeType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether the current node is a text node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the node type is <see cref="F:System.Xml.XmlNodetype.Text" />, <see cref="F:System.Xml.XmlNodetype.Whitespace" />, <see cref="F:System.Xml.XmlNodetype.SignificantWhitespace" />, <see cref="F:System.Xml.XmlNodetype.CDATA" />, or <see cref="F:System.Xml.XmlNodetype.Attribute" />; otherwise false.</para>
+        </returns>
         <param name="nodeType">
           <attribution license="cc4" from="Microsoft" modified="false" />Type of the node being tested.</param>
       </Docs>
@@ -1338,12 +1434,15 @@
       </Parameters>
       <Docs>
         <param name="length">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads repeated occurrences of <see cref="T:System.Boolean" /> nodes into a typed array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of nodes put in the array.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -1373,12 +1472,15 @@
       </Parameters>
       <Docs>
         <param name="length">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads repeated occurrences of <see cref="T:System.DateTime" /> nodes into a typed array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of nodes put in the array.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -1408,12 +1510,15 @@
       </Parameters>
       <Docs>
         <param name="length">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads repeated occurrences of <see cref="T:System.Decimal" /> nodes into a typed array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of nodes put in the array.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -1443,12 +1548,15 @@
       </Parameters>
       <Docs>
         <param name="length">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads repeated occurrences of <see cref="T:System.Double" /> nodes into a typed array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of nodes put in the array.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -1478,12 +1586,15 @@
       </Parameters>
       <Docs>
         <param name="length">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads repeated occurrences of <see cref="T:System.Guid" /> nodes into a typed array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of nodes put in the array.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -1513,12 +1624,15 @@
       </Parameters>
       <Docs>
         <param name="length">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads repeated occurrences of short integers into a typed array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of integers put in the array.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -1548,12 +1662,15 @@
       </Parameters>
       <Docs>
         <param name="length">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads repeated occurrences of integers into a typed array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of integers put in the array.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -1583,12 +1700,15 @@
       </Parameters>
       <Docs>
         <param name="length">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads repeated occurrences of long integers into a typed array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of integers put in the array.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -1618,12 +1738,15 @@
       </Parameters>
       <Docs>
         <param name="length">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads repeated occurrences of float numbers into a typed array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The umber of float numbers put in the array.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -1653,12 +1776,15 @@
       </Parameters>
       <Docs>
         <param name="length">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads repeated occurrences of <see cref="T:System.TimeSpan" /> nodes into a typed array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of nodes put in the array.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -1688,12 +1814,15 @@
       </Parameters>
       <Docs>
         <param name="length">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads repeated occurrences of <see cref="T:System.Boolean" /> nodes into a typed array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of nodes put in the array.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -1723,12 +1852,15 @@
       </Parameters>
       <Docs>
         <param name="length">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads repeated occurrences of <see cref="T:System.DateTime" /> nodes into a typed array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of nodes put in the array.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -1758,12 +1890,15 @@
       </Parameters>
       <Docs>
         <param name="length">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads repeated occurrences of <see cref="T:System.Decimal" /> nodes into a typed array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of nodes put in the array.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -1793,12 +1928,15 @@
       </Parameters>
       <Docs>
         <param name="length">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads repeated occurrences of <see cref="T:System.Double" /> nodes type into a typed array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of nodes put in the array.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -1828,12 +1966,15 @@
       </Parameters>
       <Docs>
         <param name="length">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads repeated occurrences of <see cref="T:System.Guid" /> nodes into a typed array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of nodes put in the array.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -1863,12 +2004,15 @@
       </Parameters>
       <Docs>
         <param name="length">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads repeated occurrences of short integers into a typed array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of integers put in the array.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -1898,12 +2042,15 @@
       </Parameters>
       <Docs>
         <param name="length">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads repeated occurrences of integers into a typed array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of integers put in the array.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -1933,12 +2080,15 @@
       </Parameters>
       <Docs>
         <param name="length">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads repeated occurrences of long integers into a typed array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of integers put in the array.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -1968,12 +2118,15 @@
       </Parameters>
       <Docs>
         <param name="length">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads repeated occurrences of float numbers into a typed array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of float numbers put in the array.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -2003,12 +2156,15 @@
       </Parameters>
       <Docs>
         <param name="length">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads repeated occurrences of <see cref="T:System.TimeSpan" /> nodes into a typed array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of nodes put in the array.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -2034,7 +2190,6 @@
         <Parameter Name="namespaceUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The buffer allocated by this read operation is limited by the MaxArrayLength quota. </para>
@@ -2043,6 +2198,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads repeated occurrences of <see cref="T:System.Boolean" /> nodes into a typed array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Boolean" /> array of the <see cref="T:System.Boolean" /> nodes.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -2064,7 +2223,6 @@
         <Parameter Name="namespaceUri" Type="System.Xml.XmlDictionaryString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The buffer allocated by this read operation is limited by the MaxArrayLength quota.</para>
@@ -2073,6 +2231,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads repeated occurrences of <see cref="T:System.Boolean" /> nodes into a typed array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Boolean" /> array of the <see cref="T:System.Boolean" /> nodes.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -2095,12 +2257,15 @@
       </Parameters>
       <Docs>
         <param name="nsResolver">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a node's content to a specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The concatenated text content or attribute value converted to the requested type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the value to be returned.</param>
       </Docs>
@@ -2117,7 +2282,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The buffer allocated by this read operation is limited by the MaxArrayLength quota.</para>
@@ -2126,6 +2290,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the content and returns the Base64 decoded binary bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array that contains the Base64 decoded binary bytes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadContentAsBinHex">
@@ -2140,7 +2308,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The buffer allocated by this read operation is limited by the MaxArrayLength quota.</para>
@@ -2149,6 +2316,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the content and returns the BinHex decoded binary bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array that contains the BinHex decoded binary bytes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadContentAsBinHex">
@@ -2165,12 +2336,15 @@
         <Parameter Name="maxByteArrayContentLength" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the content and returns the BinHex decoded binary bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array that contains the BinHex decoded binary bytes.</para>
+        </returns>
         <param name="maxByteArrayContentLength">
           <attribution license="cc4" from="Microsoft" modified="false" />The maximum array length.</param>
       </Docs>
@@ -2191,12 +2365,15 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the content into a char array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Number of characters read.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />The array into which the characters are put.</param>
         <param name="offset">
@@ -2217,12 +2394,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a node's content to decimal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The decimal representation of node's content.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadContentAsFloat">
@@ -2237,12 +2417,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a node's content to float.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The float representation of node's content.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadContentAsGuid">
@@ -2257,12 +2440,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a node's content to guid.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The guid representation of node's content.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadContentAsQualifiedName">
@@ -2298,7 +2484,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The string returned by this read operation is limited by the MaxStringContentLength quota</para>
@@ -2307,6 +2492,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a node's content to a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node content in a string representation.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadContentAsString">
@@ -2323,7 +2512,6 @@
         <Parameter Name="maxStringContentLength" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The string returned by this read operation is limited by the MaxStringContentLength quota.</para>
@@ -2332,6 +2520,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a node's content to a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Node content in string representation.</para>
+        </returns>
         <param name="maxStringContentLength">
           <attribution license="cc4" from="Microsoft" modified="false" />The maximum string length.</param>
       </Docs>
@@ -2392,12 +2584,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a node's content to <see cref="T:System.TimeSpan" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="T:System.TimeSpan" /> representation of node's content.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadContentAsUniqueId">
@@ -2412,12 +2608,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a node's content to a unique identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node's content represented as a unique identifier.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadDateTimeArray">
@@ -2435,7 +2634,6 @@
         <Parameter Name="namespaceUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The buffer allocated by this read operation is limited by the MaxArrayLength quota.</para>
@@ -2444,6 +2642,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a node's content to a <see cref="T:System.DateTime" /> array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node's content represented as a <see cref="T:System.DateTime" /> array.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -2465,12 +2667,15 @@
         <Parameter Name="namespaceUri" Type="System.Xml.XmlDictionaryString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a node's content to a <see cref="T:System.DateTime" /> array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node's content represented as a <see cref="T:System.DateTime" /> array.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -2492,7 +2697,6 @@
         <Parameter Name="namespaceUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The buffer allocated by this read operation is limited by the MaxArrayLength quota.</para>
@@ -2501,6 +2705,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a node's content to a <see cref="T:System.Decimal" /> array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node's content represented as a <see cref="T:System.Decimal" /> array.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -2522,7 +2730,6 @@
         <Parameter Name="namespaceUri" Type="System.Xml.XmlDictionaryString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The buffer allocated by this read operation is limited by the MaxArrayLength quota.</para>
@@ -2531,6 +2738,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a node's content to a <see cref="T:System.Decimal" /> array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node's content represented as a <see cref="T:System.Decimal" /> array.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -2552,7 +2763,6 @@
         <Parameter Name="namespaceUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The buffer allocated by this read operation is limited by the MaxArrayLength quota.</para>
@@ -2561,6 +2771,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a node's content to a <see cref="T:System.Double" /> array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node's content represented as a <see cref="T:System.Double" /> array.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -2582,7 +2796,6 @@
         <Parameter Name="namespaceUri" Type="System.Xml.XmlDictionaryString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The buffer allocated by this read operation is limited by the MaxArrayLength quota.</para>
@@ -2591,6 +2804,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a node's content to a <see cref="T:System.Double" /> array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node's content represented as a <see cref="T:System.Double" /> array.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -2609,7 +2826,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The string returned by this read operation is limited by the MaxArrayLength quota.</para>
@@ -2618,6 +2834,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a node's content to a array of Base64 bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node's content represented as an array of Base64 bytes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadElementContentAsBinHex">
@@ -2632,7 +2852,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The string returned by this read operation is limited by the MaxArrayLength quota.</para>
@@ -2641,6 +2860,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a node's content to an array of BinHex bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node's content represented as an array of BinHex bytes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadElementContentAsBoolean">
@@ -2655,12 +2878,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an element's content to a <see cref="T:System.Boolean" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node's content represented as a <see cref="T:System.Boolean" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadElementContentAsDateTime">
@@ -2675,12 +2901,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an element's content to a <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node's content represented as a <see cref="T:System.DateTime" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadElementContentAsDecimal">
@@ -2695,12 +2924,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an element's content to a <see cref="T:System.Decimal" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node's content represented as a <see cref="T:System.Decimal" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadElementContentAsDouble">
@@ -2715,12 +2947,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an element's content to a <see cref="T:System.Double" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node's content represented as a <see cref="T:System.Double" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadElementContentAsFloat">
@@ -2735,12 +2970,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an element's content to a floating point number (<see cref="T:System.Single" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node's content represented as a floating point number (<see cref="T:System.Single" />).</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadElementContentAsGuid">
@@ -2755,12 +2993,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an element's content to a <see cref="T:System.Guid" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node's content represented as a <see cref="T:System.Guid" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadElementContentAsInt">
@@ -2775,12 +3016,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an element's content to an integer (<see cref="T:System.Int32" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node's content represented as an integer (<see cref="T:System.Int32" />).</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadElementContentAsLong">
@@ -2795,12 +3039,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an element's content to a long integer (<see cref="T:System.Int64" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node's content represented as a long integer (<see cref="T:System.Int64" />).</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadElementContentAsString">
@@ -2815,7 +3062,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The string returned by this read operation is limited by the MaxStringContentLength quota.</para>
@@ -2824,6 +3070,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an element's content to a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node's content represented as a <see cref="T:System.String" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadElementContentAsTimeSpan">
@@ -2838,12 +3088,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an element's content to a <see cref="T:System.TimeSpan" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node's content represented as a <see cref="T:System.TimeSpan" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadElementContentAsUniqueId">
@@ -2858,12 +3111,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an element's content to a unique identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node's content represented as a unique identifier.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadFullStartElement">
@@ -2975,7 +3231,6 @@
         <Parameter Name="namespaceUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The buffer allocated by this read operation is limited by the MaxArrayLength quota.</para>
@@ -2984,6 +3239,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the contents of a series of nodes with the given <paramref name="localName" /> and <paramref name="namespaceUri" /> into an array of <see cref="T:System.Guid" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Guid" />.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -3005,7 +3264,6 @@
         <Parameter Name="namespaceUri" Type="System.Xml.XmlDictionaryString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The buffer allocated by this read operation is limited by the MaxArrayLength quota.</para>
@@ -3014,6 +3272,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the contents of a series of nodes with the given <paramref name="localName" /> and <paramref name="namespaceUri" /> into an array of <see cref="T:System.Guid" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Guid" />.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -3035,7 +3297,6 @@
         <Parameter Name="namespaceUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The buffer allocated by this read operation is limited by the MaxArrayLength quota.</para>
@@ -3044,6 +3305,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the contents of a series of nodes with the given <paramref name="localName" /> and <paramref name="namespaceUri" /> into an array of short integers (<see cref="T:System.Int16" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of short integers (<see cref="T:System.Int16" />).</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -3065,7 +3330,6 @@
         <Parameter Name="namespaceUri" Type="System.Xml.XmlDictionaryString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The buffer allocated by this read operation is limited by the MaxArrayLength quota.</para>
@@ -3074,6 +3338,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the contents of a series of nodes with the given <paramref name="localName" /> and <paramref name="namespaceUri" /> into an array of short integers (<see cref="T:System.Int16" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of short integers (<see cref="T:System.Int16" />).</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -3095,7 +3363,6 @@
         <Parameter Name="namespaceUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The buffer allocated by this read operation is limited by the MaxArrayLength quota.</para>
@@ -3104,6 +3371,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the contents of a series of nodes with the given <paramref name="localName" /> and <paramref name="namespaceUri" /> into an array of integers (<see cref="T:System.Int32" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of integers (<see cref="T:System.Int32" />).</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -3125,7 +3396,6 @@
         <Parameter Name="namespaceUri" Type="System.Xml.XmlDictionaryString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The buffer allocated by this read operation is limited by the MaxArrayLength quota.</para>
@@ -3134,6 +3404,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the contents of a series of nodes with the given <paramref name="localName" /> and <paramref name="namespaceUri" /> into an array of integers (<see cref="T:System.Int32" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of integers (<see cref="T:System.Int32" />).</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -3155,7 +3429,6 @@
         <Parameter Name="namespaceUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The buffer allocated by this read operation is limited by the MaxArrayLength quota.</para>
@@ -3164,6 +3437,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the contents of a series of nodes with the given <paramref name="localName" /> and <paramref name="namespaceUri" /> into an array of long integers (<see cref="T:System.Int64" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of long integers (<see cref="T:System.Int64" />).</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -3185,7 +3462,6 @@
         <Parameter Name="namespaceUri" Type="System.Xml.XmlDictionaryString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The buffer allocated by this read operation is limited by the MaxArrayLength quota.</para>
@@ -3194,6 +3470,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the contents of a series of nodes with the given <paramref name="localName" /> and <paramref name="namespaceUri" /> into an array of long integers (<see cref="T:System.Int64" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of long integers (<see cref="T:System.Int64" />).</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -3215,7 +3495,6 @@
         <Parameter Name="namespaceUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The buffer allocated by this read operation is limited by the MaxArrayLength quota.</para>
@@ -3224,6 +3503,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the contents of a series of nodes with the given <paramref name="localName" /> and <paramref name="namespaceUri" /> into an array of float numbers (<see cref="T:System.Single" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of float numbers (<see cref="T:System.Single" />).</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -3245,7 +3528,6 @@
         <Parameter Name="namespaceUri" Type="System.Xml.XmlDictionaryString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The buffer allocated by this read operation is limited by the MaxArrayLength quota.</para>
@@ -3254,6 +3536,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the contents of a series of nodes with the given <paramref name="localName" /> and <paramref name="namespaceUri" /> into an array of float numbers (<see cref="T:System.Single" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of float numbers (<see cref="T:System.Single" />).</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -3298,12 +3584,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the contents of the current node into a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the contents of the current node.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadString">
@@ -3320,12 +3609,15 @@
         <Parameter Name="maxStringContentLength" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the contents of the current node into a string with a given maximum length.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the contents of the current node.</para>
+        </returns>
         <param name="maxStringContentLength">
           <attribution license="cc4" from="Microsoft" modified="false" />Maximum allowed string length.</param>
       </Docs>
@@ -3345,7 +3637,6 @@
         <Parameter Name="namespaceUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The buffer allocated by this read operation is limited by the MaxArrayLength quota.</para>
@@ -3354,6 +3645,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the contents of a series of nodes with the given <paramref name="localName" /> and <paramref name="namespaceUri" /> into a <see cref="T:System.TimeSpan" /> array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.TimeSpan" /> array.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -3375,7 +3670,6 @@
         <Parameter Name="namespaceUri" Type="System.Xml.XmlDictionaryString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The buffer allocated by this read operation is limited by the MaxArrayLength quota.</para>
@@ -3384,6 +3678,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the contents of a series of nodes with the given <paramref name="localName" /> and <paramref name="namespaceUri" /> into a <see cref="T:System.TimeSpan" /> array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.TimeSpan" /> array.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceUri">
@@ -3409,12 +3707,15 @@
         <param name="bytes">To be added.</param>
         <param name="start">To be added.</param>
         <param name="length">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Not implemented.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Not implemented.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="StartCanonicalization">
diff --git a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Xml/XmlDictionaryString.xml b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Xml/XmlDictionaryString.xml
index 6b177e82d22..ebb5f9bdf24 100644
--- a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Xml/XmlDictionaryString.xml
+++ b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Xml/XmlDictionaryString.xml
@@ -122,12 +122,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a text representation of this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string value for this instance of the class. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Xml/XmlDictionaryWriter.xml b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Xml/XmlDictionaryWriter.xml
index 0f19d2df064..d20f9d31215 100644
--- a/mcs/class/System.Runtime.Serialization/Documentation/en/System.Xml/XmlDictionaryWriter.xml
+++ b/mcs/class/System.Runtime.Serialization/Documentation/en/System.Xml/XmlDictionaryWriter.xml
@@ -77,12 +77,15 @@
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryWriter" /> that writes indigo2 binary XML format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryWriter" />.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream to write to.</param>
       </Docs>
@@ -102,12 +105,15 @@
         <Parameter Name="dictionary" Type="System.Xml.IXmlDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryWriter" /> that writes indigo2 binary XML format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryWriter" />.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream to write to.</param>
         <param name="dictionary">
@@ -130,12 +136,15 @@
         <Parameter Name="session" Type="System.Xml.XmlBinaryWriterSession" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryWriter" /> that writes indigo2 binary XML format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryWriter" />.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream to write to.</param>
         <param name="dictionary">
@@ -161,12 +170,15 @@
         <Parameter Name="ownsStream" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryWriter" /> that writes indigo2 binary XML format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryWriter" />.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream from which to read.</param>
         <param name="dictionary">
@@ -191,12 +203,15 @@
         <Parameter Name="writer" Type="System.Xml.XmlWriter" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryWriter" /> from an existing <see cref="T:System.Xml.XmlWriter" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryWriter" />.</para>
+        </returns>
         <param name="writer">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of <see cref="T:System.Xml.XmlWriter" />.</param>
       </Docs>
@@ -218,12 +233,15 @@
         <Parameter Name="startInfo" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryWriter" /> that writes XML in the MTOM format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryWriter" />.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream to write to.</param>
         <param name="encoding">
@@ -255,12 +273,15 @@
         <Parameter Name="ownsStream" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryWriter" /> that writes XML in the MTOM format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryWriter" />.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream to write to.</param>
         <param name="encoding">
@@ -293,7 +314,6 @@
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The text writer writes the XML in UTF-8 format.</para>
@@ -302,6 +322,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryWriter" /> that writes text XML.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryWriter" />.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream to write to.</param>
       </Docs>
@@ -321,7 +345,6 @@
         <Parameter Name="encoding" Type="System.Text.Encoding" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An instance of <see cref="T:System.Xml.XmlDictionaryWriter" />.</para>
@@ -330,6 +353,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryWriter" /> that writes text XML.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryWriter" />.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream to write to.</param>
         <param name="encoding">
@@ -352,12 +379,15 @@
         <Parameter Name="ownsStream" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.Xml.XmlDictionaryWriter" /> that writes text XML.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryWriter" />.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream to write to.</param>
         <param name="encoding">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/CmsRecipientCollection.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/CmsRecipientCollection.xml
index 8748b731059..346549debb8 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/CmsRecipientCollection.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/CmsRecipientCollection.xml
@@ -104,13 +104,17 @@
         <Parameter Name="recipient" Type="System.Security.Cryptography.Pkcs.CmsRecipient" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Security.Cryptography.Pkcs.CmsRecipientCollection.Add(System.Security.Cryptography.Pkcs.CmsRecipient)" /> method adds a recipient to the <see cref="T:System.Security.Cryptography.Pkcs.CmsRecipientCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If the method succeeds, the method returns an <see cref="T:System.Int32" /> value that represents the zero-based position where the recipient is to be inserted.</para>
+          <para>If the method fails, it throws an exception.</para>
+        </returns>
         <param name="recipient">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Security.Cryptography.Pkcs.CmsRecipient" /> object that represents the recipient to add to the <see cref="T:System.Security.Cryptography.Pkcs.CmsRecipientCollection" /> collection.</param>
       </Docs>
@@ -205,13 +209,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Security.Cryptography.Pkcs.CmsRecipientCollection.GetEnumerator" /> method returns a <see cref="T:System.Security.Cryptography.Pkcs.CmsRecipientEnumerator" /> object for the <see cref="T:System.Security.Cryptography.Pkcs.CmsRecipientCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Cryptography.Pkcs.CmsRecipientEnumerator" /> object that can be used to enumerate the <see cref="T:System.Security.Cryptography.Pkcs.CmsRecipientCollection" /> collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsSynchronized">
@@ -316,12 +323,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Security.Cryptography.Pkcs.CmsRecipientCollection.System#Collections#IEnumerable#GetEnumerator" /> method returns a <see cref="T:System.Security.Cryptography.Pkcs.CmsRecipientEnumerator" /> object for the <see cref="T:System.Security.Cryptography.Pkcs.CmsRecipientCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Cryptography.Pkcs.CmsRecipientEnumerator" /> object that can be used to enumerate the <see cref="T:System.Security.Cryptography.Pkcs.CmsRecipientCollection" /> collection.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/CmsRecipientEnumerator.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/CmsRecipientEnumerator.xml
index e435f96fbed..85d085fe9e3 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/CmsRecipientEnumerator.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/CmsRecipientEnumerator.xml
@@ -58,13 +58,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Security.Cryptography.Pkcs.CmsRecipientEnumerator.MoveNext" /> method advances the enumeration to the next <see cref="T:System.Security.Cryptography.Pkcs.CmsRecipient" /> object in the <see cref="T:System.Security.Cryptography.Pkcs.CmsRecipientCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the enumeration successfully moved to the next <see cref="T:System.Security.Cryptography.Pkcs.CmsRecipient" /> object; false if the enumeration moved past the last item in the enumeration.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Reset">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/ContentInfo.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/ContentInfo.xml
index 2545cbe10e4..5943bf2a039 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/ContentInfo.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/ContentInfo.xml
@@ -236,13 +236,17 @@
         <Parameter Name="encodedMessage" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Security.Cryptography.Pkcs.ContentInfo.GetContentType(System.Byte[])" /> static method  retrieves the outer content type of the encoded <see cref="T:System.Security.Cryptography.Pkcs.ContentInfo" /> message represented by an array of byte values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If the method succeeds, the method returns an <see cref="T:System.Security.Cryptography.Oid" /> object that contains the outer content type of the specified encoded <see cref="T:System.Security.Cryptography.Pkcs.ContentInfo" /> message.</para>
+          <para>If the method fails, it throws an exception.</para>
+        </returns>
         <param name="encodedMessage">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of byte values that represents the encoded <see cref="T:System.Security.Cryptography.Pkcs.ContentInfo" /> message from which to retrieve the outer content type.</param>
       </Docs>
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/EnvelopedCms.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/EnvelopedCms.xml
index db412b81a7d..03d5f248b68 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/EnvelopedCms.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/EnvelopedCms.xml
@@ -507,7 +507,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -519,6 +518,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Security.Cryptography.Pkcs.EnvelopedCms.Encode" /> method encodes the contents of the enveloped CMS/PKCS #7 message and returns it as an array of byte values. Encryption must be done before encoding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If the method succeeds, the method returns an array of byte values that represent the encoded information.</para>
+          <para>If the method fails, it throws an exception.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Encrypt">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/RecipientInfoCollection.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/RecipientInfoCollection.xml
index 560edee7deb..038e4a9d2aa 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/RecipientInfoCollection.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/RecipientInfoCollection.xml
@@ -117,13 +117,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Security.Cryptography.Pkcs.RecipientInfoCollection.GetEnumerator" /> method returns a <see cref="T:System.Security.Cryptography.Pkcs.RecipientInfoEnumerator" /> object for the <see cref="T:System.Security.Cryptography.Pkcs.RecipientInfoCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Cryptography.Pkcs.RecipientInfoEnumerator" /> object that can be used to enumerate the <see cref="T:System.Security.Cryptography.Pkcs.RecipientInfoCollection" /> collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsSynchronized">
@@ -203,12 +206,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Security.Cryptography.Pkcs.RecipientInfoCollection.System#Collections#IEnumerable#GetEnumerator" /> method returns a <see cref="T:System.Security.Cryptography.Pkcs.RecipientInfoEnumerator" /> object for the <see cref="T:System.Security.Cryptography.Pkcs.RecipientInfoCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Cryptography.Pkcs.RecipientInfoEnumerator" /> object that can be used to enumerate the <see cref="T:System.Security.Cryptography.Pkcs.RecipientInfoCollection" /> collection.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/RecipientInfoEnumerator.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/RecipientInfoEnumerator.xml
index c199b003a37..0a4a8f06d97 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/RecipientInfoEnumerator.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/RecipientInfoEnumerator.xml
@@ -58,13 +58,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Security.Cryptography.Pkcs.RecipientInfoEnumerator.MoveNext" /> method advances the enumeration to the next <see cref="T:System.Security.Cryptography.Pkcs.RecipientInfo" /> object in the <see cref="T:System.Security.Cryptography.Pkcs.RecipientInfoCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns a bool that specifies whether the enumeration successfully advanced. If the enumeration successfully moved to the next <see cref="T:System.Security.Cryptography.Pkcs.RecipientInfo" /> object, the method returns true. If the enumeration moved past the last item in the enumeration, it returns false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Reset">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/SignedCms.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/SignedCms.xml
index 846e564ebda..b63278dad38 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/SignedCms.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/SignedCms.xml
@@ -599,13 +599,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Security.Cryptography.Pkcs.SignedCms.Encode" /> method encodes the information in the object into a CMS/PKCS #7 message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of byte values that represents the encoded message. The encoded message can be decoded by the <see cref="M:System.Security.Cryptography.Pkcs.SignedCms.Decode(System.Byte[])" /> method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="RemoveSignature">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/SignerInfoCollection.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/SignerInfoCollection.xml
index fa0ace9ea9f..df696e40201 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/SignerInfoCollection.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/SignerInfoCollection.xml
@@ -117,13 +117,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Security.Cryptography.Pkcs.SignerInfoCollection.GetEnumerator" /> method returns a <see cref="T:System.Security.Cryptography.Pkcs.SignerInfoEnumerator" /> object for the <see cref="T:System.Security.Cryptography.Pkcs.SignerInfoCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Cryptography.Pkcs.SignerInfoEnumerator" /> object that can be used to enumerate the <see cref="T:System.Security.Cryptography.Pkcs.SignerInfoCollection" /> collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsSynchronized">
@@ -203,12 +206,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Security.Cryptography.Pkcs.SignerInfoCollection.System#Collections#IEnumerable#GetEnumerator" /> method returns a <see cref="T:System.Security.Cryptography.Pkcs.SignerInfoEnumerator" /> object for the <see cref="T:System.Security.Cryptography.Pkcs.SignerInfoCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Cryptography.Pkcs.SignerInfoEnumerator" /> object that can be used to enumerate the <see cref="T:System.Security.Cryptography.Pkcs.SignerInfoCollection" /> collection.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/SignerInfoEnumerator.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/SignerInfoEnumerator.xml
index 42d221b5550..258465fe88d 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/SignerInfoEnumerator.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Pkcs/SignerInfoEnumerator.xml
@@ -58,13 +58,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Security.Cryptography.Pkcs.SignerInfoEnumerator.MoveNext" /> method advances the enumeration to the next   <see cref="T:System.Security.Cryptography.Pkcs.SignerInfo" /> object in the <see cref="T:System.Security.Cryptography.Pkcs.SignerInfoCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns a bool value that specifies whether the enumeration successfully advanced. If the enumeration successfully moved to the next <see cref="T:System.Security.Cryptography.Pkcs.SignerInfo" /> object, the method returns true. If the enumeration moved past the last item in the enumeration, it returns false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Reset">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.X509Certificates/X509Certificate2UI.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.X509Certificates/X509Certificate2UI.xml
index f021e39aa5f..b9fb3a1e24b 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.X509Certificates/X509Certificate2UI.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.X509Certificates/X509Certificate2UI.xml
@@ -100,7 +100,6 @@
         <Parameter Name="selectionFlag" Type="System.Security.Cryptography.X509Certificates.X509SelectionFlag" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -110,6 +109,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a dialog box for selecting an X.509 certificate from a certificate collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate2Collection" /> object that contains the selected certificate or certificates.</para>
+        </returns>
         <param name="certificates">
           <attribution license="cc4" from="Microsoft" modified="false" />A collection of X.509 certificates to select from.</param>
         <param name="title">
@@ -139,7 +142,6 @@
         <Parameter Name="hwndParent" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -149,6 +151,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a dialog box for selecting an X.509 certificate from a certificate collection using a handle to a parent window.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate2Collection" /> object that contains the selected certificate or certificates.</para>
+        </returns>
         <param name="certificates">
           <attribution license="cc4" from="Microsoft" modified="false" />A collection of X.509 certificates to select from.</param>
         <param name="title">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/CipherData.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/CipherData.xml
index 5512300ccb3..cbbf0b75186 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/CipherData.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/CipherData.xml
@@ -171,7 +171,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -181,6 +180,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the XML values for the <see cref="T:System.Security.Cryptography.Xml.CipherData" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Xml.XmlElement" /> object that represents the XML information for the <see cref="T:System.Security.Cryptography.Xml.CipherData" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="LoadXml">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/CipherReference.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/CipherReference.xml
index 1b046b14be9..23f934710d1 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/CipherReference.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/CipherReference.xml
@@ -127,7 +127,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -137,6 +136,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML representation of a <see cref="T:System.Security.Cryptography.Xml.CipherReference" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlElement" /> that represents the &lt;CipherReference&gt; element in XML encryption.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="LoadXml">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/DSAKeyValue.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/DSAKeyValue.xml
index 4795b4a3343..98b91224f2b 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/DSAKeyValue.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/DSAKeyValue.xml
@@ -87,7 +87,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Xml.XmlElement" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to output XML for a <see cref="T:System.Security.Cryptography.Xml.DSAKeyValue" /> object.</para>
@@ -96,6 +95,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML representation of a <see cref="T:System.Security.Cryptography.Xml.DSAKeyValue" /> element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XML representation of the <see cref="T:System.Security.Cryptography.Xml.DSAKeyValue" /> element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Key">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/DataObject.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/DataObject.xml
index e21e63e591b..3ed8850d1f2 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/DataObject.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/DataObject.xml
@@ -147,7 +147,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Xml.XmlElement" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to output XML for a <see cref="T:System.Security.Cryptography.Xml.DataObject" />.</para>
@@ -156,6 +155,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML representation of the <see cref="T:System.Security.Cryptography.Xml.DataObject" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XML representation of the <see cref="T:System.Security.Cryptography.Xml.DataObject" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Id">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptedData.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptedData.xml
index b6c31473cbc..5c8444d70d1 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptedData.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptedData.xml
@@ -57,7 +57,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -67,6 +66,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML representation of the <see cref="T:System.Security.Cryptography.Xml.EncryptedData" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlElement" /> that represents the &lt;EncryptedData&gt; element in XML encryption.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="LoadXml">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptedKey.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptedKey.xml
index 9b92a526210..02cf62e8e84 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptedKey.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptedKey.xml
@@ -138,7 +138,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -148,6 +147,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML representation of the <see cref="T:System.Security.Cryptography.Xml.EncryptedKey" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlElement" /> that represents the &lt;EncryptedKey&gt; element in XML encryption.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="LoadXml">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptedReference.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptedReference.xml
index 6b2a4cb3838..3fcc09a9b34 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptedReference.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptedReference.xml
@@ -161,7 +161,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -171,6 +170,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML representation of an <see cref="T:System.Security.Cryptography.Xml.EncryptedReference" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlElement" /> object that represents the values of the &lt;EncryptedReference&gt; element in XML encryption.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="LoadXml">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptedType.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptedType.xml
index ffea02c4cfe..1c04b7b1bf0 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptedType.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptedType.xml
@@ -183,7 +183,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -193,6 +192,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML representation of the <see cref="T:System.Security.Cryptography.Xml.EncryptedType" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlElement" /> object that represents the &lt;EncryptedType&gt; element in XML encryption.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Id">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptedXml.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptedXml.xml
index f7a8751b153..1c01a64c8c7 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptedXml.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptedXml.xml
@@ -188,7 +188,6 @@
       </Parameters>
       <Docs>
         <param name="symAlg">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -199,6 +198,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decrypts an &lt;EncryptedData&gt; element using the specified symmetric algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array that contains the raw decrypted plain text.</para>
+        </returns>
         <param name="encryptedData">
           <attribution license="cc4" from="Microsoft" modified="false" />The data to decrypt.</param>
       </Docs>
@@ -247,7 +250,6 @@
         <Parameter Name="encryptedKey" Type="System.Security.Cryptography.Xml.EncryptedKey" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -258,6 +260,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the key represented by the <see cref="T:System.Security.Cryptography.Xml.EncryptedKey" /> element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array that contains the key.</para>
+        </returns>
         <param name="encryptedKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Cryptography.Xml.EncryptedKey" /> object that contains the key to retrieve.</param>
       </Docs>
@@ -279,7 +285,6 @@
       </Parameters>
       <Docs>
         <param name="symAlg">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -289,6 +294,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decrypts an &lt;EncryptedKey&gt; element using a symmetric algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array that contains the plain text key.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of bytes that represents an encrypted &lt;EncryptedKey&gt; element.</param>
       </Docs>
@@ -311,7 +320,6 @@
       </Parameters>
       <Docs>
         <param name="fOAEP">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -321,6 +329,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decrypts an &lt;EncryptedKey&gt; element using an asymmetric algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array that contains the plain text key.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of bytes that represents an encrypted &lt;EncryptedKey&gt; element.</param>
         <param name="rsa">
@@ -391,7 +403,6 @@
         <Parameter Name="certificate" Type="System.Security.Cryptography.X509Certificates.X509Certificate2" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -403,6 +414,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encrypts the outer XML of an element using the specified X.509 certificate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.Cryptography.Xml.EncryptedData" /> element that represents the encrypted XML data.</para>
+        </returns>
         <param name="inputElement">
           <attribution license="cc4" from="Microsoft" modified="false" />The XML element to encrypt.</param>
         <param name="certificate">
@@ -425,7 +440,6 @@
         <Parameter Name="keyName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -436,6 +450,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encrypts the outer XML of an element using the specified key in the key mapping table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.Cryptography.Xml.EncryptedData" /> object that represents the encrypted XML data.</para>
+        </returns>
         <param name="inputElement">
           <attribution license="cc4" from="Microsoft" modified="false" />The XML element to encrypt.</param>
         <param name="keyName">
@@ -460,7 +478,6 @@
       <Docs>
         <param name="plainText">To be added.</param>
         <param name="symAlg">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -470,6 +487,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encrypts data in the specified byte array using the specified symmetric algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array of encrypted data.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="EncryptData">
@@ -490,7 +511,6 @@
       </Parameters>
       <Docs>
         <param name="symAlg">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -500,6 +520,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encrypts the specified element or its contents using the specified symmetric algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array that contains the encrypted data.</para>
+        </returns>
         <param name="inputElement">
           <attribution license="cc4" from="Microsoft" modified="false" />The element or its contents to encrypt.</param>
         <param name="content">
@@ -523,7 +547,6 @@
       </Parameters>
       <Docs>
         <param name="symAlg">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -534,6 +557,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encrypts a key using a symmetric algorithm that a recipient uses to decrypt an &lt;EncryptedData&gt; element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array that represents the encrypted value of the <paramref name="keyData" /> parameter.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />The key to encrypt.</param>
       </Docs>
@@ -556,7 +583,6 @@
       </Parameters>
       <Docs>
         <param name="fOAEP">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -567,6 +593,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encrypts the key that a recipient uses to decrypt an &lt;EncryptedData&gt; element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array that represents the encrypted value of the <paramref name="keyData" /> parameter.</para>
+        </returns>
         <param name="keyData">
           <attribution license="cc4" from="Microsoft" modified="false" />The key to encrypt.</param>
         <param name="rsa">
@@ -590,7 +620,6 @@
       </Parameters>
       <Docs>
         <param name="symAlgUri">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -601,6 +630,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the decryption initialization vector (IV) from an <see cref="T:System.Security.Cryptography.Xml.EncryptedData" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array that contains the decryption initialization vector (IV).</para>
+        </returns>
         <param name="encryptedData">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Cryptography.Xml.EncryptedData" /> object that contains the initialization vector (IV) to retrieve.</param>
       </Docs>
@@ -622,7 +655,6 @@
       </Parameters>
       <Docs>
         <param name="symAlgUri">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -632,6 +664,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the decryption key from the specified <see cref="T:System.Security.Cryptography.Xml.EncryptedData" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Cryptography.SymmetricAlgorithm" /> object associated with the decryption key.</para>
+        </returns>
         <param name="encryptedData">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Cryptography.Xml.EncryptedData" /> object that contains the decryption key to retrieve.</param>
       </Docs>
@@ -652,7 +688,6 @@
         <Parameter Name="idValue" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -662,6 +697,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines how to resolve internal Uniform Resource Identifier (URI) references.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlElement" /> object that contains an ID indicating how internal Uniform Resource Identifiers (URIs) are to be resolved.</para>
+        </returns>
         <param name="document">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlDocument" /> object that contains an element with an ID value.</param>
         <param name="idValue">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptionMethod.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptionMethod.xml
index 41068d3da6e..acf72f7b8e4 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptionMethod.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptionMethod.xml
@@ -84,7 +84,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -94,6 +93,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Xml.XmlElement" /> object that encapsulates an instance of the <see cref="T:System.Security.Cryptography.Xml.EncryptionMethod" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlElement" /> object that encapsulates an instance of the <see cref="T:System.Security.Cryptography.Xml.EncryptionMethod" /> class.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="KeyAlgorithm">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptionProperty.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptionProperty.xml
index f39de590530..7c71354f1d1 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptionProperty.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptionProperty.xml
@@ -76,7 +76,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -86,6 +85,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Xml.XmlElement" /> object that encapsulates an instance of the <see cref="T:System.Security.Cryptography.Xml.EncryptionProperty" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlElement" /> object that encapsulates an instance of the <see cref="T:System.Security.Cryptography.Xml.EncryptionProperty" /> class.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Id">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptionPropertyCollection.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptionPropertyCollection.xml
index 151e97c3ce0..b07e9386b4d 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptionPropertyCollection.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/EncryptionPropertyCollection.xml
@@ -61,13 +61,16 @@
         <Parameter Name="value" Type="System.Security.Cryptography.Xml.EncryptionProperty" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an <see cref="T:System.Security.Cryptography.Xml.EncryptionProperty" /> object to the <see cref="T:System.Security.Cryptography.Xml.EncryptionPropertyCollection" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position at which the new element is inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Security.Cryptography.Xml.EncryptionProperty" /> object to add to the <see cref="T:System.Security.Cryptography.Xml.EncryptionPropertyCollection" /> object.</param>
       </Docs>
@@ -108,13 +111,16 @@
         <Parameter Name="value" Type="System.Security.Cryptography.Xml.EncryptionProperty" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Security.Cryptography.Xml.EncryptionPropertyCollection" /> object contains a specific <see cref="T:System.Security.Cryptography.Xml.EncryptionProperty" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Security.Cryptography.Xml.EncryptionProperty" /> object is found in the <see cref="T:System.Security.Cryptography.Xml.EncryptionPropertyCollection" /> object; otherwise, false. </para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Cryptography.Xml.EncryptionProperty" /> object to locate in the <see cref="T:System.Security.Cryptography.Xml.EncryptionPropertyCollection" /> object. </param>
       </Docs>
@@ -209,7 +215,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -219,6 +224,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through an <see cref="T:System.Security.Cryptography.Xml.EncryptionPropertyCollection" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> object that can be used to iterate through an <see cref="T:System.Security.Cryptography.Xml.EncryptionPropertyCollection" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IndexOf">
@@ -236,13 +245,16 @@
         <Parameter Name="value" Type="System.Security.Cryptography.Xml.EncryptionProperty" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of a specific item in the <see cref="T:System.Security.Cryptography.Xml.EncryptionPropertyCollection" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of <paramref name="value" /> if found in the collection; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Cryptography.Xml.EncryptionProperty" /> object to locate in the <see cref="T:System.Security.Cryptography.Xml.EncryptionPropertyCollection" /> object.</param>
       </Docs>
@@ -361,13 +373,16 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Security.Cryptography.Xml.EncryptionProperty" /> object at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Security.Cryptography.Xml.EncryptionProperty" /> object at the specified index.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the <see cref="T:System.Security.Cryptography.Xml.EncryptionProperty" /> object to return.</param>
       </Docs>
@@ -480,12 +495,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an item to the <see cref="T:System.Collections.IList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position into which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to add to the <see cref="T:System.Collections.IList" />.</param>
       </Docs>
@@ -505,12 +523,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Collections.IList" /> contains a specific value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Object" /> is found in the <see cref="T:System.Collections.IList" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the <see cref="T:System.Collections.IList" />.</param>
       </Docs>
@@ -530,12 +551,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of a specific item in the <see cref="T:System.Collections.IList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of <paramref name="value" /> if found in the list; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the <see cref="T:System.Collections.IList" />.</param>
       </Docs>
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/IRelDecryptor.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/IRelDecryptor.xml
index 39cd7a25619..6a385b1c5da 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/IRelDecryptor.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/IRelDecryptor.xml
@@ -37,7 +37,6 @@
         <Parameter Name="toDecrypt" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -47,6 +46,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decrypts an XrML &lt;encryptedGrant&gt; element that is contained within a <see cref="T:System.IO.Stream" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> object that contains a decrypted &lt;encryptedGrant&gt; element.</para>
+        </returns>
         <param name="encryptionMethod">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Security.Cryptography.Xml.EncryptionMethod" /> object that encapsulates the algorithm used for XML encryption.</param>
         <param name="keyInfo">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/KeyInfo.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/KeyInfo.xml
index b43261d962c..fbe4758e9c0 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/KeyInfo.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/KeyInfo.xml
@@ -111,7 +111,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Collections.IEnumerator" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Two enumerators taken from the same collection at the same time are not necessarily required to return the same iteration.</para>
@@ -121,6 +120,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator of the <see cref="T:System.Security.Cryptography.Xml.KeyInfoClause" /> objects in the <see cref="T:System.Security.Cryptography.Xml.KeyInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator of the subelements of <see cref="T:System.Security.Cryptography.Xml.KeyInfo" /> that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetEnumerator">
@@ -139,7 +142,6 @@
         <Parameter Name="requestedObjectType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Collections.IEnumerator" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Two enumerators taken from the same collection at the same time are not necessarily required to return the same iteration.</para>
@@ -149,6 +151,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator of the <see cref="T:System.Security.Cryptography.Xml.KeyInfoClause" /> objects of the specified type in the <see cref="T:System.Security.Cryptography.Xml.KeyInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator of the subelements of <see cref="T:System.Security.Cryptography.Xml.KeyInfo" /> that can be used to iterate through the collection.</para>
+        </returns>
         <param name="requestedObjectType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of object to enumerate. </param>
       </Docs>
@@ -167,12 +173,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Xml.XmlElement" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML representation of the <see cref="T:System.Security.Cryptography.Xml.KeyInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XML representation of the <see cref="T:System.Security.Cryptography.Xml.KeyInfo" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Id">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/KeyInfoClause.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/KeyInfoClause.xml
index f2639910969..2ce9769ebda 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/KeyInfoClause.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/KeyInfoClause.xml
@@ -62,7 +62,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Xml.XmlElement" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Xml.XmlElement" /> returned by this method is suitable for use as a subelement of an XMLDSIG or encrypted XML &lt;KeyInfo&gt; element.</para>
@@ -71,6 +70,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns an XML representation of the <see cref="T:System.Security.Cryptography.Xml.KeyInfoClause" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML representation of the <see cref="T:System.Security.Cryptography.Xml.KeyInfoClause" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="LoadXml">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/KeyInfoEncryptedKey.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/KeyInfoEncryptedKey.xml
index d43cd7098da..a04b7116a31 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/KeyInfoEncryptedKey.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/KeyInfoEncryptedKey.xml
@@ -102,13 +102,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an XML representation of a <see cref="T:System.Security.Cryptography.Xml.KeyInfoEncryptedKey" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML representation of a <see cref="T:System.Security.Cryptography.Xml.KeyInfoEncryptedKey" /> object. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="LoadXml">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/KeyInfoName.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/KeyInfoName.xml
index f80b9e4b01c..826ebfa55da 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/KeyInfoName.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/KeyInfoName.xml
@@ -84,7 +84,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Xml.XmlElement" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Xml.XmlElement" /> object returned by this method is suitable for use as a subelement of an XMLDSIG or XML Encryption &lt;KeyInfo&gt; element.</para>
@@ -93,6 +92,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an XML representation of the <see cref="T:System.Security.Cryptography.Xml.KeyInfoName" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML representation of the <see cref="T:System.Security.Cryptography.Xml.KeyInfoName" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="LoadXml">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/KeyInfoNode.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/KeyInfoNode.xml
index e9a5db9c19b..f9303731d30 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/KeyInfoNode.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/KeyInfoNode.xml
@@ -82,7 +82,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Xml.XmlElement" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Xml.XmlElement" /> returned by this method is suitable for use as a subelement of an XMLDSIG or an XML encryption &lt;KeyInfo&gt; element.</para>
@@ -91,6 +90,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an XML representation of the <see cref="T:System.Security.Cryptography.Xml.KeyInfoNode" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML representation of the <see cref="T:System.Security.Cryptography.Xml.KeyInfoNode" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="LoadXml">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/KeyInfoRetrievalMethod.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/KeyInfoRetrievalMethod.xml
index 67bae11c775..804cec2ce12 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/KeyInfoRetrievalMethod.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/KeyInfoRetrievalMethod.xml
@@ -106,7 +106,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Xml.XmlElement" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Xml.XmlElement" /> object returned by this method is suitable for use as a subelement of an XMLDSIG or XML encryption &lt;KeyInfo&gt; element.</para>
@@ -115,6 +114,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML representation of the <see cref="T:System.Security.Cryptography.Xml.KeyInfoRetrievalMethod" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XML representation of the <see cref="T:System.Security.Cryptography.Xml.KeyInfoRetrievalMethod" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="LoadXml">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/KeyInfoX509Data.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/KeyInfoX509Data.xml
index ae7c64b0a3d..2d7724b3445 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/KeyInfoX509Data.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/KeyInfoX509Data.xml
@@ -316,7 +316,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Xml.XmlElement" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Xml.XmlElement" /> object returned by this method is suitable for use as a subelement of an XMLDSIG or XML encryption &lt;KeyInfo&gt; element.</para>
@@ -325,6 +324,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an XML representation of the <see cref="T:System.Security.Cryptography.Xml.KeyInfoX509Data" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML representation of the <see cref="T:System.Security.Cryptography.Xml.KeyInfoX509Data" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IssuerSerials">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/RSAKeyValue.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/RSAKeyValue.xml
index d29db6f5747..e1319983d1d 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/RSAKeyValue.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/RSAKeyValue.xml
@@ -87,12 +87,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Xml.XmlElement" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML representation of the <see cref="T:System.Security.Cryptography.RSA" /> key clause.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XML representation of the <see cref="T:System.Security.Cryptography.RSA" /> key clause.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Key">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/Reference.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/Reference.xml
index d5d8ed22726..09dad92b425 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/Reference.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/Reference.xml
@@ -214,12 +214,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Xml.XmlElement" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML representation of the <see cref="T:System.Security.Cryptography.Xml.Reference" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XML representation of the <see cref="T:System.Security.Cryptography.Xml.Reference" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Id">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/ReferenceList.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/ReferenceList.xml
index 59ede647fcf..c6037fcf2e2 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/ReferenceList.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/ReferenceList.xml
@@ -63,13 +63,16 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Security.Cryptography.Xml.DataReference" /> or <see cref="T:System.Security.Cryptography.Xml.KeyReference" /> object to the <see cref="T:System.Security.Cryptography.Xml.ReferenceList" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position at which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Security.Cryptography.Xml.DataReference" /> or <see cref="T:System.Security.Cryptography.Xml.KeyReference" /> object to add to the <see cref="T:System.Security.Cryptography.Xml.ReferenceList" /> collection.</param>
       </Docs>
@@ -110,13 +113,16 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Security.Cryptography.Xml.ReferenceList" /> collection contains a specific <see cref="T:System.Security.Cryptography.Xml.DataReference" /> or <see cref="T:System.Security.Cryptography.Xml.KeyReference" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Security.Cryptography.Xml.DataReference" /> or <see cref="T:System.Security.Cryptography.Xml.KeyReference" /> object is found in the <see cref="T:System.Security.Cryptography.Xml.ReferenceList" /> collection; otherwise, false. </para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Cryptography.Xml.DataReference" /> or <see cref="T:System.Security.Cryptography.Xml.KeyReference" /> object to locate in the <see cref="T:System.Security.Cryptography.Xml.ReferenceList" /> collection. </param>
       </Docs>
@@ -183,7 +189,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -193,6 +198,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through a <see cref="T:System.Security.Cryptography.Xml.ReferenceList" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> object that can be used to iterate through a <see cref="T:System.Security.Cryptography.Xml.ReferenceList" /> collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IndexOf">
@@ -210,13 +219,16 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of a specific item in the <see cref="T:System.Security.Cryptography.Xml.ReferenceList" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of <paramref name="value" /> if found in the collection; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Cryptography.Xml.DataReference" /> or <see cref="T:System.Security.Cryptography.Xml.KeyReference" /> object to locate in the <see cref="T:System.Security.Cryptography.Xml.ReferenceList" /> collection.</param>
       </Docs>
@@ -285,13 +297,16 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Security.Cryptography.Xml.DataReference" /> or <see cref="T:System.Security.Cryptography.Xml.KeyReference" /> object at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Security.Cryptography.Xml.DataReference" /> or <see cref="T:System.Security.Cryptography.Xml.KeyReference" /> object at the specified index.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the <see cref="T:System.Security.Cryptography.Xml.DataReference" /> or <see cref="T:System.Security.Cryptography.Xml.KeyReference" /> object to return.</param>
       </Docs>
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/Signature.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/Signature.xml
index db2dd60c542..55f5d2ff6e2 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/Signature.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/Signature.xml
@@ -87,12 +87,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Xml.XmlElement" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML representation of the <see cref="T:System.Security.Cryptography.Xml.Signature" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XML representation of the <see cref="T:System.Security.Cryptography.Xml.Signature" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Id">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/SignedInfo.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/SignedInfo.xml
index a2ec6ca5b0c..dde37819b79 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/SignedInfo.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/SignedInfo.xml
@@ -256,12 +256,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Collections.IEnumerator" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the collection of references.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator that iterates through the collection of references.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetXml">
@@ -278,12 +281,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Xml.XmlElement" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML representation of the <see cref="T:System.Security.Cryptography.Xml.SignedInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XML representation of the <see cref="T:System.Security.Cryptography.Xml.SignedInfo" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Id">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/SignedXml.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/SignedXml.xml
index 54cb1e42843..9c2c9f82c38 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/SignedXml.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/SignedXml.xml
@@ -218,7 +218,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>True if the signature was verified, false otherwise.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method also computes the digest of the references and the value of the signature.</para>
@@ -228,6 +227,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="P:System.Security.Cryptography.Xml.SignedXml.Signature" /> property verifies using the public key in the signature.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="P:System.Security.Cryptography.Xml.SignedXml.Signature" /> property verifies; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CheckSignature">
@@ -246,12 +249,15 @@
         <Parameter Name="key" Type="System.Security.Cryptography.AsymmetricAlgorithm" />
       </Parameters>
       <Docs>
-        <returns>True if the signature was verified, false otherwise.</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="P:System.Security.Cryptography.Xml.SignedXml.Signature" /> property verifies for the specified key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="P:System.Security.Cryptography.Xml.SignedXml.Signature" /> property verifies for the specified key; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The implementation of the <see cref="T:System.Security.Cryptography.AsymmetricAlgorithm" /> property that holds the key to be used to verify the <see cref="P:System.Security.Cryptography.Xml.SignedXml.Signature" /> property. </param>
       </Docs>
@@ -272,7 +278,6 @@
         <Parameter Name="macAlg" Type="System.Security.Cryptography.KeyedHashAlgorithm" />
       </Parameters>
       <Docs>
-        <returns>True if the signature was verified, false otherwise.</returns>
         <remarks>
           <para>Only <see cref="T:System.Security.Cryptography.HMACSHA1" /> is supported by the XMLDSIG specification.</para>
           <para>This example read a XML file (document.xml) and verify if it has been signed with the shared secret "trustme".</para>
@@ -305,6 +310,10 @@ else {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="P:System.Security.Cryptography.Xml.SignedXml.Signature" /> property verifies for the specified message authentication code (MAC) algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="P:System.Security.Cryptography.Xml.SignedXml.Signature" /> property verifies for the specified MAC; otherwise, false.</para>
+        </returns>
         <param name="macAlg">
           <attribution license="cc4" from="Microsoft" modified="false" />The implementation of <see cref="T:System.Security.Cryptography.KeyedHashAlgorithm" /> that holds the MAC to be used to verify the <see cref="P:System.Security.Cryptography.Xml.SignedXml.Signature" /> property. </param>
       </Docs>
@@ -330,7 +339,6 @@ else {
         <Parameter Name="verifySignatureOnly" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In version 1.1 of the .NET Framework, the X.509 certificate is not verified.  In version 2.0 and later, the X.509 certificate is verified.  </para>
@@ -340,6 +348,12 @@ else {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="P:System.Security.Cryptography.Xml.SignedXml.Signature" /> property verifies for the specified <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate2" /> object and, optionally, whether the certificate is valid.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the signature is valid; otherwise, false. </para>
+          <para>-or-</para>
+          <para>true if the signature and certificate are valid; otherwise, false. </para>
+        </returns>
         <param name="certificate">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate2" /> object to use to verify the <see cref="P:System.Security.Cryptography.Xml.SignedXml.Signature" /> property.</param>
         <param name="verifySignatureOnly">
@@ -464,12 +478,15 @@ else {
         <Parameter Name="idValue" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Xml.XmlElement" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Xml.XmlElement" /> object with the specified ID from the specified <see cref="T:System.Xml.XmlDocument" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.XmlElement" /> object with the specified ID from the specified <see cref="T:System.Xml.XmlDocument" /> object, or null if it could not be found.</para>
+        </returns>
         <param name="document">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlDocument" /> object to retrieve the <see cref="T:System.Xml.XmlElement" /> object from.</param>
         <param name="idValue">
@@ -490,7 +507,6 @@ else {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Security.Cryptography.AsymmetricAlgorithm" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Security.Cryptography.Xml.SignedXml.GetPublicKey" /> method returns an <see cref="T:System.Security.Cryptography.AsymmetricAlgorithm" /> object that contains a public key that can be used to verify an XML digital signature.</para>
@@ -500,6 +516,10 @@ else {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the public key of a signature.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.Cryptography.AsymmetricAlgorithm" /> object that contains the public key of the signature, or null if the key cannot be found.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetXml">
@@ -516,12 +536,15 @@ else {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Xml.XmlElement" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML representation of a <see cref="T:System.Security.Cryptography.Xml.SignedXml" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XML representation of the <see cref="T:System.Security.Cryptography.Xml.Signature" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="KeyInfo">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/Transform.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/Transform.xml
index 6e5ee6b6eed..ecc010f182a 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/Transform.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/Transform.xml
@@ -121,12 +121,15 @@
         <Parameter Name="hash" Type="System.Security.Cryptography.HashAlgorithm" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the digest associated with a <see cref="T:System.Security.Cryptography.Xml.Transform" /> object. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The digest associated with a <see cref="T:System.Security.Cryptography.Xml.Transform" /> object.</para>
+        </returns>
         <param name="hash">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Cryptography.HashAlgorithm" /> object used to create a digest.</param>
       </Docs>
@@ -145,12 +148,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Xml.XmlNodeList" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns an XML representation of the parameters of the <see cref="T:System.Security.Cryptography.Xml.Transform" /> object that are suitable to be included as subelements of an XMLDSIG &lt;Transform&gt; element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A list of the XML nodes that represent the transform-specific content needed to describe the current <see cref="T:System.Security.Cryptography.Xml.Transform" /> object in an XMLDSIG &lt;Transform&gt; element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOutput">
@@ -167,12 +173,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the output of the current <see cref="T:System.Security.Cryptography.Xml.Transform" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The output of the current <see cref="T:System.Security.Cryptography.Xml.Transform" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOutput">
@@ -191,7 +200,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Security.Cryptography.Xml.Transform.GetOutput(System.Type)" /> method returns the output of the current transform after it is run on the value previously set by a call to the <see cref="M:System.Security.Cryptography.Xml.Transform.LoadInput(System.Object)" /> method.</para>
@@ -201,6 +209,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the output of the current <see cref="T:System.Security.Cryptography.Xml.Transform" /> object of the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The output of the current <see cref="T:System.Security.Cryptography.Xml.Transform" /> object as an object of the specified type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the output to return. This must be one of the types in the <see cref="P:System.Security.Cryptography.Xml.Transform.OutputTypes" /> property. </param>
       </Docs>
@@ -219,7 +231,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Xml.XmlElement" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Xml.XmlElement" /> object returned by this method conforms to the XML Scheme for the &lt;Transform&gt; element defined in Section 4.3.3.4 of the XMLDSIG specification.</para>
@@ -228,6 +239,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML representation of the current <see cref="T:System.Security.Cryptography.Xml.Transform" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XML representation of the current <see cref="T:System.Security.Cryptography.Xml.Transform" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InputTypes">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/TransformChain.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/TransformChain.xml
index 8ca38570e04..0414ecb4af3 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/TransformChain.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/TransformChain.xml
@@ -112,12 +112,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Collections.IEnumerator" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator of the transforms in the <see cref="T:System.Security.Cryptography.Xml.TransformChain" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator of the transforms in the <see cref="T:System.Security.Cryptography.Xml.TransformChain" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Item">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlDecryptionTransform.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlDecryptionTransform.xml
index cdad27002aa..120fc903e63 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlDecryptionTransform.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlDecryptionTransform.xml
@@ -105,13 +105,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an XML representation of the parameters of an <see cref="T:System.Security.Cryptography.Xml.XmlDecryptionTransform" /> object that are suitable to be included as subelements of an XMLDSIG &lt;Transform&gt; element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A list of the XML nodes that represent the transform-specific content needed to describe the current <see cref="T:System.Security.Cryptography.Xml.XmlDecryptionTransform" /> object in an XMLDSIG &lt;Transform&gt; element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOutput">
@@ -127,13 +130,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the output of the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigEnvelopedSignatureTransform" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The output of the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigEnvelopedSignatureTransform" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOutput">
@@ -151,13 +157,16 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the output of the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigEnvelopedSignatureTransform" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The output of the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigEnvelopedSignatureTransform" /> object.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the output to return. <see cref="T:System.Xml.XmlNodeList" /> is the only valid type for this parameter.</param>
       </Docs>
@@ -203,13 +212,16 @@
         <Parameter Name="idValue" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the ID attribute of an <see cref="T:System.Xml.XmlElement" /> object matches a specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the ID attribute of the <paramref name="inputElement" /> parameter matches the <paramref name="idValue" /> parameter; otherwise, false. </para>
+        </returns>
         <param name="inputElement">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlElement" /> object with an ID attribute to compare with <paramref name="idValue" />.</param>
         <param name="idValue">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlDsigBase64Transform.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlDsigBase64Transform.xml
index ce9c4a253a6..5cd8fea539a 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlDsigBase64Transform.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlDsigBase64Transform.xml
@@ -60,12 +60,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Xml.XmlNodeList" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an XML representation of the parameters of the <see cref="T:System.Security.Cryptography.Xml.XmlDsigBase64Transform" /> object that are suitable to be included as subelements of an XMLDSIG &lt;Transform&gt; element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A list of the XML nodes that represent the transform-specific content needed to describe the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigBase64Transform" /> object in an XMLDSIG &lt;Transform&gt; element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOutput">
@@ -82,7 +85,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The type of the returned object must be <see cref="T:System.IO.Stream" />.</para>
@@ -91,6 +93,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the output of the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigBase64Transform" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The output of the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigBase64Transform" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOutput">
@@ -109,7 +115,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The type of the returned object must be <see cref="T:System.IO.Stream" />.</para>
@@ -118,6 +123,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the output of the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigBase64Transform" /> object of type <see cref="T:System.IO.Stream" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The output of the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigBase64Transform" /> object of type <see cref="T:System.IO.Stream" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the output to return. <see cref="T:System.IO.Stream" /> is the only valid type for this parameter. </param>
       </Docs>
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlDsigC14NTransform.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlDsigC14NTransform.xml
index 7f94c0d5fea..9f02ab42036 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlDsigC14NTransform.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlDsigC14NTransform.xml
@@ -92,12 +92,15 @@
         <Parameter Name="hash" Type="System.Security.Cryptography.HashAlgorithm" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the digest associated with an <see cref="T:System.Security.Cryptography.Xml.XmlDsigC14NTransform" /> object. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The digest associated with an <see cref="T:System.Security.Cryptography.Xml.XmlDsigC14NTransform" /> object.</para>
+        </returns>
         <param name="hash">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Cryptography.HashAlgorithm" /> object used to create a digest.</param>
       </Docs>
@@ -116,12 +119,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Xml.XmlNodeList" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an XML representation of the parameters of an <see cref="T:System.Security.Cryptography.Xml.XmlDsigC14NTransform" /> object that are suitable to be included as subelements of an XMLDSIG &lt;Transform&gt; element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A list of the XML nodes that represent the transform-specific content needed to describe the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigC14NTransform" /> object in an XMLDSIG &lt;Transform&gt; element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOutput">
@@ -138,7 +144,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The type of the returned object must be <see cref="T:System.IO.Stream" />.</para>
@@ -147,6 +152,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the output of the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigC14NTransform" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The output of the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigC14NTransform" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOutput">
@@ -165,7 +174,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The type of the returned object must be <see cref="T:System.IO.Stream" />.</para>
@@ -174,6 +182,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the output of the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigC14NTransform" /> object of type <see cref="T:System.IO.Stream" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The output of the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigC14NTransform" /> object of type <see cref="T:System.IO.Stream" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the output to return. <see cref="T:System.IO.Stream" /> is the only valid type for this parameter. </param>
       </Docs>
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlDsigEnvelopedSignatureTransform.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlDsigEnvelopedSignatureTransform.xml
index eed37eeca3c..f961d59b439 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlDsigEnvelopedSignatureTransform.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlDsigEnvelopedSignatureTransform.xml
@@ -84,12 +84,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Xml.XmlNodeList" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an XML representation of the parameters of an <see cref="T:System.Security.Cryptography.Xml.XmlDsigEnvelopedSignatureTransform" /> object that are suitable to be included as subelements of an XMLDSIG &lt;Transform&gt; element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A list of the XML nodes that represent the transform-specific content needed to describe the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigEnvelopedSignatureTransform" /> object in an XMLDSIG &lt;Transform&gt; element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOutput">
@@ -106,7 +109,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The type of the returned object must be <see cref="T:System.Xml.XmlNodeList" />.</para>
@@ -115,6 +117,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the output of the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigEnvelopedSignatureTransform" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The output of the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigEnvelopedSignatureTransform" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOutput">
@@ -133,7 +139,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The type of the returned object must be <see cref="T:System.Xml.XmlNodeList" />.</para>
@@ -142,6 +147,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the output of the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigEnvelopedSignatureTransform" /> object of type <see cref="T:System.Xml.XmlNodeList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The output of the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigEnvelopedSignatureTransform" /> object of type <see cref="T:System.Xml.XmlNodeList" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the output to return. <see cref="T:System.Xml.XmlNodeList" /> is the only valid type for this parameter. </param>
       </Docs>
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlDsigExcC14NTransform.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlDsigExcC14NTransform.xml
index 1f02bc51f93..7ea068f9524 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlDsigExcC14NTransform.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlDsigExcC14NTransform.xml
@@ -137,13 +137,16 @@
         <Parameter Name="hash" Type="System.Security.Cryptography.HashAlgorithm" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the digest associated with a <see cref="T:System.Security.Cryptography.Xml.XmlDsigExcC14NTransform" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The digest associated with a <see cref="T:System.Security.Cryptography.Xml.XmlDsigExcC14NTransform" /> object.</para>
+        </returns>
         <param name="hash">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Cryptography.HashAlgorithm" /> object used to create a digest.</param>
       </Docs>
@@ -161,13 +164,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an XML representation of the parameters of a <see cref="T:System.Security.Cryptography.Xml.XmlDsigExcC14NTransform" /> object that are suitable to be included as subelements of an XMLDSIG &lt;Transform&gt; element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A list of the XML nodes that represent the transform-specific content needed to describe the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigExcC14NTransform" /> object in an XMLDSIG &lt;Transform&gt; element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOutput">
@@ -183,13 +189,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the output of the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigExcC14NTransform" /> object</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The output of the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigExcC14NTransform" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOutput">
@@ -207,7 +216,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -218,6 +226,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the output of the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigExcC14NTransform" /> object as an object of the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The output of the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigExcC14NTransform" /> object as an object of the specified type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the output to return. This must be one of the types in the <see cref="P:System.Security.Cryptography.Xml.XmlDsigExcC14NTransform.OutputTypes" /> property.</param>
       </Docs>
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlDsigXPathTransform.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlDsigXPathTransform.xml
index 2fa9d13a049..2624587fed0 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlDsigXPathTransform.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlDsigXPathTransform.xml
@@ -61,12 +61,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Xml.XmlNodeList" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an XML representation of the parameters of a <see cref="T:System.Security.Cryptography.Xml.XmlDsigXPathTransform" /> object that are suitable to be included as subelements of an XMLDSIG &lt;Transform&gt; element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A list of the XML nodes that represent the transform-specific content needed to describe the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigXPathTransform" /> object in an XMLDSIG &lt;Transform&gt; element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOutput">
@@ -83,7 +86,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The type of the returned object must be <see cref="T:System.Xml.XmlNodeList" />.</para>
@@ -93,6 +95,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the output of the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigXPathTransform" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The output of the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigXPathTransform" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOutput">
@@ -111,7 +117,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The type of the returned object must be <see cref="T:System.Xml.XmlNodeList" />.</para>
@@ -121,6 +126,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the output of the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigXPathTransform" /> object of type <see cref="T:System.Xml.XmlNodeList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The output of the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigXPathTransform" /> object of type <see cref="T:System.Xml.XmlNodeList" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the output to return. <see cref="T:System.Xml.XmlNodeList" /> is the only valid type for this parameter. </param>
       </Docs>
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlDsigXsltTransform.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlDsigXsltTransform.xml
index 55e205ca803..d6780bcf21a 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlDsigXsltTransform.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlDsigXsltTransform.xml
@@ -84,12 +84,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Xml.XmlNodeList" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an XML representation of the parameters of the <see cref="T:System.Security.Cryptography.Xml.XmlDsigXsltTransform" /> object that are suitable to be included as subelements of an XMLDSIG &lt;Transform&gt; element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A list of the XML nodes that represent the transform-specific content needed to describe the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigXsltTransform" /> object in an XMLDSIG &lt;Transform&gt; element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOutput">
@@ -106,7 +109,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The type of the returned object must be <see cref="T:System.IO.Stream" />.</para>
@@ -115,6 +117,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the output of the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigXsltTransform" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The output of the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigXsltTransform" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOutput">
@@ -133,7 +139,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The type of the returned object must be <see cref="T:System.IO.Stream" />.</para>
@@ -142,6 +147,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the output of the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigXsltTransform" /> object of type <see cref="T:System.IO.Stream" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The output of the current <see cref="T:System.Security.Cryptography.Xml.XmlDsigXsltTransform" /> object of type <see cref="T:System.IO.Stream" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the output to return. <see cref="T:System.IO.Stream" /> is the only valid type for this parameter. </param>
       </Docs>
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlLicenseTransform.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlLicenseTransform.xml
index bbbddbccac8..b13eee89be4 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlLicenseTransform.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography.Xml/XmlLicenseTransform.xml
@@ -80,13 +80,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an XML representation of the parameters of an <see cref="T:System.Security.Cryptography.Xml.XmlLicenseTransform" /> object that are suitable to be included as subelements of an XMLDSIG &lt;Transform&gt; element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A list of the XML nodes that represent the transform-specific content needed to describe the current <see cref="T:System.Security.Cryptography.Xml.XmlLicenseTransform" /> object in an XMLDSIG &lt;Transform&gt; element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOutput">
@@ -102,7 +105,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -112,6 +114,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the output of an <see cref="T:System.Security.Cryptography.Xml.XmlLicenseTransform" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The output of the <see cref="T:System.Security.Cryptography.Xml.XmlLicenseTransform" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOutput">
@@ -129,13 +135,16 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the output of an <see cref="T:System.Security.Cryptography.Xml.XmlLicenseTransform" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The output of the <see cref="T:System.Security.Cryptography.Xml.XmlLicenseTransform" /> object.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the output to return. <see cref="T:System.Xml.XmlDocument" /> is the only valid type for this parameter.</param>
       </Docs>
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography/CryptographicAttributeObjectCollection.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography/CryptographicAttributeObjectCollection.xml
index a351e2a4002..8574a0e6aa1 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography/CryptographicAttributeObjectCollection.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography/CryptographicAttributeObjectCollection.xml
@@ -79,13 +79,16 @@
         <Parameter Name="asnEncodedData" Type="System.Security.Cryptography.AsnEncodedData" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Security.Cryptography.AsnEncodedData" /> object to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the method returns the zero-based index of the added item; otherwise, false.</para>
+        </returns>
         <param name="asnEncodedData">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Cryptography.AsnEncodedData" /> object to add to the collection.</param>
       </Docs>
@@ -105,13 +108,16 @@
         <Parameter Name="attribute" Type="System.Security.Cryptography.CryptographicAttributeObject" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Security.Cryptography.CryptographicAttributeObject" /> object to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the method returns the zero-based index of the added item; otherwise, false.</para>
+        </returns>
         <param name="attribute">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Cryptography.CryptographicAttributeObject" /> object to add to the collection.</param>
       </Docs>
@@ -178,13 +184,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Security.Cryptography.CryptographicAttributeObjectEnumerator" /> object for the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the method returns a <see cref="T:System.Security.Cryptography.CryptographicAttributeObjectEnumerator" /> object that can be used to enumerate the collection; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsSynchronized">
@@ -319,12 +328,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the <see cref="T:System.Security.Cryptography.CryptographicAttributeObjectCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> object that can be used to iterate through the <see cref="T:System.Security.Cryptography.CryptographicAttributeObjectCollection" /> collection.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography/CryptographicAttributeObjectEnumerator.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography/CryptographicAttributeObjectEnumerator.xml
index 2ab28ff577a..93b74c303a9 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography/CryptographicAttributeObjectEnumerator.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography/CryptographicAttributeObjectEnumerator.xml
@@ -58,13 +58,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the enumeration to the next <see cref="T:System.Security.Cryptography.CryptographicAttributeObject" /> object in the <see cref="T:System.Security.Cryptography.CryptographicAttributeObjectCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the enumeration successfully moved to the next <see cref="T:System.Security.Cryptography.CryptographicAttributeObject" /> object; false if the enumerator is at the end of the enumeration.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Reset">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography/ProtectedData.xml b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography/ProtectedData.xml
index e3741c3696f..c1ba22329ad 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Cryptography/ProtectedData.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Cryptography/ProtectedData.xml
@@ -42,7 +42,6 @@
         <Parameter Name="scope" Type="System.Security.Cryptography.DataProtectionScope" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -55,6 +54,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encrypts the data in a specified byte array and returns a byte array that contains the encrypted data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array representing the encrypted data.</para>
+        </returns>
         <param name="userData">
           <attribution license="cc4" from="Microsoft" modified="false" />A byte array that contains data to encrypt. </param>
         <param name="optionalEntropy">
@@ -80,7 +83,6 @@
         <Parameter Name="scope" Type="System.Security.Cryptography.DataProtectionScope" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -93,6 +95,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decrypts the data in a specified byte array and returns a byte array that contains the decrypted data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array representing the decrypted data.</para>
+        </returns>
         <param name="encryptedData">
           <attribution license="cc4" from="Microsoft" modified="false" />A byte array containing data encrypted using the <see cref="M:System.Security.Cryptography.ProtectedData.Protect(System.Byte[],System.Byte[],System.Security.Cryptography.DataProtectionScope)" /> method. </param>
         <param name="optionalEntropy">
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Permissions/DataProtectionPermission.xml b/mcs/class/System.Security/Documentation/en/System.Security.Permissions/DataProtectionPermission.xml
index 4a8ffd39313..8e39d3f2615 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Permissions/DataProtectionPermission.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Permissions/DataProtectionPermission.xml
@@ -86,7 +86,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -96,6 +95,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an identical copy of the current permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current permission.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Flags">
@@ -164,7 +167,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -174,6 +176,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a permission that is the intersection of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the intersection of the current permission and the specified permission. This new permission is null if the intersection is empty.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to intersect with the current permission. It must be the same type as the current permission. </param>
       </Docs>
@@ -193,7 +199,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -203,6 +208,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current permission is a subset of the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is a subset of the specified permission; otherwise, false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to test for the subset relationship. This permission must be the same type as the current permission. </param>
       </Docs>
@@ -220,7 +229,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -230,6 +238,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the current permission is unrestricted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is unrestricted; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToXml">
@@ -245,7 +257,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -255,6 +266,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the permission and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the permission, including state information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Union">
@@ -272,7 +287,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -282,6 +296,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a permission that is the union of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the union of the current permission and the specified permission.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to combine with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
diff --git a/mcs/class/System.Security/Documentation/en/System.Security.Permissions/DataProtectionPermissionAttribute.xml b/mcs/class/System.Security/Documentation/en/System.Security.Permissions/DataProtectionPermissionAttribute.xml
index f8e80773485..06033171017 100644
--- a/mcs/class/System.Security/Documentation/en/System.Security.Permissions/DataProtectionPermissionAttribute.xml
+++ b/mcs/class/System.Security/Documentation/en/System.Security.Permissions/DataProtectionPermissionAttribute.xml
@@ -64,7 +64,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -75,6 +74,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new <see cref="T:System.Security.Permissions.DataProtectionPermission" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Permissions.DataProtectionPermission" /> that corresponds to the attribute.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Flags">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.Collections.Generic/KeyedByTypeCollection`1.xml b/mcs/class/System.ServiceModel/Documentation/en/System.Collections.Generic/KeyedByTypeCollection`1.xml
index f0e40125dd2..1f40c6111e5 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.Collections.Generic/KeyedByTypeCollection`1.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.Collections.Generic/KeyedByTypeCollection`1.xml
@@ -76,12 +76,15 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the first item in the collection of a specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object of type <paramref name="T" /> if it is a reference type and the value of type <paramref name="T" /> if it is a value type. The default value of the type is returned if no object of type <paramref name="T" /> is contained in the collection: null if it is a reference type and 0 if it is a value type.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of item in the collection to find.</typeparam>
       </Docs>
@@ -101,12 +104,15 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of objects of type <paramref name="T" /> that are contained in the <see cref="T:System.Collections.Generic.KeyedByTypeCollection`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.ObjectModel.Collection`1" /> of type <paramref name="T" /> that contains the objects of type <paramref name="T" /> from the original collection.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of item in the collection to find.</typeparam>
       </Docs>
@@ -167,12 +173,15 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes an object of a specified type from the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object removed from the collection.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of item in the collection to remove.</typeparam>
       </Docs>
@@ -192,12 +201,15 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes all of the elements of a specified type from the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Collections.ObjectModel.Collection`1" /> that contains the objects of type <paramref name="T" /> from the original collection.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of item in the collection to remove.</typeparam>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.Collections.Generic/SynchronizedCollection`1.xml b/mcs/class/System.ServiceModel/Documentation/en/System.Collections.Generic/SynchronizedCollection`1.xml
index 847f59773b5..ad53c8e734b 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.Collections.Generic/SynchronizedCollection`1.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.Collections.Generic/SynchronizedCollection`1.xml
@@ -273,12 +273,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the synchronized collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerator`1" /> for objects of the type stored in the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IndexOf">
@@ -589,12 +592,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the synchronized collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerator`1" /> for objects of the type stored in the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Add">
@@ -611,7 +617,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The position is given by a zero-based index.</para>
@@ -620,6 +625,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an element to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position into which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to add to the collection.</param>
       </Docs>
@@ -638,12 +647,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the collection contains an element with a specific value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the element <paramref name="value" /> is found in the collection; otherwise false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to locate in the collection.</param>
       </Docs>
@@ -662,12 +674,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the zero-based index of an element in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the <paramref name="value" /> if found in the collection; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The element in the collection whose index is being determined.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.Collections.Generic/SynchronizedReadOnlyCollection`1.xml b/mcs/class/System.ServiceModel/Documentation/en/System.Collections.Generic/SynchronizedReadOnlyCollection`1.xml
index 0994679b96a..531152df753 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.Collections.Generic/SynchronizedReadOnlyCollection`1.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.Collections.Generic/SynchronizedReadOnlyCollection`1.xml
@@ -215,12 +215,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the synchronized, read-only collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerator`1" /> for objects of the type stored in the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IndexOf">
@@ -492,12 +495,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the synchronized, read-only collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Collections.IEnumerator" />.  An enumerator that iterates through the synchronized, read-only collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Add">
@@ -514,7 +520,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Items cannot be added to a read-only collection.</para>
@@ -523,6 +528,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an element to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Int32" />. The position into which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The element to be added to the collection.</param>
       </Docs>
@@ -563,7 +572,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns true if the element <paramref name="value" /> is found in the collection; otherwise false.</para>
@@ -572,6 +580,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks whether the specified object exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>True if the object is located in the collection; otherwise false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to locate in the collection.</param>
       </Docs>
@@ -590,12 +603,16 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the specified item.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Int32" />.</para>
+          <para>The zero-based index of the first occurrence of the <paramref name="value" /> in the collection.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The element whose index is being retrieved.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Activation/HostedTransportConfiguration.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Activation/HostedTransportConfiguration.xml
index c63fa3d1dcb..bcc98fd0c6c 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Activation/HostedTransportConfiguration.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Activation/HostedTransportConfiguration.xml
@@ -51,7 +51,6 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information about the use of this class, see the <format type="text/html"><a href="4b0ccd10-0dfb-4603-93f9-f0857c581cb7">UDP Activation</a></format> sample, which demonstrates how to create a custom user datagram protocol (UDP) to be activated by WAS.</para>
@@ -60,6 +59,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, retrieves the base address of the host.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Uri" /> that contains the base address of the host.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path to the service.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Activation/ServiceHostFactoryBase.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Activation/ServiceHostFactoryBase.xml
index 6e5bcc9683e..a54ebc2efbb 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Activation/ServiceHostFactoryBase.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Activation/ServiceHostFactoryBase.xml
@@ -52,12 +52,15 @@
         <Parameter Name="baseAddresses" Type="System.Uri[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates a <see cref="T:System.ServiceModel.ServiceHostBase" /> with a specific base address using custom initiation data. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.ServiceHostBase" /> object with the specified base addresses and initialized with the custom initiation data.</para>
+        </returns>
         <param name="constructorString">
           <attribution license="cc4" from="Microsoft" modified="false" />The initialization data that is passed to the <see cref="T:System.ServiceModel.ServiceHostBase" /> instance being constructed by the factory. </param>
         <param name="baseAddresses">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/AddressHeader.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/AddressHeader.xml
index a802c8981be..7ee49be6a5b 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/AddressHeader.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/AddressHeader.xml
@@ -54,12 +54,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the <see cref="T:System.ServiceModel.Channels.AddressHeader" /> class with a specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.AddressHeader" /> that contains the information item specified by the <paramref name="value" /> parameter.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The information item for the address header.</param>
       </Docs>
@@ -80,12 +83,15 @@
       </Parameters>
       <Docs>
         <param name="formatter">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the <see cref="T:System.ServiceModel.Channels.AddressHeader" /> class using a specified formatter to serialize the information item from a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.AddressHeader" /> that contains the information item specified by the value parameter.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The information item for the address header.</param>
       </Docs>
@@ -106,12 +112,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the <see cref="T:System.ServiceModel.Channels.AddressHeader" /> class with a specified value, name and namespace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.AddressHeader" /> with the specified <paramref name="name" /> and <paramref name="ns" /> that contains the information item specified by <paramref name="value" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the address header.</param>
         <param name="ns">
@@ -138,12 +147,15 @@
       </Parameters>
       <Docs>
         <param name="formatter">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the <see cref="T:System.ServiceModel.Channels.AddressHeader" /> class with a specified name and namespace that uses a specified formatter to serialize the information item from a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.AddressHeader" /> with the specified <paramref name="name" /> and <paramref name="ns" /> that contains the information item specified by <paramref name="value" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the address header.</param>
         <param name="ns">
@@ -166,7 +178,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks for equivalence of serialized canonical XML between the information items.</para>
@@ -175,6 +186,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the information item in a specified object is equal to the object contained in the current address header.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the information item in a specified <paramref name="obj" /> is equivalent to the information item contained in the current address header; otherwise, false. In particular, returns false if <paramref name="obj" /> is null.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to compare with the object contained in the current address header.</param>
       </Docs>
@@ -191,12 +206,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an XML reader that can serialize the current address header object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Xml.XmlDictionaryReader" /> that can serialize the current address header object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -211,7 +229,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the string-based implementation.</para>
@@ -222,6 +239,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides a unique hash code for an address header. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A unique hash code for the current address header.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetValue&lt;T&gt;">
@@ -239,7 +260,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When using this overload, you must supply a type for the generic parameter <paramref name="T" />. The type of the return value is determined by the generic type parameter. </para>
@@ -249,6 +269,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes the information item from the current address header to an object of a specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of a class of type <paramref name="T" /> with its fields and properties set to the values supplied by the current address header object.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />A class of type <paramref name="T" /> with its fields and properties set to the values supplied by the current address header object.</typeparam>
       </Docs>
@@ -271,7 +295,6 @@
       </Parameters>
       <Docs>
         <param name="formatter">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When using this overload, you must supply a type for the generic parameter <paramref name="T" />. The type of the return value is determined by the generic type parameter.</para>
@@ -281,6 +304,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes the information item from the current address header to an object of a specified type that uses a specified formatter to serialize this information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of a class of type <paramref name="T" /> with its fields and properties set to the values supplied by the current address header object.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />A class of type <paramref name="T" /> with its fields and properties set to the values supplied by the current address header object.</typeparam>
       </Docs>
@@ -381,12 +408,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Wraps the address header as a message header.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.MessageHeader" /> that wraps the current address header.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="WriteAddressHeader">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/AddressHeaderCollection.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/AddressHeaderCollection.xml
index 77b693c834c..540f8def49d 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/AddressHeaderCollection.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/AddressHeaderCollection.xml
@@ -100,12 +100,15 @@
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds all the address headers in the collection with the specified name and namespace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Array" /> of type <see cref="T:System.ServiceModel.Channels.AddressHeader" /> that contains all the headers in the collection with the specified name and namespace.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the address header to be found.</param>
         <param name="ns">
@@ -127,7 +130,6 @@
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you need to find all the address headers in the collection with the specified name and namespace, use the <see cref="M:System.ServiceModel.Channels.AddressHeaderCollection.FindAll(System.String,System.String)" /> method instead.</para>
@@ -138,6 +140,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds the first address header in the collection with a specified name and namespace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.AddressHeader" /> in the collection with the specified name and namespace.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the address header to be found.</param>
         <param name="ns">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/AddressingVersion.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/AddressingVersion.xml
index c4d8af4bf7a..f04cfab9f62 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/AddressingVersion.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/AddressingVersion.xml
@@ -56,12 +56,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of the current addressing version.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current addressing version.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="WSAddressing10">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/AsymmetricSecurityBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/AsymmetricSecurityBindingElement.xml
index 984eb27614e..c3a599f03db 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/AsymmetricSecurityBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/AsymmetricSecurityBindingElement.xml
@@ -403,7 +403,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This creates a complete copy of the current binding element object tree, also called a deep clone. A deep clone of an object creates a copy of the object and a copy of everything directly or indirectly referenced by that object. (This can also be described as copying the entire object graph.) Returning a deep clone enables the runtime to support the case in which multiple custom bindings share a custom binding element. If a deep clone is not returned, the run-time behavior is undefined. </para>
@@ -413,6 +412,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of this class initialized from the current one.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.BindingElement" /> object with property values equal to those of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetProperty&lt;T&gt;">
@@ -436,7 +439,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method gets the specified object from the base class or from one of that class's ancestors. The object that is returned is usually a collection of properties, for example an object that implements <see cref="T:System.ServiceModel.Channels.ISecurityCapabilities" />.</para>
@@ -445,6 +447,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a specified object from the <see cref="T:System.ServiceModel.Channels.BindingContext" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified object from the <see cref="T:System.ServiceModel.Channels.BindingContext" /> or null if the object is not found.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ServiceModel.Channels.BindingContext" />.</param>
         <typeparam name="T">
@@ -611,7 +617,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Information returned by <see cref="M:System.ServiceModel.Channels.AsymmetricSecurityBindingElement.ToString" /> includes the <see cref="P:System.ServiceModel.Channels.AsymmetricSecurityBindingElement.MessageProtectionOrder" />, <see cref="P:System.ServiceModel.Channels.AsymmetricSecurityBindingElement.RequireSignatureConfirmation" />, <see cref="P:System.ServiceModel.Channels.AsymmetricSecurityBindingElement.RecipientTokenParameters" />, and <see cref="P:System.ServiceModel.Channels.AsymmetricSecurityBindingElement.InitiatorTokenParameters" /> values of the current instance.</para>
@@ -620,6 +625,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents this <see cref="T:System.ServiceModel.Channels.AsymmetricSecurityBindingElement" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current <see cref="T:System.ServiceModel.Channels.AsymmetricSecurityBindingElement" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/BinaryMessageEncodingBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/BinaryMessageEncodingBindingElement.xml
index 248b8a78a43..33aa0a0d7e8 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/BinaryMessageEncodingBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/BinaryMessageEncodingBindingElement.xml
@@ -65,12 +65,15 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds the channel factory stack on the client that creates a specified type of channel for a specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Channels.IChannelFactory`1" /> of type <paramref name="TChannel" /> for the specified context.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> for the channel.</param>
         <typeparam name="TChannel">
@@ -99,12 +102,15 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds the channel listener on the service that accepts a specified type of channel for a specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Channels.IChannelListener`1" /> of type <paramref name="TChannel" /> for the specified context.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> for the listener.</param>
         <typeparam name="TChannel">
@@ -133,12 +139,15 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current binding can build a listener for a specified type of channel and context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified channel listener stack can be built on the service; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> for the listener.</param>
         <typeparam name="TChannel">
@@ -157,7 +166,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This creates a complete copy of the current binding element object tree, also called a deep clone. A deep clone of an object creates a copy of the object and a copy of everything directly or indirectly referenced by that object. (This can also be described as copying the entire object graph.) Returning a deep clone enables the runtime to support the case in which multiple custom bindings share a custom binding element. If a deep clone is not returned, the runtime behavior is undefined. </para>
@@ -167,6 +175,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Channels.BinaryMessageEncodingBindingElement" /> object initialized from the current one.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.BinaryMessageEncodingBindingElement" /> object with property values equal to those of the current element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CompressionFormat">
@@ -200,7 +212,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.ServiceModel.Channels.MessageEncoder" /> objects that the factory produces can read and write messages using the binary message encoding.</para>
@@ -209,6 +220,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a factory for binary message encoders that employ the SOAP and WS-Addressing versions and the character encoding specified by the current encoding binding element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.MessageEncoderFactory" /> that this binding element creates.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetProperty&lt;T&gt;">
@@ -232,7 +247,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this to request a typed object for setting properties or getting status from the appropriate layer in the binding element stack. If a layer supports returning the requested object, it returns it. If not, it delegates the call down to the next layer in the stack. If it gets to the bottom of the stack and no binding element layer supported the requested object, then the method returns null.</para>
@@ -241,6 +255,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a typed object requested, if present, from the appropriate layer in the binding element stack.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The typed object <paramref name="T" /> requested if it is present or null if it is not.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> for the binding element.</param>
         <typeparam name="T">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/Binding.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/Binding.xml
index 83c7c7895f7..32007d656f5 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/Binding.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/Binding.xml
@@ -249,12 +249,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds the channel factory stack on the client that creates a specified type of channel and that satisfies the features specified by an object array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Channels.IChannelFactory`1" /> of type <paramref name="TChannel" /> that satisfies the features specified by the collection.</para>
+        </returns>
         <param name="parameters">
           <attribution license="cc4" from="Microsoft" modified="false" />The object array that specifies requirements for the channel factory that is built.</param>
         <typeparam name="TChannel">
@@ -278,12 +281,15 @@
         <Parameter Name="parameters" Type="System.ServiceModel.Channels.BindingParameterCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds the channel factory stack on the client that creates a specified type of channel and that satisfies the features specified by a collection of binding parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Channels.IChannelFactory`1" /> of type <paramref name="TChannel" /> that satisfies the features specified by the collection.</para>
+        </returns>
         <param name="parameters">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingParameterCollection" /> that specifies requirements for the channel factory built.</param>
         <typeparam name="TChannel">
@@ -318,12 +324,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Channels.IChannelListener`1" /> of type <paramref name="TChannel" /> that satisfies the features specified.</para>
+        </returns>
         <param name="parameters">
           <attribution license="cc4" from="Microsoft" modified="false" />The object array that specifies requirements for the channel factory built.</param>
         <typeparam name="TChannel">
@@ -352,12 +361,15 @@
         <Parameter Name="parameters" Type="System.ServiceModel.Channels.BindingParameterCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified by a collection of binding parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Channels.IChannelListener`1" /> of type <paramref name="TChannel" /> that satisfies the features specified.</para>
+        </returns>
         <param name="parameters">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingParameterCollection" /> that specifies requirements for the channel listener that is built.</param>
         <typeparam name="TChannel">
@@ -394,12 +406,15 @@
       </Parameters>
       <Docs>
         <param name="listenUri">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Channels.IChannelListener`1" /> of type <paramref name="TChannel" /> that satisfies the features specified.</para>
+        </returns>
         <param name="parameters">
           <attribution license="cc4" from="Microsoft" modified="false" />The object array that specifies requirements for the channel factory that is built.</param>
         <typeparam name="TChannel">
@@ -430,12 +445,15 @@
       </Parameters>
       <Docs>
         <param name="listenUri">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Channels.IChannelListener`1" /> of type <paramref name="TChannel" /> that satisfies the features specified.</para>
+        </returns>
         <param name="parameters">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingParameterCollection" /> that specifies requirements for the channel listener that is built.</param>
         <typeparam name="TChannel">
@@ -472,12 +490,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Channels.IChannelListener`1" /> of type <paramref name="TChannel" /> that satisfies the features specified.</para>
+        </returns>
         <param name="listenUriBaseAddress">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Uri" /> that provides the base address on which the service listens.</param>
         <param name="listenUriRelativeAddress">
@@ -512,12 +533,15 @@
         <Parameter Name="parameters" Type="System.ServiceModel.Channels.BindingParameterCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Channels.IChannelListener`1" /> of type <paramref name="TChannel" /> that satisfies the features specified.</para>
+        </returns>
         <param name="listenUriBaseAddress">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Uri" /> that provides the base address on which the service listens.</param>
         <param name="listenUriRelativeAddress">
@@ -559,12 +583,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Channels.IChannelListener`1" /> of type <paramref name="TChannel" /> that satisfies the features specified.</para>
+        </returns>
         <param name="listenUriBaseAddress">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Uri" /> that provides the base address on which the service listens.</param>
         <param name="listenUriRelativeAddress">
@@ -602,12 +629,15 @@
         <Parameter Name="parameters" Type="System.ServiceModel.Channels.BindingParameterCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Channels.IChannelListener`1" /> of type <paramref name="TChannel" /> that satisfies the features specified.</para>
+        </returns>
         <param name="listenUriBaseAddress">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Uri" /> that provides the base address on which the service listens.</param>
         <param name="listenUriRelativeAddress">
@@ -643,7 +673,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method if you want to check that the channel factory for channels of type <paramref name="TChannel" /> can be build for the binding <paramref name="parameters" /> specified before attempting to actually build the factory. Alternatively, try to build the channel factory by calling <see cref="M:System.ServiceModel.Channels.Binding.BuildChannelFactory``1(System.Object[])" /> and catch the exception generated if it cannot be built.</para>
@@ -652,6 +681,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current binding can build a channel factory stack on the client that satisfies the requirements specified by an object array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified channel factory stack can be build on the client; otherwise, false.</para>
+        </returns>
         <param name="parameters">
           <attribution license="cc4" from="Microsoft" modified="false" />The object array that specifies requirements for the channel factory that is built.</param>
         <typeparam name="TChannel">
@@ -675,7 +708,6 @@
         <Parameter Name="parameters" Type="System.ServiceModel.Channels.BindingParameterCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method if you want to check that the channel factory for channels of type <paramref name="TChannel" /> can be build for the binding <paramref name="parameters" /> specified before attempting to actually build the factory. Alternatively, try to build the channel factory by calling <see cref="M:System.ServiceModel.Channels.Binding.BuildChannelFactory``1(System.ServiceModel.Channels.BindingParameterCollection)" /> and catch the exception generated if it cannot be built.</para>
@@ -684,6 +716,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current binding can build a channel factory stack on the client that satisfies the collection of binding parameters specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified channel factory stack can be build on the client; otherwise, false.</para>
+        </returns>
         <param name="parameters">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingParameterCollection" /> that specifies requirements for the channel factory that is built.</param>
         <typeparam name="TChannel">
@@ -718,7 +754,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method if you want to check that the channel listener for channels of type <paramref name="TChannel" /> can be build for the binding <paramref name="parameters" /> specified before attempting to actually build the listener. Alternatively, try to build the channel listener by calling <see cref="M:System.ServiceModel.Channels.Binding.BuildChannelListener``1(System.Object[])" /> and catch the exception generated if it cannot be built.</para>
@@ -727,6 +762,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current binding can build a channel listener stack on the service that satisfies the criteria specified in an array of objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified channel listener stack can be build on the service; otherwise, false.</para>
+        </returns>
         <param name="parameters">
           <attribution license="cc4" from="Microsoft" modified="false" />The object array that specifies requirements for the channel factory that is built.</param>
         <typeparam name="TChannel">
@@ -755,7 +794,6 @@
         <Parameter Name="parameters" Type="System.ServiceModel.Channels.BindingParameterCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method if you want to check that the channel listener for channels of type <paramref name="TChannel" /> can be build for the binding <paramref name="parameters" /> specified before attempting to actually build the listener. Alternatively, try to build the channel listener by calling <see cref="M:System.ServiceModel.Channels.Binding.BuildChannelListener``1(System.ServiceModel.Channels.BindingParameterCollection)" /> and catch the exception generated if it cannot be built.</para>
@@ -764,6 +802,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current binding can build a channel listener stack on the service that satisfies the collection of binding parameters specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified channel listener stack can be build on the service; otherwise, false.</para>
+        </returns>
         <param name="parameters">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingParameterCollection" /> that specifies requirements for the channel listener that is built.</param>
         <typeparam name="TChannel">
@@ -804,7 +846,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The elements should not reference any internal elements that the <see cref="T:System.ServiceModel.Channels.Binding" /> object uses.</para>
@@ -813,6 +854,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates a collection that contains the binding elements that are part of the current binding. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.Generic.ICollection`1" /> object of type <see cref="T:System.ServiceModel.Channels.BindingElement" /> that contains the binding elements from the current binding object in the correct order.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetProperty&lt;T&gt;">
@@ -836,7 +881,6 @@
         <Parameter Name="parameters" Type="System.ServiceModel.Channels.BindingParameterCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If a layer supports returning the requested object, it returns it. If not, it delegates the call down to the next layer in the stack. If it gets to the bottom of the stack and no layer supported the requested object, then the method returns null.</para>
@@ -845,6 +889,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a typed object requested, if present, from the appropriate layer in the binding stack.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The typed object <paramref name="T" /> requested if it is present or null if it is not.</para>
+        </returns>
         <param name="parameters">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingParameterCollection" /> that specifies requirements for the channel listener that is built.</param>
         <typeparam name="T">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/BindingContext.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/BindingContext.xml
index 1bfa0deeaa3..bdb907117c8 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/BindingContext.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/BindingContext.xml
@@ -134,12 +134,15 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds the inner channel factory for channels of a specified type below the current channel factory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.IChannelFactory`1" /> of type <see cref="T:System.ServiceModel.Channels.IChannel" /> that represents the inner channel factory of the current channel factory.</para>
+        </returns>
         <typeparam name="TChannel">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of <see cref="T:System.ServiceModel.Channels.IChannel" /> object the inner channel factory produces.</typeparam>
       </Docs>
@@ -164,12 +167,15 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds an inner channel listener that listens for a specified type of channel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.IChannelListener`1" /> of type <see cref="T:System.ServiceModel.Channels.IChannel" /> that represents the inner channel listener of the current channel factory.</para>
+        </returns>
         <typeparam name="TChannel">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of <see cref="T:System.ServiceModel.Channels.IChannel" /> object for which the inner channel listener listens.</typeparam>
       </Docs>
@@ -189,12 +195,15 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the inner channel factory can produce a specified type of channel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the inner channel factory can produce the specified <paramref name="TChannel" />; otherwise, false.</para>
+        </returns>
         <typeparam name="TChannel">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of <see cref="T:System.ServiceModel.Channels.IChannel" /> object the inner channel factory produces.</typeparam>
       </Docs>
@@ -219,12 +228,15 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the inner channel listener can be built to listen for a specified type of channel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the inner channel listener can be built to listen for the <paramref name="TChannel" /> specified; otherwise, false.</para>
+        </returns>
         <typeparam name="TChannel">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of <see cref="T:System.ServiceModel.Channels.IChannel" /> object for which the inner channel listener listens.</typeparam>
       </Docs>
@@ -241,7 +253,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns a copy that is a deep clone of your binding context. A deep clone of an object creates a copy of the object and a copy of everything directly or indirectly referenced by that object. (This is also called copying the entire object graph.) A shallow clone of an object, by contrast, is a copy of the object only. If the object contains references to other objects, the shallow copy does not create copies of the referred objects; instead, it copies only the references to the original objects.</para>
@@ -250,6 +261,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a copy of the current channel build context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.BindingContext" /> object that is a copy of the current channel build context.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetInnerProperty&lt;T&gt;">
@@ -271,7 +286,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clones the binding context and calls <see cref="M:System.ServiceModel.Channels.BindingElement.GetProperty``1(System.ServiceModel.Channels.BindingContext)" /> on the next binding element stored in the binding context.</para>
@@ -280,6 +294,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a typed object requested, if present, from the appropriate layer in the binding stack.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The typed object <paramref name="T" /> requested if it is present or null if it is not.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The typed object for which the method is querying.</typeparam>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/BindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/BindingElement.xml
index 7f3b189d5ce..310dc704267 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/BindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/BindingElement.xml
@@ -80,12 +80,15 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a channel factory for producing channels of a specified type from the binding context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.IChannelFactory`1" /> of type <paramref name="TChannel" /> initialized from the <paramref name="context" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> that provides context for the binding element. </param>
         <typeparam name="TChannel">
@@ -114,12 +117,15 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a channel listener to accept channels of a specified type from the binding context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.IChannelListener`1" /> of type <see cref="T:System.ServiceModel.Channels.IChannel" /> initialized from the <paramref name="context" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> that provides context for the binding element.</param>
         <typeparam name="TChannel">
@@ -143,7 +149,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method if you want to check that the channel factory for channels of type <paramref name="TChannel" /> can be build for the <paramref name="context" /> provided before attempting to build the factory. Alternatively, build the channel factory by calling <see cref="M:System.ServiceModel.Channels.BindingElement.BuildChannelFactory``1(System.ServiceModel.Channels.BindingContext)" /> and catch the exception generated if it cannot be built.</para>
@@ -152,6 +157,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the binding element can build a channel factory for a specific type of channel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ServiceModel.Channels.IChannelFactory`1" /> of type <paramref name="TChannel" /> can be built by the binding element; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> that provides context for the binding element. </param>
         <typeparam name="TChannel">
@@ -180,7 +189,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method if you want to check that the channel listener for channels of type <paramref name="TChannel" /> can be build for the <paramref name="context" /> provided before attempting to build the listener. Alternatively, build the channel listener by calling <see cref="M:System.ServiceModel.Channels.BindingElement.BuildChannelListener``1(System.ServiceModel.Channels.BindingContext)" /> and catch the exception generated if it cannot be built.</para>
@@ -189,6 +197,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the binding element can build a listener for a specific type of channel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ServiceModel.Channels.IChannelListener`1" /> of type <see cref="T:System.ServiceModel.Channels.IChannel" /> can be built by the binding element; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> that provides context for the binding element. </param>
         <typeparam name="TChannel">
@@ -207,7 +219,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implement the <see cref="M:System.ServiceModel.Channels.BindingElement.Clone" /> method to return a deep clone of your binding element. Returning a clone enables the runtime to support the case in which multiple custom bindings share a custom binding element. If a clone is not returned, the run-time behavior is undefined.</para>
@@ -217,6 +228,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns a copy of the binding element object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.BindingElement" /> object that is a deep clone of the original.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetProperty&lt;T&gt;">
@@ -240,7 +255,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this to retrieve capabilities, requirements and parameters from the binding element stack. If a binding element supports returning the requested object, it returns it. If not, it delegates the call down to the next binding element in the stack. If it gets to the bottom of the stack and no binding element supported the requested object, then the method returns null.</para>
@@ -252,6 +266,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns a typed object requested, if present, from the appropriate layer in the binding stack.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The typed object <paramref name="T" /> requested if it is present or null if it is not present.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> for the binding element.</param>
         <typeparam name="T">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/BindingElementCollection.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/BindingElementCollection.xml
index e4664340f83..dd21260a96d 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/BindingElementCollection.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/BindingElementCollection.xml
@@ -116,12 +116,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the binding element collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the <see cref="T:System.ServiceModel.Channels.BindingElementCollection" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Contains">
@@ -138,12 +141,15 @@
         <Parameter Name="bindingElementType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a specified type of binding element belongs to the collection of binding elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the type of binding element specified is contained in the collection; otherwise, false.</para>
+        </returns>
         <param name="bindingElementType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of binding element being tested for inclusion in the collection.</param>
       </Docs>
@@ -163,12 +169,15 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the first item of a specified type from the collection of binding elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The item of type <see cref="T:System.Type" /> if found; if not found, 0 if <paramref name="T" /> is a value type and null if <paramref name="T" /> is a reference type.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of item to find.</typeparam>
       </Docs>
@@ -188,12 +197,15 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all of the items of a specified type from the collection of binding elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.ObjectModel.Collection`1" /> of all of the items of type <see cref="T:System.Type" /> if found; if none are found, 0 if <paramref name="T" /> is a value type and null if <paramref name="T" /> is a reference type.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of item to find.</typeparam>
       </Docs>
@@ -239,12 +251,15 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes a binding element of a specified type from the collection of binding elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The item of type <see cref="T:System.Type" /> removed.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of item to find.</typeparam>
       </Docs>
@@ -264,12 +279,15 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes all of the binding elements of a specified type from the collection of binding elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.ObjectModel.Collection`1" /> of all of the items of type <see cref="T:System.Type" /> found.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of item to find.</typeparam>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/BindingParameterCollection.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/BindingParameterCollection.xml
index 82b65993d2f..f1c146037fe 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/BindingParameterCollection.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/BindingParameterCollection.xml
@@ -54,12 +54,15 @@
         <Parameter Name="item" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the key of an item contained in the collection. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> object that represents the key of the specified <paramref name="item" /> in the collection.</para>
+        </returns>
         <param name="item">
           <attribution license="cc4" from="Microsoft" modified="false" />The item in the collection whose key is to be retrieved.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/BodyWriter.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/BodyWriter.xml
index 2a0fade6ec2..f15b0bc631a 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/BodyWriter.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/BodyWriter.xml
@@ -58,7 +58,6 @@
         <Parameter Name="maxBufferSize" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <see cref="P:System.ServiceModel.Channels.BodyWriter.IsBuffered" /> is true then the <see cref="T:System.ServiceModel.Channels.BodyWriter" /> object is returned. If <see cref="P:System.ServiceModel.Channels.BodyWriter.IsBuffered" /> is false then the contents of the <see cref="T:System.ServiceModel.Channels.BodyWriter" /> up to <paramref name="maxBufferSize" /> is returned. This also calls <see cref="M:System.ServiceModel.Channels.BodyWriter.OnCreateBufferedCopy(System.Int32)" /> as an extensibility point.</para>
@@ -67,6 +66,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a buffered copy of the body.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.BodyWriter" /> that contains a copy of this object.</para>
+        </returns>
         <param name="maxBufferSize">
           <attribution license="cc4" from="Microsoft" modified="false" />The maximum size of the buffer for the body.</param>
       </Docs>
@@ -107,7 +110,6 @@
         <Parameter Name="maxBufferSize" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A class derived from <see cref="T:System.ServiceModel.Channels.BodyWriter" /> can override this method to create a buffered copy of the <see cref="T:System.ServiceModel.Channels.BodyWriter" />. But the default implementation of <see cref="M:System.ServiceModel.Channels.BodyWriter.WriteBodyContents(System.Xml.XmlDictionaryWriter)" /> calls <see cref="M:System.ServiceModel.Channels.BodyWriter.OnWriteBodyContents(System.Xml.XmlDictionaryWriter)" />, so overriding just <see cref="M:System.ServiceModel.Channels.BodyWriter.OnWriteBodyContents(System.Xml.XmlDictionaryWriter)" /> should be easier and work for most scenarios.</para>
@@ -117,6 +119,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides an extensibility point when the body contents are written.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.BodyWriter" /> with the specified maximum buffer size.</para>
+        </returns>
         <param name="maxBufferSize">
           <attribution license="cc4" from="Microsoft" modified="false" />The maximum size of the buffer for the body.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/BufferManager.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/BufferManager.xml
index 6ebd7ac6ded..2eb0ab1528a 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/BufferManager.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/BufferManager.xml
@@ -74,7 +74,6 @@
         <Parameter Name="maxBufferSize" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates a new buffer pool with as many buffers as can be created.</para>
@@ -83,6 +82,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new BufferManager with a specified maximum buffer pool size and a maximum size for each individual buffer in the pool.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a <see cref="T:System.ServiceModel.Channels.BufferManager" /> object with the specified parameters.</para>
+        </returns>
         <param name="maxBufferPoolSize">
           <attribution license="cc4" from="Microsoft" modified="false" />The maximum size of the pool.</param>
         <param name="maxBufferSize">
@@ -129,7 +132,6 @@
         <Parameter Name="bufferSize" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If successful, the system returns a byte array buffer of at least the requested size.</para>
@@ -138,6 +140,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a buffer of at least the specified size from the pool. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array that is the requested size of the buffer.</para>
+        </returns>
         <param name="bufferSize">
           <attribution license="cc4" from="Microsoft" modified="false" />The size, in bytes, of the requested buffer.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ChannelBase.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ChannelBase.xml
index 4fc1716b78c..44360c85175 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ChannelBase.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ChannelBase.xml
@@ -166,7 +166,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this to request a typed object such as an interface for setting properties or getting status from the appropriate layer in the channel stack. If a layer supports returning the requested object, it returns it. If not, it delegates the call down to the next layer in the stack. If it gets to the bottom of the stack and no channel layer supported the requested object, then the method returns null.</para>
@@ -176,6 +175,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the typed object requested, if present, from the appropriate layer in the channel stack.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The typed object <paramref name="T" /> requested, if it is present, or null, if it is not.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The typed object for which the method is querying.</typeparam>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ChannelFactoryBase.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ChannelFactoryBase.xml
index dd8b95ad043..f56d4dc3384 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ChannelFactoryBase.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ChannelFactoryBase.xml
@@ -176,7 +176,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this to request a typed object such as an interface for setting properties or getting status from the appropriate layer in the channel factory stack. If a layer supports returning the requested object, it returns it. If not, it simply delegates the call down to the next layer in the stack. If it gets to the bottom of the stack and no channel factory layer supported the requested object, then the method returns null.</para>
@@ -186,6 +185,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a typed object requested, if present, from the appropriate layer in the channel stack.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The typed object T requested if it is present or null if it is not.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The typed object for which the method is querying.</typeparam>
       </Docs>
@@ -228,12 +231,15 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to close each of the channels that were created by the factory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous on close operation. </para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies how long the on close operation has to complete before timing out.</param>
         <param name="callback">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ChannelFactoryBase`1.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ChannelFactoryBase`1.xml
index bab768b1f61..ad4f908fa5e 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ChannelFactoryBase`1.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ChannelFactoryBase`1.xml
@@ -87,7 +87,6 @@
       </Parameters>
       <Docs>
         <param name="remoteAddress">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method calls <see cref="M:System.ServiceModel.Channels.ChannelFactoryBase`1.OnCreateChannel(System.ServiceModel.EndpointAddress,System.Uri)" /> when invoked. This method cannot be overridden by a derived class. </para>
@@ -97,6 +96,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a particular type of channel with a specified endpoint address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A channel of type <paramref name="TChannel" /> with the specified <paramref name="address" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateChannel">
@@ -115,7 +118,6 @@
       </Parameters>
       <Docs>
         <param name="remoteAddress">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method calls <see cref="M:System.ServiceModel.Channels.ChannelFactoryBase`1.OnCreateChannel(System.ServiceModel.EndpointAddress,System.Uri)" /> when invoked.</para>
@@ -124,6 +126,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a particular type of channel with specified transport and endpoint addresses.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A channel of type <paramref name="TChannel" /> with the specified remote and transport addresses.</para>
+        </returns>
         <param name="via">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Uri" /> that contains the transport address to which messages are sent on the output channel.</param>
       </Docs>
@@ -166,12 +172,15 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to close all the channels associated with the channel factory within a specified interval of time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous on-close operation. </para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies how long the on-close operation has to complete before timing out.</param>
         <param name="callback">
@@ -223,7 +232,6 @@
       </Parameters>
       <Docs>
         <param name="remoteAddress">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called by <see cref="Overload:System.ServiceModel.Channels.ChannelFactoryBase`1.CreateChannel" /> when invoked.</para>
@@ -232,6 +240,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented in a derived class, provides an extensibility point when creating channels.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A channel of type <paramref name="TChannel" /> with the specified addresses.</para>
+        </returns>
         <param name="via">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Uri" /> that contains the transport address to which messages are sent on the output channel.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ChannelListenerBase.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ChannelListenerBase.xml
index 1c9b6992eb4..da5bc776a93 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ChannelListenerBase.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ChannelListenerBase.xml
@@ -83,12 +83,15 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented in a derived class, begins an asynchronous operation to wait for a channel to arrive.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous wait for a channel operation. </para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies how long the wait for a channel operation has to complete before timing out.</param>
         <param name="callback">
@@ -199,12 +202,15 @@
         <Parameter Name="result" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented in a derived class, completes an asynchronous operation to wait for channels to arrive.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a message arrived; otherwise false.</para>
+        </returns>
         <param name="result">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IAsyncResult" /> returned by a call to the <see cref="M:System.ServiceModel.Channels.ChannelListenerBase.EndWaitForChannel(System.IAsyncResult)" /> method.</param>
       </Docs>
@@ -228,7 +234,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this to request a typed object such as an interface for setting properties or getting status from the appropriate layer in the channel listener stack. If a layer supports returning the requested object, it returns it. If not, it simply delegates the call down to the next layer in the stack. If it gets to the bottom of the stack and no layer supported the requested object, then the method returns null.</para>
@@ -237,6 +242,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a typed object requested, if present, from the appropriate layer in the channel stack.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The typed object T requested if it is present or null if it is not.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The typed object for which the method is querying.</typeparam>
       </Docs>
@@ -257,12 +266,15 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented in a derived class, provides a point of extensibility when starting to wait for a channel to arrive.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous on begin wait operation. </para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies how long the on begin wait operation has to complete before timing out.</param>
         <param name="callback">
@@ -285,12 +297,15 @@
         <Parameter Name="result" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented in a derived class, provides a point of extensibility when ending the waiting for a channel to arrive.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the method completed before the interval of time specified by the <paramref name="timeout" /> expired; otherwise false.</para>
+        </returns>
         <param name="result">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IAsyncResult" /> returned by a call to the <see cref="M:System.ServiceModel.Channels.ChannelListenerBase.OnBeginWaitForChannel(System.TimeSpan,System.AsyncCallback,System.Object)" /> method.</param>
       </Docs>
@@ -309,12 +324,15 @@
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, provides a point of extensibility when waiting for a channel to arrive.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the method completed before the interval of time specified by the <paramref name="timeout" /> expired; otherwise false.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies how long the on wait for a channel operation has to complete before timing out.</param>
       </Docs>
@@ -416,12 +434,15 @@
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented in a derived class, waits for a channel to arrive.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a channel arrived before the interval of time specified by the <paramref name="timeout" /> expired; otherwise false.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies how long the wait for a channel operation has to complete before timing out.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ChannelListenerBase`1.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ChannelListenerBase`1.xml
index 1825c05d7a7..1e34bf9777b 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ChannelListenerBase`1.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ChannelListenerBase`1.xml
@@ -88,12 +88,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Accepts a channel of the type specified by the current channel listener.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.IChannel" /> accepted by the listener.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="AcceptChannel">
@@ -110,12 +113,15 @@
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Accepts a channel of the type specified by the current channel listener within a specified interval of time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.IChannel" /> accepted by the listener.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies how long the accept channel operation has to complete before timing out.</param>
       </Docs>
@@ -136,12 +142,15 @@
       </Parameters>
       <Docs>
         <param name="asyncState">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to accept a channel of the type specified by the current channel listener.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous accept channel operation. </para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies how long the accept channel operation has to complete before timing out.</param>
       </Docs>
@@ -163,12 +172,15 @@
       </Parameters>
       <Docs>
         <param name="asyncState">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented in a derived class, begins an asynchronous operation to accept a channel of the type specified by the current channel listener within a specified interval of time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous accept channel operation. </para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies how long the accept channel operation has to complete before timing out.</param>
         <param name="callback">
@@ -189,12 +201,15 @@
         <Parameter Name="result" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented in a derived class, completes an asynchronous operation to accept a channel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.IChannel" /> accepted by the listener.</para>
+        </returns>
         <param name="result">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IAsyncResult" /> returned by a call to the <see cref="Overload:System.ServiceModel.Channels.ChannelListenerBase`1.BeginAcceptChannel" /> method.</param>
       </Docs>
@@ -213,12 +228,15 @@
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented in a derived class, provides an extensibility point when accepting a channel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.IChannel" /> accepted.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies how long the accept channel operation has to complete before timing out.</param>
       </Docs>
@@ -240,12 +258,15 @@
       </Parameters>
       <Docs>
         <param name="asyncState">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented in a derived class, provides an asynchronous extensibility point when beginning to accept a channel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous accept channel operation. </para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies how long the accept channel operation has to complete before timing out.</param>
         <param name="callback">
@@ -266,12 +287,15 @@
         <Parameter Name="result" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented in a derived class, provides an asynchronous extensibility point when completing the acceptance a channel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.IChannel" /> accepted by the listener.</para>
+        </returns>
         <param name="result">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IAsyncResult" /> returned by a call to the <see cref="M:System.ServiceModel.Channels.ChannelListenerBase`1.OnBeginAcceptChannel(System.TimeSpan,System.AsyncCallback,System.Object)" /> method.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/CommunicationObject.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/CommunicationObject.xml
index cd2ced04270..7fd5b15012d 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/CommunicationObject.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/CommunicationObject.xml
@@ -100,7 +100,6 @@
       <Docs>
         <param name="callback">To be added.</param>
         <param name="state">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method causes the <see cref="T:System.ServiceModel.Channels.CommunicationObject" /> to gracefully transition from any state, other than the <see cref="F:System.ServiceModel.CommunicationState.Closed" /> state, into the <see cref="F:System.ServiceModel.CommunicationState.Closed" /> state within a default interval of time. The <see cref="Overload:System.ServiceModel.Channels.CommunicationObject.BeginClose" /> method allows any unfinished work to be completed before returning. For example, finish sending any buffered messages). This method calls <see cref="M:System.ServiceModel.Channels.CommunicationObject.OnBeginOpen(System.TimeSpan,System.AsyncCallback,System.Object)" /> if the communication object was initially in the <see cref="F:System.ServiceModel.CommunicationState.Opened" /> state.</para>
@@ -109,6 +108,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to close a communication object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous close operation. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="BeginClose">
@@ -130,7 +133,6 @@
         <param name="timeout">To be added.</param>
         <param name="callback">To be added.</param>
         <param name="state">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method causes the <see cref="T:System.ServiceModel.Channels.CommunicationObject" /> to gracefully transition from any state, other than the <see cref="F:System.ServiceModel.CommunicationState.Closed" /> state, into the <see cref="F:System.ServiceModel.CommunicationState.Closed" /> state with in a specified interval of time.  The <see cref="Overload:System.ServiceModel.Channels.CommunicationObject.BeginClose" /> method allows any unfinished work to be completed before returning. For example, finish sending any buffered messages). This method calls <see cref="M:System.ServiceModel.Channels.CommunicationObject.OnBeginClose(System.TimeSpan,System.AsyncCallback,System.Object)" /> if the communication object was initially in the <see cref="F:System.ServiceModel.CommunicationState.Opened" /> state.</para>
@@ -139,6 +141,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to close a communication object with a specified timeout.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous close operation.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="BeginOpen">
@@ -158,7 +164,6 @@
       <Docs>
         <param name="callback">To be added.</param>
         <param name="state">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ServiceModel.Channels.CommunicationObject.OnBeginOpen(System.TimeSpan,System.AsyncCallback,System.Object)" /> method calls <see cref="M:System.ServiceModel.Channels.CommunicationObject.OnOpening" /> and <see cref="M:System.ServiceModel.Channels.CommunicationObject.OnBeginOpen(System.TimeSpan,System.AsyncCallback,System.Object)" /> if the communication object is initially in the <see cref="F:System.ServiceModel.CommunicationState.Created" /> state.</para>
@@ -168,6 +173,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to open a communication object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous open operation. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="BeginOpen">
@@ -189,7 +198,6 @@
         <param name="timeout">To be added.</param>
         <param name="callback">To be added.</param>
         <param name="state">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ServiceModel.Channels.CommunicationObject.BeginOpen(System.TimeSpan,System.AsyncCallback,System.Object)" /> method calls <see cref="M:System.ServiceModel.Channels.CommunicationObject.OnOpening" /> and <see cref="M:System.ServiceModel.Channels.CommunicationObject.OnBeginOpen(System.TimeSpan,System.AsyncCallback,System.Object)" /> if the communication object is initially in the <see cref="F:System.ServiceModel.CommunicationState.Created" /> state.</para>
@@ -199,6 +207,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to open a communication object within a specified interval of time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous open operation. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Close">
@@ -437,12 +449,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the type of communication object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type of communication object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsDisposed">
@@ -508,7 +523,6 @@
         <param name="timeout">To be added.</param>
         <param name="callback">To be added.</param>
         <param name="state">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.ServiceModel.Channels.CommunicationObject.BeginClose" /> method calls <see cref="M:System.ServiceModel.Channels.CommunicationObject.OnBeginClose(System.TimeSpan,System.AsyncCallback,System.Object)" /> if the communication object is initially in the <see cref="F:System.ServiceModel.CommunicationState.Opened" /> state.</para>
@@ -518,6 +532,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts processing after a communication object transitions to the closing state due to the invocation of an asynchronous close operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous on close operation. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="OnBeginOpen">
@@ -539,7 +557,6 @@
         <param name="timeout">To be added.</param>
         <param name="callback">To be added.</param>
         <param name="state">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To insert processing after a communication object transitions to a opening state due to the invocation of a synchronous <see cref="Overload:System.ServiceModel.Channels.CommunicationObject.Open" /> operation, use the <see cref="Overload:System.ServiceModel.Channels.CommunicationObject.Open" /> method.</para>
@@ -548,6 +565,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts processing on a communication object after it transitions to the opening state due to the invocation of an asynchronous open operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous on open operation. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="OnClose">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/CompositeDuplexBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/CompositeDuplexBindingElement.xml
index 10fbb85c76b..515887ebaf6 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/CompositeDuplexBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/CompositeDuplexBindingElement.xml
@@ -55,7 +55,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The build context requires an <see cref="T:System.ServiceModel.Channels.IOutputChannel" /> for the <paramref name="TChannel" />.</para>
@@ -64,6 +63,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a channel factory that can create a composite duplex channel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.IChannelFactory`1" /> that creates a composite duplex channel of type <paramref name="TChannel" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> that provides the context required to build the channel factory.</param>
         <typeparam name="TChannel">
@@ -92,7 +95,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The build context requires an <see cref="T:System.ServiceModel.Channels.IInputChannel" /> for the <paramref name="TChannel" />.</para>
@@ -101,6 +103,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a channel listener that can accept a composite duplex channel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Channels.IChannelListener`1" /> that accepts a composite duplex channel of type <paramref name="TChannel" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> that provides the context required to build the channel listener.</param>
         <typeparam name="TChannel">
@@ -142,7 +148,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returning a clone enables the runtime to support the case in which multiple custom bindings share a custom binding element. If a clone is not returned, the run-time behavior is undefined.</para>
@@ -152,6 +157,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a deep clone of the current binding element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.CompositeDuplexBindingElement" /> that is a deep clone of the current binding element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetProperty&lt;T&gt;">
@@ -175,7 +184,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this to request a typed object, such as an interface for setting properties or getting status, from the appropriate layer in the stacked binding. If a layer supports returning the requested object, it returns it. If not, it delegates the call down to the next layer in the stack. If it gets to the bottom of the stack and no layer supports getting the requested object then the caller is returned a null value.</para>
@@ -184,6 +192,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a typed object requested from the appropriate layer in one of the channel stacks.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The typed object <paramref name="T" /> requested if it is supported; or null if it is not.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> that provides the context required to build the channel.</param>
         <typeparam name="T">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ConnectionOrientedTransportBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ConnectionOrientedTransportBindingElement.xml
index 85fb0d15f36..2c5d875f9b9 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ConnectionOrientedTransportBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ConnectionOrientedTransportBindingElement.xml
@@ -45,7 +45,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You should call this method before trying to create a channel factory.</para>
@@ -55,6 +54,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a channel factory of the specified type can be built.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a channel factory can be built; otherwise false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> for the channel.</param>
         <typeparam name="TChannel">
@@ -83,7 +86,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You should call this method before trying to create a channel listener.</para>
@@ -93,6 +95,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a channel listener of the specified type can be built.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a channel listener can be built; otherwise false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> for the channel.</param>
         <typeparam name="TChannel">
@@ -164,7 +170,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method receives a binding context as an input parameter, which represents the stack of binding elements.</para>
@@ -175,6 +180,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets properties from the binding stack, if present.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <paramref name="T" /> object from the binding stack, if present.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The binding context.</param>
         <typeparam name="T">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/CustomBinding.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/CustomBinding.xml
index 57b5ed52edc..d4ce86ca744 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/CustomBinding.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/CustomBinding.xml
@@ -389,12 +389,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a generic collection of the binding elements from the custom binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.ICollection`1" /> object of type <see cref="T:System.ServiceModel.Channels.BindingElement" /> that contains the binding elements from the custom binding.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Elements">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/FaultConverter.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/FaultConverter.xml
index 95f544d9d39..f1be97b1cc7 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/FaultConverter.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/FaultConverter.xml
@@ -48,7 +48,6 @@
         <Parameter Name="version" Type="System.ServiceModel.Channels.MessageVersion" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Transport channels should delegate to this method to get the default SOAP WS-Addressing fault converter.</para>
@@ -57,6 +56,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the default fault converter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.ServiceModel.Channels.FaultConverter" />.</para>
+        </returns>
         <param name="version">
           <attribution license="cc4" from="Microsoft" modified="false" />The message version.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/HttpCookieContainerBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/HttpCookieContainerBindingElement.xml
index c7fb71dd156..f13fdf79ca4 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/HttpCookieContainerBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/HttpCookieContainerBindingElement.xml
@@ -76,12 +76,15 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel factory that can be used to create a channel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A channel factory of the specified type.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.Channels.BindingContext" /> members that describe bindings, behaviors, contracts and other information required to create the channel factory.</param>
@@ -101,12 +104,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a copy of the current binding element object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The binding element object that is a deep clone of the original.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetProperty&lt;T&gt;">
@@ -130,12 +136,15 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a typed object requested, if present, from the appropriate layer in the binding stack.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The typed object <paramref name="T" /> requested if it is present, or Nothing if it is not present.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The binding context for the binding element.</param>
         <typeparam name="T">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/HttpRequestMessageProperty.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/HttpRequestMessageProperty.xml
index 1772e9215ff..ce57d80f68a 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/HttpRequestMessageProperty.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/HttpRequestMessageProperty.xml
@@ -207,12 +207,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a copy of the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.IMessageProperty" /> object that represents a copy of the current object.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/HttpResponseMessageProperty.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/HttpResponseMessageProperty.xml
index eb58d4ffb31..fcea76a445e 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/HttpResponseMessageProperty.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/HttpResponseMessageProperty.xml
@@ -187,12 +187,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new copy of the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A newly created copy of type <see cref="T:System.ServiceModel.Channels.IMessageProperty" /> of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/HttpTransportBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/HttpTransportBindingElement.xml
index 728c78fc0f4..2bb817f2029 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/HttpTransportBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/HttpTransportBindingElement.xml
@@ -140,7 +140,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to get a channel factory for sending messages based on the configuration of the transport binding element.</para>
@@ -149,6 +148,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel factory that can be used to create a channel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A channel factory of the specified type.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.Channels.BindingContext" /> members that describe bindings, behaviors, contracts and other information required to create the channel factory.</param>
@@ -178,7 +181,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to get a channel listener for receiving messages based on the configuration of the transport binding element.</para>
@@ -187,6 +189,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel listener of the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A channel listener of the specified type.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.Channels.BindingContext" /> members that describe bindings, behaviors, contracts and other information required to create the channel factory.</param>
@@ -239,12 +245,15 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a channel factory of the specified type can be built.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a channel factory can be built; otherwise false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> for the channel.</param>
         <typeparam name="TChannel">
@@ -273,12 +282,15 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a channel listener of the specified type can be built.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a channel listener can be built; otherwise false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> for the channel.</param>
         <typeparam name="TChannel">
@@ -297,12 +309,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance that is a copy of the current binding element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance that is a copy of the current binding element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DecompressionEnabled">
@@ -369,12 +384,15 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a property from the specified <see cref="T:System.ServiceModel.Channels.BindingContext" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The property from the specified <see cref="T:System.ServiceModel.Channels.BindingContext" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ServiceModel.Channels.BindingContext" />.</param>
         <typeparam name="T">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/HttpsTransportBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/HttpsTransportBindingElement.xml
index 73009e68ac6..bf41df095d8 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/HttpsTransportBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/HttpsTransportBindingElement.xml
@@ -84,7 +84,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a channel factory that is configured based on the values set in the transport binding element.</para>
@@ -93,6 +92,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel factory of a specified type that can be used to create a channel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A channel factory of the specified type that is configured based on the values set in the transport binding element.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.Channels.BindingContext" /> members that describe bindings, behaviors, contracts and other information required to create the channel factory.</param>
@@ -122,7 +125,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A channel listener that is configured based on the values set in the transport binding element.</para>
@@ -131,6 +133,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel listener of a specified type that can be used to create a channel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A channel listener of the specified type.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.Channels.BindingContext" /> members that describe bindings, behaviors, contracts and other information required to create the channel factory.</param>
@@ -150,12 +156,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the current binding element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current binding element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetProperty&lt;T&gt;">
@@ -179,7 +188,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method gets the specified object from the base class, or from one of that class's ancestors. The object returned is usually a collection of properties, for example an object that implements <see cref="T:System.ServiceModel.Channels.ISecurityCapabilities" />.</para>
@@ -188,6 +196,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a specified object from the <see cref="T:System.ServiceModel.Channels.BindingContext" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified object from the <see cref="T:System.ServiceModel.Channels.BindingContext" />, or null if the object isn't found.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ServiceModel.Channels.BindingContext" />.</param>
         <typeparam name="T">
@@ -206,7 +218,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is used to generate WSDL for the associated service.</para>
@@ -215,6 +226,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Xml.XmlElement" /> that represents the transport token used in the security binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlElement" /> that represents the transport token used in the security binding.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="RequireClientCertificate">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IChannel.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IChannel.xml
index eb1fa341722..ada0968af62 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IChannel.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IChannel.xml
@@ -67,7 +67,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this to request a typed object such as an interface for setting properties or getting status from the appropriate layer in the channel stack. If a layer supports returning the requested object, it returns it. If not, it delegates the call down to the next layer in the stack. If it gets to the bottom of the stack and no channel layer supported the requested object, then the method returns null.</para>
@@ -76,6 +75,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a typed object requested, if present, from the appropriate layer in the channel stack.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The typed object <paramref name="T" /> requested if it is present or null if it is not.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The typed object for which the method is querying.</typeparam>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IChannelFactory.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IChannelFactory.xml
index 2687ea42cf8..fb3ed661363 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IChannelFactory.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IChannelFactory.xml
@@ -42,7 +42,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this to request a typed object such as an interface for setting properties or getting status from the appropriate layer in the channel stack. If a layer supports returning the requested object, it returns it. If not, it delegates the call down to the next layer in the stack. If it gets to the bottom of the stack and no channel layer supported the requested object, then the method returns null.</para>
@@ -52,6 +51,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a typed object requested, if present, from the appropriate layer in the channel stack.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The typed object <paramref name="T" /> requested, if it is present, or null if it is not.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The typed object for which the method is querying.</typeparam>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IChannelFactory`1.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IChannelFactory`1.xml
index 39cdab92024..02f24c8d2c0 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IChannelFactory`1.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IChannelFactory`1.xml
@@ -40,7 +40,6 @@
         <Parameter Name="to" Type="System.ServiceModel.EndpointAddress" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.ServiceModel.Channels.IChannelFactory`1.CreateChannel(System.ServiceModel.EndpointAddress,System.Uri)" /> overload to distinguish the address to which the message is initially sent from the ultimate destination when you want to do manual routing. Note that any channels created by this channel factory are closed when the channel factory is closed.</para>
@@ -49,6 +48,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel of a specified type to a specified endpoint address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A channel of type <paramref name="TChannel" /> to the specified endpoint address.</para>
+        </returns>
         <param name="to">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.EndpointAddress" /> that provides the location of the service.</param>
       </Docs>
@@ -68,7 +71,6 @@
         <Parameter Name="via" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The transport address specified by the <paramref name="via" /> is the location to which a message should initially be sent on its way to some other remote address specified by the <paramref name="to" /> at which the service is located. In most Internet scenarios, the <paramref name="via" /> URI is the same as the <see cref="P:System.ServiceModel.EndpointAddress.Uri" /> of the final <paramref name="to" /> address of the service. You only distinguish between these two addresses when you want to do some kind of manual routing. Note that any channels created by this channel factory are closed when the channel factory is closed. For a discussion of addressing, see the <format type="text/html"><a href="13f269e3-ebb1-433c-86cf-54fbd866a627">Addresses</a></format> topic.</para>
@@ -77,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel of a specified type to a specified endpoint address and transport address to which messages are sent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A channel of type <paramref name="TChannel" /> to the specified endpoint address and transport address.</para>
+        </returns>
         <param name="to">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.EndpointAddress" /> that provides the location of the service.</param>
         <param name="via">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IChannelListener.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IChannelListener.xml
index 9a8490c2c6c..6be1cb490d0 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IChannelListener.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IChannelListener.xml
@@ -39,12 +39,15 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to wait for a channel to arrive that must be completed within a specified interval of time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous wait for a channel operation. </para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies how long the wait for a channel operation has to complete before timing out.</param>
         <param name="callback">
@@ -67,12 +70,15 @@
         <Parameter Name="result" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Completes an asynchronous operation to wait for channels to arrive.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a message arrived; otherwise false.</para>
+        </returns>
         <param name="result">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IAsyncResult" /> returned by a call to the <see cref="M:System.ServiceModel.Channels.IChannelListener.EndWaitForChannel(System.IAsyncResult)" /> method.</param>
       </Docs>
@@ -96,7 +102,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to request a typed object such as an interface for setting properties or getting status from the appropriate layer in the channel stack. If a layer supports returning the requested object, it returns it. If not, it delegates the call down to the next layer in the stack. If it gets to the bottom of the stack and no channel layer supported the requested object, then the method returns null.</para>
@@ -105,6 +110,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a typed object requested, if present, from the appropriate layer in the channel stack.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The typed object <paramref name="T" /> requested, if it is present or null if it is not.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The typed object for which the method is querying.</typeparam>
       </Docs>
@@ -145,12 +154,15 @@
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits for a channel to arrive.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a channel arrived before the interval of time specified by the <paramref name="timeout" />; otherwise false.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies how long the wait for a channel operation has to complete before timing out.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IChannelListener`1.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IChannelListener`1.xml
index d6fb11cd758..9bfd2197070 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IChannelListener`1.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IChannelListener`1.xml
@@ -44,7 +44,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>It is recommended that the <see cref="M:System.ServiceModel.Channels.IChannelListener`1.AcceptChannel(System.TimeSpan)" /> overload with the explicit timeout be used. The <paramref name="timeout" /> specified for that method overrides any default timeouts set by the system for the service.</para>
@@ -53,6 +52,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Accepts a channel of a specified type for communication with a client.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A channel of type <paramref name="TChannel" /> accepted by the listener.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="AcceptChannel">
@@ -69,7 +72,6 @@
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>It is recommended that this overload with an explicit timeout be used rather than the <see cref="M:System.ServiceModel.Channels.IChannelListener`1.AcceptChannel" />. The <paramref name="timeout" /> specified for this method overrides any default timeouts set by the system for the service.</para>
@@ -78,6 +80,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Accepts a channel of a specified type for communication with a client within a specified interval of time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A channel of type <paramref name="TChannel" /> accepted by the listener.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies how long the wait for a channel operation has to complete before timing out.</param>
       </Docs>
@@ -97,7 +103,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>It is recommended that the <see cref="M:System.ServiceModel.Channels.IChannelListener`1.BeginAcceptChannel(System.TimeSpan,System.AsyncCallback,System.Object)" /> overload with the explicit timeout be used. The <paramref name="timeout" /> specified for that method overrides any default timeouts set by the system for the service.</para>
@@ -106,6 +111,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to accept a channel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous acceptance of a channel operation. </para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.AsyncCallback" /> delegate that receives the notification of the asynchronous completion of the accept for a channel operation.</param>
         <param name="state">
@@ -128,7 +137,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>It is recommended that this overload with an explicit timeout be used rather than the <see cref="M:System.ServiceModel.Channels.IChannelListener`1.BeginAcceptChannel(System.TimeSpan,System.AsyncCallback,System.Object)" />. The <paramref name="timeout" /> specified for this method overrides any default timeouts set by the system for the service.</para>
@@ -137,6 +145,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to accept a channel within a specified interval of time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous acceptance of a channel operation. </para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies how long the wait for a channel operation has to complete before timing out.</param>
         <param name="callback">
@@ -159,12 +171,15 @@
         <Parameter Name="result" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Completes an asynchronous operation to accept a channel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A channel of type <paramref name="TChannel" /> accepted by the listener.</para>
+        </returns>
         <param name="result">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IAsyncResult" /> returned by a call to the <see cref="Overload:System.ServiceModel.Channels.IChannelListener`1.BeginAcceptChannel" /> method.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IDuplexSession.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IDuplexSession.xml
index 3e0f3cd06c2..ac4a43061f2 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IDuplexSession.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IDuplexSession.xml
@@ -41,7 +41,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Terminating the outbound session does not affect the incoming session and so makes no statement about the ability to receive messages on the session associated with the input channel. This operation must complete within a default interval of time. </para>
@@ -50,6 +49,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to terminate the outbound session.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous outbound session termination. </para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.AsyncCallback" /> delegate. </param>
         <param name="state">
@@ -72,7 +75,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Terminating the outbound session does not affect the incoming session and so makes no statement about the ability to receive messages on the session associated with the input channel.</para>
@@ -81,6 +83,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to terminate the outbound session with a specified timeout within which the operation must complete.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous outbound session termination. </para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.TimeSpan" /> that specifies the interval of time within which the operation must complete.</param>
         <param name="callback">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IInputChannel.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IInputChannel.xml
index 75fc001974a..b57e442587d 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IInputChannel.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IInputChannel.xml
@@ -39,7 +39,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the asynchronous <see cref="M:System.ServiceModel.Channels.IInputChannel.BeginReceive" /> method when you want the application processing to continue without waiting for the request to be received. Use the synchronous <see cref="M:System.ServiceModel.Channels.IInputChannel.Receive" /> method when it is acceptable for the current thread to be blocked until the request message is received or the interval of time specified by the <paramref name="timeout" /> has been exceeded. The asynchronous operation is available with or without an explicit timeout. </para>
@@ -49,6 +48,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to receive a message that has a state object associated with it. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous message reception. </para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.AsyncCallback" /> delegate that receives the notification of the asynchronous operation completion.</param>
         <param name="state">
@@ -71,7 +74,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the asynchronous <see cref="M:System.ServiceModel.Channels.IInputChannel.BeginReceive" /> method when you want the application processing to continue without waiting for the request to be received. Use the synchronous <see cref="M:System.ServiceModel.Channels.IInputChannel.Receive" /> method when it is acceptable for the current thread to be blocked until the request message is received or the interval of time specified by the <paramref name="timeout" /> has been exceeded. The asynchronous operation is available with or without an explicit timeout. </para>
@@ -81,6 +83,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to receive a message that has a specified time out and state object associated with it. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous receive operation.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies the interval of time to wait for a message to become available.</param>
         <param name="callback">
@@ -105,7 +111,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the asynchronous <see cref="M:System.ServiceModel.Channels.IInputChannel.BeginTryReceive(System.TimeSpan,System.AsyncCallback,System.Object)" /> method when you want the application processing to continue without waiting. Use the synchronous <see cref="M:System.ServiceModel.Channels.IInputChannel.TryReceive(System.TimeSpan,System.ServiceModel.Channels.Message@)" /> method when it is acceptable for the current thread to be blocked while it replies to the request message or until the timeout interval is exceeded.</para>
@@ -117,6 +122,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to receive a message that has a specified time out and state object associated with it. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous receive operation.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies the interval of time to wait for a message to become available.</param>
         <param name="callback">
@@ -141,7 +150,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the asynchronous <see cref="M:System.ServiceModel.Channels.IInputChannel.BeginWaitForMessage(System.TimeSpan,System.AsyncCallback,System.Object)" /> method if you need the application processing to continue without waiting for the message to arrive. Use the synchronous <see cref="M:System.ServiceModel.Channels.IInputChannel.WaitForMessage(System.TimeSpan)" /> method when it is acceptable for the current thread to be blocked while it waits for a message to arrive in the queue. The thread is blocked up to the specified <paramref name="timeout" />.</para>
@@ -151,6 +159,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous wait-for-a-message-to-arrive operation that has a specified time out and state object associated with it. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous operation to wait for a message to arrive.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies the interval of time to wait for a message to become available.</param>
         <param name="callback">
@@ -173,12 +185,15 @@
         <Parameter Name="result" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Completes an asynchronous operation to receive a message. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.Message" /> received. </para>
+        </returns>
         <param name="result">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IAsyncResult" /> returned by a call to one of the <see cref="Overload:System.ServiceModel.Channels.IInputChannel.BeginReceive" /> methods.</param>
       </Docs>
@@ -219,12 +234,15 @@
         <Parameter Name="result" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Completes the specified asynchronous wait-for-a-message operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a message has arrived before the <paramref name="timeout" /> has been exceeded; otherwise false.</para>
+        </returns>
         <param name="result">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IAsyncResult" /> that identifies the <see cref="M:System.ServiceModel.Channels.IInputChannel.BeginWaitForMessage(System.TimeSpan,System.AsyncCallback,System.Object)" /> operation to finish, and from which to retrieve an end result.</param>
       </Docs>
@@ -264,7 +282,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the synchronous <see cref="M:System.ServiceModel.Channels.IInputChannel.Receive" /> method when it is acceptable for the current thread to be blocked until it receives the request message or exceeds the interval of time specified by <paramref name="timeout" />. Use the asynchronous <see cref="Overload:System.ServiceModel.Channels.IInputChannel.BeginReceive" /> method when you want the application processing to continue without waiting for the request to be received. </para>
@@ -277,6 +294,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the message received, if one is available. If a message is not available, blocks for a default interval of time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.Message" /> received. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Receive">
@@ -293,7 +314,6 @@
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the synchronous <see cref="M:System.ServiceModel.Channels.IInputChannel.Receive" /> method when it is acceptable for the current thread to be blocked until it receives the request message or exceeds the interval of time specified by <paramref name="timeout" />. Use the asynchronous <see cref="Overload:System.ServiceModel.Channels.IInputChannel.BeginReceive" /> method when you want the application processing to continue without waiting for the request to be received. </para>
@@ -306,6 +326,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the message received, if one is available. If a message is not available, blocks for a specified interval of time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.Message" /> received. </para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies how long the receive operation has to complete before timing out and throwing a <see cref="T:System.TimeoutException" />.</param>
       </Docs>
@@ -346,7 +370,6 @@
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling <see cref="M:System.ServiceModel.Channels.IInputChannel.WaitForMessage(System.TimeSpan)" /> does not result in a message being received or processed in any other way.</para>
@@ -358,6 +381,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a message has arrived within a specified interval of time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a message has arrived before the <paramref name="timeout" /> has been exceeded; otherwise false.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> specifies the maximum interval of time to wait for a message to arrive before timing out.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IMessageProperty.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IMessageProperty.xml
index eee0f8550f7..90ce8a79937 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IMessageProperty.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IMessageProperty.xml
@@ -31,7 +31,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called whenever an implementor of this interface is created. This happens when an object that implements this interface is added to <see cref="P:System.ServiceModel.Channels.Message.Properties" /> as a custom property.</para>
@@ -40,6 +39,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.IMessageProperty" /> object that is a copy of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IOutputChannel.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IOutputChannel.xml
index a5f8170e8fd..275b19a3ac3 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IOutputChannel.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IOutputChannel.xml
@@ -38,7 +38,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The destination for messages sent out on an output channel is specified at channel creation time. </para>
@@ -49,6 +48,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to transmit a message to the destination of the output channel. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous message transmission. </para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.Message" /> being sent on the output channel. </param>
         <param name="callback">
@@ -74,7 +77,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The destination for messages sent out on an output channel is specified at channel creation time. </para>
@@ -85,6 +87,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to transmit a message to the destination of the output channel within a specified interval of time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous send operation.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.Message" /> being sent on the output channel.</param>
         <param name="timeout">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IReplyChannel.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IReplyChannel.xml
index 2bfce6091ee..9440c1cdd02 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IReplyChannel.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IReplyChannel.xml
@@ -40,7 +40,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ServiceModel.Channels.IReplyChannel.BeginReceiveRequest(System.AsyncCallback,System.Object)" /> method implements the standard pattern for invoking <see cref="M:System.ServiceModel.Channels.IReplyChannel.ReceiveRequest" /> asynchronously. The default timeout is 1 minute. If a receive timeout is set on the binding used to configure the connection, then that value is used. Use <see cref="M:System.ServiceModel.Channels.IReplyChannel.BeginReceiveRequest(System.TimeSpan,System.AsyncCallback,System.Object)" /> if you want to specify an explicit timeout with the call that overrides these other values.</para>
@@ -50,6 +49,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to receive an available request with a default timeout.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous reception of the request. </para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.AsyncCallback" /> delegate that receives the notification of the asynchronous receive that a request operation completes.</param>
         <param name="state">
@@ -72,7 +75,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ServiceModel.Channels.IReplyChannel.BeginReceiveRequest(System.TimeSpan,System.AsyncCallback,System.Object)" /> method implements the standard pattern for invoking <see cref="M:System.ServiceModel.Channels.IReplyChannel.ReceiveRequest(System.TimeSpan)" />asynchronously. The timeout set on this method overrides a receive timeout set on the binding that is used to configure the connection.</para>
@@ -82,6 +84,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to receive an available request with a specified timeout.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous reception of the request. </para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies the interval of time to wait for the reception of an available request.</param>
         <param name="callback">
@@ -106,7 +112,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the asynchronous <see cref="M:System.ServiceModel.Channels.IReplyChannel.BeginTryReceiveRequest(System.TimeSpan,System.AsyncCallback,System.Object)" /> method when you need the application processing to continue without waiting. Use one of the synchronous <see cref="M:System.ServiceModel.Channels.IReplyChannel.TryReceiveRequest(System.TimeSpan,System.ServiceModel.Channels.RequestContext@)" /> methods when it is acceptable for the current thread to be blocked while it replies to the request message or until the timeout interval is exceeded.</para>
@@ -116,6 +121,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to receive a request message that has a specified time out and state object associated with it. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous receive request operation.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies how long the receive request operation has to complete before timing out and returning false.</param>
         <param name="callback">
@@ -140,7 +149,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the synchronous <see cref="M:System.ServiceModel.Channels.IReplyChannel.WaitForRequest(System.TimeSpan)" /> method when it is acceptable for the current thread to be blocked while it waits for a request message to arrive in the queue. The thread is blocked up to the specified <paramref name="timeout" />.</para>
@@ -150,6 +158,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous request operation that has a specified time out and state object associated with it. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous operation to wait for a request message to arrive.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies the interval of time to wait for the reception of an available request.</param>
         <param name="callback">
@@ -172,7 +184,6 @@
         <Parameter Name="result" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the request message received is larger that the maximum message size allowed by the binding being used, a <see cref="T:System.ServiceModel.QuotaExceededException" /> is thrown. The maximum message size is set by the <see cref="P:System.ServiceModel.Channels.TransportBindingElement.MaxReceivedMessageSize" /> property. The default value is 65536 bytes. </para>
@@ -181,6 +192,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Completes an asynchronous operation to receive an available request. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.RequestContext" /> used to construct a reply to the request. </para>
+        </returns>
         <param name="result">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IAsyncResult" /> returned by a call to the <see cref="M:System.ServiceModel.Channels.IInputChannel.BeginReceive" /> method.</param>
       </Docs>
@@ -221,12 +236,15 @@
         <Parameter Name="result" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Completes the specified asynchronous wait-for-a-request message operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a request is received before the specified interval of time elapses; otherwise false.</para>
+        </returns>
         <param name="result">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IAsyncResult" /> that identifies the <see cref="M:System.ServiceModel.Channels.IReplyChannel.BeginWaitForRequest(System.TimeSpan,System.AsyncCallback,System.Object)" /> operation to finish, and from which to retrieve an end result.</param>
       </Docs>
@@ -262,7 +280,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -275,6 +292,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the context of the request received, if one is available. If a context is not available, waits until there is one available. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.RequestContext" /> used to construct replies. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReceiveRequest">
@@ -291,7 +312,6 @@
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -304,6 +324,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the context of the request received, if one is available. If a context is not available, waits until there is one available. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.RequestContext" /> used to construct replies. </para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.TimeSpan" /> that specifies how long the receive of a request operation has to complete before timing out and returning false.</param>
       </Docs>
@@ -344,7 +368,6 @@
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling <see cref="M:System.ServiceModel.Channels.IReplyChannel.WaitForRequest(System.TimeSpan)" /> does not result in a request message being received or processed in any way.</para>
@@ -356,6 +379,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a request message is received before a specified interval of time elapses.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a request is received before the specified interval of time elapses; otherwise false.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies how long a request operation has to complete before timing out and returning false.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IRequestChannel.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IRequestChannel.xml
index de840f67467..6f2d2899c4a 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IRequestChannel.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/IRequestChannel.xml
@@ -38,7 +38,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the request message is larger that the maximum message size allowed by the binding being used, a <see cref="T:System.ServiceModel.QuotaExceededException" /> is thrown. The maximum message size is set by the <see cref="P:System.ServiceModel.Channels.TransportBindingElement.MaxReceivedMessageSize" /> property. The default value is 65536 bytes. </para>
@@ -47,6 +46,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to transmit a request message to the reply side of a request-reply message exchange. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous message transmission. </para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The request <see cref="T:System.ServiceModel.Channels.Message" /> to be transmitted.</param>
         <param name="callback">
@@ -72,7 +75,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the request message is larger that the maximum message size allowed by the binding being used, a <see cref="T:System.ServiceModel.QuotaExceededException" /> should be thrown. The maximum message size is set by the <see cref="P:System.ServiceModel.Channels.TransportBindingElement.MaxReceivedMessageSize" /> property. The default value is 65536 bytes. </para>
@@ -83,6 +85,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to transmit a request message to the reply side of a request-reply message exchange within a specified interval of time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous message transmission. </para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The request <see cref="T:System.ServiceModel.Channels.Message" /> to be transmitted.</param>
         <param name="timeout">
@@ -107,7 +113,6 @@
         <Parameter Name="result" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the request message is larger that the maximum message size allowed by the binding being used, a <see cref="T:System.ServiceModel.QuotaExceededException" /> is thrown. The maximum message size is set by the <see cref="P:System.ServiceModel.Channels.TransportBindingElement.MaxReceivedMessageSize" /> property. The default value is 65536 bytes. </para>
@@ -116,6 +121,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Completes an asynchronous operation to return a message-based response to a transmitted request. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.Message" /> received in response to the request. </para>
+        </returns>
         <param name="result">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IAsyncResult" /> returned by a call to the <see cref="Overload:System.ServiceModel.Channels.IInputChannel.BeginReceive" /> method. </param>
       </Docs>
@@ -156,7 +165,6 @@
         <Parameter Name="message" Type="System.ServiceModel.Channels.Message" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implementations of <see cref="T:System.ServiceModel.Channels.IRequestChannel" /> ensure that the response message is correlated with the request message. </para>
@@ -169,6 +177,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends a message-based request and returns the correlated message-based response. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.Message" /> received in response to the request. </para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The request <see cref="T:System.ServiceModel.Channels.Message" /> to be transmitted.</param>
       </Docs>
@@ -188,7 +200,6 @@
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implementations of <see cref="T:System.ServiceModel.Channels.IRequestChannel" /> ensure that the response message is correlated with the request message. </para>
@@ -203,6 +214,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends a message-based request and returns the correlated message-based response within a specified interval of time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.Message" /> received in response to the request. </para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The request <see cref="T:System.ServiceModel.Channels.Message" /> to be transmitted.</param>
         <param name="timeout">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ITransportTokenAssertionProvider.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ITransportTokenAssertionProvider.xml
index 107cbe57978..ad383d67515 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ITransportTokenAssertionProvider.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ITransportTokenAssertionProvider.xml
@@ -27,12 +27,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a transport token assertion.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlElement" /> that represents a transport token assertion.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/LocalClientSecuritySettings.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/LocalClientSecuritySettings.xml
index 06e2dae7460..86c01986a0f 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/LocalClientSecuritySettings.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/LocalClientSecuritySettings.xml
@@ -68,12 +68,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of this class, which is a copy or clone of the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.ServiceModel.Channels.LocalClientSecuritySettings" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CookieRenewalThresholdPercentage">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/LocalServiceSecuritySettings.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/LocalServiceSecuritySettings.xml
index 2f2f9414737..7a141d0a7cd 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/LocalServiceSecuritySettings.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/LocalServiceSecuritySettings.xml
@@ -49,12 +49,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of this class from the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.ServiceModel.Channels.LocalServiceSecuritySettings" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DetectReplays">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/Message.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/Message.xml
index 205057e8974..72580f373be 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/Message.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/Message.xml
@@ -101,7 +101,6 @@
         <Parameter Name="maxBufferSize" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The body of a <see cref="T:System.ServiceModel.Channels.Message" /> instance can only be accessed or written once. If you want to access a <see cref="T:System.ServiceModel.Channels.Message" /> instance more than once, you should use the <see cref="T:System.ServiceModel.Channels.MessageBuffer" /> class to completely store an entire <see cref="T:System.ServiceModel.Channels.Message" /> instance into memory. A <see cref="T:System.ServiceModel.Channels.MessageBuffer" /> instance is constructed by calling <see cref="M:System.ServiceModel.Channels.Message.CreateBufferedCopy(System.Int32)" /> of a <see cref="T:System.ServiceModel.Channels.Message" /> instance.</para>
@@ -113,6 +112,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Stores an entire <see cref="T:System.ServiceModel.Channels.Message" /> into a memory buffer for future access.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A newly created <see cref="T:System.ServiceModel.Channels.MessageBuffer" /> object.</para>
+        </returns>
         <param name="maxBufferSize">
           <attribution license="cc4" from="Microsoft" modified="false" />The maximum size of the buffer to be created.</param>
       </Docs>
@@ -132,7 +135,6 @@
         <Parameter Name="action" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This static method is used to create a new copy of message ready for sending.</para>
@@ -141,6 +143,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a message that contains a version and an action.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.Message" /> object for the message created. </para>
+        </returns>
         <param name="version">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ServiceModel.Channels.MessageVersion" /> object that specifies the SOAP version to use for the message.</param>
         <param name="action">
@@ -163,7 +169,6 @@
         <Parameter Name="action" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This static method is used to create a new copy of message ready for sending.</para>
@@ -172,6 +177,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a message that contains a SOAP fault, a version and an action.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.Message" /> object for the message created. </para>
+        </returns>
         <param name="version">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ServiceModel.Channels.MessageVersion" /> object that specifies the SOAP version to use for the message.</param>
         <param name="fault">
@@ -196,7 +205,6 @@
         <Parameter Name="body" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This static method is used to create a new copy of message ready for sending.</para>
@@ -206,6 +214,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a message with the specified version, action and body. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.Message" /> object for the message created. </para>
+        </returns>
         <param name="version">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ServiceModel.Channels.MessageVersion" /> object that specifies the SOAP version to use for the message. </param>
         <param name="action">
@@ -230,7 +242,6 @@
         <Parameter Name="body" Type="System.ServiceModel.Channels.BodyWriter" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An empty message is useful for an endpoint to send an alert to another endpoint without any actual content. </para>
@@ -239,6 +250,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a message with a body that consists of an array of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.Message" /> object for the message created. </para>
+        </returns>
         <param name="version">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ServiceModel.Channels.MessageVersion" /> object that specifies the SOAP version to use for the message. </param>
         <param name="action">
@@ -263,7 +278,6 @@
         <Parameter Name="body" Type="System.Xml.XmlDictionaryReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This static method is used to create a new copy of message ready for sending.</para>
@@ -272,6 +286,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a message with the specified version, action and body.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.Message" /> object for the message created. </para>
+        </returns>
         <param name="version">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ServiceModel.Channels.MessageVersion" /> object that specifies the SOAP version to use for the message. </param>
         <param name="action">
@@ -296,7 +314,6 @@
         <Parameter Name="body" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This static method is used to create a new copy of message ready for sending.</para>
@@ -305,6 +322,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a message using the specified reader, action and version.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.Message" /> object for the message created. </para>
+        </returns>
         <param name="version">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ServiceModel.Channels.MessageVersion" /> object that specifies the SOAP version to use for the message. </param>
         <param name="action">
@@ -329,7 +350,6 @@
         <Parameter Name="version" Type="System.ServiceModel.Channels.MessageVersion" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -343,6 +363,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a message using the specified reader, action and version.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.Message" /> object for the message created. </para>
+        </returns>
         <param name="envelopeReader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlDictionaryReader" /> object to be used for reading the SOAP message.</param>
         <param name="maxSizeOfHeaders">
@@ -367,7 +391,6 @@
         <Parameter Name="version" Type="System.ServiceModel.Channels.MessageVersion" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -381,6 +404,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a message using the specified reader, action and version.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.Message" /> object for the message created. </para>
+        </returns>
         <param name="envelopeReader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> object to be used for reading the SOAP message.</param>
         <param name="maxSizeOfHeaders">
@@ -407,7 +434,6 @@
       </Parameters>
       <Docs>
         <param name="code">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This static method is used to create a new copy of message ready for sending.</para>
@@ -416,6 +442,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a message that contains a SOAP fault, the reason for the fault, a version and an action.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.Message" /> object for the message created. </para>
+        </returns>
         <param name="version">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ServiceModel.Channels.MessageVersion" /> object that specifies the SOAP version to use for the message.</param>
         <param name="reason">
@@ -442,7 +472,6 @@
       </Parameters>
       <Docs>
         <param name="xmlFormatter">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This static method is used to create a new copy of message ready for sending. </para>
@@ -452,6 +481,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a message using the specified version, action, message body and serializer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.Message" /> object for the message created. </para>
+        </returns>
         <param name="version">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ServiceModel.Channels.MessageVersion" /> object that specifies the SOAP version to use for the message. </param>
         <param name="action">
@@ -479,7 +512,6 @@
       </Parameters>
       <Docs>
         <param name="code">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This static method is used to create a new copy of message ready for sending.</para>
@@ -488,6 +520,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a message that contains a SOAP fault, a reason and the detail for the fault, a version and an action.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.Message" /> object for the message created. </para>
+        </returns>
         <param name="version">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ServiceModel.Channels.MessageVersion" /> object that specifies the SOAP version to use for the message.</param>
         <param name="reason">
@@ -513,7 +549,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A <see cref="T:System.ServiceModel.Channels.Message" /> instance has a body that corresponds to the SOAP body. It can be accessed as an <see cref="T:System.Xml.XmlDictionaryReader" /> by calling <see cref="M:System.ServiceModel.Channels.Message.GetReaderAtBodyContents" />. It is initially positioned directly after the &lt;S:Body&gt; element, and it returns EOF on reaching the &lt;/S:Body&gt; element. Alternatively, if you expect the body to contain a serialized object, you can call <see cref="Overload:System.ServiceModel.Channels.Message.GetBody" /> instead. You should be aware that a message body can only be accessed once and a message can only be written once. If you want to access the Body multiple times, use <see cref="M:System.ServiceModel.Channels.Message.CreateBufferedCopy(System.Int32)" /> to create a <see cref="T:System.ServiceModel.Channels.MessageBuffer" /> instance. </para>
@@ -523,6 +558,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the body of this <see cref="T:System.ServiceModel.Channels.Message" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object of type <paramref name="T" /> that contains the body of this message.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The body of the message.</typeparam>
       </Docs>
@@ -545,7 +584,6 @@
       </Parameters>
       <Docs>
         <param name="xmlFormatter">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A <see cref="T:System.ServiceModel.Channels.Message" /> instance has a body that corresponds to the SOAP body. It can be accessed as an <see cref="T:System.Xml.XmlDictionaryReader" /> by calling <see cref="M:System.ServiceModel.Channels.Message.GetReaderAtBodyContents" />. It is initially positioned directly after the &lt;S:Body&gt; element, and it returns EOF on reaching the &lt;/S:Body&gt; element. Alternatively, if you expect the body to contain a serialized object, you can call <see cref="Overload:System.ServiceModel.Channels.Message.GetBody" /> instead. You should be aware that a message body can only be accessed once and a message can only be written once. If you want to access the body multiple times, use <see cref="M:System.ServiceModel.Channels.Message.CreateBufferedCopy(System.Int32)" /> to create a <see cref="T:System.ServiceModel.Channels.MessageBuffer" /> instance.  </para>
@@ -555,6 +593,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the body of this <see cref="T:System.ServiceModel.Channels.Message" /> using the specified serializer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object of type <paramref name="T" /> that contains the body of this message.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The body of the message.</typeparam>
       </Docs>
@@ -574,7 +616,6 @@
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A <see cref="T:System.ServiceModel.Channels.Message" /> instance has a body that corresponds to the SOAP body. It can be accessed as an <see cref="T:System.Xml.XmlDictionaryReader" /> by calling <see cref="M:System.ServiceModel.Channels.Message.GetReaderAtBodyContents" />. It is initially positioned directly after the &lt;S:Body&gt; element, and it returns EOF on reaching the &lt;/S:Body&gt; element. Alternatively, if you expect the body to contain a serialized object, you can call <see cref="Overload:System.ServiceModel.Channels.Message.GetBody" /> instead. You should be aware that a message body can only be accessed once and a message can only be written once. If you want to access the body multiple times, use <see cref="M:System.ServiceModel.Channels.Message.CreateBufferedCopy(System.Int32)" /> to create a <see cref="T:System.ServiceModel.Channels.MessageBuffer" /> instance.  </para>
@@ -583,6 +624,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the attributes of the message body.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The attributes of the message body.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the XML node.</param>
         <param name="ns">
@@ -601,7 +646,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A <see cref="T:System.ServiceModel.Channels.Message" /> instance has a body that corresponds to the SOAP body. It can be accessed as an <see cref="T:System.Xml.XmlDictionaryReader" /> by calling <see cref="M:System.ServiceModel.Channels.Message.GetReaderAtBodyContents" />. It is initially positioned directly after the &lt;S:Body&gt; element. Alternatively, if you expect the body to contain a serialized object, you can call <see cref="Overload:System.ServiceModel.Channels.Message.GetBody" /> instead. You should be aware that a message body can only be accessed once and a message can only be written once. If you want to access the body multiple times, use <see cref="M:System.ServiceModel.Channels.Message.CreateBufferedCopy(System.Int32)" /> to create a <see cref="T:System.ServiceModel.Channels.MessageBuffer" /> instance.  </para>
@@ -610,6 +654,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the XML dictionary reader that accesses the body content of this message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Xml.XmlDictionaryReader" /> object that accesses the body content of this message.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Headers">
@@ -824,12 +872,15 @@
         <Parameter Name="maxBufferSize" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called when a message buffer is created to store this message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.MessageBuffer" /> object for the newly created message copy.</para>
+        </returns>
         <param name="maxBufferSize">
           <attribution license="cc4" from="Microsoft" modified="false" />The maximum size of the buffer to be created.</param>
       </Docs>
@@ -851,12 +902,15 @@
         <Parameter Name="reader" Type="System.Xml.XmlDictionaryReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called when the body of the message is retrieved.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.MessageBuffer" /> that represents the body of the message.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.XmlDictionaryReader)" /> object used to read the body of the message.</param>
         <typeparam name="T">
@@ -878,12 +932,15 @@
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called when the attributes of the message body is retrieved.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The attributes of the message body.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the XML node.</param>
         <param name="ns">
@@ -902,12 +959,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called when an XML dictionary reader that accesses the body content of this message is retrieved.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Xml.XmlDictionaryReader" /> object that accesses the body content of this message.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="OnWriteBodyContents">
@@ -1106,12 +1166,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.ServiceModel.Channels.Message" /> instance. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the current <see cref="T:System.ServiceModel.Channels.Message" /> instance. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Version">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageBuffer.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageBuffer.xml
index c1ad4ee680b..abda9d0cb8c 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageBuffer.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageBuffer.xml
@@ -120,7 +120,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method creates an identical copy of the original <see cref="T:System.ServiceModel.Channels.Message" /> instance you previously provided to the <see cref="M:System.ServiceModel.Channels.Message.CreateBufferedCopy(System.Int32)" /> method of a <see cref="T:System.ServiceModel.Channels.Message" /> instance. You can then save the message to a durable storage.</para>
@@ -129,6 +128,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a copy of the original message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An identical copy of the original <see cref="T:System.ServiceModel.Channels.Message" /> instance you previously provided to the <see cref="M:System.ServiceModel.Channels.Message.CreateBufferedCopy(System.Int32)" /> method of a <see cref="T:System.ServiceModel.Channels.Message" /> instance. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateNavigator">
@@ -143,7 +146,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method if you want to manipulate just a portion of the message copy.</para>
@@ -152,6 +154,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.XPath.XPathNavigator" /> object for navigating this object. This method cannot be inherited.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XPath.XPathNavigator" /> object for navigating this object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateNavigator">
@@ -169,7 +175,6 @@
       </Parameters>
       <Docs>
         <param name="node_quota">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method if you want to manipulate just a portion of the message copy.</para>
@@ -178,6 +183,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.XPath.XPathNavigator" /> object for navigating this object, with the navigator positioned on the node specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XPath.XPathNavigator" /> object for navigating this object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateNavigator">
@@ -194,7 +203,6 @@
         <Parameter Name="space" Type="System.Xml.XmlSpace" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method if you want to manipulate just a portion of the message copy.</para>
@@ -203,6 +211,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.XPath.XPathNavigator" /> object for navigating this object, with the specified xml:space scope.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XPath.XPathNavigator" /> object for navigating this object.</para>
+        </returns>
         <param name="space">
           <attribution license="cc4" from="Microsoft" modified="false" />A valid <see cref="T:System.Xml.XmlSpace" /> space.</param>
       </Docs>
@@ -223,7 +235,6 @@
       </Parameters>
       <Docs>
         <param name="node_quota">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method if you want to manipulate just a portion of the message copy.</para>
@@ -232,6 +243,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.XPath.XPathNavigator" /> object for navigating this object, with the navigator positioned on the specified node and xml:space scope.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XPath.XPathNavigator" /> object for navigating this object.</para>
+        </returns>
         <param name="space">
           <attribution license="cc4" from="Microsoft" modified="false" />A valid <see cref="T:System.Xml.XmlSpace" /> space.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageEncoder.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageEncoder.xml
index 3b3f5c7bd0a..eed3ad672ff 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageEncoder.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageEncoder.xml
@@ -101,7 +101,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this to request a typed object such as an interface for setting properties or getting status from the appropriate layer in the channel stack. If a layer supports returning the requested object, it returns it. If not, it delegates the call down to the next layer in the stack. If it gets to the bottom of the stack and no channel layer supported the requested object, then the method returns null.</para>
@@ -110,6 +109,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a typed object requested, if present, from the appropriate layer in the channel stack.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The typed object <paramref name="T " />requested if it is present or null if it is not.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The typed object for which the method is querying.</typeparam>
       </Docs>
@@ -128,7 +131,6 @@
         <Parameter Name="contentType" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is used to determine whether the message encoder can be used to read a particular style of message, based on its content-type. The information in the <see cref="T:System.Net.Mime.ContentType" /> class is used to describe the data that is contained in a message and is used to determine if there is a content-type match.</para>
@@ -138,6 +140,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a specified message-level content-type value is supported by the message encoder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the message-level content-type specified is supported; otherwise false.</para>
+        </returns>
         <param name="contentType">
           <attribution license="cc4" from="Microsoft" modified="false" />The message-level content-type being tested.</param>
       </Docs>
@@ -201,12 +207,15 @@
         <Parameter Name="bufferManager" Type="System.ServiceModel.Channels.BufferManager" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, reads a message from a specified buffer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.Message" /> that is read from the buffer specified.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ArraySegment`1" /> of type <see cref="T:System.Byte" /> that provides the buffer from which the message is deserialized.</param>
         <param name="bufferManager">
@@ -228,12 +237,15 @@
         <Parameter Name="maxSizeOfHeaders" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, reads a message from a specified stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.Message" /> that is read from the stream specified.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.Stream" /> object from which the message is read.</param>
         <param name="maxSizeOfHeaders">
@@ -256,12 +268,15 @@
         <Parameter Name="contentType" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, reads a message from a specified stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.Message" /> that is read from the stream specified.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ArraySegment`1" /> of type <see cref="T:System.Byte" /> that provides the buffer from which the message is deserialized.</param>
         <param name="bufferManager">
@@ -286,12 +301,15 @@
         <Parameter Name="contentType" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, reads a message from a specified stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.Message" /> that is read from the stream specified.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.Stream" /> object from which the message is read.</param>
         <param name="maxSizeOfHeaders">
@@ -312,12 +330,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the content type that is used by the message encoder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The content type that is used by the message encoder.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="WriteMessage">
@@ -362,7 +383,6 @@
         <Parameter Name="bufferManager" Type="System.ServiceModel.Channels.BufferManager" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method calls the abstract method <see cref="M:System.ServiceModel.Channels.MessageEncoder.WriteMessage(System.ServiceModel.Channels.Message,System.Int32,System.ServiceModel.Channels.BufferManager,System.Int32)" /> with <paramref name="messageOffset" /> = 0.</para>
@@ -371,6 +391,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes a message less than a specified size to a byte array buffer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ArraySegment`1" /> of type byte that provides the buffer to which the message is serialized.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.Message" /> to write to the message buffer.</param>
         <param name="maxMessageSize">
@@ -396,7 +420,6 @@
         <Parameter Name="messageOffset" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called by <see cref="M:System.ServiceModel.Channels.MessageEncoder.WriteMessage(System.ServiceModel.Channels.Message,System.Int32,System.ServiceModel.Channels.BufferManager,System.Int32)" />.</para>
@@ -405,6 +428,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, writes a message of less than a specified size to a byte array buffer at the specified offset.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ArraySegment`1" /> of type byte that provides the buffer to which the message is serialized.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.Message" /> to write to the message buffer.</param>
         <param name="maxMessageSize">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageEncoderFactory.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageEncoderFactory.xml
index d5b3d9a362f..3bdf543fb31 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageEncoderFactory.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageEncoderFactory.xml
@@ -68,7 +68,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A session-based message encoder can keep track the individual messages that form part of a conversation that consists of all the messages exchanged between two endpoints that are part of a session.</para>
@@ -77,6 +76,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a message encoder that can be used to correlate messages in session-based exchanges.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.MessageEncoder" /> that is used in session-based exchanges of messages.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Encoder">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageEncodingBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageEncodingBindingElement.xml
index 765670d20ff..e6d2a41cb84 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageEncodingBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageEncodingBindingElement.xml
@@ -103,12 +103,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates a factory for producing message encoders.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.MessageEncoderFactory" /> used to produce message encoders.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetProperty&lt;T&gt;">
@@ -133,7 +136,6 @@
       </Parameters>
       <Docs>
         <param name="ctx">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this to request a typed object such as an interface for retrieving properties or getting status from the appropriate layer in the channel stack. If a layer supports returning the requested object, it returns it. If not, it delegates the call down to the next layer in the stack. If it gets to the bottom of the stack and no channel layer supported the requested object, then the method returns null.</para>
@@ -142,6 +144,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the typed object requested, if present, from the appropriate layer in the channel stack.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The typed object <paramref name="T" /> requested if it is present or null if it is not.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The typed object for which the method is querying.</typeparam>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageFault.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageFault.xml
index f3620572f4f..58b343b974d 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageFault.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageFault.xml
@@ -91,12 +91,15 @@
         <Parameter Name="maxBufferSize" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new <see cref="T:System.ServiceModel.Channels.MessageFault" /> object that uses the specified <see cref="T:System.ServiceModel.Channels.Message" /> and the specified maximum buffer size for the message buffer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.MessageFault" /> object with initial values from the passed in parameters.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The specified <see cref="T:System.ServiceModel.Channels.Message" /> to be used to create the <see cref="T:System.ServiceModel.Channels.MessageFault" /> object.</param>
         <param name="maxBufferSize">
@@ -118,12 +121,15 @@
         <Parameter Name="reason" Type="System.ServiceModel.FaultReason" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new <see cref="T:System.ServiceModel.Channels.MessageFault" /> object that uses the specified <see cref="T:System.ServiceModel.FaultCode" /> and <see cref="T:System.ServiceModel.FaultReason" /> objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.MessageFault" /> object with initial values from the passed in parameters.</para>
+        </returns>
         <param name="code">
           <attribution license="cc4" from="Microsoft" modified="false" />The fault code for the fault message.</param>
         <param name="reason">
@@ -145,12 +151,15 @@
         <Parameter Name="reason" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new <see cref="T:System.ServiceModel.Channels.MessageFault" /> object that uses the specified <see cref="T:System.ServiceModel.FaultCode" /> and fault reason.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.MessageFault" /> object with initial values from the passed in parameters.</para>
+        </returns>
         <param name="code">
           <attribution license="cc4" from="Microsoft" modified="false" />The fault code for the fault message.</param>
         <param name="reason">
@@ -173,12 +182,15 @@
         <Parameter Name="detail" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new <see cref="T:System.ServiceModel.Channels.MessageFault" /> object that uses the specified <see cref="T:System.ServiceModel.FaultCode" />, <see cref="T:System.ServiceModel.FaultReason" />, and detail object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.MessageFault" /> object with initial values from the passed in parameters.</para>
+        </returns>
         <param name="code">
           <attribution license="cc4" from="Microsoft" modified="false" />The fault code for the fault message.</param>
         <param name="reason">
@@ -205,12 +217,15 @@
       </Parameters>
       <Docs>
         <param name="formatter">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new <see cref="T:System.ServiceModel.Channels.MessageFault" /> object that uses the specified <see cref="T:System.ServiceModel.FaultCode" />, <see cref="T:System.ServiceModel.FaultReason" />, detail object, and  <see cref="T:System.Runtime.Serialization.XmlObjectSerializer" /> objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.MessageFault" /> object with initial values from the passed in parameters.</para>
+        </returns>
         <param name="code">
           <attribution license="cc4" from="Microsoft" modified="false" />The fault code for the fault message.</param>
         <param name="reason">
@@ -238,12 +253,15 @@
       </Parameters>
       <Docs>
         <param name="formatter">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new <see cref="T:System.ServiceModel.Channels.MessageFault" /> object that uses the specified <see cref="T:System.ServiceModel.FaultCode" />, <see cref="T:System.ServiceModel.FaultReason" />, detail object, <see cref="T:System.Runtime.Serialization.XmlObjectSerializer" />, and actor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.MessageFault" /> object with initial values from the passed in parameters.</para>
+        </returns>
         <param name="code">
           <attribution license="cc4" from="Microsoft" modified="false" />The fault code for the fault message.</param>
         <param name="reason">
@@ -274,12 +292,15 @@
       </Parameters>
       <Docs>
         <param name="formatter">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new <see cref="T:System.ServiceModel.Channels.MessageFault" /> object that uses the specified <see cref="T:System.ServiceModel.FaultCode" />, <see cref="T:System.ServiceModel.FaultReason" />, detail object, <see cref="T:System.Runtime.Serialization.XmlObjectSerializer" />, actor, and node values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.MessageFault" /> object with initial values from the passed in parameters.</para>
+        </returns>
         <param name="code">
           <attribution license="cc4" from="Microsoft" modified="false" />The fault code for the fault message.</param>
         <param name="reason">
@@ -307,12 +328,15 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the detail object of the message fault.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The detail object of the message fault.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the detail object.</typeparam>
       </Docs>
@@ -335,12 +359,15 @@
       </Parameters>
       <Docs>
         <param name="formatter">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the detail object that uses the specified <see cref="T:System.Runtime.Serialization.XmlObjectSerializer" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The detail object contained in the <see cref="T:System.ServiceModel.Channels.MessageFault" />.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the detail object.</typeparam>
       </Docs>
@@ -357,12 +384,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Xml.XmlDictionaryReader" /> object that is positioned on the detail object of the <see cref="T:System.ServiceModel.Channels.MessageFault" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlDictionaryReader" /> object that is positioned on the detail object of the <see cref="T:System.ServiceModel.Channels.MessageFault" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HasDetail">
@@ -415,12 +445,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When called in a derived class, returns an <see cref="T:System.Xml.XmlDictionaryReader" /> object that is positioned on the detail object of the <see cref="T:System.ServiceModel.Channels.MessageFault" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlDictionaryReader" /> object that is positioned on the detail object of the <see cref="T:System.ServiceModel.Channels.MessageFault" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="OnWriteDetail">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageHeader.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageHeader.xml
index 0f705a7dbf2..2f1f1825ffc 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageHeader.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageHeader.xml
@@ -153,12 +153,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new message header with the specified data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Channels.MessageHeader" /> object with the specified data.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the header XML element.</param>
         <param name="ns">
@@ -185,12 +188,15 @@
       </Parameters>
       <Docs>
         <param name="must_understand">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new message header with the specified data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Channels.MessageHeader" /> object with the specified data.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the header XML element.</param>
         <param name="ns">
@@ -217,12 +223,15 @@
       </Parameters>
       <Docs>
         <param name="formatter">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a header from an object to be serialized using the XmlFormatter. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Channels.MessageHeader" /> object with the specified data.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the header XML element.</param>
         <param name="ns">
@@ -250,12 +259,15 @@
       </Parameters>
       <Docs>
         <param name="must_understand">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new message header with the specified data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Channels.MessageHeader" /> object with the specified data.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the header XML element.</param>
         <param name="ns">
@@ -286,12 +298,15 @@
       <Docs>
         <param name="formatter">To be added.</param>
         <param name="must_understand">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new message header with the specified data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Channels.MessageHeader" /> object with the specified data.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the header XML element.</param>
         <param name="ns">
@@ -320,12 +335,15 @@
       </Parameters>
       <Docs>
         <param name="must_understand">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new message header with the specified data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Channels.MessageHeader" /> object with the specified data.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the header XML element.</param>
         <param name="ns">
@@ -359,12 +377,15 @@
       <Docs>
         <param name="formatter">To be added.</param>
         <param name="must_understand">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new message header with the specified data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Channels.MessageHeader" /> object with the specified data.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the header XML element.</param>
         <param name="ns">
@@ -397,12 +418,15 @@
       <Docs>
         <param name="formatter">To be added.</param>
         <param name="must_understand">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new message header with the specified data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Channels.MessageHeader" /> object with the specified data.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the header XML element.</param>
         <param name="ns">
@@ -430,12 +454,15 @@
       </Parameters>
       <Docs>
         <param name="version">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies whether the specified message version is supported.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified message version is supported; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsReferenceParameter">
@@ -566,12 +593,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the string representation of this message header.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of this message header.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="WriteHeader">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageHeaders.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageHeaders.xml
index 49807a9b974..7000e6c141a 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageHeaders.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageHeaders.xml
@@ -401,12 +401,15 @@
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds a message header in this collection by the specified LocalName and namespace URI of the header element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the message header in this collection if found or -1 if the header specified does not exist.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The LocalName of the header XML element.</param>
         <param name="ns">
@@ -435,12 +438,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds a message header in this collection by the specified LocalName, namespace URI and actors of the header element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the message header in this collection if found, or -1 if the header specified does not exist.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The LocalName of the header XML element.</param>
         <param name="ns">
@@ -483,12 +489,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator for iterating through the collection. This method cannot be inherited.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> object that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHeader&lt;T&gt;">
@@ -508,7 +517,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method only uses the <see cref="T:System.Runtime.Serialization.DataContractSerializer" />. It does not try to detect from the type whether it should use the <see cref="T:System.Runtime.Serialization.XmlObjectSerializer" /> or DataContractSerializer. To use the XML serializer, call <see cref="M:System.ServiceModel.Channels.MessageHeaders.GetHeader``1(System.String,System.String,System.Runtime.Serialization.XmlObjectSerializer)" /> or obtain the reader at the contents and call directly into the serializer.</para>
@@ -517,6 +525,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a message header at a specific position in this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A message header at the specified index.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the header to get.</param>
         <typeparam name="T">
@@ -541,12 +553,15 @@
         <Parameter Name="serializer" Type="System.Runtime.Serialization.XmlObjectSerializer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a message header at a specific position in this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A message header at the specified index.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the header to get.</param>
         <param name="serializer">
@@ -573,7 +588,6 @@
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method only uses the <see cref="T:System.Runtime.Serialization.DataContractSerializer" />. It does not try to detect from the type whether it should use the <see cref="T:System.Runtime.Serialization.XmlObjectSerializer" /> or the DataContractSerializer. To use the XML serializer, call <see cref="M:System.ServiceModel.Channels.MessageHeaders.GetHeader``1(System.String,System.String,System.Runtime.Serialization.XmlObjectSerializer)" /> or obtain the reader at the contents and call directly into the serializer.</para>
@@ -582,6 +596,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds a message header in this collection by the specified LocalName and namespace URI of the header element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A message header with the specified name.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The LocalName of the header XML element.</param>
         <param name="ns">
@@ -609,12 +627,15 @@
         <Parameter Name="serializer" Type="System.Runtime.Serialization.XmlObjectSerializer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a message header in this collection by the specified LocalName, namespace URI and serializer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A message header with the specified name.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The LocalName of the header XML element.</param>
         <param name="ns">
@@ -650,7 +671,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method only uses the <see cref="T:System.Runtime.Serialization.DataContractSerializer" />. It does not try to detect from the type whether it should use the <see cref="T:System.Runtime.Serialization.XmlObjectSerializer" /> or DataContractSerializer. To use the XML serializer, call <see cref="M:System.ServiceModel.Channels.MessageHeaders.GetHeader``1(System.String,System.String,System.Runtime.Serialization.XmlObjectSerializer)" /> or obtain the reader at the contents and call directly into the serializer.</para>
@@ -659,6 +679,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a message header in this collection by the specified LocalName, namespace URI and actors of the header element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A message header with the specified name.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The LocalName of the header XML element.</param>
         <param name="ns">
@@ -684,12 +708,15 @@
       </Parameters>
       <Docs>
         <param name="index">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a XML dictionary reader that consumes the message header at the specified location of the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlDictionaryReader" /> object that consumes the message header at the specified location of the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HaveMandatoryHeadersBeenUnderstood">
@@ -704,7 +731,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the message receiver cannot interpret the message headers marked with MustUnderstand, the message is not processed and an exception is thrown. </para>
@@ -713,6 +739,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies whether all the message headers marked with MustUnderstand have been properly interpreted and processed. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the recipients specified by <paramref name="actors" /> have properly interpreted and processed all the message headers marked with MustUnderstand; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HaveMandatoryHeadersBeenUnderstood">
@@ -735,7 +765,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the message receiver cannot interpret the message headers marked with MustUnderstand, the message is not processed and an exception is thrown. </para>
@@ -744,6 +773,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies whether the specified recipients have properly interpreted and processed all the message headers marked with MustUnderstand. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the recipients specified by <paramref name="actors" /> have properly interpreted and processed all the message headers marked with MustUnderstand; otherwise, false.</para>
+        </returns>
         <param name="actors">
           <attribution license="cc4" from="Microsoft" modified="false" />The targeted recipient of the message header.</param>
       </Docs>
@@ -961,12 +994,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator for iterating through the collection. This method cannot be inherited.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> object that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="To">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageProperties.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageProperties.xml
index d3fa316c49e..0193187a01c 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageProperties.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageProperties.xml
@@ -153,12 +153,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.ServiceModel.Channels.MessageProperties" /> contains a specific name, key, or identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ServiceModel.Channels.MessageProperties" /> contains an element with the specified <paramref name="name" />; otherwise, false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name, key, or identifier to locate in the <see cref="T:System.ServiceModel.Channels.MessageProperties" />.</param>
       </Docs>
@@ -343,12 +346,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the element with the specified name from the <see cref="T:System.ServiceModel.Channels.MessageProperties" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ServiceModel.Channels.MessageProperties" /> contains an element with the specified <paramref name="name" /> and can be removed; otherwise, false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the element to remove.</param>
       </Docs>
@@ -484,12 +490,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that can iterate through a collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryGetValue">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageVersion.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageVersion.xml
index b50b2fdad1d..09db9e858e5 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageVersion.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MessageVersion.xml
@@ -64,7 +64,6 @@
       </Parameters>
       <Docs>
         <param name="envelope_version">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The SOAP versions currently available are SOAP 1.1 and SOAP 1.2. There is an <see cref="T:System.ServiceModel.EnvelopeVersion" /> for each version of SOAP that contains the data relevant to its use. </para>
@@ -73,6 +72,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a message version object by using WS-Addressing 1.0 and with a specified SOAP version.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.MessageVersion" /> using the specified version of SOAP and WS-Addressing 1.0.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateVersion">
@@ -92,7 +95,6 @@
       <Docs>
         <param name="envelope_version">To be added.</param>
         <param name="addressing_version">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The SOAP versions currently available are SOAP 1.1 and SOAP 1.2. There is an <see cref="T:System.ServiceModel.EnvelopeVersion" /> for each version of SOAP that contains the data relevant to its use.</para>
@@ -102,6 +104,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a message version object with specified SOAP and WS-Addressing versions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.MessageVersion" /> using the specified versions of WS-Addressing and SOAP.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Default">
@@ -163,12 +169,15 @@
       </Parameters>
       <Docs>
         <param name="value">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current message version is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified object is equal to the current <see cref="T:System.ServiceModel.Channels.MessageVersion" /> object; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -183,12 +192,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a hash code for the current message version.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A unique hash code for the current <see cref="T:System.ServiceModel.Channels.MessageVersion" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="None">
@@ -420,12 +432,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the string representation of the current message version.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the current message version.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MsmqBindingElementBase.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MsmqBindingElementBase.xml
index 6ee4ade4bd2..cfe18fb36fa 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MsmqBindingElementBase.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MsmqBindingElementBase.xml
@@ -173,7 +173,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides the functionality to retrieve capabilities and protection requirements from the element.</para>
@@ -182,6 +181,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, retrieves a specified type of object for the binding context provided.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object of type <paramref name="T" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> for the binding element.</param>
         <typeparam name="T">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MsmqMessageProperty.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MsmqMessageProperty.xml
index c6d017e867d..92a9c914101 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MsmqMessageProperty.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MsmqMessageProperty.xml
@@ -103,12 +103,15 @@
         <Parameter Name="message" Type="System.ServiceModel.Channels.Message" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.ServiceModel.Channels.MsmqMessageProperty" /> for the specified <see cref="T:System.ServiceModel.Channels.Message" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.MsmqMessageProperty" /> for the specified <see cref="T:System.ServiceModel.Channels.Message" />.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.Message" /> whose properties are to be retrieved.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MsmqTransportBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MsmqTransportBindingElement.xml
index 5ca2175cdd0..beb7d2684c8 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MsmqTransportBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MsmqTransportBindingElement.xml
@@ -55,7 +55,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A channel factory is created and initialized using the properties that have been set in the binding element. The initialized channel factory is then used to create output channels that can be used to send messages to a message queue.</para>
@@ -64,6 +63,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds a channel factory using the context provided.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Message Queuing (MSMQ) channel factory that can be used to create channels to send messages to existing Message Queuing applications.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> with which to build the channel factory.</param>
         <typeparam name="TChannel">
@@ -92,12 +95,15 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds a channel listener using the context provided.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Message Queuing (MSMQ) channel listener that can be used to create channels to receive messages from existing MSMQ applications.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> with which to build the channel listener.</param>
         <typeparam name="TChannel">
@@ -121,12 +127,15 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Boolean value that indicates whether you can build a channel factory with the context provided.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if you can build a channel factory with the context provided; otherwise, false. The binding element returns true only when <paramref name="TChannel" /> is <see cref="T:System.ServiceModel.Channels.IOutputChannel" /> or <see cref="T:System.ServiceModel.Channels.IOutputSessionChannel" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> with which to build the channel factory.</param>
         <typeparam name="TChannel">
@@ -155,12 +164,16 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Boolean value that indicates whether you can build a channel listener with the context provided.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if you can build a channel listener with the context provided; otherwise, false.</para>
+          <para>The binding returns true only when <paramref name="TChannel" /> is <see cref="T:System.ServiceModel.Channels.IInputChannel" /> or <see cref="T:System.ServiceModel.Channels.IInputSessionChannel" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> with which to build the channel listener.</param>
         <typeparam name="TChannel">
@@ -179,12 +192,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a clone of the binding element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A clone of the binding element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MaxPoolSize">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MtomMessageEncodingBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MtomMessageEncodingBindingElement.xml
index 168135b4be5..97c4bcbce4f 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MtomMessageEncodingBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/MtomMessageEncodingBindingElement.xml
@@ -92,12 +92,15 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds the channel factory stack on the client that creates a specified type of channel for a specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Channels.IChannelFactory`1" /> of type <paramref name="TChannel" /> for the specified context.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> for the channel.</param>
         <typeparam name="TChannel">
@@ -126,12 +129,15 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds the channel listener stack on the client that accepts a specified type of channel for a specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Channels.IChannelListener`1" /> of type <paramref name="TChannel" /> for the specified context.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> for the listener.</param>
         <typeparam name="TChannel">
@@ -160,12 +166,15 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current binding can build a listener for a specified type of channel and context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified channel listener stack can be built on the service; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> for the listener.</param>
         <typeparam name="TChannel">
@@ -184,7 +193,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This creates a complete copy of the current binding element object tree, also called a deep clone. A deep clone of an object creates a copy of the object and a copy of everything directly or indirectly referenced by that object. (This is called copying the entire object graph.) Returning a deep clone enables the runtime to support the case in which multiple custom bindings share a custom binding element. If a deep clone is not returned, the run-time behavior is undefined. A shallow clone of an object, by contrast, is a copy of the object only. If the object contains references to other objects, the shallow copy does not create copies of the referred objects; instead, it copies only the references to the original objects.</para>
@@ -193,6 +201,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Channels.MtomMessageEncodingBindingElement" /> object initialized from the current one.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.MtomMessageEncodingBindingElement" /> object with property values equal to those of the current element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateMessageEncoderFactory">
@@ -207,12 +219,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a message encoder factory that encodes MTOM messages.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.MessageEncoderFactory" /> that encodes MTOM messages.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ExportPolicy">
@@ -257,7 +272,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this to request a typed object for setting properties or getting status from the appropriate layer in the binding element stack. If a layer supports returning the requested object, it returns it. If not, it simply delegates the call down to the next layer in the stack. If it gets to the bottom of the stack and no binding element layer supported the requested object, then the method returns null.</para>
@@ -266,6 +280,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a typed object requested, if present, from the appropriate layer in the binding element stack.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The typed object <paramref name="T " />requested if it is present or null if it is not.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> for the binding element.</param>
         <typeparam name="T">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/NamedPipeTransportBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/NamedPipeTransportBindingElement.xml
index 51be788c2fb..d6eabc04934 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/NamedPipeTransportBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/NamedPipeTransportBindingElement.xml
@@ -81,7 +81,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to create a channel factory of the specified type for sending messages based on the configuration of the transport binding element.</para>
@@ -90,6 +89,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel factory of the specified type that can be used to create channels.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a channel factory of the specified type.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />Members that describe bindings, behaviors, contracts and other information required to create the channel factory.</param>
         <typeparam name="TChannel">
@@ -118,7 +121,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to get a channel listener of the specified type for receiving messages based on the configuration of the named pipe binding element.</para>
@@ -127,6 +129,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel listener of the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a channel listener of the specified type.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />Members that describe bindings, behaviors, contracts and other information required to create the channel factory.</param>
         <typeparam name="TChannel">
@@ -145,12 +151,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the current binding element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a copy of the current binding element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ConnectionPoolSettings">
@@ -193,7 +202,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method gets the specified object from the base class, or from one of that class's ancestors. The object returned is usually a collection of properties, for example an object that implements <see cref="T:System.ServiceModel.Channels.ISecurityCapabilities" />.</para>
@@ -202,6 +210,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a specified object from the <see cref="T:System.ServiceModel.Channels.BindingContext" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified object from the <see cref="T:System.ServiceModel.Channels.BindingContext" />, or null if the object isn't found.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ServiceModel.Channels.BindingContext" />.</param>
         <typeparam name="T">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/OneWayBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/OneWayBindingElement.xml
index 77570e77d07..30762a9aa85 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/OneWayBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/OneWayBindingElement.xml
@@ -55,7 +55,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates a channel factory, which is used to create a channel that processes outgoing messages for this binding.</para>
@@ -64,6 +63,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a channel factory for producing one-way channels from the binding context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.IChannelFactory`1" /> of type <see cref="T:System.ServiceModel.Channels.IChannel" /> initialized from the <paramref name="context" />. </para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> that provides context for the binding element.</param>
         <typeparam name="TChannel">
@@ -92,7 +95,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates a channel listener, which is used to create a channel that processes incoming messages for this binding.</para>
@@ -101,6 +103,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a channel listener for accepting one-way channels.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.IChannelListener`1" /> of type <see cref="T:System.ServiceModel.Channels.IChannel" /> initialized from the <paramref name="context" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> that provides context for the binding element.  </param>
         <typeparam name="TChannel">
@@ -124,7 +130,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You should call this method before trying to create a channel factory.</para>
@@ -134,6 +139,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether a channel factory of the specified type can be built. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a channel factory of the specified type can be built; otherwise, false. The default is false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> that provides context for the binding element.  </param>
         <typeparam name="TChannel">
@@ -162,7 +171,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You should call this method before trying to create a channel listener.</para>
@@ -172,6 +180,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether a channel listener of the specified type can be built.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a channel listener of the specified type can be built; otherwise, false. The default is false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> that provides context for the binding element.  </param>
         <typeparam name="TChannel">
@@ -209,12 +221,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clones an instance of this class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A cloned copy of this instance of this class.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetProperty&lt;T&gt;">
@@ -238,7 +253,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method receives a binding context as an input parameter, which represents the stack of binding elements.</para>
@@ -249,6 +263,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets properties from the binding stack, if present.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <paramref name="T" /> object from the binding stack, if present.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> that provides context for the binding element.  </param>
         <typeparam name="T">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/PeerCustomResolverBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/PeerCustomResolverBindingElement.xml
index 037df2d48b3..22521d07cda 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/PeerCustomResolverBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/PeerCustomResolverBindingElement.xml
@@ -156,7 +156,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to get a channel factory for sending messages based on the configuration of the transport binding element.</para>
@@ -165,6 +164,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel factory that can be used to create a channel for sending messages.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="T:System.ServiceModel.Channels.IChannelFactory" /> that contains the new channel factory of the specified type.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.Channels.BindingContext" /> that specifies the binding context for the channel factory.</param>
@@ -194,7 +198,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to get a channel listener for receiving messages based on the configuration of the transport binding element.</para>
@@ -203,6 +206,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel listener of the specified type for receiving messages.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="T:System.ServiceModel.Channels.IChannelListener" /> that contains the new channel listener of the specified type.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.Channels.BindingContext" /> that specifies the binding context for the channel listener.</param>
@@ -228,12 +236,15 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a channel factory of the specified type can be built.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True if this binding element can produce a channel factory of the specified type; false if it cannot.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.Channels.BindingContext" /> that specifies the binding context for the channel factory.</param>
@@ -264,12 +275,15 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a channel listener of the specified type can be built.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True if this binding element can produce a channel listener of the specified type; false if it cannot.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.Channels.BindingContext" /> that specifies the binding context for the channel listener.</param>
@@ -290,7 +304,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The object returned by this method can be reboxed as an object of the more specific <see cref="T:System.ServiceModel.Channels.PeerCustomResolverBindingElement" /> type.</para>
@@ -299,6 +312,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the current binding element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="T:System.ServiceModel.Channels.BindingElement" /> that contains a copy of the current binding element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreatePeerResolver">
@@ -313,12 +331,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the custom peer resolver.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="T:System.ServiceModel.PeerResolver" /> object that contains a new custom peer resolver with the settings supplied to this binding element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetProperty&lt;T&gt;">
@@ -342,12 +364,15 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a property from the specified <see cref="T:System.ServiceModel.Channels.BindingContext" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The property from the specified <see cref="T:System.ServiceModel.Channels.BindingContext" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.Channels.BindingContext" /> that specifies the binding context.</param>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/PeerResolverBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/PeerResolverBindingElement.xml
index c9da66b80f1..9b64c61a002 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/PeerResolverBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/PeerResolverBindingElement.xml
@@ -70,12 +70,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a peer resolver object with the settings defined on this binding element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="T:System.ServiceModel.PeerResolver" /> object that is used to perform peer name to address resolution. The settings on the peer resolver must be defined on the binding element. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReferralPolicy">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/PeerTransportBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/PeerTransportBindingElement.xml
index 37b704c832d..c07b46e9042 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/PeerTransportBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/PeerTransportBindingElement.xml
@@ -61,7 +61,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to get a channel factory based on the configuration of the transport binding element.</para>
@@ -70,6 +69,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel factory that can be used to create a channel for sending messages.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="T:System.ServiceModel.Channels.IChannelFactory" /> that contains the new channel factory of the specified type.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.Channels.BindingContext" /> that specifies the binding context for the channel factory.</param>
@@ -99,7 +103,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to get a channel listener for receiving messages based on the configuration of the transport binding element.</para>
@@ -108,6 +111,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel listener of the specified type for receiving messages.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="T:System.ServiceModel.Channels.IChannelListener" /> that contains the new channel listener of the specified type.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.Channels.BindingContext" /> that specifies the binding context for the channel listener.</param>
@@ -133,12 +141,15 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a channel factory of the specified type can be built.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this binding element can produce a channel factory of the specified type; false if it cannot.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.Channels.BindingContext" /> that specifies the binding context for the channel factory.</param>
@@ -169,12 +180,15 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a channel listener of the specified type can be built.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this binding element can produce a channel listener of the specified type; false if it cannot.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.Channels.BindingContext" /> that specifies the binding context for the channel listener.</param>
@@ -195,7 +209,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The object returned by this method can be re-boxed as an object of the more specific <see cref="T:System.ServiceModel.Channels.PeerTransportBindingElement" /> type.</para>
@@ -204,6 +217,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the current binding element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="T:System.ServiceModel.Channels.BindingElement" /> that contains a copy of the current binding element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetProperty&lt;T&gt;">
@@ -227,7 +245,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following properties can be retrieved from <see cref="T:System.ServiceModel.Channels.PeerTransportBindingElement" />:</para>
@@ -253,6 +270,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a property from the specified <see cref="T:System.ServiceModel.Channels.BindingContext" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The property from the specified <see cref="T:System.ServiceModel.Channels.BindingContext" />. </para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.Channels.BindingContext" /> that specifies the binding context.</param>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/PnrpPeerResolverBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/PnrpPeerResolverBindingElement.xml
index d823cbec064..aceb98e0615 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/PnrpPeerResolverBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/PnrpPeerResolverBindingElement.xml
@@ -54,7 +54,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to get a channel factory for sending messages based on the configuration of the transport binding element.</para>
@@ -63,6 +62,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel factory that can be used to create a channel for sending messages.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="T:System.ServiceModel.Channels.IChannelFactory" /> that contains the new channel factory of the specified type.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.Channels.BindingContext" /> that specifies the binding context for the channel factory.</param>
@@ -92,7 +96,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to get a channel listener for receiving messages based on the configuration of the transport binding element.</para>
@@ -101,6 +104,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel listener of the specified type for receiving messages.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="T:System.ServiceModel.Channels.IChannelListener" /> that contains the new channel listener of the specified type.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.Channels.BindingContext" /> that specifies the binding context for the channel listener.</param>
@@ -121,7 +129,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The object returned by this method can be reboxed as an object of the more specific <see cref="T:System.ServiceModel.Channels.PnrpPeerResolverBindingElement" /> type.</para>
@@ -130,6 +137,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance that is a copy of the current binding element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Channels.BindingElement" /> that contains a copy of the current binding element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreatePeerResolver">
@@ -144,12 +155,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a PNRP-specific <see cref="T:System.ServiceModel.PeerResolver" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="T:System.ServiceModel.PeerResolver" /> object that contains the new PNRP resolver created by this binding element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetProperty&lt;T&gt;">
@@ -173,12 +188,15 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a property from the specified <see cref="T:System.ServiceModel.Channels.BindingContext" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The property from the specified <see cref="T:System.ServiceModel.Channels.BindingContext" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.Channels.BindingContext" /> that specifies the binding context.</param>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/PrivacyNoticeBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/PrivacyNoticeBindingElement.xml
index 5aed9ef6d7e..c77bdff4de1 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/PrivacyNoticeBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/PrivacyNoticeBindingElement.xml
@@ -70,12 +70,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the current binding element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.BindingElement" /> that is a copy of the current element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetProperty&lt;T&gt;">
@@ -99,7 +102,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calls <see cref="M:System.ServiceModel.Channels.BindingElement.GetProperty``1(System.ServiceModel.Channels.BindingContext)" /> on the next binding element in the binding context.</para>
@@ -108,6 +110,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Queries the binding element stack to see whether it supports a particular interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The interface whose support is being tested.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> for the current binding element.</param>
         <typeparam name="T">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ReliableSessionBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ReliableSessionBindingElement.xml
index 4f2fd6c6b4d..78b4e91a6d6 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ReliableSessionBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/ReliableSessionBindingElement.xml
@@ -145,7 +145,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.ServiceModel.Channels.IChannel" /> produced by the factory is of type <paramref name="TChannel" />. The types of <paramref name="TChannel" /> supported on the client is dependent of the types of underlying channels that connect to the service. The following table indicates what reliable session channel types are supported as a function of the underlying channels.</para>
@@ -226,6 +225,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a factory that creates a channel of a specified type that supports a reliable session.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.IChannelFactory`1" /> of type <see cref="T:System.ServiceModel.Channels.IChannel" /> initialized from the <paramref name="context" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> that contains the information required to build the factories that can produce channels of type <paramref name="TChannel" />.</param>
         <typeparam name="TChannel">
@@ -254,7 +257,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.ServiceModel.Channels.IChannel" /> accepted by the listener is of type <paramref name="TChannel" />. The types of <paramref name="TChannel" /> supported on the server that hosts the service is dependent of the types of underlying channels used to connect to the client. The following table indicates what reliable session channel types are supported as a function of the underlying channels.</para>
@@ -335,6 +337,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a listener that accepts a channel of a specified type that supports a reliable session.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.IChannelListener`1" /> of type <see cref="T:System.ServiceModel.Channels.IChannel" /> initialized from the <paramref name="context" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> that contains the information required to build the listeners that can accept channels of type <paramref name="TChannel" />.</param>
         <typeparam name="TChannel">
@@ -358,7 +364,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns true or false for a <paramref name="TChannel" /> in accordance with the table of values provided in <see cref="M:System.ServiceModel.Channels.ReliableSessionBindingElement.BuildChannelFactory``1(System.ServiceModel.Channels.BindingContext)" />.</para>
@@ -367,6 +372,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the channel factory can be built for the channel and context provided that can support a reliable session.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ServiceModel.Channels.IChannelFactory`1" /> of type <paramref name="TChannel" /> can be built; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> that contains the information required to build the factories that can produce channels of type <paramref name="TChannel" />.</param>
         <typeparam name="TChannel">
@@ -395,7 +404,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Channel stacks are typically created using a factory pattern where a binding creates the channel stack. When sending messages, a binding is used to build a channel factory which in turn builds a channel stack and returns a reference to the top channel in the stack. The application can then use this channel to send messages. Similarly when receiving messages, a binding is used to build a channel listener which listens for incoming messages. The channel listener provides messages to the listening application by creating channel stacks and handing the application a reference to the top channel.</para>
@@ -405,6 +413,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the channel listener can be built for the channel and context provided that can support a reliable session.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ServiceModel.Channels.ChannelListenerBase`1" /> that can produce an <see cref="T:System.ServiceModel.Channels.IChannel" /> of type <paramref name="TChannel" /> can be built by the binding element; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> that contains the information required to build the listeners that can accept channels of type <paramref name="TChannel" />.</param>
         <typeparam name="TChannel">
@@ -423,12 +435,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the current reliable session binding element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.BindingElement" /> that is a clone of the current binding element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="FlowControlEnabled">
@@ -474,12 +489,15 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a property of the specified type from its binding context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The property of type <paramref name="T" /> with the specified <paramref name="context" /> or null if no property of type <paramref name="T" /> is found.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> that contains the information required to retrieve the channel of type <paramref name="T" />.</param>
         <typeparam name="T">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/RequestContext.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/RequestContext.xml
index 9459b96ee22..a31501eb7b6 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/RequestContext.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/RequestContext.xml
@@ -93,7 +93,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the asynchronous <see cref="M:System.ServiceModel.Channels.RequestContext.BeginReply" /> method when the application processing must continue without waiting. Use one of the synchronous <see cref="M:System.ServiceModel.Channels.RequestContext.Reply" /> methods when it is acceptable for the current thread to be blocked while it replies to the request message or until the time-out interval is exceeded.</para>
@@ -103,6 +102,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, begins an asynchronous operation to reply to the request associated with the current context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous reply operation.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The incoming <see cref="T:System.ServiceModel.Channels.Message" /> that contains the request.</param>
         <param name="callback">
@@ -128,7 +131,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the asynchronous <see cref="M:System.ServiceModel.Channels.RequestContext.BeginReply" /> method to allow the application processing to continue without waiting for the request to complete. </para>
@@ -138,6 +140,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, begins an asynchronous operation to reply to the request associated with the current context within a specified interval of time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous reply operation.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The incoming <see cref="T:System.ServiceModel.Channels.Message" /> that contains the request.</param>
         <param name="timeout">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/SecurityBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/SecurityBindingElement.xml
index 0acfc249861..4d3a42cc007 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/SecurityBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/SecurityBindingElement.xml
@@ -64,7 +64,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The channel factory created is a SOAP message security channel factory, which internally has a reference to the channel factory that corresponds to the binding context, (which includes the transport channel factory). </para>
@@ -74,6 +73,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel factory based on the <see cref="T:System.ServiceModel.Channels.SecurityBindingElement" /> settings and the binding context passed in. The channel factory created is a SOAP message security channel factory, which internally has a reference to the channel factory that corresponds to the binding context, (which includes the transport channel factory).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A channel factory based on the <see cref="T:System.ServiceModel.Channels.SecurityBindingElement" /> settings and the binding context passed in.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" />.</param>
         <typeparam name="TChannel">
@@ -97,7 +100,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -107,6 +109,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented, creates a channel factory of a specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A channel factory of a specified type.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" />.</param>
         <typeparam name="TChannel">
@@ -135,7 +141,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The channel factory created is a SOAP message security channel listener, which internally has a reference to the channel listener that corresponds to the binding context, which includes the transport channel listener.</para>
@@ -145,6 +150,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel listener based on the <see cref="T:System.ServiceModel.Channels.SecurityBindingElement" /> settings and the binding context passed in. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A channel listener based on the <see cref="T:System.ServiceModel.Channels.SecurityBindingElement" /> settings and the binding context passed in.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" />.</param>
         <typeparam name="TChannel">
@@ -173,7 +182,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -183,6 +191,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented, creates a channel listener of a specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A channel listener of a specified type.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> object.</param>
         <typeparam name="TChannel">
@@ -206,7 +218,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You should call this method before trying to create a channel factory.</para>
@@ -215,6 +226,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a channel factory of the specified type can be built. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a channel factory of the specified type can be built; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" />.</param>
         <typeparam name="TChannel">
@@ -243,7 +258,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You should call this method before trying to create a channel listener.</para>
@@ -252,6 +266,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a channel listener of the specified type can be built.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a channel listener of the specified type can be built; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.serviceModel.Channels.BindingContext" />.</param>
         <typeparam name="TChannel">
@@ -270,7 +288,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The client and server must be configured out of band with the service certificate.</para>
@@ -280,6 +297,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric security binding element that is configured for anonymous client authentication and certificate-based server authentication.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.SymmetricSecurityBindingElement" /> that holds the new binding.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateCertificateOverTransportBindingElement">
@@ -294,7 +315,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This binding element expects the transport to provide server authentication as well as message protection (for example, HTTPS).</para>
@@ -307,6 +327,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a security binding element that expects clients to do certificate-based authentication using SOAP message security. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.TransportSecurityBindingElement" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateCertificateOverTransportBindingElement">
@@ -323,7 +347,6 @@
         <Parameter Name="version" Type="System.ServiceModel.MessageSecurityVersion" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This binding element expects the transport to provide server authentication as well as message protection (for example, HTTPS). The binding element is configured with the specified <see cref="T:System.ServiceModel.MessageSecurityVersion" />.</para>
@@ -335,6 +358,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a security binding element that expects clients to do certificate-based authentication using SOAP message security. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.TransportSecurityBindingElement" /> object.</para>
+        </returns>
         <param name="version">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.MessageSecurityVersion" /> for the binding.</param>
       </Docs>
@@ -351,7 +378,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.ServiceModel.Channels.LocalClientSecuritySettings" /> object returned from <see cref="P:System.ServiceModel.Channels.SecurityBindingElement.LocalClientSettings" /> has its <see cref="P:System.ServiceModel.Channels.LocalClientSecuritySettings.DetectReplays" /> property set to false.</para>
@@ -361,6 +387,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a binding element using a certificate to sign messages. This binding element can be used only for one-way message exchanges and is capable only of signing the message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.AsymmetricSecurityBindingElement" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateIssuedTokenBindingElement">
@@ -377,7 +407,6 @@
         <Parameter Name="issuedTokenParameters" Type="System.ServiceModel.Security.Tokens.IssuedSecurityTokenParameters" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The issued token parameters must have a symmetric key type.</para>
@@ -389,6 +418,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric security binding element that is configured to require client authentication using a symmetric-key based issued token. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.SymmetricSecurityBindingElement" /> object.</para>
+        </returns>
         <param name="issuedTokenParameters">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ServiceModel.Security.Tokens.IssuedSecurityTokenParameters" /> that represents the symmetric-key based issued token.</param>
       </Docs>
@@ -407,7 +440,6 @@
         <Parameter Name="issuedTokenParameters" Type="System.ServiceModel.Security.Tokens.IssuedSecurityTokenParameters" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The issued token can have a symmetric or an asymmetric key. The client and server must be provisioned with the server's certificate.</para>
@@ -420,6 +452,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric security binding element that is configured to require client authentication based on an issued token and server authentication based on the server certificate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.SymmetricSecurityBindingElement" /> object.</para>
+        </returns>
         <param name="issuedTokenParameters">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ServiceModel.Security.Tokens.IssuedSecurityTokenParameters" /> that represents the symmetric-key based issued token.</param>
       </Docs>
@@ -438,7 +474,6 @@
         <Parameter Name="issuedTokenParameters" Type="System.ServiceModel.Security.Tokens.IssuedSecurityTokenParameters" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The server issues a cookie-based security context token at the end of the SSL protocol.</para>
@@ -448,6 +483,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric security binding element that is configured to require client authentication based on an issued token and server authentication based on the server certificate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.SymmetricSecurityBindingElement" /> object.</para>
+        </returns>
         <param name="issuedTokenParameters">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ServiceModel.Security.Tokens.IssuedSecurityTokenParameters" />.</param>
       </Docs>
@@ -467,7 +506,6 @@
         <Parameter Name="requireCancellation" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The created binding has <see cref="P:System.ServiceModel.Channels.SymmetricSecurityBindingElement.RequireSignatureConfirmation" /> set to true and <see cref="P:System.ServiceModel.Channels.SecurityBindingElement.MessageSecurityVersion" /> set to <see cref="P:System.ServiceModel.MessageSecurityVersion.WSSecurity11WSTrustFebruary2005WSSecureConversationFebruary2005WSSecurityPolicy11" />.</para>
@@ -476,6 +514,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric security binding element that is configured to require client authentication based on an issued token and server authentication based on the server certificate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.SymmetricSecurityBindingElement" /> object.</para>
+        </returns>
         <param name="issuedTokenParameters">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ServiceModel.Security.Tokens.IssuedSecurityTokenParameters" />.</param>
         <param name="requireCancellation">
@@ -496,7 +538,6 @@
         <Parameter Name="issuedTokenParameters" Type="System.ServiceModel.Security.Tokens.IssuedSecurityTokenParameters" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The created binding has <see cref="P:System.ServiceModel.Channels.SecurityBindingElement.IncludeTimestamp" /> set to true.</para>
@@ -510,6 +551,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a security binding element configured to require SOAP security based client authentication using an issued token. This binding element requires the transport to provide server authentication and message protection (for example, HTTPS).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.TransportSecurityBindingElement" /> object.</para>
+        </returns>
         <param name="issuedTokenParameters">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ServiceModel.Security.Tokens.IssuedSecurityTokenParameters" />.</param>
       </Docs>
@@ -526,7 +571,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To do Kerberos authentication, the server must run in an account that has a service principal name registered with Active Directory. NetworkService is such an account.</para>
@@ -535,6 +579,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric security binding element that is configured to require client authentication based on the client's Kerberos token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.SymmetricSecurityBindingElement" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateKerberosOverTransportBindingElement">
@@ -549,7 +597,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To do Kerberos authentication, the server must run in an account that has a service principal name registered with Active Directory. NetworkService is such an account.</para>
@@ -560,6 +607,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a security binding element that is configured to require SOAP-security based client authentication using the client's Kerberos token. This binding element requires the transport to provide server authentication and message protection (for example, HTTPS).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.TransportSecurityBindingElement" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateMutualCertificateBindingElement">
@@ -574,7 +625,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The binding is configured so that a new random symmetric key (encrypted for the server) is generated for every request by the client and is used to protect the request as well as the response from the server. The client's certificate is used as an endorsing supporting token on the request.</para>
@@ -584,6 +634,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an asymmetric security binding element that is configured to require certificate-based client authentication as well as certificate-based server authentication.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.SecurityBindingElement" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateMutualCertificateBindingElement">
@@ -600,7 +654,6 @@
         <Parameter Name="version" Type="System.ServiceModel.MessageSecurityVersion" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the version is WSSecurity10, then the binding element is configured so that the client request is signed by its certificate and encrypted with the server certificate. </para>
@@ -613,6 +666,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an asymmetric security binding element that is configured to require certificate-based client authentication as well as certificate-based server authentication.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.SecurityBindingElement" /> object.</para>
+        </returns>
         <param name="version">
           <attribution license="cc4" from="Microsoft" modified="false" />The message security version.</param>
       </Docs>
@@ -632,7 +689,6 @@
         <Parameter Name="allowSerializedSigningTokenOnReply" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="allowSerializedSigningTokenOnReply" /> parameter, when true, enables interoperability with older versions of Web Services Enhancements (WSE).</para>
@@ -644,6 +700,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an asymmetric security binding element that is configured to require certificate-based client authentication as well as certificate-based server authentication.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.SecurityBindingElement" /> object.</para>
+        </returns>
         <param name="version">
           <attribution license="cc4" from="Microsoft" modified="false" />The message security version.</param>
         <param name="allowSerializedSigningTokenOnReply">
@@ -662,12 +722,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an asymmetric security binding element that is configured to require certificate-based client authentication as well as certificate-based server authentication. This authentication mode can be used to secure duplex message-exchange patterns and requires the service to be configured with the client certificate out of band.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Channels.AsymmetricSecurityBindingElement" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateMutualCertificateDuplexBindingElement">
@@ -684,7 +747,6 @@
         <Parameter Name="version" Type="System.ServiceModel.MessageSecurityVersion" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -695,6 +757,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an asymmetric security binding element that is configured to require certificate-based client authentication as well as certificate-based server authentication. This authentication mode can be used to secure duplex message exchange patterns and requires the service to be configured with the client certificate out of band.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Channels.AsymmetricSecurityBindingElement" /> object.</para>
+        </returns>
         <param name="version">
           <attribution license="cc4" from="Microsoft" modified="false" />The message security version.</param>
       </Docs>
@@ -714,7 +780,6 @@
       </Parameters>
       <Docs>
         <param name="binding">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The binding element is configured to use session-based security context tokens.</para>
@@ -726,6 +791,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric security binding element that is configured to establish a secure conversation between the client and service. The security context token issued at the end of the secure conversation handshake is used to secure the messages. The bootstrap security binding element specifies how the secure conversation handshake messages are secured.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.SecurityBindingElement" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateSecureConversationBindingElement">
@@ -744,7 +813,6 @@
       </Parameters>
       <Docs>
         <param name="binding">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="requireCancellation" /> is false, cookie-based security context tokens are issued; otherwise, session-based security context tokens are issued.</para>
@@ -759,6 +827,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric security binding element that is configured to establish a secure conversation between the client and service. The security context token issued at the end of the secure conversation handshake is used to secure the messages.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.SecurityBindingElement" /> object.</para>
+        </returns>
         <param name="requireCancellation">
           <attribution license="cc4" from="Microsoft" modified="false" />true if cancellation is required; otherwise, false. Setting this parameter to false enables a security context token that is useful in Web farm scenarios, because in this mode the session state is encoded inside the established security context token instead of being kept in the server memory.</param>
       </Docs>
@@ -781,7 +853,6 @@
       <Docs>
         <param name="binding">To be added.</param>
         <param name="protectionRequirements">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="bootstrapProtectionRequirements" /> parameter enables customization of how the messages exchanged as part of the secure conversation handshake are secured.</para>
@@ -796,6 +867,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric security binding element that is configured to establish a secure conversation between the client and service. The security context token issued at the end of the secure conversation handshake is used to secure the messages. The bootstrap security binding element specifies how the secure conversation handshake messages are secured.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.SecurityBindingElement" /> object.</para>
+        </returns>
         <param name="requireCancellation">
           <attribution license="cc4" from="Microsoft" modified="false" />true if cancellation is required; otherwise, false. Setting this parameter to false enables a security context token that is useful in Web farm scenarios, because in this mode the session state is encoded inside the established security context token instead of being kept in the server memory.</param>
       </Docs>
@@ -814,7 +889,6 @@
         <Parameter Name="requireClientCertificate" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The security context token issued after the SSL negotiation is cookie based.</para>
@@ -823,6 +897,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric security binding element that is configured to do SOAP-level SSL negotiation between the client and server, noting whether a client certificate is required.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.SymmetricSecurityBindingElement" /> that holds the new binding.</para>
+        </returns>
         <param name="requireClientCertificate">
           <attribution license="cc4" from="Microsoft" modified="false" />true if a client certificate is required during the SSL negotiation.</param>
       </Docs>
@@ -842,7 +920,6 @@
         <Parameter Name="requireCancellation" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The security context token issued after the SSL negotiation is session based is <paramref name="requireCancellation" /> is true; otherwise, it is cookie based.</para>
@@ -851,6 +928,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric security binding element that does SOAP SSL negotiation, noting whether a client certificate and cancellation is required.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.SymmetricSecurityBindingElement" /> that holds the new binding.</para>
+        </returns>
         <param name="requireClientCertificate">
           <attribution license="cc4" from="Microsoft" modified="false" />true if a client certificate is required during the SSL negotiation.</param>
         <param name="requireCancellation">
@@ -869,7 +950,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The security context token issued at the end of the SSPI negotiation is cookie based.</para>
@@ -878,6 +958,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric security binding element that does SOAP SSPI negotiation based on the Negotiate authentication package.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.SymmetricSecurityBindingElement" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateSspiNegotiationBindingElement">
@@ -894,7 +978,6 @@
         <Parameter Name="requireCancellation" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="requireCancellation" /> is false, the security context token issued at the end of the SSPI negotiation is cookie based; otherwise, it is session based.</para>
@@ -903,6 +986,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric security binding element that does SOAP SSPI negotiation based on the Negotiate authentication package.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.SymmetricSecurityBindingElement" /> object.</para>
+        </returns>
         <param name="requireCancellation">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies whether cancellation is required. Setting it to false enables a security context token that is useful in Web farm scenarios, because in this mode the session state is encoded inside the established security context token instead of being kept in the server memory.</param>
       </Docs>
@@ -919,7 +1006,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The security context token issued at the end of SSPI negotiation is cookie based.</para>
@@ -930,6 +1016,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a security binding element that is configured for client authentication based on SOAP SSPI negotiation using the Negotiate authentication package. The binding element requires the transport to provide server authentication and message protection (for example, HTTPS).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.TransportSecurityBindingElement" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateSspiNegotiationOverTransportBindingElement">
@@ -946,7 +1036,6 @@
         <Parameter Name="requireCancellation" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="requireCancellation" /> is false, cookie-based security context tokens are issued; otherwise, session-based security context tokens are issued.</para>
@@ -957,6 +1046,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a security binding element that is configured for client authentication based on SOAP SSPI negotiation using the Negotiate authentication package. The binding element requires the transport to provide server authentication and message protection (for example, HTTPS).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.TransportSecurityBindingElement" /> object.</para>
+        </returns>
         <param name="requireCancellation">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies whether cancellation is required. Setting it to false enables a security context token that is useful in Web farm scenarios, because in this mode the session state is encoded inside the established security context token instead of being kept in the server memory.</param>
       </Docs>
@@ -973,7 +1066,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The server certificate must be configured out of band at the client.</para>
@@ -982,6 +1074,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric security binding element that is configured to require user name- and password-based client authentication and certificate-based server authentication. The created binding element requires the client to be configured with a service certificate that is out-of-band before opening a communication channel with a service.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.SymmetricSecurityBindingElement" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateUserNameForSslBindingElement">
@@ -996,7 +1092,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The security context token issued at the end of SSPI negotiation is cookie based. </para>
@@ -1006,6 +1101,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric security binding element that is configured to require user name- and password-based client authentication and certificate-based server authentication. The client authenticates the server using the SOAP-level SSL protocol.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.SymmetricSecurityBindingElement" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateUserNameForSslBindingElement">
@@ -1022,7 +1121,6 @@
         <Parameter Name="requireCancellation" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="requireCancellation" /> is false, stateful security context tokens are issued; otherwise, stateless security context tokens are issued.</para>
@@ -1032,6 +1130,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric security binding element that is configured to require user name- and password-based client authentication and certificate-based server authentication. The client authenticates the server using the SOAP-level SSL protocol.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.SymmetricSecurityBindingElement" /> object.</para>
+        </returns>
         <param name="requireCancellation">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies whether cancellation is required. Setting it to false enables a security context token that is useful in Web farm scenarios, because in this mode the session state is encoded inside the established security context token instead of being kept in the server memory.</param>
       </Docs>
@@ -1048,7 +1150,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The created binding has <see cref="P:System.ServiceModel.Channels.SecurityBindingElement.IncludeTimestamp" /> set to true. The <see cref="T:System.ServiceModel.Channels.LocalClientSecuritySettings" /> object returned from <see cref="P:System.ServiceModel.Channels.SecurityBindingElement.LocalClientSettings" /> has its <see cref="P:System.ServiceModel.Channels.LocalClientSecuritySettings.DetectReplays" /> property set to false.</para>
@@ -1058,6 +1159,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a security binding element that is configured for client authentication based on a user name and password sent as part of the SOAP message. The binding element requires the transport to provide server authentication and message protection (for example, HTTPS).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.TransportSecurityBindingElement" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DefaultAlgorithmSuite">
@@ -1130,7 +1235,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method gets the specified object from the base class, or from one of that class's ancestors. The object returned is usually a collection of properties, for example, an object that implements <see cref="T:System.ServiceModel.Channels.ISecurityCapabilities" />. </para>
@@ -1140,6 +1244,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a specified object using the specified <see cref="T:System.ServiceModel.Channels.BindingContext" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified object from the <see cref="T:System.ServiceModel.Channels.BindingContext" /> or null if the object is not found.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" />.</param>
         <typeparam name="T">
@@ -1455,7 +1563,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Information returned by <see cref="M:System.ServiceModel.Channels.SecurityBindingElement.ToString" /> includes the <see cref="P:System.ServiceModel.Channels.SecurityBindingElement.DefaultAlgorithmSuite" />, <see cref="P:System.ServiceModel.Channels.SecurityBindingElement.EndpointSupportingTokenParameters" />, <see cref="P:System.ServiceModel.Channels.SecurityBindingElement.IncludeTimestamp" />, <see cref="P:System.ServiceModel.Channels.SecurityBindingElement.KeyEntropyMode" />, <see cref="P:System.ServiceModel.Channels.SecurityBindingElement.OptionalEndpointSupportingTokenParameters" />, <see cref="P:System.ServiceModel.Channels.SecurityBindingElement.SecurityHeaderLayout" />, and <see cref="P:System.ServiceModel.Channels.SecurityBindingElement.OperationSupportingTokenParameters" /> values of the current instance.</para>
@@ -1464,6 +1571,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a description of this class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A description of the current <see cref="T:System.ServiceModel.Channels.SecurityBindingElement" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/SslStreamSecurityBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/SslStreamSecurityBindingElement.xml
index 344d3cd64ba..d5e7bed487e 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/SslStreamSecurityBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/SslStreamSecurityBindingElement.xml
@@ -194,7 +194,6 @@ namespace ServiceNamespace
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates a channel factory, which is used to create a channel that processes outgoing messages for this binding.</para>
@@ -203,6 +202,10 @@ namespace ServiceNamespace
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel factory of a specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.serviceModel.Channels.IChannelFactory" /> object that represents the channel factory of type <paramref name="TChannel" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.serviceModel.Channels.BindingContext" />.</param>
         <typeparam name="TChannel">
@@ -231,7 +234,6 @@ namespace ServiceNamespace
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates a channel listener, which is used to create a channel that processes incoming messages for this binding.</para>
@@ -240,6 +242,10 @@ namespace ServiceNamespace
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel listener of a specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.serviceModel.Channels.IChannelListener" /> object that represents a channel listener of type <paramref name="TChannel" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.serviceModel.Channels.BindingContext" />.</param>
         <typeparam name="TChannel">
@@ -260,7 +266,6 @@ namespace ServiceNamespace
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called when opening the client channel factory and provides a custom implementation of the <see cref="T:System.ServiceModel.Channels.StreamUpgradeProvider" /> abstract class.</para>
@@ -270,6 +275,10 @@ namespace ServiceNamespace
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance on the client of the <see cref="T:System.ServiceModel.Channels.StreamUpgradeProvider" /> based on the channel context provided.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the <see cref="T:System.ServiceModel.Channels.StreamUpgradeProvider" />. </para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> for the entire channel stack.</param>
       </Docs>
@@ -288,7 +297,6 @@ namespace ServiceNamespace
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called when opening the service and provides a custom implementation of the <see cref="T:System.ServiceModel.Channels.StreamUpgradeProvider" /> abstract class.</para>
@@ -298,6 +306,10 @@ namespace ServiceNamespace
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance on the server of the <see cref="T:System.ServiceModel.Channels.StreamUpgradeProvider" /> based on the channel context provided.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the <see cref="T:System.ServiceModel.Channels.StreamUpgradeProvider" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> for the entire channel stack.</param>
       </Docs>
@@ -319,7 +331,6 @@ namespace ServiceNamespace
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You should call this method before trying to create a channel factory.</para>
@@ -328,6 +339,10 @@ namespace ServiceNamespace
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether a channel factory of the specified type can be built.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a channel factory of the specified type can be built; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" />.</param>
         <typeparam name="TChannel">
@@ -356,7 +371,6 @@ namespace ServiceNamespace
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You should call this method before trying to create a channel listener.</para>
@@ -365,6 +379,10 @@ namespace ServiceNamespace
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether a channel listener of the specified type can be built.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a channel listener of the specified type can be built; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.serviceModel.Channels.BindingContext" />.</param>
         <typeparam name="TChannel">
@@ -383,12 +401,15 @@ namespace ServiceNamespace
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance that is a copy of the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.SslStreamSecurityBindingElement" /> instance that is a copy of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetProperty&lt;T&gt;">
@@ -412,7 +433,6 @@ namespace ServiceNamespace
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method gets the specified object from the base class or from one of that class's ancestors. The object returned is usually a collection of properties, for example, an object that implements <see cref="T:System.ServiceModel.Channels.ISecurityCapabilities" />.</para>
@@ -421,6 +441,10 @@ namespace ServiceNamespace
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a specified object from the <see cref="T:System.ServiceModel.Channels.BindingContext" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The  object of type <paramref name="T" />from the <see cref="T:System.ServiceModel.Channels.BindingContext" />, or null if the object is not found.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ServiceModel.Channels.BindingContext" />.</param>
         <typeparam name="T">
@@ -439,7 +463,6 @@ namespace ServiceNamespace
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is used to generate WSDL for the associated service.</para>
@@ -448,6 +471,10 @@ namespace ServiceNamespace
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Xml.XmlElement" /> that represents the transport token used in the security binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlElement" /> that represents the transport token used in the security binding.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IdentityVerifier">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/StreamSecurityUpgradeAcceptor.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/StreamSecurityUpgradeAcceptor.xml
index 1faa182b620..8317be4fc48 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/StreamSecurityUpgradeAcceptor.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/StreamSecurityUpgradeAcceptor.xml
@@ -50,7 +50,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This information is useful for implementing a stream-level authentication mechanism based on the identities provided in the security context.</para>
@@ -59,6 +58,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the security message property provided on the stream for performing custom security negotiation based on the information provided in the security context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the <see cref="T:System.ServiceModel.Security.SecurityMessageProperty" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/StreamSecurityUpgradeInitiator.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/StreamSecurityUpgradeInitiator.xml
index add0fcf7ae3..ea3b80fe3af 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/StreamSecurityUpgradeInitiator.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/StreamSecurityUpgradeInitiator.xml
@@ -50,7 +50,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This information is useful for implementing a stream-level authentication mechanism based on the identities provided in the security context.</para>
@@ -59,6 +58,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the security message property provided on the stream for performing custom security negotiation based on the information provided in the security context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the <see cref="T:System.ServiceModel.Security.SecurityMessageProperty" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/StreamUpgradeAcceptor.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/StreamUpgradeAcceptor.xml
index 8a95295973b..bed0fe0f365 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/StreamUpgradeAcceptor.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/StreamUpgradeAcceptor.xml
@@ -53,7 +53,6 @@
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to wrap the existing transport stream by providing additional capabilities; for example, a compressing stream.</para>
@@ -62,6 +61,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Upgrades the transport stream and returns the upgraded stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the upgraded stream.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream to be upgraded.</param>
       </Docs>
@@ -82,7 +85,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information, see the remarks for <see cref="M:System.ServiceModel.Channels.StreamUpgradeAcceptor.AcceptUpgrade(System.IO.Stream)" />.</para>
@@ -91,6 +93,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronous version of <see cref="M:System.ServiceModel.Channels.StreamUpgradeAcceptor.AcceptUpgrade(System.IO.Stream)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a result code that is passed into EndAcceptUpgrade to access the upgraded stream.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream to be upgraded.</param>
         <param name="callback">
@@ -113,7 +119,6 @@
         <Parameter Name="contentType" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The developer can inspect the requested content type and determine whether the resulting upgrade can be performed by this upgrade acceptor. This content type comes from the GetNextUpgrade method on the matching upgrade initiator.</para>
@@ -122,6 +127,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the upgrade requested is supported by this upgrade acceptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this kind of upgrade is supported; otherwise, false. </para>
+        </returns>
         <param name="contentType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of content to be checked. </param>
       </Docs>
@@ -140,7 +149,6 @@
         <Parameter Name="result" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information, see the remarks in <see cref="M:System.ServiceModel.Channels.StreamUpgradeAcceptor.AcceptUpgrade(System.IO.Stream)" />.</para>
@@ -149,6 +157,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronous version of <see cref="M:System.ServiceModel.Channels.StreamUpgradeAcceptor.AcceptUpgrade(System.IO.Stream)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the upgraded stream.</para>
+        </returns>
         <param name="result">
           <attribution license="cc4" from="Microsoft" modified="false" />The IAsyncResult returned from BeginAcceptUpgrade.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/StreamUpgradeBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/StreamUpgradeBindingElement.xml
index 03d3773c282..9bb56b18c16 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/StreamUpgradeBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/StreamUpgradeBindingElement.xml
@@ -83,7 +83,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called when opening the client channel factory and provides a custom implementation of the <see cref="T:System.ServiceModel.Channels.StreamUpgradeProvider" /> abstract class. </para>
@@ -93,6 +92,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance on the client of the <see cref="T:System.ServiceModel.Channels.StreamUpgradeProvider" /> based on the channel context provided.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the <see cref="T:System.ServiceModel.Channels.StreamUpgradeProvider" />. </para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> for the entire channel stack.</param>
       </Docs>
@@ -111,7 +114,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called when opening the service and provides a custom implementation of the <see cref="T:System.ServiceModel.Channels.StreamUpgradeProvider" /> abstract class. </para>
@@ -121,6 +123,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance on the server of the <see cref="T:System.ServiceModel.Channels.StreamUpgradeProvider" /> based on the channel context provided.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the <see cref="T:System.ServiceModel.Channels.StreamUpgradeProvider" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> for the entire channel stack.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/StreamUpgradeInitiator.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/StreamUpgradeInitiator.xml
index aa51fbfc028..c1e3186444d 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/StreamUpgradeInitiator.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/StreamUpgradeInitiator.xml
@@ -54,7 +54,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method calls <see cref="M:System.ServiceModel.Channels.StreamUpgradeInitiator.InitiateUpgrade(System.IO.Stream)" /> and returns. </para>
@@ -63,6 +62,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This abstract method can be implemented to do asynchronous processing that initiates an upgrade.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an <see cref="T:System.IAsyncResult" /> to be passed into the <see cref="M:System.ServiceModel.Channels.StreamUpgradeInitiator.EndInitiateUpgrade(System.IAsyncResult)" /> method.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream to be upgraded.</param>
         <param name="callback">
@@ -85,7 +88,6 @@
         <Parameter Name="result" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information about using this method, see the remarks in <see cref="M:System.ServiceModel.Channels.StreamUpgradeInitiator.InitiateUpgrade(System.IO.Stream)" />.</para>
@@ -94,6 +96,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is the asynchronous callback method that is called after <see cref="M:System.ServiceModel.Channels.StreamUpgradeInitiator.BeginInitiateUpgrade(System.IO.Stream,System.AsyncCallback,System.Object)" /> has completed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the upgraded stream.</para>
+        </returns>
         <param name="result">
           <attribution license="cc4" from="Microsoft" modified="false" />The IAsyncResult returned from the <see cref="M:System.ServiceModel.Channels.StreamUpgradeInitiator.BeginInitiateUpgrade(System.IO.Stream,System.AsyncCallback,System.Object)" /> method. </param>
       </Docs>
@@ -110,7 +116,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns a set of upgrade content types supported by the upgrade provider in the order in which they are expected. Upgrade providers that support a single upgrade return only a single value. Upgrade providers that support multiple upgrades return the values in order (for example, compression content type followed by the security content type).</para>
@@ -119,6 +124,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the content type of the next upgrade to be performed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the content type of the next upgrade.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InitiateUpgrade">
@@ -135,7 +144,6 @@
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be called multiple times for each upgrade supported by the upgrade provider. For example, an upgrade provider that supports compression and security would call this method twice: first to upgrade the default transport streaming for compression, and second to upgrade the security. Subsequent calls to this method should pass in the upgrade stream from the previous call.</para>
@@ -144,6 +152,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initiates the upgrade of the stream by requesting the other end of its connection to upgrade the channel transport layer. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the upgraded stream.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream to be upgraded.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/StreamUpgradeProvider.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/StreamUpgradeProvider.xml
index b11bd055bfb..d93d6642541 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/StreamUpgradeProvider.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/StreamUpgradeProvider.xml
@@ -92,7 +92,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates the associated UpgradeAcceptor for this upgrade provider that can accept upgrade requests from the matching UpgradeInitiator.</para>
@@ -101,6 +100,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.ServiceModel.Channels.StreamUpgradeAcceptor" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an instance of <see cref="T:System.ServiceModel.Channels.StreamUpgradeAcceptor" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateUpgradeInitiator">
@@ -120,7 +123,6 @@
       <Docs>
         <param name="remoteAddress">To be added.</param>
         <param name="via">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates the associated <see cref="T:System.ServiceModel.Channels.StreamUpgradeInitiator" /> for this upgrade provider that creates upgrade requests for the matching <see cref="T:System.ServiceModel.Channels.StreamUpgradeAcceptor" /> at the endpoint provided.</para>
@@ -129,6 +131,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of <see cref="T:System.ServiceModel.Channels.StreamUpgradeInitiator" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an instance of <see cref="T:System.ServiceModel.Channels.StreamUpgradeInitiator" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DefaultCloseTimeout">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/SymmetricSecurityBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/SymmetricSecurityBindingElement.xml
index 3f2d3d6a826..0854c9e0612 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/SymmetricSecurityBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/SymmetricSecurityBindingElement.xml
@@ -151,7 +151,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This creates a complete copy of the current binding element object tree, also called a deep clone. A deep clone of an object creates a copy of the object and a copy of everything directly or indirectly referenced by that object. This can also be described as copying the entire object graph. Returning a deep clone enables the runtime to support the case in which multiple custom bindings share a custom binding element. If a deep clone is not returned, the run-time behavior is undefined. </para>
@@ -161,6 +160,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of this class initialized from the current one.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.BindingElement" /> object with property values equal to those of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetProperty&lt;T&gt;">
@@ -184,7 +187,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method gets the specified object from the base class or from one of that class's ancestors. The object returned is usually a collection of properties, for example an object that implements <see cref="T:System.ServiceModel.Channels.ISecurityCapabilities" />.</para>
@@ -193,6 +195,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a specified object from the <see cref="T:System.ServiceModel.Channels.BindingContext" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified object of type <paramref name="T" /> from the <see cref="T:System.ServiceModel.Channels.BindingContext" />, or null if the object is not found.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ServiceModel.Channels.BindingContext" />.</param>
         <typeparam name="T">
@@ -334,7 +340,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Information returned by <see cref="M:System.ServiceModel.Channels.SymmetricSecurityBindingElement.ToString" /> includes the <see cref="P:System.ServiceModel.Channels.SymmetricSecurityBindingElement.MessageProtectionOrder" />, <see cref="P:System.ServiceModel.Channels.SymmetricSecurityBindingElement.RequireSignatureConfirmation" />, and <see cref="P:System.ServiceModel.Channels.SymmetricSecurityBindingElement.ProtectionTokenParameters" /> values of the current instance.</para>
@@ -343,6 +348,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents this <see cref="T:System.ServiceModel.Channels.SymmetricSecurityBindingElement" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents this <see cref="T:System.ServiceModel.Channels.SymmetricSecurityBindingElement" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/TcpTransportBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/TcpTransportBindingElement.xml
index 75556aa5967..f5d7e9f3187 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/TcpTransportBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/TcpTransportBindingElement.xml
@@ -81,7 +81,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to create a channel factory for sending messages based on the configuration of the TCP binding element.</para>
@@ -90,6 +89,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel factory that can be used to create a channel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a channel factory of the specified type.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.Channels.BindingContext" /> members that describe bindings, behaviors, contracts, and other information required to create the channel factory.</param>
@@ -119,7 +122,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to create a channel listener for receiving messages based on the configuration of the TCP binding element.</para>
@@ -128,6 +130,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel listener of the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a channel listener of the specified type.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.Channels.BindingContext" /> members that describe bindings, behaviors, contracts, and other information required to create the channel factory.</param>
@@ -147,12 +153,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the current binding element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a copy of the current binding element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ConnectionPoolSettings">
@@ -195,7 +204,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method gets the specified object from the base class, or from one of that class's ancestors. The object returned is usually a collection of properties, for example, an object that implements <see cref="T:System.ServiceModel.Channels.ISecurityCapabilities" />.</para>
@@ -204,6 +212,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a specified object from the <see cref="T:System.ServiceModel.Channels.BindingContext" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified object from the <see cref="T:System.ServiceModel.Channels.BindingContext" />, or null if the object is not found.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ServiceModel.Channels.BindingContext" />.</param>
         <typeparam name="T">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/TextMessageEncodingBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/TextMessageEncodingBindingElement.xml
index 9ccf8a94984..c6f239cef02 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/TextMessageEncodingBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/TextMessageEncodingBindingElement.xml
@@ -91,12 +91,15 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds the channel factory stack on the client that creates a specified type of channel for a specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Channels.IChannelFactory`1" /> of type <paramref name="TChannel" /> for the specified context.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> for the channel.</param>
         <typeparam name="TChannel">
@@ -125,12 +128,15 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds the channel listener on the service that accepts a specified type of channel for a specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Channels.IChannelListener`1" /> of type <paramref name="TChannel" /> for the specified context.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> for the listener.</param>
         <typeparam name="TChannel">
@@ -159,12 +165,15 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current binding can build a listener for a specified type of channel and context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified channel listener stack can be build on the service; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> for the listener.</param>
         <typeparam name="TChannel">
@@ -183,7 +192,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This creates a complete copy of the current binding element object tree, also called a deep clone. A deep clone of an object creates a copy of the object and a copy of everything directly or indirectly referenced by that object. (This is called copying the entire object graph.) Returning a deep clone enables the runtime to support the case in which multiple custom bindings share a custom binding element. If a deep clone is not returned, the run-time behavior is undefined. A shallow clone of an object, by contrast, is a copy of the object only. If the object contains references to other objects, the shallow copy does not create copies of the referred objects; instead, it copies only the references to the original objects.</para>
@@ -192,6 +200,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Channels.TextMessageEncodingBindingElement" /> object initialized from the current one.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.TextMessageEncodingBindingElement" /> object with property values equal to those of the current element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateMessageEncoderFactory">
@@ -206,7 +218,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.ServiceModel.Channels.MessageEncoder" /> objects that the factory produces can read messages from a stream and write them to a stream for specific types of message encoding.</para>
@@ -215,6 +226,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a factory for text message encoders that employs the message version and character encoding specified by the current encoding binding element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.MessageEncoderFactory" /> that this factory creates.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetProperty&lt;T&gt;">
@@ -238,7 +253,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this to request a typed object for setting properties or getting status from the appropriate layer in the binding element stack. If a layer supports returning the requested object, it returns it. If not, it delegates the call down to the next layer in the stack. If it gets to the bottom of the stack and no binding element layer supported the requested object, then the method returns null.</para>
@@ -247,6 +261,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a typed object requested, if present, from the appropriate layer in the binding element stack.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The typed object <paramref name="T" /> requested if it is present or null if it is not.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> for the binding element.</param>
         <typeparam name="T">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/TransactionFlowBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/TransactionFlowBindingElement.xml
index cb71f0f3675..cddb1ed63a3 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/TransactionFlowBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/TransactionFlowBindingElement.xml
@@ -79,7 +79,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates a channel factory that can be used to make outgoing channels of the specified type. This method is called by the infrastructure when building the channel stack. You should use it in your code only when you implement a custom binding element.</para>
@@ -88,6 +87,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a channel factory for producing channels of a specified type from a binding context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.IChannelFactory`1" /> of type <paramref name="TChannel" /> initialized from <paramref name="context" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> that should be used to build the channel factory.</param>
         <typeparam name="TChannel">
@@ -116,7 +119,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates a channel listener to receive messages for this binding.</para>
@@ -126,6 +128,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a channel listener for accepting channels of a specified type from the binding context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.IChannelListener`1" /> of type <paramref name="TChannel" /> initialized from <paramref name="context" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> that should be used to build the channel listener.</param>
         <typeparam name="TChannel">
@@ -149,7 +155,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You should call this method to check that the channel factory for channels of type <paramref name="TChannel" /> can be built for the specified <paramref name="context" />, before attempting to actually build the factory. Note that <see cref="M:System.ServiceModel.Channels.TransactionFlowBindingElement.BuildChannelFactory``1(System.ServiceModel.Channels.BindingContext)" /> throws an exception if it cannot build a channel factory for the specified channel type.</para>
@@ -158,6 +163,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the specified binding context can build a channel factory for producing channels of a specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a channel factory for the specified type of channel can be built from <paramref name="context" />; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> that should be used to determine if a channel factory can be built.</param>
         <typeparam name="TChannel">
@@ -186,7 +195,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You should call this method to check that the channel listener for channels of type of <paramref name="TChannel" /> can be built for the specified <paramref name="context" />, before attempting to actually build the listener. Note that <see cref="M:System.ServiceModel.Channels.TransactionFlowBindingElement.BuildChannelListener``1(System.ServiceModel.Channels.BindingContext)" /> throws an exception if it cannot build a channel listener for the specified channel type.</para>
@@ -195,6 +203,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the specified binding context can build a channel listener for accepting channels of a specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a channel listener for the specified type of channel can be built from <paramref name="context" />; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> that should be used to determine if a channel listener can be built.</param>
         <typeparam name="TChannel">
@@ -213,7 +225,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates a deep clone of this binding element. A deep clone of an object creates a copy of the object and a copy of everything directly or indirectly referenced by that object. (This is also called copying the entire object graph.) A shallow clone of an object, by contrast, is a copy of the object only. If the object contains references to other objects, the shallow copy does not create copies of the referred objects; instead, it copies only the references to the original objects.</para>
@@ -222,6 +233,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplicate of this element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.BindingElement" /> that is a duplicate of this element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetProperty&lt;T&gt;">
@@ -245,7 +260,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use this method to retrieve capabilities, requirements and parameters from the binding element stack. If a binding element supports returning the requested object, it returns it. If not, it delegates the call down to the next binding element in the stack. If it gets to the bottom of the stack and no binding element supported the requested object, this method returns null.</para>
@@ -254,6 +268,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the typed object requested, if present, from the appropriate layer in the binding stack.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The typed object <paramref name="T" /> requested if it is present; null if it is not. </para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> </param>
         <typeparam name="T">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/TransportBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/TransportBindingElement.xml
index c2f4889492d..647f976d7e1 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/TransportBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/TransportBindingElement.xml
@@ -122,7 +122,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method receives a binding context as an input parameter, which represents the stack of binding elements. This method gets the specified object directly, delegates the inquiry to the next lower binding element in the stack, or a combination of the two. It can modify the context if it delegates the inquiry. Each binding element in the stack can repeat this process, if it has been delegated to, until the bottom of the stack is reached. The object returned is usually a collection of properties.</para>
@@ -133,6 +132,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a property from the specified <see cref="T:System.ServiceModel.Channels.BindingContext" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The property from the specified <see cref="T:System.ServiceModel.Channels.BindingContext" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ServiceModel.Channels.BindingContext" />.</param>
         <typeparam name="T">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/TransportSecurityBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/TransportSecurityBindingElement.xml
index 049b2df6e23..58260e0cef3 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/TransportSecurityBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/TransportSecurityBindingElement.xml
@@ -132,7 +132,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This creates a complete copy of the current binding element object tree, also called a deep clone. A deep clone of an object creates a copy of the object and a copy of everything directly or indirectly referenced by that object. (This can also be described as copying the entire object graph.) Returning a deep clone enables the runtime to support the case in which multiple custom bindings share a custom binding element. If a deep clone is not returned, the run-time behavior is undefined. </para>
@@ -142,6 +141,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Channels.BindingElement" /> object initialized from the current class. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.BindingElement" /> object with property values equal to those of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetProperty&lt;T&gt;">
@@ -165,7 +168,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method gets the specified object from the base class or from one of that class's ancestors. The object returned is usually a collection of properties, for example an object that implements <see cref="T:System.ServiceModel.Channels.ISecurityCapabilities" />.</para>
@@ -174,6 +176,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a property from the specified <see cref="T:System.ServiceModel.Channels.BindingContext" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The property from the specified <see cref="T:System.ServiceModel.Channels.BindingContext" /> or null if the object is not found.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ServiceModel.Channels.BindingContext" />.</param>
         <typeparam name="T">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/UnderstoodHeaders.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/UnderstoodHeaders.xml
index 028b023aac5..c73011a07f8 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/UnderstoodHeaders.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/UnderstoodHeaders.xml
@@ -62,12 +62,15 @@
       </Parameters>
       <Docs>
         <param name="header">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies whether the specified <see cref="T:System.ServiceModel.Channels.MessageHeaderInfo" /> is present in this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.ServiceModel.Channels.MessageHeaderInfo" /> is present in this collection; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetEnumerator">
@@ -82,12 +85,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> object that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Remove">
@@ -124,12 +130,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> object that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/UseManagedPresentationBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/UseManagedPresentationBindingElement.xml
index 6b1abd76690..297b1c29462 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/UseManagedPresentationBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/UseManagedPresentationBindingElement.xml
@@ -53,12 +53,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the current binding element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.BindingElement" /> that is a copy of the current element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetProperty&lt;T&gt;">
@@ -82,7 +85,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this to request a typed object such as an interface for setting properties or getting status from the appropriate layer in the binding stack. If a layer supports returning the requested object, it returns it. If not, it delegates the call down to the next layer in the stack. If it gets to the bottom of the stack and no binding layer supported the requested object, then the method returns null.</para>
@@ -91,6 +93,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a typed object requested, if present, from the appropriate layer in the binding stack.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The typed object <paramref name="T" /> requested if it is present or null if it is not.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> that provides context for the binding element.</param>
         <typeparam name="T">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/WebSocketTransportSettings.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/WebSocketTransportSettings.xml
index a6e9504d5ae..e510b7c3e24 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/WebSocketTransportSettings.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/WebSocketTransportSettings.xml
@@ -146,12 +146,15 @@
         <Parameter Name="other" Type="System.ServiceModel.Channels.WebSocketTransportSettings" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified web socket transport settings object is equal with the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified object is equal with the current object; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The web socket transport settings object to compare with the current object.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/WindowsStreamSecurityBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/WindowsStreamSecurityBindingElement.xml
index 7805a492918..f5cd338052e 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/WindowsStreamSecurityBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Channels/WindowsStreamSecurityBindingElement.xml
@@ -106,7 +106,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates a channel factory, which is used to create a channel that processes outgoing messages for this binding.</para>
@@ -115,6 +114,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel factory that can be used to create a channel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a channel factory of the specified type. This method adds this class instance to the <see cref="P:System.ServiceModel.Channels.BindingContext.BindingParameters" /> and delegates to the build method <see cref="M:System.ServiceModel.Channels.BindingContext.BuildInnerChannelFactory``1" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.Channels.BindingContext" /> members that describe bindings, behaviors, contracts, and other information required to create the channel factory.</param>
@@ -144,7 +147,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates a channel listener, which is used to create a channel that processes incoming messages for this binding.</para>
@@ -153,6 +155,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel listener of the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a channel listener of the specified type. This method adds this class instance to the <see cref="P:System.ServiceModel.Channels.BindingContext.BindingParameters" /> and delegates to the build method <see cref="M:System.ServiceModel.Channels.BindingContext.BuildInnerChannelListener``1" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.Channels.BindingContext" /> members that describe bindings, behaviors, contracts, and other information required to create the channel listener.</param>
@@ -177,7 +183,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A channel factory is used to create a channel that processes outgoing messages for this binding. This method delegates to the <see cref="M:System.ServiceModel.Channels.BindingContext.CanBuildInnerChannelFactory``1" /> method.</para>
@@ -186,6 +191,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a channel factory of the specified type can be built.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a channel factory can be built; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The binding context.</param>
         <typeparam name="TChannel">
@@ -214,7 +223,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A channel listener is used to create a channel that processes incoming messages for this binding. This method delegates to the <see cref="M:System.ServiceModel.Channels.BindingContext.CanBuildInnerChannelListener``1" /> method.</para>
@@ -223,6 +231,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a channel listener of the specified type can be built.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a channel listener can be built; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> for the channel.</param>
         <typeparam name="TChannel">
@@ -241,12 +253,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new binding element from this instance of the class. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="T:System.ServiceModel.Channels.BindingElement" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetProperty&lt;T&gt;">
@@ -270,7 +286,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method receives a binding context as an input parameter, which represents the stack of binding elements. This method gets the specified object directly, delegates the inquiry to the next-lower binding element in the stack, or a combination of the two. It can modify the context if it delegates the inquiry. Each binding element in the stack can repeat this process, if it has been delegated to, until the bottom of the stack is reached. The object returned is usually a collection of properties.</para>
@@ -284,6 +299,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a specified object from the <see cref="T:System.ServiceModel.Channels.BindingContext" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified object from the <see cref="T:System.ServiceModel.Channels.BindingContext" /> or null if the object is not found.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ServiceModel.Channels.BindingContext" />.</param>
         <typeparam name="T">
@@ -302,7 +321,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is used to generate WSDL for the associated service.</para>
@@ -311,6 +329,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Xml.XmlElement" /> that represents the transport token used in the security binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlElement" /> that represents the transport token used in the policy generated by this binding.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ProtectionLevel">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/BehaviorExtensionElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/BehaviorExtensionElement.xml
index 20a6829c082..9ddf0e5ae59 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/BehaviorExtensionElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/BehaviorExtensionElement.xml
@@ -65,12 +65,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a behavior extension based on the current configuration settings.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The behavior extension.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/BindingCollectionElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/BindingCollectionElement.xml
index 200049a6532..54624119545 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/BindingCollectionElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/BindingCollectionElement.xml
@@ -105,12 +105,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a binding exists in the collection using the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the binding with the specified <paramref name="name" />; otherwise, false. </para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the binding to be located.</param>
       </Docs>
@@ -127,12 +130,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the default binding used.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.Binding" /> object that represents the default binding.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryAdd">
@@ -151,12 +157,15 @@
         <Parameter Name="config" Type="System.Configuration.Configuration" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified binding to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the operation completed successfully; otherwise, false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the binding to be added.</param>
         <param name="binding">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/BindingElementExtensionElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/BindingElementExtensionElement.xml
index 90ab0fc204a..bae89f3813b 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/BindingElementExtensionElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/BindingElementExtensionElement.xml
@@ -95,12 +95,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns a custom binding element object. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A custom <see cref="T:System.ServiceModel.Channels.BindingElement" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InitializeFrom">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/BindingsSection.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/BindingsSection.xml
index 9cbc714ca3b..afe09603907 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/BindingsSection.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/BindingsSection.xml
@@ -139,12 +139,15 @@
         <Parameter Name="config" Type="System.Configuration.Configuration" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the configuration setting of a section from the specified configuration file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Configuration.BindingsSection" /> with the settings retrieved from the specified file.</para>
+        </returns>
         <param name="config">
           <attribution license="cc4" from="Microsoft" modified="false" />A configuration file.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ClientCredentialsElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ClientCredentialsElement.xml
index e0a9baef333..e4aa303b55e 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ClientCredentialsElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ClientCredentialsElement.xml
@@ -114,12 +114,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a custom behavior based on the settings of this configuration element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A custom behavior based on the settings of this configuration element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HttpDigest">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/CustomBindingCollectionElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/CustomBindingCollectionElement.xml
index 45c23298793..02139a08ecc 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/CustomBindingCollectionElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/CustomBindingCollectionElement.xml
@@ -131,12 +131,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a specific binding exists in the collection using the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the binding with the specified <paramref name="name" />; otherwise, false. </para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the binding to be located.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/CustomBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/CustomBindingElement.xml
index 7214a98922d..97583f9ed69 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/CustomBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/CustomBindingElement.xml
@@ -148,12 +148,15 @@
         <Parameter Name="element" Type="System.ServiceModel.Configuration.BindingElementExtensionElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new behavior element to this section and returns a value indicating if the operation is successful.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the operation is successful; otherwise, false.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ServiceModel.Configuration.BindingElementExtensionElement" /> to be added.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/EndpointBehaviorElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/EndpointBehaviorElement.xml
index 0e8529bfef7..de77198dd2d 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/EndpointBehaviorElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/EndpointBehaviorElement.xml
@@ -94,12 +94,15 @@
         <Parameter Name="element" Type="System.ServiceModel.Configuration.BehaviorExtensionElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new behavior element to this section and returns a value indicating if the operation is successful.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the operation is successful; otherwise, false.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ServiceModel.Configuration.BehaviorExtensionElement" /> to be added.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/EndpointCollectionElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/EndpointCollectionElement.xml
index 9b5fb3ebfb1..972d8d5f384 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/EndpointCollectionElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/EndpointCollectionElement.xml
@@ -67,12 +67,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the service element in a configuration file contains an endpoint element with the same name as the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified string contains a specified element name; otherwise false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the key in a key/value pair that represents an endpoint element name and value.</param>
       </Docs>
@@ -127,12 +130,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented in a derived class, returns the default <see cref="T:System.ServiceModel.Configuration.StandardEndpointElement" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A service model standard endpoint element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryAdd">
@@ -151,12 +157,15 @@
         <Parameter Name="config" Type="System.Configuration.Configuration" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented in a derived class, adds the specified endpoint to the collection of service endpoints in a configuration file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the endpoint is added to the collection in the configuration file; otherwise, false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the service endpoint that contains the endpoint collection.</param>
         <param name="endpoint">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ExtensionElementCollection.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ExtensionElementCollection.xml
index 377b68b7633..08c7ff2f208 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ExtensionElementCollection.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ExtensionElementCollection.xml
@@ -115,12 +115,15 @@
         <Parameter Name="element" Type="System.Configuration.ConfigurationElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the element key for the specified configuration element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that acts as the key for the specified configuration element.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Configuration.ConfigurationElement" /> to return the key for.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/HttpTransportElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/HttpTransportElement.xml
index 3ded7244273..310dd7b4b86 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/HttpTransportElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/HttpTransportElement.xml
@@ -192,12 +192,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new transport binding element from this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created <see cref="T:System.ServiceModel.Channels.TransportBindingElement" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DecompressionEnabled">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/HttpsTransportElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/HttpsTransportElement.xml
index e5deed903b1..bebd2b6533d 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/HttpsTransportElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/HttpsTransportElement.xml
@@ -111,12 +111,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a binding element from the settings in this configuration element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.TransportBindingElement" /> whose properties are copied from the settings in this configuration element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InitializeFrom">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/MetadataElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/MetadataElement.xml
index e1ae7dc8162..007992a5b24 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/MetadataElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/MetadataElement.xml
@@ -46,12 +46,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads a collection of <see cref="T:System.ServiceModel.Description.IPolicyImportExtension" /> objects used to import custom policy assertions about bindings.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of <see cref="T:System.ServiceModel.Description.IPolicyImportExtension" /> objects used to import custom policy assertions about bindings.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="LoadWsdlImportExtensions">
@@ -66,12 +69,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads a collection of <see cref="T:System.ServiceModel.Description.IWsdlImportExtension" /> objects used to import custom WSDL information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of <see cref="T:System.ServiceModel.Description.IWsdlImportExtension" /> objects used to import custom WSDL information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="PolicyImporters">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/MexHttpBindingCollectionElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/MexHttpBindingCollectionElement.xml
index 3705bd5cf9b..082e257d404 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/MexHttpBindingCollectionElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/MexHttpBindingCollectionElement.xml
@@ -50,12 +50,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the default values of a configuration element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The default binding.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/MexHttpsBindingCollectionElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/MexHttpsBindingCollectionElement.xml
index c87c5ae9296..23602c1ca48 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/MexHttpsBindingCollectionElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/MexHttpsBindingCollectionElement.xml
@@ -50,12 +50,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the default values of a configuration element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The default binding.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/PeerTransportElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/PeerTransportElement.xml
index 85aebcded1f..6cf43e451b8 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/PeerTransportElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/PeerTransportElement.xml
@@ -68,12 +68,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a binding element from the settings in this configuration element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.BindingElement" /> whose properties are copied from the settings in this configuration element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ListenIPAddress">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/PnrpPeerResolverElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/PnrpPeerResolverElement.xml
index 3b5231a7965..10992e86ec6 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/PnrpPeerResolverElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/PnrpPeerResolverElement.xml
@@ -65,12 +65,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new custom binding element object whose properties are copied from the settings of this configuration element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A custom <see cref="T:System.ServiceModel.Channels.BindingElement" /> object.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/PrivacyNoticeElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/PrivacyNoticeElement.xml
index f97c433b3c5..1fb2ae517a8 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/PrivacyNoticeElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/PrivacyNoticeElement.xml
@@ -65,12 +65,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new a custom binding element object based on the setting of this configuration element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A custom <see cref="T:System.ServiceModel.Channels.BindingElement" /> object whose properties are based on the setting of this configuration element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Properties">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/SecurityElementBase.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/SecurityElementBase.xml
index 0ae781783c5..18563770f1c 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/SecurityElementBase.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/SecurityElementBase.xml
@@ -110,12 +110,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a custom binding element object from the setting of this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A custom <see cref="T:System.ServiceModel.Channels.BindingElement" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DefaultAlgorithmSuite">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ServiceBehaviorElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ServiceBehaviorElement.xml
index d889207ce7f..c9ccb3a091d 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ServiceBehaviorElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ServiceBehaviorElement.xml
@@ -94,12 +94,15 @@
         <Parameter Name="element" Type="System.ServiceModel.Configuration.BehaviorExtensionElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new behavior element to this section and returns a value indicating if the operation is successful.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the operation is successful; otherwise, false.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ServiceModel.Configuration.BehaviorExtensionElement" /> to be added.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ServiceCredentialsElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ServiceCredentialsElement.xml
index 751068d5ea3..7dd20492193 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ServiceCredentialsElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ServiceCredentialsElement.xml
@@ -114,12 +114,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a custom behavior based on the settings of this configuration element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A custom behavior based on the settings of this configuration element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IssuedTokenAuthentication">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ServiceMetadataEndpointElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ServiceMetadataEndpointElement.xml
index 4041b0d21d6..a67df06df2a 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ServiceMetadataEndpointElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ServiceMetadataEndpointElement.xml
@@ -49,12 +49,15 @@
       </Parameters>
       <Docs>
         <param name="contractDescription">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new service endpoint using the specified contract description.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A service endpoint.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="EndpointType">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ServiceModelConfigurationElementCollection`1.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ServiceModelConfigurationElementCollection`1.xml
index 3f34091d825..5cd6dd72338 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ServiceModelConfigurationElementCollection`1.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ServiceModelConfigurationElementCollection`1.xml
@@ -121,12 +121,15 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a boolean value that indicates whether this collection contains a configuration element with the specified key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains a configuration element with the specified key; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The configuration element to search for in the collection.</param>
       </Docs>
@@ -164,12 +167,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Configuration.ConfigurationElement" /> instance of type <paramref name="ConfigurationElementType" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Configuration.ConfigurationElement" /> instance of type <paramref name="ConfigurationElementType" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ElementName">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ServiceModelExtensionCollectionElement`1.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ServiceModelExtensionCollectionElement`1.xml
index f74d1a840b1..fcd9c904105 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ServiceModelExtensionCollectionElement`1.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ServiceModelExtensionCollectionElement`1.xml
@@ -128,12 +128,15 @@
         <Parameter Name="elementName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether this collection contains an element of the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains an element of the specified name; otherwise, false.</para>
+        </returns>
         <param name="elementName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the element to search for.</param>
       </Docs>
@@ -152,12 +155,15 @@
         <Parameter Name="elementType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether this collection contains an element of the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains an element of the specified type; otherwise, false.</para>
+        </returns>
         <param name="elementType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the element to search for.</param>
       </Docs>
@@ -240,12 +246,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IEnumerator" /> that iterates through a collection. This method cannot be inherited.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> object that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsModified">
@@ -260,7 +269,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method determines whether this object is written to the configuration file. If the return value is false, it is assumed that the configuration file represents the current state of the element. </para>
@@ -271,6 +279,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether this configuration element has been modified since it was last saved or loaded, when implemented in a derived class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the element has been modified; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Item">
@@ -328,12 +340,15 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether an unknown element is encountered during deserialization.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true when an unknown element is encountered while deserializing; otherwise, false.</para>
+        </returns>
         <param name="elementName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the unknown sub-element.</param>
         <param name="reader">
@@ -474,12 +489,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IEnumerator" /> that iterates through a collection. This method cannot be inherited.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the collection. </para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ServiceModelExtensionElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ServiceModelExtensionElement.xml
index d4cf6119db2..999dbcaeb0f 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ServiceModelExtensionElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ServiceModelExtensionElement.xml
@@ -88,12 +88,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that specifies whether this configuration element has been modified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this configuration element has been modified; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Reset">
@@ -134,12 +137,15 @@
         <Parameter Name="serializeCollectionKey" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes the contents of this configuration element to the configuration file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if any data was actually serialized; otherwise, false.</para>
+        </returns>
         <param name="writer">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlWriter" /> that is used to write to the configuration file.</param>
         <param name="serializeCollectionKey">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ServiceModelSectionGroup.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ServiceModelSectionGroup.xml
index 7ed4a3a015c..f7e969fecb4 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ServiceModelSectionGroup.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/ServiceModelSectionGroup.xml
@@ -177,12 +177,15 @@
         <Parameter Name="config" Type="System.Configuration.Configuration" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the system.ServiceModel configuration section group from the specified configuration file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Configuration.ServiceModelSectionGroup" /> that represents the system.ServiceModel settings in configuration.</para>
+        </returns>
         <param name="config">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Configuration.Configuration" /> that represents a configuration file.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/StandardBindingCollectionElement`2.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/StandardBindingCollectionElement`2.xml
index fd3404be4ab..79259514815 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/StandardBindingCollectionElement`2.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/StandardBindingCollectionElement`2.xml
@@ -125,12 +125,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a binding exists in the collection using the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the binding with the specified <paramref name="name" />; otherwise, false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the binding to be located.</param>
       </Docs>
@@ -147,12 +150,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the default binding used.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.Binding" /> object that represents the default binding.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Properties">
@@ -190,12 +196,15 @@
         <Parameter Name="config" Type="System.Configuration.Configuration" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified binding to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the binding can be added to this collection; otherwise, false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the binding to be added.</param>
         <param name="binding">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/StandardEndpointCollectionElement`2.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/StandardEndpointCollectionElement`2.xml
index ed5700388c1..1316da369c0 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/StandardEndpointCollectionElement`2.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/StandardEndpointCollectionElement`2.xml
@@ -82,12 +82,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether an element with the specified name exists in the collection of standard endpoint elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the endpoint collection of elements contains a match for the specified element name; otherwise, false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of an endpoint element.</param>
       </Docs>
@@ -147,12 +150,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a local instance of the <see cref="T:System.ServiceModel.Configuration.StandardEndpointElement" /> class. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A standard endpoint element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Properties">
@@ -190,12 +196,15 @@
         <Parameter Name="config" Type="System.Configuration.Configuration" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to add an endpoint element to the collection of standard endpoints elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the element was added to the collection; otherwise, false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The identifier of the element to add to the collection.</param>
         <param name="endpoint">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/StandardEndpointElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/StandardEndpointElement.xml
index d8ca1bec4f7..3de1c3fb72c 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/StandardEndpointElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/StandardEndpointElement.xml
@@ -100,12 +100,15 @@
         <Parameter Name="contractDescription" Type="System.ServiceModel.Description.ContractDescription" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented in a derived class, creates a service endpoint from message information contained in the specified contract description.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A service endpoint.</para>
+        </returns>
         <param name="contractDescription">
           <attribution license="cc4" from="Microsoft" modified="false" />Information about what is contained in messages being sent from an endpoint.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/StandardEndpointsSection.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/StandardEndpointsSection.xml
index cc7df2995be..a2190089ea4 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/StandardEndpointsSection.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/StandardEndpointsSection.xml
@@ -68,12 +68,15 @@
       </Parameters>
       <Docs>
         <param name="config">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the standard endpoints section from the specified configuration file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A standard endpoints configuration section.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Item">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/TransactionFlowElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/TransactionFlowElement.xml
index e1cca8c3c3c..fb1c220d8cb 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/TransactionFlowElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/TransactionFlowElement.xml
@@ -65,12 +65,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.ServiceModel.Channels.TransactionFlowBindingElement" /> object that has enabled transaction flow and uses the same <see cref="T:System.ServiceModel.TransactionProtocol" /> as the current element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.TransactionFlowBindingElement" /> object that has enabled transaction flow, and uses the same <see cref="T:System.ServiceModel.TransactionProtocol" /> as the current element </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Properties">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/TransportElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/TransportElement.xml
index 1695fb21dbf..63e604adc58 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/TransportElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/TransportElement.xml
@@ -95,12 +95,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new custom binding element object whose properties are copied from the settings of this configuration element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A custom <see cref="T:System.ServiceModel.Channels.BindingElement" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateDefaultBindingElement">
@@ -115,12 +118,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a custom binding element object with default values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A custom <see cref="T:System.ServiceModel.Channels.BindingElement" /> object with default values.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InitializeFrom">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/UseManagedPresentationElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/UseManagedPresentationElement.xml
index d657e6a0c04..96ce158af1c 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/UseManagedPresentationElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Configuration/UseManagedPresentationElement.xml
@@ -65,12 +65,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new custom binding element object whose properties are copied from the settings of this configuration element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A custom <see cref="T:System.ServiceModel.Channels.BindingElement" /> object.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/ClientCredentials.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/ClientCredentials.xml
index 0e2cc421a0d..f0276b0079a 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/ClientCredentials.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/ClientCredentials.xml
@@ -126,12 +126,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new copy of this <see cref="T:System.ServiceModel.Description.ClientCredentials" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Description.ClientCredentials" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CloneCore">
@@ -146,7 +149,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ServiceModel.Description.ClientCredentials.Clone" /> and <see cref="M:System.ServiceModel.Description.ClientCredentials.CloneCore" /> methods follow the Core design pattern. <see cref="M:System.ServiceModel.Description.ClientCredentials.CloneCore" /> can be overridden in derived classes if they add new fields that must be cloned.</para>
@@ -156,6 +158,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new copy of this <see cref="T:System.ServiceModel.Description.ClientCredentials" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Description.ClientCredentials" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateSecurityTokenManager">
@@ -170,7 +176,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is usually overridden by custom client credentials implementations that inherit from this class. This method is responsible for returning a new instance of a <see cref="T:System.IdentityModel.Selectors.SecurityTokenManager" /> implementation.</para>
@@ -179,6 +184,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a security token manager for this instance. This method is rarely called explicitly; it is primarily used in extensibility scenarios and is called by the system itself. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.ClientCredentialsSecurityTokenManager" /> for this <see cref="T:System.ServiceModel.Description.ClientCredentials" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetInfoCardSecurityToken">
@@ -197,12 +206,15 @@
         <Parameter Name="tokenSerializer" Type="System.IdentityModel.Selectors.SecurityTokenSerializer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates and returns a security token using the infocard system and the specified policy chain and token serializer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IdentityModel.Tokens.GenericXmlSecurityToken" /> that represents the generated security token. Returns null if <paramref name="requiresInfoCard" /> is false.</para>
+        </returns>
         <param name="requiresInfoCard">
           <attribution license="cc4" from="Microsoft" modified="false" />A value that determines whether infocard is required.</param>
         <param name="chain">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/ContractDescription.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/ContractDescription.xml
index 68cc309da62..4d185b5ad0f 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/ContractDescription.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/ContractDescription.xml
@@ -199,7 +199,6 @@
         <Parameter Name="contractType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The difference between the <see cref="Overload:System.ServiceModel.Description.ContractDescription.GetContract" /> overloads is that the ones with two arguments allow you to find attributes from the service (for example, <see cref="T:System.ServiceModel.OperationBehaviorAttribute" />).</para>
@@ -208,6 +207,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the contract description for a specified type of contract.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Description.ContractDescription" /> for the specified type of contract.</para>
+        </returns>
         <param name="contractType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of contract.</param>
       </Docs>
@@ -227,7 +230,6 @@
         <Parameter Name="serviceImplementation" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The difference between the <see cref="Overload:System.ServiceModel.Description.ContractDescription.GetContract" /> overloads is that the ones with two arguments allow you to find attributes from the service (for example, <see cref="T:System.ServiceModel.OperationBehaviorAttribute" />).</para>
@@ -236,6 +238,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the contract description for a specified type of contract and service implementation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Description.ContractDescription" /> for the specified type of contract and service implementation.</para>
+        </returns>
         <param name="contractType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of contract.</param>
         <param name="serviceImplementation">
@@ -257,7 +263,6 @@
         <Parameter Name="serviceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The difference between the <see cref="Overload:System.ServiceModel.Description.ContractDescription.GetContract" /> overloads is that the ones with two arguments allow you to find attributes from the service (for example, <see cref="T:System.ServiceModel.OperationBehaviorAttribute" />).</para>
@@ -266,6 +271,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the contract description for a specified type of contract and a specified type of service.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Description.ContractDescription" /> for the specified type of contract and type of service.</para>
+        </returns>
         <param name="contractType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of contract.</param>
         <param name="serviceType">
@@ -284,12 +293,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of contract descriptions that are inherited by the current contract description.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Collections.ObjectModel.Collection`1" /> of type <see cref="T:System.ServiceModel.Description.ContractDescription" /> that is inherited by the current contract description.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HasProtectionLevel">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/DataContractSerializerOperationBehavior.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/DataContractSerializerOperationBehavior.xml
index eea878e8671..2354d73fe7e 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/DataContractSerializerOperationBehavior.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/DataContractSerializerOperationBehavior.xml
@@ -89,7 +89,6 @@
         <Parameter Name="knownTypes" Type="System.Collections.Generic.IList&lt;System.Type&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Both the <see cref="T:System.Runtime.Serialization.NetDataContractSerializer" /> and the <see cref="T:System.Runtime.Serialization.DataContractSerializer" /> inherit from the <see cref="T:System.Runtime.Serialization.XmlObjectSerializer" /> class. </para>
@@ -98,6 +97,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of a class that inherits from <see cref="T:System.Runtime.Serialization.XmlObjectSerializer" /> for serialization and deserialization processes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of a class that inherits from the <see cref="T:System.Runtime.Serialization.XmlObjectSerializer" /> class. </para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> to create the serializer for.</param>
         <param name="name">
@@ -125,7 +128,6 @@
         <Parameter Name="knownTypes" Type="System.Collections.Generic.IList&lt;System.Type&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Both the <see cref="T:System.Runtime.Serialization.DataContractSerializer" /> and the <see cref="T:System.Runtime.Serialization.NetDataContractSerializer" /> inherit from the <see cref="T:System.Runtime.Serialization.XmlObjectSerializer" /> class. </para>
@@ -134,6 +136,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of a class that inherits from <see cref="T:System.Runtime.Serialization.XmlObjectSerializer" /> for serialization and deserialization processes with an <see cref="T:System.Xml.XmlDictionaryString" /> that contains the namespace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of a class that inherits from the <see cref="T:System.Runtime.Serialization.XmlObjectSerializer" /> class. </para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to serialize or deserialize.</param>
         <param name="name">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/FaultDescriptionCollection.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/FaultDescriptionCollection.xml
index 2cffbaebe49..f26cb3f22f5 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/FaultDescriptionCollection.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/FaultDescriptionCollection.xml
@@ -39,12 +39,15 @@
       </Parameters>
       <Docs>
         <param name="name">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.ServiceModel.Description.FaultDescription" /> object that has the specified action value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Description.FaultDescription" /> object that has the specified action, or null. If more than one <see cref="T:System.ServiceModel.Description.FaultDescription" /> object has the same action, the first one in the collection is returned.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="FindAll">
@@ -62,12 +65,15 @@
       </Parameters>
       <Docs>
         <param name="name">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all <see cref="T:System.ServiceModel.Description.FaultDescription" /> objects that have the specified action value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of <see cref="T:System.ServiceModel.Description.FaultDescription" /> objects that have the specified action. If there are no <see cref="T:System.ServiceModel.Description.FaultDescription" /> objects with the action, an empty collection is returned.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/IMetadataExchange.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/IMetadataExchange.xml
index 1b930f24885..742242d0787 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/IMetadataExchange.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/IMetadataExchange.xml
@@ -48,12 +48,15 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Starts an asynchronous retrieval of metadata.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that can be passed to the <see cref="M:System.ServiceModel.Description.IMetadataExchange.EndGet(System.IAsyncResult)" /> method.</para>
+        </returns>
         <param name="request">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ServiceModel.Channels.Message" /> that should be processed to determine the metadata to return.</param>
         <param name="callback">
@@ -76,12 +79,15 @@
         <Parameter Name="result" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Concludes the retrieval of metadata.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.Message" /> containing the processed metadata.</para>
+        </returns>
         <param name="result">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IAsyncResult" />  that contains data used to further process the metadata.</param>
       </Docs>
@@ -105,12 +111,15 @@
         <Parameter Name="request" Type="System.ServiceModel.Channels.Message" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the service metadata.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.Message" /> containing the metadata.</para>
+        </returns>
         <param name="request">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ServiceModel.Channels.Message" /> that contains the request for metadata.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MessageDescriptionCollection.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MessageDescriptionCollection.xml
index e39742b9280..b5c0040906d 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MessageDescriptionCollection.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MessageDescriptionCollection.xml
@@ -38,7 +38,6 @@
         <Parameter Name="action" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you need to find all of the <see cref="T:System.ServiceModel.Description.MessageDescription" /> objects in the collection that match the specified <paramref name="action" />, use the <see cref="M:System.ServiceModel.Description.MessageDescriptionCollection.FindAll(System.String)" /> method instead.</para>
@@ -47,6 +46,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds and returns the first message description in a collection for a message with a specified action.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first <see cref="T:System.ServiceModel.Description.MessageDescription" /> from the collection whose message has the specified <paramref name="action" /> and null if no matching <paramref name="action" /> is found.</para>
+        </returns>
         <param name="action">
           <attribution license="cc4" from="Microsoft" modified="false" />The action of the message being found.</param>
       </Docs>
@@ -65,7 +68,6 @@
         <Parameter Name="action" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you need to find the first instance of the <see cref="T:System.ServiceModel.Description.MessageDescription" /> in the collection that match the specified <paramref name="action" />, use the <see cref="M:System.ServiceModel.Description.MessageDescriptionCollection.Find(System.String)" /> method instead.</para>
@@ -74,6 +76,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds and returns all of the message descriptions in a collection whose messages have a specified action.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Description.MessageDescriptionCollection" /> that contains the collection message descriptions from the current collection whose messages have the specified <paramref name="action" />. If no matching <see cref="T:System.ServiceModel.Description.MessageDescription" /> objects are found, an empty collection is returned.</para>
+        </returns>
         <param name="action">
           <attribution license="cc4" from="Microsoft" modified="false" />The action of the messages being found.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MessageHeaderDescriptionCollection.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MessageHeaderDescriptionCollection.xml
index c5eaae2551c..e30200eaced 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MessageHeaderDescriptionCollection.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MessageHeaderDescriptionCollection.xml
@@ -39,12 +39,15 @@
         <Parameter Name="item" Type="System.ServiceModel.Description.MessageHeaderDescription" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When called by a derived class, returns the <see cref="T:System.Xml.XmlQualifiedName" /> of the message header.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.XmlQualifiedName" /> of the message header.</para>
+        </returns>
         <param name="item">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Description.MessageHeaderDescription" /> to locate.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MessagePartDescriptionCollection.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MessagePartDescriptionCollection.xml
index 3e0909118e2..92b9ea1f319 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MessagePartDescriptionCollection.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MessagePartDescriptionCollection.xml
@@ -39,12 +39,15 @@
         <Parameter Name="item" Type="System.ServiceModel.Description.MessagePartDescription" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When called by a derived class, returns the <see cref="T:System.Xml.XmlQualifiedName" /> of the <see cref="T:System.ServiceModel.Description.MessagePartDescription" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.XmlQualifiedName" /> of the <see cref="T:System.ServiceModel.Description.MessagePartDescription" />.</para>
+        </returns>
         <param name="item">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Description.MessagePartDescription" /> to locate.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MessagePropertyDescriptionCollection.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MessagePropertyDescriptionCollection.xml
index 4672dd323d9..54cccbafbce 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MessagePropertyDescriptionCollection.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MessagePropertyDescriptionCollection.xml
@@ -39,12 +39,15 @@
         <Parameter Name="item" Type="System.ServiceModel.Description.MessagePropertyDescription" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Xml.XmlQualifiedName" /> for a <see cref="T:System.ServiceModel.Description.MessagePropertyDescription" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.XmlQualifiedName" /> of the <see cref="T:System.ServiceModel.Description.MessagePropertyDescription" />.</para>
+        </returns>
         <param name="item">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Description.MessagePropertyDescription" /> to locate.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataConversionError.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataConversionError.xml
index e64969e95be..a3ca2835a4f 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataConversionError.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataConversionError.xml
@@ -85,7 +85,6 @@
       </Parameters>
       <Docs>
         <param name="other">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For details about reference and value equality, see <see cref="M:System.Object.Equals(System.Object)" />.</para>
@@ -94,6 +93,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether two <see cref="T:System.ServiceModel.Description.MetadataConversionError" /> objects have value equality.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two <see cref="T:System.ServiceModel.Description.MetadataConversionError" /> objects have value equality; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -108,7 +111,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For details about hash codes, see <see cref="M:System.Object.GetHashCode" />.</para>
@@ -117,6 +119,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that serves as a hash function for a <see cref="T:System.ServiceModel.Description.MetadataConversionError" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value suitable for use in hashing algorithms and data structures, such as a hash table.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsWarning">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataExchangeBindings.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataExchangeBindings.xml
index b18dd84b72f..eb20fb72161 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataExchangeBindings.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataExchangeBindings.xml
@@ -34,7 +34,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para> Use the <see cref="M:System.ServiceModel.Description.MetadataExchangeBindings.CreateMexHttpBinding" /> method to return a binding that supports most metadata requests. </para>
@@ -43,6 +42,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.ServiceModel.WSHttpBinding" /> with security disabled.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.WSHttpBinding" /> with security disabled. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateMexHttpsBinding">
@@ -57,7 +60,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.ServiceModel.Description.MetadataExchangeBindings.CreateMexHttpsBinding" /> method to return a binding that can be secured at the transport level using certificates. For more information about configuring and using such a metadata endpoint, see <format type="text/html"><a href="cdba4d73-da64-4805-bc56-9822becfd1e4">How to: Configure a Custom WS-Metadata Exchange Binding</a></format>, <format type="text/html"><a href="2292e124-81b2-4317-b881-ce9c1ec66ecb">How to: Retrieve Metadata Over a Custom Binding</a></format>, and the sample <format type="text/html"><a href="9e369e99-ea4a-49ff-aed2-9fdf61091a48">Custom Secure Metadata Endpoint</a></format>. </para>
@@ -66,6 +68,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.ServiceModel.WSHttpBinding" /> that supports transport-level security.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.WSHttpBinding" /> that supports transport-level security.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateMexNamedPipeBinding">
@@ -80,12 +86,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.ServiceModel.Channels.CustomBinding" /> with a <see cref="T:System.ServiceModel.Channels.NamedPipeTransportBindingElement" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.CustomBinding" /> with a <see cref="T:System.ServiceModel.Channels.NamedPipeTransportBindingElement" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateMexTcpBinding">
@@ -100,12 +109,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.ServiceModel.Channels.CustomBinding" /> with a <see cref="T:System.ServiceModel.Channels.TcpTransportBindingElement" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.CustomBinding" /> with a <see cref="T:System.ServiceModel.Channels.TcpTransportBindingElement" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataExchangeClient.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataExchangeClient.xml
index 6daf7cc5ffa..be813031fd4 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataExchangeClient.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataExchangeClient.xml
@@ -181,7 +181,6 @@
         <Parameter Name="asyncState" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An asynchronous implementation of the <see cref="M:System.ServiceModel.Description.MetadataExchangeClient.GetMetadata" /> method.</para>
@@ -190,6 +189,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous method call that returns a <see cref="T:System.ServiceModel.Description.MetadataSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The metadata.</para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />The asynchronous callback delegate invoked when the call is complete.</param>
         <param name="asyncState">
@@ -212,7 +215,6 @@
         <Parameter Name="asyncState" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An asynchronous implementation of the <see cref="M:System.ServiceModel.Description.MetadataExchangeClient.GetMetadata(System.ServiceModel.EndpointAddress)" /> method.</para>
@@ -221,6 +223,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous method call that returns a <see cref="T:System.ServiceModel.Description.MetadataSet" /> using the specified address, callback, and asynchronous state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The metadata obtained from the specified <paramref name="address" />.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The address of the metadata.</param>
         <param name="callback">
@@ -246,7 +252,6 @@
         <Parameter Name="asyncState" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An asynchronous implementation of the <see cref="M:System.ServiceModel.Description.MetadataExchangeClient.GetMetadata(System.Uri,System.ServiceModel.Description.MetadataExchangeClientMode)" /> method.</para>
@@ -255,6 +260,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous method call that returns a <see cref="T:System.ServiceModel.Description.MetadataSet" /> using the specified address, callback, asynchronous state, and download mechanism.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The metadata obtained from the specified <paramref name="address" />.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The address of the metadata.</param>
         <param name="mode">
@@ -279,7 +288,6 @@
         <Parameter Name="result" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ends one of the asynchronous <see cref="Overload:System.ServiceModel.Description.MetadataExchangeClient.BeginGetMetadata" /> methods to return the downloaded metadata. </para>
@@ -288,6 +296,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ends an asynchronous method call that returns a <see cref="T:System.ServiceModel.Description.MetadataSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Description.MetadataSet" /> that contains the downloaded metadata.</para>
+        </returns>
         <param name="result">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IAsyncResult" /> object that is received from a call to the <see cref="Overload:System.ServiceModel.Description.MetadataExchangeClient.BeginGetMetadata" /> method.</param>
       </Docs>
@@ -308,7 +320,6 @@
         <Parameter Name="identifier" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called when retrieving metadata for a <see cref="T:System.ServiceModel.Description.MetadataReference" />.</para>
@@ -317,6 +328,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the channel factory that is used to make the WS-Transfer metadata request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.ChannelFactory`1" /> of type <see cref="T:System.ServiceModel.Channels.IRequestChannel" /> that makes the WS-Transfer metadata request.</para>
+        </returns>
         <param name="metadataAddress">
           <attribution license="cc4" from="Microsoft" modified="false" />The metadata address.</param>
         <param name="dialect">
@@ -337,12 +352,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.ServiceModel.Description.MetadataSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Description.MetadataSet" /> that contains the downloaded metadata.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetMetadata">
@@ -359,12 +377,15 @@
         <Parameter Name="address" Type="System.ServiceModel.EndpointAddress" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.ServiceModel.Description.MetadataSet" /> from the specified address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The metadata located at the <paramref name="address" />.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The address from which to download the metadata.</param>
       </Docs>
@@ -384,7 +405,6 @@
         <Parameter Name="mode" Type="System.ServiceModel.Description.MetadataExchangeClientMode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to specify the address and whether to use HTTP GET or WS-Transfer Get to download the metadata.</para>
@@ -393,6 +413,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.ServiceModel.Description.MetadataSet" /> from the specified address using the specified download mode.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The metadata that is downloaded.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The address from which to download the metadata.</param>
         <param name="mode">
@@ -415,7 +439,6 @@
         <Parameter Name="identifier" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ServiceModel.Description.MetadataExchangeClient.GetWebRequest(System.Uri,System.String,System.String)" /> method is called:</para>
@@ -432,6 +455,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the <see cref="T:System.Net.HttpWebRequest" /> used to make HTTP/GET metadata requests.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The internal <see cref="T:System.Net.HttpWebRequest" /> used to make HTTP GET metadata requests.</para>
+        </returns>
         <param name="location">
           <attribution license="cc4" from="Microsoft" modified="false" />The location of the metadata.</param>
         <param name="dialect">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataExporter.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataExporter.xml
index 9f19950e190..72e6a932cc4 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataExporter.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataExporter.xml
@@ -113,12 +113,15 @@
         <Parameter Name="endpoint" Type="System.ServiceModel.Description.ServiceEndpoint" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts policy assertions into a <see cref="T:System.ServiceModel.Description.PolicyConversionContext" /> object. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that contains policy assertion information for the endpoint. The policy assertions can then be embedded in a metadata document.</para>
+        </returns>
         <param name="endpoint">
           <attribution license="cc4" from="Microsoft" modified="false" />The endpoint from which to extract policy assertions.</param>
       </Docs>
@@ -135,7 +138,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.ServiceModel.Description.MetadataExporter.GetGeneratedMetadata" /> method to retrieve the metadata generated from earlier calls. Check the <see cref="P:System.ServiceModel.Description.MetadataExporter.Errors" /> property prior to retrieving the metadata to ensure that you have the metadata you want.</para>
@@ -144,6 +146,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the metadata generated by a call to either <see cref="M:System.ServiceModel.Description.MetadataExporter.ExportContract(System.ServiceModel.Description.ContractDescription)" />, <see cref="M:System.ServiceModel.Description.MetadataExporter.ExportEndpoint(System.ServiceModel.Description.ServiceEndpoint)" />, or <see cref="M:System.ServiceModel.Description.MetadataExporter.ExportPolicy(System.ServiceModel.Description.ServiceEndpoint)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerable collection of <see cref="T:System.ServiceModel.Description.MetadataSection" /> objects that contain the exported metadata.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="State">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataImporter.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataImporter.xml
index b38421512bc..e8c51fc4ccd 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataImporter.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataImporter.xml
@@ -62,12 +62,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns a collection of contracts imported from the metadata. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The contracts imported from the metadata.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ImportAllEndpoints">
@@ -82,7 +85,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implement the <see cref="M:System.ServiceModel.Description.MetadataImporter.ImportAllEndpoints" /> method to return all endpoints in the imported metadata. Metadata that has been imported as service endpoints cannot be used to create a runtime or export metadata because the imported endpoints contain no managed type information. To use the metadata to create a client or service runtime or to generate metadata, you must first generate and compile code from the metadata and use that type information to create a new <see cref="T:System.ServiceModel.Description.ContractDescription" /> object using <see cref="Overload:System.ServiceModel.Description.ContractDescription.GetContract" />.</para>
@@ -91,6 +93,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns all endpoints in the metadata. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> objects that are published by a service.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="KnownContracts">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataReference.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataReference.xml
index 0b7d900f1b0..f79c6d1cc35 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataReference.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataReference.xml
@@ -126,12 +126,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an XML schema document for the metadata reference endpoint.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Schema.XmlSchema" /> that represents the XML Schema Document (XSD) for the metadata endpoint reference.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataResolver.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataResolver.xml
index 5b327511457..51bdde4e0cb 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataResolver.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataResolver.xml
@@ -38,7 +38,6 @@
         <Parameter Name="asyncState" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default settings on the <see cref="T:System.ServiceModel.Description.MetadataExchangeClient" /> are used to retrieve the metadata and the default <see cref="T:System.ServiceModel.Description.MetadataExchangeClientMode" /> is <see cref="F:System.ServiceModel.Description.MetadataExchangeClientMode.MetadataExchange" />.</para>
@@ -51,6 +50,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous call that resolves a metadata address into the <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> objects for the specified contracts, using the specified address and asynchronous state and delegate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous resolve operation. </para>
+        </returns>
         <param name="contracts">
           <attribution license="cc4" from="Microsoft" modified="false" />The contracts for which to download and resolve metadata.</param>
         <param name="address">
@@ -78,7 +81,6 @@
         <Parameter Name="asyncState" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default settings on the <see cref="T:System.ServiceModel.Description.MetadataExchangeClient" /> are used to retrieve the metadata and the default <see cref="T:System.ServiceModel.Description.MetadataExchangeClientMode" /> is <see cref="F:System.ServiceModel.Description.MetadataExchangeClientMode.MetadataExchange" />.</para>
@@ -93,6 +95,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous call that resolves a metadata address into the <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> objects for the specified contract using the specified address and asynchronous state and delegate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous resolve operation.</para>
+        </returns>
         <param name="contract">
           <attribution license="cc4" from="Microsoft" modified="false" />The contract for which to download and resolve metadata.</param>
         <param name="address">
@@ -121,7 +127,6 @@
         <Parameter Name="asyncState" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default <see cref="T:System.ServiceModel.Description.MetadataExchangeClientMode" /> is <see cref="F:System.ServiceModel.Description.MetadataExchangeClientMode.MetadataExchange" />.</para>
@@ -134,6 +139,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous call that resolves a metadata address into the <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> objects for the specified contracts, using the specified address, <see cref="T:System.ServiceModel.Description.MetadataExchangeClient" />, asynchronous state and delegate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous resolve operation.</para>
+        </returns>
         <param name="contracts">
           <attribution license="cc4" from="Microsoft" modified="false" />The contracts for which to download and resolve metadata.</param>
         <param name="address">
@@ -164,7 +173,6 @@
         <Parameter Name="asyncState" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default settings on the <see cref="T:System.ServiceModel.Description.MetadataExchangeClient" /> are used to retrieve the metadata.</para>
@@ -177,6 +185,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous call that resolves a metadata address into the <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> objects for the specified contracts, using the specified address, <see cref="T:System.ServiceModel.Description.MetadataExchangeClientMode" /> value, asynchronous state and delegate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous resolve operation.</para>
+        </returns>
         <param name="contracts">
           <attribution license="cc4" from="Microsoft" modified="false" />The contracts for which to download and resolve metadata.</param>
         <param name="address">
@@ -207,7 +219,6 @@
         <Parameter Name="asyncState" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default settings on the <see cref="T:System.ServiceModel.Description.MetadataExchangeClient" /> are used to retrieve the metadata.</para>
@@ -220,6 +231,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous call that resolves a metadata address into the <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> objects for the specified contract, using the specified address, <see cref="T:System.ServiceModel.Description.MetadataExchangeClientMode" />, asynchronous state and delegate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous resolve operation.</para>
+        </returns>
         <param name="contract">
           <attribution license="cc4" from="Microsoft" modified="false" />The contract for which to download and resolve metadata.</param>
         <param name="address">
@@ -251,7 +266,6 @@
         <Parameter Name="asyncState" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To download metadata but not resolve the information into <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> objects, use the <see cref="T:System.ServiceModel.Description.MetadataExchangeClient" /> directly.</para>
@@ -263,6 +277,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous call that resolves a metadata address into the <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> objects for the specified contracts, using the specified address, <see cref="T:System.ServiceModel.Description.MetadataExchangeClient" />, <see cref="T:System.ServiceModel.Description.MetadataExchangeClientMode" />, asynchronous state, and delegate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous resolve operation.</para>
+        </returns>
         <param name="contracts">
           <attribution license="cc4" from="Microsoft" modified="false" />The contracts for which to download and resolve metadata.</param>
         <param name="address">
@@ -291,7 +309,6 @@
         <Parameter Name="result" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ends an asynchronous call to one of the <see cref="Overload:System.ServiceModel.Description.MetadataResolver.BeginResolve" /> methods.</para>
@@ -300,6 +317,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Completes an asynchronous call to resolve metadata into a collection of endpoints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> objects for the endpoints contained in the metadata.</para>
+        </returns>
         <param name="result">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IAsyncResult" /> object that was received from a call to the <see cref="Overload:System.ServiceModel.Description.MetadataResolver.BeginResolve" /> method.</param>
       </Docs>
@@ -319,7 +340,6 @@
         <Parameter Name="address" Type="System.ServiceModel.EndpointAddress" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default settings on the <see cref="T:System.ServiceModel.Description.MetadataExchangeClient" /> are used to retrieve the metadata and the default <see cref="T:System.ServiceModel.Description.MetadataExchangeClientMode" /> is <see cref="F:System.ServiceModel.Description.MetadataExchangeClientMode.MetadataExchange" />.</para>
@@ -332,6 +352,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resolves a metadata address into the <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> objects for the specified contracts using the specified metadata address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> objects for the specified contract.</para>
+        </returns>
         <param name="contracts">
           <attribution license="cc4" from="Microsoft" modified="false" />The contracts for which to download and resolve metadata.</param>
         <param name="address">
@@ -353,7 +377,6 @@
         <Parameter Name="address" Type="System.ServiceModel.EndpointAddress" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.ServiceModel.Description.MetadataResolver.Resolve(System.Type,System.ServiceModel.EndpointAddress)" /> method to specify the contract and the metadata address to use when downloading and resolving metadata. </para>
@@ -369,6 +392,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Downloads and resolves a metadata address into a collection of <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> objects for a specified contract at a specified address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> objects for the specified contract.</para>
+        </returns>
         <param name="contract">
           <attribution license="cc4" from="Microsoft" modified="false" />The contracts for which to download and resolve metadata.</param>
         <param name="address">
@@ -391,7 +418,6 @@
         <Parameter Name="client" Type="System.ServiceModel.Description.MetadataExchangeClient" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default <see cref="T:System.ServiceModel.Description.MetadataExchangeClientMode" /> is <see cref="F:System.ServiceModel.Description.MetadataExchangeClientMode.MetadataExchange" />.</para>
@@ -404,6 +430,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resolves a metadata address into the <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> objects for the specified contracts using the specified metadata address and <see cref="T:System.ServiceModel.Description.MetadataExchangeClient" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> objects for the specified contract.</para>
+        </returns>
         <param name="contracts">
           <attribution license="cc4" from="Microsoft" modified="false" />The contracts for which to download and resolve metadata.</param>
         <param name="address">
@@ -428,7 +458,6 @@
         <Parameter Name="mode" Type="System.ServiceModel.Description.MetadataExchangeClientMode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default settings on the <see cref="T:System.ServiceModel.Description.MetadataExchangeClient" /> are used to retrieve the metadata.</para>
@@ -441,6 +470,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resolves a metadata address into the <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> objects for the specified contracts using the specified address and transfer mode.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> objects for the specified contract.</para>
+        </returns>
         <param name="contracts">
           <attribution license="cc4" from="Microsoft" modified="false" />The contracts for which to download and resolve metadata.</param>
         <param name="address">
@@ -465,7 +498,6 @@
         <Parameter Name="mode" Type="System.ServiceModel.Description.MetadataExchangeClientMode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.ServiceModel.Description.MetadataResolver.Resolve(System.Type,System.Uri,System.ServiceModel.Description.MetadataExchangeClientMode)" /> method to specify a contract, and address, and the download mechanism to use.</para>
@@ -479,6 +511,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resolves a metadata address into the <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> objects for the specified contract using the specified address and transfer mode.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> objects for the specified contract.</para>
+        </returns>
         <param name="contract">
           <attribution license="cc4" from="Microsoft" modified="false" />The contract for which to download and resolve metadata.</param>
         <param name="address">
@@ -504,7 +540,6 @@
         <Parameter Name="client" Type="System.ServiceModel.Description.MetadataExchangeClient" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To download metadata but not resolve the information into <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> objects, use the <see cref="T:System.ServiceModel.Description.MetadataExchangeClient" /> directly.</para>
@@ -516,6 +551,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resolves a metadata address into the <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> objects for the specified contracts using the specified address, transfer mode, and transfer client.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> objects for the specified contract.</para>
+        </returns>
         <param name="contracts">
           <attribution license="cc4" from="Microsoft" modified="false" />The contracts for which to download and resolve metadata.</param>
         <param name="address">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataSection.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataSection.xml
index 145bc55dbb3..8fbd1704eda 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataSection.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataSection.xml
@@ -116,7 +116,6 @@
       </Parameters>
       <Docs>
         <param name="schema">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this static factory method to quickly create a <see cref="T:System.ServiceModel.Description.MetadataSection" /> for a XML Schema document. The <see cref="P:System.ServiceModel.Description.MetadataSection.Dialect" /> property is assigned the value of <see cref="P:System.ServiceModel.Description.MetadataSection.XmlSchemaDialect" /> and the <see cref="P:System.ServiceModel.Description.MetadataSection.Identifier" /> property is assigned the value of the target namespace of the XML Schema document.</para>
@@ -125,6 +124,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.ServiceModel.Description.MetadataSection" /> from the specified <see cref="T:System.Xml.Schema.XmlSchema" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Description.MetadataSection" /> containing the specified XML schema.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateFromServiceDescription">
@@ -142,7 +145,6 @@
       </Parameters>
       <Docs>
         <param name="serviceDescription">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this static factory method to quickly create a <see cref="T:System.ServiceModel.Description.MetadataSection" /> for a WSDL document. The <see cref="P:System.ServiceModel.Description.MetadataSection.Dialect" /> property is assigned the value of <see cref="P:System.ServiceModel.Description.MetadataSection.ServiceDescriptionDialect" /> and the <see cref="P:System.ServiceModel.Description.MetadataSection.Identifier" /> property is assigned the value of the target namespace of the WSDL document.</para>
@@ -151,6 +153,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.ServiceModel.Description.MetadataSection" /> that contains the specified <see cref="T:System.Web.Services.Description.ServiceDescription" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Description.MetadataSection" /> that contains the specified <see cref="T:System.Web.Services.Description.ServiceDescription" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Dialect">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataSet.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataSet.xml
index 0a4304eb003..fcb912604f9 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataSet.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/MetadataSet.xml
@@ -137,7 +137,6 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.ServiceModel.Description.MetadataSet" /> from an <see cref="T:System.Xml.XmlReader" /> object.</para>
@@ -146,6 +145,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.ServiceModel.Description.MetadataSet" /> from the specified <see cref="T:System.Xml.XmlReader" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Description.MetadataSet" /> that contains all the metadata present in the XML stream.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The reader to read in XML.</param>
       </Docs>
@@ -162,12 +165,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implements <see cref="M:System.Xml.Serialization.IXmlSerializable.GetSchema" /> method to provide serialization support.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Xml.Schema.XmlSchema" />.</para>
+          <para>Returns the <see cref="T:System.Xml.Schema.XmlSchema" /> object that describes the XML representation of the object that is produced by the <see cref="M:System.ServiceModel.Description.MetadataSet.System.Xml.Serialization.IXmlSerializable.WriteXml(System.Xml.XmlWriter)" /> method and accessed by the <see cref="M:System.ServiceModel.Description.MetadataSet.System.Xml.Serialization.IXmlSerializable.ReadXml(System.Xml.XmlReader)" /> method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/OperationDescriptionCollection.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/OperationDescriptionCollection.xml
index cda6c7600ac..414c1f56f5b 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/OperationDescriptionCollection.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/OperationDescriptionCollection.xml
@@ -39,7 +39,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns the first occurrence of the <see cref="T:System.ServiceModel.Description.OperationDescription" /> in the collection with the name specified. If you need to find all of the <see cref="T:System.ServiceModel.Description.OperationDescription" /> objects in the collection use the <see cref="M:System.ServiceModel.Description.OperationDescriptionCollection.FindAll(System.String)" /> method instead.</para>
@@ -48,6 +47,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an operation description with a specified name from the collection of operation descriptions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Description.OperationDescription" /> with the name specified.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the operation.</param>
       </Docs>
@@ -66,12 +69,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of all the operation descriptions from the collection that have the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Collections.ObjectModel.Collection`1" /> of type <see cref="T:System.ServiceModel.Description.OperationDescription" /> that contains the operation descriptions with the specified name.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the operation.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/PolicyAssertionCollection.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/PolicyAssertionCollection.xml
index 106a4578981..5199877d5a9 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/PolicyAssertionCollection.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/PolicyAssertionCollection.xml
@@ -77,12 +77,15 @@
       <Docs>
         <param name="name">To be added.</param>
         <param name="ns">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the collection contains the specified policy assertion.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the specified policy assertion; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Find">
@@ -102,12 +105,15 @@
       <Docs>
         <param name="name">To be added.</param>
         <param name="ns">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified policy assertion.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified policy assertion, or null if the assertion cannot be found.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="FindAll">
@@ -127,12 +133,15 @@
       <Docs>
         <param name="name">To be added.</param>
         <param name="ns">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all specified policy assertions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of all policy assertions that match the specification, or an empty collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InsertItem">
@@ -178,12 +187,15 @@
       <Docs>
         <param name="name">To be added.</param>
         <param name="ns">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the specified policy assertion from the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The policy assertion that was removed from the collection or null if the policy assertion was not in the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="RemoveAll">
@@ -203,12 +215,15 @@
       <Docs>
         <param name="name">To be added.</param>
         <param name="ns">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes all policy assertions that match the specified name and namespace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of all removed policy assertions or an empty collection if no assertions were found that match the specified name and namespace.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SetItem">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/PolicyConversionContext.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/PolicyConversionContext.xml
index 962209b638d..5d0f445d3ea 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/PolicyConversionContext.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/PolicyConversionContext.xml
@@ -111,7 +111,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The collection returned from <see cref="M:System.ServiceModel.Description.PolicyConversionContext.GetBindingAssertions" /> is not a copy. You can add and remove assertions as necessary.</para>
@@ -120,6 +119,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of policy assertions from metadata.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.ICollection`1" /> of type <see cref="T:System.Xml.XmlElement" /> that contains binding policy assertions.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetFaultBindingAssertions">
@@ -136,7 +139,6 @@
         <Parameter Name="fault" Type="System.ServiceModel.Description.FaultDescription" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The collection returned from <see cref="M:System.ServiceModel.Description.PolicyConversionContext.GetFaultBindingAssertions(System.ServiceModel.Description.FaultDescription)" /> is not a copy. You can add and remove assertions as necessary.</para>
@@ -145,6 +147,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of policy assertions for the specified SOAP fault.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of policy assertions for the specified SOAP fault.</para>
+        </returns>
         <param name="fault">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Description.FaultDescription" /> object for which policy assertions are to be added or for which bindings are to be configured.</param>
       </Docs>
@@ -163,7 +169,6 @@
         <Parameter Name="message" Type="System.ServiceModel.Description.MessageDescription" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The collection returned from <see cref="M:System.ServiceModel.Description.PolicyConversionContext.GetMessageBindingAssertions(System.ServiceModel.Description.MessageDescription)" /> is not a copy. You can add and remove assertions as needed.</para>
@@ -172,6 +177,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of policy assertions for a message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of policy assertions for the specified message.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Description.MessageDescription" /> for which there are binding assertions.</param>
       </Docs>
@@ -190,7 +199,6 @@
         <Parameter Name="operation" Type="System.ServiceModel.Description.OperationDescription" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The collection returned from <see cref="M:System.ServiceModel.Description.PolicyConversionContext.GetOperationBindingAssertions(System.ServiceModel.Description.OperationDescription)" /> is not a copy. You can add and remove assertions as necessary.</para>
@@ -199,6 +207,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of policy assertions for the specified operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The policy assertions for the operation.</para>
+        </returns>
         <param name="operation">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Description.OperationDescription" /> object for which policy assertions are to be added or for which bindings are to be configured.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/PolicyVersion.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/PolicyVersion.xml
index 73d233e93b1..3e8aff78188 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/PolicyVersion.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/PolicyVersion.xml
@@ -115,12 +115,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.ServiceModel.Description.PolicyVersion" /> instance into a string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The namespace for the version of WS-Policy being used.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/ServiceContractGenerator.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/ServiceContractGenerator.xml
index 7b563be5036..1d1f7d9d258 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/ServiceContractGenerator.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/ServiceContractGenerator.xml
@@ -174,7 +174,6 @@
         <Parameter Name="contractDescription" Type="System.ServiceModel.Description.ContractDescription" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Other code artifacts may also get generated as specified by using the <see cref="P:System.ServiceModel.Description.ServiceContractGenerator.Options" /> property.</para>
@@ -183,6 +182,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a service contract type from the specified <see cref="T:System.ServiceModel.Description.ContractDescription" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.CodeTypeReference" /> instance for the generated contract type.</para>
+        </returns>
         <param name="contractDescription">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Description.ContractDescription" /> to use to generate the contract type.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/ServiceCredentials.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/ServiceCredentials.xml
index 2dac412c028..016f6922965 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/ServiceCredentials.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/ServiceCredentials.xml
@@ -95,12 +95,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Description.ServiceCredentials" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CloneCore">
@@ -115,7 +118,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ServiceModel.Description.ServiceCredentials.CloneCore" /> method calls the <see cref="M:System.ServiceModel.Description.ServiceCredentials.#ctor(System.ServiceModel.ServiceCredentials)" /> constructor.</para>
@@ -124,6 +126,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the essential members of the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Description.ServiceCredentials" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateSecurityTokenManager">
@@ -138,12 +144,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a token manager for this service.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Security.ServiceCredentialsSecurityTokenManager" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IssuedTokenAuthentication">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/ServiceDescription.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/ServiceDescription.xml
index 2f9dab72cf7..53890eea947 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/ServiceDescription.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/ServiceDescription.xml
@@ -144,7 +144,6 @@
       </Parameters>
       <Docs>
         <param name="wellKnown">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to reflect on behaviors using the indigo1 programming model when replacing <see cref="T:System.ServiceModel.ServiceHostBase" /> with you own hosting mechanism. </para>
@@ -155,6 +154,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a service description initialized with a specified service object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Description.ServiceDescription" /> for the service object provided.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetService">
@@ -172,7 +175,6 @@
       </Parameters>
       <Docs>
         <param name="type">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to reflect on behaviors using the indigo1 programming model when replacing <see cref="T:System.ServiceModel.ServiceHostBase" /> with you own hosting mechanism. </para>
@@ -183,6 +185,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a service description initialized with a specified service type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Description.ServiceDescription" /> for the service type provided.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Name">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/ServiceEndpointCollection.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/ServiceEndpointCollection.xml
index e8bb100a77c..f004477cb1c 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/ServiceEndpointCollection.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/ServiceEndpointCollection.xml
@@ -40,7 +40,6 @@
       </Parameters>
       <Docs>
         <param name="type">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This <see cref="M:System.ServiceModel.Description.ServiceEndpointCollection.Find(System.Type)" /> overload is specific to the indigo1 programming model. It looks at the <see cref="P:System.ServiceModel.Description.ContractDescription.ContractType" /> property for each endpoint. The <see cref="P:System.ServiceModel.Description.ContractDescription.ContractType" /> may be null if the <see cref="T:System.ServiceModel.Description.ContractDescription" /> was not created from the indigo2 programming model (types with *Contract attributes). </para>
@@ -50,6 +49,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the first service endpoint found that satisfies the specified contract type from the collection of service endpoints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> of the specified contract type or null if none was found.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Find">
@@ -67,7 +70,6 @@
       </Parameters>
       <Docs>
         <param name="uri">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>There are potentially multiple endpoints that could satisfy the criteria. The method returns the first one encountered in the collection. If you need to find all of the <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> objects that satisfy the specified criteria, use one of the <see cref="Overload:System.ServiceModel.Description.ServiceEndpointCollection.FindAll" /> methods instead.</para>
@@ -76,6 +78,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a service endpoint with a specified address from the collection of service endpoints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> of the specified address or null if none was found.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Find">
@@ -93,7 +99,6 @@
       </Parameters>
       <Docs>
         <param name="name">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>There are potentially multiple endpoints that could satisfy the criteria. The method returns the first one encountered in the collection. If you need to find all of the <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> objects that satisfy the specified criteria, use one of the <see cref="Overload:System.ServiceModel.Description.ServiceEndpointCollection.FindAll" /> methods instead.</para>
@@ -102,6 +107,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a service endpoint with a specified namespace and contract name from the collection of service endpoints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> with the specified namespace and contract name or null if none was found.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Find">
@@ -119,7 +128,6 @@
         <Parameter Name="bindingName" Type="System.Xml.XmlQualifiedName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>There are potentially multiple endpoints that could satisfy the criteria. The method returns the first one encountered in the collection. If you need to find all of the <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> objects that satisfy the specified criteria, use one of the <see cref="Overload:System.ServiceModel.Description.ServiceEndpointCollection.FindAll" /> methods instead.</para>
@@ -128,6 +136,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a service endpoint of a specified contract type and with a specified binding name and namespace from the collection of service endpoints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> of the specified contract type and binding name and namespace or null if none was found.</para>
+        </returns>
         <param name="contractType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of contract for the service endpoint.</param>
         <param name="bindingName">
@@ -149,7 +161,6 @@
         <Parameter Name="bindingName" Type="System.Xml.XmlQualifiedName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>There are potentially multiple endpoints that could satisfy the criteria. The method returns the first one encountered in the collection. If you need to find all of the <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> objects that satisfy the specified criteria, use one of the <see cref="Overload:System.ServiceModel.Description.ServiceEndpointCollection.FindAll" /> methods instead.</para>
@@ -158,6 +169,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the first service endpoint with the specified contract name and namespace and binding name and namespace from the collection of service endpoints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> with the specified binding and contract names and namespaces.</para>
+        </returns>
         <param name="contractName">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlQualifiedName" /> for the contract of the service.</param>
         <param name="bindingName">
@@ -178,7 +193,6 @@
         <Parameter Name="contractType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you only need to find the first <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> that satisfies the specified criteria, use one of the <see cref="Overload:System.ServiceModel.Description.ServiceEndpointCollection.Find" /> methods instead.</para>
@@ -187,6 +201,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of all the service endpoints for a specified type of service.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Collections.ObjectModel.Collection`1" /> of type <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> that contains service endpoints of the specified type or the empty collection if none is found.</para>
+        </returns>
         <param name="contractType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of contract for the service endpoint.</param>
       </Docs>
@@ -206,7 +224,6 @@
       </Parameters>
       <Docs>
         <param name="name">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you only need to find the first <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> that satisfies the specified criteria, use one of the <see cref="Overload:System.ServiceModel.Description.ServiceEndpointCollection.Find" /> methods instead.</para>
@@ -215,6 +232,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of all the service endpoints for a specified service name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Collections.ObjectModel.Collection`1" /> of type <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> that contains service endpoints with the specified contract name and namespace or the empty collection if none is found.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InsertItem">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/TypedMessageConverter.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/TypedMessageConverter.xml
index 2fe979bff2e..6dd0204a6d9 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/TypedMessageConverter.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/TypedMessageConverter.xml
@@ -53,12 +53,15 @@
       </Parameters>
       <Docs>
         <param name="type">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Represents a static method that returns a <see cref="T:System.ServiceModel.Description.TypedMessageConverter" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Description.TypedMessageConverter" /> instance.</para>
+        </returns>
         <param name="action">
           <attribution license="cc4" from="Microsoft" modified="false" />An action string.</param>
       </Docs>
@@ -80,12 +83,15 @@
       </Parameters>
       <Docs>
         <param name="type">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Represents a static method that returns a <see cref="T:System.ServiceModel.Description.TypedMessageConverter" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Description.TypedMessageConverter" /> instance.</para>
+        </returns>
         <param name="action">
           <attribution license="cc4" from="Microsoft" modified="false" />An action string.</param>
         <param name="formatterAttribute">
@@ -109,12 +115,15 @@
       </Parameters>
       <Docs>
         <param name="type">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Represents a static method that returns a <see cref="T:System.ServiceModel.Description.TypedMessageConverter" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Description.TypedMessageConverter" /> instance.</para>
+        </returns>
         <param name="action">
           <attribution license="cc4" from="Microsoft" modified="false" />An action string.</param>
         <param name="formatterAttribute">
@@ -138,12 +147,15 @@
       </Parameters>
       <Docs>
         <param name="type">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Represents a static method that returns a <see cref="T:System.ServiceModel.Description.TypedMessageConverter" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Description.TypedMessageConverter" /> instance.</para>
+        </returns>
         <param name="action">
           <attribution license="cc4" from="Microsoft" modified="false" />An action string.</param>
         <param name="defaultNamespace">
@@ -168,12 +180,15 @@
       </Parameters>
       <Docs>
         <param name="type">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Represents a static method that returns a <see cref="T:System.ServiceModel.Description.TypedMessageConverter" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Description.TypedMessageConverter" /> instance.</para>
+        </returns>
         <param name="action">
           <attribution license="cc4" from="Microsoft" modified="false" />An action string.</param>
         <param name="defaultNamespace">
@@ -200,12 +215,15 @@
       </Parameters>
       <Docs>
         <param name="type">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Represents a static method that returns a <see cref="T:System.ServiceModel.Description.TypedMessageConverter" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Description.TypedMessageConverter" /> instance.</para>
+        </returns>
         <param name="action">
           <attribution license="cc4" from="Microsoft" modified="false" />An action string.</param>
         <param name="defaultNamespace">
@@ -228,7 +246,6 @@
         <Parameter Name="message" Type="System.ServiceModel.Channels.Message" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method takes an untyped indigo1 message, that is, an instance of <see cref="T:System.ServiceModel.Channels.Message" />, and converts it into a typed message, that is, an instance of a type that is annotated by the <see cref="T:System.ServiceModel.MessageContractAttribute" />.</para>
@@ -237,6 +254,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a typed message from the specified <see cref="T:System.ServiceModel.Channels.Message" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is a typed message.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />An untyped message.</param>
       </Docs>
@@ -255,12 +276,15 @@
         <Parameter Name="typedMessage" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.ServiceModel.Channels.Message" /> instance from the specified typed message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.Message" /> instance.</para>
+        </returns>
         <param name="typedMessage">
           <attribution license="cc4" from="Microsoft" modified="false" />A typed message.</param>
       </Docs>
@@ -280,12 +304,15 @@
         <Parameter Name="version" Type="System.ServiceModel.Channels.MessageVersion" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.ServiceModel.Channels.Message" /> instance from the specified typed message using the specified version.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.Message" /> instance.</para>
+        </returns>
         <param name="typedMessage">
           <attribution license="cc4" from="Microsoft" modified="false" />A typed message.</param>
         <param name="version">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/WsdlContractConversionContext.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/WsdlContractConversionContext.xml
index 6b97134b906..e52f638587f 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/WsdlContractConversionContext.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/WsdlContractConversionContext.xml
@@ -59,12 +59,15 @@
         <Parameter Name="operationMessage" Type="System.Web.Services.Description.OperationMessage" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the message description for the specified message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The message description for the specified message.</para>
+        </returns>
         <param name="operationMessage">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.OperationMessage" /> for the requested <see cref="T:System.ServiceModel.Description.MessageDescription" />.</param>
       </Docs>
@@ -83,12 +86,15 @@
         <Parameter Name="operation" Type="System.ServiceModel.Description.OperationDescription" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the operation for the specified operation description.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The operation for the specified operation description.</para>
+        </returns>
         <param name="operation">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Description.OperationDescription" /> for the requested <see cref="T:System.Web.Services.Description.Operation" />.</param>
       </Docs>
@@ -107,12 +113,15 @@
         <Parameter Name="operation" Type="System.Web.Services.Description.Operation" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the operation description associated with the operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The operation description associated with the operation.</para>
+        </returns>
         <param name="operation">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.Operation" /> for the requested <see cref="T:System.ServiceModel.Description.OperationDescription" />.</param>
       </Docs>
@@ -131,12 +140,15 @@
         <Parameter Name="message" Type="System.ServiceModel.Description.MessageDescription" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Web.Services.Description.OperationMessage" /> object for the specified <paramref name="message" /> that represents a message type passed by the action of an XML Web service.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Services.Description.OperationMessage" /> object that represents a message type passed by the action of an XML Web service.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Description.MessageDescription" /> for the requested <see cref="T:System.Web.Services.Description.OperationMessage" />.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/WsdlEndpointConversionContext.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/WsdlEndpointConversionContext.xml
index e8802bafcc9..8a6f70f91de 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/WsdlEndpointConversionContext.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/WsdlEndpointConversionContext.xml
@@ -117,7 +117,6 @@
         <Parameter Name="message" Type="System.ServiceModel.Description.MessageDescription" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is the inverse of the <see cref="M:System.ServiceModel.Description.WsdlEndpointConversionContext.GetMessageDescription(System.Web.Services.Description.MessageBinding)" /> method.</para>
@@ -126,6 +125,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the WSDL binding for the message specified by the description.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.Services.Description.MessageBinding" /> for the message specified by the description.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Description.MessageDescription" /> associated with the description.</param>
       </Docs>
@@ -145,7 +148,6 @@
       </Parameters>
       <Docs>
         <param name="message">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is the inverse of the <see cref="M:System.ServiceModel.Description.WsdlEndpointConversionContext.GetMessageBinding(System.ServiceModel.Description.MessageDescription)" /> method.</para>
@@ -154,6 +156,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the message description for the message specified by the WSDL binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Description.MessageDescription" /> for the message specified by the binding.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOperationBinding">
@@ -170,7 +176,6 @@
         <Parameter Name="operation" Type="System.ServiceModel.Description.OperationDescription" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is the inverse of the <see cref="M:System.ServiceModel.Description.WsdlEndpointConversionContext.GetOperationDescription(System.Web.Services.Description.OperationBinding)" /> method.</para>
@@ -179,6 +184,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the WSDL binding for the operation specified by the description.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.Services.Description.OperationBinding" /> for the operation specified by the description.</para>
+        </returns>
         <param name="operation">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Description.OperationDescription" /> of the operation associated with the binding.</param>
       </Docs>
@@ -198,7 +207,6 @@
       </Parameters>
       <Docs>
         <param name="operation">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is the inverse of the <see cref="M:System.ServiceModel.Description.WsdlEndpointConversionContext.GetOperationBinding(System.ServiceModel.Description.OperationDescription)" /> method.</para>
@@ -207,6 +215,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the operation description of the operation associated with the WSDL binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Description.OperationDescription" /> of the operation associated with the binding.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="WsdlBinding">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/WsdlExporter.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/WsdlExporter.xml
index b8522ce2a48..65e063f2cb1 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/WsdlExporter.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/WsdlExporter.xml
@@ -192,7 +192,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.ServiceModel.Description.WsdlExporter.GetGeneratedMetadata" /> property to get a collection of all the metadata generated as a result of any number of calls to <see cref="M:System.ServiceModel.Description.WsdlExporter.ExportContract(System.ServiceModel.Description.ContractDescription)" />, <see cref="M:System.ServiceModel.Description.WsdlExporter.ExportEndpoint(System.ServiceModel.Description.ServiceEndpoint)" />, or <see cref="M:System.ServiceModel.Description.WsdlExporter.ExportEndpoints(System.Collections.Generic.IEnumerable{System.ServiceModel.Description.ServiceEndpoint},System.Xml.XmlQualifiedName)" />. </para>
@@ -202,6 +201,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerable collection of generated <see cref="T:System.ServiceModel.Description.MetadataSection" /> objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerable collection of generated <see cref="T:System.ServiceModel.Description.MetadataSection" /> objects that represents the metadata generated as a result of calls to <see cref="M:System.ServiceModel.Description.WsdlExporter.ExportContract(System.ServiceModel.Description.ContractDescription)" />, <see cref="M:System.ServiceModel.Description.WsdlExporter.ExportEndpoint(System.ServiceModel.Description.ServiceEndpoint)" />, or <see cref="M:System.ServiceModel.Description.WsdlExporter.ExportEndpoints(System.Collections.Generic.IEnumerable{System.ServiceModel.Description.ServiceEndpoint},System.Xml.XmlQualifiedName)" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/WsdlImporter.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/WsdlImporter.xml
index 3d5582dbfc7..f8ef35e5ad6 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/WsdlImporter.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/WsdlImporter.xml
@@ -104,7 +104,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.ServiceModel.Description.WsdlImporter.ImportAllBindings" /> method to import all binding information from the metadata documents and return them as <see cref="T:System.ServiceModel.Channels.Binding" /> objects. Check the <see cref="P:System.ServiceModel.Description.MetadataImporter.Errors" /> property to determine whether there are any import errors before using the returned objects.</para>
@@ -114,6 +113,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a set of <see cref="T:System.ServiceModel.Channels.Binding" /> objects imported from the metadata documents.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A set of <see cref="T:System.ServiceModel.Channels.Binding" /> objects imported from the metadata documents.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ImportAllContracts">
@@ -128,7 +131,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.ServiceModel.Description.WsdlImporter.ImportAllContracts" /> method to import all WSDL port type information from the metadata documents and return them as <see cref="T:System.ServiceModel.Description.ContractDescription" /> objects. It is recommended to check the <see cref="P:System.ServiceModel.Description.MetadataImporter.Errors" /> property to determine whether there are any import errors before using the returned objects.</para>
@@ -138,6 +140,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a set of <see cref="T:System.ServiceModel.Description.ContractDescription" /> objects that represent port type information in the metadata documents.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A set of <see cref="T:System.ServiceModel.Description.ContractDescription" /> objects that represent port type information in the metadata documents.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ImportAllEndpoints">
@@ -152,7 +158,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.ServiceModel.Description.WsdlImporter.ImportAllEndpoints" /> method to import all endpoint information from the metadata documents and return them as a collection of <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> objects. Check the <see cref="P:System.ServiceModel.Description.MetadataImporter.Errors" /> property to determine whether there are any import errors before using the returned objects.</para>
@@ -162,6 +167,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.ServiceModel.Description.ServiceEndpointCollection" /> that represents the endpoints in WSDL documents.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Description.ServiceEndpointCollection" /> that represents the endpoints in WSDL documents.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ImportBinding">
@@ -179,7 +188,6 @@
       </Parameters>
       <Docs>
         <param name="binding">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.ServiceModel.Description.WsdlImporter.ImportBinding(System.Web.Services.Description.Binding)" /> method to use a <see cref="T:System.Web.Services.Description.Binding" /> object to locate binding information in the metadata and return that binding information as a <see cref="T:System.ServiceModel.Channels.Binding" /> object. Check the <see cref="P:System.ServiceModel.Description.MetadataImporter.Errors" /> property to determine whether there are any import errors before using the returned object.</para>
@@ -188,6 +196,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.ServiceModel.Channels.Binding" /> object that represents binding information from a set of metadata documents.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.Binding" /> object that represents binding information from a set of metadata documents.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ImportContract">
@@ -205,7 +217,6 @@
       </Parameters>
       <Docs>
         <param name="wsdlPortType">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.ServiceModel.Description.WsdlImporter.ImportContract(System.Web.Services.Description.PortType)" /> method to use a <see cref="T:System.Web.Services.Description.PortType" /> object to locate port type information in the metadata and return that information as a <see cref="T:System.ServiceModel.Description.ContractDescription" /> object. Check the <see cref="P:System.ServiceModel.Description.MetadataImporter.Errors" /> property to determine whether there are any import errors before using the returned object.</para>
@@ -214,6 +225,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.ServiceModel.Description.ContractDescription" /> object that represents metadata located by the specified port type information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Description.ContractDescription" /> object that represents metadata located by the specified port type information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ImportEndpoint">
@@ -231,7 +246,6 @@
       </Parameters>
       <Docs>
         <param name="wsdlPort">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.ServiceModel.Description.WsdlImporter.ImportEndpoint(System.Web.Services.Description.Port)" /> method to use a <see cref="T:System.Web.Services.Description.Port" /> object to locate port type information in the metadata and return that information as a <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> object. Check the <see cref="P:System.ServiceModel.Description.MetadataImporter.Errors" /> property to determine whether there are any import errors before using the returned object.</para>
@@ -240,6 +254,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> from a set of metadata documents that uses information from the specified <see cref="T:System.Web.Services.Description.Port" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> object that represents specific WSDL port information in the metadata document.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ImportEndpoints">
@@ -257,7 +275,6 @@
       </Parameters>
       <Docs>
         <param name="binding">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Check the <see cref="P:System.ServiceModel.Description.MetadataImporter.Errors" /> property to determine whether there are any import errors before using the returned object.</para>
@@ -266,6 +283,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.ServiceModel.Description.ServiceEndpointCollection" /> that represents all WSDL port types using the specified <see cref="T:System.Web.Services.Description.Binding" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Description.ServiceEndpointCollection" /> that represents all WSDL port types using the specified <see cref="T:System.Web.Services.Description.Binding" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ImportEndpoints">
@@ -283,7 +304,6 @@
       </Parameters>
       <Docs>
         <param name="portType">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Check the <see cref="P:System.ServiceModel.Description.MetadataImporter.Errors" /> property to determine whether there are any import errors before using the returned object.</para>
@@ -292,6 +312,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.ServiceModel.Description.ServiceEndpointCollection" /> that represents all WSDL port types associated with the specified <see cref="T:System.Web.Services.Description.PortType" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Description.ServiceEndpointCollection" /> that represents all WSDL port types associated with the specified <see cref="T:System.Web.Services.Description.PortType" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ImportEndpoints">
@@ -309,7 +333,6 @@
       </Parameters>
       <Docs>
         <param name="service">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Check the <see cref="P:System.ServiceModel.Description.MetadataImporter.Errors" /> property to determine whether there are any import errors before using the returned object.</para>
@@ -318,6 +341,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.ServiceModel.Description.ServiceEndpointCollection" /> that represents all WSDL port types within the specified <see cref="T:System.Web.Services.Description.Service" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Description.ServiceEndpointCollection" /> that represents all WSDL port types within the specified <see cref="T:System.Web.Services.Description.Service" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="WsdlDocuments">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/XmlSerializerOperationBehavior.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/XmlSerializerOperationBehavior.xml
index 539db988f5e..66a1c0439c4 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/XmlSerializerOperationBehavior.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Description/XmlSerializerOperationBehavior.xml
@@ -82,12 +82,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the collection of mappings between XML schema elements and CLR data types.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.ObjectModel.Collection`1" /> of <see cref="T:System.Xml.Serialization.XmlMapping" />s that contains the mappings.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ServiceModel.Description.IOperationBehavior.AddBindingParameters">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/ActionMessageFilter.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/ActionMessageFilter.xml
index 643204cfdec..4e11160c97f 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/ActionMessageFilter.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/ActionMessageFilter.xml
@@ -93,7 +93,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method returns an instance of <see cref="T:System.ServiceModel.Dispatcher.IMessageFilterTable`1" />. </para>
@@ -103,6 +102,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new filter table that tests efficiently on message actions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Dispatcher.IMessageFilterTable`1" /> object to which <see cref="T:System.ServiceModel.Dispatcher.ActionMessageFilter" />s and associated <paramref name="FilterData" /> can be added.</para>
+        </returns>
         <typeparam name="FilterData">
           <attribution license="cc4" from="Microsoft" modified="false" />Data associated with the filters in the table.</typeparam>
       </Docs>
@@ -121,7 +124,6 @@
         <Parameter Name="message" Type="System.ServiceModel.Channels.Message" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this overload of <see cref="Overload:System.ServiceModel.Dispatcher.ActionMessageFilter.Match" /> when a message must be tested against the actions in a single filter and the <see cref="T:System.ServiceModel.Channels.Message" /> is available.</para>
@@ -130,6 +132,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether a message's action matches one of the actions specified in this <see cref="T:System.ServiceModel.Dispatcher.ActionMessageFilter" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ServiceModel.Channels.Message" /> action header matches one of the specified actions; otherwise, false.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.Message" /> to test.</param>
       </Docs>
@@ -149,7 +155,6 @@
       </Parameters>
       <Docs>
         <param name="buffer">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this overload of the <see cref="Overload:System.ServiceModel.Dispatcher.ActionMessageFilter.Match" /> method when a message must be tested against the actions in a single filter and the <see cref="T:System.ServiceModel.Channels.MessageBuffer" /> is available.</para>
@@ -158,6 +163,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether a buffered message's action header matches one of the actions specified in this <see cref="T:System.ServiceModel.Dispatcher.ActionMessageFilter" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ServiceModel.Channels.MessageBuffer" /> action header matches one of the specified actions; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/ChannelDispatcher.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/ChannelDispatcher.xml
index 730a36996b3..ee37899b9ec 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/ChannelDispatcher.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/ChannelDispatcher.xml
@@ -516,12 +516,15 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to close a channel listener for the dispatcher that must be completed within a specified interval of time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous operation to close a channel listener for the dispatcher. </para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies how long the close operation has to complete before timing out.</param>
         <param name="callback">
@@ -546,7 +549,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The channel dispatcher must be associated with a non-null service host when this method is called.</para>
@@ -555,6 +557,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to open a channel listener for the dispatcher that must be completed within a specified interval of time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous operation to open a channel listener for the dispatcher. </para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies how long the open operation has to complete before timing out.</param>
         <param name="callback">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/EndpointAddressMessageFilter.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/EndpointAddressMessageFilter.xml
index 9bd68aff44d..4304e421bff 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/EndpointAddressMessageFilter.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/EndpointAddressMessageFilter.xml
@@ -117,7 +117,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method returns an instance of <see cref="T:System.ServiceModel.Dispatcher.IMessageFilterTable`1" /> that is optimized to test for specific message endpoints.</para>
@@ -127,6 +126,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new filter table that tests a message against multiple endpoint addresses simultaneously.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that implements the <see cref="T:System.ServiceModel.Dispatcher.IMessageFilterTable`1" /> interface that can contain <see cref="T:System.ServiceModel.Dispatcher.EndpointAddressMessageFilter" />s with associated <paramref name="FilterData" />. </para>
+        </returns>
         <typeparam name="FilterData">
           <attribution license="cc4" from="Microsoft" modified="false" />Data associated with the filters in the table.</typeparam>
       </Docs>
@@ -182,7 +185,6 @@
         <Parameter Name="message" Type="System.ServiceModel.Channels.Message" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The two overloads of this method are equivalent because they both examine only message headers.</para>
@@ -191,6 +193,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether a message satisfies the specified endpoint address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ServiceModel.Channels.Message" /> object satisfies the endpoint address specified in the filter; otherwise, false. </para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.Message" /> object to test.</param>
       </Docs>
@@ -209,7 +215,6 @@
         <Parameter Name="messageBuffer" Type="System.ServiceModel.Channels.MessageBuffer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The two overloads of this method are equivalent because they both examine only message headers. The only reason to use this overload is if you already had a <paramref name="messageBuffer" /> available and not a message, because this method converts the <paramref name="messageBuffer" /> into a message.</para>
@@ -218,6 +223,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether a buffered message satisfies the specified endpoint address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ServiceModel.Channels.MessageBuffer" /> object satisfies the endpoint address; otherwise, false. </para>
+        </returns>
         <param name="messageBuffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.MessageBuffer" /> object to test.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/ExceptionHandler.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/ExceptionHandler.xml
index c6ea59da006..25046f3f3e5 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/ExceptionHandler.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/ExceptionHandler.xml
@@ -99,7 +99,6 @@
       </Parameters>
       <Docs>
         <param name="e">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ServiceModel.Dispatcher.ExceptionHandler.HandleException(System.Exception)" /> property returns true if the exception has been handled. If it returns false or throws a different exception, the original exception is rethrown.</para>
@@ -108,6 +107,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns true if the exception has been handled, or false if the exception should be rethrown and the application terminated. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the exception has been handled; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TransportExceptionHandler">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/ICallContextInitializer.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/ICallContextInitializer.xml
index e0e7f26e877..ebbda6a6cd6 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/ICallContextInitializer.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/ICallContextInitializer.xml
@@ -60,7 +60,6 @@
         <Parameter Name="message" Type="System.ServiceModel.Channels.Message" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implement the <see cref="M:System.ServiceModel.Dispatcher.ICallContextInitializer.BeforeInvoke(System.ServiceModel.InstanceContext,System.ServiceModel.IClientChannel,System.ServiceModel.Channels.Message)" /> method to initialize and clean up thread-local storage for the thread that invokes user code. Typical usage is to set some value, such as impersonation or changing the <see cref="T:System.Globalization.CultureInfo" />. If you wanted to establish some custom context, this is the extension point to initialize the static context property, which is then available for developers in the course of the operation.</para>
@@ -69,6 +68,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implement to participate in the initialization of the operation thread.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A correlation object passed back as the parameter of the <see cref="M:System.ServiceModel.Dispatcher.ICallContextInitializer.AfterInvoke(System.Object)" /> method.</para>
+        </returns>
         <param name="instanceContext">
           <attribution license="cc4" from="Microsoft" modified="false" />The service instance for the operation.</param>
         <param name="channel">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IClientMessageFormatter.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IClientMessageFormatter.xml
index e9768e6f839..01c1bc86560 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IClientMessageFormatter.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IClientMessageFormatter.xml
@@ -35,7 +35,6 @@
       </Parameters>
       <Docs>
         <param name="paremeters">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called after a reply message is received. Implement to convert the reply message into a return value (and any out parameters) that is returned to the calling application.</para>
@@ -44,6 +43,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a message into a return value and out parameters that are passed back to the calling operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value of the operation.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The inbound message.</param>
       </Docs>
@@ -65,7 +68,6 @@
       <Docs>
         <param name="version">To be added.</param>
         <param name="inputs">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called after an operation is invoked on the client but prior to serializing the outbound message. Implement to convert the parameter objects into the outbound message.</para>
@@ -74,6 +76,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an <see cref="T:System.Object" /> array into an outbound <see cref="T:System.ServiceModel.Channels.Message" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The SOAP message sent to the service operation.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IClientOperationSelector.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IClientOperationSelector.xml
index f67e92f6bdd..520c0e82628 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IClientOperationSelector.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IClientOperationSelector.xml
@@ -55,12 +55,15 @@
         <Parameter Name="parameters" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the selected operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The operation selected by the custom operation selector.</para>
+        </returns>
         <param name="method">
           <attribution license="cc4" from="Microsoft" modified="false" />The method invoked.</param>
         <param name="parameters">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IDispatchMessageFormatter.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IDispatchMessageFormatter.xml
index 95030b6ed5a..69e71d1ea60 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IDispatchMessageFormatter.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IDispatchMessageFormatter.xml
@@ -61,12 +61,15 @@
       </Parameters>
       <Docs>
         <param name="version">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serializes a reply message from a specified message version, array of parameters, and a return value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The serialized reply message.</para>
+        </returns>
         <param name="parameters">
           <attribution license="cc4" from="Microsoft" modified="false" />The out parameters.</param>
         <param name="result">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IErrorHandler.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IErrorHandler.xml
index 3c69ba76170..899924b2920 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IErrorHandler.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IErrorHandler.xml
@@ -46,7 +46,6 @@
       </Parameters>
       <Docs>
         <param name="exception">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.ServiceModel.Dispatcher.IErrorHandler.HandleError(System.Exception)" /> method to implement error-related behaviors such as error logging, system notifications, shutting down the application, and so on, and return a value that specifies whether the exception has been handled appropriately. </para>
@@ -62,6 +61,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Enables error-related processing and returns a value that indicates whether the dispatcher aborts the session and the instance context in certain cases. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if indigo1 should not abort the session (if there is one) and instance context if the instance context is not <see cref="F:System.ServiceModel.InstanceContextMode.Single" />; otherwise, false. The default is false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ProvideFault">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IInstanceContextProvider.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IInstanceContextProvider.xml
index 0f936c28742..19c0acaaf5f 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IInstanceContextProvider.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IInstanceContextProvider.xml
@@ -38,7 +38,6 @@
         <Parameter Name="channel" Type="System.ServiceModel.IContextChannel" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ServiceModel.Dispatcher.IInstanceContextProvider.GetExistingInstanceContext(System.ServiceModel.Channels.Message,System.ServiceModel.IContextChannel)" /> method is called when a message is received. Return the <see cref="T:System.ServiceModel.InstanceContext" /> object that you want to process the message, or null. In the case of null, indigo2 creates a new <see cref="T:System.ServiceModel.InstanceContext" /> object for the message and then calls the <see cref="M:System.ServiceModel.Dispatcher.IInstanceContextProvider.InitializeInstanceContext(System.ServiceModel.InstanceContext,System.ServiceModel.Channels.Message,System.ServiceModel.IContextChannel)" /> method.</para>
@@ -48,6 +47,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called when a new message is received.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.InstanceContext" /> object that is used to process the message; return null to instruct indigo2 to create a new <see cref="T:System.ServiceModel.InstanceContext" /> object.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The incoming message.</param>
         <param name="channel">
@@ -101,7 +104,6 @@
         <Parameter Name="instanceContext" Type="System.ServiceModel.InstanceContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -112,6 +114,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called when all <see cref="T:System.ServiceModel.InstanceContext" /> activities have completed to enable implementers to prevent the <see cref="T:System.ServiceModel.InstanceContext" /> from being recycled.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if indigo1 is to close and recycle the <see cref="T:System.ServiceModel.InstanceContext" /> object and adjust the value of <see cref="P:System.ServiceModel.Dispatcher.ServiceThrottle.MaxConcurrentInstances" />; otherwise, false.</para>
+        </returns>
         <param name="instanceContext">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.InstanceContext" /> object that is considered idle.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IInstanceProvider.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IInstanceProvider.xml
index 40ffe2fee3f..75cec60cd50 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IInstanceProvider.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IInstanceProvider.xml
@@ -42,7 +42,6 @@
       </Parameters>
       <Docs>
         <param name="context">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.ServiceModel.Dispatcher.IInstanceProvider.GetInstance(System.ServiceModel.InstanceContext)" /> method to control the exact service object that a indigo2 service receives when it attempts to create a new one.</para>
@@ -51,6 +50,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a service object given the specified <see cref="T:System.ServiceModel.InstanceContext" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A user-defined service object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetInstance">
@@ -69,7 +72,6 @@
       </Parameters>
       <Docs>
         <param name="context">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.ServiceModel.Dispatcher.IInstanceProvider.GetInstance(System.ServiceModel.InstanceContext,System.ServiceModel.Channels.Message)" /> method to control the exact service object that a indigo2 service receives when it attempts to create a new one.</para>
@@ -78,6 +80,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a service object given the specified <see cref="T:System.ServiceModel.InstanceContext" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The service object.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The message that triggered the creation of a service object.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IInteractiveChannelInitializer.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IInteractiveChannelInitializer.xml
index 8abd0fa3714..9ee5840fc7f 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IInteractiveChannelInitializer.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IInteractiveChannelInitializer.xml
@@ -71,7 +71,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To implement <see cref="T:System.ServiceModel.Dispatcher.IInteractiveChannelInitializer" />, perform the following steps in <see cref="M:System.ServiceModel.Dispatcher.IInteractiveChannelInitializer.BeginDisplayInitializationUI(System.ServiceModel.IClientChannel,System.AsyncCallback,System.Object)" />:</para>
@@ -91,6 +90,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An asynchronous call to begin using a user interface to obtain credential information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> to use to call back when processing has completed.</para>
+        </returns>
         <param name="channel">
           <attribution license="cc4" from="Microsoft" modified="false" />The client channel.</param>
         <param name="callback">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IMessageFilterTable`1.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IMessageFilterTable`1.xml
index 44a7615dc13..b690db835de 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IMessageFilterTable`1.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IMessageFilterTable`1.xml
@@ -183,7 +183,6 @@
         <Parameter Name="results" Type="System.Collections.Generic.ICollection&lt;System.ServiceModel.Dispatcher.MessageFilter&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method when more than one filter is expected to match the message, the matching filters are required, and the body of the message does not have to be inspected.</para>
@@ -192,6 +191,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the match criterion of a filter in the table is satisfied by the specified message, and adds the matching filters to a collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the match criterion of at least one filter in the table is satisfied by <paramref name="message" />; false if no filter is satisfied.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.Message" /> to test.</param>
         <param name="results">
@@ -214,7 +217,6 @@
       </Parameters>
       <Docs>
         <param name="buffer">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method when more than one filter is expected to match the buffered message, the matching filter is required, and the body of the message may have to be inspected.</para>
@@ -223,6 +225,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the match criterion of a filter in the table is satisfied by the specified buffered message, and adds the matching filters to a collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the match criterion of at least one filter in the table is satisfied by <paramref name="messageBuffer" />; false if no filter is satisfied.</para>
+        </returns>
         <param name="results">
           <attribution license="cc4" from="Microsoft" modified="false" />Reference parameter that stores the <see cref="T:System.ServiceModel.Dispatcher.MessageFilter" /> objects that match in <see cref="T:System.Collections.Generic.ICollection`1" />&lt;Filter&gt;.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IOperationInvoker.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IOperationInvoker.xml
index 0415cc4c153..36dcac2e0aa 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IOperationInvoker.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IOperationInvoker.xml
@@ -30,7 +30,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implement this to return an array of parameters for the operation. This array is filled by the formatter and passed back to the invoker when <see cref="M:System.ServiceModel.Dispatcher.IOperationInvoker.Invoke(System.Object,System.Object[],System.Object[]@)" /> is called.</para>
@@ -39,6 +38,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Array" /> of parameter objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The parameters that are to be used as arguments to the operation.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Invoke">
@@ -82,12 +85,15 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An asynchronous implementation of the <see cref="M:System.ServiceModel.Dispatcher.IOperationInvoker.Invoke(System.Object,System.Object[],System.Object[]@)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IAsyncResult" /> used to complete the asynchronous call.</para>
+        </returns>
         <param name="instance">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be invoked.</param>
         <param name="inputs">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IParameterInspector.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IParameterInspector.xml
index baf61a0cadf..5c46ef3b669 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IParameterInspector.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/IParameterInspector.xml
@@ -73,7 +73,6 @@
         <Parameter Name="inputs" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>On outbound calls from a client, the inspector is invoked before the request contents are serialized and sent to the service. The inspector is also called after the response has been deserialized but before the return values have been dispatched to the proxy method. </para>
@@ -83,6 +82,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called before client calls are sent and after service responses are returned.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The correlation state that is returned as the <paramref name="correlationState" /> parameter in <see cref="M:System.ServiceModel.Dispatcher.IParameterInspector.AfterCall(System.String,System.Object[],System.Object,System.Object)" />. Return null if you do not intend to use correlation state.</para>
+        </returns>
         <param name="operationName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the operation.</param>
         <param name="inputs">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/MatchAllMessageFilter.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/MatchAllMessageFilter.xml
index 3e26c0ab8ba..f1cba03060f 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/MatchAllMessageFilter.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/MatchAllMessageFilter.xml
@@ -59,7 +59,6 @@
         <Parameter Name="message" Type="System.ServiceModel.Channels.Message" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The difference between the two overloads of the <see cref="Overload:System.ServiceModel.Dispatcher.MatchAllMessageFilter.Match" /> method is that one takes the <see cref="T:System.ServiceModel.Channels.MessageBuffer" /> parameter and buffers the entire contents of a message (including its body) into memory, while the other takes the <see cref="T:System.ServiceModel.Channels.Message" /> parameter and does not buffer the body.</para>
@@ -68,6 +67,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns true for every message that is not null.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.Message" /> object to test.</param>
       </Docs>
@@ -87,7 +90,6 @@
       </Parameters>
       <Docs>
         <param name="buffer">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method takes the <see cref="T:System.ServiceModel.Channels.MessageBuffer" /> parameter, which buffers the entire contents of a message (including its body) into memory, and allows the body to be inspected.</para>
@@ -96,6 +98,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ServiceModel.Dispatcher.MatchAllMessageFilter.Match(System.ServiceModel.MessageBuffer)" /> method returns true for every message that is not null.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/MatchNoneMessageFilter.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/MatchNoneMessageFilter.xml
index 81868b183f6..0ac4318e684 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/MatchNoneMessageFilter.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/MatchNoneMessageFilter.xml
@@ -59,7 +59,6 @@
         <Parameter Name="message" Type="System.ServiceModel.Channels.Message" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The difference between the two overloads of the <see cref="Overload:System.ServiceModel.Dispatcher.MatchNoneMessageFilter.Match" /> method is that one takes the <see cref="T:System.ServiceModel.Channels.MessageBuffer" /> parameter and buffers the entire contents of a message (including its body) into memory, while the other takes the <see cref="T:System.ServiceModel.Channels.Message" /> parameter and does not buffer the body.</para>
@@ -68,6 +67,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns false for every message that is not null.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns false.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.Message" /> object to test.</param>
       </Docs>
@@ -87,7 +90,6 @@
       </Parameters>
       <Docs>
         <param name="buffer">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method takes the <see cref="T:System.ServiceModel.Channels.MessageBuffer" /> parameter, which buffers the entire contents of a message (including its body) into memory, and allows the body to be inspected.</para>
@@ -96,6 +98,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns false for every message that is not null.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns false.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/MessageFilter.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/MessageFilter.xml
index bb526981181..249e87b411d 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/MessageFilter.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/MessageFilter.xml
@@ -100,7 +100,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is intended to be called by <see cref="T:System.ServiceModel.Dispatcher.MessageFilterTable`1" />. Users should create a filter table by calling a constructor for the filter table. The default implementation of this method returns a filter table that calls the <see cref="Overload:System.ServiceModel.Dispatcher.MessageFilter.Match" /> method of each filter sequentially. Override this method to associate a custom filter table when implementing a filter.</para>
@@ -109,6 +108,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a filter table for a filter that has a specified type of data associated with it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Dispatcher.IMessageFilterTable`1" /> object to which filters associated with <paramref name="FilterData" /> can be added.</para>
+        </returns>
         <typeparam name="FilterData">
           <attribution license="cc4" from="Microsoft" modified="false" />Data associated with the filters in the table.</typeparam>
       </Docs>
@@ -127,7 +130,6 @@
         <Parameter Name="message" Type="System.ServiceModel.Channels.Message" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method cannot inspect the contents of the message body.</para>
@@ -136,6 +138,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, tests whether a message satisfies the filter criteria. The body cannot be examined.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ServiceModel.Channels.Message" /> object satisfies the filter criteria; otherwise, false.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.Message" /> object to test. </param>
       </Docs>
@@ -154,7 +160,6 @@
         <Parameter Name="buffer" Type="System.ServiceModel.Channels.MessageBuffer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The message must be fully buffered if the body is to be inspected by the filter. The body of the <see cref="T:System.ServiceModel.Channels.MessageBuffer" /> is fully buffered and therefore can be inspected by a filter. The body of a <see cref="T:System.ServiceModel.Channels.Message" /> that has not been fully buffered may be consumed by the filter inspection. The header element of a <see cref="T:System.ServiceModel.Channels.Message" /> is automatically buffered and therefore can be inspected without being consumed.</para>
@@ -163,6 +168,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, tests whether a buffered message satisfies the criteria of a filter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ServiceModel.Channels.MessageBuffer" /> object satisfies the filter criteria; otherwise, false.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.MessageBuffer" /> object to test. </param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/MessageFilterTable`1.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/MessageFilterTable`1.xml
index 0441c5b4b88..2041abdf713 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/MessageFilterTable`1.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/MessageFilterTable`1.xml
@@ -205,7 +205,6 @@
         <Parameter Name="filter" Type="System.ServiceModel.Dispatcher.MessageFilter" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method implements the ContainsKey method of <see cref="T:System.Collections.Generic.IDictionary`2" />.</para>
@@ -214,6 +213,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the filter table contains a specified filter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="filter" /> is contained in the filter table; otherwise false.</para>
+        </returns>
         <param name="filter">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Dispatcher.MessageFilter" /> being tested for.</param>
       </Docs>
@@ -275,12 +278,15 @@
         <Parameter Name="filter" Type="System.ServiceModel.Dispatcher.MessageFilter" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Instantiates a filter table for a specified type of filter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Dispatcher.IMessageFilterTable`1" /> that is created that contains the specified filter.</para>
+        </returns>
         <param name="filter">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Dispatcher.MessageFilter" /> to be contained in the filter table created.</param>
       </Docs>
@@ -324,7 +330,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method implements the GetEnumerator method of <see cref="T:System.Collections.IEnumerable" />.</para>
@@ -333,6 +338,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the filter table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerator`1" />&lt;KeyValuePair&lt;Filter, <paramref name="FilterData" />&gt;&gt; that can be used to iterate through the filter table.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetMatchingFilter">
@@ -394,7 +403,6 @@
         <Parameter Name="results" Type="System.Collections.Generic.ICollection&lt;System.ServiceModel.Dispatcher.MessageFilter&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method when more than one filter is expected to match the message and the matching filters are required.</para>
@@ -407,6 +415,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the match criterion of an <see cref="T:System.ServiceModel.Dispatcher.MessageFilter" /> in the table is satisfied by the specified message, and adds the matching filters to a collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if match criterion of at least one <see cref="T:System.ServiceModel.Dispatcher.MessageFilter" /> in the table is satisfied by <paramref name="message" />; false if no filter is satisfied.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.Message" /> to test.</param>
         <param name="results">
@@ -428,7 +440,6 @@
         <Parameter Name="results" Type="System.Collections.Generic.ICollection&lt;System.ServiceModel.Dispatcher.MessageFilter&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method when more than one filter is expected to match the buffered message and the matching filters are required.</para>
@@ -440,6 +451,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the match criterion of at least one filter in the table is satisfied by the specified buffered message and adds the matching filters from the highest priority set of filters in which at least one match is found to a collection. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if match criterion of at least one filter in the table is satisfied by <paramref name="message" />; false if no filter is satisfied.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.MessageBuffer" /> to test.</param>
         <param name="results">
@@ -548,7 +563,6 @@
         <Parameter Name="filter" Type="System.ServiceModel.Dispatcher.MessageFilter" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The priority is an integer value used to group filters into priority buckets and order their processing. The larger the integer assigned to a filter type, the higher its priority for processing. All the filter tables in a priority bucket are evaluated together. Lower priority buckets are only evaluated if higher priority buckets do not provide any matches.</para>
@@ -557,6 +571,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the priority of a given filter in the table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The priority of the <paramref name="filter" />.</para>
+        </returns>
         <param name="filter">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Dispatcher.MessageFilter" /> contained in the filter table created.</param>
       </Docs>
@@ -660,7 +678,6 @@
         <Parameter Name="filter" Type="System.ServiceModel.Dispatcher.MessageFilter" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method implements <see cref="M:System.Collections.Generic.SynchronizedReadOnlyCollection`1.System.Collections.Generic.ICollection`1.Remove(`0)" />.</para>
@@ -669,6 +686,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes a filter and its associated <paramref name="FilterData" /> from the filter table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the filter was found and removed; false if it was not found.</para>
+        </returns>
         <param name="filter">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Dispatcher.MessageFilter" /> to remove.</param>
       </Docs>
@@ -685,7 +706,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method implements <see cref="M:System.Collections.IEnumerable.GetEnumerator" />.</para>
@@ -694,6 +714,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the filter table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerator`1" /> that can be used to iterate through the filter table.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryGetValue">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/PrefixEndpointAddressMessageFilter.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/PrefixEndpointAddressMessageFilter.xml
index 79d9c950d0f..f5f8027b31d 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/PrefixEndpointAddressMessageFilter.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/PrefixEndpointAddressMessageFilter.xml
@@ -118,7 +118,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method returns an instance of <see cref="T:System.ServiceModel.Dispatcher.IMessageFilterTable`1" /> that is optimized to test for specific message endpoints.</para>
@@ -128,6 +127,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new filter table that tests a message against multiple endpoint addresses simultaneously.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that implements the <see cref="T:System.ServiceModel.Dispatcher.IMessageFilterTable`1" /> interface that can contain <see cref="T:System.ServiceModel.Dispatcher.PrefixEndpointAddressMessageFilter" />s with associated <paramref name="FilterData" />. </para>
+        </returns>
         <typeparam name="FilterData">
           <attribution license="cc4" from="Microsoft" modified="false" />Data associated with the filters in the table.</typeparam>
       </Docs>
@@ -183,7 +186,6 @@
         <Parameter Name="message" Type="System.ServiceModel.Channels.Message" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The two overloads of this method are equivalent because this filter does not examine the message body, only the address, to do a longest-prefix match, and then the headers.</para>
@@ -192,6 +194,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether a message satisfies the specified endpoint address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ServiceModel.Channels.Message" /> object satisfies the endpoint address specified in the filter; otherwise, false. </para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.Message" /> object to test.</param>
       </Docs>
@@ -210,7 +216,6 @@
         <Parameter Name="messageBuffer" Type="System.ServiceModel.Channels.MessageBuffer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The two overloads of this method are equivalent because this filter does not examine the message body, only the address, to do a longest-prefix match, and then the headers. </para>
@@ -219,6 +224,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether a buffered message satisfies the specified endpoint address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ServiceModel.Channels.MessageBuffer" /> object satisfies the endpoint address; otherwise, false. </para>
+        </returns>
         <param name="messageBuffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.MessageBuffer" /> object to test.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/SeekableXPathNavigator.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/SeekableXPathNavigator.xml
index dea3971dd2c..25038de7881 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/SeekableXPathNavigator.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/SeekableXPathNavigator.xml
@@ -56,12 +56,15 @@
       <Docs>
         <param name="first">To be added.</param>
         <param name="second">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns a value that describes the document order of the two specified positions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Xml.XmlNodeOrder" /> values that describes the relation of <paramref name="firstPosition" /> to <paramref name="secondPosition" /> in the document.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CurrentPosition">
@@ -101,12 +104,15 @@
       </Parameters>
       <Docs>
         <param name="node_position">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the local name of the node at the position specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The local name of the node at the specified position. <see cref="F:System.String.Empty" /> is returned if the node does not have a local name, for example if the current position references a text node.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetName">
@@ -124,7 +130,6 @@
       </Parameters>
       <Docs>
         <param name="node_position">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The name is the name of the XML element at <paramref name="nodePosition" /> and typically includes a namespace prefix.</para>
@@ -133,6 +138,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the name of the node at the specified position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the node at <paramref name="nodePosition" />. <see cref="F:System.String.Empty" /> is returned if the node does not have a name.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetNamespace">
@@ -150,12 +159,15 @@
       </Parameters>
       <Docs>
         <param name="node_position">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the namespace of the node at the specified position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The namespace of the node at <paramref name="nodePosition" />. <see cref="F:System.String.Empty" /> is returned if the node does not have a namespace.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetNodeType">
@@ -173,12 +185,15 @@
       </Parameters>
       <Docs>
         <param name="node_position">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the type of the node at the specified position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Xml.XPath.XPathNodeType" /> values that indicate the type of the XML node.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetValue">
@@ -196,7 +211,6 @@
       </Parameters>
       <Docs>
         <param name="node_position">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For elements, this method returns the concatenation of all text descendents of the node at the specified position, similar to the <see cref="P:System.Xml.XmlElement.InnerText" /> property.</para>
@@ -205,6 +219,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the text value of the node at the specified position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The text value of the node at <paramref name="nodePosition" />. <see cref="F:System.String.Empty" /> is returned if the node does not have a text value.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/XPathMessageContext.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/XPathMessageContext.xml
index f7a076ae832..919273c9b25 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/XPathMessageContext.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/XPathMessageContext.xml
@@ -310,7 +310,6 @@
       <Docs>
         <param name="uri1">To be added.</param>
         <param name="uri2">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This property should be overridden in a derived class in order to be used.</para>
@@ -319,6 +318,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the base Uniform Resource Identifiers (URIs) of two documents based upon the order the documents were loaded by the XSLT processor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always returns 0.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="PreserveWhitespace">
@@ -335,7 +338,6 @@
         <Parameter Name="node" Type="System.Xml.XPath.XPathNavigator" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This property should be overridden in a derived class in order to be used.</para>
@@ -344,6 +346,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates whether to preserve white space nodes or strip them for the given context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always returns false.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The white space node that is to be preserved or stripped in the current context.</param>
       </Docs>
@@ -364,7 +370,6 @@
         <Parameter Name="argTypes" Type="System.Xml.XPath.XPathResultType[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="ms-help://MS.MSSDK.1033/MS.WinFXSDK.1033/cpref37/html/T_System_Xml_Xsl_IXsltContextFunction.htm">T:System.Xml.Xsl.IXsltContextFunction</see> is used at execution time to evaluate the function.</para>
@@ -373,6 +378,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resolves a function reference and returns an <see cref="ms-help://MS.MSSDK.1033/MS.WinFXSDK.1033/cpref37/html/T_System_Xml_Xsl_IXsltContextFunction.htm">T:System.Xml.Xsl.IXsltContextFunction</see> that represents the function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="ms-help://MS.MSSDK.1033/MS.WinFXSDK.1033/cpref37/html/T_System_Xml_Xsl_IXsltContextFunction.htm">T:System.Xml.Xsl.IXsltContextFunction</see> that represents the function.</para>
+        </returns>
         <param name="prefix">
           <attribution license="cc4" from="Microsoft" modified="false" />The prefix of the function as it appears in the XPath expression.</param>
         <param name="name">
@@ -396,7 +405,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Xml.Xsl.IXsltContextVariable" /> is used at execution time to get the value of the variable.</para>
@@ -405,6 +413,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resolves a variable reference and returns an <see cref="T:System.Xml.Xsl.IXsltContextVariable" /> that represents the variable.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Xsl.IXsltContextVariable" /> that represents the variable at runtime.</para>
+        </returns>
         <param name="prefix">
           <attribution license="cc4" from="Microsoft" modified="false" />The prefix of the variable as it appears in the XPath expression.</param>
         <param name="name">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/XPathMessageFilter.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/XPathMessageFilter.xml
index e11d06fe985..0f45e956957 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/XPathMessageFilter.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/XPathMessageFilter.xml
@@ -219,7 +219,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called by <see cref="T:System.ServiceModel.Dispatcher.MessageFilterTable`1" />. Users should create a filter table by calling a constructor for the filter table. This implementation returns an instance of <see cref="T:System.ServiceModel.Dispatcher.XPathMessageFilterTable`1" />.</para>
@@ -228,6 +227,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.ServiceModel.Dispatcher.XPathMessageFilterTable`1" /> that has a specified type of data associated with it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Dispatcher.IMessageFilterTable`1" /> object to which filters associated with <paramref name="FilterData" /> can be added.</para>
+        </returns>
         <typeparam name="FilterData">
           <attribution license="cc4" from="Microsoft" modified="false" />Data associated with the filters in the table.</typeparam>
       </Docs>
@@ -246,7 +249,6 @@
         <Parameter Name="message" Type="System.ServiceModel.Channels.Message" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.ServiceModel.Dispatcher.XPathMessageFilter.Match(System.ServiceModel.MessageBuffer)" /> method to match elements from the body. An exception is thrown by this method if the engine attempts to access the message body in order to evaluate the XPath expression. This helps to ensure that the filter engine does not access the body stream.</para>
@@ -255,6 +257,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether a specified message satisfies the criteria of the XPath filter. This form is not allowed to access the body of the message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ServiceModel.Channels.Message" /> satisfies the filter criteria; otherwise, false. </para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.Message" /> to test. </param>
       </Docs>
@@ -273,7 +279,6 @@
         <Parameter Name="messageBuffer" Type="System.ServiceModel.Channels.MessageBuffer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this overload of the <see cref="Overload:System.ServiceModel.Dispatcher.XPathMessageFilter.Match" /> method when a <see cref="T:System.ServiceModel.Channels.MessageBuffer" /> is available. This form is allowed to examine the body of the message.</para>
@@ -282,6 +287,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a buffered message satisfies the query criteria of the XPath filter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="M:System.ServiceModel.Dispatcher.XPathMessageFilter.Match(System.ServiceModel.MessageBuffer)" /> satisfies the filter criteria; otherwise false. </para>
+        </returns>
         <param name="messageBuffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.MessageBuffer" /> to test. </param>
       </Docs>
@@ -300,7 +309,6 @@
         <Parameter Name="navigator" Type="System.ServiceModel.Dispatcher.SeekableXPathNavigator" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.ServiceModel.Dispatcher.SeekableXPathNavigator" /> class extends the <see cref="T:System.Xml.XPath.XPathNavigator" /> class with methods that run queries more efficiently.</para>
@@ -309,6 +317,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the XML document provided by the specified optimized XPath navigator satisfies the query criteria of the XPath filter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the data from the <see cref="T:System.ServiceModel.Dispatcher.SeekableXPathNavigator" /> satisfies the filter criteria; otherwise, false. </para>
+        </returns>
         <param name="navigator">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Dispatcher.SeekableXPathNavigator" /> that provides data to test. </param>
       </Docs>
@@ -327,12 +339,15 @@
         <Parameter Name="navigator" Type="System.Xml.XPath.XPathNavigator" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates the filter over the specified XPath navigator.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the data from the <see cref="T:System.Xml.XPath.XPathNavigator" /> satisfies the filter criteria; false otherwise. </para>
+        </returns>
         <param name="navigator">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XPath.XPathNavigator" /> that provides data to test. </param>
       </Docs>
@@ -395,12 +410,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the schema for the current XML document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.Schema.XmlSchema" /> that represents the current document.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="OnReadXml">
@@ -492,12 +510,15 @@
         <Parameter Name="schemas" Type="System.Xml.Schema.XmlSchemaSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the type of XML schema used to serialize the XPath filter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.Schema.XmLSchemaType" /> used to serialize the XPath filter.</para>
+        </returns>
         <param name="schemas">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Schema.XmLSchemaSet" /> that contains the cache of XML Schema definition language (XSD) schemas.</param>
       </Docs>
@@ -514,12 +535,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An explicit interface implementation that gets the current schema.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.Schema.XmlSchema" /> that represents the current document.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/XPathMessageFilterTable`1.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/XPathMessageFilterTable`1.xml
index 77884a113c4..71718876ca2 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/XPathMessageFilterTable`1.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Dispatcher/XPathMessageFilterTable`1.xml
@@ -194,7 +194,6 @@
       </Parameters>
       <Docs>
         <param name="key">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method implements the ContainsKey method of <see cref="T:System.Collections.Generic.IDictionary`2" />.</para>
@@ -203,6 +202,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the filter table contains a specified filter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="filter" /> is contained in the filter table; otherwise false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CopyTo">
@@ -257,7 +260,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method implements <see cref="M:System.Collections.Generic.SynchronizedCollection`1.System.Collections.IEnumerable.GetEnumerator" />.</para>
@@ -266,6 +268,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that can iterate through the filter table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerator`1" />&lt;KeyValuePair&lt;Filter, FilterData&gt;&gt; that can be used to iterate through the filter table.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetMatchingFilter">
@@ -371,7 +377,6 @@
         <Parameter Name="results" Type="System.Collections.Generic.ICollection&lt;System.ServiceModel.Dispatcher.MessageFilter&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method when more than one filter is expected to match the message and the matching filters are required.</para>
@@ -383,6 +388,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the match criterion of at least one <see cref="T:System.ServiceModel.Dispatcher.XPathMessageFilter" /> in the table is satisfied by the specified message and adds the matching filters to a collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the match criterion of at least one filter in the table is satisfied by <paramref name="message" />; false if no filter is satisfied.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.Message" /> to test.</param>
         <param name="results">
@@ -405,7 +414,6 @@
       </Parameters>
       <Docs>
         <param name="buffer">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method when more than one filter is expected to match the buffered message and the matching filters are required.</para>
@@ -417,6 +425,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the match criterion of at least one <see cref="T:System.ServiceModel.Dispatcher.XPathMessageFilter" /> in the table is satisfied by the specified buffered message and adds the matching filters to a collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the match criterion of at least one filter in the table is satisfied by <paramref name="messageBuffer" />; false if no filter is satisfied.</para>
+        </returns>
         <param name="results">
           <attribution license="cc4" from="Microsoft" modified="false" />The reference parameter that stores the <see cref="T:System.ServiceModel.Dispatcher.MessageFilter" /> objects that match in <see cref="T:System.Collections.Generic.ICollection`1" />&lt;Filter&gt;.</param>
       </Docs>
@@ -436,7 +448,6 @@
         <Parameter Name="results" Type="System.Collections.Generic.ICollection&lt;System.ServiceModel.Dispatcher.MessageFilter&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method when more than one filter is expected to match the navigator and the matching filters are required.</para>
@@ -446,6 +457,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the match criterion of at least one <see cref="T:System.ServiceModel.Dispatcher.SeekableXPathNavigator" /> in the table is satisfied by the specified buffered message and adds the matching filters to a collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the match criterion of at least one filter in the table is satisfied by <paramref name="messageBuffer" />; false if no filter is satisfied.</para>
+        </returns>
         <param name="navigator">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Dispatcher.SeekableXPathNavigator" /> to test.</param>
         <param name="results">
@@ -467,7 +482,6 @@
         <Parameter Name="results" Type="System.Collections.Generic.ICollection&lt;System.ServiceModel.Dispatcher.MessageFilter&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method when multiple filters can be expected to match the message specified by the <see cref="T:System.Xml.XPath.XPathNavigator" /> and the matching filters are required. </para>
@@ -477,6 +491,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the match criterion of at least one <see cref="T:System.Xml.XPath.XPathNavigator" /> in the table is satisfied by the specified buffered message and adds the matching filters to a collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the match criterion of at least one filter in the table is satisfied by <paramref name="messageBuffer" />; false if no filter is satisfied.</para>
+        </returns>
         <param name="navigator">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XPath.XPathNavigator" /> to test.</param>
         <param name="results">
@@ -782,12 +800,15 @@
         <Parameter Name="filter" Type="System.ServiceModel.Dispatcher.MessageFilter" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes a filter and its associated filter data from the filter table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the filter was found and removed; otherwise, false. </para>
+        </returns>
         <param name="filter">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Dispatcher.MessageFilter" /> to remove.</param>
       </Docs>
@@ -806,7 +827,6 @@
         <Parameter Name="filter" Type="System.ServiceModel.Dispatcher.XPathMessageFilter" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method does not throw an exception if the specified filter does not exist in the filter table.</para>
@@ -815,6 +835,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes an <see cref="T:System.ServiceModel.Dispatcher.XPathMessageFilter" /> and its associated filter data from the filter table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ServiceModel.Dispatcher.XPathMessageFilter" /> was found and removed; otherwise, false.</para>
+        </returns>
         <param name="filter">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Dispatcher.XPathMessageFilter" /> to remove.</param>
       </Docs>
@@ -831,7 +855,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method implements <see cref="M:System.Collections.Generic.SynchronizedCollection`1.System.Collections.IEnumerable.GetEnumerator" />.</para>
@@ -840,6 +863,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that can iterate through the filter table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerator`1" />&lt;KeyValuePair&lt;Filter, FilterData&gt;&gt; that can be used to iterate through the filter table.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TrimToSize">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.MsmqIntegration/MsmqIntegrationBinding.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.MsmqIntegration/MsmqIntegrationBinding.xml
index dab486a8acc..88d66e1c1a1 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.MsmqIntegration/MsmqIntegrationBinding.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.MsmqIntegration/MsmqIntegrationBinding.xml
@@ -95,12 +95,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the binding elements in the basic profile stack.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.BindingElementCollection" /> that contains the stack of binding elements in the basic profile stack.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Security">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.MsmqIntegration/MsmqIntegrationBindingElement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.MsmqIntegration/MsmqIntegrationBindingElement.xml
index 880a06f01d5..d8e4f2cfe27 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.MsmqIntegration/MsmqIntegrationBindingElement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.MsmqIntegration/MsmqIntegrationBindingElement.xml
@@ -51,7 +51,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method builds a channel factory that enables the developer to create a client channel to communicate with a service. The channel factory is not a channel, but rather a factory that can create a channel. You create a channel by calling IChannelFactory&lt;TChannel&gt;.CreateChannel.</para>
@@ -60,6 +59,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds a channel factory using the context provided.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An MSMQ integration channel factory that can be used to create channels to send messages to existing MSMQ applications.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> with which to build the channel factory.</param>
         <typeparam name="TChannel">
@@ -88,7 +91,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Channel listeners are created on the service and are used to receive messages sent by a client channel. The service must call IChannelListener.Open and then IChannelListener.AcceptChannel to get a reference to the actual channel. Then IChannel.Open must be called to open the channel. At this point, the channel can be used to retrieve messages.</para>
@@ -97,6 +99,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds a channel listener using the context provided.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An MSMQ integration channel listener that can be used to create channels to receive messages from existing MSMQ applications.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> with which to build the channel listener.</param>
         <typeparam name="TChannel">
@@ -120,12 +126,15 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether you can build a channel factory with the context provided.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if you can build a channel factory with the context provided; otherwise, false. This method returns true only if <paramref name="TChannel" /> is <see cref="T:System.ServiceModel.Channels.IOutputChannel" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> with which to build the channel factory.</param>
         <typeparam name="TChannel">
@@ -154,12 +163,16 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether you can build a channel listener with the context provided.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if you can build a channel listener with the context provided; otherwise, false.</para>
+          <para>This method returns true only if <paramref name="TChannel" /> is <see cref="T:System.ServiceModel.Channels.IInputChannel" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.BindingContext" /> with which to build the channel listener.</param>
         <typeparam name="TChannel">
@@ -178,12 +191,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a clone of the binding element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A clone of the binding element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetProperty&lt;T&gt;">
@@ -207,7 +223,6 @@
         <Parameter Name="context" Type="System.ServiceModel.Channels.BindingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method provides the functionality to retrieve capabilities and protection requirements from the element.</para>
@@ -216,6 +231,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a property of the requested type from the specified BindingContext.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object of type <paramref name="T" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The binding context.</param>
         <typeparam name="T">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.MsmqIntegration/MsmqIntegrationMessageProperty.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.MsmqIntegration/MsmqIntegrationMessageProperty.xml
index 101288aea37..cab18e70ec3 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.MsmqIntegration/MsmqIntegrationMessageProperty.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.MsmqIntegration/MsmqIntegrationMessageProperty.xml
@@ -287,12 +287,15 @@
         <Parameter Name="message" Type="System.ServiceModel.Channels.Message" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.ServiceModel.MsmqIntegration.MsmqIntegrationMessageProperty" /> for a given message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.MsmqIntegration.MsmqIntegrationMessageProperty" /> object that contains the Message Queuing integration properties for the specified message.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The message for which the Message Queuing (MSMQ) integration message properties are to be retrieved.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/CustomPeerResolverService.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/CustomPeerResolverService.xml
index 90179454988..1d3119d84c2 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/CustomPeerResolverService.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/CustomPeerResolverService.xml
@@ -119,12 +119,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains the specific response settings for the peer resolver service.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="T:System.ServiceModel.PeerResolvers.ServiceSettingsResponseInfo" /> that contains the specific response settings for the custom peer resolver service, including cleanup and refresh interval settings.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Open">
@@ -163,7 +167,6 @@
         <Parameter Name="refreshInfo" Type="System.ServiceModel.PeerResolvers.RefreshInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A refresh of an entry extends the length of time for which it remains valid. All information used to uniquely identify the entry must be supplied in the <see cref="T:System.ServiceModel.PeerResolvers.RefreshInfo" /> object supplied to this method.</para>
@@ -172,6 +175,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Refreshes the expiry of an entry in the peer resolver service's registration lookup table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="T:System.ServiceModel.PeerResolvers.RefreshResponseInfo" /> that contains the newly refreshed registration entry.</para>
+        </returns>
         <param name="refreshInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.PeerResolvers.RefreshInfo" /> object that contains the mesh ID and the registration ID of the entry to refresh in the peer resolver service's registration lookup table.</param>
@@ -214,7 +222,6 @@
         <Parameter Name="registerInfo" Type="System.ServiceModel.PeerResolvers.RegisterInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method adds a new entry to the registration lookup table of the peer resolver service. Note that registrations made after the service is closed  have no effect -- these entries are not returned by resolve requests.</para>
@@ -223,6 +230,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new entry to the registration lookup table of the peer resolver service.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="T:System.ServiceModel.PeerResolvers.RegisterResponseInfo" /> that contains a copy of the entry added to the peer resolver service's registration lookup table.</para>
+        </returns>
         <param name="registerInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.PeerResolvers.RegisterInfo" />  that contains information about the registration entry to register with the peer resolver service.</param>
@@ -244,12 +256,15 @@
         <Parameter Name="address" Type="System.ServiceModel.PeerNodeAddress" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new entry to the registration lookup table of the peer resolver service.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.PeerResolvers.RegisterResponseInfo" /> that contains a copy of the entry added to the peer resolver service's registration lookup table.</para>
+        </returns>
         <param name="clientId">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Guid" /> that specifies a unique identifier for the registration entry to register with the resolver service.</param>
         <param name="meshId">
@@ -272,7 +287,6 @@
         <Parameter Name="resolveInfo" Type="System.ServiceModel.PeerResolvers.ResolveInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method looks up a registration entry based on the data supplied in a <see cref="T:System.ServiceModel.PeerResolvers.ResolveInfo" /> object and returns any corresponding endpoint addresses found in the peer resolver service's registration lookup table. The number of endpoint addresses returned is equal to or less than the value of the  <see cref="P:System.ServiceModel.PeerResolvers.ResolveInfo.MaxAddresses" /> property set on the <see cref="T:System.ServiceModel.PeerResolvers.ResolveInfo" /> object. </para>
@@ -281,6 +295,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a list of known endpoints for a registration entry.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="T:System.ServiceModel.PeerResolvers.ResolveResponseInfo" /> that contains the endpoints for the registration entry in the lookup table that matches the information supplied in the <paramref name="resolveInfo" /> parameter. </para>
+        </returns>
         <param name="resolveInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.PeerResolvers.ResolveInfo" /> that contains information on the registration entry for which endpoints, if known, are to be looked up by the peer resolver service.</param>
@@ -324,12 +343,16 @@
         <Parameter Name="updateInfo" Type="System.ServiceModel.PeerResolvers.UpdateInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Updates an existing registration entry entry in the registration lookup table of the peer resolver service.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="T:System.ServiceModel.PeerResolvers.UpdateInfo" /> that contains a copy of the updated registration entry entry.</para>
+        </returns>
         <param name="updateInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.PeerResolvers.UpdateInfo" /> that uniquely identifies a specific registration entry and provides updated information for it.</param>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/IPeerResolverContract.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/IPeerResolverContract.xml
index f1973ba8140..3a5037a1513 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/IPeerResolverContract.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/IPeerResolverContract.xml
@@ -41,12 +41,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains the settings for a peer resolver service.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="T:System.ServiceModel.PeerResolvers.ServiceSettingsResponseInfo" /> that contains information about the peer resolver service.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Refresh">
@@ -68,7 +72,6 @@
         <Parameter Name="refreshInfo" Type="System.ServiceModel.PeerResolvers.RefreshInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A "refresh" of an entry is implemented by updating the supplied entry's expiry timestamp. All information used to uniquely identify the entry must be supplied in the <see cref="T:System.ServiceModel.PeerResolvers.RefreshInfo" /> object supplied to this method.</para>
@@ -77,6 +80,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Refreshes the expiry for an entry in the peer resolver service's registration lookup table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="T:System.ServiceModel.PeerResolvers.RefreshResponseInfo" /> that contains the newly refreshed registration entry.</para>
+        </returns>
         <param name="refreshInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.PeerResolvers.RefreshInfo" /> object that contains the mesh ID and the registration ID of the entry to refresh in the peer resolver service's registration lookup table.</param>
@@ -101,7 +109,6 @@
         <Parameter Name="registerInfo" Type="System.ServiceModel.PeerResolvers.RegisterInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is used to add a peer node's registration information to the lookup table used by the peer resolver service.</para>
@@ -110,6 +117,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Registers a peer node with the custom peer resolver service.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="T:System.ServiceModel.PeerResolvers.RegisterResponseInfo" /> that contains a copy of the entry added to the peer resolver service's registration lookup table.</para>
+        </returns>
         <param name="registerInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.PeerResolvers.RegisterInfo" />  that contains information about the peer node to register with the peer resolver service.</param>
@@ -134,12 +146,16 @@
         <Parameter Name="resolveInfo" Type="System.ServiceModel.PeerResolvers.ResolveInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a list of known endpoints for a registration entry.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="T:System.ServiceModel.PeerResolvers.ResolveResponseInfo" /> that contains the endpoints for the registration entry in the lookup table that matches the information supplied in the <paramref name="resolveInfo" /> parameter. </para>
+        </returns>
         <param name="resolveInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.PeerResolvers.ResolveInfo" /> that contains information on the peer node for which endpoints, if known, are to be looked up by the peer resolver service.</param>
@@ -196,12 +212,16 @@
         <Parameter Name="updateInfo" Type="System.ServiceModel.PeerResolvers.UpdateInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Updates the entry for a specific peer node in the peer resolver service's lookup table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="T:System.ServiceModel.PeerResolvers.UpdateInfo" /> that contains a copy of the updated peer node entry.</para>
+        </returns>
         <param name="updateInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.ServiceModel.PeerResolvers.UpdateInfo" /> that uniquely identifies a specific peer node entry and provides updated information for it.</param>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/RefreshInfo.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/RefreshInfo.xml
index cbaec34b7d4..b401d4c0115 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/RefreshInfo.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/RefreshInfo.xml
@@ -78,12 +78,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the body of the message containing a serialized instance of this type is correctly formed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True if the refresh information message body is correctly formed by the sender (the service client); false if it is not.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MeshId">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/RefreshResponseInfo.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/RefreshResponseInfo.xml
index 68e86980c1f..d33e7576ee3 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/RefreshResponseInfo.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/RefreshResponseInfo.xml
@@ -80,12 +80,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the body of the message containing a serialized instance of this type is correctly formed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True if the refresh response information body is correctly-formed by the sender; false if it is not.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="RegistrationLifetime">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/RegisterInfo.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/RegisterInfo.xml
index 21bbcc9eafe..acb687fe7e7 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/RegisterInfo.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/RegisterInfo.xml
@@ -103,12 +103,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the body of the message containing a serialized instance of this type is correctly formed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True if the registration information body is correctly-formed by the sender; false if it is not.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MeshId">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/RegisterResponseInfo.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/RegisterResponseInfo.xml
index 655e22d8a8b..63ad4681a5a 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/RegisterResponseInfo.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/RegisterResponseInfo.xml
@@ -80,12 +80,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the body of the message containing a serialized instance of this type is correctly formed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True if the registration response information body is correctly-formed by the sender; false if it is not.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="RegistrationId">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/ResolveInfo.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/ResolveInfo.xml
index f62c4c683b9..fd3d85b91fa 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/ResolveInfo.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/ResolveInfo.xml
@@ -103,12 +103,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the body of the message containing a serialized instance of this type is correctly formed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True if the resolve request information message body is correctly formed by the sender (the service client); false if it is not.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MaxAddresses">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/ResolveResponseInfo.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/ResolveResponseInfo.xml
index 74ab5ff4a33..a4dad163638 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/ResolveResponseInfo.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/ResolveResponseInfo.xml
@@ -94,12 +94,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the body of the message containing a serialized instance of this type is correctly formed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True if the resolution response information body is correctly-formed by the sender; false if it is not.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/ServiceSettingsResponseInfo.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/ServiceSettingsResponseInfo.xml
index 3dad3b82e06..a0935ec6e27 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/ServiceSettingsResponseInfo.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/ServiceSettingsResponseInfo.xml
@@ -97,12 +97,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the body of the message containing a serialized instance of this type is correctly formed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True if the service settings response information body is correctly-formed by the sender; false if it is not.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/UnregisterInfo.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/UnregisterInfo.xml
index 225a351f00d..5715e7b42db 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/UnregisterInfo.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/UnregisterInfo.xml
@@ -77,12 +77,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the body of the message containing a serialized instance of this type is correctly formed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True if the registration removal information body is correctly-formed by the sender; false if it is not.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MeshId">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/UpdateInfo.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/UpdateInfo.xml
index 14d44915347..94905c603e1 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/UpdateInfo.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.PeerResolvers/UpdateInfo.xml
@@ -109,12 +109,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the body of the message containing a serialized instance of this type is correctly formed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True if the registration update information body is correctly-formed by the sender; false if it is not.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MeshId">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/BinarySecretSecurityToken.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/BinarySecretSecurityToken.xml
index 990f38b2d86..6e6abc30e51 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/BinarySecretSecurityToken.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/BinarySecretSecurityToken.xml
@@ -168,12 +168,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the bytes that represent the key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The key.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Id">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/ISecurityContextSecurityTokenCache.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/ISecurityContextSecurityTokenCache.xml
index 4cdfd0b8faa..77c188eaf04 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/ISecurityContextSecurityTokenCache.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/ISecurityContextSecurityTokenCache.xml
@@ -71,12 +71,15 @@
         <Parameter Name="contextId" Type="System.Xml.UniqueId" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of security context security token IDs that match a specified context ID.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A generic collection of <see cref="T:System.ServiceModel.Security.Tokens.SecurityContextSecurityToken" />s.</para>
+        </returns>
         <param name="contextId">
           <attribution license="cc4" from="Microsoft" modified="false" />The specified security context ID.</param>
       </Docs>
@@ -96,12 +99,15 @@
         <Parameter Name="generation" Type="System.Xml.UniqueId" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the security context security token ID that matches a specified context ID and generation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The matching <see cref="T:System.ServiceModel.Security.Tokens.SecurityContextSecurityToken" />.</para>
+        </returns>
         <param name="contextId">
           <attribution license="cc4" from="Microsoft" modified="false" />The specified security context ID.</param>
         <param name="generation">
@@ -171,12 +177,15 @@
         <Parameter Name="token" Type="System.ServiceModel.Security.Tokens.SecurityContextSecurityToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tries to add a token to the cache.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the token was added successfully to the cache; otherwise, false. </para>
+        </returns>
         <param name="token">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Security.Tokens.SecurityContextSecurityToken" />.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/InitiatorServiceModelSecurityTokenRequirement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/InitiatorServiceModelSecurityTokenRequirement.xml
index cc8c4b261a3..2f1c9f409a5 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/InitiatorServiceModelSecurityTokenRequirement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/InitiatorServiceModelSecurityTokenRequirement.xml
@@ -73,7 +73,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method displays the property type name, and for each property, the property name and value.</para>
@@ -82,6 +81,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Outputs a text representation of this instance of the class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A text representation of this instance of the class.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Via">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/IssuedSecurityTokenParameters.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/IssuedSecurityTokenParameters.xml
index 90060e32c3d..bb00c6e0af4 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/IssuedSecurityTokenParameters.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/IssuedSecurityTokenParameters.xml
@@ -274,7 +274,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ServiceModel.Security.Tokens.SecurityTokenParameters.Clone" /> and <see cref="M:System.ServiceModel.Security.Tokens.SecurityTokenParameters.CloneCore" /> methods follow the Core design pattern.</para>
@@ -286,6 +285,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clones another instance of this instance of the class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Security.Tokens.SecurityTokenParameters" /> that represents the copy.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateKeyIdentifierClause">
@@ -303,7 +306,6 @@
         <Parameter Name="referenceStyle" Type="System.ServiceModel.Security.Tokens.SecurityTokenReferenceStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a key identifier clause using the <see cref="M:System.IdentityModel.Tokens.SecurityToken.CreateKeyIdentifierClause``1" /> method, with <paramref name="referenceStyle" /> as a generic parameter.</para>
@@ -312,6 +314,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a key identifier clause for a token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The security key identifier clause.</para>
+        </returns>
         <param name="token">
           <attribution license="cc4" from="Microsoft" modified="false" />The token.</param>
         <param name="referenceStyle">
@@ -333,12 +339,15 @@
         <Parameter Name="securityTokenSerializer" Type="System.IdentityModel.Selectors.SecurityTokenSerializer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a collection of issued token request parameter XML elements that get included in the request sent by the client to the security token service.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.ObjectModel.Collection`1" /> that contains XML elements that represent the request parameters.</para>
+        </returns>
         <param name="messageSecurityVersion">
           <attribution license="cc4" from="Microsoft" modified="false" />The message security version.</param>
         <param name="securityTokenSerializer">
@@ -602,7 +611,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method displays the name of this class, <see cref="P:System.ServiceModel.Security.Tokens.IssuedSecurityTokenParameters.TokenType" />, <see cref="P:System.ServiceModel.Security.Tokens.IssuedSecurityTokenParameters.KeyType" />, <see cref="P:System.ServiceModel.Security.Tokens.IssuedSecurityTokenParameters.KeySize" />, <see cref="P:System.ServiceModel.Security.Tokens.IssuedSecurityTokenParameters.IssuerAddress" />, <see cref="P:System.ServiceModel.Security.Tokens.IssuedSecurityTokenParameters.IssuerMetadataAddress" />, <see cref="P:System.ServiceModel.Security.Tokens.IssuedSecurityTokenParameters.IssuerBinding" /> (if not null) and binding elements, and <see cref="P:System.ServiceModel.Security.Tokens.IssuedSecurityTokenParameters.ClaimTypeRequirements" /> (if not 0).</para>
@@ -611,6 +619,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a text representation of this instance of the class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A text representation of this instance of this class.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/IssuedSecurityTokenProvider.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/IssuedSecurityTokenProvider.xml
index 671883682dc..f42da34a3ce 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/IssuedSecurityTokenProvider.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/IssuedSecurityTokenProvider.xml
@@ -75,12 +75,15 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously begins closing the provider.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object that represents the result of an asynchronous operation.</para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.AsyncCallback" /> method to execute when the operation completed.</param>
         <param name="state">
@@ -103,12 +106,15 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously begins closing the provider.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object that represents the result of an asynchronous operation.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.TimeSpan" /> after which the call times out.</param>
         <param name="callback">
@@ -133,12 +139,15 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously begins getting the token core.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object that represents the result of an asynchronous operation.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.TimeSpan" /> after which the call times out.</param>
         <param name="callback">
@@ -162,12 +171,15 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously begins opening the provider.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object that represents the result of an asynchronous operation.</para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.AsyncCallback" /> method to execute when the operation completed.</param>
         <param name="state">
@@ -190,12 +202,15 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously begins opening the provider.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object that represents the result of an asynchronous operation.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.TimeSpan" /> after which the call times out.</param>
         <param name="callback">
@@ -401,12 +416,15 @@
         <Parameter Name="result" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ends the asynchronous call for getting the token core.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A security token.</para>
+        </returns>
         <param name="result">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IAsyncResult" /> object that represents the result of an asynchronous operation.</param>
       </Docs>
@@ -466,7 +484,6 @@
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Care must be taken when caching and reusing security tokens that are returned from the <see cref="M:System.ServiceModel.Security.Tokens.IssuedSecurityTokenProvider.GetTokenCore(System.TimeSpan)" /> method, because the security token might become unusable when the channel that the token provider is associated with is closed. The security token becomes unusable when the requested key type is asymmetric and the thread is running under impersonated context when the <see cref="M:System.ServiceModel.Security.Tokens.IssuedSecurityTokenProvider.GetTokenCore(System.TimeSpan)" /> method is called.</para>
@@ -475,6 +492,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the token core.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IdentityModel.Tokens.SecurityToken" /> that represents the token core.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.TimeSpan" /> after which the call times out.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/KerberosSecurityTokenParameters.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/KerberosSecurityTokenParameters.xml
index ff432b323af..01e1ccfe98e 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/KerberosSecurityTokenParameters.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/KerberosSecurityTokenParameters.xml
@@ -88,7 +88,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ServiceModel.Security.Tokens.SecurityTokenParameters.Clone" /> and <see cref="M:System.ServiceModel.Security.Tokens.SecurityTokenParameters.CloneCore" /> methods follow the Core design pattern.</para>
@@ -100,6 +99,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clones another instance of this instance of the class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Security.Tokens.SecurityTokenParameters" /> instance that represents the copy.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateKeyIdentifierClause">
@@ -117,12 +120,15 @@
         <Parameter Name="referenceStyle" Type="System.ServiceModel.Security.Tokens.SecurityTokenReferenceStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a key identifier clause for a token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The key identifier clause for a token.</para>
+        </returns>
         <param name="token">
           <attribution license="cc4" from="Microsoft" modified="false" />The token.</param>
         <param name="referenceStyle">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/RecipientServiceModelSecurityTokenRequirement.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/RecipientServiceModelSecurityTokenRequirement.xml
index 8d1f37e7537..a8688a41b77 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/RecipientServiceModelSecurityTokenRequirement.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/RecipientServiceModelSecurityTokenRequirement.xml
@@ -167,7 +167,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method displays the property type name, and for each property, the property name and value.</para>
@@ -176,6 +175,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a text representation of this instance of the class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A text representation of this instance of the class.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/RsaSecurityTokenParameters.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/RsaSecurityTokenParameters.xml
index 469cd87ee99..9ca9cc95c5a 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/RsaSecurityTokenParameters.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/RsaSecurityTokenParameters.xml
@@ -88,7 +88,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ServiceModel.Security.Tokens.SecurityTokenParameters.Clone" /> and <see cref="M:System.ServiceModel.Security.Tokens.SecurityTokenParameters.CloneCore" /> methods follow the Core design pattern.</para>
@@ -100,6 +99,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clones another instance of this instance of the class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Security.Tokens.SecurityTokenParameters" /> instance that represents the copy.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateKeyIdentifierClause">
@@ -117,12 +120,15 @@
         <Parameter Name="referenceStyle" Type="System.ServiceModel.Security.Tokens.SecurityTokenReferenceStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a key identifier clause for a token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The key identifier clause for a token.</para>
+        </returns>
         <param name="token">
           <attribution license="cc4" from="Microsoft" modified="false" />The token.</param>
         <param name="referenceStyle">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SecureConversationSecurityTokenParameters.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SecureConversationSecurityTokenParameters.xml
index ce4414859e5..a3690e2eb26 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SecureConversationSecurityTokenParameters.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SecureConversationSecurityTokenParameters.xml
@@ -206,7 +206,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ServiceModel.Security.Tokens.SecurityTokenParameters.Clone" /> and <see cref="M:System.ServiceModel.Security.Tokens.SecurityTokenParameters.CloneCore" /> methods follow the Core design pattern.</para>
@@ -218,6 +217,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clones another instance of this instance of the class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Security.Tokens.SecureConversationSecurityTokenParameters" /> instance that represents the copy.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateKeyIdentifierClause">
@@ -235,7 +238,6 @@
         <Parameter Name="referenceStyle" Type="System.ServiceModel.Security.Tokens.SecurityTokenReferenceStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates a key identifier clause using the <see cref="M:System.IdentityModel.Tokens.SecurityToken.CreateKeyIdentifierClause``1" /> method, with <paramref name="referenceStyle" /> as a generic parameter.</para>
@@ -244,6 +246,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a key identifier clause for a token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The key identifier clause for a token.</para>
+        </returns>
         <param name="token">
           <attribution license="cc4" from="Microsoft" modified="false" />The token.</param>
         <param name="referenceStyle">
@@ -425,7 +431,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method displays the following data: the result of performing this method on the base class, <see cref="P:System.ServiceModel.Security.Tokens.SecureConversationSecurityTokenParameters.RequireCancellation" />, and, if non-null, <see cref="P:System.ServiceModel.Security.Tokens.SecureConversationSecurityTokenParameters.BootstrapSecurityBindingElement" />.</para>
@@ -434,6 +439,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a text representation of this instance of the class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A text representation of this instance of the class.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SecurityContextSecurityToken.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SecurityContextSecurityToken.xml
index 3e37f070fb7..9b6c5350d26 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SecurityContextSecurityToken.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SecurityContextSecurityToken.xml
@@ -211,12 +211,15 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a specified key identifier clause type can be created.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified key identifier clause type can be created; otherwise, false.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The specified key identifier clause type.</typeparam>
       </Docs>
@@ -260,12 +263,15 @@
         <Parameter Name="securityStateEncoder" Type="System.ServiceModel.Security.SecurityStateEncoder" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a security context token cookie.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A security context token cookie.</para>
+        </returns>
         <param name="contextId">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.UniqueId" /> that represents the context id.</param>
         <param name="id">
@@ -305,12 +311,15 @@
         <Parameter Name="securityStateEncoder" Type="System.ServiceModel.Security.SecurityStateEncoder" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a security context token cookie.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A security context token cookie.</para>
+        </returns>
         <param name="contextId">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.UniqueId" /> that represents the context id.</param>
         <param name="id">
@@ -352,12 +361,15 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a key identifier clause of a specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IdentityModel.Tokens.SecurityKeyIdentifierClause" /> cast to type <paramref name="T" />.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The specified type.</typeparam>
       </Docs>
@@ -456,12 +468,15 @@
       </Parameters>
       <Docs>
         <param name="clause">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the current token's key identifier clause matches a specified key identifier clause.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current token's key identifier clause matches a specified key identifier clause; otherwise, false. The default is false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SecurityKeys">
@@ -495,12 +510,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a text representation of the current instance of this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A text representation of the current instance of this object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ValidFrom">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SecurityContextSecurityTokenAuthenticator.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SecurityContextSecurityTokenAuthenticator.xml
index db792809361..3efff5cafdb 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SecurityContextSecurityTokenAuthenticator.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SecurityContextSecurityTokenAuthenticator.xml
@@ -54,12 +54,15 @@
         <Parameter Name="token" Type="System.IdentityModel.Tokens.SecurityToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether a specified token can be validated. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified token can be validated; otherwise, false.</para>
+        </returns>
         <param name="token">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IdentityModel.Tokens.SecurityToken" />.</param>
       </Docs>
@@ -78,12 +81,15 @@
         <Parameter Name="token" Type="System.IdentityModel.Tokens.SecurityToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates a specified token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of <see cref="T:System.IdentityModel.Policy.IAuthorizationPolicy" /> instances.</para>
+        </returns>
         <param name="token">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IdentityModel.Tokens.SecurityToken" />.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SecurityContextSecurityTokenResolver.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SecurityContextSecurityTokenResolver.xml
index 6dfd1e73968..117367013ac 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SecurityContextSecurityTokenResolver.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SecurityContextSecurityTokenResolver.xml
@@ -102,12 +102,15 @@
       </Parameters>
       <Docs>
         <param name="contextId">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of security context security token IDs that match a specified context ID.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A generic collection of security context tokens.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetContext">
@@ -127,12 +130,15 @@
       <Docs>
         <param name="contextId">To be added.</param>
         <param name="generation">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the security context security token ID that matches a specified context ID and generation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The matching security context token.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="RemoveAllContexts">
@@ -234,12 +240,15 @@
       </Parameters>
       <Docs>
         <param name="token">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to add a token to the cache.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the token was added successfully to the cache; otherwise, false. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryResolveSecurityKeyCore">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SecurityTokenParameters.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SecurityTokenParameters.xml
index 63f3f4470fb..19b6d0789bf 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SecurityTokenParameters.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SecurityTokenParameters.xml
@@ -90,7 +90,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ServiceModel.Security.Tokens.SecurityTokenParameters.Clone" /> and <see cref="M:System.ServiceModel.Security.Tokens.SecurityTokenParameters.CloneCore" /> methods follow the Core design pattern. In that pattern, this method performs some validation and then calls <see cref="M:System.ServiceModel.Security.Tokens.SecurityTokenParameters.CloneCore" />, which is an abstract method that is overridden in derived classes to perform the core functionality.</para>
@@ -99,6 +98,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clones another instance of this instance of the class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of <see cref="T:System.ServiceModel.Security.Tokens.SecurityTokenParameters" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CloneCore">
@@ -113,7 +116,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ServiceModel.Security.Tokens.SecurityTokenParameters.Clone" /> and <see cref="M:System.ServiceModel.Security.Tokens.SecurityTokenParameters.CloneCore" /> methods follow the Core design pattern. <see cref="M:System.ServiceModel.Security.Tokens.SecurityTokenParameters.CloneCore" /> is an abstract method that is overridden in derived classes.</para>
@@ -122,6 +124,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clones another instance of this instance of the class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Security.Tokens.SecurityTokenParameters" /> instance that represents the copy.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateKeyIdentifierClause">
@@ -139,7 +145,6 @@
         <Parameter Name="referenceStyle" Type="System.ServiceModel.Security.Tokens.SecurityTokenReferenceStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method must be implemented in a derived class.</para>
@@ -148,6 +153,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a key identifier clause for a token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The key identifier clause for a token.</para>
+        </returns>
         <param name="token">
           <attribution license="cc4" from="Microsoft" modified="false" />The token.</param>
         <param name="referenceStyle">
@@ -263,12 +272,15 @@
         <Parameter Name="referenceStyle" Type="System.ServiceModel.Security.Tokens.SecurityTokenReferenceStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a token matches a key identifier clause.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the token matches the key identifier clause; otherwise, false.</para>
+        </returns>
         <param name="token">
           <attribution license="cc4" from="Microsoft" modified="false" />The security token.</param>
         <param name="keyIdentifierClause">
@@ -392,7 +404,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method displays the name of this class, <see cref="P:System.ServiceModel.Security.Tokens.SecurityTokenParameters.InclusionMode" />, <see cref="P:System.ServiceModel.Security.Tokens.SecurityTokenParameters.ReferenceStyle" />, and <see cref="P:System.ServiceModel.Security.Tokens.SecurityTokenParameters.RequireDerivedKeys" />.</para>
@@ -401,6 +412,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a text representation of this instance of the class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A text representation of this instance of the class.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SslSecurityTokenParameters.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SslSecurityTokenParameters.xml
index 67f6fac2225..6029704a723 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SslSecurityTokenParameters.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SslSecurityTokenParameters.xml
@@ -173,7 +173,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ServiceModel.Security.Tokens.SecurityTokenParameters.Clone" /> and <see cref="M:System.ServiceModel.Security.Tokens.SecurityTokenParameters.CloneCore" /> methods follow the Core design pattern. <see cref="M:System.ServiceModel.Security.Tokens.SslSecurityTokenParameters.CloneCore" /> overrides <see cref="M:System.ServiceModel.Security.Tokens.SecurityTokenParameters.CloneCore" />.</para>
@@ -183,6 +182,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clones another instance of this instance of the class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Security.Tokens.SecurityTokenParameters" /> instance that represents the copy.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateKeyIdentifierClause">
@@ -200,7 +203,6 @@
         <Parameter Name="referenceStyle" Type="System.ServiceModel.Security.Tokens.SecurityTokenReferenceStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates a key identifier clause using the <see cref="M:System.IdentityModel.Tokens.SecurityToken.CreateKeyIdentifierClause``1" /> method, with <paramref name="referenceStyle" /> as a generic parameter.</para>
@@ -209,6 +211,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a key identifier clause for a token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The key identifier clause for a token.</para>
+        </returns>
         <param name="token">
           <attribution license="cc4" from="Microsoft" modified="false" />The token.</param>
         <param name="referenceStyle">
@@ -396,7 +402,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method displays the name of this class, <see cref="P:System.ServiceModel.Security.Tokens.SslSecurityTokenParameters.RequireCancellation" />, and <see cref="P:System.ServiceModel.Security.Tokens.SslSecurityTokenParameters.RequireClientCertificate" />.</para>
@@ -405,6 +410,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a text representation of this instance of the class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A text representation of this instance of the class.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SspiSecurityTokenParameters.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SspiSecurityTokenParameters.xml
index 17bd1db7484..5282154305b 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SspiSecurityTokenParameters.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SspiSecurityTokenParameters.xml
@@ -131,7 +131,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ServiceModel.Security.Tokens.SecurityTokenParameters.Clone" /> and <see cref="M:System.ServiceModel.Security.Tokens.SecurityTokenParameters.CloneCore" /> methods follow the Core design pattern. </para>
@@ -143,6 +142,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clones another instance of this instance of the class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the <see cref="T:System.ServiceModel.Security.Tokens.SecurityTokenParameters" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateKeyIdentifierClause">
@@ -160,12 +163,15 @@
         <Parameter Name="referenceStyle" Type="System.ServiceModel.Security.Tokens.SecurityTokenReferenceStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a key identifier clause for a token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A security key identifier clause.</para>
+        </returns>
         <param name="token">
           <attribution license="cc4" from="Microsoft" modified="false" />The token.</param>
         <param name="referenceStyle">
@@ -331,12 +337,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a text representation of this instance of the class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A text representation of this instance of this class.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SupportingTokenParameters.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SupportingTokenParameters.xml
index c6b1e4e8804..cef617203ed 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SupportingTokenParameters.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/SupportingTokenParameters.xml
@@ -66,12 +66,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clones another instance of this instance of the class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Security.Tokens.SupportingTokenParameters" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Endorsing">
@@ -200,7 +203,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The output string displays the result of performing the ToString() method on each of the tokens in <see cref="P:System.ServiceModel.Security.Tokens.SupportingTokenParameters.Endorsing" />, <see cref="P:System.ServiceModel.Security.Tokens.SupportingTokenParameters.Signed" />, <see cref="P:System.ServiceModel.Security.Tokens.SupportingTokenParameters.SignedEncrypted" />, and <see cref="P:System.ServiceModel.Security.Tokens.SupportingTokenParameters.SignedEndorsing" />.</para>
@@ -209,6 +211,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a text representation of this instance of the class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A text representation of this instance of this class.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/UserNameSecurityTokenParameters.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/UserNameSecurityTokenParameters.xml
index 785372b6d7f..27bb81005bb 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/UserNameSecurityTokenParameters.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/UserNameSecurityTokenParameters.xml
@@ -86,7 +86,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ServiceModel.Security.Tokens.SecurityTokenParameters.Clone" /> and <see cref="M:System.ServiceModel.Security.Tokens.SecurityTokenParameters.CloneCore" /> methods follow the Core design pattern. </para>
@@ -98,6 +97,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clones another instance of this instance of the class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Security.Tokens.SecurityTokenParameters" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateKeyIdentifierClause">
@@ -115,7 +118,6 @@
         <Parameter Name="referenceStyle" Type="System.ServiceModel.Security.Tokens.SecurityTokenReferenceStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a key identifier clause using the <see cref="M:System.IdentityModel.Tokens.SecurityToken.CreateKeyIdentifierClause``1" /> method, with <paramref name="referenceStyle" /> as a generic parameter.</para>
@@ -124,6 +126,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a key identifier clause for a token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The security key identifier clause.</para>
+        </returns>
         <param name="token">
           <attribution license="cc4" from="Microsoft" modified="false" />The token.</param>
         <param name="referenceStyle">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/WrappedKeySecurityToken.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/WrappedKeySecurityToken.xml
index 848ceb49c97..9eea3a0cf43 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/WrappedKeySecurityToken.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/WrappedKeySecurityToken.xml
@@ -72,12 +72,15 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the token can create a key identifier clause.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the token can create a key identifier clause; otherwise, false. The default is false.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the <see cref="T:System.IdentityModel.Tokens.SecurityKeyIdentifierClause" />.</typeparam>
       </Docs>
@@ -101,12 +104,15 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Create a key identifier clause.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type of the <see cref="T:System.IdentityModel.Tokens.SecurityKeyIdentifierClause" />.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the <see cref="T:System.IdentityModel.Tokens.SecurityKeyIdentifierClause" />.</typeparam>
       </Docs>
@@ -123,12 +129,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the wrapped key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The wrapped key.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Id">
@@ -164,12 +173,15 @@
         <Parameter Name="keyIdentifierClause" Type="System.IdentityModel.Tokens.SecurityKeyIdentifierClause" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current security key identifier clause to a specified one for equality.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current security key identifier clause equals the specified one; otherwise, false. The default is false.</para>
+        </returns>
         <param name="keyIdentifierClause">
           <attribution license="cc4" from="Microsoft" modified="false" />The specified security key identifier clause.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/X509SecurityTokenParameters.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/X509SecurityTokenParameters.xml
index c09d0a09a60..0335245367e 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/X509SecurityTokenParameters.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security.Tokens/X509SecurityTokenParameters.xml
@@ -151,7 +151,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ServiceModel.Security.Tokens.SecurityTokenParameters.Clone" /> and <see cref="M:System.ServiceModel.Security.Tokens.SecurityTokenParameters.CloneCore" /> methods follow the Core design pattern. </para>
@@ -163,6 +162,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clones another instance of this instance of the class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the <see cref="T:System.ServiceModel.Security.Tokens.SecurityTokenParameters" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateKeyIdentifierClause">
@@ -180,12 +183,15 @@
         <Parameter Name="referenceStyle" Type="System.ServiceModel.Security.Tokens.SecurityTokenReferenceStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a key identifier clause for a token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The security key identifier clause.</para>
+        </returns>
         <param name="token">
           <attribution license="cc4" from="Microsoft" modified="false" />The token.</param>
         <param name="referenceStyle">
@@ -321,12 +327,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays a text representation of this instance of the class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A text representation of this instance of this class.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="X509ReferenceStyle">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/BinarySecretKeyIdentifierClause.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/BinarySecretKeyIdentifierClause.xml
index 1135482771f..6093a98a21c 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/BinarySecretKeyIdentifierClause.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/BinarySecretKeyIdentifierClause.xml
@@ -121,12 +121,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a security key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created security key.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetKeyBytes">
@@ -141,12 +144,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of bytes that represents the key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of bytes that represents the key.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Matches">
@@ -164,12 +170,15 @@
       </Parameters>
       <Docs>
         <param name="clause">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares whether the key of a specified clause matches this instance's key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there is a match; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/ChannelProtectionRequirements.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/ChannelProtectionRequirements.xml
index c1b3a59581c..8ac320ef431 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/ChannelProtectionRequirements.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/ChannelProtectionRequirements.xml
@@ -160,7 +160,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Incoming parts of the current instance of this class become outgoing parts of the new instance. Outgoing parts of the current instance of this class become incoming parts of the new instance.</para>
@@ -169,6 +168,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of this class with incoming and outgoing parts reversed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of this class with incoming and outgoing parts reversed.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IncomingEncryptionParts">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/DataProtectionSecurityStateEncoder.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/DataProtectionSecurityStateEncoder.xml
index bf7609993d4..8c37346c39e 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/DataProtectionSecurityStateEncoder.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/DataProtectionSecurityStateEncoder.xml
@@ -97,12 +97,15 @@
         <Parameter Name="data" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes the security state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array that represents the decoded security state.</para>
+        </returns>
         <param name="data">
           <attribution license="cc4" from="Microsoft" modified="false" />A byte array that represents the encoded security state.</param>
       </Docs>
@@ -121,12 +124,15 @@
         <Parameter Name="data" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes the security state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array that represents the encoded security state.</para>
+        </returns>
         <param name="data">
           <attribution license="cc4" from="Microsoft" modified="false" />A byte array representing the decoded security state.</param>
       </Docs>
@@ -143,12 +149,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates the randomness of this encoder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Byte" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -163,7 +172,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Information returned by this method includes the <see cref="P:System.ServiceModel.Security.DataProtectionSecurityStateEncoder.UseCurrentUserProtectionScope" /> and <see cref="M:System.ServiceModel.Security.DataProtectionSecurityStateEncoder.GetEntropy" /> values of the current instance.</para>
@@ -172,6 +180,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.ServiceModel.Security.DataProtectionSecurityStateEncoder" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that represents the current <see cref="T:System.ServiceModel.Security.DataProtectionSecurityStateEncoder" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="UseCurrentUserProtectionScope">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/IEndpointIdentityProvider.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/IEndpointIdentityProvider.xml
index f8c9108295f..9a9b42caeda 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/IEndpointIdentityProvider.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/IEndpointIdentityProvider.xml
@@ -32,7 +32,6 @@
         <Parameter Name="tokenRequirement" Type="System.IdentityModel.Selectors.SecurityTokenRequirement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="tokenRequirement" /> parameter contains the binding information of the endpoint, which is typically used in determining the <see cref="T:System.ServiceModel.EndpointIdentity" /> for the endpoint. For example, if the binding is configured to do Kerberos-based authentication, the default identity returned will be a ServicePrincipalName (SPN) or UserPrincipalName (UPN).</para>
@@ -41,6 +40,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the identity of the current endpoint, based on the security token requirements passed in.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.EndpointIdentity" /> of the current endpoint.</para>
+        </returns>
         <param name="tokenRequirement">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IdentityModel.Selectors.SecurityTokenRequirement" /> that describes security token requirements.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/ISecureConversationSession.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/ISecureConversationSession.xml
index cb3572abbfc..0bd5ec7b6d0 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/ISecureConversationSession.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/ISecureConversationSession.xml
@@ -33,7 +33,6 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is useful for sessions like WS-RM sessions that build on top of the security session and refer to the security session token's identifier as part of their session establishment protocol.</para>
@@ -42,6 +41,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tries to read the session token identifier pointed to by the XML reader.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the XML pointed to by the XML reader corresponds to a SecurityKeyIdentifierClause that matches the security session's token; otherwise, false.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> with which to try to read the token.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/IdentityVerifier.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/IdentityVerifier.xml
index dee94614bae..e9d91e59ad2 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/IdentityVerifier.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/IdentityVerifier.xml
@@ -53,12 +53,15 @@
         <Parameter Name="authContext" Type="System.IdentityModel.Policy.AuthorizationContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implements a method to verify an identity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the identity is verified; otherwise, false. The default is false.</para>
+        </returns>
         <param name="identity">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.EndpointIdentity" /> to verify.</param>
         <param name="authContext">
@@ -77,12 +80,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a default instance of this class. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A default instance of <see cref="T:System.ServiceModel.Security.IdentityVerifier" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryGetIdentity">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/InfocardInteractiveChannelInitializer.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/InfocardInteractiveChannelInitializer.xml
index 8d535f3d7c2..df276ed9b97 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/InfocardInteractiveChannelInitializer.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/InfocardInteractiveChannelInitializer.xml
@@ -61,12 +61,15 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins the asynchronous method to display the initialization user interface (UI).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> from this method.</para>
+        </returns>
         <param name="channel">
           <attribution license="cc4" from="Microsoft" modified="false" />The channel.</param>
         <param name="callback">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/KeyNameIdentifierClause.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/KeyNameIdentifierClause.xml
index dc21e816440..895e37ec1e9 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/KeyNameIdentifierClause.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/KeyNameIdentifierClause.xml
@@ -72,12 +72,15 @@
       </Parameters>
       <Docs>
         <param name="clause">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks whether a <see cref="T:System.IdentityModel.Tokens.SecurityKeyIdentifierClause" /> matches the current instance of this class. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there is a match; otherwise, false. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Matches">
@@ -94,12 +97,15 @@
         <Parameter Name="keyName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks whether the specified key name matches the current instance's key name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there is a match; otherwise, false. </para>
+        </returns>
         <param name="keyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The security key name clause.</param>
       </Docs>
@@ -116,12 +122,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.String" /> that represents the current Object. (Inherited from <see cref="T:System.Object" />)</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current Object.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/SecurityAlgorithmSuite.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/SecurityAlgorithmSuite.xml
index 1de5e679067..d77c2b0287d 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/SecurityAlgorithmSuite.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/SecurityAlgorithmSuite.xml
@@ -555,7 +555,6 @@
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Typical key lengths are 128, 192, and 256 bits.</para>
@@ -564,6 +563,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a particular key length is supported by the asymmetric algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key length is supported by the asymmetric algorithm; otherwise, false.</para>
+        </returns>
         <param name="length">
           <attribution license="cc4" from="Microsoft" modified="false" />The key length to check.</param>
       </Docs>
@@ -582,7 +585,6 @@
         <Parameter Name="algorithm" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -592,6 +594,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether an asymmetric key wrap algorithm is supported.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the asymmetric key wrap algorithm is supported; otherwise, false.</para>
+        </returns>
         <param name="algorithm">
           <attribution license="cc4" from="Microsoft" modified="false" />The algorithm to check.</param>
       </Docs>
@@ -610,7 +616,6 @@
         <Parameter Name="algorithm" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -620,6 +625,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether an asymmetric signature algorithm is supported.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the asymmetric signature algorithm is supported; otherwise, false.</para>
+        </returns>
         <param name="algorithm">
           <attribution license="cc4" from="Microsoft" modified="false" />The algorithm name to check.</param>
       </Docs>
@@ -638,7 +647,6 @@
         <Parameter Name="algorithm" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -648,6 +656,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a canonicalization algorithm is supported.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the canonicalization algorithm is supported; otherwise, false.</para>
+        </returns>
         <param name="algorithm">
           <attribution license="cc4" from="Microsoft" modified="false" />The algorithm name to check.</param>
       </Docs>
@@ -666,7 +678,6 @@
         <Parameter Name="algorithm" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -676,6 +687,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a digest algorithm is supported.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the digest algorithm is supported; otherwise, false.</para>
+        </returns>
         <param name="algorithm">
           <attribution license="cc4" from="Microsoft" modified="false" />The algorithm name to check.</param>
       </Docs>
@@ -694,7 +709,6 @@
         <Parameter Name="algorithm" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -704,6 +718,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether an encryption algorithm is supported.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the encryption algorithm is supported; otherwise, false.</para>
+        </returns>
         <param name="algorithm">
           <attribution license="cc4" from="Microsoft" modified="false" />The algorithm name to check.</param>
       </Docs>
@@ -722,12 +740,15 @@
         <Parameter Name="algorithm" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether an encryption key derivation algorithm is supported.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the encryption key derivation algorithm is supported; otherwise, false.</para>
+        </returns>
         <param name="algorithm">
           <attribution license="cc4" from="Microsoft" modified="false" />The algorithm name to check.</param>
       </Docs>
@@ -746,12 +767,15 @@
         <Parameter Name="algorithm" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a signature key derivation algorithm is supported.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the signature key derivation algorithm is supported; otherwise, false.</para>
+        </returns>
         <param name="algorithm">
           <attribution license="cc4" from="Microsoft" modified="false" />The algorithm name to check.</param>
       </Docs>
@@ -770,7 +794,6 @@
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="length" /> is compared to a range of values depending on the subclass. For example, in the TripleDES subclass, this method verifies that <paramref name="length" /> is between 192 and 256, inclusive.</para>
@@ -779,6 +802,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, indicates whether a particular symmetric key length is supported.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the symmetric key length is supported; otherwise, false.</para>
+        </returns>
         <param name="length">
           <attribution license="cc4" from="Microsoft" modified="false" />The key length to check.</param>
       </Docs>
@@ -797,12 +824,15 @@
         <Parameter Name="algorithm" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a symmetric key wrap algorithm is supported.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the symmetric key wrap algorithm is supported; otherwise, false.</para>
+        </returns>
         <param name="algorithm">
           <attribution license="cc4" from="Microsoft" modified="false" />The algorithm name to check.</param>
       </Docs>
@@ -821,12 +851,15 @@
         <Parameter Name="algorithm" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a symmetric signature algorithm is supported.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the symmetric signature algorithm is supported; otherwise, false.</para>
+        </returns>
         <param name="algorithm">
           <attribution license="cc4" from="Microsoft" modified="false" />The algorithm name to check.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/SecurityContextKeyIdentifierClause.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/SecurityContextKeyIdentifierClause.xml
index 6aa8dc0c987..2f69e5462b5 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/SecurityContextKeyIdentifierClause.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/SecurityContextKeyIdentifierClause.xml
@@ -153,12 +153,15 @@
         <Parameter Name="keyIdentifierClause" Type="System.IdentityModel.Tokens.SecurityKeyIdentifierClause" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares a specified <see cref="T:System.IdentityModel.Tokens.SecurityKeyIdentifierClause" /> to the current instance of the <see cref="T:System.ServiceModel.Security.SecurityContextKeyIdentifierClause" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two instances are equal; otherwise, false.</para>
+        </returns>
         <param name="keyIdentifierClause">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IdentityModel.Tokens.SecurityKeyIdentifierClause" /> to be compared.</param>
       </Docs>
@@ -178,12 +181,15 @@
         <Parameter Name="generation" Type="System.Xml.UniqueId" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares a specified <see cref="T:System.IdentityModel.Tokens.SecurityKeyIdentifierClause" /> to the current instance of the <see cref="T:System.ServiceModel.Security.SecurityContextKeyIdentifierClause" /> class with the specified context identifier and generation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two instances are equal; otherwise, false.</para>
+        </returns>
         <param name="contextId">
           <attribution license="cc4" from="Microsoft" modified="false" />The context ID part of the identifier clause.</param>
         <param name="generation">
@@ -202,12 +208,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides a text representation of this instance of the class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A text representation of this instance of the class.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/SecurityCredentialsManager.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/SecurityCredentialsManager.xml
index 85a67e0c30c..16983d732e0 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/SecurityCredentialsManager.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/SecurityCredentialsManager.xml
@@ -53,7 +53,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A <see cref="T:System.IdentityModel.Selectors.SecurityTokenManager" /> is created by indigo2 for every ChannelFactory at the client and for every ChannelListener/endpoint at the service.</para>
@@ -63,6 +62,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates a new <see cref="T:System.IdentityModel.Selectors.SecurityTokenManager" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created <see cref="T:System.IdentityModel.Selectors.SecurityTokenManager" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/SecurityMessageProperty.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/SecurityMessageProperty.xml
index b7ba1da0552..4ec16ef3bbd 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/SecurityMessageProperty.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/SecurityMessageProperty.xml
@@ -56,7 +56,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To access any objects in the <see cref="T:System.ServiceModel.Security.SecurityMessageProperty" />, such as <see cref="P:System.ServiceModel.Security.SecurityMessageProperty.ServiceSecurityContext" />, <see cref="P:System.ServiceModel.Security.SecurityMessageProperty.TransportToken" />, or <see cref="P:System.ServiceModel.Security.SecurityMessageProperty.IncomingSupportingTokens" />), a copy must be created because these properties are undefined after the message is disposed of.</para>
@@ -65,6 +64,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clones the current instance of this class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.IMessageProperty" /> cloned from the current instance of this class.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Dispose">
@@ -123,12 +126,15 @@
       </Parameters>
       <Docs>
         <param name="message">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets or creates an instance of this class from the specified message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.ServiceModel.Security.SecurityMessageProperty" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HasIncomingSupportingTokens">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/SecurityStateEncoder.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/SecurityStateEncoder.xml
index 05ac79759f4..095c61351dd 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/SecurityStateEncoder.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/SecurityStateEncoder.xml
@@ -55,12 +55,15 @@
         <Parameter Name="data" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes the security state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array that represents the security state.</para>
+        </returns>
         <param name="data">
           <attribution license="cc4" from="Microsoft" modified="false" />Security data.</param>
       </Docs>
@@ -79,12 +82,15 @@
         <Parameter Name="data" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes the security state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array that results from encoding the security state.</para>
+        </returns>
         <param name="data">
           <attribution license="cc4" from="Microsoft" modified="false" />The security state data.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/ServiceCredentialsSecurityTokenManager.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/ServiceCredentialsSecurityTokenManager.xml
index 0dbec3342fd..22af5d92f2c 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/ServiceCredentialsSecurityTokenManager.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/ServiceCredentialsSecurityTokenManager.xml
@@ -80,7 +80,6 @@
         <Parameter Name="requirement" Type="System.IdentityModel.Selectors.SecurityTokenRequirement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.IdentityModel.Selectors.SecurityTokenProvider" /> class is responsible for obtaining tokens for a given <see cref="T:System.ServiceModel.Security.Tokens.ServiceModelSecurityTokenRequirement" />. Optionally, token providers can support renewing and canceling tokens as well. The token provider can cache tokens if it is configured to do so. </para>
@@ -89,6 +88,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a security token provider based on the <see cref="T:System.IdentityModel.Selectors.SecurityTokenRequirement" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The security token provider.</para>
+        </returns>
         <param name="requirement">
           <attribution license="cc4" from="Microsoft" modified="false" />The security token requirement.</param>
       </Docs>
@@ -107,7 +110,6 @@
         <Parameter Name="version" Type="System.IdentityModel.Selectors.SecurityTokenVersion" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.IdentityModel.Selectors.SecurityTokenSerializer" /> is used for writing and reading security tokens and security token references. When deserializing the token from XML, the returned token must be able to perform cryptographic operations. The token serializer must be able to do enough validation to ensure that the token can do cryptographic operations (Kerberos ticket processing, X.509 decoding, SAML decoding, and so on) but should defer application trust decisions to the authenticator.</para>
@@ -116,6 +118,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a security token serializer based on the security token version passed in.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The security token serializer.</para>
+        </returns>
         <param name="version">
           <attribution license="cc4" from="Microsoft" modified="false" />The version of the security token.</param>
       </Docs>
@@ -135,7 +141,6 @@
       </Parameters>
       <Docs>
         <param name="requirement">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called by the indigo2 infrastructure to obtain the <see cref="T:System.ServiceModel.EndpointIdentity" /> that corresponds to a service endpoint.</para>
@@ -144,6 +149,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.ServiceModel.EndpointIdentity" /> based on the security token requirement. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The endpoint identity that corresponds to the <paramref name="tokenRequirement" />. null is returned if an identity cannot be created from the <paramref name="tokenRequirement" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsIssuedSecurityTokenRequirement">
@@ -160,12 +169,15 @@
         <Parameter Name="requirement" Type="System.IdentityModel.Selectors.SecurityTokenRequirement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the security token requirement is for an issued token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the security token requirement is for an issued token; otherwise, false. </para>
+        </returns>
         <param name="requirement">
           <attribution license="cc4" from="Microsoft" modified="false" />The security token requirement.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/SspiSecurityTokenProvider.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/SspiSecurityTokenProvider.xml
index e806466cc37..fcd3e51ae0f 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/SspiSecurityTokenProvider.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/SspiSecurityTokenProvider.xml
@@ -93,7 +93,6 @@
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The security token is of type <see cref="T:System.ServiceModel.Security.Tokens.SspiSecurityToken" />.</para>
@@ -102,6 +101,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the security token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The security token.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Timespan" /> that represents the time-out interval.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/WSSecurityTokenSerializer.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/WSSecurityTokenSerializer.xml
index 58d54e8c0eb..31b5142b216 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/WSSecurityTokenSerializer.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Security/WSSecurityTokenSerializer.xml
@@ -191,12 +191,15 @@
       </Parameters>
       <Docs>
         <param name="reader">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the key identifier clause core can be read using the specified reader. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key identifier clause core can be read using the specified reader; otherwise, false. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CanReadKeyIdentifierCore">
@@ -214,12 +217,15 @@
       </Parameters>
       <Docs>
         <param name="reader">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the key identifier core can be read using the specified reader.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key identifier core can be read using the specified reader; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CanReadTokenCore">
@@ -237,12 +243,15 @@
       </Parameters>
       <Docs>
         <param name="reader">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the token core can be read using the specified reader.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the token core can be read using the specified reader; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CanWriteKeyIdentifierClauseCore">
@@ -260,12 +269,15 @@
       </Parameters>
       <Docs>
         <param name="keyIdentifierClause">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the key identifier clause core with a specified key identifier clause can be written.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key identifier clause core with the specified key identifier clause can be written; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CanWriteKeyIdentifierCore">
@@ -283,12 +295,15 @@
       </Parameters>
       <Docs>
         <param name="keyIdentifier">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the key identifier core with a specified key identifier clause can be written.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key identifier core with the specified key identifier clause can be written; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CanWriteTokenCore">
@@ -306,12 +321,15 @@
       </Parameters>
       <Docs>
         <param name="token">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the token core with a specified security token can be written.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the token core with the specified security token can be written; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateKeyIdentifierClauseFromTokenXml">
@@ -331,12 +349,15 @@
       <Docs>
         <param name="tokenXml">To be added.</param>
         <param name="referenceStyle">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a key identifier clause from a token expressed as XML.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created security key identifier.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DefaultInstance">
@@ -392,12 +413,15 @@
       </Parameters>
       <Docs>
         <param name="tokenType">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the URI of the security token of the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The URI of the security token of the specified type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MaximumKeyDerivationLabelLength">
@@ -472,12 +496,15 @@
       </Parameters>
       <Docs>
         <param name="reader">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the key identifier clause core using the specified <see cref="T:System.Xml.XmlReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The security key identifier clause that was read.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadKeyIdentifierCore">
@@ -495,12 +522,15 @@
       </Parameters>
       <Docs>
         <param name="reader">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the key identifier core using the specified <see cref="T:System.Xml.XmlReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The security key identifier that was read.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadTokenCore">
@@ -520,12 +550,15 @@
       <Docs>
         <param name="reader">To be added.</param>
         <param name="tokenResolver">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the token core using the specified <see cref="T:System.Xml.XmlReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The security token that was read.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SecurityVersion">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Atom10FeedFormatter.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Atom10FeedFormatter.xml
index 9a23f71e6d3..e18342346ef 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Atom10FeedFormatter.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Atom10FeedFormatter.xml
@@ -106,7 +106,6 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method does not advance the reader to beyond the start element.</para>
@@ -115,6 +114,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies whether the specified <see cref="T:System.Xml.XmlReader" /> contains a valid Atom 1.0 syndication feed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that specifies whether the <see cref="T:System.Xml.XmlReader" /> contains a valid Atom 1.0 syndication feed.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read from.</param>
       </Docs>
@@ -131,7 +134,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The newly created <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> instance is not automatically associated with the <see cref="T:System.ServiceModel.Syndication.Atom10FeedFormatter" /> used to create it.</para>
@@ -140,6 +142,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="FeedType">
@@ -243,7 +249,6 @@
         <Parameter Name="feed" Type="System.ServiceModel.Syndication.SyndicationFeed" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method does not add the newly created <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance to the <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" />, because this is done by the caller of the method. This method provides an extensibility point for classes derived from <see cref="T:System.ServiceModel.Syndication.Atom10FeedFormatter" /> to customize how an Atom 1.0 entry is deserialized.</para>
@@ -252,6 +257,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a syndication item from <see cref="T:System.Xml.XmlReader" /> instance using the <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read from.</param>
         <param name="feed">
@@ -294,7 +303,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Override this method to return your own schema.</para>
@@ -303,6 +311,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implements the <see cref="M:System.Xml.Serialization.IXmlSerializable.GetSchema" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Atom10FeedFormatter`1.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Atom10FeedFormatter`1.xml
index e2c28cfe98c..8f5de29de3d 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Atom10FeedFormatter`1.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Atom10FeedFormatter`1.xml
@@ -82,12 +82,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> derived class. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> class. </para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Atom10ItemFormatter.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Atom10ItemFormatter.xml
index 6be69484821..93d5f42b538 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Atom10ItemFormatter.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Atom10ItemFormatter.xml
@@ -105,12 +105,15 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies whether the specified <see cref="T:System.Xml.XmlReader" /> contains a valid Atom 1.0 syndication item.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that specifies whether the <see cref="T:System.Xml.XmlReader" /> contains a valid Atom 1.0 syndication item.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read from.</param>
       </Docs>
@@ -127,7 +130,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The newly created <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance is not automatically associated with the <see cref="T:System.ServiceModel.Syndication.Atom10ItemFormatter" /> used to create it.</para>
@@ -136,6 +138,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ItemType">
@@ -236,7 +242,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Override this method to return your own schema.</para>
@@ -245,6 +250,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implements the <see cref="M:System.Xml.Serialization.IXmlSerializable.GetSchema" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Atom10ItemFormatter`1.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Atom10ItemFormatter`1.xml
index 6828ed9a43c..8a724705918 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Atom10ItemFormatter`1.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Atom10ItemFormatter`1.xml
@@ -82,12 +82,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the <see cref="T:System.ServiceModel.Syndication.SyndicationItem" />-derived class. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> class. </para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/AtomPub10CategoriesDocumentFormatter.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/AtomPub10CategoriesDocumentFormatter.xml
index f8c6660ce99..02ab42865d2 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/AtomPub10CategoriesDocumentFormatter.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/AtomPub10CategoriesDocumentFormatter.xml
@@ -101,12 +101,15 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies whether the specified <see cref="T:System.Xml.XmlReader" /> contains a valid Atom 1.0 categories document. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that specifies whether the <see cref="T:System.Xml.XmlReader" /> contains a valid Atom 1.0 categories document.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read from.</param>
       </Docs>
@@ -123,12 +126,17 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.ServiceModel.Syndication.InlineCategoriesDocument" /> that can be serialized into a &lt;atom:categories&gt; element within a service document and contains the set of categories within the element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns an <see cref="T:System.ServiceModel.Syndication.InlineCategoriesDocument" /> that can be serialized into a &lt;atom:categories&gt; element within a service document.
+</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateReferencedCategoriesDocument">
@@ -143,12 +151,17 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.ServiceModel.Syndication.ReferencedCategoriesDocument" /> that can be serialized into a &lt;atom:categories&gt; element within a service document and contains a URI reference to the set of categories within the element. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns a <see cref="T:System.ServiceModel.Syndication.ReferencedCategoriesDocument" /> that can be serialized into a &lt;atom:categories&gt; element within a service document.
+</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadFrom">
@@ -186,7 +199,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Override this method to return your own schema.</para>
@@ -195,6 +207,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implements the <see cref="M:System.Xml.Serialization.IXmlSerializable.GetSchema" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/AtomPub10ServiceDocumentFormatter.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/AtomPub10ServiceDocumentFormatter.xml
index 67cc60c04ec..795cb573124 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/AtomPub10ServiceDocumentFormatter.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/AtomPub10ServiceDocumentFormatter.xml
@@ -106,12 +106,17 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether the specified XML reader contains a valid service document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+true if the XML reader does contain a valid service document; otherwise false.
+</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The XML reader.</param>
       </Docs>
@@ -128,12 +133,17 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.ServiceDocument" /> instance associated with the Atom 1.0 formatter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns an instance of a <see cref="T:System.ServiceModel.Syndication.ServiceDocument" />.
+</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadFrom">
@@ -171,7 +181,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Explicitly implements the <see cref="T:System.Xml.Serialization.ISerialization.GetSchema" /> method.</para>
@@ -180,6 +189,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is reserved and should not be used.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns null.
+</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/AtomPub10ServiceDocumentFormatter`1.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/AtomPub10ServiceDocumentFormatter`1.xml
index 806f8ba328e..febbb056454 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/AtomPub10ServiceDocumentFormatter`1.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/AtomPub10ServiceDocumentFormatter`1.xml
@@ -79,12 +79,17 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.ServiceDocument" /> instance associated with the Atom 1.0 formatter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns an instance of <see cref="T:System.ServiceModel.Syndication.ServiceDocument" />.
+</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/CategoriesDocument.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/CategoriesDocument.xml
index 97054083c16..60c90e3adb4 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/CategoriesDocument.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/CategoriesDocument.xml
@@ -76,12 +76,17 @@
         <Parameter Name="categories" Type="System.Collections.ObjectModel.Collection&lt;System.ServiceModel.Syndication.SyndicationCategory&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.CategoriesDocument" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns <see cref="T:System.ServiceModel.Syndication.InlineCategoriesDocument" />.
+</para>
+        </returns>
         <param name="categories">
           <attribution license="cc4" from="Microsoft" modified="false" />A collection of <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> instances used to initialize the new <see cref="T:System.ServiceModel.Syndication.CategoriesDocument" /> instance. </param>
       </Docs>
@@ -100,12 +105,17 @@
         <Parameter Name="linkToCategoriesDocument" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the <see cref="T:System.ServiceModel.Syndication.CategoriesDocument" /> initializing it with the specified <see cref="T:System.Uri" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns <see cref="T:System.ServiceModel.Syndication.ReferencedCategoriesDocument" />.
+</para>
+        </returns>
         <param name="linkToCategoriesDocument">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the categories document.</param>
       </Docs>
@@ -126,7 +136,6 @@
         <Parameter Name="scheme" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <paramref name="isFixed" /> parameter is set to true, the categories contained within the categories document are immutable. If the <paramref name="isFixed" /> parameter is set to true, additional categories can be added to the categories document.</para>
@@ -135,6 +144,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the <see cref="T:System.ServiceModel.Syndication.CategoriesDocument" /> class. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns <see cref="T:System.ServiceModel.Syndication.InlineCategoriesDocument" />.
+</para>
+        </returns>
         <param name="categories">
           <attribution license="cc4" from="Microsoft" modified="false" />A collection of categories.</param>
         <param name="isFixed">
@@ -174,12 +189,17 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a new <see cref="T:System.ServiceModel.Syndication.AtomPub10CategoriesDocumentFormatter" /> instance initialized with the <see cref="T:System.ServiceModel.Syndication.CategoriesDocument" /> on which this method is called.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns <see cref="T:System.ServiceModel.Syndication.CategoriesDocumentFormatter" />.
+</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Language">
@@ -215,12 +235,17 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads a <see cref="T:System.ServiceModel.Syndication.CategoriesDocument" /> instance from an <see cref="T:System.Xml.XmlReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns <see cref="T:System.ServiceModel.Syndication.CategoriesDocument" />.
+</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read from.</param>
       </Docs>
@@ -265,12 +290,17 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an attribute extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns <see cref="T:System.Boolean" />.
+</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the element.</param>
         <param name="ns">
@@ -296,12 +326,17 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an element extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns <see cref="T:System.Boolean" />.
+</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read from.</param>
         <param name="version">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/CategoriesDocumentFormatter.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/CategoriesDocumentFormatter.xml
index 8cad19c0ac9..bac84e50d84 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/CategoriesDocumentFormatter.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/CategoriesDocumentFormatter.xml
@@ -76,12 +76,16 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies whether the specified <see cref="T:System.Xml.XmlReader" /> contains a valid Atom 1.0 categories document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that specifies whether the <see cref="T:System.Xml.XmlReader" /> contains a valid Atom 1.0 categories document.
+</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read from.</param>
       </Docs>
@@ -98,12 +102,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.ServiceModel.Syndication.InlineCategoriesDocument" /> that can be serialized into a &lt;atom:categories&gt; element within a service document and contains the set of categories within the element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns an <see cref="T:System.ServiceModel.Syndication.InlineCategoriesDocument" /> that can be serialized into a &lt;atom:categories&gt; element within a service document.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateReferencedCategoriesDocument">
@@ -118,12 +126,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.ServiceModel.Syndication.ReferencedCategoriesDocument" /> that can be serialized into a &lt;atom:categories&gt; element within a service document and contains a URI reference to the set of categories within the element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns a <see cref="T:System.ServiceModel.Syndication.ReferencedCategoriesDocument" /> that can be serialized into a &lt;atom:categories&gt; element within a service document.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Document">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/InlineCategoriesDocument.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/InlineCategoriesDocument.xml
index ea86b8b9564..3eea246ba67 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/InlineCategoriesDocument.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/InlineCategoriesDocument.xml
@@ -111,12 +111,17 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns a new  <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> instance.
+</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsFixed">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/ResourceCollectionInfo.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/ResourceCollectionInfo.xml
index 2e951467a88..152ac49908f 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/ResourceCollectionInfo.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/ResourceCollectionInfo.xml
@@ -229,12 +229,17 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.InlineCategoriesDocument" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns <see cref="T:System.ServiceModel.Syndication.InlineCategoriesDocument" />.
+</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateReferencedCategoriesDocument">
@@ -249,12 +254,17 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.ReferencedCategoriesDocument" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns <see cref="T:System.ServiceModel.Syndication.ReferencedCategoriesDocument" />.
+</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ElementExtensions">
@@ -336,12 +346,17 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an attribute extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns <see cref="T:System.Boolean" />.
+</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the element.</param>
         <param name="ns">
@@ -367,12 +382,17 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an element extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns <see cref="T:System.Boolean" />.
+</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read from.</param>
         <param name="version">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Rss20FeedFormatter.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Rss20FeedFormatter.xml
index d66e1ecfdb6..af75d50afc5 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Rss20FeedFormatter.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Rss20FeedFormatter.xml
@@ -129,12 +129,15 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies whether the specified <see cref="T:System.Xml.XmlReader" /> contains a valid RSS 2.0 syndication feed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that specifies whether the <see cref="T:System.Xml.XmlReader" /> contains a valid RSS 2.0 syndication feed.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read from.</param>
       </Docs>
@@ -151,12 +154,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="FeedType">
@@ -260,7 +266,6 @@
         <Parameter Name="feed" Type="System.ServiceModel.Syndication.SyndicationFeed" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The newly created <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance is not added to the <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> associated with the <see cref="T:System.ServiceModel.Syndication.Rss20FeedFormatter" /> instance.</para>
@@ -269,6 +274,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a syndication item from <see cref="T:System.Xml.XmlReader" /> instance using the <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read from.</param>
         <param name="feed">
@@ -356,7 +365,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Override this method to return your own schema.</para>
@@ -365,6 +373,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implements the <see cref="M:System.Xml.Serialization.IXmlSerializable.GetSchema" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Rss20FeedFormatter`1.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Rss20FeedFormatter`1.xml
index 2ea1d62f4c1..5543cea711f 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Rss20FeedFormatter`1.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Rss20FeedFormatter`1.xml
@@ -97,12 +97,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> derived class. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> class. </para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Rss20ItemFormatter.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Rss20ItemFormatter.xml
index 3adf3cf2b27..62943d34a83 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Rss20ItemFormatter.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Rss20ItemFormatter.xml
@@ -129,12 +129,15 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies whether the specified <see cref="T:System.Xml.XmlReader" /> contains a valid RSS 2.0 syndication item.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that specifies if the <see cref="T:System.Xml.XmlReader" /> contains a valid RSS 2.0 syndication item.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read from.</param>
       </Docs>
@@ -151,7 +154,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The newly created <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance is not automatically associated with the <see cref="T:System.ServiceModel.Syndication.Rss20ItemFormatter" /> used to create it.</para>
@@ -160,6 +162,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ItemType">
@@ -282,7 +288,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Override this method to return your own schema.</para>
@@ -291,6 +296,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implements the <see cref="M:System.Xml.Serialization.IXmlSerializable.GetSchema" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Rss20ItemFormatter`1.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Rss20ItemFormatter`1.xml
index 2c58780ea35..6acd9888032 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Rss20ItemFormatter`1.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Rss20ItemFormatter`1.xml
@@ -97,12 +97,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> derived class. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> class. </para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/ServiceDocument.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/ServiceDocument.xml
index 8009ec62d05..d8bdfc5d6e8 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/ServiceDocument.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/ServiceDocument.xml
@@ -107,12 +107,17 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.Workspace" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+A new workspace.
+</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ElementExtensions">
@@ -150,12 +155,17 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.ServiceModel.Syndication.AtomPub10ServiceDocumentFormatter" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+A <see cref="T:System.ServiceModel.Syndication.ServiceDocumentFormatter" /> instance.
+</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Language">
@@ -191,12 +201,17 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads a service document from the specified <see cref="T:System.Xml.XmlReader" /> into a <see cref="T:System.ServiceModel.Syndication.ServiceDocument" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+A <see cref="T:System.ServiceModel.Syndication.ServiceDocument" /> instance.
+</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read the service document from.</param>
       </Docs>
@@ -223,12 +238,15 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads a service document from the specified <see cref="T:System.Xml.XmlReader" /> into a <see cref="T:System.ServiceModel.Syndication.ServiceDocument" /> derived instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A<see cref="T:System.ServiceModel.Syndication.ServiceDocument" /> instance.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read the service document from.</param>
         <typeparam name="TServiceDocument">
@@ -275,12 +293,17 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an attribute extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute is successfully parsed; otherwise, false.
+Returns <see cref="T:System.Boolean" />.
+</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the element.</param>
         <param name="ns">
@@ -306,12 +329,15 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an element extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the element is successfully parsed; otherwise, false.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read from.</param>
         <param name="version">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/ServiceDocumentFormatter.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/ServiceDocumentFormatter.xml
index e22881afa4e..82e83796d5f 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/ServiceDocumentFormatter.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/ServiceDocumentFormatter.xml
@@ -76,12 +76,17 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies whether the specified <see cref="T:System.Xml.XmlReader" /> contains a valid service document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+true, if the XML reader contains a valid service document, otherwise false.
+</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />An XML reader to check.</param>
       </Docs>
@@ -100,12 +105,17 @@
         <Parameter Name="inlineCategories" Type="System.ServiceModel.Syndication.InlineCategoriesDocument" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> class. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns a new <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> instance.
+</para>
+        </returns>
         <param name="inlineCategories">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ServiceModel.Syndication.InlineCategories" /> instance used to create the new categories document.</param>
       </Docs>
@@ -124,12 +134,17 @@
         <Parameter Name="workspace" Type="System.ServiceModel.Syndication.Workspace" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.ResourceCollectionInfo" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns a new <see cref="T:System.ServiceModel.Syndication.ResourceCollectionInfo" /> instance.
+</para>
+        </returns>
         <param name="workspace">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ServiceModel.Syndication.Workspace" /> instance used to create the new collection.</param>
       </Docs>
@@ -146,12 +161,17 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.ServiceDocument" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns a new <see cref="T:System.ServiceModel.Syndication.ServiceDocument" /> instance. 
+</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateInlineCategories">
@@ -168,12 +188,17 @@
         <Parameter Name="collection" Type="System.ServiceModel.Syndication.ResourceCollectionInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.InlineCategoriesDocument" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns a new <see cref="T:System.ServiceModel.Syndication.InlineCategoriesDocument" /> instance.
+</para>
+        </returns>
         <param name="collection">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Syndication.ResourceCollectionInfo" /> to use to create the new <see cref="T:System.ServiceModel.Syndication.InlineCategoriesDocument" />.</param>
       </Docs>
@@ -192,12 +217,17 @@
         <Parameter Name="collection" Type="System.ServiceModel.Syndication.ResourceCollectionInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.ReferencedCategoriesDocument" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns a new <see cref="T:System.ServiceModel.Syndication.ReferencedCategoriesDocument" />.
+</para>
+        </returns>
         <param name="collection">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Syndication.ResourceCollectionInfo" /> instance to use to create the new <see cref="T:System.ServiceModel.Syndication.ReferencedCategoriesDocument" />.</param>
       </Docs>
@@ -216,12 +246,17 @@
         <Parameter Name="document" Type="System.ServiceModel.Syndication.ServiceDocument" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.Workspace" /></para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns a new <see cref="T:System.ServiceModel.Syndication.Workspace" />.
+</para>
+        </returns>
         <param name="document">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Syndication.ServiceDocument" /> to use to create the new workspace.</param>
       </Docs>
@@ -425,12 +460,17 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an attribute extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns a <see cref="T:System.Boolean" /> that indicates whether the attribute extension was successfully parsed.
+</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the element.</param>
         <param name="ns">
@@ -461,12 +501,17 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an attribute extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns a <see cref="T:System.Boolean" /> that indicates whether the attribute extension was parsed successfully.
+</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the element.</param>
         <param name="ns">
@@ -497,12 +542,17 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an attribute extensions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns a <see cref="T:System.Boolean" /> that indicates whether the attribute extension was parsed successfully.
+</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the element.</param>
         <param name="ns">
@@ -533,12 +583,17 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an attribute extension</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns a <see cref="T:System.Boolean" /> that indicates whether the attribute extension was parsed successfully.
+</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the element.</param>
         <param name="ns">
@@ -567,12 +622,17 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an element extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns a <see cref="T:System.Boolean" /> that indicates whether the element extension was parsed successfully.
+</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read from.</param>
         <param name="categories">
@@ -597,12 +657,17 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an element extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns a <see cref="T:System.Boolean" /> that indicates whether the element extension was parsed successfully.
+</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read from.</param>
         <param name="collection">
@@ -627,12 +692,17 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an element extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns a <see cref="T:System.Boolean" /> that indicates whether the element extension was successfully parsed.
+</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read from.</param>
         <param name="document">
@@ -657,12 +727,17 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an element extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns a <see cref="T:System.Boolean" /> that indicates whether the element extension was parsed successfully.
+</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read from.</param>
         <param name="workspace">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationCategory.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationCategory.xml
index 5acb75e2ae0..d90b8fbe9e3 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationCategory.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationCategory.xml
@@ -141,12 +141,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of a <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ElementExtensions">
@@ -255,7 +258,6 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attribute extensions are custom attributes that are not defined by the Atom 1.0 or RSS 2.0 specifications. They are serialized as an attribute of the &lt;category&gt; element. This method is an extension point that allows you to handle the deserialization of a custom attribute extension. To do this, derive a class from <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> and override this method. This method is called for all unrecognized attribute extensions.</para>
@@ -264,6 +266,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an attribute extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that specifies whether the attribute extension was parsed successfully.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the element.</param>
         <param name="ns">
@@ -289,7 +295,6 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Element extensions are valid XML elements that are not specified in either the Atom 1.0 or RSS 2.0 specifications. You can add any valid XML element as an extension, provided its namespace is different from the enclosing namespace. This method is an extension point that allows you to handle the deserialization of a custom element extension. To do this, derive a class from <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> and override this method. This method is called for all unrecognized attribute extensions.</para>
@@ -298,6 +303,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an element extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that specifies whether the element extension has been parsed successfully.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read from.</param>
         <param name="version">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationContent.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationContent.xml
index 4a5a2733a91..3fde1a00241 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationContent.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationContent.xml
@@ -108,12 +108,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the <see cref="T:System.ServiceModel.Syndication.SyndicationContent" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the <see cref="T:System.ServiceModel.Syndication.SyndicationContent" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateHtmlContent">
@@ -130,7 +133,6 @@
         <Parameter Name="content" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The string passed into this method should contain HTML.</para>
@@ -139,6 +141,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.TextSyndicationContent" /> instance with the specified HTML content.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Syndication.TextSyndicationContent" /> instance.</para>
+        </returns>
         <param name="content">
           <attribution license="cc4" from="Microsoft" modified="false" />The text of the content.</param>
       </Docs>
@@ -157,12 +163,15 @@
         <Parameter Name="content" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.TextSyndicationContent" /> instance with the specified plain text content.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.TextSyndicationContent" /> instance.</para>
+        </returns>
         <param name="content">
           <attribution license="cc4" from="Microsoft" modified="false" />The plain text content.</param>
       </Docs>
@@ -182,7 +191,6 @@
         <Parameter Name="mediaType" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The media type parameter can be set to any known MIME type value as defined in <see cref="http://go.microsoft.com/fwlink/?LinkId=95720">RFC 2046</see>.</para>
@@ -191,6 +199,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.UrlSyndicationContent" /> instance with the specified <see cref="T:System.Uri" /> and media type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.UrlSyndicationContent" /> instance.</para>
+        </returns>
         <param name="url">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Uri" /> of the content.</param>
         <param name="mediaType">
@@ -211,12 +223,15 @@
         <Parameter Name="content" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.TextSyndicationContent" /> instance with the specified XHTML content.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.TextSyndicationContent" /> instance.</para>
+        </returns>
         <param name="content">
           <attribution license="cc4" from="Microsoft" modified="false" />The XHTML content.</param>
       </Docs>
@@ -235,12 +250,15 @@
         <Parameter Name="dataContractObject" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.XmlSyndicationContent" /> instance with the specified data contract object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.XmlSyndicationContent" /> instance.</para>
+        </returns>
         <param name="dataContractObject">
           <attribution license="cc4" from="Microsoft" modified="false" />The data contract object.</param>
       </Docs>
@@ -260,12 +278,15 @@
       </Parameters>
       <Docs>
         <param name="reader">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates XML syndication content.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the <see cref="T:System.ServiceModel.Syndication.XmlSyndicationContent" /> class that contains the new content.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateXmlContent">
@@ -283,12 +304,15 @@
         <Parameter Name="dataContractSerializer" Type="System.Runtime.Serialization.XmlObjectSerializer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.XmlSyndicationContent" /> instance with the specified data contract object and data contract serializer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.XmlSyndicationContent" /> instance.</para>
+        </returns>
         <param name="dataContractObject">
           <attribution license="cc4" from="Microsoft" modified="false" />The data contract object.</param>
         <param name="dataContractSerializer">
@@ -310,12 +334,15 @@
         <Parameter Name="serializer" Type="System.Xml.Serialization.XmlSerializer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.XmlSyndicationContent" /> instance with the specified object and XML serializer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.XmlSyndicationContent" /> instance.</para>
+        </returns>
         <param name="xmlSerializerObject">
           <attribution license="cc4" from="Microsoft" modified="false" />The object.</param>
         <param name="serializer">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationElementExtension.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationElementExtension.xml
index b25e9010a41..d899a3fbed9 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationElementExtension.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationElementExtension.xml
@@ -205,12 +205,15 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the object that represents the element extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object of the specified type that contains the element extension.</para>
+        </returns>
         <typeparam name="TExtension">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the extension to retrieve.</typeparam>
       </Docs>
@@ -232,12 +235,15 @@
         <Parameter Name="serializer" Type="System.Runtime.Serialization.XmlObjectSerializer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the object that represents the element extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object of the specified type that contains the element extension.</para>
+        </returns>
         <param name="serializer">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Runtime.Serialization.XmlObjectSerializer" /> to use.</param>
         <typeparam name="TExtension">
@@ -261,12 +267,15 @@
         <Parameter Name="serializer" Type="System.Xml.Serialization.XmlSerializer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the object that represents the element extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object of the specified type that contains the element extension.</para>
+        </returns>
         <param name="serializer">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Serialization.XmlSerializer" /> to use.</param>
         <typeparam name="TExtension">
@@ -285,12 +294,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Xml.XmlReader" /> associated with the <see cref="T:System.ServiceModel.Syndication.SyndicationElementExtension" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.XmlReader" /> associated with the <see cref="T:System.ServiceModel.Syndication.SyndicationElementExtension" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="OuterName">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationElementExtensionCollection.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationElementExtensionCollection.xml
index 6b10eca408a..e21870be180 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationElementExtensionCollection.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationElementExtensionCollection.xml
@@ -208,12 +208,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <see cref="T:System.Xml.XmlReader" /> with the element extensions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlReader" /> that contains the element extensions.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InsertItem">
@@ -255,12 +258,15 @@
         <Parameter Name="extensionNamespace" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the element extensions with the specified name and namespace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of element extension objects.</para>
+        </returns>
         <param name="extensionName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the element extension.</param>
         <param name="extensionNamespace">
@@ -288,12 +294,15 @@
         <Parameter Name="serializer" Type="System.Runtime.Serialization.XmlObjectSerializer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the element extensions with the specified name and namespace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of element extension objects.</para>
+        </returns>
         <param name="extensionName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the element extension.</param>
         <param name="extensionNamespace">
@@ -323,12 +332,15 @@
         <Parameter Name="serializer" Type="System.Xml.Serialization.XmlSerializer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the element extensions with the specified name and namespace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of element extension objects.</para>
+        </returns>
         <param name="extensionName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the element extension.</param>
         <param name="extensionNamespace">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationFeed.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationFeed.xml
index 540f17ce42b..c499e30a94d 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationFeed.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationFeed.xml
@@ -577,7 +577,6 @@
         <Parameter Name="cloneItems" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <paramref name="cloneItems" /> parameter is true, all items within the <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> object are cloned; otherwise, the new <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> instance's items collection contain references to the original <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> instance's items.</para>
@@ -586,6 +585,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A duplicate <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> object.</para>
+        </returns>
         <param name="cloneItems">
           <attribution license="cc4" from="Microsoft" modified="false" />A value that specifies whether the <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> objects are cloned.</param>
       </Docs>
@@ -648,7 +651,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method does not add the <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> object to the <see cref="P:System.ServiceModel.Syndication.SyndicationFeed.Categories" /> collection.</para>
@@ -657,6 +659,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateItem">
@@ -671,7 +677,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method does not add the <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> object to the <see cref="P:System.ServiceModel.Syndication.SyndicationFeed.Items" /> collection.</para>
@@ -680,6 +685,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateLink">
@@ -694,7 +703,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The new <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> instance is not added to the <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> instance used to create it.</para>
@@ -703,6 +711,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreatePerson">
@@ -717,7 +729,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method does not add the <see cref="T:System.ServiceModel.Syndication.SyndicationPerson" /> object to the <see cref="P:System.ServiceModel.Syndication.SyndicationFeed.Authors" /> or <see cref="P:System.ServiceModel.Syndication.SyndicationFeed.Contributors" /> collections. </para>
@@ -726,6 +737,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.SyndicationPerson" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationPerson" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Description">
@@ -809,12 +824,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <see cref="T:System.ServiceModel.Syndication.Atom10FeedFormatter" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Syndication.Atom10FeedFormatter" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetRss20Formatter">
@@ -829,12 +847,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <see cref="T:System.ServiceModel.Syndication.Rss20FeedFormatter" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Syndication.Rss20FeedFormatter" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetRss20Formatter">
@@ -851,7 +872,6 @@
         <Parameter Name="serializeExtensionsAsAtom" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The RSS 2.0 specification allows elements and attributes that are not specified in its specification only if they are within a namespace. When the <paramref name="serializedExtensionsAsAtom" /> parameter is true, the formatter automatically adds the a10 namespace qualifier to all extensions; otherwise, the extensions are not serialized.</para>
@@ -860,6 +880,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a new <see cref="T:System.ServiceModel.Syndication.Rss20FeedFormatter" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Syndication.Rss20FeedFormatter" /> instance.</para>
+        </returns>
         <param name="serializeExtensionsAsAtom">
           <attribution license="cc4" from="Microsoft" modified="false" />A value that specifies whether to serialize element and attribute extensions with an Atom 1.0 namespace.</param>
       </Docs>
@@ -1016,12 +1040,15 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads a syndication feed from the specified XML reader.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> that contains the loaded contents.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to load the feed from.</param>
       </Docs>
@@ -1048,7 +1075,6 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method when you are loading a syndication item into a class derived from <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" />.</para>
@@ -1057,6 +1083,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads a <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" />-derived instance from the specified <see cref="T:System.Xml.XmlReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" />-derived instance that contains the feed.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read from.</param>
         <typeparam name="TSyndicationFeed">
@@ -1148,7 +1178,6 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attribute extensions are custom attributes that are not defined by the Atom 1.0 or RSS 2.0 specifications. They are serialized as an attribute of the &lt;feed&gt; (for Atom 1.0) or &lt;rss&gt; (for RSS 1.0) element, which depends upon the syndication version being used. This method is an extension point that allows you to handle the deserialization of a custom attribute extension. To do this, you must derive a class from <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> and override this method. This method is called for all unrecognized attribute extensions.</para>
@@ -1157,6 +1186,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an attribute extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that specifies whether the attribute extension was parsed successfully.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the element.</param>
         <param name="ns">
@@ -1182,7 +1215,6 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Element extensions are valid XML elements that are not specified in either the Atom 1.0 or RSS 2.0 specifications. You can add any valid XML element as an extension, provided its namespace is different from the enclosing namespace. This method is an extension point that allows you to handle the deserialization of a custom element extension. To do this, you must derive a class from <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> and override this method. This method is called for all unrecognized element extensions.</para>
@@ -1191,6 +1223,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an element extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that specifies whether the element extension was parsed successfully.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read from.</param>
         <param name="version">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationFeedFormatter.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationFeedFormatter.xml
index 95ff82247a6..ac51efed55b 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationFeedFormatter.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationFeedFormatter.xml
@@ -79,7 +79,6 @@
       </Parameters>
       <Docs>
         <param name="reader">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method verifies whether the start element name and namespace match the start element name and namespace of the RSS 2.0 or Atom 1.0 specification.</para>
@@ -88,6 +87,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies whether the specified <see cref="T:System.Xml.XmlReader" /> contains a valid syndication feed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if the XML reader contains a valid syndication feed, otherwise false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateCategory">
@@ -105,7 +108,6 @@
       </Parameters>
       <Docs>
         <param name="feed">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The newly created <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> instance is not automatically added to the <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> instance used to create it.</para>
@@ -114,6 +116,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> class using the specified <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateCategory">
@@ -131,7 +137,6 @@
       </Parameters>
       <Docs>
         <param name="item">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The newly created <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> instance is not automatically added to the <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance used to create it.</para>
@@ -140,6 +145,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> class using the specified <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateFeedInstance">
@@ -154,7 +163,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The newly created <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> instance is not automatically added to the <see cref="T:System.ServiceModel.Syndication.SyndicationFeedFormatter" /> instance used to create it.</para>
@@ -163,6 +171,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateItem">
@@ -180,7 +192,6 @@
       </Parameters>
       <Docs>
         <param name="feed">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The newly created <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance is not automatically added to the <see cref="T:System.ServiceModel.Syndication.SyndicationFeedFormatter" /> instance used to create it.</para>
@@ -189,6 +200,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> class using the specified <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateLink">
@@ -206,7 +221,6 @@
       </Parameters>
       <Docs>
         <param name="feed">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The newly created <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> instance is not automatically added to the <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> instance used to create it.</para>
@@ -215,6 +229,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> class with the specified <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateLink">
@@ -232,7 +250,6 @@
       </Parameters>
       <Docs>
         <param name="item">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The newly created <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> instance is not automatically added to the <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance used to create it.</para>
@@ -241,6 +258,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> class with the specified <see cref="T:System.ServiceModel.Syndication.SyndicationItem" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreatePerson">
@@ -258,7 +279,6 @@
       </Parameters>
       <Docs>
         <param name="feed">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The newly created <see cref="T:System.ServiceModel.Syndication.SyndicationPerson" /> instance is not automatically added to the <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> instance used to create it.</para>
@@ -267,6 +287,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.SyndicationPerson" /> instance with the specified <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationPerson" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreatePerson">
@@ -284,7 +308,6 @@
       </Parameters>
       <Docs>
         <param name="item">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The newly created <see cref="T:System.ServiceModel.Syndication.SyndicationPerson" /> instance is not automatically added to the <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance used to create it.</para>
@@ -293,6 +316,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.SyndicationPerson" /> instance with the specified <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationPerson" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Feed">
@@ -524,12 +551,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a string representation of the <see cref="T:System.ServiceModel.Syndication.SyndicationFeedFormatter" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Syndication.SyndicationFeedFormatter" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParseAttribute">
@@ -555,7 +585,6 @@
         <param name="value">To be added.</param>
         <param name="category">To be added.</param>
         <param name="version">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To control how attribute extensions are parsed, derive your own class from <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> and override the <see cref="M:System.ServiceModel.Syndication.SyndicationCategory.TryParseAttribute(System.String,System.String,System.String,System.String)" /> method.</para>
@@ -564,6 +593,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an attribute extension using the specified <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute was parsed successfully; otherwise false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParseAttribute">
@@ -589,7 +622,6 @@
         <param name="value">To be added.</param>
         <param name="feed">To be added.</param>
         <param name="version">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To control how attribute extensions are parsed, derive your own class from <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> and override the <see cref="M:System.ServiceModel.Syndication.SyndicationFeed.TryParseAttribute(System.String,System.String,System.String,System.String)" /> method.</para>
@@ -598,6 +630,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an attribute extension using the specified <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute was parsed successfully; otherwise false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParseAttribute">
@@ -623,7 +659,6 @@
         <param name="value">To be added.</param>
         <param name="item">To be added.</param>
         <param name="version">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To control how attribute extensions are parsed, derive your own class from <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> and override the <see cref="M:System.ServiceModel.Syndication.SyndicationItem.TryParseAttribute(System.String,System.String,System.String,System.String)" /> method.</para>
@@ -632,6 +667,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an attribute extension using the specified <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute was parsed successfully; otherwise false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParseAttribute">
@@ -657,7 +696,6 @@
         <param name="value">To be added.</param>
         <param name="link">To be added.</param>
         <param name="version">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To control how attribute extensions are parsed, derive your own class from <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> and override the <see cref="M:System.ServiceModel.Syndication.SyndicationLink.TryParseAttribute(System.String,System.String,System.String,System.String)" /> method.</para>
@@ -666,6 +704,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an attribute extension using the specified <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute was parsed successfully; otherwise false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParseAttribute">
@@ -691,7 +733,6 @@
         <param name="value">To be added.</param>
         <param name="person">To be added.</param>
         <param name="version">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To control how attribute extensions are parsed, derive your own class from <see cref="T:System.ServiceModel.Syndication.SyndicationPerson" /> and override the <see cref="M:System.ServiceModel.Syndication.SyndicationPerson.TryParseAttribute(System.String,System.String,System.String,System.String)" /> method.</para>
@@ -700,6 +741,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an attribute extension using the specified <see cref="T:System.ServiceModel.Syndication.SyndicationPerson" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute was parsed successfully; otherwise false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParseContent">
@@ -749,7 +794,6 @@
         <param name="reader">To be added.</param>
         <param name="category">To be added.</param>
         <param name="version">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To control how element extensions are parsed, derive your own class from <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> and override the <see cref="M:System.ServiceModel.Syndication.SyndicationCategory.TryParseElement(System.Xml.XmlReader,System.String)" /> method.</para>
@@ -758,6 +802,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an element extension using the specified <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the element was parsed successfully; otherwise false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParseElement">
@@ -779,7 +827,6 @@
         <param name="reader">To be added.</param>
         <param name="feed">To be added.</param>
         <param name="version">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To control how element extensions are parsed, derive your own class from <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> and override the <see cref="M:System.ServiceModel.Syndication.SyndicationFeed.TryParseElement(System.Xml.XmlReader,System.String)" /> method.</para>
@@ -788,6 +835,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an element extension using the specified <see cref="T:System.ServiceModel.Syndication.SyndicationFeed" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the element was parsed successfully; otherwise false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParseElement">
@@ -809,7 +860,6 @@
         <param name="reader">To be added.</param>
         <param name="item">To be added.</param>
         <param name="version">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To control how element extensions are parsed, derive your own class from <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> and override the <see cref="M:System.ServiceModel.Syndication.SyndicationItem.TryParseElement(System.Xml.XmlReader,System.String)" /> method.</para>
@@ -818,6 +868,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an element extension using the specified <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the element was parsed successfully; otherwise false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParseElement">
@@ -839,7 +893,6 @@
         <param name="reader">To be added.</param>
         <param name="link">To be added.</param>
         <param name="version">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To control how element extensions are parsed, derive your own class from <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> and override the <see cref="M:System.ServiceModel.Syndication.SyndicationLink.TryParseElement(System.Xml.XmlReader,System.String)" /> method.</para>
@@ -848,6 +901,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an element extension using the specified <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the element was parsed successfully; otherwise false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParseElement">
@@ -869,7 +926,6 @@
         <param name="reader">To be added.</param>
         <param name="person">To be added.</param>
         <param name="version">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To control how element extensions are parsed, derive your own class from <see cref="T:System.ServiceModel.Syndication.SyndicationPerson" /> and override the <see cref="M:System.ServiceModel.Syndication.SyndicationPerson.TryParseElement(System.Xml.XmlReader,System.String)" /> method.</para>
@@ -878,6 +934,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an element extension using the specified <see cref="T:System.ServiceModel.Syndication.SyndicationPerson" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the element was parsed successfully; otherwise false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Version">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationItem.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationItem.xml
index e6fa64d045f..3931b8644d1 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationItem.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationItem.xml
@@ -576,12 +576,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Content">
@@ -684,7 +687,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This does not add the new <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> object to the <see cref="P:System.ServiceModel.Syndication.SyndicationItem.Categories" /> collection.</para>
@@ -693,6 +695,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateLink">
@@ -707,7 +713,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The new <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> instance is not automatically added to the <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance used to call the <see cref="M:System.ServiceModel.Syndication.SyndicationItem.CreateLink" /> method.</para>
@@ -716,6 +721,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreatePerson">
@@ -730,7 +739,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This does not add the new <see cref="T:System.ServiceModel.Syndication.SyndicationPerson" /> object to the <see cref="P:System.ServiceModel.Syndication.SyndicationItem.Authors" /> or <see cref="P:System.ServiceModel.Syndication.SyndicationItem.Contributors" /> collection.</para>
@@ -739,6 +747,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new person.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationPerson" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ElementExtensions">
@@ -777,12 +789,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <see cref="T:System.ServiceModel.Syndication.Atom10FeedFormatter" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Syndication.Atom10FeedFormatter" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetRss20Formatter">
@@ -797,12 +812,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <see cref="T:System.ServiceModel.Syndication.Rss20FeedFormatter" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Syndication.Rss20FeedFormatter" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetRss20Formatter">
@@ -819,7 +837,6 @@
         <Parameter Name="serializeExtensionsAsAtom" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>RSS 2.0 allows elements and attributes that are not in its specification only if they are within a namespace. When the <paramref name="serializedExtensionsAsAtom" /> parameter is true, the formatter automatically adds the "a10" namespace to all extensions; otherwise, the extensions are not serialized.</para>
@@ -828,6 +845,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <see cref="T:System.ServiceModel.Syndication.Rss20FeedFormatter" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Syndication.Rss20FeedFormatter" /> instance.</para>
+        </returns>
         <param name="serializeExtensionsAsAtom">
           <attribution license="cc4" from="Microsoft" modified="false" />A value that specifies whether to serialize element and attribute extensions with an Atom 1.0 namespace.</param>
       </Docs>
@@ -912,12 +933,15 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads a <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance from the specified <see cref="T:System.Xml.XmlReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read from. </param>
       </Docs>
@@ -944,7 +968,6 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method when you are loading a syndication item into a class derived from <see cref="T:System.ServiceModel.Syndication.SyndicationItem" />.</para>
@@ -953,6 +976,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads a <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> derived object from the specified <see cref="T:System.Xml.XmlReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> derived object that contains the syndication item.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read from.</param>
         <typeparam name="TSyndicationItem">
@@ -1110,7 +1137,6 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attribute extensions are custom attributes that are not defined by the Atom 1.0 or RSS 2.0 specifications. They are serialized as an attribute of the &lt;entry&gt; (for Atom 1.0) or &lt;item&gt; (for RSS 1.0) element, depending upon the syndication version being used. This method is an extension point that allows you to handle the deserialization of a custom attribute extension. To do this, you must derive a class from <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> and override this method. This method is called for all unrecognized attribute extensions.</para>
@@ -1119,6 +1145,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an attribute extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that specifies whether the attribute extension was parsed successfully.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the element.</param>
         <param name="ns">
@@ -1170,7 +1200,6 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Element extensions are valid XML elements that are not specified in either the Atom 1.0 or RSS 2.0 specifications. You can add any valid XML element as an extension, provided its namespace is different from the enclosing namespace. This method is an extension point that allows you to handle the deserialization of a custom element extension. To do this, you must derive a class from <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> and override this method. This method is called for all unrecognized element extensions.</para>
@@ -1179,6 +1208,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an element extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that specifies whether the element extension was parsed successfully.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read from.</param>
         <param name="version">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationItemFormatter.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationItemFormatter.xml
index 221a71f0f68..576ea1cb2b0 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationItemFormatter.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationItemFormatter.xml
@@ -79,12 +79,15 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies whether the specified <see cref="T:System.Xml.XmlReader" /> contains a valid syndication item.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if the XML reader contains a valid syndication item, otherwise false.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />An XML reader to check.</param>
       </Docs>
@@ -103,7 +106,6 @@
         <Parameter Name="item" Type="System.ServiceModel.Syndication.SyndicationItem" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The newly created <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> instance is not automatically added to the <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance used to create it.</para>
@@ -112,6 +114,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> class using the specified <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> instance.</para>
+        </returns>
         <param name="item">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> used to create the <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" />.</param>
       </Docs>
@@ -128,7 +134,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The newly created <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance is not automatically added to the <see cref="T:System.ServiceModel.Syndication.SyndicationItemFormatter" /> instance used to create it.</para>
@@ -137,6 +142,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> class. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateLink">
@@ -153,7 +162,6 @@
         <Parameter Name="item" Type="System.ServiceModel.Syndication.SyndicationItem" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The newly created <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> instance is not automatically added to the <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance used to create it.</para>
@@ -162,6 +170,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> class.  </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> instance.</para>
+        </returns>
         <param name="item">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> to use to create the new <see cref="T:System.ServiceModel.Syndication.SyndicationLink" />.</param>
       </Docs>
@@ -180,7 +192,6 @@
         <Parameter Name="item" Type="System.ServiceModel.Syndication.SyndicationItem" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The newly created <see cref="T:System.ServiceModel.Syndication.SyndicationPerson" /> instance is not automatically added to the <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance used to create it.</para>
@@ -189,6 +200,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.SyndicationPerson" /> instance with the specified <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationPerson" /> instance.</para>
+        </returns>
         <param name="item">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance used to create the new <see cref="T:System.ServiceModel.Syndication.SyndicationPerson" /> instance.</param>
       </Docs>
@@ -407,12 +422,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a string representation of the <see cref="T:System.ServiceModel.Syndication.SyndicationItemFormatter" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Syndication.SyndicationItemFormatter" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParseAttribute">
@@ -433,7 +451,6 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To control how attribute extensions are parsed, derive your own class from <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> and override the <see cref="M:System.ServiceModel.Syndication.SyndicationCategory.TryParseAttribute(System.String,System.String,System.String,System.String)" /> method.</para>
@@ -442,6 +459,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an attribute extension using the specified <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that indicates whether the attribute was parsed successfully.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the element.</param>
         <param name="ns">
@@ -472,7 +493,6 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To control how attribute extensions are parsed, derive your own class from <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> and override the <see cref="M:System.ServiceModel.Syndication.SyndicationItem.TryParseAttribute(System.String,System.String,System.String,System.String)" /> method.</para>
@@ -481,6 +501,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an attribute extension using the specified <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that indicates whether the attribute was parsed successfully.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the element.</param>
         <param name="ns">
@@ -511,7 +535,6 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To control how attribute extensions are parsed, derive your own class from <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> and override the <see cref="M:System.ServiceModel.Syndication.SyndicationLink.TryParseAttribute(System.String,System.String,System.String,System.String)" /> method.</para>
@@ -520,6 +543,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an attribute extension using the specified <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that indicates whether the attribute was parsed successfully.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the element.</param>
         <param name="ns">
@@ -550,7 +577,6 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To control how attribute extensions are parsed, derive your own class from <see cref="T:System.ServiceModel.Syndication.SyndicationPerson" /> and override the <see cref="M:System.ServiceModel.Syndication.SyndicationPerson.TryParseAttribute(System.String,System.String,System.String,System.String)" /> method.</para>
@@ -559,6 +585,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an attribute extension using the specified <see cref="T:System.ServiceModel.Syndication.SyndicationPerson" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that indicates whether the attribute was parsed successfully.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the element.</param>
         <param name="ns">
@@ -615,7 +645,6 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To control how element extensions are parsed, derive your own class from <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> and override the <see cref="M:System.ServiceModel.Syndication.SyndicationCategory.TryParseElement(System.Xml.XmlReader,System.String)" /> method.</para>
@@ -624,6 +653,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an element extension using the specified <see cref="T:System.ServiceModel.Syndication.SyndicationCategory" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that indicates whether the element was parsed successfully.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read from.</param>
         <param name="category">
@@ -648,7 +681,6 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To control how element extensions are parsed, derive your own class from <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> and override the <see cref="M:System.ServiceModel.Syndication.SyndicationItem.TryParseElement(System.Xml.XmlReader,System.String)" /> method.</para>
@@ -657,6 +689,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an element extension using the specified <see cref="T:System.ServiceModel.Syndication.SyndicationItem" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that indicates whether the element was parsed successfully.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read from.</param>
         <param name="item">
@@ -681,7 +717,6 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To control how element extensions are parsed, derive your own class from <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> and override the <see cref="M:System.ServiceModel.Syndication.SyndicationLink.TryParseElement(System.Xml.XmlReader,System.String)" /> method.</para>
@@ -690,6 +725,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an element extension using the specified <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that indicates whether the element was parsed successfully.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read from.</param>
         <param name="link">
@@ -714,7 +753,6 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To control how element extensions are parsed, derive your own class from <see cref="T:System.ServiceModel.Syndication.SyndicationPerson" /> and override the <see cref="M:System.ServiceModel.Syndication.SyndicationPerson.TryParseElement(System.Xml.XmlReader,System.String)" /> method.</para>
@@ -723,6 +761,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an element extension using the specified <see cref="T:System.ServiceModel.Syndication.SyndicationPerson" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that indicates whether the element was parsed successfully.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read from.</param>
         <param name="person">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationLink.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationLink.xml
index 60bead42d7d..28569aea5fc 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationLink.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationLink.xml
@@ -181,12 +181,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the current <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateAlternateLink">
@@ -204,12 +207,15 @@
       </Parameters>
       <Docs>
         <param name="uri">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> object with the specified <see cref="T:System.Uri" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateAlternateLink">
@@ -229,12 +235,15 @@
       <Docs>
         <param name="uri">To be added.</param>
         <param name="mediaType">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> object with the specified <see cref="T:System.Uri" /> and media type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateMediaEnclosureLink">
@@ -256,7 +265,6 @@
         <param name="uri">To be added.</param>
         <param name="mediaType">To be added.</param>
         <param name="length">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates a new <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> object and sets <see cref="P:System.ServiceModel.Syndication.SyndicationLink.RelationshipType" /> to enclosure.</para>
@@ -265,6 +273,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a media enclosure link with the specified URI, media type, and length.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateSelfLink">
@@ -282,12 +294,15 @@
       </Parameters>
       <Docs>
         <param name="uri">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> with the specified URI and relationship type set to self.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateSelfLink">
@@ -307,12 +322,15 @@
       <Docs>
         <param name="uri">To be added.</param>
         <param name="mediaType">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> with the specified URI, media type, and relationship type set to self.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ElementExtensions">
@@ -349,12 +367,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the absolute URI for the <see cref="T:System.ServiceModel.Syndication.SyndicationLink" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Uri" /> instance that contains the absolute URI of the <see cref="T:System.ServiceModel.Syndication.SyndicationLink" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Length">
@@ -486,7 +507,6 @@
         <param name="ns">To be added.</param>
         <param name="value">To be added.</param>
         <param name="version">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attribute extensions are custom attributes that are not defined by the Atom 1.0 or RSS 2.0 specifications. They are serialized as an attribute of the &lt;link&gt; element. This method is an extension point that allows you to handle the deserialization of a custom attribute extension. To do this, you must derive a class from <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> and override this method. This method is called for all unrecognized attribute extensions.</para>
@@ -495,6 +515,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an attribute extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that specifies whether the attribute extension was parsed successfully.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParseElement">
@@ -514,7 +538,6 @@
       <Docs>
         <param name="reader">To be added.</param>
         <param name="version">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Element extensions are valid XML elements that are not specified in either the Atom 1.0 or RSS 2.0 specifications. You can add any valid XML element as an extension, provided its namespace is different from the enclosing namespace. This method is an extension point that allows you to handle the deserialization of a custom element extension. To do this, you must derive a class from <see cref="T:System.ServiceModel.Syndication.SyndicationLink" /> and override this method. This method is called for all unrecognized element extensions.</para>
@@ -523,6 +546,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an element extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that specifies whether the element extension was parsed successfully.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Uri">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationPerson.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationPerson.xml
index 5208795b846..62866915ed9 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationPerson.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/SyndicationPerson.xml
@@ -145,12 +145,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the existing <see cref="T:System.ServiceModel.Syndication.SyndicationPerson" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationPerson" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ElementExtensions">
@@ -240,7 +243,6 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attribute extensions are custom attributes that are not defined by the Atom 1.0 or RSS 2.0 specifications. They are serialized as an attribute of the &lt;author&gt; or &lt;contributor&gt; element for Atom 1.0 or &lt;managingEditor&gt;, &lt;a10:author&gt;, or &lt;a10:contributor&gt; element for RSS 2.0. This method is an extension point that allows you to handle the deserialization of a custom attribute extension. To do this, you must derive a class from <see cref="T:System.ServiceModel.Syndication.SyndicationPerson" /> and override this method. This method is called for all unrecognized attribute extensions.</para>
@@ -249,6 +251,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an attribute extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that specifies whether the attribute extension was parsed successfully.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the element.</param>
         <param name="ns">
@@ -274,7 +280,6 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Element extensions are valid XML elements that are not specified in either the Atom 1.0 or RSS 2.0 specifications. You can add any valid XML element as an extension, provided its namespace is different from the enclosing namespace. This method is an extension point that allows you to handle the deserialization of a custom element extension. To do this, you must derive a class from <see cref="T:System.ServiceModel.Syndication.SyndicationPerson" /> and override this method. This method is called for all unrecognized element extensions.</para>
@@ -283,6 +288,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an element extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that specifies whether the element extension was parsed successfully.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read from.</param>
         <param name="version">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/TextSyndicationContent.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/TextSyndicationContent.xml
index 370e70bad29..6d911491a69 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/TextSyndicationContent.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/TextSyndicationContent.xml
@@ -116,12 +116,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the existing <see cref="T:System.ServiceModel.Syndication.SyndicationContent" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationContent" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Text">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/UrlSyndicationContent.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/UrlSyndicationContent.xml
index 45213d0a35d..ff2cc0fa17b 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/UrlSyndicationContent.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/UrlSyndicationContent.xml
@@ -76,12 +76,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the existing <see cref="T:System.ServiceModel.Syndication.UrlSyndicationContent" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationContent" /> instance that contains the new copy of the <see cref="T:System.ServiceModel.Syndication.UrlSyndicationContent" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Type">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Workspace.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Workspace.xml
index b525caab59e..72fdde0341f 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Workspace.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/Workspace.xml
@@ -155,12 +155,17 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ServiceModel.Syndication.ResourceCollectionInfo" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns <see cref="T:System.ServiceModel.Syndication.ResourceCollectionInfo" />.
+</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ElementExtensions">
@@ -218,12 +223,17 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an attribute extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns <see cref="T:System.Boolean" />.
+</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the element.</param>
         <param name="ns">
@@ -249,12 +259,17 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to parse an element extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+Returns <see cref="T:System.Boolean" />.
+</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read from.</param>
         <param name="version">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/XmlSyndicationContent.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/XmlSyndicationContent.xml
index 9344f5904b3..93d1a18ae51 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/XmlSyndicationContent.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel.Syndication/XmlSyndicationContent.xml
@@ -151,12 +151,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the existing <see cref="T:System.ServiceModel.Syndication.XmlSyndicationContent" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ServiceModel.Syndication.SyndicationContent" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Extension">
@@ -194,12 +197,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a reader from the content of the <see cref="T:System.ServiceModel.Syndication.XmlSyndicationContent" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlDictionaryReader" /> from the content of the <see cref="T:System.ServiceModel.Syndication.XmlSyndicationContent" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadContent&lt;TContent&gt;">
@@ -217,7 +223,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>On the receive/deserialization side, if the XML syndication content element is an empty XML element, then default(<paramref name="TContent" />) is returned. If not, a new instance of <see cref="T:System.Runtime.Serialization.DataContractSerializer" /> is created and is used to deserialize the inner XML of the XML syndication content element into an instance of <paramref name="TContent" />.</para>
@@ -226,6 +231,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the content of the specified type into the <see cref="T:System.ServiceModel.Syndication.XmlSyndicationContent" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object of the specified type.</para>
+        </returns>
         <typeparam name="TContent">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of content to read.</typeparam>
       </Docs>
@@ -248,7 +257,6 @@
       </Parameters>
       <Docs>
         <param name="serializer">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>On the receive/deserialization side, if the XML syndication content element is an empty XML element, then default(<paramref name="TContent" />) is returned. If not, the instance of <see cref="T:System.Runtime.Serialization.XmlObjectSerializer" /> passed in is used to deserialize the inner XML of XML syndication content element into an instance of <paramref name="TContent" />.</para>
@@ -257,6 +265,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the content of the specified type into the <see cref="T:System.ServiceModel.Syndication.XmlSyndicationContent" /> using the specified serializer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object of the specified type.</para>
+        </returns>
         <typeparam name="TContent">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of content to read.</typeparam>
       </Docs>
@@ -278,7 +290,6 @@
         <Parameter Name="serializer" Type="System.Xml.Serialization.XmlSerializer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>On the receive/deserialization side, if the XML syndication content element is an empty XML element, then default(<paramref name="TContent" />) is returned. If not, the instance of <see cref="T:System.Xml.Serialization.XmlSerializer" /> passed in is used to deserialize the inner XML of XML syndication content element into an instance of <paramref name="TContent" />.</para>
@@ -287,6 +298,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the content of the specified type into the <see cref="T:System.ServiceModel.Syndication.XmlSyndicationContent" /> using the specified serializer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object of the specified type.</para>
+        </returns>
         <param name="serializer">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Serialization.XmlSerializer" /> to use.</param>
         <typeparam name="TContent">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/BasicHttpBinding.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/BasicHttpBinding.xml
index 1b3475af49e..d0e771047d9 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/BasicHttpBinding.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/BasicHttpBinding.xml
@@ -96,7 +96,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The order of the binding elements is important. It reflects the order in which the protocol and transport channels are constructed and stacked. This collection of binding elements is a new collection and can be modified and then used to create a <see cref="T:System.ServiceModel.Channels.CustomBinding" />.</para>
@@ -105,6 +104,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an ordered collection of binding elements contained in the current binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.BindingElementCollection" /> that contains the ordered stack of binding elements described by the <see cref="T:System.ServiceModel.BasicHttpBinding" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MessageEncoding">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/BasicHttpsBinding.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/BasicHttpsBinding.xml
index 8ce30783ed8..6b993c6c97d 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/BasicHttpsBinding.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/BasicHttpsBinding.xml
@@ -86,12 +86,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an ordered collection of binding elements contained in the current binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An ordered collection of binding elements contained in the current binding.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MessageEncoding">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ChannelFactory.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ChannelFactory.xml
index 480c7048d3e..be675675e2c 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ChannelFactory.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ChannelFactory.xml
@@ -101,12 +101,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented in a derived class, creates a description of the service endpoint associated with the channel factory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> associated with the channel factory.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateFactory">
@@ -121,12 +124,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds the channel factory for the current endpoint of the factory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.Channels.IChannelFactory" /> for the endpoint of the current factory.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Credentials">
@@ -260,7 +266,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this to retrieve capabilities, requirements and parameters from the channel stack. If a channel factory supports returning the requested object, it returns it. If not, it delegates the call down to the next level in the stack. If it gets to the bottom of the stack and no channel factory supported the requested object, then the method returns null.</para>
@@ -271,6 +276,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the typed object requested, if present, from the appropriate layer in the channel stack, or null if not present.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The typed object <paramref name="T" /> requested if it is present or null if it is not.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The typed object for which the method is querying.</typeparam>
       </Docs>
@@ -394,7 +403,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method receives notification, through a callback, of the identity of the event handler for the operation. The operation is not complete until either the asynchronous close on the inner channel factory returns or the time-out occurs.</para>
@@ -403,6 +411,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous close operation on the inner channel factory of the current channel factory that has a state object associated with it. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous operation.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies how long the operation has to complete before timing out.</param>
         <param name="callback">
@@ -427,7 +439,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method receives notification, through a callback, of the identity of the event handler for the operation. The operation is not complete until either the asynchronous open on the inner channel factory returns or the time-out occurs.</para>
@@ -436,6 +447,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous open operation on the inner channel factory of the current channel factory that has a state object associated with it. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous operation.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies how long the operation has to complete before timing out.</param>
         <param name="callback">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ChannelFactory`1.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ChannelFactory`1.xml
index b88afe139ac..e3148d6ae50 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ChannelFactory`1.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ChannelFactory`1.xml
@@ -225,7 +225,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel of type <paramref name="TChannel" />, the generic parameter for the class.</para>
@@ -234,6 +233,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel of a specified type to a specified endpoint address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <paramref name="TChannel" /> of type <see cref="T:System.ServiceModel.Channels.IChannel" /> created by the factory.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateChannel">
@@ -250,12 +253,15 @@
         <Parameter Name="address" Type="System.ServiceModel.EndpointAddress" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel that is used to send messages to a service at a specific endpoint address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <paramref name="TChannel" /> of type <see cref="T:System.ServiceModel.Channels.IChannel" /> created by the factory.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.EndpointAddress" /> that provides the location of the service.</param>
       </Docs>
@@ -274,12 +280,15 @@
         <Parameter Name="endpointConfigurationName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel that is used to send messages to a service whose endpoint is configured in a specified way.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <paramref name="TChannel" /> of type <see cref="T:System.ServiceModel.Channels.IChannel" /> created by the factory.</para>
+        </returns>
         <param name="endpointConfigurationName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the endpoint configuration used for the service.</param>
       </Docs>
@@ -300,12 +309,15 @@
       </Parameters>
       <Docs>
         <param name="address">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel of a specified type that is used to send messages to a service endpoint that is configured with a specified binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <paramref name="TChannel" /> of type <see cref="T:System.ServiceModel.Channels.IChannel" /> created by the factory.</para>
+        </returns>
         <param name="binding">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.Binding" /> used to configure the endpoint.</param>
       </Docs>
@@ -325,12 +337,15 @@
         <Parameter Name="via" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel that is used to send messages to a service at a specific endpoint address through a specified transport address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <paramref name="TChannel" /> of type <see cref="T:System.ServiceModel.Channels.IChannel" /> created by the factory.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.EndpointAddress" /> that provides the location of the service.</param>
         <param name="via">
@@ -354,12 +369,15 @@
       </Parameters>
       <Docs>
         <param name="address">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel of a specified type that is used to send messages to a service endpoint at a specified transport address that is configured with a specified binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <paramref name="TChannel" /> of type <see cref="T:System.ServiceModel.Channels.IChannel" /> created by the factory.</para>
+        </returns>
         <param name="binding">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.Binding" /> used to configure the endpoint.</param>
         <param name="via">
@@ -378,12 +396,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a description of the service endpoint.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> of the service.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ClientCredentialsSecurityTokenManager.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ClientCredentialsSecurityTokenManager.xml
index 93b26c9adf2..d4da6cf0183 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ClientCredentialsSecurityTokenManager.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ClientCredentialsSecurityTokenManager.xml
@@ -99,7 +99,6 @@
       </Parameters>
       <Docs>
         <param name="requirement">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.IdentityModel.Selectors.SecurityTokenProvider" /> class is responsible for obtaining tokens for a given <see cref="T:System.ServiceModel.Security.Tokens.ServiceModelSecurityTokenRequirement" />. Optionally token providers support renewing and canceling tokens as well. </para>
@@ -108,6 +107,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a security token provider.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IdentityModel.Selectors.SecurityTokenProvider" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateSecurityTokenSerializer">
@@ -124,7 +127,6 @@
         <Parameter Name="version" Type="System.IdentityModel.Selectors.SecurityTokenVersion" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.IdentityModel.Selectors.SecurityTokenSerializer" /> is used to write and read security tokens, security key identifiers, and security key identifier clauses. When deserializing the token from XML, the returned token must be able to perform cryptographic operations. The token serializer therefore must ensure the deserialized token can perform cryptographic operations (Kerberos ticket processing, X.509 decoding, SAML decoding and other operations) but should defer application trust decisions to the security token authenticator.</para>
@@ -133,6 +135,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a security token serializer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IdentityModel.Selectors.SecurityTokenSerializer" /> object.</para>
+        </returns>
         <param name="version">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IdentityModel.Selectors.SecurityTokenVersion" /> of the security token.</param>
       </Docs>
@@ -151,7 +157,6 @@
         <Parameter Name="version" Type="System.ServiceModel.Security.SecurityVersion" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.IdentityModel.Selectors.SecurityTokenSerializer" /> is used to write and read security tokens, security key identifiers and security key identifier clauses. When deserializing the token from XML, the returned token must be able to perform cryptographic operations. The token serializer therefore must ensure the deserialized token can perform cryptographic operations (Kerberos ticket processing, X.509 decoding, SAML decoding and other operations) but should defer application trust decisions to the security token authenticator.</para>
@@ -160,6 +165,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a security token serializer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IdentityModel.Selectors.SecurityTokenSerializer" /> object.</para>
+        </returns>
         <param name="version">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Security.SecurityVersion" /> of the security token.</param>
       </Docs>
@@ -178,12 +187,15 @@
         <Parameter Name="requirement" Type="System.IdentityModel.Selectors.SecurityTokenRequirement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the specified token requirement is an issued security token requirement.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified token requirement is an issued security token requirement; otherwise, false. The default is false.</para>
+        </returns>
         <param name="requirement">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IdentityModel.Selectors.SecurityTokenRequirement" />.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/DuplexChannelFactory`1.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/DuplexChannelFactory`1.xml
index cfe60cee897..3979dfb4dbd 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/DuplexChannelFactory`1.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/DuplexChannelFactory`1.xml
@@ -570,12 +570,15 @@
         <Parameter Name="callbackInstance" Type="System.ServiceModel.InstanceContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplex channel between a service and a callback instance on the client.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A duplex channel of type <paramref name="TChannel" />, the generic parameter for the factory, between the client and service.</para>
+        </returns>
         <param name="callbackInstance">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.InstanceContext" /> that the client uses to listen for messages from the connected service.</param>
       </Docs>
@@ -595,12 +598,15 @@
         <Parameter Name="endpointConfigurationName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplex channel between a service and a callback instance on the client.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A channel of type <paramref name="TChannel" />, the generic parameter for the factory, between the client and service.</para>
+        </returns>
         <param name="callbackObject">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> that the client uses to listen for messages from the connected service.</param>
         <param name="endpointConfigurationName">
@@ -622,12 +628,15 @@
         <Parameter Name="via" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplex channel between a service and a callback instance on the client.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A duplex channel of type <paramref name="TChannel" />, the generic parameter for the factory, between the client and service.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.EndpointAddress" /> that provides the location of the service.</param>
         <param name="via">
@@ -649,12 +658,15 @@
         <Parameter Name="address" Type="System.ServiceModel.EndpointAddress" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplex channel between a service and a callback instance on the client.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A duplex channel of type <paramref name="TChannel" />, the generic parameter for the factory, between the client and service.</para>
+        </returns>
         <param name="callbackInstance">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.InstanceContext" /> that the client uses to listen for messages from the connected service.</param>
         <param name="address">
@@ -676,12 +688,15 @@
         <Parameter Name="endpointConfigurationName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplex channel between a service and a callback instance on the client.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A channel of type <paramref name="TChannel" />, the generic parameter for the factory, between the client and service.</para>
+        </returns>
         <param name="callbackInstance">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.InstanceContext" /> that the client uses to listen for messages from the connected service.</param>
         <param name="endpointConfigurationName">
@@ -704,12 +719,15 @@
         <Parameter Name="endpointAddress" Type="System.ServiceModel.EndpointAddress" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplex channel between a service and a callback instance on the client.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A channel of type <paramref name="TChannel" />, the generic parameter for the factory, between the client and service.</para>
+        </returns>
         <param name="callbackObject">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> that the client uses to listen for messages from the connected service.</param>
         <param name="binding">
@@ -734,12 +752,15 @@
         <Parameter Name="endpointAddress" Type="System.ServiceModel.EndpointAddress" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplex channel between a service and a callback instance on the client.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A channel of type <paramref name="TChannel" />, the generic parameter for the factory, between the client and service.</para>
+        </returns>
         <param name="callbackInstance">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.InstanceContext" /> that the client uses to listen for messages from the connected service.</param>
         <param name="binding">
@@ -764,12 +785,15 @@
         <Parameter Name="via" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplex channel between a service and a callback instance on the client.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A channel of type <paramref name="TChannel" />, the generic parameter for the factory, between the client and service.</para>
+        </returns>
         <param name="callbackInstance">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.InstanceContext" /> that the client uses to listen for messages from the connected service.</param>
         <param name="address">
@@ -795,12 +819,15 @@
         <Parameter Name="via" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplex channel between a service and a callback instance on the client.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A channel of type <paramref name="TChannel" />, the generic parameter for the factory, between the client and service.</para>
+        </returns>
         <param name="callbackObject">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> that the client uses to listen for messages from the connected service.</param>
         <param name="binding">
@@ -828,12 +855,15 @@
         <Parameter Name="via" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplex channel between a service and a callback instance on the client.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A channel of type <paramref name="TChannel" />, the generic parameter for the factory, between the client and service.</para>
+        </returns>
         <param name="callbackInstance">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.InstanceContext" /> that the client uses to listen for messages from the connected service.</param>
         <param name="binding">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/DuplexClientBase`1.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/DuplexClientBase`1.xml
index 405b31e24f7..eb08bf70386 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/DuplexClientBase`1.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/DuplexClientBase`1.xml
@@ -349,12 +349,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a channel to the service associated with the callback object passed to the constructor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A channel to the service of the type of the service contract interface.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InnerDuplexChannel">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/EndpointAddress.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/EndpointAddress.xml
index af42059ce19..98974a06c26 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/EndpointAddress.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/EndpointAddress.xml
@@ -232,12 +232,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a specified object is equivalent to the current endpoint address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified object is equivalent to the current address; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to be compared to the current endpoint address.</param>
       </Docs>
@@ -254,7 +257,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -264,6 +266,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides a unique hash code for the current endpoint address. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A unique hash code for the current endpoint address.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetReaderAtExtensions">
@@ -278,7 +284,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The reader provides access to the information that is not contained in the model of the endpoint reference defined by WS-Addressing.</para>
@@ -287,6 +292,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the XML dictionary reader that provides access to the extensions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.XmlDictionaryReader" /> that provides access to the extensions.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetReaderAtMetadata">
@@ -301,12 +310,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the XML dictionary reader that provides access to the metadata for an endpoint.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.XmlDictionaryReader" /> that provides access to the metadata for an endpoint.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Headers">
@@ -433,12 +445,15 @@
         <Parameter Name="address2" Type="System.ServiceModel.EndpointAddress" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether specified endpoint addresses are not equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the endpoint addresses are equivalent; otherwise, false.</para>
+        </returns>
         <param name="address1">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.ServiceModel.EndpointAddress" /> objects being compared.</param>
         <param name="address2">
@@ -460,12 +475,15 @@
         <Parameter Name="address2" Type="System.ServiceModel.EndpointAddress" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether specified endpoint addresses are not equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the endpoint addresses are not equivalent; otherwise, false.</para>
+        </returns>
         <param name="address1">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.ServiceModel.EndpointAddress" /> objects being compared.</param>
         <param name="address2">
@@ -486,12 +504,15 @@
         <Parameter Name="reader" Type="System.Xml.XmlDictionaryReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads an endpoint address from a specified XML dictionary reader.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.EndpointAddress" /> read from the XML dictionary reader.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlDictionaryReader" /> from which the endpoint address is obtained.</param>
       </Docs>
@@ -511,12 +532,15 @@
         <Parameter Name="reader" Type="System.Xml.XmlDictionaryReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads an endpoint address for a specified address version from a specified XML dictionary reader.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.EndpointAddress" /> read from the XML dictionary reader.</para>
+        </returns>
         <param name="addressingVersion">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.AddressingVersion" /> of the current endpoint address.</param>
         <param name="reader">
@@ -538,12 +562,15 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads an endpoint address for a specified address version from a specified XML reader.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.EndpointAddress" /> read from the XML reader.</para>
+        </returns>
         <param name="addressingVersion">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.AddressingVersion" /> of the current endpoint address.</param>
         <param name="reader">
@@ -566,12 +593,15 @@
         <Parameter Name="ns" Type="System.Xml.XmlDictionaryString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads an endpoint address with a specified qualified name from a specified XML dictionary reader.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.EndpointAddress" /> with the qualified name read from the XML dictionary reader.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlDictionaryReader" /> from which the endpoint address is obtained.</param>
         <param name="localName">
@@ -597,12 +627,15 @@
         <Parameter Name="ns" Type="System.Xml.XmlDictionaryString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads an endpoint address for a specified address version with a specified qualified name from a specified XML dictionary reader.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.EndpointAddress" /> with the qualified name read from the XML reader.</para>
+        </returns>
         <param name="addressingVersion">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.AddressingVersion" /> of the current endpoint address.</param>
         <param name="reader">
@@ -630,12 +663,15 @@
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads an endpoint address for a specified address version with a specified qualified name from a specified XML reader.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.EndpointAddress" /> with the qualified name read from the XML reader.</para>
+        </returns>
         <param name="addressingVersion">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.Channels.AddressingVersion" /> of the current endpoint address.</param>
         <param name="reader">
@@ -658,12 +694,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a canonical string representation of the URI that is contained in the endpoint address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The URI that identifies the endpoint.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Uri">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/EndpointAddress10.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/EndpointAddress10.xml
index 3657e6a10a0..2f8952c131a 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/EndpointAddress10.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/EndpointAddress10.xml
@@ -48,7 +48,6 @@
         <Parameter Name="address" Type="System.ServiceModel.EndpointAddress" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.ServiceModel.EndpointAddress" /> is not tied to a particular version of the WS-Addressing specification or bound to a particular wire format.</para>
@@ -57,6 +56,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of the <see cref="T:System.ServiceModel.EndpointAddress10" /> class with a specified endpoint address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.EndpointAddress10" /> class that contains the specified endpoint address.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.EndpointAddress" /> used to initialize the instance of this class.</param>
       </Docs>
@@ -75,7 +78,6 @@
         <Parameter Name="xmlSchemaSet" Type="System.Xml.Schema.XmlSchemaSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is required by the serialization contract. It must be public to be seen by the <see cref="T:System.Xml.Serialization.XmlSerializer" />. It is not intended to be called by developers.</para>
@@ -84,6 +86,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an XML-qualified name that describes the XML representation of the version 1.0 endpoint address from a specified cached schema.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Xml.XmlQualifiedName" /> that describes the XML representation of the endpoint address.</para>
+        </returns>
         <param name="xmlSchemaSet">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.Schema.XmlSchema" /> that contains a cache of the XML schema definition language (XSD) schemas for the endpoint address.</param>
       </Docs>
@@ -100,12 +106,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns null.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>null</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
@@ -166,12 +175,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the endpoint address contained in this serializable type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.EndpointAddress" /> used to initialize the instance of this class. </para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/EndpointAddressAugust2004.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/EndpointAddressAugust2004.xml
index 8c707c5cb3f..d26b9de6090 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/EndpointAddressAugust2004.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/EndpointAddressAugust2004.xml
@@ -48,7 +48,6 @@
         <Parameter Name="address" Type="System.ServiceModel.EndpointAddress" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.ServiceModel.EndpointAddress" /> is not tied to a particular version of the WS-Addressing specification or bound to a particular wire format.</para>
@@ -57,6 +56,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of the <see cref="T:System.ServiceModel.EndpointAddress10" /> class with a specified endpoint address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.EndpointAddressAugust2004" /> class that contains the specified endpoint address.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ServiceModel.EndpointAddress" /> used to initialize the instance of this class. </param>
       </Docs>
@@ -75,7 +78,6 @@
         <Parameter Name="xmlSchemaSet" Type="System.Xml.Schema.XmlSchemaSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is required by the serialization contract. It must be public to be seen by the XmlSerializer. It is not intended to be called by developers.</para>
@@ -84,6 +86,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an XML-qualified name that describes the XML representation of the version 1 endpoint address from a specified cached schema.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Xml.XmlQualifiedName" /> that describes the XML representation of the endpoint address.</para>
+        </returns>
         <param name="xmlSchemaSet">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.Schema.XmlSchema" /> that contains a cache of the XML schema definition language (XSD) schemas for the endpoint address.</param>
       </Docs>
@@ -100,12 +106,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns null.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>null</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
@@ -166,12 +175,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the endpoint address contained in this serializable type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.EndpointAddress" /> that contains a version-neutral endpoint address of this <see cref="T:System.ServiceModel.EndpointAddressAugust2004" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/EndpointAddressBuilder.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/EndpointAddressBuilder.xml
index 9afaeaaa4ea..57dae58d8e6 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/EndpointAddressBuilder.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/EndpointAddressBuilder.xml
@@ -73,7 +73,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The reader provides access to the information that is not contained in the model of the endpoint reference defined by WS-Addressing.</para>
@@ -82,6 +81,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML dictionary reader that contains the extensions of the endpoint address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.XmlDictionaryReader" /> that reads the extensions of the endpoint address.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetReaderAtMetadata">
@@ -96,12 +99,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the reader that contains the metadata associated with the endpoint address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.XmlDictionaryReader" /> that reads the metadata associated the endpoint address if there is some; otherwise, null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Headers">
@@ -206,7 +212,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The values initialized from the endpoint address are the identity, the address header collection, the URI, and the extension buffer.</para>
@@ -215,6 +220,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new endpoint address initialized with the property values of the current endpoint address builder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.EndpointAddress" /> whose property are initialized with the values of the current endpoint address builder.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Uri">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/EndpointIdentity.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/EndpointIdentity.xml
index 5393852afe1..b58fe1a4374 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/EndpointIdentity.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/EndpointIdentity.xml
@@ -51,7 +51,6 @@
         <Parameter Name="dnsName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A secure indigo2 client that connects to an endpoint with this identity verifies that the claims presented by the server contain a DNS claim that represents this identity.</para>
@@ -61,6 +60,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a DNS identity with a specified DNS name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A DNS <see cref="T:System.ServiceModel.EndpointIdentity" /> associated with the specified <paramref name="dnsName" />.</para>
+        </returns>
         <param name="dnsName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name for the DNS identity.</param>
       </Docs>
@@ -79,7 +82,6 @@
         <Parameter Name="identity" Type="System.IdentityModel.Claims.Claim" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A secure indigo2 client that connects to an endpoint with this identity verifies that the claims presented by the server contain the identity claim used to construct this identity.</para>
@@ -89,6 +91,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an identity with the specified claim.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ServiceModel.EndpointIdentity" /> associated with the specified <paramref name="identity" />.</para>
+        </returns>
         <param name="identity">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IdentityModel.Claims.Claim" /> used to create the new identity.</param>
       </Docs>
@@ -107,7 +113,6 @@
         <Parameter Name="certificate" Type="System.Security.Cryptography.X509Certificates.X509Certificate2" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A secure indigo2 client that connects to an endpoint with this identity verifies that the claims presented by the server contain a claim that contains the RSA public key obtained from the certificate used to construct this identity.</para>
@@ -117,6 +122,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an RSA identity with the specified X.509 certificate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An RSA <see cref="T:System.ServiceModel.EndpointIdentity" /> associated with the specified <paramref name="certificate" />.</para>
+        </returns>
         <param name="certificate">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate2" />  that contains the certificate for the RSA identity.</param>
       </Docs>
@@ -135,7 +144,6 @@
         <Parameter Name="publicKey" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A secure indigo2 client that connects to an endpoint with this identity verifies that the claims presented by the server contain a claim that contains the RSA public key used to construct this identity.</para>
@@ -145,6 +153,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an RSA identity with the specified public key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An RSA <see cref="T:System.ServiceModel.EndpointIdentity" /> associated with the specified <paramref name="publicKey" />.</para>
+        </returns>
         <param name="publicKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The public key for the RSA identity.</param>
       </Docs>
@@ -163,7 +175,6 @@
         <Parameter Name="spnName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A secure indigo2 client that connects to an endpoint with this identity uses the SPN when performing SSPI authentication with the endpoint.</para>
@@ -174,6 +185,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a server principal name (SPN) identity with a specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An SPN <see cref="T:System.ServiceModel.EndpointIdentity" /> associated with the specified <paramref name="spnName" />.</para>
+        </returns>
         <param name="spnName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name for the SPN identity.</param>
       </Docs>
@@ -192,7 +207,6 @@
         <Parameter Name="upnName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A secure indigo2 client that connects to an endpoint with this identity uses the UPN when performing SSPI authentication with the endpoint.</para>
@@ -203,6 +217,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a user principal name (UPN) identity with a specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A UPN <see cref="T:System.ServiceModel.EndpointIdentity" /> associated with the specified <paramref name="upnName" />.</para>
+        </returns>
         <param name="upnName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name for the UPN identity.</param>
       </Docs>
@@ -221,7 +239,6 @@
         <Parameter Name="certificate" Type="System.Security.Cryptography.X509Certificates.X509Certificate2" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A secure indigo2 client that connects to an endpoint with this identity verifies that the claims presented by the server contain the claim that contains the thumbprint of the certificate used to construct this identity.</para>
@@ -231,6 +248,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an X509Certificate identity with the specified certificate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An X509Certificate <see cref="T:System.ServiceModel.EndpointIdentity" /> associated with the specified <paramref name="certificate" />.</para>
+        </returns>
         <param name="certificate">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate2" />  that contains the certificate for the identity.</param>
       </Docs>
@@ -250,7 +271,6 @@
         <Parameter Name="supportingCertificates" Type="System.Security.Cryptography.X509Certificates.X509Certificate2Collection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This static method creates an instance of <see cref="T:System.ServiceModel.X509CertificateEndpointIdentity" /> by calling its constructor, <see cref="M:System.ServiceModel.X509CertificateEndpointIdentity.#ctor(System.Security.Cryptography.X509Certificates.X509Certificate2,System.Security.Cryptography.X509Certificates.X509Certificate2Collection)" />, using <paramref name="primaryCertificate" /> and <paramref name="supportingCertificates" /> as input parameters.</para>
@@ -259,6 +279,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an X509Certificate identity with the specified primary and supporting certificates.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A secure indigo2 client that connects to an endpoint with this identity verifies that the claims presented by the server contain the claim that contains the thumbprint of the certificate used to construct this identity.</para>
+          <para>An X509Certificate <see cref="T:System.ServiceModel.EndpointIdentity" /> associated with the specified <paramref name="primaryCertificate" /> and<paramref name=" supportingCertificates." /></para>
+        </returns>
         <param name="primaryCertificate">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate2" /> that contains the primary certificate for the identity.</param>
         <param name="supportingCertificates">
@@ -280,12 +305,15 @@
       </Parameters>
       <Docs>
         <param name="other">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that determines whether a specified object is equal to the current identity object or if they have equal security properties.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified object <paramref name="obj" /> is equivalent to the current identity or contains the same security properties; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -300,12 +328,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides a hash code for the current instance of the identity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the current identity.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IdentityClaim">
@@ -391,12 +422,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the identity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> of the form "identity(string)" where string = <see cref="P:System.ServiceModel.EndpointIdentity.IdentityClaim" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/EnvelopeVersion.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/EnvelopeVersion.xml
index 16616a04a4b..51c9ad6fa8a 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/EnvelopeVersion.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/EnvelopeVersion.xml
@@ -33,7 +33,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The ultimate receiver is null if <see cref="P:System.ServiceModel.EnvelopeVersion.None" /> is specified.</para>
@@ -42,6 +41,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a string that contains the URI name for the SOAP role associated with the current message version for the ultimate destination.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An empty string if SOAP1.1 is used; a string that contains http://www.w3.org/2003/05/soap-envelope/role/ultimateReceiver if SOAP1.2 is used.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="NextDestinationActorValue">
@@ -142,7 +145,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns a human-readable string that is culture-sensitive.</para>
@@ -151,6 +153,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a string that represents the current envelope version.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the current envelope version.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ExceptionDetail.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ExceptionDetail.xml
index 1e1dca40c69..3dba2d8fa29 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ExceptionDetail.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ExceptionDetail.xml
@@ -170,12 +170,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the exception detail information for the exception passed to the constructor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The message and stack trace of the exception.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Type">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ExtensionCollection`1.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ExtensionCollection`1.xml
index 898665084f0..97eb09dd3bf 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ExtensionCollection`1.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ExtensionCollection`1.xml
@@ -107,12 +107,15 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an extension if it is in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An extension of the type sought, or null if no extensions implement the type. If more than one extension implements the type, the most recently added is returned.</para>
+        </returns>
         <typeparam name="E">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of extension sought.</typeparam>
       </Docs>
@@ -132,12 +135,15 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of extensions if found in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of extensions of the type sought. If no extensions implement this type, a non-null empty collection is returned.</para>
+        </returns>
         <typeparam name="E">
           <attribution license="cc4" from="Microsoft" modified="false" />The type for which the collection of extensions is sought.</typeparam>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/FaultCode.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/FaultCode.xml
index 762b76ffcec..b10117392d3 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/FaultCode.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/FaultCode.xml
@@ -144,12 +144,15 @@
       </Parameters>
       <Docs>
         <param name="subcode">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a receiver fault code with the specified subcode. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.FaultCode" /> object with the created SOAP fault subcode in the <see cref="P:System.ServiceModel.FaultCode.SubCode" /> property. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateReceiverFaultCode">
@@ -167,12 +170,15 @@
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a receiver fault code with the specified subcode. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.FaultCode" /> instance with the created SOAP fault subcode in the <see cref="P:System.ServiceModel.FaultCode.SubCode" /> property. </para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name for the fault subcode. </param>
         <param name="ns">
@@ -194,12 +200,15 @@
       </Parameters>
       <Docs>
         <param name="subcode">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a sender fault code with the specified subcode. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.FaultCode" /> object with the created SOAP fault subcode in the <see cref="P:System.ServiceModel.FaultCode.SubCode" /> property. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateSenderFaultCode">
@@ -217,12 +226,15 @@
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a sender fault code with the specified subcode.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.FaultCode" /> object with the created SOAP fault subcode in <see cref="P:System.ServiceModel.FaultCode.SubCode" />. </para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name for the fault subcode. </param>
         <param name="ns">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/FaultException.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/FaultException.xml
index 929cb9224ee..f024362636b 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/FaultException.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/FaultException.xml
@@ -315,7 +315,6 @@
       <Docs>
         <param name="fault">To be added.</param>
         <param name="details">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="faultDetailTypes" /> parameter contains candidate detail types. If any of the <paramref name="faultDetailTypes" /> has a schema that matches the <paramref name="messageFault" /> parameter, a <see cref="T:System.ServiceModel.FaultException`1" /> is returned where the type parameter is the matching candidate type.</para>
@@ -324,6 +323,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.ServiceModel.Channels.FaultException" /> object from the specified message fault and an array of detail types.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.FaultException" /> object that you can throw to indicate that a SOAP fault message was received.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateFault">
@@ -348,7 +351,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="faultDetailTypes" /> parameter contains candidate detail types. If any of the <paramref name="faultDetailTypes" /> has a schema that matches the <paramref name="messageFault" /> parameter, a <see cref="T:System.ServiceModel.FaultException`1" /> is returned where the type parameter is the matching candidate type.</para>
@@ -357,6 +359,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.ServiceModel.Channels.FaultException" /> object from the specified message fault, action and an array of detail types.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.FaultException" /> object that you can throw to indicate that a SOAP fault message was received.</para>
+        </returns>
         <param name="messageFault">
           <attribution license="cc4" from="Microsoft" modified="false" />The message fault that contains default SOAP fault information.</param>
         <param name="action">
@@ -377,12 +383,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.ServiceModel.Channels.MessageFault" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The in-memory representation of a SOAP fault that can be passed to <see cref="Overload:System.ServiceModel.Channels.Message.CreateMessage" /> to create a message that contains a fault. For <see cref="T:System.ServiceModel.FaultException" /> objects that result from fault messages, this <see cref="T:System.ServiceModel.Channels.MessageFault" /> object is the fault that arrives.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetObjectData">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/FaultException`1.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/FaultException`1.xml
index f54fb25161f..49f81ce39ee 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/FaultException`1.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/FaultException`1.xml
@@ -201,12 +201,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.ServiceModel.Channels.MessageFault" /> object that can be used to create a <see cref="T:System.ServiceModel.Channels.Message" /> that represents the SOAP fault.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The message fault created.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Detail">
@@ -266,12 +269,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string for the <see cref="T:System.ServiceModel.FaultException`1" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string for the SOAP fault.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/FaultReason.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/FaultReason.xml
index 02f865581df..02070d40400 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/FaultReason.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/FaultReason.xml
@@ -93,7 +93,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A translation is always returned. </para>
@@ -116,6 +115,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the fault description in the language used by the current thread. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.FaultReasonText" /> object that contains the fault description. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetMatchingTranslation">
@@ -132,7 +135,6 @@
         <Parameter Name="cultureInfo" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A translation is always returned. </para>
@@ -156,6 +158,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the fault description in the specified language. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The fault text in the specified language.</para>
+        </returns>
         <param name="cultureInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Globalization.CultureInfo" /> object that specifies the language of the fault description. </param>
       </Docs>
@@ -172,12 +178,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the fault reason as a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the reason for the fault.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Translations">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/FaultReasonText.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/FaultReasonText.xml
index bb03c451dfc..b62eaeba879 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/FaultReasonText.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/FaultReasonText.xml
@@ -101,12 +101,15 @@
         <Parameter Name="cultureInfo" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the language of the description matches provided <see cref="T:System.Globalization.CultureInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Globalization.CultureInfo" /> matches; otherwise, false.</para>
+        </returns>
         <param name="cultureInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Globalization.CultureInfo" /> object to compare with the language of the description.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/IClientChannel.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/IClientChannel.xml
index c78df7be0ae..7f72d3a914f 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/IClientChannel.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/IClientChannel.xml
@@ -68,7 +68,6 @@
       <Docs>
         <param name="callback">To be added.</param>
         <param name="state">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this method to cause any interactive channel initialization (for example, CardSpace card selection) to occur. This happens automatically if the channel is used without explicitly calling <see cref="M:System.ServiceModel.ICommunicationObject.Open" />, so for many applications this call is optional.</para>
@@ -80,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An asynchronous call to begin using a user interface to obtain credential information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> to use to call back when processing has completed.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DidInteractiveInitialization">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ICommunicationObject.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ICommunicationObject.xml
index f73657d52ac..83935fdee64 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ICommunicationObject.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ICommunicationObject.xml
@@ -135,7 +135,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method causes an <see cref="T:System.ServiceModel.ICommunicationObject" /> to gracefully transition from any state, other than the <see cref="F:System.ServiceModel.CommunicationState.Opened" /> state to the <see cref="F:System.ServiceModel.CommunicationState.Closed" /> state. The <see cref="M:System.ServiceModel.ICommunicationObject.BeginClose" /> method allows any unfinished work to be completed before returning. For example, finish sending any buffered messages). </para>
@@ -144,6 +143,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to close a communication object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous close operation. </para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.AsyncCallback" /> delegate that receives notification of the completion of the asynchronous close operation.</param>
         <param name="state">
@@ -166,7 +169,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method causes an <see cref="T:System.ServiceModel.ICommunicationObject" /> to gracefully transition from any state, other than the <see cref="F:System.ServiceModel.CommunicationState.Opened" /> state to the <see cref="F:System.ServiceModel.CommunicationState.Closed" /> state with in a specified interval of time. The <see cref="M:System.ServiceModel.ICommunicationObject.BeginClose" /> method allows any unfinished work to be completed before returning. For example, finish sending any buffered messages). </para>
@@ -175,6 +177,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to close a communication object with a specified timeout.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous close operation.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies how long the send operation has to complete before timing out.</param>
         <param name="callback">
@@ -198,7 +204,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When an <see cref="T:System.ServiceModel.ICommunicationObject" /> is instantiated, it begins in the <see cref="F:System.ServiceModel.CommunicationState.Created" /> state. In the <see cref="F:System.ServiceModel.CommunicationState.Created" /> state, the object can be configured (for example, properties can be set, or events can be registered), but it is not yet usable to send or receive messages. The <see cref="M:System.ServiceModel.ICommunicationObject.BeginOpen" /> method causes an <see cref="T:System.ServiceModel.ICommunicationObject" /> to enter into the <see cref="F:System.ServiceModel.CommunicationState.Opening" /> state where it remains until the open operation succeeds, the open operation times out or fails and the object becomes faulted, or the <see cref="T:System.ServiceModel.ICommunicationObject" /> is aborted.</para>
@@ -208,6 +213,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to open a communication object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous open operation. </para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.AsyncCallback" /> delegate that receives notification of the completion of the asynchronous open operation.</param>
         <param name="state">
@@ -230,7 +239,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When an <see cref="T:System.ServiceModel.ICommunicationObject" /> is instantiated, it begins in the <see cref="F:System.ServiceModel.CommunicationState.Created" /> state. In the <see cref="F:System.ServiceModel.CommunicationState.Created" /> state, the object can be configured (for example, properties can be set, or events can be registered), but it is not yet usable to send or receive messages. The <see cref="M:System.ServiceModel.ICommunicationObject.Open" /> method causes an <see cref="T:System.ServiceModel.ICommunicationObject" /> to enter into the <see cref="F:System.ServiceModel.CommunicationState.Opening" /> state where it remains until the open operation succeeds, the open operation times out or fails and the object becomes faulted, or the <see cref="T:System.ServiceModel.ICommunicationObject" /> is aborted.</para>
@@ -240,6 +248,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to open a communication object within a specified interval of time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous open operation. </para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies how long the send operation has to complete before timing out.</param>
         <param name="callback">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/IDuplexContextChannel.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/IDuplexContextChannel.xml
index c47b3896677..8bc7d7f31b1 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/IDuplexContextChannel.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/IDuplexContextChannel.xml
@@ -63,12 +63,15 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to close an output session on the client that has a specified time out and state object associated with it. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous close operation.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies how long the close operation has to complete before timing out.</param>
         <param name="callback">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/IExtensionCollection`1.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/IExtensionCollection`1.xml
index 774e9803f54..f2c01730966 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/IExtensionCollection`1.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/IExtensionCollection`1.xml
@@ -45,7 +45,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -55,6 +54,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds the specified extension object in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The extension object that was found.</para>
+        </returns>
         <typeparam name="E">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of extension object.</typeparam>
       </Docs>
@@ -74,12 +77,15 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds all extension object in the collection specified by <paramref name="E" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of all extension objects in the collection that implement the specified type.</para>
+        </returns>
         <typeparam name="E">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of extension object.</typeparam>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/InstanceContext.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/InstanceContext.xml
index 60876ab6f47..de2c5359ec0 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/InstanceContext.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/InstanceContext.xml
@@ -151,12 +151,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the instance of the service for the instance context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object that represents the service instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetServiceInstance">
@@ -173,7 +176,6 @@
         <Parameter Name="message" Type="System.ServiceModel.Channels.Message" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The general idea is that you only create an instance of the service when a message directed at it arrives, by calling <see cref="M:System.ServiceModel.Channels.CommunicationObject.Open" />; then if no message arrives, no <see cref="T:System.ServiceModel.InstanceContext" /> is created and no service object is created, and so resources are not deployed until actually required.</para>
@@ -182,6 +184,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the instance of the service for the instance context in response to an incoming message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object that represents the service instance.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The incoming message that triggered the creation of a service object.</param>
       </Docs>
@@ -238,12 +244,15 @@
         <Parameter Name="incrementBy" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Increases the number of messages that can be processed by the service instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new limit on the number of messages, after <paramref name="incrementBy" /> is added, that can be processed by the service instance.</para>
+        </returns>
         <param name="incrementBy">
           <attribution license="cc4" from="Microsoft" modified="false" />The additional number of messages that can be processed by the service instance.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/MessageHeader`1.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/MessageHeader`1.xml
index 9591e613e9a..edb42a3398a 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/MessageHeader`1.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/MessageHeader`1.xml
@@ -135,12 +135,15 @@
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the message header with the specified namespace and local name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A message header with the specified namespace and local name.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the header XML element</param>
         <param name="ns">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/MessageSecurityOverHttp.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/MessageSecurityOverHttp.xml
index acf9f4bb261..c81d9e37b0c 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/MessageSecurityOverHttp.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/MessageSecurityOverHttp.xml
@@ -104,12 +104,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Only used in extensibility scenarios to indicate whether an instance of a class derived from <see cref="T:System.ServiceModel.MessageSecurityOverHttp" /> is configured to perform secure conversation as described in WS-SecurityConversation. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always returns true, unless overridden in a derived class.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="NegotiateServiceCredential">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/NetHttpBinding.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/NetHttpBinding.xml
index f32784d1277..f2adcdc9738 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/NetHttpBinding.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/NetHttpBinding.xml
@@ -126,12 +126,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a collection that contains the binding elements for the binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of the binding elements that makes up the binding.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MessageEncoding">
@@ -219,12 +222,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the reliable session has changed from its default value and should be serialized.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the reliable session should be serialized; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ShouldSerializeSecurity">
@@ -239,12 +245,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the security has changed from its default value and should be serialized.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the security should be serialized; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="WebSocketSettings">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/NetMsmqBinding.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/NetMsmqBinding.xml
index 397f3214fa8..46d0eb19224 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/NetMsmqBinding.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/NetMsmqBinding.xml
@@ -91,7 +91,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The order of the binding elements is important. It reflects the order in which the protocol and transport channels are constructed and stacked. This collection of binding elements is a new collection and can be modified and then used to create a <see cref="T:System.ServiceModel.Channels.CustomBinding" />.</para>
@@ -100,6 +99,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an ordered collection of binding elements contained in the current binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The ordered collection of binding elements described by the <see cref="T:System.ServiceModel.NetMsmqBinding" /> binding.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="EnvelopeVersion">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/NetNamedPipeBinding.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/NetNamedPipeBinding.xml
index 17d47481684..97baf301077 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/NetNamedPipeBinding.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/NetNamedPipeBinding.xml
@@ -103,12 +103,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a collection with the binding elements for the binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Collections.Generic.ICollection`1" /> of type <see cref="T:System.ServiceModel.Channels.BindingElement" /> that makes up the binding.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="EnvelopeVersion">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/NetPeerTcpBinding.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/NetPeerTcpBinding.xml
index 801a839a512..d5bcf939ad1 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/NetPeerTcpBinding.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/NetPeerTcpBinding.xml
@@ -78,12 +78,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a collection with the binding elements for the binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Collections.Generic.ICollection`1" /> of type <see cref="T:System.ServiceModel.Channels.BindingElement" /> that makes up the binding.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="EnvelopeVersion">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/NetTcpBinding.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/NetTcpBinding.xml
index 560ab1ab9f7..8536e9e9ad7 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/NetTcpBinding.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/NetTcpBinding.xml
@@ -132,12 +132,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a collection with the binding elements for the binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Collections.Generic.ICollection`1" /> of type <see cref="T:System.ServiceModel.Channels.BindingElement" /> that makes up the binding.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="EnvelopeVersion">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/OperationContext.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/OperationContext.xml
index d0b198cca1b..1a9a859e3a3 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/OperationContext.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/OperationContext.xml
@@ -192,7 +192,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call the <see cref="M:System.ServiceModel.OperationContext.GetCallbackChannel``1" /> property to obtain a channel that you can use to call operations on the client instance that called the service. </para>
@@ -201,6 +200,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a channel to the client instance that called the current operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A channel to the client instance that called the operation of the type specified in the <see cref="P:System.ServiceModel.ServiceContractAttribute.CallbackContract" /> property.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of channel used to call back to the client.</typeparam>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/PeerMessagePropagationFilter.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/PeerMessagePropagationFilter.xml
index 4e7f46299d5..96ad1a1d9f3 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/PeerMessagePropagationFilter.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/PeerMessagePropagationFilter.xml
@@ -52,12 +52,15 @@
         <Parameter Name="origination" Type="System.ServiceModel.PeerMessageOrigination" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether or not a message received on a peer channel should be propagated, and if so, the destination of the message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.PeerMessagePropagation" /> enumeration value that indicates the destination of the message (local, remote, both, or no propagation at all).</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The message to evaluate for propagation. </param>
         <param name="origination">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/PeerNode.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/PeerNode.xml
index a41629d9f71..ad4e19fbb44 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/PeerNode.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/PeerNode.xml
@@ -163,12 +163,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides a string representation of a peer node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="T:System.String" /> value that contains the mesh ID of the peer node if the mesh ID is set; otherwise, it returns the type.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/PeerResolver.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/PeerResolver.xml
index d1b0b5e89ed..1680091f86a 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/PeerResolver.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/PeerResolver.xml
@@ -111,12 +111,15 @@
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Registers a <see cref="T:System.ServiceModel.PeerNodeAddress" /> for a specific peer mesh.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the registration ID. This registration ID object is passed to the <see cref="M:System.ServiceModel.PeerResolver.Update(System.Object,System.ServiceModel.PeerNodeAddress,System.TimeSpan)" /> and <see cref="M:System.ServiceModel.PeerResolver.Unregister(System.Object,System.TimeSpan)" /> methods. </para>
+        </returns>
         <param name="meshId">
           <attribution license="cc4" from="Microsoft" modified="false" />The ID of the peer mesh in which the peer node is to be registered.</param>
         <param name="nodeAddress">
@@ -141,12 +144,15 @@
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resolves the supplied mesh ID to zero or more endpoint addresses of nodes participating in the peer mesh.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.ObjectModel.ReadOnlyCollection`1" /> that contains <see cref="T:System.ServiceModel.PeerNodeAddress" /> objects representing nodes participating in the peer mesh.</para>
+        </returns>
         <param name="meshId">
           <attribution license="cc4" from="Microsoft" modified="false" />The mesh ID of the peer mesh within which the <see cref="T:System.ServiceModel.PeerNodeAddress" /> objects representing participating nodes are to be obtained.</param>
         <param name="maxAddresses">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ServiceAuthorizationManager.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ServiceAuthorizationManager.xml
index 4c57dd733a2..e3f2ee7b49c 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ServiceAuthorizationManager.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ServiceAuthorizationManager.xml
@@ -66,7 +66,6 @@
       </Parameters>
       <Docs>
         <param name="context">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In general, applications should override <see cref="M:System.ServiceModel.ServiceAuthorizationManager.CheckAccessCore(System.ServiceModel.OperationContext)" /> instead of this method. </para>
@@ -77,6 +76,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks authorization for the given operation context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if access is granted; otherwise; otherwise false. The default is true.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CheckAccess">
@@ -116,7 +119,6 @@
       </Parameters>
       <Docs>
         <param name="context">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -130,6 +132,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks authorization for the given operation context based on default policy evaluation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if access is granted; otherwise, false. The default is true.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetAuthorizationPolicies">
@@ -147,7 +153,6 @@
       </Parameters>
       <Docs>
         <param name="context">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The indigo1 implementation provides a default set of authorization policies. These include the primary token that contains the credentials of the requester and all supporting tokens, transport tokens, and external policies if specified. </para>
@@ -157,6 +162,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the set of policies that participate in policy evaluation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.ObjectModel.ReadOnlyCollection`1" /> of type <see cref="T:System.IdentityModel.Policy.IAuthorizationPolicy" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ServiceBehaviorAttribute.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ServiceBehaviorAttribute.xml
index f223cd15ac4..dd41ffc6848 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ServiceBehaviorAttribute.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ServiceBehaviorAttribute.xml
@@ -275,7 +275,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A non-null value provides the service instance to which all messages addressed to the service will be dispatched. </para>
@@ -284,6 +283,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an object that implements the service and that is used as the singleton instance of the service, or null if there is no singleton instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An implementation of the service. The default value is null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IgnoreExtensionDataObject">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ServiceHost.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ServiceHost.xml
index 58f172617c4..54d160224b3 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ServiceHost.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ServiceHost.xml
@@ -123,12 +123,15 @@
         <Parameter Name="address" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a service endpoint to the hosted service with a specified contract, binding, and endpoint address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> added to the hosted service.</para>
+        </returns>
         <param name="implementedContract">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of contract for the endpoint added.</param>
         <param name="binding">
@@ -153,12 +156,15 @@
         <Parameter Name="address" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a service endpoint to the hosted service with a specified contract, binding, and URI that contains the endpoint address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> added to the hosted service.</para>
+        </returns>
         <param name="implementedContract">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of contract for the endpoint added.</param>
         <param name="binding">
@@ -184,7 +190,6 @@
         <Parameter Name="listenUri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this version of the method when you have multiple endpoints that need to listen on the same, specified URI.</para>
@@ -193,6 +198,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a service endpoint to the hosted service with a specified contract, binding, an endpoint address, and a URI on which the service listens.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> added to the hosted service.</para>
+        </returns>
         <param name="implementedContract">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of contract for the endpoint added.</param>
         <param name="binding">
@@ -220,7 +229,6 @@
         <Parameter Name="listenUri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this version of the method when you have multiple endpoints that need to listen on the same, specified URI.</para>
@@ -229,6 +237,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a service endpoint to the hosted service with a specified contract, binding, a URI that contains the endpoint address, and a URI on which the service listens.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> added to the hosted service.</para>
+        </returns>
         <param name="implementedContract">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of contract for the endpoint added.</param>
         <param name="binding">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ServiceHostBase.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ServiceHostBase.xml
index 12913b59217..711444ec938 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ServiceHostBase.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/ServiceHostBase.xml
@@ -129,12 +129,15 @@
         <Parameter Name="address" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a service endpoint to the hosted service with a specified contract, binding, and endpoint address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> added to the hosted service.</para>
+        </returns>
         <param name="implementedContract">
           <attribution license="cc4" from="Microsoft" modified="false" />The contract implemented by the endpoint.</param>
         <param name="binding">
@@ -159,12 +162,15 @@
         <Parameter Name="address" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a service endpoint to the hosted service with a specified contract, binding, and a URI that contains the endpoint address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> added to the hosted service.</para>
+        </returns>
         <param name="implementedContract">
           <attribution license="cc4" from="Microsoft" modified="false" />The contract implemented by the endpoint.</param>
         <param name="binding">
@@ -190,7 +196,6 @@
         <Parameter Name="listenUri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <paramref name="address" /> is a relative URI, one of the base addresses of the <see cref="T:System.ServiceModel.ServiceHost" /> (depending on the binding protocol) is used as the endpoint's base address.</para>
@@ -199,6 +204,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a service endpoint to the hosted service with a specified contract, binding, endpoint address and URI that contains the address at which it listens.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> added to the hosted service.</para>
+        </returns>
         <param name="implementedContract">
           <attribution license="cc4" from="Microsoft" modified="false" />The contract implemented by the endpoint.</param>
         <param name="binding">
@@ -226,12 +235,15 @@
         <Parameter Name="listenUri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a service endpoint to the hosted service with the specified contract, binding, and URIs that contain the endpoint and listening addresses.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Description.ServiceEndpoint" /> added to the hosted service. This URI can be absolute or relative.</para>
+        </returns>
         <param name="implementedContract">
           <attribution license="cc4" from="Microsoft" modified="false" />The contract implemented by the endpoint.</param>
         <param name="binding">
@@ -592,12 +604,15 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation invoked on the close of the service host.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous on-close operation. </para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies how long the on-close operation has to complete before timing out.</param>
         <param name="callback">
@@ -622,12 +637,15 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation invoked on the opening of the service host.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> that references the asynchronous on-open operation. </para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Timespan" /> that specifies how long the on-open operation has to complete before timing out.</param>
         <param name="callback">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/UriSchemeKeyedCollection.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/UriSchemeKeyedCollection.xml
index e5a38bbf600..43c286a105d 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/UriSchemeKeyedCollection.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/UriSchemeKeyedCollection.xml
@@ -64,12 +64,15 @@
         <Parameter Name="item" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the key for a specified URI from the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The key for the specified URI from the collection.</para>
+        </returns>
         <param name="item">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Uri" /> whose key is being retrieved.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/WSDualHttpBinding.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/WSDualHttpBinding.xml
index 1bd4e593d91..220279912dc 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/WSDualHttpBinding.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/WSDualHttpBinding.xml
@@ -161,12 +161,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an ordered collection of binding elements contained in the current binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.BindingElementCollection" /> that includes a <see cref="T:System.ServiceModel.Channels.TransactionFlowBindingElement" /> and, because a reliable session is required for the <see cref="T:System.ServiceModel.WSDualHttpBinding" />, a <see cref="T:System.ServiceModel.Channels.ReliableSessionBindingElement" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="EnvelopeVersion">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/WSFederationHttpBinding.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/WSFederationHttpBinding.xml
index 821604f01a2..e71d1d31f3a 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/WSFederationHttpBinding.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/WSFederationHttpBinding.xml
@@ -136,7 +136,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The stack of binding elements depends on the value of the <see cref="T:System.ServiceModel.WSFederationHttpSecurityMode" /> set.</para>
@@ -209,6 +208,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a collection with the binding elements for the binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Collections.Generic.ICollection`1" /> of type <see cref="T:System.ServiceModel.Channels.BindingElement" /> that makes up the binding.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateMessageSecurity">
@@ -223,12 +226,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.ServiceModel.Channels.SecurityBindingElement" /> that has enabled a reliable session.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.SecurityBindingElement" /> that has enabled a reliable session.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetTransport">
@@ -243,12 +249,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the transport binding element from the current binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.TransportBindingElement" /> from the current binding.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="PrivacyNoticeAt">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/WSHttpBinding.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/WSHttpBinding.xml
index 0b961600933..72650f02939 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/WSHttpBinding.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/WSHttpBinding.xml
@@ -160,7 +160,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The order of the binding elements is important. It reflects the order in which the protocol and transport channels are constructed and stacked. </para>
@@ -169,6 +168,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an ordered collection of binding elements contained in the current binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.BindingElementCollection" /> that contains the ordered stack of binding elements described by the <see cref="T:System.ServiceModel.WSHttpBinding" /> binding.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateMessageSecurity">
@@ -183,12 +186,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the security binding element from the current binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.SecurityBindingElement" /> from the current binding.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetTransport">
@@ -203,12 +209,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the transport binding element from the current binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.TransportBindingElement" /> from the current binding.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Security">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/WSHttpBindingBase.xml b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/WSHttpBindingBase.xml
index 02b16264027..d757a23a969 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/WSHttpBindingBase.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System.ServiceModel/WSHttpBindingBase.xml
@@ -99,7 +99,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The order of the binding elements is important. It reflects the order in which the protocol and transport channels are constructed and stacked. </para>
@@ -108,6 +107,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an ordered collection of binding elements contained in the current binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.BindingElementCollection" /> that contains the <see cref="T:System.ServiceModel.Channels.BindingElement" /> objects for the binding.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateMessageSecurity">
@@ -122,12 +125,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented in a derived class, returns the <see cref="T:System.ServiceModel.Channels.SecurityBindingElement" /> from the current binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ServiceModel.Channels.SecurityBindingElement" /> from the current binding.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="EnvelopeVersion">
@@ -161,12 +167,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented in a derived class, returns the transport binding element from the current binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ServiceModel.Channels.TransportBindingElement" /> from the current binding.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HostNameComparisonMode">
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System/UriTemplate.xml b/mcs/class/System.ServiceModel/Documentation/en/System/UriTemplate.xml
index efb98a3ca2d..83dbd11622e 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System/UriTemplate.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System/UriTemplate.xml
@@ -163,7 +163,6 @@
         <Parameter Name="parameters" Type="System.Collections.Generic.IDictionary&lt;System.String,System.String&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Collections.Generic.IDictionary{System.String,System.String}" /> parameter contains a collection of parameter name and value pairs. The parameters are matched up against the variables within the template by a case-insensitive comparison.</para>
@@ -178,6 +177,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new URI from the template and the collection of parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A URI.</para>
+        </returns>
         <param name="baseAddress">
           <attribution license="cc4" from="Microsoft" modified="false" />The base address.</param>
         <param name="parameters">
@@ -199,7 +202,6 @@
         <Parameter Name="parameters" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Collections.Specialized.NameValueCollection" /> parameter contains a collection of parameter name/value pairs. The parameters are matched up against the variables within the template by a case-insensitive comparison. Values passed in this collection are escaped.</para>
@@ -214,6 +216,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new URI from the template and the collection of parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance.</para>
+        </returns>
         <param name="baseAddress">
           <attribution license="cc4" from="Microsoft" modified="false" />The base address.</param>
         <param name="parameters">
@@ -236,12 +242,15 @@
         <Parameter Name="omitDefaults" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new URI from the template and the collection of parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A URI.</para>
+        </returns>
         <param name="baseAddress">
           <attribution license="cc4" from="Microsoft" modified="false" />A URI that contains the base address.</param>
         <param name="parameters">
@@ -266,12 +275,15 @@
         <Parameter Name="omitDefaults" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new URI from the template and the collection of parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A URI.</para>
+        </returns>
         <param name="baseAddress">
           <attribution license="cc4" from="Microsoft" modified="false" />The base address.</param>
         <param name="parameters">
@@ -301,7 +313,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The parameter values are bound by position left to right. The first parameter value replaces the first variable found in the template, the second parameter value replaces the second variable, and so on. Variables passed to this method are escaped.</para>
@@ -323,6 +334,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new URI from the template and an array of parameter values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Uri" /> instance.</para>
+        </returns>
         <param name="baseAddress">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Uri" /> that contains the base address.</param>
         <param name="values">
@@ -381,7 +396,6 @@
         <Parameter Name="other" Type="System.UriTemplate" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Two <see cref="T:System.UriTemplate" /> instances are equivalent if their literal strings are identical and the variables appear in the same segments. For example "weather/{state}/{city}" is equivalent to "weather/{country}/{village}".</para>
@@ -390,6 +404,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a <see cref="T:System.UriTemplate" /> is structurally equivalent to another.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.UriTemplate" /> is structurally equivalent to another; otherwise false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.UriTemplate" /> to compare.</param>
       </Docs>
@@ -409,7 +427,6 @@
         <Parameter Name="candidate" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the match is successful the <see cref="T:System.UriTemplateMatch" /> is populated with the URI segments, variable values, query string values, and wildcard segments from the candidate URI. If the match is unsuccessful, null is returned.</para>
@@ -418,6 +435,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to match a <see cref="T:System.URI" /> to a <see cref="T:System.UriTemplate" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance.</para>
+        </returns>
         <param name="baseAddress">
           <attribution license="cc4" from="Microsoft" modified="false" />The base address.</param>
         <param name="candidate">
@@ -480,12 +501,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of the <see cref="T:System.UriTemplate" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The representation of the <see cref="T:System.UriTemplate" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System/UriTemplateEquivalenceComparer.xml b/mcs/class/System.ServiceModel/Documentation/en/System/UriTemplateEquivalenceComparer.xml
index 9bd3ae46f63..5166bc6ea32 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System/UriTemplateEquivalenceComparer.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System/UriTemplateEquivalenceComparer.xml
@@ -57,7 +57,6 @@
         <Parameter Name="y" Type="System.UriTemplate" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is not normally called directly. It is called by another class that is comparing two <see cref="T:System.UriTemplate" /> instances.</para>
@@ -66,6 +65,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.UriTemplate" /> instances for equivalence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that indicates whether the two <see cref="T:System.UriTemplate" /> instances are equivalent.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.UriTemplate" /> instance.</param>
         <param name="y">
@@ -86,7 +89,6 @@
         <Parameter Name="obj" Type="System.UriTemplate" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is not normally called directly. It is called by another class that requires a hash of a <see cref="T:System.UriTemplate" /> instance.</para>
@@ -95,6 +97,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a hash code for the specified <see cref="T:System.UriTemplate" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.UriTemplate" /> instance.</param>
       </Docs>
diff --git a/mcs/class/System.ServiceModel/Documentation/en/System/UriTemplateTable.xml b/mcs/class/System.ServiceModel/Documentation/en/System/UriTemplateTable.xml
index d0c08654e44..0524a8ebd7f 100644
--- a/mcs/class/System.ServiceModel/Documentation/en/System/UriTemplateTable.xml
+++ b/mcs/class/System.ServiceModel/Documentation/en/System/UriTemplateTable.xml
@@ -223,7 +223,6 @@
         <Parameter Name="uri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method may return multiple matches.</para>
@@ -232,6 +231,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to match a candidate <see cref="T:System.Uri" /> to the <see cref="T:System.UriTemplateTable" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of <see cref="T:System.UriTemplateMatch" /> instances.</para>
+        </returns>
         <param name="uri">
           <attribution license="cc4" from="Microsoft" modified="false" />The candidate URI.</param>
       </Docs>
@@ -250,7 +253,6 @@
         <Parameter Name="uri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns, at most, one match. If more than one match is found, a <see cref="T:System.UriTemplateMatchException" /> is thrown.</para>
@@ -259,6 +261,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to match a candidate <see cref="T:System.Uri" /> to the <see cref="T:System.UriTemplateTable" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A single <see cref="T:System.UriTemplateMatch" /> instance.</para>
+        </returns>
         <param name="uri">
           <attribution license="cc4" from="Microsoft" modified="false" />The candidate URI.</param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Configuration/ProtocolElementCollection.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Configuration/ProtocolElementCollection.xml
index 60838929229..0ad951348fa 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Configuration/ProtocolElementCollection.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Configuration/ProtocolElementCollection.xml
@@ -94,13 +94,16 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Boolean" /> that indicates whether a <see cref="T:System.Web.Services.Configuration.ProtocolElement" /> with the specified key exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains a <see cref="T:System.Web.Services.Configuration.ProtocolElement" /> with the specified key; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key of the <see cref="T:System.Web.Services.Configuration.ProtocolElement" /> to find in the collection.</param>
       </Docs>
@@ -181,13 +184,16 @@
         <Parameter Name="element" Type="System.Web.Services.Configuration.ProtocolElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the zero-based index of a specified <see cref="T:System.Web.Services.Configuration.ProtocolElement" /> in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the specified <see cref="T:System.Web.Services.Configuration.ProtocolElement" />, or -1 if the element was not found in the collection.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Configuration.ProtocolElement" /> to find in the collection.</param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Configuration/SoapExtensionTypeElementCollection.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Configuration/SoapExtensionTypeElementCollection.xml
index 31fe776309a..4c887a48699 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Configuration/SoapExtensionTypeElementCollection.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Configuration/SoapExtensionTypeElementCollection.xml
@@ -94,13 +94,16 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Boolean" /> that indicates whether a <see cref="T:System.Web.Services.Configuration.SoapExtensionTypeElement" /> with the specified key exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains a <see cref="T:System.Web.Services.Configuration.SoapExtensionTypeElement" /> with the specified key; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key of the <see cref="T:System.Web.Services.Configuration.SoapExtensionTypeElement" /> to find in the collection.</param>
       </Docs>
@@ -181,13 +184,16 @@
         <Parameter Name="element" Type="System.Web.Services.Configuration.SoapExtensionTypeElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the zero-based index of a specified <see cref="T:System.Web.Services.Configuration.SoapExtensionTypeElement" /> in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the specified <see cref="T:System.Web.Services.Configuration.SoapExtensionTypeElement" />, or -1 if the element was not found in the collection.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Configuration.SoapExtensionTypeElement" /> to find in the collection.</param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Configuration/TypeElementCollection.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Configuration/TypeElementCollection.xml
index 1b4692f33a8..c242faa9867 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Configuration/TypeElementCollection.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Configuration/TypeElementCollection.xml
@@ -94,13 +94,16 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Boolean" /> that indicates whether a <see cref="T:System.Web.Services.Configuration.TypeElement" /> with the specified key exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains a <see cref="T:System.Web.Services.Configuration.TypeElement" /> with the specified key; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key of the <see cref="T:System.Web.Services.Configuration.TypeElement" /> to find in the collection.</param>
       </Docs>
@@ -181,13 +184,16 @@
         <Parameter Name="element" Type="System.Web.Services.Configuration.TypeElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the zero-based index of a specified <see cref="T:System.Web.Services.Configuration.TypeElement" /> in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the specified <see cref="T:System.Web.Services.Configuration.TypeElement" />, or -1 if the element was not found in the collection.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Configuration.TypeElement" /> to find in the collection.</param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Configuration/WebServicesSection.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Configuration/WebServicesSection.xml
index 4452f8beb14..020e85d7920 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Configuration/WebServicesSection.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Configuration/WebServicesSection.xml
@@ -125,13 +125,16 @@
         <Parameter Name="config" Type="System.Configuration.Configuration" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the specified configuration section.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Services.Configuration.WebServicesSection" /> object that represents the section being retrieved.</para>
+        </returns>
         <param name="config">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Configuration.Configuration" /> object that represents the section to be retrieved.</param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Configuration/WsiProfilesElementCollection.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Configuration/WsiProfilesElementCollection.xml
index 8fb02b8601e..f6b2d2ad7a5 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Configuration/WsiProfilesElementCollection.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Configuration/WsiProfilesElementCollection.xml
@@ -94,13 +94,16 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Boolean" /> that indicates whether a <see cref="T:System.Web.Services.Configuration.WsiProfilesElement" /> with the specified key exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains a <see cref="T:System.Web.Services.Configuration.WsiProfilesElement" /> with the specified key; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key of the <see cref="T:System.Web.Services.Configuration.WsiProfilesElement" /> to find in the collection.</param>
       </Docs>
@@ -181,13 +184,16 @@
         <Parameter Name="element" Type="System.Web.Services.Configuration.WsiProfilesElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the zero-based index of a specified <see cref="T:System.Web.Services.Configuration.WsiProfilesElement" /> in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the specified <see cref="T:System.Web.Services.Configuration.WsiProfilesElement" />, or -1 if the element was not found in the collection.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Configuration.WsiProfilesElement" /> to find in the collection.</param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/BasicProfileViolation.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/BasicProfileViolation.xml
index 1b40d2b8d1b..827136a4c52 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/BasicProfileViolation.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/BasicProfileViolation.xml
@@ -121,13 +121,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.String" /> that comprises information from <see cref="P:System.Web.Services.Description.BasicProfileViolation.NormativeStatement" />, <see cref="P:System.Web.Services.Description.BasicProfileViolation.Details" />, and <see cref="P:System.Web.Services.Description.BasicProfileViolation.Elements" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that comprises information from <see cref="P:System.Web.Services.Description.BasicProfileViolation.NormativeStatement" />, <see cref="P:System.Web.Services.Description.BasicProfileViolation.Details" />, and <see cref="P:System.Web.Services.Description.BasicProfileViolation.Elements" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/BasicProfileViolationCollection.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/BasicProfileViolationCollection.xml
index eef122277b7..acf6e4ba6e2 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/BasicProfileViolationCollection.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/BasicProfileViolationCollection.xml
@@ -48,13 +48,16 @@
         <Parameter Name="violation" Type="System.Web.Services.Description.BasicProfileViolation" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks whether the collection contains the specified <see cref="T:System.Web.Services.Description.BasicProfileViolation" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.Services.Description.BasicProfileViolation" /> object exists in the collection; otherwise false.</para>
+        </returns>
         <param name="violation">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.BasicProfileViolation" /> object to locate in the collection.</param>
       </Docs>
@@ -98,13 +101,16 @@
         <Parameter Name="violation" Type="System.Web.Services.Description.BasicProfileViolation" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the zero-based index of a specified <see cref="T:System.Web.Services.Description.BasicProfileViolation" /> in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the specified <see cref="T:System.Web.Services.Description.BasicProfileViolation" />, or -1 if the element was not found in the collection.</para>
+        </returns>
         <param name="violation">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.BasicProfileViolation" /> to find in the collection.</param>
       </Docs>
@@ -205,13 +211,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.String" /> representation of the <see cref="T:System.Web.Services.Description.BasicProfileViolation" /> objects in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> representation of the <see cref="T:System.Web.Services.Description.BasicProfileViolation" /> objects in the collection.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/BasicProfileViolationEnumerator.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/BasicProfileViolationEnumerator.xml
index cf1d5406dab..dc0ed7a7b32 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/BasicProfileViolationEnumerator.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/BasicProfileViolationEnumerator.xml
@@ -93,12 +93,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Enumerates to the next element in the <see cref="T:System.Web.Services.Description.BasicProfileViolationCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>false if the end of the collection is reached; otherwise true.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IEnumerator.Current">
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/BindingCollection.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/BindingCollection.xml
index b235a5c3fc0..dcdb4c15fa7 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/BindingCollection.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/BindingCollection.xml
@@ -35,12 +35,15 @@
         <Parameter Name="binding" Type="System.Web.Services.Description.Binding" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Web.Services.Description.Binding" /> to the end of the <see cref="T:System.Web.Services.Description.BindingCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index where the <paramref name="binding" /> parameter has been added.</para>
+        </returns>
         <param name="binding">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.Binding" /> to add to the collection. </param>
       </Docs>
@@ -59,12 +62,15 @@
         <Parameter Name="binding" Type="System.Web.Services.Description.Binding" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified <see cref="T:System.Web.Services.Description.Binding" /> is a member of the <see cref="T:System.Web.Services.Description.BindingCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="binding" /> parameter is a member of the <see cref="T:System.Web.Services.Description.BindingCollection" />; otherwise, false.</para>
+        </returns>
         <param name="binding">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.Services.Description.Binding" /> for which to check collection membership. </param>
       </Docs>
@@ -109,12 +115,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the <see cref="T:System.Web.Services.Description.Binding" /> associated with the value passed by reference.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the <paramref name="value" /> parameter.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.Binding" /> for which to return the name. </param>
       </Docs>
@@ -133,12 +142,15 @@
         <Parameter Name="binding" Type="System.Web.Services.Description.Binding" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified <see cref="T:System.Web.Services.Description.Binding" /> and returns the zero-based index of the first occurrence within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer.</para>
+        </returns>
         <param name="binding">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.Binding" /> for which to search in the collection. </param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/FaultBindingCollection.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/FaultBindingCollection.xml
index 3622f62c36e..737e7fec1a9 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/FaultBindingCollection.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/FaultBindingCollection.xml
@@ -32,12 +32,15 @@
         <Parameter Name="bindingOperationFault" Type="System.Web.Services.Description.FaultBinding" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Web.Services.Description.FaultBinding" /> to the end of the <see cref="T:System.Web.Services.Description.FaultBindingCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index where the <paramref name="bindingOperationFault" /> parameter has been added.</para>
+        </returns>
         <param name="bindingOperationFault">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.FaultBinding" /> to add to the collection. </param>
       </Docs>
@@ -56,12 +59,15 @@
         <Parameter Name="bindingOperationFault" Type="System.Web.Services.Description.FaultBinding" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified <see cref="T:System.Web.Services.Description.FaultBinding" /> is a member of the <see cref="T:System.Web.Services.Description.FaultBindingCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="bindingOperationFault" /> parameter is a member of the FaultBindingCollection; otherwise, false.</para>
+        </returns>
         <param name="bindingOperationFault">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.FaultBinding" /> for which to check collection membership. </param>
       </Docs>
@@ -106,12 +112,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the <see cref="T:System.Web.Services.Description.FaultBinding" /> associated with the value passed by reference.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the <paramref name="value" /> parameter.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.FaultBinding" /> for which to return the name. </param>
       </Docs>
@@ -130,12 +139,15 @@
         <Parameter Name="bindingOperationFault" Type="System.Web.Services.Description.FaultBinding" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified <see cref="T:System.Web.Services.Description.FaultBinding" /> and returns the zero-based index of the first occurrence within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer.</para>
+        </returns>
         <param name="bindingOperationFault">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.FaultBinding" /> for which to search in the collection. </param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ImportCollection.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ImportCollection.xml
index 27cd0d25c30..715b134ec76 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ImportCollection.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ImportCollection.xml
@@ -35,12 +35,15 @@
         <Parameter Name="import" Type="System.Web.Services.Description.Import" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Web.Services.Description.Import" /> to the end of the <see cref="T:System.Web.Services.Description.ImportCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index where the <paramref name="import" /> parameter has been added.</para>
+        </returns>
         <param name="import">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.Import" /> to add to the collection. </param>
       </Docs>
@@ -59,12 +62,15 @@
         <Parameter Name="import" Type="System.Web.Services.Description.Import" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified <see cref="T:System.Web.Services.Description.Import" /> is a member of the <see cref="T:System.Web.Services.Description.ImportCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="import" /> parameter is a member of the <see cref="T:System.Web.Services.Description.ImportCollection" />; otherwise, false.</para>
+        </returns>
         <param name="import">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.Import" /> for which to check collection membership. </param>
       </Docs>
@@ -109,12 +115,15 @@
         <Parameter Name="import" Type="System.Web.Services.Description.Import" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified <see cref="T:System.Web.Services.Description.Import" /> and returns the zero-based index of the first occurrence within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer.</para>
+        </returns>
         <param name="import">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.Import" /> for which to search in the collection. </param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/Message.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/Message.xml
index b4126796478..6de88894a07 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/Message.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/Message.xml
@@ -75,12 +75,15 @@
         <Parameter Name="partName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MessagePart'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the <see cref="T:System.Web.Services.Description.MessagePartCollection" /> returned by the <see cref="P:System.Web.Services.Description.Message.Parts" /> property, and returns the named <see cref="T:System.Web.Services.Description.MessagePart" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Services.Description.MessagePart" />.</para>
+        </returns>
         <param name="partName">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that names the <see cref="T:System.Web.Services.Description.MessagePart" /> to be returned.</param>
       </Docs>
@@ -99,12 +102,15 @@
         <Parameter Name="partNames" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MessagePart []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the <see cref="T:System.Web.Services.Description.MessagePartCollection" /> returned by the <see cref="P:System.Web.Services.Description.Message.Parts" /> property and returns an array of type <see cref="T:System.Web.Services.Description.MessagePart" /> that contains the named instances.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Web.Services.Description.MessagePart" />.</para>
+        </returns>
         <param name="partNames">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of names of the <see cref="T:System.Web.Services.Description.MessagePart" /> instances to be returned. </param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/MessageCollection.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/MessageCollection.xml
index 4abd54ba9d7..c8d24a7ac88 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/MessageCollection.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/MessageCollection.xml
@@ -32,12 +32,15 @@
         <Parameter Name="message" Type="System.Web.Services.Description.Message" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Web.Services.Description.Message" /> to the end of the <see cref="T:System.Web.Services.Description.MessageCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index where the <paramref name="message" /> parameter has been added.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.Message" /> to add to the collection. </param>
       </Docs>
@@ -56,12 +59,15 @@
         <Parameter Name="message" Type="System.Web.Services.Description.Message" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified <see cref="T:System.Web.Services.Description.Message" /> is a member of the <see cref="T:System.Web.Services.Description.MessageCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="message" /> parameter is a member of the <see cref="T:System.Web.Services.Description.MessageCollection" />; otherwise, false.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.Message" /> for which to check collection membership. </param>
       </Docs>
@@ -126,12 +132,15 @@
         <Parameter Name="message" Type="System.Web.Services.Description.Message" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified <see cref="T:System.Web.Services.Description.Message" /> and returns the zero-based index of the first occurrence within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.Message" /> for which to search in the collection. </param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/MessagePartCollection.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/MessagePartCollection.xml
index 3539891397c..14835c21bef 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/MessagePartCollection.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/MessagePartCollection.xml
@@ -35,12 +35,15 @@
         <Parameter Name="messagePart" Type="System.Web.Services.Description.MessagePart" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Web.Services.Description.MessagePart" /> to the end of the <see cref="T:System.Web.Services.Description.MessagePartCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index where the <paramref name="messagePart" /> parameter has been added.</para>
+        </returns>
         <param name="messagePart">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.MessagePart" /> to add to the collection. </param>
       </Docs>
@@ -59,12 +62,15 @@
         <Parameter Name="messagePart" Type="System.Web.Services.Description.MessagePart" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified <see cref="T:System.Web.Services.Description.MessagePart" /> is a member of the MessagePartCollection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="messagePart" /> parameter is a member of the <see cref="T:System.Web.Services.Description.MessagePartCollection" />; otherwise, false.</para>
+        </returns>
         <param name="messagePart">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.MessagePart" /> for which to check collection membership. </param>
       </Docs>
@@ -129,12 +135,15 @@
         <Parameter Name="messagePart" Type="System.Web.Services.Description.MessagePart" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified <see cref="T:System.Web.Services.Description.MessagePart" /> and returns the zero-based index of the first occurrence within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer.</para>
+        </returns>
         <param name="messagePart">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.MessagePart" /> for which to search in the collection. </param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/MimePartCollection.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/MimePartCollection.xml
index c51fb37005c..ffb288a9ce4 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/MimePartCollection.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/MimePartCollection.xml
@@ -53,12 +53,15 @@
         <Parameter Name="mimePart" Type="System.Web.Services.Description.MimePart" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Web.Services.Description.MimePart" /> to the end of the <see cref="T:System.Web.Services.Description.MimePartCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index where the <paramref name="mimePart" /> parameter has been added.</para>
+        </returns>
         <param name="mimePart">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.MimePart" /> to add to the collection. </param>
       </Docs>
@@ -77,12 +80,15 @@
         <Parameter Name="mimePart" Type="System.Web.Services.Description.MimePart" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified <see cref="T:System.Web.Services.Description.MimePart" /> is a member of the <see cref="T:System.Web.Services.Description.MimePartCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="mimePart" /> parameter is a member of the MimePartCollection; otherwise, false.</para>
+        </returns>
         <param name="mimePart">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.MimePart" /> to check for collection membership. </param>
       </Docs>
@@ -127,12 +133,15 @@
         <Parameter Name="mimePart" Type="System.Web.Services.Description.MimePart" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified <see cref="T:System.Web.Services.Description.MimePart" /> and returns the zero-based index of the first occurrence within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer.</para>
+        </returns>
         <param name="mimePart">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.MimePart" /> for which to search the <see cref="T:System.Web.Services.Description.MimePartCollection" />. </param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/MimeTextMatchCollection.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/MimeTextMatchCollection.xml
index baa02c47ce8..5793af848ab 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/MimeTextMatchCollection.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/MimeTextMatchCollection.xml
@@ -52,12 +52,15 @@
         <Parameter Name="match" Type="System.Web.Services.Description.MimeTextMatch" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Web.Services.Description.MimeTextMatch" /> to the end of the <see cref="T:System.Web.Services.Description.MimeTextMatchCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index where the <paramref name="match" /> parameter has been added.</para>
+        </returns>
         <param name="match">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.MimeTextMatch" /> to add to the collection. </param>
       </Docs>
@@ -76,12 +79,15 @@
         <Parameter Name="match" Type="System.Web.Services.Description.MimeTextMatch" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified <see cref="T:System.Web.Services.Description.MimeTextMatch" /> is a member of the <see cref="T:System.Web.Services.Description.MimeTextMatchCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="match" /> parameter is a member of the MimeTextMatchCollection; otherwise, false.</para>
+        </returns>
         <param name="match">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.MimeTextMatch" /> for which to check collection membership. </param>
       </Docs>
@@ -126,12 +132,15 @@
         <Parameter Name="match" Type="System.Web.Services.Description.MimeTextMatch" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified <see cref="T:System.Web.Services.Description.MimeTextMatch" /> and returns the zero-based index of the first occurrence within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer.</para>
+        </returns>
         <param name="match">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.MimeTextMatch" /> for which to search in the collection. </param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/Operation.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/Operation.xml
index 411140f0758..fad4f8fb26c 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/Operation.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/Operation.xml
@@ -98,12 +98,15 @@
         <Parameter Name="operationBinding" Type="System.Web.Services.Description.OperationBinding" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the specified <see cref="T:System.Web.Services.Description.OperationBinding" /> matches with the <see cref="T:System.Web.Services.Description.Operation" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.Services.Description.Operation" /> instance matches the <paramref name="operationBinding" /> parameter; otherwise, false.</para>
+        </returns>
         <param name="operationBinding">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Web.Services.Description.OperationBinding" /> to be checked to determine whether it matches with the <see cref="T:System.Web.Services.Description.Operation" />. </param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/OperationBindingCollection.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/OperationBindingCollection.xml
index 27c6146c87d..092eb32eff8 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/OperationBindingCollection.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/OperationBindingCollection.xml
@@ -35,12 +35,15 @@
         <Parameter Name="bindingOperation" Type="System.Web.Services.Description.OperationBinding" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Web.Services.Description.OperationBinding" /> to the end of the <see cref="T:System.Web.Services.Description.OperationBindingCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index where the <paramref name="bindingOperation" /> parameter has been added.</para>
+        </returns>
         <param name="bindingOperation">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.OperationBinding" /> to add to the collection. </param>
       </Docs>
@@ -59,12 +62,15 @@
         <Parameter Name="bindingOperation" Type="System.Web.Services.Description.OperationBinding" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified <see cref="T:System.Web.Services.Description.OperationBinding" /> is a member of the <see cref="T:System.Web.Services.Description.OperationBindingCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="bindingOperation" /> parameter is a member of the <see cref="T:System.Web.Services.Description.OperationBindingCollection" />; otherwise, false.</para>
+        </returns>
         <param name="bindingOperation">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.OperationBinding" /> for which to check collection membership. </param>
       </Docs>
@@ -109,12 +115,15 @@
         <Parameter Name="bindingOperation" Type="System.Web.Services.Description.OperationBinding" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified <see cref="T:System.Web.Services.Description.OperationBinding" /> and returns the zero-based index of the first occurrence within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer.</para>
+        </returns>
         <param name="bindingOperation">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.OperationBinding" /> for which to search in the collection. </param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/OperationCollection.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/OperationCollection.xml
index 82d2d04049b..cfb10331c10 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/OperationCollection.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/OperationCollection.xml
@@ -35,12 +35,15 @@
         <Parameter Name="operation" Type="System.Web.Services.Description.Operation" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Web.Services.Description.Operation" /> to the end of the <see cref="T:System.Web.Services.Description.OperationCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index where the <paramref name="operation" /> parameter has been added.</para>
+        </returns>
         <param name="operation">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.Operation" /> to add to the collection. </param>
       </Docs>
@@ -59,12 +62,15 @@
         <Parameter Name="operation" Type="System.Web.Services.Description.Operation" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified <see cref="T:System.Web.Services.Description.Operation" /> is a member of the <see cref="T:System.Web.Services.Description.OperationCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="operation" /> is a member of the <see cref="T:System.Web.Services.Description.OperationCollection" />; otherwise, false.</para>
+        </returns>
         <param name="operation">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.Operation" /> for which to check collection membership. </param>
       </Docs>
@@ -109,12 +115,15 @@
         <Parameter Name="operation" Type="System.Web.Services.Description.Operation" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified <see cref="T:System.Web.Services.Description.Operation" /> and returns the zero-based index of the first occurrence within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer.</para>
+        </returns>
         <param name="operation">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.Operation" /> for which to search in the collection. </param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/OperationFaultCollection.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/OperationFaultCollection.xml
index 58830b29f13..86405be5b18 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/OperationFaultCollection.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/OperationFaultCollection.xml
@@ -35,12 +35,15 @@
         <Parameter Name="operationFaultMessage" Type="System.Web.Services.Description.OperationFault" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Web.Services.Description.OperationFault" /> to the end of the <see cref="T:System.Web.Services.Description.OperationFaultCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index where the <paramref name="operationFaultMessage" /> parameter has been added.</para>
+        </returns>
         <param name="operationFaultMessage">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.OperationFault" /> to add to the collection. </param>
       </Docs>
@@ -59,12 +62,15 @@
         <Parameter Name="operationFaultMessage" Type="System.Web.Services.Description.OperationFault" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified <see cref="T:System.Web.Services.Description.OperationFault" /> is a member of the <see cref="T:System.Web.Services.Description.OperationFaultCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="operationFaultMessage" /> parameter is a member of the <see cref="T:System.Web.Services.Description.OperationFaultCollection" />; otherwise, false.</para>
+        </returns>
         <param name="operationFaultMessage">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.OperationFault" /> for which to check collection membership. </param>
       </Docs>
@@ -129,12 +135,15 @@
         <Parameter Name="operationFaultMessage" Type="System.Web.Services.Description.OperationFault" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified <see cref="T:System.Web.Services.Description.OperationFault" /> and returns the zero-based index of the first occurrence within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer.</para>
+        </returns>
         <param name="operationFaultMessage">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.OperationFault" /> for which to search in the collection. </param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/OperationMessageCollection.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/OperationMessageCollection.xml
index c7aeb0dc8e0..33a0108d050 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/OperationMessageCollection.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/OperationMessageCollection.xml
@@ -35,12 +35,15 @@
         <Parameter Name="operationMessage" Type="System.Web.Services.Description.OperationMessage" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Web.Services.Description.OperationMessage" /> to the end of the <see cref="T:System.Web.Services.Description.OperationMessageCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index where the <paramref name="operationMessage" /> parameter has been added.</para>
+        </returns>
         <param name="operationMessage">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.OperationMessage" /> to add to the collection.</param>
       </Docs>
@@ -59,12 +62,15 @@
         <Parameter Name="operationMessage" Type="System.Web.Services.Description.OperationMessage" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Web.Services.Description.OperationMessage" /> is a member of the <see cref="T:System.Web.Services.Description.OperationMessageCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="operationMessage" /> parameter is a member of the <see cref="T:System.Web.Services.Description.OperationMessageCollection" />; otherwise, false.</para>
+        </returns>
         <param name="operationMessage">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.OperationMessage" /> for which to check collection membership.</param>
       </Docs>
@@ -128,12 +134,15 @@
         <Parameter Name="operationMessage" Type="System.Web.Services.Description.OperationMessage" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified <see cref="T:System.Web.Services.Description.OperationMessage" /> and returns the zero-based index of the first occurrence within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the specified operation message, or -1 if the element was not found in the collection.</para>
+        </returns>
         <param name="operationMessage">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.OperationMessage" /> for which to search in the collection.</param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/PortCollection.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/PortCollection.xml
index 29b7a177646..55892344b9e 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/PortCollection.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/PortCollection.xml
@@ -32,12 +32,15 @@
         <Parameter Name="port" Type="System.Web.Services.Description.Port" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Web.Services.Description.Port" /> to the end of the <see cref="T:System.Web.Services.Description.PortCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index where the <paramref name="port" /> parameter has been added.</para>
+        </returns>
         <param name="port">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.Port" /> to add to the collection. </param>
       </Docs>
@@ -56,12 +59,15 @@
         <Parameter Name="port" Type="System.Web.Services.Description.Port" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified <see cref="T:System.Web.Services.Description.Port" /> is a member of the <see cref="T:System.Web.Services.Description.PortCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Web.Services.Description.Port" /> is a member of the <see cref="T:System.Web.Services.Description.PortCollection" />; otherwise, false.</para>
+        </returns>
         <param name="port">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.Port" /> for which to check collection membership.</param>
       </Docs>
@@ -126,12 +132,15 @@
         <Parameter Name="port" Type="System.Web.Services.Description.Port" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified <see cref="T:System.Web.Services.Description.Port" /> and returns the zero-based index of the first occurrence within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer.</para>
+        </returns>
         <param name="port">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.Port" /> for which to search in the collection.</param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/PortTypeCollection.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/PortTypeCollection.xml
index fb4b6e48d78..a7e7ecc5aeb 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/PortTypeCollection.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/PortTypeCollection.xml
@@ -32,12 +32,15 @@
         <Parameter Name="portType" Type="System.Web.Services.Description.PortType" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Web.Services.Description.PortType" /> to the end of the <see cref="T:System.Web.Services.Description.PortTypeCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index where the <paramref name="portType" /> parameter has been added.</para>
+        </returns>
         <param name="portType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.PortType" /> to add to the collection. </param>
       </Docs>
@@ -56,12 +59,15 @@
         <Parameter Name="portType" Type="System.Web.Services.Description.PortType" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified <see cref="T:System.Web.Services.Description.PortType" /> is a member of the <see cref="T:System.Web.Services.Description.PortTypeCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="portType" /> parameter is a member of the <see cref="T:System.Web.Services.Description.PortTypeCollection" />; otherwise, false.</para>
+        </returns>
         <param name="portType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.PortType" /> for which to check for collection membership. </param>
       </Docs>
@@ -126,12 +132,15 @@
         <Parameter Name="portType" Type="System.Web.Services.Description.PortType" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified <see cref="T:System.Web.Services.Description.PortType" /> and returns the zero-based index of the first occurrence within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer.</para>
+        </returns>
         <param name="portType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.PortType" /> for which to search in the collection. </param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ProtocolImporter.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ProtocolImporter.xml
index 969ed7d4247..bcda404ad20 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ProtocolImporter.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ProtocolImporter.xml
@@ -98,7 +98,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.CodeDom.CodeTypeDeclaration" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When generating a class for a given binding, the <see cref="T:System.Web.Services.Description.ProtocolImporter" /> class calls the <see cref="M:System.Web.Services.Description.ProtocolImporter.BeginClass" /> method before generating methods that correspond to operations.</para>
@@ -107,6 +106,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, initializes the generation of a binding class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The generated class.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -305,7 +308,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.CodeDom.CodeMemberMethod" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When generating code, the <see cref="T:System.Web.Services.Description.ProtocolImporter" /> class calls the <see cref="M:System.Web.Services.Description.ProtocolImporter.GenerateMethod" /> method for each binding class method that represents an operation.</para>
@@ -314,6 +316,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, generates method code for binding classes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The generated method.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -347,7 +353,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When generating code, the <see cref="T:System.Web.Services.Description.ProtocolImporter" /> class calls the <see cref="M:System.Web.Services.Description.ProtocolImporter.IsBindingSupported" /> method to determine whether to generate a class for the current binding, as represented by the <see cref="P:System.Web.Services.Description.ProtocolImporter.Binding" /> property.</para>
@@ -356,6 +361,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, determines whether a class can be generated for the current binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True if the binding is supported; otherwise false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -372,7 +381,6 @@
         <Parameter Name="flow" Type="System.Web.Services.Description.OperationFlow" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When generating code, the <see cref="T:System.Web.Services.Description.ProtocolImporter" /> class calls the <see cref="M:System.Web.Services.Description.ProtocolImporter.IsOperationFlowSupported(System.Web.Services.Description.OperationFlow)" /> method to determine whether to generate a method for the current operation, as represented by the <see cref="P:System.Web.Services.Description.ProtocolImporter.Operation" /> property. This evaluation takes place for each operation in a binding for which a class is being generated. If a false value is returned, the <see cref="T:System.Web.Services.Description.ProtocolImporter" /> class calls its <see cref="M:System.Web.Services.Description.ProtocolImporter.UnsupportedOperationWarning(System.String)" /> method.</para>
@@ -382,6 +390,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, determines whether the current operation's operation flow is supported.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True if the current operation's operation flow is supported.</para>
+        </returns>
         <param name="flow">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Web.Services.Description.OperationFlow" />  enumeration value that represents a transmission pattern.</param>
       </Docs>
@@ -463,12 +475,15 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Exception'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces an Exception indicating that the current <see cref="P:System.Web.Services.Description.ProtocolImporter.OperationBinding" /> instance for which a binding class is being generated is invalid within the target namespace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An Exception indicating that the current <see cref="P:System.Web.Services.Description.ProtocolImporter.OperationBinding" /> instance for which a binding class is being generated is invalid within the target namespace.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />Annotation to be added to the exception message, which already indicates that the operation binding syntax is invalid.</param>
       </Docs>
@@ -487,12 +502,15 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Exception'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces an Exception indicating that the current <see cref="P:System.Web.Services.Description.ProtocolImporter.Operation" /> instance for which a binding class is being generated is invalid within the target namespace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An Exception indicating that the current <see cref="P:System.Web.Services.Description.ProtocolImporter.Operation" /> instance for which a binding class is being generated is invalid within the target namespace.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />Annotation to be added to the exception message, which already indicates that the operation syntax is invalid.</param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ProtocolReflector.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ProtocolReflector.xml
index 10222c700d3..fa90127376f 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ProtocolReflector.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ProtocolReflector.xml
@@ -130,7 +130,6 @@
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ServiceDescription'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Web.Services.Description.ServiceDescription" /> instance obtained subsequently gets populated with objects that correspond to WSDL entities that are reflected from the input Web service class.</para>
@@ -139,6 +138,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Web.Services.Description.ServiceDescription" /> object for a given XML namespace and the applicable communication protocol.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Services.Description.ServiceDescription" /> object for a given XML namespace and the applicable communication protocol.</para>
+        </returns>
         <param name="ns">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.ServiceDescription" /> instance obtained subsequently gets populated with objects that correspond to Web Services Description Language (WSDL) entities that are reflected from the input Web service class.</param>
       </Docs>
@@ -414,7 +417,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An implementation of the <see cref="M:System.Web.Services.Description.ProtocolReflector.ReflectMethod" /> method should generate information such as operation binding, abstract operation, and messages.</para>
@@ -423,6 +425,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, generates method-specific information that gets placed in a <see cref="T:System.Web.Services.Description.ServiceDescription" /> object corresponding to a binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Method-specific information that gets placed in a <see cref="T:System.Web.Services.Description.ServiceDescription" /> object corresponding to a binding.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -437,12 +443,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the name of the binding that a method belongs to.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the binding that a method belongs to.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ServiceCollection.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ServiceCollection.xml
index e6b92b2ec09..fc86f210143 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ServiceCollection.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ServiceCollection.xml
@@ -35,12 +35,15 @@
         <Parameter Name="service" Type="System.Web.Services.Description.Service" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Web.Services.Description.Service" /> to the end of the <see cref="T:System.Web.Services.Description.ServiceCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index where the <paramref name="service" /> parameter has been added.</para>
+        </returns>
         <param name="service">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.Service" /> instance to add to the collection. </param>
       </Docs>
@@ -59,12 +62,15 @@
         <Parameter Name="service" Type="System.Web.Services.Description.Service" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified <see cref="T:System.Web.Services.Description.Service" /> instance is a member of the <see cref="T:System.Web.Services.Description.ServiceCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="service" /> parameter is a member of the <see cref="T:System.Web.Services.Description.ServiceCollection" />; otherwise, false.</para>
+        </returns>
         <param name="service">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.Service" /> for which to check collection membership. </param>
       </Docs>
@@ -129,12 +135,15 @@
         <Parameter Name="service" Type="System.Web.Services.Description.Service" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified <see cref="T:System.Web.Services.Description.Service" /> and returns the zero-based index of the first occurrence within the ServiceCollection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer.</para>
+        </returns>
         <param name="service">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.Service" /> for which to search in the collection. </param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ServiceDescription.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ServiceDescription.xml
index bc94a571c72..ee6898895fc 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ServiceDescription.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ServiceDescription.xml
@@ -87,12 +87,15 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether an <see cref="T:System.Xml.XmlReader" /> represents a valid Web Services Description Language (WSDL) file that can be parsed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Xml.Serialization.XmlSerializer" /> can recognize the node on which the <see cref="T:System.Xml.XmlReader" /> is positioned; otherwise false.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlReader" /> </param>
       </Docs>
@@ -257,12 +260,15 @@
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Web.Services.Description.ServiceDescription" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes an instance of the <see cref="T:System.Web.Services.Description.ServiceDescription" /> class by directly loading the XML from a <see cref="T:System.IO.Stream" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the <see cref="T:System.Web.Services.Description.ServiceDescription" />.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IO.Stream" />, passed by reference, which contains the bytes to be read.</param>
       </Docs>
@@ -281,12 +287,15 @@
         <Parameter Name="textReader" Type="System.IO.TextReader" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Web.Services.Description.ServiceDescription" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes an instance of the <see cref="T:System.Web.Services.Description.ServiceDescription" /> class by directly loading the XML from a <see cref="T:System.IO.TextReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the <see cref="T:System.Web.Services.Description.ServiceDescription" />.</para>
+        </returns>
         <param name="textReader">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IO.TextReader" /> instance, passed by reference, which contains the text to be read. </param>
       </Docs>
@@ -305,12 +314,15 @@
         <Parameter Name="fileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ServiceDescription'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes an instance of a <see cref="T:System.Web.Services.Description.ServiceDescription" /> object by directly loading the XML from the specified file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the <see cref="T:System.Web.Services.Description.ServiceDescription" />.</para>
+        </returns>
         <param name="fileName">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to the file to be read. </param>
       </Docs>
@@ -329,12 +341,15 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Web.Services.Description.ServiceDescription" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes an instance of the <see cref="T:System.Web.Services.Description.ServiceDescription" /> class by directly loading the XML from an <see cref="T:System.Xml.XmlReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the <see cref="T:System.Web.Services.Description.ServiceDescription" />.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlReader" />, passed by reference, which contains the XML data to be read. </param>
       </Docs>
@@ -357,12 +372,15 @@
         <Parameter Name="validate" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes an instance of the <see cref="T:System.Web.Services.Description.ServiceDescription" /> class by directly loading the XML from a <see cref="T:System.IO.Stream" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the <see cref="T:System.Web.Services.Description.ServiceDescription" />.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IO.Stream" />, passed by reference, which contains the bytes to be read. </param>
         <param name="validate">
@@ -384,12 +402,15 @@
       </Parameters>
       <Docs>
         <param name="reader">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes an instance of the <see cref="T:System.Web.Services.Description.ServiceDescription" /> class by directly loading the XML from a <see cref="T:System.IO.TextReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the <see cref="T:System.Web.Services.Description.ServiceDescription" />.</para>
+        </returns>
         <param name="validate">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Boolean" /> that indicates whether the XML should be validated against the schema specified by <see cref="P:System.Web.Services.Description.ServiceDescription.Schema" />.</param>
       </Docs>
@@ -408,12 +429,15 @@
         <Parameter Name="validate" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes an instance of a <see cref="T:System.Web.Services.Description.ServiceDescription" /> object by directly loading the XML from the specified file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the <see cref="T:System.Web.Services.Description.ServiceDescription" />.</para>
+        </returns>
         <param name="fileName">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to the file to be read. </param>
         <param name="validate">
@@ -434,12 +458,15 @@
         <Parameter Name="validate" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes an instance of the <see cref="T:System.Web.Services.Description.ServiceDescription" /> class by directly loading the XML from an <see cref="T:System.Xml.XmlReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the <see cref="T:System.Web.Services.Description.ServiceDescription" />.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlReader" />, passed by reference, which contains the XML data to be read. </param>
         <param name="validate">
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ServiceDescriptionBaseCollection.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ServiceDescriptionBaseCollection.xml
index 44a3e0c43e7..eacaeb84909 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ServiceDescriptionBaseCollection.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ServiceDescriptionBaseCollection.xml
@@ -32,7 +32,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default implementation of this method is intended to be overridden by a derived class in order to return the name of the key associated with the <paramref name="value" /> parameter. The default implementation returns null (Nothing in Visual Basic). This protected method is accessible only through this class or a derived class.</para>
@@ -41,6 +40,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the key associated with the value passed by reference.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A null reference.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object for which to return the name of the key. </param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ServiceDescriptionCollection.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ServiceDescriptionCollection.xml
index b82e23d4cc0..49cdcd8ab9c 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ServiceDescriptionCollection.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ServiceDescriptionCollection.xml
@@ -49,12 +49,15 @@
         <Parameter Name="serviceDescription" Type="System.Web.Services.Description.ServiceDescription" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Web.Services.Description.ServiceDescription" /> to the end of the <see cref="T:System.Web.Services.Description.ServiceDescriptionCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index where the <see cref="T:System.Web.Services.Description.ServiceDescription" /> parameter has been added.</para>
+        </returns>
         <param name="serviceDescription">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.ServiceDescription" /> to add to the collection.</param>
       </Docs>
@@ -73,12 +76,15 @@
         <Parameter Name="serviceDescription" Type="System.Web.Services.Description.ServiceDescription" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified <see cref="T:System.Web.Services.Description.ServiceDescription" /> is a member of the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="serviceDescription" /> parameter is a member of the <see cref="T:System.Web.Services.Description.ServiceDescriptionCollection" />; otherwise, false.</para>
+        </returns>
         <param name="serviceDescription">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.ServiceDescription" /> for which to check collection membership.</param>
       </Docs>
@@ -123,12 +129,15 @@
         <Parameter Name="name" Type="System.Xml.XmlQualifiedName" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Web.Services.Description.Binding" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the <see cref="T:System.Web.Services.Description.ServiceDescriptionCollection" /> and returns the <see cref="T:System.Web.Services.Description.Binding" /> with the specified name that is a member of one of the <see cref="T:System.Web.Services.Description.ServiceDescription" /> instances contained in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The binding with the specified name.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlQualifiedName" /> whose <see cref="P:System.Xml.XmlQualifiedName.Name" /> property is used to retrieve a <see cref="T:System.Web.Services.Description.Binding" /> instance.</param>
       </Docs>
@@ -167,12 +176,15 @@
         <Parameter Name="name" Type="System.Xml.XmlQualifiedName" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Web.Services.Description.Message" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the <see cref="T:System.Web.Services.Description.ServiceDescriptionCollection" /> and returns the <see cref="T:System.Web.Services.Description.Message" /> with the specified name that is a member of one of the <see cref="T:System.Web.Services.Description.ServiceDescription" /> instances contained in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The message with the specified name.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlQualifiedName" />, passed by reference, whose <see cref="P:System.Xml.XmlQualifiedName.Name" /> property is shared by the <see cref="T:System.Web.Services.Description.Message" /> returned.</param>
       </Docs>
@@ -191,12 +203,15 @@
         <Parameter Name="name" Type="System.Xml.XmlQualifiedName" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Web.Services.Description.PortType" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the <see cref="T:System.Web.Services.Description.ServiceDescriptionCollection" /> and returns the <see cref="T:System.Web.Services.Description.PortType" /> with the specified name that is a member of one of the <see cref="T:System.Web.Services.Description.ServiceDescription" /> instances contained in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The PortType with the specified name.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlQualifiedName" />, passed by reference, whose <see cref="P:System.Xml.XmlQualifiedName.Name" /> property is shared by the <see cref="T:System.Web.Services.Description.PortType" /> returned.</param>
       </Docs>
@@ -215,12 +230,15 @@
         <Parameter Name="name" Type="System.Xml.XmlQualifiedName" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Web.Services.Description.Service" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the <see cref="T:System.Web.Services.Description.ServiceDescriptionCollection" /> and returns the <see cref="T:System.Web.Services.Description.Service" /> with the specified name that is a member of one of the <see cref="T:System.Web.Services.Description.ServiceDescription" /> instances contained in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The service with the specified name.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlQualifiedName" />, passed by reference, whose <see cref="P:System.Xml.XmlQualifiedName.Name" /> property is shared by the <see cref="T:System.Web.Services.Description.Service" /> returned.</param>
       </Docs>
@@ -239,12 +257,15 @@
         <Parameter Name="serviceDescription" Type="System.Web.Services.Description.ServiceDescription" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified <see cref="T:System.Web.Services.Description.ServiceDescription" /> and returns the zero-based index of the first occurrence within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the specified service description, or -1 if the element was not found in the collection.</para>
+        </returns>
         <param name="serviceDescription">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.ServiceDescription" /> for which to search in the collection.</param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ServiceDescriptionFormatExtensionCollection.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ServiceDescriptionFormatExtensionCollection.xml
index fddb54b6578..8d0a06635f1 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ServiceDescriptionFormatExtensionCollection.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ServiceDescriptionFormatExtensionCollection.xml
@@ -59,12 +59,15 @@
         <Parameter Name="extension" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Web.Services.Description.ServiceDescriptionFormatExtension" /> to the end of the <see cref="T:System.Web.Services.Description.ServiceDescriptionFormatExtensionCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index where the <see cref="T:System.Web.Services.Description.ServiceDescriptionFormatExtension" /> has been added.</para>
+        </returns>
         <param name="extension">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.ServiceDescriptionFormatExtension" />, passed by reference, to add to the <see cref="T:System.Web.Services.Description.ServiceDescriptionFormatExtensionCollection" />.</param>
       </Docs>
@@ -83,12 +86,15 @@
         <Parameter Name="extension" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified <see cref="T:System.Web.Services.Description.ServiceDescriptionFormatExtension" /> is a member of the <see cref="T:System.Web.Services.Description.ServiceDescriptionFormatExtensionCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.Services.Description.ServiceDescriptionFormatExtension" /> is a member of the collection; otherwise, false.</para>
+        </returns>
         <param name="extension">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.ServiceDescriptionFormatExtension" /> for which to check collection membership.</param>
       </Docs>
@@ -133,7 +139,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method searches the collection in index order, and returns only the matching element with the lowest-numbered index.</para>
@@ -142,6 +147,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the <see cref="T:System.Web.Services.Description.ServiceDescriptionFormatExtensionCollection" /> and returns the first element of the specified derived <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If the search is successful, an object of the specified <see cref="T:System.Type" />; otherwise, null.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> for which to search the collection.</param>
       </Docs>
@@ -161,7 +170,6 @@
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Xml.XmlElement" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method searches the collection in index order, and returns the first <see cref="T:System.Xml.XmlElement" /> that meets the criteria of the two parameters.</para>
@@ -170,6 +178,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the <see cref="T:System.Web.Services.Description.ServiceDescriptionFormatExtensionCollection" /> for a member with the specified name and namespace URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If the search is successful, an <see cref="T:System.Xml.XmlElement" />; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Xml.XmlElement" /> to be found.</param>
         <param name="ns">
@@ -190,7 +202,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -201,6 +212,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the <see cref="T:System.Web.Services.Description.ServiceDescriptionFormatExtensionCollection" /> and returns an array of all elements of the specified <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Object" /> instances representing all collection members of the specified type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> for which to search the collection.</param>
       </Docs>
@@ -220,7 +235,6 @@
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Xml.XmlElement[]" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -231,6 +245,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the <see cref="T:System.Web.Services.Description.ServiceDescriptionFormatExtensionCollection" /> and returns an array of all members with the specified name and namespace URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Xml.XmlElement" /> instances.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The XML name attribute of the <see cref="T:System.Xml.XmlElement" /> objects to be found.</param>
         <param name="ns">
@@ -251,12 +269,15 @@
         <Parameter Name="extension" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified <see cref="T:System.Web.Services.Description.ServiceDescriptionFormatExtension" /> and returns the zero-based index of the first instance with the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the specified <see cref="T:System.Web.Services.Description.ServiceDescriptionFormatExtension" />, or -1 if the element was not found in the collection.</para>
+        </returns>
         <param name="extension">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Description.ServiceDescriptionFormatExtension" /> for which to search in the collection.</param>
       </Docs>
@@ -306,7 +327,6 @@
         <Parameter Name="item" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method checks whether the <paramref name="item" /> parameter is an <see cref="T:System.Xml.XmlElement" /> or a <see cref="T:System.Web.Services.Description.ServiceDescriptionFormatExtension" /> (or a derived class) before determining whether it is supported by the XML Web service.</para>
@@ -315,6 +335,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified object is used by the import process when the extensibility element is imported into the XML Web service.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="item" /> parameter is used; otherwise, false.</para>
+        </returns>
         <param name="item">
           <attribution license="cc4" from="Microsoft" modified="false" />An object, either of type <see cref="T:System.Xml.XmlElement" /> or <see cref="T:System.Web.Services.Description.ServiceDescriptionFormatExtension" /> to check for use by the import process.</param>
       </Docs>
@@ -333,12 +357,15 @@
         <Parameter Name="item" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified object is necessary for the operation of the XML Web service.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="item" /> parameter is required; otherwise, false.</para>
+        </returns>
         <param name="item">
           <attribution license="cc4" from="Microsoft" modified="false" />An object, either of type <see cref="T:System.Xml.XmlElement" /> or <see cref="T:System.Web.Services.Description.ServiceDescriptionFormatExtension" />, to check whether it is necessary.</param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ServiceDescriptionImporter.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ServiceDescriptionImporter.xml
index e592d49626f..203a84a7d51 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ServiceDescriptionImporter.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/ServiceDescriptionImporter.xml
@@ -143,7 +143,6 @@
       </Parameters>
       <Docs>
         <param name="codeGenerator">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The services description document collection in each <see cref="T:System.Web.Services.Description.WebReference" /> member of the <paramref name="webReferences" /> collection should contain only <see cref="T:System.Web.Services.Description.ServiceDescription" /> and <see cref="T:System.Xml.Schema.XmlSchema" /> objects. This method is unable to interpret <see cref="T:System.Web.Services.Discovery.DiscoveryDocument" /> objects.</para>
@@ -153,6 +152,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compiles a collection of Web references to produce a client proxy or a server stub.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.Specialized.StringCollection" /> of compiler warnings.</para>
+        </returns>
         <param name="webReferences">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.Services.Description.WebReferenceCollection" /> of Web references to compile.</param>
         <param name="codeCompileUnit">
@@ -172,7 +175,6 @@
         <Parameter Name="codeCompileUnit" Type="System.CodeDom.CodeCompileUnit" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Web.Services.Description.ServiceDescriptionImportWarnings" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>After you have specified the <see cref="P:System.Web.Services.Description.ServiceDescriptionImporter.ServiceDescriptions" /> values to import and the <see cref="P:System.Web.Services.Description.ServiceDescriptionImporter.Style" /> property of the code to generate, call the <see cref="T:System.Web.Services.Description.Import" /> method to initiate code generation.</para>
@@ -181,6 +183,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Imports the specified <see cref="P:System.Web.Services.Description.ServiceDescriptionImporter.ServiceDescriptions" /> values, that generates code as specified by the <see cref="P:System.Web.Services.Description.ServiceDescriptionImporter.Style" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Services.Description.ServiceDescriptionImportWarnings" /> value that describes any error that occurred; or 0 if no error occurred.</para>
+        </returns>
         <param name="codeNamespace">
           <attribution license="cc4" from="Microsoft" modified="false" />The namespace into which the <see cref="P:System.Web.Services.Description.ServiceDescriptionImporter.ServiceDescriptions" /> values are imported. </param>
         <param name="codeCompileUnit">
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/SoapProtocolImporter.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/SoapProtocolImporter.xml
index 811b89fa92e..84f83910f5c 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/SoapProtocolImporter.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/SoapProtocolImporter.xml
@@ -50,7 +50,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.CodeDom.CodeTypeDeclaration" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>During generation of a class for a given binding, the <see cref="M:System.Web.Services.Description.SoapProtocolImporter.BeginClass" /> method executes before the <see cref="T:System.Web.Services.Description.SoapProtocolImporter" /> class generates methods that correspond to operations.</para>
@@ -59,6 +58,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes the generation of a binding class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A binding class.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -139,7 +142,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.CodeDom.CodeMemberMethod" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>During generation of a class for a given binding, the <see cref="M:System.Web.Services.Description.SoapProtocolImporter.GenerateMethod" /> method executes for each binding class method that represents an operation.</para>
@@ -148,6 +150,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates method code for a binding class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The method code for a binding class.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -162,7 +168,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.Services.Description.SoapProtocolImporter.IsBindingSupported" /> method determines whether to generate a class for the current binding, as represented by the <see cref="P:System.Web.Services.Description.SoapProtocolImporter.Binding" /> property. The method checks whether the <see cref="P:System.Web.Services.Description.SoapProtocolImporter.Binding" /> property's <see cref="P:System.Web.Services.Description.Binding.Extensions" /> property contains a <see cref="T:System.Web.Services.Description.SoapBinding" /> instance. In addition, the transport mechanism obtained through the <see cref="P:System.Web.Services.Description.SoapBinding.Transport" /> property must be supported by the current Web services configuration.</para>
@@ -171,6 +176,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a class can be generated for the current binding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the class can be generated for the current binding; otherwise false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -187,7 +196,6 @@
         <Parameter Name="flow" Type="System.Web.Services.Description.OperationFlow" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.Services.Description.SoapProtocolImporter.IsOperationFlowSupported(System.Web.Services.Description.OperationFlow)" /> method determines whether to generate a method for the current operation, as represented by the <see cref="T:System.Web.Services.Description.Operation" /> property. This evaluation takes place for each operation in a binding for which a class is being generated. If a false value is returned, the <see cref="M:System.Web.Services.Description.SoapProtocolImporter.UnsupportedOperationWarning(System.String)" /> method executes. A true value is returned only if the input value is <see cref="F:System.Web.Services.Description.OperationFlow.OneWay" /> or <see cref="F:System.Web.Services.Description.OperationFlow.RequestResponse" />.</para>
@@ -197,6 +205,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current operation's operation flow is supported.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current operation's operation flow is supported; otherwise false.</para>
+        </returns>
         <param name="flow">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Web.Services.Description.OperationFlow" /> enumeration value that represents a transmission pattern.</param>
       </Docs>
@@ -219,12 +231,15 @@
         <Parameter Name="uriList" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks for the presence of "http://schemas.xmlsoap.org/soap/encoding/" in a string that represents a list of Uniform Resource Indicators (URIs).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true it the string contains <see cref="http://schemas.xmlsoap.org/soap/encoding/">http://schemas.xmlsoap.org/soap/encoding/</see>; otherwise false.</para>
+        </returns>
         <param name="uriList">
           <attribution license="cc4" from="Microsoft" modified="false" />A space-delimited list of URIs.</param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/SoapTransportImporter.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/SoapTransportImporter.xml
index f892c4a14f7..374e86bb8df 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/SoapTransportImporter.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/SoapTransportImporter.xml
@@ -96,12 +96,15 @@
         <Parameter Name="transport" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, this method determines whether the specified transport protocol is supported by the XML Web service.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the transport protocol is supported; otherwise, false.</para>
+        </returns>
         <param name="transport">
           <attribution license="cc4" from="Microsoft" modified="false" />A URI representing the transport protocol to be checked. </param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/WebReferenceCollection.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/WebReferenceCollection.xml
index a2af4404bde..f66140c450e 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/WebReferenceCollection.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/WebReferenceCollection.xml
@@ -47,7 +47,6 @@
         <Parameter Name="webReference" Type="System.Web.Services.Description.WebReference" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -57,6 +56,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends a <see cref="T:System.Web.Services.Description.WebReference" /> instance to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the appended Web reference.</para>
+        </returns>
         <param name="webReference">
           <attribution license="cc4" from="Microsoft" modified="false" />The Web reference to append.</param>
       </Docs>
@@ -74,13 +77,16 @@
         <Parameter Name="webReference" Type="System.Web.Services.Description.WebReference" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the collection contains a given <see cref="T:System.Web.Services.Description.WebReference" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collections contains the given Web reference instance; otherwise, false.</para>
+        </returns>
         <param name="webReference">
           <attribution license="cc4" from="Microsoft" modified="false" />The Web reference to search for.</param>
       </Docs>
@@ -127,7 +133,6 @@
         <Parameter Name="webReference" Type="System.Web.Services.Description.WebReference" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -137,6 +142,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of the specified <see cref="T:System.Web.Services.Description.WebReference" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified Web reference, or -1 if the collection does not contain the specified Web reference.</para>
+        </returns>
         <param name="webReference">
           <attribution license="cc4" from="Microsoft" modified="false" />The Web reference to search for.</param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/WebReferenceOptions.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/WebReferenceOptions.xml
index cfa56c7fa23..763ab2dfe69 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/WebReferenceOptions.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/WebReferenceOptions.xml
@@ -80,13 +80,16 @@
         <Parameter Name="validationEventHandler" Type="System.Xml.Schema.ValidationEventHandler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new instance of <see cref="T:System.Web.Services.Description.WebReferenceOptions" /> based on the code generation options described in the specified stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.Web.Services.Description.WebReferenceOptions" /> based on the code generation options described in the specified stream.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.Stream" /> that contains the code generation options.</param>
         <param name="validationEventHandler">
@@ -107,13 +110,16 @@
         <Parameter Name="validationEventHandler" Type="System.Xml.Schema.ValidationEventHandler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new instance of <see cref="T:System.Web.Services.Description.WebReferenceOptions" /> based on the code generation options described in the specified <see cref="T:System.IO.TextReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.Web.Services.Description.WebReferenceOptions" /> based on the code generation options described in the specified <see cref="T:System.IO.TextReader" />.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.TextReader" /> that contains the code generation options.</param>
         <param name="validationEventHandler">
@@ -134,13 +140,16 @@
         <Parameter Name="validationEventHandler" Type="System.Xml.Schema.ValidationEventHandler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new instance of <see cref="T:System.Web.Services.Description.WebReferenceOptions" /> based on the code generation options described in the specified <see cref="T:System.Xml.XmlReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.Web.Services.Description.WebReferenceOptions" /> based on the code generation options described in the specified <see cref="T:System.Xml.XmlReader" />.</para>
+        </returns>
         <param name="xmlReader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> that contains the code generation options.</param>
         <param name="validationEventHandler">
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/WebServicesInteroperability.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/WebServicesInteroperability.xml
index cb6fa0a5964..3c05703c322 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/WebServicesInteroperability.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Description/WebServicesInteroperability.xml
@@ -34,7 +34,6 @@
       </Parameters>
       <Docs>
         <param name="service">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -44,6 +43,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies whether a given Web service or services conforms to a given WS-I specification, and provides a list of any violations that it finds.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the Web service described by <paramref name="description" /> conforms to the Web services interoperability specification indicated by <paramref name="claims" />; otherwise false.</para>
+        </returns>
         <param name="claims">
           <attribution license="cc4" from="Microsoft" modified="false" />A member of <see cref="T:System.Web.Services.WsiProfiles" /> that indicates a Web services interoperability specification.</param>
         <param name="violations">
@@ -66,7 +69,6 @@
       </Parameters>
       <Docs>
         <param name="services">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -76,6 +78,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies whether a given Web service or services conforms to a given WS-I specification, and provides a list of any violations that it finds.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the Web service descriptions contained in <paramref name="descriptions" /> conform to the Web services interoperability specification indicated by <paramref name="claims" />; false otherwise.</para>
+        </returns>
         <param name="claims">
           <attribution license="cc4" from="Microsoft" modified="false" />A member of <see cref="T:System.Web.Services.WsiProfiles" /> that indicates a Web services interoperability specification.</param>
         <param name="violations">
@@ -97,7 +103,6 @@
         <Parameter Name="violations" Type="System.Web.Services.Description.BasicProfileViolationCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -107,6 +112,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies whether a given Web service or services conforms to a given WS-I specification, and provides a list of any violations that it finds.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the Web service described by <paramref name="webReference" /> conforms to the Web services interoperability specification indicated by <paramref name="claims" />; false otherwise.</para>
+        </returns>
         <param name="claims">
           <attribution license="cc4" from="Microsoft" modified="false" />A member of <see cref="T:System.Web.Services.WsiProfiles" /> that indicates a Web services interoperability specification.</param>
         <param name="webReference">
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/ContractReference.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/ContractReference.xml
index 9e1e267414d..085775ad206 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/ContractReference.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/ContractReference.xml
@@ -289,12 +289,15 @@
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the service description from the passed <see cref="T:System.IO.Stream" /> and returns the service description.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Services.Description.ServiceDescription" /> containing the contents of the referenced service description.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.IO.Stream" /> containing the service description. </param>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/ContractSearchPattern.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/ContractSearchPattern.xml
index 4e5091bd5ac..2d12e7afd86 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/ContractSearchPattern.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/ContractSearchPattern.xml
@@ -51,7 +51,6 @@
         <Parameter Name="filename" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Web.Services.Discovery.DiscoveryReference" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The concrete <see cref="T:System.Web.Services.Discovery.ContractReference" /> class inherits from the abstract <see cref="T:System.Web.Services.Discovery.DiscoveryReference" /> class. </para>
@@ -61,6 +60,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the <see cref="T:System.Web.Services.Discovery.ContractReference" /> object for the specified .asmx file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Services.Discovery.ContractReference" /> object with the specified file name for its .asmx file.</para>
+        </returns>
         <param name="filename">
           <attribution license="cc4" from="Microsoft" modified="false" />The file-system path of the Web service's .asmx file.</param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryClientDocumentCollection.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryClientDocumentCollection.xml
index 5abb06168af..970dc03abf7 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryClientDocumentCollection.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryClientDocumentCollection.xml
@@ -78,12 +78,15 @@
         <Parameter Name="url" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the <see cref="T:System.Web.Services.Discovery.DiscoveryClientDocumentCollection" /> contains an object with the specified URL.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.Services.Discovery.DiscoveryClientDocumentCollection" /> contains an object with the specified URL; otherwise, false.</para>
+        </returns>
         <param name="url">
           <attribution license="cc4" from="Microsoft" modified="false" />The URL for the document to locate within the <see cref="T:System.Web.Services.Discovery.DiscoveryClientDocumentCollection" />. </param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryClientProtocol.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryClientProtocol.xml
index ec0110f23be..048c522b41e 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryClientProtocol.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryClientProtocol.xml
@@ -77,7 +77,6 @@
         <Parameter Name="url" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DiscoveryDocument'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.Services.Discovery.DiscoveryClientProtocol.Discover(System.String)" /> method expects that the supplied URL is a discovery document. If the URL refers to a service description or an XML schema an exception is thrown. To discover an XML schema or a service description invoke the <see cref="M:System.Web.Services.Discovery.DiscoveryClientProtocol.DiscoverAny(System.String)" /> method.</para>
@@ -87,6 +86,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Discovers the supplied URL to determine if it is a discovery document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Services.Discovery.DiscoveryDocument" /> containing the results of XML Web services discovery at the supplied URL.</para>
+        </returns>
         <param name="url">
           <attribution license="cc4" from="Microsoft" modified="false" />The URL where XML Web services discovery begins. </param>
       </Docs>
@@ -105,7 +108,6 @@
         <Parameter Name="url" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DiscoveryDocument'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.Services.Discovery.DiscoveryClientProtocol.DiscoverAny(System.String)" /> method discovers whether the supplied URL is a discovery document, service description or XSD schema. If it is known that the URL only refers to a discovery document, the <see cref="M:System.Web.Services.Discovery.DiscoveryClientProtocol.Discover(System.String)" /> method might be invoked.</para>
@@ -115,6 +117,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Discovers the supplied URL to determine if it is a discovery document, service description or an XML Schema Definition (XSD) schema.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Services.Discovery.DiscoveryDocument" /> containing the results of XML Web services discovery at the supplied URL. If the <paramref name="url" /> parameter refers to a service description or an XSD Schema, a <see cref="T:System.Web.Services.Discovery.DiscoveryDocument" /> is created in memory for it.</para>
+        </returns>
         <param name="url">
           <attribution license="cc4" from="Microsoft" modified="false" />The URL where XML Web services discovery begins. </param>
       </Docs>
@@ -246,7 +252,6 @@
         <Parameter Name="topLevelFilename" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DiscoveryClientResultCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A file containing a map of saved discovery documents can be created by the <see cref="M:System.Web.Services.Discovery.DiscoveryClientProtocol.WriteAll(System.String,System.String)" /> method or Disco.exe.</para>
@@ -256,6 +261,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads in a file containing a map of saved discovery documents populating the <see cref="P:System.Web.Services.Discovery.DiscoveryClientProtocol.Documents" /> and <see cref="P:System.Web.Services.Discovery.DiscoveryClientProtocol.References" /> properties, with discovery documents, XML Schema Definition (XSD) schemas, and service descriptions referenced in the file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Services.Discovery.DiscoveryClientResultCollection" /> containing the results found in the file with the map of saved discovery documents. The file format is a <see cref="T:System.Web.Services.Discovery.DiscoveryClientProtocol.DiscoveryClientResultsFile" /> class serialized into XML; however, one would typically create the file using only the <see cref="M:System.Web.Services.Discovery.DiscoveryClientProtocol.WriteAll(System.String,System.String)" /> method or Disco.exe.</para>
+        </returns>
         <param name="topLevelFilename">
           <attribution license="cc4" from="Microsoft" modified="false" />Name of file to read in, containing the map of saved discovery documents. </param>
       </Docs>
@@ -345,7 +354,6 @@
         <Parameter Name="topLevelFilename" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DiscoveryClientResultCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The file created with the name of the <paramref name="topLevelFilename" /> parameter in the directory specified by the directory parameter contains a map of saved discovery documents, XML Schema Definition (XSD) schemas and service descriptions. This file can be read in using the <see cref="M:System.Web.Services.Discovery.DiscoveryClientProtocol.ReadAll(System.String)" /> method to populate the <see cref="P:System.Web.Services.Discovery.DiscoveryClientProtocol.References" /> and <see cref="P:System.Web.Services.Discovery.DiscoveryClientProtocol.Documents" /> properties. The format of the file is XML containing an serialized version of the <see cref="T:System.Web.Services.Discovery.DiscoveryClientProtocol.DiscoveryClientResultsFile" /> class.</para>
@@ -355,6 +363,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes all discovery documents, XML Schema Definition (XSD) schemas, and Service Descriptions in the <see cref="P:System.Web.Services.Discovery.DiscoveryClientProtocol.Documents" /> property to the supplied directory and creates a file in that directory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Services.Discovery.DiscoveryClientResultCollection" /> containing the results of all files saved.</para>
+        </returns>
         <param name="directory">
           <attribution license="cc4" from="Microsoft" modified="false" />The directory in which to save all documents currently in the <see cref="P:System.Web.Services.Discovery.DiscoveryClientProtocol.Documents" /> property. </param>
         <param name="topLevelFilename">
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryClientReferenceCollection.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryClientReferenceCollection.xml
index 4c58fd0d8ff..8d79149fbba 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryClientReferenceCollection.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryClientReferenceCollection.xml
@@ -101,12 +101,15 @@
         <Parameter Name="url" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the <see cref="T:System.Web.Services.Discovery.DiscoveryClientReferenceCollection" /> contains a <see cref="T:System.Web.Services.Discovery.DiscoveryReference" /> with the specified URL.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.Services.Discovery.DiscoveryClientReferenceCollection" /> contains a <see cref="T:System.Web.Services.Discovery.DiscoveryReference" /> with the specified URL; otherwise, false.</para>
+        </returns>
         <param name="url">
           <attribution license="cc4" from="Microsoft" modified="false" />The URL for the <see cref="T:System.Web.Services.Discovery.DiscoveryReference" /> to locate within the <see cref="T:System.Web.Services.Discovery.DiscoveryClientReferenceCollection" />. </param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryClientResultCollection.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryClientResultCollection.xml
index 40786fae9de..ddf4cd85f45 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryClientResultCollection.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryClientResultCollection.xml
@@ -49,12 +49,15 @@
         <Parameter Name="value" Type="System.Web.Services.Discovery.DiscoveryClientResult" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Web.Services.Discovery.DiscoveryClientResult" /> to the <see cref="T:System.Web.Services.Discovery.DiscoveryClientResultCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position into which the <see cref="T:System.Web.Services.Discovery.DiscoveryClientResult" /> was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Discovery.DiscoveryClientResult" /> to add to the <see cref="T:System.Web.Services.Discovery.DiscoveryClientResultCollection" />. </param>
       </Docs>
@@ -73,12 +76,15 @@
         <Parameter Name="value" Type="System.Web.Services.Discovery.DiscoveryClientResult" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Web.Services.Discovery.DiscoveryClientResultCollection" /> contains a specific <see cref="T:System.Web.Services.Discovery.DiscoveryClientResult" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.Services.Discovery.DiscoveryClientResult" /> is found in the <see cref="T:System.Web.Services.Discovery.DiscoveryClientResultCollection" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Discovery.DiscoveryClientResult" /> to locate in the <see cref="T:System.Web.Services.Discovery.DiscoveryClientResultCollection" />. </param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryDocument.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryDocument.xml
index 8f874e3cc76..b76e04d18cd 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryDocument.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryDocument.xml
@@ -56,12 +56,15 @@
         <Parameter Name="xmlReader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the passed <see cref="T:System.Xml.XmlReader" /> can be deserialized into a <see cref="T:System.Web.Services.Discovery.DiscoveryDocument" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <see cref="T:System.Xml.XmlReader" /> can be deserialized into a <see cref="T:System.Web.Services.Discovery.DiscoveryDocument" />; otherwise, false.</para>
+        </returns>
         <param name="xmlReader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> that is tested whether it can be deserialized into a <see cref="T:System.Web.Services.Discovery.DiscoveryDocument" />. </param>
       </Docs>
@@ -102,12 +105,15 @@
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Web.Services.Discovery.DiscoveryDocument" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads and returns a <see cref="T:System.Web.Services.Discovery.DiscoveryDocument" /> from the passed <see cref="T:System.IO.Stream" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Services.Discovery.DiscoveryDocument" /> containing the contents of a discovery document from the passed <see cref="T:System.IO.Stream" />.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.Stream" /> from which to read the <see cref="T:System.Web.Services.Discovery.DiscoveryDocument" />. </param>
       </Docs>
@@ -127,12 +133,15 @@
       </Parameters>
       <Docs>
         <param name="textReader">a <see cref="T:System.IO.TextReader" /></param>
-        <returns>a <see cref="T:System.Web.Services.Discovery.DiscoveryDocument" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads and returns a <see cref="T:System.Web.Services.Discovery.DiscoveryDocument" /> from the passed <see cref="T:System.IO.TextReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Services.Discovery.DiscoveryDocument" /> containing the contents of a discovery document from the passed <see cref="T:System.IO.TextReader" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -149,12 +158,15 @@
         <Parameter Name="xmlReader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Web.Services.Discovery.DiscoveryDocument" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads and returns a <see cref="T:System.Web.Services.Discovery.DiscoveryDocument" /> from the passed <see cref="T:System.Xml.XmlReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Services.Discovery.DiscoveryDocument" /> containing the contents of a discovery document from the passed <see cref="T:System.Xml.XmlReader" />.</para>
+        </returns>
         <param name="xmlReader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> from which to read the <see cref="T:System.Web.Services.Discovery.DiscoveryDocument" />. </param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryDocumentLinksPattern.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryDocumentLinksPattern.xml
index 0292486710e..a148e88663a 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryDocumentLinksPattern.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryDocumentLinksPattern.xml
@@ -51,7 +51,6 @@
         <Parameter Name="filename" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Web.Services.Discovery.DiscoveryReference" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The concrete <see cref="T:System.Web.Services.Discovery.DiscoveryDocumentReference" /> class inherits from the abstract <see cref="T:System.Web.Services.Discovery.DiscoveryReference" /> class. </para>
@@ -61,6 +60,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Web.Services.Discovery.DiscoveryDocumentReference" /> object for a given discovery document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Services.Discovery.DiscoveryDocumentReference" /> object that specifies the location of a .vsdisco file.</para>
+        </returns>
         <param name="filename">
           <attribution license="cc4" from="Microsoft" modified="false" />The file-system path of the discovery document.</param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryDocumentReference.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryDocumentReference.xml
index fe19cb37633..c756e7a0290 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryDocumentReference.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryDocumentReference.xml
@@ -129,12 +129,15 @@
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads and returns the discovery document from the passed <see cref="T:System.IO.Stream" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Services.Discovery.DiscoveryDocument" /> containing the contents of the referenced discovery document.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.IO.Stream" /> containing the discovery document. </param>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryDocumentSearchPattern.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryDocumentSearchPattern.xml
index 18ea5a4d790..5ab8d32dba2 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryDocumentSearchPattern.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryDocumentSearchPattern.xml
@@ -51,7 +51,6 @@
         <Parameter Name="filename" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Web.Services.Discovery.DiscoveryReference" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The concrete <see cref="T:System.Web.Services.Discovery.DiscoveryDocumentReference" /> class inherits from the abstract <see cref="T:System.Web.Services.Discovery.DiscoveryReference" /> class. </para>
@@ -61,6 +60,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Web.Services.Discovery.DiscoveryDocumentReference" /> object for a given discovery document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Services.Discovery.DiscoveryDocumentReference" /> object that specifies the location of a .vsdisco file.</para>
+        </returns>
         <param name="filename">
           <attribution license="cc4" from="Microsoft" modified="false" />The file system path of the discovery document.</param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryExceptionDictionary.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryExceptionDictionary.xml
index 0af9f77031a..166bd5de6e0 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryExceptionDictionary.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryExceptionDictionary.xml
@@ -78,12 +78,15 @@
         <Parameter Name="url" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Web.Services.Discovery.DiscoveryExceptionDictionary" /> contains an <see cref="T:System.Exception" /> with the specified URL.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.Services.Discovery.DiscoveryExceptionDictionary" /> contains an <see cref="T:System.Exception" /> with the specified URL; otherwise, false.</para>
+        </returns>
         <param name="url">
           <attribution license="cc4" from="Microsoft" modified="false" />The URL of the <see cref="T:System.Exception" /> to locate within the <see cref="T:System.Web.Services.Discovery.DiscoveryExceptionDictionary" />. </param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryReference.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryReference.xml
index 9ad904282fd..bedd011497c 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryReference.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryReference.xml
@@ -101,12 +101,15 @@
         <Parameter Name="url" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a file name based on the passed URL.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Name of the file based on the passed URL.</para>
+        </returns>
         <param name="url">
           <attribution license="cc4" from="Microsoft" modified="false" />The URL on which the name of the file is based. </param>
       </Docs>
@@ -125,7 +128,6 @@
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is always an <see cref="T:System.Object" />. However, the underlying type varies, depending on the type of document referenced. For instance, a <see cref="T:System.IO.Stream" /> passed into <see cref="M:System.Web.Services.Discovery.SchemaReference.ReadDocument(System.IO.Stream)" /> returns an instance of <see cref="T:System.Xml.Schema.XmlSchema" />.</para>
@@ -134,6 +136,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the passed <see cref="T:System.IO.Stream" /> and returns an instance of the class representing the type of referenced document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> with an underlying type matching the type of referenced document.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.IO.Stream" /> containing the reference document. </param>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryReferenceCollection.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryReferenceCollection.xml
index 4476e7650f0..51c4c7e820a 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryReferenceCollection.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoveryReferenceCollection.xml
@@ -49,12 +49,15 @@
         <Parameter Name="value" Type="System.Web.Services.Discovery.DiscoveryReference" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Web.Services.Discovery.DiscoveryReference" /> to the <see cref="T:System.Web.Services.Discovery.DiscoveryReferenceCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position where the <see cref="T:System.Web.Services.Discovery.DiscoveryReference" /> was inserted in the <see cref="T:System.Web.Services.Discovery.DiscoveryReferenceCollection" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Discovery.DiscoveryReference" /> to add to the <see cref="T:System.Web.Services.Discovery.DiscoveryReferenceCollection" />. </param>
       </Docs>
@@ -73,12 +76,15 @@
         <Parameter Name="value" Type="System.Web.Services.Discovery.DiscoveryReference" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Web.Services.Discovery.DiscoveryReferenceCollection" /> contains a specific <see cref="T:System.Web.Services.Discovery.DiscoveryReference" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.Services.Discovery.DiscoveryReferenceCollection" /> contains the <see cref="T:System.Web.Services.Discovery.DiscoveryReference" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Discovery.DiscoveryReference" /> to locate within the <see cref="T:System.Web.Services.Discovery.DiscoveryReferenceCollection" />. </param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoverySearchPattern.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoverySearchPattern.xml
index 7a1830745dc..4c38bc6399a 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoverySearchPattern.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DiscoverySearchPattern.xml
@@ -52,7 +52,6 @@
         <Parameter Name="filename" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DiscoveryReference'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A class derived from <see cref="T:System.Web.Services.Discovery.DiscoverySearchPattern" /> implements the <see cref="M:System.Web.Services.Discovery.DiscoverySearchPattern.GetDiscoveryReference(System.String)" /> method by returning its associated concrete class derived from <see cref="T:System.Web.Services.Discovery.DiscoveryReference" />. </para>
@@ -62,6 +61,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the <see cref="T:System.Web.Services.Discovery.DiscoveryReference" /> object for a given file name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A file name.</para>
+        </returns>
         <param name="filename">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a discovery file or a file that appears in a dynamically generated discovery document. For example, an .asmx or .xsd file.</param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DynamicDiscoveryDocument.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DynamicDiscoveryDocument.xml
index 9d4aad5f6e7..d5d71139346 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DynamicDiscoveryDocument.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/DynamicDiscoveryDocument.xml
@@ -85,7 +85,6 @@
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Web.Services.Discovery.DynamicDiscoveryDocument" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This static method takes an XML document, represented as a <see cref="T:System.IO.Stream" />, and converts in to a <see cref="T:System.Web.Services.Discovery.DynamicDiscoveryDocument" /> .</para>
@@ -94,6 +93,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes an XML document into a <see cref="T:System.Web.Services.Discovery.DynamicDiscoveryDocument" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.Services.Discovery.DynamicDiscoveryDocument" /> that was loaded.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IO.Stream" /> object from which the XML dynamic discovery document is deserialized.</param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/SchemaReference.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/SchemaReference.xml
index e5b092bc289..2207fba3405 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/SchemaReference.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/SchemaReference.xml
@@ -124,12 +124,15 @@
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads and returns the XSD schema from the passed <see cref="T:System.IO.Stream" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Schema.XmlSchema" /> containing the contents of the referenced XSD schema.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.IO.Stream" /> containing the XSD schema. </param>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/XmlSchemaSearchPattern.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/XmlSchemaSearchPattern.xml
index a1aa6c69ad4..5800f7caa81 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/XmlSchemaSearchPattern.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Discovery/XmlSchemaSearchPattern.xml
@@ -51,7 +51,6 @@
         <Parameter Name="filename" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Web.Services.Discovery.DiscoveryReference" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The concrete <see cref="T:System.Web.Services.Discovery.SchemaReference" /> class inherits from the abstract <see cref="T:System.Web.Services.Discovery.DiscoveryReference" /> class. </para>
@@ -61,6 +60,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Web.Services.Discovery.SchemaReference" /> object for a given discovery document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Services.Discovery.SchemaReference" /> object that specifies the file name for an XML Schema document.</para>
+        </returns>
         <param name="filename">
           <attribution license="cc4" from="Microsoft" modified="false" />The file system path of the XML Schema document.</param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/AnyReturnReader.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/AnyReturnReader.xml
index f2c3a0e52bf..128e3f40c75 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/AnyReturnReader.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/AnyReturnReader.xml
@@ -53,7 +53,6 @@
         <Parameter Name="methodInfo" Type="System.Web.Services.Protocols.LogicalMethodInfo" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An initializer is an object passed as a parameter to the <see cref="M:System.Web.Services.Protocols.AnyReturnReader.Initialize(System.Object)" /> method. For the <see cref="T:System.Web.Services.Protocols.AnyReturnReader" /> class, the initializer is the instance referred to by the keyword this, unless the <see cref="T:System.Web.Services.Protocols.LogicalMethodInfo" /> parameter value has a void return type, in which case the initializer is set to null.</para>
@@ -63,6 +62,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the parameter passed to the <see cref="M:System.Web.Services.Protocols.AnyReturnReader.Initialize(System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The parameter passed to the <see cref="M:System.Web.Services.Protocols.AnyReturnReader.Initialize(System.Object)" /> method.</para>
+        </returns>
         <param name="methodInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.Services.Protocols.LogicalMethodInfo" />  that indicates the Web method for which the initializer is obtained.</param>
       </Docs>
@@ -109,7 +112,6 @@
         <Parameter Name="responseStream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Web.Services.Protocols.AnyReturnReader" /> class's implementation of the <see cref="M:System.Web.Services.Protocols.AnyReturnReader.Read(System.Net.WebResponse,System.IO.Stream)" /> method does no reading. Instead it simply returns the <see cref="T:System.IO.Stream" /> object passed as a parameter.</para>
@@ -118,6 +120,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the input HTTP response stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The input HTTP response stream.</para>
+        </returns>
         <param name="response">
           <attribution license="cc4" from="Microsoft" modified="false" />A representation of the HTTP response sent by a Web service, containing the output message for an operation.</param>
         <param name="responseStream">
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/HtmlFormParameterReader.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/HtmlFormParameterReader.xml
index 9f31b143c1d..f80eac1596b 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/HtmlFormParameterReader.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/HtmlFormParameterReader.xml
@@ -53,7 +53,6 @@
         <Parameter Name="request" Type="System.Web.HttpRequest" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object[]" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.Services.Protocols.HtmlFormParameterReader.Read(System.Web.HttpRequest)" /> method uses the content of the <see cref="T:System.Web.HttpRequest" /> object's <see cref="P:System.Web.HttpRequest.Form" /> property.</para>
@@ -62,6 +61,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads name-value pairs into Web method parameter values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of objects contain the name-value pairs.</para>
+        </returns>
         <param name="request">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Web.HttpRequest" /> object containing HTML name-value pairs encoded in the body of an HTTP request.</param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/HttpGetClientProtocol.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/HttpGetClientProtocol.xml
index bbf096918a1..8a0a23a1fc1 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/HttpGetClientProtocol.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/HttpGetClientProtocol.xml
@@ -56,7 +56,6 @@
         <Parameter Name="uri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Net.WebRequest" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method overrides the base version of <see cref="M:System.Web.Services.Protocols.WebClientProtocol.GetWebRequest(System.Uri)" /> to specify that the HTTP request to the XML Web service is made using HTTP-GET. By overriding this method, additional customizations can be made to the <see cref="T:System.Net.WebRequest" /> object before the XML Web service request is made. For example you could add a custom header to the request.</para>
@@ -65,6 +64,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Net.WebRequest" /> instance for the specified URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Net.WebRequest" /> instance.</para>
+        </returns>
         <param name="uri">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Uri" /> to use when creating the <see cref="T:System.Net.WebRequest" />. </param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/HttpPostClientProtocol.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/HttpPostClientProtocol.xml
index c33d62b12b4..588a5659250 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/HttpPostClientProtocol.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/HttpPostClientProtocol.xml
@@ -56,7 +56,6 @@
         <Parameter Name="uri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Net.WebRequest" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method overrides the base version of <see cref="M:System.Web.Services.Protocols.WebClientProtocol.GetWebRequest(System.Uri)" /> to specify that the HTTP request to the XML Web service is made using HTTP-POST. By overriding this method, you can customize the <see cref="T:System.Net.WebRequest" /> object before the XML Web service request is made. For example, you can add a custom header to the request.</para>
@@ -65,6 +64,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Net.WebRequest" /> instance for the specified URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Net.WebRequest" /> instance.</para>
+        </returns>
         <param name="uri">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Uri" /> to use when creating the <see cref="T:System.Net.WebRequest" />. </param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/HttpSimpleClientProtocol.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/HttpSimpleClientProtocol.xml
index 62bf4e39349..1723c4719b9 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/HttpSimpleClientProtocol.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/HttpSimpleClientProtocol.xml
@@ -58,7 +58,6 @@
         <Parameter Name="asyncState" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IAsyncResult'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="methodName" /> parameter is used to find the types of the parameters and return values of the method that is invoking the <see cref="M:System.Web.Services.Protocols.HttpSimpleClientProtocol.BeginInvoke(System.String,System.String,System.Object[],System.AsyncCallback,System.Object)" /> method. It is also used to find custom attributes that may have been added to the method. <see cref="T:System.Web.Services.Protocols.SoapDocumentMethodAttribute" />, <see cref="T:System.Web.Services.Protocols.SoapRpcMethodAttribute" />, and <see cref="T:System.Xml.Serialization.XmlElementAttribute" /> provide additional information on the derived method that is required for the HTTP protocol.</para>
@@ -69,6 +68,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Starts an asynchronous invocation of a method of an XML Web service.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that can be passed to the <see cref="M:System.Web.Services.Protocols.HttpSimpleClientProtocol.EndInvoke(System.IAsyncResult)" /> method to obtain the return values from the XML Web service method.</para>
+        </returns>
         <param name="methodName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the XML Web service method. </param>
         <param name="requestUrl">
@@ -95,12 +98,15 @@
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Completes asynchronous invocation of an XML Web service method using HTTP.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of objects containing the return value and any by reference or <paramref name="out" /> parameters for the XML Web service method.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IAsyncResult" /> returned from the <see cref="M:System.Web.Services.Protocols.HttpSimpleClientProtocol.BeginInvoke(System.String,System.String,System.Object[],System.AsyncCallback,System.Object)" /> method. </param>
       </Docs>
@@ -121,7 +127,6 @@
         <Parameter Name="parameters" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="methodName" /> parameter is used to find the types of the parameters and return values of the method that is invoking the <see cref="M:System.Web.Services.Protocols.HttpSimpleClientProtocol.Invoke(System.String,System.String,System.Object[])" /> method. It is also used to find custom attributes which may have been added to the method. <see cref="T:System.Web.Services.Protocols.HttpMethodAttribute" /> and <see cref="T:System.Xml.Serialization.XmlElementAttribute" /> provide additional information on the derived method that is required for the SOAP protocol.</para>
@@ -130,6 +135,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes an XML Web service method using HTTP.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of objects containing the return value and any by-reference or <paramref name="out" /> parameters of the derived class method.</para>
+        </returns>
         <param name="methodName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the XML Web service method in the derived class that is invoking the <see cref="M:System.Web.Services.Protocols.HttpSimpleClientProtocol.Invoke(System.String,System.String,System.Object[])" /> method. </param>
         <param name="requestUrl">
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/HttpWebClientProtocol.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/HttpWebClientProtocol.xml
index 3267f29133d..59aaab2bc14 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/HttpWebClientProtocol.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/HttpWebClientProtocol.xml
@@ -194,12 +194,15 @@
       </Parameters>
       <Docs>
         <param name="mapping">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Xml.Serialization.XmlMembersMapping" /> for each XML Web service method exposed by the specified type, and stores the mappings in the specified <see cref="T:System.Collections.ArrayList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="type" /> can be assigned to a <see cref="T:System.Web.Services.Protocols.SoapHttpClientProtocol" />; otherwise, false.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> that exposes the XML Web service methods.</param>
       </Docs>
@@ -219,12 +222,15 @@
       </Parameters>
       <Docs>
         <param name="mapping">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Xml.Serialization.XmlMembersMapping" /> for each XML Web service method exposed by the specified types, and stores the mappings in the specified <see cref="T:System.Collections.ArrayList" />, as well as in a <see cref="T:System.Collections.Hashtable" /> that this method returns.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.Hashtable" /> that contains the <see cref="T:System.Xml.Serialization.XmlMembersMapping" /> for each XML Web service method exposed by the specified types. The types contained in <paramref name="types" /> are used as keys.</para>
+        </returns>
         <param name="types">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Type" /> that contains the types that expose the XML Web service methods.</param>
       </Docs>
@@ -239,12 +245,15 @@
         <Parameter Name="uri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Net.WebRequest" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Net.WebRequest" /> for the specified URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Net.WebRequest" />.</para>
+        </returns>
         <param name="uri">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Uri" /> for creating the <see cref="T:System.Net.WebRequest" />. </param>
       </Docs>
@@ -263,12 +272,15 @@
         <Parameter Name="request" Type="System.Net.WebRequest" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Net.WebResponse" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a response from a synchronous request to an XML Web service method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A response from a synchronous request to an XML Web service method.</para>
+        </returns>
         <param name="request">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.WebRequest" /> from which to get the response. </param>
       </Docs>
@@ -288,12 +300,15 @@
         <Parameter Name="result" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Net.WebResponse" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a response from an asynchronous request to an XML Web service method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A response from an asynchronous request to an XML Web service method.</para>
+        </returns>
         <param name="request">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.WebRequest" /> from which to get the response. </param>
         <param name="result">
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/LogicalMethodInfo.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/LogicalMethodInfo.xml
index d7c8f4e7596..06cae4483c8 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/LogicalMethodInfo.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/LogicalMethodInfo.xml
@@ -131,12 +131,15 @@
         <Parameter Name="asyncState" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IAsyncResult'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous invocation of the method represented by this <see cref="T:System.Web.Services.Protocols.LogicalMethodInfo" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> which is passed to <see cref="M:System.Web.Services.Protocols.LogicalMethodInfo.EndInvoke(System.Object,System.IAsyncResult)" /> to obtain the return values from the remote method call.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The instance of the <see cref="T:System.Object" /> on which to invoke the method on. </param>
         <param name="values">
@@ -182,12 +185,15 @@
       </Parameters>
       <Docs>
         <param name="method_infos">a <see cref="T:System.Reflection.MethodInfo[]" /></param>
-        <returns>a <see cref="T:System.Web.Services.Protocols.LogicalMethodInfo[]" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Given an array of <see cref="T:System.Reflection.MethodInfo" /> that can contain information about both asynchronous and synchronous methods, creates an array of <see cref="T:System.Web.Services.Protocols.LogicalMethodInfo" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Web.Services.Protocols.LogicalMethodInfo" />, representing the methods within <paramref name="methodInfos" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -206,12 +212,15 @@
       </Parameters>
       <Docs>
         <param name="method_infos">a <see cref="T:System.Reflection.MethodInfo[]" /></param>
-        <returns>a <see cref="T:System.Web.Services.Protocols.LogicalMethodInfo[]" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Given an array of <see cref="T:System.Reflection.MethodInfo" />, where the returned array of <see cref="T:System.Web.Services.Protocols.LogicalMethodInfo" /> can be restricted to only asynchronous or synchronous methods, creates an array of <see cref="T:System.Web.Services.Protocols.LogicalMethodInfo" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Web.Services.Protocols.LogicalMethodInfo" />, representing the methods within <paramref name="methodInfos" />, filtered by the value of <paramref name="types" />.</para>
+        </returns>
         <param name="types">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of the <see cref="T:System.Web.Services.Protocols.LogicalMethodTypes" /> values. Determines whether just asynchronous or synchronous methods or both are included in the returned array of <see cref="T:System.Web.Services.Protocols.LogicalMethodInfo" />. </param>
       </Docs>
@@ -273,12 +282,15 @@
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ends an asynchronous invocation of the method represented by the current <see cref="T:System.Web.Services.Protocols.LogicalMethodInfo" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of objects containing the return value and any by-reference or out parameters of the derived class method.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The instance of the <see cref="T:System.Object" /> on which to invoke the method. </param>
         <param name="asyncResult">
@@ -319,12 +331,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the first custom attribute applied to the type, if any custom attributes are applied to the type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> containing the first custom attribute applied to the <paramref name="type" /> parameter.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> to which the custom attributes are applied. </param>
       </Docs>
@@ -343,12 +358,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the custom attributes applied to the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Object" /> containing the custom attributes applied to <paramref name="type" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> to which the custom attributes are applied. </param>
       </Docs>
@@ -393,12 +411,15 @@
         <Parameter Name="values" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes the method represented by the current <see cref="T:System.Web.Services.Protocols.LogicalMethodInfo" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Object" /> representing the return value and out parameters of the invoked method.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The instance of the <see cref="T:System.Object" /> to invoke the method. </param>
         <param name="values">
@@ -439,12 +460,15 @@
       </Parameters>
       <Docs>
         <param name="method_info">a <see cref="T:System.Reflection.MethodInfo" /></param>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the method passed in represents a Begin method of an asynchronous invocation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="methodInfo" /> parameter is a Begin method of an asynchronous invocation; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -462,12 +486,15 @@
       </Parameters>
       <Docs>
         <param name="method_info">a <see cref="T:System.Reflection.MethodInfo" /></param>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the method passed in represents an End method of an asynchronous invocation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="methodInfo" /> parameter is an End method of an asynchronous invocation; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -627,12 +654,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Web.Services.Protocols.LogicalMethodInfo" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that represents the current <see cref="T:System.Web.Services.Protocols.LogicalMethodInfo" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/MimeFormatter.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/MimeFormatter.xml
index 60fee130d91..e8d97d12c8a 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/MimeFormatter.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/MimeFormatter.xml
@@ -54,7 +54,6 @@
         <Parameter Name="initializer" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MimeFormatter'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.Services.Protocols.MimeFormatter.CreateInstance(System.Type,System.Object)" /> method creates an instance of the derived class and invokes the derived class's implementation of the abstract <see cref="M:System.Web.Services.Protocols.MimeFormatter.Initialize(System.Object)" /> method. The <see cref="M:System.Web.Services.Protocols.MimeFormatter.CreateInstance(System.Type,System.Object)" /> method is invoked at the time a request or response is processed.</para>
@@ -64,6 +63,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and initializes an instance of a concrete class derived from <see cref="T:System.Web.Services.Protocols.MimeFormatter" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Services.Protocols.MimeFormatter" /> object.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The Type, derived from <see cref="T:System.Web.Services.Protocols.MimeFormatter" />, of which to create an instance.</param>
         <param name="initializer">
@@ -84,7 +87,6 @@
         <Parameter Name="methodInfo" Type="System.Web.Services.Protocols.LogicalMethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An initializer is an object passed as a parameter to the <see cref="M:System.Web.Services.Protocols.MimeFormatter.Initialize(System.Object)" /> method.</para>
@@ -94,6 +96,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns an initializer for the specified method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that contains the initializer for the specified method.</para>
+        </returns>
         <param name="methodInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.Services.Protocols.LogicalMethodInfo" /> that specifies the Web method for which the initializer is obtained.</param>
       </Docs>
@@ -113,7 +119,6 @@
         <Parameter Name="methodInfo" Type="System.Web.Services.Protocols.LogicalMethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An initializer is an object passed as a parameter to the <see cref="M:System.Web.Services.Protocols.MimeFormatter.Initialize(System.Object)" /> method.</para>
@@ -123,6 +128,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an initializer for the specified method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Object" /> object that contains the initializer for the specified method.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The Type, derived from <see cref="T:System.Web.Services.Protocols.MimeFormatter" />,- for which an initializer is obtained.</param>
         <param name="methodInfo">
@@ -143,7 +152,6 @@
         <Parameter Name="methodInfos" Type="System.Web.Services.Protocols.LogicalMethodInfo[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An initializer is an object passed as a parameter to the <see cref="M:System.Web.Services.Protocols.MimeFormatter.Initialize(System.Object)" /> method.</para>
@@ -153,6 +161,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns an array of initializer objects corresponding to an input array of method definitions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of initializer objects corresponding to the input array of method definitions.</para>
+        </returns>
         <param name="methodInfos">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of Web methods where, for each method, the object of the corresponding index in the returned initializer array is obtained.</param>
       </Docs>
@@ -172,7 +184,6 @@
         <Parameter Name="methodInfos" Type="System.Web.Services.Protocols.LogicalMethodInfo[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An initializer is an object passed as a parameter to the <see cref="M:System.Web.Services.Protocols.MimeFormatter.Initialize(System.Object)" /> method.</para>
@@ -182,6 +193,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of initializer objects corresponding to an input array of method definitions for a specified class derived from <see cref="T:System.Web.Services.Protocols.MimeFormatter" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of initializer objects corresponding to the input array of method definitions for a specified class derived from <see cref="T:System.Web.Services.Protocols.MimeFormatter" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The Type, derived from <see cref="T:System.Web.Services.Protocols.MimeFormatter" />, for which initializers are obtained.</param>
         <param name="methodInfos">
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/MimeParameterReader.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/MimeParameterReader.xml
index 29eb78759eb..52191d9e6ed 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/MimeParameterReader.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/MimeParameterReader.xml
@@ -54,12 +54,15 @@
         <Parameter Name="request" Type="System.Web.HttpRequest" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object[]" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, deserializes an HTTP request into an array of Web method parameter values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Object" /> objects that contains the deserialized HTTP request.</para>
+        </returns>
         <param name="request">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Web.HttpRequest" /> object containing the input message for an operation.</param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/MimeParameterWriter.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/MimeParameterWriter.xml
index ccba9d8fc43..958729db619 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/MimeParameterWriter.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/MimeParameterWriter.xml
@@ -55,7 +55,6 @@
         <Parameter Name="parameters" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Of the classes derived from <see cref="T:System.Web.Services.Protocols.MimeParameterWriter" />, only <see cref="T:System.Web.Services.Protocols.UrlParameterWriter" /> modifies the HTTP request URL.</para>
@@ -64,6 +63,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, modifies the outgoing HTTP request's Uniform Request Locator (URL).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> object that contains the modified, outgoing HTTP request's Uniform Request Locator (URL).</para>
+        </returns>
         <param name="url">
           <attribution license="cc4" from="Microsoft" modified="false" />The HTTP request's original Uniform Resource Locator (URL).</param>
         <param name="parameters">
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/MimeReturnReader.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/MimeReturnReader.xml
index b0a6ea4e110..a7db1e1db88 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/MimeReturnReader.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/MimeReturnReader.xml
@@ -55,12 +55,15 @@
         <Parameter Name="responseStream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, deserializes an HTTP response into a Web method return value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An HTTP response deserialized into a Web method return value.</para>
+        </returns>
         <param name="response">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Net.WebResponse" /> object containing the output message for an operation.</param>
         <param name="responseStream">
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/NopReturnReader.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/NopReturnReader.xml
index ff1a743cbc6..a4a664644d4 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/NopReturnReader.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/NopReturnReader.xml
@@ -54,7 +54,6 @@
         <Parameter Name="methodInfo" Type="System.Web.Services.Protocols.LogicalMethodInfo" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An initializer is an object passed as a parameter to the <see cref="M:System.Web.Services.Protocols.NopReturnReader.Initialize(System.Object)" /> method. For the <see cref="T:System.Web.Services.Protocols.NopReturnReader" /> class, the initializer is the instance referred to by the keyword this.</para>
@@ -63,6 +62,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an initializer for the specified method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An initializer for the specified method.</para>
+        </returns>
         <param name="methodInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.Services.Protocols.LogicalMethodInfo" /> that specifies the Web method for which the initializer is obtained.</param>
       </Docs>
@@ -108,7 +111,6 @@
         <Parameter Name="responseStream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Web.Services.Protocols.NopReturnReader" /> class's implementation of the <see cref="M:System.Web.Services.Protocols.MimeReturnReader.Read(System.Net.WebResponse,System.IO.Stream)" /> method does no reading. Instead it returns null. It also closes the response stream.</para>
@@ -117,6 +119,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns null instead of deserializing the HTTP response stream into a Web method return value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>null.</para>
+        </returns>
         <param name="response">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Net.WebResponse" /> object  containing the output message for an operation.</param>
         <param name="responseStream">
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/PatternMatcher.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/PatternMatcher.xml
index 0211016c995..d41ff95f36e 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/PatternMatcher.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/PatternMatcher.xml
@@ -61,7 +61,6 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.Services.Protocols.PatternMatcher.Match(System.String)" /> method's return value is the Web method return value deserialized from the input text.</para>
@@ -70,6 +69,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches a text input to deserialize an object representing a Web method return value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing a Web method return value.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to search, which is the body of the HTTP response.</param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/ServerProtocol.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/ServerProtocol.xml
index fe075bfb727..5b39fe232f3 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/ServerProtocol.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/ServerProtocol.xml
@@ -93,13 +93,16 @@
         <Parameter Name="serverType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the <see cref="T:System.Object" /> that is stored in the cache using the key that was created from the specified protocol type and server type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> that is stored in the cache using the key that was created from <paramref name="protocolType" /> and <paramref name="serverType" />.</para>
+        </returns>
         <param name="protocolType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that is used to create the key to retrieve <paramref name="value" /> from the cache.</param>
         <param name="serverType">
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/ServerProtocolFactory.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/ServerProtocolFactory.xml
index 0992fc1e58e..f50bdc829a9 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/ServerProtocolFactory.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/ServerProtocolFactory.xml
@@ -44,13 +44,16 @@
         <Parameter Name="request" Type="System.Web.HttpRequest" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Web.Services.Protocols.ServerProtocol" /> that can be used to process the XML Web service request specified by the <paramref name="request" /> parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Services.Protocols.ServerProtocol" /> that can be used to process the XML Web service request specified by the <paramref name="request" /> parameter.</para>
+        </returns>
         <param name="request">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.HttpRequest" /> that represents the Web service request.</param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapException.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapException.xml
index 3a9ca96fc27..7fcfa1ba1c6 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapException.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapException.xml
@@ -589,7 +589,6 @@
         <Parameter Name="code" Type="System.Xml.XmlQualifiedName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Recipients of a <see cref="T:System.Web.Services.Protocols.SoapException" /> can use this method to determine whether the <see cref="P:System.Web.Services.Protocols.SoapException.Code" /> property is functionally equivalent to the Client SOAP fault code defined in SOAP 1.1 regardless of the version of the SOAP protocol used. Versions of the SOAP protocol later than 1.1 might use different names or namespaces for the Client SOAP fault code defined in SOAP version 1.1, which is represented by the <see cref="F:System.Web.Services.Protocols.SoapException.ClientFaultCode" /> field. SOAP 1.2 names the fault code Sender, which is represented by the <see cref="F:System.Web.Services.Protocols.Soap12FaultCodes.SenderFaultCode" /> field.</para>
@@ -598,6 +597,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the SOAP fault code is equivalent to the Client SOAP fault code regardless of the version of the SOAP protocol used.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="code" /> is equivalent to the Client SOAP fault code; otherwise, false.</para>
+        </returns>
         <param name="code">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlQualifiedName" /> that contains a SOAP fault code. </param>
       </Docs>
@@ -615,7 +618,6 @@
         <Parameter Name="code" Type="System.Xml.XmlQualifiedName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Recipients of a <see cref="T:System.Web.Services.Protocols.SoapException" /> can use this method to determine whether the <see cref="P:System.Web.Services.Protocols.SoapException.Code" /> property is functionally equivalent to the MustUnderstand SOAP fault code defined in SOAP 1.1 regardless of the version of the SOAP protocol used. Versions of the SOAP protocol later than 1.1 might use different names or namespaces for the MustUnderstand SOAP fault code defined in SOAP version 1.1, which is represented by the <see cref="F:System.Web.Services.Protocols.SoapException.MustUnderstandFaultCode" /> field. SOAP 1.2 names the fault code the same; however it is scoped by a different XML namespace and is represented by the <see cref="F:System.Web.Services.Protocols.Soap12FaultCodes.MustUnderstandFaultCode" /> field.</para>
@@ -624,6 +626,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the SOAP fault code is equivalent to MustUnderstand regardless of the version of the SOAP protocol used.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="code" /> is equivalent to the MustUnderstand SOAP fault code; otherwise, false.</para>
+        </returns>
         <param name="code">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlQualifiedName" /> that contains a SOAP fault code. </param>
       </Docs>
@@ -641,7 +647,6 @@
         <Parameter Name="code" Type="System.Xml.XmlQualifiedName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Recipients of a <see cref="T:System.Web.Services.Protocols.SoapException" /> can use this method to determine whether the <see cref="P:System.Web.Services.Protocols.SoapException.Code" /> property is functionally equivalent to the Server SOAP fault code defined in SOAP 1.1 regardless of the version of the SOAP protocol used. Versions of the SOAP protocol later than 1.1 might use different names or namespaces for the Server SOAP fault code defined in SOAP version 1.1, which is represented by the <see cref="F:System.Web.Services.Protocols.SoapException.ServerFaultCode" /> field. SOAP 1.2 names the fault code Receiver, which is represented by the <see cref="F:System.Web.Services.Protocols.Soap12FaultCodes.ReceiverFaultCode" /> field.</para>
@@ -650,6 +655,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the SOAP fault code is equivalent to the Server SOAP fault code regardless of the version of the SOAP protocol used.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="code" /> is equivalent to the Server SOAP fault code; otherwise, false.</para>
+        </returns>
         <param name="code">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlQualifiedName" /> that contains a SOAP fault code. </param>
       </Docs>
@@ -667,7 +676,6 @@
         <Parameter Name="code" Type="System.Xml.XmlQualifiedName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Recipients of a <see cref="T:System.Web.Services.Protocols.SoapException" /> can use this method to determine whether the <see cref="P:System.Web.Services.Protocols.SoapException.Code" /> property is functionally equivalent to the VersionMismatch SOAP fault code defined in SOAP 1.1 regardless of the version of the SOAP protocol used. Versions of the SOAP protocol later than 1.1 might use different names or namespaces for the VersionMismatch SOAP fault code defined in SOAP version 1.1, which is represented by the <see cref="F:System.Web.Services.Protocols.SoapException.VersionMismatchFaultCode" /> field. SOAP 1.2 names the fault code the same; however, it is scoped by a different XML namespace and is represented by the <see cref="F:System.Web.Services.Protocols.Soap12FaultCodes.VersionMismatchFaultCode" /> field.</para>
@@ -676,6 +684,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the SOAP fault code is equivalent to the VersionMismatch SOAP fault code regardless of the version of the SOAP protocol used.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="code" /> is equivalent to the VersionMismatch SOAP fault code; otherwise, false.</para>
+        </returns>
         <param name="code">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlQualifiedName" /> that contains a SOAP fault code. </param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapExtension.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapExtension.xml
index a3c29a3dba1..ed80b9bb055 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapExtension.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapExtension.xml
@@ -52,7 +52,6 @@
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.IO.Stream" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -63,6 +62,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, allows a SOAP extension access to the memory buffer containing the SOAP request or response.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> representing a new memory buffer that this SOAP extension can modify.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />A memory buffer containing the SOAP request or response. </param>
       </Docs>
@@ -81,7 +84,6 @@
         <Parameter Name="serviceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The overload of <see cref="M:System.Web.Services.Protocols.SoapExtension.GetInitializer(System.Web.Services.Protocols.LogicalMethodInfo,System.Web.Services.Protocols.SoapExtensionAttribute)" /> that gets called by ASP.NET depends on how the SOAP extension was specified. There are two methods for specifying a SOAP extension: </para>
@@ -100,6 +102,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, allows a SOAP extension to initialize data specific to a class implementing an XML Web service at a one time performance cost.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> that the SOAP extension initializes for caching.</para>
+        </returns>
         <param name="serviceType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the class implementing the XML Web service to which the SOAP extension is applied. </param>
       </Docs>
@@ -119,7 +125,6 @@
         <Parameter Name="attribute" Type="System.Web.Services.Protocols.SoapExtensionAttribute" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the SOAP extension is configured using a configuration file see the <see cref="M:System.Web.Services.Protocols.SoapExtension.GetInitializer(System.Web.Services.Protocols.LogicalMethodInfo,System.Web.Services.Protocols.SoapExtensionAttribute)" /> overload that accepts a <see cref="T:System.Type" />.</para>
@@ -142,6 +147,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, allows a SOAP extension to initialize data specific to an XML Web service method using an attribute applied to the XML Web service method at a one time performance cost.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> that the SOAP extension initializes for caching.</para>
+        </returns>
         <param name="methodInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.Services.Protocols.LogicalMethodInfo" /> representing the specific function prototype for the XML Web service method to which the SOAP extension is applied. </param>
         <param name="attribute">
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapHeaderCollection.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapHeaderCollection.xml
index 628b5f5ce60..c18ab2dcf79 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapHeaderCollection.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapHeaderCollection.xml
@@ -49,12 +49,15 @@
         <Parameter Name="header" Type="System.Web.Services.Protocols.SoapHeader" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Web.Services.Protocols.SoapHeader" /> to the <see cref="T:System.Web.Services.Protocols.SoapHeaderCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position at which the <see cref="T:System.Web.Services.Protocols.SoapHeader" /> was inserted.</para>
+        </returns>
         <param name="header">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Protocols.SoapHeader" /> to add to the <see cref="T:System.Web.Services.Protocols.SoapHeaderCollection" />. </param>
       </Docs>
@@ -73,12 +76,15 @@
         <Parameter Name="header" Type="System.Web.Services.Protocols.SoapHeader" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Web.Services.Protocols.SoapHeaderCollection" /> contains a specific <see cref="T:System.Web.Services.Protocols.SoapHeader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of the <paramref name="header" /> parameter is found in the <see cref="T:System.Web.Services.Protocols.SoapHeaderCollection" />; otherwise, false.</para>
+        </returns>
         <param name="header">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Protocols.SoapHeader" /> to locate in the <see cref="T:System.Web.Services.Protocols.SoapHeaderCollection" />. </param>
       </Docs>
@@ -123,12 +129,15 @@
         <Parameter Name="header" Type="System.Web.Services.Protocols.SoapHeader" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of the <see cref="T:System.Web.Services.Protocols.SoapHeader" /> in the <see cref="T:System.Web.Services.Protocols.SoapHeaderCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the <paramref name="header" /> parameter, if found in the <see cref="T:System.Web.Services.Protocols.SoapHeaderCollection" />; otherwise, -1.</para>
+        </returns>
         <param name="header">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Protocols.SoapHeader" /> to locate in the <see cref="T:System.Web.Services.Protocols.SoapHeaderCollection" />. </param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapHeaderHandling.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapHeaderHandling.xml
index 770364601fc..50f6d9edfec 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapHeaderHandling.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapHeaderHandling.xml
@@ -109,13 +109,16 @@
         <Parameter Name="checkRequiredHeaders" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.String" /> that contains the SOAP header content of the SOAP message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that contains the SOAP header content of the SOAP message.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to be used in writing the headers.</param>
         <param name="serializer">
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapHttpClientProtocol.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapHttpClientProtocol.xml
index ecc2aaf1f9a..66379b7a18f 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapHttpClientProtocol.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapHttpClientProtocol.xml
@@ -56,7 +56,6 @@
         <Parameter Name="asyncState" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IAsyncResult'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Typically, you would not call the <see cref="M:System.Web.Services.Protocols.SoapHttpClientProtocol.BeginInvoke(System.String,System.Object[],System.AsyncCallback,System.Object)" /> method directly, unless you were building your own proxy class for an XML Web service.</para>
@@ -70,6 +69,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Starts an asynchronous invocation of an XML Web service method using SOAP.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that is passed to the <see cref="M:System.Web.Services.Protocols.SoapHttpClientProtocol.EndInvoke(System.IAsyncResult)" /> method to obtain the return values from the remote method call.</para>
+        </returns>
         <param name="methodName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the XML Web service method in the derived class that is invoking the <see cref="M:System.Web.Services.Protocols.SoapHttpClientProtocol.BeginInvoke(System.String,System.Object[],System.AsyncCallback,System.Object)" /> method. </param>
         <param name="parameters">
@@ -117,7 +120,6 @@
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Typically, you would not call the <see cref="M:System.Web.Services.Protocols.SoapHttpClientProtocol.EndInvoke(System.IAsyncResult)" /> method directly, unless you were building your own proxy class for an XML Web service.</para>
@@ -128,6 +130,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ends an asynchronous invocation of an XML Web service method using SOAP.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of objects that contains the return value and any by-reference or out parameters of the derived class method.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IAsyncResult" /> returned from the <see cref="M:System.Web.Services.Protocols.SoapHttpClientProtocol.BeginInvoke(System.String,System.Object[],System.AsyncCallback,System.Object)" /> method. </param>
       </Docs>
@@ -150,12 +156,15 @@
         <Parameter Name="bufferSize" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Xml.XmlReader" /> initialized with the <see cref="P:System.Web.Services.Protocols.SoapMessage.Stream" /> property of the <see cref="T:System.Web.Services.Protocols.SoapClientMessage" /> parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Xml.XmlReader" /> initialized with the <see cref="P:System.Web.Services.Protocols.SoapMessage.Stream" /> property of the <paramref name="message" /> parameter.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.Services.Protocols.SoapClientMessage" /> that provides the <see cref="P:System.Web.Services.Protocols.SoapMessage.Stream" /> to initialize the <see cref="T:System.Xml.XmlReader" />.</param>
         <param name="bufferSize">
@@ -172,7 +181,6 @@
         <Parameter Name="uri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Net.WebRequest" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be overridden to customize the <see cref="T:System.Net.WebRequest" /> before the XML Web service request is made. For example, you could add a custom header to the request.</para>
@@ -181,6 +189,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Net.WebRequest" /> for the specified <paramref name="uri" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Net.WebRequest" /> for the specified URI.</para>
+        </returns>
         <param name="uri">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Uri" /> to use when creating the <see cref="T:System.Net.WebRequest" />. </param>
       </Docs>
@@ -203,12 +215,15 @@
         <Parameter Name="bufferSize" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Xml.XmlWriter" /> initialized with the <see cref="P:System.Web.Services.Protocols.SoapMessage.Stream" /> property of the <see cref="T:System.Web.Services.Protocols.SoapClientMessage" /> parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Xml.XmlWriter" /> initialized with the <see cref="P:System.Web.Services.Protocols.SoapMessage.Stream" /> property of the <paramref name="message" /> parameter.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.Services.Protocols.SoapClientMessage" /> that provides the <see cref="P:System.Web.Services.Protocols.SoapMessage.Stream" /> to initialize the <see cref="T:System.Xml.XmlWriter" />.</param>
         <param name="bufferSize">
@@ -227,7 +242,6 @@
       </Parameters>
       <Docs>
         <param name="method_name">a <see cref="T:System.String" /></param>
-        <returns>a <see cref="T:System.Object[]" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Typically, you do not call the <see cref="M:System.Web.Services.Protocols.SoapHttpClientProtocol.Invoke(System.String,System.Object[])" /> method directly, unless you are building your own proxy class for an XML Web service.</para>
@@ -238,6 +252,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes an XML Web service method synchronously using SOAP.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of objects that contains the return value and any reference or out parameters of the derived class method.</para>
+        </returns>
         <param name="parameters">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of objects that contains the parameters to pass to the XML Web service. The order of the values in the array corresponds to the order of the parameters in the calling method of the derived class. </param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapMessage.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapMessage.xml
index 4ed39067aff..6754fa7cf17 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapMessage.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapMessage.xml
@@ -201,7 +201,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.Services.Protocols.SoapMessage.GetInParameterValue(System.Int32)" /> property is only accessible when in parameters are available. ASP.NET throws <see cref="T:System.InvalidOperationException" /> when accessing the <see cref="M:System.Web.Services.Protocols.SoapMessage.GetInParameterValue(System.Int32)" /> property if in parameters are not available.</para>
@@ -211,6 +210,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the parameter passed into the XML Web service method at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> representing the parameter at the specified index.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the parameter in the array of parameters. </param>
       </Docs>
@@ -229,7 +232,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If out parameters are not available, ASP.NET throws an <see cref="T:System.InvalidOperationException" /> when accessing the <see cref="M:System.Web.Services.Protocols.SoapMessage.GetOutParameterValue(System.Int32)" /> property.</para>
@@ -239,6 +241,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the out parameter passed into the XML Web service method at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> representing the parameter at the specified index.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the parameter in the array of parameters. </param>
       </Docs>
@@ -255,7 +261,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If a return value is not available, ASP.NET throws <see cref="T:System.InvalidOperationException" /> when accessing the <see cref="M:System.Web.Services.Protocols.SoapMessage.GetReturnValue" /> property.</para>
@@ -265,6 +270,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the return value of an XML Web service method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> representing the return value of the XML Web service method.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapServerProtocol.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapServerProtocol.xml
index 0a6ee075b88..7eb5b1c710c 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapServerProtocol.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapServerProtocol.xml
@@ -48,13 +48,16 @@
         <Parameter Name="bufferSize" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Xml.XmlTextReader" /> initialized with the specified <see cref="T:System.Web.Services.Protocols.SoapServerMessage" /> and buffer size.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Xml.XmlTextReader" /> initialized with the <see cref="T:System.Web.Services.Protocols.SoapServerMessage" /> specified by <paramref name="message" /> and the buffer size specified by <paramref name="bufferSize" />.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Protocols.SoapServerMessage" /> with which to initialize the <see cref="T:System.Xml.XmlTextReader" />.</param>
         <param name="bufferSize">
@@ -75,13 +78,16 @@
         <Parameter Name="bufferSize" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Xml.XmlTextWriter" /> initialized with the specified <see cref="T:System.Web.Services.Protocols.SoapServerMessage" /> and buffer size.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Xml.XmlTextWriter" /> initialized with the <see cref="T:System.Web.Services.Protocols.SoapServerMessage" /> specified by <paramref name="message" /> and the buffer size specified by <paramref name="bufferSize" />.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Protocols.SoapServerMessage" /> with which to initialize the <see cref="T:System.Xml.XmlTextWriter" />.</param>
         <param name="bufferSize">
@@ -102,13 +108,16 @@
         <Parameter Name="extensions" Type="System.Web.Services.Protocols.SoapExtension[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Applies the specified priority and group attributes to the SOAP extensions contained in the specified array of type <see cref="T:System.Web.Services.Protocols.SoapExtension" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Web.Services.Protocols.SoapExtension" /> with the priority and group attributes specified by <paramref name="group" /> applied.</para>
+        </returns>
         <param name="group">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.Services.Configuration.PriorityGroup" /> that specifies the priority and group attributes to be applied to the SOAP extensions contained in <paramref name="extensions" />.</param>
         <param name="extensions">
@@ -128,7 +137,6 @@
         <Parameter Name="message" Type="System.Web.Services.Protocols.SoapServerMessage" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -138,6 +146,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Web.Services.Protocols.SoapServerMethod" /> to which the specified <see cref="T:System.Web.Services.Protocols.SoapServerMessage" /> should be routed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.Services.Protocols.SoapServerMethod" /> to which the <see cref="T:System.Web.Services.Protocols.SoapServerMessage" /> specified by <paramref name="message" /> should be routed.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Services.Protocols.SoapServerMessage" /> sent to the XML Web service.</param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapServerProtocolFactory.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapServerProtocolFactory.xml
index afd1efd95c7..5f427bdb9a8 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapServerProtocolFactory.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapServerProtocolFactory.xml
@@ -44,13 +44,16 @@
         <Parameter Name="request" Type="System.Web.HttpRequest" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Web.Services.Protocols.ServerProtocol" /> that can be used to process the XML Web service request specified by <paramref name="request" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Services.Protocols.ServerProtocol" /> that can be used to process the XML Web service request specified by <paramref name="request" />.</para>
+        </returns>
         <param name="request">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.HttpRequest" /> that represents the Web service request.</param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapServerType.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapServerType.xml
index d509815ff39..20b80bd3473 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapServerType.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/SoapServerType.xml
@@ -51,13 +51,16 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the duplicate <see cref="T:System.Web.Services.Protocols.SoapServerMethod" /> associated with the specified key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The duplicate <see cref="T:System.Web.Services.Protocols.SoapServerMethod" /> associated with the specified key.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key associated with the desired duplicate <see cref="T:System.Web.Services.Protocols.SoapServerMethod" />.</param>
       </Docs>
@@ -75,13 +78,16 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Web.Services.Protocols.SoapServerMethod" /> associated with the specified key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.Services.Protocols.SoapServerMethod" /> associated with the specified key.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key associated with the desired <see cref="T:System.Web.Services.Protocols.SoapServerMethod" />.</param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/TextReturnReader.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/TextReturnReader.xml
index 7bc52464c7c..79870f882ed 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/TextReturnReader.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/TextReturnReader.xml
@@ -56,7 +56,6 @@
         <Parameter Name="methodInfo" Type="System.Web.Services.Protocols.LogicalMethodInfo" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An initializer is an object passed as a parameter to the <see cref="M:System.Web.Services.Protocols.TextReturnReader.Initialize(System.Object)" /> method. For the <see cref="T:System.Web.Services.Protocols.TextReturnReader" /> class, the initializer is a <see cref="T:System.Web.Services.Protocols.PatternMatcher" /> object based on the return type of the Web method. </para>
@@ -66,6 +65,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an initializer for the specified method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An initializer for the specified method</para>
+        </returns>
         <param name="methodInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.Services.Protocols.LogicalMethodInfo" /> that specifies the Web method for which the initializer is obtained.</param>
       </Docs>
@@ -111,7 +114,6 @@
         <Parameter Name="responseStream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To parse the text content of the HTTP response, the <see cref="T:System.Web.Services.Protocols.TextReturnReader" /> class's implementation of the <see cref="M:System.Web.Services.Protocols.TextReturnReader.Read(System.Net.WebResponse,System.IO.Stream)" /> method uses the <see cref="T:System.Web.Services.Protocols.PatternMatcher" /> object passed as an argument to the <see cref="M:System.Web.Services.Protocols.TextReturnReader.Initialize(System.Object)" /> method. It closes the response stream before returning the deserialized Web method return value.</para>
@@ -120,6 +122,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Parses text contained in the HTTP response.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object containing the deserialized Web method return value.</para>
+        </returns>
         <param name="response">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Net.WebResponse" /> object  containing the output message for an operation.</param>
         <param name="responseStream">
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/UrlParameterReader.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/UrlParameterReader.xml
index c633eafc9d3..cb47ff956cb 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/UrlParameterReader.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/UrlParameterReader.xml
@@ -54,7 +54,6 @@
         <Parameter Name="request" Type="System.Web.HttpRequest" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object[]" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.Services.Protocols.UrlParameterReader.Read(System.Web.HttpRequest)" /> method uses the content of the <see cref="T:System.Web.HttpRequest" /> object's <see cref="P:System.Web.HttpRequest.QueryString" /> property.</para>
@@ -63,6 +62,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads name/value pairs encoded in the query string of an HTTP request into Web method parameter values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of name/value pairs.</para>
+        </returns>
         <param name="request">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Net.WebResponse" /> objectcontaining HTML URL-encoded name/value pairs.</param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/UrlParameterWriter.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/UrlParameterWriter.xml
index 5e0a14e79eb..78a42cadd06 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/UrlParameterWriter.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/UrlParameterWriter.xml
@@ -55,7 +55,6 @@
         <Parameter Name="parameters" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.Services.Protocols.UrlParameterWriter.GetRequestUrl(System.String,System.Object[])" /> method encodes parameters name/value pairs into an HTTP request URL's query string. For example, in the URL http://contoso.com?a=1&amp;b=2, a and b are parameter names, and 1 and 2 are their values. A new URL string, with any encoded parameters, is returned.</para>
@@ -64,6 +63,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes Web method parameter values to the query string of an HTTP request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> object that contains the query string and the parameter values.</para>
+        </returns>
         <param name="url">
           <attribution license="cc4" from="Microsoft" modified="false" />The HTTP request's original URL.</param>
         <param name="parameters">
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/ValueCollectionParameterReader.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/ValueCollectionParameterReader.xml
index 7ce5e909366..c379771bbbd 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/ValueCollectionParameterReader.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/ValueCollectionParameterReader.xml
@@ -53,7 +53,6 @@
         <Parameter Name="methodInfo" Type="System.Web.Services.Protocols.LogicalMethodInfo" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The object returned by the <see cref="M:System.Web.Services.Protocols.ValueCollectionParameterReader.GetInitializer(System.Web.Services.Protocols.LogicalMethodInfo)" /> method is the <see cref="P:System.Web.Services.Protocols.LogicalMethodInfo.InParameters" /> property of the <paramref name="methodinfo" /> parameter. The <see cref="P:System.Web.Services.Protocols.LogicalMethodInfo.InParameters" /> property value is an array of type <see cref="T:System.Reflection.ParameterInfo" />.</para>
@@ -63,6 +62,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an initializer for the specified method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Services.Protocols.LogicalMethodInfo" /> representing the Web method.</para>
+        </returns>
         <param name="methodInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.Services.Protocols.LogicalMethodInfo" /> that specifies the Web method for which the initializer is obtained.</param>
       </Docs>
@@ -108,12 +111,15 @@
         <Parameter Name="paramInfo" Type="System.Reflection.ParameterInfo" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a particular parameter type is supported by the <see cref="T:System.Web.Services.Protocols.ValueCollectionParameterReader" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a method's parameter definitions are supported by the reader; otherwise, false.</para>
+        </returns>
         <param name="paramInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Reflection.ParameterInfo" /> that specifies the parameter to check.</param>
       </Docs>
@@ -132,12 +138,15 @@
         <Parameter Name="methodInfo" Type="System.Web.Services.Protocols.LogicalMethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a method definition's parameter definitions are supported by the <see cref="T:System.Web.Services.Protocols.ValueCollectionParameterReader" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a method's parameter definitions are supported by the reader; otherwise, false.</para>
+        </returns>
         <param name="methodInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.Services.Protocols.LogicalMethodInfo" /> that specifies the method to check.</param>
       </Docs>
@@ -156,7 +165,6 @@
         <Parameter Name="collection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object[]" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.Services.Protocols.ValueCollectionParameterReader.Read(System.Collections.Specialized.NameValueCollection)" /> method is called by the <see cref="M:System.Web.Services.Protocols.ValueCollectionParameterReader.Read(System.Collections.Specialized.NameValueCollection)" /> method defined in the two classes derived from <see cref="T:System.Web.Services.Protocols.ValueCollectionParameterReader" />, <see cref="T:System.Web.Services.Protocols.UrlParameterReader" /> and <see cref="T:System.Web.Services.Protocols.HtmlFormParameterReader" />. Those two classes' <see cref="M:System.Web.Services.Protocols.ValueCollectionParameterReader.Read(System.Collections.Specialized.NameValueCollection)" /> methods take an <see cref="T:System.Web.HttpRequest" /> parameter.</para>
@@ -165,6 +173,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Translates a collection of name/value pairs into an array of objects representing method parameter values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Object" /> objects representing method parameter values.</para>
+        </returns>
         <param name="collection">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Collections.Specialized.NameValueCollection" /> object that specifies the collection of name/value pairs containing method parameter names and values.</param>
       </Docs>
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/WebClientProtocol.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/WebClientProtocol.xml
index 8c0c3792cff..6d409d62790 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/WebClientProtocol.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/WebClientProtocol.xml
@@ -150,12 +150,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an instance of a client protocol handler from the cache.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of a client protocol handler from the cache.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the client protocol handler to be returned from the cache.</param>
       </Docs>
@@ -174,7 +177,6 @@
         <Parameter Name="uri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Net.WebRequest" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be overridden to customize the <see cref="T:System.Net.WebRequest" /> object before the XML Web service request is made. For example you could add a custom header to the request.</para>
@@ -183,6 +185,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Net.WebRequest" /> instance for the specified <paramref name="uri" />. This protected method is called by the XML Web service client infrastructure to get a new <see cref="T:System.Net.WebRequest" /> transport object to transmit the XML Web service request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Net.WebRequest" /> instance.</para>
+        </returns>
         <param name="uri">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Uri" /> to use when creating the <see cref="T:System.Net.WebRequest" />. </param>
       </Docs>
@@ -201,12 +207,15 @@
         <Parameter Name="request" Type="System.Net.WebRequest" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Net.WebResponse" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a response from a synchronous request to an XML Web service method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A response from a synchronous request to an XML Web service method.</para>
+        </returns>
         <param name="request">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.WebRequest" /> to get the response from. </param>
       </Docs>
@@ -226,12 +235,15 @@
         <Parameter Name="result" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Net.WebResponse" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a response from an asynchronous request to an XML Web service method. This protected method is called by the XML Web service client infrastructure to get the response from an asynchronous XML Web service request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A response from an asynchronous request to an XML Web service method.</para>
+        </returns>
         <param name="request">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.WebRequest" /> to get the response from. </param>
         <param name="result">
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/WebServiceHandlerFactory.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/WebServiceHandlerFactory.xml
index 33d737eaada..cbf7a3dd1cf 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/WebServiceHandlerFactory.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/WebServiceHandlerFactory.xml
@@ -58,12 +58,15 @@
         <Parameter Name="filePath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Web.IHttpHandler" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Web.IHttpHandler" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.IHttpHandler" /> instance.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Web.HttpContext" /> that provides references to intrinsic server objects (For example, <see cref="P:System.Web.HttpContext.Request" />, <see cref="P:System.Web.HttpContext.Response" />, <see cref="P:System.Web.HttpContext.Session" />, and <see cref="P:System.Web.HttpContext.Server" />) used to service HTTP requests.</param>
         <param name="verb">
diff --git a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/XmlReturnReader.xml b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/XmlReturnReader.xml
index 6d3ecfc98ec..7dd15eab56f 100644
--- a/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/XmlReturnReader.xml
+++ b/mcs/class/System.Web.Services/Documentation/en/System.Web.Services.Protocols/XmlReturnReader.xml
@@ -53,7 +53,6 @@
         <Parameter Name="methodInfo" Type="System.Web.Services.Protocols.LogicalMethodInfo" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An initializer is an object passed as a parameter to the Initialize method. For the <see cref="T:System.Web.Services.Protocols.XmlReturnReader" /> class, the initializer is an <see cref="T:System.Xml.Serialization.XmlSerializer" /> object for the return type of the Web method. </para>
@@ -63,6 +62,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an initializer for the specified method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An initializer for the specified method.</para>
+        </returns>
         <param name="methodInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.Services.Protocols.LogicalMethodInfo" /> that specifies the Web method for which the initializer is obtained.</param>
       </Docs>
@@ -81,7 +84,6 @@
         <Parameter Name="methodInfos" Type="System.Web.Services.Protocols.LogicalMethodInfo[]" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object[]" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An initializer is an object passed as a parameter to the Initialize method. For the <see cref="T:System.Web.Services.Protocols.XmlReturnReader" /> class, the initializer is an <see cref="T:System.Xml.Serialization.XmlSerializer" /> object for the return type of the Web method. </para>
@@ -91,6 +93,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of initializer objects corresponding to an input array of method definitions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of initializer objects corresponding to an input array of method definitions.</para>
+        </returns>
         <param name="methodInfos">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Web.Services.Protocols.LogicalMethodInfo" /> that specifies the Web methods for which the initializers are obtained.</param>
       </Docs>
@@ -137,7 +143,6 @@
         <Parameter Name="responseStream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To deserialize the XML content of the HTTP response, the <see cref="T:System.Web.Services.Protocols.XmlReturnReader" /> class's implementation of the <see cref="M:System.Web.Services.Protocols.XmlReturnReader.Read(System.Net.WebResponse,System.IO.Stream)" /> method uses the <see cref="T:System.Xml.Serialization.XmlSerializer" /> object passed as an argument to the <see cref="M:System.Web.Services.Protocols.XmlReturnReader.Initialize(System.Object)" /> method. It throws an exception if the HTTP response's MIME content type is not text/xml. The method closes the response before returning the deserialized Web method return value.</para>
@@ -146,6 +151,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a return value deserialized from an XML document contained in the HTTP response.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A return value deserialized from an XML document contained in the HTTP response.</para>
+        </returns>
         <param name="response">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Web.HttpRequest" /> object containing the output message for an operation.</param>
         <param name="responseStream">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Caching/AggregateCacheDependency.xml b/mcs/class/System.Web/Documentation/en/System.Web.Caching/AggregateCacheDependency.xml
index 1fde23404d2..cca36fb629d 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Caching/AggregateCacheDependency.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Caching/AggregateCacheDependency.xml
@@ -78,7 +78,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -88,6 +87,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a unique identifier for the <see cref="T:System.Web.Caching.AggregateCacheDependency" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The unique identifier for the <see cref="T:System.Web.Caching.AggregateCacheDependency" /> object. If one of the associated dependency objects does not have a unique identifier, the <see cref="M:System.Web.Caching.AggregateCacheDependency.GetUniqueId" /> method returns null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Caching/Cache.xml b/mcs/class/System.Web/Documentation/en/System.Web.Caching/Cache.xml
index b1bd0ee6306..2a87a57c0a7 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Caching/Cache.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Caching/Cache.xml
@@ -64,7 +64,6 @@
         <Parameter Name="onRemoveCallback" Type="System.Web.Caching.CacheItemRemovedCallback" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calls to this method will fail if an item with the same <paramref name="key" /> parameter is already stored in the Cache. To overwrite an existing Cache item using the same <paramref name="key" /> parameter, use the <see cref="M:System.Web.Caching.Cache.Insert(System.String,System.Object)" /> method.</para>
@@ -75,6 +74,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified item to the <see cref="T:System.Web.Caching.Cache" /> object with dependencies, expiration and priority policies, and a delegate you can use to notify your application when the inserted item is removed from the Cache.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the item that was added if the item was previously stored in the cache; otherwise, null.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The cache key used to reference the item. </param>
         <param name="value">
@@ -127,12 +130,15 @@
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the specified item from the <see cref="T:System.Web.Caching.Cache" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The retrieved cache item, or null if the key is not found.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The identifier for the cache item to retrieve.</param>
       </Docs>
@@ -149,7 +155,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Collections.IDictionaryEnumerator" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Items can be added to or removed from the cache while this method is enumerating through the items.</para>
@@ -158,6 +163,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a dictionary enumerator used to iterate through the key settings and their values contained in the cache.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator to iterate through the <see cref="T:System.Web.Caching.Cache" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -385,12 +394,15 @@
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the specified item from the application's <see cref="T:System.Web.Caching.Cache" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The item removed from the Cache. If the value in the key parameter is not found, returns null.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> identifier for the cache item to remove.</param>
       </Docs>
@@ -411,12 +423,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that can iterate through the <see cref="T:System.Web.Caching.Cache" /> object collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator that can iterate through the <see cref="T:System.Web.Caching.Cache" /> object collection.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Caching/CacheDependency.xml b/mcs/class/System.Web/Documentation/en/System.Web.Caching/CacheDependency.xml
index e820c969184..03663b31928 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Caching/CacheDependency.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Caching/CacheDependency.xml
@@ -366,7 +366,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be particularly useful for tracking multiple instances of the <see cref="T:System.Web.Caching.CacheDependency" /> class associated with an item or an application.</para>
@@ -376,6 +375,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a unique identifier for a <see cref="T:System.Web.Caching.CacheDependency" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The unique identifier for the <see cref="T:System.Web.Caching.CacheDependency" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HasChanged">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Caching/SqlCacheDependency.xml b/mcs/class/System.Web/Documentation/en/System.Web.Caching/SqlCacheDependency.xml
index c8cdbd1435e..aedb2045192 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Caching/SqlCacheDependency.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Caching/SqlCacheDependency.xml
@@ -131,7 +131,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Web.Caching.SqlCacheDependency" /> method returns an identifier used to uniquely track <see cref="T:System.Web.Caching.SqlCacheDependency" /> objects associated with an item or application. The unique identifier generated when using table-based notifications is partially dependent on the change identifier generated by the database.</para>
@@ -141,6 +140,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a unique identifier for a <see cref="T:System.Web.Caching.SqlCacheDependency" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The unique identifier for the <see cref="T:System.Web.Caching.SqlCacheDependency" /> object, or null if no identifier can be generated.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Compilation/AppSettingsExpressionBuilder.xml b/mcs/class/System.Web/Documentation/en/System.Web.Compilation/AppSettingsExpressionBuilder.xml
index 7262e58c14a..1f65bfb03ea 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Compilation/AppSettingsExpressionBuilder.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Compilation/AppSettingsExpressionBuilder.xml
@@ -66,7 +66,6 @@
         <Parameter Name="context" Type="System.Web.Compilation.ExpressionBuilderContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -76,6 +75,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value from the &lt;appSettings&gt; section of the Web.config file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> associated with a key in the &lt;appSettings&gt; section of the Web.config file.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The object that contains the property entry.</param>
         <param name="entry">
@@ -99,7 +102,6 @@
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -109,6 +111,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value from the &lt;appSettings&gt; section of the Web.config file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> associated with the key in the &lt;appSettings&gt; section of the Web.config file.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key for the value to be retrieved from the configuration file. </param>
       </Docs>
@@ -128,7 +134,6 @@
         <Parameter Name="propertyName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -138,6 +143,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value from the &lt;appSettings&gt; section of the Web.config file with the value converted to a target type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> associated with the key in the &lt;appSettings&gt; section of the Web.config file.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key for a value to be retrieved from the configuration file.</param>
         <param name="targetType">
@@ -161,7 +170,6 @@
         <Parameter Name="context" Type="System.Web.Compilation.ExpressionBuilderContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -171,6 +179,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a code expression that is used to perform the property assignment in the generated page class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.CodeExpression" /> that is used in the property assignment.</para>
+        </returns>
         <param name="entry">
           <attribution license="cc4" from="Microsoft" modified="false" />The property to which the expression is bound.</param>
         <param name="parsedData">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Compilation/AssemblyBuilder.xml b/mcs/class/System.Web/Documentation/en/System.Web.Compilation/AssemblyBuilder.xml
index f83eb047cc0..eb1ec58306e 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Compilation/AssemblyBuilder.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Compilation/AssemblyBuilder.xml
@@ -118,7 +118,6 @@
         <Parameter Name="buildProvider" Type="System.Web.Compilation.BuildProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -130,6 +129,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Allows a build provider to create a temporary source file, and include the source file in the assembly compilation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An open <see cref="T:System.IO.TextWriter" /> that can be used to write source code to a temporary file.</para>
+        </returns>
         <param name="buildProvider">
           <attribution license="cc4" from="Microsoft" modified="false" />The build provider generating the code source file.</param>
       </Docs>
@@ -148,7 +151,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -158,6 +160,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Allows a build provider to create a resource file to include in the assembly compilation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An open <see cref="T:System.IO.Stream" /> that can be used to write resources, which are included in the assembly compilation.</para>
+        </returns>
         <param name="buildProvider">
           <attribution license="cc4" from="Microsoft" modified="false" />The build provider generating the resource.</param>
         <param name="name">
@@ -203,7 +209,6 @@
         <Parameter Name="extension" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -214,6 +219,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a temporary file path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A path to a temporary file, with the specified file extension.</para>
+        </returns>
         <param name="extension">
           <attribution license="cc4" from="Microsoft" modified="false" />The file extension to use for the temporary file.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Compilation/BuildManager.xml b/mcs/class/System.Web/Documentation/en/System.Web.Compilation/BuildManager.xml
index c1f095261b8..da0941bd81b 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Compilation/BuildManager.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Compilation/BuildManager.xml
@@ -65,7 +65,6 @@
         <Parameter Name="requiredBaseType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -75,6 +74,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a file, given its virtual path, and creates an instance of the result.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> that represents the instance of the processed file.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path of the file to create an instance of.</param>
         <param name="requiredBaseType">
@@ -95,13 +98,16 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a build dependency set for a virtual path if the path is located in the ASP.NET cache.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Compilation.BuildDependencySet" /> object that is stored in the cache, or null if the <see cref="T:System.Web.Compilation.BuildDependencySet" /> object cannot be retrieved from the cache.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The context of the request.</param>
         <param name="virtualPath">
@@ -121,13 +127,16 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compiles a file into an assembly using the specified virtual path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Reflection.Assembly" /> object that is compiled from the specified virtual path, which is cached to either memory or to disk.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path to build into an assembly.</param>
       </Docs>
@@ -145,13 +154,16 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compiles a file, given its virtual path, and returns a custom string that the build provider persists in cache.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string, as returned by the <see cref="M:System.Web.Compilation.BuildProvider.GetCustomString(System.CodeDom.Compiler.CompilerResults)" /> method, that is cached to disk or memory.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path of the file to build.</param>
       </Docs>
@@ -169,13 +181,16 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compiles a file, given its virtual path, and returns the compiled type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object that represents the type generated from compiling the virtual path.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path to build into a type.</param>
       </Docs>
@@ -194,7 +209,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The collection of assemblies that is returned from the <see cref="M:System.Web.Compilation.BuildManager.GetReferencedAssemblies" /> method includes assemblies specified in the <format type="text/html"><a href="3811c448-af1c-498d-be2b-6ed2634c51e9">assemblies</a></format> element of the Web.config file, assemblies built from custom code in the App_Code directory, and assemblies in other top-level folders.</para>
@@ -205,6 +219,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a list of assembly references that all page compilations must reference.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.ICollection" /> collection of assembly references.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetType">
@@ -218,7 +236,6 @@
         <Parameter Name="throwOnError" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -228,6 +245,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds a type in the top-level assemblies or in assemblies that are defined in configuration, and optionally throws an exception on failure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object that represents the requested <paramref name="typeName" /> parameter.</para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the type.</param>
         <param name="throwOnError">
@@ -249,7 +270,6 @@
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -259,6 +279,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds a type in the top-level assemblies, or in assemblies that are defined in configuration, by using a case-insensitive search and optionally throwing an exception on failure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object that represents the requested <paramref name="typeName" /> parameter.</para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the type.</param>
         <param name="throwOnError">
@@ -280,13 +304,16 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides a collection of virtual-path dependencies for a specified virtual path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.ICollection" /> collection of files represented by virtual paths that are caching dependencies for the virtual path.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path used to determine the dependencies.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Compilation/BuildProvider.xml b/mcs/class/System.Web/Documentation/en/System.Web.Compilation/BuildProvider.xml
index bc3b9d23074..0f531158e1b 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Compilation/BuildProvider.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Compilation/BuildProvider.xml
@@ -113,7 +113,6 @@
         <Parameter Name="results" Type="System.CodeDom.Compiler.CompilerResults" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -125,6 +124,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a string to be persisted in the compiled assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string to be persisted in the build environment, or null if the <see cref="T:System.Web.Compilation.BuildProvider" /> instance does not implement <see cref="M:System.Web.Compilation.BuildProvider.GetCustomString(System.CodeDom.Compiler.CompilerResults)" />.</para>
+        </returns>
         <param name="results">
           <attribution license="cc4" from="Microsoft" modified="false" />The compilation results for the build provider's virtual path.</param>
       </Docs>
@@ -140,7 +143,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -152,6 +154,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the compiler settings for the default language in the application.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Compilation.CompilerType" /> that represents the compiler settings for the default language in the application. The base class returns the default compiler based on the application configuration file.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -167,7 +173,6 @@
         <Parameter Name="language" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -179,6 +184,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the compiler settings for the build provider based on the specified language.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Compilation.CompilerType" /> that represents the compiler settings for the build provider based on the specified language. The base class returns the default compiler settings for the language based on the application configuration file.</para>
+        </returns>
         <param name="language">
           <attribution license="cc4" from="Microsoft" modified="false" />A code language name.</param>
       </Docs>
@@ -196,7 +205,6 @@
         <Parameter Name="results" Type="System.CodeDom.Compiler.CompilerResults" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -207,6 +215,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a type generated by the build provider from the virtual path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type that is generated by the build provider for the virtual path. The base class returns null.</para>
+        </returns>
         <param name="results">
           <attribution license="cc4" from="Microsoft" modified="false" />The compilation results for the build provider's virtual path.</param>
       </Docs>
@@ -224,7 +236,6 @@
         <Parameter Name="results" Type="System.CodeDom.Compiler.CompilerResults" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -236,6 +247,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating actions required when a virtual path is built.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Compilation.BuildProviderResultFlags" /> value indicating actions required after the virtual path is built within the ASP.NET build environment.</para>
+        </returns>
         <param name="results">
           <attribution license="cc4" from="Microsoft" modified="false" />The compilation results for the build provider's virtual path.</param>
       </Docs>
@@ -251,7 +266,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -262,6 +276,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a text reader for reading from the virtual path of the current build provider object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An open <see cref="T:System.IO.TextReader" /> that can be used to read the contents of the <see cref="P:System.Web.Compilation.BuildProvider.VirtualPath" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -277,7 +295,6 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -288,6 +305,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a text reader for reading from a specified virtual path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An open <see cref="T:System.IO.TextReader" /> that can be used to read the contents of the specified virtual path.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path to read.</param>
       </Docs>
@@ -303,7 +324,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -314,6 +334,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a stream for reading the virtual path of the current build provider object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An open <see cref="T:System.IO.Stream" /> that can be used to read the contents of the <see cref="P:System.Web.Compilation.BuildProvider.VirtualPath" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -329,7 +353,6 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -340,6 +363,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a stream for reading from a specified virtual path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An open <see cref="T:System.IO.Stream" /> that can be used to read the contents of the specified virtual path.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path to read.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Compilation/ClientBuildManager.xml b/mcs/class/System.Web/Documentation/en/System.Web.Compilation/ClientBuildManager.xml
index 094c2a83843..135d871886f 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Compilation/ClientBuildManager.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Compilation/ClientBuildManager.xml
@@ -268,13 +268,16 @@
         <Parameter Name="failIfExists" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an object in the application domain of the ASP.NET runtime.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object in the application domain of the ASP.NET runtime.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of object to be created.</param>
         <param name="failIfExists">
@@ -370,7 +373,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -380,6 +382,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the directories with files that, when changed, cause the application domain to shut down.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> array containing the top-level directory names.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -393,7 +399,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -403,6 +408,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of browser elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IDictionary" /> containing browser elements.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -443,13 +452,16 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compiles the file represented by the virtual path and returns its compiled type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> of the compiled file.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path of the file to compile. </param>
       </Docs>
@@ -490,13 +502,16 @@
         <Parameter Name="filePath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the virtual path of a generated file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the virtual path for <paramref name="filePath" />.</para>
+        </returns>
         <param name="filePath">
           <attribution license="cc4" from="Microsoft" modified="false" />The full physical path to a generated file.</param>
       </Docs>
@@ -514,13 +529,16 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the physical path to the generated file for a virtual path. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that contains the physical path to the generated file.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path of the file to retrieve.</param>
       </Docs>
@@ -538,13 +556,16 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of the assemblies defined in the Bin directory and the &lt;assembly&gt; section of the Web configuration file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> array containing paths to code bases in the Bin directory and the &lt;assembly&gt; section of the Web configuration file. </para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The configuration name and path.</param>
       </Docs>
@@ -560,13 +581,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the virtual paths to the App_Code directory and its subdirectories in an ASP.NET application.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> array containing all the virtual paths to code directories in an application.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -580,7 +604,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -590,6 +613,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gives the application domain an infinite lifetime by preventing a lease from being created.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -605,13 +632,16 @@
         <Parameter Name="assemblyName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether an assembly is a code assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="assemblyName" /> parameter matches one of the generated code assemblies; otherwise, false.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the assembly to be identified as a code assembly.</param>
       </Docs>
@@ -750,13 +780,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Unloads the application domain for compiling ASP.NET Web applications.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the application domain is unloaded; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Compilation/CompilerType.xml b/mcs/class/System.Web/Documentation/en/System.Web.Compilation/CompilerType.xml
index 6b33745ab7e..43a5db5b2fa 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Compilation/CompilerType.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Compilation/CompilerType.xml
@@ -79,7 +79,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -91,6 +90,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified object represents the same code provider and compiler settings as the current instance of <see cref="T:System.Web.Compilation.CompilerType" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="o" /> is a <see cref="T:System.Web.Compilation.CompilerType" /> object and its value is the same as this instance; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current instance of <see cref="T:System.Web.Compilation.CompilerType" />.</param>
       </Docs>
@@ -106,7 +109,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -118,6 +120,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code for the current instance of <see cref="T:System.Web.Compilation.CompilerType" />, suitable for use in hashing algorithms and data structures, such as a hash table.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Compilation/ConnectionStringsExpressionBuilder.xml b/mcs/class/System.Web/Documentation/en/System.Web.Compilation/ConnectionStringsExpressionBuilder.xml
index c88ab30416a..4c903470536 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Compilation/ConnectionStringsExpressionBuilder.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Compilation/ConnectionStringsExpressionBuilder.xml
@@ -68,7 +68,6 @@
         <Parameter Name="context" Type="System.Web.Compilation.ExpressionBuilderContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -78,6 +77,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value from the &lt;connectionStrings&gt; section of the Web.config file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> associated with a key in the &lt;connectionStrings&gt; section of the Web.config file.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The object that contains the expression.</param>
         <param name="entry">
@@ -103,7 +106,6 @@
         <Parameter Name="context" Type="System.Web.Compilation.ExpressionBuilderContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -113,6 +115,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a code expression to evaluate during page parsing.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.CodeExpression" /> that invokes a method.</para>
+        </returns>
         <param name="entry">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that represents information about the property bound to by the expression.</param>
         <param name="parsedData">
@@ -134,7 +140,6 @@
         <Parameter Name="connectionStringName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -144,6 +149,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a connection string from the &lt;connectionStrings&gt; section of the Web.config file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The connection string as a <see cref="T:System.String" /> for this connection string name.</para>
+        </returns>
         <param name="connectionStringName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the connection string.</param>
       </Docs>
@@ -161,7 +170,6 @@
         <Parameter Name="connectionStringName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -171,6 +179,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the connection string provider from the &lt;connectionStrings&gt; section of the Web.config file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The provider as a <see cref="T:System.String" /> for this connection string name.</para>
+        </returns>
         <param name="connectionStringName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the connection string.</param>
       </Docs>
@@ -190,7 +202,6 @@
         <Parameter Name="context" Type="System.Web.Compilation.ExpressionBuilderContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -200,6 +211,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that represents the parsed expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> containing the parsed representation of the expression.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />The value of the declarative expression.</param>
         <param name="propertyType">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Compilation/DesignTimeResourceProviderFactoryAttribute.xml b/mcs/class/System.Web/Documentation/en/System.Web.Compilation/DesignTimeResourceProviderFactoryAttribute.xml
index 3d73aadab9a..808df641e2e 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Compilation/DesignTimeResourceProviderFactoryAttribute.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Compilation/DesignTimeResourceProviderFactoryAttribute.xml
@@ -99,13 +99,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the default provider is used.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <see cref="P:System.Web.Compilation.DesignTimeResourceProviderFactoryAttribute.FactoryTypeName" /> equals null; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Compilation/ExpressionBuilder.xml b/mcs/class/System.Web/Documentation/en/System.Web.Compilation/ExpressionBuilder.xml
index daebf2785a5..1ff8d2db5e5 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Compilation/ExpressionBuilder.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Compilation/ExpressionBuilder.xml
@@ -58,7 +58,6 @@
         <Parameter Name="context" Type="System.Web.Compilation.ExpressionBuilderContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -68,6 +67,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns an object that represents an evaluated expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the evaluated expression; otherwise, null if the inheritor does not implement <see cref="M:System.Web.Compilation.ExpressionBuilder.EvaluateExpression(System.Object,System.Web.UI.BoundPropertyEntry,System.Object,System.Web.Compilation.ExpressionBuilderContext)" />.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The object containing the expression.</param>
         <param name="entry">
@@ -93,7 +96,6 @@
         <Parameter Name="context" Type="System.Web.Compilation.ExpressionBuilderContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -103,6 +105,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns code that is used during page execution to obtain the evaluated expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.CodeExpression" /> that is used for property assignment.</para>
+        </returns>
         <param name="entry">
           <attribution license="cc4" from="Microsoft" modified="false" />The object that represents information about the property bound to by the expression.</param>
         <param name="parsedData">
@@ -126,7 +132,6 @@
         <Parameter Name="context" Type="System.Web.Compilation.ExpressionBuilderContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -136,6 +141,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns an object that represents the parsed expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> containing the parsed representation of the expression; otherwise, null if <see cref="M:System.Web.Compilation.ExpressionBuilder.ParseExpression(System.String,System.Type,System.Web.Compilation.ExpressionBuilderContext)" /> is not implemented.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />The value of the declarative expression.</param>
         <param name="propertyType">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Compilation/ExpressionEditorAttribute.xml b/mcs/class/System.Web/Documentation/en/System.Web.Compilation/ExpressionEditorAttribute.xml
index d23b85e1a21..30f7e8c11a7 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Compilation/ExpressionEditorAttribute.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Compilation/ExpressionEditorAttribute.xml
@@ -106,13 +106,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether this instance of the <see cref="T:System.Web.Compilation.ExpressionEditorAttribute" /> class and a specified object are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if value is not null and <see cref="P:System.Web.Compilation.ExpressionEditorAttribute.EditorTypeName" /> is equal; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of the <see cref="T:System.Web.Compilation.ExpressionEditorAttribute" /> class or a class that derives from it.</param>
       </Docs>
@@ -128,7 +131,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -138,6 +140,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the hash code for the value of this <see cref="T:System.Web.Compilation.ExpressionEditorAttribute" /> attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code of the value of this <see cref="T:System.Web.Compilation.ExpressionEditorAttribute" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Compilation/IImplicitResourceProvider.xml b/mcs/class/System.Web/Documentation/en/System.Web.Compilation/IImplicitResourceProvider.xml
index 00b288aa445..3df4dc77e06 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Compilation/IImplicitResourceProvider.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Compilation/IImplicitResourceProvider.xml
@@ -30,7 +30,6 @@
         <Parameter Name="keyPrefix" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -40,6 +39,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of implicit resource keys as specified by the prefix.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.ICollection" /> of implicit resource keys.</para>
+        </returns>
         <param name="keyPrefix">
           <attribution license="cc4" from="Microsoft" modified="false" />The prefix of the implicit resource keys to be collected.</param>
       </Docs>
@@ -58,7 +61,6 @@
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -68,6 +70,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an object representing the value of the specified resource key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> representing the localized value of an implicit resource key.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The resource key containing the prefix, filter, and property.</param>
         <param name="culture">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Compilation/IResourceProvider.xml b/mcs/class/System.Web/Documentation/en/System.Web.Compilation/IResourceProvider.xml
index 57bbeb995e5..233dae2ead6 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Compilation/IResourceProvider.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Compilation/IResourceProvider.xml
@@ -29,7 +29,6 @@
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -39,6 +38,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a resource object for the key and culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that contains the resource value for the <paramref name="resourceKey" /> and <paramref name="culture" />.</para>
+        </returns>
         <param name="resourceKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key identifying a particular resource.</param>
         <param name="culture">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Compilation/ResourceExpressionBuilder.xml b/mcs/class/System.Web/Documentation/en/System.Web.Compilation/ResourceExpressionBuilder.xml
index abc97b8defa..0185e831433 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Compilation/ResourceExpressionBuilder.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Compilation/ResourceExpressionBuilder.xml
@@ -62,7 +62,6 @@
         <Parameter Name="context" Type="System.Web.Compilation.ExpressionBuilderContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -72,6 +71,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value from a resource file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> associated with the parsed expression. The parsed expression contains the class name and resource key.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The object containing the expression.</param>
         <param name="entry">
@@ -97,7 +100,6 @@
         <Parameter Name="context" Type="System.Web.Compilation.ExpressionBuilderContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -107,6 +109,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a code expression to evaluate during page execution.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.CodeExpression" /> that invokes a method.</para>
+        </returns>
         <param name="entry">
           <attribution license="cc4" from="Microsoft" modified="false" />The property name of the object.</param>
         <param name="parsedData">
@@ -128,7 +134,6 @@
         <Parameter Name="expression" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -138,6 +143,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that represents the parsed expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.Compilation.ResourceExpressionFields" /> for the expression.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />The expression value to be parsed.</param>
       </Docs>
@@ -157,7 +166,6 @@
         <Parameter Name="context" Type="System.Web.Compilation.ExpressionBuilderContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -167,6 +175,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that represents the parsed expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the parsed expression.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />The value of the declarative expression.</param>
         <param name="propertyType">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Compilation/ResourceProviderFactory.xml b/mcs/class/System.Web/Documentation/en/System.Web.Compilation/ResourceProviderFactory.xml
index c962f84fded..f95baddc808 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Compilation/ResourceProviderFactory.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Compilation/ResourceProviderFactory.xml
@@ -51,7 +51,6 @@
         <Parameter Name="classKey" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -61,6 +60,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates a global resource provider. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A global resource provider.</para>
+        </returns>
         <param name="classKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the resource class.</param>
       </Docs>
@@ -78,7 +81,6 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -88,6 +90,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates a local resource provider. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A local resource provider.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to a resource file.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration.Internal/IInternalConfigWebHost.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration.Internal/IInternalConfigWebHost.xml
index f50232595b1..abc21637544 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration.Internal/IInternalConfigWebHost.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration.Internal/IInternalConfigWebHost.xml
@@ -31,13 +31,16 @@
         <Parameter Name="vpath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value representing the path to a configuration file associated with the provided site identifier and application's virtual path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representing the path to a configuration file.</para>
+        </returns>
         <param name="siteID">
           <attribution license="cc4" from="Microsoft" modified="false" />The application's site identifier. For more information, see ASP.NET Configuration Overview.</param>
         <param name="vpath">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/AuthorizationRule.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/AuthorizationRule.xml
index 647412f5ca3..aab3406e2c7 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/AuthorizationRule.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/AuthorizationRule.xml
@@ -80,13 +80,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified object is equal to the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the objects are equal; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current object.</param>
       </Docs>
@@ -102,13 +105,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer representing the hash code for the current object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -122,13 +128,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the collection has been modified since it was last saved or loaded.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if any contained element has been modified; otherwise, false. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/AuthorizationRuleCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/AuthorizationRuleCollection.xml
index 9fe50851eca..c2aaba67c5f 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/AuthorizationRuleCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/AuthorizationRuleCollection.xml
@@ -117,13 +117,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Configuration.ConfigurationElement" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Configuration.ConfigurationElement" />. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -139,13 +142,16 @@
         <Parameter Name="elementName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Configuration.ConfigurationElement" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Configuration.ConfigurationElement" />.</para>
+        </returns>
         <param name="elementName">
           <attribution license="cc4" from="Microsoft" modified="false" />Name of the <see cref="T:System.Configuration.ConfigurationElement" /> to be created. </param>
       </Docs>
@@ -182,13 +188,16 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Web.Configuration.AuthorizationRule" /> at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.Configuration.AuthorizationRule" /> at the specified index.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Configuration.AuthorizationRule" /> index. </param>
       </Docs>
@@ -206,13 +215,16 @@
         <Parameter Name="element" Type="System.Configuration.ConfigurationElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the element key for a specified <see cref="T:System.Configuration.ConfigurationElement" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> that acts as the key for the specified <see cref="T:System.Configuration.ConfigurationElement" />. </para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Configuration.ConfigurationElement" /> whose key is returned.</param>
       </Docs>
@@ -230,13 +242,16 @@
         <Parameter Name="rule" Type="System.Web.Configuration.AuthorizationRule" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the collection index of the specified <see cref="T:System.Web.Configuration.AuthorizationRule" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified <see cref="T:System.Web.Configuration.AuthorizationRule" /> object.</para>
+        </returns>
         <param name="rule">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Configuration.AuthorizationRule" /> object whose index is returned.</param>
       </Docs>
@@ -254,13 +269,16 @@
         <Parameter Name="elementname" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies that the specified name is allowed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the name is allowed; otherwise, false.</para>
+        </returns>
         <param name="elementname">
           <attribution license="cc4" from="Microsoft" modified="false" />The element name to check.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/BuildProvider.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/BuildProvider.xml
index 73dc4555f74..b20adca2879 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/BuildProvider.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/BuildProvider.xml
@@ -51,7 +51,6 @@
         <Parameter Name="provider" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -61,6 +60,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified build provider object is equal to the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the objects are equal; otherwise, false.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />The build provider object to compare with the current object.</param>
       </Docs>
@@ -103,13 +106,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates the hash code for the build provider.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer representing the hash code for the build provider.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/ClientTargetCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/ClientTargetCollection.xml
index 9b726bb3d7e..0b7d101d100 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/ClientTargetCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/ClientTargetCollection.xml
@@ -184,13 +184,16 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the collection key for the specified element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the value of the key.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The collection index of the element to get.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/CompilerCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/CompilerCollection.xml
index 7f4066261a3..e1d40e2d4f3 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/CompilerCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/CompilerCollection.xml
@@ -126,13 +126,16 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Web.Configuration.Compiler" /> collection element at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Configuration.Compiler" /> object.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer value specifying a <see cref="T:System.Web.Configuration.Compiler" /> within the <see cref="T:System.Web.Configuration.CompilerCollection" />.</param>
       </Docs>
@@ -150,13 +153,16 @@
         <Parameter Name="language" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Web.Configuration.Compiler" /> collection element for the specified language.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Configuration.Compiler" /> object.</para>
+        </returns>
         <param name="language">
           <attribution license="cc4" from="Microsoft" modified="false" />The language for the <see cref="T:System.Web.Configuration.Compiler" /> object within the collection.</param>
       </Docs>
@@ -194,13 +200,16 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Web.Configuration.CompilerCollection" /> key name at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The key name at the specified index of the <see cref="T:System.Web.Configuration.CompilerCollection" />.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer value specifying a <see cref="T:System.Web.Configuration.Compiler" /> within the <see cref="T:System.Web.Configuration.CompilerCollection" />.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/CustomError.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/CustomError.xml
index f26cc797e6e..319bd175995 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/CustomError.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/CustomError.xml
@@ -60,7 +60,6 @@
         <Parameter Name="customError" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -70,6 +69,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares <see cref="T:System.Web.Configuration.CustomError" /> errors.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the errors  are equal; otherwise, false.</para>
+        </returns>
         <param name="customError">
           <attribution license="cc4" from="Microsoft" modified="false" />The error to compare against.</param>
       </Docs>
@@ -85,13 +88,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Web.Configuration.CustomError" /> object hash code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.Configuration.CustomError" /> object hash code.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/CustomErrorCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/CustomErrorCollection.xml
index b17b3f2d809..baa01b2edad 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/CustomErrorCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/CustomErrorCollection.xml
@@ -200,13 +200,16 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Web.Configuration.CustomError" /> object with the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.Configuration.CustomError" /> with the specified index.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The collection index of the <see cref="T:System.Web.Configuration.CustomError" /> object. </param>
       </Docs>
@@ -224,13 +227,16 @@
         <Parameter Name="statusCode" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Web.Configuration.CustomError" /> object with the specified status code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.Configuration.CustomError" /> object with the specified status code.</para>
+        </returns>
         <param name="statusCode">
           <attribution license="cc4" from="Microsoft" modified="false" />The HTTP status code associated with the custom error. </param>
       </Docs>
@@ -268,13 +274,16 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Web.Configuration.CustomErrorCollection" /> key at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.Configuration.CustomErrorCollection" /> key at the specified index.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The collection key's index. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/EventMappingSettingsCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/EventMappingSettingsCollection.xml
index cc87369f523..2a28ce552e0 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/EventMappingSettingsCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/EventMappingSettingsCollection.xml
@@ -103,7 +103,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -113,6 +112,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the collection contains an <see cref="T:System.Web.Configuration.EventMappingSettings" /> object with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains an <see cref="T:System.Web.Configuration.EventMappingSettings" /> object with the specified name; otherwise, false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of an <see cref="T:System.Web.Configuration.EventMappingSettings" /> object in the collection.</param>
       </Docs>
@@ -168,13 +171,16 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the specified <see cref="T:System.Web.Configuration.EventMappingSettings" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified <see cref="T:System.Web.Configuration.EventMappingSettings" /> object, or -1 if the object is not found in the collection.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of an <see cref="T:System.Web.Configuration.EventMappingSettings" /> object in the collection.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/FormsAuthenticationUserCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/FormsAuthenticationUserCollection.xml
index 7b12ebb62de..410281cace8 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/FormsAuthenticationUserCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/FormsAuthenticationUserCollection.xml
@@ -176,13 +176,16 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Web.Configuration.FormsAuthenticationUser" /> collection element at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Configuration.FormsAuthenticationUser" /> that contains the user name and password.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The collection user's index. </param>
       </Docs>
@@ -200,13 +203,16 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Web.Configuration.FormsAuthenticationUser" /> collection element with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Configuration.FormsAuthenticationUser" /> object that contains the user name and password.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The user's name. </param>
       </Docs>
@@ -244,13 +250,16 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the key at the specified <see cref="T:System.Web.Configuration.FormsAuthenticationUserCollection" /> collection index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The key at the specified index of the <see cref="T:System.Web.Configuration.FormsAuthenticationUserCollection" />.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index in the collection.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/HttpCapabilitiesBase.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/HttpCapabilitiesBase.xml
index a7fc2ec47c7..dffd2216f96 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/HttpCapabilitiesBase.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/HttpCapabilitiesBase.xml
@@ -516,12 +516,15 @@
         <Parameter Name="w" Type="System.IO.TextWriter" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the <see cref="T:System.Web.UI.HtmlTextWriter" /> to be used.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the <see cref="T:System.Web.UI.HtmlTextWriter" /> to be used.</para>
+        </returns>
         <param name="w">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.IO.TextWriter" /> to be created.</param>
@@ -668,7 +671,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.Configuration.HttpCapabilitiesBase.GetClrVersions" />  method is supported only when the browser is Internet Explorer version 5.0 or later. If the common language runtime is not installed on the client, the property returns an array containing a single <see cref="T:System.Version" /> object with the values 0, 0,-1,-1.</para>
@@ -677,6 +679,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all versions of the .NET Framework common language runtime that are installed on the client.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Version" /> objects.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetConfigCapabilities">
@@ -690,12 +696,15 @@
         <Parameter Name="request" Type="System.Web.HttpRequest" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Web.Configuration.HttpCapabilitiesBase" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used internally to return an instance of <see cref="T:System.Web.Configuration.HttpCapabilitiesBase" /> representing the browser that generated the specified <see cref="T:System.Web.HttpRequest" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Web.Configuration.HttpCapabilitiesBase" /> representing the browser that generated the specified <see cref="T:System.Web.HttpRequest" />.</para>
+        </returns>
         <param name="configKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the configuration section that configures browser capabilities.</param>
         <param name="request">
@@ -845,7 +854,6 @@
         <Parameter Name="browserName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.Configuration.HttpCapabilitiesBase.IsBrowser(System.String)" /> method also returns true if the client browser definition inherits from the specified browser.</para>
@@ -854,6 +862,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the client browser is the same as the specified browser.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the client browser is the same as the specified browser; otherwise, false. The default is false.</para>
+        </returns>
         <param name="browserName">
           <attribution license="cc4" from="Microsoft" modified="false" />The specified browser.</param>
       </Docs>
@@ -2369,12 +2381,15 @@
         <Parameter Name="filter2" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used internally to compare filters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>1 if <paramref name="filter1" /> is a parent of <paramref name="filter2" />; -1 if <paramref name="filter2" /> is a parent of <paramref name="filter1" />; 0 if there is no parent-child relationship between <paramref name="filter1" /> and <paramref name="filter2" />.</para>
+        </returns>
         <param name="filter1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first filter to compare.</param>
         <param name="filter2">
@@ -2394,12 +2409,15 @@
         <Parameter Name="filterName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used internally to evaluate a filter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the filter was successfully evaluated; otherwise, false.</para>
+        </returns>
         <param name="filterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The filter to evaluate.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/HttpHandlerActionCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/HttpHandlerActionCollection.xml
index 4e04f17de47..b79fa83698c 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/HttpHandlerActionCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/HttpHandlerActionCollection.xml
@@ -163,7 +163,6 @@
         <Parameter Name="action" Type="System.Web.Configuration.HttpHandlerAction" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -173,6 +172,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the collection index of the specified <see cref="T:System.Web.Configuration.HttpHandlerAction" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The collection index value.</para>
+        </returns>
         <param name="action">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Configuration.HttpHandlerAction" /> object for which to get the collection index. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/HttpModuleActionCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/HttpModuleActionCollection.xml
index 1a23a68d341..be9c321ad1a 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/HttpModuleActionCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/HttpModuleActionCollection.xml
@@ -100,7 +100,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -110,6 +109,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Configuration.ConfigurationElement" /> object for the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Configuration.ConfigurationElement" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -125,7 +128,6 @@
         <Parameter Name="element" Type="System.Configuration.ConfigurationElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -135,6 +137,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the element key for a specified <see cref="T:System.Configuration.ConfigurationElement" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" />, which acts as the key for the specified <see cref="T:System.Configuration.ConfigurationElement" /> object. </para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Configuration.ConfigurationElement" /> whose key is returned.</param>
       </Docs>
@@ -152,7 +158,6 @@
         <Parameter Name="action" Type="System.Web.Configuration.HttpModuleAction" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -162,6 +167,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the collection index of the specified <see cref="T:System.Web.Configuration.HttpModuleAction" /> module.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The collection index value for the specified module.</para>
+        </returns>
         <param name="action">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Configuration.HttpModuleAction" /> module for which to get the collection index.</param>
       </Docs>
@@ -179,7 +188,6 @@
         <Parameter Name="element" Type="System.Configuration.ConfigurationElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -189,6 +197,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies that the element is removable.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the element is removable.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Configuration.ConfigurationElement" /> element whose removable property is queried.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/IConfigMapPath.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/IConfigMapPath.xml
index b8b947833c9..8c770519fe8 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/IConfigMapPath.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/IConfigMapPath.xml
@@ -32,7 +32,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -42,6 +41,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the virtual-directory name associated with a specific site.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <paramref name="siteID" /> must be unique. No two sites share the same id. The <paramref name="siteID" /> distinguishes sites that have the same name.</para>
+        </returns>
         <param name="siteID">
           <attribution license="cc4" from="Microsoft" modified="false" />A unique identifier for the site.</param>
         <param name="path">
@@ -79,7 +82,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -89,6 +91,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the machine-configuration file name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The machine-configuration file name.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetPathConfigFilename">
@@ -126,7 +132,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -136,6 +141,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the name of the configuration file at the Web root.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the configuration file at the Web root.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MapPath">
@@ -152,7 +161,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -162,6 +170,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the physical directory path based on the site ID and URL associated with the site.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The physical directory path.</para>
+        </returns>
         <param name="siteID">
           <attribution license="cc4" from="Microsoft" modified="false" />A unique identifier for the site.</param>
         <param name="path">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/IConfigMapPathFactory.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/IConfigMapPathFactory.xml
index f9d3d8eeb98..50476dc7a94 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/IConfigMapPathFactory.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/IConfigMapPathFactory.xml
@@ -32,7 +32,6 @@
         <Parameter Name="physicalPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -42,6 +41,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the interface for the mapping between configuration-file virtual and physical paths. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.Configuration.IConfigMapPath" /> object associated with the specified configuration-file path mapping.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The configuration-file virtual path.</param>
         <param name="physicalPath">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/IRemoteWebConfigurationHostServer.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/IRemoteWebConfigurationHostServer.xml
index 12a35527e9d..e5c26b9f43e 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/IRemoteWebConfigurationHostServer.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/IRemoteWebConfigurationHostServer.xml
@@ -47,13 +47,16 @@
         <param name="protection_provider_type">To be added.</param>
         <param name="params_keys">To be added.</param>
         <param name="param_values">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Conditionally encrypts or decrypts the value of the string referenced by the <paramref name="xmlString" /> parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing either the encrypted or decrypted value of the <paramref name="xmlString" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -123,13 +126,16 @@
         <Parameter Name="locationSubPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used internally to support remote access to configuration data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A concatenated string representing the file path of the configuration file.</para>
+        </returns>
         <param name="webLevel">
           <attribution license="cc4" from="Microsoft" modified="false" />The level of the configuration file.</param>
         <param name="path">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/LowerCaseStringConverter.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/LowerCaseStringConverter.xml
index bc9ed2d8e87..5d81a3d7965 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/LowerCaseStringConverter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/LowerCaseStringConverter.xml
@@ -49,7 +49,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -59,6 +58,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether an object can be converted to a lowercase string based on the specified parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the parameters describe an object that can be converted to a lowercase string object; otherwise, false.</para>
+        </returns>
         <param name="ctx">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> interface.</param>
         <param name="type">
@@ -79,7 +82,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -89,6 +91,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether an object can be converted to a lowercase string based on the specified parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the parameters describe an object that can be converted to a lowercase string object; otherwise, false.</para>
+        </returns>
         <param name="ctx">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> interface.</param>
         <param name="type">
@@ -110,7 +116,6 @@
         <Parameter Name="data" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -120,6 +125,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an object from its original value to a lowercase string based on the specified parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A lowercase string object.</para>
+        </returns>
         <param name="ctx">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> interface.</param>
         <param name="ci">
@@ -144,7 +153,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -154,6 +162,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an object to a lowercase string based on the specified parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A lowercase string object.</para>
+        </returns>
         <param name="ctx">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> interface.</param>
         <param name="ci">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/MachineKeyValidationConverter.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/MachineKeyValidationConverter.xml
index f1d05b0cdd1..a9033a225c2 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/MachineKeyValidationConverter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/MachineKeyValidationConverter.xml
@@ -51,7 +51,6 @@
         <Parameter Name="data" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -75,6 +74,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string to the equivalent <see cref="T:System.Web.Configuration.MachineKeyValidation" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The equivalent <see cref="T:System.Web.Configuration.MachineKeyValidation" /> value.</para>
+        </returns>
         <param name="ctx">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is not used.</param>
         <param name="ci">
@@ -99,13 +102,16 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a <see cref="T:System.Web.Configuration.MachineKeyValidation" /> value to the string representation of that value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representing a <see cref="T:System.Web.Configuration.MachineKeyValidation" /> value.</para>
+        </returns>
         <param name="ctx">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is not used.</param>
         <param name="ci">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/NamespaceInfo.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/NamespaceInfo.xml
index 9c99304d9ad..d2f8decd5b3 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/NamespaceInfo.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/NamespaceInfo.xml
@@ -54,13 +54,16 @@
         <Parameter Name="namespaceInformation" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current instance to the passed <see cref="T:System.Web.Configuration.NamespaceInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two objects are identical. </para>
+        </returns>
         <param name="namespaceInformation">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.Configuration.NamespaceInfo" /> object to compare to.</param>
       </Docs>
@@ -76,13 +79,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash value for the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash value for the current instance.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/OutputCacheProfileCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/OutputCacheProfileCollection.xml
index edb8268ca6e..63a936d20da 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/OutputCacheProfileCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/OutputCacheProfileCollection.xml
@@ -140,13 +140,16 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Web.Configuration.OutputCacheProfile" /> element at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.Configuration.OutputCacheProfile" /> element at the specified index.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the <see cref="T:System.Web.Configuration.OutputCacheProfileCollection" /> element. </param>
       </Docs>
@@ -164,13 +167,16 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Web.Configuration.OutputCacheProfile" /> element with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.Configuration.OutputCacheProfile" /> element with the specified name.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Web.Configuration.OutputCacheProfileCollection" /> element.</param>
       </Docs>
@@ -208,13 +214,16 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the key at the specified <see cref="T:System.Web.Configuration.OutputCacheProfileCollection" /> index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The key with the specified <see cref="T:System.Web.Configuration.OutputCacheProfileCollection" /> index.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Configuration.OutputCacheProfileCollection" /> index of the key. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/ProfileGroupSettingsCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/ProfileGroupSettingsCollection.xml
index 2fcbe6d4bbe..5fa43a23a5c 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/ProfileGroupSettingsCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/ProfileGroupSettingsCollection.xml
@@ -157,13 +157,16 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Web.Configuration.ProfileGroupSettings" /> object at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.Configuration.ProfileGroupSettings" /> object at the specified index, or null if there is no object at that index.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the <see cref="T:System.Web.Configuration.ProfileGroupSettings" /> object to get.</param>
       </Docs>
@@ -181,13 +184,16 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Web.Configuration.ProfileGroupSettings" /> object with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.Configuration.ProfileGroupSettings" /> object with the specified name, or null if the name does not exist.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Web.Configuration.ProfileGroupSettings" /> object to get.</param>
       </Docs>
@@ -226,13 +232,16 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the <see cref="T:System.Web.Configuration.ProfileGroupSettings" /> object at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the <see cref="T:System.Web.Configuration.ProfileGroupSettings" /> object at the specified index, or null if there is no object at that index.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of a <see cref="T:System.Web.Configuration.ProfileGroupSettings" /> object.</param>
       </Docs>
@@ -250,13 +259,16 @@
         <Parameter Name="group" Type="System.Web.Configuration.ProfileGroupSettings" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the specified <see cref="T:System.Web.Configuration.ProfileGroupSettings" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified <see cref="T:System.Web.Configuration.ProfileGroupSettings" /> object, or -1 if the specified <see cref="T:System.Web.Configuration.ProfileGroupSettings" /> object is not contained in the collection.</para>
+        </returns>
         <param name="group">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.Configuration.ProfileGroupSettings" /> object in the collection.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/ProfilePropertySettingsCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/ProfilePropertySettingsCollection.xml
index 410009a34c6..af95b7101d5 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/ProfilePropertySettingsCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/ProfilePropertySettingsCollection.xml
@@ -171,13 +171,16 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Web.Configuration.ProfileSection" /> object at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.Configuration.ProfileSection" /> object at the specified index, or null if there is no object at that index.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the <see cref="T:System.Web.Configuration.ProfileSection" /> to get.</param>
       </Docs>
@@ -195,13 +198,16 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Web.Configuration.ProfileSection" /> object with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.Configuration.ProfileSection" /> object with the specified name, or null if the name does not exist.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Web.Configuration.ProfileSection" /> to get.</param>
       </Docs>
@@ -219,13 +225,16 @@
         <Parameter Name="element" Type="System.Configuration.ConfigurationElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the key for the specified configuration element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the element.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Configuration.ConfigurationElement" /> in the collection.</param>
       </Docs>
@@ -243,7 +252,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -253,6 +261,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the name of the <see cref="T:System.Web.Configuration.ProfilePropertySettings" /> at the specified index location.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the <see cref="T:System.Web.Configuration.ProfilePropertySettings" /> at the specified index location.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of a <see cref="T:System.Web.Configuration.ProfilePropertySettings" /> in the collection.</param>
       </Docs>
@@ -270,13 +282,16 @@
         <Parameter Name="propertySettings" Type="System.Web.Configuration.ProfilePropertySettings" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the specified <see cref="T:System.Web.Configuration.ProfilePropertySettings" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified <see cref="T:System.Web.Configuration.ProfilePropertySettings" /> object, or -1 if the object is not found in the collection.</para>
+        </returns>
         <param name="propertySettings">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.Configuration.ProfilePropertySettings" /> object in the collection.</param>
       </Docs>
@@ -337,7 +352,6 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation of <see cref="M:System.Web.Configuration.ProfilePropertySettingsCollection.OnDeserializeUnrecognizedElement(System.String,System.Xml.XmlReader)" /> throws specialized errors if the element name is either "clear" or "group".  After checking for these conditions, the method then explicitly calls its base implementation, the <see cref="M:System.Configuration.ConfigurationElementCollection.OnDeserializeUnrecognizedElement(System.String,System.Xml.XmlReader)" /> method.</para>
@@ -346,6 +360,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Handles the reading of unrecognized configuration elements from a configuration file and causes the configuration system to throw an exception if the element cannot be handled.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the unrecognized element was deserialized successfully; otherwise, false.</para>
+        </returns>
         <param name="elementName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the unrecognized element.</param>
         <param name="reader">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/ProfileSettingsCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/ProfileSettingsCollection.xml
index b1e74adf767..d2d0a3d9992 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/ProfileSettingsCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/ProfileSettingsCollection.xml
@@ -104,13 +104,16 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the collection contains a <see cref="T:System.Web.Configuration.ProfileSettings" /> object with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains a <see cref="T:System.Web.Configuration.ProfileSettings" /> object with the specified <paramref name="name" />; otherwise, false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a <see cref="T:System.Web.Configuration.ProfileSettings" /> object in the collection.</param>
       </Docs>
@@ -166,13 +169,16 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the specified <see cref="T:System.Web.Configuration.ProfileSettings" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified <see cref="T:System.Web.Configuration.ProfileSettings" /> object, or -1 if the object is not found in the collection.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a <see cref="T:System.Web.Configuration.ProfileSettings" /> object in the collection.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/ProvidersHelper.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/ProvidersHelper.xml
index 39957756feb..087966d9351 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/ProvidersHelper.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/ProvidersHelper.xml
@@ -29,13 +29,16 @@
         <Parameter Name="providerType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes and returns a single provider of the given type using the supplied settings.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new provider of the given type using the supplied settings.</para>
+        </returns>
         <param name="providerSettings">
           <attribution license="cc4" from="Microsoft" modified="false" />The settings to be passed to the provider upon initialization.</param>
         <param name="providerType">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/RegexWorker.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/RegexWorker.xml
index 209110ca3b7..cabc2d46fb6 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/RegexWorker.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/RegexWorker.xml
@@ -69,13 +69,16 @@
         <Parameter Name="regexExpression" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used internally at run time to determine whether the specified request-header value matches any of the capabilities of an internal collection of browsers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified request-header value matches any of the capabilities of an internal collection of browsers; otherwise, false. The default is false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The capabilities value from an internal collection of browsers.</param>
         <param name="regexExpression">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/RootProfilePropertySettingsCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/RootProfilePropertySettingsCollection.xml
index c803d3be96a..a90c4edbb0b 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/RootProfilePropertySettingsCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/RootProfilePropertySettingsCollection.xml
@@ -122,7 +122,6 @@
       </Parameters>
       <Docs>
         <param name="obj">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -132,6 +131,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current <see cref="T:System.Web.Configuration.RootProfilePropertySettingsCollection" /> object to another A <see cref="T:System.Web.Configuration.RootProfilePropertySettingsCollection" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the passed <see cref="T:System.Web.Configuration.RootProfilePropertySettingsCollection" /> object is equal to the current object; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -145,7 +148,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -155,6 +157,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a hash code for the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Unique integer hash code for the current object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -198,12 +204,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the collection has been modified since it was last saved or loaded.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if any contained element has been modified; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="OnDeserializeUnrecognizedElement">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/RuleSettingsCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/RuleSettingsCollection.xml
index a128f793387..2dd98ed67ba 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/RuleSettingsCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/RuleSettingsCollection.xml
@@ -104,7 +104,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -114,6 +113,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns true if the collection contains a <see cref="T:System.Web.Configuration.RuleSettings" /> object with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains a <see cref="T:System.Web.Configuration.RuleSettings" /> object with the specified name; otherwise, false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a <see cref="T:System.Web.Configuration.RuleSettings" /> object in the collection.</param>
       </Docs>
@@ -175,7 +178,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -185,6 +187,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds the index of a <see cref="T:System.Web.Configuration.RuleSettings" /> object in the collection with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of a <see cref="T:System.Web.Configuration.RuleSettings" /> object in the collection with the specified name.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a <see cref="T:System.Web.Configuration.RuleSettings" /> object in the collection.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/SqlCacheDependencyDatabaseCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/SqlCacheDependencyDatabaseCollection.xml
index fb3c2423e0d..b17fee785c5 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/SqlCacheDependencyDatabaseCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/SqlCacheDependencyDatabaseCollection.xml
@@ -120,7 +120,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -130,6 +129,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Web.Configuration.SqlCacheDependencyDatabase" /> element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Web.Configuration.SqlCacheDependencyDatabase" /> element.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -145,7 +148,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -155,6 +157,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Web.Configuration.SqlCacheDependencyDatabaseCollection" /> element at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.Configuration.SqlCacheDependencyDatabaseCollection" /> element at the specified index.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the <see cref="T:System.Web.Configuration.SqlCacheDependencyDatabaseCollection" /> element to retrieve.</param>
       </Docs>
@@ -172,7 +178,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -182,6 +187,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Web.Configuration.SqlCacheDependencyDatabaseCollection" /> element with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.Configuration.SqlCacheDependencyDatabaseCollection" /> element with the specified name.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Web.Configuration.SqlCacheDependencyDatabaseCollection" /> element to retrieve.</param>
       </Docs>
@@ -219,7 +228,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -229,6 +237,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the key for the element located at the specified index in the <see cref="T:System.Web.Configuration.SqlCacheDependencyDatabaseCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The key at the specified index.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the key to return.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/TagMapInfo.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/TagMapInfo.xml
index f25f97861fb..a1f70afadfa 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/TagMapInfo.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/TagMapInfo.xml
@@ -59,13 +59,16 @@
       </Parameters>
       <Docs>
         <param name="map">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this instance to another object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the objects are identical; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -79,13 +82,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash value for the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash value for the current instance.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/TagPrefixInfo.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/TagPrefixInfo.xml
index 7eb108443ca..30a678dd93e 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/TagPrefixInfo.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/TagPrefixInfo.xml
@@ -131,13 +131,16 @@
         <Parameter Name="prefix" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this instance to another object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the objects are identical; otherwise, false.</para>
+        </returns>
         <param name="prefix">
           <attribution license="cc4" from="Microsoft" modified="false" />Object to compare.</param>
       </Docs>
@@ -153,13 +156,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash value for the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash value for the current instance.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/TransformerInfo.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/TransformerInfo.xml
index c8bb49ccfd0..2dd19343ae1 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/TransformerInfo.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/TransformerInfo.xml
@@ -58,13 +58,16 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current <see cref="T:System.Web.Configuration.TransformerInfo" /> object to another <see cref="T:System.Web.Configuration.TransformerInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the passed object is equal to the current object; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to the current object.</param>
       </Docs>
@@ -80,13 +83,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a hash code for the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Unique integer hash code for the current object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/TransformerInfoCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/TransformerInfoCollection.xml
index 8015c09d8c6..b5b751b8457 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/TransformerInfoCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/TransformerInfoCollection.xml
@@ -103,13 +103,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Web.Configuration.TransformerInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Web.Configuration.TransformerInfo" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -125,13 +128,16 @@
         <Parameter Name="element" Type="System.Configuration.ConfigurationElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the key of the passed <see cref="T:System.Web.Configuration.TransformerInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The key of the passed <see cref="T:System.Web.Configuration.TransformerInfo" /> object.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Configuration.ConfigurationElement" />. The specified configuration element should be a <see cref="T:System.Web.Configuration.TransformerInfo" /> object that exists in the collection.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/TrustLevelCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/TrustLevelCollection.xml
index ff31ed2f66f..b95e95d5c9d 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/TrustLevelCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/TrustLevelCollection.xml
@@ -115,13 +115,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Web.Configuration.TrustLevelCollection" /> element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Configuration.ConfigurationElement" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -156,13 +159,16 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Web.Configuration.TrustLevel" /> object at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.Configuration.TrustLevel" /> at the specified index.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the <see cref="T:System.Web.Configuration.TrustLevelCollection" />.</param>
       </Docs>
@@ -180,13 +186,16 @@
         <Parameter Name="element" Type="System.Configuration.ConfigurationElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the element key for a specified <see cref="T:System.Configuration.ConfigurationElement" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> that acts as the key for the specified <see cref="T:System.Configuration.ConfigurationElement" />. </para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Configuration.ConfigurationElement" /> for which to get the key.</param>
       </Docs>
@@ -204,13 +213,16 @@
         <Parameter Name="elementname" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies that the specified name is allowed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the name is allowed; otherwise, false.</para>
+        </returns>
         <param name="elementname">
           <attribution license="cc4" from="Microsoft" modified="false" />The element name to check.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/UrlMappingCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/UrlMappingCollection.xml
index 63416e75ae9..532c648719d 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/UrlMappingCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/UrlMappingCollection.xml
@@ -176,13 +176,16 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the collection key of the specified element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representing the value of the key. </para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The collection index of the element to get.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/VirtualDirectoryMappingCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/VirtualDirectoryMappingCollection.xml
index 934d3c134a5..37921fbb4d5 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/VirtualDirectoryMappingCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/VirtualDirectoryMappingCollection.xml
@@ -137,13 +137,16 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the specified <see cref="T:System.Web.Configuration.VirtualDirectoryMapping" /> collection element at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.Configuration.VirtualDirectoryMapping" /> element at the specified index.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer value that specifies a particular <see cref="T:System.Web.Configuration.VirtualDirectoryMapping" /> object within the <see cref="T:System.Web.Configuration.VirtualDirectoryMappingCollection" />.</param>
       </Docs>
@@ -161,13 +164,16 @@
         <Parameter Name="virtualDirectory" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Web.Configuration.VirtualDirectoryMapping" /> collection element based on the specified virtual-directory name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.Configuration.VirtualDirectoryMapping" /> element based on the specified virtual-directory name.</para>
+        </returns>
         <param name="virtualDirectory">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the name of the <see cref="T:System.Web.Configuration.VirtualDirectoryMapping" /> object.</param>
       </Docs>
@@ -185,13 +191,16 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the key of the entry at the specified index of the <see cref="T:System.Web.Configuration.VirtualDirectoryMappingCollection" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the name of the <see cref="T:System.Web.Configuration.VirtualDirectoryMapping" /> object.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer value that specifies a particular <see cref="T:System.Web.Configuration.VirtualDirectoryMapping" /> object within the <see cref="T:System.Web.Configuration.VirtualDirectoryMappingCollection" />.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/WebConfigurationFileMap.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/WebConfigurationFileMap.xml
index 3777fc419e9..cfd2667e076 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/WebConfigurationFileMap.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/WebConfigurationFileMap.xml
@@ -46,13 +46,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of a <see cref="T:System.Web.Configuration.WebConfigurationFileMap" /> class with the same value as the existing instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of a <see cref="T:System.Web.Configuration.WebConfigurationFileMap" /> class.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/WebConfigurationManager.xml b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/WebConfigurationManager.xml
index df56cd5020d..2ae2b9a7b40 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Configuration/WebConfigurationManager.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Configuration/WebConfigurationManager.xml
@@ -93,7 +93,6 @@
         <Parameter Name="sectionName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -110,6 +109,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the specified configuration section from the current Web application's configuration file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified configuration section object, or null if the section does not exist. Remember that security restrictions exist on the use of <see cref="M:System.Web.Configuration.WebConfigurationManager.GetSection(System.String)" /> as a runtime operation. You might not be able to access a section at run time for modifications, for example.</para>
+        </returns>
         <param name="sectionName">
           <attribution license="cc4" from="Microsoft" modified="false" />The configuration section name.</param>
       </Docs>
@@ -128,7 +131,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -146,6 +148,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the specified configuration section from the Web application's configuration file at the specified location.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified configuration section object, or null if the section does not exist. Remember that security restrictions exist on the use of <see cref="M:System.Web.Configuration.WebConfigurationManager.GetSection(System.String,System.String)" /> as a run-time operation. You might not be able to access a section at run time for modifications, for instance.</para>
+        </returns>
         <param name="sectionName">
           <attribution license="cc4" from="Microsoft" modified="false" />The configuration section name.</param>
         <param name="path">
@@ -165,7 +171,6 @@
         <Parameter Name="sectionName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -179,6 +184,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the specified configuration section from the current Web application's configuration file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified configuration section object, or null if the section does not exist, or an internal object if the section is not accessible at run time.</para>
+        </returns>
         <param name="sectionName">
           <attribution license="cc4" from="Microsoft" modified="false" />The configuration section name.</param>
       </Docs>
@@ -194,7 +203,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -204,6 +212,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens the machine-configuration file on the current computer as a <see cref="T:System.Configuration.Configuration" /> object to allow read or write operations.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -219,7 +231,6 @@
         <Parameter Name="locationSubPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -229,6 +240,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens the machine-configuration file on the current computer as a <see cref="T:System.Configuration.Configuration" /> object to allow read or write operations.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
+        </returns>
         <param name="locationSubPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The application path to which the machine configuration applies.</param>
       </Docs>
@@ -247,7 +262,6 @@
         <Parameter Name="server" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -257,6 +271,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens the specified machine-configuration file on the specified server as a <see cref="T:System.Configuration.Configuration" /> object to allow read or write operations.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
+        </returns>
         <param name="locationSubPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The application path to which the configuration applies.</param>
         <param name="server">
@@ -278,7 +296,6 @@
         <Parameter Name="userToken" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -291,6 +308,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens the specified machine-configuration file on the specified server as a <see cref="T:System.Configuration.Configuration" /> object, using the specified security context to allow read or write operations.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
+        </returns>
         <param name="locationSubPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The application path to which the configuration applies.</param>
         <param name="server">
@@ -315,7 +336,6 @@
         <Parameter Name="password" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -325,6 +345,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens the specified machine-configuration file on the specified server as a <see cref="T:System.Configuration.Configuration" /> object, using the specified security context to allow read or write operations.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
+        </returns>
         <param name="locationSubPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The application path to which the configuration applies. </param>
         <param name="server">
@@ -348,13 +372,16 @@
         <Parameter Name="fileMap" Type="System.Configuration.ConfigurationFileMap" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens the machine-configuration file as a <see cref="T:System.Configuration.Configuration" /> object, using the specified file mapping to allow read or write operations. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
+        </returns>
         <param name="fileMap">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Configuration.ConfigurationFileMap" /> object to use in place of the default machine-configuration file.</param>
       </Docs>
@@ -373,13 +400,16 @@
         <Parameter Name="locationSubPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens the machine-configuration file as a <see cref="T:System.Configuration.Configuration" /> object using the specified file mapping and location to allow read or write operations.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
+        </returns>
         <param name="fileMap">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Configuration.ConfigurationFileMap" /> object to use in place of a default machine-configuration file.</param>
         <param name="locationSubPath">
@@ -400,7 +430,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -410,6 +439,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens the specified Web-application configuration file as a <see cref="T:System.Configuration.Configuration" /> object using the specified file mapping and virtual path to allow read or write operations.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
+        </returns>
         <param name="fileMap">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Configuration.WebConfigurationFileMap" /> object to use in place of a default Web-application configuration file.</param>
         <param name="path">
@@ -431,7 +464,6 @@
         <Parameter Name="site" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -441,6 +473,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens the specified Web application configuration file as a <see cref="T:System.Configuration.Configuration" /> object using the specified file mapping, virtual path, and site name to allow read or write operations.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
+        </returns>
         <param name="fileMap">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Configuration.WebConfigurationFileMap" /> object to use in place of a default Web-application configuration-file mapping.</param>
         <param name="path">
@@ -465,7 +501,6 @@
         <Parameter Name="locationSubPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -475,6 +510,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens the specified Web-application configuration file as a <see cref="T:System.Configuration.Configuration" /> object using the specified file mapping, virtual path, site name, and location to allow read or write operations.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
+        </returns>
         <param name="fileMap">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Configuration.WebConfigurationFileMap" /> object to use in place of a default Web-application configuration-file mapping.</param>
         <param name="path">
@@ -498,7 +537,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -508,6 +546,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens the Web-application configuration file as a <see cref="T:System.Configuration.Configuration" /> object using the specified virtual path to allow read or write operations.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path to the configuration file. If null, the root Web.config file is opened.</param>
       </Docs>
@@ -526,7 +568,6 @@
         <Parameter Name="site" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -536,6 +577,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens the Web-application configuration file as a <see cref="T:System.Configuration.Configuration" /> object using the specified virtual path and site name to allow read or write operations.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path to the configuration file. </param>
         <param name="site">
@@ -557,7 +602,6 @@
         <Parameter Name="locationSubPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -567,6 +611,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens the Web-application configuration file as a <see cref="T:System.Configuration.Configuration" /> object using the specified virtual path, site name, and location to allow read or write operations.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path to the configuration file. </param>
         <param name="site">
@@ -591,7 +639,6 @@
         <Parameter Name="server" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -601,6 +648,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens the Web-application configuration file as a <see cref="T:System.Configuration.Configuration" /> object using the specified virtual path, site name, location, and server to allow read or write operations.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path to the configuration file. </param>
         <param name="site">
@@ -628,7 +679,6 @@
         <Parameter Name="userToken" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -642,6 +692,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens the Web-application configuration file as a <see cref="T:System.Configuration.Configuration" /> object using the specified virtual path, site name, location, server, and security context to allow read or write operations.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path to the configuration file. </param>
         <param name="site">
@@ -672,7 +726,6 @@
         <Parameter Name="password" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -684,6 +737,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens the Web-application configuration file as a <see cref="T:System.Configuration.Configuration" /> object using the specified virtual path, site name, location, server, and security context to allow read or write operations.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path to the configuration file. </param>
         <param name="site">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Hosting/AppDomainFactory.xml b/mcs/class/System.Web/Documentation/en/System.Web.Hosting/AppDomainFactory.xml
index 549bb75ecc3..571d1111099 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Hosting/AppDomainFactory.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Hosting/AppDomainFactory.xml
@@ -57,12 +57,15 @@
         <Parameter Name="iZone" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new application domain for the specified Web application. This class was used by earlier versions of the .NET Framework than version 2.0, which uses the <see cref="T:System.Web.Hosting.AppManagerAppDomainFactory" /> class instead.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new application domain.</para>
+        </returns>
         <param name="module">
           <attribution license="cc4" from="Microsoft" modified="false" />The module containing the Web application.</param>
         <param name="typeName">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Hosting/AppManagerAppDomainFactory.xml b/mcs/class/System.Web/Documentation/en/System.Web.Hosting/AppManagerAppDomainFactory.xml
index 7f6430cf6d8..0a45f6ba717 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Hosting/AppManagerAppDomainFactory.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Hosting/AppManagerAppDomainFactory.xml
@@ -49,13 +49,16 @@
         <Parameter Name="appPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new application domain for the specified Web application.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new application domain for the specified Web application.</para>
+        </returns>
         <param name="appId">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique identifier for the new Web application.</param>
         <param name="appPath">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Hosting/ApplicationHost.xml b/mcs/class/System.Web/Documentation/en/System.Web.Hosting/ApplicationHost.xml
index 75f060f9abd..153d863e827 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Hosting/ApplicationHost.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Hosting/ApplicationHost.xml
@@ -37,12 +37,15 @@
         <Parameter Name="physicalDir" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and configures an application domain for hosting ASP.NET.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of a user-supplied class used to marshal calls into the newly created application domain.</para>
+        </returns>
         <param name="hostType">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a user-supplied class to be created in the new application domain.</param>
         <param name="virtualDir">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Hosting/ApplicationManager.xml b/mcs/class/System.Web/Documentation/en/System.Web.Hosting/ApplicationManager.xml
index 5aec15ee952..ac8c3044d5d 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Hosting/ApplicationManager.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Hosting/ApplicationManager.xml
@@ -71,7 +71,6 @@
         <Parameter Name="failIfExists" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -85,6 +84,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an object for the specified application domain based on type, virtual and physical paths, and a Boolean value indicating failure behavior when an object of the specified type already exists.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new object of the specified <paramref name="type" />.</para>
+        </returns>
         <param name="appId">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique identifier for the application that owns the object.</param>
         <param name="type">
@@ -115,7 +118,6 @@
         <Parameter Name="throwOnError" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -125,6 +127,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an object for the specified application domain based on type, virtual and physical paths, a Boolean value indicating failure behavior when an object of the specified type already exists, and a Boolean value indicating whether hosting initialization error exceptions are thrown.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new object of the specified <paramref name="type" />.</para>
+        </returns>
         <param name="appId">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique identifier for the application that owns the object.</param>
         <param name="type">
@@ -150,7 +156,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -160,6 +165,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the single instance of the <see cref="T:System.Web.Hosting.ApplicationManager" /> object associated with this ASP.NET host process.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The single instance of the <see cref="T:System.Web.Hosting.ApplicationManager" /> object associated with the ASP.NET host process that is running.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -176,13 +185,16 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the registered object of the specified type from the specified application.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The registered object of the specified type; or null if the type has not been registered through a call to the <see cref="M:System.Web.Hosting.ApplicationManager.CreateObject(System.String,System.Type,System.String,System.String,System.Boolean)" /> method.</para>
+        </returns>
         <param name="appId">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique identifier for the application that owns the object.</param>
         <param name="type">
@@ -200,13 +212,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a snapshot of running applications.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Web.Hosting.ApplicationInfo" /> objects that contain information about the applications managed by this <see cref="T:System.Web.Hosting.ApplicationManager" /> instance.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -220,7 +235,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -230,6 +244,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gives the application domain an infinite lifetime by preventing a lease from being created.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -243,7 +261,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -253,6 +270,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether all applications hosted by the process are idle and not processing requests.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if all applications in the process are idle; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Hosting/HostingEnvironment.xml b/mcs/class/System.Web/Documentation/en/System.Web.Hosting/HostingEnvironment.xml
index d7cd0665be3..c8735c065cf 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Hosting/HostingEnvironment.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Hosting/HostingEnvironment.xml
@@ -154,13 +154,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Impersonates the user represented by the application identity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IDisposable" /> object that represents the Windows user prior to impersonation; this object can be used to revert to the original user's context.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -176,13 +179,16 @@
         <Parameter Name="token" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Impersonates the user represented by the specified user token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IDisposable" /> object that represents the Windows user prior to impersonation; this object can be used to revert to the original user's context.</para>
+        </returns>
         <param name="token">
           <attribution license="cc4" from="Microsoft" modified="false" />The handle of a Windows account token.</param>
       </Docs>
@@ -201,7 +207,6 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -211,6 +216,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Impersonates the user specified by the configuration settings for the specified virtual path, or the specified user token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IDisposable" /> object that represents the Windows user prior to impersonation; this object can be used to revert to the original user's context.</para>
+        </returns>
         <param name="userToken">
           <attribution license="cc4" from="Microsoft" modified="false" />The handle of a Windows account token.</param>
         <param name="virtualPath">
@@ -271,7 +280,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -281,6 +289,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gives the <see cref="T:System.Web.Hosting.HostingEnvironment" /> object an infinite lifetime by preventing a lease from being created.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -339,13 +351,16 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Maps a virtual path to a physical path on the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The physical path on the server specified by <paramref name="virtualPath" />.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path (absolute or relative).</param>
       </Docs>
@@ -432,7 +447,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -442,6 +456,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the current thread to the culture specified in the application configuration file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IDisposable" /> object that represents the culture prior to changing; this object can be used to revert to the previous culture.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -457,7 +475,6 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -467,6 +484,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the current thread to the culture of the specified virtual path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IDisposable" /> object that represents the culture prior to changing; this object can be used to revert to the previous culture.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The path that contains the culture information.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Hosting/IAppDomainFactory.xml b/mcs/class/System.Web/Documentation/en/System.Web.Hosting/IAppDomainFactory.xml
index 7ef19417ec0..6f011fbbe71 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Hosting/IAppDomainFactory.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Hosting/IAppDomainFactory.xml
@@ -41,12 +41,15 @@
         <Parameter Name="iZone" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new application domain for the specified Web application. This interface was used by .NET Framework versions earlier than 2.0; version 2.0 uses the <see cref="T:System.Web.Hosting.IAppManagerAppDomainFactory" /> interface instead.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new application domain for the specified Web application.</para>
+        </returns>
         <param name="module">
           <attribution license="cc4" from="Microsoft" modified="false" />The module containing the Web application.</param>
         <param name="typeName">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Hosting/IAppManagerAppDomainFactory.xml b/mcs/class/System.Web/Documentation/en/System.Web.Hosting/IAppManagerAppDomainFactory.xml
index fd68440dc0c..4ff0972889a 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Hosting/IAppManagerAppDomainFactory.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Hosting/IAppManagerAppDomainFactory.xml
@@ -36,13 +36,16 @@
       <Docs>
         <param name="s">To be added.</param>
         <param name="app_id">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new application domain for the specified Web application.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new application domain for the specified Web application.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Hosting/IISAPIRuntime.xml b/mcs/class/System.Web/Documentation/en/System.Web.Hosting/IISAPIRuntime.xml
index 8fc2fda4871..589553e1413 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Hosting/IISAPIRuntime.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Hosting/IISAPIRuntime.xml
@@ -56,12 +56,15 @@
         <Parameter Name="useProcessModel" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Web.HttpWorkerRequest" /> object to process the current request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>0 if <see cref="T:System.Web.HttpWorkerRequest" /> was created successfully; otherwise, 1.</para>
+        </returns>
         <param name="ecb">
           <attribution license="cc4" from="Microsoft" modified="false" />An ISAPI extension control block.</param>
         <param name="useProcessModel">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Hosting/ISAPIRuntime.xml b/mcs/class/System.Web/Documentation/en/System.Web.Hosting/ISAPIRuntime.xml
index d9ad417b826..a429b4adad9 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Hosting/ISAPIRuntime.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Hosting/ISAPIRuntime.xml
@@ -75,12 +75,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gives the <see cref="T:System.Web.Hosting.ISAPIRuntime" /> object an infinite lifetime by preventing a lease from being created. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>null to prevent a lease from being created.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ProcessRequest">
@@ -94,12 +97,15 @@
         <Parameter Name="iWRType" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Web.HttpWorkerRequest" /> object to process the current request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>0 if <see cref="T:System.Web.HttpWorkerRequest" /> was created successfully; otherwise, 1.</para>
+        </returns>
         <param name="ecb">
           <attribution license="cc4" from="Microsoft" modified="false" />An ISAPI extension control block.</param>
         <param name="iWRType">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Hosting/SimpleWorkerRequest.xml b/mcs/class/System.Web/Documentation/en/System.Web.Hosting/SimpleWorkerRequest.xml
index d71b2ca7b52..c75dec72385 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Hosting/SimpleWorkerRequest.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Hosting/SimpleWorkerRequest.xml
@@ -140,12 +140,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the virtual path to the currently executing server application.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The virtual path of the current application.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -160,12 +163,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the UNC-translated path to the currently executing server application.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The physical path of the current application.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -180,12 +186,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the physical path to the requested URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The physical path to the requested URI.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -200,12 +209,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the physical file path to the requested URI (and translates it from virtual path to physical path: for example, "/proj1/page.aspx" to "c:\dir\page.aspx") </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The translated physical file path to the requested URI.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -220,12 +232,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the HTTP request verb.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The HTTP verb for this request.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -240,12 +255,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the HTTP version string of the request (for example, "HTTP/1.1").</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The HTTP version string returned in the request header.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -260,12 +278,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the server IP address of the interface on which the request was received.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The server IP address of the interface on which the request was received.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -280,12 +301,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Int32" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the port number on which the request was received.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The server port number on which the request was received.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -300,12 +324,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>Path info is a string which follows the script name in the URI of the request. For example, if the script name is 'foo.aspx' and the URI is '/somedir/foo.aspx/bar/baz', then the path info is '/bar/baz'.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns additional path information for a resource with a URL extension. That is, for the path /virdir/page.html/tail, the return value is /tail.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Additional path information for a resource.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -320,12 +347,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the query string specified in the request URL.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The request query string.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -340,12 +370,19 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the URL path contained in the header with the query string appended.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The raw URL path of the request header.</para>
+          <block subset="none" type="note">
+            <para>The returned URL is not normalized. Using the URL for access control, or security-sensitive decisions can expose your application to canonicalization security vulnerabilities.</para>
+          </block>
+          <para />
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -360,12 +397,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the IP address of the client.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The client's IP address.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -380,12 +420,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>A <see cref="T:System.Int32" /> containing the port number of the remote endpoint.</returns>
         <remarks>When a client (web browser) connects to a server, it is assigned a port to communicate over. This value represents that port.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the client's port number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The client's port number.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -402,12 +445,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a single server variable from a dictionary of server variables associated with the request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The requested server variable.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the requested server variable. </param>
       </Docs>
@@ -424,12 +470,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the virtual path to the requested URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The path to the requested URI.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -444,12 +493,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.IntPtr" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the client's impersonation token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value representing the client's impersonation token. The default is <see cref="F:System.IntPtr.Zero" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -506,12 +558,15 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the physical path corresponding to the specified virtual path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The physical path that corresponds to the virtual path specified in the <paramref name="path" /> parameter.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Hosting/VirtualFile.xml b/mcs/class/System.Web/Documentation/en/System.Web.Hosting/VirtualFile.xml
index efd2dd72884..f617bafe313 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Hosting/VirtualFile.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Hosting/VirtualFile.xml
@@ -68,7 +68,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -78,6 +77,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns a read-only stream to the virtual resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A read-only stream to the virtual file.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Hosting/VirtualFileBase.xml b/mcs/class/System.Web/Documentation/en/System.Web.Hosting/VirtualFileBase.xml
index 34b2806f95f..b0fd4dbe3de 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Hosting/VirtualFileBase.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Hosting/VirtualFileBase.xml
@@ -48,7 +48,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -58,6 +57,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gives a <see cref="T:System.Web.Hosting.VirtualFileBase" /> instance an infinite lifetime by preventing a lease from being created.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Hosting/VirtualPathProvider.xml b/mcs/class/System.Web/Documentation/en/System.Web.Hosting/VirtualPathProvider.xml
index 449bd5ef9aa..966be08a482 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Hosting/VirtualPathProvider.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Hosting/VirtualPathProvider.xml
@@ -93,7 +93,6 @@
         <Parameter Name="relativePath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -104,6 +103,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Combines a base path with a relative path to return a complete path to a virtual resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The complete path to a virtual resource.</para>
+        </returns>
         <param name="basePath">
           <attribution license="cc4" from="Microsoft" modified="false" />The base path for the application.</param>
         <param name="relativePath">
@@ -123,7 +126,6 @@
         <Parameter Name="virtualDir" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -137,6 +139,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether a directory exists in the virtual file system.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the directory exists in the virtual file system; otherwise, false.</para>
+        </returns>
         <param name="virtualDir">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to the virtual directory.</param>
       </Docs>
@@ -154,7 +160,6 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -164,6 +169,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether a file exists in the virtual file system.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the file exists in the virtual file system; otherwise, false.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to the virtual file.</param>
       </Docs>
@@ -183,7 +192,6 @@
         <Parameter Name="utcStart" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -193,6 +201,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a cache dependency based on the specified virtual paths.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Caching.CacheDependency" /> object for the specified virtual resources.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to the primary virtual resource.</param>
         <param name="virtualPathDependencies">
@@ -214,7 +226,6 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -224,6 +235,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a cache key to use for the specified virtual path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A cache key for the specified virtual resource.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to the virtual resource.</param>
       </Docs>
@@ -241,7 +256,6 @@
         <Parameter Name="virtualDir" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -255,6 +269,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a virtual directory from the virtual file system.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A descendent of the <see cref="T:System.Web.Hosting.VirtualDirectory" /> class that represents a directory in the virtual file system.</para>
+        </returns>
         <param name="virtualDir">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to the virtual directory.</param>
       </Docs>
@@ -272,7 +290,6 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -282,6 +299,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a virtual file from the virtual file system.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A descendent of the <see cref="T:System.Web.Hosting.VirtualFile" /> class that represents a file in the virtual file system.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to the virtual file.</param>
       </Docs>
@@ -300,7 +321,6 @@
         <Parameter Name="virtualPathDependencies" Type="System.Collections.IEnumerable" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -310,6 +330,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash of the specified virtual paths.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash of the specified virtual paths.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to the primary virtual resource.</param>
         <param name="virtualPathDependencies">
@@ -349,7 +373,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -359,6 +382,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gives the <see cref="T:System.Web.Hosting.VirtualPathProvider" /> object an infinite lifetime by preventing a lease from being created.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -374,7 +401,6 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -384,6 +410,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a stream from a virtual file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A read-only <see cref="T:System.IO.Stream" /> object for the specified virtual file or resource.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to the virtual file.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Management/IWebEventCustomEvaluator.xml b/mcs/class/System.Web/Documentation/en/System.Web.Management/IWebEventCustomEvaluator.xml
index 45996b4a6c5..28d974edf4f 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Management/IWebEventCustomEvaluator.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Management/IWebEventCustomEvaluator.xml
@@ -34,7 +34,6 @@
       </Parameters>
       <Docs>
         <param name="raised_event">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -44,6 +43,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates whether an event should be raised.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the event should be raised; otherwise, false.</para>
+        </returns>
         <param name="record">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Management.RuleFiringRecord" /> containing information about the event. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Management/WebApplicationInformation.xml b/mcs/class/System.Web/Documentation/en/System.Web.Management/WebApplicationInformation.xml
index 437520a57ea..7e38d91c1e6 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Management/WebApplicationInformation.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Management/WebApplicationInformation.xml
@@ -156,7 +156,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -169,6 +168,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Formats event information for display purposes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The event information.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Management/WebBaseEvent.xml b/mcs/class/System.Web/Documentation/en/System.Web.Management/WebBaseEvent.xml
index 00614685326..360db895ce4 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Management/WebBaseEvent.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Management/WebBaseEvent.xml
@@ -354,7 +354,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -367,6 +366,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Formats event information for display purposes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The event information.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -385,7 +388,6 @@
       <Docs>
         <param name="include_app_info">To be added.</param>
         <param name="include_custom_event_details">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -398,6 +400,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Formats event information for display purposes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The event information.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Management/WebEventFormatter.xml b/mcs/class/System.Web/Documentation/en/System.Web.Management/WebEventFormatter.xml
index 06d96162d34..1f3ca1d2b48 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Management/WebEventFormatter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Management/WebEventFormatter.xml
@@ -101,7 +101,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -111,6 +110,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the event information in string format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The event information.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Profile/CustomProviderDataAttribute.xml b/mcs/class/System.Web/Documentation/en/System.Web.Profile/CustomProviderDataAttribute.xml
index b9d28570978..113192fdee1 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Profile/CustomProviderDataAttribute.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Profile/CustomProviderDataAttribute.xml
@@ -80,7 +80,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -90,6 +89,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the <see cref="P:System.Web.Profile.CustomProviderDataAttribute.CustomProviderData" /> property is set to the default value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="P:System.Web.Profile.CustomProviderDataAttribute.CustomProviderData" /> property is set to the default value; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Profile/ProfileBase.xml b/mcs/class/System.Web/Documentation/en/System.Web.Profile/ProfileBase.xml
index cfcfc4519c2..fd67e64c83d 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Profile/ProfileBase.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Profile/ProfileBase.xml
@@ -55,7 +55,6 @@
         <Parameter Name="username" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -66,6 +65,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used by ASP.NET to create an instance of a profile for the specified user name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.Profile.ProfileBase" /> that represents the profile for the specified user.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the user to create a profile for.</param>
       </Docs>
@@ -84,7 +87,6 @@
         <Parameter Name="isAuthenticated" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -95,6 +97,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used by ASP.NET to create an instance of a profile for the specified user name. Takes a parameter indicating whether the user is authenticated or anonymous.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Profile.ProfileBase" /> object that represents the profile for the specified user.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the user to create a profile for.</param>
         <param name="isAuthenticated">
@@ -114,7 +120,6 @@
         <Parameter Name="groupName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -124,6 +129,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a group of properties identified by a group name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Profile.ProfileGroupBase" /> object for a group of properties configured with the specified group name.</para>
+        </returns>
         <param name="groupName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the group of properties.</param>
       </Docs>
@@ -141,7 +150,6 @@
         <Parameter Name="propertyName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -152,6 +160,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of a profile property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified profile property, typed as object.</para>
+        </returns>
         <param name="propertyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the profile property.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Profile/ProfileGroupBase.xml b/mcs/class/System.Web/Documentation/en/System.Web.Profile/ProfileGroupBase.xml
index 09edaa4ab9b..489fc1a3bb9 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Profile/ProfileGroupBase.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Profile/ProfileGroupBase.xml
@@ -53,7 +53,6 @@
         <Parameter Name="propertyName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -64,6 +63,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of a grouped profile property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the grouped profile property typed as object.</para>
+        </returns>
         <param name="propertyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the grouped profile property.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Profile/ProfileInfoCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.Profile/ProfileInfoCollection.xml
index e6597f0bfc3..27adfdcad57 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Profile/ProfileInfoCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Profile/ProfileInfoCollection.xml
@@ -175,7 +175,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -185,6 +184,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an enumerator that can iterate through the <see cref="T:System.Web.Profile.ProfileInfoCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the entire <see cref="T:System.Web.Profile.ProfileInfoCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Profile/ProfileManager.xml b/mcs/class/System.Web/Documentation/en/System.Web.Profile/ProfileManager.xml
index 855fe79df7b..85e4b39d325 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Profile/ProfileManager.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Profile/ProfileManager.xml
@@ -108,7 +108,6 @@
         <Parameter Name="userInactiveSinceDate" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -119,6 +118,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deletes user profile data for which the last activity date and time occurred before the specified date and time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of profiles deleted from the data source.</para>
+        </returns>
         <param name="authenticationOption">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Web.Profile.ProfileAuthenticationOption" /> enumeration values, specifying whether anonymous, authenticated, or both types of profiles are deleted.</param>
         <param name="userInactiveSinceDate">
@@ -138,7 +141,6 @@
         <Parameter Name="username" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -149,6 +151,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deletes the profile for the specified user name from the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the user profile was found and deleted; otherwise, false.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The user name for the profile to be deleted.</param>
       </Docs>
@@ -166,7 +172,6 @@
         <Parameter Name="usernames" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -178,6 +183,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deletes profile properties and information for the supplied list of user names.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of profiles deleted from the data source.</para>
+        </returns>
         <param name="usernames">
           <attribution license="cc4" from="Microsoft" modified="false" />A string array of user names for profiles to be deleted. </param>
       </Docs>
@@ -195,7 +204,6 @@
         <Parameter Name="profiles" Type="System.Web.Profile.ProfileInfoCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -207,6 +215,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deletes profile properties and information from the data source for the supplied list of profiles.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of profiles deleted from the data source.</para>
+        </returns>
         <param name="profiles">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.Profile.ProfileInfoCollection" />  that contains profile information for profiles to be deleted.</param>
       </Docs>
@@ -248,7 +260,6 @@
         <Parameter Name="userInactiveSinceDate" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -263,6 +274,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves profile information for all profiles in which the last activity date occurred on or before the specified date and time and the user name for the profile matches the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Profile.ProfileInfoCollection" /> containing user profile information for inactive profiles in which the user name matches the supplied <paramref name="usernameToMatch" /> parameter.</para>
+        </returns>
         <param name="authenticationOption">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Web.Profile.ProfileAuthenticationOption" />  enumeration values, specifying whether anonymous, authenticated, or both types of profiles are returned.</param>
         <param name="usernameToMatch">
@@ -315,7 +330,6 @@
         <Parameter Name="usernameToMatch" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -328,6 +342,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves all profile information for profiles in which the user name matches the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Profile.ProfileInfoCollection" /> containing user profile information for profiles where the user name matches the supplied <paramref name="usernameToMatch" /> parameter.</para>
+        </returns>
         <param name="authenticationOption">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Web.Profile.ProfileAuthenticationOption" />  enumeration values, specifying whether anonymous, authenticated, or both types of profiles are returned.</param>
         <param name="usernameToMatch">
@@ -376,7 +394,6 @@
         <Parameter Name="userInactiveSinceDate" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -388,6 +405,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves all user profile data for profiles in which the last activity date occurred on or before the specified date and time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Profile.ProfileInfoCollection" /> containing user profile information about the inactive profiles.</para>
+        </returns>
         <param name="authenticationOption">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Web.Profile.ProfileAuthenticationOption" /> enumeration values, specifying whether anonymous, authenticated, or both types of profiles are returned.</param>
         <param name="userInactiveSinceDate">
@@ -435,7 +456,6 @@
         <Parameter Name="authenticationOption" Type="System.Web.Profile.ProfileAuthenticationOption" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -447,6 +467,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves user profile data for profiles in the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Profile.ProfileInfoCollection" /> containing user profile information for all of the profiles in the data source.</para>
+        </returns>
         <param name="authenticationOption">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Web.Profile.ProfileAuthenticationOption" /> enumeration values, specifying whether anonymous, authenticated, or both types of profiles are returned.</param>
       </Docs>
@@ -491,7 +515,6 @@
         <Parameter Name="userInactiveSinceDate" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -501,6 +524,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the number of profiles in which the last activity date occurred on or before the specified date.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of profiles in the data source for which the last activity date occurred before the specified date and time.</para>
+        </returns>
         <param name="authenticationOption">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Web.Profile.ProfileAuthenticationOption" /> enumeration values, specifying whether anonymous, authenticated, or both types of profiles are returned.</param>
         <param name="userInactiveSinceDate">
@@ -520,7 +547,6 @@
         <Parameter Name="authenticationOption" Type="System.Web.Profile.ProfileAuthenticationOption" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -530,6 +556,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the number of profiles in the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of profiles in the data source.</para>
+        </returns>
         <param name="authenticationOption">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Web.Profile.ProfileAuthenticationOption" /> enumeration values, specifying whether anonymous, authenticated, or both types of profiles are returned.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Profile/ProfileProvider.xml b/mcs/class/System.Web/Documentation/en/System.Web.Profile/ProfileProvider.xml
index 6525b4a270b..9cfe71045ed 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Profile/ProfileProvider.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Profile/ProfileProvider.xml
@@ -61,7 +61,6 @@
         <Parameter Name="userInactiveSinceDate" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -71,6 +70,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, deletes all user-profile data for profiles in which the last activity date occurred before the specified date.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of profiles deleted from the data source.</para>
+        </returns>
         <param name="authenticationOption">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Web.Profile.ProfileAuthenticationOption" /> values, specifying whether anonymous, authenticated, or both types of profiles are deleted.</param>
         <param name="userInactiveSinceDate">
@@ -90,7 +93,6 @@
         <Parameter Name="usernames" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -100,6 +102,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, deletes profile properties and information for profiles that match the supplied list of user names.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of profiles deleted from the data source.</para>
+        </returns>
         <param name="usernames">
           <attribution license="cc4" from="Microsoft" modified="false" />A string array of user names for profiles to be deleted.</param>
       </Docs>
@@ -117,7 +123,6 @@
         <Parameter Name="profiles" Type="System.Web.Profile.ProfileInfoCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -128,6 +133,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, deletes profile properties and information for the supplied list of profiles.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of profiles deleted from the data source.</para>
+        </returns>
         <param name="profiles">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.Profile.ProfileInfoCollection" />  of information about profiles that are to be deleted.</param>
       </Docs>
@@ -258,7 +267,6 @@
         <Parameter Name="userInactiveSinceDate" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -268,6 +276,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the number of profiles in which the last activity date occurred on or before the specified date.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of profiles in which the last activity date occurred on or before the specified date.</para>
+        </returns>
         <param name="authenticationOption">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Web.Profile.ProfileAuthenticationOption" /> values, specifying whether anonymous, authenticated, or both types of profiles are returned.</param>
         <param name="userInactiveSinceDate">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Profile/SettingsAllowAnonymousAttribute.xml b/mcs/class/System.Web/Documentation/en/System.Web.Profile/SettingsAllowAnonymousAttribute.xml
index 7b58db575fa..22f356f03b0 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Profile/SettingsAllowAnonymousAttribute.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Profile/SettingsAllowAnonymousAttribute.xml
@@ -120,13 +120,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the <see cref="P:System.Web.Profile.SettingsAllowAnonymousAttribute.Allow" /> property is set to the default value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="P:System.Web.Profile.SettingsAllowAnonymousAttribute.Allow" /> property is set to the default value; otherwise false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Profile/SqlProfileProvider.xml b/mcs/class/System.Web/Documentation/en/System.Web.Profile/SqlProfileProvider.xml
index 6162044c36f..0de9c274373 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Profile/SqlProfileProvider.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Profile/SqlProfileProvider.xml
@@ -84,7 +84,6 @@
         <Parameter Name="userInactiveSinceDate" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -95,6 +94,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deletes user profile data for profiles in which the last activity date occurred before the specified date and time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of profiles deleted from the data source.</para>
+        </returns>
         <param name="authenticationOption">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Web.Profile.ProfileAuthenticationOption" /> values, specifying whether anonymous, authenticated, or both types of profiles are deleted.</param>
         <param name="userInactiveSinceDate">
@@ -114,7 +117,6 @@
         <Parameter Name="usernames" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -126,6 +128,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deletes profile properties and information from the data source for the supplied list of user names.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of profiles deleted from the data source.</para>
+        </returns>
         <param name="usernames">
           <attribution license="cc4" from="Microsoft" modified="false" />A string array of user names for profiles to be deleted. </param>
       </Docs>
@@ -143,7 +149,6 @@
         <Parameter Name="profiles" Type="System.Web.Profile.ProfileInfoCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -155,6 +160,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deletes profile properties and information for the supplied list of profiles from the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of profiles deleted from the data source.</para>
+        </returns>
         <param name="profiles">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.Profile.ProfileInfoCollection" />  that contains profile information for profiles to be deleted.</param>
       </Docs>
@@ -285,7 +294,6 @@
         <Parameter Name="userInactiveSinceDate" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -295,6 +303,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the number of profiles in the data source where the last activity date occurred on or before the specified <paramref name="userInactiveSinceDate" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of profiles in the data source for which the last activity date occurred before the specified date and time.</para>
+        </returns>
         <param name="authenticationOption">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Web.Profile.ProfileAuthenticationOption" /> values, specifying whether anonymous, authenticated, or both types of profiles are returned.</param>
         <param name="userInactiveSinceDate">
@@ -315,7 +327,6 @@
         <Parameter Name="properties" Type="System.Configuration.SettingsPropertyCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -325,6 +336,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves profile property information and values from a SQL Server profile database.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Configuration.SettingsPropertyValueCollection" /> containing profile property information and values.</para>
+        </returns>
         <param name="sc">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Configuration.SettingsContext" /> that contains user profile information.</param>
         <param name="properties">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Security/ActiveDirectoryMembershipProvider.xml b/mcs/class/System.Web/Documentation/en/System.Web.Security/ActiveDirectoryMembershipProvider.xml
index 9765f677a67..00fc6b17890 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Security/ActiveDirectoryMembershipProvider.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Security/ActiveDirectoryMembershipProvider.xml
@@ -467,7 +467,6 @@
       <Docs>
         <param name="oldPwd">To be added.</param>
         <param name="newPwd">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -482,6 +481,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Changes the password for the specified user.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para> true if the password was updated successfully; otherwise, false.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the user to update the password for.</param>
       </Docs>
@@ -504,7 +507,6 @@
       <Docs>
         <param name="newPwdQuestion">To be added.</param>
         <param name="newPwdAnswer">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -532,6 +534,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Updates the password question and answer for a user in the Active Directory store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para> true if the update was successful; otherwise, false. A value of false is also returned if the password is incorrect, the user is locked out, or the user does not exist in the Active Directory data store.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The user to change the password question and answer for.</param>
         <param name="password">
@@ -610,7 +616,6 @@
         <Parameter Name="deleteAllRelatedData" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -625,6 +630,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes a user's membership information from the Active Directory data store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para> true if the user was deleted; otherwise, false if the user was not found in the data store.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the user to delete.</param>
         <param name="deleteAllRelatedData">
@@ -794,7 +803,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -810,6 +818,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a random password.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A random password.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -847,7 +859,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -857,6 +868,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Throws a <see cref="T:System.NotSupportedException" /> exception in all cases.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.NotSupportedException" /> in all cases.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -874,7 +889,6 @@
       </Parameters>
       <Docs>
         <param name="answer">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -884,6 +898,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the password of the specified user from the database. The <see cref="T:System.Web.Security.ActiveDirectoryMembershipProvider" /> class does not support this method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always throws a <see cref="T:System.NotSupportedException" /> exception.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The user to retrieve the password for.</param>
       </Docs>
@@ -902,7 +920,6 @@
         <Parameter Name="userIsOnline" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -914,6 +931,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the membership user information associated with the specified user key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Security.MembershipUser" /> instance representing the user specified. If no user is found in the Active Directory data store for the specified <paramref name="providerUserKey" /> value, null is returned.</para>
+        </returns>
         <param name="providerUserKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique identifier for the user.</param>
         <param name="userIsOnline">
@@ -934,7 +955,6 @@
         <Parameter Name="userIsOnline" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -946,6 +966,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the membership user information associated with the specified user name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Security.MembershipUser" /> instance representing the user specified. If no user is found in the Active Directory data store for the specified <paramref name="username" /> value, null is returned.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the user to get information for.</param>
         <param name="userIsOnline">
@@ -965,7 +989,6 @@
         <Parameter Name="email" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -983,6 +1006,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the user name associated with the specified e-mail address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The user name associated with the specified e-mail address.</para>
+        </returns>
         <param name="email">
           <attribution license="cc4" from="Microsoft" modified="false" />The e-mail address to search for.</param>
       </Docs>
@@ -1255,7 +1282,6 @@
       </Parameters>
       <Docs>
         <param name="answer">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1298,6 +1324,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resets a user's password to a new, automatically generated password.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new password for the specified user.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The user to reset the password for.</param>
       </Docs>
@@ -1316,7 +1346,6 @@
       </Parameters>
       <Docs>
         <param name="userName">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1329,6 +1358,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clears a lock so that a membership user can be validated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para> true if the membership user was successfully unlocked; otherwise, false. The <see cref="M:System.Web.Security.ActiveDirectoryMembershipProvider.UnlockUser(System.String)" /> method also returns false when the membership user is not found in the data store.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1374,7 +1407,6 @@
         <Parameter Name="password" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1430,6 +1462,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies that the specified user name and password exist in the Active Directory data store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para> true if the specified <paramref name="username" /> and <paramref name="password" /> are valid; otherwise, false. If the user specified does not exist in the Active Directory data store, the <see cref="M:System.Web.Security.ActiveDirectoryMembershipProvider.ValidateUser(System.String,System.String)" /> method returns false.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the user to validate.</param>
         <param name="password">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Security/FileAuthorizationModule.xml b/mcs/class/System.Web/Documentation/en/System.Web.Security/FileAuthorizationModule.xml
index 78ef26e13c2..050f334fddb 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Security/FileAuthorizationModule.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Security/FileAuthorizationModule.xml
@@ -64,7 +64,6 @@
         <Parameter Name="verb" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.Security.FileAuthorizationModule.CheckFileAccessForUser(System.String,System.IntPtr,System.String)" /> method checks to see whether the current user, represented by a Windows access token, is granted access to the requested file in the file-system access-control lists (ACLs). The virtual path is mapped to the physical file-system path before the check is made.</para>
@@ -75,6 +74,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the user has access to the requested file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current Windows user represented by <paramref name="token" /> has access to the file using the specified HTTP verb or if the <see cref="T:System.Web.Security.FileAuthorizationModule" /> module is not defined in the application's configuration file; otherwise, false.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path to the file.</param>
         <param name="token">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Security/FormsAuthentication.xml b/mcs/class/System.Web/Documentation/en/System.Web.Security/FormsAuthentication.xml
index ed49a5f04b1..830020b6b0b 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Security/FormsAuthentication.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Security/FormsAuthentication.xml
@@ -66,7 +66,6 @@
         <Parameter Name="password" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The Authenticate method verifies user credentials that are stored in the <format type="text/html"><a href="e5a001f8-fdbe-4c88-80ca-bfe36df23479">credentials</a></format> section of the application configuration file. Alternatively, you can use ASP.NET membership to store user credentials and call the <see cref="M:System.Web.Security.MembershipProvider.ValidateUser(System.String,System.String)" /> to verify the credentials. For more information, see <format type="text/html"><a href="824c3a24-f0af-427c-a652-0d2d1e9397cd">Managing Users By Using ASP.NET Membership</a></format>.</para>
@@ -76,6 +75,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates a user name and password against credentials stored in the configuration file for an application.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the user name and password are valid; otherwise, false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The user name.</param>
         <param name="password">
@@ -176,12 +179,15 @@
         <Parameter Name="encryptedTicket" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>This will return a <see cref="T:System.Web.Security.FormsAuthenticationTicket" /> or if the ticket fails to validate (due to tampering) it will throw an <see cref="T:System.ArgumentException" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Web.Security.FormsAuthenticationTicket" /> object based on the encrypted forms-authentication ticket passed to the method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Security.FormsAuthenticationTicket" /> object. If the <paramref name="encryptedTicket" /> parameter is not a valid ticket, null is returned.</para>
+        </returns>
         <param name="encryptedTicket">
           <attribution license="cc4" from="Microsoft" modified="false" />The encrypted authentication ticket. </param>
       </Docs>
@@ -249,13 +255,6 @@
         <Parameter Name="ticket" Type="System.Web.Security.FormsAuthenticationTicket" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-A string representing the ticket. </para>
-          <para>
-The ticket might be just a string representation of the ticket, a string representation with a checksum or string representation with a checksum and encryption.  Depending on the settings.
-</para>
-        </returns>
         <remarks>
           <para>The actual method to encrypt the data depends on the setting in the "mode" attribute in the &lt;authentication&gt; section in the &lt;system.web&gt; section of the application configuration.
 </para>
@@ -290,6 +289,10 @@ The possible values are:
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a string containing an encrypted forms-authentication ticket suitable for use in an HTTP cookie.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing an encrypted forms-authentication ticket.</para>
+        </returns>
         <param name="ticket">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Security.FormsAuthenticationTicket" /> object with which to create the encrypted forms-authentication ticket. </param>
       </Docs>
@@ -353,7 +356,6 @@ The possible values are:
         <Parameter Name="createPersistentCookie" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Web.HttpCookie" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The path of the cookie is determined by the <see cref="P:System.Web.Security.FormsAuthentication.FormsCookiePath" /> property.</para>
@@ -362,6 +364,10 @@ The possible values are:
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an authentication cookie for a given user name. This does not set the cookie as part of the outgoing response, so that an application can have more control over how the cookie is issued.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.HttpCookie" /> that contains encrypted forms-authentication ticket information. The default value for the <see cref="P:System.Web.Security.FormsAuthentication.FormsCookiePath" /> property is used.</para>
+        </returns>
         <param name="userName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the authenticated user. </param>
         <param name="createPersistentCookie">
@@ -384,12 +390,15 @@ The possible values are:
         <Parameter Name="strCookiePath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Web.HttpCookie" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an authentication cookie for a given user name. This does not set the cookie as part of the outgoing response.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.HttpCookie" /> that contains encrypted forms-authentication ticket information.</para>
+        </returns>
         <param name="userName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the authenticated user. </param>
         <param name="createPersistentCookie">
@@ -413,7 +422,6 @@ The possible values are:
         <Parameter Name="createPersistentCookie" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use this method when you want to perform the redirect in your application code instead of using the <see cref="M:System.Web.Security.FormsAuthentication.RedirectFromLoginPage(System.String,System.Boolean)" /> method.</para>
@@ -428,6 +436,10 @@ The possible values are:
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the redirect URL for the original request that caused the redirect to the login page.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the redirect URL.</para>
+        </returns>
         <param name="userName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the authenticated user. </param>
         <param name="createPersistentCookie">
@@ -449,7 +461,6 @@ The possible values are:
         <Parameter Name="passwordFormat" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>A string that contains the hashed password.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.Security.FormsAuthentication.HashPasswordForStoringInConfigFile(System.String,System.String)" /> method creates a hashed password value that can be used when storing forms-authentication credentials in the configuration file for an application.</para>
@@ -459,6 +470,10 @@ The possible values are:
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces a hash password suitable for storing in a configuration file based on the specified password and hash algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hashed password.</para>
+        </returns>
         <param name="password">
           <attribution license="cc4" from="Microsoft" modified="false" />The password to hash. </param>
         <param name="passwordFormat">
@@ -645,7 +660,6 @@ The possible values are:
         <Parameter Name="tOld" Type="System.Web.Security.FormsAuthenticationTicket" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'FormsAuthenticationTicket'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.Security.FormsAuthentication.RenewTicketIfOld(System.Web.Security.FormsAuthenticationTicket)" /> method updates the expiration date and time of the supplied <see cref="T:System.Web.Security.FormsAuthenticationTicket" /> if the current date and time minus the <see cref="P:System.Web.Security.FormsAuthenticationTicket.IssueDate" /> value is greater than the <see cref="P:System.Web.Security.FormsAuthenticationTicket.Expiration" /> value minus the current date and time.</para>
@@ -655,6 +669,10 @@ The possible values are:
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Conditionally updates the issue date and time and expiration date and time for a <see cref="T:System.Web.Security.FormsAuthenticationTicket" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The updated <see cref="T:System.Web.Security.FormsAuthenticationTicket" />.</para>
+        </returns>
         <param name="tOld">
           <attribution license="cc4" from="Microsoft" modified="false" />The forms-authentication ticket to update.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Security/Membership.xml b/mcs/class/System.Web/Documentation/en/System.Web.Security/Membership.xml
index b965c129a12..f4cf90efec6 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Security/Membership.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Security/Membership.xml
@@ -99,7 +99,6 @@
         <Parameter Name="password" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -114,6 +113,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new user to the data store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Security.MembershipUser" /> object for the newly created user.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The user name for the new user. </param>
         <param name="password">
@@ -135,7 +138,6 @@
         <Parameter Name="email" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -149,6 +151,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new user with a specified e-mail address to the data store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Security.MembershipUser" /> object for the newly created user.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The user name for the new user. </param>
         <param name="password">
@@ -236,7 +242,6 @@
         <Parameter Name="username" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -246,6 +251,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deletes a user and any related user data from the database.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the user was deleted; otherwise, false.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the user to delete. </param>
       </Docs>
@@ -264,7 +273,6 @@
         <Parameter Name="deleteAllRelatedData" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -275,6 +283,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deletes a user from the database.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the user was deleted; otherwise, false.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the user to delete.</param>
         <param name="deleteAllRelatedData">
@@ -339,7 +351,6 @@
         <Parameter Name="emailToMatch" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -351,6 +362,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of membership users where the e-mail address contains the specified e-mail address to match.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Security.MembershipUserCollection" /> that contains all users that match the <paramref name="emailToMatch" /> parameter.</para>
+          <para>Leading and trailing spaces are trimmed from the <paramref name="emailToMatch" /> parameter value.</para>
+        </returns>
         <param name="emailToMatch">
           <attribution license="cc4" from="Microsoft" modified="false" />The e-mail address to search for.</param>
       </Docs>
@@ -395,7 +411,6 @@
       </Parameters>
       <Docs>
         <param name="nameToMatch">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -408,6 +423,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of membership users where the user name contains the specified user name to match.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Security.MembershipUserCollection" /> that contains all users that match the <paramref name="usernameToMatch" /> parameter.</para>
+          <para>Leading and trailing spaces are trimmed from the <paramref name="usernameToMatch" /> parameter value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -450,7 +470,6 @@
         <Parameter Name="numberOfNonAlphanumericCharacters" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -464,6 +483,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a random password of the specified length.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A random password of the specified length.</para>
+        </returns>
         <param name="length">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of characters in the generated password. The length must be between 1 and 128 characters. </param>
         <param name="numberOfNonAlphanumericCharacters">
@@ -481,7 +504,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -492,6 +514,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of all the users in the database.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Security.MembershipUserCollection" /> of <see cref="T:System.Web.Security.MembershipUser" /> objects representing all of the users in the database.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -529,7 +555,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -540,6 +565,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the number of users currently accessing an application.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of users currently accessing an application.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -553,7 +582,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -565,6 +593,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the information from the data source and updates the last-activity date/time stamp for the current logged-on membership user.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Security.MembershipUser" /> object representing the current logged-on user.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -580,7 +612,6 @@
         <Parameter Name="userIsOnline" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -591,6 +622,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the information from the data source for the current logged-on membership user. Updates the last-activity date/time stamp for the current logged-on membership user, if specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Security.MembershipUser" /> object representing the current logged-on user.</para>
+        </returns>
         <param name="userIsOnline">
           <attribution license="cc4" from="Microsoft" modified="false" />If true, updates the last-activity date/time stamp for the specified user. </param>
       </Docs>
@@ -608,7 +643,6 @@
         <Parameter Name="providerUserKey" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -619,6 +653,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the information from the data source for the membership user associated with the specified unique identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Security.MembershipUser" /> object representing the user associated with the specified unique identifier.</para>
+        </returns>
         <param name="providerUserKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique user identifier from the membership data source for the user.</param>
       </Docs>
@@ -636,7 +674,6 @@
         <Parameter Name="username" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -647,6 +684,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the information from the data source for the specified membership user.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Security.MembershipUser" /> object representing the specified user. If the <paramref name="username" /> parameter does not correspond to an existing user, this method returns null.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the user to retrieve.</param>
       </Docs>
@@ -665,7 +706,6 @@
         <Parameter Name="userIsOnline" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -675,6 +715,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the information from the data source for the membership user associated with the specified unique identifier. Updates the last-activity date/time stamp for the user, if specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Security.MembershipUser" /> object representing the user associated with the specified unique identifier.</para>
+        </returns>
         <param name="providerUserKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique user identifier from the membership data source for the user.</param>
         <param name="userIsOnline">
@@ -695,7 +739,6 @@
         <Parameter Name="userIsOnline" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -707,6 +750,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the information from the data source for the specified membership user. Updates the last-activity date/time stamp for the user, if specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Security.MembershipUser" /> object representing the specified user. If the <paramref name="username" /> parameter does not correspond to an existing user, this method returns null.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the user to retrieve. </param>
         <param name="userIsOnline">
@@ -727,7 +774,6 @@
       </Parameters>
       <Docs>
         <param name="email">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -739,6 +785,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a user name where the e-mail address for the user matches the specified e-mail address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The user name where the e-mail address for the user matches the specified e-mail address. If no match is found, null is returned.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1045,7 +1095,6 @@
         <Parameter Name="password" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1056,6 +1105,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies that the supplied user name and password are valid.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the supplied user name and password are valid; otherwise, false.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the user to be validated. </param>
         <param name="password">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Security/MembershipProvider.xml b/mcs/class/System.Web/Documentation/en/System.Web.Security/MembershipProvider.xml
index c1f0a85b793..15df2184906 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Security/MembershipProvider.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Security/MembershipProvider.xml
@@ -93,7 +93,6 @@
         <param name="name">To be added.</param>
         <param name="oldPwd">To be added.</param>
         <param name="newPwd">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -103,6 +102,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a request to update the password for a membership user.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the password was updated successfully; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -124,7 +127,6 @@
         <param name="name">To be added.</param>
         <param name="newPwdQuestion">To be added.</param>
         <param name="newPwdAnswer">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -135,6 +137,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a request to update the password question and answer for a membership user.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the password question and answer are updated successfully; otherwise, false.</para>
+        </returns>
         <param name="password">
           <attribution license="cc4" from="Microsoft" modified="false" />The password for the specified user. </param>
       </Docs>
@@ -186,7 +192,6 @@
         <Parameter Name="encodedPassword" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -196,6 +201,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decrypts an encrypted password.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array that contains the decrypted password.</para>
+        </returns>
         <param name="encodedPassword">
           <attribution license="cc4" from="Microsoft" modified="false" />A byte array that contains the encrypted password to decrypt.</param>
       </Docs>
@@ -215,7 +224,6 @@
       </Parameters>
       <Docs>
         <param name="name">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -225,6 +233,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes a user from the membership data source. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the user was successfully deleted; otherwise, false.</para>
+        </returns>
         <param name="deleteAllRelatedData">
           <attribution license="cc4" from="Microsoft" modified="false" />true to delete data related to the user from the database; false to leave data related to the user in the database.</param>
       </Docs>
@@ -288,7 +300,6 @@
         <Parameter Name="password" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -298,6 +309,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encrypts a password.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array that contains the encrypted password.</para>
+        </returns>
         <param name="password">
           <attribution license="cc4" from="Microsoft" modified="false" />A byte array that contains the password to encrypt.</param>
       </Docs>
@@ -389,7 +404,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -399,6 +413,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the number of users currently accessing the application.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of users currently accessing the application.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -416,7 +434,6 @@
       </Parameters>
       <Docs>
         <param name="name">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -430,6 +447,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the password for the specified user name from the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The password for the specified user name.</para>
+        </returns>
         <param name="answer">
           <attribution license="cc4" from="Microsoft" modified="false" />The password answer for the user. </param>
       </Docs>
@@ -448,7 +469,6 @@
         <Parameter Name="userIsOnline" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -458,6 +478,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets user information from the data source based on the unique identifier for the membership user. Provides an option to update the last-activity date/time stamp for the user.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Security.MembershipUser" /> object populated with the specified user's information from the data source.</para>
+        </returns>
         <param name="providerUserKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique identifier for the membership user to get information for.</param>
         <param name="userIsOnline">
@@ -479,7 +503,6 @@
       </Parameters>
       <Docs>
         <param name="name">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -489,6 +512,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets information from the data source for a user. Provides an option to update the last-activity date/time stamp for the user.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Security.MembershipUser" /> object populated with the specified user's information from the data source.</para>
+        </returns>
         <param name="userIsOnline">
           <attribution license="cc4" from="Microsoft" modified="false" />true to update the last-activity date/time stamp for the user; false to return user information without updating the last-activity date/time stamp for the user. </param>
       </Docs>
@@ -506,7 +533,6 @@
         <Parameter Name="email" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -518,6 +544,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the user name associated with the specified e-mail address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The user name associated with the specified e-mail address. If no match is found, return null.</para>
+        </returns>
         <param name="email">
           <attribution license="cc4" from="Microsoft" modified="false" />The e-mail address to search for. </param>
       </Docs>
@@ -750,7 +780,6 @@
       </Parameters>
       <Docs>
         <param name="name">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -768,6 +797,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resets a user's password to a new, automatically generated password.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new password for the specified user.</para>
+        </returns>
         <param name="answer">
           <attribution license="cc4" from="Microsoft" modified="false" />The password answer for the specified user. </param>
       </Docs>
@@ -785,7 +818,6 @@
         <Parameter Name="userName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -795,6 +827,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clears a lock so that the membership user can be validated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the membership user was successfully unlocked; otherwise, false.</para>
+        </returns>
         <param name="userName">
           <attribution license="cc4" from="Microsoft" modified="false" />The membership user whose lock status you want to clear.</param>
       </Docs>
@@ -840,7 +876,6 @@
       </Parameters>
       <Docs>
         <param name="name">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -851,6 +886,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies that the specified user name and password exist in the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified username and password are valid; otherwise, false.</para>
+        </returns>
         <param name="password">
           <attribution license="cc4" from="Microsoft" modified="false" />The password for the specified user. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Security/MembershipUser.xml b/mcs/class/System.Web/Documentation/en/System.Web.Security/MembershipUser.xml
index 0c8f5e2b5ba..7e7502779ad 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Security/MembershipUser.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Security/MembershipUser.xml
@@ -120,7 +120,6 @@
         <Parameter Name="newPassword" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -132,6 +131,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Updates the password for the membership user in the membership data store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the update was successful; otherwise, false.</para>
+        </returns>
         <param name="oldPassword">
           <attribution license="cc4" from="Microsoft" modified="false" />The current password for the membership user.</param>
         <param name="newPassword">
@@ -153,7 +156,6 @@
         <Parameter Name="newPasswordAnswer" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -165,6 +167,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Updates the password question and answer for the membership user in the membership data store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the update was successful; otherwise, false.</para>
+        </returns>
         <param name="password">
           <attribution license="cc4" from="Microsoft" modified="false" />The current password for the membership user.</param>
         <param name="newPasswordQuestion">
@@ -247,7 +253,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -263,6 +268,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the password for the membership user from the membership data store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The password for the membership user.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -279,7 +288,6 @@
       </Parameters>
       <Docs>
         <param name="answer">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -295,6 +303,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the password for the membership user from the membership data store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The password for the membership user.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -543,7 +555,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -556,6 +567,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resets a user's password to a new, automatically generated password.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new password for the membership user.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -572,7 +587,6 @@
       </Parameters>
       <Docs>
         <param name="answer">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -586,6 +600,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resets a user's password to a new, automatically generated password.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new password for the membership user.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -599,13 +617,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the user name for the membership user.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="P:System.Web.Security.MembershipUser.UserName" /> for the membership user.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -619,7 +640,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -631,6 +651,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clears the locked-out state of the user so that the membership user can be validated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the membership user was successfully unlocked; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Security/MembershipUserCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.Security/MembershipUserCollection.xml
index 1faabfdc706..7dc8a6ca751 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Security/MembershipUserCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Security/MembershipUserCollection.xml
@@ -145,7 +145,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -155,6 +154,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an enumerator that can iterate through the membership user collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the entire <see cref="T:System.Web.Security.MembershipUserCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Security/PassportIdentity.xml b/mcs/class/System.Web/Documentation/en/System.Web.Security/PassportIdentity.xml
index 41b101a845d..4a0976e5419 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Security/PassportIdentity.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Security/PassportIdentity.xml
@@ -81,7 +81,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -90,6 +89,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string containing the Login server URL for a member, as well as with optional information sent to the Login server in the query string. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The Login server URL for a member, as well as optional information sent to the Login server in the query string.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -106,7 +109,6 @@
         <Parameter Name="strReturnUrl" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -116,6 +118,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string containing the Login server URL for a member, along with optional information sent to the Login server in the query string. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The Login server URL for a member, as well as the optional information sent to the Login server in the query string.</para>
+        </returns>
         <param name="strReturnUrl">
           <attribution license="cc4" from="Microsoft" modified="false" />The URL of the location that the Login server should redirect to after logon is complete. Pass null to indicate that Passport should use the default value. </param>
       </Docs>
@@ -141,7 +147,6 @@
         <Parameter Name="bUseSecureAuth" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -150,6 +155,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the authentication server URL for a member. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The Login server URL for a member, as well as the optional information sent to the Login server in the query string.</para>
+        </returns>
         <param name="strReturnUrl">
           <attribution license="cc4" from="Microsoft" modified="false" />Sets the URL of the location that the Login server should redirect to after logon is complete. Pass null to indicate that Passport should use the default value. </param>
         <param name="iTimeWindow">
@@ -189,7 +198,6 @@
         <Parameter Name="iUseSecureAuth" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -198,6 +206,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string containing the Login server URL for a member, along with the optional information sent to the Login server in the query string. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The Login server URL for a member, as well as the optional information sent to the Login server in the query string.</para>
+        </returns>
         <param name="strReturnUrl">
           <attribution license="cc4" from="Microsoft" modified="false" />Sets the URL of the location that the Login server should redirect to after logon is complete. Pass null to indicate that Passport should use the default value. </param>
         <param name="iTimeWindow">
@@ -228,7 +240,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -237,6 +248,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string containing the Login server URL for a member, as well as optional information sent to the Login server in the query string. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The Login server URL for a member, as well as optional information sent to the Login server in the query string.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -253,7 +268,6 @@
         <Parameter Name="strReturnUrl" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -262,6 +276,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string containing the Login server URL for a member, as well as optional information sent to the Login server in the query string. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The Login server URL for a member, as well as the optional information sent to the Login server in the query string.</para>
+        </returns>
         <param name="strReturnUrl">
           <attribution license="cc4" from="Microsoft" modified="false" />The URL of the location that the Login server should redirect to after logon is complete. Pass null to indicate that Passport should use the default value. </param>
       </Docs>
@@ -287,7 +305,6 @@
         <Parameter Name="bUseSecureAuth" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -296,6 +313,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string containing the Login server URL for a member, as well as the optional information sent to the Login server in the query string. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The Login server URL for a member, as well as the optional information sent to the Login server in the query string.</para>
+        </returns>
         <param name="strReturnUrl">
           <attribution license="cc4" from="Microsoft" modified="false" />Sets the URL of the location that the Login server should redirect to after logon is complete. Pass null to indicate that Passport should use the default value. </param>
         <param name="iTimeWindow">
@@ -335,7 +356,6 @@
         <Parameter Name="iUseSecureAuth" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -344,6 +364,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a string containing the Login server URL for a member, as well as the optional information sent to the Login server in the query string. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The Login server URL for a member, as well as the optional information sent to the Login server in the query string.</para>
+        </returns>
         <param name="strReturnUrl">
           <attribution license="cc4" from="Microsoft" modified="false" />Sets the URL of the location that the Login server should redirect to after logon is complete. Pass null to indicate that Passport should use the default value. </param>
         <param name="iTimeWindow">
@@ -376,7 +400,6 @@
         <Parameter Name="strData" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -385,6 +408,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compresses data. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The compressed data.</para>
+        </returns>
         <param name="strData">
           <attribution license="cc4" from="Microsoft" modified="false" />The data to be compressed. </param>
       </Docs>
@@ -401,7 +428,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -410,6 +436,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the state of a flag indicating if the Passport Manager is in a valid state for encryption. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key used for encryption and decryption is valid and if the Passport Manager is in a valid state for encryption; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -426,7 +456,6 @@
         <Parameter Name="strHost" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -435,6 +464,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the key being used for Passport encryption and decryption. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer result code.</para>
+        </returns>
         <param name="strHost">
           <attribution license="cc4" from="Microsoft" modified="false" />The host name or IP address. </param>
       </Docs>
@@ -453,7 +486,6 @@
         <Parameter Name="strSite" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -462,6 +494,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the key being used for Passport encryption and decryption by referring to the site-name label assigned to that key when the key was first installed. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer result code.</para>
+        </returns>
         <param name="strSite">
           <attribution license="cc4" from="Microsoft" modified="false" />The site label. </param>
       </Docs>
@@ -480,7 +516,6 @@
         <Parameter Name="strData" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -489,6 +524,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decompresses data that has been compressed by the <see cref="M:System.Web.Security.PassportIdentity.Compress(System.String)" /> method. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The decompressed data.</para>
+        </returns>
         <param name="strData">
           <attribution license="cc4" from="Microsoft" modified="false" />The data to be decompressed. </param>
       </Docs>
@@ -507,7 +546,6 @@
         <Parameter Name="strData" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -516,6 +554,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decrypts data using the Passport participant key for the current site. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Data decrypted using the Passport participant key for the current site.</para>
+        </returns>
         <param name="strData">
           <attribution license="cc4" from="Microsoft" modified="false" />The data to be decrypted. </param>
       </Docs>
@@ -534,7 +576,6 @@
         <Parameter Name="strData" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -543,6 +584,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encrypts data using the Passport participant key for the current site. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Data encrypted using the Passport participant key for the current site.</para>
+        </returns>
         <param name="strData">
           <attribution license="cc4" from="Microsoft" modified="false" />The data to be encrypted. </param>
       </Docs>
@@ -599,7 +644,6 @@
         <Parameter Name="strAttribute" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -608,6 +652,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the contents of a registry key under the HKLM\SW\Microsoft\Passport hive. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The contents of the registry key.</para>
+        </returns>
         <param name="strAttribute">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the registry key. </param>
       </Docs>
@@ -628,7 +676,6 @@
         <Parameter Name="strDomain" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -637,6 +684,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides information for a Passport domain by querying the Passport manager for the requested domain attribute. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representing the requested attribute.</para>
+        </returns>
         <param name="strAttribute">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the attribute value to retrieve. </param>
         <param name="iLCID">
@@ -659,7 +710,6 @@
         <Parameter Name="strMemberName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -668,6 +718,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the Passport domain from the member name string. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The Passport domain for the specified member.</para>
+        </returns>
         <param name="strMemberName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the Passport member </param>
       </Docs>
@@ -710,7 +764,6 @@
         <Parameter Name="bCheckSecure" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -719,6 +772,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the user is authenticated by a central site responsible for Passport authentication. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the user is authenticated by a Passport authority; otherwise, false.</para>
+        </returns>
         <param name="iTimeWindow">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies the interval during which members must have last logged on to the calling domain. Pass -1 to indicate that Passport should use the default value. </param>
         <param name="bForceLogin">
@@ -743,7 +800,6 @@
         <Parameter Name="iCheckSecure" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -752,6 +808,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the user is authenticated by a Passport authority. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the user is authenticated by a central site responsible for Passport authentication; otherwise, false.</para>
+        </returns>
         <param name="iTimeWindow">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies the interval during which members must have last logged on to the calling domain. A value of -1 indicates that Passport should use the default value, 0 represents false, and 1 represents true. </param>
         <param name="iForceLogin">
@@ -772,7 +832,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -781,6 +840,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Logs the user on, either by generating a 302 redirect URL or initiating a Passport-aware client authentication exchange. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representing the Passport Login Challenge.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -797,7 +860,6 @@
         <Parameter Name="strReturnUrl" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -807,6 +869,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Logs the user on by outputting the appropriate headers to either a 302 redirect URL or the initiation of a Passport-aware client authentication exchange. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representing the Passport Login Challenge.</para>
+        </returns>
         <param name="strReturnUrl">
           <attribution license="cc4" from="Microsoft" modified="false" />See Passport documentation for IPassportManager3.GetLoginChallenge. Pass null to indicate that Passport should use the default value. </param>
       </Docs>
@@ -833,7 +899,6 @@
         <Parameter Name="oExtraParams" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -842,6 +907,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Logs the user on, either by generating a 302 redirect URL or initiating a Passport-aware client authentication exchange. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representing the Passport Login Challenge.</para>
+        </returns>
         <param name="szRetURL">
           <attribution license="cc4" from="Microsoft" modified="false" />See Passport documentation for IPassportManager3.GetLoginChallenge. Pass null to indicate that Passport should use the default value. </param>
         <param name="iTimeWindow">
@@ -876,7 +945,6 @@
         <Parameter Name="strOpt" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -885,6 +953,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a specific Passport logon option. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The Passport logon option <paramref name="strOpt" />.</para>
+        </returns>
         <param name="strOpt">
           <attribution license="cc4" from="Microsoft" modified="false" />Logon option to query. </param>
       </Docs>
@@ -903,7 +975,6 @@
         <Parameter Name="strProfileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -912,6 +983,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns Passport profile information for the specified profile attribute. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the Passport profile attribute specified by the <paramref name="strProfileName" /> parameter.</para>
+        </returns>
         <param name="strProfileName">
           <attribution license="cc4" from="Microsoft" modified="false" />The Passport profile attribute to return. </param>
       </Docs>
@@ -930,7 +1005,6 @@
         <Parameter Name="iFlagMask" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -939,6 +1013,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a given flag is set in this user's profile. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the Passport profile flag <paramref name="iFlagMask" /> is set in this user's profile; otherwise, false.</para>
+        </returns>
         <param name="iFlagMask">
           <attribution license="cc4" from="Microsoft" modified="false" />The Passport profile flag to query. </param>
       </Docs>
@@ -957,7 +1035,6 @@
         <Parameter Name="strProfile" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -966,6 +1043,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a given profile attribute exists in this user's profile. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the profile attribute <paramref name="strProfile" /> exists in this user's profile; otherwise, false.</para>
+        </returns>
         <param name="strProfile">
           <attribution license="cc4" from="Microsoft" modified="false" />The Passport profile attribute to query. </param>
       </Docs>
@@ -1029,7 +1110,6 @@
         <Parameter Name="bNeedBirthdate" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -1038,6 +1118,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether full consent is granted in this user's profile. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if full consent is granted in this user's profile.</para>
+        </returns>
         <param name="bNeedFullConsent">
           <attribution license="cc4" from="Microsoft" modified="false" />true to indicate full consent is required for Passport Authentication; otherwise, false. </param>
         <param name="bNeedBirthdate">
@@ -1120,7 +1204,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -1129,6 +1212,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Logs the user on, either by generating a 302 redirect URL or initiating a Passport-aware client authentication exchange. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer result code.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1145,7 +1232,6 @@
         <Parameter Name="strReturnUrl" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -1155,6 +1241,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Logs the user on, either by generating a 302 redirect URL or initiating a Passport-aware client authentication exchange. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer result code.</para>
+        </returns>
         <param name="strReturnUrl">
           <attribution license="cc4" from="Microsoft" modified="false" />The URL to which the Login server should redirect users after sign in is complete. Pass null to indicate that Passport should use the default value. </param>
       </Docs>
@@ -1181,7 +1271,6 @@
         <Parameter Name="oExtraParams" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -1190,6 +1279,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Logs the user on, either by generating a 302 redirect URL or by initiating a Passport-aware client authentication exchange. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer result code.</para>
+        </returns>
         <param name="szRetURL">
           <attribution license="cc4" from="Microsoft" modified="false" />The URL to which the Login server should redirect users after sign in is complete. Pass null to indicate that Passport should use the default value. </param>
         <param name="iTimeWindow">
@@ -1232,7 +1325,6 @@
         <Parameter Name="oExtraParams" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -1241,6 +1333,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Logs the user on, either by generating a 302 redirect URL or initiating a Passport-aware client authentication exchange. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer result code.</para>
+        </returns>
         <param name="szRetURL">
           <attribution license="cc4" from="Microsoft" modified="false" />The URL to which the Login server should redirect users after sign in is complete. Pass null to indicate that Passport should use the default value. </param>
         <param name="iTimeWindow">
@@ -1273,7 +1369,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -1282,6 +1377,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an HTML fragment containing an image tag for a Passport link. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An HTML fragment containing an image tag for a Passport link.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1298,7 +1397,6 @@
         <Parameter Name="strReturnUrl" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -1308,6 +1406,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an HTML fragment containing an HTML &lt;img&gt; tag for a Passport link. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An HTML fragment containing an image tag for a Passport link.</para>
+        </returns>
         <param name="strReturnUrl">
           <attribution license="cc4" from="Microsoft" modified="false" />Sets the URL of the location to which the Login server should redirect members after they log on. Pass null to indicate that Passport should use the default value. </param>
       </Docs>
@@ -1334,7 +1436,6 @@
         <Parameter Name="bUseSecureAuth" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -1343,6 +1444,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an HTML fragment containing an HTML &lt;img&gt; tag for a Passport link. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An HTML fragment containing an image tag for a Passport link.</para>
+        </returns>
         <param name="strReturnUrl">
           <attribution license="cc4" from="Microsoft" modified="false" />Sets the URL of the location to which the Login server should redirect members after they log on. Pass null to indicate that Passport should use the default value. </param>
         <param name="iTimeWindow">
@@ -1385,7 +1490,6 @@
         <Parameter Name="iUseSecureAuth" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -1394,6 +1498,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an HTML fragment containing an HTML &lt;img&gt; tag for a Passport link. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An HTML fragment containing an image tag for a Passport link.</para>
+        </returns>
         <param name="strReturnUrl">
           <attribution license="cc4" from="Microsoft" modified="false" />Sets the URL of the location to which the Login server should redirect members after they log on. Pass null to indicate that Passport should use the default value. </param>
         <param name="iTimeWindow">
@@ -1426,7 +1534,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -1435,6 +1542,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an HTML fragment containing an image tag for a Passport link. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An HTML fragment containing an image tag for a Passport link.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1451,7 +1562,6 @@
         <Parameter Name="strReturnUrl" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -1461,6 +1571,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an HTML fragment containing an HTML &lt;img&gt; tag for a Passport link. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An HTML fragment containing an image tag for a Passport link.</para>
+        </returns>
         <param name="strReturnUrl">
           <attribution license="cc4" from="Microsoft" modified="false" />Sets the URL of the location to which the Login server should redirect members after they log on. Pass null to indicate that Passport should use the default value. </param>
       </Docs>
@@ -1487,7 +1601,6 @@
         <Parameter Name="bUseSecureAuth" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -1496,6 +1609,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an HTML fragment containing an HTML &lt;img&gt; tag for a Passport link. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An HTML fragment containing an image tag for a Passport link.</para>
+        </returns>
         <param name="strReturnUrl">
           <attribution license="cc4" from="Microsoft" modified="false" />Sets the URL of the location to which the Login server should redirect members after they log on. Pass null to indicate that Passport should use the default value. </param>
         <param name="iTimeWindow">
@@ -1538,7 +1655,6 @@
         <Parameter Name="iUseSecureAuth" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -1547,6 +1663,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an HTML fragment containing an HTML &lt;img&gt; tag for a Passport link. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An HTML fragment containing an image tag for a Passport link.</para>
+        </returns>
         <param name="strReturnUrl">
           <attribution license="cc4" from="Microsoft" modified="false" />Sets the URL of the location to which the Login server should redirect members after they log on. Pass null to indicate that Passport should use the default value. </param>
         <param name="iTimeWindow">
@@ -1579,7 +1699,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -1588,6 +1707,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the Passport logout URL string. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The Passport logout URL string.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1608,7 +1731,6 @@
         <Parameter Name="iUseSecureAuth" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -1617,6 +1739,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the Passport logout URL string using the specified parameters. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The Passport logout URL string.</para>
+        </returns>
         <param name="szReturnURL">
           <attribution license="cc4" from="Microsoft" modified="false" />See IPassportManager3.LogoutUrl for more details. Pass null to indicate that Passport should use the default value. </param>
         <param name="szCOBrandArgs">
@@ -1741,7 +1867,6 @@
         <Parameter Name="strAttribute" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This class has been deprecated and is no longer supported. Microsoft Passport Network has been replaced by Windows Live ID. For more information about how to use Windows Live ID to authenticate users in a Web application, see <see cref="http://go.microsoft.com/fwlink/?LinkId=106346">Windows Live ID SDK</see>.</para>
@@ -1750,6 +1875,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets information on a specific attribute of the Passport authentication ticket. This class is deprecated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing an attribute of the Passport authentication ticket.</para>
+        </returns>
         <param name="strAttribute">
           <attribution license="cc4" from="Microsoft" modified="false" />A string identifying the Passport authentication ticket to return. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Security/RolePrincipal.xml b/mcs/class/System.Web/Documentation/en/System.Web.Security/RolePrincipal.xml
index 0f79d2f5d71..e708046b58b 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Security/RolePrincipal.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Security/RolePrincipal.xml
@@ -230,7 +230,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -240,6 +239,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a list of roles that the <see cref="T:System.Web.Security.RolePrincipal" /> is a member of.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The list of roles that the <see cref="T:System.Web.Security.RolePrincipal" /> is a member of.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -277,7 +280,6 @@
         <Parameter Name="role" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -289,6 +291,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the user represented by the <see cref="T:System.Web.Security.RolePrincipal" /> is in the specified role.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if user represented by the <see cref="T:System.Web.Security.RolePrincipal" /> is in the specified role; otherwise, false.</para>
+        </returns>
         <param name="role">
           <attribution license="cc4" from="Microsoft" modified="false" />The role to search for.</param>
       </Docs>
@@ -390,7 +396,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -400,6 +405,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the role information cached with the <see cref="T:System.Web.Security.RolePrincipal" /> object encrypted based on the <see cref="P:System.Web.Security.Roles.CookieProtectionValue" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The role information cached with the <see cref="T:System.Web.Security.RolePrincipal" /> object encrypted based on the <see cref="P:System.Web.Security.Roles.CookieProtectionValue" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Security/RoleProvider.xml b/mcs/class/System.Web/Documentation/en/System.Web.Security/RoleProvider.xml
index 7f918d1c480..965752426c3 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Security/RoleProvider.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Security/RoleProvider.xml
@@ -148,7 +148,6 @@
       </Parameters>
       <Docs>
         <param name="rolename">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -162,6 +161,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes a role from the data source for the configured applicationName.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the role was successfully deleted; otherwise, false.</para>
+        </returns>
         <param name="throwOnPopulatedRole">
           <attribution license="cc4" from="Microsoft" modified="false" />If true, throw an exception if <paramref name="roleName" /> has one or more members and do not delete <paramref name="roleName" />.</param>
       </Docs>
@@ -180,7 +183,6 @@
         <Parameter Name="usernameToMatch" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -191,6 +193,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of user names in a role where the user name contains the specified user name to match.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string array containing the names of all the users where the user name matches <paramref name="usernameToMatch" /> and the user is a member of the specified role.</para>
+        </returns>
         <param name="roleName">
           <attribution license="cc4" from="Microsoft" modified="false" />The role to search in.</param>
         <param name="usernameToMatch">
@@ -208,7 +214,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -220,6 +225,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a list of all the roles for the configured applicationName.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string array containing the names of all the roles stored in the data source for the configured applicationName.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -235,7 +244,6 @@
         <Parameter Name="username" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -248,6 +256,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a list of the roles that a specified user is in for the configured applicationName.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string array containing the names of all the roles that the specified user is in for the configured applicationName.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The user to return a list of roles for.</param>
       </Docs>
@@ -266,7 +278,6 @@
       </Parameters>
       <Docs>
         <param name="rolename">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -279,6 +290,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a list of users in the specified role for the configured applicationName.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string array containing the names of all the users who are members of the specified role for the configured applicationName.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -296,7 +311,6 @@
       </Parameters>
       <Docs>
         <param name="rolename">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -308,6 +322,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified user is in the specified role for the configured applicationName.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified user is in the specified role for the configured applicationName; otherwise, false.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The user name to search for.</param>
       </Docs>
@@ -360,7 +378,6 @@
       </Parameters>
       <Docs>
         <param name="rolename">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -372,6 +389,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified role name already exists in the role data source for the configured applicationName.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the role name already exists in the data source for the configured applicationName; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Security/Roles.xml b/mcs/class/System.Web/Documentation/en/System.Web.Security/Roles.xml
index 1581ac5c231..48093ebebe1 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Security/Roles.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Security/Roles.xml
@@ -475,7 +475,6 @@
       </Parameters>
       <Docs>
         <param name="rolename">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -486,6 +485,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes a role from the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="roleName" /> was deleted from the data source; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -503,7 +506,6 @@
       </Parameters>
       <Docs>
         <param name="rolename">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -514,6 +516,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes a role from the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="roleName" /> was deleted from the data source; otherwise; false.</para>
+        </returns>
         <param name="throwOnPopulatedRole">
           <attribution license="cc4" from="Microsoft" modified="false" />If true, throws an exception if <paramref name="roleName" /> has one or more members.</param>
       </Docs>
@@ -575,7 +581,6 @@
       </Parameters>
       <Docs>
         <param name="rolename">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -587,6 +592,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a list of users in a specified role where the user name contains the specified user name to match.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string array containing the names of all the users whose user name matches <paramref name="usernameToMatch" /> and who are members of the specified role.</para>
+        </returns>
         <param name="usernameToMatch">
           <attribution license="cc4" from="Microsoft" modified="false" />The user name to search for.</param>
       </Docs>
@@ -602,7 +611,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -612,6 +620,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a list of all the roles for the application.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string array containing the names of all the roles stored in the data source for the application.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -625,7 +637,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -636,6 +647,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a list of the roles that the currently logged-on user is in.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string array containing the names of all the roles that the currently logged-on user is in.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -651,7 +666,6 @@
         <Parameter Name="username" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -662,6 +676,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a list of the roles that a user is in.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string array containing the names of all the roles that the specified user is in.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The user to return a list of roles for. </param>
       </Docs>
@@ -680,7 +698,6 @@
       </Parameters>
       <Docs>
         <param name="rolename">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -690,6 +707,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a list of users in the specified role.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string array containing the names of all the users who are members of the specified role.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -706,7 +727,6 @@
       </Parameters>
       <Docs>
         <param name="rolename">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -717,6 +737,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the currently logged-on user is in the specified role.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the currently logged-on user is in the specified role; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -734,7 +758,6 @@
       </Parameters>
       <Docs>
         <param name="rolename">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -745,6 +768,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified user is in the specified role.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified user is in the specified role; otherwise, false.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the user to search for. </param>
       </Docs>
@@ -977,7 +1004,6 @@
       </Parameters>
       <Docs>
         <param name="rolename">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -987,6 +1013,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified role name already exists in the role data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the role name already exists in the data source; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Security/SqlMembershipProvider.xml b/mcs/class/System.Web/Documentation/en/System.Web.Security/SqlMembershipProvider.xml
index 8636da74a09..63b5611212d 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Security/SqlMembershipProvider.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Security/SqlMembershipProvider.xml
@@ -84,7 +84,6 @@
       <Docs>
         <param name="oldPwd">To be added.</param>
         <param name="newPwd">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -99,6 +98,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Modifies a user's password.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the password was updated successfully. false if the supplied old password is invalid, the user is locked out, or the user does not exist in the database.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The user to update the password for. </param>
       </Docs>
@@ -121,7 +124,6 @@
       <Docs>
         <param name="newPwdQuestion">To be added.</param>
         <param name="newPwdAnswer">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -136,6 +138,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Updates the password question and answer for a user in the SQL Server membership database.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the update was successful; otherwise, false. A value of false is also returned if the <paramref name="password" /> is incorrect, the user is locked out, or the user does not exist in the database.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The user to change the password question and answer for. </param>
         <param name="password">
@@ -190,7 +196,6 @@
         <Parameter Name="deleteAllRelatedData" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -204,6 +209,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes a user's membership information from the SQL Server membership database.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the user was deleted; otherwise, false. A value of false is also returned if the user does not exist in the database.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the user to delete.</param>
         <param name="deleteAllRelatedData">
@@ -318,7 +327,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -333,6 +341,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a random password that is at least 14 characters long.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A random password that is at least 14 characters long.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -370,7 +382,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -383,6 +394,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of users currently accessing the application.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of users currently accessing the application.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -400,7 +415,6 @@
       </Parameters>
       <Docs>
         <param name="answer">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -414,6 +428,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the password for the specified user name from the SQL Server membership database.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The password for the specified user name.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The user to retrieve the password for. </param>
       </Docs>
@@ -432,7 +450,6 @@
         <Parameter Name="userIsOnline" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -443,6 +460,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the information from the data source for the membership user associated with the specified unique identifier and updates the last activity date/time stamp for the user, if specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Security.MembershipUser" /> object representing the user associated with the specified unique identifier. If no user is found in the database for the specified <paramref name="providerUserKey" /> value, null is returned.</para>
+        </returns>
         <param name="providerUserKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique identifier for the user.</param>
         <param name="userIsOnline">
@@ -463,7 +484,6 @@
         <Parameter Name="userIsOnline" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -475,6 +495,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns information from the SQL Server membership database for a user and provides an option to update the last activity date/time stamp for the user.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.Security.MembershipUser" /> object representing the specified user. If no user is found in the database for the specified <paramref name="username" /> value, null is returned.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the user to get information for. </param>
         <param name="userIsOnline">
@@ -494,7 +518,6 @@
         <Parameter Name="email" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -506,6 +529,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the user name associated with the specified e-mail address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The user name associated with the specified e-mail address. If no match is found, this method returns null.</para>
+        </returns>
         <param name="email">
           <attribution license="cc4" from="Microsoft" modified="false" />The e-mail address to search for. </param>
       </Docs>
@@ -742,7 +769,6 @@
       </Parameters>
       <Docs>
         <param name="answer">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -759,6 +785,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resets a user's password to a new, automatically generated password.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new password for the specified user.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The user to reset the password for. </param>
       </Docs>
@@ -776,7 +806,6 @@
         <Parameter Name="username" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -787,6 +816,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clears the user's locked-out status so that the membership user can be validated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the membership user was successfully unlocked; otherwise, false. A value of false is also returned if the user does not exist in the database.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the membership user to clear the locked-out status for.</param>
       </Docs>
@@ -833,7 +866,6 @@
         <Parameter Name="password" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -846,6 +878,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies that the specified user name and password exist in the SQL Server membership database.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified username and password are valid; otherwise, false. A value of false is also returned if the user does not exist in the database.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the user to validate. </param>
         <param name="password">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Security/SqlRoleProvider.xml b/mcs/class/System.Web/Documentation/en/System.Web.Security/SqlRoleProvider.xml
index b1d6dd52959..b93fc76c08f 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Security/SqlRoleProvider.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Security/SqlRoleProvider.xml
@@ -139,7 +139,6 @@
       </Parameters>
       <Docs>
         <param name="rolename">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -150,6 +149,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes a role from the role database.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the role was successfully deleted; otherwise, false.</para>
+        </returns>
         <param name="throwOnPopulatedRole">
           <attribution license="cc4" from="Microsoft" modified="false" />If true, throws an exception if <paramref name="roleName" /> has one or more members.</param>
       </Docs>
@@ -168,7 +171,6 @@
         <Parameter Name="usernameToMatch" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -178,6 +180,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of user names in a role where the user name contains the specified user name to match.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string array containing the names of all the users where the user name matches <paramref name="usernameToMatch" /> and the user is a member of the specified role.</para>
+        </returns>
         <param name="roleName">
           <attribution license="cc4" from="Microsoft" modified="false" />The role to search in.</param>
         <param name="usernameToMatch">
@@ -195,7 +201,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -205,6 +210,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a list of all the roles for the application.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string array containing the names of all the roles stored in the database for a particular application.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -220,7 +229,6 @@
         <Parameter Name="username" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -230,6 +238,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a list of the roles that a user is in.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string array containing the names of all the roles that the specified user is in.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The user to return a list of roles for. </param>
       </Docs>
@@ -248,7 +260,6 @@
       </Parameters>
       <Docs>
         <param name="rolename">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -258,6 +269,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a list of users in the specified role.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string array containing the names of all the users who are members of the specified role.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -304,7 +319,6 @@
       </Parameters>
       <Docs>
         <param name="rolename">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -314,6 +328,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified user is in the specified role.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified user name is in the specified role; otherwise, false.</para>
+        </returns>
         <param name="username">
           <attribution license="cc4" from="Microsoft" modified="false" />The user name to search for. </param>
       </Docs>
@@ -362,7 +380,6 @@
       </Parameters>
       <Docs>
         <param name="rolename">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -372,6 +389,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified role name already exists in the role database.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the role name already exists in the database; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Security/UrlAuthorizationModule.xml b/mcs/class/System.Web/Documentation/en/System.Web.Security/UrlAuthorizationModule.xml
index 518bc057bcf..3baa157d598 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Security/UrlAuthorizationModule.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Security/UrlAuthorizationModule.xml
@@ -71,7 +71,6 @@
         <Parameter Name="verb" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.Security.UrlAuthorizationModule.CheckUrlAccessForPrincipal(System.String,System.Security.Principal.IPrincipal,System.String)" /> method checks to see whether the current user is granted access to the requested file in the Web.config file for the application.</para>
@@ -82,6 +81,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the user has access to the requested file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current user can access the file; otherwise, false.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path to the file.</param>
         <param name="user">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.SessionState/HttpSessionState.xml b/mcs/class/System.Web/Documentation/en/System.Web.SessionState/HttpSessionState.xml
index 971f2dc1ee8..d75c5317025 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.SessionState/HttpSessionState.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.SessionState/HttpSessionState.xml
@@ -205,12 +205,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Collections.IEnumerator" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that can be used to read all the session-state variable names in the current session.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can iterate through the variable names in the session-state collection.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.SessionState/HttpSessionStateContainer.xml b/mcs/class/System.Web/Documentation/en/System.Web.SessionState/HttpSessionStateContainer.xml
index e67982b824a..64c96705592 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.SessionState/HttpSessionStateContainer.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.SessionState/HttpSessionStateContainer.xml
@@ -230,12 +230,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that can be used to read all the session-state variable names in the current session.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can iterate through the variable names in the session-state collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsAbandoned">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.SessionState/IHttpSessionState.xml b/mcs/class/System.Web/Documentation/en/System.Web.SessionState/IHttpSessionState.xml
index 7570b30f3f5..8e0b7b566f2 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.SessionState/IHttpSessionState.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.SessionState/IHttpSessionState.xml
@@ -186,13 +186,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that can be used to read all the session-state item values in the current session.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can iterate through the values in the session-state item collection.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.SessionState/ISessionIDManager.xml b/mcs/class/System.Web/Documentation/en/System.Web.SessionState/ISessionIDManager.xml
index 42a1ba822d0..6bf2b3669dd 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.SessionState/ISessionIDManager.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.SessionState/ISessionIDManager.xml
@@ -30,7 +30,6 @@
         <Parameter Name="context" Type="System.Web.HttpContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -40,6 +39,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a unique session identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A unique session identifier.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The current <see cref="T:System.Web.HttpContext" /> object that references server objects used to process HTTP requests (for example, the <see cref="P:System.Web.HttpContext.Request" /> and <see cref="P:System.Web.HttpContext.Response" /> properties). </param>
       </Docs>
@@ -57,7 +60,6 @@
         <Parameter Name="context" Type="System.Web.HttpContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -68,6 +70,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the session identifier from the context of the current HTTP request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current session identifier sent with the HTTP request.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The current <see cref="T:System.Web.HttpContext" /> object that references server objects used to process HTTP requests (for example, the <see cref="P:System.Web.HttpContext.Request" /> and <see cref="P:System.Web.HttpContext.Response" /> properties).</param>
       </Docs>
@@ -182,7 +188,6 @@
         <Parameter Name="id" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -193,6 +198,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Confirms that the supplied session identifier is valid.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the session identifier is valid; otherwise, false.</para>
+        </returns>
         <param name="id">
           <attribution license="cc4" from="Microsoft" modified="false" />The session identifier to validate. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.SessionState/SessionIDManager.xml b/mcs/class/System.Web/Documentation/en/System.Web.SessionState/SessionIDManager.xml
index 4dc0c9ba741..2b0c3f2a132 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.SessionState/SessionIDManager.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.SessionState/SessionIDManager.xml
@@ -58,7 +58,6 @@
         <Parameter Name="context" Type="System.Web.HttpContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is not intended to be called from application code.</para>
@@ -68,6 +67,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a unique session identifier for the session.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A unique session identifier.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The current <see cref="T:System.Web.HttpContext" /> object that references server objects used to process HTTP requests (for example, the <see cref="P:System.Web.HttpContext.Request" /> and <see cref="P:System.Web.HttpContext.Response" /> properties).</param>
       </Docs>
@@ -85,7 +88,6 @@
         <Parameter Name="id" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is not intended to be called from application code.</para>
@@ -95,6 +97,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes a URL-encoded session identifier obtained from a cookie or the URL.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The decoded session identifier.</para>
+        </returns>
         <param name="id">
           <attribution license="cc4" from="Microsoft" modified="false" />The session identifier to decode. </param>
       </Docs>
@@ -112,7 +118,6 @@
         <Parameter Name="id" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is not intended to be called from application code.</para>
@@ -123,6 +128,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes the session identifier for saving to either a cookie or the URL.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The encoded session identifier.</para>
+        </returns>
         <param name="id">
           <attribution license="cc4" from="Microsoft" modified="false" />The session identifier to encode. </param>
       </Docs>
@@ -140,7 +149,6 @@
         <Parameter Name="context" Type="System.Web.HttpContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is not intended to be called from application code.</para>
@@ -150,6 +158,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the session-identifier value from the current Web request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current <see cref="P:System.Web.SessionState.HttpSessionState.SessionID" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The current <see cref="T:System.Web.HttpContext" /> object that references server objects used to process HTTP requests (for example, the <see cref="P:System.Web.HttpContext.Request" /> and <see cref="P:System.Web.HttpContext.Response" /> properties).</param>
       </Docs>
@@ -283,7 +295,6 @@
         <Parameter Name="id" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is not intended to be called from application code.</para>
@@ -294,6 +305,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether a session identifier is valid.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the session identifier is valid; otherwise, false.</para>
+        </returns>
         <param name="id">
           <attribution license="cc4" from="Microsoft" modified="false" />The session identifier to validate. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.SessionState/SessionStateItemCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.SessionState/SessionStateItemCollection.xml
index 2b5a36382ae..d24e223874f 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.SessionState/SessionStateItemCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.SessionState/SessionStateItemCollection.xml
@@ -73,7 +73,6 @@
         <Parameter Name="reader" Type="System.IO.BinaryReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.SessionState.SessionStateItemCollection.Deserialize(System.IO.BinaryReader)" /> method can be used to read the contents of a <see cref="T:System.Web.SessionState.SessionStateItemCollection" /> collection from the session store.</para>
@@ -83,6 +82,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Web.SessionState.SessionStateItemCollection" /> collection from a storage location that is written to using the <see cref="M:System.Web.SessionState.SessionStateItemCollection.Serialize(System.IO.BinaryWriter)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.SessionState.SessionStateItemCollection" /> collection populated with the contents from a storage location that is written to using the <see cref="M:System.Web.SessionState.SessionStateItemCollection.Serialize(System.IO.BinaryWriter)" /> method.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.BinaryReader" /> used to read the serialized collection from a stream or encoded string.</param>
       </Docs>
@@ -122,12 +125,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that can be used to read all the key names in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can iterate through the variable names in the session-state collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Item">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.SessionState/SessionStateStoreProviderBase.xml b/mcs/class/System.Web/Documentation/en/System.Web.SessionState/SessionStateStoreProviderBase.xml
index 5b845669b69..03f5281da83 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.SessionState/SessionStateStoreProviderBase.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.SessionState/SessionStateStoreProviderBase.xml
@@ -66,7 +66,6 @@
         <Parameter Name="timeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Web.SessionState.SessionStateModule" /> object calls the <see cref="M:System.Web.SessionState.SessionStateStoreProviderBase.CreateNewStoreData(System.Web.HttpContext,System.Int32)" /> method at the beginning of a request for an ASP.NET page, during the <see cref="E:System.Web.HttpApplication.AcquireRequestState" /> event. The <see cref="M:System.Web.SessionState.SessionStateStoreProviderBase.CreateNewStoreData(System.Web.HttpContext,System.Int32)" /> method is called if:</para>
@@ -84,6 +83,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Web.SessionState.SessionStateStoreData" /> object to be used for the current request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Web.SessionState.SessionStateStoreData" /> for the current request.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.HttpContext" /> for the current request.</param>
         <param name="timeout">
@@ -409,7 +412,6 @@
         <Parameter Name="expireCallback" Type="System.Web.SessionState.SessionStateItemExpireCallback" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Web.SessionState.SessionStateModule" /> object calls the <see cref="M:System.Web.SessionState.SessionStateStoreProviderBase.SetItemExpireCallback(System.Web.SessionState.SessionStateItemExpireCallback)" /> method when the module is initialized to determine whether calls to the Session_OnEnd event are supported by the <see cref="T:System.Web.SessionState.SessionStateStoreProviderBase" /> implementation and to associate the <see cref="T:System.Web.SessionState.SessionStateItemExpireCallback" /> delegate with the Session_OnEnd event.</para>
@@ -419,6 +421,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets a reference to the <see cref="T:System.Web.SessionState.SessionStateItemExpireCallback" /> delegate for the Session_OnEnd event defined in the Global.asax file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the session-state store provider supports calling the Session_OnEnd event; otherwise, false.</para>
+        </returns>
         <param name="expireCallback">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.SessionState.SessionStateItemExpireCallback" />  delegate for the Session_OnEnd event defined in the Global.asax file.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.SessionState/SessionStateUtility.xml b/mcs/class/System.Web/Documentation/en/System.Web.SessionState/SessionStateUtility.xml
index 45f30116e6f..8b2be2605a2 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.SessionState/SessionStateUtility.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.SessionState/SessionStateUtility.xml
@@ -112,7 +112,6 @@
         <Parameter Name="context" Type="System.Web.HttpContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.SessionState.SessionStateUtility.GetHttpSessionStateFromContext(System.Web.HttpContext)" /> method can be used by a session-state module to retrieve session data from the current request. This occurs during the <see cref="E:System.Web.HttpApplication.ReleaseRequestState" /> event at the end of a request. The returned session data can then be written to the session data store. If the session has been abandoned, the session data can be removed from the data store and <see cref="T:System.Web.HttpContext" />, and the <system>Session_OnEnd</system> event can be executed. </para>
@@ -121,6 +120,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves session data from the context for the current request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.SessionState.IHttpSessionState" /> implementation instance populated with session data from the current request.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.HttpContext" /> from which to retrieve session data.</param>
       </Docs>
@@ -138,7 +141,6 @@
         <Parameter Name="context" Type="System.Web.HttpContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.SessionState.SessionStateUtility.GetSessionStaticObjects(System.Web.HttpContext)" /> method is used to retrieve the collection of static objects defined in the Global.asax file for the ASP.NET application. A session-state module implementation will supply the returned <see cref="T:System.Web.HttpStaticObjectsCollection" /> collection to the <see cref="T:System.Web.SessionState.IHttpSessionState" /> implementation instance that is added to the current context using the <see cref="M:System.Web.SessionState.SessionStateUtility.AddHttpSessionStateToContext(System.Web.HttpContext,System.Web.SessionState.IHttpSessionState)" /> method.</para>
@@ -148,6 +150,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a reference to the static objects collection for the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.HttpStaticObjectsCollection" /> collection populated with the <see cref="P:System.Web.SessionState.HttpSessionState.StaticObjects" /> property value for the specified <see cref="T:System.Web.HttpContext" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.HttpContext" /> from which to get the static objects collection.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.Adapters/ControlAdapter.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.Adapters/ControlAdapter.xml
index 1c8a9b6ede5..ac45414e911 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.Adapters/ControlAdapter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.Adapters/ControlAdapter.xml
@@ -455,7 +455,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Control state is the essential state information needed even if view state is disabled. When an adapter needs to maintain its own control state information, it can override the <see cref="M:System.Web.UI.Adapters.ControlAdapter.SaveAdapterControlState" /> and <see cref="M:System.Web.UI.Adapters.ControlAdapter.LoadAdapterControlState(System.Object)" /> methods.</para>
@@ -466,6 +465,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves control state information for the control adapter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that contains the adapter's control state information as a <see cref="T:System.Web.UI.StateBag" />. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SaveAdapterViewState">
@@ -479,7 +482,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When an adapter needs to maintain its own view state information, it can override the <see cref="M:System.Web.UI.Adapters.ControlAdapter.SaveAdapterViewState" /> and <see cref="M:System.Web.UI.Adapters.ControlAdapter.LoadAdapterViewState(System.Object)" /> methods.</para>
@@ -490,6 +492,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves view state information for the control adapter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that contains the adapter view state information as a <see cref="T:System.Web.UI.StateBag" />. </para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.Adapters/PageAdapter.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.Adapters/PageAdapter.xml
index ba8dc271ae6..cdcf3a16b61 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.Adapters/PageAdapter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.Adapters/PageAdapter.xml
@@ -149,7 +149,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -167,6 +166,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the Web page is in postback and returns a name/value collection of the postback variables.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.Specialized.NameValueCollection" /> of the postback variables, if any; otherwise null. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -186,7 +189,6 @@
       </Parameters>
       <Docs>
         <param name="formID">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Adapters.PageAdapter.GetPostBackFormReference(System.String)" /> method provides a DHTML reference to the postback form. The code fragment has the following format: </para>
@@ -196,6 +198,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a DHTML code fragment that the client browser can use to reference the form on the page that was posted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> with a reference to the form on the page that was posted.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetRadioButtonsByGroup">
@@ -208,7 +214,6 @@
         <Parameter Name="groupName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -218,6 +223,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection of radio button controls specified by <paramref name="groupName" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.ICollection" /> of <see cref="T:System.Web.UI.WebControls.RadioButton" /> controls that make up <paramref name="groupName" />.</para>
+        </returns>
         <param name="groupName">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that is the name of the <see cref="T:System.Web.UI.WebControls.RadioButton" /> group to retrieve. </param>
       </Docs>
@@ -233,7 +242,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -295,6 +303,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that is used by the Web page to maintain the control and view states.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object derived from <see cref="T:System.Web.UI.PageStatePersister" /> that supports creating and extracting the combined control and view states for the <see cref="T:System.Web.UI.Page" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -558,7 +570,6 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -569,6 +580,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Transforms text for the target browser.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that contains the transformed text.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that is the text to transform.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlControl.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlControl.xml
index 3b7582b8ba9..1fe75464aea 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlControl.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlControl.xml
@@ -172,8 +172,11 @@
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <returns>a <see cref="T:System.Web.UI.ControlCollection" /></returns>
         <remarks>To be added</remarks>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.ControlCollection" /> that contains the <see cref="T:System.Web.UI.HtmlControls.HtmlControl" /> child server controls.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -227,7 +230,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.HtmlControls.HtmlControl.GetAttribute(System.String)" /> method to access an attribute on the <see cref="T:System.Web.UI.HtmlControls.HtmlControl" /> server control. All HTML server controls store their attributes in the <see cref="P:System.Web.UI.Control.ViewState" /> property. HTML attributes are treated by the ASP.NET page framework as properties on the HTML server control to which they belong. The <see cref="M:System.Web.UI.HtmlControls.HtmlControl.GetAttribute(System.String)" /> method's <paramref name="name" /> parameter is case-insensitive.</para>
@@ -236,6 +238,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the named attribute on the <see cref="T:System.Web.UI.HtmlControls.HtmlControl" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of this attribute on the element, as a <see cref="T:System.String" /> value. If the specified attribute does not exist on this element, returns an empty string ("").</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the attribute. This argument is case-insensitive.</param>
       </Docs>
@@ -395,7 +401,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.HtmlControls.HtmlControl.System.Web.UI.IAttributeAccessor.GetAttribute(System.String)" /> method calls the <see cref="M:System.Web.UI.HtmlControls.HtmlControl.GetAttribute(System.String)" /> method.</para>
@@ -405,6 +410,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Web.UI.IAttributeAccessor.GetAttribute(System.String)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of this attribute on the element, as a <see cref="T:System.String" /> value. If the specified attribute does not exist on this element, returns an empty string ("").</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The attribute name.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlEmptyTagControlBuilder.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlEmptyTagControlBuilder.xml
index fb2075b82f2..cb6651f5733 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlEmptyTagControlBuilder.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlEmptyTagControlBuilder.xml
@@ -48,7 +48,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -58,6 +57,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates that the controls built with the <see cref="T:System.Web.UI.HtmlControls.HtmlEmptyTagControlBuilder" /> control do not have closing tags.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>false in all cases.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlForm.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlForm.xml
index 71be27e5210..a718b00a0f7 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlForm.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlForm.xml
@@ -87,12 +87,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Web.UI.ControlCollection" /> collection for the <see cref="T:System.Web.UI.HtmlControls.HtmlForm" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.ControlCollection" /> that contains the <see cref="T:System.Web.UI.HtmlControls.HtmlForm" /> control's child server controls.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DefaultButton">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlHeadBuilder.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlHeadBuilder.xml
index 02a7378d2d5..e28cbb5a4e1 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlHeadBuilder.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlHeadBuilder.xml
@@ -42,7 +42,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -52,6 +51,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the literal white space characters in the control must be processed or ignored.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>false in all cases.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -68,7 +71,6 @@
         <Parameter Name="attribs" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -78,6 +80,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains the <see cref="T:System.Type" /> for the <see cref="T:System.Web.UI.HtmlControls.HtmlHead" /> control's child controls. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> of the specified control's child control.</para>
+        </returns>
         <param name="tagName">
           <attribution license="cc4" from="Microsoft" modified="false" />The tag name of the child control.</param>
         <param name="attribs">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlInputCheckBox.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlInputCheckBox.xml
index 5b8647d1117..d99aefaa168 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlInputCheckBox.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlInputCheckBox.xml
@@ -129,7 +129,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is primarily of interest to custom control developers extending the functionality of the <see cref="T:System.Web.UI.HtmlControls.HtmlInputCheckBox" /> control.</para>
@@ -138,6 +137,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the postback data for the <see cref="T:System.Web.UI.HtmlControls.HtmlInputCheckBox" /> control. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.UI.HtmlControls.HtmlInputCheckBox" /> control's state has changed as a result of the postback event; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key identifier for the control.</param>
         <param name="postCollection">
@@ -285,12 +288,15 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implements the <see cref="M:System.Web.UI.IPostBackDataHandler.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method by calling the <see cref="M:System.Web.UI.HtmlControls.HtmlInputCheckBox.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.UI.HtmlControls.HtmlInputCheckBox" /> control's state has changed as a result of the postback; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key identifier for the control.</param>
         <param name="postCollection">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlInputFile.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlInputFile.xml
index decc0360d46..37c3842e988 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlInputFile.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlInputFile.xml
@@ -138,7 +138,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Web.UI.HtmlControls.HtmlInputFile" /> control implements the <see cref="T:System.Web.UI.IPostBackDataHandler" /> interface, which has two methods: <see cref="M:System.Web.UI.IPostBackDataHandler.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> and <see cref="M:System.Web.UI.IPostBackDataHandler.RaisePostDataChangedEvent" />. The <see cref="M:System.Web.UI.HtmlControls.HtmlInputFile.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method is called by the <see cref="M:System.Web.UI.HtmlControls.HtmlInputFile.System.Web.UI.IPostBackDataHandler.RaisePostDataChangedEvent" /> method and always returns false, indicating that the <see cref="T:System.Web.UI.HtmlControls.HtmlInputFile" /> control's state is not managed by the ASP.NET page framework.</para>
@@ -148,6 +147,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the postback data for the <see cref="T:System.Web.UI.HtmlControls.HtmlInputFile" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method always returns false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key identifier for the control.</param>
         <param name="postCollection">
@@ -313,7 +316,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.HtmlControls.HtmlInputFile" /> instance is cast to an <see cref="T:System.Web.UI.IPostBackDataHandler" /> interface.</para>
@@ -322,6 +324,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Web.UI.IPostBackDataHandler.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.UI.HtmlControls.HtmlInputFile" /> control's state has changed as a result of the postback; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key identifier for the control.</param>
         <param name="postCollection">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlInputHidden.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlInputHidden.xml
index c21d908042f..f4c8ce8b9a3 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlInputHidden.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlInputHidden.xml
@@ -99,7 +99,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.HtmlControls.HtmlInputHidden.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method checks to see whether the postback value of the <see cref="T:System.Web.UI.HtmlControls.HtmlInputHidden" /> control is different from the previous value, and if so, returns true. </para>
@@ -109,6 +108,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the postback data for the <see cref="T:System.Web.UI.HtmlControls.HtmlInputHidden" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.UI.HtmlControls.HtmlInputHidden" /> control's state has changed as a result of the postback; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key identifier for the control.</param>
         <param name="postCollection">
@@ -256,12 +259,15 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implements the <see cref="M:System.Web.UI.IPostBackDataHandler.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> interface method by calling the <see cref="M:System.Web.UI.HtmlControls.HtmlInputHidden.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.UI.HtmlControls.HtmlInputHidden" /> control's state has changed as a result of the postback; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key identifier for the control.</param>
         <param name="postCollection">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlInputImage.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlInputImage.xml
index 19a572d7f8c..0d5077b75ab 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlInputImage.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlInputImage.xml
@@ -227,7 +227,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.HtmlControls.HtmlInputImage.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method checks to see whether coordinates that represent the location where the image was clicked by the user are part of the postback data for the <see cref="T:System.Web.UI.HtmlControls.HtmlInputImage" /> control. If coordinates are part of the postback data, then the <see cref="M:System.Web.UI.HtmlControls.HtmlInputImage.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method registers the <see cref="T:System.Web.UI.HtmlControls.HtmlInputImage" /> control with the Web page as a control that requires an event to be raised when it is processed.</para>
@@ -240,6 +239,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the postback data for the <see cref="T:System.Web.UI.HtmlControls.HtmlInputImage" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.UI.HtmlControls.HtmlInputImage" /> control's state has changed as a result of the postback; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key identifier for the control.</param>
         <param name="postCollection">
@@ -453,12 +456,15 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implements the <see cref="M:System.Web.UI.IPostBackDataHandler.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> interface method by calling the <see cref="M:System.Web.UI.HtmlControls.HtmlInputImage.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.UI.HtmlControls.HtmlInputImage" /> control's state has changed as a result of the postback; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key identifier for the control.</param>
         <param name="postCollection">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlInputRadioButton.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlInputRadioButton.xml
index df848d87c3a..da7eb16523e 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlInputRadioButton.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlInputRadioButton.xml
@@ -141,7 +141,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.HtmlControls.HtmlInputRadioButton.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method checks to see whether the postback value of the <see cref="T:System.Web.UI.HtmlControls.HtmlInputRadioButton" /> control is different from its previous value, and if so, returns true. </para>
@@ -151,6 +150,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the postback data for the <see cref="T:System.Web.UI.HtmlControls.HtmlInputRadioButton" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.UI.HtmlControls.HtmlInputRadioButton" /> control's state has changed as a result of the postback; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key identifier for the control.</param>
         <param name="postCollection">
@@ -327,7 +330,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.HtmlControls.HtmlInputRadioButton" /> instance is cast to an <see cref="T:System.Web.UI.IPostBackDataHandler" /> interface.</para>
@@ -336,6 +338,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implements the <see cref="M:System.Web.UI.IPostBackDataHandler.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method by calling the <see cref="M:System.Web.UI.HtmlControls.HtmlInputRadioButton.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.UI.HtmlControls.HtmlInputRadioButton" /> control's state has changed as a result of the postback; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key identifier for the control.</param>
         <param name="postCollection">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlInputText.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlInputText.xml
index 0efaf548196..6e38ed19389 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlInputText.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlInputText.xml
@@ -149,7 +149,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.HtmlControls.HtmlInputText.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method checks to see whether the postback value of the <see cref="T:System.Web.UI.HtmlControls.HtmlInputText" /> control is different from its previous value, and if so, returns true. </para>
@@ -159,6 +158,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the postback data for the <see cref="T:System.Web.UI.HtmlControls.HtmlInputText" /> control. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.UI.HtmlControls.HtmlInputText" /> control's state has changed as a result of the postback; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key identifier for the control.</param>
         <param name="postCollection">
@@ -387,12 +390,15 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implements the <see cref="M:System.Web.UI.IPostBackDataHandler.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> interface method by calling the <see cref="M:System.Web.UI.HtmlControls.HtmlInputText.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.UI.HtmlControls.HtmlInputText" /> control's state has changed as a result of the postback; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key identifier for the control.</param>
         <param name="postCollection">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlSelect.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlSelect.xml
index 2e068d152df..e4be3e2156a 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlSelect.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlSelect.xml
@@ -147,7 +147,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Web.UI.ControlCollection" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Web.UI.HtmlControls.HtmlSelect" /> control does not allow child controls.</para>
@@ -156,6 +155,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Web.UI.EmptyControlCollection" /> object for the <see cref="T:System.Web.UI.HtmlControls.HtmlSelect" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.ControlCollection" /> to contain the current server control's child server controls. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -349,7 +352,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.HtmlControls.HtmlSelect.GetData" /> method returns an <see cref="T:System.Collections.IEnumerable" /> object independent of whether the data source was specified by the <see cref="P:System.Web.UI.HtmlControls.HtmlSelect.DataSource" /> property or the <see cref="P:System.Web.UI.HtmlControls.HtmlSelect.DataSourceID" /> property.</para>
@@ -358,6 +360,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <see cref="T:System.Collections.IEnumerable" /> object that represents the data source that is bound to the <see cref="T:System.Web.UI.HtmlControls.HtmlSelect" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerable" /> object. If no data source is specified, a default value of null is returned.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InnerHtml">
@@ -477,7 +483,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.HtmlControls.HtmlSelect.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method checks whether the postback data of the <see cref="T:System.Web.UI.HtmlControls.HtmlSelect" /> control is different from its previous value, and if so, returns true. If the <see cref="T:System.Web.UI.HtmlControls.HtmlSelect" /> control's <see cref="P:System.Web.UI.HtmlControls.HtmlSelect.Multiple" /> property is false, indicating a single-selection <see cref="T:System.Web.UI.HtmlControls.HtmlSelect" /> control, then the <see cref="M:System.Web.UI.HtmlControls.HtmlSelect.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method checks the <see cref="P:System.Web.UI.HtmlControls.HtmlSelect.SelectedIndex" /> property. If the <see cref="T:System.Web.UI.HtmlControls.HtmlSelect" /> control's <see cref="P:System.Web.UI.HtmlControls.HtmlSelect.Multiple" /> property is true, indicating a multiple-selection <see cref="T:System.Web.UI.HtmlControls.HtmlSelect" /> control, then the <see cref="M:System.Web.UI.HtmlControls.HtmlSelect.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method checks the <see cref="P:System.Web.UI.HtmlControls.HtmlSelect.SelectedIndices" /> property.</para>
@@ -487,6 +492,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the postback data for the <see cref="T:System.Web.UI.HtmlControls.HtmlSelect" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.UI.HtmlControls.HtmlSelect" /> control's state has changed as a result of a postback; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key identifier for the control.</param>
         <param name="postCollection">
@@ -903,7 +912,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Web.UI.HtmlControls.HtmlSelect" /> control's view state is stored as a <see cref="T:System.Web.UI.Triplet" /> object. The <see cref="F:System.Web.UI.Triplet.First" /> field of the <see cref="T:System.Web.UI.Triplet" /> object holds the <see cref="T:System.Web.UI.HtmlControls.HtmlSelect" /> control's base view state. The <see cref="F:System.Web.UI.Triplet.Second" /> field of the <see cref="T:System.Web.UI.Triplet" /> object holds the <see cref="T:System.Web.UI.WebControls.ListItemCollection" /> collection represented by the <see cref="P:System.Web.UI.HtmlControls.HtmlSelect.Items" /> property. The <see cref="F:System.Web.UI.Triplet.Third" /> field of the <see cref="T:System.Web.UI.Triplet" /> object holds the selected indices represented by the <see cref="P:System.Web.UI.HtmlControls.HtmlSelect.SelectedIndices" /> property. The <see cref="M:System.Web.UI.HtmlControls.HtmlSelect.SaveViewState" /> method calls the base class's <see cref="M:System.Web.UI.Control.SaveViewState" /> method to save the control's base view state.</para>
@@ -913,6 +921,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves any <see cref="T:System.Web.UI.HtmlControls.HtmlSelect" /> control view state changes that have occurred since the page was posted back to the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> that contains the changes to the <see cref="T:System.Web.UI.HtmlControls.HtmlSelect" /> view state. If no view state is associated with the object, this method returns a null reference (Nothing in Visual Basic).</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1074,7 +1086,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.HtmlControls.HtmlSelect" /> instance is cast to an <see cref="T:System.Web.UI.IPostBackDataHandler" /> interface.</para>
@@ -1083,6 +1094,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Web.UI.IPostBackDataHandler.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.UI.HtmlControls.HtmlSelect" /> control's state has changed as a result of a postback; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key identifier for the control.</param>
         <param name="postCollection">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlSelectBuilder.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlSelectBuilder.xml
index 3a7d39a6d03..ac4bd8ff1f5 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlSelectBuilder.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlSelectBuilder.xml
@@ -51,7 +51,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method overrides the <see cref="M:System.Web.UI.ControlBuilder.AllowWhitespaceLiterals" /> method to always ignore white space in the <see cref="T:System.Web.UI.HtmlControls.HtmlSelect" /> control.</para>
@@ -60,6 +59,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the white space literals in an <see cref="T:System.Web.UI.HtmlControls.HtmlSelect" /> control are to be processed or ignored.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method always returns false, indicating that white space in the <see cref="T:System.Web.UI.HtmlControls.HtmlSelect" /> control is ignored.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -76,7 +79,6 @@
         <Parameter Name="attribs" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.HtmlControls.HtmlSelectBuilder.GetChildControlType(System.String,System.Collections.IDictionary)" /> method to return the <see cref="T:System.Type" /> of a specified child control in an <see cref="T:System.Web.UI.HtmlControls.HtmlSelect" /> control.</para>
@@ -85,6 +87,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains the <see cref="T:System.Type" /> for the <see cref="T:System.Web.UI.HtmlControls.HtmlSelect" /> control's child controls.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> of the <see cref="T:System.Web.UI.HtmlControls.HtmlSelect" /> control's specified child control.</para>
+        </returns>
         <param name="tagName">
           <attribution license="cc4" from="Microsoft" modified="false" />The tag name of the child control. </param>
         <param name="attribs">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlTable.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlTable.xml
index 2afdf6da0e9..8c1a6866299 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlTable.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlTable.xml
@@ -601,7 +601,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Web.UI.ControlCollection" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.HtmlControls.HtmlTable.CreateControlCollection" /> method creates a <see cref="T:System.Web.UI.ControlCollection" /> object that is used to hold table rows.</para>
@@ -611,6 +610,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Web.UI.ControlCollection" /> object for the <see cref="T:System.Web.UI.HtmlControls.HtmlTable" /> control. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.ControlCollection" /> that contains the <see cref="T:System.Web.UI.HtmlControls.HtmlTable" /> control's child server controls.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlTableCellCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlTableCellCollection.xml
index 9e6c211a1ed..746f1b76127 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlTableCellCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlTableCellCollection.xml
@@ -144,7 +144,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Collections.IEnumerator" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create a <see cref="T:System.Collections.IEnumerator" />-implemented object that can be iterated through to retrieve the contents of each item in the <see cref="T:System.Web.UI.HtmlControls.HtmlTableCellCollection" /> collection.</para>
@@ -159,6 +158,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Collections.IEnumerator" />-implemented object that contains all <see cref="T:System.Web.UI.HtmlControls.HtmlTableCell" /> objects in the <see cref="T:System.Web.UI.HtmlControls.HtmlTableCellCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.IEnumerator" />-implemented object that contains all <see cref="T:System.Web.UI.HtmlControls.HtmlTableCell" /> objects in the <see cref="T:System.Web.UI.HtmlControls.HtmlTableCellCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlTableRow.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlTableRow.xml
index afa21bf99d4..8fa3dbf65ee 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlTableRow.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlTableRow.xml
@@ -539,7 +539,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Web.UI.ControlCollection" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.HtmlControls.HtmlTableRow.CreateControlCollection" /> method creates a new <see cref="T:System.Web.UI.ControlCollection" /> collection that is used to hold the row cells.</para>
@@ -549,6 +548,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Web.UI.ControlCollection" /> object for the <see cref="T:System.Web.UI.HtmlControls.HtmlTableRow" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.ControlCollection" /> that contains the <see cref="T:System.Web.UI.HtmlControls.HtmlTableRow" /> control's child server controls.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlTableRowCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlTableRowCollection.xml
index 68996782ca7..4c9c0714af1 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlTableRowCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlTableRowCollection.xml
@@ -141,7 +141,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Collections.IEnumerator" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create an <see cref="T:System.Collections.IEnumerator" />-implemented object that can be iterated through to get each item in the <see cref="T:System.Web.UI.HtmlControls.HtmlTableRowCollection" /> collection.</para>
@@ -156,6 +155,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IEnumerator" />-implemented object that contains all <see cref="T:System.Web.UI.HtmlControls.HtmlTableRow" /> objects in the <see cref="T:System.Web.UI.HtmlControls.HtmlTableRowCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" />-implemented object that contains all <see cref="T:System.Web.UI.HtmlControls.HtmlTableRow" /> objects in the <see cref="T:System.Web.UI.HtmlControls.HtmlTableRowCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlTextArea.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlTextArea.xml
index dd29a191a64..23e81ee7908 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlTextArea.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlTextArea.xml
@@ -163,7 +163,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.HtmlControls.HtmlTextArea.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method checks whether the postback value of the <see cref="T:System.Web.UI.HtmlControls.HtmlTextArea" /> control is different from its previous value, and if so, returns true.</para>
@@ -173,6 +172,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the postback data for the <see cref="T:System.Web.UI.HtmlControls.HtmlTextArea" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.UI.HtmlControls.HtmlTextArea" /> control's state has changed as a result of the postback; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key identifier for the control.</param>
         <param name="postCollection">
@@ -400,7 +403,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.HtmlControls.HtmlTextArea" /> instance is cast to an <see cref="T:System.Web.UI.IPostBackDataHandler" /> interface.</para>
@@ -409,6 +411,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Web.UI.IPostBackDataHandler.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.UI.HtmlControls.HtmlTextArea" /> control's state has changed as a result of postback; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key identifier for the control.</param>
         <param name="postCollection">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlTitle.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlTitle.xml
index 4adae8997b4..3e43af0b744 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlTitle.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.HtmlControls/HtmlTitle.xml
@@ -98,13 +98,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Web.UI.ControlCollection" /> collection for the <see cref="T:System.Web.UI.HtmlControls.HtmlTitle" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.ControlCollection" /> object to contain the current server control's child server controls.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.Adapters/MenuAdapter.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.Adapters/MenuAdapter.xml
index 58034a2b6ed..d9eb22017b5 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.Adapters/MenuAdapter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.Adapters/MenuAdapter.xml
@@ -306,7 +306,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.Adapters.MenuAdapter.SaveAdapterControlState" /> method uses the <see cref="T:System.Web.UI.WebControls.Menu" /> control state to maintain the current navigation path of the menu. When an adapter needs to maintain private state information, it can override the <see cref="M:System.Web.UI.WebControls.Adapters.MenuAdapter.LoadAdapterControlState(System.Object)" /> and <see cref="M:System.Web.UI.WebControls.Adapters.MenuAdapter.SaveAdapterControlState" /> methods. An adapter might maintain private control state when there are complex features that need to maintain state across requests, separate from the associated control's state. The adapter needs to register for control state during the <see cref="M:System.Web.UI.WebControls.Adapters.MenuAdapter.OnInit(System.EventArgs)" /> method call in every request.</para>
@@ -315,6 +314,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves any changes to the adapter private control state that have occurred since the page was posted back to the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that contains the adapter's control state information as a <see cref="T:System.Web.UI.StateBag" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IPostBackEventHandler.RaisePostBackEvent">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/ConnectionInterfaceCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/ConnectionInterfaceCollection.xml
index b18b3f41abe..4db84178183 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/ConnectionInterfaceCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/ConnectionInterfaceCollection.xml
@@ -91,13 +91,16 @@
       </Parameters>
       <Docs>
         <param name="t">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Web.UI.WebControls.WebParts.ConnectionInterfaceCollection" /> object contains a specific value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is found in the <see cref="T:System.Web.UI.WebControls.WebParts.ConnectionInterfaceCollection" />; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -158,13 +161,16 @@
       </Parameters>
       <Docs>
         <param name="t">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified object and returns the zero-based index of the first occurrence within the entire <see cref="T:System.Web.UI.WebControls.WebParts.ConnectionInterfaceCollection" /> collection. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="value" /> within the entire <see cref="T:System.Web.UI.WebControls.WebParts.ConnectionInterfaceCollection" />, if found; otherwise, -1.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/ConnectionPoint.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/ConnectionPoint.xml
index 857a3d33783..c459e116176 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/ConnectionPoint.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/ConnectionPoint.xml
@@ -111,7 +111,6 @@
         <Parameter Name="control" Type="System.Web.UI.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -121,6 +120,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a connection point can participate in connections. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the control can create a connection point to participate in a connection; otherwise, false.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.WebControls.WebParts.WebPart" /> or other server control that is associated with a connection point.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/EditorPart.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/EditorPart.xml
index 2a4083ceeff..0fd096f4174 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/EditorPart.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/EditorPart.xml
@@ -110,7 +110,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -121,6 +120,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the values in an <see cref="T:System.Web.UI.WebControls.WebParts.EditorPart" /> control to the corresponding properties in the associated <see cref="T:System.Web.UI.WebControls.WebParts.WebPart" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the action of saving values from the <see cref="T:System.Web.UI.WebControls.WebParts.EditorPart" /> control to the <see cref="T:System.Web.UI.WebControls.WebParts.WebPart" /> control is successful; otherwise (if an error occurs), false. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -196,7 +199,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -206,6 +208,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the current state of an <see cref="T:System.Web.UI.WebControls.WebParts.EditorPart" /> control's parent zone.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IDictionary" /> that has the current state of the <see cref="T:System.Web.UI.WebControls.WebParts.EditorZoneBase" /> zone that contains an <see cref="T:System.Web.UI.WebControls.WebParts.EditorPart" /> control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/EditorPartCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/EditorPartCollection.xml
index bd6cdf4f439..d0176dde58f 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/EditorPartCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/EditorPartCollection.xml
@@ -102,7 +102,6 @@
         <Parameter Name="editorPart" Type="System.Web.UI.WebControls.WebParts.EditorPart" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -112,6 +111,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a particular control is in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Boolean value that indicates whether the <see cref="T:System.Web.UI.WebControls.WebParts.EditorPart" /> is in the collection.</para>
+        </returns>
         <param name="editorPart">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.WebParts.EditorPart" /> being tested for its status as a member of the collection. </param>
       </Docs>
@@ -179,7 +182,6 @@
         <Parameter Name="editorPart" Type="System.Web.UI.WebControls.WebParts.EditorPart" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -189,6 +191,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the position of a particular member of the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that corresponds to the index of an <see cref="T:System.Web.UI.WebControls.WebParts.EditorPart" /> control in the collection.</para>
+        </returns>
         <param name="editorPart">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Web.UI.WebControls.WebParts.EditorPart" /> that is a member of the collection. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/IVersioningPersonalizable.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/IVersioningPersonalizable.xml
index e50adda8a8c..8df66467d12 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/IVersioningPersonalizable.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/IVersioningPersonalizable.xml
@@ -39,6 +39,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads personalization data to a Web Parts control that does not have a corresponding personalized property for the data due to a version change.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the personalization data was successfully loaded; otherwise, false.</para>
+        </returns>
         <param name="unknownProperties">
           <attribution license="cc4" from="Microsoft" modified="false" />A dictionary of personalization data that could not be applied to a control.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/IWebEditable.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/IWebEditable.xml
index 3e8eb207ac9..26df6fc0ae3 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/IWebEditable.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/IWebEditable.xml
@@ -28,7 +28,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -42,6 +41,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of custom <see cref="T:System.Web.UI.WebControls.WebParts.EditorPart" /> controls associated with a server control that implements the <see cref="T:System.Web.UI.WebControls.WebParts.IWebEditable" /> interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.WebControls.WebParts.EditorPartCollection" /> that contains the collection of custom <see cref="T:System.Web.UI.WebControls.WebParts.EditorPart" /> controls associated with a server control. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/PersonalizableAttribute.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/PersonalizableAttribute.xml
index 1db14c56250..341900160b0 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/PersonalizableAttribute.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/PersonalizableAttribute.xml
@@ -169,7 +169,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -179,6 +178,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden, returns a Boolean evaluation of the current instance of <see cref="T:System.Web.UI.WebControls.WebParts.PersonalizableAttribute" /> and another <see cref="T:System.Web.UI.WebControls.WebParts.PersonalizableAttribute" /> instance supplied as a parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the values are equal; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.WebParts.PersonalizableAttribute" /> to be compared to the current instance.</param>
       </Docs>
@@ -194,7 +197,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -204,6 +206,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden, returns a hash code of the attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code in the form of an integer.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -219,7 +225,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -230,6 +235,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of <see cref="T:System.Reflection.PropertyInfo" /> objects for the properties that match the parameter type and are marked as personalizable.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.ICollection" /> of personalizable properties.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type on which to look for Personalizable properties.</param>
       </Docs>
@@ -245,7 +254,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -255,6 +263,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden, returns a value that indicates whether the attribute instance equals the value of the static <see cref="F:System.Web.UI.WebControls.WebParts.PersonalizableAttribute.Default" /> field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute instance equals the static <see cref="F:System.Web.UI.WebControls.WebParts.PersonalizableAttribute.Default" /> field; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -315,7 +327,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -325,6 +336,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current instance of <see cref="T:System.Web.UI.WebControls.WebParts.PersonalizableAttribute" /> and the specified <see cref="T:System.Web.UI.WebControls.WebParts.PersonalizableAttribute" /> have the same <see cref="P:System.Web.UI.WebControls.WebParts.PersonalizableAttribute.IsPersonalizable" /> property value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two attributes have the same <see cref="P:System.Web.UI.WebControls.WebParts.PersonalizableAttribute.IsPersonalizable" /> value; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.WebParts.PersonalizableAttribute" /> to be compared to the current instance.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/ProviderConnectionPoint.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/ProviderConnectionPoint.xml
index b18c645bb93..638a26261bb 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/ProviderConnectionPoint.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/ProviderConnectionPoint.xml
@@ -83,7 +83,6 @@
         <Parameter Name="control" Type="System.Web.UI.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -95,6 +94,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes the callback method in a provider control that gets an interface instance to return to consumers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that is an instance of the interface a provider returns to consumers to establish a connection. </para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The control acting as the provider in a Web Parts connection.</param>
       </Docs>
@@ -112,7 +115,6 @@
         <Parameter Name="control" Type="System.Web.UI.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -123,6 +125,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an optional collection of secondary interfaces that can be supported by a provider connection point.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.WebParts.ConnectionInterfaceCollection" /> of additional interfaces provided by the control acting as a provider.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The control acting as the provider in a Web Parts connection.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/WebPartVerb.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/WebPartVerb.xml
index 66ac578379c..ed1e465ee25 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/WebPartVerb.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/WebPartVerb.xml
@@ -493,7 +493,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -503,6 +502,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves a <see cref="T:System.Web.UI.WebControls.WebParts.WebPartVerb" /> object's view-state changes that occurred since the page was last posted back to the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that contains the state data to be saved.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -595,7 +598,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.WebControls.WebParts.WebPartVerb" /> instance is cast to an <see cref="T:System.Web.UI.IStateManager" /> interface. The method simply calls the <see cref="M:System.Web.UI.WebControls.WebParts.WebPartVerb.SaveViewState" /> method on the <see cref="T:System.Web.UI.WebControls.WebParts.WebPartVerb" /> class.</para>
@@ -604,6 +606,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implements the <see cref="M:System.Web.UI.IStateManager.SaveViewState" /> method by calling the <see cref="T:System.Web.UI.WebControls.WebParts.WebPartVerb" /> class's own <see cref="M:System.Web.UI.WebControls.WebParts.WebPartVerb.SaveViewState" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an <see cref="T:System.Object" /> containing the control's current view state. If no view state is associated with the control, this method returns null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IStateManager.TrackViewState">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/WebPartVerbCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/WebPartVerbCollection.xml
index 8a49a11deeb..f8d59de008d 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/WebPartVerbCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls.WebParts/WebPartVerbCollection.xml
@@ -103,7 +103,6 @@
         <Parameter Name="value" Type="System.Web.UI.WebControls.WebParts.WebPartVerb" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -113,6 +112,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the Web Parts verb collection for the specified <see cref="T:System.Web.UI.WebControls.WebParts.WebPartVerb" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the Web Parts verb; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.WebParts.WebPartVerb" /> to be found.</param>
       </Docs>
@@ -180,7 +183,6 @@
         <Parameter Name="value" Type="System.Web.UI.WebControls.WebParts.WebPartVerb" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -190,6 +192,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified Web Parts verb and returns the zero-based index of the first occurrence within the entire collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the Web Parts verb.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.WebParts.WebPartVerb" /> to be located.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/AccessDataSource.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/AccessDataSource.xml
index ccbf0f52d3c..6f666a4247e 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/AccessDataSource.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/AccessDataSource.xml
@@ -630,7 +630,6 @@
         <Parameter Name="viewName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -640,6 +639,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a data source view object that is associated with the data source control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.WebControls.AccessDataSourceView" /> object that is associated with the <see cref="T:System.Web.UI.WebControls.AccessDataSource" /> instance.</para>
+        </returns>
         <param name="viewName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the data source view.</param>
       </Docs>
@@ -698,13 +701,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a <see cref="T:System.Data.Common.DbProviderFactory" /> object that is associated with the .NET data provider that is identified by the <see cref="P:System.Web.UI.WebControls.SqlDataSource.ProviderName" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Data.OleDb.OleDbFactory" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/AccessDataSourceView.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/AccessDataSourceView.xml
index e6df16221aa..c8670f9ea2b 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/AccessDataSourceView.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/AccessDataSourceView.xml
@@ -64,7 +64,6 @@
         <Parameter Name="arguments" Type="System.Web.UI.DataSourceSelectArguments" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Web.UI.WebControls.AccessDataSourceView" /> object overrides the <see cref="M:System.Web.UI.WebControls.SqlDataSourceView.ExecuteSelect(System.Web.UI.DataSourceSelectArguments)" /> method to ensure that the <see cref="P:System.Web.UI.WebControls.AccessDataSource.DataFile" /> property of its associated <see cref="T:System.Web.UI.WebControls.AccessDataSource" /> control is set before retrieving data. </para>
@@ -77,6 +76,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves data from the underlying data storage using the SQL string in the <see cref="P:System.Web.UI.WebControls.SqlDataSourceView.SelectCommand" /> property and any parameters in the <see cref="P:System.Web.UI.WebControls.SqlDataSourceView.SelectParameters" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerable" /> of data rows.</para>
+        </returns>
         <param name="arguments">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.DataSourceSelectArguments" /> that is used to request operations on the data beyond basic data retrieval.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/AssociatedControlConverter.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/AssociatedControlConverter.xml
index c898b396131..d48c368a5f4 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/AssociatedControlConverter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/AssociatedControlConverter.xml
@@ -51,13 +51,16 @@
         <Parameter Name="control" Type="System.Web.UI.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the provided control inherits from <see cref="T:System.Web.UI.WebControls.WebControl" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="control" /> inherits from the <see cref="T:System.Web.UI.WebControls.WebControl" /> class; otherwise, false.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The control instance to test whether it is a <see cref="T:System.Web.UI.WebControls.WebControl" />. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/AutoGeneratedFieldProperties.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/AutoGeneratedFieldProperties.xml
index 3568c66a87d..ccbd41ba01c 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/AutoGeneratedFieldProperties.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/AutoGeneratedFieldProperties.xml
@@ -180,7 +180,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.AutoGeneratedFieldProperties.System#Web#UI#IStateManager#SaveViewState" /> method is a helper method used by the <see cref="T:System.Web.UI.WebControls.AutoGeneratedFieldProperties" /> class to save the state of the object.</para>
@@ -189,6 +188,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the current view state of the <see cref="T:System.Web.UI.WebControls.AutoGeneratedFieldProperties" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that contains the saved state of the <see cref="T:System.Web.UI.WebControls.AutoGeneratedFieldProperties" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IStateManager.TrackViewState">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/BaseCompareValidator.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/BaseCompareValidator.xml
index 0539afd37e4..d9132b30dc5 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/BaseCompareValidator.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/BaseCompareValidator.xml
@@ -94,7 +94,6 @@
         <Parameter Name="type" Type="System.Web.UI.WebControls.ValidationDataType" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.BaseCompareValidator.CanConvert(System.String,System.Web.UI.WebControls.ValidationDataType)" /> method to determine whether the specified string can be converted to the specified data type. This method is commonly used to test whether a string can be converted to a compatible data type before performing an operation that depends on that data type.</para>
@@ -104,6 +103,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified string can be converted to the specified data type. This version of the overloaded method tests currency, double, and date values using the format used by the current culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified data string can be converted to the specified data type; otherwise, false.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to test.</param>
         <param name="type">
@@ -129,7 +132,6 @@
         <Parameter Name="cultureInvariant" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.BaseCompareValidator.CanConvert(System.String,System.Web.UI.WebControls.ValidationDataType,System.Boolean)" /> method to determine whether the specified string can be converted to the specified data type. This method is commonly used to test whether a string can be converted to a compatible data type before performing an operation that depends on that data type. To indicate that values should be tested using a culture-neutral format, pass in true for the <paramref name="cultureInvariant" /> parameter; otherwise, values are tested using the format used by the current culture. When testing a value using the format used by the current culture, consider using the <see cref="M:System.Web.UI.WebControls.BaseCompareValidator.CanConvert(System.String,System.Web.UI.WebControls.ValidationDataType)" /> overloaded version of this method.</para>
@@ -138,6 +140,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified string can be converted to the specified data type. This version of the overloaded method allows you to specify whether values are tested using a culture-neutral format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified data string can be converted to the specified data type; otherwise, false.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to test.</param>
         <param name="type">
@@ -161,7 +167,6 @@
       <Docs>
         <param name="left">To be added.</param>
         <param name="right">To be added.</param>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.BaseCompareValidator.Compare(System.String,System.String,System.Web.UI.WebControls.ValidationCompareOperator,System.Web.UI.WebControls.ValidationDataType)" /> method is used to test whether the value of the <paramref name="leftText" /> parameter relates to the value of the <paramref name="rightText" /> parameter in the manner specified by the <paramref name="op" /> parameter. The <paramref name="type" /> parameter specifies the data type of the values being compared.</para>
@@ -174,6 +179,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two strings using the specified operator and data type. This version of the overloaded method compares currency, double, and date values using the format used by the current culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="leftValue" /> parameter relates to the <paramref name="rightValue" /> parameter in the manner specified by the <paramref name="op" /> parameter; otherwise, false.</para>
+        </returns>
         <param name="op">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Web.UI.WebControls.ValidationCompareOperator" /> values. </param>
         <param name="type">
@@ -204,7 +213,6 @@
       <Docs>
         <param name="left">To be added.</param>
         <param name="right">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.BaseCompareValidator.Compare(System.String,System.Boolean,System.String,System.Boolean,System.Web.UI.WebControls.ValidationCompareOperator,System.Web.UI.WebControls.ValidationDataType)" /> method is used to test whether the value of the <paramref name="leftText" /> parameter relates to the value of the <paramref name="rightText" /> parameter in the manner specified by the <paramref name="op" /> parameter. The <paramref name="type" /> parameter specifies the data type of the values being compared.</para>
@@ -217,6 +225,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two strings using the specified operator and validation data type. This version of the overload allows you to specify whether values are compared using a culture-neutral format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="leftValue" /> parameter relates to the <paramref name="rightValue" /> parameter in the manner specified by the <paramref name="op" /> parameter; otherwise, false.</para>
+        </returns>
         <param name="cultureInvariantLeftText">
           <attribution license="cc4" from="Microsoft" modified="false" />true to convert the left side value to a culture-neutral format; otherwise, false.</param>
         <param name="cultureInvariantRightText">
@@ -336,7 +348,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.BaseCompareValidator.DetermineRenderUplevel" /> method is a helper function used primarily by the <see cref="P:System.Web.UI.WebControls.BaseValidator.RenderUplevel" /> property to determine whether the client's browser supports "uplevel" rendering (rendering on a newer browser). The <see cref="T:System.Web.UI.WebControls.BaseCompareValidator" /> class overrides this method to return false if the current culture uses a non-Gregorian calendar.</para>
@@ -348,6 +359,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the validation control can be rendered for a newer ("uplevel") browser.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the validation control can be rendered for an "uplevel" browser; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -362,7 +377,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The month, day, and year of a date value can appear in different orders depending on the current culture settings. The <see cref="M:System.Web.UI.WebControls.BaseCompareValidator.GetDateElementOrder" /> method is used to determine the order in which these values appear. The following table shows the different values returned by this method.</para>
@@ -407,6 +421,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the order in which the month, day, and year appear in a date value for the current culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the order in which the month, day, and year appear in a date value for the current culture.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -424,7 +442,6 @@
       </Parameters>
       <Docs>
         <param name="two_digit_year">To be added: an object of type 'int'</param>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.BaseCompareValidator.GetFullYear(System.Int32)" /> method to generate the four-digit year representation of the specified two-digit year. The four-digit year representation depends on the value of the <see cref="P:System.Web.UI.WebControls.BaseCompareValidator.CutoffYear" /> property, which contains the maximum year that can be represented by a two-digit year in a 100-year range. For example, if the <see cref="P:System.Web.UI.WebControls.BaseCompareValidator.CutoffYear" /> property contains the value 2029, the <see cref="M:System.Web.UI.WebControls.BaseCompareValidator.GetFullYear(System.Int32)" /> method returns a year between 1930 and 2029. The two-digit year 30 is interpreted as 1930, while 29 is interpreted as 2029. You can change the maximum year that can be represented by a two-digit year by setting the <see cref="P:System.Globalization.Calendar.TwoDigitYearMax" /> property.</para>
@@ -436,6 +453,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates the four-digit year representation of the specified two-digit year.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The four-digit year representation of the specified two-digit year.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/BaseDataList.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/BaseDataList.xml
index 689c18bc56e..cda63698d07 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/BaseDataList.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/BaseDataList.xml
@@ -337,7 +337,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.BaseDataList.CreateDataSourceSelectArguments" /> method is a helper method used by the <see cref="P:System.Web.UI.WebControls.BaseDataList.SelectArguments" /> property to create its default <see cref="T:System.Web.UI.DataSourceSelectArguments" /> object.</para>
@@ -346,6 +345,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a default <see cref="T:System.Web.UI.DataSourceSelectArguments" /> object used by the data-bound control if no arguments are specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.DataSourceSelectArguments" /> initialized to <see cref="P:System.Web.UI.DataSourceSelectArguments.Empty" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DataBind">
@@ -599,7 +602,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.BaseDataList.GetData" /> method is a helper method called by derived classes (such as <see cref="T:System.Web.UI.WebControls.DataGrid" /> and <see cref="T:System.Web.UI.WebControls.DataList" />) to retrieve the data source.</para>
@@ -608,6 +610,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IEnumerable" />-implemented object that represents the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerable" />-implemented object that represents the data source.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GridLines">
@@ -788,7 +794,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.BaseDataList.IsBindableType(System.Type)" /> static method to determine whether the specified data type can be bound to a list control that inherits from the <see cref="T:System.Web.UI.WebControls.BaseDataList" /> class. The supported data types are <see cref="T:System.Boolean" />, <see cref="T:System.Byte" />, <see cref="T:System.SByte" />, <see cref="T:System.Int16" />, <see cref="T:System.UInt16" />, <see cref="T:System.Int32" />, <see cref="T:System.UInt32" />, <see cref="T:System.Int64" />, <see cref="T:System.UInt64" />, <see cref="T:System.Char" />, <see cref="T:System.Double" />, <see cref="T:System.Single" />, <see cref="T:System.DateTime" />, <see cref="T:System.Decimal" />, and <see cref="T:System.String" />.</para>
@@ -797,6 +802,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified data type can be bound to a list control that derives from the <see cref="T:System.Web.UI.WebControls.BaseDataList" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified data type can be bound to a list control that derives from the <see cref="T:System.Web.UI.WebControls.BaseDataList" /> class; otherwise, false.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that contains the data type to test. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/BaseValidator.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/BaseValidator.xml
index b9b5d3606ca..7bf027c994a 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/BaseValidator.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/BaseValidator.xml
@@ -417,7 +417,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.BaseValidator.ControlPropertiesValid" /> method is a helper method used primarily by the <see cref="P:System.Web.UI.WebControls.BaseValidator.PropertiesValid" /> property to determine whether the <see cref="P:System.Web.UI.WebControls.BaseValidator.ControlToValidate" /> property contains a valid input control. To be a valid input control, the <see cref="P:System.Web.UI.WebControls.BaseValidator.ControlToValidate" /> property must be set to some value and that value must be a control on the page that supports validation.</para>
@@ -429,6 +428,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the control specified by the <see cref="P:System.Web.UI.WebControls.BaseValidator.ControlToValidate" /> property is a valid control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the control specified by <see cref="P:System.Web.UI.WebControls.BaseValidator.ControlToValidate" /> is a valid control; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -538,7 +541,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.BaseValidator.DetermineRenderUplevel" /> method is a helper function that is used primarily by the <see cref="P:System.Web.UI.WebControls.BaseValidator.RenderUplevel" /> property to determine whether the client's browser supports client script. For this property to return true, the following conditions must be true:</para>
@@ -561,6 +563,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the validation control can perform client-side validation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the validation control can perform client-side validation; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -740,7 +746,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.BaseValidator.EvaluateIsValid" /> method to determine whether the value in the input control specified by the <see cref="P:System.Web.UI.WebControls.BaseValidator.ControlToValidate" /> property is valid.</para>
@@ -752,6 +757,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, this method contains the code to determine whether the value in the input control is valid.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value in the input control is valid; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -796,7 +805,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.BaseValidator.GetControlRenderID(System.String)" /> method to get the client ID of the specified control. For more information, see <see cref="P:System.Web.UI.Control.ClientID" />.</para>
@@ -808,6 +816,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the client ID of the specified control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The client ID of the specified control.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the control to get the client ID from. </param>
       </Docs>
@@ -826,7 +838,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.BaseValidator.GetControlValidationValue(System.String)" /> method to get the value associated with the specified input control, regardless of the control type. For example, you can use this method to get the value in a <see cref="T:System.Web.UI.WebControls.TextBox" /> control, as well as the value of the selected item from a <see cref="T:System.Web.UI.WebControls.ListBox" /> control. If the specified control cannot be found, null is returned.</para>
@@ -838,6 +849,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value associated with the specified input control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value associated with the specified input control.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the input control to get the value from. </param>
       </Docs>
@@ -857,7 +872,6 @@
       </Parameters>
       <Docs>
         <param name="o">a <see cref="T:System.Object" /></param>
-        <returns>a <see cref="T:System.ComponentModel.PropertyDescriptor" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.BaseValidator.GetValidationProperty(System.Object)" /> method is a helper function that gets the validation property of the specified input control.</para>
@@ -869,6 +883,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the validation property of a control (if it exists).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptor" /> that contains the validation property of the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/BoundColumn.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/BoundColumn.xml
index 4684b820f59..9e532822b63 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/BoundColumn.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/BoundColumn.xml
@@ -200,7 +200,6 @@
         <Parameter Name="dataValue" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.BoundColumn.FormatDataValue(System.Object)" /> method to convert the specified value to the format indicated by the <see cref="P:System.Web.UI.WebControls.BoundColumn.DataFormatString" /> property.</para>
@@ -212,6 +211,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified value to the format indicated by the <see cref="P:System.Web.UI.WebControls.BoundColumn.DataFormatString" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified value converted to the format indicated by the <see cref="P:System.Web.UI.WebControls.BoundColumn.DataFormatString" /> property.</para>
+        </returns>
         <param name="dataValue">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to format. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/BoundField.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/BoundField.xml
index 3e66d76d57c..ca1745a504c 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/BoundField.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/BoundField.xml
@@ -193,7 +193,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -203,6 +202,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an empty <see cref="T:System.Web.UI.WebControls.BoundField" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An empty <see cref="T:System.Web.UI.WebControls.BoundField" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -670,7 +673,6 @@
       </Parameters>
       <Docs>
         <param name="value">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -683,6 +685,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Formats the specified field value for a cell in the <see cref="T:System.Web.UI.WebControls.BoundField" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The field value converted to the format specified by <see cref="P:System.Web.UI.WebControls.BoundField.DataFormatString" />.</para>
+        </returns>
         <param name="encode">
           <attribution license="cc4" from="Microsoft" modified="false" />true to encode the value; otherwise, false.</param>
       </Docs>
@@ -698,7 +704,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -711,6 +716,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the value used for a field's value when rendering the <see cref="T:System.Web.UI.WebControls.BoundField" /> object in a designer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value to display in the designer as the field's value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -726,7 +735,6 @@
         <Parameter Name="controlContainer" Type="System.Web.UI.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -739,6 +747,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the value of the field bound to the <see cref="T:System.Web.UI.WebControls.BoundField" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the field bound to the <see cref="T:System.Web.UI.WebControls.BoundField" />.</para>
+        </returns>
         <param name="controlContainer">
           <attribution license="cc4" from="Microsoft" modified="false" />The container for the field value.</param>
       </Docs>
@@ -809,7 +821,6 @@
         <Parameter Name="control" Type="System.Web.UI.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -820,6 +831,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes the <see cref="T:System.Web.UI.WebControls.BoundField" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>false in all cases.</para>
+        </returns>
         <param name="enableSorting">
           <attribution license="cc4" from="Microsoft" modified="false" />true if sorting is supported; otherwise, false.</param>
         <param name="control">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Button.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Button.xml
index 95898e0f289..d0eb5abb19d 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Button.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Button.xml
@@ -475,7 +475,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.Button.GetPostBackOptions" /> method creates a <see cref="T:System.Web.UI.PostBackOptions" /> object that represents the <see cref="T:System.Web.UI.WebControls.Button" /> control's postback behavior. The <see cref="T:System.Web.UI.PostBackOptions" /> object is then typically passed to the <see cref="M:System.Web.UI.ClientScriptManager.GetPostBackEventReference(System.Web.UI.PostBackOptions)" /> method, which is used to obtain a reference to a client-side script function that, when invoked, causes the server to post back to the page.</para>
@@ -485,6 +484,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Web.UI.PostBackOptions" /> object that represents the <see cref="T:System.Web.UI.WebControls.Button" /> control's postback behavior.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.PostBackOptions" /> that represents the <see cref="T:System.Web.UI.WebControls.Button" /> control's postback behavior.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="OnClick">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ButtonColumn.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ButtonColumn.xml
index 0329cf90c0b..257885c3be8 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ButtonColumn.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ButtonColumn.xml
@@ -316,7 +316,6 @@
         <Parameter Name="dataTextValue" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.ButtonColumn.FormatDataTextValue(System.Object)" /> method to convert the specified value to the format that is indicated by the <see cref="P:System.Web.UI.WebControls.ButtonColumn.DataTextFormatString" /> property.</para>
@@ -328,6 +327,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified value to the format that is indicated by the <see cref="P:System.Web.UI.WebControls.ButtonColumn.DataTextFormatString" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <paramref name="dataTextValue" /> converted to the format indicated by the <see cref="P:System.Web.UI.WebControls.ButtonColumn.DataTextFormatString" />.</para>
+        </returns>
         <param name="dataTextValue">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to format. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ButtonField.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ButtonField.xml
index 38b0a06ac64..c844b239eb4 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ButtonField.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ButtonField.xml
@@ -211,7 +211,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -221,6 +220,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new instance of the <see cref="T:System.Web.UI.WebControls.ButtonField" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the  <see cref="T:System.Web.UI.WebControls.ButtonField" /> class.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -385,7 +388,6 @@
       </Parameters>
       <Docs>
         <param name="value">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -395,6 +397,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Formats the specified field value for a cell in the <see cref="T:System.Web.UI.WebControls.ButtonField" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The field value converted to the format specified by the <see cref="P:System.Web.UI.WebControls.ButtonField.DataTextFormatString" /> property.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -445,7 +451,6 @@
         <Parameter Name="control" Type="System.Web.UI.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -456,6 +461,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes the current <see cref="T:System.Web.UI.WebControls.ButtonField" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>false, which indicates the control does not need to rebind to the data.</para>
+        </returns>
         <param name="sortingEnabled">
           <attribution license="cc4" from="Microsoft" modified="false" />true to enable sorting; otherwise, false. </param>
         <param name="control">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ChangePassword.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ChangePassword.xml
index 7af9f269490..935d916d96d 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ChangePassword.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ChangePassword.xml
@@ -3164,7 +3164,6 @@
         <Parameter Name="e" Type="System.EventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3174,6 +3173,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the event for the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control is passed up the Web server control hierarchy for the page.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para> true if the event has been canceled; otherwise, false. The default is false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The source of the event.</param>
         <param name="e">
@@ -3794,7 +3797,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.ChangePassword.SaveControlState" /> method to save state information required for the operation of the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control. This control state data is stored separately from the view state data for the <see cref="T:System.Web.UI.WebControls.ChangePassword" /> control.</para>
@@ -3804,6 +3806,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves any server control state changes that have occurred since the time the page was posted back to the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The server control's current state; otherwise, null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SaveViewState">
@@ -3814,7 +3820,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3825,6 +3830,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves any server control view state changes that have occurred since the time the page was posted back to the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The server control's current view state; otherwise, null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CheckBox.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CheckBox.xml
index aa740467524..8219ad31d10 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CheckBox.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CheckBox.xml
@@ -372,7 +372,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.CheckBox.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method is used primarily by control developers.</para>
@@ -382,6 +381,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the postback data for the <see cref="T:System.Web.UI.WebControls.CheckBox" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the posted content is different from the last posting; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The index within the posted collection that references the content to load. </param>
         <param name="postCollection">
@@ -523,7 +526,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.CheckBox.SaveViewState" /> method is used primarily by control developers.</para>
@@ -534,6 +536,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the changes to the <see cref="T:System.Web.UI.WebControls.CheckBox" /> view state since the time the page was posted back to the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object that contains the changes to the <see cref="T:System.Web.UI.WebControls.CheckBox" /> view state; otherwise, if no view state is associated with the object, null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IPostBackDataHandler.LoadPostData">
@@ -551,7 +557,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -561,6 +566,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes posted data for the <see cref="T:System.Web.UI.WebControls.CheckBox" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the state of the <see cref="T:System.Web.UI.WebControls.CheckBox" /> has changed; otherwise false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key value used to index an entry in the collection. </param>
         <param name="postCollection">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CheckBoxField.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CheckBoxField.xml
index 9746536e721..672c24c16dc 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CheckBoxField.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CheckBoxField.xml
@@ -205,7 +205,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -215,6 +214,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an empty <see cref="T:System.Web.UI.WebControls.CheckBoxField" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An empty <see cref="T:System.Web.UI.WebControls.CheckBoxField" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -303,7 +306,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -313,6 +315,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the value used for the field's value when rendering the <see cref="T:System.Web.UI.WebControls.CheckBoxField" /> object in a designer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always returns true.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CheckBoxList.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CheckBoxList.xml
index b002f53d179..92f0134fd62 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CheckBoxList.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CheckBoxList.xml
@@ -263,7 +263,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Web.UI.WebControls.Style" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.CheckBoxList.CreateControlStyle" /> method is used primarily by control developers in custom controls that derive from the <see cref="T:System.Web.UI.WebControls.CheckBoxList" /> class.</para>
@@ -272,6 +271,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a style object that is used internally by the <see cref="T:System.Web.UI.WebControls.CheckBoxList" /> control to implement all style related properties.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.Style" /> that contains the style properties of the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -289,7 +292,6 @@
         <Parameter Name="pathOffset" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Web.UI.Control" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.CheckBoxList.FindControl(System.String,System.Int32)" /> method is used primarily by control developers in custom controls that derive from the <see cref="T:System.Web.UI.WebControls.CheckBoxList" /> class.</para>
@@ -299,6 +301,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the current naming container for a server control with the specified ID and path offset. The <see cref="M:System.Web.UI.WebControls.CheckBoxList.FindControl(System.String,System.Int32)" /> method always returns the <see cref="T:System.Web.UI.WebControls.CheckBoxList" /> object. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current <see cref="T:System.Web.UI.WebControls.CheckBoxList" />.</para>
+        </returns>
         <param name="id">
           <attribution license="cc4" from="Microsoft" modified="false" />The identifier for the control to find.</param>
         <param name="pathOffset">
@@ -323,7 +329,6 @@
         <Parameter Name="repeatIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.CheckBoxList.GetItemStyle(System.Web.UI.WebControls.ListItemType,System.Int32)" /> method is used primarily by control developers in custom controls that derive from the <see cref="T:System.Web.UI.WebControls.CheckBoxList" /> class.</para>
@@ -333,6 +338,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the style of the specified item type at the specified index in the list control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>null, indicating that style attributes are not set on individual list items in a <see cref="T:System.Web.UI.WebControls.CheckBoxList" /> control.</para>
+        </returns>
         <param name="itemType">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Web.UI.WebControls.ListItemType" /> enumeration values. </param>
         <param name="repeatIndex">
@@ -416,7 +425,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.CheckBoxList.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method is used primarily by control developers in custom controls that derive from the <see cref="T:System.Web.UI.WebControls.CheckBoxList" /> class.</para>
@@ -427,6 +435,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the posted data for the <see cref="T:System.Web.UI.WebControls.CheckBoxList" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the state of the <see cref="T:System.Web.UI.WebControls.CheckBoxList" /> is different from the last posting; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key identifier for the control, used to index the <see cref="T:System.Collections.Specialized.NameValueCollection" /> specified in the <paramref name="postCollection" /> parameter.</param>
         <param name="postCollection">
@@ -746,7 +758,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Typically, you should use the <see cref="M:System.Web.UI.WebControls.CheckBoxList.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method to process posted data for a <see cref="T:System.Web.UI.WebControls.CheckBoxList" /> object. </para>
@@ -756,6 +767,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes posted data for the <see cref="T:System.Web.UI.WebControls.CheckBoxList" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the server control's state changes as a result of the postback; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key identifier for the control, used to index the <paramref name="postCollection" />.</param>
         <param name="postCollection">
@@ -800,7 +815,6 @@
         <Parameter Name="repeatIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Typically, you should use the <see cref="M:System.Web.UI.WebControls.CheckBoxList.GetItemStyle(System.Web.UI.WebControls.ListItemType,System.Int32)" /> method to retrieve the style of an item in a <see cref="T:System.Web.UI.WebControls.CheckBoxList" /> object. </para>
@@ -810,6 +824,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Web.UI.WebControls.IRepeatInfoUser.GetItemStyle(System.Web.UI.WebControls.ListItemType,System.Int32)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.Style" /> object that represents the style of the specified item type at the specified index in the list control.</para>
+        </returns>
         <param name="itemType">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Web.UI.WebControls.ListItemType" /> enumeration values. </param>
         <param name="repeatIndex">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CircleHotSpot.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CircleHotSpot.xml
index bc616bc882e..cd56dfa50d6 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CircleHotSpot.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CircleHotSpot.xml
@@ -49,7 +49,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -60,6 +59,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the x- and y-coordinates of a <see cref="T:System.Web.UI.WebControls.CircleHotSpot" /> object's center and the length of its radius.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the x- and y-coordinates of a <see cref="T:System.Web.UI.WebControls.CircleHotSpot" /> object's center and the length of its radius.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CommandField.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CommandField.xml
index ad1f32b052e..3f883a710bd 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CommandField.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CommandField.xml
@@ -447,7 +447,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -457,6 +456,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an empty <see cref="T:System.Web.UI.WebControls.CommandField" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An empty <see cref="T:System.Web.UI.WebControls.CommandField" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CompareValidator.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CompareValidator.xml
index d340ac5fd05..ecdb2e5e6e0 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CompareValidator.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CompareValidator.xml
@@ -165,12 +165,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks the properties of the control for valid values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the control properties are valid; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ControlToCompare">
@@ -223,12 +226,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, this method contains the code to determine whether the value in the input control is valid.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value in the input control is valid; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CompositeDataBoundControl.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CompositeDataBoundControl.xml
index 6fad6bedee4..3e80ff5ea91 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CompositeDataBoundControl.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CompositeDataBoundControl.xml
@@ -99,7 +99,6 @@
         <Parameter Name="dataBinding" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -109,6 +108,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in an abstract class, creates the control hierarchy that is used to render the composite data-bound control based on the values from the specified data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of items created by the <see cref="M:System.Web.UI.WebControls.CompositeDataBoundControl.CreateChildControls(System.Collections.IEnumerable,System.Boolean)" />.</para>
+        </returns>
         <param name="dataSource">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.IEnumerable" /> that contains the values to bind to the control.</param>
         <param name="dataBinding">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ControlIDConverter.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ControlIDConverter.xml
index dccfd4f0053..11900fdb71a 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ControlIDConverter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ControlIDConverter.xml
@@ -53,13 +53,16 @@
         <Parameter Name="control" Type="System.Web.UI.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the control ID of the specified control is added to the <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> that is returned by the <see cref="M:System.Web.UI.WebControls.ControlIDConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true in all cases.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The control instance to test for inclusion in the <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" />. </param>
       </Docs>
@@ -77,7 +80,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -87,6 +89,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of control IDs from the container within the <see cref="T:System.ComponentModel.Design.IDesignerHost" /> when provided with a format context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> that holds a set of strings representing the control IDs of the controls in the current container. If no controls are currently contained, an empty collection is returned. If the context is null or there is no current container, then null is returned.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context that can be used to extract additional information about the environment from which this converter is invoked. This parameter or properties of this parameter can be null. </param>
       </Docs>
@@ -104,7 +110,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -114,6 +119,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the collection of standard values returned by the <see cref="M:System.Web.UI.WebControls.ControlIDConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> method is an exclusive list of possible values, using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>false in all cases.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
@@ -131,13 +140,16 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this object supports a standard set of control ID values that can be picked from a list, using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <see cref="M:System.Web.UI.WebControls.ControlIDConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> should be called to find a common set of control ID values the object supports; otherwise, false. This implementation returns true if the context is not null; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ControlParameter.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ControlParameter.xml
index 83c2c459c6a..2d7d1e9a06f 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ControlParameter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ControlParameter.xml
@@ -164,7 +164,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -174,6 +173,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a duplicate of the current <see cref="T:System.Web.UI.WebControls.ControlParameter" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.ControlParameter" /> that is an exact duplicate of the current one.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -228,7 +231,6 @@
       </Parameters>
       <Docs>
         <param name="ctx">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -242,6 +244,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Updates and returns the value of the <see cref="T:System.Web.UI.WebControls.ControlParameter" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the updated and current value of the parameter.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Control" /> that the parameter is bound to. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ControlPropertyNameConverter.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ControlPropertyNameConverter.xml
index 716f28ab7ff..b025bfa2488 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ControlPropertyNameConverter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ControlPropertyNameConverter.xml
@@ -56,7 +56,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.ControlPropertyNameConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> method returns a <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> collection that contains a set of strings representing the names of the current control's properties. </para>
@@ -66,6 +65,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of property names for the control within a designer that implements <see cref="T:System.ComponentModel.Design.IDesignerHost" /> when provided with a format context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> that contains a set of strings representing property names for the current control. If the current control is null, an empty collection is returned. If the <paramref name="context" /> parameter is null, null is returned.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context that can be used to extract additional information about the environment from which this converter is invoked. This parameter or properties of this parameter can be null.</param>
       </Docs>
@@ -83,7 +86,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.ControlPropertyNameConverter.GetStandardValuesExclusive(System.ComponentModel.ITypeDescriptorContext)" /> method always returns false to indicate that the list of property values returned by the <see cref="Overload:System.Web.UI.WebControls.ControlPropertyNameConverter.GetStandardValues" /> method is not an exclusive list of possible values.</para>
@@ -93,6 +95,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the collection of standard values returned by the <see cref="Overload:System.Web.UI.WebControls.ControlPropertyNameConverter.GetStandardValues" /> method is an exclusive list of possible values, using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>false in all cases, which indicates that the list is not exclusive.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context that can be used to extract additional information about the environment from which this converter is invoked. This parameter or properties of this parameter can be null.</param>
       </Docs>
@@ -110,7 +116,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.ControlPropertyNameConverter.GetStandardValuesSupported(System.ComponentModel.ITypeDescriptorContext)" /> method returns a value that indicates whether this object supports a standard set of values. </para>
@@ -120,6 +125,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether this object supports a standard set of values that can be chosen from a list, using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="context" /> parameter is not null; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context that can be used to extract additional information about the environment from which this converter is invoked. This parameter or properties of this parameter can be null.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CookieParameter.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CookieParameter.xml
index e0a87a983de..1631f13c628 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CookieParameter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CookieParameter.xml
@@ -135,7 +135,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -145,6 +144,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a duplicate of the current <see cref="T:System.Web.UI.WebControls.CookieParameter" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.CookieParameter" /> that is an exact duplicate of the current one.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -189,7 +192,6 @@
       </Parameters>
       <Docs>
         <param name="ctx">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -199,6 +201,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Updates and returns the value of the <see cref="T:System.Web.UI.WebControls.CookieParameter" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the updated and current value of the parameter. If the context or the request is null, the <see cref="M:System.Web.UI.WebControls.CookieParameter.Evaluate(System.Web.HttpContext,System.Web.UI.Control)" /> method returns null.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.Control" /> that is associated with the Web Forms page where the <see cref="T:System.Web.UI.WebControls.CookieParameter" /> is used. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CreateUserWizard.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CreateUserWizard.xml
index 99a00bd66a3..04d99e86eca 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CreateUserWizard.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CreateUserWizard.xml
@@ -1929,13 +1929,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets design-time data for a control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>None</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -2539,13 +2542,16 @@
         <Parameter Name="e" Type="System.EventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the event for the server control is passed up the page's UI server control hierarchy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Boolean value.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" /> None</param>
         <param name="e">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CustomValidator.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CustomValidator.xml
index 03a1bdb3839..5cf8ed1cba7 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CustomValidator.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/CustomValidator.xml
@@ -147,12 +147,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks the properties of the control for valid values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the control properties are valid; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -167,12 +170,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Overrides the <see cref="M:System.Web.UI.MobileControls.BaseValidator.EvaluateIsValid" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value in the input control is valid; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -189,7 +195,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="E:System.Web.UI.WebControls.CustomValidator.ServerValidate" /> event is raised when validation is performed on the server.</para>
@@ -200,6 +205,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Raises the <see cref="E:System.Web.UI.WebControls.CustomValidator.ServerValidate" /> event for the <see cref="T:System.Web.UI.WebControls.CustomValidator" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value specified by the <paramref name="value" /> parameter passes validation; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to validate. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataBoundControl.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataBoundControl.xml
index fa736050fc0..ef3993a10b2 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataBoundControl.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataBoundControl.xml
@@ -53,7 +53,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -63,6 +62,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a default <see cref="T:System.Web.UI.DataSourceSelectArguments" /> object used by the data-bound control if no arguments are specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.DataSourceSelectArguments" /> initialized to <see cref="P:System.Web.UI.DataSourceSelectArguments.Empty" />. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -131,7 +134,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -141,6 +143,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a <see cref="T:System.Web.UI.DataSourceView" /> object that the data-bound control uses to perform data operations.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.UI.DataSourceView" /> that the data-bound control uses to perform data operations. If the <see cref="P:System.Web.UI.WebControls.DataBoundControl.DataMember" /> property is set, a specific, named <see cref="T:System.Web.UI.DataSourceView" /> is returned; otherwise, the default <see cref="T:System.Web.UI.DataSourceView" /> is returned.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -154,7 +160,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -164,6 +169,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the <see cref="T:System.Web.UI.IDataSource" /> interface that the data-bound control is associated with, if any.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.IDataSource" /> that represents the data source identified by <see cref="P:System.Web.UI.WebControls.DataBoundControl.DataSourceID" />. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataControlField.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataControlField.xml
index 3fa5966ff3f..ba7ea0100b8 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataControlField.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataControlField.xml
@@ -183,7 +183,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.DataControlField.CloneField" /> method is a helper method used by the <see cref="M:System.Web.UI.WebControls.DataControlFieldCollection.CloneFields" /> method to create a copy of the current <see cref="T:System.Web.UI.WebControls.DataControlField" />-derived object.</para>
@@ -192,6 +191,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplicate copy of the current <see cref="T:System.Web.UI.WebControls.DataControlField" />-derived object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A duplicate copy of the current <see cref="T:System.Web.UI.WebControls.DataControlField" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Control">
@@ -284,7 +287,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -294,6 +296,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates an empty <see cref="T:System.Web.UI.WebControls.DataControlField" />-derived object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An empty <see cref="T:System.Web.UI.WebControls.DataControlField" />-derived object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -541,7 +547,6 @@
         <Parameter Name="control" Type="System.Web.UI.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -552,6 +557,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs basic instance initialization for a data control field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always returns false.</para>
+        </returns>
         <param name="sortingEnabled">
           <attribution license="cc4" from="Microsoft" modified="false" />A value that indicates whether the control supports the sorting of columns of data.</param>
         <param name="control">
@@ -737,7 +746,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -749,6 +757,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the changes made to the <see cref="T:System.Web.UI.WebControls.DataControlField" /> view state since the time the page was posted back to the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object that contains the changes to the <see cref="T:System.Web.UI.WebControls.DataControlField" /> view state. If there is no view state associated with the object, this method returns null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -874,12 +886,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the changes made to the <see cref="T:System.Web.UI.WebControls.DataControlField" /> view state since the time the page was posted back to the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that contains the saved view state values for the control.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IStateManager.TrackViewState">
@@ -908,7 +923,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -918,6 +932,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents this <see cref="T:System.Web.UI.WebControls.DataControlField" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents this <see cref="T:System.Web.UI.WebControls.DataControlField" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataControlFieldCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataControlFieldCollection.xml
index 903c945928a..e46e125df21 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataControlFieldCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataControlFieldCollection.xml
@@ -194,7 +194,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -204,6 +203,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the current collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.DataControlFieldCollection" /> that contains a copy of each data control field in the current collection.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -219,7 +222,6 @@
         <Parameter Name="field" Type="System.Web.UI.WebControls.DataControlField" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -229,6 +231,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Web.UI.WebControls.DataControlFieldCollection" /> collection contains a specific <see cref="T:System.Web.UI.WebControls.DataControlField" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.UI.WebControls.DataControlFieldCollection" /> contains the specified field; otherwise, false.</para>
+        </returns>
         <param name="field">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.DataControlField" /> to locate in the <see cref="T:System.Web.UI.WebControls.DataControlFieldCollection" />. </param>
       </Docs>
@@ -331,13 +337,16 @@
         <Parameter Name="field" Type="System.Web.UI.WebControls.DataControlField" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of a specific <see cref="T:System.Web.UI.WebControls.DataControlField" /> object in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the <paramref name="field" /> parameter, if it is found in the collection; otherwise, -1.</para>
+        </returns>
         <param name="field">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.DataControlField" /> to locate in the collection.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataGrid.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataGrid.xml
index 1aaf49e78e0..e674e744682 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataGrid.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataGrid.xml
@@ -952,12 +952,15 @@
         <Parameter Name="useDataSource" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Collections.ArrayList" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the set of columns to be used to build up the control hierarchy. When <see cref="P:System.Web.UI.WebControls.DataGrid.AutoGenerateColumns" /> is true, the columns are created to match the data source and are appended to the set of columns defined in the <see cref="P:System.Web.UI.WebControls.DataGrid.Columns" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.ArrayList" /> containing the effective set of columns in the right order.</para>
+        </returns>
         <param name="dataSource">
           <attribution license="cc4" from="Microsoft" modified="false" />The data source being used to create the control hierarchy </param>
         <param name="useDataSource">
@@ -1002,12 +1005,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Web.UI.WebControls.Style" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates new control style.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.Style" /> the represents the new style.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1026,7 +1032,6 @@
         <Parameter Name="itemType" Type="System.Web.UI.WebControls.ListItemType" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataGridItem'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.DataGrid.CreateItem(System.Int32,System.Int32,System.Web.UI.WebControls.ListItemType)" /> is a helper method used by the <see cref="T:System.Web.UI.WebControls.DataGrid" /> class to create its <see cref="T:System.Web.UI.WebControls.DataGridItem" /> objects.</para>
@@ -1038,6 +1043,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Web.UI.WebControls.DataGridItem" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.DataGridItem" /> object.</para>
+        </returns>
         <param name="itemIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index for the <see cref="T:System.Web.UI.WebControls.DataGridItem" /> object.</param>
         <param name="dataSourceIndex">
@@ -1706,7 +1715,6 @@
         <Parameter Name="e" Type="System.EventArgs" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.DataGrid.OnBubbleEvent(System.Object,System.EventArgs)" /> method to pass an event raised by a control within the container up the page's UI server control hierarchy.</para>
@@ -1718,6 +1726,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Passes the event raised by a control within the container up the page's UI server control hierarchy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true to indicate that this method is passing an event raised by a control within the container up the page's UI server control hierarchy; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The source of the event. </param>
         <param name="e">
@@ -2190,12 +2202,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the current state of the <see cref="T:System.Web.UI.WebControls.DataGrid" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The saved state of the <see cref="T:System.Web.UI.WebControls.DataGrid" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataGridColumn.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataGridColumn.xml
index 12e9d7ede17..52531ee8ec1 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataGridColumn.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataGridColumn.xml
@@ -437,7 +437,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.DataGridColumn.SaveViewState" /> method to save the state of the <see cref="T:System.Web.UI.WebControls.DataGridColumn" /> object. This allows a column to perform custom view-state management.</para>
@@ -446,6 +445,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the current state of the <see cref="T:System.Web.UI.WebControls.DataGridColumn" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that contains the saved state of the <see cref="T:System.Web.UI.WebControls.DataGridColumn" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -544,12 +547,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object containing state changes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> that contains the view state changes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IStateManager.TrackViewState">
@@ -579,7 +585,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.DataGridColumn.ToString" /> method to get the string representation of the column.</para>
@@ -591,6 +596,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the string representation of the column.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="F:System.String.Empty" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataGridColumnCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataGridColumnCollection.xml
index 5f513787c77..552970532f5 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataGridColumnCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataGridColumnCollection.xml
@@ -282,7 +282,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Collections.IEnumerator" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create a <see cref="T:System.Collections.IEnumerator" /> interface that can be iterated through easily to get each item in the <see cref="T:System.Web.UI.WebControls.DataGridColumnCollection" /> collection.</para>
@@ -297,6 +296,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Collections.IEnumerator" /> interface that contains all the <see cref="T:System.Web.UI.WebControls.DataGridColumn" />-derived column objects in the <see cref="T:System.Web.UI.WebControls.DataGridColumnCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.IEnumerator" /> interface that contains all <see cref="T:System.Web.UI.WebControls.DataGridColumn" />-derived column objects in the <see cref="T:System.Web.UI.WebControls.DataGridColumnCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -313,7 +316,6 @@
         <Parameter Name="column" Type="System.Web.UI.WebControls.DataGridColumn" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to determine the index number of the specified <see cref="T:System.Web.UI.WebControls.DataGridColumn" />-derived column object in the <see cref="T:System.Web.UI.WebControls.DataGridColumnCollection" /> collection. If the specified <see cref="T:System.Web.UI.WebControls.DataGridColumn" />-derived column object is not found, an index of -1 is returned.</para>
@@ -322,6 +324,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the specified <see cref="T:System.Web.UI.WebControls.DataGridColumn" />-derived column object from the <see cref="T:System.Web.UI.WebControls.DataGridColumnCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index position of the specified <see cref="T:System.Web.UI.WebControls.DataGridColumn" />-derived column in the <see cref="T:System.Web.UI.WebControls.DataGridColumnCollection" />. The default value is -1, which indicates that the specified <see cref="T:System.Web.UI.WebControls.DataGridColumn" />-derived object is not found.</para>
+        </returns>
         <param name="column">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.DataGridColumn" />-derived column to search for in the <see cref="T:System.Web.UI.WebControls.DataGridColumnCollection" />. </param>
       </Docs>
@@ -555,12 +561,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object containing state changes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that contains the saved view state values for the control.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IStateManager.TrackViewState">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataGridItem.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataGridItem.xml
index ba90690542d..cbe00c4073b 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataGridItem.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataGridItem.xml
@@ -249,12 +249,15 @@ List items contains one of this types.
       </Parameters>
       <Docs>
         <param name="args">To be added.</param>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used internally by the <see cref="T:System.Web.UI.WebControls.DataGridItem" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the event has been canceled; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The source of the event.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataGridItemCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataGridItemCollection.xml
index f114061488e..21d29bbc87c 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataGridItemCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataGridItemCollection.xml
@@ -126,7 +126,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Collections.IEnumerator" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create a <see cref="T:System.Collections.IEnumerator" />-implemented object that can be iterated through to get each item in the <see cref="T:System.Web.UI.WebControls.DataGridItemCollection" /> collection.</para>
@@ -141,6 +140,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Collections.IEnumerator" />-implemented object that contains all the <see cref="T:System.Web.UI.WebControls.DataGridItem" /> objects in the <see cref="T:System.Web.UI.WebControls.DataGridItemCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.IEnumerator" />-implemented object that contains all <see cref="T:System.Web.UI.WebControls.DataGridItem" /> objects in the <see cref="T:System.Web.UI.WebControls.DataGridItemCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataKey.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataKey.xml
index 29f24d55523..b2da692931b 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataKey.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataKey.xml
@@ -191,7 +191,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -204,6 +203,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the current view state of the <see cref="T:System.Web.UI.WebControls.DataKey" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that contains the saved state of the <see cref="T:System.Web.UI.WebControls.DataKey" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -265,7 +268,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.DataKey.System#Web#UI#IStateManager#SaveViewState" /> method is a helper method used by the <see cref="T:System.Web.UI.WebControls.DataKey" /> class to save the state of the object.</para>
@@ -274,6 +276,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the current view state of the <see cref="T:System.Web.UI.WebControls.DataKey" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that contains the saved state of the <see cref="T:System.Web.UI.WebControls.DataKey" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IStateManager.TrackViewState">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataKeyArray.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataKeyArray.xml
index d7ddc9e5c3b..a44939e6734 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataKeyArray.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataKeyArray.xml
@@ -126,7 +126,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -139,6 +138,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that contains all <see cref="T:System.Web.UI.WebControls.DataKey" /> objects in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" />-implemented object that contains all <see cref="T:System.Web.UI.WebControls.DataKey" /> objects in the collection.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -328,7 +331,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.DataKeyArray.System#Web#UI#IStateManager#SaveViewState" /> method is a helper method used by the <see cref="T:System.Web.UI.WebControls.DataKeyArray" /> class to save the state of the object.</para>
@@ -337,6 +339,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the current view state of the <see cref="T:System.Web.UI.WebControls.DataKeyArray" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that contains the saved state of the <see cref="T:System.Web.UI.WebControls.DataKeyArray" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IStateManager.TrackViewState">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataKeyCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataKeyCollection.xml
index 242b3de40cf..cc1dde2d6c9 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataKeyCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataKeyCollection.xml
@@ -127,7 +127,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Collections.IEnumerator" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create a <see cref="T:System.Collections.IEnumerator" /> implemented object that can be iterated through to get each item in the <see cref="T:System.Web.UI.WebControls.DataKeyCollection" />.</para>
@@ -142,6 +141,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Collections.IEnumerator" /> implemented object that contains all key fields in the <see cref="T:System.Web.UI.WebControls.DataKeyCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.IEnumerator" /> implemented object that contains all key fields in the <see cref="T:System.Web.UI.WebControls.DataKeyCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataList.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataList.xml
index fee8a614d5f..da20928932a 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataList.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataList.xml
@@ -632,7 +632,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Web.UI.WebControls.Style" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.DataList.CreateControlStyle" /> method is used primarily by control developers in deriving a custom implementation from the <see cref="T:System.Web.UI.WebControls.DataList" /> control.</para>
@@ -641,6 +640,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the default style object that is used internally by the <see cref="T:System.Web.UI.WebControls.DataList" /> control to implement all style related properties.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.TableStyle" /> that contains the default style properties for the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -658,7 +661,6 @@
         <Parameter Name="itemType" Type="System.Web.UI.WebControls.ListItemType" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DataListItem'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.DataList.CreateItem(System.Int32,System.Web.UI.WebControls.ListItemType)" /> method is used primarily by control developers in creating a custom implementation of the <see cref="T:System.Web.UI.WebControls.DataList" /> control. The <see cref="M:System.Web.UI.WebControls.DataList.CreateItem(System.Int32,System.Web.UI.WebControls.ListItemType)" /> method is functionally equivalent to calling the <see cref="M:System.Web.UI.WebControls.DataListItem.#ctor(System.Int32,System.Web.UI.WebControls.ListItemType)" /> constructor for a <see cref="T:System.Web.UI.WebControls.DataListItem" />. The <see cref="P:System.Web.UI.WebControls.DataListItem.ItemIndex" /> and <see cref="P:System.Web.UI.WebControls.DataListItem.ItemType" /> properties are initialized for the new <see cref="T:System.Web.UI.WebControls.DataListItem" /> using the specified values, but the item is not inserted into the <see cref="T:System.Web.UI.WebControls.DataList" />. </para>
@@ -668,6 +670,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Web.UI.WebControls.DataListItem" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Web.UI.WebControls.DataListItem" /> created with the specified list-item type.</para>
+        </returns>
         <param name="itemIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The specified location within the <see cref="T:System.Web.UI.WebControls.DataList" /> to place the created item.</param>
         <param name="itemType">
@@ -2017,7 +2023,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.DataList.SaveViewState" /> method is used primarily by control developers.</para>
@@ -2028,6 +2033,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the changes to the control view state since the time the page was posted back to the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object that contains the changes to the <see cref="T:System.Web.UI.WebControls.DataList" /> view state. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -2432,7 +2441,6 @@
         <Parameter Name="repeatIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.WebControls.DataList" /> instance is cast to an <see cref="T:System.Web.UI.WebControls.IRepeatInfoUser" /> interface.</para>
@@ -2441,6 +2449,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Web.UI.WebControls.IRepeatInfoUser.GetItemStyle(System.Web.UI.WebControls.ListItemType,System.Int32)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.Style" /> that represents the style of the specified item type at the specified index in the list control.</para>
+        </returns>
         <param name="itemType">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Web.UI.WebControls.ListItemType" /> enumeration values.</param>
         <param name="repeatIndex">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataListItem.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataListItem.xml
index d4a392d9ea4..235aa43de80 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataListItem.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataListItem.xml
@@ -70,7 +70,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Web.UI.WebControls.Style" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is primarily used by control developers, when extending the functionality of the <see cref="T:System.Web.UI.WebControls.DataListItem" /> control. </para>
@@ -79,6 +78,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Web.UI.WebControls.TableItemStyle" /> object for the <see cref="T:System.Web.UI.WebControls.DataListItem" /> control, which contains the style properties for the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.TableItemStyle" /> that contains the style properties of the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -245,7 +248,6 @@
         <Parameter Name="e" Type="System.EventArgs" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is used primarily by control developers when extending the functionality of the <see cref="T:System.Web.UI.WebControls.DataListItem" /> control.</para>
@@ -254,6 +256,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the event for the control is passed up the server control hierarchy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the event has been canceled; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The source of the event.</param>
         <param name="e">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataListItemCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataListItemCollection.xml
index 93f9801721b..ffbc67e80a1 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataListItemCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DataListItemCollection.xml
@@ -126,7 +126,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Collections.IEnumerator" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create a <see cref="T:System.Collections.IEnumerator" /> that can be easily iterated through to get each item in the <see cref="T:System.Web.UI.WebControls.DataListItemCollection" /> collection.</para>
@@ -141,6 +140,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Collections.IEnumerator" /> interface that contains all <see cref="T:System.Web.UI.WebControls.DataListItem" /> objects in the <see cref="T:System.Web.UI.WebControls.DataListItemCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.IEnumerator" /> interface that contains all <see cref="T:System.Web.UI.WebControls.DataListItem" /> objects in the <see cref="T:System.Web.UI.WebControls.DataListItemCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DetailsView.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DetailsView.xml
index 6d6ce531c44..f4b0388bed8 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DetailsView.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DetailsView.xml
@@ -1639,7 +1639,6 @@
         <Parameter Name="fieldProperties" Type="System.Web.UI.WebControls.AutoGeneratedFieldProperties" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1649,6 +1648,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Web.UI.WebControls.AutoGeneratedField" /> object that represents an automatically generated row field using the specified field properties.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.WebControls.AutoGeneratedField" /> that contains the field properties specified by the <paramref name="fieldProperties" /> parameter.</para>
+        </returns>
         <param name="fieldProperties">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Web.UI.WebControls.AutoGeneratedFieldProperties" /> that contains the properties for the <see cref="T:System.Web.UI.WebControls.AutoGeneratedField" />.</param>
       </Docs>
@@ -1666,7 +1669,6 @@
         <Parameter Name="dataItem" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1676,6 +1678,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a set of automatically generated row fields for the specified data item.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.ICollection" /> that contains the automatically generated row fields for the specified data item.</para>
+        </returns>
         <param name="dataItem">
           <attribution license="cc4" from="Microsoft" modified="false" />The data item for which to create the automatically generated row fields.</param>
       </Docs>
@@ -1695,7 +1701,6 @@
       </Parameters>
       <Docs>
         <param name="data">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1705,6 +1710,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the control hierarchy used to render the <see cref="T:System.Web.UI.WebControls.DetailsView" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of items in the data source.</para>
+        </returns>
         <param name="dataBinding">
           <attribution license="cc4" from="Microsoft" modified="false" />true to indicate that this method is being called during data binding; otherwise, false.</param>
       </Docs>
@@ -1720,7 +1729,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1762,6 +1770,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a default table style object for the <see cref="T:System.Web.UI.WebControls.DetailsView" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.Style" /> that contains the default table style for the <see cref="T:System.Web.UI.WebControls.DetailsView" /> control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1775,7 +1787,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1785,6 +1796,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the <see cref="T:System.Web.UI.DataSourceSelectArguments" /> object that gets passed to the Select command.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.UI.DataSourceSelectArguments" /> that gets passed to the Select command</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1801,7 +1816,6 @@
         <Parameter Name="useDataSource" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1811,6 +1825,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the complete set of automatically generated and user-defined row fields used to generate the control hierarchy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.ICollection" /> that contains both the automatically generated and the user-defined row fields for the specified data item.</para>
+        </returns>
         <param name="dataItem">
           <attribution license="cc4" from="Microsoft" modified="false" />The data item for which to create the row fields.</param>
         <param name="useDataSource">
@@ -1832,7 +1850,6 @@
         <Parameter Name="rowState" Type="System.Web.UI.WebControls.DataControlRowState" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1842,6 +1859,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Web.UI.WebControls.DetailsViewRow" /> object using the specified item index, row type, and row state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.DetailsViewRow" /> with the specified item index, row type, and row state.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the data item to display.</param>
         <param name="rowType">
@@ -1861,7 +1882,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1871,6 +1891,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the containing table for the <see cref="T:System.Web.UI.WebControls.DetailsView" /> control. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.Table" /> that represents the containing table for the <see cref="T:System.Web.UI.WebControls.DetailsView" /> control. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -2798,7 +2822,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2808,6 +2831,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the result of a callback event that targets a control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The results of the callback.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -2824,13 +2851,16 @@
         <Parameter Name="argument" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the callback string created using the specified argument.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The complete callback string to be sent to the client.</para>
+        </returns>
         <param name="buttonControl">
           <attribution license="cc4" from="Microsoft" modified="false" />The control that initiated the callback.</param>
         <param name="argument">
@@ -3270,7 +3300,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3293,6 +3322,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified data type can be bound to a field in the <see cref="T:System.Web.UI.WebControls.DetailsView" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified data type can be bound to a field in the <see cref="T:System.Web.UI.WebControls.DetailsView" /> control; otherwise, false.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents the data type to check.</param>
       </Docs>
@@ -3594,7 +3627,6 @@
         <Parameter Name="e" Type="System.EventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3604,6 +3636,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the event for the Web server control is passed up the page's user interface (UI) server control hierarchy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the event has been canceled; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The source of the event.</param>
         <param name="e">
@@ -4475,7 +4511,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is used to save the state of the properties in the <see cref="T:System.Web.UI.WebControls.DetailsView" /> control that need to be persisted, even when the <see cref="P:System.Web.UI.Control.EnableViewState" /> property is set to false.</para>
@@ -4487,6 +4522,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the state of the properties in the <see cref="T:System.Web.UI.WebControls.DetailsView" /> control that need to be persisted, even when the <see cref="P:System.Web.UI.Control.EnableViewState" /> property is set to false.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the server control's current view state. If there is no view state associated with the control, this method returns null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SaveViewState">
@@ -4497,7 +4536,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4507,6 +4545,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the current view state of the <see cref="T:System.Web.UI.WebControls.DetailsView" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that contains the saved state of the <see cref="T:System.Web.UI.WebControls.DetailsView" /> control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -4554,7 +4596,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Web.UI.WebControls.DetailsView" /> control implements the <see cref="T:System.Web.UI.ICallbackEventHandler" /> interface and uses the <see cref="M:System.Web.UI.WebControls.DetailsView.RaisePostBackEvent(System.String)" /> to retrieve data and the <see cref="M:System.Web.UI.WebControls.DetailsView.GetCallbackResult" /> method to return the retrieved data to the control.</para>
@@ -4563,6 +4604,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the method <see cref="M:System.Web.UI.WebControls.DetailsView.GetCallbackResult" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The results of the callback.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.ICallbackEventHandler.RaiseCallbackEvent">
@@ -4668,7 +4713,6 @@
       </Parameters>
       <Docs>
         <param name="control">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is a helper method that is called by the <see cref="T:System.Web.UI.WebControls.DetailsView" /> control to generate its callback script. If the <see cref="T:System.Web.UI.WebControls.DetailsView" /> control does not render client script, or if the <paramref name="argument" /> parameter is null or an empty string (""), this method returns null.</para>
@@ -4677,6 +4721,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the callback script for the <see cref="T:System.Web.UI.WebControls.DetailsView" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The callback script for the <see cref="T:System.Web.UI.WebControls.DetailsView" /> control.</para>
+        </returns>
         <param name="argument">
           <attribution license="cc4" from="Microsoft" modified="false" />The argument for the callback event.</param>
       </Docs>
@@ -4695,7 +4743,6 @@
       </Parameters>
       <Docs>
         <param name="control">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.WebControls.DetailsView" /> instance is cast to the <see cref="T:System.Web.UI.IPostBackEventHandler" /> interface.</para>
@@ -4704,6 +4751,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Web.UI.WebControls.IPostBackContainer.GetPostBackOptions(System.Web.UI.WebControls.IButtonControl)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.PostBackOptions" /> with the information required for <see cref="Overload:System.Web.UI.Page.GetPostBackEventReference" /> to construct a valid script that, when executed on the client, initiates a client postback. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TagKey">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DetailsViewRow.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DetailsViewRow.xml
index 8be5df468d8..2b58bec4b6f 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DetailsViewRow.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DetailsViewRow.xml
@@ -218,13 +218,16 @@
         <Parameter Name="e" Type="System.EventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether to pass an event up the page's ASP.NET server control hierarchy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the event has been canceled; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The source of the event.</param>
         <param name="e">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DetailsViewRowCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DetailsViewRowCollection.xml
index 0e7005aac18..b4d5c851fd7 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DetailsViewRowCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DetailsViewRowCollection.xml
@@ -126,7 +126,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -139,6 +138,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that contains all <see cref="T:System.Web.UI.WebControls.DetailsViewRow" /> objects in the <see cref="T:System.Web.UI.WebControls.DetailsViewRowCollection" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" />-implemented object that contains all <see cref="T:System.Web.UI.WebControls.DetailsViewRow" /> objects in the <see cref="T:System.Web.UI.WebControls.DetailsViewRowCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DropDownList.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DropDownList.xml
index 8eef35916dd..b8af9afd744 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DropDownList.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/DropDownList.xml
@@ -284,12 +284,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Web.UI.ControlCollection" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a collection to store child controls.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always returns an <see cref="T:System.Web.UI.EmptyControlCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -310,7 +313,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The ASP.NET page framework tracks all the server controls that return true from this method call, and then invokes the <see cref="M:System.Web.UI.WebControls.DropDownList.RaisePostDataChangedEvent" /> method on the <see cref="T:System.Web.UI.WebControls.DropDownList" /> control.</para>
@@ -319,6 +321,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes postback data for the <see cref="T:System.Web.UI.WebControls.DropDownList" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.UI.WebControls.DropDownList" /> control's state changes as a result of the postback event; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The index within the posted collection that references the content to load.</param>
         <param name="postCollection">
@@ -413,12 +419,15 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes posted data for the <see cref="T:System.Web.UI.WebControls.DropDownList" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the posted content is different from the last posting; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key value used to index an entry in the collection. </param>
         <param name="postCollection">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/EmbeddedMailObjectsCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/EmbeddedMailObjectsCollection.xml
index 08d64a30370..fd44f28b43b 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/EmbeddedMailObjectsCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/EmbeddedMailObjectsCollection.xml
@@ -68,13 +68,16 @@
         <Parameter Name="value" Type="System.Web.UI.WebControls.EmbeddedMailObject" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an <see cref="T:System.Web.UI.WebControls.EmbeddedMailObject" /> to the end of the <see cref="T:System.Web.UI.WebControls.EmbeddedMailObjectsCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the index of the <see cref="T:System.Web.UI.WebControls.EmbeddedMailObject" /> in the <see cref="T:System.Web.UI.WebControls.EmbeddedMailObjectsCollection" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.EmbeddedMailObject" /> to add to the <see cref="T:System.Web.UI.WebControls.EmbeddedMailObjectsCollection" />. </param>
       </Docs>
@@ -92,7 +95,6 @@
         <Parameter Name="value" Type="System.Web.UI.WebControls.EmbeddedMailObject" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -102,6 +104,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Web.UI.WebControls.EmbeddedMailObjectsCollection" /> contains a specific <see cref="T:System.Web.UI.WebControls.EmbeddedMailObject" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.UI.WebControls.EmbeddedMailObjectsCollection" /> contains <paramref name="obj" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.EmbeddedMailObject" /> to locate in the <see cref="T:System.Web.UI.WebControls.EmbeddedMailObjectsCollection" /> object.</param>
       </Docs>
@@ -145,13 +151,16 @@
         <Parameter Name="value" Type="System.Web.UI.WebControls.EmbeddedMailObject" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of a specific <see cref="T:System.Web.UI.WebControls.EmbeddedMailObject" /> in the <see cref="T:System.Web.UI.WebControls.EmbeddedMailObjectsCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the <see cref="T:System.Web.UI.WebControls.EmbeddedMailObject" /> if it exists in the <see cref="T:System.Web.UI.WebControls.EmbeddedMailObjectsCollection" />; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Web.UI.WebControls.EmbeddedMailObject" /> to locate in the <see cref="T:System.Web.UI.WebControls.EmbeddedMailObjectsCollection" />.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/FontInfo.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/FontInfo.xml
index 501a60c185e..f01adb10acd 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/FontInfo.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/FontInfo.xml
@@ -351,7 +351,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.FontInfo.ShouldSerializeNames" /> method to determine whether the <see cref="P:System.Web.UI.WebControls.FontInfo.Names" /> property has changed from its default value. This method is commonly used if you are either creating a designer for the <see cref="T:System.Web.UI.WebControls.FontInfo" /> class or creating your own control incorporating the <see cref="T:System.Web.UI.WebControls.FontInfo" /> class.</para>
@@ -363,6 +362,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="P:System.Web.UI.WebControls.FontInfo.Names" /> property should be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="P:System.Web.UI.WebControls.FontInfo.Names" /> property has changed from its default value; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -447,7 +450,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.FontInfo.ToString" /> method to create a string that contains the font name and size, separated by a comma, for an instance of the <see cref="T:System.Web.UI.WebControls.FontInfo" /> class.</para>
@@ -459,6 +461,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that contains the font name and size for an instance of the <see cref="T:System.Web.UI.WebControls.FontInfo" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the font name and size for an instance of the <see cref="T:System.Web.UI.WebControls.FontInfo" /> class.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/FontNamesConverter.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/FontNamesConverter.xml
index 92c9bf71738..3049615f0fa 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/FontNamesConverter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/FontNamesConverter.xml
@@ -57,7 +57,6 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.FontNamesConverter.CanConvertFrom(System.ComponentModel.ITypeDescriptorContext,System.Type)" /> method to determine whether the specified data type can be converted to an array of strings containing individual font names.</para>
@@ -70,6 +69,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether this converter can convert an object of the specified data type to an array of strings containing individual font names.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the type can be converted; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that provides information about the context of a type converter. You can optionally pass in null for this parameter. </param>
         <param name="sourceType">
@@ -92,7 +95,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.FontNamesConverter.ConvertFrom(System.ComponentModel.ITypeDescriptorContext,System.Globalization.CultureInfo,System.Object)" /> method to convert a string containing a list of font names to an array of strings containing the individual names. Each font name in the string must be separated by a comma. For example, the string "arial, times new roman, verdana", converts to an array that contains the strings "arial", "times new roman", and "verdana". Notice that the commas are removed along with any white space at the beginning or end of the font name. White space in the middle of a font name is not removed.</para>
@@ -104,6 +106,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string that represents a list of font names into an array of strings containing individual font names.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Object" /> instance that represents the array of strings containing the individual font names.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that provides information about the context of a type converter. This parameter is not used in this method. It is reserved for future versions of this method. You can optionally pass in null for this parameter. </param>
         <param name="culture">
@@ -129,7 +135,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.FontNamesConverter.ConvertTo(System.ComponentModel.ITypeDescriptorContext,System.Globalization.CultureInfo,System.Object,System.Type)" /> method to convert an array of strings containing the individual font names to a single string containing a list of the names. For example, an array that contains the strings "arial", "times new roman", and "verdana" converts to the string "arial,times new roman,verdana". Notice that commas are automatically inserted between the font names without any white space.</para>
@@ -144,6 +149,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a string that represents a list of font names from an array of strings containing individual font names.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Object" /> instance that represents a string containing a list of font names.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that provides information about the context of a type converter. This parameter is not used in this method. It is reserved for future versions of this method. You can optionally pass in null for this parameter. </param>
         <param name="culture">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/FontUnit.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/FontUnit.xml
index c9b9088e979..2ec87b7ddd3 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/FontUnit.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/FontUnit.xml
@@ -541,7 +541,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.FontUnit.Equals(System.Object)" /> method to determine whether the specified <see cref="T:System.Object" /> is equivalent to the instance of the <see cref="T:System.Web.UI.WebControls.FontUnit" /> class that this method is called from. For the specified <see cref="T:System.Object" /> to be equivalent, the object must be a <see cref="T:System.Web.UI.WebControls.FontUnit" /> that contains the same values for the <see cref="P:System.Web.UI.WebControls.FontUnit.Type" /> and <see cref="P:System.Web.UI.WebControls.FontUnit.Unit" /> properties as the instance of the <see cref="T:System.Web.UI.WebControls.FontUnit" /> class that this method is called from.</para>
@@ -550,6 +549,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is equivalent to the instance of the <see cref="T:System.Web.UI.WebControls.FontUnit" /> class that this method is called from.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Object" /> is equivalent to the instance of the <see cref="T:System.Web.UI.WebControls.FontUnit" /> class that this method is called from; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Object" /> that contains the object to compare to this instance. </param>
       </Docs>
@@ -566,12 +569,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Int32" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer that represents the hash code.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -683,7 +689,6 @@
         <Parameter Name="right" Type="System.Web.UI.WebControls.FontUnit" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For the <see cref="T:System.Web.UI.WebControls.FontUnit" /> objects to be equivalent, each object must have the same values for the <see cref="P:System.Web.UI.WebControls.FontUnit.Type" /> and <see cref="P:System.Web.UI.WebControls.FontUnit.Unit" /> properties.</para>
@@ -692,6 +697,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Web.UI.WebControls.FontUnit" /> objects for equality.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if both <see cref="T:System.Web.UI.WebControls.FontUnit" /> objects are equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.WebControls.FontUnit" /> on the left of the operator that contains font properties. </param>
         <param name="right">
@@ -733,7 +742,6 @@
         <Parameter Name="right" Type="System.Web.UI.WebControls.FontUnit" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For the <see cref="T:System.Web.UI.WebControls.FontUnit" /> objects to be not equal to each other, each object must either have different values for the <see cref="P:System.Web.UI.WebControls.FontUnit.Type" /> property or the <see cref="P:System.Web.UI.WebControls.FontUnit.Unit" /> property.</para>
@@ -742,6 +750,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Web.UI.WebControls.FontUnit" /> objects for inequality.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if both <see cref="T:System.Web.UI.WebControls.FontUnit" /> objects are not equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.WebControls.FontUnit" /> that contains font properties on the left of the operator. </param>
         <param name="right">
@@ -762,7 +774,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'FontUnit'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the static <see cref="M:System.Web.UI.WebControls.FontUnit.Parse(System.String)" /> method to convert the specified string to its <see cref="T:System.Web.UI.WebControls.FontUnit" /> equivalent.</para>
@@ -860,6 +871,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string to its <see cref="T:System.Web.UI.WebControls.FontUnit" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.FontUnit" /> that represents the font size specified by the <paramref name="s" /> parameter.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string representation of one of the <see cref="T:System.Web.UI.WebControls.FontSize" /> values. </param>
       </Docs>
@@ -879,7 +894,6 @@
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Web.UI.WebControls.FontUnit" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the static <see cref="M:System.Web.UI.WebControls.FontUnit.Parse(System.String)" /> method to convert the specified string and culture to its <see cref="T:System.Web.UI.WebControls.FontUnit" /> equivalent.</para>
@@ -977,6 +991,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string to its <see cref="T:System.Web.UI.WebControls.FontUnit" /> equivalent in the specified culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.FontUnit" /> that represents the font size specified by the <paramref name="s" /> parameter in the culture specified by the <paramref name="culture" /> parameter.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string representation of one of the <see cref="T:System.Web.UI.WebControls.FontSize" /> values. </param>
         <param name="culture">
@@ -997,7 +1015,6 @@
         <Parameter Name="n" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'FontUnit'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the static <see cref="M:System.Web.UI.WebControls.FontUnit.Point(System.Int32)" /> method to create a <see cref="T:System.Web.UI.WebControls.FontUnit" /> that represents the font size specified by the <paramref name="n" /> parameter.</para>
@@ -1006,6 +1023,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Web.UI.WebControls.FontUnit" /> of type <see cref="T:System.Drawing.Point" /> from an integer value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.FontUnit" /> that represents the font size specified by the <paramref name="n" /> parameter.</para>
+        </returns>
         <param name="n">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer representing the <see cref="T:System.Drawing.Point" /> value to convert to a <see cref="T:System.Web.UI.WebControls.FontUnit" />. </param>
       </Docs>
@@ -1071,7 +1092,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.FontUnit.ToString" /> method to retrieve the string representation of the <see cref="T:System.Web.UI.WebControls.FontUnit" />. If the <see cref="P:System.Web.UI.WebControls.FontUnit.Type" /> property is set to FontSize.AsUnit, the returned string is the string equivalent of the <see cref="T:System.Web.UI.WebControls.Unit" /> contained in the <see cref="P:System.Web.UI.WebControls.FontUnit.Unit" /> property. If the <see cref="P:System.Web.UI.WebControls.FontUnit.Type" /> property is set to any other <see cref="T:System.Web.UI.WebControls.FontSize" /> value, the returned string is the string equivalent of the <see cref="T:System.Web.UI.WebControls.FontSize" /> value.</para>
@@ -1080,6 +1100,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.Web.UI.WebControls.FontUnit" /> object to the default string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the <see cref="T:System.Web.UI.WebControls.FontUnit" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1096,7 +1120,6 @@
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.FontUnit.ToString" /> method to retrieve the string representation of the <see cref="T:System.Web.UI.WebControls.FontUnit" /> in the specified culture. If the <see cref="P:System.Web.UI.WebControls.FontUnit.Type" /> property is set to FontSize.AsUnit, the returned string is the string equivalent of the <see cref="T:System.Web.UI.WebControls.Unit" /> contained in the <see cref="P:System.Web.UI.WebControls.FontUnit.Unit" /> property. If the <see cref="P:System.Web.UI.WebControls.FontUnit.Type" /> property is set to any other <see cref="T:System.Web.UI.WebControls.FontSize" /> value, the returned string is the string equivalent of the <see cref="T:System.Web.UI.WebControls.FontSize" /> value.</para>
@@ -1105,6 +1128,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.Web.UI.WebControls.FontUnit" /> object to a string representation, using the specified <see cref="T:System.Globalization.CultureInfo" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the <see cref="T:System.Web.UI.WebControls.FontUnit" /> object in the specified culture.</para>
+        </returns>
         <param name="culture">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Globalization.CultureInfo" /> that contains the culture to represent the <see cref="T:System.Web.UI.WebControls.FontUnit" />. </param>
       </Docs>
@@ -1127,7 +1154,6 @@
       </Parameters>
       <Docs>
         <param name="fmt">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.FontUnit.ToString" /> method to retrieve the string representation of the <see cref="T:System.Web.UI.WebControls.FontUnit" /> object using a culture-specific format provider for any numeric values that are in the string. </para>
@@ -1138,6 +1164,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a <see cref="T:System.Web.UI.WebControls.FontUnit" /> object to a string equivalent using the specified format provider.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents this <see cref="T:System.Web.UI.WebControls.FontUnit" />, with any numeric unit value in the format specified by <paramref name="formatProvider" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Type">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/FontUnitConverter.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/FontUnitConverter.xml
index 95ec1638155..6186263fd9d 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/FontUnitConverter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/FontUnitConverter.xml
@@ -60,7 +60,6 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.FontUnitConverter.CanConvertFrom(System.ComponentModel.ITypeDescriptorContext,System.Type)" /> method to determine whether the data type specified by the <paramref name="sourceType" /> parameter can be converted to a <see cref="T:System.Web.UI.WebControls.FontUnit" />.</para>
@@ -72,6 +71,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a data type can be converted to a <see cref="T:System.Web.UI.WebControls.FontUnit" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the data type specified by the <paramref name="sourceType" /> parameter can be converted to a <see cref="T:System.Web.UI.WebControls.FontUnit" />; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> implemented object that provides information about the context of a type converter. </param>
         <param name="sourceType">
@@ -97,12 +100,18 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the converter can convert a <see cref="T:System.Web.UI.WebControls.FontUnit" /> object to the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the converter supports converting a <see cref="T:System.Web.UI.WebControls.FontUnit" /> object to the destination type; otherwise, false.</para>
+          <block subset="none" type="note">
+            <para>This method will return true only if the <paramref name="destinationType" /> is <see cref="T:System.String" />. The only type this converter can convert <see cref="T:System.Web.UI.WebControls.FontUnit" /> into is <see cref="T:System.String" />.</para>
+          </block>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that indicates the context of the object to convert.</param>
         <param name="destinationType">
@@ -121,7 +130,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.FontUnitConverter.ConvertFrom(System.ComponentModel.ITypeDescriptorContext,System.Globalization.CultureInfo,System.Object)" /> method to convert the object specified by the <paramref name="value" /> parameter to a <see cref="T:System.Web.UI.WebControls.FontUnit" /> in the culture specified by the <paramref name="culture" /> parameter.</para>
@@ -136,6 +144,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an object to a <see cref="T:System.Web.UI.WebControls.FontUnit" /> in a specific culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> implemented object that provides information about the context of a type converter. </param>
         <param name="culture">
@@ -161,7 +173,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.FontUnitConverter.ConvertTo(System.ComponentModel.ITypeDescriptorContext,System.Globalization.CultureInfo,System.Object,System.Type)" /> method to convert the <see cref="T:System.Web.UI.WebControls.FontUnit" /> specified by the <paramref name="value" /> parameter to an object with the data type specified by the <paramref name="destinationType" /> parameter.</para>
@@ -177,6 +188,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a <see cref="T:System.Web.UI.WebControls.FontUnit" /> to an object with a different data type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> implemented object that provides information about the context of a type converter. </param>
         <param name="culture">
@@ -201,7 +216,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.ComponentModel.TypeConverter+StandardValuesCollection" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.FontUnitConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> method to retrieve a <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> containing the standard values for a <see cref="T:System.Web.UI.WebControls.FontUnit" />. This collection contains all the fields in the <see cref="T:System.Web.UI.WebControls.FontUnit" /> class.</para>
@@ -210,6 +224,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> containing the standard values for a <see cref="T:System.Web.UI.WebControls.FontUnit" />, using the specified format context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> containing the standard values for a <see cref="T:System.Web.UI.WebControls.FontUnit" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides information about the context of a type converter. </param>
       </Docs>
@@ -228,7 +246,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.FontUnitConverter.GetStandardValuesExclusive(System.ComponentModel.ITypeDescriptorContext)" /> method to determine whether the <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> returned by the <see cref="M:System.Web.UI.WebControls.FontUnitConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> method is an exclusive list of values. This method is overridden to always return false to indicate that the list of values is not an exclusive list.</para>
@@ -237,6 +254,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> returned by the <see cref="M:System.Web.UI.WebControls.FontUnitConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> method is an exclusive list of values, using the specified format context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>false for all cases.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides information about the context of a type converter. </param>
       </Docs>
@@ -255,7 +276,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.FontUnitConverter.GetStandardValuesSupported(System.ComponentModel.ITypeDescriptorContext)" /> method to determine whether the instance of the <see cref="T:System.Web.UI.WebControls.FontUnitConverter" /> class that this method is called from supports a standard set of values that can be picked from a list, using the specified format context. This method is overridden to always return true to indicate that this class supports a standard set of values that can be picked from a list.</para>
@@ -264,6 +284,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the instance of the <see cref="T:System.Web.UI.WebControls.FontUnitConverter" /> class that this method is called from supports a standard set of values that can be picked from a list, using the specified format context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true for all cases.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides information about the context of a type converter. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/FormParameter.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/FormParameter.xml
index 80ccee8ad26..c77f61bc4a2 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/FormParameter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/FormParameter.xml
@@ -135,7 +135,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -145,6 +144,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a duplicate of the current <see cref="T:System.Web.UI.WebControls.FormParameter" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.FormParameter" /> that is an exact duplicate of the current one.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -162,7 +165,6 @@
       </Parameters>
       <Docs>
         <param name="ctx">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -173,6 +175,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Updates and returns the value of the <see cref="T:System.Web.UI.WebControls.FormParameter" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the updated and current value of the parameter. If the context or the request is null (Nothing in Visual Basic), the <see cref="M:System.Web.UI.WebControls.FormParameter.Evaluate(System.Web.HttpContext,System.Web.UI.Control)" /> method returns null.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.Control" /> that is associated with the page where the <see cref="T:System.Web.UI.WebControls.FormParameter" /> is used. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/FormView.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/FormView.xml
index 73c9b04e09c..dc0da6ace05 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/FormView.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/FormView.xml
@@ -1196,7 +1196,6 @@
       </Parameters>
       <Docs>
         <param name="data">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1206,6 +1205,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the control hierarchy used to render the <see cref="T:System.Web.UI.WebControls.FormView" /> control with the specified data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of items created from the data source.</para>
+        </returns>
         <param name="dataBinding">
           <attribution license="cc4" from="Microsoft" modified="false" />true to indicate that the control hierarchy is created directly from the data source; false to indicate the control hierarchy is created from the view state.</param>
       </Docs>
@@ -1221,7 +1224,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1231,6 +1233,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a default table style object for the <see cref="T:System.Web.UI.WebControls.FormView" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.Style" /> that contains the default table style for the <see cref="T:System.Web.UI.WebControls.FormView" /> control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1244,7 +1250,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1254,6 +1259,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the <see cref="T:System.Web.UI.DataSourceSelectArguments" /> object that contains the arguments that are passed to the data source for processing.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.DataSourceSelectArguments" /> that contains the arguments that are passed to the data source.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1272,7 +1281,6 @@
       </Parameters>
       <Docs>
         <param name="rowIndex">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1282,6 +1290,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Web.UI.WebControls.FormViewRow" /> object using the specified item index, row type, and row state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.FormViewRow" /> with the specified item index, row type, and row state.</para>
+        </returns>
         <param name="rowType">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Web.UI.WebControls.DataControlRowType" /> enumeration values.</param>
         <param name="rowState">
@@ -1299,7 +1311,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1309,6 +1320,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the containing table for the <see cref="T:System.Web.UI.WebControls.FormView" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.Table" /> that represents the containing table for the <see cref="T:System.Web.UI.WebControls.FormView" /> control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -2807,7 +2822,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2842,6 +2856,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified data type can be bound to a field in the <see cref="T:System.Web.UI.WebControls.FormView" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified data type can be bound to a field in the <see cref="T:System.Web.UI.WebControls.FormView" /> control; otherwise, false.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents the data type to check.</param>
       </Docs>
@@ -3337,7 +3355,6 @@
         <Parameter Name="e" Type="System.EventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3444,6 +3461,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Handles an event passed up through the control hierarchy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true to indicate the event should be passed further up the control hierarchy; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The source of the event.</param>
         <param name="e">
@@ -4337,7 +4358,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is used to save the state of the <see cref="T:System.Web.UI.WebControls.FormView" /> control properties that need to be persisted, even when the <see cref="P:System.Web.UI.Control.EnableViewState" /> property is set to false.</para>
@@ -4349,6 +4369,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the state of the <see cref="T:System.Web.UI.WebControls.FormView" /> control properties that need to be persisted, even when the <see cref="P:System.Web.UI.Control.EnableViewState" /> property is set to false.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the server control's current view state. If there is no view state associated with the control, this method returns null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SaveViewState">
@@ -4359,7 +4383,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4369,6 +4392,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the current view state of the <see cref="T:System.Web.UI.WebControls.FormView" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that contains the saved state of the <see cref="T:System.Web.UI.WebControls.FormView" /> control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -4488,7 +4515,6 @@
       </Parameters>
       <Docs>
         <param name="control">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.FormView.System#Web#UI#WebControls#IPostBackContainer#GetPostBackOptions(System.Web.UI.WebControls.IButtonControl)" /> method is a helper method that is called by the <see cref="T:System.Web.UI.WebControls.FormView" /> control to create a <see cref="T:System.Web.UI.PostBackOptions" /> object that contains the postback event options for the control. The <see cref="T:System.Web.UI.PostBackOptions" /> object is typically used as a parameter for the <see cref="M:System.Web.UI.Page.GetPostBackEventReference(System.Web.UI.Control,System.String)" /> method.</para>
@@ -4497,6 +4523,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the postback event options for the <see cref="T:System.Web.UI.WebControls.FormView" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The postback event options for the <see cref="T:System.Web.UI.WebControls.FormView" /> control.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TagKey">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/FormViewRow.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/FormViewRow.xml
index ecee7f8fd14..64cf8b4ebfb 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/FormViewRow.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/FormViewRow.xml
@@ -234,13 +234,16 @@
         <Parameter Name="e" Type="System.EventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether to pass an event up the page's ASP.NET server control hierarchy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the event has been canceled; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The source of the event.</param>
         <param name="e">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/GridView.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/GridView.xml
index bd1ccad71b0..a62bf848edf 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/GridView.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/GridView.xml
@@ -1837,7 +1837,6 @@
         <Parameter Name="fieldProperties" Type="System.Web.UI.WebControls.AutoGeneratedFieldProperties" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1850,6 +1849,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an automatically generated column field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.WebControls.AutoGeneratedField" /> that represents the automatically generated column field specified by the <paramref name="fieldProperties" /> parameter.</para>
+        </returns>
         <param name="fieldProperties">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Web.UI.WebControls.AutoGeneratedFieldProperties" /> that represents the properties of the automatically generated column field to create.</param>
       </Docs>
@@ -1869,7 +1872,6 @@
       </Parameters>
       <Docs>
         <param name="data">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1882,6 +1884,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the control hierarchy used to render the <see cref="T:System.Web.UI.WebControls.GridView" /> control using the specified data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows created.</para>
+        </returns>
         <param name="dataBinding">
           <attribution license="cc4" from="Microsoft" modified="false" />true to indicate that the child controls are bound to data; otherwise, false. </param>
       </Docs>
@@ -1897,7 +1903,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1907,6 +1912,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new child table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always returns a new <see cref="T:System.Web.UI.WebControls.Table" /> that represents the child table.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1923,7 +1932,6 @@
         <Parameter Name="useDataSource" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1936,6 +1944,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the set of column fields used to build the control hierarchy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.ICollection" /> that contains the fields used to build the control hierarchy.</para>
+        </returns>
         <param name="dataSource">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.WebControls.PagedDataSource" /> that represents the data source. </param>
         <param name="useDataSource">
@@ -1953,7 +1965,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1966,6 +1977,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the default style for the control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.Style" /> that represents the style for the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1979,7 +1994,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1989,6 +2003,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the <see cref="T:System.Web.UI.DataSourceSelectArguments" /> object that contains the arguments that get passed to the data source for processing.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.DataSourceSelectArguments" /> that contains the arguments that get passed to the data source.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -2007,7 +2025,6 @@
         <Parameter Name="rowState" Type="System.Web.UI.WebControls.DataControlRowState" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2020,6 +2037,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a row in the <see cref="T:System.Web.UI.WebControls.GridView" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.GridViewRow" /> created using the specified parameters.</para>
+        </returns>
         <param name="rowIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the row to create. </param>
         <param name="dataSourceIndex">
@@ -2511,7 +2532,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2521,6 +2541,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the result of a callback event that targets a control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The results of the callback.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -2538,7 +2562,6 @@
       </Parameters>
       <Docs>
         <param name="control">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2548,6 +2571,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the callback script for a button that performs a sorting operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The callback script for a button that performs a sorting operation.</para>
+        </returns>
         <param name="argument">
           <attribution license="cc4" from="Microsoft" modified="false" />The arguments to pass to the callback script.</param>
       </Docs>
@@ -2863,7 +2890,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2955,6 +2981,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified data type can be bound to a column in a <see cref="T:System.Web.UI.WebControls.GridView" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified data type can be bound to a column in a <see cref="T:System.Web.UI.WebControls.GridView" /> control; otherwise, false.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents the data type to test. </param>
       </Docs>
@@ -3026,7 +3056,6 @@
         <Parameter Name="e" Type="System.EventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3036,6 +3065,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the event for the Web server control is passed up the page's user interface (UI) server control hierarchy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the event has been canceled; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The source of the event. </param>
         <param name="e">
@@ -4445,7 +4478,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is used to save the state of the properties in the <see cref="T:System.Web.UI.WebControls.GridView" /> control that need to be persisted, even when the <see cref="P:System.Web.UI.Control.EnableViewState" /> property is set to false.</para>
@@ -4457,6 +4489,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the state of the properties in the <see cref="T:System.Web.UI.WebControls.GridView" /> control that need to be persisted, even when the <see cref="P:System.Web.UI.Control.EnableViewState" /> property is set to false.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the server control's current view state. If there is no view state associated with the control, this method returns null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SaveViewState">
@@ -4467,13 +4503,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads the previously saved view state of the <see cref="T:System.Web.UI.WebControls.GridView" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Object" /> that contains the saved view state values for the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -4906,7 +4945,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Web.UI.WebControls.GridView" /> control implements the <see cref="T:System.Web.UI.ICallbackEventHandler" /> interface and uses the <see cref="M:System.Web.UI.WebControls.GridView.RaisePostBackEvent(System.String)" /> to asynchronously retrieve data and the <see cref="M:System.Web.UI.WebControls.GridView.GetCallbackResult" /> method to return the retrieved data to the control.</para>
@@ -4915,6 +4953,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the result of a callback event that targets a control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The results of the callback.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.ICallbackEventHandler.RaiseCallbackEvent">
@@ -4985,7 +5027,6 @@
       </Parameters>
       <Docs>
         <param name="control">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -4995,6 +5036,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the callback script for a button that performs a sorting operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The callback script for a button that performs a sorting operation.</para>
+        </returns>
         <param name="argument">
           <attribution license="cc4" from="Microsoft" modified="false" />The arguments to pass to the callback script.</param>
       </Docs>
@@ -5013,12 +5058,15 @@
       </Parameters>
       <Docs>
         <param name="control">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Web.UI.PostBackOptions" /> object that represents the postback behavior of the specified button control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.PostBackOptions" /> that represents the postback behavior of the specified button control.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TagKey">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/GridViewRow.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/GridViewRow.xml
index 0fd170b9090..6a8f2d00062 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/GridViewRow.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/GridViewRow.xml
@@ -285,13 +285,16 @@
         <Parameter Name="e" Type="System.EventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether to pass an event up the page's ASP.NET server control hierarchy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the event has been canceled; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The source of the event.</param>
         <param name="e">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/GridViewRowCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/GridViewRowCollection.xml
index cb8f6b3a844..d8597ccae89 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/GridViewRowCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/GridViewRowCollection.xml
@@ -123,7 +123,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -136,6 +135,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that contains all <see cref="T:System.Web.UI.WebControls.GridViewRow" /> objects in the <see cref="T:System.Web.UI.WebControls.GridViewRowCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> implemented object that contains all <see cref="T:System.Web.UI.WebControls.GridViewRow" /> objects in the <see cref="T:System.Web.UI.WebControls.GridViewRowCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/HiddenField.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/HiddenField.xml
index a8c8c5f0e82..65a1fcceb96 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/HiddenField.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/HiddenField.xml
@@ -99,7 +99,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -109,6 +108,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Web.UI.EmptyControlCollection" /> object used to indicate that child controls are not allowed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always returns an <see cref="T:System.Web.UI.EmptyControlCollection" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -169,7 +172,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -179,6 +181,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes postback data for a <see cref="T:System.Web.UI.WebControls.HiddenField" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.UI.WebControls.HiddenField" /> control's state changes as a result of the postback; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key identifier for the control.</param>
         <param name="postCollection">
@@ -321,7 +327,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.WebControls.HiddenField" /> instance is cast to an <see cref="T:System.Web.UI.IPostBackDataHandler" /> interface.</para>
@@ -330,6 +335,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see the <see cref="M:System.Web.UI.IPostBackDataHandler.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the server control's state changes as a result of the postback; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key identifier for the control.</param>
         <param name="postCollection">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/HierarchicalDataBoundControl.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/HierarchicalDataBoundControl.xml
index e7e93089d52..8b2f8dc5e79 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/HierarchicalDataBoundControl.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/HierarchicalDataBoundControl.xml
@@ -76,7 +76,6 @@
         <Parameter Name="viewPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -86,6 +85,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a <see cref="T:System.Web.UI.HierarchicalDataSourceView" /> object that the data-bound control uses to perform data operations.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.UI.HierarchicalDataSourceView" /> object that the data-bound control uses to perform data operations. </para>
+        </returns>
         <param name="viewPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The hierarchical path of the view to retrieve.</param>
       </Docs>
@@ -101,7 +104,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -111,6 +113,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the <see cref="T:System.Web.UI.IHierarchicalDataSource" /> that the data-bound control is associated with, if any.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.IHierarchicalDataSource" /> instance that represents the data source identified by the <see cref="P:System.Web.UI.WebControls.DataBoundControl.DataSourceID" /> property. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/HotSpot.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/HotSpot.xml
index 622efc5077b..3ac5a2fa860 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/HotSpot.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/HotSpot.xml
@@ -133,7 +133,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -143,6 +142,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns a string that represents the coordinates of the <see cref="T:System.Web.UI.WebControls.HotSpot" /> region.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the coordinates of the <see cref="T:System.Web.UI.WebControls.HotSpot" /> region.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -396,7 +399,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -408,6 +410,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the changes to the <see cref="T:System.Web.UI.WebControls.HotSpot" /> object's view state since the time the page was posted back to the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> that contains the changes to the <see cref="T:System.Web.UI.WebControls.HotSpot" /> object's view state. If no view state is associated with the object, this method returns null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -472,7 +478,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Typically, you should use the <see cref="M:System.Web.UI.WebControls.HotSpot.SaveViewState" /> method to save the view state for the <see cref="T:System.Web.UI.WebControls.HotSpot" /> region. </para>
@@ -482,6 +487,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the changes to the <see cref="T:System.Web.UI.WebControls.HotSpot" /> object's view state since the last time the page was posted back to the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> that contains the changes to the <see cref="T:System.Web.UI.WebControls.HotSpot" /> object's view state.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IStateManager.TrackViewState">
@@ -644,7 +653,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -654,6 +662,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.String" /> representation of this instance of a <see cref="T:System.Web.UI.WebControls.HotSpot" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents this <see cref="T:System.Web.UI.WebControls.HotSpot" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/HotSpotCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/HotSpotCollection.xml
index 6b3900c9be5..8a56a7e3523 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/HotSpotCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/HotSpotCollection.xml
@@ -57,7 +57,6 @@
         <Parameter Name="spot" Type="System.Web.UI.WebControls.HotSpot" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -67,6 +66,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends a specified <see cref="T:System.Web.UI.WebControls.HotSpot" /> object to the end of the <see cref="T:System.Web.UI.WebControls.HotSpotCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the object was added to the collection.</para>
+        </returns>
         <param name="spot">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.HotSpot" /> object to append to the collection. </param>
       </Docs>
@@ -85,7 +88,6 @@
       </Parameters>
       <Docs>
         <param name="idx">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -140,6 +142,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a default instance of a type derived from the <see cref="T:System.Web.UI.WebControls.HotSpot" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object of a specified type derived from the <see cref="T:System.Web.UI.WebControls.HotSpot" /> class.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -153,7 +159,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -167,6 +172,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an array of the <see cref="T:System.Web.UI.WebControls.HotSpot" /> object-derived types that a <see cref="T:System.Web.UI.WebControls.HotSpotCollection" /> collection can contain. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Web.UI.WebControls.HotSpot" /> object-derived types that a <see cref="T:System.Web.UI.WebControls.HotSpotCollection" /> collection can contain.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/HyperLinkColumn.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/HyperLinkColumn.xml
index bc5d34fb6df..2c9234b3c4d 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/HyperLinkColumn.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/HyperLinkColumn.xml
@@ -201,7 +201,6 @@
       </Parameters>
       <Docs>
         <param name="value">To be added: an object of type 'object'</param>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.HyperLinkColumn.FormatDataNavigateUrlValue(System.Object)" /> method to format a data-bound URL value with the format specified by the <see cref="P:System.Web.UI.WebControls.HyperLinkColumn.DataNavigateUrlFormatString" /> property.</para>
@@ -210,6 +209,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Formats a data-bound URL using the format specified by the <see cref="P:System.Web.UI.WebControls.HyperLinkColumn.DataNavigateUrlFormatString" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The data-bound URL in the format specified by the <see cref="P:System.Web.UI.WebControls.HyperLinkColumn.DataNavigateUrlFormatString" /> property.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -227,7 +230,6 @@
       </Parameters>
       <Docs>
         <param name="value">To be added: an object of type 'object'</param>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.HyperLinkColumn.FormatDataTextValue(System.Object)" /> method to format a data-bound text caption value with the format specified by the <see cref="P:System.Web.UI.WebControls.HyperLinkColumn.DataTextFormatString" /> property.</para>
@@ -236,6 +238,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Formats a data-bound text caption using the format specified by the <see cref="P:System.Web.UI.WebControls.HyperLinkColumn.DataTextFormatString" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The data-bound text caption in the format specified by the <see cref="P:System.Web.UI.WebControls.HyperLinkColumn.DataTextFormatString" /> property.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/HyperLinkControlBuilder.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/HyperLinkControlBuilder.xml
index cb12a924d54..730870af30d 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/HyperLinkControlBuilder.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/HyperLinkControlBuilder.xml
@@ -46,7 +46,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method overrides the <see cref="M:System.Web.UI.ControlBuilder.AllowWhitespaceLiterals" /> property to ignore white space in the <see cref="T:System.Web.UI.WebControls.HyperLink" /> control.</para>
@@ -55,6 +54,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether white spaces are allowed in literals for this control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Overloaded to always returns false to indicate that white spaces are not allowed.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/HyperLinkField.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/HyperLinkField.xml
index 679de4402ab..8696df9d958 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/HyperLinkField.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/HyperLinkField.xml
@@ -138,7 +138,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -148,6 +147,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new instance of the <see cref="T:System.Web.UI.WebControls.HyperLinkField" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.Web.UI.WebControls.HyperLinkField" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -461,7 +464,6 @@
         <Parameter Name="dataUrlValues" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -471,6 +473,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Formats the navigation URL using the format string specified by the <see cref="P:System.Web.UI.WebControls.HyperLinkField.DataNavigateUrlFormatString" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The formatted URL value.</para>
+        </returns>
         <param name="dataUrlValues">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of values to combine with the format string.</param>
       </Docs>
@@ -488,7 +494,6 @@
         <Parameter Name="dataTextValue" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -501,6 +506,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Formats the caption text using the format string specified by the <see cref="P:System.Web.UI.WebControls.HyperLinkField.DataTextFormatString" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The formatted text value.</para>
+        </returns>
         <param name="dataTextValue">
           <attribution license="cc4" from="Microsoft" modified="false" />The text value to format. </param>
       </Docs>
@@ -520,13 +529,16 @@
       </Parameters>
       <Docs>
         <param name="sortingEnabled">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes the <see cref="T:System.Web.UI.WebControls.HyperLinkField" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always returns false.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The data control that acts as the parent for the <see cref="T:System.Web.UI.WebControls.HyperLinkField" />.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ICallbackContainer.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ICallbackContainer.xml
index 6d3193b7b14..9e205368b14 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ICallbackContainer.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ICallbackContainer.xml
@@ -31,7 +31,6 @@
       </Parameters>
       <Docs>
         <param name="control">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -43,6 +42,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a script for initiating a client callback to a Web server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A script that, when run on a client, will initiate a callback to the Web server.</para>
+        </returns>
         <param name="argument">
           <attribution license="cc4" from="Microsoft" modified="false" />The arguments used to build the callback script.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/IPostBackContainer.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/IPostBackContainer.xml
index de516f14ee2..88f1213201b 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/IPostBackContainer.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/IPostBackContainer.xml
@@ -31,7 +31,6 @@
       </Parameters>
       <Docs>
         <param name="control">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -41,6 +40,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the options required for a postback script for a specified button control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.PostBackOptions" /> object containing the options required to generate a postback script for <paramref name="buttonControl" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/IRepeatInfoUser.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/IRepeatInfoUser.xml
index 21d831df506..4e99d0992e2 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/IRepeatInfoUser.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/IRepeatInfoUser.xml
@@ -32,7 +32,6 @@
         <Parameter Name="repeatIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Style'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A list control that inherits from the <see cref="T:System.Web.UI.WebControls.IRepeatInfoUser" /> interface must implement the <see cref="M:System.Web.UI.WebControls.IRepeatInfoUser.GetItemStyle(System.Web.UI.WebControls.ListItemType,System.Int32)" /> method to retrieve the style of the specified item type at the specified index in the list control.</para>
@@ -41,6 +40,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the style of the specified item type at the specified index in the list control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.Style" /> that represents the style of the specified item type at the specified index in the list control.</para>
+        </returns>
         <param name="itemType">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Web.UI.WebControls.ListItemType" /> enumeration values. </param>
         <param name="repeatIndex">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ImageButton.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ImageButton.xml
index b156dfd1c67..f9cd6a23d69 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ImageButton.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ImageButton.xml
@@ -448,7 +448,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.ImageButton.GetPostBackOptions" /> method creates a <see cref="T:System.Web.UI.PostBackOptions" /> object that represents the <see cref="T:System.Web.UI.WebControls.ImageButton" /> control's postback behavior. The <see cref="T:System.Web.UI.PostBackOptions" /> object is then typically passed to the <see cref="M:System.Web.UI.ClientScriptManager.GetPostBackEventReference(System.Web.UI.PostBackOptions)" /> method, which is used to obtain a reference to a client-side script function that, when invoked, causes the server to postback to the page.</para>
@@ -458,6 +457,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Web.UI.PostBackOptions" /> object that represents the <see cref="T:System.Web.UI.WebControls.ImageButton" /> control's postback behavior.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.PostBackOptions" /> that represents the <see cref="T:System.Web.UI.WebControls.ImageButton" /> control's postback behavior.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="LoadPostData">
@@ -474,7 +477,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.ImageButton.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> member is used primarily by control developers when deriving a custom class from the <see cref="T:System.Web.UI.WebControls.ImageButton" /> control.</para>
@@ -484,6 +486,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes posted data for the <see cref="T:System.Web.UI.WebControls.ImageButton" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns false for all cases.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key value used to index an entry in the collection. </param>
         <param name="postCollection">
@@ -715,7 +721,6 @@ End Sub</code>
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.IPostBackDataHandler.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.WebControls.ImageButton" /> instance is cast to an <see cref="T:System.Web.UI.IPostBackDataHandler" /> interface.</para>
@@ -724,6 +729,10 @@ End Sub</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Web.UI.IPostBackDataHandler.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the server control's state changes as a result of the postback; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key identifier for the control, used to index the <paramref name="postCollection" />.</param>
         <param name="postCollection">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ImageField.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ImageField.xml
index fd09fc7c4b4..97dcd4c0d0c 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ImageField.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ImageField.xml
@@ -206,7 +206,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -216,6 +215,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new instance of the <see cref="T:System.Web.UI.WebControls.ImageField" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the <see cref="T:System.Web.UI.WebControls.ImageField" /> class.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -562,7 +565,6 @@
       </Parameters>
       <Docs>
         <param name="value">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -572,6 +574,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Applies the format specified by the <see cref="P:System.Web.UI.WebControls.ImageField.DataImageUrlFormatString" /> property to a field value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The transformed value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -585,7 +591,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -595,6 +600,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the value used for a field's value when rendering the <see cref="T:System.Web.UI.WebControls.ImageField" /> object in a designer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value to display in the designer as the field's value.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -610,7 +619,6 @@
         <Parameter Name="controlContainer" Type="System.Web.UI.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -620,6 +628,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Applies the format specified by the <see cref="P:System.Web.UI.WebControls.ImageField.DataAlternateTextFormatString" /> property to the alternate text value contained in the specified <see cref="T:System.Web.UI.Control" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The transformed value.</para>
+        </returns>
         <param name="controlContainer">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Control" /> that contains the alternate text value to transform.</param>
       </Docs>
@@ -663,7 +675,6 @@
       </Parameters>
       <Docs>
         <param name="sortingEnabled">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -674,6 +685,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes the <see cref="T:System.Web.UI.WebControls.ImageField" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always returns true.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The data control that contains the <see cref="T:System.Web.UI.WebControls.ImageField" />. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ImageMap.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ImageMap.xml
index a343823c82f..07a6147a938 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ImageMap.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ImageMap.xml
@@ -472,7 +472,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -484,6 +483,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves any changes to an <see cref="T:System.Web.UI.WebControls.ImageMap" /> control's view-state that have occurred since the time the page was posted back to the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the <see cref="T:System.Web.UI.WebControls.ImageMap" /> control's current view state. If there is no view state associated with the control, this method returns null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/LabelControlBuilder.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/LabelControlBuilder.xml
index a0aed559bc1..849e2a5061c 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/LabelControlBuilder.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/LabelControlBuilder.xml
@@ -49,7 +49,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method overrides the <see cref="M:System.Web.UI.ControlBuilder.AllowWhitespaceLiterals" /> property to ignore white space in the <see cref="T:System.Web.UI.WebControls.Label" /> control.</para>
@@ -58,6 +57,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Specifies whether white space literals are allowed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>false for all cases.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/LinkButton.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/LinkButton.xml
index f590f0ab57c..8ab67bf639e 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/LinkButton.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/LinkButton.xml
@@ -384,7 +384,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.LinkButton.GetPostBackOptions" /> method creates a <see cref="T:System.Web.UI.PostBackOptions" /> object that represents the <see cref="T:System.Web.UI.WebControls.LinkButton" /> control's postback behavior. The <see cref="T:System.Web.UI.PostBackOptions" /> object is then typically passed to the <see cref="M:System.Web.UI.ClientScriptManager.GetPostBackEventReference(System.Web.UI.PostBackOptions)" /> method, which is used to obtain a reference to a client-side script function that, when invoked, causes the server to post back to the page.</para>
@@ -394,6 +393,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Web.UI.PostBackOptions" /> object that represents the <see cref="T:System.Web.UI.WebControls.LinkButton" /> control's postback behavior.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.PostBackOptions" /> that represents the <see cref="T:System.Web.UI.WebControls.LinkButton" /> control's postback behavior.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="LoadViewState">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/LinkButtonControlBuilder.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/LinkButtonControlBuilder.xml
index 46805c6c9c5..cd4071b7072 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/LinkButtonControlBuilder.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/LinkButtonControlBuilder.xml
@@ -49,7 +49,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method overrides <see cref="M:System.Web.UI.ControlBuilder.AllowWhitespaceLiterals" /> to ignore white space in the <see cref="T:System.Web.UI.WebControls.LinkButton" /> control.</para>
@@ -58,6 +57,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Specifies whether white space literals are allowed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>false for all cases.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ListBox.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ListBox.xml
index 90af883ea38..d2ffdb18626 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ListBox.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ListBox.xml
@@ -289,7 +289,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.ListBox.GetSelectedIndices" /> method to identify or access the selected items in the <see cref="T:System.Web.UI.WebControls.ListBox" /> control. Each element in the returned array represents the index for a selected list item. You can use the index values to access the items in the <see cref="P:System.Web.UI.WebControls.ListControl.Items" /> collection.</para>
@@ -298,6 +297,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the array of index values for currently selected items in the <see cref="T:System.Web.UI.WebControls.ListBox" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of integers, each representing the index of a selected item in the list box.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="LoadPostData">
@@ -314,7 +317,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.ListBox.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method is used primarily by control developers, when deriving a custom control from the <see cref="T:System.Web.UI.WebControls.ListBox" /> class.</para>
@@ -325,6 +327,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads the posted content of the list control, if it is different from the last posting.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the posted content is different from the last posting; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key identifier for the control, used to index the <paramref name="postCollection" />.</param>
         <param name="postCollection">
@@ -475,7 +481,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Typically, you should use the <see cref="M:System.Web.UI.WebControls.ListBox.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method to process posted data for changes to a <see cref="T:System.Web.UI.WebControls.ListBox" /> object. </para>
@@ -485,6 +490,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads the posted content of the list control, if it is different from the last posting.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the posted content is different from the last posting; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The index within the posted collection that references the content to load. </param>
         <param name="postCollection">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ListControl.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ListControl.xml
index 081bcda673a..efd7103acc9 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ListControl.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ListControl.xml
@@ -857,7 +857,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.DetailsView.SaveViewState" /> method is a helper method called by the <see cref="T:System.Web.UI.WebControls.ListControl" /> control to save the state of the control.</para>
@@ -869,6 +868,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the current view state of the <see cref="T:System.Web.UI.WebControls.ListControl" /> -derived control and the items it contains.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that contains the saved state of the <see cref="T:System.Web.UI.WebControls.ListControl" /> control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ListItem.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ListItem.xml
index 9124580214d..c6de7bc356a 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ListItem.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ListItem.xml
@@ -529,12 +529,15 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified object has the same value and text as the current list item.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified object is equivalent to the current list item; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current list item.</param>
       </Docs>
@@ -554,7 +557,6 @@
       </Parameters>
       <Docs>
         <param name="text">a <see cref="T:System.String" /></param>
-        <returns>a <see cref="T:System.Web.UI.WebControls.ListItem" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.ListItem.FromString(System.String)" /> static method to create a <see cref="T:System.Web.UI.WebControls.ListItem" /> from the specified text. This method sets the <see cref="P:System.Web.UI.WebControls.ListItem.Text" /> property of the <see cref="T:System.Web.UI.WebControls.ListItem" /> to the text specified by the <paramref name="s" /> parameter.</para>
@@ -563,6 +565,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Web.UI.WebControls.ListItem" /> from the specified text.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.ListItem" /> that represents the text specified by the <paramref name="s" /> parameter.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -632,7 +638,6 @@
       </Parameters>
       <Docs>
         <param name="key">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.WebControls.ListItem" /> instance is cast to an <see cref="T:System.Web.UI.IAttributeAccessor" /> interface.</para>
@@ -641,6 +646,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the attribute value of the list item control having the specified attribute name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified attribute.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IAttributeAccessor.SetAttribute">
@@ -754,7 +763,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.WebControls.ListItem" /> instance is cast to an <see cref="T:System.Web.UI.IStateManager" /> interface.</para>
@@ -763,6 +771,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Web.UI.IStateManager.SaveViewState" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> that contains the view state changes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IStateManager.TrackViewState">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ListItemCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ListItemCollection.xml
index 017272739ee..01e4ed60009 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ListItemCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ListItemCollection.xml
@@ -207,7 +207,6 @@
         <Parameter Name="item" Type="System.Web.UI.WebControls.ListItem" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.ListItemCollection.Contains(System.Web.UI.WebControls.ListItem)" /> method to determine whether the <see cref="T:System.Web.UI.WebControls.ListItem" /> specified by the <paramref name="item" /> parameter is in the collection.</para>
@@ -216,6 +215,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the collection contains the specified item.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the specified item; otherwise, false.</para>
+        </returns>
         <param name="item">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.WebControls.ListItem" /> to search for in the collection. </param>
       </Docs>
@@ -288,7 +291,6 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ListItem'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.ListItemCollection.FindByText(System.String)" /> method to search the collection for a <see cref="T:System.Web.UI.WebControls.ListItem" /> with a <see cref="P:System.Web.UI.WebControls.ListItem.Text" /> property that equals text specified by the <paramref name="text" /> parameter. This method performs a case-sensitive and culture-insensitive comparison. This method does not do partial searches or wildcard searches. If an item is not found in the collection using this criteria, null is returned.</para>
@@ -297,6 +299,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the collection for a <see cref="T:System.Web.UI.WebControls.ListItem" /> with a <see cref="P:System.Web.UI.WebControls.ListItem.Text" /> property that equals the specified text.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.ListItem" /> that contains the text specified by the <paramref name="text" /> parameter.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to search for. </param>
       </Docs>
@@ -315,7 +321,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ListItem'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.ListItemCollection.FindByValue(System.String)" /> method to search the collection for a <see cref="T:System.Web.UI.WebControls.ListItem" /> with a <see cref="P:System.Web.UI.WebControls.ListItem.Value" /> property that contains value specified by the <paramref name="value" /> parameter. This method performs a case-sensitive and culture-insensitive comparison. This method does not do partial searches or wildcard searches. If an item is not found in the collection using this criteria, null is returned.</para>
@@ -324,6 +329,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the collection for a <see cref="T:System.Web.UI.WebControls.ListItem" /> with a <see cref="P:System.Web.UI.WebControls.ListItem.Value" /> property that contains the specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.ListItem" /> that contains the value specified by the <paramref name="value" /> parameter.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to search for. </param>
       </Docs>
@@ -340,7 +349,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Collections.IEnumerator" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create a <see cref="T:System.Collections.IEnumerator" /> that can be iterated through to get each <see cref="T:System.Web.UI.WebControls.ListItem" /> object in the <see cref="T:System.Web.UI.WebControls.ListItemCollection" />.</para>
@@ -355,6 +363,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Collections.IEnumerator" /> implemented object that contains all <see cref="T:System.Web.UI.WebControls.ListItem" /> objects in the <see cref="T:System.Web.UI.WebControls.ListItemCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.IEnumerator" /> implemented object that contains all <see cref="T:System.Web.UI.WebControls.ListItem" /> objects in the <see cref="T:System.Web.UI.WebControls.ListItemCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -371,7 +383,6 @@
         <Parameter Name="item" Type="System.Web.UI.WebControls.ListItem" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.ListItemCollection.IndexOf(System.Web.UI.WebControls.ListItem)" /> method to determine the index value of the <see cref="T:System.Web.UI.WebControls.ListItem" /> specified by the <paramref name="item" /> parameter in the collection. If an item with this criteria is not found in the collection, -1 is returned.</para>
@@ -380,6 +391,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index value that represents the position of the specified <see cref="T:System.Web.UI.WebControls.ListItem" /> in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index position of the specified <see cref="T:System.Web.UI.WebControls.ListItem" /> in the collection.</para>
+        </returns>
         <param name="item">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.WebControls.ListItem" /> to search for in the collection. </param>
       </Docs>
@@ -627,7 +642,6 @@
       </Parameters>
       <Docs>
         <param name="value">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.WebControls.ListItemCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -636,6 +650,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Collections.IList.Add(System.Object)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the item has been added. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Contains">
@@ -653,7 +671,6 @@
       </Parameters>
       <Docs>
         <param name="value">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.WebControls.ListItemCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -662,6 +679,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Collections.IList.Contains(System.Object)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Object" /> is found in the <see cref="T:System.Collections.IList" />; otherwise, false. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.IndexOf">
@@ -679,7 +700,6 @@
       </Parameters>
       <Docs>
         <param name="value">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.WebControls.ListItemCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -688,6 +708,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Collections.IList.IndexOf(System.Object)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of <paramref name="value" /> if found in the list; otherwise, -1. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Insert">
@@ -844,7 +868,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.WebControls.ListItemCollection" /> instance is cast to an <see cref="T:System.Web.UI.IStateManager" /> interface.</para>
@@ -853,6 +876,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns object containing state changes. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the state of the <see cref="T:System.Web.UI.WebControls.ListItemCollection" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IStateManager.TrackViewState">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ListItemControlBuilder.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ListItemControlBuilder.xml
index 0bd7e7f5ddb..3e8433a9e7b 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ListItemControlBuilder.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ListItemControlBuilder.xml
@@ -49,7 +49,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method overrides the inherited implementation of the <see cref="M:System.Web.UI.ControlBuilder.AllowWhitespaceLiterals" /> method to always indicate that white spaces in the text associated with the <see cref="T:System.Web.UI.WebControls.ListItem" /> control are not represented by <see cref="T:System.Web.UI.LiteralControl" /> objects.</para>
@@ -58,6 +57,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether white spaces in the text associated with the <see cref="T:System.Web.UI.WebControls.ListItem" /> are represented by <see cref="T:System.Web.UI.LiteralControl" /> objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>false for all cases.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -72,7 +75,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.ListItemControlBuilder.HtmlDecodeLiterals" /> method is used to determine whether HTML entities in the text associated with the <see cref="T:System.Web.UI.WebControls.ListItem" /> are converted to their equivalent characters when the text is parsed. This method overrides the inherited implementation of the <see cref="M:System.Web.UI.ControlBuilder.HtmlDecodeLiterals" /> method to always return true. This indicates that HTML entities in the text associated with the <see cref="T:System.Web.UI.WebControls.ListItem" /> control are always automatically converted to their equivalent, plain text characters.</para>
@@ -84,6 +86,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether HTML entities in the text associated with the <see cref="T:System.Web.UI.WebControls.ListItem" /> are converted to their equivalent characters when the text is parsed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true for all cases.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/LiteralControlBuilder.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/LiteralControlBuilder.xml
index 52780931ded..ae022485398 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/LiteralControlBuilder.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/LiteralControlBuilder.xml
@@ -49,7 +49,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.LiteralControlBuilder.AllowWhitespaceLiterals" /> method overrides the inherited implementation of the <see cref="M:System.Web.UI.ControlBuilder.AllowWhitespaceLiterals" /> method to always indicate that white spaces in the text that are associated with the <see cref="T:System.Web.UI.WebControls.Literal" /> control are not represented by <see cref="T:System.Web.UI.WebControls.Literal" /> objects.</para>
@@ -58,6 +57,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the control builder should process the white space literals that are represented by the <see cref="T:System.Web.UI.WebControls.Literal" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Login.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Login.xml
index d6c999986eb..ba6d89a2083 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Login.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Login.xml
@@ -2017,7 +2017,6 @@
         <Parameter Name="e" Type="System.EventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2028,6 +2027,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether to pass an event up the page's user interface (UI) server control hierarchy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the event has been canceled; otherwise, false. The default is false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The source of the event. </param>
         <param name="e">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MailDefinition.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MailDefinition.xml
index 7090f9906ad..7a40a82045b 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MailDefinition.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MailDefinition.xml
@@ -126,7 +126,6 @@
         <Parameter Name="owner" Type="System.Web.UI.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -140,6 +139,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an e-mail message from a text file to send by means of SMTP (Simple Mail Transfer Protocol).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The e-mail message from a text file.</para>
+        </returns>
         <param name="recipients">
           <attribution license="cc4" from="Microsoft" modified="false" />A comma-separated list of message recipients.</param>
         <param name="replacements">
@@ -164,7 +167,6 @@
         <Parameter Name="owner" Type="System.Web.UI.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -178,6 +180,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an e-mail message with replacements from a text file to send by means of SMTP (Simple Mail Transfer Protocol).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The e-mail message with replacements from a text file.</para>
+        </returns>
         <param name="recipients">
           <attribution license="cc4" from="Microsoft" modified="false" />The comma-separated list of recipients.</param>
         <param name="replacements">
@@ -400,7 +406,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.WebControls.MailDefinition" /> instance is cast to an <see cref="T:System.Web.UI.IStateManager" /> interface.</para>
@@ -409,6 +414,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves any server control view-state changes that have occurred since the time the page was posted back to the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The server control's current view state.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IStateManager.TrackViewState">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Menu.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Menu.xml
index 5e7ee73e116..fa60d9d015a 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Menu.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Menu.xml
@@ -1635,7 +1635,6 @@
         <Parameter Name="valuePath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1645,6 +1644,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the menu item at the specified value path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.MenuItem" /> that represents the menu item at the specified value path.</para>
+        </returns>
         <param name="valuePath">
           <attribution license="cc4" from="Microsoft" modified="false" />The value path to the menu item to retrieve.</param>
       </Docs>
@@ -1660,7 +1663,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1670,6 +1672,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the design-time state of the <see cref="T:System.Web.UI.WebControls.Menu" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IDictionary" /> containing the design-time state of the <see cref="T:System.Web.UI.WebControls.Menu" /> control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -2007,7 +2013,6 @@
       </Parameters>
       <Docs>
         <param name="args">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2020,6 +2025,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the event for the <see cref="T:System.Web.UI.WebControls.Menu" /> control is passed up the page's user interface (UI) server control hierarchy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the event has been canceled; otherwise, false. The default is false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The source of the event.</param>
       </Docs>
@@ -2409,7 +2418,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is used to save the state of the properties in the <see cref="T:System.Web.UI.WebControls.Menu" /> control that need to be persisted, even when the <see cref="P:System.Web.UI.Control.EnableViewState" /> property is set to false. The <see cref="M:System.Web.UI.WebControls.Menu.SaveControlState" /> method is concerned with state data that is essential for a control's operation (such as an index or keyword) and is separate from the control's view-state data.</para>
@@ -2421,6 +2429,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the state of the properties in the <see cref="T:System.Web.UI.WebControls.Menu" /> control that need to be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that contains the state data for the control. If there have been no changes to the state, this method returns null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SaveViewState">
@@ -2431,13 +2443,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the state of the <see cref="T:System.Web.UI.WebControls.Menu" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that contains the state of the <see cref="T:System.Web.UI.WebControls.Menu" /> control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MenuItem.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MenuItem.xml
index bd661483c33..93330e100e7 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MenuItem.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MenuItem.xml
@@ -1076,7 +1076,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.MenuItem.System#ICloneable#Clone" /> method is used by the <see cref="T:System.Web.UI.WebControls.MenuItem" /> class to make a copy of itself.</para>
@@ -1085,6 +1084,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the current <see cref="T:System.Web.UI.WebControls.MenuItem" /> object. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents a copy of the <see cref="T:System.Web.UI.WebControls.MenuItem" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IStateManager.IsTrackingViewState">
@@ -1141,12 +1144,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the view-state changes to an <see cref="T:System.Object" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> that contains the view-state changes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IStateManager.TrackViewState">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MenuItemBinding.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MenuItemBinding.xml
index 1fcd21c6ac8..e21814abd0e 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MenuItemBinding.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MenuItemBinding.xml
@@ -886,7 +886,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.MenuItemBinding.System#ICloneable#Clone" /> method is a helper function that creates a copy of the <see cref="T:System.Web.UI.WebControls.MenuItemBinding" /> object from which this method is called.</para>
@@ -898,6 +897,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the <see cref="T:System.Web.UI.WebControls.MenuItemBinding" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents a copy of the <see cref="T:System.Web.UI.WebControls.MenuItemBinding" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IDataSourceViewSchemaAccessor.DataSourceViewSchema">
@@ -971,12 +974,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the view state changes to an <see cref="T:System.Object" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that contains the view state changes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IStateManager.TrackViewState">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MenuItemBindingCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MenuItemBindingCollection.xml
index 3019f7a0ab1..1fee7e12b81 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MenuItemBindingCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MenuItemBindingCollection.xml
@@ -48,7 +48,6 @@
         <Parameter Name="binding" Type="System.Web.UI.WebControls.MenuItemBinding" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -65,6 +64,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the specified <see cref="T:System.Web.UI.WebControls.MenuItemBinding" /> object to the end of the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the <see cref="T:System.Web.UI.WebControls.MenuItemBinding" /> was inserted in the collection.</para>
+        </returns>
         <param name="binding">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.MenuItemBinding" /> to append to the end of the collection.</param>
       </Docs>
@@ -82,7 +85,6 @@
         <Parameter Name="binding" Type="System.Web.UI.WebControls.MenuItemBinding" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -92,6 +94,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Web.UI.WebControls.MenuItemBinding" /> object is in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Web.UI.WebControls.MenuItemBinding" /> is contained in the collection; otherwise, false.</para>
+        </returns>
         <param name="binding">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.MenuItemBinding" /> to find.</param>
       </Docs>
@@ -139,7 +145,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -153,6 +158,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Object" /> of the data type that corresponds to the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always returns an empty <see cref="T:System.Web.UI.WebControls.MenuItemBinding" /> object.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the data type to create. This parameter is not used in this implementation of the method; therefore, you should always pass in null.</param>
       </Docs>
@@ -168,7 +177,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -181,6 +189,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an array of <see cref="T:System.Type" /> objects that contains the supported data types of the <see cref="T:System.Web.UI.WebControls.MenuItemBindingCollection" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Type" /> objects that contains the data types supported by the <see cref="T:System.Web.UI.WebControls.MenuItemBindingCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -197,7 +209,6 @@
       </Parameters>
       <Docs>
         <param name="binding">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -214,6 +225,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of the specified <see cref="T:System.Web.UI.WebControls.MenuItemBinding" /> object in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="value" /> within the collection, if found; otherwise, -1.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MenuItemCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MenuItemCollection.xml
index fc45c3dafc6..859cb00c604 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MenuItemCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MenuItemCollection.xml
@@ -194,7 +194,6 @@
       </Parameters>
       <Docs>
         <param name="child">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -204,6 +203,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Web.UI.WebControls.MenuItem" /> object is in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Web.UI.WebControls.MenuItem" /> object is contained in the collection; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -297,7 +300,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -311,6 +313,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that can be used to iterate through the items in the current <see cref="T:System.Web.UI.WebControls.MenuItemCollection" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator that can be used to iterate through the items in the current <see cref="T:System.Web.UI.WebControls.MenuItemCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -327,7 +333,6 @@
       </Parameters>
       <Docs>
         <param name="item">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -340,6 +345,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of the specified <see cref="T:System.Web.UI.WebControls.MenuItem" /> object in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="value" /> within the current <see cref="T:System.Web.UI.WebControls.MenuItemCollection" />, if found; otherwise, -1.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -549,12 +558,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the changes to view state to an <see cref="T:System.Object" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> that contains the view state changes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IStateManager.TrackViewState">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MenuItemStyleCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MenuItemStyleCollection.xml
index a948006e0d2..af8b2554028 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MenuItemStyleCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MenuItemStyleCollection.xml
@@ -33,7 +33,6 @@
         <Parameter Name="style" Type="System.Web.UI.WebControls.MenuItemStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -43,6 +42,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the specified <see cref="T:System.Web.UI.WebControls.MenuItemStyle" /> object to the end of the current collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the added <see cref="T:System.Web.UI.WebControls.MenuItemStyle" />.</para>
+        </returns>
         <param name="style">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.MenuItemStyle" /> to append to the end of the current collection.</param>
       </Docs>
@@ -60,7 +63,6 @@
         <Parameter Name="style" Type="System.Web.UI.WebControls.MenuItemStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -70,6 +72,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Web.UI.WebControls.MenuItemStyle" /> object is in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Web.UI.WebControls.MenuItemStyle" /> is contained in the collection; otherwise, false.</para>
+        </returns>
         <param name="style">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.MenuItemStyle" />  to find.</param>
       </Docs>
@@ -152,7 +158,6 @@
         <Parameter Name="style" Type="System.Web.UI.WebControls.MenuItemStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -165,6 +170,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of the specified <see cref="T:System.Web.UI.WebControls.MenuItemStyle" /> object in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of the specified <see cref="T:System.Web.UI.WebControls.MenuItemStyle" />, if found; otherwise, -1.</para>
+        </returns>
         <param name="style">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.MenuItemStyle" /> to locate.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MenuItemTemplateContainer.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MenuItemTemplateContainer.xml
index bde50fdf3f6..213b9a0a178 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MenuItemTemplateContainer.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MenuItemTemplateContainer.xml
@@ -150,7 +150,6 @@
       </Parameters>
       <Docs>
         <param name="args">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -163,6 +162,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Passes the event raised by a control within the container up the page's user interface (UI) server control hierarchy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true to indicate that this method is passing an event raised by a control within the container up the page's UI server control hierarchy; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The source of the event. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MultiView.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MultiView.xml
index f028cb35fa0..70b05f6511d 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MultiView.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/MultiView.xml
@@ -252,7 +252,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -262,6 +261,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Web.UI.ControlCollection" /> to hold the child controls of the <see cref="T:System.Web.UI.WebControls.MultiView" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.ViewCollection" /> to contain the <see cref="T:System.Web.UI.WebControls.View" /> controls of the current <see cref="T:System.Web.UI.WebControls.MultiView" /> control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -303,7 +306,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -314,6 +316,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the current active <see cref="T:System.Web.UI.WebControls.View" /> control within a <see cref="T:System.Web.UI.WebControls.MultiView" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.View" /> control that represents the active view within a <see cref="T:System.Web.UI.WebControls.MultiView" /> control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -402,7 +408,6 @@
         <Parameter Name="e" Type="System.EventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -412,6 +417,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the event for the <see cref="T:System.Web.UI.WebControls.MultiView" /> control is passed to the page's UI server control hierarchy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the event has been canceled; otherwise, false. The default is false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The source of the event. </param>
         <param name="e">
@@ -531,12 +540,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the current state of the <see cref="T:System.Web.UI.WebControls.MultiView" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the state of the <see cref="T:System.Web.UI.WebControls.MultiView" /> control. If there is no state associated with the <see cref="T:System.Web.UI.WebControls.MultiView" /> control, this method returns null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SetActiveView">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ObjectDataSource.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ObjectDataSource.xml
index a8bcb58bf22..9014cb3d521 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ObjectDataSource.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ObjectDataSource.xml
@@ -944,7 +944,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -960,6 +959,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a delete operation by calling the method that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteMethod" /> property with any parameters that are in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.DeleteParameters" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that represents the number of rows deleted from the underlying data storage, if the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceStatusEventArgs.AffectedRows" /> property of the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceStatusEventArgs" /> is set in the <see cref="E:System.Web.UI.WebControls.ObjectDataSource.Deleted" /> event; otherwise, -1.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1269,7 +1272,6 @@
         <Parameter Name="viewName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1280,6 +1282,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the named data source view that is associated with the data source control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> named DefaultView that is associated with the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" />.</para>
+        </returns>
         <param name="viewName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the view to retrieve. Because the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> supports only one view, <paramref name="viewName" /> is ignored. </param>
       </Docs>
@@ -1295,7 +1301,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1306,6 +1311,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection of names representing the list of view objects that are associated with the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.ICollection" /> that contains the names of the views associated with the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1319,7 +1328,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1335,6 +1343,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs an insert operation by calling the method that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.InsertMethod" /> property and any parameters in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.InsertParameters" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that represents the number of rows inserted into the underlying data storage.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1674,13 +1686,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the state of the <see cref="T:System.Web.UI.WebControls.ObjectDataSource" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the server control's current view state; otherwise, returns null, if there is no view state associated with the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1694,7 +1709,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1776,6 +1790,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves data from the underlying data storage by calling the method that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectMethod" /> property with the parameters in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.SelectParameters" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerable" /> list of data rows.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -2157,7 +2175,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2177,6 +2194,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs an update operation by calling the method that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateMethod" /> property and any parameters that are in the <see cref="P:System.Web.UI.WebControls.ObjectDataSource.UpdateParameters" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that represents the number of rows updated in the underlying data storage.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ObjectDataSourceView.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ObjectDataSourceView.xml
index 57c7e719b74..a3649ba5cb3 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ObjectDataSourceView.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ObjectDataSourceView.xml
@@ -366,7 +366,6 @@
         <Parameter Name="oldValues" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -377,6 +376,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a delete operation by calling the business object method that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.DeleteMethod" /> property using the specified <paramref name="keys" /> and <paramref name="oldValues" /> collections.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows deleted; otherwise, -1, if the number is not known.</para>
+        </returns>
         <param name="keys">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Collections.IDictionary" /> of the key values used to identify the item to delete. These parameters are used with the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.DeleteMethod" /> property to perform the delete operation. If there are no parameters associated with the method, pass null.</param>
         <param name="oldValues">
@@ -514,7 +517,6 @@
         <Parameter Name="oldValues" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -526,6 +528,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a delete operation using the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.DeleteMethod" /> method and the specified <paramref name="keys" /> and <paramref name="oldValues" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows deleted; otherwise, -1, if the number is not known. For more information, see <see cref="Overload:System.Web.UI.WebControls.ObjectDataSourceView.Delete" />.</para>
+        </returns>
         <param name="keys">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Collections.IDictionary" /> of parameters used with the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.DeleteMethod" /> property to perform the delete operation. If there are no parameters associated with the method, pass null.</param>
         <param name="oldValues">
@@ -545,7 +551,6 @@
         <Parameter Name="values" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -558,6 +563,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs an insert operation by calling the business object method that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.InsertMethod" /> property using the specified <paramref name="values" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows inserted; otherwise, -1, if the number is not known. For more information, see <see cref="Overload:System.Web.UI.WebControls.ObjectDataSourceView.Insert" />.</para>
+        </returns>
         <param name="values">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Collections.IDictionary" /> of parameters used with the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.InsertMethod" /> property to perform the insert operation. If there are no parameters associated with the method, pass null.</param>
       </Docs>
@@ -578,7 +587,6 @@
         <Parameter Name="arguments" Type="System.Web.UI.DataSourceSelectArguments" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> class implements the inherited <see cref="M:System.Web.UI.WebControls.ObjectDataSourceView.ExecuteSelect(System.Web.UI.DataSourceSelectArguments)" /> method to retrieve data using a business object. Page developers and data-bound control authors do not call the <see cref="M:System.Web.UI.WebControls.ObjectDataSourceView.ExecuteSelect(System.Web.UI.DataSourceSelectArguments)" /> method directly; instead, use the publicly exposed <see cref="Overload:System.Web.UI.WebControls.ObjectDataSourceView.Select" /> method.</para>
@@ -645,6 +653,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves data from the object that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.TypeName" /> property by calling the method that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.SelectMethod" /> property and passing any values in the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.SelectParameters" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.IEnumerable" /> list of data rows.</para>
+        </returns>
         <param name="arguments">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.DataSourceSelectArguments" /> used to request operations on the data beyond basic data retrieval.</param>
       </Docs>
@@ -661,7 +673,6 @@
         <Parameter Name="oldValues" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -674,6 +685,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs an update operation by calling the method that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.UpdateMethod" /> property and using any parameters that are supplied in the <paramref name="keys" />, <paramref name="values" />, or <paramref name="oldValues" /> collections.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows updated; or -1, if the number is not known. For more information, see <see cref="M:System.Web.UI.WebControls.ObjectDataSource.Update" />.</para>
+        </returns>
         <param name="keys">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Collections.IDictionary" /> of primary keys to use with the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.UpdateMethod" /> property to perform the update database operation. If there are no keys associated with the method, pass null.</param>
         <param name="values">
@@ -771,7 +786,6 @@
         <Parameter Name="values" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -782,6 +796,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs an insert operation by calling the business object method that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.InsertMethod" /> property using the specified <paramref name="values" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows inserted; otherwise, -1, if the number is not known.</para>
+        </returns>
         <param name="values">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Collections.IDictionary" /> collection of parameters used with the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.InsertMethod" /> property to perform the insert operation. If there are no parameters associated with the method, pass null.</param>
       </Docs>
@@ -1384,7 +1402,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1396,6 +1413,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the changes to the view state for the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> object since the time when the page was posted back to the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object that contains the changes to the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> view state; otherwise null, if there is no view state associated with the object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1411,7 +1432,6 @@
         <Parameter Name="arguments" Type="System.Web.UI.DataSourceSelectArguments" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1421,6 +1441,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves data from the object that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.TypeName" /> property by calling the method that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.SelectMethod" /> property and passing any values in the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.SelectParameters" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerable" /> list of data rows. For more information, see <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.SelectMethod" />.</para>
+        </returns>
         <param name="arguments">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.DataSourceSelectArguments" /> used to request operations on the data beyond basic data retrieval.</param>
       </Docs>
@@ -1697,7 +1721,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> instance is cast to an <see cref="T:System.Web.UI.IStateManager" /> interface.</para>
@@ -1706,6 +1729,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Web.UI.IStateManager.SaveViewState" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object that contains the changes to the <see cref="T:System.Web.UI.WebControls.ObjectDataSourceView" /> view state; otherwise, null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IStateManager.TrackViewState">
@@ -1785,7 +1812,6 @@
         <Parameter Name="oldValues" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1796,6 +1822,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs an update operation by calling the method that is identified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.UpdateMethod" /> property and using any parameters that are supplied in the <paramref name="keys" />, <paramref name="values" />, or <paramref name="oldValues" /> collections.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of rows updated; otherwise, -1, if the number is not known.</para>
+        </returns>
         <param name="keys">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Collections.IDictionary" /> of the key values used to identify the item to update. These parameters are used with the method specified by the <see cref="P:System.Web.UI.WebControls.ObjectDataSourceView.UpdateMethod" /> property to perform the update operation. If there are no parameters associated with the method, pass null.</param>
         <param name="values">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/PagedDataSource.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/PagedDataSource.xml
index 51862981ba8..4e1494610f1 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/PagedDataSource.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/PagedDataSource.xml
@@ -370,7 +370,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Collections.IEnumerator" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create a <see cref="T:System.Collections.IEnumerator" /> that can be iterated through to get each item in the data source. To access the item at the current position in the enumerator, use the <see cref="P:System.Collections.IEnumerator.Current" /> property. Use the <see cref="M:System.Collections.IEnumerator.MoveNext" /> method to move to the next item in the collection. To move the enumerator to its initial position, use the <see cref="M:System.Collections.IEnumerator.Reset" /> method.</para>
@@ -382,6 +381,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Collections.IEnumerator" /> implemented object that contains all items in the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.IEnumerator" /> implemented object that contains all items in the data source.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -399,7 +402,6 @@
       </Parameters>
       <Docs>
         <param name="list_accessors">a <see cref="T:System.ComponentModel.PropertyDescriptor[]" /></param>
-        <returns>a <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.PagedDataSource.GetItemProperties(System.ComponentModel.PropertyDescriptor[])" /> method to create a <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that represents the properties on each item used to bind data. If the <see cref="P:System.Web.UI.WebControls.PagedDataSource.DataSource" /> property is null or is not a <see cref="T:System.ComponentModel.ITypedList" /> implemented object, null is returned. For more information on the <see cref="M:System.Web.UI.WebControls.PagedDataSource.GetItemProperties(System.ComponentModel.PropertyDescriptor[])" /> method, see <see cref="M:System.ComponentModel.ITypedList.GetItemProperties(System.ComponentModel.PropertyDescriptor[])" />.</para>
@@ -408,6 +410,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that represents the properties on each item used to bind data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that represents the properties on each item used to bind data.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -425,7 +431,6 @@
       </Parameters>
       <Docs>
         <param name="list_accessors">a <see cref="T:System.ComponentModel.PropertyDescriptor[]" /></param>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is inherited from <see cref="T:System.ComponentModel.ITypedList" /> and is not applicable to this class. It has been implemented to return <see cref="F:System.String.Empty" /> for all cases.</para>
@@ -434,6 +439,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the list. This method does not apply to this class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="F:System.String.Empty" /> for all cases.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/PagerSettings.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/PagerSettings.xml
index 69f49a7f90f..1eeb274c6b0 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/PagerSettings.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/PagerSettings.xml
@@ -879,7 +879,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.PagerSettings.System#Web#UI#IStateManager#SaveViewState" /> method is a helper method that is used by the <see cref="T:System.Web.UI.WebControls.PagerSettings" /> class to save the state of the object.</para>
@@ -891,6 +890,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the current view state of the <see cref="T:System.Web.UI.WebControls.PagerSettings" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that contains the saved state of the <see cref="T:System.Web.UI.WebControls.PagerSettings" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IStateManager.TrackViewState">
@@ -925,7 +928,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -935,6 +937,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the string representation of a <see cref="T:System.Web.UI.WebControls.PagerSettings" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An empty string ("").</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Panel.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Panel.xml
index bc6b9f97833..8aa623d9d45 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Panel.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Panel.xml
@@ -204,7 +204,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.Panel.CreateControlStyle" /> method is used primarily by control developers.</para>
@@ -213,6 +212,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a style object that is used internally by the <see cref="T:System.Web.UI.WebControls.Panel" /> control to implement all style related properties.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.PanelStyle" /> that contains the style properties of the control.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DefaultButton">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Parameter.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Parameter.xml
index 728965704d9..4a9e47e805f 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Parameter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Parameter.xml
@@ -238,7 +238,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -249,6 +248,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a duplicate of the current <see cref="T:System.Web.UI.WebControls.Parameter" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.Parameter" /> that is an exact duplicate of the current one.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -349,7 +352,6 @@
         <Parameter Name="control" Type="System.Web.UI.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -359,6 +361,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Updates and returns the value of the <see cref="T:System.Web.UI.WebControls.Parameter" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the updated and current value of the parameter.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The current <see cref="T:System.Web.HttpContext" /> of the request.</param>
         <param name="control">
@@ -476,7 +482,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -488,6 +493,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the changes to the <see cref="T:System.Web.UI.WebControls.Parameter" /> object's view state since the time the page was posted back to the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> that contains the changes to the <see cref="T:System.Web.UI.WebControls.Parameter" /> view state. If there is no view state associated with the object, this method returns null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -552,7 +561,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.Parameter.Clone" /> method calls the <see cref="M:System.Web.UI.WebControls.Parameter.#ctor(System.Web.UI.WebControls.Parameter)" /> constructor to initialize a new instance of the <see cref="T:System.Web.UI.WebControls.Parameter" /> class with the values of the current instance.</para>
@@ -562,6 +570,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a duplicate of the current <see cref="T:System.Web.UI.WebControls.Parameter" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.Parameter" /> that is a copy of the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IStateManager.IsTrackingViewState">
@@ -619,7 +631,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is used primarily by control developers.</para>
@@ -630,6 +641,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the changes to the <see cref="T:System.Web.UI.WebControls.Parameter" /> object's view state since the time the page was posted back to the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> that contains the changes to the <see cref="T:System.Web.UI.WebControls.Parameter" /> object's view state. If there is no view state associated with the object, this method returns null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IStateManager.TrackViewState">
@@ -658,7 +673,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -668,6 +682,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the value of this instance.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ParameterCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ParameterCollection.xml
index acd140573d3..8a7fec8c77c 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ParameterCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ParameterCollection.xml
@@ -144,7 +144,6 @@
       </Parameters>
       <Docs>
         <param name="param">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -154,6 +153,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the specified <see cref="T:System.Web.UI.WebControls.Parameter" /> object to the end of the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index value of the added item.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -170,7 +173,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -180,6 +182,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Web.UI.WebControls.Parameter" /> object with the specified name and default value, and appends it to the end of the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index value of the added item.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the parameter. </param>
         <param name="value">
@@ -201,7 +207,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -211,6 +216,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Web.UI.WebControls.Parameter" /> object with the specified name, <see cref="T:System.TypeCode" />, and default value, and appends it to the end of the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index value of the added item.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the parameter. </param>
         <param name="type">
@@ -233,7 +242,6 @@
       </Parameters>
       <Docs>
         <param name="param">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -243,6 +251,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Web.UI.WebControls.ParameterCollection" /> collection contains a specific value</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object is found in the <see cref="T:System.Web.UI.WebControls.ParameterCollection" />; otherwise, false. If null is passed for the <paramref name="value" /> parameter, false is returned.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -284,7 +296,6 @@
       </Parameters>
       <Docs>
         <param name="idx">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -370,6 +381,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of a default <see cref="T:System.Web.UI.WebControls.Parameter" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A default instance of a <see cref="T:System.Web.UI.WebControls.Parameter" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -383,13 +398,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of <see cref="T:System.Web.UI.WebControls.Parameter" /> types that the <see cref="T:System.Web.UI.WebControls.ParameterCollection" /> collection can contain.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An ordered array of <see cref="T:System.Type" /> objects that identify the types of <see cref="T:System.Web.UI.WebControls.Parameter" /> objects that the collection can contain.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -406,7 +424,6 @@
         <Parameter Name="control" Type="System.Web.UI.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -417,6 +434,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an ordered collection of <see cref="T:System.Web.UI.WebControls.Parameter" /> object names and their corresponding values currently contained by the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Specialized.IOrderedDictionary" /> of name/value pairs.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The current <see cref="T:System.Web.HttpRequest" /> that the <see cref="T:System.Web.UI.WebControls.Parameter" /> binds to.</param>
         <param name="control">
@@ -437,7 +458,6 @@
       </Parameters>
       <Docs>
         <param name="param">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -447,6 +467,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of a specified <see cref="T:System.Web.UI.WebControls.Parameter" /> object in the <see cref="T:System.Web.UI.WebControls.ParameterCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of <paramref name="parameter" />, if it is found in the collection; otherwise, -1.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/PlaceHolderControlBuilder.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/PlaceHolderControlBuilder.xml
index eb001ccb68d..43fb405dacc 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/PlaceHolderControlBuilder.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/PlaceHolderControlBuilder.xml
@@ -46,7 +46,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method overrides the <see cref="M:System.Web.UI.ControlBuilder.AllowWhitespaceLiterals" /> method to ignore white spaces in the <see cref="T:System.Web.UI.WebControls.Label" /> control.</para>
@@ -55,6 +54,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Specifies whether white-space literals are allowed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>false in all cases.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/PolygonHotSpot.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/PolygonHotSpot.xml
index a514f2dff5b..c36fdb14bdb 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/PolygonHotSpot.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/PolygonHotSpot.xml
@@ -77,7 +77,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -88,6 +87,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the coordinates of the vertexes of a <see cref="T:System.Web.UI.WebControls.PolygonHotSpot" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the coordinates of the vertexes of a <see cref="T:System.Web.UI.WebControls.PolygonHotSpot" /> object. The default value is an empty string ("").</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ProfileParameter.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ProfileParameter.xml
index 5722e4cdf4d..a73c039b379 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ProfileParameter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ProfileParameter.xml
@@ -128,7 +128,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.ProfileParameter.Clone" /> method calls the <see cref="M:System.Web.UI.WebControls.ProfileParameter.#ctor(System.Web.UI.WebControls.ProfileParameter)" /> copy constructor to initialize a new instance of the <see cref="T:System.Web.UI.WebControls.ProfileParameter" /> class with the values of the current instance.</para>
@@ -137,6 +136,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a duplicate of the current <see cref="T:System.Web.UI.WebControls.ProfileParameter" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.ProfileParameter" /> object that is an exact duplicate of the current one.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Evaluate">
@@ -153,7 +156,6 @@
         <Parameter Name="control" Type="System.Web.UI.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Web.UI.WebControls.ProfileParameter" /> attempts to bind to the value of the Profile property every time the <see cref="M:System.Web.UI.WebControls.ProfileParameter.Evaluate(System.Web.HttpContext,System.Web.UI.Control)" /> method is called.</para>
@@ -163,6 +165,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Updates and returns the value of the <see cref="T:System.Web.UI.WebControls.ProfileParameter" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the updated and current value of the parameter. If the context or the ASP.NET Profile is null (Nothing in Visual Basic), the <see cref="M:System.Web.UI.WebControls.ProfileParameter.Evaluate(System.Web.HttpContext,System.Web.UI.Control)" /> method returns null.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The current <see cref="T:System.Web.HttpContext" /> of the request.</param>
         <param name="control">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/QueryStringParameter.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/QueryStringParameter.xml
index 1b56e9c4966..cf58ef618e9 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/QueryStringParameter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/QueryStringParameter.xml
@@ -158,7 +158,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -168,6 +167,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a duplicate of the current <see cref="T:System.Web.UI.WebControls.QueryStringParameter" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A duplicate of the current instance.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -185,7 +188,6 @@
       </Parameters>
       <Docs>
         <param name="ctx">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -196,6 +198,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Updates and returns the value of the <see cref="T:System.Web.UI.WebControls.QueryStringParameter" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the current value of the parameter. If the context or the request is null, the <see cref="M:System.Web.UI.WebControls.QueryStringParameter.Evaluate(System.Web.HttpContext,System.Web.UI.Control)" /> method returns null. </para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />A Web server control that is associated with the ASP.NET Web page where the <see cref="T:System.Web.UI.WebControls.QueryStringParameter" /> object is used.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RadioButton.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RadioButton.xml
index 427d2985965..543b51e53ce 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RadioButton.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RadioButton.xml
@@ -188,7 +188,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.RadioButton.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method is called by the <see cref="M:System.Web.UI.IPostBackDataHandler.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method. It is used primarily by control developers extending the functionality of the <see cref="T:System.Web.UI.WebControls.RadioButton" /> control.</para>
@@ -197,6 +196,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes postback data for the <see cref="T:System.Web.UI.WebControls.RadioButton" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the data for the <see cref="T:System.Web.UI.WebControls.RadioButton" /> has changed; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key identifier for the control.</param>
         <param name="postCollection">
@@ -265,7 +268,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.WebControls.RadioButton" /> control is cast to an <see cref="T:System.Web.UI.IPostBackDataHandler" /> interface.</para>
@@ -274,6 +276,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Web.UI.IPostBackDataHandler.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <see cref="T:System.Web.UI.WebControls.RadioButton" /> is checked; otherwise, false. The default is false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />A string.</param>
         <param name="postCollection">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RadioButtonList.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RadioButtonList.xml
index 02e6b689672..ce1d25af729 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RadioButtonList.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RadioButtonList.xml
@@ -254,7 +254,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Web.UI.WebControls.Style" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.RadioButtonList.CreateControlStyle" /> method is used primarily by control developers in custom control that derive from the <see cref="T:System.Web.UI.WebControls.RadioButtonList" /> class.</para>
@@ -263,6 +262,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a style object that is used internally by the <see cref="T:System.Web.UI.WebControls.RadioButtonList" /> control to implement all style-related properties.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.Style" /> that contains the style properties of the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -283,7 +286,6 @@
         <Parameter Name="pathOffset" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.RadioButtonList.FindControl(System.String,System.Int32)" /> method is used primarily by control developers in custom controls that derive from the <see cref="T:System.Web.UI.WebControls.RadioButtonList" /> class.</para>
@@ -293,6 +295,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the current naming container for a server control with the specified ID and path offset. The <see cref="M:System.Web.UI.WebControls.RadioButtonList.FindControl(System.String,System.Int32)" /> method always returns the <see cref="T:System.Web.UI.WebControls.RadioButtonList" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current <see cref="T:System.Web.UI.WebControls.RadioButtonList" />.</para>
+        </returns>
         <param name="id">
           <attribution license="cc4" from="Microsoft" modified="false" />The identifier for the control to find.</param>
         <param name="pathOffset">
@@ -313,7 +319,6 @@
         <Parameter Name="repeatIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.RadioButtonList.GetItemStyle(System.Web.UI.WebControls.ListItemType,System.Int32)" /> method is used primarily by control developers in custom controls that derive from the <see cref="T:System.Web.UI.WebControls.RadioButtonList" /> class.</para>
@@ -323,6 +328,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the style of the specified item type at the specified index in the list control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>null, indicating that style attributes are not set on individual list items in a <see cref="T:System.Web.UI.WebControls.RadioButtonList" /> control.</para>
+        </returns>
         <param name="itemType">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Web.UI.WebControls.ListItemType" /> enumeration values. </param>
         <param name="repeatIndex">
@@ -406,7 +415,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.RadioButtonList.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method is used primarily by control developers in custom controls that derive from the <see cref="T:System.Web.UI.WebControls.RadioButtonList" /> class.</para>
@@ -417,6 +425,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the posted data for the <see cref="T:System.Web.UI.WebControls.RadioButtonList" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the state of the <see cref="T:System.Web.UI.WebControls.RadioButtonList" /> is different from the last posting; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key identifier for the control, used to index the <paramref name="postCollection" />.</param>
         <param name="postCollection">
@@ -709,7 +721,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Typically, you should use the <see cref="M:System.Web.UI.WebControls.RadioButtonList.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method to process posted data for a <see cref="T:System.Web.UI.WebControls.RadioButtonList" /> control. </para>
@@ -719,6 +730,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes posted data for the <see cref="T:System.Web.UI.WebControls.RadioButtonList" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the server control's state changed as a result of the postback; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key identifier for the control, used to index the <paramref name="postCollection" />. </param>
         <param name="postCollection">
@@ -763,7 +778,6 @@
         <Parameter Name="repeatIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Typically, you should use the <see cref="M:System.Web.UI.WebControls.RadioButtonList.GetItemStyle(System.Web.UI.WebControls.ListItemType,System.Int32)" /> method to retrieve the style of an item in a <see cref="T:System.Web.UI.WebControls.RadioButtonList" /> control. </para>
@@ -773,6 +787,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the style of the specified item type at the specified index in the list control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.Style" /> that represents the style of the specified item type at the specified index in the list control.</para>
+        </returns>
         <param name="itemType">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Web.UI.WebControls.ListItemType" /> enumeration values. </param>
         <param name="repeatIndex">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RangeValidator.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RangeValidator.xml
index d3f2fea30d1..27ad26b3b1f 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RangeValidator.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RangeValidator.xml
@@ -150,12 +150,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is a check of properties to determine any errors made by the developer. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the control properties are valid; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -170,12 +173,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the content in the input control is valid.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the control is valid; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RectangleHotSpot.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RectangleHotSpot.xml
index 646397de8ab..78e6ccae9c3 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RectangleHotSpot.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RectangleHotSpot.xml
@@ -76,7 +76,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -87,6 +86,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the x -and y-coordinates of a <see cref="T:System.Web.UI.WebControls.RectangleHotSpot" /> object's top left corner and the x- and y-coordinates of its bottom right corner.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the x- and y-coordinates of a <see cref="T:System.Web.UI.WebControls.RectangleHotSpot" /> object's top left corner and the x- and y-coordinates of its bottom right corner.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RegularExpressionValidator.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RegularExpressionValidator.xml
index 3b7f1ce0b1b..5e5135bd63f 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RegularExpressionValidator.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RegularExpressionValidator.xml
@@ -90,12 +90,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the value in the input control is valid.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value in the input control is valid; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Repeater.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Repeater.xml
index c27e6354891..3e82177770d 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Repeater.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Repeater.xml
@@ -334,7 +334,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The first call to the <see cref="P:System.Web.UI.WebControls.Repeater.SelectArguments" /> property calls the <see cref="M:System.Web.UI.WebControls.Repeater.CreateDataSourceSelectArguments" /> method to return the <see cref="P:System.Web.UI.DataSourceSelectArguments.Empty" /> value. </para>
@@ -343,6 +342,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="P:System.Web.UI.DataSourceSelectArguments.Empty" /> value. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="P:System.Web.UI.DataSourceSelectArguments.Empty" /> value.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateItem">
@@ -356,12 +359,15 @@
         <Parameter Name="itemType" Type="System.Web.UI.WebControls.ListItemType" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'RepeaterItem'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Web.UI.WebControls.RepeaterItem" /> object with the specified item type and location within the <see cref="T:System.Web.UI.WebControls.Repeater" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Web.UI.WebControls.RepeaterItem" /> object.</para>
+        </returns>
         <param name="itemIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The specified location within the <see cref="T:System.Web.UI.WebControls.Repeater" /> control to place the created item. </param>
         <param name="itemType">
@@ -595,7 +601,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The data source is specified either by the <see cref="P:System.Web.UI.WebControls.Repeater.DataSource" /> property or by the <see cref="P:System.Web.UI.WebControls.Repeater.DataSourceID" /> and <see cref="P:System.Web.UI.WebControls.Repeater.SelectArguments" /> properties.</para>
@@ -604,6 +609,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IEnumerable" /> interface from the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object implementing <see cref="T:System.Collections.IEnumerable" /> that represents the data from the data source.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HeaderTemplate">
@@ -862,12 +871,15 @@
         <Parameter Name="e" Type="System.EventArgs" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Raises the <see cref="E:System.Web.UI.WebControls.Repeater.ItemCommand" /> event if the <paramref name="EventArgs" /> parameter is an instance of <see cref="T:System.Web.UI.WebControls.RepeaterCommandEventArgs" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="E:System.Web.UI.WebControls.Repeater.ItemCommand" /> was raised, otherwise false.</para>
+        </returns>
         <param name="sender">
           <attribution license="cc4" from="Microsoft" modified="false" />The source of the event. </param>
         <param name="e">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RepeaterItem.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RepeaterItem.xml
index 778d2b8d671..ccb16e48010 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RepeaterItem.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RepeaterItem.xml
@@ -222,12 +222,15 @@
         <Parameter Name="e" Type="System.EventArgs" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Assigns any sources of the event and its information to the parent <see cref="T:System.Web.UI.WebControls.Repeater" /> control, if the <see cref="T:System.EventArgs" /> parameter is an instance of <see cref="T:System.Web.UI.WebControls.RepeaterCommandEventArgs" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the event assigned to the parent was raised, otherwise false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The source of the event. </param>
         <param name="e">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RepeaterItemCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RepeaterItemCollection.xml
index 51bb14c8d8a..060c0d8b358 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RepeaterItemCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RepeaterItemCollection.xml
@@ -129,7 +129,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Collections.IEnumerator" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create a <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through each item in the <see cref="T:System.Web.UI.WebControls.RepeaterItemCollection" />.</para>
@@ -144,6 +143,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Collections.IEnumerator" /> interface that can iterate through all the <see cref="T:System.Web.UI.WebControls.RepeaterItem" /> objects in the <see cref="T:System.Web.UI.WebControls.RepeaterItemCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.IEnumerator" /> interface that contains all <see cref="T:System.Web.UI.WebControls.RepeaterItem" /> objects in the <see cref="T:System.Web.UI.WebControls.RepeaterItemCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RequiredFieldValidator.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RequiredFieldValidator.xml
index 6c3f736cd41..cdd36544e0c 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RequiredFieldValidator.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RequiredFieldValidator.xml
@@ -89,12 +89,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called during the validation stage when ASP.NET processes a Web Form.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value in the input control is valid; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RoleGroup.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RoleGroup.xml
index d3c9024939e..afb8f85662b 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RoleGroup.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RoleGroup.xml
@@ -52,7 +52,6 @@
         <Parameter Name="user" Type="System.Security.Principal.IPrincipal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -63,6 +62,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified user is a member of any of the roles in the role group.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the user is a member of one of the roles associated with this role group; otherwise, false.</para>
+        </returns>
         <param name="user">
           <attribution license="cc4" from="Microsoft" modified="false" />The user name to look for in the role group. </param>
       </Docs>
@@ -138,7 +141,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -148,6 +150,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a comma-separated list of the roles associated with this role group.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A comma-separated list of the roles associated with this role group.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RoleGroupCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RoleGroupCollection.xml
index 507673d5d24..80c93586c77 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RoleGroupCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/RoleGroupCollection.xml
@@ -80,13 +80,16 @@
         <Parameter Name="group" Type="System.Web.UI.WebControls.RoleGroup" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the collection contains the specified role group.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified role group is a member of the collection; otherwise false.</para>
+        </returns>
         <param name="group">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.RoleGroup" /> to look for in the collection. </param>
       </Docs>
@@ -133,7 +136,6 @@
         <Parameter Name="user" Type="System.Security.Principal.IPrincipal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -145,6 +147,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the first role group that contains the specified user account.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.RoleGroup" /> representing the first role group in the collection that contains the specified user account. If the user is not part of a role group in the collection, it returns null.</para>
+        </returns>
         <param name="user">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Security.Principal.IPrincipal" /> that represents the user account to find the role group collection.</param>
       </Docs>
@@ -162,7 +168,6 @@
         <Parameter Name="group" Type="System.Web.UI.WebControls.RoleGroup" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -172,6 +177,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the collection and returns the zero-based index of the first occurrence of the specified <see cref="T:System.Web.UI.WebControls.RoleGroup" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="group" /> within the entire <see cref="T:System.Web.UI.WebControls.RoleGroupCollection" />, if found; otherwise, -1.</para>
+        </returns>
         <param name="group">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.RoleGroup" /> to locate in the collection. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SelectedDatesCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SelectedDatesCollection.xml
index ea11fe39a84..220f4004c9a 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SelectedDatesCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SelectedDatesCollection.xml
@@ -114,7 +114,6 @@
         <Parameter Name="date" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to determine whether the <see cref="T:System.Web.UI.WebControls.SelectedDatesCollection" /> collection contains the specified <see cref="T:System.DateTime" /> object.</para>
@@ -123,6 +122,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the <see cref="T:System.Web.UI.WebControls.SelectedDatesCollection" /> collection contains the specified <see cref="T:System.DateTime" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.UI.WebControls.SelectedDatesCollection" /> contains the specified <see cref="T:System.DateTime" />; otherwise, false.</para>
+        </returns>
         <param name="date">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to search for in the <see cref="T:System.Web.UI.WebControls.SelectedDatesCollection" />. </param>
       </Docs>
@@ -193,7 +196,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Collections.IEnumerator" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create an <see cref="T:System.Collections.IEnumerator" />-implemented object that can be easily iterated through to get each item in the <see cref="T:System.Web.UI.WebControls.SelectedDatesCollection" /> collection.</para>
@@ -208,6 +210,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IEnumerator" />-implemented object that contains all <see cref="T:System.DateTime" /> objects within the <see cref="T:System.Web.UI.WebControls.SelectedDatesCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" />-implemented object that contains all <see cref="T:System.DateTime" /> objects within the <see cref="T:System.Web.UI.WebControls.SelectedDatesCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SessionParameter.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SessionParameter.xml
index 5b5ae44d0f8..49a9d6ff8ef 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SessionParameter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SessionParameter.xml
@@ -134,7 +134,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -144,6 +143,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a duplicate of the current <see cref="T:System.Web.UI.WebControls.SessionParameter" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.SessionParameter" /> that is an exact duplicate of the current one.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -161,7 +164,6 @@
       </Parameters>
       <Docs>
         <param name="ctx">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -172,6 +174,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Updates and returns the value of the <see cref="T:System.Web.UI.WebControls.SessionParameter" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the updated and current value of the parameter. If the context or the request is null, the <see cref="M:System.Web.UI.WebControls.SessionParameter.Evaluate(System.Web.HttpContext,System.Web.UI.Control)" /> method returns null.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.Control" /> that is associated with the Web Forms page where the <see cref="T:System.Web.UI.WebControls.SessionParameter" /> is used. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SiteMapDataSource.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SiteMapDataSource.xml
index c02f07330f8..e1d9e82daa7 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SiteMapDataSource.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SiteMapDataSource.xml
@@ -216,13 +216,16 @@
         <Parameter Name="viewPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a single view on the site map data for the <see cref="T:System.Web.SiteMapProvider" /> object according to the starting node and other properties of the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.HierarchicalDataSourceView" /> helper object on the site map data, starting with the node that is identified by the <see cref="P:System.Web.UI.WebControls.SiteMapDataSource.StartingNodeUrl" /> or its child, if the <see cref="P:System.Web.UI.WebControls.SiteMapDataSource.ShowStartingNode" /> is false.</para>
+        </returns>
         <param name="viewPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The URL of the starting node, specified by the <see cref="P:System.Web.UI.WebControls.SiteMapDataSource.StartingNodeUrl" />. </param>
       </Docs>
@@ -238,7 +241,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -249,6 +251,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a list of data source controls that can be used as sources of lists of data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IList" /> of data source controls that can be used as sources of lists of data.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -264,7 +270,6 @@
         <Parameter Name="viewName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -274,6 +279,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a named view on the site map data of the site map provider according to the starting node and other properties of the data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.HierarchicalDataSourceView" /> helper object on the site map data, according to the starting node that is identified by the <see cref="P:System.Web.UI.WebControls.SiteMapDataSource.StartingNodeUrl" /> property or its child, if the <see cref="P:System.Web.UI.WebControls.SiteMapDataSource.ShowStartingNode" /> is false.</para>
+        </returns>
         <param name="viewName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the data source view to retrieve.</param>
       </Docs>
@@ -289,7 +298,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -299,6 +307,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection of named views for the data source control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.ICollection" /> of named <see cref="T:System.Web.UI.WebControls.SiteMapDataSourceView" /> objects associated with the <see cref="T:System.Web.UI.WebControls.SiteMapDataSource" />. Because the <see cref="T:System.Web.UI.WebControls.SiteMapDataSource" /> supports only one named view, the <see cref="M:System.Web.UI.WebControls.SiteMapDataSource.GetViewNames" /> method returns an <see cref="T:System.Collections.ICollection" /> with one <see cref="F:System.String.Empty" /> element.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -514,7 +526,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.WebControls.SiteMapDataSource" /> instance is cast to an <see cref="T:System.ComponentModel.IListSource" /> interface.</para>
@@ -523,6 +534,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ComponentModel.IListSource.GetList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IList" /> of data source controls that can be used as sources of lists of data.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IDataSource.GetView">
@@ -538,7 +553,6 @@
         <Parameter Name="viewName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.WebControls.SiteMapDataSource" /> instance is cast to an <see cref="T:System.Web.UI.IDataSource" /> interface.</para>
@@ -547,6 +561,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Web.UI.IDataSource.GetView(System.String)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.HierarchicalDataSourceView" /> helper object on the site map data, according to the starting node identified by the <see cref="P:System.Web.UI.WebControls.SiteMapDataSource.StartingNodeUrl" /> property or its child, if the <see cref="P:System.Web.UI.WebControls.SiteMapDataSource.ShowStartingNode" /> is false.</para>
+        </returns>
         <param name="viewName">
           <attribution license="cc4" from="Microsoft" modified="false" />The URL of the root node of the view. </param>
       </Docs>
@@ -562,7 +580,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.WebControls.SiteMapDataSource" /> instance is cast to an <see cref="T:System.Web.UI.IDataSource" /> interface.</para>
@@ -571,6 +588,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Web.UI.IDataSource.GetViewNames" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.ICollection" /> of named <see cref="T:System.Web.UI.WebControls.SiteMapDataSourceView" /> objects associated with the <see cref="T:System.Web.UI.WebControls.SiteMapDataSource" />. Because the <see cref="T:System.Web.UI.WebControls.SiteMapDataSource" /> supports only one named view, the <see cref="M:System.Web.UI.WebControls.SiteMapDataSource.GetViewNames" /> returns a collection containing one element set to <see cref="F:System.String.Empty" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SiteMapDataSourceView.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SiteMapDataSourceView.xml
index 852463e70a8..6564850ac30 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SiteMapDataSourceView.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SiteMapDataSourceView.xml
@@ -92,7 +92,6 @@
         <Parameter Name="arguments" Type="System.Web.UI.DataSourceSelectArguments" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Web.UI.WebControls.SiteMapDataSourceView" /> class implements the inherited <see cref="M:System.Web.UI.WebControls.SiteMapDataSourceView.ExecuteSelect(System.Web.UI.DataSourceSelectArguments)" /> method to retrieve a set of nodes that represents the site navigation structure for the current ASP.NET application. Page developers and data-bound control authors do not call the <see cref="M:System.Web.UI.WebControls.SiteMapDataSourceView.ExecuteSelect(System.Web.UI.DataSourceSelectArguments)" /> method directly; instead, use the publicly exposed <see cref="Overload:System.Web.UI.WebControls.SiteMapDataSourceView.Select" /> method.</para>
@@ -101,6 +100,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the collection of the <see cref="T:System.Web.SiteMapNode" /> objects that represents the site navigation structure for the current user.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.SiteMapNodeCollection" /> that represents the site navigation structure for the current user.</para>
+        </returns>
         <param name="arguments">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.DataSourceSelectArguments" /> that is used to request operations on the data beyond basic data retrieval.</param>
       </Docs>
@@ -135,7 +138,6 @@
         <Parameter Name="arguments" Type="System.Web.UI.DataSourceSelectArguments" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -145,6 +147,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the collection of the <see cref="T:System.Web.SiteMapNode" /> objects that represents the site navigation structure for the current user.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.SiteMapNodeCollection" /> that represents the site navigation structure for the current user. </para>
+        </returns>
         <param name="arguments">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.DataSourceSelectArguments" /> that is used to request operations on the data beyond basic data retrieval.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SiteMapHierarchicalDataSourceView.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SiteMapHierarchicalDataSourceView.xml
index 2079ce7af2f..a795d6709ca 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SiteMapHierarchicalDataSourceView.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SiteMapHierarchicalDataSourceView.xml
@@ -78,7 +78,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -88,6 +87,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the collection of the <see cref="T:System.Web.SiteMapNode" /> objects that represents the site navigation structure for the current user.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.IHierarchicalEnumerable" /> collection of site map nodes.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SiteMapPath.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SiteMapPath.xml
index 37be253c271..0ab7da19e15 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SiteMapPath.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SiteMapPath.xml
@@ -1076,7 +1076,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1087,6 +1086,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves changes to view state for the <see cref="T:System.Web.UI.WebControls.SiteMapPath" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the server control's current view state. If there is no view state associated with the control, this method returns null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SqlDataSource.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SqlDataSource.xml
index 3a9ef41a712..ae2b286afb4 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SqlDataSource.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SqlDataSource.xml
@@ -949,7 +949,6 @@
         <Parameter Name="viewName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -959,6 +958,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a data source view object that is associated with the data source control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.SqlDataSourceView" /> that is associated with the <see cref="T:System.Web.UI.WebControls.SqlDataSource" />.</para>
+        </returns>
         <param name="viewName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the data source view. </param>
       </Docs>
@@ -1005,7 +1008,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1018,6 +1020,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a delete operation using the <see cref="P:System.Web.UI.WebControls.SqlDataSource.DeleteCommand" /> SQL string and any parameters that are in the <see cref="P:System.Web.UI.WebControls.SqlDataSource.DeleteParameters" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that represents the number of rows deleted from the underlying database.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1306,7 +1312,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1316,6 +1321,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Data.Common.DbProviderFactory" /> object that is associated with the ADO.NET provider that is identified by the <see cref="P:System.Web.UI.WebControls.SqlDataSource.ProviderName" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Data.Common.DbProviderFactory" /> that represents the identified ADO.NET provider; otherwise, and instance of the <see cref="N:System.Data.SqlClient" />, if no provider is set.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1331,7 +1340,6 @@
         <Parameter Name="viewName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1341,6 +1349,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the named data source view that is associated with the data source control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.UI.WebControls.SqlDataSourceView" /> named "Table" that is associated with the <see cref="T:System.Web.UI.WebControls.SqlDataSource" />.</para>
+        </returns>
         <param name="viewName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the view to retrieve. Because the <see cref="T:System.Web.UI.WebControls.SqlDataSource" /> supports only one view, <paramref name="viewName" /> is ignored. </param>
       </Docs>
@@ -1356,7 +1368,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1366,6 +1377,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of names representing the list of view objects that are associated with the <see cref="T:System.Web.UI.WebControls.SqlDataSource" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.ICollection" /> that contains the names of the views associated with the <see cref="T:System.Web.UI.WebControls.SqlDataSource" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1379,7 +1394,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1395,6 +1409,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs an insert operation using the <see cref="P:System.Web.UI.WebControls.SqlDataSource.InsertCommand" /> SQL string and any parameters that are in the <see cref="P:System.Web.UI.WebControls.SqlDataSource.InsertParameters" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that represents the number of rows inserted into the underlying database.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1690,13 +1708,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the current view state of the <see cref="T:System.Web.UI.WebControls.SqlDataSource" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that contains the saved state of the <see cref="T:System.Web.UI.WebControls.SqlDataSource" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1713,7 +1734,6 @@
       </Parameters>
       <Docs>
         <param name="args">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1735,6 +1755,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves data from the underlying database by using the <see cref="P:System.Web.UI.WebControls.SqlDataSource.SelectCommand" /> SQL string and any parameters that are in the <see cref="P:System.Web.UI.WebControls.SqlDataSource.SelectParameters" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerable" /> list of data rows.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1977,7 +2001,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1993,6 +2016,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs an update operation using the <see cref="P:System.Web.UI.WebControls.SqlDataSource.UpdateCommand" /> SQL string and any parameters that are in the <see cref="P:System.Web.UI.WebControls.SqlDataSource.UpdateParameters" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that represents the number of rows updated in the underlying database.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SqlDataSourceView.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SqlDataSourceView.xml
index 90067ebbb62..0465705e1f5 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SqlDataSourceView.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SqlDataSourceView.xml
@@ -309,7 +309,6 @@
         <Parameter Name="oldValues" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -319,6 +318,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a delete operation using the <see cref="P:System.Web.UI.WebControls.SqlDataSourceView.DeleteCommand" /> SQL string, any parameters that are specified in the <see cref="P:System.Web.UI.WebControls.SqlDataSourceView.DeleteParameters" /> collection, and the values that are in the specified <paramref name="keys" /> and <paramref name="oldValues" /> collections.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that represents the number of rows deleted from the underlying database.</para>
+        </returns>
         <param name="keys">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.IDictionary" /> of object or row key values for the <see cref="M:System.Web.UI.WebControls.SqlDataSourceView.ExecuteDelete(System.Collections.IDictionary,System.Collections.IDictionary)" /> operation to delete.</param>
         <param name="oldValues">
@@ -466,7 +469,6 @@
         <Parameter Name="oldValues" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -479,6 +481,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a delete operation using the <see cref="P:System.Web.UI.WebControls.SqlDataSourceView.DeleteCommand" /> SQL string, any parameters that are specified in the <see cref="P:System.Web.UI.WebControls.SqlDataSourceView.DeleteParameters" /> collection, and the values that are in the specified <paramref name="keys" /> and <paramref name="oldValues" /> collections.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that represents the number of rows deleted from the underlying database.</para>
+        </returns>
         <param name="keys">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.IDictionary" /> of object or row key values for the <see cref="M:System.Web.UI.WebControls.SqlDataSourceView.ExecuteDelete(System.Collections.IDictionary,System.Collections.IDictionary)" /> operation to delete.</param>
         <param name="oldValues">
@@ -498,7 +504,6 @@
         <Parameter Name="values" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -510,6 +515,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs an insert operation using the <see cref="P:System.Web.UI.WebControls.SqlDataSourceView.InsertCommand" /> SQL string, any parameters that are specified in the <see cref="P:System.Web.UI.WebControls.SqlDataSourceView.InsertParameters" /> collection, and the values that are in the specified <paramref name="values" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that represents the number of rows inserted into the underlying database.</para>
+        </returns>
         <param name="values">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.IDictionary" /> of values used with the <see cref="P:System.Web.UI.WebControls.SqlDataSourceView.InsertCommand" /> property to perform the insert database operation. If there are no parameters associated with the query or if the <see cref="P:System.Web.UI.WebControls.SqlDataSourceView.InsertCommand" /> property is not a parameterized SQL query, pass null.</param>
       </Docs>
@@ -530,7 +539,6 @@
         <Parameter Name="arguments" Type="System.Web.UI.DataSourceSelectArguments" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Web.UI.WebControls.SqlDataSourceView" /> class implements the inherited <see cref="M:System.Web.UI.WebControls.SqlDataSourceView.ExecuteSelect(System.Web.UI.DataSourceSelectArguments)" /> method to retrieve data from a database. Page developers and data-bound control authors do not call the <see cref="M:System.Web.UI.WebControls.SqlDataSourceView.ExecuteSelect(System.Web.UI.DataSourceSelectArguments)" /> method directly; instead, use the publicly exposed <see cref="M:System.Web.UI.WebControls.SqlDataSource.Select(System.Web.UI.DataSourceSelectArguments)" /> method.</para>
@@ -547,6 +555,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves data from the underlying database using the <see cref="P:System.Web.UI.WebControls.SqlDataSourceView.SelectCommand" /> SQL string and any parameters that are in the <see cref="P:System.Web.UI.WebControls.SqlDataSourceView.SelectParameters" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerable" /> list of data rows.</para>
+        </returns>
         <param name="arguments">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.DataSourceSelectArguments" /> object used to request operations on the data beyond basic data retrieval.</param>
       </Docs>
@@ -563,7 +575,6 @@
         <Parameter Name="oldValues" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -576,6 +587,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs an update operation using the <see cref="P:System.Web.UI.WebControls.SqlDataSourceView.UpdateCommand" /> SQL string, any parameters that are in the <see cref="P:System.Web.UI.WebControls.SqlDataSourceView.UpdateParameters" /> collection, and the values that are in the specified <paramref name="keys" />, <paramref name="values" />, and <paramref name="oldValues" /> collections.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that represents the number of rows updated in the underlying database.</para>
+        </returns>
         <param name="keys">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.IDictionary" /> of primary keys to use with the <see cref="P:System.Web.UI.WebControls.SqlDataSourceView.UpdateCommand" /> property to perform the update database operation. If there are no keys associated with the query or if the <see cref="P:System.Web.UI.WebControls.SqlDataSourceView.UpdateCommand" /> property is not a parameterized SQL query, pass null.</param>
         <param name="values">
@@ -686,7 +701,6 @@
         <Parameter Name="values" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -696,6 +710,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs an insert operation using the <see cref="P:System.Web.UI.WebControls.SqlDataSourceView.InsertCommand" /> SQL string, any parameters that are specified in the <see cref="P:System.Web.UI.WebControls.SqlDataSourceView.InsertParameters" /> collection, and the values that are in the specified <paramref name="values" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that represents the number of rows inserted into the underlying database.</para>
+        </returns>
         <param name="values">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.IDictionary" /> of parameters for the <see cref="P:System.Web.UI.WebControls.SqlDataSourceView.InsertCommand" /> property to use to perform the insert database operation. If there are no parameters associated with the query or if the <see cref="P:System.Web.UI.WebControls.SqlDataSourceView.InsertCommand" /> is not a parameterized SQL query, pass null. </param>
       </Docs>
@@ -1177,7 +1195,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1189,6 +1206,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the changes to the view state for the  <see cref="T:System.Web.UI.WebControls.SqlDataSourceView" /> control since the time that the page was posted back to the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object that contains the changes to the <see cref="T:System.Web.UI.WebControls.SqlDataSourceView" /> view state; otherwise, null, if there is no view state associated with the object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1204,7 +1225,6 @@
         <Parameter Name="arguments" Type="System.Web.UI.DataSourceSelectArguments" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1215,6 +1235,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves data from the underlying database using the <see cref="P:System.Web.UI.WebControls.SqlDataSourceView.SelectCommand" /> SQL string and any parameters that are in the <see cref="P:System.Web.UI.WebControls.SqlDataSourceView.SelectParameters" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerable" /> list of data rows.</para>
+        </returns>
         <param name="arguments">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.DataSourceSelectArguments" /> used to request operations on the data beyond basic data retrieval.</param>
       </Docs>
@@ -1419,7 +1443,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.WebControls.SqlDataSourceView" /> instance is cast to the <see cref="T:System.Web.UI.IStateManager" /> interface.</para>
@@ -1428,6 +1451,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Web.UI.IStateManager.SaveViewState" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object that contains the changes to the <see cref="T:System.Web.UI.WebControls.SqlDataSourceView" /> view state; otherwise, null, if there is no view state associated with the object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IStateManager.TrackViewState">
@@ -1482,7 +1509,6 @@
         <Parameter Name="oldValues" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1492,6 +1518,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs an update operation using the <see cref="P:System.Web.UI.WebControls.SqlDataSourceView.UpdateCommand" /> SQL string, any parameters that are in the <see cref="P:System.Web.UI.WebControls.SqlDataSourceView.UpdateParameters" /> collection, and the values that are in the specified <paramref name="keys" />, <paramref name="values" />, and <paramref name="oldValues" /> collections.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that represents the number of rows updated in the underlying database.</para>
+        </returns>
         <param name="keys">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.IDictionary" /> of primary keys to use with the <see cref="P:System.Web.UI.WebControls.SqlDataSourceView.UpdateCommand" /> property to perform the update database operation. If there are no keys associated with the query or if the <see cref="P:System.Web.UI.WebControls.SqlDataSourceView.UpdateCommand" /> is not a parameterized SQL query, pass null.</param>
         <param name="values">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/StringArrayConverter.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/StringArrayConverter.xml
index ccee8da56f0..6f7bee04809 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/StringArrayConverter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/StringArrayConverter.xml
@@ -57,7 +57,6 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -67,6 +66,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Web.UI.WebControls.StringArrayConverter" /> can convert the specified source type to an array of strings.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the converter can perform the operation; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that provides a format context that can be used to extract additional information about the environment from which this converter is invoked. This parameter or properties of this parameter can be null.</param>
         <param name="sourceType">
@@ -88,7 +91,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -99,6 +101,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified comma-separated string into an array of strings.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted <paramref name="value" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that provides a format context that can be used to extract additional information about the environment from which this converter is invoked. This parameter or properties of this parameter can be null.</param>
         <param name="culture">
@@ -123,7 +129,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -134,6 +139,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an array of strings into a string of values separated by commas.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> instance that represents the converted <paramref name="value" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> object that provides a format context that can be used to extract additional information about the environment from which this converter is invoked. This parameter or properties of this parameter can be null.</param>
         <param name="culture">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Style.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Style.xml
index c409df5367e..05175907f22 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Style.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Style.xml
@@ -555,7 +555,6 @@
       </Parameters>
       <Docs>
         <param name="resolver">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.Style.GetStyleAttributes(System.Web.UI.IUrlResolutionService)" /> method to retrieve the <see cref="T:System.Web.UI.CssStyleCollection" /> object for a specified <see cref="T:System.Web.UI.IUrlResolutionService" />-implemented object. All classes derived from <see cref="T:System.Web.UI.Control" /> implement <see cref="T:System.Web.UI.IUrlResolutionService" />.</para>
@@ -564,6 +563,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the <see cref="T:System.Web.UI.CssStyleCollection" /> object for the specified <see cref="T:System.Web.UI.IUrlResolutionService" />-implemented object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.CssStyleCollection" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Height">
@@ -765,12 +768,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A protected method. Saves any state that has been modified after the <see cref="M:System.Web.UI.WebControls.Style.TrackViewState" /> method was invoked.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the saved state. The default is null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SetBit">
@@ -877,7 +883,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.WebControls.Style" /> instance is cast to an <see cref="T:System.Web.UI.IStateManager" /> interface.</para>
@@ -886,6 +891,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the object containing state changes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the saved state. The default is null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IStateManager.TrackViewState">
@@ -918,12 +927,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SubMenuStyle.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SubMenuStyle.xml
index f8b3725b71d..58b95acccbd 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SubMenuStyle.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SubMenuStyle.xml
@@ -258,7 +258,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can only be used when the <see cref="T:System.Web.UI.WebControls.SubMenuStyle" /> instance is cast to the <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -267,6 +266,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ComponentModel.ICustomTypeDescriptor.GetAttributes" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.AttributeCollection" /> containing the attributes for this object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetClassName">
@@ -280,7 +283,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can only be used when the <see cref="T:System.Web.UI.WebControls.SubMenuStyle" /> instance is cast to the <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -289,6 +291,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ComponentModel.ICustomTypeDescriptor.GetClassName" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The class name of the object, or null if the class does not have a name.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetComponentName">
@@ -302,7 +308,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can only be used when the <see cref="T:System.Web.UI.WebControls.SubMenuStyle" /> instance is cast to the <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -311,6 +316,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ComponentModel.ICustomTypeDescriptor.GetComponentName" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the object, or null if the object does not have a name.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetConverter">
@@ -324,7 +333,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can only be used when the <see cref="T:System.Web.UI.WebControls.SubMenuStyle" /> instance is cast to the <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -333,6 +341,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ComponentModel.ICustomTypeDescriptor.GetConverter" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter" /> that is the converter for this object, or null if there is no <see cref="T:System.ComponentModel.TypeConverter" /> for this object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetDefaultEvent">
@@ -346,7 +358,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can only be used when the <see cref="T:System.Web.UI.WebControls.SubMenuStyle" /> instance is cast to the <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -355,6 +366,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ComponentModel.ICustomTypeDescriptor.GetDefaultEvent" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptor" /> object that represents the default event for the object, or null if the object has no events.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetDefaultProperty">
@@ -368,7 +383,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can only be used when the <see cref="T:System.Web.UI.WebControls.SubMenuStyle" /> instance is cast to the <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -377,6 +391,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ComponentModel.ICustomTypeDescriptor.GetDefaultProperty" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptor" /> object that represents the default property for this object, or null if the object does not have properties.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetEditor">
@@ -392,7 +410,6 @@
         <Parameter Name="editorBaseType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can only be used when the <see cref="T:System.Web.UI.WebControls.SubMenuStyle" /> instance is cast to the <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -401,6 +418,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ComponentModel.ICustomTypeDescriptor.GetEditor(System.Type)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> of the specified type that is the editor for this object, or null if the editor cannot be found.</para>
+        </returns>
         <param name="editorBaseType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents the editor for this object.</param>
       </Docs>
@@ -416,7 +437,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can only be used when the <see cref="T:System.Web.UI.WebControls.SubMenuStyle" /> instance is cast to the <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -425,6 +445,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ComponentModel.ICustomTypeDescriptor.GetEvents" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptorCollection" /> that contains the events for this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetEvents">
@@ -441,7 +465,6 @@
       </Parameters>
       <Docs>
         <param name="arr">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can only be used when the <see cref="T:System.Web.UI.WebControls.SubMenuStyle" /> instance is cast to the <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -450,6 +473,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ComponentModel.ICustomTypeDescriptor.GetEvents(System.Attribute[])" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptorCollection" /> that contains the filtered events for this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetProperties">
@@ -463,7 +490,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can only be used when the <see cref="T:System.Web.UI.WebControls.SubMenuStyle" /> instance is cast to the <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -472,6 +498,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ComponentModel.ICustomTypeDescriptor.GetProperties" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that contains the properties for this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetProperties">
@@ -488,7 +518,6 @@
       </Parameters>
       <Docs>
         <param name="arr">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can only be used when the <see cref="T:System.Web.UI.WebControls.SubMenuStyle" /> instance is cast to the <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -497,6 +526,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ComponentModel.ICustomTypeDescriptor.GetProperties(System.Attribute[])" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> object that contains the filtered properties for this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.ICustomTypeDescriptor.GetPropertyOwner">
@@ -512,7 +545,6 @@
         <Parameter Name="pd" Type="System.ComponentModel.PropertyDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can only be used when the <see cref="T:System.Web.UI.WebControls.SubMenuStyle" /> instance is cast to the <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface.</para>
@@ -521,6 +553,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ComponentModel.ICustomTypeDescriptor.GetPropertyOwner(System.ComponentModel.PropertyDescriptor)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the owner of the specified property.</para>
+        </returns>
         <param name="pd">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.PropertyDescriptor" /> that represents the property whose owner is to be found.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SubMenuStyleCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SubMenuStyleCollection.xml
index c66796e133c..4d2e553faa7 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SubMenuStyleCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/SubMenuStyleCollection.xml
@@ -33,7 +33,6 @@
         <Parameter Name="style" Type="System.Web.UI.WebControls.SubMenuStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -43,6 +42,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a submenu style to the <see cref="T:System.Web.UI.WebControls.SubMenuStyleCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position in the collection at which the <see cref="T:System.Web.UI.WebControls.SubMenuStyle" /> instance was inserted.</para>
+        </returns>
         <param name="style">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.SubMenuStyle" /> instance to add to the collection.</param>
       </Docs>
@@ -60,7 +63,6 @@
         <Parameter Name="style" Type="System.Web.UI.WebControls.SubMenuStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -70,6 +72,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a <see cref="T:System.Web.UI.WebControls.SubMenuStyleCollection" /> collection contains a specific <see cref="T:System.Web.UI.WebControls.SubMenuStyle" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.UI.WebControls.SubMenuStyle" /> instance is found in the <see cref="T:System.Web.UI.WebControls.SubMenuStyleCollection" /> collection; otherwise, false. If null is passed as the <paramref name="style" /> parameter, false is returned.</para>
+        </returns>
         <param name="style">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.SubMenuStyle" /> instance to locate in the <see cref="T:System.Web.UI.WebControls.SubMenuStyleCollection" /> collection.</param>
       </Docs>
@@ -115,7 +121,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -129,6 +134,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Object" /> of the data type that corresponds to the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always returns an empty <see cref="T:System.Web.UI.WebControls.SubMenuStyle" /> object.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the data type to create. This parameter is not used in this implementation of the method; therefore, you should always pass in null.</param>
       </Docs>
@@ -144,7 +153,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -157,6 +165,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an array of <see cref="T:System.Type" /> objects that contains the supported data types of the <see cref="T:System.Web.UI.WebControls.SubMenuStyleCollection" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Type" /> objects that contains the data types supported by the <see cref="T:System.Web.UI.WebControls.SubMenuStyleCollection" /> class.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -172,7 +184,6 @@
         <Parameter Name="style" Type="System.Web.UI.WebControls.SubMenuStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -182,6 +193,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the location of a specified <see cref="T:System.Web.UI.WebControls.SubMenuStyle" /> object in the <see cref="T:System.Web.UI.WebControls.SubMenuStyleCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified <see cref="T:System.Web.UI.WebControls.SubMenuStyle" /> object if it is found in the list; otherwise, -1.</para>
+        </returns>
         <param name="style">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.SubMenuStyle" /> object to locate in the <see cref="T:System.Web.UI.WebControls.SubMenuStyleCollection" /> collection.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Table.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Table.xml
index 1596ba4780b..3634737f30a 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Table.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Table.xml
@@ -807,7 +807,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Web.UI.ControlCollection" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is used primarily by control developers when deriving a custom class from a <see cref="T:System.Web.UI.WebControls.Table" /> control.</para>
@@ -817,6 +816,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Web.UI.ControlCollection" /> object to hold the <see cref="T:System.Web.UI.WebControls.TableRow" /> controls of the current <see cref="T:System.Web.UI.WebControls.Table" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.ControlCollection" /> object to contain the <see cref="T:System.Web.UI.WebControls.TableRow" /> controls of the current <see cref="T:System.Web.UI.WebControls.Table" /> control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -831,7 +834,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Web.UI.WebControls.Style" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is used primarily by control developers when deriving a custom control from the <see cref="T:System.Web.UI.WebControls.Table" /> class.</para>
@@ -840,6 +842,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a reference to a collection of properties that define the appearance of a <see cref="T:System.Web.UI.WebControls.Table" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to the <see cref="T:System.Web.UI.WebControls.Style" /> object that contains the properties that define the appearance of the <see cref="T:System.Web.UI.WebControls.Table" /> control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TableCell.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TableCell.xml
index 30440a8a8f0..13f96eb7465 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TableCell.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TableCell.xml
@@ -262,7 +262,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Web.UI.WebControls.Style" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Web.UI.WebControls.TableItemStyle" /> created by the <see cref="M:System.Web.UI.WebControls.TableCell.CreateControlStyle" /> method is used with the <see cref="P:System.Web.UI.WebControls.TableCell.Wrap" />, <see cref="P:System.Web.UI.WebControls.TableCell.HorizontalAlign" />, and <see cref="P:System.Web.UI.WebControls.TableCell.VerticalAlign" /> properties.</para>
@@ -272,6 +271,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Web.UI.WebControls.TableItemStyle" /> for the <see cref="T:System.Web.UI.WebControls.TableCell" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.Style" /> that represents the <see cref="T:System.Web.UI.WebControls.TableItemStyle" /> for the <see cref="T:System.Web.UI.WebControls.TableCell" /> control. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TableCellCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TableCellCollection.xml
index ab7168e2e7c..3522b38e6cc 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TableCellCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TableCellCollection.xml
@@ -46,7 +46,6 @@
         <Parameter Name="cell" Type="System.Web.UI.WebControls.TableCell" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to add the specified <see cref="T:System.Web.UI.WebControls.TableCell" /> to the end of a <see cref="T:System.Web.UI.WebControls.TableCellCollection" />.</para>
@@ -55,6 +54,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the specified <see cref="T:System.Web.UI.WebControls.TableCell" /> to the end of the <see cref="T:System.Web.UI.WebControls.TableCellCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index number of the <see cref="T:System.Web.UI.WebControls.TableCell" />.</para>
+        </returns>
         <param name="cell">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.TableCell" /> to add to the collection. </param>
       </Docs>
@@ -207,7 +210,6 @@
         <Parameter Name="cell" Type="System.Web.UI.WebControls.TableCell" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to determine the index of the specified <see cref="T:System.Web.UI.WebControls.TableCell" /> in the <see cref="T:System.Web.UI.WebControls.TableCellCollection" />. If the specified <see cref="T:System.Web.UI.WebControls.TableCell" /> is not found, an index of -1 is returned.</para>
@@ -216,6 +218,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that represents the index of the specified <see cref="T:System.Web.UI.WebControls.TableCell" /> from the <see cref="T:System.Web.UI.WebControls.TableCellCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified <see cref="T:System.Web.UI.WebControls.TableCell" /> within the <see cref="T:System.Web.UI.WebControls.TableCellCollection" />. The default is -1, which indicates that a match has not been found.</para>
+        </returns>
         <param name="cell">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.TableCell" /> to get the index of in the <see cref="T:System.Web.UI.WebControls.TableCellCollection" />. </param>
       </Docs>
@@ -232,7 +238,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Collections.IEnumerator" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create a <see cref="T:System.Collections.IEnumerator" /> implemented object that can be iterated through easily to get each item in the <see cref="T:System.Web.UI.WebControls.TableCellCollection" />.</para>
@@ -247,6 +252,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Collections.IEnumerator" /> implemented object that contains all <see cref="T:System.Web.UI.WebControls.TableCell" /> objects in the <see cref="T:System.Web.UI.WebControls.TableCellCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.IEnumerator" /> implemented object that contains all <see cref="T:System.Web.UI.WebControls.TableCell" /> objects within the <see cref="T:System.Web.UI.WebControls.TableCellCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -408,7 +417,6 @@
       </Parameters>
       <Docs>
         <param name="value">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Typically, you should use the <see cref="M:System.Web.UI.WebControls.TableCellCollection.Add(System.Web.UI.WebControls.TableCell)" /> method to add an element to a <see cref="T:System.Web.UI.WebControls.TableCellCollection" /> object. </para>
@@ -418,6 +426,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an object to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the object was added to the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Contains">
@@ -435,7 +447,6 @@
       </Parameters>
       <Docs>
         <param name="value">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.TableCellCollection.System#Collections#IList#Contains(System.Object)" /> method is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.WebControls.TableCellCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -444,6 +455,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified object is contained within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object is in the collection; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.IndexOf">
@@ -461,7 +476,6 @@
       </Parameters>
       <Docs>
         <param name="value">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Typically, you should use the <see cref="M:System.Web.UI.WebControls.TableCellCollection.GetCellIndex(System.Web.UI.WebControls.TableCell)" /> method to get the index of an element in a <see cref="T:System.Web.UI.WebControls.TableCellCollection" /> object. </para>
@@ -471,6 +485,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified object and returns the zero-based index of the first occurrence within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of the object within the collection; otherwise, -1 if the object is not in the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Insert">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TableCellControlBuilder.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TableCellControlBuilder.xml
index f3a28f0ca82..4b799b0a7bd 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TableCellControlBuilder.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TableCellControlBuilder.xml
@@ -49,7 +49,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.TableCellControlBuilder.AllowWhitespaceLiterals" /> method overrides the <see cref="M:System.Web.UI.ControlBuilder.AllowWhitespaceLiterals" /> method to ignore white space in the <see cref="T:System.Web.UI.WebControls.TableCell" /> control.</para>
@@ -58,6 +57,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Specifies whether white space literals are allowed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TableRow.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TableRow.xml
index f679e4d234c..56fd6be8025 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TableRow.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TableRow.xml
@@ -266,7 +266,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Web.UI.ControlCollection" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.TableRow.CreateControlCollection" /> method creates a new <see cref="T:System.Web.UI.ControlCollection" /> object that holds the <see cref="T:System.Web.UI.WebControls.TableRow" /> cells.</para>
@@ -276,6 +275,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Web.UI.ControlCollection" /> object for the <see cref="T:System.Web.UI.WebControls.TableRow" /> control. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.ControlCollection" /> object that contains the <see cref="T:System.Web.UI.WebControls.TableRow" /> control's child server controls.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -290,12 +293,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Web.UI.WebControls.Style" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Web.UI.WebControls.TableItemStyle" /> object for the <see cref="T:System.Web.UI.WebControls.TableRow" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.Style" /> object that specifies the style properties for the <see cref="T:System.Web.UI.WebControls.TableRow" /> control.</para>
+          <para>The <see cref="M:System.Web.UI.WebControls.TableRow.CreateControlCollection" /> method is primarily of interest to control developers extending the functionality of the <see cref="T:System.Web.UI.WebControls.TableRow" /> control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TableRowCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TableRowCollection.xml
index 62a43e6538a..74b8dc83509 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TableRowCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TableRowCollection.xml
@@ -46,7 +46,6 @@
         <Parameter Name="row" Type="System.Web.UI.WebControls.TableRow" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to add a <see cref="T:System.Web.UI.WebControls.TableRow" /> object to the end of a <see cref="T:System.Web.UI.WebControls.TableRowCollection" />.</para>
@@ -55,6 +54,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the specified <see cref="T:System.Web.UI.WebControls.TableRow" /> object to the end of the <see cref="T:System.Web.UI.WebControls.TableRowCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the <see cref="T:System.Web.UI.WebControls.TableRow" />.</para>
+        </returns>
         <param name="row">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.TableRow" /> object to add to the <see cref="T:System.Web.UI.WebControls.TableRowCollection" />. </param>
       </Docs>
@@ -202,7 +205,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Collections.IEnumerator" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create a <see cref="T:System.Collections.IEnumerator" /> implemented object that can be iterated through easily to get each item in the <see cref="T:System.Web.UI.WebControls.TableRowCollection" />.</para>
@@ -217,6 +219,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Collections.IEnumerator" /> implemented object that contains all <see cref="T:System.Web.UI.WebControls.TableRow" /> objects within the <see cref="T:System.Web.UI.WebControls.TableRowCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.IEnumerator" /> implemented object that contains all <see cref="T:System.Web.UI.WebControls.TableRow" /> objects within the <see cref="T:System.Web.UI.WebControls.TableRowCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -233,7 +239,6 @@
         <Parameter Name="row" Type="System.Web.UI.WebControls.TableRow" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to determine the index of the specified <see cref="T:System.Web.UI.WebControls.TableRow" /> in the <see cref="T:System.Web.UI.WebControls.TableRowCollection" />. If the specified <see cref="T:System.Web.UI.WebControls.TableRow" /> is not found, an index of -1 is returned.</para>
@@ -242,6 +247,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that represents the index of the specified <see cref="T:System.Web.UI.WebControls.TableRow" /> from the <see cref="T:System.Web.UI.WebControls.TableRowCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The ordinal index position of the specified <see cref="T:System.Web.UI.WebControls.TableRow" /> within the collection. The default is -1, which indicates that the specified <see cref="T:System.Web.UI.WebControls.TableRow" /> has not been found.</para>
+        </returns>
         <param name="row">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.TableRow" /> object to search for in the <see cref="T:System.Web.UI.WebControls.TableRowCollection" />. </param>
       </Docs>
@@ -405,7 +414,6 @@
       </Parameters>
       <Docs>
         <param name="value">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Typically, you should use the <see cref="M:System.Web.UI.WebControls.TableRowCollection.Add(System.Web.UI.WebControls.TableRow)" /> method to add an element to a <see cref="T:System.Web.UI.WebControls.TableRowCollection" /> object. </para>
@@ -415,6 +423,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an object to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the object was added to the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Contains">
@@ -432,7 +444,6 @@
       </Parameters>
       <Docs>
         <param name="value">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.TableRowCollection.System#Collections#IList#Contains(System.Object)" /> method is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.WebControls.TableRowCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -441,6 +452,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified object is contained within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object is in the collection; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.IndexOf">
@@ -458,7 +473,6 @@
       </Parameters>
       <Docs>
         <param name="value">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Typically, you should use the <see cref="M:System.Web.UI.WebControls.TableRowCollection.GetRowIndex(System.Web.UI.WebControls.TableRow)" /> method to get the index of an element in a <see cref="T:System.Web.UI.WebControls.TableRowCollection" /> object. </para>
@@ -468,6 +482,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified object and returns the zero-based index of the first occurrence within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of the object within the collection; otherwise, -1 if the object is not in the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Insert">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TargetConverter.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TargetConverter.xml
index b513e9d356e..8b548903b4c 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TargetConverter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TargetConverter.xml
@@ -51,7 +51,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.ComponentModel.TypeConverter+StandardValuesCollection" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is an internal-only class.</para>
@@ -60,6 +59,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of standard values from the default context for the data type this type converter is designed for.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> containing a standard set of valid values, or null if the data type does not support a standard set of values.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
       </Docs>
@@ -78,7 +81,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is an internal-only class.</para>
@@ -87,6 +89,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the collection of standard values returned from the <see cref="M:System.Web.UI.WebControls.TargetConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> method is an exclusive list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> returned from <see cref="M:System.Web.UI.WebControls.TargetConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> is an exhaustive list of possible values; false if other values are possible.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
       </Docs>
@@ -105,7 +111,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is an internal-only class.</para>
@@ -114,6 +119,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether this object supports a standard set of values that can be picked from a list, using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <see cref="M:System.Web.UI.WebControls.TargetConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> should be called to find a common set of values the object supports; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TemplateField.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TemplateField.xml
index 0b88b3e629c..895d0215568 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TemplateField.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TemplateField.xml
@@ -268,7 +268,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -278,6 +277,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Web.UI.WebControls.TemplateField" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always returns a new <see cref="T:System.Web.UI.WebControls.TemplateField" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TextBox.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TextBox.xml
index a5b83d04154..1519f8839c1 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TextBox.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TextBox.xml
@@ -380,7 +380,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.TextBox.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method checks whether the postback data of the <see cref="T:System.Web.UI.WebControls.TextBox" /> control is different from its previous value and, if so, loads the content and returns true.</para>
@@ -389,6 +388,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the postback data for the <see cref="T:System.Web.UI.WebControls.TextBox" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the posted content is different from the last posting; otherwise, false. </para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The index within the posted collection that references the content to load. </param>
         <param name="postCollection">
@@ -615,7 +618,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is used primarily by control developers.</para>
@@ -626,6 +628,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the changes to the text box view state since the time the page was posted back to the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> that contains the changes to the <see cref="T:System.Web.UI.WebControls.TextBox" /> view state. If no view state is associated with the object, this method returns null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IPostBackDataHandler.LoadPostData">
@@ -643,7 +649,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.WebControls.TextBox" /> instance is cast to an <see cref="T:System.Web.UI.IPostBackDataHandler" /> interface.</para>
@@ -652,6 +657,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads the posted text box content if it is different from the last posting. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the posted content is different from the last posting; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The index within the posted collection that references the content to load. </param>
         <param name="postCollection">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TextBoxControlBuilder.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TextBoxControlBuilder.xml
index 2bac99eece5..4b4cc16fb6f 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TextBoxControlBuilder.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TextBoxControlBuilder.xml
@@ -52,7 +52,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method overrides <see cref="M:System.Web.UI.ControlBuilder.AllowWhitespaceLiterals" /> to ignore white space in the <see cref="T:System.Web.UI.WebControls.TextBox" /> control.</para>
@@ -61,6 +60,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Specifies whether white-space literals are allowed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>false in all cases.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -75,7 +78,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.TextBoxControlBuilder.HtmlDecodeLiterals" /> method to determine whether the literal string of the <see cref="T:System.Web.UI.WebControls.TextBox" /> control must be HTML decoded. This implementation of the method always returns true to indicate that the literal string of the <see cref="T:System.Web.UI.WebControls.TextBox" /> control must be HTML decoded.</para>
@@ -84,6 +86,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the literal string of the <see cref="T:System.Web.UI.WebControls.TextBox" /> control must be HTML decoded.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true in all cases.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TreeNode.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TreeNode.xml
index 44b7024b05e..f45a8d26d21 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TreeNode.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TreeNode.xml
@@ -452,7 +452,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -462,6 +461,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the <see cref="T:System.Web.UI.WebControls.TreeNode" /> class with the properties of the current <see cref="T:System.Web.UI.WebControls.TreeNode" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.Web.UI.WebControls.TreeNode" /> with the properties of the current <see cref="T:System.Web.UI.WebControls.TreeNode" /> instance.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1021,7 +1024,6 @@ if (TreeView1.Nodes[0].Expanded)
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1031,6 +1033,10 @@ if (TreeView1.Nodes[0].Expanded)
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the current view state of the node. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that contains the saved state of the node. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1226,7 +1232,6 @@ if (TreeView1.Nodes[0].Expanded)
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.TreeNode.System.ICloneable.Clone" /> method is used by the <see cref="T:System.Web.UI.WebControls.TreeNode" /> class to make a copy of itself.</para>
@@ -1235,6 +1240,10 @@ if (TreeView1.Nodes[0].Expanded)
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the <see cref="T:System.Web.UI.WebControls.TreeNode" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents a copy of the <see cref="T:System.Web.UI.WebControls.TreeNode" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IStateManager.IsTrackingViewState">
@@ -1290,12 +1299,15 @@ if (TreeView1.Nodes[0].Expanded)
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the view state changes to a <see cref="T:System.Object" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> that contains the view state changes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IStateManager.TrackViewState">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TreeNodeBinding.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TreeNodeBinding.xml
index b7c09e63c39..526fcdd0586 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TreeNodeBinding.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TreeNodeBinding.xml
@@ -822,7 +822,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.TreeNodeBinding.System.ICloneable.Clone" /> method is a helper function that creates a copy of the <see cref="T:System.Web.UI.WebControls.TreeNodeBinding" /> object from which the <see cref="M:System.Web.UI.WebControls.TreeNodeBinding.System.ICloneable.Clone" /> method is called.</para>
@@ -834,6 +833,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the <see cref="T:System.Web.UI.WebControls.TreeNodeBinding" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents a copy of the <see cref="T:System.Web.UI.WebControls.TreeNodeBinding" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IDataSourceViewSchemaAccessor.DataSourceViewSchema">
@@ -911,12 +914,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the view state changes to an object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object that contains the view state changes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IStateManager.TrackViewState">
@@ -1170,13 +1176,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="P:System.Web.UI.WebControls.TreeNodeBinding.DataMember" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the <see cref="P:System.Web.UI.WebControls.TreeNodeBinding.DataMember" /> property. If the <see cref="P:System.Web.UI.WebControls.TreeNodeBinding.DataMember" /> property is null or an empty string (""), <ui>(Empty)</ui> is returned.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TreeNodeBindingCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TreeNodeBindingCollection.xml
index ad596966a73..8f828f395e2 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TreeNodeBindingCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TreeNodeBindingCollection.xml
@@ -51,7 +51,6 @@
         <Parameter Name="binding" Type="System.Web.UI.WebControls.TreeNodeBinding" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -62,6 +61,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the specified <see cref="T:System.Web.UI.WebControls.TreeNodeBinding" /> object to the end of the <see cref="T:System.Web.UI.WebControls.TreeNodeBindingCollection" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the location of the added <see cref="T:System.Web.UI.WebControls.TreeNodeBinding" /> in the <see cref="T:System.Web.UI.WebControls.TreeNodeBindingCollection" />.</para>
+        </returns>
         <param name="binding">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.TreeNodeBinding" /> to append. </param>
       </Docs>
@@ -79,7 +82,6 @@
         <Parameter Name="binding" Type="System.Web.UI.WebControls.TreeNodeBinding" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -89,6 +91,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Web.UI.WebControls.TreeNodeBinding" /> object is in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.UI.WebControls.TreeNodeBinding" /> is in the collection; otherwise, false.</para>
+        </returns>
         <param name="binding">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.TreeNodeBinding" /> to find.</param>
       </Docs>
@@ -172,7 +178,6 @@
         <Parameter Name="binding" Type="System.Web.UI.WebControls.TreeNodeBinding" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -185,6 +190,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of the specified <see cref="T:System.Web.UI.WebControls.TreeNodeBinding" /> object in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="binding" /> within the <see cref="T:System.Web.UI.WebControls.TreeNodeBindingCollection" />, if found; otherwise, -1.</para>
+        </returns>
         <param name="binding">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.TreeNodeBinding" /> to locate.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TreeNodeCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TreeNodeCollection.xml
index dec861703d3..5a50ca5a034 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TreeNodeCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TreeNodeCollection.xml
@@ -197,7 +197,6 @@
       </Parameters>
       <Docs>
         <param name="child">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -207,6 +206,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Web.UI.WebControls.TreeNode" /> object is in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Web.UI.WebControls.TreeNode" /> object is contained in the collection; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -272,7 +275,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -286,6 +288,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that can be used to iterate through a <see cref="T:System.Web.UI.WebControls.TreeNodeCollection" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator that can be used to iterate through the <see cref="T:System.Web.UI.WebControls.TreeNodeCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -302,7 +308,6 @@
       </Parameters>
       <Docs>
         <param name="node">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -315,6 +320,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of the specified <see cref="T:System.Web.UI.WebControls.TreeNode" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="value" /> within the <see cref="T:System.Web.UI.WebControls.TreeNodeCollection" />, if found; otherwise, -1.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -533,12 +542,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the changes to view state to a <see cref="T:System.Object" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> that contains the view state changes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IStateManager.TrackViewState">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TreeNodeStyleCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TreeNodeStyleCollection.xml
index 07b1694f9e9..87b1eefaa6c 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TreeNodeStyleCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TreeNodeStyleCollection.xml
@@ -33,7 +33,6 @@
         <Parameter Name="style" Type="System.Web.UI.WebControls.TreeNodeStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -46,6 +45,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the specified <see cref="T:System.Web.UI.WebControls.TreeNodeStyle" /> object to the end of the <see cref="T:System.Web.UI.WebControls.TreeNodeStyleCollection" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position into which the new <see cref="T:System.Web.UI.WebControls.TreeNodeStyle" /> was inserted.</para>
+        </returns>
         <param name="style">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.TreeNodeStyle" /> to append. </param>
       </Docs>
@@ -63,7 +66,6 @@
         <Parameter Name="style" Type="System.Web.UI.WebControls.TreeNodeStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -73,6 +75,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Web.UI.WebControls.TreeNodeStyle" /> object is in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if the specified <see cref="T:System.Web.UI.WebControls.TreeNodeStyle" /> object is contained in the collection; otherwise, false.</para>
+        </returns>
         <param name="style">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.TreeNodeStyle" /> to find. </param>
       </Docs>
@@ -155,7 +161,6 @@
         <Parameter Name="style" Type="System.Web.UI.WebControls.TreeNodeStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -168,6 +173,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of the specified <see cref="T:System.Web.UI.WebControls.TreeNodeStyle" /> object in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="style" /> within the <see cref="T:System.Web.UI.WebControls.TreeNodeStyleCollection" />, if found; otherwise, -1.</para>
+        </returns>
         <param name="style">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.TreeNodeStyle" /> to locate.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TreeView.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TreeView.xml
index d85502a311b..91f3dc42762 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TreeView.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/TreeView.xml
@@ -933,7 +933,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -943,6 +942,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a collection to store child controls.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always returns an <see cref="T:System.Web.UI.EmptyControlCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -959,7 +962,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.TreeView.CreateNode" /> method is a helper method that returns a new instance of the <see cref="T:System.Web.UI.WebControls.TreeNode" /> class.</para>
@@ -969,6 +971,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new instance of the <see cref="T:System.Web.UI.WebControls.TreeNode" /> class. The <see cref="M:System.Web.UI.WebControls.TreeView.CreateNode" /> is a helper method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the <see cref="T:System.Web.UI.WebControls.TreeNode" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DataBind">
@@ -1216,7 +1222,6 @@
         <Parameter Name="valuePath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1226,6 +1231,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the <see cref="T:System.Web.UI.WebControls.TreeNode" /> object in the <see cref="T:System.Web.UI.WebControls.TreeView" /> control at the specified value path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.UI.WebControls.TreeNode" /> at the specified value path.</para>
+        </returns>
         <param name="valuePath">
           <attribution license="cc4" from="Microsoft" modified="false" />The value path of a node. </param>
       </Docs>
@@ -1241,7 +1250,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1251,6 +1259,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the result of a callback event that targets a control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The results of the callback.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1835,7 +1847,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1845,6 +1856,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes postback data for the <see cref="T:System.Web.UI.WebControls.TreeView" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if the <see cref="T:System.Web.UI.WebControls.TreeView" /> control's state changes as a result of the postback event; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key identifier for the control. </param>
         <param name="postCollection">
@@ -2501,6 +2516,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Raises the callback event using the specified arguments. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The argument for the callback handler in the <see cref="M:System.Web.UI.ClientScriptManager.GetCallbackEventReference(System.String,System.String,System.String,System.String,System.String,System.Boolean)" /> method.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -2695,13 +2714,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the state of the <see cref="T:System.Web.UI.WebControls.TreeView" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The server control's current view state; otherwise, null, if there is no view state associated with the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -3230,7 +3252,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Web.UI.WebControls.TreeView" /> control implements the <see cref="T:System.Web.UI.ICallbackEventHandler" /> interface and uses the <see cref="M:System.Web.UI.WebControls.TreeView.RaisePostBackEvent(System.String)" /> to retrieve data and the <see cref="M:System.Web.UI.WebControls.TreeView.GetCallbackResult" /> method to return the retrieved data to the control.</para>
@@ -3239,6 +3260,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the result of a callback event that targets a control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The results of the callback.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.ICallbackEventHandler.RaiseCallbackEvent">
@@ -3263,6 +3288,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Raises the callback event using the specified arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The argument for the callback handler in the <see cref="M:System.Web.UI.ClientScriptManager.GetCallbackEventReference(System.String,System.String,System.String,System.String,System.String,System.Boolean)" /> method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IPostBackDataHandler.LoadPostData">
@@ -3279,7 +3308,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Control developers should override the <see cref="M:System.Web.UI.WebControls.TreeView.LoadPostData(System.String,System.Collections.Specialized.NameValueCollection)" /> method.</para>
@@ -3288,6 +3316,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes postback data for the <see cref="T:System.Web.UI.WebControls.TreeView" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if the <see cref="T:System.Web.UI.WebControls.TreeView" /> control's state changes as a result of the postback event; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key identifier for the control. </param>
         <param name="postCollection">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Unit.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Unit.xml
index 028275ee01c..1082ff1b49f 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Unit.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Unit.xml
@@ -490,7 +490,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.Unit.Equals(System.Object)" /> method to compare the <see cref="T:System.Web.UI.WebControls.Unit" /> that this method is called from with the object specified by <paramref name="obj" />. For both objects to be equal, they must have the same values for both the <see cref="P:System.Web.UI.WebControls.Unit.Type" /> and <see cref="P:System.Web.UI.WebControls.Unit.Value" /> properties.</para>
@@ -502,6 +501,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this <see cref="T:System.Web.UI.WebControls.Unit" /> with the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.UI.WebControls.Unit" /> that this method is called from is equal to the specified object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object for comparison. </param>
       </Docs>
@@ -563,7 +566,6 @@
         <Parameter Name="right" Type="System.Web.UI.WebControls.Unit" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this operator to compare two <see cref="T:System.Web.UI.WebControls.Unit" /> objects for equality. For both objects to be equal, they must have the same values for both the <see cref="P:System.Web.UI.WebControls.Unit.Type" /> and <see cref="P:System.Web.UI.WebControls.Unit.Value" /> properties.</para>
@@ -572,6 +574,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Web.UI.WebControls.Unit" /> objects to determine whether they are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if both <see cref="T:System.Web.UI.WebControls.Unit" /> objects are equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.Unit" /> on the left side of the operator. </param>
         <param name="right">
@@ -613,7 +619,6 @@
         <Parameter Name="right" Type="System.Web.UI.WebControls.Unit" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this operator to compare two <see cref="T:System.Web.UI.WebControls.Unit" /> objects for inequality. For the objects to not be equal, they must have different values for the <see cref="P:System.Web.UI.WebControls.Unit.Type" /> property or the <see cref="P:System.Web.UI.WebControls.Unit.Value" /> property.</para>
@@ -622,6 +627,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Web.UI.WebControls.Unit" /> objects to determine whether they are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.UI.WebControls.Unit" /> objects are not equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.Unit" /> on the left side of the operator. </param>
         <param name="right">
@@ -642,7 +651,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Unit'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.Unit.Parse(System.String)" /> static method to convert the string specified by the <paramref name="s" /> parameter to a <see cref="T:System.Web.UI.WebControls.Unit" />.</para>
@@ -654,6 +662,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string to a <see cref="T:System.Web.UI.WebControls.Unit" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.Unit" /> that represents the specified string.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert. </param>
       </Docs>
@@ -673,7 +685,6 @@
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Web.UI.WebControls.Unit" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.Unit.Parse(System.String)" /> static method to convert the string specified by <paramref name="s" /> to a <see cref="T:System.Web.UI.WebControls.Unit" /> in the culture specified by <paramref name="culture" />.</para>
@@ -685,6 +696,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string and <see cref="T:System.Globalization.CultureInfo" /> to a <see cref="T:System.Web.UI.WebControls.Unit" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.Unit" /> that represents the specified string.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert. </param>
         <param name="culture">
@@ -705,7 +720,6 @@
         <Parameter Name="n" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Unit'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.Unit.Percentage(System.Double)" /> static method to create a <see cref="T:System.Web.UI.WebControls.Unit" /> of type <see cref="F:System.Web.UI.WebControls.UnitType.Percentage" /> that represents the length specified by the <paramref name="n" /> parameter. For example, if you specify 80 for n and use the returned unit to set the <see cref="P:System.Web.UI.WebControls.WebControl.Height" /> of a Web server control, the height attribute is set to 80%.</para>
@@ -717,6 +731,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Web.UI.WebControls.Unit" /> of type <see cref="F:System.Web.UI.WebControls.UnitType.Percentage" /> from the specified double-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.Unit" /> of type <see cref="F:System.Web.UI.WebControls.UnitType.Percentage" /> that represents the length specified by the double-precision floating-point number.</para>
+        </returns>
         <param name="n">
           <attribution license="cc4" from="Microsoft" modified="false" />A double-precision floating-point number that represents the length of the <see cref="T:System.Web.UI.WebControls.Unit" />.</param>
       </Docs>
@@ -735,7 +753,6 @@
         <Parameter Name="n" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Unit'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.Unit.Pixel(System.Int32)" /> static method to create a <see cref="T:System.Web.UI.WebControls.Unit" /> of type <see cref="F:System.Web.UI.WebControls.UnitType.Pixel" /> that represents the length specified by the <paramref name="n" /> parameter.</para>
@@ -747,6 +764,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Web.UI.WebControls.Unit" /> of type <see cref="F:System.Web.UI.WebControls.UnitType.Pixel" /> from the specified 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.Unit" /> of type <see cref="F:System.Web.UI.WebControls.UnitType.Pixel" /> that represents the length specified by the <paramref name="n" /> parameter.</para>
+        </returns>
         <param name="n">
           <attribution license="cc4" from="Microsoft" modified="false" />A 32-bit signed integer that represents the length of the <see cref="T:System.Web.UI.WebControls.Unit" />. </param>
       </Docs>
@@ -765,7 +786,6 @@
         <Parameter Name="n" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Unit'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.Unit.Point(System.Int32)" /> static method to create a <see cref="T:System.Web.UI.WebControls.Unit" /> of type <see cref="F:System.Web.UI.WebControls.UnitType.Point" /> that represents the length specified by the <paramref name="n" /> parameter.</para>
@@ -777,6 +797,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Web.UI.WebControls.Unit" /> of type <see cref="F:System.Web.UI.WebControls.UnitType.Point" /> from the specified 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.Unit" /> of type <see cref="F:System.Web.UI.WebControls.UnitType.Point" /> that represents the length specified by the 32-bit signed integer.</para>
+        </returns>
         <param name="n">
           <attribution license="cc4" from="Microsoft" modified="false" />A 32-bit signed integer that represents the length of the <see cref="T:System.Web.UI.WebControls.Unit" />. </param>
       </Docs>
@@ -793,12 +817,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a <see cref="T:System.Web.UI.WebControls.Unit" /> to a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that represents this <see cref="T:System.Web.UI.WebControls.Unit" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -815,7 +842,6 @@
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.WebControls.Unit.ToString" /> method to convert the <see cref="T:System.Web.UI.WebControls.Unit" /> that this method is called from to a string equivalent in the specified culture.</para>
@@ -824,6 +850,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a <see cref="T:System.Web.UI.WebControls.Unit" /> to a string equivalent in the specified culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> represents this <see cref="T:System.Web.UI.WebControls.Unit" /> in the culture specified by <paramref name="culture" />.</para>
+        </returns>
         <param name="culture">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Globalization.CultureInfo" /> that represents the culture. </param>
       </Docs>
@@ -846,7 +876,6 @@
       </Parameters>
       <Docs>
         <param name="provider">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.Unit.ToString(System.IFormatProvider)" /> method returns a string representation formatted with a unit <see cref="P:System.Web.UI.WebControls.Unit.Value" /> and an abbreviation representing the unit <see cref="P:System.Web.UI.WebControls.Unit.Type" />. The following table lists <see cref="T:System.Web.UI.WebControls.UnitType" /> values and their corresponding abbreviation.</para>
@@ -949,6 +978,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a <see cref="T:System.Web.UI.WebControls.Unit" /> to a string equivalent using the specified format provider.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> representing this <see cref="T:System.Web.UI.WebControls.Unit" /> in the format specified by <paramref name="formatProvider" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Type">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/UnitConverter.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/UnitConverter.xml
index 3f9cb20e104..920784f00e9 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/UnitConverter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/UnitConverter.xml
@@ -58,12 +58,15 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the unit converter can convert from the specified source type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the source type can be converted from; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> instance that specifies the context of the object to convert. </param>
         <param name="sourceType">
@@ -89,12 +92,15 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the converter can convert a <see cref="T:System.Web.UI.WebControls.Unit" /> object to the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the converter supports converting a <see cref="T:System.Web.UI.WebControls.Unit" /> object to the destination type; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that indicates the context of the object to convert.</param>
         <param name="destinationType">
@@ -113,12 +119,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs type conversion from the specified context, object, and argument list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object resulting from conversion.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> instance that indicates the context of the object to convert. </param>
         <param name="culture">
@@ -144,12 +153,15 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs type conversion to the specified destination type given the specified context, object and argument list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object resulting from conversion.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> instance that indicates the context of the object to convert. </param>
         <param name="culture">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ValidatedControlConverter.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ValidatedControlConverter.xml
index 44a8c68bde9..20900bbd99f 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ValidatedControlConverter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/ValidatedControlConverter.xml
@@ -76,7 +76,6 @@
         <Parameter Name="control" Type="System.Web.UI.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When the <see cref="M:System.Web.UI.WebControls.ValidatedControlConverter.FilterControl(System.Web.UI.Control)" /> method returns true, the <see cref="T:System.Web.UI.WebControls.ValidatedControlConverter" /> instance will add the ID of the control specified in the control parameter to the <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> returned by the <see cref="M:System.Web.UI.WebControls.ControlIDConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> method.</para>
@@ -85,6 +84,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified control should be added to the list of controls that can be validated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the control should be added to the list of controls that can be validated; otherwise, false.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The control to check. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/WebColorConverter.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/WebColorConverter.xml
index d40f5196ac8..966356f0884 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/WebColorConverter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/WebColorConverter.xml
@@ -108,12 +108,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given value to the type of the converter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object resulting from conversion.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that indicates the context of the object to convert.</param>
         <param name="culture">
@@ -139,12 +142,15 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object to a specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object resulting from conversion.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> instance that indicates the context of the object to convert.</param>
         <param name="culture">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/WebControl.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/WebControl.xml
index 5c8ac40b836..f8c0b4ddc6d 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/WebControl.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/WebControl.xml
@@ -636,7 +636,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Style'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.WebControl.CreateControlStyle" /> method is used to create the style object that is used internally to implement all style related properties. Derived classes can override this method to create a style that is appropriate to the class. This method is primarily used by control developers.</para>
@@ -646,6 +645,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the style object that is used internally by the <see cref="T:System.Web.UI.WebControls.WebControl" /> class to implement all style related properties. This method is used primarily by control developers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.Style" /> that is used to implement all style-related properties of the control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1096,7 +1099,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.WebControl.SaveViewState" /> method is used primarily by control developers.</para>
@@ -1107,6 +1109,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves any state that was modified after the <see cref="M:System.Web.UI.WebControls.Style.TrackViewState" /> method was invoked.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that contains the current view state of the control; otherwise, if there is no view state associated with the control, null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1192,7 +1198,6 @@
       </Parameters>
       <Docs>
         <param name="key">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.WebControl.System#Web#UI#IAttributeAccessor#GetAttribute(System.String)" /> method is an explicit interface member implementation. It can be used only when the instance of the <see cref="T:System.Web.UI.WebControls.WebControl" /> class is cast to an <see cref="T:System.Web.UI.IAttributeAccessor" /> interface.</para>
@@ -1201,6 +1206,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an attribute of the Web control with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the attribute.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IAttributeAccessor.SetAttribute">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Wizard.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Wizard.xml
index e91499cbe99..ec3623c681d 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Wizard.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Wizard.xml
@@ -513,7 +513,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -523,6 +522,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uses a Boolean value to determine whether the <see cref="P:System.Web.UI.WebControls.Wizard.ActiveStep" /> property can be set to the <see cref="T:System.Web.UI.WebControls.WizardStepBase" /> object that corresponds to the index that is passed in.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>false if the index passed in refers to a <see cref="T:System.Web.UI.WebControls.WizardStepBase" /> that has already been accessed and its <see cref="P:System.Web.UI.WebControls.WizardStepBase.AllowReturn" /> property is set to false; otherwise, true.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the <see cref="T:System.Web.UI.WebControls.WizardStepBase" /> object being checked.</param>
       </Docs>
@@ -1511,7 +1514,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1521,6 +1523,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of <see cref="T:System.Web.UI.WebControls.WizardStepBase" /> objects that have been accessed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.ICollection" /> containing the <see cref="T:System.Web.UI.WebControls.WizardStepBase" /> objects that have been accessed.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -1537,7 +1543,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1547,6 +1552,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Web.UI.WebControls.WizardStepType" /> value for the specified <see cref="T:System.Web.UI.WebControls.WizardStepBase" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Web.UI.WebControls.WizardStepType" /> values.</para>
+        </returns>
         <param name="wizardStep">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.WizardStepBase" /> for which the associated <see cref="T:System.Web.UI.WebControls.WizardStepType" />  is returned.</param>
         <param name="index">
@@ -2029,13 +2038,16 @@
         <Parameter Name="e" Type="System.EventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the event for the server control is passed up the page’s user interface server control hierarchy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the event for the server control is passed up the page’s user interface server control hierarchy; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The source of the event.</param>
         <param name="e">
@@ -2287,12 +2299,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Save the control state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The control state.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SaveViewState">
@@ -2303,13 +2318,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the view state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The view state.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/WizardStepCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/WizardStepCollection.xml
index d46c5e08b9b..eb551aefa9d 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/WizardStepCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/WizardStepCollection.xml
@@ -128,7 +128,6 @@
         <Parameter Name="wizardStep" Type="System.Web.UI.WebControls.WizardStepBase" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -138,6 +137,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Web.UI.WebControls.WizardStepCollection" /> collection contains a specific <see cref="T:System.Web.UI.WebControls.WizardStepBase" />-derived object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.UI.WebControls.WizardStepBase" />-derived object is found in the <see cref="T:System.Web.UI.WebControls.WizardStepCollection" /> collection; otherwise, false.</para>
+        </returns>
         <param name="wizardStep">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.WizardStepBase" />-derived object to find in the <see cref="T:System.Web.UI.WebControls.WizardStepCollection" /> collection.</param>
       </Docs>
@@ -205,13 +208,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IEnumerator" />-implemented object that can be used to iterate through the <see cref="T:System.Web.UI.WebControls.WizardStepBase" />-derived objects in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" />-implemented object that contains all the <see cref="T:System.Web.UI.WebControls.WizardStepBase" />-derived objects in the <see cref="T:System.Web.UI.WebControls.WizardStepCollection" /> collection.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -227,7 +233,6 @@
         <Parameter Name="wizardStep" Type="System.Web.UI.WebControls.WizardStepBase" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -237,6 +242,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index value that represents the position of the specified <see cref="T:System.Web.UI.WebControls.WizardStepBase" />-derived object in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If found, the zero-based index of the first occurrence of the <see cref="T:System.Web.UI.WebControls.WizardStepBase" />-derived object passed in within the current <see cref="T:System.Web.UI.WebControls.WizardStepCollection" /> collection; otherwise, -1.</para>
+        </returns>
         <param name="wizardStep">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.WebControls.WizardStepBase" />-derived object to search for in the <see cref="T:System.Web.UI.WebControls.WizardStepCollection" /> collection.</param>
       </Docs>
@@ -453,12 +462,15 @@
       </Parameters>
       <Docs>
         <param name="ob">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the specified object to the end of the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position into which the new element was inserted.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Contains">
@@ -475,12 +487,15 @@
       </Parameters>
       <Docs>
         <param name="ob">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the collection contains the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Object" /> is found in the <see cref="T:System.Collections.IList" />; otherwise false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.IndexOf">
@@ -497,12 +512,15 @@
       </Parameters>
       <Docs>
         <param name="ob">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index value that represents the position of the specified object in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index value of the specified object in the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Insert">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Xml.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Xml.xml
index 4ceb701c601..240a2a5aab2 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Xml.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/Xml.xml
@@ -298,7 +298,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.Xml.CreateControlCollection" /> method is used primarily by control developers extending the functionality of the <see cref="T:System.Web.UI.WebControls.Xml" /> control.</para>
@@ -307,6 +306,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Web.UI.EmptyControlCollection" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always returns an <see cref="T:System.Web.UI.EmptyControlCollection" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Document">
@@ -462,12 +465,15 @@
         <Parameter Name="id" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the page naming container for the specified server control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified control; otherwise, null if the specified control does not exist.</para>
+        </returns>
         <param name="id">
           <attribution license="cc4" from="Microsoft" modified="false" />The identifier for the control to be found.</param>
       </Docs>
@@ -509,7 +515,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.Xml.GetDesignModeState" /> method is a helper method used to get the current design-time state of the <see cref="T:System.Web.UI.WebControls.Xml" /> control.</para>
@@ -518,6 +523,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets design-time data for a control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IDictionary" /> containing the design-time data for the <see cref="T:System.Web.UI.WebControls.Xml" /> control.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HasControls">
@@ -536,12 +545,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the server control contains any child controls.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the control contains other controls; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Render">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/XmlBuilder.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/XmlBuilder.xml
index 9385758d2d8..9fb64dab01b 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/XmlBuilder.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/XmlBuilder.xml
@@ -70,7 +70,6 @@
         <Parameter Name="attribs" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.XmlBuilder.GetChildControlType(System.String,System.Collections.IDictionary)" /> method of the <see cref="T:System.Web.UI.WebControls.XmlBuilder" /> class overrides the <see cref="M:System.Web.UI.ControlBuilder.GetChildControlType(System.String,System.Collections.IDictionary)" /> method of the <see cref="T:System.Web.UI.ControlBuilder" /> class. This implementation of the <see cref="M:System.Web.UI.WebControls.XmlBuilder.GetChildControlType(System.String,System.Collections.IDictionary)" /> method always returns null.</para>
@@ -79,6 +78,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains the <see cref="T:System.Type" /> for the <see cref="T:System.Web.UI.WebControls.Xml" /> control's specified child control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="M:System.Web.UI.ControlBuilder.GetChildControlType(System.String,System.Collections.IDictionary)" /> method is overridden to always return null.</para>
+        </returns>
         <param name="tagName">
           <attribution license="cc4" from="Microsoft" modified="false" />The tag name of the child control.</param>
         <param name="attribs">
@@ -96,7 +99,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.WebControls.XmlBuilder.NeedsTagInnerText" /> method of the <see cref="T:System.Web.UI.WebControls.XmlBuilder" /> class overrides the <see cref="M:System.Web.UI.ControlBuilder.NeedsTagInnerText" /> method of the <see cref="T:System.Web.UI.ControlBuilder" /> class to always return true.</para>
@@ -106,6 +108,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Web.UI.WebControls.Xml" /> control needs to get its inner text.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="M:System.Web.UI.ControlBuilder.NeedsTagInnerText" /> method is overridden to always return true.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/XmlDataSource.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/XmlDataSource.xml
index bf09f0e7fd1..c23bf33b442 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/XmlDataSource.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/XmlDataSource.xml
@@ -499,7 +499,6 @@
         <Parameter Name="viewPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -509,6 +508,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the data source view object for the <see cref="T:System.Web.UI.WebControls.XmlDataSource" /> control. The <paramref name="viewPath" /> parameter can be an XPath expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an <see cref="T:System.Web.UI.WebControls.XmlHierarchicalDataSourceView" /> object that represents a single view of the data starting with the data node identified by <paramref name="viewPath" />.</para>
+        </returns>
         <param name="viewPath">
           <attribution license="cc4" from="Microsoft" modified="false" />An XPath expression that identifies a node from which the current hierarchical view is built. </param>
       </Docs>
@@ -524,7 +527,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -535,6 +537,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads the XML data into memory, either directly from the underlying data storage or from the cache, and returns it in the form of an <see cref="T:System.Xml.XmlDataDocument" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlDataDocument" /> object that represents the XML specified in the <see cref="P:System.Web.UI.WebControls.XmlDataSource.Data" /> property or in the file identified by the <see cref="P:System.Web.UI.WebControls.XmlDataSource.DataFile" /> property, with any transformations and <see cref="P:System.Web.UI.WebControls.XmlDataSource.XPath" /> queries applied.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -630,7 +636,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.WebControls.XmlDataSource" /> instance is cast to the <see cref="T:System.ComponentModel.IListSource" /> interface.</para>
@@ -639,6 +644,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ComponentModel.IListSource.GetList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object implementing <see cref="T:System.Collections.IList" /> that can be bound to a data source.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IDataSource.GetView">
@@ -654,12 +663,15 @@
         <Parameter Name="viewName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the named data source view associated with the data source control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the named <see cref="T:System.Web.UI.WebControls.XmlDataSourceView" /> object associated with the <see cref="T:System.Web.UI.WebControls.XmlDataSource" /> control.</para>
+        </returns>
         <param name="viewName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the view to retrieve. If <see cref="F:System.String.Empty" /> is specified, the default view for the <see cref="T:System.Web.UI.WebControls.XmlDataSource" /> control is retrieved. </param>
       </Docs>
@@ -675,7 +687,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.WebControls.XmlDataSource" /> instance is cast to the <see cref="T:System.Web.UI.IDataSource" /> interface.</para>
@@ -684,6 +695,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Web.UI.IDataSource.GetViewNames" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object implementing <see cref="T:System.Collections.ICollection" /> containing names representing the list of view objects associated with the <see cref="T:System.Web.UI.IDataSource" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Transform">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/XmlDataSourceView.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/XmlDataSourceView.xml
index 378b25d2388..6a4b8b2df57 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/XmlDataSourceView.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/XmlDataSourceView.xml
@@ -75,13 +75,16 @@
         <Parameter Name="arguments" Type="System.Web.UI.DataSourceSelectArguments" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a list of data rows from the underlying XML.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerable" /> collection of data items.</para>
+        </returns>
         <param name="arguments">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.DataSourceSelectArguments" /> object that is used to request operations on the data beyond basic data retrieval.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/XmlHierarchicalDataSourceView.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/XmlHierarchicalDataSourceView.xml
index fabd4f443ae..ac12b01bcbb 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/XmlHierarchicalDataSourceView.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI.WebControls/XmlHierarchicalDataSourceView.xml
@@ -31,7 +31,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -41,6 +40,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a list of the data items from the underlying data source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.IHierarchicalEnumerable" /> collection of data items based on the hierarchical level of the current view.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/AttributeCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/AttributeCollection.xml
index d42fccbced2..54bb13069e8 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/AttributeCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/AttributeCollection.xml
@@ -178,7 +178,6 @@
       </Parameters>
       <Docs>
         <param name="obj">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For the compared objects to be equal, they must meet the following criteria:</para>
@@ -201,6 +200,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current instance of the <see cref="T:System.Web.UI.AttributeCollection" /> object is equal to the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object that is contained in the <paramref name="o" /> parameter is equal to the current instance of <see cref="T:System.Web.UI.AttributeCollection" />; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -215,7 +218,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.AttributeCollection.GetHashCode" /> method to determine the hash code for this <see cref="T:System.Web.UI.AttributeCollection" /> object.</para>
@@ -224,6 +226,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Item">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/BaseTemplateParser.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/BaseTemplateParser.xml
index 9a3db51dd6a..59e26427592 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/BaseTemplateParser.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/BaseTemplateParser.xml
@@ -67,7 +67,6 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If a <see cref="T:System.Web.UI.PageParserFilter" /> object is defined and its <see cref="M:System.Web.UI.PageParserFilter.AllowVirtualReference(System.String,System.Web.UI.VirtualReferenceType)" /> property is false, the <see cref="M:System.Web.UI.BaseTemplateParser.GetUserControlType(System.String)" /> method raises an <see cref="T:System.Web.HttpException" /> exception.</para>
@@ -77,6 +76,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compiles and returns the type of the <see cref="T:System.Web.UI.UserControl" /> object that is specified by the virtual path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type of the user control. </para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path of the <see cref="T:System.Web.UI.UserControl" />. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/ChtmlTextWriter.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/ChtmlTextWriter.xml
index 2731ed43f9a..692113da9f4 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/ChtmlTextWriter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/ChtmlTextWriter.xml
@@ -208,7 +208,6 @@
         <Parameter Name="key" Type="System.Web.UI.HtmlTextWriterAttribute" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -218,6 +217,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified cHTML attribute and its value are rendered to the requesting page. You can override the <see cref="M:System.Web.UI.ChtmlTextWriter.OnAttributeRender(System.String,System.String,System.Web.UI.HtmlTextWriterAttribute)" /> method in classes that derive from the <see cref="T:System.Web.UI.ChtmlTextWriter" /> class to filter out attributes that you do not want to render on devices that support cHTML.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true to write the attribute and its value to the <see cref="T:System.Web.UI.ChtmlTextWriter" /> output stream; otherwise, false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The cHTML attribute to render. </param>
         <param name="value">
@@ -242,7 +245,6 @@
       </Parameters>
       <Docs>
         <param name="styleAttrName">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -252,6 +254,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified cHTML markup style attribute and its value can be rendered to the current markup element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the style can be rendered; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string containing the value that is assigned to <paramref name="name" />. </param>
         <param name="key">
@@ -273,7 +279,6 @@
       </Parameters>
       <Docs>
         <param name="tag">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -283,6 +288,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified cHTML markup element is rendered to the requesting page. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified cHTML markup element can be rendered; otherwise, false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />A string containing the name of the cHTML element to render.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/ClientScriptManager.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/ClientScriptManager.xml
index 08357108caf..0d51e8a90d5 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/ClientScriptManager.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/ClientScriptManager.xml
@@ -45,7 +45,6 @@
         <Parameter Name="context" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -65,6 +64,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains a reference to a client function that, when invoked, initiates a client call back to a server event. The client function for this overloaded method includes a specified control, argument, client script, and context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of a client function that invokes the client callback. </para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The server <see cref="T:System.Web.UI.Control" /> that handles the client callback. The control must implement the <see cref="T:System.Web.UI.ICallbackEventHandler" /> interface and provide a <see cref="M:System.Web.UI.ICallbackEventHandler.RaiseCallbackEvent(System.String)" /> method. </param>
         <param name="argument">
@@ -92,7 +95,6 @@
         <Parameter Name="useAsync" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -103,6 +105,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains a reference to a client function that, when invoked, initiates a client call back to server events. The client function for this overloaded method includes a specified control, argument, client script, context, and Boolean value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of a client function that invokes the client callback. </para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The server <see cref="T:System.Web.UI.Control" /> that handles the client callback. The control must implement the <see cref="T:System.Web.UI.ICallbackEventHandler" /> interface and provide a <see cref="M:System.Web.UI.ICallbackEventHandler.RaiseCallbackEvent(System.String)" /> method. </param>
         <param name="argument">
@@ -133,7 +139,6 @@
         <Parameter Name="useAsync" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -145,6 +150,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains a reference to a client function that, when invoked, initiates a client call back to server events. The client function for this overloaded method includes a specified target, argument, client script, context, error handler, and Boolean value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of a client function that invokes the client callback. </para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a server <see cref="T:System.Web.UI.Control" /> that handles the client callback. The control must implement the <see cref="T:System.Web.UI.ICallbackEventHandler" /> interface and provide a <see cref="M:System.Web.UI.ICallbackEventHandler.RaiseCallbackEvent(System.String)" /> method.</param>
         <param name="argument">
@@ -177,7 +186,6 @@
         <Parameter Name="useAsync" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -188,6 +196,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains a reference to a client function that, when invoked, initiates a client call back to server events. The client function for this overloaded method includes a specified control, argument, client script, context, error handler, and Boolean value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of a client function that invokes the client callback. </para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The server <see cref="T:System.Web.UI.Control" /> that handles the client callback. The control must implement the <see cref="T:System.Web.UI.ICallbackEventHandler" /> interface and provide a <see cref="M:System.Web.UI.ICallbackEventHandler.RaiseCallbackEvent(System.String)" /> method. </param>
         <param name="argument">
@@ -216,7 +228,6 @@
         <Parameter Name="argument" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -226,6 +237,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a reference, with javascript: appended to the beginning of it, that can be used in a client event to post back to the server for the specified control and with the specified event arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representing a JavaScript call to the postback function that includes the target control's ID and event arguments.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The server control to process the postback.</param>
         <param name="argument">
@@ -247,7 +262,6 @@
         <Parameter Name="registerForEventValidation" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -257,6 +271,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a reference, with javascript: appended to the beginning of it, that can be used in a client event to post back to the server for the specified control with the specified event arguments and Boolean indication whether to register the post back for event validation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representing a JavaScript call to the postback function that includes the target control's ID and event arguments.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The server control to process the postback.</param>
         <param name="argument">
@@ -278,7 +296,6 @@
         <Parameter Name="options" Type="System.Web.UI.PostBackOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -289,6 +306,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that can be used in a client event to cause postback to the server. The reference string is defined by the specified <see cref="T:System.Web.UI.PostBackOptions" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that, when treated as script on the client, initiates the client postback.</para>
+        </returns>
         <param name="options">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.PostBackOptions" /> that defines the postback.</param>
       </Docs>
@@ -307,7 +328,6 @@
         <Parameter Name="argument" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -318,6 +338,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that can be used in a client event to cause postback to the server. The reference string is defined by the specified control that handles the postback and a string argument of additional event information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that, when treated as script on the client, initiates the postback.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The server <see cref="T:System.Web.UI.Control" /> that processes the postback on the server.</param>
         <param name="argument">
@@ -338,7 +362,6 @@
         <Parameter Name="registerForEventValidation" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -350,6 +373,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that can be used in a client event to cause postback to the server. The reference string is defined by the specified <see cref="T:System.Web.UI.PostBackOptions" /> object. Optionally, registers the event reference for validation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that, when treated as script on the client, initiates the client postback.</para>
+        </returns>
         <param name="options">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.PostBackOptions" /> that defines the postback.</param>
         <param name="registerForEventValidation">
@@ -371,7 +398,6 @@
         <Parameter Name="registerForEventValidation" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -383,6 +409,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string to use in a client event to cause postback to the server. The reference string is defined by the specified control that handles the postback and a string argument of additional event information. Optionally, registers the event reference for validation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that, when treated as script on the client, initiates the postback.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The server <see cref="T:System.Web.UI.Control" /> that processes the postback on the server.</param>
         <param name="argument">
@@ -405,7 +435,6 @@
         <Parameter Name="resourceName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -417,6 +446,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a URL reference to a resource in an assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The URL reference to the resource.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the resource. </param>
         <param name="resourceName">
@@ -436,7 +469,6 @@
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -448,6 +480,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the client script block is registered with the <see cref="T:System.Web.UI.Page" /> object using the specified key. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the client script block is registered; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key of the client script block to search for.</param>
       </Docs>
@@ -466,7 +502,6 @@
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -477,6 +512,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the client script block is registered with the <see cref="T:System.Web.UI.Page" /> object using a key and type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the client script block is registered; otherwise, false.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the client script block to search for.  </param>
         <param name="key">
@@ -496,7 +535,6 @@
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this method before calling the <see cref="Overload:System.Web.UI.ClientScriptManager.RegisterClientScriptInclude" /> method to avoid registering duplicate scripts. This is particularly important if the script requires a large amount of server resources to create.</para>
@@ -507,6 +545,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the client script include is registered with the <see cref="T:System.Web.UI.Page" /> object using the specified key. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the client script include is registered; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key of the client script include to search for. </param>
       </Docs>
@@ -525,7 +567,6 @@
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this method before calling the <see cref="Overload:System.Web.UI.ClientScriptManager.RegisterClientScriptInclude" /> method to avoid registering duplicate client script includes. This is particularly important if the script requires a large amount of server resources to create.</para>
@@ -535,6 +576,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the client script include is registered with the <see cref="T:System.Web.UI.Page" /> object using a key and type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the client script include is registered; otherwise, false.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the client script include to search for. </param>
         <param name="key">
@@ -554,7 +599,6 @@
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this method before calling the <see cref="M:System.Web.UI.ClientScriptManager.RegisterOnSubmitStatement(System.Type,System.String,System.String)" /> method to avoid registering duplicate OnSubmit statements. This is particularly important if the statement requires a large amount of server resources to create.</para>
@@ -565,6 +609,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the OnSubmit statement is registered with the <see cref="T:System.Web.UI.Page" /> object using the specified key. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the OnSubmit statement is registered; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key of the OnSubmit statement to search for.</param>
       </Docs>
@@ -583,7 +631,6 @@
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this method before calling the <see cref="M:System.Web.UI.ClientScriptManager.RegisterOnSubmitStatement(System.Type,System.String,System.String)" /> method to avoid registering duplicate statements. This is particularly important if the statement requires a large amount of server resources to create.</para>
@@ -593,6 +640,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the OnSubmit statement is registered with the <see cref="T:System.Web.UI.Page" /> object using the specified key and type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the OnSubmit statement is registered; otherwise, false.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the OnSubmit statement to search for. </param>
         <param name="key">
@@ -612,7 +663,6 @@
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this method before calling the <see cref="Overload:System.Web.UI.ClientScriptManager.RegisterStartupScript" /> method to avoid registering duplicate scripts. This is particularly important if the script requires a large amount of server resources to create.</para>
@@ -623,6 +673,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the startup script is registered with the <see cref="T:System.Web.UI.Page" /> object using the specified key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the startup script is registered; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key of the startup script to search for.</param>
       </Docs>
@@ -641,7 +695,6 @@
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this method before calling the <see cref="Overload:System.Web.UI.ClientScriptManager.RegisterStartupScript" /> method to avoid registering duplicate scripts. This is particularly important if the script requires a large amount of server resources to create.</para>
@@ -651,6 +704,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the startup script is registered with the <see cref="T:System.Web.UI.Page" /> object using the specified key and type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the startup script is registered; otherwise, false.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the startup script to search for. </param>
         <param name="key">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/CompiledBindableTemplateBuilder.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/CompiledBindableTemplateBuilder.xml
index 84da12ce910..dd3e8e8babf 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/CompiledBindableTemplateBuilder.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/CompiledBindableTemplateBuilder.xml
@@ -59,7 +59,6 @@
         <Parameter Name="container" Type="System.Web.UI.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -69,6 +68,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a set of name/value pairs for values bound using two-way ASP.NET data-binding syntax within the templated content.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Specialized.IOrderedDictionary" /> of name/value pairs. The name represents the name of the data item field specified as the first parameter to bind within templated content. The value is the current value of a property value bound using two-way ASP.NET data-binding syntax.</para>
+        </returns>
         <param name="container">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Control" /> from which to extract name/value pairs, which are passed by the data-bound control to an associated data source control in two-way data-binding scenarios.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/Control.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/Control.xml
index 9d8e251aef3..efdf3d5f0d9 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/Control.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/Control.xml
@@ -583,7 +583,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ControlCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Override this method in a custom server control if you have created a collection object that is derived from the <see cref="T:System.Web.UI.ControlCollection" /> class. You can then instantiate that collection class in the override of this method.</para>
@@ -592,6 +591,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Web.UI.ControlCollection" /> object to hold the child controls (both literal and server) of the server control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.ControlCollection" /> object to contain the current server control's child server controls.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -920,7 +923,6 @@
         <Parameter Name="id" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Control'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use <see cref="M:System.Web.UI.Control.FindControl(System.String)" /> to access a control from a function in a code-behind page, to access a control that is inside another container, or in other circumstances where the target control is not directly accessible to the caller. This method will find a control only if the control is directly contained by the specified container; that is, the method does not search throughout a hierarchy of controls within controls. For information about how to find a control when you do not know its immediate container, see <format type="text/html"><a href="59964ef8-72ef-4159-9f1a-5b230ff46fb3">How to: Access Server Controls by ID</a></format>.</para>
@@ -929,6 +931,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the current naming container for a server control with the specified <paramref name="id" /> parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified control, or null if the specified control does not exist.</para>
+        </returns>
         <param name="id">
           <attribution license="cc4" from="Microsoft" modified="false" />The identifier for the control to be found. </param>
       </Docs>
@@ -948,12 +954,15 @@
         <Parameter Name="pathOffset" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Control'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the current naming container for a server control with the specified <paramref name="id" /> and an integer, specified in the <paramref name="pathOffset" /> parameter, which aids in the search. You should not override this version of the <see cref="Overload:System.Web.UI.Control.FindControl" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified control, or null if the specified control does not exist.</para>
+        </returns>
         <param name="id">
           <attribution license="cc4" from="Microsoft" modified="false" />The identifier for the control to be found. </param>
         <param name="pathOffset">
@@ -997,7 +1006,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Control.GetDesignModeState" /> method returns design-time data for a control.</para>
@@ -1006,6 +1014,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets design-time data for a control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IDictionary" /> containing the design-time data for the control.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HasChildViewState">
@@ -1038,7 +1050,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Since this method simply determines if any child controls exist, it can enhance performance by allowing you to avoid an unnecessary <see cref="P:System.Web.UI.ControlCollection.Count" /> property call. Calls to this property require a <see cref="T:System.Web.UI.ControlCollection" /> object to be instantiated. If there are no children, this object creation wastes server resources.</para>
@@ -1047,6 +1058,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the server control contains any child controls.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the control contains other controls; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1064,12 +1079,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether events are registered for the control or any child controls.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if events are registered; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ID">
@@ -1182,7 +1200,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When this method returns true, the server control's collection holds a single literal control.</para>
@@ -1191,6 +1208,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the server control holds only literal content.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the server control contains solely literal content; otherwise false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1357,7 +1378,6 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can only be used by server controls that have permissions to read files and which are part of fully trusted .dll files, such as System.Web.dll. This helps prevent security breaches.</para>
@@ -1366,6 +1386,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the physical path that a virtual path, either absolute or relative, maps to.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The physical path to the requested file.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />A relative or root relative URL. </param>
       </Docs>
@@ -1417,7 +1441,6 @@
         <Parameter Name="args" Type="System.EventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>ASP.NET server controls such as the <see cref="T:System.Web.UI.WebControls.Repeater" />, <see cref="T:System.Web.UI.WebControls.DataList" /> and <see cref="T:System.Web.UI.WebControls.GridView" /> Web controls can contain child controls that raise events. For example, each row in a <see cref="T:System.Web.UI.WebControls.GridView" /> control can contain one or more buttons created dynamically by templates. Rather than each button raising an event individually, events from the nested controls are "bubbled"—that is, they are sent to the naming container. The naming container in turn raises a generic event called <see cref="E:System.Web.UI.WebControls.GridView.RowCommand" /> with parameter values. These values allow you to determine which individual control that raised the original event. By responding to this single event, you can avoid having to write individual event-handling methods for child controls.</para>
@@ -1426,6 +1449,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the event for the server control is passed up the page's UI server control hierarchy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the event has been canceled; otherwise, false. The default is false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The source of the event. </param>
         <param name="args">
@@ -1580,7 +1607,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Control.OpenFile(System.String)" /> method returns a <see cref="T:System.IO.Stream" /> object that can be used to read the contents of the file specified in the <paramref name="path" /> parameter. The path parameter can be either a relative or root URL without a protocol (such as "~/mySite/myFile.txt), or a physical path, either local ("c:\mySite\myFile.txt") or UNC ("\\myServer\myFile.txt").</para>
@@ -1590,6 +1616,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.IO.Stream" /> used to read a file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> that references the desired file.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to the desired file.</param>
       </Docs>
@@ -1856,7 +1886,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>ASP.NET Web pages are viewable across a wide range of devices that are capable of requesting pages from the Web. The <see cref="M:System.Web.UI.Control.ResolveAdapter" /> method returns the control adapter responsible for rendering the control on the specific browser or device that requested the ASP.NET page. </para>
@@ -1867,6 +1896,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the control adapter responsible for rendering the specified control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.Adapters.ControlAdapter" /> that will render the control.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ResolveClientUrl">
@@ -1882,7 +1915,6 @@
         <Parameter Name="relativeUrl" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.Control.ResolveClientUrl(System.String)" /> method to return a URL string suitable for use by the client to access resources on the Web server, such as image files, links to additional pages, and so on.</para>
@@ -1894,6 +1926,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a URL that can be used by the browser.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A fully qualified URL to the specified resource suitable for use on the browser.</para>
+        </returns>
         <param name="relativeUrl">
           <attribution license="cc4" from="Microsoft" modified="false" />A URL relative to the current page.</param>
       </Docs>
@@ -1908,7 +1944,6 @@
         <Parameter Name="relativeUrl" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <paramref name="relativeUrl" /> parameter contains an absolute URL, the URL is returned unchanged. If the <paramref name="relativeUrl" /> parameter contains a relative URL, that URL is changed to a relative URL that is correct for the current request path, so that the browser can resolve the URL.</para>
@@ -1938,6 +1973,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a URL into one that is usable on the requesting client.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted URL.</para>
+        </returns>
         <param name="relativeUrl">
           <attribution license="cc4" from="Microsoft" modified="false" />The URL associated with the <see cref="P:System.Web.UI.Control.TemplateSourceDirectory" /> property. </param>
       </Docs>
@@ -1957,7 +1996,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.Control.SaveControlState" /> method to save state information required for the operation of a specific control. This control-state data is stored separately from the control's view-state data.</para>
@@ -1967,6 +2005,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves any server control state changes that have occurred since the time the page was posted back to the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the server control's current state. If there is no state associated with the control, this method returns null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SaveViewState">
@@ -1977,7 +2019,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>View state is the accumulation of the values of a server control's properties. These values are automatically placed in the server control's <see cref="P:System.Web.UI.Control.ViewState" /> property, which is an instance of the <see cref="T:System.Web.UI.StateBag" /> class. This property's value is then persisted to a string object after the save state stage of the server control life cycle. For more information, see <format type="text/html"><a href="7949d756-1a79-464e-891f-904b1cfc7991">Introduction to the ASP.NET Page Life Cycle</a></format>.</para>
@@ -1987,6 +2028,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves any server control view-state changes that have occurred since the time the page was posted back to the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the server control's current view state. If there is no view state associated with the control, this method returns null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -2149,7 +2194,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.Control" /> instance is cast to an <see cref="T:System.Web.UI.IControlDesignerAccessor" /> interface.</para>
@@ -2158,6 +2202,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Web.UI.IControlDesignerAccessor.GetDesignModeState" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IDictionary" /> of the control state.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IControlDesignerAccessor.SetDesignModeState">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/ControlBuilder.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/ControlBuilder.xml
index fc5932d7e87..9b73ed705d5 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/ControlBuilder.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/ControlBuilder.xml
@@ -56,7 +56,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.ControlBuilder.AllowWhitespaceLiterals" /> method is used to determine whether white space literals are permitted in the content between the opening and closing tags of a control. When this method returns false, the white space literals are trimmed from the content before the content is processed by the page parser. When this method returns true, the white space literals not removed. </para>
@@ -66,6 +65,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether white space literals are permitted in the content between a control's opening and closing tags. This method is called by the ASP.NET page framework.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always returns true.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -150,12 +153,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds a design-time instance of the control that is referred to by this <see cref="T:System.Web.UI.ControlBuilder" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The resulting built control.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CloseControl">
@@ -216,12 +222,15 @@
         <Parameter Name="sourceFileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Web.UI.ControlBuilder" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Web.UI.ControlBuilder" /> object from the specified tag name and object type, as well as other parameters defining the builder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The builder that is responsible for creating the control.</para>
+        </returns>
         <param name="parser">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.TemplateParser" /> object responsible for parsing the control. </param>
         <param name="parentBuilder">
@@ -293,7 +302,6 @@
         <Parameter Name="attribs" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Type" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called by the ASP.NET page framework during parsing and is not intended to be called directly in you code.</para>
@@ -302,6 +310,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains the <see cref="T:System.Type" /> of the control type corresponding to a child tag. This method is called by the ASP.NET page framework.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> of the specified control's child.</para>
+        </returns>
         <param name="tagName">
           <attribution license="cc4" from="Microsoft" modified="false" />The tag name of the child. </param>
         <param name="attribs">
@@ -339,7 +351,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called by the ASP.NET page framework during parsing and is not intended to be called directly in you code.</para>
@@ -348,6 +359,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if a control has both an opening and closing tag. This method is called by the ASP.NET page framework.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the control has an opening and closing tag; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -362,7 +377,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A literal string refers to the text between the opening and closing tag of an HTML control. HTML encoding is when text is converted into a string representation that the browser will display rather than interpret as HTML. Characters such as the question mark (?), ampersand (&amp;), slash mark (/), and spaces might be truncated or corrupted by some browsers, so those characters must be encoded when they appear in a tags or in query strings.</para>
@@ -372,6 +386,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the literal string of an HTML control must be HTML decoded. This method is called by the ASP.NET page framework.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the HTML control literal string is to be decoded; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -485,7 +503,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The inner text is the text between the opening and closing tags of the control.</para>
@@ -495,6 +512,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the control builder needs to get its inner text. If so, the <see cref="M:System.Web.UI.ControlBuilder.SetTagInnerText(System.String)" /> method must be called. This method is called by the ASP.NET page framework.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the control builder needs to get its inner text. The default is false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/ControlBuilderAttribute.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/ControlBuilderAttribute.xml
index a37925f819c..9d34784483d 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/ControlBuilderAttribute.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/ControlBuilderAttribute.xml
@@ -103,12 +103,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the current <see cref="T:System.Web.UI.ControlBuilderAttribute" /> is identical to the specified object. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is a <see cref="T:System.Web.UI.ControlBuilderAttribute" /> and is identical to the current <see cref="T:System.Web.UI.ControlBuilderAttribute" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare to the current <see cref="T:System.Web.UI.ControlBuilderAttribute" />.</param>
       </Docs>
@@ -125,12 +128,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Int32" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code of the <see cref="T:System.Web.UI.ControlBuilderAttribute" /> object. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer representing the hash code; otherwise, 0, if the <see cref="P:System.Web.UI.ControlBuilderAttribute.BuilderType" /> is null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -145,12 +151,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current control builder is the default.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current control builder is the default.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/ControlCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/ControlCollection.xml
index 8ec5ddac3d2..f7fe9386d0c 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/ControlCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/ControlCollection.xml
@@ -138,12 +138,15 @@
         <Parameter Name="c" Type="System.Web.UI.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified server control is in the parent server control's <see cref="T:System.Web.UI.ControlCollection" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified server control exists in the collection; otherwise, false.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The server control to search for in the collection. </param>
       </Docs>
@@ -205,12 +208,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Collections.IEnumerator" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an enumerator that can iterate through the <see cref="T:System.Web.UI.ControlCollection" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The enumerator to iterate through the collection.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -228,7 +234,6 @@
       </Parameters>
       <Docs>
         <param name="c">a <see cref="T:System.Web.UI.Control" /></param>
-        <returns>a <see cref="T:System.Int32" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to determine the index location of the specified server control in the <see cref="T:System.Web.UI.ControlCollection" /> object.</para>
@@ -237,6 +242,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the index of a specified <see cref="T:System.Web.UI.Control" /> object in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified server control. If the server control is not currently a member of the collection, it returns -1.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/ControlValuePropertyAttribute.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/ControlValuePropertyAttribute.xml
index 79b99d52420..62acb9b54fd 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/ControlValuePropertyAttribute.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/ControlValuePropertyAttribute.xml
@@ -219,7 +219,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -240,6 +239,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current instance of the <see cref="T:System.Web.UI.ControlValuePropertyAttribute" /> object is equal to the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object contained in the <paramref name="obj" /> parameter is equal to the current instance of <see cref="T:System.Web.UI.ControlValuePropertyAttribute" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to compare with this instance.</param>
       </Docs>
@@ -255,13 +258,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/DataBinder.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/DataBinder.xml
index 9878146226f..3a480171cf1 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/DataBinder.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/DataBinder.xml
@@ -54,7 +54,6 @@
         <Parameter Name="expression" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The value of the <paramref name="expression" /> parameter must evaluate to a public property. </para>
@@ -70,6 +69,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates data-binding expressions at run time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> instance that results from the evaluation of the data-binding expression.</para>
+        </returns>
         <param name="container">
           <attribution license="cc4" from="Microsoft" modified="false" />The object reference against which the expression is evaluated. This must be a valid object identifier in the page's specified language. </param>
         <param name="expression">
@@ -92,7 +95,6 @@
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The value of <paramref name="expression" /> must evaluate to a public property.</para>
@@ -109,6 +111,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates data-binding expressions at run time and formats the result as a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> object that results from evaluating the data-binding expression and converting it to a string type.</para>
+        </returns>
         <param name="container">
           <attribution license="cc4" from="Microsoft" modified="false" />The object reference against which the expression is evaluated. This must be a valid object identifier in the page's specified language. </param>
         <param name="expression">
@@ -134,7 +140,6 @@
         <Parameter Name="container" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method calls the <see cref="M:System.Web.UI.DataBinder.GetDataItem(System.Object,System.Boolean@)" /> method, ignoring its <paramref name="foundDataItem" /> parameter when returning the result.</para>
@@ -144,6 +149,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an object's declared data item.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the container's declared data item. Returns null if no data item is found or if the container evaluates to null.</para>
+        </returns>
         <param name="container">
           <attribution license="cc4" from="Microsoft" modified="false" />The object reference against which the expression is evaluated. This must be a valid object identifier in the page's specified language.</param>
       </Docs>
@@ -180,7 +189,6 @@
         <Parameter Name="expr" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The value of <paramref name="expr" /> must evaluate to a public property. </para>
@@ -190,6 +198,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the value of a property of the specified container and navigation path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that results from the evaluation of the data-binding expression.</para>
+        </returns>
         <param name="container">
           <attribution license="cc4" from="Microsoft" modified="false" />The object reference against which <paramref name="expr" /> is evaluated. This must be a valid object identifier in the specified language for the page.</param>
         <param name="expr">
@@ -213,7 +225,6 @@
       </Parameters>
       <Docs>
         <param name="expr">a <see cref="T:System.String" /></param>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.DataBinder.GetIndexedPropertyValue(System.Object,System.String,System.String)" /> method invokes the <see cref="M:System.Web.UI.DataBinder.GetIndexedPropertyValue(System.Object,System.String)" /> method, and then uses the <see cref="M:System.String.Format(System.String,System.Object)" /> method to format the result as specified in the <paramref name="format" /> parameter. A .NET Framework format string (like those used by <see cref="M:System.String.Format(System.String,System.Object)" />) converts the <see cref="T:System.Object" /> instance returned by the data-binding expression to a <see cref="T:System.String" /> object. </para>
@@ -223,6 +234,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the value of the specified property for the specified container, and then formats the results.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified property in the format specified by <paramref name="format" />.</para>
+        </returns>
         <param name="container">
           <attribution license="cc4" from="Microsoft" modified="false" />The object reference against which the expression is evaluated. This must be a valid object identifier in the specified language for the page.</param>
         <param name="format">
@@ -244,7 +259,6 @@
         <Parameter Name="propName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.DataBinder.GetPropertyValue(System.Object,System.String)" /> method is used to retrieve the value of a property in an object.</para>
@@ -253,6 +267,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the value of the specified property of the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified property.</para>
+        </returns>
         <param name="container">
           <attribution license="cc4" from="Microsoft" modified="false" />The object that contains the property. </param>
         <param name="propName">
@@ -275,7 +293,6 @@
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This version of the <see cref="M:System.Web.UI.DataBinder.GetPropertyValue(System.Object,System.String,System.String)" /> method is used to retrieve and format the value of a property in an object.</para>
@@ -284,6 +301,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the value of the specified property of the specified object, and then formats the results.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified property in the format specified by <paramref name="format" />.</para>
+        </returns>
         <param name="container">
           <attribution license="cc4" from="Microsoft" modified="false" />The object that contains the property. </param>
         <param name="propName">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/DataBinding.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/DataBinding.xml
index e09a6b3e0d5..8c01d28bb05 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/DataBinding.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/DataBinding.xml
@@ -61,12 +61,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified object is the same instance of the <see cref="T:System.Web.UI.DataBinding" /> class as the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the data-binding property names match; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare against the current <see cref="T:System.Web.UI.DataBinding" />. </param>
       </Docs>
@@ -103,7 +106,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Int32" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -113,6 +115,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the hash code for an instance of the <see cref="T:System.Web.UI.DataBinding" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/DataBindingCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/DataBindingCollection.xml
index 18e3986faf6..7a7902a832e 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/DataBindingCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/DataBindingCollection.xml
@@ -120,12 +120,15 @@
         <Parameter Name="propertyName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the data-binding collection contains a specific <see cref="T:System.Web.UI.DataBinding" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.UI.DataBindingCollection" /> contains an element with the specified name; otherwise, false.</para>
+        </returns>
         <param name="propertyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the object to locate in the collection.</param>
       </Docs>
@@ -183,12 +186,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Collections.IEnumerator" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator to iterate through the <see cref="T:System.Web.UI.DataBindingCollection" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that contains the collection's members.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/DataBindingHandlerAttribute.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/DataBindingHandlerAttribute.xml
index eb767bbe709..4b749456324 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/DataBindingHandlerAttribute.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/DataBindingHandlerAttribute.xml
@@ -131,12 +131,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two object instances are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="obj" /> parameter equals the <see cref="T:System.Web.UI.DataBindingHandlerAttribute" /> object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to the current <see cref="T:System.Web.UI.DataBindingHandlerAttribute" />.</param>
       </Docs>
@@ -153,12 +156,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HandlerTypeName">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/DataSourceControl.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/DataSourceControl.xml
index fbc9f6a9414..760a213bfcb 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/DataSourceControl.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/DataSourceControl.xml
@@ -148,7 +148,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -160,6 +159,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a collection to store child controls.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a <see cref="T:System.Web.UI.EmptyControlCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -208,13 +211,16 @@
         <Parameter Name="id" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the current naming container for a server control with the specified <paramref name="id" /> parameter. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified control, or null if the specified control does not exist.</para>
+        </returns>
         <param name="id">
           <attribution license="cc4" from="Microsoft" modified="false" />The identifier for the control to be found.</param>
       </Docs>
@@ -264,7 +270,6 @@
         <Parameter Name="viewName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -278,6 +283,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the named data source view associated with the data source control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the named <see cref="T:System.Web.UI.DataSourceView" /> associated with the <see cref="T:System.Web.UI.DataSourceControl" />.</para>
+        </returns>
         <param name="viewName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Web.UI.DataSourceView" /> to retrieve. In data source controls that support only one view, such as <see cref="T:System.Web.UI.WebControls.SqlDataSource" />, this parameter is ignored. </param>
       </Docs>
@@ -293,7 +302,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -307,6 +315,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of names, representing the list of <see cref="T:System.Web.UI.DataSourceView" /> objects associated with the <see cref="T:System.Web.UI.DataSourceControl" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.ICollection" /> that contains the names of the <see cref="T:System.Web.UI.DataSourceView" /> objects associated with the <see cref="T:System.Web.UI.DataSourceControl" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -320,13 +332,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the server control contains any child controls. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the control contains other controls; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -457,7 +472,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is used to retrieve a set of objects that can be used as sources of data. Data source controls encapsulate their lists of data as <see cref="T:System.Web.UI.DataSourceView" /> objects; therefore, when associated with one or more <see cref="T:System.Web.UI.DataSourceView" /> objects, a <see cref="T:System.Web.UI.DataSourceControl" /> control represents a list source object and the method returns an <see cref="T:System.Collections.IList" /> collection of one element, the <see cref="T:System.Web.UI.DataSourceControl" /> itself.</para>
@@ -467,6 +481,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a list of data source controls that can be used as sources of lists of data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IList" /> of data source controls that can be used as sources of lists of data.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IDataSource.GetView">
@@ -482,7 +500,6 @@
         <Parameter Name="viewName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="viewName" /> parameter is ignored when this method is called on data source controls that support only one view, such as the <see cref="T:System.Web.UI.WebControls.SqlDataSource" /> and <see cref="T:System.Web.UI.WebControls.AccessDataSource" /> controls.</para>
@@ -494,6 +511,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the named <see cref="T:System.Web.UI.DataSourceView" /> object associated with the <see cref="T:System.Web.UI.DataSourceControl" /> control. Some data source controls support only one view, while others support more than one.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the named <see cref="T:System.Web.UI.DataSourceView" /> associated with the <see cref="T:System.Web.UI.DataSourceControl" />.</para>
+        </returns>
         <param name="viewName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Web.UI.DataSourceView" /> to retrieve. In data source controls that support only one view, such as <see cref="T:System.Web.UI.WebControls.SqlDataSource" />, this parameter is ignored.</param>
       </Docs>
@@ -509,7 +530,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -520,6 +540,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of names, representing the list of <see cref="T:System.Web.UI.DataSourceView" /> objects associated with the <see cref="T:System.Web.UI.DataSourceControl" /> control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.ICollection" /> that contains the names of the <see cref="T:System.Web.UI.DataSourceView" /> objects associated with the <see cref="T:System.Web.UI.DataSourceControl" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Visible">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/DataSourceSelectArguments.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/DataSourceSelectArguments.xml
index 8161ec68b6b..a8aac82b238 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/DataSourceSelectArguments.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/DataSourceSelectArguments.xml
@@ -222,7 +222,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -232,6 +231,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Web.UI.DataSourceSelectArguments" /> instance is equal to the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Web.UI.DataSourceSelectArguments" /> is equal to the current instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.DataSourceSelectArguments" /> to compare with the current one.</param>
       </Docs>
@@ -247,13 +250,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for the <see cref="T:System.Web.UI.DataSourceSelectArguments" /> type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the <see cref="T:System.Web.UI.DataSourceSelectArguments" /> type.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/DataSourceView.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/DataSourceView.xml
index f5fa99de708..47b7905cf8e 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/DataSourceView.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/DataSourceView.xml
@@ -265,7 +265,6 @@
       </Parameters>
       <Docs>
         <param name="values">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -279,6 +278,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a delete operation on the list of data that the <see cref="T:System.Web.UI.DataSourceView" /> object represents.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of items that were deleted from the underlying data storage.</para>
+        </returns>
         <param name="keys">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.IDictionary" /> of object or row keys to be deleted by the <see cref="M:System.Web.UI.DataSourceView.ExecuteDelete(System.Collections.IDictionary,System.Collections.IDictionary)" /> operation.</param>
       </Docs>
@@ -297,7 +300,6 @@
       </Parameters>
       <Docs>
         <param name="keys">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -311,6 +313,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs an insert operation on the list of data that the <see cref="T:System.Web.UI.DataSourceView" /> object represents.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of items that were inserted into the underlying data storage.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -329,7 +335,6 @@
         <Parameter Name="arguments" Type="System.Web.UI.DataSourceSelectArguments" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.DataSourceView.ExecuteSelect(System.Web.UI.DataSourceSelectArguments)" /> method is called to retrieve data from the underlying data store and return it as an <see cref="T:System.Collections.IEnumerable" /> object. All data source controls support data retrieval from their underlying data storage, even if other operations such as insertion and sorting are not supported. Because a data-bound control can request a list of data at any time as a result of a <see cref="E:System.Web.UI.IDataSource.DataSourceChanged" /> event or a <see cref="M:System.Web.UI.WebControls.BaseDataBoundControl.DataBind" /> method call, the data retrieval must be performed on demand.</para>
@@ -338,6 +343,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a list of data from the underlying data storage.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerable" /> list of data from the underlying data storage.</para>
+        </returns>
         <param name="arguments">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.DataSourceSelectArguments" /> that is used to request operations on the data beyond basic data retrieval.</param>
       </Docs>
@@ -354,7 +363,6 @@
         <Parameter Name="oldValues" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -368,6 +376,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs an update operation on the list of data that the <see cref="T:System.Web.UI.DataSourceView" /> object represents.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of items that were updated in the underlying data storage.</para>
+        </returns>
         <param name="keys">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.IDictionary" /> of object or row keys to be updated by the update operation.</param>
         <param name="values">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/DesignTimeTemplateParser.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/DesignTimeTemplateParser.xml
index 29de5512df8..20ce219779e 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/DesignTimeTemplateParser.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/DesignTimeTemplateParser.xml
@@ -34,12 +34,15 @@
         <Parameter Name="data" Type="System.Web.UI.DesignTimeParseData" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Control'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Parses and builds one control at design time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The built <see cref="T:System.Web.UI.Control" /> object.</para>
+        </returns>
         <param name="data">
           <attribution license="cc4" from="Microsoft" modified="false" />Information used in creating the parser.</param>
       </Docs>
@@ -61,12 +64,15 @@
         <Parameter Name="data" Type="System.Web.UI.DesignTimeParseData" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Parses and builds one or more controls at design time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of built <see cref="T:System.Web.UI.Control" /> objects.</para>
+        </returns>
         <param name="data">
           <attribution license="cc4" from="Microsoft" modified="false" />Information used in creating the parser.</param>
       </Docs>
@@ -81,12 +87,15 @@
         <Parameter Name="data" Type="System.Web.UI.DesignTimeParseData" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ITemplate'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Parses a template at design time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.UI.RootBuilder" /> from the parser that parsed the template.</para>
+        </returns>
         <param name="data">
           <attribution license="cc4" from="Microsoft" modified="false" />Information used in creating the parser.</param>
       </Docs>
@@ -110,12 +119,15 @@
         <Parameter Name="themePath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Parses a theme at design time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.UI.RootBuilder" /> from the parser that parsed the theme.</para>
+        </returns>
         <param name="host">
           <attribution license="cc4" from="Microsoft" modified="false" />Manages designer components.</param>
         <param name="theme">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/ExpressionBinding.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/ExpressionBinding.xml
index a3ae87c6998..75f6fbe672f 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/ExpressionBinding.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/ExpressionBinding.xml
@@ -57,13 +57,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified object is the same instance as the current <see cref="T:System.Web.UI.ExpressionBinding" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified object is the same instance as the current <see cref="T:System.Web.UI.ExpressionBinding" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current <see cref="T:System.Web.UI.ExpressionBinding" />.</param>
       </Docs>
@@ -136,13 +139,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for the current <see cref="T:System.Web.UI.ExpressionBinding" /> object; suitable for hashing algorithms and data structures, such as a hash table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.Web.UI.ExpressionBinding" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/ExpressionBindingCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/ExpressionBindingCollection.xml
index e50b9245ad2..ebe80e71caa 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/ExpressionBindingCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/ExpressionBindingCollection.xml
@@ -112,13 +112,16 @@
       </Parameters>
       <Docs>
         <param name="propertyName">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Web.UI.ExpressionBindingCollection" /> collection contains a specific <see cref="T:System.Web.UI.ExpressionBinding" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.UI.ExpressionBinding" /> is found in the <see cref="T:System.Web.UI.ExpressionBindingCollection" />; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -202,13 +205,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IEnumerator" />-implemented object that can be used to iterate through the <see cref="T:System.Web.UI.ExpressionBinding" /> objects in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" />-implemented object that contains all the <see cref="T:System.Web.UI.ExpressionBinding" /> objects in the <see cref="T:System.Web.UI.ExpressionBindingCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/FilterableAttribute.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/FilterableAttribute.xml
index 97961c26a6e..687ced8fb55 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/FilterableAttribute.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/FilterableAttribute.xml
@@ -107,7 +107,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -128,6 +127,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current instance of the <see cref="T:System.Web.UI.FilterableAttribute" /> class is equal to the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object contained in the <paramref name="obj" /> parameter is equal to the current instance of the <see cref="T:System.Web.UI.FilterableAttribute" /> object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to compare with this instance.</param>
       </Docs>
@@ -165,13 +168,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -185,7 +191,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -195,6 +200,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current instance of the <see cref="T:System.Web.UI.FilterableAttribute" /> class is equal to the <see cref="F:System.Web.UI.FilterableAttribute.Default" /> attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current instance of <see cref="T:System.Web.UI.FilterableAttribute" /> is equal to <see cref="F:System.Web.UI.FilterableAttribute.Default" />; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -211,7 +220,6 @@
       </Parameters>
       <Docs>
         <param name="obj">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -224,6 +232,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> supports device filtering.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Object" /> contained in the <paramref name="instance" /> parameter supports device filtering; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -240,7 +252,6 @@
       </Parameters>
       <Docs>
         <param name="propDesc">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -250,6 +261,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a property supports device filtering.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property represented by the <see cref="T:System.ComponentModel.PropertyDescriptor" /> object contained in the <paramref name="propertyDescriptor" /> parameter supports device filtering; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -265,7 +280,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -275,6 +289,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified data type supports device filtering.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the data type contained in the <paramref name="type" /> parameter supports device filtering; otherwise, false.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents the data type to test.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/HierarchicalDataSourceControl.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/HierarchicalDataSourceControl.xml
index e3248d64c7d..d61b317a4ee 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/HierarchicalDataSourceControl.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/HierarchicalDataSourceControl.xml
@@ -67,7 +67,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -77,6 +76,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Web.UI.ControlCollection" /> object to hold the child controls (both literal and server) of the server control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.EmptyControlCollection" /> that prevents any child controls from being added.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -125,13 +128,16 @@
         <Parameter Name="id" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the current naming container for a server control with the specified <paramref name="id" /> parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified control, or null if the specified control does not exist.</para>
+        </returns>
         <param name="id">
           <attribution license="cc4" from="Microsoft" modified="false" />The identifier for the control to be found.</param>
       </Docs>
@@ -181,7 +187,6 @@
         <Parameter Name="viewPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -191,6 +196,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the view helper object for the <see cref="T:System.Web.UI.IHierarchicalDataSource" /> interface for the specified path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.HierarchicalDataSourceView" /> that represents a single view of the data at the hierarchical level identified by the <paramref name="viewPath" /> parameter.</para>
+        </returns>
         <param name="viewPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The hierarchical path of the view to retrieve. </param>
       </Docs>
@@ -206,13 +215,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the server control contains any child controls.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the control contains other controls; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -322,7 +334,6 @@
         <Parameter Name="viewPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.IHierarchicalDataSource.GetHierarchicalView(System.String)" /> method is called by clients when a <see cref="T:System.Web.UI.HierarchicalDataSourceControl" /> is manipulated as an <see cref="T:System.Web.UI.IHierarchicalDataSource" /> interface. It delegates to the <see cref="M:System.Web.UI.HierarchicalDataSourceControl.GetHierarchicalView(System.String)" /> method, which derived classes override to return strongly typed <see cref="T:System.Web.UI.HierarchicalDataSourceView" /> objects.</para>
@@ -331,6 +342,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the view helper object for the <see cref="T:System.Web.UI.IHierarchicalDataSource" /> interface for the specified path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a <see cref="T:System.Web.UI.HierarchicalDataSourceView" /> that represents a single view of the data at the hierarchical level identified by the <paramref name="viewPath" /> parameter.</para>
+        </returns>
         <param name="viewPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The hierarchical path of the view to retrieve. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/HierarchicalDataSourceView.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/HierarchicalDataSourceView.xml
index f1176aef0ac..caa1eb6b27f 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/HierarchicalDataSourceView.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/HierarchicalDataSourceView.xml
@@ -47,7 +47,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -57,6 +56,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a list of all the data items in the view.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.IHierarchicalEnumerable" /> collection of data items.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/Html32TextWriter.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/Html32TextWriter.xml
index 130a5b94a21..695370a8bb9 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/Html32TextWriter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/Html32TextWriter.xml
@@ -113,7 +113,6 @@
         <Parameter Name="tagKey" Type="System.Web.UI.HtmlTextWriterTag" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="F:System.Web.UI.HtmlTextWriterTag.Div" /> field is passed in <paramref name="tagKey" /> and the <see cref="P:System.Web.UI.Html32TextWriter.ShouldPerformDivTableSubstitution" /> property is true, the <see cref="M:System.Web.UI.Html32TextWriter.GetTagName(System.Web.UI.HtmlTextWriterTag)" /> method returns the table element.</para>
@@ -122,6 +121,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the HTML element that is associated with the specified <see cref="T:System.Web.UI.HtmlTextWriterTag" /> enumeration value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The HTML element.</para>
+        </returns>
         <param name="tagKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.HtmlTextWriterTag" /> enumeration value to obtain the HTML element for. </param>
       </Docs>
@@ -142,7 +145,6 @@
         <Parameter Name="key" Type="System.Web.UI.HtmlTextWriterStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Html32TextWriter.OnStyleAttributeRender(System.String,System.String,System.Web.UI.HtmlTextWriterStyle)" /> method supports a smaller number of HTML style attributes than the <see cref="M:System.Web.UI.Html32TextWriter.OnStyleAttributeRender(System.String,System.String,System.Web.UI.HtmlTextWriterStyle)" /> method that it overrides.</para>
@@ -151,6 +153,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether to write the specified HTML style attribute and its value to the output stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the HTML style attribute and its value will be rendered to the output stream; otherwise, false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The HTML style attribute to write to the output stream. </param>
         <param name="value">
@@ -174,7 +180,6 @@
         <Parameter Name="key" Type="System.Web.UI.HtmlTextWriterTag" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="P:System.Web.UI.Html32TextWriter.ShouldPerformDivTableSubstitution" /> property is true, the <see cref="M:System.Web.UI.Html32TextWriter.OnTagRender(System.String,System.Web.UI.HtmlTextWriterTag)" /> method replaces any div elements that are rendered by a control with table elements.</para>
@@ -183,6 +188,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether to write the specified HTML element to the output stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the HTML element is written to the output stream; otherwise, false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The HTML element to write to the output stream. </param>
         <param name="key">
@@ -201,12 +210,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes any text or spacing that appears after the content of the HTML element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The spacing or text to write after the content of the HTML element; otherwise, if there is no such information to render, null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -221,12 +233,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes any spacing or text that occurs after an HTML element's closing tag.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The spacing or text to write after the closing tag of the HTML element; otherwise, if there is no such information to render, null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -241,12 +256,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes any tab spacing or font information that appears before the content that is contained in an HTML element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The font information or spacing to write before rendering the content of the HTML element; otherwise, if there is no such information to render, null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -261,12 +279,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes any text or tab spacing that occurs before the opening tag of an HTML element to the HTML 3.2 output stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The HTML font and spacing information to render before the tag; otherwise, if there is no such information to render, null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/HtmlTextWriter.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/HtmlTextWriter.xml
index 9485362e4e8..efee2db05c3 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/HtmlTextWriter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/HtmlTextWriter.xml
@@ -517,7 +517,6 @@
         <Parameter Name="fEncode" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.HtmlTextWriter.EncodeAttributeValue(System.String,System.Boolean)" /> overload of the <see cref="M:System.Web.UI.HtmlTextWriter.EncodeAttributeValue(System.Web.UI.HtmlTextWriterAttribute,System.String)" /> method if the attribute is not an <see cref="T:System.Web.UI.HtmlTextWriterAttribute" /> enumeration value or is not known until run time.</para>
@@ -527,6 +526,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes the value of the specified markup attribute based on the requirements of the <see cref="T:System.Web.HttpRequest" /> object of the current context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the encoded attribute value, null if <paramref name="value" /> is empty, or the unencoded attribute value if <paramref name="fEncode" /> is false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string containing the attribute value to encode. </param>
         <param name="fEncode">
@@ -548,7 +551,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.HtmlTextWriter.EncodeAttributeValue(System.Web.UI.HtmlTextWriterAttribute,System.String)" /> method removes double quotation marks ("), ampersands (&amp;), and less than signs (&lt;) so that invalid tags are not generated, regardless of the input. The actual encoding is performed by the <see cref="M:System.Web.HttpUtility.HtmlAttributeEncode(System.String)" /> method.</para>
@@ -557,6 +559,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes the value of the specified markup attribute based on the requirements of the <see cref="T:System.Web.HttpRequest" /> object of the current context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the encoded attribute value.</para>
+        </returns>
         <param name="attrKey">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Web.UI.HtmlTextWriterAttribute" /> representing the markup attribute. </param>
         <param name="value">
@@ -577,7 +583,6 @@
         <Parameter Name="url" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>URL encoding of a character consists of a percent symbol (%), followed by the two-digit hexadecimal representation (case-insensitive) of the ISO-Latin code point for the character. The hexadecimal representation of a space is 20.</para>
@@ -586,6 +591,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs minimal URL encoding by converting spaces in the specified URL to the string "%20".</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the encoded URL.</para>
+        </returns>
         <param name="url">
           <attribution license="cc4" from="Microsoft" modified="false" />A string containing the URL to encode. </param>
       </Docs>
@@ -871,7 +880,6 @@
         <Parameter Name="attrName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'HtmlTextWriterAttribute'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="attrName" /> is null or an empty string (""), or cannot be found in the table of attribute names, the value -1, typed to an <see cref="T:System.Web.UI.HtmlTextWriterAttribute" /> object, is returned.</para>
@@ -880,6 +888,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains the corresponding <see cref="T:System.Web.UI.HtmlTextWriterAttribute" /> enumeration value for the specified attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.UI.HtmlTextWriterAttribute" /> enumeration value for the specified attribute; otherwise, an invalid <see cref="T:System.Web.UI.HtmlTextWriterAttribute" /> value if the attribute is not a member of the enumeration.</para>
+        </returns>
         <param name="attrName">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the attribute for which to obtain the <see cref="T:System.Web.UI.HtmlTextWriterAttribute" />. </param>
       </Docs>
@@ -898,7 +910,6 @@
         <Parameter Name="attrKey" Type="System.Web.UI.HtmlTextWriterAttribute" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.HtmlTextWriter.GetAttributeName(System.Web.UI.HtmlTextWriterAttribute)" /> method returns an empty string (""), if <paramref name="attrKey" /> is not a valid <see cref="T:System.Web.UI.HtmlTextWriterAttribute" /> value.</para>
@@ -907,6 +918,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains the name of the markup attribute associated with the specified <see cref="T:System.Web.UI.HtmlTextWriterAttribute" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the name of the markup attribute.</para>
+        </returns>
         <param name="attrKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.HtmlTextWriterAttribute" /> to obtain the markup attribute name for. </param>
       </Docs>
@@ -925,7 +940,6 @@
         <Parameter Name="styleName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'HtmlTextWriterStyle'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.HtmlTextWriter.GetStyleKey(System.String)" /> method returns the value -1 typed as a <see cref="T:System.Web.UI.HtmlTextWriterStyle" /> value, if <paramref name="styleName" /> does not correspond to any <see cref="T:System.Web.UI.HtmlTextWriterStyle" /> enumeration value.</para>
@@ -934,6 +948,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains the <see cref="T:System.Web.UI.HtmlTextWriterStyle" /> enumeration value for the specified style.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.UI.HtmlTextWriterStyle" /> enumeration value corresponding to <paramref name="styleName" />.</para>
+        </returns>
         <param name="styleName">
           <attribution license="cc4" from="Microsoft" modified="false" />The style attribute for which to obtain the <see cref="T:System.Web.UI.HtmlTextWriterStyle" />. </param>
       </Docs>
@@ -952,7 +970,6 @@
         <Parameter Name="styleKey" Type="System.Web.UI.HtmlTextWriterStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="styleKey" /> is not a valid <see cref="T:System.Web.UI.HtmlTextWriterStyle" /> object, the <see cref="M:System.Web.UI.HtmlTextWriter.GetStyleName(System.Web.UI.HtmlTextWriterStyle)" /> method returns an empty string ("").</para>
@@ -961,6 +978,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains the markup style attribute name associated with the specified <see cref="T:System.Web.UI.HtmlTextWriterStyle" /> enumeration value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The style attribute name associated with the <see cref="T:System.Web.UI.HtmlTextWriterStyle" /> enumeration value specified in <paramref name="styleKey" />.</para>
+        </returns>
         <param name="styleKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.HtmlTextWriterStyle" /> to obtain the style attribute name for. </param>
       </Docs>
@@ -979,7 +1000,6 @@
         <Parameter Name="tagName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'HtmlTextWriterTag'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="tagName" /> is null, an empty string (""), or cannot be found in the table of markup tag names, the <see cref="M:System.Web.UI.HtmlTextWriter.GetTagKey(System.String)" /> method returns the <see cref="F:System.Web.UI.HtmlTextWriterTag.Unknown" /> field.</para>
@@ -988,6 +1008,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains the <see cref="T:System.Web.UI.HtmlTextWriterTag" /> enumeration value associated with the specified markup element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.UI.HtmlTextWriterTag" /> enumeration value; otherwise, if <paramref name="tagName" /> is not associated with a specific <see cref="T:System.Web.UI.HtmlTextWriterTag" /> value, <see cref="F:System.Web.UI.HtmlTextWriterTag.Unknown" />.</para>
+        </returns>
         <param name="tagName">
           <attribution license="cc4" from="Microsoft" modified="false" />The markup element for which to obtain the <see cref="T:System.Web.UI.HtmlTextWriterTag" />. </param>
       </Docs>
@@ -1006,7 +1030,6 @@
         <Parameter Name="tagKey" Type="System.Web.UI.HtmlTextWriterTag" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="tagKey" /> is not a valid <see cref="T:System.Web.UI.HtmlTextWriterTag" /> value, the <see cref="M:System.Web.UI.HtmlTextWriter.GetTagName(System.Web.UI.HtmlTextWriterTag)" /> method returns an empty string ("").</para>
@@ -1015,6 +1038,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains the markup element associated with the specified <see cref="T:System.Web.UI.HtmlTextWriterTag" /> enumeration value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representing the markup element.</para>
+        </returns>
         <param name="tagKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.HtmlTextWriterTag" /> to obtain the markup element for. </param>
       </Docs>
@@ -1081,7 +1108,6 @@
         <Parameter Name="key" Type="System.Web.UI.HtmlTextWriterAttribute" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To obtain the value to be assigned to the <see cref="T:System.Web.UI.HtmlTextWriterAttribute" /> object, use the <see cref="M:System.Web.UI.HtmlTextWriter.IsAttributeDefined(System.Web.UI.HtmlTextWriterAttribute,System.String@)" /> overload instead of this one.</para>
@@ -1090,6 +1116,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified markup attribute and its value are rendered during the next call to the <see cref="Overload:System.Web.UI.HtmlTextWriter.RenderBeginTag" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute is rendered during the next call to the <see cref="Overload:System.Web.UI.HtmlTextWriter.RenderBeginTag" /> method; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.HtmlTextWriterAttribute" /> associated with the markup attribute. </param>
       </Docs>
@@ -1130,7 +1160,6 @@
         <Parameter Name="key" Type="System.Web.UI.HtmlTextWriterStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To get the value that will be rendered with the specified style attribute, use the <see cref="M:System.Web.UI.HtmlTextWriter.IsStyleAttributeDefined(System.Web.UI.HtmlTextWriterStyle,System.String@)" /> overload of the <see cref="M:System.Web.UI.HtmlTextWriter.IsStyleAttributeDefined(System.Web.UI.HtmlTextWriterStyle)" /> method.</para>
@@ -1139,6 +1168,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified markup style attribute is rendered during the next call to the <see cref="Overload:System.Web.UI.HtmlTextWriter.RenderBeginTag" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute will be rendered during the next call to the <see cref="Overload:System.Web.UI.HtmlTextWriter.RenderBeginTag" /> method; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.HtmlTextWriterStyle" /> associated with the attribute. </param>
       </Docs>
@@ -1182,7 +1215,6 @@
         <Parameter Name="attribute" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Web.UI.HtmlTextWriter" /> class implementation of the <see cref="M:System.Web.UI.HtmlTextWriter.IsValidFormAttribute(System.String)" /> method returns true for all attributes. Override the <see cref="M:System.Web.UI.HtmlTextWriter.IsValidFormAttribute(System.String)" /> to limit the attributes that can be rendered in the opening tag of a &lt;form&gt; element.</para>
@@ -1191,6 +1223,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks an attribute to ensure that it can be rendered in the opening tag of a &lt;form&gt; markup element. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always true.</para>
+        </returns>
         <param name="attribute">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the name of the attribute to check. </param>
       </Docs>
@@ -1231,7 +1267,6 @@
         <Parameter Name="key" Type="System.Web.UI.HtmlTextWriterAttribute" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Web.UI.HtmlTextWriter" /> class implementation of the <see cref="M:System.Web.UI.HtmlTextWriter.OnAttributeRender(System.String,System.String,System.Web.UI.HtmlTextWriterAttribute)" /> method always returns true. The <see cref="M:System.Web.UI.HtmlTextWriter.OnAttributeRender(System.String,System.String,System.Web.UI.HtmlTextWriterAttribute)" /> overrides can determine whether an attribute will be rendered to the page. </para>
@@ -1240,6 +1275,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified markup attribute and its value can be rendered to the current markup element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always true.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />A string containing the name of the attribute to render. </param>
         <param name="value">
@@ -1264,7 +1303,6 @@
         <Parameter Name="key" Type="System.Web.UI.HtmlTextWriterStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Web.UI.HtmlTextWriter" /> class implementation of the <see cref="M:System.Web.UI.HtmlTextWriter.OnStyleAttributeRender(System.String,System.String,System.Web.UI.HtmlTextWriterStyle)" /> method always returns true. The <see cref="M:System.Web.UI.HtmlTextWriter.OnStyleAttributeRender(System.String,System.String,System.Web.UI.HtmlTextWriterStyle)" /> overrides can determine whether a style attribute will be rendered to the page. </para>
@@ -1273,6 +1311,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified markup style attribute and its value can be rendered to the current markup element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always true.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />A string containing the name of the style attribute to render. </param>
         <param name="value">
@@ -1296,7 +1338,6 @@
         <Parameter Name="key" Type="System.Web.UI.HtmlTextWriterTag" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Web.UI.HtmlTextWriter" /> class implementation of the <see cref="M:System.Web.UI.HtmlTextWriter.OnTagRender(System.String,System.Web.UI.HtmlTextWriterTag)" /> method always returns true. The <see cref="M:System.Web.UI.HtmlTextWriter.OnTagRender(System.String,System.Web.UI.HtmlTextWriterTag)" /> overrides can determine whether an element will be rendered to the page. </para>
@@ -1305,6 +1346,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified markup element will be rendered to the requesting page.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always true.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />A string containing the name of the element to render. </param>
         <param name="key">
@@ -1346,7 +1391,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Elements are added to the list of rendered markup elements by the <see cref="Overload:System.Web.UI.HtmlTextWriter.RenderBeginTag" /> method. The <see cref="M:System.Web.UI.HtmlTextWriter.RenderEndTag" /> method removes markup elements from the list by calling the <see cref="M:System.Web.UI.HtmlTextWriter.PopEndTag" /> method.</para>
@@ -1355,6 +1399,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the most recently saved markup element from the list of rendered elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the most recently rendered markup element.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1485,7 +1533,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.HtmlTextWriter.RenderAfterContent" /> method can be useful if you want to insert child elements into the current markup element.</para>
@@ -1494,6 +1541,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes any text or spacing that occurs after the content and before the closing tag of the markup element to the markup output stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the spacing or text to write after the content of the element. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1508,7 +1559,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.HtmlTextWriter.RenderAfterTag" /> method can be useful if you want to render additional closing tags after the element tag.</para>
@@ -1517,6 +1567,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes any spacing or text that occurs after the closing tag for a markup element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The spacing or text to write after the closing tag of the element. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1531,7 +1585,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.HtmlTextWriter.RenderBeforeContent" /> method can be useful if you want to insert child elements into the current markup element before the inner markup.</para>
@@ -1540,6 +1593,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes any text or spacing before the content and after the opening tag of a markup element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The text or spacing to write prior to the content of the element. If not overridden, <see cref="M:System.Web.UI.HtmlTextWriter.RenderBeforeContent" /> returns null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1554,7 +1611,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.HtmlTextWriter.RenderBeforeTag" /> method can be useful if you want to render additional opening tags before the opening tag of the intended element.</para>
@@ -1563,6 +1619,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes any text or spacing that occurs before the opening tag of a markup element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The text or spacing to write before the markup element opening tag. If not overridden, null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/IAttributeAccessor.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/IAttributeAccessor.xml
index 27784ee0134..4444bee34d4 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/IAttributeAccessor.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/IAttributeAccessor.xml
@@ -32,12 +32,15 @@
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented by a class, retrieves the specified attribute property from the server control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified attribute.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that represents the name of the server control attribute. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/IAutoFieldGenerator.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/IAutoFieldGenerator.xml
index 9c7e5336e49..93524839657 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/IAutoFieldGenerator.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/IAutoFieldGenerator.xml
@@ -35,12 +35,15 @@
         <Parameter Name="control" Type="System.Web.UI.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Automatically generates <see cref="T:System.Web.DynamicData.DynamicField" /> objects based on metadata information for the table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of <see cref="T:System.Web.DynamicData.DynamicField" /> objects.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The data-bound control that will contain the <see cref="T:System.Web.DynamicData.DynamicField" /> objects.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/IBindableTemplate.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/IBindableTemplate.xml
index 788ab2c5195..1f8c7d3eb33 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/IBindableTemplate.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/IBindableTemplate.xml
@@ -84,13 +84,16 @@
       </Parameters>
       <Docs>
         <param name="control">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented by a class, retrieves a set of name/value pairs for values bound using two-way ASP.NET data-binding syntax within the templated content.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Specialized.IOrderedDictionary" /> of name/value pairs. The name represents the name of a control within templated content, and the value is the current value of a property value bound using two-way ASP.NET data-binding syntax.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/ICallbackEventHandler.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/ICallbackEventHandler.xml
index 9f081bc87e6..d563ae73a9e 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/ICallbackEventHandler.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/ICallbackEventHandler.xml
@@ -29,7 +29,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -39,6 +38,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the results of a callback event that targets a control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of the callback.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/IControlDesignerAccessor.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/IControlDesignerAccessor.xml
index 7abdb328751..d0da071e7a4 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/IControlDesignerAccessor.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/IControlDesignerAccessor.xml
@@ -27,7 +27,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -37,6 +36,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented, gets the state from the control during use on the design surface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IDictionary" /> of the control state.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/IDataSource.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/IDataSource.xml
index 88ed246fd07..6256da4d746 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/IDataSource.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/IDataSource.xml
@@ -54,7 +54,6 @@
         <Parameter Name="viewName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -65,6 +64,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the named data source view associated with the data source control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the named <see cref="T:System.Web.UI.DataSourceView" /> associated with the <see cref="T:System.Web.UI.IDataSource" />.</para>
+        </returns>
         <param name="viewName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the view to retrieve. </param>
       </Docs>
@@ -80,7 +83,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -91,6 +93,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of names representing the list of view objects associated with the <see cref="T:System.Web.UI.IDataSource" /> interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.ICollection" /> that contains the names of the views associated with the <see cref="T:System.Web.UI.IDataSource" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/IFilterResolutionService.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/IFilterResolutionService.xml
index bf294089054..02ea01e64d4 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/IFilterResolutionService.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/IFilterResolutionService.xml
@@ -32,13 +32,16 @@
         <Parameter Name="filter2" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether a parent-child relationship exists between two specified device filters. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>1 if the device filter identified by <paramref name="filter1" /> is a parent of the filter identified by <paramref name="filter2" />, -1 if the device filter identified by <paramref name="filter2" /> is a parent of the filter identified by <paramref name="filter1" />, and 0 if there is no parent-child relationship between the two filters.</para>
+        </returns>
         <param name="filter1">
           <attribution license="cc4" from="Microsoft" modified="false" />A device filter name.</param>
         <param name="filter2">
@@ -58,7 +61,6 @@
         <Parameter Name="filterName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -68,6 +70,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified filter is a type of the current filter object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified filter is a type applicable to the current filter object; otherwise, false.</para>
+        </returns>
         <param name="filterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a device filter.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/IHierarchicalDataSource.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/IHierarchicalDataSource.xml
index f7a055a7505..9cd637069e0 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/IHierarchicalDataSource.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/IHierarchicalDataSource.xml
@@ -52,7 +52,6 @@
         <Parameter Name="viewPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -62,6 +61,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the view helper object for the <see cref="T:System.Web.UI.IHierarchicalDataSource" /> interface for the specified path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a <see cref="T:System.Web.UI.HierarchicalDataSourceView" /> that represents a single view of the data at the hierarchical level identified by the <paramref name="viewPath" /> parameter.</para>
+        </returns>
         <param name="viewPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The hierarchical path of the view to retrieve. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/IHierarchicalEnumerable.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/IHierarchicalEnumerable.xml
index 50e6a79903f..f5e8b6c3c9b 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/IHierarchicalEnumerable.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/IHierarchicalEnumerable.xml
@@ -33,7 +33,6 @@
         <Parameter Name="enumeratedItem" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -43,6 +42,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hierarchical data item for the specified enumerated item.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.IHierarchyData" /> instance that represents the <see cref="T:System.Object" /> passed to the <see cref="M:System.Web.UI.IHierarchicalEnumerable.GetHierarchyData(System.Object)" /> method.</para>
+        </returns>
         <param name="enumeratedItem">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> for which to return an <see cref="T:System.Web.UI.IHierarchyData" />. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/IHierarchyData.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/IHierarchyData.xml
index c4387fd4757..631ee8f7a86 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/IHierarchyData.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/IHierarchyData.xml
@@ -26,7 +26,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -36,6 +35,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an enumeration object that represents all the child nodes of the current hierarchical node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.IHierarchicalEnumerable" /> collection of child nodes of the current hierarchical node.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -49,7 +52,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -59,6 +61,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <see cref="T:System.Web.UI.IHierarchyData" /> object that represents the parent node of the current hierarchical node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.IHierarchyData" /> object that represents the parent node of the current hierarchical node.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/IPostBackDataHandler.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/IPostBackDataHandler.xml
index fb45df477ed..6994bc47bed 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/IPostBackDataHandler.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/IPostBackDataHandler.xml
@@ -32,7 +32,6 @@
         <Parameter Name="postCollection" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The ASP.NET page framework tracks all the server controls that return true to this method call, and then invokes the <see cref="M:System.Web.UI.IPostBackDataHandler.RaisePostDataChangedEvent" /> method on those controls.</para>
@@ -41,6 +40,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented by a class, processes postback data for an ASP.NET server control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the server control's state changes as a result of the postback; otherwise, false.</para>
+        </returns>
         <param name="postDataKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key identifier for the control. </param>
         <param name="postCollection">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/IResourceUrlGenerator.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/IResourceUrlGenerator.xml
index 9a364fc4ce2..2fea7aeece7 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/IResourceUrlGenerator.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/IResourceUrlGenerator.xml
@@ -42,7 +42,6 @@
       </Parameters>
       <Docs>
         <param name="resource">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -53,6 +52,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a URL reference to an embedded resource in an assembly that is used at design time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The URL reference to the resource.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type in the assembly that contains the embedded resource.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/IStateFormatter.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/IStateFormatter.xml
index 6a73ab84d93..a14adb21db2 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/IStateFormatter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/IStateFormatter.xml
@@ -30,7 +30,6 @@
       </Parameters>
       <Docs>
         <param name="serializationState">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -40,6 +39,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes an object state graph from its serialized string form.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the state of an ASP.NET server control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -55,7 +58,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -65,6 +67,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serializes ASP.NET Web server control state to string form.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents a Web server control's view state. </para>
+        </returns>
         <param name="state">
           <attribution license="cc4" from="Microsoft" modified="false" />The object that represents the view state of the Web server control to serialize to string form.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/IStateManager.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/IStateManager.xml
index bc68fbfb371..2428276c101 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/IStateManager.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/IStateManager.xml
@@ -75,12 +75,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented by a class, saves the changes to a server control's view state to an <see cref="T:System.Object" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> that contains the view state changes.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/IThemeResolutionService.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/IThemeResolutionService.xml
index 2eabbbf1de1..6d86c3052ac 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/IThemeResolutionService.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/IThemeResolutionService.xml
@@ -27,13 +27,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <see cref="T:System.Array" /> of <see cref="T:System.Web.UI.ThemeProvider" /> objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Array" /> of <see cref="T:System.Web.UI.ThemeProvider" /> objects associated with the current <see cref="T:System.Web.UI.IThemeResolutionService" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -47,13 +50,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Web.UI.ThemeProvider" /> object that represents the customization theme from a style sheet.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.ThemeProvider" /> that represents the page theme that is applied to a control built by the <see cref="T:System.Web.UI.ControlBuilder" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -67,13 +73,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Web.UI.ThemeProvider" /> object that represents the customization theme on an ASP.NET page. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.ThemeProvider" /> that represents the page theme that is applied to a control built by the <see cref="T:System.Web.UI.ControlBuilder" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/IUrlResolutionService.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/IUrlResolutionService.xml
index 55e5ff9d543..428261759ba 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/IUrlResolutionService.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/IUrlResolutionService.xml
@@ -31,7 +31,6 @@
       </Parameters>
       <Docs>
         <param name="url">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -41,6 +40,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a resolved URL that is suitable for use by the client.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the resolved URL.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/IUserControlTypeResolutionService.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/IUserControlTypeResolutionService.xml
index f0c0e00da69..edacac973fb 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/IUserControlTypeResolutionService.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/IUserControlTypeResolutionService.xml
@@ -30,7 +30,6 @@
       </Parameters>
       <Docs>
         <param name="prefixTag">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -40,6 +39,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a type based on a parsed ASP.NET tag prefix and the name of the tag.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> that represents the type of control the prefix and tag identify.</para>
+        </returns>
         <param name="tagName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the parsed ASP.NET tag.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/ListSourceHelper.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/ListSourceHelper.xml
index a7269225233..2c96834a0b3 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/ListSourceHelper.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/ListSourceHelper.xml
@@ -31,7 +31,6 @@
         <Parameter Name="dataSource" Type="System.Web.UI.IDataSource" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -41,6 +40,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified data source control contains a collection of data source view objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the data source control contains a collection of data source view objects; otherwise, false.</para>
+        </returns>
         <param name="dataSource">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Web.UI.IDataSource" /> that specifies the data source control to test for associated data source view objects.</param>
       </Docs>
@@ -58,7 +61,6 @@
         <Parameter Name="dataSource" Type="System.Web.UI.IDataSource" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -69,6 +71,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an <see cref="T:System.Collections.IList" /> collection of data source objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IList" /> of one <see cref="T:System.Web.UI.IDataSource" />, if the <see cref="T:System.Web.UI.IDataSource" /> has one or more associated <see cref="T:System.Web.UI.DataSourceView" /> objects; otherwise, returns null. </para>
+        </returns>
         <param name="dataSource">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Web.UI.IDataSource" /> that contains one or more associated <see cref="T:System.Web.UI.DataSourceView" /> objects, which are retrieved by a call to <see cref="M:System.Web.UI.DataSourceControl.GetViewNames" />.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/LiteralControl.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/LiteralControl.xml
index 20bf1efe1cc..56bf8ac48bb 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/LiteralControl.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/LiteralControl.xml
@@ -81,7 +81,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Web.UI.ControlCollection" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>By default, <see cref="T:System.Web.UI.LiteralControl" /> objects contain only text and no child server controls. If you want to change this behavior, you must override this method.</para>
@@ -90,6 +89,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Web.UI.EmptyControlCollection" /> object for the current instance of the <see cref="T:System.Web.UI.LiteralControl" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.UI.EmptyControlCollection" /> for the current control.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/LosFormatter.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/LosFormatter.xml
index eaca075b75d..126c36d8161 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/LosFormatter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/LosFormatter.xml
@@ -97,7 +97,6 @@
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This version of the <see cref="M:System.Web.UI.LosFormatter.Deserialize(System.IO.Stream)" /> method is used to transform the view-state value contained in a <see cref="T:System.IO.Stream" /> object to a LOS-formatted object.</para>
@@ -109,6 +108,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Transforms the view-state value contained in a <see cref="T:System.IO.Stream" /> object to a limited object serialization (LOS)-formatted object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A LOS-formatted object.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IO.Stream" /> that contains the view-state value to transform. </param>
       </Docs>
@@ -127,7 +130,6 @@
         <Parameter Name="input" Type="System.IO.TextReader" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This version of the <see cref="M:System.Web.UI.LosFormatter.Deserialize(System.IO.Stream)" /> method is used to transform the view-state value contained in a <see cref="T:System.IO.TextReader" /> object to a LOS-formatted object.</para>
@@ -139,6 +141,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Transforms the view-state value contained in a <see cref="T:System.IO.TextReader" /> object to a limited object serialization (LOS)-formatted object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A LOS-formatted object.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IO.TextReader" /> that contains the view-state value to transform. </param>
       </Docs>
@@ -157,7 +163,6 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This version of the <see cref="M:System.Web.UI.LosFormatter.Deserialize(System.IO.Stream)" /> method is used to transform the specified view-state value to a LOS-formatted object.</para>
@@ -169,6 +174,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Transforms the specified view-state value to a limited object serialization (LOS)-formatted object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A LOS-formatted object.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The view-state value to transform. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/NonVisualControlAttribute.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/NonVisualControlAttribute.xml
index 5ff9bce1922..238f9843980 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/NonVisualControlAttribute.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/NonVisualControlAttribute.xml
@@ -130,13 +130,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the current instance is equivalent to a default instance of the <see cref="T:System.Web.UI.NonVisualControlAttribute" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current instance is equivalent to a <see cref="F:System.Web.UI.NonVisualControlAttribute.Default" /> instance of the class; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/ObjectConverter.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/ObjectConverter.xml
index 4c827f71b38..4e37d2dbcda 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/ObjectConverter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/ObjectConverter.xml
@@ -55,12 +55,15 @@
         <Parameter Name="formatString" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an object from one object type to another object type. This class is obsolete. Use the <see cref="T:System.Convert" /> class and the <see cref="M:System.String.Format(System.String,System.Object)" /> method instead.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted object.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to convert.</param>
         <param name="toType">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/ObjectStateFormatter.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/ObjectStateFormatter.xml
index 1b9c7ef3c1d..c8d0bf6ca98 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/ObjectStateFormatter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/ObjectStateFormatter.xml
@@ -185,7 +185,6 @@
         <Parameter Name="inputStream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -198,6 +197,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes an object state graph from its binary-serialized form that is contained in the specified <see cref="T:System.IO.Stream" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents a deserialized object state graph.</para>
+        </returns>
         <param name="inputStream">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IO.Stream" /> that the <see cref="T:System.Web.UI.ObjectStateFormatter" /> deserializes into an initialized object. </param>
       </Docs>
@@ -215,7 +218,6 @@
         <Parameter Name="inputString" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -228,6 +230,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes an object state graph from its serialized base64-encoded string form.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents a deserialized object state graph.</para>
+        </returns>
         <param name="inputString">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that the <see cref="T:System.Web.UI.ObjectStateFormatter" /> deserializes into an initialized object.</param>
       </Docs>
@@ -245,7 +251,6 @@
         <Parameter Name="stateGraph" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -255,6 +260,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serializes an object state graph to a base64-encoded string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A base-64 encoded string that represents the serialized object state of the <paramref name="stateGraph" /> parameter.</para>
+        </returns>
         <param name="stateGraph">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to serialize.</param>
       </Docs>
@@ -346,7 +355,6 @@
         <Parameter Name="serializationStream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.ObjectStateFormatter" /> instance is cast to an <see cref="T:System.Runtime.Serialization.IFormatter" /> interface.</para>
@@ -355,6 +363,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Web.UI.ObjectStateFormatter.Deserialize(System.IO.Stream)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The top object of the deserialized graph.</para>
+        </returns>
         <param name="serializationStream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream that contains the data to deserialize.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/Page.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/Page.xml
index e0d19e1e143..308eb726d6d 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/Page.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/Page.xml
@@ -227,7 +227,6 @@
         <Parameter Name="extraData" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.IAsyncResult" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Do not call this method.</para>
@@ -236,6 +235,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initiates a request for Active Server Page (ASP) resources. This method is provided for compatibility with legacy ASP applications.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Web.HttpContext" /> with information about the current request. </param>
         <param name="cb">
@@ -349,12 +352,15 @@
         <Parameter Name="extraData" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins processing an asynchronous page request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that references the asynchronous request.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.HttpContext" /> for the request.</param>
         <param name="callback">
@@ -664,7 +670,6 @@
         <Parameter Name="tw" Type="System.IO.TextWriter" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Web.UI.HtmlTextWriter" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Page.CreateHtmlTextWriter(System.IO.TextWriter)" /> method creates a <see cref="T:System.IO.TextWriter" /> through the <see cref="P:System.Web.HttpRequest.Browser" /> property of the <see cref="P:System.Web.HttpContext.Request" /> object associated with the page request. You can add a reference to an <see cref="T:System.Web.UI.HtmlTextWriter" /> in the browserCaps configuration section. Override the <see cref="M:System.Web.UI.Page.CreateHtmlTextWriter(System.IO.TextWriter)" /> method to perform custom lookup.</para>
@@ -673,6 +678,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Web.UI.HtmlTextWriter" /> object to render the page's content.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.HtmlTextWriter" /> or <see cref="T:System.Web.UI.Html32TextWriter" />.</para>
+        </returns>
         <param name="tw">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.TextWriter" /> used to create the <see cref="T:System.Web.UI.HtmlTextWriter" />.</param>
       </Docs>
@@ -700,7 +709,6 @@
         <Parameter Name="writerType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is used internally in page adapters.</para>
@@ -709,6 +717,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a specified <see cref="T:System.Web.UI.HtmlTextWriter" /> object to render the page's content.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.HtmlTextWriter" /> that renders the content of the page.</para>
+        </returns>
         <param name="tw">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.TextWriter" /> used to create the <see cref="T:System.Web.UI.HtmlTextWriter" />. </param>
         <param name="writerType">
@@ -782,7 +794,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Collections.Specialized.NameValueCollection" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Page.DeterminePostBackMode" /> method returns a <see cref="T:System.Collections.Specialized.NameValueCollection" /> object that contains the data posted back to the page. The presence of the page hidden fields VIEWSTATE and EVENTTARGET is used to help determine whether a postback event has occurred. The <see cref="P:System.Web.UI.Page.IsPostBack" /> property is set when the <see cref="M:System.Web.UI.Page.DeterminePostBackMode" /> method is called.</para>
@@ -791,6 +802,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Collections.Specialized.NameValueCollection" /> of data posted back to the page using either a POST or a GET command. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.Specialized.NameValueCollection" /> object that contains the form data. If the postback used the POST command, the form information is returned from the <see cref="P:System.Web.UI.Page.Context" /> object. If the postback used the GET command, the query string information is returned. If the page is being requested for the first time, null is returned.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -992,7 +1007,6 @@
         <Parameter Name="id" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Page.FindControl(System.String)" /> method can be used to access a control whose <see cref="P:System.Web.UI.Control.ID" /> is not available at design time. The method searches only the page's immediate, or top-level, container; it does not recursively search for controls in naming containers contained on the page. To access controls in a subordinate naming container, call the FindControl method of that container.</para>
@@ -1001,6 +1015,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the page naming container for a server control with the specified identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified control, or null if the specified control does not exist.</para>
+        </returns>
         <param name="id">
           <attribution license="cc4" from="Microsoft" modified="false" />The identifier for the control to be found. </param>
       </Docs>
@@ -1059,12 +1077,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the data item at the top of the data-binding context stack.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object at the top of the data binding context stack.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetPostBackClientEvent">
@@ -1078,7 +1099,6 @@
         <Parameter Name="argument" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="T:System.Web.UI.ClientScriptManager" /> class for alternatives to this deprecated member.</para>
@@ -1087,6 +1107,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a reference that can be used in a client event to post back to the server for the specified control and with the specified event arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string that represents the client event.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The server control that receives the client event postback. </param>
         <param name="argument">
@@ -1116,7 +1140,6 @@
         <Parameter Name="argument" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.Web.UI.ClientScriptManager.GetPostBackClientHyperlink(System.Web.UI.Control,System.String)" /> method for an alternative to this deprecated member.</para>
@@ -1125,6 +1148,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a reference, with javascript: appended to the beginning of it, that can be used in a client event to post back to the server for the specified control and with the specified event arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representing a JavaScript call to the postback function that includes the target control's ID and event arguments.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The server control to process the postback. </param>
         <param name="argument">
@@ -1153,7 +1180,6 @@
         <Parameter Name="control" Type="System.Web.UI.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has been deprecated. Use the <see cref="Overload:System.Web.UI.ClientScriptManager.GetPostBackEventReference" /> method in the <see cref="T:System.Web.UI.ClientScriptManager" /> class instead.</para>
@@ -1162,6 +1188,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that can be used in a client event to cause postback to the server. The reference string is defined by the specified <see cref="T:System.Web.UI.Control" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that, when treated as script on the client, initiates the postback.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The server control to process the postback on the server. </param>
       </Docs>
@@ -1189,7 +1219,6 @@
         <Parameter Name="argument" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has been deprecated. Use the <see cref="Overload:System.Web.UI.ClientScriptManager.GetPostBackEventReference" /> method in the <see cref="T:System.Web.UI.ClientScriptManager" /> class instead. </para>
@@ -1198,6 +1227,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that can be used in a client event to cause postback to the server. The reference string is defined by the specified control that handles the postback and a string argument of additional event information. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that, when treated as script on the client, initiates the postback.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The server control to process the postback. </param>
         <param name="argument">
@@ -1224,7 +1257,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Do not override this method.</para>
@@ -1233,6 +1265,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a hash code that is generated by <see cref="T:System.Web.UI.Page" /> objects that are generated at run time. This hash code is unique to the <see cref="T:System.Web.UI.Page" /> object's control hierarchy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code generated at run time. The default is 0.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1257,7 +1293,6 @@
         <Parameter Name="validationGroup" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Page.GetValidators(System.String)" /> method returns all the validation objects associated with a specific validation group. You can return the default validation group (all validation controls associated with controls without the ValidationGroup property set) by setting the <paramref name="validationGroup" /> parameter to null. </para>
@@ -1267,6 +1302,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of control validators for a specified validation group.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.ValidatorCollection" /> that contains the control validators for the specified validation group.</para>
+        </returns>
         <param name="validationGroup">
           <attribution license="cc4" from="Microsoft" modified="false" />The validation group to return, or null to return the default validation group.</param>
       </Docs>
@@ -1285,7 +1324,6 @@
       </Parameters>
       <Docs>
         <param name="list">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Page.GetWrappedFileDependencies(System.String[])" /> method gets a list of files, such as user control files, that make up the current page. If any of these pages are modified, the entire page is compiled the next time it is requested. Do not override this method.</para>
@@ -1294,6 +1332,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a list of physical file names that correspond to a list of virtual file locations.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object containing a list of physical file locations.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Header">
@@ -1589,7 +1631,6 @@
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this method before calling <see cref="M:System.Web.UI.Page.RegisterClientScriptBlock(System.String,System.String)" /> to avoid unnecessarily assembling the client-side script. This is particularly important if the script requires a large amount of server resources to create.</para>
@@ -1599,6 +1640,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the client script block with the specified key is registered with the page.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the script block is registered; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The string key of the client script to search for. </param>
       </Docs>
@@ -1709,7 +1754,6 @@
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this method before calling <see cref="M:System.Web.UI.Page.RegisterStartupScript(System.String,System.String)" /> to avoid unnecessarily assembling the client-side script. This is particularly important if the script requires a large amount of server resources to create.</para>
@@ -1719,6 +1763,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the client startup script is registered with the <see cref="T:System.Web.UI.Page" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the startup script is registered; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The string key of the startup script to search for. </param>
       </Docs>
@@ -1852,7 +1900,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.Page.LoadPageStateFromPersistenceMedium" /> method uses the <see cref="M:System.Web.UI.PageStatePersister.Load" /> method of the <see cref="T:System.Web.UI.PageStatePersister" /> object referenced by the <see cref="P:System.Web.UI.Page.PageStatePersister" /> property to load any saved view-state information for the <see cref="T:System.Web.UI.Page" /> object.</para>
@@ -1864,6 +1911,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads any saved view-state information to the <see cref="T:System.Web.UI.Page" /> object. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The saved view state.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1916,7 +1967,6 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1927,6 +1977,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the physical path that a virtual path, either absolute or relative, or an application-relative path maps to.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The physical path associated with the virtual path or application-relative path.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that represents the virtual path. </param>
       </Docs>
@@ -2908,7 +2962,6 @@
         <Parameter Name="control" Type="System.Web.UI.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Control state is an object composed of critical view-state data that Web server controls need to function; it is contained in a separate object from normal view state. </para>
@@ -2918,6 +2971,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Web.UI.Control" /> object is registered to participate in control state management.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Web.UI.Control" /> requires control state; otherwise, false</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.UI.Control" /> to check for a control state requirement.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/PageHandlerFactory.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/PageHandlerFactory.xml
index a5bd2a605d5..7a8014c3ad4 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/PageHandlerFactory.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/PageHandlerFactory.xml
@@ -60,7 +60,6 @@
       </Parameters>
       <Docs>
         <param name="url">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.PageHandlerFactory.GetHandler(System.Web.HttpContext,System.String,System.String,System.String)" /> method is called by the ASP.NET run time and returns either a valid instance of the <see cref="T:System.Web.IHttpHandler" /> interface or null.</para>
@@ -69,6 +68,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an instance of the <see cref="T:System.Web.IHttpHandler" /> interface to process the requested resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Web.IHttpHandler" /> that processes the request; otherwise, null.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of the <see cref="T:System.Web.HttpContext" /> class that provides references to intrinsic server objects (for example, Request, Response, Session, and Server) used to service HTTP requests. </param>
         <param name="requestType">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/PageParser.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/PageParser.xml
index 47125c0eb15..fab1f147d87 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/PageParser.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/PageParser.xml
@@ -72,12 +72,15 @@
         <Parameter Name="context" Type="System.Web.HttpContext" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Web.IHttpHandler" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an instance of a compiled page for the specific virtual path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the compiled instance of the requested page. </para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path of the requested file. </param>
         <param name="inputFile">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/PageTheme.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/PageTheme.xml
index 4c31c5b9522..7573498278c 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/PageTheme.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/PageTheme.xml
@@ -98,13 +98,16 @@
         <Parameter Name="skinID" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a lookup key object for a particular control type and skin ID. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that can be used as a lookup key in a dictionary-style collection, which contains the control type and skin ID information.</para>
+        </returns>
         <param name="controlType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of control to which a control skin applies, which is passed typically from the <see cref="P:System.Web.UI.ControlBuilder.ControlType" />.</param>
         <param name="skinID">
@@ -124,7 +127,6 @@
         <Parameter Name="expression" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -134,6 +136,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uses the <see cref="M:System.Web.UI.DataBinder.Eval(System.Object,System.String)" /> method of the <see cref="P:System.Web.UI.PageTheme.Page" /> property that the instance of the <see cref="T:System.Web.UI.PageTheme" /> class is associated with to evaluate a data-binding expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that results from the evaluation of the data-binding expression.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />The navigation path from the container to the public property value. For details, see <see cref="T:System.Web.UI.DataBinder" />.</param>
       </Docs>
@@ -152,7 +158,6 @@
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -162,6 +167,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uses the <see cref="M:System.Web.UI.DataBinder.Eval(System.Object,System.String,System.String)" /> method of the <see cref="P:System.Web.UI.PageTheme.Page" /> property that the instance of the <see cref="T:System.Web.UI.PageTheme" /> class is associated with to evaluate a data-binding expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that results from the evaluation of the data-binding expression and conversion to a string type.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />The navigation path from the container to the public property value. For details, see <see cref="T:System.Web.UI.DataBinder" />.</param>
         <param name="format">
@@ -225,13 +234,16 @@
         <Parameter Name="deviceFilterName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether a device filter applies to the <see cref="T:System.Web.UI.Page" /> control that the instance of the <see cref="T:System.Web.UI.PageTheme" /> class is associated with.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="deviceFilterName" /> applies to the page; otherwise; false.</para>
+        </returns>
         <param name="deviceFilterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The string name of the device filter to check. </param>
       </Docs>
@@ -249,7 +261,6 @@
         <Parameter Name="xPathExpression" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -259,6 +270,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates an XPath data-binding expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that results from the evaluation of the data-binding <paramref name="xPathExpression" />.</para>
+        </returns>
         <param name="xPathExpression">
           <attribution license="cc4" from="Microsoft" modified="false" />The XPath expression to evaluate. For details, see <see cref="T:System.Web.UI.XPathBinder" />.</param>
       </Docs>
@@ -277,7 +292,6 @@
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -287,6 +301,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates an XPath data-binding expression using the specified format string to display the result.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that results from the evaluation of the data-binding expression and conversion to a string type.</para>
+        </returns>
         <param name="xPathExpression">
           <attribution license="cc4" from="Microsoft" modified="false" />The XPath expression to evaluate. For details, see <see cref="T:System.Web.UI.XPathBinder" />.</param>
         <param name="format">
@@ -307,7 +325,6 @@
         <Parameter Name="resolver" Type="System.Xml.IXmlNamespaceResolver" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -317,6 +334,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates an XPath data-binding expression using the specified prefix and namespace mappings for namespace resolution. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that results from the evaluation of the data-binding <paramref name="xPathExpression" />.</para>
+        </returns>
         <param name="xPathExpression">
           <attribution license="cc4" from="Microsoft" modified="false" />The XPath expression to evaluate. For details, see <see cref="T:System.Web.UI.XPathBinder" />. </param>
         <param name="resolver">
@@ -338,7 +359,6 @@
         <Parameter Name="resolver" Type="System.Xml.IXmlNamespaceResolver" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -348,6 +368,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uses the <see cref="M:System.Web.UI.TemplateControl.XPath(System.String,System.String,System.Xml.IXmlNamespaceResolver)" /> method of the <see cref="P:System.Web.UI.PageTheme.Page" /> control that the instance of the <see cref="T:System.Web.UI.PageTheme" /> class is associated with to evaluate an XPath data-binding expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that results from the evaluation of the data-binding expression and conversion to a string type.</para>
+        </returns>
         <param name="xPathExpression">
           <attribution license="cc4" from="Microsoft" modified="false" />The XPath expression to evaluate. For details, see <see cref="T:System.Web.UI.XPathBinder" />. </param>
         <param name="format">
@@ -369,7 +393,6 @@
         <Parameter Name="xPathExpression" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -379,6 +402,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates an XPath data-binding expression and returns a node collection that implements the <see cref="T:System.Collections.IEnumerable" /> interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerable" /> list of nodes.</para>
+        </returns>
         <param name="xPathExpression">
           <attribution license="cc4" from="Microsoft" modified="false" />The XPath expression to evaluate. For details, see <see cref="T:System.Web.UI.XPathBinder" />.</param>
       </Docs>
@@ -397,7 +424,6 @@
         <Parameter Name="resolver" Type="System.Xml.IXmlNamespaceResolver" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -407,6 +433,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates an XPath data-binding expression using the specified prefix and namespace mappings for namespace resolution and returns a node collection that implements the <see cref="T:System.Collections.IEnumerable" /> interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerable" /> list of nodes. </para>
+        </returns>
         <param name="xPathExpression">
           <attribution license="cc4" from="Microsoft" modified="false" />The XPath expression to evaluate. For details, see <see cref="T:System.Web.UI.XPathBinder" />. </param>
         <param name="resolver">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/ParseChildrenAttribute.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/ParseChildrenAttribute.xml
index e516e2d9258..1f7798fd7e7 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/ParseChildrenAttribute.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/ParseChildrenAttribute.xml
@@ -222,12 +222,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified object is equal to the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is equal to the current object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current object.</param>
       </Docs>
@@ -244,12 +247,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Int32" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for the <see cref="T:System.Web.UI.ParseChildrenAttribute" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.Web.UI.ParseChildrenAttribute" /> object. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -264,7 +270,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default value for the <see cref="T:System.Web.UI.ParseChildrenAttribute" /> class is the <see cref="F:System.Web.UI.ParseChildrenAttribute.ParseAsChildren" /> field. </para>
@@ -273,6 +278,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the value of the current instance of the <see cref="T:System.Web.UI.ParseChildrenAttribute" /> class is the default value of the derived class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current <see cref="T:System.Web.UI.ParseChildrenAttribute" /> value is the default instance; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/PersistChildrenAttribute.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/PersistChildrenAttribute.xml
index 60f80d48046..46e95cc0e12 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/PersistChildrenAttribute.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/PersistChildrenAttribute.xml
@@ -104,12 +104,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified object is equal to the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is equal to the current object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current object.</param>
       </Docs>
@@ -126,12 +129,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Int32" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for the <see cref="T:System.Web.UI.PersistChildrenAttribute" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the <see cref="T:System.Web.UI.PersistChildrenAttribute" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -146,12 +152,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the value of the current instance of the <see cref="T:System.Web.UI.PersistChildrenAttribute" /> class is the default value of the derived clss.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of the current instance of the <see cref="T:System.Web.UI.PersistChildrenAttribute" /> is the default instance; otherwise, false. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/PersistenceModeAttribute.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/PersistenceModeAttribute.xml
index d9a88de6282..ed7c64d197f 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/PersistenceModeAttribute.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/PersistenceModeAttribute.xml
@@ -120,7 +120,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.PersistenceModeAttribute.Equals(System.Object)" /> method first compares the current object with the given object and returns true if they are equal.  Otherwise, if the given object is also a <see cref="T:System.Web.UI.PersistenceModeAttribute" /> object and is not null, the <see cref="P:System.Web.UI.PersistenceModeAttribute.Mode" /> properties of each object are compared for equality and the result returned.</para>
@@ -129,6 +128,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the <see cref="T:System.Web.UI.PersistenceModeAttribute" /> object against another object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the objects are considered equal; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to.</param>
       </Docs>
@@ -145,12 +148,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Int32" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides a hash value for a <see cref="T:System.Web.UI.PersistenceModeAttribute" /> attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash value to be assigned to the <see cref="T:System.Web.UI.PersistenceModeAttribute" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -203,7 +209,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method performs calls the <see cref="M:System.Web.UI.PersistenceModeAttribute.Equals(System.Object)" /> method while passing in the object referenced by the <see cref="F:System.Web.UI.PersistenceModeAttribute.Default" /> property.</para>
@@ -212,6 +217,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the <see cref="T:System.Web.UI.PersistenceModeAttribute" /> object is of the default type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.UI.PersistenceModeAttribute" /> is of the default type; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/PropertyConverter.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/PropertyConverter.xml
index 67f33fa06a8..4660a216f4f 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/PropertyConverter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/PropertyConverter.xml
@@ -35,7 +35,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.PropertyConverter.EnumFromString(System.Type,System.String)" /> method is used to convert a string value to its equivalent enumeration value.</para>
@@ -47,6 +46,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation to a value of the specified enumeration type. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumeration of type <paramref name="enumType" />.</para>
+        </returns>
         <param name="enumType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents the enumeration type to create from the <paramref name="value" /> parameter.</param>
         <param name="value">
@@ -68,7 +71,6 @@
         <Parameter Name="enumValue" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.PropertyConverter.EnumToString(System.Type,System.Object)" /> method is used to convert an enumeration value to its equivalent string representation.</para>
@@ -80,6 +82,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified enumeration type to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="enumValue" />.</para>
+        </returns>
         <param name="enumType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents the enumeration type of <paramref name="enumValue" />. </param>
         <param name="enumValue">
@@ -102,7 +108,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.PropertyConverter.ObjectFromString(System.Type,System.Reflection.MemberInfo,System.String)" /> method is used to convert a string value to an object.</para>
@@ -114,6 +119,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string value to the specified object type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object of type <paramref name="objType" />.</para>
+        </returns>
         <param name="objType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> to create from <paramref name="value" />.</param>
         <param name="propertyInfo">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/RootBuilder.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/RootBuilder.xml
index c52848a6f22..9dbfc35001f 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/RootBuilder.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/RootBuilder.xml
@@ -87,7 +87,6 @@
         <Parameter Name="attribs" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Type" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.RootBuilder.GetChildControlType(System.String,System.Collections.IDictionary)" /> method overrides the implementation of this method in <see cref="T:System.Web.UI.ControlBuilder" />.</para>
@@ -96,6 +95,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the control type of any parsed child controls.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type of the child control.</para>
+        </returns>
         <param name="tagName">
           <attribution license="cc4" from="Microsoft" modified="false" />The tag name of the child control.</param>
         <param name="attribs">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/SimpleWebHandlerParser.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/SimpleWebHandlerParser.xml
index 6d108af71a0..c360c6c8ccc 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/SimpleWebHandlerParser.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/SimpleWebHandlerParser.xml
@@ -79,12 +79,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the type for the compiled object from the virtual path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> assigned to the virtual path.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/SkinBuilder.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/SkinBuilder.xml
index 6babc5435d6..c6a35d5507a 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/SkinBuilder.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/SkinBuilder.xml
@@ -62,7 +62,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -73,6 +72,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Applies a theme and a control skin to the current control at design time, if a <see cref="T:System.Web.UI.SkinBuilder" /> object is associated with the control. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The control instance to which the theme or style sheet theme and any control skin was applied. This is the same instance passed to the builder's <see cref="M:System.Web.UI.SkinBuilder.#ctor(System.Web.UI.ThemeProvider,System.Web.UI.Control,System.Web.UI.ControlBuilder,System.String)" /> constructor. This method will return null if no control was passed to the constructor.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/StateBag.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/StateBag.xml
index 145a48f98c6..0bff7eff2a6 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/StateBag.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/StateBag.xml
@@ -82,12 +82,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'StateItem'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new <see cref="T:System.Web.UI.StateItem" /> object to the <see cref="T:System.Web.UI.StateBag" /> object. If the item already exists in the <see cref="T:System.Web.UI.StateBag" /> object, this method updates the value of the item.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a <see cref="T:System.Web.UI.StateItem" /> that represents the object added to view state.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The attribute name for the <see cref="T:System.Web.UI.StateItem" />. </param>
         <param name="value">
@@ -144,12 +147,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Collections.IDictionaryEnumerator" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates over all the key/value pairs of the <see cref="T:System.Web.UI.StateItem" /> objects stored in the <see cref="T:System.Web.UI.StateBag" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The enumerator to iterate through the state bag.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -166,7 +172,6 @@
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method also returns false if the <paramref name="key" /> parameter does not exist in the <see cref="T:System.Web.UI.StateBag" /> object.</para>
@@ -175,6 +180,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks a <see cref="T:System.Web.UI.StateItem" /> object stored in the <see cref="T:System.Web.UI.StateBag" /> object to evaluate whether it has been modified since the call to <see cref="M:System.Web.UI.Control.TrackViewState" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the item has been modified; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key of the item to check. </param>
       </Docs>
@@ -421,7 +430,6 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.StateBag" /> instance is cast to an <see cref="T:System.Collections.IDictionary" /> interface.</para>
@@ -430,6 +438,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Collections.IDictionary.Contains(System.Object)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Collections.IDictionary" /> contains an element with the key; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key to locate in the <see cref="T:System.Collections.IDictionary" /> object.</param>
       </Docs>
@@ -536,7 +548,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Web.UI.StateBag" /> instance is cast to an <see cref="T:System.Collections.IEnumerable" /> interface.</para>
@@ -545,6 +556,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Collections.IEnumerable.GetEnumerator" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IStateManager.IsTrackingViewState">
@@ -604,7 +619,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is primarily used by control developers.</para>
@@ -615,6 +629,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the changes to the <see cref="T:System.Web.UI.StateBag" /> object since the time the page was posted back to the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object that contains the changes to the view state of the <see cref="T:System.Web.UI.StateBag" />. If there are no changes, or there are no <see cref="T:System.Web.UI.StateItem" /> elements in the <see cref="T:System.Web.UI.StateBag" />, this method returns null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IStateManager.TrackViewState">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/StateManagedCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/StateManagedCollection.xml
index 6377d7f10b0..29cb2058338 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/StateManagedCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/StateManagedCollection.xml
@@ -133,7 +133,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -143,6 +142,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates an instance of a class that implements <see cref="T:System.Web.UI.IStateManager" />. The type of object created is based on the specified member of the collection returned by the <see cref="M:System.Web.UI.StateManagedCollection.GetKnownTypes" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of a class derived from <see cref="T:System.Web.UI.IStateManager" />, according to the <paramref name="index" /> provided.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index, from the ordered list of types returned by <see cref="M:System.Web.UI.StateManagedCollection.GetKnownTypes" />, of the type of <see cref="T:System.Web.UI.IStateManager" /> to create.</param>
       </Docs>
@@ -158,13 +161,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an iterator that iterates through the <see cref="T:System.Web.UI.StateManagedCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the <see cref="T:System.Web.UI.StateManagedCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -178,7 +184,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -188,6 +193,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, gets an array of <see cref="T:System.Web.UI.IStateManager" /> types that the <see cref="T:System.Web.UI.StateManagedCollection" /> collection can contain.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An ordered array of <see cref="T:System.Type" /> objects that identify the types of <see cref="T:System.Web.UI.IStateManager" /> objects the collection can contain. The default implementation returns null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -492,12 +501,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an iterator that iterates through the <see cref="T:System.Web.UI.StateManagedCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the <see cref="T:System.Web.UI.StateManagedCollection" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Add">
@@ -513,7 +525,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.StateManagedCollection.OnValidate(System.Object)" /> and <see cref="M:System.Web.UI.StateManagedCollection.OnInsert(System.Int32,System.Object)" /> methods are called before the element is added to the collection, and the <see cref="M:System.Web.UI.StateManagedCollection.OnInsertComplete(System.Int32,System.Object)" /> method is called after the element is added.</para>
@@ -522,6 +533,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an item to the <see cref="T:System.Web.UI.StateManagedCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position at which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to add to the <see cref="T:System.Web.UI.StateManagedCollection" />.</param>
       </Docs>
@@ -560,7 +575,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.StateManagedCollection.OnValidate(System.Object)" /> method is called to validate <paramref name="value" /> before the collection is checked.</para>
@@ -569,6 +583,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Web.UI.StateManagedCollection" /> collection contains a specific value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object is found in the <see cref="T:System.Web.UI.StateManagedCollection" />; otherwise, false. If null is passed for the value parameter, false is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to locate in the <see cref="T:System.Web.UI.StateManagedCollection" />.</param>
       </Docs>
@@ -586,7 +604,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.StateManagedCollection.OnValidate(System.Object)" /> method is called to validate <paramref name="value" /> before the index is returned.</para>
@@ -595,6 +612,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of a specified item in the <see cref="T:System.Web.UI.StateManagedCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of <paramref name="value" />, if it is found in the list; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to locate in the <see cref="T:System.Web.UI.StateManagedCollection" />.</param>
       </Docs>
@@ -788,7 +809,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is used primarily by control developers.</para>
@@ -799,6 +819,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves the changes to the <see cref="T:System.Web.UI.StateManagedCollection" /> collection and each <see cref="T:System.Web.UI.IStateManager" /> object it contains since the time the page was posted back to the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object that contains the changes to the view state of the <see cref="T:System.Web.UI.StateManagedCollection" /> and the items it contains. If no view state is associated with the collection and its elements, this method returns null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IStateManager.TrackViewState">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/StaticPartialCachingControl.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/StaticPartialCachingControl.xml
index 13d16eea03c..a178ac53906 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/StaticPartialCachingControl.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/StaticPartialCachingControl.xml
@@ -47,6 +47,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the <see cref="T:System.Web.UI.StaticPartialCachingControl" /> object to contain the cached server control content.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The instance of the <see cref="T:System.Web.UI.StaticPartialCachingControl" />.</para>
+        </returns>
         <param name="ctrlID">
           <attribution license="cc4" from="Microsoft" modified="false" />The identifier assigned to the server control by ASP.NET. </param>
         <param name="guid">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/TemplateBuilder.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/TemplateBuilder.xml
index 2a44bd340b7..d76b41ee4c9 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/TemplateBuilder.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/TemplateBuilder.xml
@@ -56,12 +56,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used during design time to build the template and its child controls. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to the instance of the <see cref="T:System.Web.UI.TemplateBuilder" /> class.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Init">
@@ -136,7 +139,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.TemplateBuilder.SetTagInnerText(System.String)" /> method needs to be called when we are in design time. The <see cref="M:System.Web.UI.TemplateBuilder.NeedsTagInnerText" /> method returns the value of the <see cref="P:System.Web.UI.ControlBuilder.InDesigner" /> property of the base <see cref="T:System.Web.UI.ControlBuilder" /> class.</para>
@@ -145,6 +147,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the control builder needs to get its inner text.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the control builder needs to get its inner text. The default is false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/TemplateControl.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/TemplateControl.xml
index 2ee64ed1970..2b4ed690256 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/TemplateControl.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/TemplateControl.xml
@@ -185,7 +185,6 @@
         <Parameter Name="fAsciiOnly" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'LiteralControl'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.TemplateControl.CreateResourceBasedLiteralControl(System.Int32,System.Int32,System.Boolean)" /> method is used to access literal strings that are stored in a resource and is not intended for use from within your code.</para>
@@ -194,6 +193,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Accesses literal strings stored in a resource. The <see cref="M:System.Web.UI.TemplateControl.CreateResourceBasedLiteralControl(System.Int32,System.Int32,System.Boolean)" /> method is not intended for use from within your code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.LiteralControl" /> representing a literal string in a resource.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />The offset of the start of the string in the resource. </param>
         <param name="size">
@@ -238,7 +241,6 @@
         <Parameter Name="expression" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The value of <paramref name="expression" /> must evaluate to a public property. </para>
@@ -248,6 +250,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates a data-binding expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that results from the evaluation of the data-binding expression.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />The navigation path from the container to the public property value to place in the bound control property.</param>
       </Docs>
@@ -266,7 +272,6 @@
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The value of <paramref name="expression" /> must evaluate to a public property. </para>
@@ -276,6 +281,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates a data-binding expression using the specified format string to display the result.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that results from the evaluation of the data-binding expression and conversion to a string type.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />The navigation path from the container to the public property value to place in the bound control property.</param>
         <param name="format">
@@ -323,7 +332,6 @@
         <Parameter Name="resourceKey" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Application-level resources are stored in the App_GlobalResources folder. For more information, see <format type="text/html"><a href="5a29f26b-d94d-48d9-864e-5ee8890dc265">Resources in ASP.NET Applications</a></format>. </para>
@@ -332,6 +340,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an application-level resource object based on the specified <see cref="P:System.Web.Compilation.ResourceExpressionFields.ClassKey" /> and <see cref="P:System.Web.Compilation.ResourceExpressionFields.ResourceKey" /> properties. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the requested resource object; otherwise, null.</para>
+        </returns>
         <param name="className">
           <attribution license="cc4" from="Microsoft" modified="false" />A string representing a <see cref="P:System.Web.Compilation.ResourceExpressionFields.ClassKey" />.</param>
         <param name="resourceKey">
@@ -354,7 +366,6 @@
         <Parameter Name="propName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Application-level resources are stored in the App_GlobalResources folder. For more information, see <format type="text/html"><a href="5a29f26b-d94d-48d9-864e-5ee8890dc265">Resources in ASP.NET Applications</a></format>.</para>
@@ -363,6 +374,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an application-level resource object based on the specified <see cref="P:System.Web.Compilation.ResourceExpressionFields.ClassKey" /> and <see cref="P:System.Web.Compilation.ResourceExpressionFields.ResourceKey" /> properties, object type, and property name of the resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the requested resource object; otherwise, null.</para>
+        </returns>
         <param name="className">
           <attribution license="cc4" from="Microsoft" modified="false" />A string representing a <see cref="P:System.Web.Compilation.ResourceExpressionFields.ClassKey" />. </param>
         <param name="resourceKey">
@@ -386,7 +401,6 @@
         <Parameter Name="resourceKey" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Local resource files are stored in the App_LocalResources directory. For more information, see <format type="text/html"><a href="5a29f26b-d94d-48d9-864e-5ee8890dc265">Resources in ASP.NET Applications</a></format></para>
@@ -395,6 +409,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a page-level resource object based on the specified <see cref="P:System.Web.Compilation.ResourceExpressionFields.ResourceKey" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the requested resource object; otherwise, null.</para>
+        </returns>
         <param name="resourceKey">
           <attribution license="cc4" from="Microsoft" modified="false" />A string representing a <see cref="P:System.Web.Compilation.ResourceExpressionFields.ResourceKey" />.</param>
       </Docs>
@@ -414,7 +432,6 @@
         <Parameter Name="propName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Local resource files are stored in the App_LocalResources directory. For more information, see <format type="text/html"><a href="5a29f26b-d94d-48d9-864e-5ee8890dc265">Resources in ASP.NET Applications</a></format></para>
@@ -423,6 +440,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a page-level resource object based on the specified <see cref="P:System.Web.Compilation.ResourceExpressionFields.ResourceKey" /> property, object type, and property name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the requested resource object; otherwise, null.</para>
+        </returns>
         <param name="resourceKey">
           <attribution license="cc4" from="Microsoft" modified="false" />A string representing a <see cref="P:System.Web.Compilation.ResourceExpressionFields.ResourceKey" />.</param>
         <param name="objType">
@@ -441,7 +462,6 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>Returns the <see cref="T:System.Web.UI.UserControl" /> object specified in <i>virtualPath</i></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the control supports caching, the object returned from the <see cref="M:System.Web.UI.TemplateControl.LoadControl(System.String)" /> method is not actually a <see cref="T:System.Web.UI.Control" /> object; rather, it is a <see cref="T:System.Web.UI.PartialCachingControl" /> object. If the <paramref name="virtualPath" /> parameter is relative, the path of the loaded control is relative to the path of the <see cref="T:System.Web.UI.TemplateControl" />.</para>
@@ -451,6 +471,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads a <see cref="T:System.Web.UI.Control" /> object from a file based on a specified virtual path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the specified <see cref="T:System.Web.UI.Control" />.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path to a control file. </param>
       </Docs>
@@ -475,7 +499,6 @@
       </Parameters>
       <Docs>
         <param name="type">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the user control supports caching, the object returned from the <see cref="M:System.Web.UI.TemplateControl.LoadControl(System.Type,System.Object[])" /> method is not actually a <see cref="T:System.Web.UI.UserControl" /> object; rather, it is a <see cref="T:System.Web.UI.PartialCachingControl" /> object. </para>
@@ -485,6 +508,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads a <see cref="T:System.Web.UI.Control" /> object based on a specified type and constructor parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the specified <see cref="T:System.Web.UI.UserControl" />.</para>
+        </returns>
         <param name="parameters">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of arguments that match in number, order, and type the parameters of the constructor to invoke. If <paramref name="parameters" /> is an empty array or null, the constructor that takes no parameters (the default constructor) is invoked.</param>
       </Docs>
@@ -499,12 +526,15 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ITemplate'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains an instance of the <see cref="T:System.Web.UI.ITemplate" /> interface from an external file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the specified template.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path to a user control file. </param>
       </Docs>
@@ -595,7 +625,6 @@
         <Parameter Name="content" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Control'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="content" /> parameter contains a user control, such as you would find in an .ascx file. This string cannot contain any code, because the <see cref="M:System.Web.UI.TemplateControl.ParseControl(System.String)" /> method never causes compilation.</para>
@@ -604,6 +633,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Parses an input string into a <see cref="T:System.Web.UI.Control" /> object on the Web Forms page or user control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The parsed <see cref="T:System.Web.UI.Control" />.</para>
+        </returns>
         <param name="content">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a user control. </param>
       </Docs>
@@ -626,7 +659,6 @@
         <Parameter Name="ignoreParserFilter" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="content" /> parameter contains a user control (the contents of an .ascx file). This string cannot contain any code, because the <see cref="M:System.Web.UI.TemplateControl.ParseControl(System.String)" /> method never causes compilation.</para>
@@ -636,6 +668,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Parses an input string into a <see cref="T:System.Web.UI.Control" /> object on the ASP.NET Web page or user control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The parsed control.</para>
+        </returns>
         <param name="content">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a user control.</param>
         <param name="ignoreParserFilter">
@@ -659,7 +695,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.TemplateControl.ReadStringResource" /> method is not intended for use from within your code.</para>
@@ -668,6 +703,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a string resource. The <see cref="M:System.Web.UI.TemplateControl.ReadStringResource" /> method is not intended for use from within your code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the resource.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadStringResource">
@@ -680,7 +719,6 @@
         <Parameter Name="t" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.TemplateControl.ReadStringResource(System.Type)" /> method is not intended for use from within your code.</para>
@@ -689,6 +727,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a string resource. The <see cref="M:System.Web.UI.TemplateControl.ReadStringResource(System.Type)" /> method is not intended for use from within your code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the resource.</para>
+        </returns>
         <param name="t">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the resource to read.</param>
       </Docs>
@@ -774,7 +816,6 @@
         <Parameter Name="filter2" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.TemplateControl.System.Web.UI.IFilterResolutionService.CompareFilters(System.String,System.String)" /> method is part of the <see cref="T:System.Web.UI.IFilterResolutionService" /> interface, which is specific to how a control uses device filters in a designer environment. When controls are parsed or persisted in the designer environment outside the context of a browser request, the <see cref="T:System.Web.UI.IFilterResolutionService" /> provides a way to determine if the current control is affected by a named filter and whether a named filter is part of a specific device-filter hierarchy.</para>
@@ -783,6 +824,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a parent/child relationship exists between two specified device filters. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>1, if <paramref name="filter1" /> is a parent of <paramref name="filter2" />; -1, if <paramref name="filter2" /> is a parent of <paramref name="filter1" />; otherwise, 0, if there is no parent/child relationship between <paramref name="filter1" /> and <paramref name="filter2" />.</para>
+        </returns>
         <param name="filter1">
           <attribution license="cc4" from="Microsoft" modified="false" />A device filter name. </param>
         <param name="filter2">
@@ -802,7 +847,6 @@
         <Parameter Name="filterName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.TemplateControl.System.Web.UI.IFilterResolutionService.EvaluateFilter(System.String)" /> method is part of the <see cref="T:System.Web.UI.IFilterResolutionService" /> interface, which is specific to how a control uses device filters in a designer environment. When controls are parsed or persisted in the designer environment outside the context of a browser request, the <see cref="T:System.Web.UI.IFilterResolutionService" /> provides a way to determine if the current control is affected by a named filter and whether a named filter is part of a specific device-filter hierarchy. </para>
@@ -811,6 +855,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the specified filter is a type of the current filter object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified filter is a type applicable to the current filter object; otherwise, false.</para>
+        </returns>
         <param name="filterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a device filter.</param>
       </Docs>
@@ -866,7 +914,6 @@
       </Parameters>
       <Docs>
         <param name="xpathexpression">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.TemplateControl.XPath(System.String)" /> method calls the <see cref="M:System.Web.UI.XPathBinder.Eval(System.Object,System.String)" /> method using the <see cref="M:System.Web.UI.Page.GetDataItem" /> method to resolve the <see cref="T:System.Xml.XPath.IXPathNavigable" /> object reference that the expression is evaluated against.</para>
@@ -875,6 +922,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates an XPath data-binding expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that results from the evaluation of the data-binding expression.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="XPath">
@@ -892,7 +943,6 @@
       </Parameters>
       <Docs>
         <param name="xpathexpression">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.TemplateControl.XPath(System.String,System.String)" /> method calls the <see cref="M:System.Web.UI.XPathBinder.Eval(System.Object,System.String,System.String)" /> method using the <see cref="M:System.Web.UI.Page.GetDataItem" /> method to resolve the <see cref="T:System.Xml.XPath.IXPathNavigable" /> object reference that the expression is evaluated against.</para>
@@ -901,6 +951,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates an XPath data-binding expression using the specified format string to display the result. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that results from the evaluation of the data-binding expression and conversion to a string type.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A .NET Framework format string to apply to the result. </param>
       </Docs>
@@ -920,7 +974,6 @@
       </Parameters>
       <Docs>
         <param name="xpathexpression">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.TemplateControl.XPath(System.String,System.Xml.IXmlNamespaceResolver)" /> method calls the <see cref="M:System.Web.UI.XPathBinder.Eval(System.Object,System.String,System.Xml.IXmlNamespaceResolver)" /> method using the <see cref="M:System.Web.UI.Page.GetDataItem" /> method to resolve the <see cref="T:System.Xml.XPath.IXPathNavigable" /> object reference that the expression is evaluated against.</para>
@@ -929,6 +982,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates an XPath data-binding expression using the specified prefix and namespace mappings for namespace resolution.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that results from the evaluation of the data-binding expression. </para>
+        </returns>
         <param name="resolver">
           <attribution license="cc4" from="Microsoft" modified="false" />A set of prefix and namespace mappings used for namespace resolution.</param>
       </Docs>
@@ -949,7 +1006,6 @@
       </Parameters>
       <Docs>
         <param name="xpathexpression">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.TemplateControl.XPath(System.String,System.String,System.Xml.IXmlNamespaceResolver)" /> method calls the <see cref="M:System.Web.UI.XPathBinder.Eval(System.Object,System.String,System.String,System.Xml.IXmlNamespaceResolver)" /> method using the <see cref="M:System.Web.UI.Page.GetDataItem" /> method to resolve the <see cref="T:System.Xml.XPath.IXPathNavigable" /> object reference that the expression is evaluated against.</para>
@@ -958,6 +1014,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates an XPath data-binding expression using the specified prefix and namespace mappings for namespace resolution and the specified format string to display the result.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that results from the evaluation of the data-binding expression and conversion to a string type.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A .NET Framework format string to apply to the result. </param>
         <param name="resolver">
@@ -978,7 +1038,6 @@
       </Parameters>
       <Docs>
         <param name="xpathexpression">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.TemplateControl.XPathSelect(System.String)" /> method calls the <see cref="M:System.Web.UI.XPathBinder.Select(System.Object,System.String)" /> method using the <see cref="M:System.Web.UI.Page.GetDataItem" /> method to resolve the <see cref="T:System.Xml.XPath.IXPathNavigable" /> object reference that the expression is evaluated against.</para>
@@ -987,6 +1046,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates an XPath data-binding expression and returns a node collection that implements the <see cref="T:System.Collections.IEnumerable" /> interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerable" /> node list. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="XPathSelect">
@@ -1004,7 +1067,6 @@
       </Parameters>
       <Docs>
         <param name="xpathexpression">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.TemplateControl.XPathSelect(System.String,System.Xml.IXmlNamespaceResolver)" /> method calls the <see cref="M:System.Web.UI.XPathBinder.Select(System.Object,System.String,System.Xml.IXmlNamespaceResolver)" /> method using the <see cref="M:System.Web.UI.Page.GetDataItem" /> method to resolve the <see cref="T:System.Xml.XPath.IXPathNavigable" /> object reference that the expression is evaluated against.</para>
@@ -1013,6 +1075,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates an XPath data-binding expression using the specified prefix and namespace mappings for namespace resolution and returns a node collection that implements the <see cref="T:System.Collections.IEnumerable" /> interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerable" /> node list. </para>
+        </returns>
         <param name="resolver">
           <attribution license="cc4" from="Microsoft" modified="false" />A set of prefix and namespace mappings used for namespace resolution. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/TemplateInstanceAttribute.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/TemplateInstanceAttribute.xml
index 4c4e8511144..5e5a767f864 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/TemplateInstanceAttribute.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/TemplateInstanceAttribute.xml
@@ -77,13 +77,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified object is a <see cref="T:System.Web.UI.TemplateInstanceAttribute" /> object and is identical to the this <see cref="T:System.Web.UI.TemplateInstanceAttribute" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if value is both a <see cref="T:System.Web.UI.TemplateInstanceAttribute" /> object and is identical to the this <see cref="T:System.Web.UI.TemplateInstanceAttribute" /> object; otherwise false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to test.</param>
       </Docs>
@@ -99,13 +102,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a hash code for this <see cref="T:System.Web.UI.TemplateInstanceAttribute" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for this <see cref="T:System.Web.UI.TemplateInstanceAttribute" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -141,7 +147,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -151,6 +156,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating if the current <see cref="T:System.Web.UI.TemplateInstanceAttribute" /> object is the same as the default <see cref="T:System.Web.UI.TemplateInstanceAttribute" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of the current instance of <see cref="T:System.Web.UI.TemplateInstanceAttribute" /> is the default; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/ThemeProvider.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/ThemeProvider.xml
index d5597159aa4..98b3761e5c2 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/ThemeProvider.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/ThemeProvider.xml
@@ -127,7 +127,6 @@
         <Parameter Name="control" Type="System.Web.UI.Control" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -137,6 +136,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a <see cref="T:System.Web.UI.SkinBuilder" /> instance for the specified control, which is used to apply a theme and control skin in a designer environment.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.SkinBuilder" /> instance, if one is defined for the specified control type; otherwise, null.</para>
+        </returns>
         <param name="control">
           <attribution license="cc4" from="Microsoft" modified="false" />The control to apply a theme and control skin to.</param>
       </Docs>
@@ -154,13 +157,16 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <see cref="T:System.Collections.IDictionary" /> object that contains a set of <see cref="T:System.Web.UI.SkinBuilder" /> objects for the specified <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IDictionary" /> that contains a list of one or more <see cref="T:System.Web.UI.ControlBuilder" /> objects associated with the <see cref="T:System.Type" /> passed to the method. This list is populated with <see cref="T:System.Collections.DictionaryEntry" /> objects where the <see cref="P:System.Web.UI.Control.SkinID" /> is a <see cref="P:System.Collections.DictionaryEntry.Key" />, and its associated <see cref="T:System.Web.UI.SkinBuilder" /> is the <see cref="P:System.Collections.DictionaryEntry.Value" />. </para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> for which to retrieve any associated <see cref="T:System.Web.UI.ControlBuilder" /> objects.</param>
       </Docs>
@@ -178,7 +184,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -188,6 +193,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <see cref="T:System.Collections.ICollection" /> of skin identifiers that are associated with the specified <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.ICollection" /> of skin identifiers, if control skins are defined for the specified <see cref="T:System.Type" />. If no control skins are associated with the type, an empty <see cref="T:System.Collections.ICollection" /> is returned. </para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> for which to retrieve any associated skin names.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/ThemeableAttribute.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/ThemeableAttribute.xml
index 29b3f8600e7..92ac1588643 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/ThemeableAttribute.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/ThemeableAttribute.xml
@@ -81,13 +81,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is the same instance as the current instance, or if the instances are different, but the attribute values are equivalent; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance, or null.</param>
       </Docs>
@@ -103,7 +106,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -113,6 +115,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for the <see cref="T:System.Web.UI.ThemeableAttribute" /> type. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.Web.UI.ThemeableAttribute" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -126,13 +132,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the current instance is equivalent to a <see cref="F:System.Web.UI.ThemeableAttribute.Default" /> instance of the <see cref="T:System.Web.UI.ThemeableAttribute" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current instance is equivalent to a <see cref="F:System.Web.UI.ThemeableAttribute.Default" /> instance of the class; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -149,13 +158,16 @@
       </Parameters>
       <Docs>
         <param name="obj">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the object passed to the method supports themes. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object supports themes and control skins; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -171,7 +183,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -181,6 +192,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the <see cref="T:System.Type" /> passed to the method supports themes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Type" /> supports themes and control skins; otherwise, false.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> to test for themes support.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/ToolboxDataAttribute.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/ToolboxDataAttribute.xml
index a7c10430d58..62bc832d168 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/ToolboxDataAttribute.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/ToolboxDataAttribute.xml
@@ -98,7 +98,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.UI.ToolboxDataAttribute.Equals(System.Object)" /> method first compares the objects for equality.  If the comparison returns false, the <see cref="M:System.Web.UI.ToolboxDataAttribute.Equals(System.Object)" /> method then compares the data of the <see cref="T:System.Web.UI.ToolboxDataAttribute" /> object to the data of the given object after first testing the given object to make sure that the given object is not null and is also typed as <see cref="T:System.Web.UI.ToolboxDataAttribute" /> object.</para>
@@ -107,6 +106,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether the <see cref="T:System.Web.UI.ToolboxDataAttribute" /> object is equal to the given object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if the <see cref="T:System.Web.UI.ToolboxDataAttribute" /> object is equal to the given object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to.</param>
       </Docs>
@@ -123,12 +126,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Int32" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code of the custom control.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer representing the hash code.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -143,7 +149,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default is an empty string ("").</para>
@@ -152,6 +157,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether the <see cref="T:System.Web.UI.ToolboxDataAttribute" /> object contains the default value for the <see cref="P:System.Web.UI.ToolboxDataAttribute.Data" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if the <see cref="T:System.Web.UI.ToolboxDataAttribute" /> contains the default value for the <see cref="P:System.Web.UI.ToolboxDataAttribute.Data" /> property; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/UserControl.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/UserControl.xml
index 81cb4aa6869..a78fedfa2d1 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/UserControl.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/UserControl.xml
@@ -311,7 +311,6 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>While similar to the <see cref="M:System.Web.UI.Page.MapPath(System.String)" /> method, this method maps the path from the .ascx file's location, not the .aspx file's location. You can use this method to obtain a path to a directory of images or other resources associated with your <see cref="T:System.Web.UI.UserControl" /> object.</para>
@@ -320,6 +319,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Assigns a virtual file path, either absolute or relative, to a physical file path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The physical path to the file.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual file path to map. </param>
       </Docs>
@@ -419,7 +422,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In general, you do not need to call this method. However, if you store custom information in view state, you can override this method to do so.</para>
@@ -428,6 +430,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Saves any user control view-state changes that have occurred since the last page postback.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the user control's current view state. If there is no view state associated with the control, it returns null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -507,7 +513,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Web.UI.UserControl.System.Web.UI.IAttributeAccessor.GetAttribute(System.String)" /> method to get the value of control attributes that are not exposed as properties on the control.</para>
@@ -516,6 +521,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified user control attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified user control attribute.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the attribute to get the value of.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/UserControlControlBuilder.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/UserControlControlBuilder.xml
index 6815703a444..866151981e7 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/UserControlControlBuilder.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/UserControlControlBuilder.xml
@@ -52,12 +52,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds an instance of the control identified by the <see cref="P:System.Web.UI.ControlBuilder.ControlType" /> property. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of a user control identified by <see cref="P:System.Web.UI.ControlBuilder.ControlType" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="NeedsTagInnerText">
@@ -68,7 +71,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="M:System.Web.UI.UserControlControlBuilder.NeedsTagInnerText" /> method returns true, the <see cref="M:System.Web.UI.UserControlControlBuilder.SetTagInnerText(System.String)" /> method is called. When the control is built in a designer environment, the <see cref="M:System.Web.UI.UserControlControlBuilder.NeedsTagInnerText" /> property returns true.</para>
@@ -77,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the control builder needs to get the control's inner text. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the control builder requires the control's inner text; otherwise, false. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/ValidatorCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/ValidatorCollection.xml
index 7e8cd416bce..6aae983b1d5 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/ValidatorCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/ValidatorCollection.xml
@@ -82,12 +82,15 @@
         <Parameter Name="validator" Type="System.Web.UI.IValidator" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified validation server control is contained within the page's <see cref="T:System.Web.UI.ValidatorCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the validation server control is in the collection; otherwise, false.</para>
+        </returns>
         <param name="validator">
           <attribution license="cc4" from="Microsoft" modified="false" />The validation server control to check for. </param>
       </Docs>
@@ -149,7 +152,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Collections.IEnumerator" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create an <see cref="T:System.Collections.IEnumerator" /> instance that can be iterated through easily to get each item in the <see cref="T:System.Web.UI.ValidatorCollection" /> collection.</para>
@@ -158,6 +160,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IEnumerator" /> instance for the <see cref="T:System.Web.UI.ValidatorCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Collections.IEnumerator" /> for the collection.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/WebServiceParser.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/WebServiceParser.xml
index 518dc400806..c1657858e65 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/WebServiceParser.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/WebServiceParser.xml
@@ -52,12 +52,15 @@
         <Parameter Name="context" Type="System.Web.HttpContext" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Type" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the compiled type for a given input file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> as specified by the <see cref="T:System.Web.HttpContext" />.</para>
+        </returns>
         <param name="inputFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The file to be compiled. </param>
         <param name="context">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/XPathBinder.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/XPathBinder.xml
index 4f0a90ce203..c5280757814 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/XPathBinder.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/XPathBinder.xml
@@ -35,7 +35,6 @@
       </Parameters>
       <Docs>
         <param name="xpath">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -46,6 +45,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates XPath data-binding expressions at run time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that results from the evaluation of the data-binding expression.</para>
+        </returns>
         <param name="container">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XPath.IXPathNavigable" /> object reference that the expression is evaluated against. This must be a valid object identifier in the page's specified language. </param>
       </Docs>
@@ -66,7 +69,6 @@
       </Parameters>
       <Docs>
         <param name="xpath">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -78,6 +80,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates XPath data-binding expressions at run time and formats the result as text to be displayed in the requesting browser.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that results from the evaluation of the data-binding expression and conversion to a string type.</para>
+        </returns>
         <param name="container">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XPath.IXPathNavigable" /> object reference that the expression is evaluated against. This must be a valid object identifier in the page's specified language. </param>
         <param name="format">
@@ -103,7 +109,6 @@
       </Parameters>
       <Docs>
         <param name="xpath">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the <see cref="M:System.Web.UI.XPathBinder.Eval(System.Object,System.String,System.Xml.IXmlNamespaceResolver)" /> method declaratively if you want to simplify the casting of an XML node to a text string to be displayed in a browser. To do so, you must place the &lt;%# and %&gt; tags, which are also used in standard ASP.NET data binding, around the data-binding expression. The data-binding expression includes the XPath expression and an <see cref="T:System.Xml.IXmlNamespaceResolver" /> object to resolve the namespace reference.</para>
@@ -113,6 +118,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates XPath data-binding expressions at run time and formats the result as text to be displayed in the requesting browser, using the <see cref="T:System.Xml.IXmlNamespaceResolver" /> object specified to resolve namespace prefixes in the XPath expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Object" /> that results from the evaluation of the data-binding expression.</para>
+        </returns>
         <param name="container">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XPath.IXPathNavigable" /> object reference that the expression is evaluated against. This must be a valid object identifier in the page's specified language.</param>
         <param name="resolver">
@@ -136,7 +145,6 @@
       </Parameters>
       <Docs>
         <param name="xpath">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the <see cref="M:System.Web.UI.XPathBinder.Eval(System.Object,System.String,System.String,System.Xml.IXmlNamespaceResolver)" /> method declaratively if you want to simplify the casting of an XML node to a text string to be displayed in a browser. To do so, you must place the &lt;%# and %&gt; tags, which are also used in standard ASP.NET data binding, around the data-binding expression. The data-binding expression includes the XPath expression and an <see cref="T:System.Xml.IXmlNamespaceResolver" /> object to resolve the namespace reference.</para>
@@ -146,6 +154,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates XPath data-binding expressions at run time and formats the result as text to be displayed in the requesting browser, using the <see cref="T:System.Xml.IXmlNamespaceResolver" /> object specified to resolve namespace prefixes in the XPath expression..</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that results from the evaluation of the data-binding expression and conversion to a string type.</para>
+        </returns>
         <param name="container">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XPath.IXPathNavigable" /> object reference that the expression is evaluated against. This must be a valid object identifier in the page's specified language.</param>
         <param name="format">
@@ -166,7 +178,6 @@
       </Parameters>
       <Docs>
         <param name="xpath">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -177,6 +188,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uses an XPath data-binding expression at run time to return a list of nodes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerable" /> list of nodes.</para>
+        </returns>
         <param name="container">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XPath.IXPathNavigable" /> object reference that the expression is evaluated against. This must be a valid object identifier in the page's specified language. </param>
       </Docs>
@@ -200,7 +215,6 @@
       </Parameters>
       <Docs>
         <param name="xpath">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the <see cref="M:System.Web.UI.XPathBinder.Select(System.Object,System.String,System.Xml.IXmlNamespaceResolver)" /> method declaratively if you want to simplify the retrieval of a set of nodes using an XPath query. To do so, you must place the &lt;%# and %&gt; tags, which are also used in standard ASP.NET data binding, around the XPath query and an <see cref="T:System.Xml.IXmlNamespaceResolver" /> object to resolve the namespace reference.</para>
@@ -210,6 +224,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uses an XPath data-binding expression at run time to return a list of nodes, using the <see cref="T:System.Xml.IXmlNamespaceResolver" /> object specified to resolve namespace prefixes in the XPath expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerable" /> list of nodes.</para>
+        </returns>
         <param name="container">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XPath.IXPathNavigable" /> object reference that the expression is evaluated against. This must be a valid object identifier in the page's specified language.</param>
         <param name="resolver">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.UI/XhtmlTextWriter.xml b/mcs/class/System.Web/Documentation/en/System.Web.UI/XhtmlTextWriter.xml
index 43d8b99d83b..bd33f82fcff 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.UI/XhtmlTextWriter.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.UI/XhtmlTextWriter.xml
@@ -415,7 +415,6 @@
         <Parameter Name="attributeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -425,6 +424,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks an XHTML attribute to ensure that it can be rendered in the opening tag of a &lt;form&gt; element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute can be applied to a &lt;form&gt; element; otherwise, false.</para>
+        </returns>
         <param name="attributeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The attribute name to check. </param>
       </Docs>
@@ -444,13 +447,16 @@
         <Parameter Name="key" Type="System.Web.UI.HtmlTextWriterAttribute" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified XHTML attribute and its value can be rendered to the current markup element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute is rendered to the page; otherwise, false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The XHTML attribute to render. </param>
         <param name="value">
@@ -474,13 +480,16 @@
         <Parameter Name="key" Type="System.Web.UI.HtmlTextWriterStyle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified XHTML style attribute and its value can be rendered to the current markup element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the style attribute is rendered; otherwise, false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The XHTML style attribute to render. </param>
         <param name="value">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Util/IWebObjectFactory.xml b/mcs/class/System.Web/Documentation/en/System.Web.Util/IWebObjectFactory.xml
index f5226e350f8..49b3cb652fc 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Util/IWebObjectFactory.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Util/IWebObjectFactory.xml
@@ -23,13 +23,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Web.Util.IWebObjectFactory" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Web.Util.IWebObjectFactory" /> </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web.Util/IWebPropertyAccessor.xml b/mcs/class/System.Web/Documentation/en/System.Web.Util/IWebPropertyAccessor.xml
index eeefcc4a00a..0a69bb7d8dd 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web.Util/IWebPropertyAccessor.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web.Util/IWebPropertyAccessor.xml
@@ -25,13 +25,16 @@
         <Parameter Name="target" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of a specified property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified property.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The property from which the value is retrieved.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web/DefaultHttpHandler.xml b/mcs/class/System.Web/Documentation/en/System.Web/DefaultHttpHandler.xml
index e75fafcc005..60d4f19e701 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web/DefaultHttpHandler.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web/DefaultHttpHandler.xml
@@ -65,7 +65,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -75,6 +74,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initiates an asynchronous call to the HTTP handler.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that contains information about the status of the process.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that provides references to intrinsic server objects that are used to service HTTP requests.</param>
         <param name="callback">
@@ -227,7 +230,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -255,6 +257,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Overrides the target URL for the current request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The overridden URL to use in the request; or null if an overridden URL is not provided.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web/HttpApplication.xml b/mcs/class/System.Web/Documentation/en/System.Web/HttpApplication.xml
index a356d8b7e62..ea776cf6de9 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web/HttpApplication.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web/HttpApplication.xml
@@ -1467,7 +1467,6 @@
         <Parameter Name="custom" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can override <see cref="M:System.Web.HttpApplication.GetVaryByCustomString(System.Web.HttpContext,System.String)" /> to add a new method for calculating custom vary-by values that are based on the current request. The implementation has to call the base class for custom values that it does not recognize. For more information, see <format type="text/html"><a href="b6c73735-a3cd-4d19-ba4d-0431881b0db0">How to: Cache Versions of a Page Using Custom Strings</a></format>. </para>
@@ -1476,6 +1475,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides an application-wide implementation of the <see cref="P:System.Web.UI.PartialCachingAttribute.VaryByCustom" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If the value of the <paramref name="custom" /> parameter is "browser", the browser's <see cref="P:System.Web.Configuration.HttpCapabilitiesBase.Type" />; otherwise, null.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Web.HttpContext" /> object that contains information about the current Web request. </param>
         <param name="custom">
@@ -2030,12 +2033,16 @@
         <Parameter Name="extraData" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initiates an asynchronous call to the HTTP event handler.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that contains information about the status of the process.</para>
+          <para />
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Web.HttpContext" /> that provides references to intrinsic server objects that are used to service HTTP requests.</param>
         <param name="cb">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web/HttpApplicationState.xml b/mcs/class/System.Web/Documentation/en/System.Web/HttpApplicationState.xml
index 3e1940eb600..aa1d3a807b6 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web/HttpApplicationState.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web/HttpApplicationState.xml
@@ -143,12 +143,15 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <see cref="T:System.Web.HttpApplicationState" /> object by numerical index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object referenced by <paramref name="index" />.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the application state object. </param>
       </Docs>
@@ -167,7 +170,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following example returns an object named MyAppVar1 from the <see cref="T:System.Web.HttpApplicationState" /> collection of the intrinsic <see cref="P:System.Web.HttpContext.Application" /> object and copies it to a new object variable.</para>
@@ -180,6 +182,10 @@ MyObject = Application.Get("MyAppVar1");</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <see cref="T:System.Web.HttpApplicationState" /> object by name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object referenced by <paramref name="name" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the object. </param>
       </Docs>
@@ -198,12 +204,15 @@ MyObject = Application.Get("MyAppVar1");</code>
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <see cref="T:System.Web.HttpApplicationState" /> object name by index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name under which the application state object was saved.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the application state object. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web/HttpClientCertificate.xml b/mcs/class/System.Web/Documentation/en/System.Web/HttpClientCertificate.xml
index 2f4b23392e0..bcf664d2a26 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web/HttpClientCertificate.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web/HttpClientCertificate.xml
@@ -140,12 +140,15 @@
         <Parameter Name="field" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns individual client certificate fields by name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the item specified by <paramref name="field" />.</para>
+        </returns>
         <param name="field">
           <attribution license="cc4" from="Microsoft" modified="false" />The item in the collection to retrieve. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web/HttpContext.xml b/mcs/class/System.Web/Documentation/en/System.Web/HttpContext.xml
index 015bc27941f..06f5ebabe24 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web/HttpContext.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web/HttpContext.xml
@@ -297,7 +297,6 @@ The routine internally uses a technique similar to thread local storage to fetch
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.HttpContext.GetAppConfig(System.String)" /> method has been deprecated. Use the <see cref="M:System.Web.Configuration.WebConfigurationManager.GetWebApplicationSection(System.String)" /> method of the <see cref="T:System.Web.Configuration.WebConfigurationManager" /> class to get configuration information for the current application.</para>
@@ -306,6 +305,10 @@ The routine internally uses a technique similar to thread local storage to fetch
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns requested configuration information for the current application.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object containing configuration information. (Cast the returned configuration section to the appropriate configuration type before use.)</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The application configuration tag for which information is requested.</param>
       </Docs>
@@ -329,7 +332,6 @@ The routine internally uses a technique similar to thread local storage to fetch
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.HttpContext.GetConfig(System.String)" /> method has been deprecated. Use the <see cref="M:System.Web.HttpContext.GetSection(System.String)" /> method to get configuration information for the current HTTP request. </para>
@@ -338,6 +340,10 @@ The routine internally uses a technique similar to thread local storage to fetch
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns requested configuration information for the current HTTP request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified <see cref="T:System.Configuration.ConfigurationSection" />, null if the section does not exist, or an internal object if the section is not accessible at run time. (Cast the returned object to the appropriate configuration type before use.) </para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The configuration tag for which information is requested.</param>
       </Docs>
@@ -365,7 +371,6 @@ The routine internally uses a technique similar to thread local storage to fetch
         <Parameter Name="resourceKey" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.HttpContext.GetGlobalResourceObject(System.String,System.String)" /> method returns a global resource by using the culture that is specified in the <see cref="P:System.Globalization.CultureInfo.CurrentUICulture" /> property.</para>
@@ -377,6 +382,10 @@ The routine internally uses a technique similar to thread local storage to fetch
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an application-level resource object based on the specified <see cref="P:System.Web.Compilation.ResourceExpressionFields.ClassKey" /> and <see cref="P:System.Web.Compilation.ResourceExpressionFields.ResourceKey" /> properties.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the requested application-level resource object; otherwise, null if a resource object is not found or if a resource object is found but it does not have the requested property.</para>
+        </returns>
         <param name="classKey">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents the <see cref="P:System.Web.Compilation.ResourceExpressionFields.ClassKey" /> property of the requested resource object.</param>
         <param name="resourceKey">
@@ -398,7 +407,6 @@ The routine internally uses a technique similar to thread local storage to fetch
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Globalization.CultureInfo" /> object represents the culture for which the resource was localized. If the resource is not localized for this culture, the lookup will follow a fallback process to locate an appropriate resource. For more information, see <format type="text/html"><a href="b224d7c0-35f8-4e82-a705-dd76795e8d16">Packaging and Deploying Resources</a></format>.</para>
@@ -410,6 +418,10 @@ The routine internally uses a technique similar to thread local storage to fetch
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an application-level resource object based on the specified <see cref="P:System.Web.Compilation.ResourceExpressionFields.ClassKey" /> and <see cref="P:System.Web.Compilation.ResourceExpressionFields.ResourceKey" /> properties, and on the <see cref="T:System.Globalization.CultureInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the requested application-level resource object, which is localized for the specified culture; otherwise, null if a resource object is not found or if a resource object is found but it does not have the requested property.</para>
+        </returns>
         <param name="classKey">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents the <see cref="P:System.Web.Compilation.ResourceExpressionFields.ClassKey" /> property of the requested resource object.</param>
         <param name="resourceKey">
@@ -432,7 +444,6 @@ The routine internally uses a technique similar to thread local storage to fetch
         <Parameter Name="resourceKey" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.HttpContext.GetLocalResourceObject(System.String,System.String)" /> method returns a local resource by using the culture that is specified in the <see cref="P:System.Globalization.CultureInfo.CurrentUICulture" /> property.</para>
@@ -441,6 +452,10 @@ The routine internally uses a technique similar to thread local storage to fetch
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a page-level resource object based on the specified <see cref="P:System.Web.Compilation.ExpressionBuilderContext.VirtualPath" /> and <see cref="P:System.Web.Compilation.ResourceExpressionFields.ResourceKey" /> properties.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the requested page-level resource object; otherwise, null if a matching resource object is found but not a <paramref name="resourceKey" /> parameter.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Web.Compilation.ExpressionBuilderContext.VirtualPath" /> property for the local resource object.</param>
         <param name="resourceKey">
@@ -462,7 +477,6 @@ The routine internally uses a technique similar to thread local storage to fetch
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the resource is not localized for this culture, the lookup will follow a fallback process to locate an appropriate resource. For more information, see <format type="text/html"><a href="b224d7c0-35f8-4e82-a705-dd76795e8d16">Packaging and Deploying Resources</a></format>.</para>
@@ -471,6 +485,10 @@ The routine internally uses a technique similar to thread local storage to fetch
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a page-level resource object based on the specified <see cref="P:System.Web.Compilation.ExpressionBuilderContext.VirtualPath" /> and <see cref="P:System.Web.Compilation.ResourceExpressionFields.ResourceKey" /> properties, and on the <see cref="T:System.Globalization.CultureInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the requested local resource object, which is localized for the specified culture; otherwise null if a matching resource object is found but not a <paramref name="resourceKey" /> parameter.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Web.Compilation.ExpressionBuilderContext.VirtualPath" /> property for the local resource object.</param>
         <param name="resourceKey">
@@ -493,12 +511,15 @@ The routine internally uses a technique similar to thread local storage to fetch
       </Parameters>
       <Docs>
         <param name="name">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a specified configuration section for the current application's default configuration. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified <see cref="T:System.Configuration.ConfigurationSection" />, null if the section does not exist, or an internal object if the section is not accessible at run time.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Handler">
@@ -912,7 +933,6 @@ The routine internally uses a technique similar to thread local storage to fetch
         <Parameter Name="service" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is useful to gain access to the underlying <see cref="T:System.Web.HttpWorkerRequest" /> object.</para>
@@ -921,6 +941,10 @@ The routine internally uses a technique similar to thread local storage to fetch
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object for the current service type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.HttpContext" />; otherwise, null if no service is found.</para>
+        </returns>
         <param name="service">
           <attribution license="cc4" from="Microsoft" modified="false" />A type of <see cref="T:System.Web.HttpContext" /> service to set the service provider to.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web/HttpCookieCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web/HttpCookieCollection.xml
index 37b173c2978..3a51f832ceb 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web/HttpCookieCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web/HttpCookieCollection.xml
@@ -142,12 +142,15 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'HttpCookie'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Web.HttpCookie" /> item with the specified index from the cookie collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.HttpCookie" /> specified by <paramref name="index" />.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the cookie to return from the collection. </param>
       </Docs>
@@ -166,7 +169,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'HttpCookie'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the named cookie does not exist, this method creates a new cookie with that name.</para>
@@ -175,6 +177,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the cookie with the specified name from the cookie collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.HttpCookie" /> specified by <paramref name="name" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the cookie to retrieve from the collection. </param>
       </Docs>
@@ -193,12 +199,15 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the key (name) of the cookie at the specified numerical index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the cookie specified by <paramref name="index" />.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the key to retrieve from the collection. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web/HttpException.xml b/mcs/class/System.Web/Documentation/en/System.Web/HttpException.xml
index cd016e176d1..6d03112b0a1 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web/HttpException.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web/HttpException.xml
@@ -258,12 +258,15 @@
         <Parameter Name="message" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'HttpException'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Web.HttpException" /> exception based on the error code that is returned from the Win32 API GetLastError() method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.HttpException" /> based on the error code that is returned from a call to the Win32 API GetLastError() method.</para>
+        </returns>
         <param name="message">
           <attribution license="cc4" from="Microsoft" modified="false" />The error message displayed to the client when the exception is thrown. </param>
       </Docs>
@@ -280,12 +283,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the HTML error message to return to the client.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The HTML error message.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -300,7 +306,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If there is a non-zero HTTP code, it is returned. Otherwise, the <see cref="P:System.Exception.InnerException" /> code is returned. If neither an <see cref="P:System.Exception.InnerException" /> code nor a non-zero HTTP code is available, the HTTP response status code 500 is returned. For more information on HTTP response status codes, see the Status Code Definitions of the Hypertext Transfer Protocol - HTTP/1.1 on the World <see cref="http://go.microsoft.com/fwlink/?linkid=37125">Wide Web Consortium (W3C) Web site</see>.</para>
@@ -309,6 +314,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the HTTP response status code to return to the client. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A non-zero HTTP code representing the exception or the <see cref="P:System.Exception.InnerException" /> code; otherwise, HTTP response status code 500.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web/HttpFileCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web/HttpFileCollection.xml
index 78de0ec41b6..03a309afc93 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web/HttpFileCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web/HttpFileCollection.xml
@@ -80,12 +80,15 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'HttpPostedFile'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Web.HttpPostedFile" /> object with the specified numerical index from the file collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.HttpPostedFile" /> object.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the object to be returned from the file collection. </param>
       </Docs>
@@ -105,12 +108,15 @@
       </Parameters>
       <Docs>
         <param name="key">a <see cref="T:System.String" /></param>
-        <returns>a <see cref="T:System.Web.HttpPostedFile" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Web.HttpPostedFile" /> object with the specified name from the file collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.HttpPostedFile" /> object. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -127,12 +133,15 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the <see cref="T:System.Web.HttpFileCollection" /> member with the specified numerical index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the <see cref="T:System.Web.HttpFileCollection" /> member specified by <paramref name="index" />.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the object name to be returned. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web/HttpModuleCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web/HttpModuleCollection.xml
index 13ed3b44daa..7ecae0f2d92 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web/HttpModuleCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web/HttpModuleCollection.xml
@@ -77,12 +77,15 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IHttpModule'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Web.IHttpModule" /> object with the specified index from the <see cref="T:System.Web.HttpModuleCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.IHttpModule" /> member specified by the <paramref name="index" /> parameter.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the <see cref="T:System.Web.IHttpModule" /> object to return from the collection. </param>
       </Docs>
@@ -102,12 +105,15 @@
       </Parameters>
       <Docs>
         <param name="key">a <see cref="T:System.String" /></param>
-        <returns>a <see cref="T:System.Web.IHttpModule" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Web.IHttpModule" /> object with the specified name from the <see cref="T:System.Web.HttpModuleCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Web.IHttpModule" /> member specified by the <paramref name="name" /> parameter.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -124,12 +130,15 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the key (name) of the <see cref="T:System.Web.IHttpModule" /> object at the specified numerical index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the <see cref="T:System.Web.IHttpModule" /> member specified by the <paramref name="index" /> parameter.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />Index of the key to retrieve from the collection. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web/HttpRequest.xml b/mcs/class/System.Web/Documentation/en/System.Web/HttpRequest.xml
index c806f644fd9..e52611ecb69 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web/HttpRequest.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web/HttpRequest.xml
@@ -152,7 +152,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.HttpRequest.BinaryRead(System.Int32)" /> method is provided for compatibility with ASP.</para>
@@ -161,6 +160,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a binary read of a specified number of bytes from the current input stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array.</para>
+        </returns>
         <param name="count">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of bytes to read. </param>
       </Docs>
@@ -583,12 +586,15 @@ The runtime puts a cap on the size of the maximum upload to avoid possible denia
         <Parameter Name="imageFieldName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Int32[]" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Maps an incoming image-field form parameter to appropriate x-coordinate and y-coordinate values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A two-dimensional array of integers.</para>
+        </returns>
         <param name="imageFieldName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the form image map. </param>
       </Docs>
@@ -607,7 +613,6 @@ The runtime puts a cap on the size of the maximum upload to avoid possible denia
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -618,6 +623,10 @@ The runtime puts a cap on the size of the maximum upload to avoid possible denia
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Maps the specified virtual path to a physical path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The physical path on the server specified by <paramref name="virtualPath" />.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path (absolute or relative) for the current request. </param>
       </Docs>
@@ -638,7 +647,6 @@ The runtime puts a cap on the size of the maximum upload to avoid possible denia
         <Parameter Name="allowCrossAppMapping" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -649,6 +657,10 @@ The runtime puts a cap on the size of the maximum upload to avoid possible denia
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Maps the specified virtual path to a physical path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The physical path on the server.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path (absolute or relative) for the current request. </param>
         <param name="baseVirtualDir">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web/HttpResponse.xml b/mcs/class/System.Web/Documentation/en/System.Web/HttpResponse.xml
index 0b5f9e199d3..31ca962701a 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web/HttpResponse.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web/HttpResponse.xml
@@ -418,7 +418,6 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -428,6 +427,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a session ID to the virtual path if the session is using <see cref="P:System.Web.Configuration.SessionStateSection.Cookieless" /> session state and returns the combined path. If <see cref="P:System.Web.Configuration.SessionStateSection.Cookieless" /> session state is not used, <see cref="M:System.Web.HttpResponse.ApplyAppPathModifier(System.String)" /> returns the original virtual path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <paramref name="virtualPath" /> with the session ID inserted.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path to a resource. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web/HttpServerUtility.xml b/mcs/class/System.Web/Documentation/en/System.Web/HttpServerUtility.xml
index 2ab2d80fa23..32612fb89a2 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web/HttpServerUtility.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web/HttpServerUtility.xml
@@ -53,12 +53,15 @@
         <Parameter Name="progID" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a server instance of a COM object identified by the object's programmatic identifier (ProgID).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new object.</para>
+        </returns>
         <param name="progID">
           <attribution license="cc4" from="Microsoft" modified="false" />The class or type of object to create an instance of.</param>
       </Docs>
@@ -77,12 +80,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a server instance of a COM object identified by the object's type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new object.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> representing the object to create.</param>
       </Docs>
@@ -101,12 +107,15 @@
         <Parameter Name="clsid" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a server instance of a COM object identified by the object's class identifier (CLSID).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new object.</para>
+        </returns>
         <param name="clsid">
           <attribution license="cc4" from="Microsoft" modified="false" />The class identifier of the object to create an instance of.</param>
       </Docs>
@@ -277,12 +286,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Exception'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the previous exception.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The previous exception that was thrown.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -299,7 +311,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>HTML encoding makes sure that text is displayed correctly in the browser and not interpreted by the browser as HTML. For example, if a text string contains a less than sign (&lt;) or greater than sign (&gt;), the browser would interpret these characters as the opening or closing bracket of an HTML tag. When the characters are HTML encoded, they are converted to the strings &amp;lt; and &amp;gt;, which causes the browser to display the less than sign and greater than sign correctly. <see cref="M:System.Web.HttpServerUtility.HtmlDecode(System.String)" /> decodes text that has been transmitted to the server.</para>
@@ -311,6 +322,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes an HTML-encoded string and returns the decoded string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The decoded text.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The HTML string to decode.</param>
       </Docs>
@@ -363,7 +378,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>HTML encoding makes sure that text is displayed correctly in the browser and not interpreted by the browser as HTML. For example, if a text string contains a less than sign (&lt;) or greater than sign (&gt;), the browser would interpret these characters as the opening or closing bracket of an HTML tag. When the characters are HTML encoded, they are converted to the strings &amp;lt; and &amp;gt;, which causes the browser to display the less than sign and greater than sign correctly.</para>
@@ -375,6 +389,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>HTML-encodes a string and returns the encoded string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The HTML-encoded text.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The text string to encode.</param>
       </Docs>
@@ -444,7 +462,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="path" /> is null, then the <see cref="M:System.Web.HttpServerUtility.MapPath(System.String)" /> method returns the full physical path of the directory that contains the current application.</para>
@@ -456,6 +473,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the physical file path that corresponds to the specified virtual path on the Web server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The physical file path that corresponds to <paramref name="path" />.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path of the Web server.</param>
       </Docs>
@@ -599,7 +620,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>URL encoding ensures that all browsers will correctly transmit text in URL strings. Characters such as a question mark (?), ampersand (&amp;), slash mark (/), and spaces might be truncated or corrupted by some browsers. As a result, these characters must be encoded in &lt;a&gt; tags or in query strings where the strings can be re-sent by a browser in a request string.</para>
@@ -611,6 +631,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>URL-decodes a string and returns the decoded string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The decoded text.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The text string to decode.</param>
       </Docs>
@@ -661,7 +685,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>URL encoding ensures that all browsers will correctly transmit text in URL strings. Characters such as a question mark (?), ampersand (&amp;), slash mark (/), and spaces might be truncated or corrupted by some browsers. As a result, these characters must be encoded in &lt;a&gt; tags or in query strings where the strings can be re-sent by a browser in a request string.</para>
@@ -673,6 +696,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>URL-encodes a string and returns the encoded string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The URL-encoded text.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to URL-encode.</param>
       </Docs>
@@ -723,12 +750,15 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Do not use; intended only for browser compatibility. Use <see cref="M:System.Web.HttpServerUtility.UrlEncode(System.String)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The URL encoded text.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to URL-encode.</param>
       </Docs>
@@ -750,7 +780,6 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.HttpServerUtility.UrlTokenDecode(System.String)" /> method converts a URL string token, which encodes binary data as base 64 digits, to its equivalent byte array representation. Use the <see cref="M:System.Web.HttpServerUtility.UrlTokenDecode(System.String)" /> method to decode tokens transmitted on the URL and encoded by using the <see cref="M:System.Web.HttpServerUtility.UrlTokenEncode(System.Byte[])" />.</para>
@@ -760,6 +789,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes a URL string token to its equivalent byte array using base 64 digits.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The byte array containing the decoded URL string token.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The URL string token to decode.</param>
       </Docs>
@@ -777,7 +810,6 @@
         <Parameter Name="input" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.HttpServerUtility.UrlTokenEncode(System.Byte[])" /> method converts a byte array into an equivalent string representation encoded with base 64 digits. The resulting string token can be transmitted on the URL.</para>
@@ -787,6 +819,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes a byte array into its equivalent string representation using base 64 digits, which is usable for transmission on the URL.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string containing the encoded token if the byte array length is greater than one; otherwise, an empty string ("").</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array to encode.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web/HttpStaticObjectsCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web/HttpStaticObjectsCollection.xml
index 0ad2d863e05..0905850af33 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web/HttpStaticObjectsCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web/HttpStaticObjectsCollection.xml
@@ -100,7 +100,6 @@
         <Parameter Name="reader" Type="System.IO.BinaryReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.HttpStaticObjectsCollection.Deserialize(System.IO.BinaryReader)" /> method is used to read the contents of a <see cref="T:System.Web.HttpStaticObjectsCollection" /> object that is stored in a storage location that is created by the <see cref="M:System.Web.HttpStaticObjectsCollection.Serialize(System.IO.BinaryWriter)" /> method. To serialize an <see cref="T:System.Web.HttpStaticObjectsCollection" />, use the <see cref="M:System.Web.HttpStaticObjectsCollection.Serialize(System.IO.BinaryWriter)" /> method.</para>
@@ -109,6 +108,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Web.HttpStaticObjectsCollection" /> object from a binary file that was written by using the <see cref="M:System.Web.HttpStaticObjectsCollection.Serialize(System.IO.BinaryWriter)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.HttpStaticObjectsCollection" /> populated with the contents from a binary file written using the <see cref="M:System.Web.HttpStaticObjectsCollection.Serialize(System.IO.BinaryWriter)" /> method.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.BinaryReader" /> used to read the serialized collection from a stream or encoded string.</param>
       </Docs>
@@ -121,12 +124,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a <see cref="T:System.Collections.IEnumerator" /></returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a dictionary enumerator used for iterating through the key-and-value pairs contained in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The enumerator for the collection.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -143,12 +149,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the object with the specified name from the collection. This property is an alternative to the this accessor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object from the collection.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The case-insensitive name of the object to return. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web/HttpUtility.xml b/mcs/class/System.Web/Documentation/en/System.Web/HttpUtility.xml
index feab5a23f19..95e31a037f8 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web/HttpUtility.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web/HttpUtility.xml
@@ -55,7 +55,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.HttpUtility.HtmlAttributeEncode(System.String)" /> method converts only quotation marks ("), ampersands (&amp;), and left angle brackets (&lt;) to equivalent character entities. It is considerably faster than the <see cref="M:System.Web.HttpUtility.HtmlEncode(System.String)" /> method. </para>
@@ -65,6 +64,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Minimally converts a string to an HTML-encoded string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An encoded string.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to encode. </param>
       </Docs>
@@ -113,7 +116,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If characters such as blanks and punctuation are passed in an HTTP stream, they might be misinterpreted at the receiving end. HTML encoding converts characters that are not allowed in HTML into character-entity equivalents; HTML decoding reverses the encoding. For example, when embedded in a block of text, the characters &lt; and &gt; are encoded as &amp;lt; and &amp;gt; for HTTP transmission.</para>
@@ -123,6 +125,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string that has been HTML-encoded for HTTP transmission into a decoded string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decoded string.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to decode. </param>
       </Docs>
@@ -171,7 +177,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If characters such as blanks and punctuation are passed in an HTTP stream, they might be misinterpreted at the receiving end. HTML encoding converts characters that are not allowed in HTML into character-entity equivalents; HTML decoding reverses the encoding. For example, when embedded in a block of text, the characters &lt; and &gt; are encoded as &amp;lt; and &amp;gt; for HTTP transmission.</para>
@@ -181,6 +186,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string to an HTML-encoded string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An encoded string.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to encode. </param>
       </Docs>
@@ -232,7 +241,6 @@
         <Parameter Name="query" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.HttpUtility.ParseQueryString(System.String)" /> method uses <see cref="P:System.Text.Encoding.UTF8" /> format to parse the query string In the returned <see cref="T:System.Collections.Specialized.NameValueCollection" />, URL-encoded characters are decoded and multiple occurrences of the same query string parameter are listed as a single entry with a comma separating each value. </para>
@@ -244,6 +252,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Parses a query string into a <see cref="T:System.Collections.Specialized.NameValueCollection" /> using <see cref="P:System.Text.Encoding.UTF8" /> encoding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.Specialized.NameValueCollection" /> of query parameters and values.</para>
+        </returns>
         <param name="query">
           <attribution license="cc4" from="Microsoft" modified="false" />The query string to parse.</param>
       </Docs>
@@ -262,7 +274,6 @@
         <Parameter Name="encoding" Type="System.Text.Encoding" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In the returned <see cref="T:System.Collections.Specialized.NameValueCollection" />, URL-encoded characters are decoded and multiple occurrences of the same query string parameter are listed as a single entry with a comma separating each value. </para>
@@ -274,6 +285,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Parses a query string into a <see cref="T:System.Collections.Specialized.NameValueCollection" /> using the specified <see cref="T:System.Text.Encoding" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.Specialized.NameValueCollection" /> of query parameters and values.</para>
+        </returns>
         <param name="query">
           <attribution license="cc4" from="Microsoft" modified="false" />The query string to parse.</param>
         <param name="encoding">
@@ -290,7 +305,6 @@
         <Parameter Name="str" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>The decoded URL</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If characters such as blanks and punctuation are passed in an HTTP stream, they might be misinterpreted at the receiving end. URL encoding converts characters that are not allowed in a URL into character-entity equivalents; URL decoding reverses the encoding. For example, when embedded in a block of text to be transmitted in a URL, the characters &lt; and &gt; are encoded as %3c and %3e.</para>
@@ -300,6 +314,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string that has been encoded for transmission in a URL into a decoded string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decoded string.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to decode. </param>
       </Docs>
@@ -319,7 +337,6 @@
         <Parameter Name="e" Type="System.Text.Encoding" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If characters such as blanks and punctuation are passed in an HTTP stream, they might be misinterpreted at the receiving end. URL encoding converts characters that are not allowed in a URL into character-entity equivalents; URL decoding reverses the encoding. For example, when embedded in a block of text to be transmitted in a URL, the characters &lt; and &gt; are encoded as %3c and %3e.</para>
@@ -329,6 +346,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a URL-encoded byte array into a decoded string using the specified decoding object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decoded string.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of bytes to decode. </param>
         <param name="e">
@@ -351,7 +372,6 @@
       </Parameters>
       <Docs>
         <param name="s">a <see cref="T:System.String" /></param>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If characters such as blanks and punctuation are passed in an HTTP stream, they might be misinterpreted at the receiving end. URL encoding converts characters that are not allowed in a URL into character-entity equivalents; URL decoding reverses the encoding. For example, when embedded in a block of text to be transmitted in a URL, the characters &lt; and &gt; are encoded as %3c and %3e.</para>
@@ -361,6 +381,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a URL-encoded string into a decoded string, using the specified encoding object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decoded string.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Text.Encoding" /> that specifies the decoding scheme. </param>
       </Docs>
@@ -382,7 +406,6 @@
         <Parameter Name="e" Type="System.Text.Encoding" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If characters such as blanks and punctuation are passed in an HTTP stream, they might be misinterpreted at the receiving end. URL encoding converts characters that are not allowed in a URL into character-entity equivalents; URL decoding reverses the encoding. For example, when embedded in a block of text to be transmitted in a URL the characters &lt; and &gt; are encoded as %3c and %3e.</para>
@@ -392,6 +415,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a URL-encoded byte array into a decoded string using the specified encoding object, starting at the specified position in the array, and continuing for the specified number of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decoded string.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of bytes to decode. </param>
         <param name="offset">
@@ -416,7 +443,6 @@
         <Parameter Name="bytes" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If characters such as blanks and punctuation are passed in an HTTP stream, they might be misinterpreted at the receiving end. URL encoding converts characters that are not allowed in a URL into character-entity equivalents; URL decoding reverses the encoding. For example, when embedded in a block of text to be transmitted in a URL, the characters &lt; and &gt; are encoded as %3c and %3e.</para>
@@ -426,6 +452,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a URL-encoded array of bytes into a decoded array of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decoded array of bytes.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of bytes to decode. </param>
       </Docs>
@@ -444,7 +474,6 @@
         <Parameter Name="str" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If characters such as blanks and punctuation are passed in an HTTP stream, they might be misinterpreted at the receiving end. URL encoding converts characters that are not allowed in a URL into character-entity equivalents; URL decoding reverses the encoding. For example, when embedded in a block of text to be transmitted in a URL, the characters &lt; and &gt; are encoded as %3c and %3e.</para>
@@ -454,6 +483,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a URL-encoded string into a decoded array of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decoded array of bytes.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to decode. </param>
       </Docs>
@@ -473,7 +506,6 @@
         <Parameter Name="e" Type="System.Text.Encoding" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Byte[]" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If characters such as blanks and punctuation are passed in an HTTP stream, they might be misinterpreted at the receiving end. URL encoding converts characters that are not allowed in a URL into character-entity equivalents; URL decoding reverses the encoding. For example, when embedded in a block of text to be transmitted in a URL, the characters &lt; and &gt; are encoded as %3c and %3e.</para>
@@ -483,6 +515,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a URL-encoded string into a decoded array of bytes using the specified decoding object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decoded array of bytes.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to decode. </param>
         <param name="e">
@@ -505,7 +541,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If characters such as blanks and punctuation are passed in an HTTP stream, they might be misinterpreted at the receiving end. URL encoding converts characters that are not allowed in a URL into character-entity equivalents; URL decoding reverses the encoding. For example, when embedded in a block of text to be transmitted in a URL, the characters &lt; and &gt; are encoded as %3c and %3e.</para>
@@ -515,6 +550,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a URL-encoded array of bytes into a decoded array of bytes, starting at the specified position in the array and continuing for the specified number of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decoded array of bytes.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of bytes to decode. </param>
         <param name="offset">
@@ -537,7 +576,6 @@
         <Parameter Name="bytes" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.HttpUtility.UrlEncode(System.Byte[])" /> method can be used to encode the entire URL, including query-string values. If characters such as blanks and punctuation are passed in an HTTP stream, they might be misinterpreted at the receiving end. URL encoding converts characters that are not allowed in a URL into character-entity equivalents; URL decoding reverses the encoding. For example, when the characters &lt; and &gt; are embedded in a block of text to be transmitted in a URL, they are encoded as %3c and %3e.</para>
@@ -547,6 +585,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a byte array into an encoded URL string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An encoded string.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of bytes to encode. </param>
       </Docs>
@@ -565,7 +607,6 @@
         <Parameter Name="str" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.HttpUtility.UrlEncode(System.String)" /> method can be used to encode the entire URL, including query-string values. If characters such as blanks and punctuation are passed in an HTTP stream without encoding, they might be misinterpreted at the receiving end. URL encoding converts characters that are not allowed in a URL into character-entity equivalents; URL decoding reverses the encoding. For example, when the characters &lt; and &gt; are embedded in a block of text to be transmitted in a URL, they are encoded as %3c and %3e.</para>
@@ -579,6 +620,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes a URL string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An encoded string.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to encode. </param>
       </Docs>
@@ -600,7 +645,6 @@
       <Docs>
         <param name="s">a <see cref="T:System.String" /></param>
         <param name="Enc">a <see cref="T:System.Text.Encoding" /></param>
-        <returns>a <see cref="T:System.String" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to encode the entire URL, including query-string values. If characters such as blanks and punctuation are passed in an HTTP stream, they might be misinterpreted at the receiving end. URL encoding converts characters that are not allowed in a URL into character-entity equivalents; URL decoding reverses the encoding. For example, when the characters &lt; and &gt; are embedded in a block of text to be transmitted in a URL, they are encoded as %3c and %3e.</para>
@@ -610,6 +654,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes a URL string using the specified encoding object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An encoded string.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -628,7 +676,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.HttpUtility.UrlEncode(System.String)" /> method can be used to encode the entire URL, including query-string values. If characters such as blanks and punctuation are passed in an HTTP stream, they might be misinterpreted at the receiving end. URL encoding converts characters that are not allowed in a URL into character-entity equivalents; URL decoding reverses the encoding. For example, when the characters &lt; and &gt; are embedded in a block of text to be transmitted in a URL, they are encoded as %3c and %3e.</para>
@@ -638,6 +685,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a byte array into a URL-encoded string, starting at the specified position in the array and continuing for the specified number of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An encoded string.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of bytes to encode. </param>
         <param name="offset">
@@ -660,7 +711,6 @@
         <Parameter Name="bytes" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If characters such as blanks and punctuation are passed in an HTTP stream, they might be misinterpreted at the receiving end. URL encoding converts characters that are not allowed in a URL into character-entity equivalents; URL decoding reverses the encoding. For example, when embedded in a block of text to be transmitted in a URL, the characters &lt; and &gt; are encoded as %3c and %3e.</para>
@@ -670,6 +720,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an array of bytes into a URL-encoded array of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An encoded array of bytes.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of bytes to encode. </param>
       </Docs>
@@ -688,7 +742,6 @@
         <Parameter Name="str" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If characters such as blanks and punctuation are passed in an HTTP stream, they might be misinterpreted at the receiving end. URL encoding converts characters that are not allowed in a URL into character-entity equivalents; URL decoding reverses the encoding. For example, when embedded in a block of text to be transmitted in a URL, the characters &lt; and &gt; are encoded as %3c and %3e.</para>
@@ -698,6 +751,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string into a URL-encoded array of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An encoded array of bytes.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to encode. </param>
       </Docs>
@@ -717,7 +774,6 @@
         <Parameter Name="e" Type="System.Text.Encoding" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Byte[]" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If characters such as blanks and punctuation are passed in an HTTP stream, they might be misinterpreted at the receiving end. URL encoding converts characters that are not allowed in a URL into character-entity equivalents; URL decoding reverses the encoding. For example, when embedded in a block of text to be transmitted in a URL, the characters &lt; and &gt; are encoded as %3c and %3e.</para>
@@ -727,6 +783,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string into a URL-encoded array of bytes using the specified encoding object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An encoded array of bytes.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to encode </param>
         <param name="e">
@@ -749,7 +809,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If characters such as blanks and punctuation are passed in an HTTP stream, they might be misinterpreted at the receiving end. URL encoding converts characters that are not allowed in a URL into character-entity equivalents; URL decoding reverses the encoding. For example, when embedded in a block of text to be transmitted in a URL, the characters &lt; and &gt; are encoded as %3c and %3e.</para>
@@ -759,6 +818,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an array of bytes into a URL-encoded array of bytes, starting at the specified position in the array and continuing for the specified number of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An encoded array of bytes.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of bytes to encode. </param>
         <param name="offset">
@@ -781,7 +844,6 @@
         <Parameter Name="str" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If characters such as blanks and punctuation are passed in an HTTP stream, they might be misinterpreted at the receiving end. URL encoding converts characters that are not valid in a URL to character-entity equivalents; URL decoding reverses the encoding. For example, when embedded in a block of text to be transmitted in a URL, the characters &lt; and &gt; are encoded as %3c and %3e.</para>
@@ -790,6 +852,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string into a Unicode string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Unicode string in %<paramref name="UnicodeValue" /> notation.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert. </param>
       </Docs>
@@ -808,7 +874,6 @@
         <Parameter Name="str" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If characters such as blanks and punctuation are passed in an HTTP stream, they might be misinterpreted at the receiving end. URL encoding converts characters that are not valid in a URL to character-entity equivalents; URL decoding reverses the encoding. For example, when embedded in a block of text to be transmitted in a URL, the characters &lt; and &gt; are encoded as %3c and %3e.</para>
@@ -817,6 +882,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a Unicode string into an array of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert. </param>
       </Docs>
@@ -836,12 +905,15 @@
       </Parameters>
       <Docs>
         <param name="s">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Do not use; intended only for browser compatibility. Use <see cref="M:System.Web.HttpUtility.UrlEncode(System.String)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The encoded text.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web/HttpWorkerRequest.xml b/mcs/class/System.Web/Documentation/en/System.Web/HttpWorkerRequest.xml
index c4d897faaef..3904d65284d 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web/HttpWorkerRequest.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web/HttpWorkerRequest.xml
@@ -119,12 +119,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the virtual path to the currently executing server application.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The virtual path of the current application.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -139,12 +142,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the physical path to the currently executing server application.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The physical path of the current application.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -159,12 +165,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the application pool ID for the current URL.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always returns null.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -179,12 +188,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the number of bytes read in from the client.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Long containing the number of bytes read.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -199,7 +211,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If no certificate is sent, the <see cref="P:System.Web.HttpRequest.ClientCertificate" /> collection returns empty.</para>
@@ -208,6 +219,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, gets the certification fields (specified in the X.509 standard) from a request issued by the client.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array containing the stream of the entire certificate content.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -222,12 +237,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the certificate issuer, in binary format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array containing the certificate issuer expressed in binary format.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -242,12 +260,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the <see cref="T:System.Text.Encoding" /> object in which the client certificate was encoded. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The certificate encoding, expressed as an integer.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -262,12 +283,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, gets a PublicKey object associated with the client certificate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A PublicKey object.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -282,12 +306,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'DateTime'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, gets the date when the certificate becomes valid. The date varies with international settings. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DateTime" /> object representing when the certificate becomes valid.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -302,12 +329,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'DateTime'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the certificate expiration date.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DateTime" /> object representing the date that the certificate expires.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -322,12 +352,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the ID of the current connection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always returns 0.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -342,12 +375,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the virtual path to the requested URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The path to the requested URI.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -362,12 +398,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the physical file path to the requested URI (and translates it from virtual path to physical path: for example, "/proj1/page.aspx" to "c:\dir\page.aspx") </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The translated physical file path to the requested URI.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -382,12 +421,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified member of the request header.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The HTTP verb returned in the request header.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -402,12 +444,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides access to the HTTP version of the request (for example, "HTTP/1.1").</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The HTTP version returned in the request header.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -424,7 +469,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>The value of the given header on the HTTP request or null if the header value was not set.</returns>
         <remarks>For example to obtain the value of the Content-Length header, you can use:
 
 
@@ -435,6 +479,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the standard HTTP request header that corresponds to the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The HTTP request header.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the header. For example, the <see cref="F:System.Web.HttpWorkerRequest.HeaderAllow" /> field. </param>
       </Docs>
@@ -453,12 +501,15 @@
         <Parameter Name="header" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>The index of the header or -1 if the header is not known to the runtime.</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index number of the specified HTTP request header.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index number of the HTTP request header specified in the <paramref name="header" /> parameter.</para>
+        </returns>
         <param name="header">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the header. </param>
       </Docs>
@@ -477,12 +528,15 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>The HTTP header name.   An exception is thrown if an invalid index is passed.</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the specified HTTP request header.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the HTTP request header specified in the <paramref name="index" /> parameter.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index number of the header. </param>
       </Docs>
@@ -501,12 +555,15 @@
         <Parameter Name="header" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index number of the specified HTTP response header.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index number of the HTTP response header specified in the <paramref name="header" /> parameter.</para>
+        </returns>
         <param name="header">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the HTTP header. </param>
       </Docs>
@@ -525,12 +582,15 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the specified HTTP response header.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the HTTP response header specified in the <paramref name="index" /> parameter.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index number of the header. </param>
       </Docs>
@@ -547,12 +607,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides access to the specified member of the request header.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The server IP address returned in the request header.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -567,12 +630,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides access to the specified member of the request header.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The server port number returned in the request header.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -587,12 +653,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns additional path information for a resource with a URL extension. That is, for the path /virdir/page.html/tail, the GetPathInfo value is /tail.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Additional path information for a resource.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -607,7 +676,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>The byte array containing the data that has been prefetched.</returns>
         <remarks>This method should be invoked prior to calling <see cref="M:System.Web.HttpWorkerRequest.ReadEntityBody(byte[], int)" /> as the web server implementing this class might have loaded some data in advance.
 <para>
 See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see cref="M:System.Web.HttpWorkerRequest.IsEntireEntityBodyIsPreloaded()" />.
@@ -616,6 +684,10 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the portion of the HTTP request body that has already been read.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The portion of the HTTP request body that has been read.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -636,12 +708,15 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
         <Parameter Name="offset" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the portion of the HTTP request body that has currently been read by using the specified buffer data and byte offset.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The portion of the HTTP request body that has been read.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The data to read.</param>
         <param name="offset">
@@ -659,12 +734,15 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the length of the portion of the HTTP request body that has currently been read.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer containing the length of the currently read HTTP request body.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetProtocol">
@@ -675,12 +753,15 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the HTTP protocol (HTTP or HTTPS).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>HTTPS if the <see cref="M:System.Web.HttpWorkerRequest.IsSecure" /> method is true, otherwise HTTP.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -695,12 +776,15 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the query string specified in the request URL.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The request query string.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -715,12 +799,15 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the response query string as an array of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of bytes containing the response.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -735,12 +822,15 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the URL path contained in the request header with the query string appended.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The raw URL path of the request header.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -755,12 +845,15 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides access to the specified member of the request header.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The client's IP address.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -775,12 +868,15 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the name of the client computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the client computer.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -795,12 +891,15 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides access to the specified member of the request header.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The client's HTTP port number.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -815,12 +914,15 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the reason for the request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Reason code. The default is ReasonResponseCacheMiss.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -835,12 +937,15 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the name of the local server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the local server.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -857,12 +962,15 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a single server variable from a dictionary of server variables associated with the request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The requested server variable.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the requested server variable. </param>
       </Docs>
@@ -881,12 +989,15 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
         <Parameter Name="code" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that describes the name of the specified HTTP status code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The status description. For example, <see cref="M:System.Web.HttpWorkerRequest.GetStatusDescription(System.Int32)" /> (404) returns "Not Found".</para>
+        </returns>
         <param name="code">
           <attribution license="cc4" from="Microsoft" modified="false" />The HTTP status code. </param>
       </Docs>
@@ -906,12 +1017,15 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the length of the entire HTTP request body.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer containing the length of the entire HTTP request body.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetUnknownRequestHeader">
@@ -924,12 +1038,15 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a nonstandard HTTP request header value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The header value.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The header name. </param>
       </Docs>
@@ -946,12 +1063,15 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'String[] []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Get all nonstandard HTTP header name-value pairs.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of header name-value pairs.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -971,12 +1091,15 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the virtual path to the requested URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The path to the requested URI.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -991,12 +1114,15 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the context ID of the current connection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always returns 0.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1011,12 +1137,15 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the client's impersonation token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value representing the client's impersonation token. The default is 0.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1031,12 +1160,15 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the impersonation token for the request virtual path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An unmanaged memory pointer for the token for the request virtual path.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -1051,7 +1183,6 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>Returns <see langword="true" /> if the HTTP request has a body (for example during a POST request).</returns>
         <remarks>See also: <see cref="M:System.Web.HttpWorkerRequest.IsEntireEntityBodyIsPreloaded()" /> ,
 <see cref="M:System.Web.HttpWorkerRequest.GetPreloadedEntityBody()" /> and
 <see cref="M:System.Web.HttpWorkerRequest.ReadEntityBody(byte[], int)" /></remarks>
@@ -1059,6 +1190,10 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the request contains body data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the request contains body data; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -2016,12 +2151,15 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether HTTP response headers have been sent to the client for the current request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if HTTP response headers have been sent to the client; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -2243,12 +2381,15 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the client connection is still active.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the client connection is still active; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -2263,12 +2404,15 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether all request data is available and no further reads from the client are required.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if all request data is available; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -2283,12 +2427,15 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the connection uses SSL.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the connection is an SSL connection; otherwise, false. The default is false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -2343,12 +2490,15 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the physical path corresponding to the specified virtual path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The physical path that corresponds to the virtual path specified in the <paramref name="virtualPath" /> parameter.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path. </param>
       </Docs>
@@ -2368,7 +2518,6 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
         <Parameter Name="size" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>The number of bytes read into the buffer.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An implementation is free to return fewer bytes than requested even if the end of the stream has not been reached.</para>
@@ -2378,6 +2527,10 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads request data from the client (when not preloaded).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes read.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array to read data into. </param>
         <param name="size">
@@ -2403,7 +2556,6 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
         <Parameter Name="size" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An implementation is free to return fewer bytes than requested even if the end of the stream has not been reached.</para>
@@ -2413,6 +2565,10 @@ See also: <see cref="M:System.Web.HttpWorkerRequest.HasEntityBody()" /> and <see
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads request data from the client (when not preloaded) by using the specified buffer to read from, byte offset, and maximum bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes read.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array to read data into.</param>
         <param name="offset">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web/IHttpAsyncHandler.xml b/mcs/class/System.Web/Documentation/en/System.Web/IHttpAsyncHandler.xml
index 02b8371944b..3a416f5f833 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web/IHttpAsyncHandler.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web/IHttpAsyncHandler.xml
@@ -37,12 +37,15 @@
         <Parameter Name="extraData" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IAsyncResult'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initiates an asynchronous call to the HTTP handler.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that contains information about the status of the process.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Web.HttpContext" /> object that provides references to intrinsic server objects (for example, Request, Response, Session, and Server) used to service HTTP requests. </param>
         <param name="cb">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web/IHttpHandlerFactory.xml b/mcs/class/System.Web/Documentation/en/System.Web/IHttpHandlerFactory.xml
index 9ff7ce976e1..06ce6acf337 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web/IHttpHandlerFactory.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web/IHttpHandlerFactory.xml
@@ -34,12 +34,15 @@
         <Parameter Name="pathTranslated" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IHttpHandler'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an instance of a class that implements the <see cref="T:System.Web.IHttpHandler" /> interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Web.IHttpHandler" /> object that processes the request.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of the <see cref="T:System.Web.HttpContext" /> class that provides references to intrinsic server objects (for example, Request, Response, Session, and Server) used to service HTTP requests. </param>
         <param name="requestType">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web/IPartitionResolver.xml b/mcs/class/System.Web/Documentation/en/System.Web/IPartitionResolver.xml
index dbb316924d8..9bd7ae4998d 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web/IPartitionResolver.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web/IPartitionResolver.xml
@@ -61,7 +61,6 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="key" /> parameter of the <see cref="M:System.Web.IPartitionResolver.ResolvePartition(System.Object)" /> method is the <see cref="P:System.Web.SessionState.HttpSessionState.SessionID" /> property. The <see cref="P:System.Web.SessionState.HttpSessionState.SessionID" /> property uniquely identifies a browser with session data on the server.</para>
@@ -70,6 +69,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resolves the partition based on a key parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string with connection information.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />An identifier used to determine which partition to use for the current session state.</param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web/ParserErrorCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web/ParserErrorCollection.xml
index 0888137e871..540e60d565f 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web/ParserErrorCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web/ParserErrorCollection.xml
@@ -94,7 +94,6 @@
       </Parameters>
       <Docs>
         <param name="error">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -105,6 +104,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a value to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the value within the collection; otherwise, -1 if the value is already in the collection.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -171,7 +174,6 @@
       </Parameters>
       <Docs>
         <param name="error">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -181,6 +183,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Web.ParserError" /> object is located in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.ParserError" /> is in the collection; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -239,7 +245,6 @@
       </Parameters>
       <Docs>
         <param name="error">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -249,6 +254,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the specified <see cref="T:System.Web.ParserError" /> object in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the <see cref="T:System.Web.ParserError" /> objects within the collection; otherwise, 1 if the <see cref="T:System.Web.ParserError" /> is not in the collection.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web/ProcessModelInfo.xml b/mcs/class/System.Web/Documentation/en/System.Web/ProcessModelInfo.xml
index 0793262712a..5579fd76b34 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web/ProcessModelInfo.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web/ProcessModelInfo.xml
@@ -52,7 +52,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ProcessInfo'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.ProcessModelInfo.GetCurrentProcessInfo" /> method is applicable only for applications that are running under the ASP.NET process model.</para>
@@ -61,6 +60,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns information about the worker process that is executing the current request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.ProcessInfo" /> that contains information about the current process.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -77,7 +80,6 @@
         <Parameter Name="numRecords" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Web.ProcessInfo[]" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.ProcessModelInfo.GetHistory(System.Int32)" /> method is applicable only for applications that are running under the ASP.NET process model.</para>
@@ -86,6 +88,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns information about recent worker processes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of the most recent <see cref="T:System.Web.ProcessInfo" /> objects (up to 100); otherwise, if the number of available objects is less than <paramref name="numRecords" />, all available objects.</para>
+        </returns>
         <param name="numRecords">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of processes for which information is requested. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web/SiteMapNode.xml b/mcs/class/System.Web/Documentation/en/System.Web/SiteMapNode.xml
index 6c5a1a300df..f8b122b50fc 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web/SiteMapNode.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web/SiteMapNode.xml
@@ -262,7 +262,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -272,6 +271,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new node that is a copy of the current node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new node that is a copy of the current node.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -287,7 +290,6 @@
         <Parameter Name="cloneParentNodes" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -298,6 +300,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new copy that is a copy of the current node, optionally cloning all parent and ancestor nodes of the current node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new node that is a copy of the current node.</para>
+        </returns>
         <param name="cloneParentNodes">
           <attribution license="cc4" from="Microsoft" modified="false" />true to clone all parent and ancestor nodes of the current node; otherwise, false.</param>
       </Docs>
@@ -344,7 +350,6 @@
       </Parameters>
       <Docs>
         <param name="ob">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -362,6 +367,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the current <see cref="T:System.Web.SiteMapNode" /> is identical to the specified object. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is both a <see cref="T:System.Web.SiteMapNode" /> and identical to the current <see cref="T:System.Web.SiteMapNode" />; otherwise, false. </para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -375,7 +384,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -385,6 +393,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a read-only collection of all <see cref="T:System.Web.SiteMapNode" /> objects that are descendants of the calling node, regardless of the degree of separation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A read-only <see cref="T:System.Web.SiteMapNodeCollection" /> that represents all the descendants of a <see cref="T:System.Web.SiteMapNode" /> within the scope of the current provider.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -401,13 +413,16 @@
         <Parameter Name="viewName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the <see cref="T:System.Web.UI.WebControls.SiteMapDataSourceView" /> object that is associated with the current node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A named <see cref="T:System.Web.UI.WebControls.SiteMapDataSourceView" /> for the current node.</para>
+        </returns>
         <param name="owner">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.WebControls.SiteMapDataSource" /> control that the view is associated with.</param>
         <param name="viewName">
@@ -429,7 +444,6 @@
         <Parameter Name="throwIfNotFound" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -444,6 +458,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a localized string based on a <see cref="T:System.Web.SiteMapNode" /> attribute to localize, a default string to return if no resource is found, and a Boolean value indicating whether to throw an exception if no resource is found. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representing the localized attribute.</para>
+        </returns>
         <param name="attributeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.SiteMapNode" /> attribute to localize. </param>
         <param name="defaultValue">
@@ -463,7 +481,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -473,6 +490,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code of the <see cref="T:System.Web.SiteMapNode" /> object. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer representing the hash code.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -486,13 +507,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the <see cref="T:System.Web.UI.WebControls.SiteMapHierarchicalDataSourceView" /> object that is associated with the current node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.SiteMapHierarchicalDataSourceView" /> for the current node.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -508,7 +532,6 @@
         <Parameter Name="attributeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -523,6 +546,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a localized string based on the attribute name and <see cref="P:System.Web.SiteMapProvider.ResourceKey" /> property that is specified by the <see cref="T:System.Web.SiteMapProvider" /> by which the <see cref="T:System.Web.SiteMapNode" /> is tracked.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representing the localized attribute. The default is null.</para>
+        </returns>
         <param name="attributeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.SiteMapNode" /> attribute to localize.</param>
       </Docs>
@@ -563,7 +590,6 @@
       </Parameters>
       <Docs>
         <param name="ctx">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -573,6 +599,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified site map node can be viewed by the user in the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if any one of the following conditions is met: the security trimming is enabled and the current user is a member of at least one of the roles allowing access to view the site map node; the current user is authorized specifically for the requested node's URL in the authorization element for the current application and the URL is located within the directory structure for the application; the current thread has an associated <see cref="T:System.Security.Principal.WindowsIdentity" /> that has file access to the requested node's URL and the URL is located within the directory structure for the application; or security trimming is not enabled and therefore any user is allowed to view the site map node; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -588,13 +618,16 @@
         <Parameter Name="node" Type="System.Web.SiteMapNode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the current site map node is a child or a direct descendant of the specified node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current node is a child or descendant of the specified node; otherwise, false.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.SiteMapNode" /> to check if the current node is a child or descendant of.</param>
       </Docs>
@@ -837,7 +870,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.Web.SiteMapNode.Roles" /> and <see cref="P:System.Web.SiteMapNode.Attributes" /> collections are copied to new collections.</para>
@@ -846,6 +878,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new node that is a copy of the current node. For a description of this member, see <see cref="M:System.ICloneable.Clone" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new node that is a copy of the current node.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IHierarchyData.GetChildren">
@@ -859,7 +895,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.SiteMapNode.System.Web.UI.IHierarchyData.GetChildren" /> method delegates to the <see cref="P:System.Web.SiteMapNode.ChildNodes" /> property.</para>
@@ -869,6 +904,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the hierarchical children data items of the current item. For a description of this member, see <see cref="M:System.Web.UI.IHierarchyData.GetChildren" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.IHierarchicalEnumerable" /> that represents the immediate children of the current item in the hierarchy.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IHierarchyData.GetParent">
@@ -882,7 +921,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.SiteMapNode.System.Web.UI.IHierarchyData.GetParent" /> method delegates to the <see cref="P:System.Web.SiteMapNode.ParentNode" /> property.</para>
@@ -892,6 +930,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the hierarchical parent of the current item. For a description of this member, see <see cref="M:System.Web.UI.IHierarchyData.GetParent" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.IHierarchicalEnumerable" /> that represents the parent of the current item in the hierarchy.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Web.UI.IHierarchyData.HasChildren">
@@ -1082,7 +1124,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1092,6 +1133,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance of the <see cref="T:System.Web.SiteMapNode" /> class to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this <see cref="T:System.Web.SiteMapNode" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web/SiteMapNodeCollection.xml b/mcs/class/System.Web/Documentation/en/System.Web/SiteMapNodeCollection.xml
index 03e3f54cce0..bf67f62ad25 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web/SiteMapNodeCollection.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web/SiteMapNodeCollection.xml
@@ -193,7 +193,6 @@
         <Parameter Name="value" Type="System.Web.SiteMapNode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -203,6 +202,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a single <see cref="T:System.Web.SiteMapNode" /> object to the  collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the <see cref="P:System.Collections.CollectionBase.InnerList" /> where the <see cref="T:System.Web.SiteMapNode" /> was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.SiteMapNode" /> to add to the <see cref="T:System.Web.SiteMapNodeCollection" />. </param>
       </Docs>
@@ -297,7 +300,6 @@
         <Parameter Name="value" Type="System.Web.SiteMapNode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -307,6 +309,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the collection contains a specific <see cref="T:System.Web.SiteMapNode" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Web.SiteMapNodeCollection" /> contains the specified <see cref="T:System.Web.SiteMapNode" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.SiteMapNode" /> to locate in the <see cref="T:System.Web.SiteMapNodeCollection" />. </param>
       </Docs>
@@ -373,13 +379,16 @@
         <Parameter Name="viewName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the <see cref="T:System.Web.UI.WebControls.SiteMapDataSourceView" /> object that is associated with the nodes in the current collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A named <see cref="T:System.Web.UI.WebControls.SiteMapDataSourceView" /> for the <see cref="T:System.Web.SiteMapNode" /> objects in the current <see cref="T:System.Web.SiteMapNodeCollection" />.</para>
+        </returns>
         <param name="owner">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Web.UI.WebControls.SiteMapDataSource" /> control that the view is associated with.</param>
         <param name="viewName">
@@ -397,13 +406,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a reference to an enumerator object, which is used to iterate over the collection. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that implements the <see cref="T:System.Collections.IEnumerator" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -417,13 +429,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the <see cref="T:System.Web.UI.WebControls.SiteMapHierarchicalDataSourceView" /> object that is associated with the nodes in the current collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.UI.WebControls.SiteMapHierarchicalDataSourceView" /> for the <see cref="T:System.Web.SiteMapNode" /> objects in the current <see cref="T:System.Web.SiteMapNodeCollection" />.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -439,13 +454,16 @@
         <Parameter Name="enumeratedItem" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hierarchical data item for the specified enumerated item.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.IHierarchyData" /> that represents the object passed to the <see cref="M:System.Web.SiteMapNodeCollection.GetHierarchyData(System.Object)" />.</para>
+        </returns>
         <param name="enumeratedItem">
           <attribution license="cc4" from="Microsoft" modified="false" />The object for which to return an <see cref="T:System.Web.UI.IHierarchyData" />.</param>
       </Docs>
@@ -463,7 +481,6 @@
         <Parameter Name="value" Type="System.Web.SiteMapNode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -473,6 +490,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified <see cref="T:System.Web.SiteMapNode" /> object, and then returns the zero-based index of the first occurrence within the entire collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="value" /> within the entire <see cref="T:System.Web.SiteMapNodeCollection" />, if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.SiteMapNode" /> to locate in the <see cref="T:System.Web.SiteMapNodeCollection" />. </param>
       </Docs>
@@ -619,7 +640,6 @@
         <Parameter Name="collection" Type="System.Web.SiteMapNodeCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -629,6 +649,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a read-only collection that contains the nodes in the specified <see cref="T:System.Web.SiteMapNodeCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A read-only <see cref="T:System.Web.SiteMapNodeCollection" /> with the same <see cref="T:System.Web.SiteMapNode" /> elements and structure as the original <see cref="T:System.Web.SiteMapNodeCollection" />.</para>
+        </returns>
         <param name="collection">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.SiteMapNodeCollection" /> that contains the <see cref="T:System.Web.SiteMapNode" /> objects to add to the read-only <see cref="T:System.Web.SiteMapNodeCollection" />. </param>
       </Docs>
@@ -802,12 +826,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through a collection. For a description of this member, see <see cref="M:System.Collections.IEnumerable.GetEnumerator" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the <see cref="T:System.Web.SiteMapNodeCollection" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Add">
@@ -823,12 +850,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an item to the collection in the <see cref="T:System.Collections.IList" /> interface. For a description of this member, see <see cref="M:System.Collections.IList.Add(System.Object)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position into which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to add to the <see cref="T:System.Collections.IList" />.</param>
       </Docs>
@@ -864,12 +894,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the collection in the <see cref="T:System.Collections.IList" /> interface contains the specified Boolean value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object is found in the <see cref="T:System.Collections.IList" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to locate in the <see cref="T:System.Collections.IList" />.</param>
       </Docs>
@@ -887,12 +920,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of the specific item in the collection that is returned by the <see cref="T:System.Collections.IList" /> interface. For a description of this member, see <see cref="M:System.Collections.IList.IndexOf(System.Object)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the value, in the list, if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to locate in the <see cref="T:System.Collections.IList" />.</param>
       </Docs>
@@ -1034,12 +1070,15 @@
         <Parameter Name="enumeratedItem" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hierarchical data item for the specified enumerated item. For a description of this member, see <see cref="M:System.Web.UI.IHierarchicalEnumerable.GetHierarchyData(System.Object)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Web.UI.IHierarchyData" /> that represents the object passed to the <see cref="M:System.Web.SiteMapNodeCollection.System.Web.UI.IHierarchicalEnumerable.GetHierarchyData(System.Object)" />.</para>
+        </returns>
         <param name="enumeratedItem">
           <attribution license="cc4" from="Microsoft" modified="false" />The object for which to return an <see cref="T:System.Web.UI.IHierarchyData" />. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web/SiteMapProvider.xml b/mcs/class/System.Web/Documentation/en/System.Web/SiteMapProvider.xml
index bf952ebf6c6..b5041ba2b9a 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web/SiteMapProvider.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web/SiteMapProvider.xml
@@ -163,7 +163,6 @@
         <Parameter Name="rawUrl" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -175,6 +174,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, retrieves a <see cref="T:System.Web.SiteMapNode" /> object that represents the page at the specified URL.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.SiteMapNode" /> that represents the page identified by <paramref name="rawURL" />; otherwise, null, if no corresponding <see cref="T:System.Web.SiteMapNode" /> is found or if security trimming is enabled and the <see cref="T:System.Web.SiteMapNode" /> cannot be returned for the current user.</para>
+        </returns>
         <param name="rawUrl">
           <attribution license="cc4" from="Microsoft" modified="false" />A URL that identifies the page for which to retrieve a <see cref="T:System.Web.SiteMapNode" />. </param>
       </Docs>
@@ -192,7 +195,6 @@
         <Parameter Name="context" Type="System.Web.HttpContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -203,6 +205,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a <see cref="T:System.Web.SiteMapNode" /> object that represents the currently requested page using the specified <see cref="T:System.Web.HttpContext" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.SiteMapNode" /> that represents the currently requested page; otherwise, null, if no corresponding <see cref="T:System.Web.SiteMapNode" /> can be found in the <see cref="T:System.Web.SiteMapNode" /> or if the page context is null. </para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.HttpContext" /> used to match node information with the URL of the requested page.</param>
       </Docs>
@@ -220,7 +226,6 @@
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -232,6 +237,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a <see cref="T:System.Web.SiteMapNode" /> object based on a specified key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.SiteMapNode" /> that represents the page identified by <paramref name="key" />; otherwise, null, if no corresponding <see cref="T:System.Web.SiteMapNode" /> is found or if security trimming is enabled and the <see cref="T:System.Web.SiteMapNode" /> cannot be returned for the current user. The default is null.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />A lookup key with which a <see cref="T:System.Web.SiteMapNode" /> is created.</param>
       </Docs>
@@ -249,7 +258,6 @@
         <Parameter Name="node" Type="System.Web.SiteMapNode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -259,6 +267,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, retrieves the child nodes of a specific <see cref="T:System.Web.SiteMapNode" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A read-only <see cref="T:System.Web.SiteMapNodeCollection" /> that contains the immediate child nodes of the specified <see cref="T:System.Web.SiteMapNode" />; otherwise, null or an empty collection, if no child nodes exist.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.SiteMapNode" /> for which to retrieve all child nodes. </param>
       </Docs>
@@ -276,7 +288,6 @@
         <Parameter Name="upLevel" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -288,6 +299,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides an optimized lookup method for site map providers when retrieving the node for the currently requested page and fetching the parent and ancestor site map nodes for the current page.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.SiteMapNode" /> that represents the currently requested page; otherwise, null, if the <see cref="T:System.Web.SiteMapNode" /> is not found or cannot be returned for the current user.</para>
+        </returns>
         <param name="upLevel">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of ancestor site map node generations to get. A value of -1 indicates that all ancestors might be retrieved and cached by the provider.</param>
       </Docs>
@@ -306,7 +321,6 @@
         <Parameter Name="downLevel" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -320,6 +334,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides an optimized lookup method for site map providers when retrieving the node for the currently requested page and fetching the site map nodes in the proximity of the current node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.SiteMapNode" /> that represents the currently requested page; otherwise, null, if the <see cref="T:System.Web.SiteMapNode" /> is not found or cannot be returned for the current user.</para>
+        </returns>
         <param name="upLevel">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of ancestor <see cref="T:System.Web.SiteMapNode" /> generations to fetch. 0 indicates no ancestor nodes are retrieved and -1 indicates that all ancestors might be retrieved and cached by the provider.</param>
         <param name="downLevel">
@@ -339,13 +357,20 @@
         <Parameter Name="node" Type="System.Web.SiteMapNode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, retrieves the parent node of a specific <see cref="T:System.Web.SiteMapNode" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.SiteMapNode" /> that represents the parent of <paramref name="node" />; otherwise, null, if the <see cref="T:System.Web.SiteMapNode" /> has no parent or security trimming is enabled and the parent node is not accessible to the current user.</para>
+          <block subset="none" type="note">
+            <para>
+              <see cref="M:System.Web.SiteMapProvider.GetParentNode(System.Web.SiteMapNode)" /> might also return null if the parent node belongs to a different provider. In this case, use the <see cref="P:System.Web.SiteMapNode.ParentNode" /> property of <paramref name="node" /> instead.</para>
+          </block>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.SiteMapNode" /> for which to retrieve the parent node. </param>
       </Docs>
@@ -364,7 +389,6 @@
         <Parameter Name="relativeDepthFromWalkup" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -375,6 +399,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides an optimized lookup method for site map providers when retrieving an ancestor node for the currently requested page and fetching the descendant nodes for the ancestor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.SiteMapNode" /> that represents an ancestor <see cref="T:System.Web.SiteMapNode" /> of the currently requested page; otherwise, null, if the current or ancestor <see cref="T:System.Web.SiteMapNode" /> is not found or cannot be returned for the current user.</para>
+        </returns>
         <param name="walkupLevels">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of ancestor node levels to traverse when retrieving the requested ancestor node. </param>
         <param name="relativeDepthFromWalkup">
@@ -396,7 +424,6 @@
         <Parameter Name="relativeDepthFromWalkup" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -407,6 +434,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides an optimized lookup method for site map providers when retrieving an ancestor node for the specified <see cref="T:System.Web.SiteMapNode" /> object and fetching its child nodes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.SiteMapNode" /> that represents an ancestor of <paramref name="node" />; otherwise, null, if the current or ancestor <see cref="T:System.Web.SiteMapNode" /> is not found or cannot be returned for the current user.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.SiteMapNode" /> that acts as a reference point for <paramref name="walkupLevels" /> and <paramref name="relativeDepthFromWalkup" />. </param>
         <param name="walkupLevels">
@@ -429,7 +460,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.SiteMapProvider.GetRootNodeCore" /> method enables a parent provider in a provider hierarchy to obtain a <see cref="T:System.Web.SiteMapNode" /> object that acts as a frame of reference for building the provider hierarchy and the larger site map node hierarchy that is the sum of the site map data that each provider manages. </para>
@@ -438,6 +468,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, retrieves the root node of all the nodes that are currently managed by the current provider. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.SiteMapNode" /> that represents the root node of the set of nodes that the current provider manages. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetRootNodeCoreFromProvider">
@@ -450,7 +484,6 @@
         <Parameter Name="provider" Type="System.Web.SiteMapProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -460,6 +493,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the root node of all the nodes that are currently managed by the specified site map provider.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.SiteMapNode" /> that represents the root node of the set of nodes that is managed by <paramref name="provider" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />The provider that calls the <see cref="M:System.Web.SiteMapProvider.GetRootNodeCore" />.</param>
       </Docs>
@@ -573,7 +610,6 @@
         <Parameter Name="node" Type="System.Web.SiteMapNode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -615,6 +651,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a Boolean value indicating whether the specified <see cref="T:System.Web.SiteMapNode" /> object can be viewed by the user in the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if security trimming is enabled and <paramref name="node" /> can be viewed by the user or security trimming is not enabled; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.HttpContext" /> that contains user information.</param>
         <param name="node">
@@ -682,7 +722,6 @@
         <Parameter Name="context" Type="System.Web.HttpContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -692,6 +731,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Raises the <see cref="E:System.Web.SiteMapProvider.SiteMapResolve" /> event. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.SiteMapNode" /> provided by the event handler delegate that is registered to handle the event or, if more than one delegate is registered to handle the event, the return value of the last delegate in the delegate chain; otherwise, null. </para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.HttpContext" /> for which the site map currently exists. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web/StaticSiteMapProvider.xml b/mcs/class/System.Web/Documentation/en/System.Web/StaticSiteMapProvider.xml
index 62b533bf099..ae829c73c09 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web/StaticSiteMapProvider.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web/StaticSiteMapProvider.xml
@@ -92,7 +92,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -102,6 +101,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, loads the site map information from persistent storage and builds it in memory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The root <see cref="T:System.Web.SiteMapNode" /> of the site map navigation structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -140,7 +143,6 @@
         <Parameter Name="rawUrl" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -151,6 +153,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a <see cref="T:System.Web.SiteMapNode" /> object that represents the page at the specified URL.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.SiteMapNode" /> that represents the page identified by <paramref name="rawURL" />; otherwise, null, if no corresponding site map node is found.</para>
+        </returns>
         <param name="rawUrl">
           <attribution license="cc4" from="Microsoft" modified="false" />A URL that identifies the page for which to retrieve a <see cref="T:System.Web.SiteMapNode" />. </param>
       </Docs>
@@ -168,7 +174,6 @@
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -181,6 +186,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a <see cref="T:System.Web.SiteMapNode" /> object based on a specified key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.SiteMapNode" /> that represents the page identified by <paramref name="key" />; otherwise, null, if security trimming is enabled and the site map node cannot be shown to the current user or the site map node is not found in the site map node collection by <paramref name="key" />. </para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />A lookup key with which a <see cref="T:System.Web.SiteMapNode" /> is created.</param>
       </Docs>
@@ -198,7 +207,6 @@
         <Parameter Name="node" Type="System.Web.SiteMapNode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -209,6 +217,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the child site map nodes of a specific <see cref="T:System.Web.SiteMapNode" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A read-only <see cref="T:System.Web.SiteMapNodeCollection" /> that contains the child site map nodes of <paramref name="node" />. If security trimming is enabled, the collection contains only site map nodes that the user is permitted to see.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.SiteMapNode" /> for which to retrieve all child site map nodes. </param>
       </Docs>
@@ -226,7 +238,6 @@
         <Parameter Name="node" Type="System.Web.SiteMapNode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -238,6 +249,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the parent site map node of a specific <see cref="T:System.Web.SiteMapNode" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.SiteMapNode" /> that represents the parent of the specified <see cref="T:System.Web.SiteMapNode" />; otherwise, null, if no parent site map node exists or the user is not permitted to see the parent site map node.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.SiteMapNode" /> for which to retrieve the parent site map node. </param>
       </Docs>
diff --git a/mcs/class/System.Web/Documentation/en/System.Web/VirtualPathUtility.xml b/mcs/class/System.Web/Documentation/en/System.Web/VirtualPathUtility.xml
index 8d84cb70e62..218a5a96d36 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web/VirtualPathUtility.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web/VirtualPathUtility.xml
@@ -38,7 +38,6 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -48,6 +47,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the literal slash mark (/) to the end of the virtual path, if one does not already exist.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified virtual path.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path to append the slash mark to.</param>
       </Docs>
@@ -66,7 +69,6 @@
         <Parameter Name="relativePath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -77,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Combines a base path and a relative path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The combined <paramref name="basePath" /> and <paramref name="relativePath" />.</para>
+        </returns>
         <param name="basePath">
           <attribution license="cc4" from="Microsoft" modified="false" />The base path.</param>
         <param name="relativePath">
@@ -96,7 +102,6 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -107,6 +112,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the directory portion of a virtual path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The directory referenced in the virtual path. </para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path.</param>
       </Docs>
@@ -124,7 +133,6 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -134,6 +142,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the extension of the file that is referenced in the virtual path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The file name extension string literal, including the period (.), null, or an empty string ("").</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path.</param>
       </Docs>
@@ -151,7 +163,6 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -161,6 +172,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the file name of the file that is referenced in the virtual path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The file name literal after the last directory character in <paramref name="virtualPath" />; otherwise, the last directory name if the last character of <paramref name="virtualPath" /> is a directory or volume separator character.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path. </param>
       </Docs>
@@ -178,7 +193,6 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -188,6 +202,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Boolean value indicating whether the specified virtual path is absolute; that is, it starts with a literal slash mark (/).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="virtualPath" /> is an absolute path and is not null or an empty string (""); otherwise, false.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path to check. </param>
       </Docs>
@@ -205,7 +223,6 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -219,6 +236,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Boolean value indicating whether the specified virtual path is relative to the application.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="virtualPath" /> is relative to the application; otherwise, false.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path to check. </param>
       </Docs>
@@ -237,7 +258,6 @@
         <Parameter Name="toPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -249,6 +269,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the relative virtual path from one virtual path containing the root operator (the tilde [~]) to another.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The relative virtual path from <paramref name="fromPath" /> to <paramref name="toPath" />.</para>
+        </returns>
         <param name="fromPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The starting virtual path to return the relative virtual path from.</param>
         <param name="toPath">
@@ -268,7 +292,6 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -278,6 +301,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes a trailing slash mark (/) from a virtual path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A virtual path without a trailing slash mark, if the virtual path is not already the root directory ("/"); otherwise, null.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path to remove any trailing slash mark from. </param>
       </Docs>
@@ -295,7 +322,6 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -317,6 +343,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a virtual path to an application absolute path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The absolute path representation of the specified virtual path. </para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path to convert to an application-relative path. </param>
       </Docs>
@@ -335,7 +365,6 @@
         <Parameter Name="applicationPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -357,6 +386,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a virtual path to an application absolute path using the specified application path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The absolute virtual path representation of <paramref name="virtualPath" />.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path to convert to an application-relative path.</param>
         <param name="applicationPath">
@@ -399,7 +432,6 @@
         <Parameter Name="virtualPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -411,6 +443,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a virtual path to an application-relative path using the application virtual path that is in the <see cref="P:System.Web.HttpRuntime.AppDomainAppVirtualPath" /> property. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The application-relative path representation of <paramref name="virtualPath" />.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path to convert to an application-relative path. </param>
       </Docs>
@@ -429,7 +465,6 @@
         <Parameter Name="applicationPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -439,6 +474,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a virtual path to an application-relative path using a specified application path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The application-relative path representation of <paramref name="virtualPath" />.</para>
+        </returns>
         <param name="virtualPath">
           <attribution license="cc4" from="Microsoft" modified="false" />The virtual path to convert to an application-relative path. </param>
         <param name="applicationPath">
diff --git a/mcs/class/System.Web/Documentation/en/System.Web/XmlSiteMapProvider.xml b/mcs/class/System.Web/Documentation/en/System.Web/XmlSiteMapProvider.xml
index cc74c2ea600..ae71a9074ec 100644
--- a/mcs/class/System.Web/Documentation/en/System.Web/XmlSiteMapProvider.xml
+++ b/mcs/class/System.Web/Documentation/en/System.Web/XmlSiteMapProvider.xml
@@ -137,7 +137,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -150,6 +149,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads the site map information from an XML file and builds it in memory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the root <see cref="T:System.Web.SiteMapNode" /> of the site map navigation structure.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>2.0.0.0</AssemblyVersion>
@@ -235,7 +238,6 @@
         <Parameter Name="rawUrl" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -248,6 +250,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a <see cref="T:System.Web.SiteMapNode" /> object that represents the page at the specified URL.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.SiteMapNode" /> that represents the page identified by <paramref name="rawURL" />.</para>
+        </returns>
         <param name="rawUrl">
           <attribution license="cc4" from="Microsoft" modified="false" />A URL that identifies the page for which to retrieve a <see cref="T:System.Web.SiteMapNode" />. </param>
       </Docs>
@@ -265,7 +271,6 @@
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -277,6 +282,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a <see cref="T:System.Web.SiteMapNode" /> object based on a specified key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.SiteMapNode" /> that represents the page identified by <paramref name="key" />; otherwise, null, if security trimming is enabled and the node cannot be shown to the current user or the node is not found by <paramref name="key" /> in the node collection.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />A lookup key with which to search for a <see cref="T:System.Web.SiteMapNode" />.</param>
       </Docs>
@@ -295,7 +304,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Web.XmlSiteMapProvider.GetRootNodeCore" /> method calls the <see cref="M:System.Web.XmlSiteMapProvider.BuildSiteMap" /> method to retrieve the top-level node in the site map. Therefore, any exceptions that occur for the <see cref="M:System.Web.XmlSiteMapProvider.BuildSiteMap" /> method can also occur when calling the <see cref="M:System.Web.XmlSiteMapProvider.GetRootNodeCore" /> method.</para>
@@ -304,6 +312,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the top-level node of the current site map data structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Web.SiteMapNode" /> that represents the top-level node in the current site map data structure.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Initialize">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlAtomicValue.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlAtomicValue.xml
index 700e896287a..5dcaf297c59 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlAtomicValue.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlAtomicValue.xml
@@ -37,13 +37,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a copy of this <see cref="T:System.Xml.Schema.XmlAtomicValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Schema.XmlAtomicValue" /> object copy of this <see cref="T:System.Xml.Schema.XmlAtomicValue" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsNode">
@@ -83,7 +86,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -93,6 +95,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Xml.Schema.XmlAtomicValue.Clone" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a copy of this <see cref="T:System.Xml.Schema.XmlAtomicValue" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -108,12 +114,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the string value of the validated XML element or attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string value of the validated XML element or attribute.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TypedValue">
@@ -178,7 +187,6 @@
         <Parameter Name="nsResolver" Type="System.Xml.IXmlNamespaceResolver" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -190,6 +198,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the validated XML element or attribute's value as the type specified using the <see cref="T:System.Xml.IXmlNamespaceResolver" /> object specified to resolve namespace prefixes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the validated XML element or attribute as the type requested.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to return the validated XML element or attribute's value as.</param>
         <param name="nsResolver">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchema.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchema.xml
index 596cd7ede2b..855bea21733 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchema.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchema.xml
@@ -827,12 +827,15 @@ schema.Includes.Add(include);</code>
         <Parameter Name="validationEventHandler" Type="System.Xml.Schema.ValidationEventHandler" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlSchema'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads an XML Schema  from the supplied stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.Schema.XmlSchema" /> object representing the XML Schema.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The supplied data stream. </param>
         <param name="validationEventHandler">
@@ -856,12 +859,15 @@ schema.Includes.Add(include);</code>
         <Parameter Name="validationEventHandler" Type="System.Xml.Schema.ValidationEventHandler" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlSchema'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads an XML Schema from the supplied <see cref="T:System.IO.TextReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.Schema.XmlSchema" /> object representing the XML Schema.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The TextReader containing the XML Schema to read. </param>
         <param name="validationEventHandler">
@@ -885,12 +891,15 @@ schema.Includes.Add(include);</code>
         <Parameter Name="validationEventHandler" Type="System.Xml.Schema.ValidationEventHandler" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlSchema'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads an XML Schema from the supplied <see cref="T:System.Xml.XmlReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.Schema.XmlSchema" /> object representing the XML Schema.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The XmlReader containing the XML Schema to read. </param>
         <param name="validationEventHandler">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaCollection.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaCollection.xml
index aef3217b9f9..521d7de3ad2 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaCollection.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaCollection.xml
@@ -103,7 +103,6 @@
         <Parameter Name="schema" Type="System.Xml.Schema.XmlSchema" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlSchema'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The targetNamespace attribute is used to identify this schema.</para>
@@ -121,6 +120,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the <see cref="T:System.Xml.Schema.XmlSchema" /> to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XmlSchema object.</para>
+        </returns>
         <param name="schema">
           <attribution license="cc4" from="Microsoft" modified="false" />The XmlSchema to add to the collection. </param>
       </Docs>
@@ -178,7 +181,6 @@
         <Parameter Name="uri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlSchema'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="ns" /> has already been associated with another schema in the collection, the schema being added replaces the original schema in the collection. For example, in the following C# code, authors.xsd is removed from the collection and names.xsd is added.</para>
@@ -198,6 +200,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the schema located by the given URL into the schema collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.Schema.XmlSchema" /> added to the schema collection; null if the schema being added is an XDR schema or if there are compilation errors in the schema. </para>
+        </returns>
         <param name="ns">
           <attribution license="cc4" from="Microsoft" modified="false" />The namespace URI associated with the schema. For XML Schemas, this will typically be the targetNamespace. </param>
         <param name="uri">
@@ -221,7 +227,6 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlSchema'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="ns" /> has already been associated with another schema in the collection, the schema being added replaces the original schema in the collection.</para>
@@ -240,6 +245,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the schema contained in the <see cref="T:System.Xml.XmlReader" /> to the schema collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.Schema.XmlSchema" /> added to the schema collection; null if the schema being added is an XDR schema or if there are compilation errors in the schema.</para>
+        </returns>
         <param name="ns">
           <attribution license="cc4" from="Microsoft" modified="false" />The namespace URI associated with the schema. For XML Schemas, this will typically be the targetNamespace. </param>
         <param name="reader">
@@ -264,7 +273,6 @@
         <Parameter Name="resolver" Type="System.Xml.XmlResolver" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The targetNamespace attribute is used to identify this schema.</para>
@@ -277,6 +285,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the <see cref="T:System.Xml.Schema.XmlSchema" /> to the collection. The specified <see cref="T:System.Xml.XmlResolver" /> is used to resolve any external references.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XmlSchema added to the schema collection.</para>
+        </returns>
         <param name="schema">
           <attribution license="cc4" from="Microsoft" modified="false" />The XmlSchema to add to the collection. </param>
         <param name="resolver">
@@ -301,7 +313,6 @@
         <Parameter Name="resolver" Type="System.Xml.XmlResolver" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="ns" /> has already been associated with another schema in the collection, the schema being added replaces the original schema in the collection.</para>
@@ -315,6 +326,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the schema contained in the <see cref="T:System.Xml.XmlReader" /> to the schema collection. The specified <see cref="T:System.Xml.XmlResolver" /> is used to resolve any external resources.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.Schema.XmlSchema" /> added to the schema collection; null if the schema being added is an XDR schema or if there are compilation errors in the schema.</para>
+        </returns>
         <param name="ns">
           <attribution license="cc4" from="Microsoft" modified="false" />The namespace URI associated with the schema. For XML Schemas, this will typically be the targetNamespace. </param>
         <param name="reader">
@@ -340,7 +355,6 @@
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -351,6 +365,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether a schema with the specified namespace is in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a schema with the specified namespace is in the collection; otherwise, false.</para>
+        </returns>
         <param name="ns">
           <attribution license="cc4" from="Microsoft" modified="false" />The namespace URI associated with the schema. For XML Schemas, this will typically be the target namespace. </param>
       </Docs>
@@ -371,7 +389,6 @@
         <Parameter Name="schema" Type="System.Xml.Schema.XmlSchema" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -382,6 +399,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the targetNamespace of the specified <see cref="T:System.Xml.Schema.XmlSchema" /> is in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there is a schema in the collection with the same targetNamespace; otherwise, false.</para>
+        </returns>
         <param name="schema">
           <attribution license="cc4" from="Microsoft" modified="false" />The XmlSchema object. </param>
       </Docs>
@@ -459,7 +480,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'XmlSchemaCollectionEnumerator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -470,6 +490,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides support for the "for each" style iteration over the collection of schemas.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator for iterating over all schemas in the current collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Item">
@@ -637,7 +661,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Xml.Schema.XmlSchemaCollection" /> instance is cast to an <see cref="T:System.Collections.IEnumerable" /> interface.</para>
@@ -646,6 +669,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Xml.Schema.XmlSchemaCollection.GetEnumerator" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the <see cref="T:System.Collections.IEnumerator" /> for the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ValidationEventHandler">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaCollectionEnumerator.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaCollectionEnumerator.xml
index 9a2accc5c01..e8ce51fe62f 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaCollectionEnumerator.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaCollectionEnumerator.xml
@@ -61,12 +61,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the enumerator to the next schema in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the move was successful; false if the enumerator has passed the end of the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IEnumerator.Current">
@@ -107,7 +110,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Xml.Schema.XmlSchemaCollectionEnumerator" /> instance is cast to an <see cref="T:System.Collections.IEnumerator" /> interface.</para>
@@ -116,6 +118,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Xml.Schema.XmlSchemaCollectionEnumerator.MoveNext" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the next node.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IEnumerator.Reset">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaDatatype.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaDatatype.xml
index 9c4eb972a78..cc4427d943c 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaDatatype.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaDatatype.xml
@@ -60,7 +60,6 @@
         <Parameter Name="targetType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -70,6 +69,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value specified, whose type is one of the valid Common Language Runtime (CLR) representations of the XML schema type represented by the <see cref="T:System.Xml.Schema.XmlSchemaDatatype" />, to the CLR type specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted input value.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The input value to convert to the specified type.</param>
         <param name="targetType">
@@ -93,7 +96,6 @@
         <Parameter Name="namespaceResolver" Type="System.Xml.IXmlNamespaceResolver" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -103,6 +105,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value specified, whose type is one of the valid Common Language Runtime (CLR) representations of the XML schema type represented by the <see cref="T:System.Xml.Schema.XmlSchemaDatatype" />, to the CLR type specified using the <see cref="T:System.Xml.IXmlNamespaceResolver" /> if the <see cref="T:System.Xml.Schema.XmlSchemaDatatype" /> represents the xs:QName type or a type derived from it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted input value.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The input value to convert to the specified type.</param>
         <param name="targetType">
@@ -126,13 +132,16 @@
         <Parameter Name="datatype" Type="System.Xml.Schema.XmlSchemaDatatype" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Xml.Schema.XmlSchemaDatatype.IsDerivedFrom(System.Xml.Schema.XmlSchemaDatatype)" /> method always returns false.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always returns false.</para>
+        </returns>
         <param name="datatype">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Schema.XmlSchemaDatatype" />.</param>
       </Docs>
@@ -154,7 +163,6 @@
         <Parameter Name="nsmgr" Type="System.Xml.IXmlNamespaceResolver" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -175,6 +183,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, validates the string specified against a built-in or user-defined simple type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that can be cast safely to the type returned by the <see cref="P:System.Xml.Schema.XmlSchemaDatatype.ValueType" /> property.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to validate against the simple type.</param>
         <param name="nameTable">
@@ -195,7 +207,6 @@
         <Parameter Name="nsmgr" Type="System.Xml.XmlNamespaceManager" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Xml.Schema.XmlSchemaDatatype.ParseValue(System.String,System.Xml.XmlNameTable,System.Xml.IXmlNamespaceResolver)" /> method validates the specified string against a built-in or user-defined simple type. For example, if this <see cref="T:System.Xml.Schema.XmlSchemaDatatype" /> represents the type xs:date, then an instance of <see cref="T:System.DateTime" /> is returned.</para>
@@ -215,6 +226,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, validates the specified string against a built-in or user-defined simple type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that can be safely cast to the type that is returned by the <see cref="P:System.Xml.Schema.XmlSchemaDatatype.ValueType" /> property.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to validate against the simple type.</param>
         <param name="nameTable">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaInference.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaInference.xml
index f89c8f919b3..301aff3b26f 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaInference.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaInference.xml
@@ -57,7 +57,6 @@
         <Parameter Name="instanceDocument" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -79,6 +78,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Infers an XML Schema Definition Language (XSD) schema from the XML document contained in the <see cref="T:System.Xml.XmlReader" /> object specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Schema.XmlSchemaSet" /> object containing the inferred schemas.</para>
+        </returns>
         <param name="instanceDocument">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlReader" /> object containing the XML document to infer a schema from.</param>
       </Docs>
@@ -99,7 +102,6 @@
         <Parameter Name="schemas" Type="System.Xml.Schema.XmlSchemaSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -124,6 +126,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Infers an XML Schema Definition Language (XSD) schema from the XML document contained in the <see cref="T:System.Xml.XmlReader" /> object specified, and refines the inferred schema using an existing schema in the <see cref="T:System.Xml.Schema.XmlSchemaSet" /> object specified with the same target namespace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Schema.XmlSchemaSet" /> object containing the inferred schemas.</para>
+        </returns>
         <param name="instanceDocument">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlReader" /> object containing the XML document to infer a schema from.</param>
         <param name="schemas">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaObjectCollection.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaObjectCollection.xml
index 27c80dcc724..813c8d27224 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaObjectCollection.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaObjectCollection.xml
@@ -81,7 +81,6 @@
         <Parameter Name="item" Type="System.Xml.Schema.XmlSchemaObject" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If Count already equals the capacity, the capacity of list is doubled by automatically reallocating the internal array and copying the existing elements to the new array before the new element is added.</para>
@@ -108,6 +107,10 @@ schema.Includes.Add(include);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an <see cref="T:System.Xml.Schema.XmlSchemaObject" /> to the XmlSchemaObjectCollection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the item has been added.</para>
+        </returns>
         <param name="item">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Schema.XmlSchemaObject" />. </param>
       </Docs>
@@ -128,12 +131,15 @@ schema.Includes.Add(include);</code>
         <Parameter Name="item" Type="System.Xml.Schema.XmlSchemaObject" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates if the specified <see cref="T:System.Xml.Schema.XmlSchemaObject" /> is in the XmlSchemaObjectCollection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified qualified name is in the collection; otherwise, returns false. If null is supplied, false is returned because there is no qualified name with a null name.</para>
+        </returns>
         <param name="item">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Schema.XmlSchemaObject" />. </param>
       </Docs>
@@ -184,12 +190,15 @@ schema.Includes.Add(include);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'XmlSchemaObjectEnumerator'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator for iterating through the XmlSchemaObjects contained in the XmlSchemaObjectCollection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The iterator returns <see cref="T:System.Xml.Schema.XmlSchemaObjectEnumerator" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IndexOf">
@@ -208,12 +217,15 @@ schema.Includes.Add(include);</code>
         <Parameter Name="item" Type="System.Xml.Schema.XmlSchemaObject" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the collection index corresponding to the specified <see cref="T:System.Xml.Schema.XmlSchemaObject" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index corresponding to the specified <see cref="T:System.Xml.Schema.XmlSchemaObject" />.</para>
+        </returns>
         <param name="item">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Schema.XmlSchemaObject" /> whose index you want to return. </param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaObjectEnumerator.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaObjectEnumerator.xml
index 93415c54854..f98302c0f83 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaObjectEnumerator.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaObjectEnumerator.xml
@@ -61,12 +61,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves to the next item in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>false at the end of the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Reset">
@@ -128,7 +131,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Xml.Schema.XmlSchemaObjectEnumerator" /> instance is cast to an <see cref="T:System.Collections.IEnumerator" /> interface.</para>
@@ -137,6 +139,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Xml.Schema.XmlSchemaObjectEnumerator.MoveNext" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The next <see cref="T:System.Xml.Schema.XmlSchemaObject" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IEnumerator.Reset">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaObjectTable.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaObjectTable.xml
index 44ebffaa244..c77afa5c6a1 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaObjectTable.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaObjectTable.xml
@@ -38,7 +38,6 @@
         <Parameter Name="name" Type="System.Xml.XmlQualifiedName" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -48,6 +47,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the qualified name specified exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the qualified name specified exists in the collection; otherwise, false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlQualifiedName" />.</param>
       </Docs>
@@ -87,12 +90,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'System.Collections.IDictionaryEnumerator'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that can iterate through the <see cref="T:System.Xml.Schema.XmlSchemaObjectTable" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IDictionaryEnumerator" /> that can iterate through <see cref="T:System.Xml.Schema.XmlSchemaObjectTable" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Item">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaSet.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaSet.xml
index 10d0e0d39e6..c0e48838454 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaSet.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaSet.xml
@@ -138,7 +138,6 @@
         <Parameter Name="schema" Type="System.Xml.Schema.XmlSchema" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -149,6 +148,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the given <see cref="T:System.Xml.Schema.XmlSchema" /> to the <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Schema.XmlSchema" /> object if the schema is valid. If the schema is not valid and a <see cref="T:System.Xml.Schema.ValidationEventHandler" /> is specified, then null is returned and the appropriate validation event is raised. Otherwise, an <see cref="T:System.Xml.Schema.XmlSchemaException" /> is thrown.</para>
+        </returns>
         <param name="schema">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Schema.XmlSchema" /> object to add to the <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</param>
       </Docs>
@@ -226,7 +229,6 @@ foreach(XmlSchema schema in schemaSet.Schemas())
         <Parameter Name="schemaUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -305,6 +307,10 @@ foreach(XmlSchema schema in schemaSet.Schemas())
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the XML Schema definition language (XSD) schema at the URL specified to the <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Schema.XmlSchema" /> object if the schema is valid. If the schema is not valid and a <see cref="T:System.Xml.Schema.ValidationEventHandler" /> is specified, then null is returned and the appropriate validation event is raised. Otherwise, an <see cref="T:System.Xml.Schema.XmlSchemaException" /> is thrown.</para>
+        </returns>
         <param name="targetNamespace">
           <attribution license="cc4" from="Microsoft" modified="false" />The schema targetNamespace property, or null to use the targetNamespace specified in the schema.</param>
         <param name="schemaUri">
@@ -327,7 +333,6 @@ foreach(XmlSchema schema in schemaSet.Schemas())
         <Parameter Name="schemaDocument" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -367,6 +372,10 @@ foreach(XmlSchema schema in schemaSet.Schemas())
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the XML Schema definition language (XSD) schema contained in the <see cref="T:System.Xml.XmlReader" /> to the <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Schema.XmlSchema" /> object if the schema is valid. If the schema is not valid and a <see cref="T:System.Xml.Schema.ValidationEventHandler" /> is specified, then null is returned and the appropriate validation event is raised. Otherwise, an <see cref="T:System.Xml.Schema.XmlSchemaException" /> is thrown.</para>
+        </returns>
         <param name="targetNamespace">
           <attribution license="cc4" from="Microsoft" modified="false" />The schema targetNamespace property, or null to use the targetNamespace specified in the schema.</param>
         <param name="schemaDocument">
@@ -440,7 +449,6 @@ foreach(XmlSchema schema in schemaSet.Schemas())
         <Parameter Name="targetNamespace" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -450,6 +458,10 @@ foreach(XmlSchema schema in schemaSet.Schemas())
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether an XML Schema definition language (XSD) schema with the specified target namespace URI is in the <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a schema with the specified target namespace URI is in the <see cref="T:System.Xml.Schema.XmlSchemaSet" />; otherwise, false.</para>
+        </returns>
         <param name="targetNamespace">
           <attribution license="cc4" from="Microsoft" modified="false" />The schema targetNamespace property.</param>
       </Docs>
@@ -469,13 +481,16 @@ foreach(XmlSchema schema in schemaSet.Schemas())
         <Parameter Name="schema" Type="System.Xml.Schema.XmlSchema" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified XML Schema definition language (XSD) <see cref="T:System.Xml.Schema.XmlSchema" /> object is in the <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Xml.Schema.XmlSchema" /> object is in the <see cref="T:System.Xml.Schema.XmlSchemaSet" />; otherwise, false.</para>
+        </returns>
         <param name="schema">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Schema.XmlSchema" /> object.</param>
       </Docs>
@@ -658,7 +673,6 @@ foreach(XmlSchema schema in schemaSet.Schemas())
         <Parameter Name="schema" Type="System.Xml.Schema.XmlSchema" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -668,6 +682,10 @@ foreach(XmlSchema schema in schemaSet.Schemas())
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the specified XML Schema definition language (XSD) schema from the <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.Schema.XmlSchema" /> object removed from the <see cref="T:System.Xml.Schema.XmlSchemaSet" /> or null if the schema was not found in the <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
+        </returns>
         <param name="schema">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Schema.XmlSchema" /> object to remove from the <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</param>
       </Docs>
@@ -687,7 +705,6 @@ foreach(XmlSchema schema in schemaSet.Schemas())
         <Parameter Name="schemaToRemove" Type="System.Xml.Schema.XmlSchema" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -714,6 +731,10 @@ ss.Compile();</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the specified XML Schema definition language (XSD) schema and all the schemas it imports from the <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Xml.Schema.XmlSchema" /> object and all its imports were successfully removed; otherwise, false.</para>
+        </returns>
         <param name="schemaToRemove">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Schema.XmlSchema" /> object to remove from the <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</param>
       </Docs>
@@ -733,7 +754,6 @@ ss.Compile();</code>
         <Parameter Name="schema" Type="System.Xml.Schema.XmlSchema" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -747,6 +767,10 @@ ss.Compile();</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reprocesses an XML Schema definition language (XSD) schema that already exists in the <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Schema.XmlSchema" /> object if the schema is a valid schema. If the schema is not valid and a <see cref="T:System.Xml.Schema.ValidationEventHandler" /> is specified, null is returned and the appropriate validation event is raised. Otherwise, an <see cref="T:System.Xml.Schema.XmlSchemaException" /> is thrown.</para>
+        </returns>
         <param name="schema">
           <attribution license="cc4" from="Microsoft" modified="false" />The schema to reprocess.</param>
       </Docs>
@@ -764,7 +788,6 @@ ss.Compile();</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -777,6 +800,10 @@ ss.Compile();</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of all the XML Schema definition language (XSD) schemas in the <see cref="T:System.Xml.Schema.XmlSchemaSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.ICollection" /> object containing all the schemas that have been added to the <see cref="T:System.Xml.Schema.XmlSchemaSet" />. If no schemas have been added to the <see cref="T:System.Xml.Schema.XmlSchemaSet" />, an empty <see cref="T:System.Collections.ICollection" /> object is returned.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Schemas">
@@ -794,7 +821,6 @@ ss.Compile();</code>
         <Parameter Name="targetNamespace" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -808,6 +834,10 @@ ss.Compile();</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of all the XML Schema definition language (XSD) schemas in the <see cref="T:System.Xml.Schema.XmlSchemaSet" /> that belong to the given namespace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.ICollection" /> object containing all the schemas that have been added to the <see cref="T:System.Xml.Schema.XmlSchemaSet" /> that belong to the given namespace. If no schemas have been added to the <see cref="T:System.Xml.Schema.XmlSchemaSet" />, an empty <see cref="T:System.Collections.ICollection" /> object is returned.</para>
+        </returns>
         <param name="targetNamespace">
           <attribution license="cc4" from="Microsoft" modified="false" />The schema targetNamespace property.</param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaType.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaType.xml
index f15dbaadc12..e191ee9879c 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaType.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaType.xml
@@ -457,13 +457,16 @@
         <Parameter Name="typeCode" Type="System.Xml.Schema.XmlTypeCode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Xml.Schema.XmlSchemaComplexType" /> that represents the built-in complex type of the complex type specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.Schema.XmlSchemaComplexType" /> that represents the built-in complex type.</para>
+        </returns>
         <param name="typeCode">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Xml.Schema.XmlTypeCode" /> values representing the complex type.</param>
       </Docs>
@@ -483,13 +486,16 @@
         <Parameter Name="qualifiedName" Type="System.Xml.XmlQualifiedName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Xml.Schema.XmlSchemaComplexType" /> that represents the built-in complex type of the complex type specified by qualified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.Schema.XmlSchemaComplexType" /> that represents the built-in complex type.</para>
+        </returns>
         <param name="qualifiedName">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlQualifiedName" /> of the complex type.</param>
       </Docs>
@@ -509,7 +515,6 @@
         <Parameter Name="typeCode" Type="System.Xml.Schema.XmlTypeCode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -519,6 +524,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Xml.Schema.XmlSchemaSimpleType" /> that represents the built-in simple type of the specified simple type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.Schema.XmlSchemaSimpleType" /> that represents the built-in simple type.</para>
+        </returns>
         <param name="typeCode">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Xml.Schema.XmlTypeCode" /> values representing the simple type.</param>
       </Docs>
@@ -538,7 +547,6 @@
         <Parameter Name="qualifiedName" Type="System.Xml.XmlQualifiedName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -548,6 +556,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Xml.Schema.XmlSchemaSimpleType" /> that represents the built-in simple type of the simple type that is specified by the qualified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.Schema.XmlSchemaSimpleType" /> that represents the built-in simple type.</para>
+        </returns>
         <param name="qualifiedName">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlQualifiedName" /> of the simple type.</param>
       </Docs>
@@ -569,13 +581,16 @@
         <Parameter Name="except" Type="System.Xml.Schema.XmlSchemaDerivationMethod" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating if the derived schema type specified is derived from the base schema type specified</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the derived type is derived from the base type; otherwise, false.</para>
+        </returns>
         <param name="derivedType">
           <attribution license="cc4" from="Microsoft" modified="false" />The derived <see cref="T:System.Xml.Schema.XmlSchemaType" /> to test.</param>
         <param name="baseType">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaValidator.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaValidator.xml
index 504df8f6b3d..81c05ae49ca 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaValidator.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Schema/XmlSchemaValidator.xml
@@ -151,7 +151,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -169,6 +168,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the expected attributes for the current element context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Xml.Schema.XmlSchemaAttribute" /> objects or an empty array if there are no expected attributes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetExpectedParticles">
@@ -184,7 +187,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -305,6 +307,10 @@ validator.ValidateEndElement(null);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the expected particles in the current element context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Xml.Schema.XmlSchemaParticle" /> objects or an empty array if there are no expected particles.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetUnspecifiedDefaultAttributes">
@@ -506,7 +512,6 @@ validator.ValidateEndElement(null);</code>
         <Parameter Name="schemaInfo" Type="System.Xml.Schema.XmlSchemaInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -527,6 +532,10 @@ validator.ValidateEndElement(null);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the attribute name, namespace URI, and value in the current element context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The validated attribute's value.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the attribute to validate.</param>
         <param name="namespaceUri">
@@ -555,7 +564,6 @@ validator.ValidateEndElement(null);</code>
         <Parameter Name="schemaInfo" Type="System.Xml.Schema.XmlSchemaInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -576,6 +584,10 @@ validator.ValidateEndElement(null);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates the attribute name, namespace URI, and value in the current element context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The validated attribute's value.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the attribute to validate.</param>
         <param name="namespaceUri">
@@ -700,7 +712,6 @@ validator.ValidateEndElement(null);</code>
         <Parameter Name="schemaInfo" Type="System.Xml.Schema.XmlSchemaInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -727,6 +738,10 @@ validator.ValidateEndElement(null);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies if the text content of the element is valid according to its data type for elements with simple content, and verifies if the content of the current element is complete for elements with complex content.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The parsed, typed text value of the element if the element has simple content.</para>
+        </returns>
         <param name="schemaInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.Schema.XmlSchemaInfo" /> object whose properties are set on successful validation of the element. This parameter can be null.</param>
       </Docs>
@@ -747,7 +762,6 @@ validator.ValidateEndElement(null);</code>
         <Parameter Name="typedValue" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -777,6 +791,10 @@ validator.ValidateEndElement(null);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies if the text content of the element specified is valid according to its data type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The parsed, typed simple content of the element.</para>
+        </returns>
         <param name="schemaInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.Schema.XmlSchemaInfo" /> object whose properties are set on successful validation of the text content of the element. This parameter can be null.</param>
         <param name="typedValue">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization.Advanced/SchemaImporterExtension.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization.Advanced/SchemaImporterExtension.xml
index 5e8d81cbc81..a2044689110 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization.Advanced/SchemaImporterExtension.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization.Advanced/SchemaImporterExtension.xml
@@ -93,7 +93,6 @@
         <Parameter Name="codeProvider" Type="System.CodeDom.Compiler.CodeDomProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -103,6 +102,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Handles the importation of the &lt;xsd:any&gt; elements in the schema.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the CLR type that the element maps to. </para>
+        </returns>
         <param name="any">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.Schema.XmlSchemaAny" /> that represents the xsd:any element found in the XML Schema Document (XSD).</param>
         <param name="mixed">
@@ -137,7 +140,6 @@
         <Parameter Name="type" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -147,6 +149,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Allows you to specify the default value for the XSD type being imported.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.CodeExpression" /> setting the new default value.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value found in the original XSD.</param>
         <param name="type">
@@ -175,13 +181,16 @@
         <Parameter Name="codeProvider" Type="System.CodeDom.Compiler.CodeDomProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Allows you to manipulate the code generated by examining the imported schema and specifying the CLR type that it maps to.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the CLR type that this maps to.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.Schema.XmlSchemaType" /> that represents the XSD type.</param>
         <param name="context">
@@ -223,7 +232,6 @@
         <Parameter Name="codeProvider" Type="System.CodeDom.Compiler.CodeDomProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -233,6 +241,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Allows you to manipulate the code generated by examining the imported schema and specifying the CLR type that it maps to.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the CLR type that this maps to.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the element.</param>
         <param name="ns">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization.Advanced/SchemaImporterExtensionCollection.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization.Advanced/SchemaImporterExtensionCollection.xml
index 919a4d7186e..880c6cb5361 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization.Advanced/SchemaImporterExtensionCollection.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization.Advanced/SchemaImporterExtensionCollection.xml
@@ -56,13 +56,16 @@
         <Parameter Name="extension" Type="System.Xml.Serialization.Advanced.SchemaImporterExtension" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified importer extension to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the added extension.</para>
+        </returns>
         <param name="extension">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Serialization.Advanced.SchemaImporterExtensionCollection" /> to add.</param>
       </Docs>
@@ -83,13 +86,16 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified importer extension to the collection. The name parameter allows you to supply a custom name for the extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the newly added item.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />A custom name for the extension.</param>
         <param name="type">
@@ -132,13 +138,16 @@
         <Parameter Name="extension" Type="System.Xml.Serialization.Advanced.SchemaImporterExtension" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the specified importer extension exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the extension is found; otherwise, false.</para>
+        </returns>
         <param name="extension">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Serialization.Advanced.SchemaImporterExtensionCollection" /> to search for.</param>
       </Docs>
@@ -186,13 +195,16 @@
         <Parameter Name="extension" Type="System.Xml.Serialization.Advanced.SchemaImporterExtension" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified item and returns the zero-based index of the first occurrence within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the found item.</para>
+        </returns>
         <param name="extension">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Serialization.Advanced.SchemaImporterExtension" /> to search for.</param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization.Configuration/SchemaImporterExtensionElementCollection.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization.Configuration/SchemaImporterExtensionElementCollection.xml
index 6bc4c3b1789..e50e13ec573 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization.Configuration/SchemaImporterExtensionElementCollection.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization.Configuration/SchemaImporterExtensionElementCollection.xml
@@ -128,12 +128,15 @@
         <Parameter Name="element" Type="System.Xml.Serialization.Configuration.SchemaImporterExtensionElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the zero-based index of the first element in the collection with the specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the found element.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Serialization.Configuration.SchemaImporterExtensionElement" /> to find.</param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/CodeIdentifier.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/CodeIdentifier.xml
index 458e1fe913d..9b76a45545a 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/CodeIdentifier.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/CodeIdentifier.xml
@@ -66,7 +66,6 @@
         <Parameter Name="identifier" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Xml.Serialization.CodeIdentifier.MakeCamel(System.String)" /> method converts the initial character from an upper-case to lower-case letter, if necessary.</para>
@@ -76,6 +75,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces a camel-case string from an input string. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A camel-case version of the parameter string.</para>
+        </returns>
         <param name="identifier">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a code entity, such as a method parameter, typically taken from an XML element or attribute name.</param>
       </Docs>
@@ -96,7 +99,6 @@
         <Parameter Name="identifier" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Xml.Serialization.CodeIdentifier.MakePascal(System.String)" /> method converts the initial character from a lower-case to upper-case letter, if necessary.</para>
@@ -106,6 +108,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces a Pascal-case string from an input string. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Pascal-case version of the parameter string.</para>
+        </returns>
         <param name="identifier">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a code entity, such as a method parameter, typically taken from an XML element or attribute name.</param>
       </Docs>
@@ -126,7 +132,6 @@
         <Parameter Name="identifier" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Xml.Serialization.CodeIdentifier.MakeValid(System.String)" /> method removes any characters that cannot appear in a code identifier. It returns the string "Item" if no characters are valid. It prefixes the string "Item" to an input that begins with an invalid start character, for example, a digit, or a currency symbol.</para>
@@ -136,6 +141,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces a valid code entity name from an input string. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that can be used as a code identifier, such as the name of a method parameter.</para>
+        </returns>
         <param name="identifier">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a code entity, such as a method parameter, typically taken from an XML element or attribute name.</param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/CodeIdentifiers.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/CodeIdentifiers.xml
index d8ddaca79ef..6eba7f2f670 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/CodeIdentifiers.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/CodeIdentifiers.xml
@@ -167,7 +167,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the identifier parameter value is not unique within the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> instance's scope, a new, unique string is generated and used in its place. The new string is generated by appending to the input name. The original name is not unique if it was passed previously to the <see cref="M:System.Xml.Serialization.CodeIdentifiers.Add(System.String,System.Object)" />, <see cref="M:System.Xml.Serialization.CodeIdentifiers.AddUnique(System.String,System.Object)" />, or <see cref="M:System.Xml.Serialization.CodeIdentifiers.AddReserved(System.String)" /> method, or if it was generated by a previous call to the <see cref="M:System.Xml.Serialization.CodeIdentifiers.AddUnique(System.String,System.Object)" /> method. In each case, if the new identifier is not unique, it is first passed to the <see cref="M:System.Xml.Serialization.CodeIdentifiers.MakeUnique(System.String)" /> method to create a new unique identifier.</para>
@@ -177,6 +176,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a named code entity or type mapping to the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> instance's scope, ensuring that the name is unique within the scope. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The identifier parameter value or a modified string if there is a name collision.</para>
+        </returns>
         <param name="identifier">
           <attribution license="cc4" from="Microsoft" modified="false" />A candidate name that is used to index the code entity.</param>
         <param name="value">
@@ -224,7 +227,6 @@
         <Parameter Name="identifier" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The input name is not unique if it was passed previously to the <see cref="M:System.Xml.Serialization.CodeIdentifiers.Add(System.String,System.Object)" />, <see cref="M:System.Xml.Serialization.CodeIdentifiers.AddUnique(System.String,System.Object)" />, or <see cref="M:System.Xml.Serialization.CodeIdentifiers.AddReserved(System.String)" /> method, or if it was generated by the <see cref="M:System.Xml.Serialization.CodeIdentifiers.AddUnique(System.String,System.Object)" /> method.</para>
@@ -234,6 +236,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a specified name is already being used within the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> instance's scope. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the name is already in use; otherwise, false.</para>
+        </returns>
         <param name="identifier">
           <attribution license="cc4" from="Microsoft" modified="false" />The name to check for use within the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> instance's scope.</param>
       </Docs>
@@ -254,7 +260,6 @@
         <Parameter Name="identifier" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the value of the <see cref="P:System.Xml.Serialization.CodeIdentifiers.UseCamelCasing" /> property is true and the first character of the input is a letter, it is made lowercase, if necessary. If the value of the <see cref="P:System.Xml.Serialization.CodeIdentifiers.UseCamelCasing" /> is false, Pascal case is in effect and the first character, if a letter, is capitalized, if necessary.</para>
@@ -263,6 +268,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ensures that the input is of the correct case by modifying the name according to the value of the <see cref="P:System.Xml.Serialization.CodeIdentifiers.UseCamelCasing" /> property. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that is the same as the input identifier or has the first letter's case modified.</para>
+        </returns>
         <param name="identifier">
           <attribution license="cc4" from="Microsoft" modified="false" />The name to possibly modify.</param>
       </Docs>
@@ -283,7 +292,6 @@
         <Parameter Name="identifier" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The input name is not unique if it was passed previously to the <see cref="M:System.Xml.Serialization.CodeIdentifiers.Add(System.String,System.Object)" />, <see cref="M:System.Xml.Serialization.CodeIdentifiers.AddUnique(System.String,System.Object)" />, or <see cref="M:System.Xml.Serialization.CodeIdentifiers.AddReserved(System.String)" />  method, or if it was generated by the <see cref="M:System.Xml.Serialization.CodeIdentifiers.AddUnique(System.String,System.Object)" /> method. If the name is not unique, a new string is generated by appending to the original string.</para>
@@ -293,6 +301,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the input name conflicts with another name within the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> instance's scope and, if it does, generates a modified string. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The identifier parameter value or a modified string if there is a name collision.</para>
+        </returns>
         <param name="identifier">
           <attribution license="cc4" from="Microsoft" modified="false" />The name to modify if it is not already unique.</param>
       </Docs>
@@ -369,7 +381,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you want to control the names of code entities that are bound to XML Schema or Web service definitions, use the associated attributes rather than creating an instance of the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> class. For a complete list, see <format type="text/html"><a href="414b820f-a696-4206-b576-2711d85490c7">Attributes That Control XML Serialization</a></format>.</para>
@@ -378,6 +389,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of the code entities or type mappings within the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> instance's scope. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of the code entities or type mappings that is stored by the <see cref="T:System.Xml.Serialization.CodeIdentifiers" /> object.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of all the code entities or type mappings for the instance.</param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/IXmlSerializable.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/IXmlSerializable.xml
index c7e934c962f..2c2252c70e9 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/IXmlSerializable.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/IXmlSerializable.xml
@@ -38,7 +38,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'System.Xml.Schema.XmlSchema'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When serializing or deserializing an object, the <see cref="T:System.Xml.Serialization.XmlSerializer" /> class does not perform XML validation. For this reason, it is often safe to omit schema information by providing a trivial implementation of this method, for example by returning null (Nothing in Visual Basic).</para>
@@ -49,6 +48,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is reserved and should not be used. When implementing the IXmlSerializable interface, you should return null (Nothing in Visual Basic) from this method, and instead, if specifying a custom schema is required, apply the <see cref="T:System.Xml.Serialization.XmlSchemaProviderAttribute" /> to the class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Schema.XmlSchema" /> that describes the XML representation of the object that is produced by the <see cref="M:System.Xml.Serialization.IXmlSerializable.WriteXml(System.Xml.XmlWriter)" /> method and consumed by the <see cref="M:System.Xml.Serialization.IXmlSerializable.ReadXml(System.Xml.XmlReader)" /> method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadXml">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/SoapReflectionImporter.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/SoapReflectionImporter.xml
index 3afd5fb520b..b55625ecaf3 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/SoapReflectionImporter.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/SoapReflectionImporter.xml
@@ -134,7 +134,6 @@
         <Parameter Name="members" Type="System.Xml.Serialization.XmlReflectionMember[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlMembersMapping'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Xml.Serialization.SoapReflectionImporter.ImportMembersMapping(System.String,System.String,System.Xml.Serialization.XmlReflectionMember[])" /> method is called while initializing a Web service or client, or reflecting a Web service. You do not need to call it directly.</para>
@@ -158,6 +157,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates internal type mappings for information that is gathered from a Web service method. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Internal .NET Framework type mappings to the element parts of a WSDL message definition.</para>
+        </returns>
         <param name="elementName">
           <attribution license="cc4" from="Microsoft" modified="false" />An XML element name produced from the Web service method.</param>
         <param name="ns">
@@ -186,7 +189,6 @@
         <Parameter Name="writeAccessors" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlMembersMapping'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Xml.Serialization.SoapReflectionImporter.ImportMembersMapping(System.String,System.String,System.Xml.Serialization.XmlReflectionMember[],System.Boolean,System.Boolean)" /> method is called while initializing a Web service or client, or reflecting a Web service. You do not need to call it directly.</para>
@@ -210,6 +212,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates internal type mappings for information that is gathered from a Web service method. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Internal .NET Framework type mappings to the element parts of a WSDL message definition.</para>
+        </returns>
         <param name="elementName">
           <attribution license="cc4" from="Microsoft" modified="false" />An XML element name produced from the Web service method.</param>
         <param name="ns">
@@ -243,7 +249,6 @@
         <Parameter Name="validate" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlMembersMapping'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Xml.Serialization.SoapReflectionImporter.ImportMembersMapping(System.String,System.String,System.Xml.Serialization.XmlReflectionMember[],System.Boolean,System.Boolean,System.Boolean)" /> method is called while initializing a Web service or client, or reflecting a Web service. You do not need to call it directly.</para>
@@ -267,6 +272,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates internal type mappings for information that is gathered from a Web service method. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Internal .NET Framework type mappings to the element parts of a WSDL message definition.</para>
+        </returns>
         <param name="elementName">
           <attribution license="cc4" from="Microsoft" modified="false" />An XML element name produced from the Web service method.</param>
         <param name="ns">
@@ -302,7 +311,6 @@
         <Parameter Name="access" Type="System.Xml.Serialization.XmlMappingAccess" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -327,6 +335,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates internal type mappings for information that is gathered from a Web service method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Internal .NET Framework type mappings to the element parts of a WSDL message definition.</para>
+        </returns>
         <param name="elementName">
           <attribution license="cc4" from="Microsoft" modified="false" />An XML element name produced from the Web service method.</param>
         <param name="ns">
@@ -359,7 +371,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlTypeMapping'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The XML Schema element is serialized using SOAP encoding.</para>
@@ -369,6 +380,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a mapping to an XML Schema element for a .NET Framework type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Internal .NET Framework mapping of a type to an XML Schema element. </para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The .NET Framework type for which to generate a type mapping. </param>
       </Docs>
@@ -390,7 +405,6 @@
         <Parameter Name="defaultNamespace" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlTypeMapping'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The XML Schema element is serialized using SOAP encoding.</para>
@@ -400,6 +414,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a mapping to an XML Schema element for a .NET Framework type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Internal .NET Framework mapping of a type to an XML Schema element.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The .NET Framework type for which to generate a type mapping. </param>
         <param name="defaultNamespace">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/SoapSchemaImporter.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/SoapSchemaImporter.xml
index cd426dedf4a..ea43adf8864 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/SoapSchemaImporter.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/SoapSchemaImporter.xml
@@ -188,7 +188,6 @@
         <Parameter Name="baseTypeCanBeIndirect" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlTypeMapping'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Xml.Serialization.SoapSchemaImporter.ImportDerivedTypeMapping(System.Xml.XmlQualifiedName,System.Type,System.Boolean)" /> method of the <see cref="T:System.Xml.Serialization.SoapSchemaImporter" /> class is used by the <format type="text/html"><a href="b9210348-8bc2-4367-8c91-d1a04b403e88">Web Services Description Language Tool (Wsdl.exe)</a></format> while generating client proxy classes or abstract server classes from a Web Services Description Language (WSDL) document. Instead of calling this method directly, use Wsdl.exe.</para>
@@ -198,6 +197,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates internal type mapping information for the type of a SOAP-encoded element part defined in a WSDL document where a base type is specified. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The .NET Framework type mapping information for a derived type corresponding to a WSDL message part.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlQualifiedName" /> that specifies the name of an element's type for which a .NET Framework type is being generated.</param>
         <param name="baseType">
@@ -224,7 +227,6 @@
         <Parameter Name="member" Type="System.Xml.Serialization.SoapSchemaMember" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlMembersMapping'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Xml.Serialization.SoapSchemaImporter.ImportMembersMapping(System.String,System.String,System.Xml.Serialization.SoapSchemaMember)" /> method of the <see cref="T:System.Xml.Serialization.SoapSchemaImporter" /> class is used by the Wsdl.exe tool while generating client proxy classes or abstract server classes from a Web Services Description Language (WSDL) document. Instead of calling this method directly, use Wsdl.exe.</para>
@@ -234,6 +236,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates internal type mapping information for a single SOAP-encoded element part defined in a WSDL document. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The .NET Framework type mapping for a single element part of a WSDL message definition.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The message name.</param>
         <param name="ns">
@@ -260,7 +266,6 @@
         <Parameter Name="members" Type="System.Xml.Serialization.SoapSchemaMember[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlMembersMapping'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Xml.Serialization.SoapSchemaImporter.ImportMembersMapping(System.String,System.String,System.Xml.Serialization.SoapSchemaMember[])" /> method of the <see cref="T:System.Xml.Serialization.SoapSchemaImporter" /> class is used by the Wsdl.exe tool while generating client proxy classes or abstract server classes from a Web Services Description Language (WSDL) document. Instead of calling this method directly, use Wsdl.exe.</para>
@@ -270,6 +275,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates internal type mapping information for the element parts of a SOAP-encoded message defined in a WSDL document. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The .NET Framework type mappings for the element parts of a WSDL message definition.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The message name.</param>
         <param name="ns">
@@ -297,7 +306,6 @@
         <Parameter Name="hasWrapperElement" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlMembersMapping'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Xml.Serialization.SoapSchemaImporter.ImportMembersMapping(System.String,System.String,System.Xml.Serialization.SoapSchemaMember[],System.Boolean)" /> method of the <see cref="T:System.Xml.Serialization.SoapSchemaImporter" /> class is used by the Wsdl.exe tool while generating client proxy classes or abstract server classes from a Web Services Description Language (WSDL) document. Instead of calling this method directly, use Wsdl.exe.</para>
@@ -307,6 +315,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates internal type mapping information for the element parts of a SOAP-encoded message defined in a WSDL document. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The .NET Framework type mappings for the element parts of a WSDL message definition.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The message name.</param>
         <param name="ns">
@@ -338,7 +350,6 @@
         <Parameter Name="baseTypeCanBeIndirect" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlMembersMapping'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Xml.Serialization.SoapSchemaImporter.ImportMembersMapping(System.String,System.String,System.Xml.Serialization.SoapSchemaMember[],System.Boolean,System.Type,System.Boolean)" /> method of the <see cref="T:System.Xml.Serialization.SoapSchemaImporter" /> class is used by the Wsdl.exe tool while generating client proxy classes or abstract server classes from a Web Services Description Language (WSDL) document. Instead of calling this method directly, use Wsdl.exe.</para>
@@ -348,6 +359,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates internal type mapping information for the element parts of a SOAP-encoded message defined in a WSDL document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The .NET Framework type mappings for the element parts of a WSDL message definition.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The message name.</param>
         <param name="ns">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/UnreferencedObjectEventArgs.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/UnreferencedObjectEventArgs.xml
index daffadf6236..523763053c0 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/UnreferencedObjectEventArgs.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/UnreferencedObjectEventArgs.xml
@@ -47,6 +47,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of the <see cref="T:System.Xml.Serialization.UnreferencedObjectEventArgs" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Serialization.UnreferencedObjectEventArgs" /> that contains information about the unreferenced object.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The unreferenced object. </param>
         <param name="id">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlAnyElementAttributes.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlAnyElementAttributes.xml
index 59a68aae11e..6b30dee41cc 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlAnyElementAttributes.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlAnyElementAttributes.xml
@@ -88,12 +88,15 @@
         <Parameter Name="attribute" Type="System.Xml.Serialization.XmlAnyElementAttribute" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an <see cref="T:System.Xml.Serialization.XmlAnyElementAttribute" /> to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the newly added <see cref="T:System.Xml.Serialization.XmlAnyElementAttribute" />.</para>
+        </returns>
         <param name="attribute">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Serialization.XmlAnyElementAttribute" /> to add. </param>
       </Docs>
@@ -114,12 +117,15 @@
         <Parameter Name="attribute" Type="System.Xml.Serialization.XmlAnyElementAttribute" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the specified <see cref="T:System.Xml.Serialization.XmlAnyElementAttribute" /> exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Xml.Serialization.XmlAnyElementAttribute" /> exists in the collection; otherwise, false.</para>
+        </returns>
         <param name="attribute">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Serialization.XmlAnyElementAttribute" /> you are interested in. </param>
       </Docs>
@@ -168,12 +174,15 @@
         <Parameter Name="attribute" Type="System.Xml.Serialization.XmlAnyElementAttribute" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the specified <see cref="T:System.Xml.Serialization.XmlAnyElementAttribute" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified <see cref="T:System.Xml.Serialization.XmlAnyElementAttribute" />.</para>
+        </returns>
         <param name="attribute">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Serialization.XmlAnyElementAttribute" /> whose index you want. </param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlArrayItemAttributes.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlArrayItemAttributes.xml
index 78469b236fd..76ea349f1f4 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlArrayItemAttributes.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlArrayItemAttributes.xml
@@ -63,12 +63,15 @@
         <Parameter Name="attribute" Type="System.Xml.Serialization.XmlArrayItemAttribute" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an <see cref="T:System.Xml.Serialization.XmlArrayItemAttribute" /> to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the added item.</para>
+        </returns>
         <param name="attribute">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Serialization.XmlArrayItemAttribute" /> to add to the collection. </param>
       </Docs>
@@ -89,12 +92,15 @@
         <Parameter Name="attribute" Type="System.Xml.Serialization.XmlArrayItemAttribute" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the collection contains the specified <see cref="T:System.Xml.Serialization.XmlArrayItemAttribute" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the specified <see cref="T:System.Xml.Serialization.XmlArrayItemAttribute" />; otherwise, false.</para>
+        </returns>
         <param name="attribute">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Serialization.XmlArrayItemAttribute" /> to check for.</param>
       </Docs>
@@ -143,12 +149,15 @@
         <Parameter Name="attribute" Type="System.Xml.Serialization.XmlArrayItemAttribute" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the zero-based index of the first occurrence of the specified <see cref="T:System.Xml.Serialization.XmlArrayItemAttribute" /> in the collection or -1 if the attribute is not found in the collection. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first index of the <see cref="T:System.Xml.Serialization.XmlArrayItemAttribute" /> in the collection or -1 if the attribute is not found in the collection.</para>
+        </returns>
         <param name="attribute">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Serialization.XmlArrayItemAttribute" /> to locate in the collection.</param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlElementAttributes.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlElementAttributes.xml
index 7295fdc5b92..32586ef3527 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlElementAttributes.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlElementAttributes.xml
@@ -61,12 +61,15 @@
         <Parameter Name="attribute" Type="System.Xml.Serialization.XmlElementAttribute" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an <see cref="T:System.Xml.Serialization.XmlElementAttribute" /> to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the newly added item.</para>
+        </returns>
         <param name="attribute">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Serialization.XmlElementAttribute" /> to add. </param>
       </Docs>
@@ -87,12 +90,15 @@
         <Parameter Name="attribute" Type="System.Xml.Serialization.XmlElementAttribute" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the collection contains the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object exists in the collection; otherwise, false.</para>
+        </returns>
         <param name="attribute">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Serialization.XmlElementAttribute" /> to look for. </param>
       </Docs>
@@ -141,12 +147,15 @@
         <Parameter Name="attribute" Type="System.Xml.Serialization.XmlElementAttribute" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the specified <see cref="T:System.Xml.Serialization.XmlElementAttribute" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the <see cref="T:System.Xml.Serialization.XmlElementAttribute" />.</para>
+        </returns>
         <param name="attribute">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Serialization.XmlElementAttribute" /> whose index is being retrieved.</param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlMemberMapping.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlMemberMapping.xml
index 3561c2e8bec..2a84e2edc4d 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlMemberMapping.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlMemberMapping.xml
@@ -129,13 +129,16 @@
         <Parameter Name="codeProvider" Type="System.CodeDom.Compiler.CodeDomProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the type associated with the specified <see cref="T:System.CodeDom.Compiler.CodeDomProvider" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the type.</para>
+        </returns>
         <param name="codeProvider">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.Compiler.CodeDomProvider" />  that contains the name of the type.</param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlReflectionImporter.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlReflectionImporter.xml
index 7b4d65af40c..1d244ceb32f 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlReflectionImporter.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlReflectionImporter.xml
@@ -173,7 +173,6 @@
         <Parameter Name="hasWrapperElement" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlMembersMapping'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Xml.Serialization.XmlReflectionImporter.ImportMembersMapping(System.String,System.String,System.Xml.Serialization.XmlReflectionMember[],System.Boolean)" /> method is called while initializing a Web service or client, or reflecting a Web service. It is not necessary to call it directly.</para>
@@ -197,6 +196,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates internal type mappings for information from a Web service method. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Serialization.XmlMembersMapping" /> with mappings to the element parts of a WSDL message definition.</para>
+        </returns>
         <param name="elementName">
           <attribution license="cc4" from="Microsoft" modified="false" />An XML element name produced from the Web service method.</param>
         <param name="ns">
@@ -226,13 +229,16 @@
         <Parameter Name="rpc" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns internal type mappings using information from a Web service method, and allows you to specify an XML element name, XML namespace, and other options.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Serialization.XmlMembersMapping" /> that contains the mappings.</para>
+        </returns>
         <param name="elementName">
           <attribution license="cc4" from="Microsoft" modified="false" />An XML element name produced from the Web service method.</param>
         <param name="ns">
@@ -265,13 +271,16 @@
         <Parameter Name="openModel" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns internal type mappings using information from a Web service method, and allows you to specify an XML element name, XML namespace, and other options.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Serialization.XmlMembersMapping" /> that contains the mappings.</para>
+        </returns>
         <param name="elementName">
           <attribution license="cc4" from="Microsoft" modified="false" />An XML element name produced from the Web service method.</param>
         <param name="ns">
@@ -307,13 +316,16 @@
         <Parameter Name="access" Type="System.Xml.Serialization.XmlMappingAccess" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates internal type mappings for information from a Web service method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Serialization.XmlMembersMapping" /> that contains the mappings.</para>
+        </returns>
         <param name="elementName">
           <attribution license="cc4" from="Microsoft" modified="false" />An XML element name produced from the Web service method.</param>
         <param name="ns">
@@ -346,7 +358,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlTypeMapping'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>It is not necessary to call the <see cref="M:System.Xml.Serialization.XmlReflectionImporter.ImportTypeMapping(System.Type)" /> method directly.</para>
@@ -355,6 +366,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a mapping to an XML Schema element for a specified .NET Framework type. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Internal .NET Framework mapping of a type to an XML Schema element.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The .NET Framework type for which to generate a type mapping.</param>
       </Docs>
@@ -376,7 +391,6 @@
         <Parameter Name="defaultNamespace" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlTypeMapping'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>It is not necessary to call the <see cref="M:System.Xml.Serialization.XmlReflectionImporter.ImportTypeMapping(System.Type,System.String)" /> method directly.</para>
@@ -385,6 +399,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a mapping to an XML Schema element for a .NET Framework type, using the specified type and namespace. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Internal .NET Framework mapping of a type to an XML Schema element.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The .NET Framework type for which to generate a type mapping.</param>
         <param name="defaultNamespace">
@@ -408,7 +426,6 @@
         <Parameter Name="root" Type="System.Xml.Serialization.XmlRootAttribute" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlTypeMapping'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>It is not necessary to call the <see cref="M:System.Xml.Serialization.XmlReflectionImporter.ImportTypeMapping(System.Type,System.Xml.Serialization.XmlRootAttribute)" /> method directly.</para>
@@ -417,6 +434,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a mapping to an XML Schema element for a .NET Framework type, using the specified type and attribute. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Serialization.XmlTypeMapping" /> that represents a mapping of a .NET Framework type to an XML Schema element.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The .NET Framework type for which to generate a type mapping.</param>
         <param name="root">
@@ -441,7 +462,6 @@
         <Parameter Name="defaultNamespace" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlTypeMapping'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>It is not necessary to call the <see cref="M:System.Xml.Serialization.XmlReflectionImporter.ImportTypeMapping(System.Type,System.Xml.Serialization.XmlRootAttribute,System.String)" /> method directly.</para>
@@ -450,6 +470,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a mapping to an XML Schema element for a .NET Framework type, using the specified type, attribute, and namespace. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Serialization.XmlTypeMapping" /> that contains the internal .NET Framework mapping of a type to an XML Schema element.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The .NET Framework type for which to generate a type mapping.</param>
         <param name="root">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSchemaEnumerator.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSchemaEnumerator.xml
index 8ae250b1776..e2d467caa9a 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSchemaEnumerator.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSchemaEnumerator.xml
@@ -104,13 +104,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the enumerator to the next item in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the move is successful; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IEnumerator.Current">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSchemaExporter.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSchemaExporter.xml
index d7d0ca8acd2..9d45fd8ceeb 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSchemaExporter.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSchemaExporter.xml
@@ -77,7 +77,6 @@
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You do not need to call the method directly.</para>
@@ -88,6 +87,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Exports an &lt;any&gt; element to the <see cref="T:System.Xml.Schema.XmlSchema" /> object that is identified by the specified namespace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An arbitrary name assigned to the &lt;any&gt; element declaration.</para>
+        </returns>
         <param name="ns">
           <attribution license="cc4" from="Microsoft" modified="false" />The namespace of the XML schema document to which to add an <ui>&lt;any&gt;</ui> element.</param>
       </Docs>
@@ -107,13 +110,16 @@
         <Parameter Name="members" Type="System.Xml.Serialization.XmlMembersMapping" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an element declaration for an object or type to a SOAP message or to an <see cref="T:System.Xml.Schema.XmlSchema" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string "any" with an appended integer. </para>
+        </returns>
         <param name="members">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.Serialization.XmlMembersMapping" />  that contains mappings to export.</param>
       </Docs>
@@ -191,7 +197,6 @@
         <Parameter Name="xmlMembersMapping" Type="System.Xml.Serialization.XmlMembersMapping" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'System.Xml.XmlQualifiedName'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload adds an XML schema element declaration to the <see cref="T:System.Xml.Schema.XmlSchema" /> that uses the same namespace as the SOAP message part. The literal message definition must contain a single part.</para>
@@ -201,6 +206,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an element declaration to the applicable <see cref="T:System.Xml.Schema.XmlSchema" /> object for a single element part of a literal SOAP message definition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlQualifiedName" /> that represents the qualified XML name of the exported element declaration.</para>
+        </returns>
         <param name="xmlMembersMapping">
           <attribution license="cc4" from="Microsoft" modified="false" />Internal .NET Framework type mappings for the element parts of a Web Services Description Language (WSDL) message definition.</param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSchemaImporter.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSchemaImporter.xml
index 1ede6bb7d5e..df79d2d319c 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSchemaImporter.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSchemaImporter.xml
@@ -199,7 +199,6 @@
         <Parameter Name="elementName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlMembersMapping'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Xml.Serialization.XmlSchemaImporter.ImportAnyType(System.Xml.XmlQualifiedName,System.String)" /> method is used by the Wsdl.exe tool while generating client proxy classes or abstract server classes from a Web Services Description Language (WSDL) document. Instead of calling this method directly, use Wsdl.exe or Xsd.exe.</para>
@@ -209,6 +208,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates internal type mapping information for a single, (SOAP) literal element part defined in a WSDL document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Serialization.XmlMembersMapping" /> representing the .NET Framework type mapping for a single element part of a WSDL message definition.</para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlQualifiedName" /> that specifies the name of an element's type for which a .NET Framework type is generated.</param>
         <param name="elementName">
@@ -232,7 +235,6 @@
         <Parameter Name="baseType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlTypeMapping'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload of the <see cref="M:System.Xml.Serialization.XmlSchemaImporter.ImportDerivedTypeMapping(System.Xml.XmlQualifiedName,System.Type)" /> method is used by the Xsd.exe tool to generate classes from an XML Schema Definition (XSD) document. Instead of calling this method directly, use Xsd.exe.</para>
@@ -241,6 +243,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates internal type mapping information for an element defined in an XML schema document. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Serialization.XmlTypeMapping" /> representing the.NET Framework type mapping information for an XML schema element.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlQualifiedName" /> that specifies the name of an element defined in an XML schema document.</param>
         <param name="baseType">
@@ -265,7 +271,6 @@
         <Parameter Name="baseTypeCanBeIndirect" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlTypeMapping'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload of the <see cref="M:System.Xml.Serialization.XmlSchemaImporter.ImportDerivedTypeMapping(System.Xml.XmlQualifiedName,System.Type,System.Boolean)" /> method is used by the Xsd.exe tool to generate classes from an XML Schema Definition (XSD) document. It also is used by the Wsdl.exe tool while generating client proxy classes or abstract server classes from a Web Services Description Language (WSDL) document. Instead of calling this method directly, use Wsdl.exe or Xsd.exe.</para>
@@ -274,6 +279,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates internal type mapping information for an element defined in an XML schema document or as a part in a WSDL document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The .NET Framework type mapping information for an XML schema element.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlQualifiedName" /> that specifies the name of an element defined in an XML schema document.</param>
         <param name="baseType">
@@ -298,7 +307,6 @@
         <Parameter Name="name" Type="System.Xml.XmlQualifiedName" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlMembersMapping'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Xml.Serialization.XmlSchemaImporter.ImportMembersMapping(System.Xml.XmlQualifiedName)" /> method of the <see cref="T:System.Xml.Serialization.XmlSchemaImporter" /> class is used by the Wsdl.exe tool while generating client proxy classes or abstract server classes from a Web Services Description Language (WSDL) document. Instead of calling this method directly, use Wsdl.exe or Xsd.exe.</para>
@@ -308,6 +316,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates internal type mapping information for a single element part of a literal-use SOAP message defined in a WSDL document. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The .NET Framework type mapping for a WSDL message definition containing a single element part.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlQualifiedName" /> that specifies the name of the message part.</param>
       </Docs>
@@ -328,7 +340,6 @@
         <Parameter Name="names" Type="System.Xml.XmlQualifiedName[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlMembersMapping'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Xml.Serialization.XmlSchemaImporter.ImportMembersMapping(System.Xml.XmlQualifiedName[])" /> method is used by the Wsdl.exe tool while generating client proxy classes or abstract server classes from a Web Services Description Language (WSDL) document. Instead of calling this method directly, use Wsdl.exe or Xsd.exe.</para>
@@ -339,6 +350,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates internal type mapping information for the element parts of a literal-use SOAP message defined in a WSDL document. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Serialization.XmlMembersMapping" /> that represents the .NET Framework type mappings for the element parts of a WSDL message definition.</para>
+        </returns>
         <param name="names">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Xml.XmlQualifiedName" /> that specifies the names of the message parts.</param>
       </Docs>
@@ -360,13 +375,16 @@
         <Parameter Name="members" Type="System.Xml.Serialization.SoapSchemaMember[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates internal type mapping information for the element parts of a literal-use SOAP message defined in a WSDL document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Xml.Serialization.XmlMembersMapping" /> that contains type mapping information.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the element for which to generate a mapping.</param>
         <param name="ns">
@@ -393,7 +411,6 @@
         <Parameter Name="baseTypeCanBeIndirect" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlMembersMapping'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Xml.Serialization.XmlSchemaImporter.ImportMembersMapping(System.Xml.XmlQualifiedName[],System.Type,System.Boolean)" /> method is used by the Wsdl.exe tool while generating client proxy classes or abstract server classes from a Web Services Description Language (WSDL) document. Instead of calling this method directly, use Wsdl.exe or Xsd.exe.</para>
@@ -404,6 +421,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates internal type mapping information for the element parts of a literal-use SOAP message defined in a WSDL document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The .NET Framework type mappings for the element parts of a WSDL message definition.</para>
+        </returns>
         <param name="names">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Xml.XmlQualifiedName" /> that specifies the names of the message parts.</param>
         <param name="baseType">
@@ -427,13 +448,16 @@
         <Parameter Name="typeName" Type="System.Xml.XmlQualifiedName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates internal type mapping information for an element defined in an XML schema document. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Xml.Serialization.XmlTypeMapping" /> object that describes a type mapping.</para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.XmlQualifiedName" /> that specifies an XML element.</param>
       </Docs>
@@ -454,13 +478,16 @@
         <Parameter Name="baseType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates internal type mapping information for an element defined in an XML schema document. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Xml.Serialization.XmlTypeMapping" /> object that describes a type mapping.</para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.XmlQualifiedName" /> that specifies an XML element.</param>
         <param name="baseType">
@@ -484,13 +511,16 @@
         <Parameter Name="baseTypeCanBeIndirect" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates internal type mapping information for an element defined in an XML schema document. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Xml.Serialization.XmlTypeMapping" /> object that describes a type mapping.</para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.XmlQualifiedName" /> that specifies an XML element.</param>
         <param name="baseType">
@@ -515,7 +545,6 @@
         <Parameter Name="name" Type="System.Xml.XmlQualifiedName" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlTypeMapping'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Xml.Serialization.XmlSchemaImporter.ImportTypeMapping(System.Xml.XmlQualifiedName)" /> method is used by the Xsd.exe tool while generating classes XML Schema Definition (XSD) document. Instead of calling this method directly, use Xsd.exe.</para>
@@ -525,6 +554,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates internal type mapping information for an element defined in an XML schema document. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The .NET Framework type mapping information for an XML schema element.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlQualifiedName" /> that specifies the name of an element defined in an XML schema document.</param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSchemas.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSchemas.xml
index 6b56f89f178..2acf7be5a13 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSchemas.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSchemas.xml
@@ -61,12 +61,15 @@
         <Parameter Name="schema" Type="System.Xml.Schema.XmlSchema" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an object to the end of the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the <see cref="T:System.Xml.Schema.XmlSchema" /> is added.</para>
+        </returns>
         <param name="schema">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Schema.XmlSchema" /> object to be added to the collection of objects. </param>
       </Docs>
@@ -112,13 +115,16 @@
         <Parameter Name="baseUri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an <see cref="T:System.Xml.Schema.XmlSchema" /> object that represents an assembly reference to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the <see cref="T:System.Xml.Schema.XmlSchema" /> is added.</para>
+        </returns>
         <param name="schema">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Schema.XmlSchema" /> to add.</param>
         <param name="baseUri">
@@ -208,13 +214,16 @@
         <Parameter Name="targetNamespace" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the collection contains an <see cref="T:System.Xml.Schema.XmlSchema" /> object that belongs to the specified namespace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the item is found; otherwise, false.</para>
+        </returns>
         <param name="targetNamespace">
           <attribution license="cc4" from="Microsoft" modified="false" />The namespace of the item to check for.</param>
       </Docs>
@@ -235,12 +244,15 @@
         <Parameter Name="schema" Type="System.Xml.Schema.XmlSchema" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Xml.Serialization.XmlSchemas" /> contains a specific schema.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if the collection contains the specified item; otherwise, false.</para>
+        </returns>
         <param name="schema">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Schema.XmlSchema" /> object to locate. </param>
       </Docs>
@@ -290,12 +302,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Locates in one of the XML schemas an <see cref="T:System.Xml.Schema.XmlSchemaObject" /> of the specified name and type. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Schema.XmlSchemaObject" /> instance, such as an <see cref="T:System.Xml.Schema.XmlSchemaElement" /> or <see cref="T:System.Xml.Schema.XmlSchemaAttribute" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlQualifiedName" /> that specifies a fully qualified name with a namespace used to locate an <see cref="T:System.Xml.Schema.XmlSchema" /> object in the collection.</param>
         <param name="type">
@@ -317,7 +332,6 @@
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -327,6 +341,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of schemas that belong to the same namespace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IList" /> implementation that contains the schemas.</para>
+        </returns>
         <param name="ns">
           <attribution license="cc4" from="Microsoft" modified="false" />The namespace of the schemas to retrieve.</param>
       </Docs>
@@ -347,12 +365,15 @@
         <Parameter Name="schema" Type="System.Xml.Schema.XmlSchema" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified schema and returns the zero-based index of the first occurrence within the entire <see cref="T:System.Xml.Serialization.XmlSchemas" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of the value within the entire <see cref="T:System.Xml.Serialization.XmlSchemas" />, if found; otherwise, -1.</para>
+        </returns>
         <param name="schema">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Schema.XmlSchema" /> to locate. </param>
       </Docs>
@@ -425,7 +446,6 @@
         <Parameter Name="schema" Type="System.Xml.Schema.XmlSchema" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The IsDataSet attribute comes from the namespace urn:schemas-microsoft-com:xml-msdata.</para>
@@ -435,6 +455,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Static method that determines whether the specified XML schema contains a custom IsDataSet attribute set to true, or its equivalent. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified schema exists; otherwise, false.</para>
+        </returns>
         <param name="schema">
           <attribution license="cc4" from="Microsoft" modified="false" />The XML schema to check for an IsDataSet attribute with a true value.</param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSerializationReader.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSerializationReader.xml
index 406350e5fe0..7e9a07d975d 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSerializationReader.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSerializationReader.xml
@@ -197,7 +197,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -207,6 +206,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes all occurrences of white space characters from the beginning and end of the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The trimmed string.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string that will have its white space trimmed.</param>
       </Docs>
@@ -228,7 +231,6 @@
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'System.Exception'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended only for use by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -237,6 +239,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.InvalidOperationException" /> that indicates that an object being deserialized should be abstract. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.InvalidOperationException" /> exception.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the abstract type.</param>
         <param name="ns">
@@ -263,7 +269,6 @@
         <Parameter Name="clrBase" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -273,6 +278,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Populates an object from its XML representation at the current location of the <see cref="T:System.Xml.XmlReader" />, with an option to read the inner element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.InvalidOperationException" /> exception.</para>
+        </returns>
         <param name="xsdDerived">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the derived XML Schema data type.</param>
         <param name="nsDerived">
@@ -303,7 +312,6 @@
         <Parameter Name="typeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -312,6 +320,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.InvalidOperationException" /> that indicates that an object being deserialized cannot be instantiated because the constructor throws a security exception.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.InvalidOperationException" /> exception.</para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the type.</param>
       </Docs>
@@ -332,7 +344,6 @@
         <Parameter Name="typeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -341,6 +352,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.InvalidOperationException" /> that indicates that an object being deserialized cannot be instantiated because there is no constructor available.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.InvalidOperationException" /> exception.</para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the type.</param>
       </Docs>
@@ -362,7 +377,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'System.Exception'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -371,6 +385,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.InvalidCastException" /> that indicates that an explicit reference conversion failed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.InvalidCastException" /> exception.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> that an object cannot be cast to. This type is incorporated into the exception message.</param>
         <param name="value">
@@ -394,7 +412,6 @@
         <Parameter Name="id" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -404,6 +421,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.InvalidCastException" /> that indicates that an explicit reference conversion failed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.InvalidCastException" /> exception.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> that an object cannot be cast to. This type is incorporated into the exception message.</param>
         <param name="value">
@@ -429,7 +450,6 @@
         <Parameter Name="clrType" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -439,6 +459,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.InvalidOperationException" /> that indicates that a derived type that is mapped to an XML Schema data type cannot be located.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.InvalidOperationException" /> exception.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the XML Schema data type that is mapped to the unavailable derived type.</param>
         <param name="ns">
@@ -463,7 +487,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'System.Exception'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -472,6 +495,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.InvalidOperationException" /> that indicates that a SOAP-encoded collection type cannot be modified and its values cannot be filled in. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.InvalidOperationException" /> exception.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The fully qualified name of the .NET Framework type for which there is a mapping.</param>
       </Docs>
@@ -493,7 +520,6 @@
         <Parameter Name="enumType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'System.Exception'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -502,6 +528,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.InvalidOperationException" /> that indicates that an enumeration value is not valid. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.InvalidOperationException" /> exception.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The enumeration value that is not valid.</param>
         <param name="enumType">
@@ -522,7 +552,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'System.Exception'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -531,6 +560,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.InvalidOperationException" /> that indicates that the current position of <see cref="T:System.Xml.XmlReader" /> represents an unknown XML node. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.InvalidOperationException" /> exception.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateUnknownTypeException">
@@ -549,7 +582,6 @@
         <Parameter Name="type" Type="System.Xml.XmlQualifiedName" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'System.Exception'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -558,6 +590,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.InvalidOperationException" /> that indicates that a type is unknown. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.InvalidOperationException" /> exception.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlQualifiedName" /> that represents the name of the unknown type.</param>
       </Docs>
@@ -628,7 +664,6 @@
         <Parameter Name="elementType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'System.Array'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -637,6 +672,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ensures that a given array, or a copy, is large enough to contain a specified index. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The existing <see cref="T:System.Array" />, if it is already large enough; otherwise, a new, larger array that contains the original array's elements.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Array" /> that is being checked.</param>
         <param name="index">
@@ -693,7 +732,6 @@
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -703,6 +741,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the length of the SOAP-encoded array where the <see cref="T:System.Xml.XmlReader" /> is currently positioned.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The length of the SOAP array.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name that the array should have.</param>
         <param name="ns">
@@ -723,7 +765,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -732,6 +773,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the XML element where the <see cref="T:System.Xml.XmlReader" /> is currently positioned has a null attribute set to the value true.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <see cref="T:System.Xml.XmlReader" /> is currently positioned over a null attribute with the value true; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetTarget">
@@ -750,7 +795,6 @@
         <Parameter Name="id" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -760,6 +804,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an object that is being deserialized from a SOAP-encoded multiRef element and that was stored earlier by <see cref="M:System.Xml.Serialization.XmlSerializationReader.AddTarget(System.String,System.Object)" />.  </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object to be deserialized from a SOAP-encoded multiRef element.</para>
+        </returns>
         <param name="id">
           <attribution license="cc4" from="Microsoft" modified="false" />The value of the id attribute of a multiRef element that identifies the element.</param>
       </Docs>
@@ -778,7 +826,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'System.Xml.XmlQualifiedName'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -788,6 +835,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the xsi:type attribute for the XML element at the current location of the <see cref="T:System.Xml.XmlReader" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML qualified name that indicates the data type of an XML element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InitCallbacks">
@@ -883,7 +934,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -893,6 +943,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether an XML attribute name indicates an XML namespace. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the XML attribute name indicates an XML namespace; otherwise, false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of an XML attribute.</param>
       </Docs>
@@ -940,7 +994,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'System.Xml.XmlQualifiedName'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -949,6 +1002,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Makes the <see cref="T:System.Xml.XmlReader" /> read the fully qualified name of the element where it is currently positioned. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The fully qualified name of the current XML element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadEndElement">
@@ -1038,7 +1095,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -1047,6 +1103,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Instructs the <see cref="T:System.Xml.XmlReader" /> to read the current XML element if the element has a null attribute with the value true. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the element has a null="true" attribute value and has been read; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadNullableQualifiedName">
@@ -1063,7 +1123,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'System.Xml.XmlQualifiedName'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -1072,6 +1131,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Instructs the <see cref="T:System.Xml.XmlReader" /> to read the fully qualified name of the element where it is currently positioned. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Xml.XmlQualifiedName" /> that represents the fully qualified name of the current XML element; otherwise, null if a null="true" attribute value is present.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadNullableString">
@@ -1088,7 +1151,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -1097,6 +1159,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Instructs the <see cref="T:System.Xml.XmlReader" /> to read a simple, text-only XML element that could be null. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string value; otherwise, null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadReference">
@@ -1135,7 +1201,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -1147,6 +1212,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes an object from a SOAP-encoded multiRef XML element. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the referenced element in the document.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadReferencedElement">
@@ -1166,7 +1235,6 @@
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -1178,6 +1246,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes an object from a SOAP-encoded multiRef XML element. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the referenced element in the document.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element's XML Schema data type.</param>
         <param name="ns">
@@ -1302,7 +1374,6 @@
         <Parameter Name="serializable" Type="System.Xml.Serialization.IXmlSerializable" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IXmlSerializable'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -1311,6 +1382,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Populates an object from its XML representation at the current location of the <see cref="T:System.Xml.XmlReader" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that implements the <see cref="T:System.Xml.Serialization.IXmlSerializable" /> interface with its members populated from the location of the <see cref="T:System.Xml.XmlReader" />.</para>
+        </returns>
         <param name="serializable">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.Serialization.IXmlSerializable" /> that corresponds to the current position of the <see cref="T:System.Xml.XmlReader" />.</param>
       </Docs>
@@ -1331,7 +1406,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -1340,6 +1414,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces the result of a call to the <see cref="M:System.Xml.XmlReader.ReadString" /> method appended to the input value. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of call to the <see cref="M:System.Xml.XmlReader.ReadString" /> method appended to the input value.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string to prefix to the result of a call to the <see cref="M:System.Xml.XmlReader.ReadString" /> method.</param>
       </Docs>
@@ -1360,13 +1438,16 @@
         <Parameter Name="trim" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the result of a call to the <see cref="M:System.Xml.XmlReader.ReadString" /> method of the <see cref="T:System.Xml.XmlReader" /> class, trimmed of white space if needed, and appended to the input value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of the read operation appended to the input value.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that will be appended to.</param>
         <param name="trim">
@@ -1388,13 +1469,16 @@
         <Parameter Name="type" Type="System.Xml.XmlQualifiedName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads an XML element that allows null values (xsi:nil = 'true') and returns a generic <see cref="T:System.Nullable`1" /> value. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A generic <see cref="T:System.Nullable`1" /> that represents a null XML value.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlQualifiedName" /> that represents the simple data type for the current location of the <see cref="T:System.Xml.XmlReader" />.</param>
       </Docs>
@@ -1415,7 +1499,6 @@
         <Parameter Name="type" Type="System.Xml.XmlQualifiedName" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -1424,6 +1507,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the XML node at which the <see cref="T:System.Xml.XmlReader" /> is currently positioned. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the node as a .NET Framework value type, if the value is a simple XML Schema data type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlQualifiedName" /> that represents the simple data type for the current location of the <see cref="T:System.Xml.XmlReader" />.</param>
       </Docs>
@@ -1444,7 +1531,6 @@
         <Parameter Name="wrapped" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -1453,6 +1539,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Instructs the <see cref="T:System.Xml.XmlReader" /> to read an XML document root element at its current position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlDocument" /> that contains the root element that has been read.</para>
+        </returns>
         <param name="wrapped">
           <attribution license="cc4" from="Microsoft" modified="false" />true if the method should read content only after reading the element's start element; otherwise, false.</param>
       </Docs>
@@ -1473,7 +1563,6 @@
         <Parameter Name="wrapped" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'System.Xml.XmlNode'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -1482,6 +1571,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Instructs the <see cref="T:System.Xml.XmlReader" /> to read the XML node at its current position. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlNode" /> that represents the XML node that has been read.</para>
+        </returns>
         <param name="wrapped">
           <attribution license="cc4" from="Microsoft" modified="false" />true to read content only after reading the element's start element; otherwise, false.</param>
       </Docs>
@@ -1531,7 +1624,6 @@
         <Parameter Name="assemblyFullName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1542,6 +1634,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a dynamically generated assembly by name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A dynamically generated <see cref="T:System.Reflection.Assembly" />.</para>
+        </returns>
         <param name="assemblyFullName">
           <attribution license="cc4" from="Microsoft" modified="false" />The full name of the assembly.</param>
       </Docs>
@@ -1565,7 +1661,6 @@
         <Parameter Name="isNullable" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'System.Array'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -1574,6 +1669,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ensures that a given array, or a copy, is no larger than a specified length. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The existing <see cref="T:System.Array" />, if it is already small enough; otherwise, a new, smaller array that contains the original array's elements up to the size of<paramref name=" length" />.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The array that is being checked.</param>
         <param name="length">
@@ -1600,7 +1699,6 @@
         <Parameter Name="isNull" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte[]'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -1609,6 +1707,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Instructs the <see cref="T:System.Xml.XmlReader" /> to read the string value at its current position and return it as a base-64 byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A base-64 byte array; otherwise, null if the value of the <paramref name="isNull" /> parameter is true.</para>
+        </returns>
         <param name="isNull">
           <attribution license="cc4" from="Microsoft" modified="false" />true to return null; false to return a base-64 byte array.</param>
       </Docs>
@@ -1629,7 +1731,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte[]'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -1639,6 +1740,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces a base-64 byte array from an input string. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A base-64 byte array.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string to translate into a base-64 byte array.</param>
       </Docs>
@@ -1659,7 +1764,6 @@
         <Parameter Name="isNull" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte[]'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -1668,6 +1772,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Instructs the <see cref="T:System.Xml.XmlReader" /> to read the string value at its current position and return it as a hexadecimal byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hexadecimal byte array; otherwise, null if the value of the <paramref name="isNull" /> parameter is true. </para>
+        </returns>
         <param name="isNull">
           <attribution license="cc4" from="Microsoft" modified="false" />true to return null; false to return a hexadecimal byte array.</param>
       </Docs>
@@ -1688,7 +1796,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte[]'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -1698,6 +1805,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces a hexadecimal byte array from an input string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hexadecimal byte array.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string to translate into a hexadecimal byte array.</param>
       </Docs>
@@ -1718,7 +1829,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'char'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -1728,6 +1838,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces a <see cref="T:System.Char" /> object from an input string. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Char" /> object.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string to translate into a <see cref="T:System.Char" /> object.</param>
       </Docs>
@@ -1748,7 +1862,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'System.DateTime'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -1758,6 +1871,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces a <see cref="T:System.DateTime" /> object from an input string. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DateTime" /> object.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string to translate into a <see cref="T:System.DateTime" /> class object.</param>
       </Docs>
@@ -1778,7 +1895,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'System.DateTime'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -1788,6 +1904,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces a <see cref="T:System.DateTime" /> object from an input string. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DateTime" /> object.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string to translate into a <see cref="T:System.DateTime" /> object.</param>
       </Docs>
@@ -1810,7 +1930,6 @@
         <Parameter Name="typeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -1820,6 +1939,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces a numeric enumeration value from a string that consists of delimited identifiers that represent constants from the enumerator list. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A long value that consists of the enumeration value as a series of bitwise OR operations.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that consists of delimited identifiers where each identifier represents a constant from the set enumerator list.</param>
         <param name="h">
@@ -1844,7 +1967,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'System.DateTime'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -1854,6 +1976,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces a <see cref="T:System.DateTime" /> from a string that represents the time. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DateTime" /> object.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string to translate into a <see cref="T:System.DateTime" /> object.</param>
       </Docs>
@@ -1874,7 +2000,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -1886,6 +2011,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes an XML name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decoded string.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An XML name to be decoded.</param>
       </Docs>
@@ -1906,7 +2035,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -1918,6 +2046,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes an XML name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decoded string.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An XML name to be decoded.</param>
       </Docs>
@@ -1938,7 +2070,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are only intended for use by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -1950,6 +2081,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes an XML name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decoded string.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An XML name to be decoded.</param>
       </Docs>
@@ -1970,7 +2105,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -1982,6 +2116,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes an XML name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decoded string.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An XML name to be decoded.</param>
       </Docs>
@@ -2002,7 +2140,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'System.Xml.XmlQualifiedName'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -2012,6 +2149,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains an <see cref="T:System.Xml.XmlQualifiedName" /> from a name that may contain a prefix. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlQualifiedName" /> that represents a namespace-qualified XML name.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A name that may contain a prefix.</param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSerializationWriter.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSerializationWriter.xml
index af4ba3d8811..c20824224b9 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSerializationWriter.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSerializationWriter.xml
@@ -104,7 +104,6 @@
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationWriter" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -113,6 +112,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.InvalidOperationException" /> that indicates an unexpected name for an element that adheres to an XML Schema choice element declaration.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created exception.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The name that is not valid.</param>
         <param name="identifier">
@@ -138,13 +141,16 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.InvalidOperationException" /> that indicates the <see cref="T:System.Xml.Serialization.XmlAnyElementAttribute" /> which has been invalidly applied to a member; only members that are of type <see cref="T:System.Xml.XmlNode" />, or derived from <see cref="T:System.Xml.XmlNode" />, are valid.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created exception.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object that represents the invalid member.</param>
       </Docs>
@@ -164,13 +170,16 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.InvalidOperationException" /> that indicates the <see cref="T:System.Xml.Serialization.XmlAnyElementAttribute" /> which has been invalidly applied to a member; only members that are of type <see cref="T:System.Xml.XmlNode" />, or derived from <see cref="T:System.Xml.XmlNode" />, are valid.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created exception.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> that is invalid.</param>
       </Docs>
@@ -192,7 +201,6 @@
         <Parameter Name="identifier" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationWriter" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -201,6 +209,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.InvalidOperationException" /> that indicates a failure while writing an array where an XML Schema choice element declaration is applied.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created exception.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type being serialized.</param>
         <param name="identifier">
@@ -223,13 +235,16 @@
         <Parameter Name="typeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.InvalidOperationException" /> for an invalid enumeration value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created exception.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that represents the invalid enumeration.</param>
         <param name="typeName">
@@ -254,7 +269,6 @@
         <Parameter Name="enumValue" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'System.Exception'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationWriter" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -263,6 +277,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.InvalidOperationException" /> that indicates that a value for an XML element does not match an enumeration type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created exception.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value that is not valid.</param>
         <param name="elementName">
@@ -288,7 +306,6 @@
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'System.Exception'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationWriter" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -297,6 +314,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.InvalidOperationException" /> that indicates that an XML element that should adhere to the XML Schema any element declaration cannot be processed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created exception.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The XML element that cannot be processed.</param>
         <param name="ns">
@@ -319,7 +340,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'System.Exception'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationWriter" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -328,6 +348,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.InvalidOperationException" /> that indicates that a type being serialized is not being used in a valid manner or is unexpectedly encountered.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created exception.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object whose type cannot be serialized.</param>
       </Docs>
@@ -348,7 +372,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'System.Exception'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationWriter" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -357,6 +380,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.InvalidOperationException" /> that indicates that a type being serialized is not being used in a valid manner or is unexpectedly encountered.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created exception.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type that cannot be serialized.</param>
       </Docs>
@@ -401,7 +428,6 @@
         <Parameter Name="value" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationWriter" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -411,6 +437,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes a base-64 byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The same byte array that was passed in as an argument.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A base-64 <see cref="T:System.Byte" /> array.</param>
       </Docs>
@@ -431,7 +461,6 @@
         <Parameter Name="value" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationWriter" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -441,6 +470,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces a string from an input hexadecimal byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The byte array value converted to a string.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A hexadecimal byte array to translate to a string.</param>
       </Docs>
@@ -461,7 +494,6 @@
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationWriter" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -471,6 +503,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces a string from an input <see cref="T:System.Char" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Char" /> value converted to a string.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Char" /> to translate to a string.</param>
       </Docs>
@@ -491,7 +527,6 @@
         <Parameter Name="value" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationWriter" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -501,6 +536,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces a string from a <see cref="T:System.DateTime" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the <see cref="T:System.DateTime" /> that shows the date but no time.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.DateTime" /> to translate to a string.</param>
       </Docs>
@@ -521,7 +560,6 @@
         <Parameter Name="value" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationWriter" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -531,6 +569,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces a string from an input <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the <see cref="T:System.DateTime" /> that shows the date and time.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.DateTime" /> to translate to a string.</param>
       </Docs>
@@ -553,7 +595,6 @@
         <Parameter Name="ids" Type="System.Int64[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationWriter" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -563,6 +604,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces a string that consists of delimited identifiers that represent the enumeration members that have been set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that consists of delimited identifiers, where each represents a member from the set enumerator list.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The enumeration value as a series of bitwise OR operations.</param>
         <param name="values">
@@ -589,7 +634,6 @@
         <Parameter Name="typeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -599,6 +643,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Takes a numeric enumeration value and the names and constants from the enumerator list for the enumeration and returns a string that consists of delimited identifiers that represent the enumeration members that have been set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that consists of delimited identifiers, where each item is one of the values set by the bitwise operation.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The enumeration value as a series of bitwise OR operations.</param>
         <param name="values">
@@ -625,7 +673,6 @@
         <Parameter Name="value" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationWriter" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -635,6 +682,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces a string from a <see cref="T:System.DateTime" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the <see cref="T:System.DateTime" /> object that shows the time but no date.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.DateTime" /> that is translated to a string.</param>
       </Docs>
@@ -655,7 +706,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationWriter" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -665,6 +715,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes a valid XML name by replacing characters that are not valid with escape sequences.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An encoded string.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />A string to be used as an XML name.</param>
       </Docs>
@@ -685,7 +739,6 @@
         <Parameter Name="ncName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of the <see cref="T:System.Xml.Serialization.XmlSerializationWriter" /> class are intended for use by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -695,6 +748,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes a valid XML local name by replacing characters that are not valid with escape sequences.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An encoded string.</para>
+        </returns>
         <param name="ncName">
           <attribution license="cc4" from="Microsoft" modified="false" />A string to be used as a local (unqualified) XML name.</param>
       </Docs>
@@ -715,7 +772,6 @@
         <Parameter Name="nmToken" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationWriter" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -725,6 +781,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes an XML name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An encoded string.</para>
+        </returns>
         <param name="nmToken">
           <attribution license="cc4" from="Microsoft" modified="false" />An XML name to be encoded.</param>
       </Docs>
@@ -745,7 +805,6 @@
         <Parameter Name="nmTokens" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationWriter" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -755,6 +814,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes a space-delimited sequence of XML names into a single XML name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An encoded string.</para>
+        </returns>
         <param name="nmTokens">
           <attribution license="cc4" from="Microsoft" modified="false" />A space-delimited sequence of XML names to be encoded.</param>
       </Docs>
@@ -775,7 +838,6 @@
         <Parameter Name="xmlQualifiedName" Type="System.Xml.XmlQualifiedName" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The protected members of <see cref="T:System.Xml.Serialization.XmlSerializationWriter" /> are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure.</para>
@@ -784,6 +846,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an XML qualified name, with invalid characters replaced by escape sequences.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML qualified name, with invalid characters replaced by escape sequences.</para>
+        </returns>
         <param name="xmlQualifiedName">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlQualifiedName" /> that represents the XML to be written.</param>
       </Docs>
@@ -804,13 +870,17 @@
         <Parameter Name="ignoreEmpty" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces a string that can be written as an XML qualified name, with invalid characters replaced by escape sequences.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML qualified name, with invalid characters replaced by escape sequences.</para>
+          <para />
+        </returns>
         <param name="xmlQualifiedName">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlQualifiedName" /> that represents the XML to be written.</param>
         <param name="ignoreEmpty">
@@ -884,7 +954,6 @@
         <Parameter Name="assemblyFullName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -895,6 +964,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a dynamically generated assembly by name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A dynamically generated assembly.</para>
+        </returns>
         <param name="assemblyFullName">
           <attribution license="cc4" from="Microsoft" modified="false" />The full name of the assembly.</param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSerializer.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSerializer.xml
index 4fc9241ae20..2ca985ca3fa 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSerializer.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSerializer.xml
@@ -464,12 +464,15 @@ xmlSerializer mySerializer=new XmlSerializer(typeof(LargeNumbers));</code>
         <Parameter Name="xmlReader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether this <see cref="T:System.Xml.Serialization.XmlSerializer" /> can deserialize a specified XML document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this <see cref="T:System.Xml.Serialization.XmlSerializer" /> can deserialize the object that the <see cref="T:System.Xml.XmlReader" /> points to; otherwise, false.</para>
+        </returns>
         <param name="xmlReader">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlReader" /> that points to the document to deserialize. </param>
       </Docs>
@@ -488,12 +491,15 @@ xmlSerializer mySerializer=new XmlSerializer(typeof(LargeNumbers));</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'XmlSerializationReader'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object used to read the XML document to be serialized.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> used to read the XML document.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateWriter">
@@ -510,12 +516,15 @@ xmlSerializer mySerializer=new XmlSerializer(typeof(LargeNumbers));</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'XmlSerializationWriter'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns a writer used to serialize the object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance that implements the <see cref="T:System.Xml.Serialization.XmlSerializationWriter" /> class.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Deserialize">
@@ -534,7 +543,6 @@ xmlSerializer mySerializer=new XmlSerializer(typeof(LargeNumbers));</code>
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserialization is the process of reading an XML document and constructing an object that is strongly typed to the XML Schema (XSD) of the document.</para>
@@ -570,6 +578,10 @@ xmlSerializer mySerializer=new XmlSerializer(typeof(LargeNumbers));</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes the XML document contained by the specified <see cref="T:System.IO.Stream" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> being deserialized.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.Stream" /> that contains the XML document to deserialize. </param>
       </Docs>
@@ -590,7 +602,6 @@ xmlSerializer mySerializer=new XmlSerializer(typeof(LargeNumbers));</code>
         <Parameter Name="textReader" Type="System.IO.TextReader" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserialization is the process of reading an instance of an XML document and constructing an object that is strongly typed to the XML Schema (XSD) of the document.</para>
@@ -607,6 +618,10 @@ xmlSerializer mySerializer=new XmlSerializer(typeof(LargeNumbers));</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes the XML document contained by the specified <see cref="T:System.IO.TextReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> being deserialized.</para>
+        </returns>
         <param name="textReader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.TextReader" /> that contains the XML document to deserialize. </param>
       </Docs>
@@ -627,12 +642,15 @@ xmlSerializer mySerializer=new XmlSerializer(typeof(LargeNumbers));</code>
         <Parameter Name="reader" Type="System.Xml.Serialization.XmlSerializationReader" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes the XML document contained by the specified <see cref="T:System.Xml.Serialization.XmlSerializationReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The deserialized object.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Serialization.XmlSerializationReader" /> that contains the XML document to deserialize. </param>
       </Docs>
@@ -653,7 +671,6 @@ xmlSerializer mySerializer=new XmlSerializer(typeof(LargeNumbers));</code>
         <Parameter Name="xmlReader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserialization is the process of reading an instance of an XML document and constructing an object that is strongly typed to the XML Schema (XSD) of the document.</para>
@@ -667,6 +684,10 @@ xmlSerializer mySerializer=new XmlSerializer(typeof(LargeNumbers));</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes the XML document contained by the specified <see cref="T:System.xml.XmlReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> being deserialized.</para>
+        </returns>
         <param name="xmlReader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.xml.XmlReader" /> that contains the XML document to deserialize. </param>
       </Docs>
@@ -687,7 +708,6 @@ xmlSerializer mySerializer=new XmlSerializer(typeof(LargeNumbers));</code>
         <Parameter Name="encodingStyle" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -700,6 +720,10 @@ xmlSerializer mySerializer=new XmlSerializer(typeof(LargeNumbers));</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes the XML document contained by the specified <see cref="T:System.xml.XmlReader" /> and encoding style.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The deserialized object.</para>
+        </returns>
         <param name="xmlReader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.xml.XmlReader" /> that contains the XML document to deserialize. </param>
         <param name="encodingStyle">
@@ -722,7 +746,6 @@ xmlSerializer mySerializer=new XmlSerializer(typeof(LargeNumbers));</code>
         <Parameter Name="events" Type="System.Xml.Serialization.XmlDeserializationEvents" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -732,6 +755,10 @@ xmlSerializer mySerializer=new XmlSerializer(typeof(LargeNumbers));</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes an XML document contained by the specified <see cref="T:System.Xml.XmlReader" /> and allows the overriding of events that occur during deserialization.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> being deserialized.</para>
+        </returns>
         <param name="xmlReader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> that contains the document to deserialize.</param>
         <param name="events">
@@ -755,7 +782,6 @@ xmlSerializer mySerializer=new XmlSerializer(typeof(LargeNumbers));</code>
         <Parameter Name="events" Type="System.Xml.Serialization.XmlDeserializationEvents" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -765,6 +791,10 @@ xmlSerializer mySerializer=new XmlSerializer(typeof(LargeNumbers));</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes the object using the data contained by the specified <see cref="T:System.Xml.XmlReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object being deserialized.</para>
+        </returns>
         <param name="xmlReader">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of the <see cref="T:System.Xml.XmlReader" /> class used to read the document.</param>
         <param name="encodingStyle">
@@ -789,12 +819,15 @@ xmlSerializer mySerializer=new XmlSerializer(typeof(LargeNumbers));</code>
         <Parameter Name="mappings" Type="System.Xml.Serialization.XmlMapping[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlSerializer[]'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of <see cref="T:System.Xml.Serialization.XmlSerializer" /> objects created from an array of <see cref="T:System.Xml.Serialization.XmlTypeMapping" /> objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Xml.Serialization.XmlSerializer" /> objects.</para>
+        </returns>
         <param name="mappings">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Xml.Serialization.XmlTypeMapping" /> that maps one type to another. </param>
       </Docs>
@@ -815,13 +848,16 @@ xmlSerializer mySerializer=new XmlSerializer(typeof(LargeNumbers));</code>
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an instance of the <see cref="T:System.Xml.Serialization.XmlSerializer" /> class created from mappings of one XML type to another.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the <see cref="T:System.Xml.Serialization.XmlSerializer" /> class.</para>
+        </returns>
         <param name="mappings">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Xml.Serialization.XmlMapping" /> objects used to map one type to another.</param>
         <param name="evidence">
@@ -844,13 +880,16 @@ xmlSerializer mySerializer=new XmlSerializer(typeof(LargeNumbers));</code>
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an instance of the <see cref="T:System.Xml.Serialization.XmlSerializer" /> class from the specified mappings.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the <see cref="T:System.Xml.Serialization.XmlSerializer" /> class.</para>
+        </returns>
         <param name="mappings">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Xml.Serialization.XmlMapping" /> objects.</param>
         <param name="type">
@@ -873,7 +912,6 @@ xmlSerializer mySerializer=new XmlSerializer(typeof(LargeNumbers));</code>
         <Parameter Name="types" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlSerializer[]'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Xml.Serialization.XmlSerializer.FromTypes(System.Type[])" /> method allows you to efficiently create an array of <see cref="T:System.Xml.Serialization.XmlSerializer" /> objects for processing an array of <see cref="T:System.Type" /> objects.</para>
@@ -882,6 +920,10 @@ xmlSerializer mySerializer=new XmlSerializer(typeof(LargeNumbers));</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of <see cref="T:System.Xml.Serialization.XmlSerializer" /> objects created from an array of types.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Xml.Serialization.XmlSerializer" /> objects.</para>
+        </returns>
         <param name="types">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Type" /> objects. </param>
       </Docs>
@@ -902,13 +944,16 @@ xmlSerializer mySerializer=new XmlSerializer(typeof(LargeNumbers));</code>
         <Parameter Name="mappings" Type="System.Xml.Serialization.XmlMapping[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an assembly that contains custom-made serializers used to serialize or deserialize the specified type or types, using the specified mappings.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Reflection.Assembly" /> object that contains serializers for the supplied types and mappings.</para>
+        </returns>
         <param name="types">
           <attribution license="cc4" from="Microsoft" modified="false" />A collection of types.</param>
         <param name="mappings">
@@ -932,13 +977,16 @@ xmlSerializer mySerializer=new XmlSerializer(typeof(LargeNumbers));</code>
         <Parameter Name="parameters" Type="System.CodeDom.Compiler.CompilerParameters" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an assembly that contains custom-made serializers used to serialize or deserialize the specified type or types, using the specified mappings and compiler settings and options. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Reflection.Assembly" /> that contains special versions of the <see cref="T:System.Xml.Serialization.XmlSerializer" />.</para>
+        </returns>
         <param name="types">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Type" /> that contains objects used to serialize and deserialize data.</param>
         <param name="mappings">
@@ -962,7 +1010,6 @@ xmlSerializer mySerializer=new XmlSerializer(typeof(LargeNumbers));</code>
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -973,6 +1020,10 @@ xmlSerializer mySerializer=new XmlSerializer(typeof(LargeNumbers));</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the assembly that contains one or more versions of the <see cref="T:System.Xml.Serialization.XmlSerializer" /> especially created to serialize or deserialize the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the assembly that contains an <see cref="T:System.Xml.Serialization.XmlSerializer" /> for the type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> you are deserializing.</param>
       </Docs>
@@ -993,7 +1044,6 @@ xmlSerializer mySerializer=new XmlSerializer(typeof(LargeNumbers));</code>
         <Parameter Name="defaultNamespace" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1004,6 +1054,10 @@ xmlSerializer mySerializer=new XmlSerializer(typeof(LargeNumbers));</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the assembly that contains the serializer for the specified type in the specified namespace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the assembly that contains specially built serializers.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> you are interested in.</param>
         <param name="defaultNamespace">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSerializerFactory.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSerializerFactory.xml
index b3f84b2e9b8..c30ad962758 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSerializerFactory.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSerializerFactory.xml
@@ -53,13 +53,16 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a derivation of the <see cref="T:System.Xml.Serialization.XmlSerializerFactory" /> class that is used to serialize the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A derivation of the <see cref="T:System.Xml.Serialization.XmlSerializer" /> class that is specifically created to serialize the specified type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> to serialize.</param>
       </Docs>
@@ -79,13 +82,16 @@
         <Parameter Name="xmlTypeMapping" Type="System.Xml.Serialization.XmlTypeMapping" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a derivation of the <see cref="T:System.Xml.Serialization.XmlSerializerFactory" /> class using an object that maps one type to another.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A derivation of the <see cref="T:System.Xml.Serialization.XmlSerializer" /> class that is specifically created to serialize the mapped type.</para>
+        </returns>
         <param name="xmlTypeMapping">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.Serialization.XmlTypeMapping" /> that maps one type to another.</param>
       </Docs>
@@ -106,13 +112,16 @@
         <Parameter Name="defaultNamespace" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a derivation of the <see cref="T:System.Xml.Serialization.XmlSerializerFactory" /> class that is used to serialize the specified type and namespace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A derivation of the <see cref="T:System.Xml.Serialization.XmlSerializer" /> class that is specifically created to serialize the specified type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> to serialize.</param>
         <param name="defaultNamespace">
@@ -135,7 +144,6 @@
         <Parameter Name="extraTypes" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -145,6 +153,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a derivation of the <see cref="T:System.Xml.Serialization.XmlSerializerFactory" /> class that is used to serialize the specified type. If a property or field returns an array, the <paramref name="extraTypes" /> parameter specifies objects that can be inserted into the array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A derivation of the <see cref="T:System.Xml.Serialization.XmlSerializer" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> to serialize.</param>
         <param name="extraTypes">
@@ -167,7 +179,6 @@
         <Parameter Name="overrides" Type="System.Xml.Serialization.XmlAttributeOverrides" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -177,6 +188,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a derivation of the <see cref="T:System.Xml.Serialization.XmlSerializer" /> class that can serialize objects of the specified type into XML documents, and vice versa. Each object to be serialized can itself contain instances of classes, which this overload can override with other classes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A derivation of the <see cref="T:System.Xml.Serialization.XmlSerializer" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> to serialize.</param>
         <param name="overrides">
@@ -199,7 +214,6 @@
         <Parameter Name="root" Type="System.Xml.Serialization.XmlRootAttribute" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -209,6 +223,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a derivation of the <see cref="T:System.Xml.Serialization.XmlSerializer" /> class that can serialize objects of the specified type into XML documents, and vice versa. Specifies the object that represents the XML root element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A derivation of the <see cref="T:System.Xml.Serialization.XmlSerializer" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> to serialize.</param>
         <param name="root">
@@ -234,7 +252,6 @@
         <Parameter Name="defaultNamespace" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -244,6 +261,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a derivation of the <see cref="T:System.Xml.Serialization.XmlSerializer" /> class that can serialize objects of the specified type into XML document instances, and vice versa. Each object to be serialized can itself contain instances of classes, which this overload can override with other classes. This overload also specifies the default namespace for all the XML elements, and the class to use as the XML root element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A derivation of the <see cref="T:System.Xml.Serialization.XmlSerializer" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> to serialize.</param>
         <param name="overrides">
@@ -277,7 +298,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -287,6 +307,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a derivation of the <see cref="T:System.Xml.Serialization.XmlSerializer" /> class that can serialize objects of the specified type into XML document instances, and vice versa. Each object to be serialized can itself contain instances of classes, which this overload can override with other classes. This overload also specifies the default namespace for all the XML elements, and the class to use as the XML root element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A derivation of the <see cref="T:System.Xml.Serialization.XmlSerializer" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the object that this <see cref="T:System.Xml.Serialization.XmlSerializer" /> can serialize.</param>
         <param name="overrides">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSerializerImplementation.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSerializerImplementation.xml
index eb19921d561..28e69025cf3 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSerializerImplementation.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSerializerImplementation.xml
@@ -56,13 +56,16 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that determines whether a type can be serialized.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the type can be serialized; otherwise, false.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> to be serialized.</param>
       </Docs>
@@ -82,13 +85,16 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a serializer for the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of a type derived from the <see cref="T:System.Xml.Serialization.XmlSerializer" /> class. </para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> to be serialized.</param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSerializerNamespaces.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSerializerNamespaces.xml
index c9c1895520a..ff266fad0ab 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSerializerNamespaces.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Serialization/XmlSerializerNamespaces.xml
@@ -219,12 +219,15 @@ ns.Add("", "")</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'System.Xml.XmlQualifiedName[]'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the array of prefix and namespace pairs in an <see cref="T:System.Xml.Serialization.XmlSerializerNamespaces" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Xml.XmlQualifiedName" /> objects that are used as qualified names in an XML document.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.XPath/IXPathNavigable.xml b/mcs/class/System.XML/Documentation/en/System.Xml.XPath/IXPathNavigable.xml
index 6253c390598..e458d9a99d1 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.XPath/IXPathNavigable.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.XPath/IXPathNavigable.xml
@@ -33,7 +33,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>The <see cref="System.Xml.XPath.XPathNavigator" /> instance created by the implementation of this interface.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="M:System.Xml.XPath.IXPathNavigable.CreateNavigator" /> method is called from an <see cref="T:System.Xml.XmlNode" /> object, the <see cref="T:System.Xml.XPath.XPathNavigator" /> object is initially positioned on the node from which the method was called. If the <see cref="M:System.Xml.XPath.IXPathNavigable.CreateNavigator" /> method is called from an <see cref="T:System.Xml.XPath.XPathDocument" /> object or an <see cref="T:System.Xml.XmlDocument" /> object, the <see cref="T:System.Xml.XPath.XPathNavigator" /> object is positioned on the root of the document.</para>
@@ -42,6 +41,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new <see cref="T:System.Xml.XPath.XPathNavigator" /> object. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XPath.XPathNavigator" /> object.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.XPath/XPathDocument.xml b/mcs/class/System.XML/Documentation/en/System.Xml.XPath/XPathDocument.xml
index f77a63c5ac8..5ea6dbbdd7e 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.XPath/XPathDocument.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.XPath/XPathDocument.xml
@@ -228,7 +228,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>The <see cref="System.Xml.XPath.XPathNavigator" /> instance created by this class.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Xml.XPath.XPathNavigator" /> is positioned on the root element of the <see cref="T:System.Xml.XPath.XPathDocument" />. If there is no root element, the <see cref="T:System.Xml.XPath.XPathNavigator" /> is positioned on the first element in the <see cref="T:System.Xml.XPath.XPathDocument" />.</para>
@@ -237,6 +236,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a read-only <see cref="T:System.Xml.XPath.XPathNavigator" /> object for navigating through nodes in this <see cref="T:System.Xml.XPath.XPathDocument" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A read-only <see cref="T:System.Xml.XPath.XPathNavigator" /> object.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.XPath/XPathExpression.xml b/mcs/class/System.XML/Documentation/en/System.Xml.XPath/XPathExpression.xml
index 463d3fd4b7d..d3d9336edc1 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.XPath/XPathExpression.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.XPath/XPathExpression.xml
@@ -139,7 +139,6 @@ expression.AddSort("@ISBN", (IComparer)isbn);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>An XPathExpression that is the copy of this instance.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, the <see cref="M:System.Xml.XPath.XPathExpression.Clone" /> method returns a clone of this <see cref="T:System.Xml.XPath.XPathExpression" /> object with the same state as this <see cref="T:System.Xml.XPath.XPathExpression" /> object.</para>
@@ -148,6 +147,10 @@ expression.AddSort("@ISBN", (IComparer)isbn);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns a clone of this <see cref="T:System.Xml.XPath.XPathExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Xml.XPath.XPathExpression" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Compile">
@@ -165,7 +168,6 @@ expression.AddSort("@ISBN", (IComparer)isbn);</code>
         <Parameter Name="xpath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -200,6 +202,10 @@ expression.AddSort("@ISBN", (IComparer)isbn);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compiles the XPath expression specified and returns an <see cref="T:System.Xml.XPath.XPathExpression" /> object representing the XPath expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XPath.XPathExpression" /> object.</para>
+        </returns>
         <param name="xpath">
           <attribution license="cc4" from="Microsoft" modified="false" />An XPath expression.</param>
       </Docs>
@@ -220,7 +226,6 @@ expression.AddSort("@ISBN", (IComparer)isbn);</code>
         <Parameter Name="nsResolver" Type="System.Xml.IXmlNamespaceResolver" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -259,6 +264,10 @@ expression.AddSort("@ISBN", (IComparer)isbn);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compiles the specified XPath expression, with the <see cref="T:System.Xml.IXmlNamespaceResolver" /> object specified for namespace resolution, and returns an <see cref="T:System.Xml.XPath.XPathExpression" /> object that represents the XPath expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XPath.XPathExpression" /> object.</para>
+        </returns>
         <param name="xpath">
           <attribution license="cc4" from="Microsoft" modified="false" />An XPath expression.</param>
         <param name="nsResolver">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.XPath/XPathItem.xml b/mcs/class/System.XML/Documentation/en/System.Xml.XPath/XPathItem.xml
index 225aad6a200..e94de511517 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.XPath/XPathItem.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.XPath/XPathItem.xml
@@ -126,7 +126,6 @@
         <Parameter Name="returnType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -136,6 +135,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the item's value as the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the item as the type requested.</para>
+        </returns>
         <param name="returnType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to return the item value as.</param>
       </Docs>
@@ -156,7 +159,6 @@
         <Parameter Name="nsResolver" Type="System.Xml.IXmlNamespaceResolver" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -168,6 +170,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the item's value as the type specified using the <see cref="T:System.Xml.IXmlNamespaceResolver" /> object specified to resolve namespace prefixes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the item as the type requested.</para>
+        </returns>
         <param name="returnType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to return the item's value as.</param>
         <param name="nsResolver">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.XPath/XPathNavigator.xml b/mcs/class/System.XML/Documentation/en/System.Xml.XPath/XPathNavigator.xml
index 326177f99a9..dc50ed8fed4 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.XPath/XPathNavigator.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.XPath/XPathNavigator.xml
@@ -75,7 +75,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -98,6 +97,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Xml.XmlWriter" /> object used to create one or more new child nodes at the end of the list of child nodes of the current node. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlWriter" /> object used to create new child nodes at the end of the list of child nodes of the current node.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="AppendChild">
@@ -372,7 +375,6 @@
         <Parameter Name="validationEventHandler" Type="System.Xml.Schema.ValidationEventHandler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -398,6 +400,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies that the XML data in the <see cref="T:System.Xml.XPath.XPathNavigator" /> conforms to the XML Schema definition language (XSD) schema provided.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if no schema validation errors occurred; otherwise, false.</para>
+        </returns>
         <param name="schemas">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Schema.XmlSchemaSet" /> containing the schemas used to validate the XML data contained in the <see cref="T:System.Xml.XPath.XPathNavigator" />.</param>
         <param name="validationEventHandler">
@@ -418,7 +424,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>The cloned XPathNavigator.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Xml.XPath.XPathNavigator.Clone" /> method is especially useful in conjunction with the <see cref="T:System.Xml.XPath.XPathNodeIterator" />. An <see cref="T:System.Xml.XPath.XPathNodeIterator" /> is used to iterate over a selected node set, and contains a <see cref="P:System.Xml.XPath.XPathNodeIterator.Current" /> property which returns an <see cref="T:System.Xml.XPath.XPathNavigator" /> positioned on the context node of the <see cref="T:System.Xml.XPath.XPathNodeIterator" />. However, the <see cref="T:System.Xml.XPath.XPathNavigator" /> returned by the <see cref="P:System.Xml.XPath.XPathNodeIterator.Current" /> property cannot be used to move away from the node set. Instead, you clone the returned <see cref="T:System.Xml.XPath.XPathNavigator" /> and use the cloned navigator to do any additional moves.</para>
@@ -428,6 +433,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates a new <see cref="T:System.Xml.XPath.XPathNavigator" /> positioned at the same node as this <see cref="T:System.Xml.XPath.XPathNavigator" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Xml.XPath.XPathNavigator" /> positioned at the same node as this <see cref="T:System.Xml.XPath.XPathNavigator" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ComparePosition">
@@ -446,8 +455,6 @@
         <Parameter Name="nav" Type="System.Xml.XPath.XPathNavigator" />
       </Parameters>
       <Docs>
-        <returns>
-          <see cref="F:System.Xml.XmlNodeOrder.Unknown" /> if the argument navigator comes from different IXPathNavigable instance; <see cref="T:System.Xml.XmlNodeOrder.Same" /> if the navigator is positioned on the same location as this navigator; <see cref="F:System.Xml.XmlNodeOrder.Before" /> if this instance positions current node before the current node of the argument navigator; <see cref="F:System.Xml.XmlNodeOrder.After" /> if the argument navigator positions current node before the current node of this instance.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following table describes the <see cref="T:System.Xml.XmlNodeOrder" /> enumeration.</para>
@@ -530,6 +537,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the position of the current <see cref="T:System.Xml.XPath.XPathNavigator" /> with the position of the <see cref="T:System.Xml.XPath.XPathNavigator" /> specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlNodeOrder" /> value representing the comparative position of the two <see cref="T:System.Xml.XPath.XPathNavigator" /> objects.</para>
+        </returns>
         <param name="nav">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XPath.XPathNavigator" /> to compare against.</param>
       </Docs>
@@ -550,7 +561,6 @@
         <Parameter Name="xpath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>An <see cref="T:System.Xml.XPath.XPathExpression" /> instance that is the result of compilation.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An XPath expression is evaluated to yield one of the following return types: </para>
@@ -574,6 +584,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compiles a string representing an XPath expression and returns an <see cref="T:System.Xml.XPath.XPathExpression" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XPath.XPathExpression" /> object representing the XPath expression.</para>
+        </returns>
         <param name="xpath">
           <attribution license="cc4" from="Microsoft" modified="false" />A string representing an XPath expression.</param>
       </Docs>
@@ -642,7 +656,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -672,6 +685,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Xml.XmlWriter" /> object used to create new attributes on the current element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlWriter" /> object used to create new attributes on the current element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateNavigator">
@@ -687,7 +704,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -697,6 +713,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a copy of the <see cref="T:System.Xml.XPath.XPathNavigator" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XPath.XPathNavigator" /> copy of this <see cref="T:System.Xml.XPath.XPathNavigator" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DeleteRange">
@@ -777,7 +797,6 @@
         <Parameter Name="xpath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>An <see cref="System.Object" /> instance that represents the evaluation result.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following C# code converts the Price/text() node to a number, multiplies it by 10, and returns the resulting value.</para>
@@ -791,6 +810,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates the specified XPath expression and returns the typed result.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of the expression (Boolean, number, string, or node set). This maps to <see cref="T:System.Boolean" />, <see cref="T:System.Double" />, <see cref="T:System.String" />, or <see cref="T:System.Xml.XPath.XPathNodeIterator" /> objects respectively.</para>
+        </returns>
         <param name="xpath">
           <attribution license="cc4" from="Microsoft" modified="false" />A string representing an XPath expression that can be evaluated.</param>
       </Docs>
@@ -811,7 +834,6 @@
         <Parameter Name="expr" Type="System.Xml.XPath.XPathExpression" />
       </Parameters>
       <Docs>
-        <returns>An <see cref="System.Object" /> instance that represents the evaluation result.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following C# code returns a number after converting the Price/text() node to a number and multiplying the value by 10.</para>
@@ -826,6 +848,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates the <see cref="T:System.Xml.XPath.XPathExpression" /> and returns the typed result.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of the expression (Boolean, number, string, or node set). This maps to <see cref="T:System.Boolean" />, <see cref="T:System.Double" />, <see cref="T:System.String" />, or <see cref="T:System.Xml.XPath.XPathNodeIterator" /> objects respectively.</para>
+        </returns>
         <param name="expr">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XPath.XPathExpression" /> that can be evaluated.</param>
       </Docs>
@@ -846,7 +872,6 @@ nav.Evaluate(expr);</code>
         <Parameter Name="resolver" Type="System.Xml.IXmlNamespaceResolver" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -862,6 +887,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates the specified XPath expression and returns the typed result, using the <see cref="T:System.Xml.IXmlNamespaceResolver" /> object specified to resolve namespace prefixes in the XPath expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of the expression (Boolean, number, string, or node set). This maps to <see cref="T:System.Boolean" />, <see cref="T:System.Double" />, <see cref="T:System.String" />, or <see cref="T:System.Xml.XPath.XPathNodeIterator" /> objects respectively.</para>
+        </returns>
         <param name="xpath">
           <attribution license="cc4" from="Microsoft" modified="false" />A string representing an XPath expression that can be evaluated.</param>
         <param name="resolver">
@@ -885,7 +914,6 @@ nav.Evaluate(expr);</code>
         <Parameter Name="context" Type="System.Xml.XPath.XPathNodeIterator" />
       </Parameters>
       <Docs>
-        <returns>An <see cref="System.Object" /> instance that represents the evaluation result.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The expression is evaluated using the <see cref="P:System.Xml.XPath.XPathNodeIterator.Current" /> node of the <see cref="T:System.Xml.XPath.XPathNodeIterator" /> as the context node. If <paramref name="context" /> is null, the node on which the <see cref="T:System.Xml.XPath.XPathNavigator" /> is currently positioned is used as the context node.</para>
@@ -906,6 +934,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uses the supplied context to evaluate the <see cref="T:System.Xml.XPath.XPathExpression" />, and returns the typed result.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of the expression (Boolean, number, string, or node set). This maps to <see cref="T:System.Boolean" />, <see cref="T:System.Double" />, <see cref="T:System.String" />, or <see cref="T:System.Xml.XPath.XPathNodeIterator" /> objects respectively.</para>
+        </returns>
         <param name="expr">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XPath.XPathExpression" /> that can be evaluated.</param>
         <param name="context">
@@ -929,7 +961,6 @@ nav.Evaluate(expr);</code>
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>The value of the specified attribute. String.Empty if the current node is not element, or specified attribute was not found.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Xml.XPath.XPathNavigator" /> must be positioned on an element node before calling the <see cref="M:System.Xml.XPath.XPathNavigator.GetAttribute(System.String,System.String)" /> method.</para>
@@ -939,6 +970,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the attribute with the specified local name and namespace URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that contains the value of the specified attribute; <see cref="F:System.String.Empty" /> if a matching attribute is not found, or if the <see cref="T:System.Xml.XPath.XPathNavigator" /> is not positioned on an element node.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the attribute.</param>
         <param name="namespaceURI">
@@ -961,7 +996,6 @@ nav.Evaluate(expr);</code>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>The namespace URI string if there was the specified namespace node. String.Empty if no such namespace node.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Namespaces xml and xmlns always return a value. If <see cref="F:System.String.Empty" /> is specified as the <paramref name="name" /> parameter, the <see cref="M:System.Xml.XPath.XPathNavigator.GetNamespace(System.String)" /> method returns the default xmlns namespace.</para>
@@ -972,6 +1006,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the namespace node corresponding to the specified local name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that contains the value of the namespace node; <see cref="F:System.String.Empty" /> if a matching namespace node is not found, or if the <see cref="T:System.Xml.XPath.XPathNavigator" /> is not positioned on an element node.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the namespace node.</param>
       </Docs>
@@ -991,7 +1029,6 @@ nav.Evaluate(expr);</code>
         <Parameter Name="scope" Type="System.Xml.XmlNamespaceScope" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1043,6 +1080,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the in-scope namespaces of the current node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IDictionary`2" /> collection of namespace names keyed by prefix.</para>
+        </returns>
         <param name="scope">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlNamespaceScope" /> value specifying the namespaces to return.</param>
       </Docs>
@@ -1179,7 +1220,6 @@ nav.Evaluate(expr);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1200,6 +1240,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Xml.XmlWriter" /> object used to create a new sibling node after the currently selected node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlWriter" /> object used to create a new sibling node after the currently selected node.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InsertAfter">
@@ -1330,7 +1374,6 @@ nav.Evaluate(expr);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1351,6 +1394,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Xml.XmlWriter" /> object used to create a new sibling node before the currently selected node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlWriter" /> object used to create a new sibling node before the currently selected node.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InsertBefore">
@@ -1586,7 +1633,6 @@ nav.Evaluate(expr);</code>
         <Parameter Name="nav" Type="System.Xml.XPath.XPathNavigator" />
       </Parameters>
       <Docs>
-        <returns>True if the argument navigator is a descendant of this navigator; Otherwise False.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An <see cref="T:System.Xml.XPath.XPathNavigator" /> is a descendant of the current <see cref="T:System.Xml.XPath.XPathNavigator" /> if it is positioned on a descendant node of the current <see cref="T:System.Xml.XPath.XPathNavigator" />. Take, for example, the following XML string: </para>
@@ -1606,6 +1652,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Xml.XPath.XPathNavigator" /> is a descendant of the current <see cref="T:System.Xml.XPath.XPathNavigator" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Xml.XPath.XPathNavigator" /> is a descendant of the current <see cref="T:System.Xml.XPath.XPathNavigator" />; otherwise, false.</para>
+        </returns>
         <param name="nav">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XPath.XPathNavigator" /> to compare to this <see cref="T:System.Xml.XPath.XPathNavigator" />.</param>
       </Docs>
@@ -1707,7 +1757,6 @@ nav.Evaluate(expr);</code>
         <Parameter Name="other" Type="System.Xml.XPath.XPathNavigator" />
       </Parameters>
       <Docs>
-        <returns>True if the current node was the same position; Otherwise False.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Xml.XPath.XPathNavigator.IsSamePosition(System.Xml.XPath.XPathNavigator)" /> method assumes that the <see cref="T:System.Xml.XPath.XPathNavigator" /> specified shares the same implementation and is points at the same document instance as the current <see cref="T:System.Xml.XPath.XPathNavigator" />.</para>
@@ -1725,6 +1774,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, determines whether the current <see cref="T:System.Xml.XPath.XPathNavigator" /> is at the same position as the specified <see cref="T:System.Xml.XPath.XPathNavigator" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two <see cref="T:System.Xml.XPath.XPathNavigator" /> objects have the same position; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XPath.XPathNavigator" /> to compare to this <see cref="T:System.Xml.XPath.XPathNavigator" />.</param>
       </Docs>
@@ -1830,7 +1883,6 @@ nav.Evaluate(expr);</code>
         <Parameter Name="prefix" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1843,6 +1895,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the namespace URI for the specified prefix.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that contains the namespace URI assigned to the namespace prefix specified; null if no namespace URI is assigned to the prefix specified. The <see cref="T:System.String" /> returned is atomized.</para>
+        </returns>
         <param name="prefix">
           <attribution license="cc4" from="Microsoft" modified="false" />The prefix whose namespace URI you want to resolve. To match the default namespace, pass <see cref="F:System.String.Empty" />.</param>
       </Docs>
@@ -1862,7 +1918,6 @@ nav.Evaluate(expr);</code>
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1875,6 +1930,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the prefix declared for the specified namespace URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that contains the namespace prefix assigned to the namespace URI specified; otherwise, <see cref="F:System.String.Empty" /> if no prefix is assigned to the namespace URI specified. The <see cref="T:System.String" /> returned is atomized.</para>
+        </returns>
         <param name="namespaceURI">
           <attribution license="cc4" from="Microsoft" modified="false" />The namespace URI to resolve for the prefix.</param>
       </Docs>
@@ -1895,7 +1954,6 @@ nav.Evaluate(expr);</code>
         <Parameter Name="xpath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>True if the current node matches; otherwise False.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has no affect on the state of the <see cref="T:System.Xml.XPath.XPathNavigator" />.</para>
@@ -1904,6 +1962,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current node matches the specified XPath expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current node matches the specified XPath expression; otherwise, false.</para>
+        </returns>
         <param name="xpath">
           <attribution license="cc4" from="Microsoft" modified="false" />The XPath expression.</param>
       </Docs>
@@ -1924,7 +1986,6 @@ nav.Evaluate(expr);</code>
         <Parameter Name="expr" Type="System.Xml.XPath.XPathExpression" />
       </Parameters>
       <Docs>
-        <returns>True if the current node matches; otherwise False.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has no effect on the state of the <see cref="T:System.Xml.XPath.XPathNavigator" />. This method is identical to the <see cref="M:System.Xml.XPath.XPathNavigator.Matches(System.String)" /> method, except that a <see cref="T:System.Xml.XPath.XPathExpression" /> object containing the compiled XPath expression is specified, rather than an XPath expression <see cref="T:System.String" />.</para>
@@ -1933,6 +1994,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current node matches the specified <see cref="T:System.Xml.XPath.XPathExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current node matches the <see cref="T:System.Xml.XPath.XPathExpression" />; otherwise, false.</para>
+        </returns>
         <param name="expr">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XPath.XPathExpression" /> object containing the compiled XPath expression.</param>
       </Docs>
@@ -1953,7 +2018,6 @@ nav.Evaluate(expr);</code>
         <Parameter Name="other" Type="System.Xml.XPath.XPathNavigator" />
       </Parameters>
       <Docs>
-        <returns>True if it successfully moved the current node; Otherwise False.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method always returns true if the <see cref="T:System.Xml.XPath.XPathNavigator" /> specified is an <see cref="T:System.Xml.XPath.XPathNavigator" /> that shares the same implementation and points at the same document instance as the current <see cref="T:System.Xml.XPath.XPathNavigator" />.</para>
@@ -1963,6 +2027,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, moves the <see cref="T:System.Xml.XPath.XPathNavigator" /> to the same position as the specified <see cref="T:System.Xml.XPath.XPathNavigator" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the <see cref="T:System.Xml.XPath.XPathNavigator" /> is successful moving to the same position as the specified <see cref="T:System.Xml.XPath.XPathNavigator" />; otherwise, false. If false, the position of the <see cref="T:System.Xml.XPath.XPathNavigator" /> is unchanged.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XPath.XPathNavigator" /> positioned on the node that you want to move to. </param>
       </Docs>
@@ -1984,7 +2052,6 @@ nav.Evaluate(expr);</code>
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>True if the current node was successfully moved to the specified attribute; Otherwise False.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="T:System.Xml.XPath.XPathNavigator" /> is not currently positioned on an element, this method returns false.</para>
@@ -1995,6 +2062,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves the <see cref="T:System.Xml.XPath.XPathNavigator" /> to the attribute with the matching local name and namespace URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the <see cref="T:System.Xml.XPath.XPathNavigator" /> is successful moving to the attribute; otherwise, false. If false, the position of the <see cref="T:System.Xml.XPath.XPathNavigator" /> is unchanged.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the attribute.</param>
         <param name="namespaceURI">
@@ -2016,7 +2087,6 @@ nav.Evaluate(expr);</code>
         <Parameter Name="type" Type="System.Xml.XPath.XPathNodeType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2069,6 +2139,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves the <see cref="T:System.Xml.XPath.XPathNavigator" /> to the child node of the <see cref="T:System.Xml.XPath.XPathNodeType" /> specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the <see cref="T:System.Xml.XPath.XPathNavigator" /> is successful moving to the child node; otherwise, false. If false, the position of the <see cref="T:System.Xml.XPath.XPathNavigator" /> is unchanged.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XPath.XPathNodeType" /> of the child node to move to.</param>
       </Docs>
@@ -2089,13 +2163,16 @@ nav.Evaluate(expr);</code>
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves the <see cref="T:System.Xml.XPath.XPathNavigator" /> to the child node with the local name and namespace URI specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the <see cref="T:System.Xml.XPath.XPathNavigator" /> is successful moving to the child node; otherwise, false. If false, the position of the <see cref="T:System.Xml.XPath.XPathNavigator" /> is unchanged.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the child node to move to.</param>
         <param name="namespaceURI">
@@ -2116,12 +2193,16 @@ nav.Evaluate(expr);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>True if the current node was not the first sibling and moved successfully; False if it is the first node for the other siblings.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves the <see cref="T:System.Xml.XPath.XPathNavigator" /> to the first sibling node of the current node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the <see cref="T:System.Xml.XPath.XPathNavigator" /> is successful moving to the first sibling node of the current node; false if there is no first sibling, or if the <see cref="T:System.Xml.XPath.XPathNavigator" /> is currently positioned on an attribute node. If the <see cref="T:System.Xml.XPath.XPathNavigator" /> is already positioned on the first sibling, <see cref="T:System.Xml.XPath.XPathNavigator" /> will return true and will not move its position.</para>
+          <para>If <see cref="T:System.Xml.XPath.XPathNavigator.MoveToFirst" /> returns false because there is no first sibling, or if <see cref="T:System.Xml.XPath.XPathNavigator" /> is currently positioned on an attribute, the position of the <see cref="T:System.Xml.XPath.XPathNavigator" /> is unchanged.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MoveToFirstAttribute">
@@ -2138,7 +2219,6 @@ nav.Evaluate(expr);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>True if the current node was successfully moved to the first attribute; False if the current node is not element, or the current element has no attributes.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="T:System.Xml.XPath.XPathNavigator" /> is not currently positioned on an element, this method returns false and the position of the <see cref="T:System.Xml.XPath.XPathNavigator" /> does not change.</para>
@@ -2149,6 +2229,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, moves the <see cref="T:System.Xml.XPath.XPathNavigator" /> to the first attribute of the current node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the <see cref="T:System.Xml.XPath.XPathNavigator" /> is successful moving to the first attribute of the current node; otherwise, false. If false, the position of the <see cref="T:System.Xml.XPath.XPathNavigator" /> is unchanged.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MoveToFirstChild">
@@ -2165,7 +2249,6 @@ nav.Evaluate(expr);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>True if the current node had the first child and moved successfully; Otherwise False.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -2175,6 +2258,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, moves the <see cref="T:System.Xml.XPath.XPathNavigator" /> to the first child node of the current node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the <see cref="T:System.Xml.XPath.XPathNavigator" /> is successful moving to the first child node of the current node; otherwise, false. If false, the position of the <see cref="T:System.Xml.XPath.XPathNavigator" /> is unchanged.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MoveToFirstNamespace">
@@ -2191,7 +2278,6 @@ nav.Evaluate(expr);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>True if the current node was an element and successfully moved to the first namespace node; Otherwise False.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Xml.XPath.XPathNavigator" /> class returns namespace nodes in reverse document order. Therefore, <see cref="M:System.Xml.XPath.XPathNavigator.MoveToFirstNamespace" /> essentially moves to the last namespace node in the current scope.</para>
@@ -2204,6 +2290,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves the <see cref="T:System.Xml.XPath.XPathNavigator" /> to first namespace node of the current node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the <see cref="T:System.Xml.XPath.XPathNavigator" /> is successful moving to the first namespace node; otherwise, false. If false, the position of the <see cref="T:System.Xml.XPath.XPathNavigator" /> is unchanged.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MoveToFirstNamespace">
@@ -2222,7 +2312,6 @@ nav.Evaluate(expr);</code>
         <Parameter Name="namespaceScope" Type="System.Xml.XPath.XPathNamespaceScope" />
       </Parameters>
       <Docs>
-        <returns>True if the current node the namespace nodes and moved to the first namespace node successfully; False if the current node is not an element.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Xml.XPath.XPathNavigator" /> class returns namespace nodes in reverse document order. Therefore, <see cref="M:System.Xml.XPath.XPathNavigator.MoveToFirstNamespace(System.Xml.XPath.XPathNamespaceScope)" /> essentially moves to the last namespace node in the current scope.</para>
@@ -2252,6 +2341,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, moves the <see cref="T:System.Xml.XPath.XPathNavigator" /> to the first namespace node that matches the <see cref="T:System.Xml.XPath.XPathNamespaceScope" /> specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the <see cref="T:System.Xml.XPath.XPathNavigator" /> is successful moving to the first namespace node; otherwise, false. If false, the position of the <see cref="T:System.Xml.XPath.XPathNavigator" /> is unchanged.</para>
+        </returns>
         <param name="namespaceScope">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XPath.XPathNamespaceScope" /> value describing the namespace scope. </param>
       </Docs>
@@ -2271,7 +2364,6 @@ nav.Evaluate(expr);</code>
         <Parameter Name="type" Type="System.Xml.XPath.XPathNodeType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2288,6 +2380,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves the <see cref="T:System.Xml.XPath.XPathNavigator" /> to the following element of the <see cref="T:System.Xml.XPath.XPathNodeType" /> specified in document order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Xml.XPath.XPathNavigator" /> moved successfully; otherwise false.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XPath.XPathNodeType" /> of the element. The <see cref="T:System.Xml.XPath.XPathNodeType" /> cannot be <see cref="F:System.Xml.XPath.XPathNodeType.Attribute" /> or <see cref="F:System.Xml.XPath.XPathNodeType.Namespace" />.</param>
       </Docs>
@@ -2308,7 +2404,6 @@ nav.Evaluate(expr);</code>
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2318,6 +2413,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves the <see cref="T:System.Xml.XPath.XPathNavigator" /> to the element with the local name and namespace URI specified in document order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Xml.XPath.XPathNavigator" /> moved successfully; otherwise false.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceURI">
@@ -2340,7 +2439,6 @@ nav.Evaluate(expr);</code>
         <Parameter Name="end" Type="System.Xml.XPath.XPathNavigator" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2366,6 +2464,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves the <see cref="T:System.Xml.XPath.XPathNavigator" /> to the following element of the <see cref="T:System.Xml.XPath.XPathNodeType" /> specified, to the boundary specified, in document order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Xml.XPath.XPathNavigator" /> moved successfully; otherwise false.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XPath.XPathNodeType" /> of the element. The <see cref="T:System.Xml.XPath.XPathNodeType" /> cannot be <see cref="F:System.Xml.XPath.XPathNodeType.Attribute" /> or <see cref="F:System.Xml.XPath.XPathNodeType.Namespace" />.</param>
         <param name="end">
@@ -2389,7 +2491,6 @@ nav.Evaluate(expr);</code>
         <Parameter Name="end" Type="System.Xml.XPath.XPathNavigator" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2412,6 +2513,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves the <see cref="T:System.Xml.XPath.XPathNavigator" /> to the element with the local name and namespace URI specified, to the boundary specified, in document order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Xml.XPath.XPathNavigator" /> moved successfully; otherwise false.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceURI">
@@ -2436,7 +2541,6 @@ nav.Evaluate(expr);</code>
         <Parameter Name="id" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>True if the current node was successfully moved; Otherwise False.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to identify nodes by unique ID provided the source document explicitly declares attributes of type ID using a DTD.</para>
@@ -2447,6 +2551,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, moves to the node that has an attribute of type ID whose value matches the specified <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Xml.XPath.XPathNavigator" /> is successful moving; otherwise, false. If false, the position of the navigator is unchanged.</para>
+        </returns>
         <param name="id">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> representing the ID value of the node to which you want to move.</param>
       </Docs>
@@ -2467,7 +2575,6 @@ nav.Evaluate(expr);</code>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>True if there was the specified namespace node and moved to the namespace node successfully; False if no such namespace node.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>After the <see cref="T:System.Xml.XPath.XPathNavigator" /> has been moved to the namespace node, the <see cref="P:System.Xml.XPath.XPathNavigator.Name" /> property reflects the name of the namespace.</para>
@@ -2479,6 +2586,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves the <see cref="T:System.Xml.XPath.XPathNavigator" /> to the namespace node with the specified namespace prefix.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Xml.XPath.XPathNavigator" /> is successful moving to the specified namespace; false if a matching namespace node was not found, or if the <see cref="T:System.Xml.XPath.XPathNavigator" /> is not positioned on an element node. If false, the position of the <see cref="T:System.Xml.XPath.XPathNavigator" /> is unchanged.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The namespace prefix of the namespace node.</param>
       </Docs>
@@ -2497,12 +2608,15 @@ nav.Evaluate(expr);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>True if the current node has the next sibling and moved successfully; False if it is the last node.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, moves the <see cref="T:System.Xml.XPath.XPathNavigator" /> to the next sibling node of the current node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Xml.XPath.XPathNavigator" /> is successful moving to the next sibling node; otherwise, false if there are no more siblings or if the <see cref="T:System.Xml.XPath.XPathNavigator" /> is currently positioned on an attribute node. If false, the position of the <see cref="T:System.Xml.XPath.XPathNavigator" /> is unchanged.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MoveToNext">
@@ -2520,7 +2634,6 @@ nav.Evaluate(expr);</code>
         <Parameter Name="type" Type="System.Xml.XPath.XPathNodeType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2595,6 +2708,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves the <see cref="T:System.Xml.XPath.XPathNavigator" /> to the next sibling node of the current node that matches the <see cref="T:System.Xml.XPath.XPathNodeType" /> specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Xml.XPath.XPathNavigator" /> is successful moving to the next sibling node; otherwise, false if there are no more siblings or if the <see cref="T:System.Xml.XPath.XPathNavigator" /> is currently positioned on an attribute node. If false, the position of the <see cref="T:System.Xml.XPath.XPathNavigator" /> is unchanged.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XPath.XPathNodeType" /> of the sibling node to move to.</param>
       </Docs>
@@ -2615,13 +2732,16 @@ nav.Evaluate(expr);</code>
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves the <see cref="T:System.Xml.XPath.XPathNavigator" /> to the next sibling node with the local name and namespace URI specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the <see cref="T:System.Xml.XPath.XPathNavigator" /> is successful moving to the next sibling node; false if there are no more siblings, or if the <see cref="T:System.Xml.XPath.XPathNavigator" /> is currently positioned on an attribute node. If false, the position of the <see cref="T:System.Xml.XPath.XPathNavigator" /> is unchanged.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the next sibling node to move to.</param>
         <param name="namespaceURI">
@@ -2642,7 +2762,6 @@ nav.Evaluate(expr);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>True if the current node was successfully moved to the next attribute; Otherwise False.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="T:System.Xml.XPath.XPathNavigator" /> is not currently positioned on an attribute, this method returns false and the position of the <see cref="T:System.Xml.XPath.XPathNavigator" /> does not change.</para>
@@ -2653,6 +2772,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, moves the <see cref="T:System.Xml.XPath.XPathNavigator" /> to the next attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the <see cref="T:System.Xml.XPath.XPathNavigator" /> is successful moving to the next attribute; false if there are no more attributes. If false, the position of the <see cref="T:System.Xml.XPath.XPathNavigator" /> is unchanged.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MoveToNextNamespace">
@@ -2669,7 +2792,6 @@ nav.Evaluate(expr);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>True if the current node was a namespace node and successfully moved to the next namespace node; Otherwise False.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Xml.XPath.XPathNavigator" /> class returns namespace nodes in reverse document order. Therefore, <see cref="M:System.Xml.XPath.XPathNavigator.MoveToNextNamespace" /> essentially moves to the namespace node above the one in the current scope.</para>
@@ -2682,6 +2804,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves the <see cref="T:System.Xml.XPath.XPathNavigator" /> to the next namespace node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the <see cref="T:System.Xml.XPath.XPathNavigator" /> is successful moving to the next namespace node; otherwise, false. If false, the position of the <see cref="T:System.Xml.XPath.XPathNavigator" /> is unchanged.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MoveToNextNamespace">
@@ -2700,7 +2826,6 @@ nav.Evaluate(expr);</code>
         <Parameter Name="namespaceScope" Type="System.Xml.XPath.XPathNamespaceScope" />
       </Parameters>
       <Docs>
-        <returns>True if the current node has the next namespace and moved successfully; False if it is the last namespace node or not positioned a namespace node.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Xml.XPath.XPathNavigator" /> class returns namespace nodes in reverse document order. </para>
@@ -2713,6 +2838,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, moves the <see cref="T:System.Xml.XPath.XPathNavigator" /> to the next namespace node matching the <see cref="T:System.Xml.XPath.XPathNamespaceScope" /> specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the <see cref="T:System.Xml.XPath.XPathNavigator" /> is successful moving to the next namespace node; otherwise, false. If false, the position of the <see cref="T:System.Xml.XPath.XPathNavigator" /> is unchanged.</para>
+        </returns>
         <param name="namespaceScope">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XPath.XPathNamespaceScope" /> value describing the namespace scope. </param>
       </Docs>
@@ -2731,7 +2860,6 @@ nav.Evaluate(expr);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>True if the current node had parent node and moved successfully; Otherwise False.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value of the <see cref="M:System.Xml.XPath.XPathNavigator.MoveToParent" /> method depends on the <see cref="T:System.Xml.XPath.XPathNodeType" /> of the current node, and the <see cref="T:System.Xml.XPath.XPathNodeType" /> of the parent node to move to. </para>
@@ -2852,6 +2980,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, moves the <see cref="T:System.Xml.XPath.XPathNavigator" /> to the parent node of the current node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the <see cref="T:System.Xml.XPath.XPathNavigator" /> is successful moving to the parent node of the current node; otherwise, false. If false, the position of the <see cref="T:System.Xml.XPath.XPathNavigator" /> is unchanged.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MoveToPrevious">
@@ -2868,12 +3000,15 @@ nav.Evaluate(expr);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>True if the current node has the previous sibling and moved successfully; False if it is the first node.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, moves the <see cref="T:System.Xml.XPath.XPathNavigator" /> to the previous sibling node of the current node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the <see cref="T:System.Xml.XPath.XPathNavigator" /> is successful moving to the previous sibling node; otherwise, false if there is no previous sibling node or if the <see cref="T:System.Xml.XPath.XPathNavigator" /> is currently positioned on an attribute node. If false, the position of the <see cref="T:System.Xml.XPath.XPathNavigator" /> is unchanged.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MoveToRoot">
@@ -3145,7 +3280,6 @@ nav.Evaluate(expr);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3167,6 +3301,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Xml.XmlWriter" /> object used to create a new child node at the beginning of the list of child nodes of the current node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlWriter" /> object used to create a new child node at the beginning of the list of child nodes of the current node.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="PrependChild">
@@ -3352,7 +3490,6 @@ nav.Evaluate(expr);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3371,6 +3508,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Xml.XmlReader" /> object that contains the current node and its child nodes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlReader" /> object that contains the current node and its child nodes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReplaceRange">
@@ -3388,7 +3529,6 @@ nav.Evaluate(expr);</code>
         <Parameter Name="lastSiblingToReplace" Type="System.Xml.XPath.XPathNavigator" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3401,6 +3541,10 @@ nav.Evaluate(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Replaces a range of sibling nodes from the current node to the node specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlWriter" /> object used to specify the replacement range.</para>
+        </returns>
         <param name="lastSiblingToReplace">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XPath.XPathNavigator" /> positioned on the last sibling node in the range to replace.</param>
       </Docs>
@@ -3571,7 +3715,6 @@ nav.Evaluate(expr);</code>
         <Parameter Name="xpath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>An <see cref="System.Xml.XPath.XPathNodeIterator" /> instance that holds all the results.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The context for the selection is the position of the <see cref="T:System.Xml.XPath.XPathNavigator" /> when this method is called. After calling this method, the <see cref="T:System.Xml.XPath.XPathNodeIterator" /> returned represents the set of selected nodes. Use <see cref="M:System.Xml.XPath.XPathNodeIterator.MoveNext" /> method of the <see cref="T:System.Xml.XPath.XPathNodeIterator" /> to iterate over the selected node set.</para>
@@ -3601,6 +3744,10 @@ while (iterator.MoveNext())
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Selects a node set, using the specified XPath expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XPath.XPathNodeIterator" /> pointing to the selected node set.</para>
+        </returns>
         <param name="xpath">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> representing an XPath expression.</param>
       </Docs>
@@ -3621,7 +3768,6 @@ while (iterator.MoveNext())
         <Parameter Name="expr" Type="System.Xml.XPath.XPathExpression" />
       </Parameters>
       <Docs>
-        <returns>An <see cref="System.Xml.XPath.XPathNodeIterator" /> instance that holds all the results.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The context for the selection is the position of the <see cref="T:System.Xml.XPath.XPathNavigator" /> when you called this method. After you call this method, the <see cref="T:System.Xml.XPath.XPathNodeIterator" /> returned represents the set of selected nodes. Use <see cref="M:System.Xml.XPath.XPathNodeIterator.MoveNext" /> on the <see cref="T:System.Xml.XPath.XPathNodeIterator" /> to iterate over the selected node set.</para>
@@ -3677,6 +3823,10 @@ XPathNodeIterator ni = nav.Select(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Selects a node set using the specified <see cref="T:System.Xml.XPath.XPathExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XPath.XPathNodeIterator" /> that points to the selected node set.</para>
+        </returns>
         <param name="expr">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XPath.XPathExpression" /> object containing the compiled XPath query.</param>
       </Docs>
@@ -3697,13 +3847,16 @@ XPathNodeIterator ni = nav.Select(expr);</code>
         <Parameter Name="resolver" Type="System.Xml.IXmlNamespaceResolver" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Selects a node set using the specified XPath expression with the <see cref="T:System.Xml.IXmlNamespaceResolver" /> object specified to resolve namespace prefixes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XPath.XPathNodeIterator" /> that points to the selected node set.</para>
+        </returns>
         <param name="xpath">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> representing an XPath expression.</param>
         <param name="resolver">
@@ -3727,7 +3880,6 @@ XPathNodeIterator ni = nav.Select(expr);</code>
         <Parameter Name="matchSelf" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>The <see cref="T:System.Xml.XPath.XPathNodeIterator" /> instance that holds all the resulting nodes.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Xml.XPath.XPathNavigator.SelectAncestors(System.Xml.XPath.XPathNodeType,System.Boolean)" /> method has no effect on the state of the <see cref="T:System.Xml.XPath.XPathNavigator" />.</para>
@@ -3736,6 +3888,10 @@ XPathNodeIterator ni = nav.Select(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Selects all the ancestor nodes of the current node that have a matching <see cref="T:System.Xml.XPath.XPathNodeType" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XPath.XPathNodeIterator" /> that contains the selected nodes. The returned nodes are in reverse document order.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XPath.XPathNodeType" /> of the ancestor nodes.</param>
         <param name="matchSelf">
@@ -3760,7 +3916,6 @@ XPathNodeIterator ni = nav.Select(expr);</code>
         <Parameter Name="matchSelf" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>The <see cref="T:System.Xml.XPath.XPathNodeIterator" /> instance that holds all the resulting nodes.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <see cref="F:System.String.Empty" /> is specified as the <paramref name="name" /> parameter, all ancestor nodes that belong to the specified namespace URI are selected. If <see cref="F:System.String.Empty" /> is specified as the <paramref name="namespaceURI" /> parameter, all ancestor nodes with the specified local name that belong to no namespace are selected. If <see cref="F:System.String.Empty" /> is specified as both the local name and namespace URI, all ancestor nodes that belong to no namespace are selected.</para>
@@ -3770,6 +3925,10 @@ XPathNodeIterator ni = nav.Select(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Selects all the ancestor nodes of the current node that have the specified local name and namespace URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XPath.XPathNodeIterator" /> that contains the selected nodes. The returned nodes are in reverse document order.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the ancestor nodes.</param>
         <param name="namespaceURI">
@@ -3794,7 +3953,6 @@ XPathNodeIterator ni = nav.Select(expr);</code>
         <Parameter Name="type" Type="System.Xml.XPath.XPathNodeType" />
       </Parameters>
       <Docs>
-        <returns>The <see cref="T:System.Xml.XPath.XPathNodeIterator" /> instance that holds all the resulting nodes.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Xml.XPath.XPathNavigator.SelectChildren(System.Xml.XPath.XPathNodeType)" /> method has no effect on the state of the <see cref="T:System.Xml.XPath.XPathNavigator" />.</para>
@@ -3803,6 +3961,10 @@ XPathNodeIterator ni = nav.Select(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Selects all the child nodes of the current node that have the matching <see cref="T:System.Xml.XPath.XPathNodeType" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XPath.XPathNodeIterator" /> that contains the selected nodes.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XPath.XPathNodeType" /> of the child nodes.</param>
       </Docs>
@@ -3824,7 +3986,6 @@ XPathNodeIterator ni = nav.Select(expr);</code>
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>The <see cref="T:System.Xml.XPath.XPathNodeIterator" /> instance that holds all the resulting nodes.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <see cref="F:System.String.Empty" /> is specified as the <paramref name="name" /> parameter, all child nodes that belong to the specified namespace URI are selected. If <see cref="F:System.String.Empty" /> is specified as the <paramref name="namespaceURI" /> parameter, all child nodes with the specified local name that belong to no namespace are selected. If both the local name and namespace URI parameters are <see cref="F:System.String.Empty" />, all child nodes that belong to no namespace are selected.</para>
@@ -3834,6 +3995,10 @@ XPathNodeIterator ni = nav.Select(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Selects all the child nodes of the current node that have the local name and namespace URI specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XPath.XPathNodeIterator" /> that contains the selected nodes.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the child nodes. </param>
         <param name="namespaceURI">
@@ -3857,7 +4022,6 @@ XPathNodeIterator ni = nav.Select(expr);</code>
         <Parameter Name="matchSelf" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>The <see cref="T:System.Xml.XPath.XPathNodeIterator" /> instance that holds all the resulting nodes.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Xml.XPath.XPathNavigator.SelectDescendants(System.Xml.XPath.XPathNodeType,System.Boolean)" /> method has no effect on the state of the <see cref="T:System.Xml.XPath.XPathNavigator" />.</para>
@@ -3866,6 +4030,10 @@ XPathNodeIterator ni = nav.Select(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Selects all the descendant nodes of the current node that have a matching <see cref="T:System.Xml.XPath.XPathNodeType" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XPath.XPathNodeIterator" /> that contains the selected nodes.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XPath.XPathNodeType" /> of the descendant nodes.</param>
         <param name="matchSelf">
@@ -3890,7 +4058,6 @@ XPathNodeIterator ni = nav.Select(expr);</code>
         <Parameter Name="matchSelf" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>The <see cref="T:System.Xml.XPath.XPathNodeIterator" /> instance that holds all the resulting nodes.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <see cref="F:System.String.Empty" /> is specified as the <paramref name="name" /> parameter, all descendant nodes that belong to the specified namespace URI are selected. If <see cref="F:System.String.Empty" /> is specified as the <paramref name="namespaceURI" /> parameter, all descendant nodes with the specified local name that belong to no namespace are selected. If both the local name and namespace URI parameters are <see cref="F:System.String.Empty" />, all descendant nodes that belong to no namespace are selected.</para>
@@ -3901,6 +4068,10 @@ XPathNodeIterator ni = nav.Select(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Selects all the descendant nodes of the current node with the local name and namespace URI specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XPath.XPathNodeIterator" /> that contains the selected nodes.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the descendant nodes. </param>
         <param name="namespaceURI">
@@ -3924,7 +4095,6 @@ XPathNodeIterator ni = nav.Select(expr);</code>
         <Parameter Name="xpath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3934,6 +4104,10 @@ XPathNodeIterator ni = nav.Select(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Selects a single node in the <see cref="T:System.Xml.XPath.XPathNavigator" /> using the specified XPath query.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XPath.XPathNavigator" /> object that contains the first matching node for the XPath query specified; otherwise, null if there are no query results.</para>
+        </returns>
         <param name="xpath">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> representing an XPath expression.</param>
       </Docs>
@@ -3953,7 +4127,6 @@ XPathNodeIterator ni = nav.Select(expr);</code>
         <Parameter Name="expression" Type="System.Xml.XPath.XPathExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3963,6 +4136,10 @@ XPathNodeIterator ni = nav.Select(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Selects a single node in the <see cref="T:System.Xml.XPath.XPathNavigator" /> using the specified <see cref="T:System.Xml.XPath.XPathExpression" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XPath.XPathNavigator" /> object that contains the first matching node for the XPath query specified; otherwise null if there are no query results.</para>
+        </returns>
         <param name="expression">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XPath.XPathExpression" /> object containing the compiled XPath query.</param>
       </Docs>
@@ -3983,7 +4160,6 @@ XPathNodeIterator ni = nav.Select(expr);</code>
         <Parameter Name="resolver" Type="System.Xml.IXmlNamespaceResolver" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3996,6 +4172,10 @@ XPathNodeIterator ni = nav.Select(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Selects a single node in the <see cref="T:System.Xml.XPath.XPathNavigator" /> object using the specified XPath query with the <see cref="T:System.Xml.IXmlNamespaceResolver" /> object specified to resolve namespace prefixes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XPath.XPathNavigator" /> object that contains the first matching node for the XPath query specified; otherwise null if there are no query results.</para>
+        </returns>
         <param name="xpath">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> representing an XPath expression.</param>
         <param name="resolver">
@@ -4080,7 +4260,6 @@ XPathNodeIterator ni = nav.Select(expr);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Xml.XPath.XPathNavigator" /> instance is cast to an <see cref="T:System.ICloneable" /> interface.</para>
@@ -4090,6 +4269,10 @@ XPathNodeIterator ni = nav.Select(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new copy of the <see cref="T:System.Xml.XPath.XPathNavigator" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new copy of the <see cref="T:System.Xml.XPath.XPathNavigator" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -4106,7 +4289,6 @@ XPathNodeIterator ni = nav.Select(expr);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>A string that represents the node value.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The content returned by the <see cref="M:System.Xml.XPath.XPathNavigator.ToString" /> method depends on the <see cref="T:System.Xml.XPath.XPathNodeType" /> of the node.</para>
@@ -4207,6 +4389,10 @@ XPathNodeIterator ni = nav.Select(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the text value of the current node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the text value of the current node.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TypedValue">
@@ -4420,7 +4606,6 @@ XPathNodeIterator ni = nav.Select(expr);</code>
         <Parameter Name="nsResolver" Type="System.Xml.IXmlNamespaceResolver" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4431,6 +4616,10 @@ XPathNodeIterator ni = nav.Select(expr);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the current node's value as the <see cref="T:System.Type" /> specified, using the <see cref="T:System.Xml.IXmlNamespaceResolver" /> object specified to resolve namespace prefixes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current node as the <see cref="T:System.Type" /> requested.</para>
+        </returns>
         <param name="returnType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> to return the current node's value as.</param>
         <param name="nsResolver">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.XPath/XPathNodeIterator.xml b/mcs/class/System.XML/Documentation/en/System.Xml.XPath/XPathNodeIterator.xml
index 2d7988f6ad1..491dcb2490c 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.XPath/XPathNodeIterator.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.XPath/XPathNodeIterator.xml
@@ -75,7 +75,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>Returns a new XPathNodeIterator copy of this instance.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The cloned <see cref="T:System.Xml.XPath.XPathNodeIterator" /> object is positioned at the same node in the node set if calls have been made to the <see cref="M:System.Xml.XPath.XPathNodeIterator.MoveNext" /> method. The cloned <see cref="T:System.Xml.XPath.XPathNodeIterator" /> object is not affected by subsequent changes to this <see cref="T:System.Xml.XPath.XPathNodeIterator" /> object.</para>
@@ -84,6 +83,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns a clone of this <see cref="T:System.Xml.XPath.XPathNodeIterator" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Xml.XPath.XPathNodeIterator" /> object clone of this <see cref="T:System.Xml.XPath.XPathNodeIterator" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Count">
@@ -174,7 +177,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -190,6 +192,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IEnumerator" /> object to iterate through the selected node set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> object to iterate through the selected node set.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MoveNext">
@@ -206,7 +212,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>True if it could iterate to the next node; False if it didn't have more nodes to be iterated.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Xml.XPath.XPathNodeIterator" /> object is positioned on the first node in the selected node set only after the initial call to the <see cref="M:System.Xml.XPath.XPathNodeIterator.MoveNext" /> method. The node set is created in document order. Therefore, calling the <see cref="M:System.Xml.XPath.XPathNodeIterator.MoveNext" /> method moves to the next node in document order.</para>
@@ -221,6 +226,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, moves the <see cref="T:System.Xml.XPath.XPathNavigator" /> object returned by the <see cref="P:System.Xml.XPath.XPathNodeIterator.Current" /> property to the next node in the selected node set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Xml.XPath.XPathNavigator" /> object moved to the next node; false if there are no more selected nodes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ICloneable.Clone">
@@ -237,7 +246,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Xml.XPath.XPathNodeIterator" /> instance is cast to an <see cref="T:System.ICloneable" /> interface.</para>
@@ -246,6 +254,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new object that is a copy of the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new object that is a copy of this instance.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Xsl/IXsltContextFunction.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Xsl/IXsltContextFunction.xml
index b2082fe0399..04f88ef8f3d 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Xsl/IXsltContextFunction.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Xsl/IXsltContextFunction.xml
@@ -61,7 +61,6 @@
         <Parameter Name="docContext" Type="System.Xml.XPath.XPathNavigator" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="docContext" /> parameter is required so that functions which require a node set can be supplied the current context node.</para>
@@ -70,6 +69,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides the method to invoke the function with the given arguments in the given context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> representing the return value of the function.</para>
+        </returns>
         <param name="xsltContext">
           <attribution license="cc4" from="Microsoft" modified="false" />The XSLT context for the function call. </param>
         <param name="args">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Xsl/IXsltContextVariable.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Xsl/IXsltContextVariable.xml
index de9885e800b..2f3fb9dd806 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Xsl/IXsltContextVariable.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Xsl/IXsltContextVariable.xml
@@ -38,12 +38,15 @@
         <Parameter Name="xsltContext" Type="System.Xml.Xsl.XsltContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates the variable at runtime and returns an object that represents the value of the variable.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> representing the value of the variable. Possible return types include number, string, Boolean, document fragment, or node set.</para>
+        </returns>
         <param name="xsltContext">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.Xsl.XsltContext" /> representing the execution context of the variable. </param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Xsl/XslTransform.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Xsl/XslTransform.xml
index 7392612c877..43ec84e9cfe 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Xsl/XslTransform.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Xsl/XslTransform.xml
@@ -872,7 +872,6 @@ xslt.Load(xslNav,resolver,evidence);</code>
         <Parameter Name="args" Type="System.Xml.Xsl.XsltArgumentList" />
       </Parameters>
       <Docs>
-        <returns>A <see cref="T:System.Xml.XmlReader" /> that holds the transformation output.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -923,6 +922,10 @@ xslt.Load(xslNav,resolver,evidence);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Transforms the XML data in the <see cref="T:System.Xml.XPath.IXPathNavigable" /> using the specified <paramref name="args" /> and outputs the result to an <see cref="T:System.Xml.XmlReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlReader" /> containing the results of the transformation.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />An object implementing the <see cref="T:System.Xml.XPath.IXPathNavigable" /> interface. In the .NET Framework, this can be either an <see cref="T:System.Xml.XmlNode" /> (typically an <see cref="T:System.Xml.XmlDocument" />), or an <see cref="T:System.Xml.XPath.XPathDocument" /> containing the data to be transformed. </param>
         <param name="args">
@@ -946,7 +949,6 @@ xslt.Load(xslNav,resolver,evidence);</code>
         <Parameter Name="args" Type="System.Xml.Xsl.XsltArgumentList" />
       </Parameters>
       <Docs>
-        <returns>A <see cref="T:System.Xml.XmlReader" /> instance that holds the transformation result.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -965,6 +967,10 @@ xslt.Load(xslNav,resolver,evidence);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Transforms the XML data in the <see cref="T:System.Xml.XPath.XPathNavigator" /> using the specified <paramref name="args" /> and outputs the result to an <see cref="T:System.Xml.XmlReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlReader" /> containing the results of the transformation.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XPath.XPathNavigator" /> containing the data to be transformed. </param>
         <param name="args">
@@ -1178,7 +1184,6 @@ xslt.Load(xslNav,resolver,evidence);</code>
         <Parameter Name="resolver" Type="System.Xml.XmlResolver" />
       </Parameters>
       <Docs>
-        <returns>A <see cref="T:System.Xml.XmlReader" /> instance that holds the transformation result.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1226,6 +1231,10 @@ xslt.Load(xslNav,resolver,evidence);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Transforms the XML data in the <see cref="T:System.Xml.XPath.IXPathNavigable" /> using the specified <paramref name="args" /> and outputs the result to an <see cref="T:System.Xml.XmlReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlReader" /> containing the results of the transformation.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />An object implementing the <see cref="T:System.Xml.XPath.IXPathNavigable" /> interface. In the .NET Framework, this can be either an <see cref="T:System.Xml.XmlNode" /> (typically an <see cref="T:System.Xml.XmlDocument" />), or an <see cref="T:System.Xml.XPath.XPathDocument" /> containing the data to be transformed. </param>
         <param name="args">
@@ -1413,7 +1422,6 @@ xslt.Load(xslNav,resolver,evidence);</code>
         <Parameter Name="resolver" Type="System.Xml.XmlResolver" />
       </Parameters>
       <Docs>
-        <returns>A <see cref="T:System.Xml.XmlReader" /> instance that holds the transformation result.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1429,6 +1437,10 @@ xslt.Load(xslNav,resolver,evidence);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Transforms the XML data in the <see cref="T:System.Xml.XPath.XPathNavigator" /> using the specified <paramref name="args" /> and outputs the result to an <see cref="T:System.Xml.XmlReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlReader" /> containing the results of the transformation.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XPath.XPathNavigator" /> containing the data to be transformed. </param>
         <param name="args">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Xsl/XsltArgumentList.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Xsl/XsltArgumentList.xml
index 497c844516a..9430d6dfb49 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Xsl/XsltArgumentList.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Xsl/XsltArgumentList.xml
@@ -248,12 +248,15 @@
         <Parameter Name="namespaceUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>The object associated with the namespace, or <see langword="null" /> if no extension object was associated with the namespace.</returns>
         <remarks>None.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the object associated with the given namespace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The namespace URI object or null if one was not found.</para>
+        </returns>
         <param name="namespaceUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The namespace URI of the object. </param>
       </Docs>
@@ -275,12 +278,15 @@
         <Parameter Name="namespaceUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>The value associated with the parameter, or <see langword="null" /> if no value is associated with the parameter.</returns>
         <remarks>None.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the parameter associated with the namespace qualified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The parameter object or null if one was not found.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the parameter. <see cref="T:System.Xml.Xsl.XsltArgumentList" /> does not check to ensure the name passed is a valid local name; however, the name cannot be null. </param>
         <param name="namespaceUri">
@@ -303,12 +309,15 @@
         <Parameter Name="namespaceUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>The object formerly associated with the namespace, or <see langword="null" /> if no extension object was associated with the namespace.</returns>
         <remarks>None.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the object with the namespace URI from the <see cref="T:System.Xml.Xsl.XsltArgumentList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object with the namespace URI or null if one was not found.</para>
+        </returns>
         <param name="namespaceUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The namespace URI associated with the object to remove. </param>
       </Docs>
@@ -330,12 +339,15 @@
         <Parameter Name="namespaceUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>The value formerly associated with the parameter, or <see langword="null" /> if no value was associated with the parameter.</returns>
         <remarks>None.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the parameter from the <see cref="T:System.Xml.Xsl.XsltArgumentList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The parameter object or null if one was not found.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the parameter to remove. <see cref="T:System.Xml.Xsl.XsltArgumentList" /> does not check to ensure the name passed is a valid local name; however, the name cannot be null. </param>
         <param name="namespaceUri">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml.Xsl/XsltContext.xml b/mcs/class/System.XML/Documentation/en/System.Xml.Xsl/XsltContext.xml
index f0dc08eb90f..4a6252629a2 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml.Xsl/XsltContext.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml.Xsl/XsltContext.xml
@@ -85,7 +85,6 @@
         <Parameter Name="nextbaseUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>If they are equal, then 0; otherwise, compare two URI strings as string.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method supports the XSLT document() function which specifies that nodes selected across multiple documents are always returned in the same order. </para>
@@ -97,6 +96,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, compares the base Uniform Resource Identifiers (URIs) of two documents based upon the order the documents were loaded by the XSLT processor (that is, the <see cref="T:System.Xml.Xsl.XslTransform" /> class).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer value describing the relative order of the two base URIs: -1 if <paramref name="baseUri" /> occurs before <paramref name="nextbaseUri" />; 0 if the two base URIs are identical; and 1 if <paramref name="baseUri" /> occurs after <paramref name="nextbaseUri" />.</para>
+        </returns>
         <param name="baseUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The base URI of the first document to compare. </param>
         <param name="nextbaseUri">
@@ -119,12 +122,15 @@
         <Parameter Name="node" Type="System.Xml.XPath.XPathNavigator" />
       </Parameters>
       <Docs>
-        <returns>True if whitespaces should be preserved; otherwise False.</returns>
         <remarks>The return value comes from the nearest ancestor's preserve-whitespace or strip-whitespace attribute value.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, evaluates whether to preserve white space nodes or strip them for the given context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the white space is to be preserved or false if the white space is to be stripped.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The white space node that is to be preserved or stripped in the current context. </param>
       </Docs>
@@ -147,12 +153,15 @@
         <Parameter Name="ArgTypes" Type="System.Xml.XPath.XPathResultType[]" />
       </Parameters>
       <Docs>
-        <returns>An instance of <see cref="T:System.Xml.Xsl.IXsltContextFunction" /> that represents the matching function, or null if no proper function was found.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, resolves a function reference and returns an <see cref="T:System.Xml.Xsl.IXsltContextFunction" /> representing the function. The <see cref="T:System.Xml.Xsl.IXsltContextFunction" /> is used at execution time to get the return value of the function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Xsl.IXsltContextFunction" /> representing the function.</para>
+        </returns>
         <param name="prefix">
           <attribution license="cc4" from="Microsoft" modified="false" />The prefix of the function as it appears in the XPath expression. </param>
         <param name="name">
@@ -178,7 +187,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>An instance of <see cref="T:System.Xml.Xsl.IXsltContextVariable" /> that represents the matching variable, or null if no proper variable was found.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Xml.Xsl.IXsltContextVariable" /> is used at execution time to get the value of the variable.</para>
@@ -187,6 +195,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, resolves a variable reference and returns an <see cref="T:System.Xml.Xsl.IXsltContextVariable" /> representing the variable.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Xsl.IXsltContextVariable" /> representing the variable at runtime.</para>
+        </returns>
         <param name="prefix">
           <attribution license="cc4" from="Microsoft" modified="false" />The prefix of the variable as it appears in the XPath expression. </param>
         <param name="name">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/IHasXmlNode.xml b/mcs/class/System.XML/Documentation/en/System.Xml/IHasXmlNode.xml
index bbd031ad590..3d1147c2bec 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/IHasXmlNode.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/IHasXmlNode.xml
@@ -36,7 +36,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'XmlNode'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following C# code uses GetNode to access a node the <see cref="T:System.Xml.XPath.XPathNavigator" /> is currently positioned on.</para>
@@ -51,6 +50,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Xml.XmlNode" /> for the current position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XmlNode for the current position.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/IXmlLineInfo.xml b/mcs/class/System.XML/Documentation/en/System.Xml/IXmlLineInfo.xml
index 0f44d6b55b8..e778b9487ae 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/IXmlLineInfo.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/IXmlLineInfo.xml
@@ -33,12 +33,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the class can return line information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <see cref="P:System.Xml.IXmlLineInfo.LineNumber" /> and <see cref="P:System.Xml.IXmlLineInfo.LinePosition" /> can be provided; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="LineNumber">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/IXmlNamespaceResolver.xml b/mcs/class/System.XML/Documentation/en/System.Xml/IXmlNamespaceResolver.xml
index 027706a5836..2d956bc6751 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/IXmlNamespaceResolver.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/IXmlNamespaceResolver.xml
@@ -32,7 +32,6 @@
         <Parameter Name="scope" Type="System.Xml.XmlNamespaceScope" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -109,6 +108,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of defined prefix-namespace mappings that are currently in scope.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IDictionary" /> that contains the current in-scope namespaces.</para>
+        </returns>
         <param name="scope">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlNamespaceScope" /> value that specifies the type of namespace nodes to return.</param>
       </Docs>
@@ -128,7 +131,6 @@
         <Parameter Name="prefix" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -185,6 +187,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the namespace URI mapped to the specified prefix.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The namespace URI that is mapped to the prefix; null if the prefix is not mapped to a namespace URI.</para>
+        </returns>
         <param name="prefix">
           <attribution license="cc4" from="Microsoft" modified="false" />The prefix whose namespace URI you wish to find.</param>
       </Docs>
@@ -204,7 +210,6 @@
         <Parameter Name="namespaceName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -254,6 +259,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the prefix that is mapped to the specified namespace URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The prefix that is mapped to the namespace URI; null if the namespace URI is not mapped to a prefix.</para>
+        </returns>
         <param name="namespaceName">
           <attribution license="cc4" from="Microsoft" modified="false" />The namespace URI whose prefix you wish to find.</param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/NameTable.xml b/mcs/class/System.XML/Documentation/en/System.Xml/NameTable.xml
index 054098f5609..69f13cf3bee 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/NameTable.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/NameTable.xml
@@ -111,12 +111,6 @@ class Ntable {
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="key" />, if it did not exist in the 
-   table at the time of the call, or the <see cref="T:System.String" /> instance previously stored in the table with a value equal to
-<paramref name="key" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="key" /> is <see langword="null" />.</exception>
         <remarks>
@@ -127,6 +121,10 @@ class Ntable {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Atomizes the specified string and adds it to the NameTable.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The atomized string or the existing string if it already exists in the NameTable.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to add. </param>
       </Docs>
@@ -151,13 +149,6 @@ class Ntable {
         <Parameter Name="len" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.String" qualify="true" /> equivalent of the 
-   specified subset of the <see cref="T:System.Char" qualify="true" /> array that is stored in the
-   table, or <see cref="F:System.String.Empty" qualify="true" />
-   if <paramref name="len" /> is
-   zero.</para>
-        </returns>
         <exception cref="T:System.IndexOutOfRangeException">
           <para>
             <paramref name="start" /> &lt; 0.</para>
@@ -178,6 +169,10 @@ class Ntable {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Atomizes the specified string and adds it to the NameTable.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The atomized string or the existing string if one already exists in the NameTable. If <paramref name="len" /> is zero, String.Empty is returned.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The character array containing the string to add. </param>
         <param name="start">
@@ -204,12 +199,6 @@ class Ntable {
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.String" /> instance previously stored in the table with a value 
-   equal to <paramref name="value" /> , or
-<see langword="null" /> if 
-   it does not exist.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is <see langword="null" />.</exception>
         <remarks>
@@ -220,6 +209,10 @@ class Ntable {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the atomized string with the specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The atomized string object or null if the string has not already been atomized.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The name to find. </param>
       </Docs>
@@ -244,12 +237,6 @@ class Ntable {
         <Parameter Name="len" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.String" qualify="true" /> equivalent of the specified subset of the <see cref="T:System.Char" qualify="true" /> array that is 
-   stored in the table, or <see langword="null" /> if the
-   equivalent <see cref="T:System.String" /> is not
-   in the table.</para>
-        </returns>
         <exception cref="T:System.IndexOutOfRangeException">
           <para>
             <paramref name="start" />
@@ -272,6 +259,10 @@ class Ntable {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the atomized string containing the same characters as the specified range of characters in the given array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The atomized string or null if the string has not already been atomized. If <paramref name="len" /> is zero, String.Empty is returned.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The character array containing the name to find. </param>
         <param name="start">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlAttribute.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlAttribute.xml
index 228746affce..8f7cc40e60d 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlAttribute.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlAttribute.xml
@@ -79,7 +79,6 @@
         <Parameter Name="newChild" Type="System.Xml.XmlNode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -90,6 +89,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified node to the end of the list of child nodes, of this node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.XmlNode" /> added.</para>
+        </returns>
         <param name="newChild">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlNode" /> to add.</param>
       </Docs>
@@ -136,7 +139,6 @@
         <Parameter Name="deep" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method serves as a copy constructor for nodes. The cloned node has no parent (<see cref="P:System.Xml.XmlAttribute.ParentNode" /> returns null).</para>
@@ -146,6 +148,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplicate of this node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The duplicate node.</para>
+        </returns>
         <param name="deep">
           <attribution license="cc4" from="Microsoft" modified="false" />true to recursively clone the subtree under the specified node; false to clone only the node itself </param>
       </Docs>
@@ -215,7 +221,6 @@
         <Parameter Name="refChild" Type="System.Xml.XmlNode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -227,6 +232,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts the specified node immediately after the specified reference node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.XmlNode" /> inserted.</para>
+        </returns>
         <param name="newChild">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlNode" /> to insert.</param>
         <param name="refChild">
@@ -249,7 +258,6 @@
         <Parameter Name="refChild" Type="System.Xml.XmlNode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -260,6 +268,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts the specified node immediately before the specified reference node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.XmlNode" /> inserted.</para>
+        </returns>
         <param name="newChild">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlNode" /> to insert.</param>
         <param name="refChild">
@@ -461,7 +473,6 @@
         <Parameter Name="newChild" Type="System.Xml.XmlNode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -473,6 +484,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified node to the beginning of the list of child nodes for this node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.XmlNode" /> added.</para>
+        </returns>
         <param name="newChild">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlNode" /> to add. If it is an <see cref="T:System.Xml.XmlDocumentFragment" />, the entire contents of the document fragment are moved into the child list of this node.</param>
       </Docs>
@@ -492,13 +507,16 @@
         <Parameter Name="oldChild" Type="System.Xml.XmlNode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the specified child node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.XmlNode" /> removed.</para>
+        </returns>
         <param name="oldChild">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlNode" /> to remove.</param>
       </Docs>
@@ -519,7 +537,6 @@
         <Parameter Name="oldChild" Type="System.Xml.XmlNode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -530,6 +547,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Replaces the child node specified with the new child node specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.XmlNode" /> replaced.</para>
+        </returns>
         <param name="newChild">
           <attribution license="cc4" from="Microsoft" modified="false" />The new child <see cref="T:System.Xml.XmlNode" />.</param>
         <param name="oldChild">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlAttributeCollection.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlAttributeCollection.xml
index 7d1dac4b50c..b30327307cd 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlAttributeCollection.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlAttributeCollection.xml
@@ -45,7 +45,6 @@
         <Parameter Name="node" Type="System.Xml.XmlAttribute" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlAttribute'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If an attribute with the same name is already present in the collection, the original attribute is removed from the collection and <paramref name="node" /> is added to the end of the collection.</para>
@@ -55,6 +54,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts the specified attribute as the last node in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XmlAttribute to append to the collection.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlAttribute" /> to insert. </param>
       </Docs>
@@ -107,7 +110,6 @@
         <Parameter Name="refNode" Type="System.Xml.XmlAttribute" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlAttribute'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If an attribute with the same name is already present in the collection, the original attribute is removed from the collection and <paramref name="newNode" /> is inserted into the collection. If <paramref name="refNode" /> is null, <paramref name="newNode" /> is inserted at the beginning of the collection.</para>
@@ -117,6 +119,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts the specified attribute immediately after the specified reference attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XmlAttribute to insert into the collection.</para>
+        </returns>
         <param name="newNode">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlAttribute" /> to insert. </param>
         <param name="refNode">
@@ -140,7 +146,6 @@
         <Parameter Name="refNode" Type="System.Xml.XmlAttribute" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlAttribute'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If an attribute with the same name is already present in the collection, the original attribute is removed from the collection and <paramref name="newNode" /> is inserted into the collection. If <paramref name="refNode" /> is null, <paramref name="newNode" /> is inserted at the end of the collection.</para>
@@ -150,6 +155,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts the specified attribute immediately before the specified reference attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XmlAttribute to insert into the collection.</para>
+        </returns>
         <param name="newNode">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlAttribute" /> to insert. </param>
         <param name="refNode">
@@ -240,7 +249,6 @@
         <Parameter Name="node" Type="System.Xml.XmlAttribute" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlAttribute'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If an attribute with the same name is already present in the collection, the original attribute is removed from the collection and <paramref name="node" /> is added to the beginning of the collection.</para>
@@ -250,6 +258,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts the specified attribute as the first node in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XmlAttribute added to the collection.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlAttribute" /> to insert. </param>
       </Docs>
@@ -270,7 +282,6 @@
         <Parameter Name="node" Type="System.Xml.XmlAttribute" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlAttribute'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is a Microsoft extension to the Document Object Model (DOM).</para>
@@ -279,6 +290,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the specified attribute from the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node removed or null if it is not found in the collection.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlAttribute" /> to remove. </param>
       </Docs>
@@ -323,7 +338,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlAttribute'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is a Microsoft extension to the Document Object Model (DOM).</para>
@@ -332,6 +346,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the attribute corresponding to the specified index from the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns null if there is no attribute at the specified index.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the node to remove. The first node has index 0. </param>
       </Docs>
@@ -352,12 +370,15 @@
         <Parameter Name="node" Type="System.Xml.XmlNode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Xml.XmlNode" /> using its <see cref="P:System.Xml.XmlNode.Name" /> property </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If the <paramref name="node" /> replaces an existing node with the same name, the old node is returned; otherwise, the added node is returned.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />An attribute node to store in this collection. The node will later be accessible using the name of the node. If a node with that name is already present in the collection, it is replaced by the new one; otherwise, the node is appended to the end of the collection. </param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlCDataSection.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlCDataSection.xml
index 03f706c9e47..52de7022ee9 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlCDataSection.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlCDataSection.xml
@@ -69,7 +69,6 @@
         <Parameter Name="deep" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>CloneNode serves as a copy constructor for nodes. To see how this method behaves with other node types, see the <see cref="M:System.Xml.XmlNode.CloneNode(System.Boolean)" /> method in the XmlNode class.</para>
@@ -79,6 +78,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplicate of this node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The cloned node.</para>
+        </returns>
         <param name="deep">
           <attribution license="cc4" from="Microsoft" modified="false" />true to recursively clone the subtree under the specified node; false to clone only the node itself. Because CDATA nodes do not have children, regardless of the parameter setting, the cloned node will always include the data content. </param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlCharacterData.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlCharacterData.xml
index 5231d73ad2b..0f336b4448d 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlCharacterData.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlCharacterData.xml
@@ -260,12 +260,15 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a substring of the full string from the specified range.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The substring corresponding to the specified range.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />The position within the string to start retrieving. An offset of zero indicates the starting point is at the start of the data. </param>
         <param name="count">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlComment.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlComment.xml
index 2804c00e8fe..aa4131a021e 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlComment.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlComment.xml
@@ -67,7 +67,6 @@
         <Parameter Name="deep" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>CloneNode serves as a copy constructor for nodes. To see how this method behaves with other node types, see the <see cref="M:System.Xml.XmlNode.CloneNode(System.Boolean)" /> method in the XmlNode class.</para>
@@ -77,6 +76,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplicate of this node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The cloned node.</para>
+        </returns>
         <param name="deep">
           <attribution license="cc4" from="Microsoft" modified="false" />true to recursively clone the subtree under the specified node; false to clone only the node itself. Because comment nodes do not have children, the cloned node always includes the text content, regardless of the parameter setting. </param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlConvert.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlConvert.xml
index 865d61ccbb9..511461011cc 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlConvert.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlConvert.xml
@@ -146,9 +146,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing the decoded name.</para>
-        </returns>
         <example>
           <para>The following example demonstrates the valid and invalid
       character formats for decoding.</para>
@@ -196,6 +193,10 @@ public class App {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes a name. This method does the reverse of the <see cref="M:System.Xml.XmlConvert.EncodeName(System.String)" /> and <see cref="M:System.Xml.XmlConvert.EncodeLocalName(System.String)" /> methods.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The decoded name.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name to be transformed. </param>
       </Docs>
@@ -218,9 +219,6 @@ public class App {
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing the XML local name. If <paramref name="name" /> is <see langword="null" /> or <see cref="F:System.String.Empty" />, <paramref name="name" /> is returned.</para>
-        </returns>
         <example>
           <para>The following example compares the <see cref="M:System.Xml.XmlConvert.EncodeLocalName(System.String)" />, <see cref="M:System.Xml.XmlConvert.EncodeName(System.String)" />, and <see cref="M:System.Xml.XmlConvert.EncodeNmToken(System.String)" /> methods when the name to be encoded is "7:+".</para>
           <code lang="C#">using System;
@@ -254,6 +252,10 @@ public class App {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the name to a valid XML local name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The encoded name.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name to be encoded. </param>
       </Docs>
@@ -276,9 +278,6 @@ public class App {
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing the XML name. If <paramref name="name" /> is <see langword="null" /> or <see cref="F:System.String.Empty" />, <paramref name="name" /> is returned.</para>
-        </returns>
         <example>
           <para>See the <see cref="M:System.Xml.XmlConvert.EncodeLocalName(System.String)" /> method for an example comparing the <see cref="M:System.Xml.XmlConvert.EncodeLocalName(System.String)" />, <see cref="M:System.Xml.XmlConvert.EncodeName(System.String)" />, and <see cref="M:System.Xml.XmlConvert.EncodeNmToken(System.String)" /> methods.</para>
         </example>
@@ -293,6 +292,10 @@ public class App {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the name to a valid XML name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the name with any invalid characters replaced by an escape string.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />A name to be translated. </param>
       </Docs>
@@ -315,10 +318,6 @@ public class App {
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing the XML name token. If <paramref name="name" /> is <see langword="null" /> or <see cref="F:System.String.Empty" />, <paramref name="name" /> is
-   returned.</para>
-        </returns>
         <example>
           <para>See the <see cref="M:System.Xml.XmlConvert.EncodeLocalName(System.String)" /> method for an example comparing the
 <see cref="M:System.Xml.XmlConvert.EncodeLocalName(System.String)" />, <see cref="M:System.Xml.XmlConvert.EncodeName(System.String)" />, and <see cref="M:System.Xml.XmlConvert.EncodeNmToken(System.String)" /> methods.</para>
@@ -332,6 +331,10 @@ public class App {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies the name is valid according to the XML specification.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The encoded name.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name to be encoded. </param>
       </Docs>
@@ -351,12 +354,15 @@ public class App {
         <Parameter Name="ch" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks whether the passed-in character is a valid non-colon character type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the character is a valid non-colon character type; otherwise, false.</para>
+        </returns>
         <param name="ch">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to verify as a non-colon character.</param>
       </Docs>
@@ -375,12 +381,15 @@ public class App {
         <Parameter Name="ch" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the passed-in character instance if the character in the argument is a valid public id character, otherwise null.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the passed-in character if the character is a valid public id character, otherwise null.</para>
+        </returns>
         <param name="ch">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.Char" /> object to validate.</param>
@@ -400,7 +409,6 @@ public class App {
         <Parameter Name="ch" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For details about allowed characters, see the <see cref="http://go.microsoft.com/fwlink/?LinkId=147985">XML 1.0 spec (fourth edition)</see> recommendation.</para>
@@ -409,6 +417,10 @@ public class App {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks if the passed-in character is a valid Start Name Character type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character is a valid Start Name Character type; otherwise, false. </para>
+        </returns>
         <param name="ch">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to validate.</param>
       </Docs>
@@ -427,7 +439,6 @@ public class App {
         <Parameter Name="ch" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For details about allowed characters, see the <see cref="http://go.microsoft.com/fwlink/?LinkID=147985">XML 1.0 spec (fourth edition)</see> recommendation.</para>
@@ -436,6 +447,10 @@ public class App {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks if the passed-in character is a valid XML whitespace character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the passed in character is a valid XML whitespace character; otherwise false.</para>
+        </returns>
         <param name="ch">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to validate.</param>
       </Docs>
@@ -454,7 +469,6 @@ public class App {
         <Parameter Name="ch" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For details about allowed characters, see the <see cref="http://go.microsoft.com/fwlink/?LinkId=147985">XML 1.0 spec (fourth edition)</see> recommendation.</para>
@@ -463,6 +477,10 @@ public class App {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks if the passed-in character is a valid XML character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the passed in character is a valid XML character; otherwise false.</para>
+        </returns>
         <param name="ch">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to validate.</param>
       </Docs>
@@ -482,12 +500,15 @@ public class App {
         <Parameter Name="highChar" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks if the passed-in surrogate pair of characters is a valid XML character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the passed in surrogate pair of characters is a valid XML character; otherwise false.</para>
+        </returns>
         <param name="lowChar">
           <attribution license="cc4" from="Microsoft" modified="false" />The surrogate character to validate.</param>
         <param name="highChar">
@@ -511,10 +532,6 @@ public class App {
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Boolean" /> equivalent of
-<paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -527,6 +544,10 @@ public class App {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.String" /> to a <see cref="T:System.Boolean" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Boolean value, that is, true or false.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert. </param>
       </Docs>
@@ -549,10 +570,6 @@ public class App {
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Byte" /> equivalent of
-<paramref name="s" />.</para>
-        </returns>
         <remarks>
           <para>This method calls <see cref="M:System.Byte.Parse(System.String)" />(<paramref name="s" />, <see cref="F:System.Globalization.NumberStyles.AllowLeadingWhite" />|<see cref="F:System.Globalization.NumberStyles.AllowTrailingWhite" />, <see cref="P:System.Globalization.NumberFormatInfo.InvariantInfo" />).</para>
         </remarks>
@@ -566,6 +583,10 @@ public class App {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.String" /> to a <see cref="T:System.Byte" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Byte equivalent of the string.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert. </param>
       </Docs>
@@ -588,10 +609,6 @@ public class App {
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Char" /> equivalent of
-<paramref name="s" />.</para>
-        </returns>
         <remarks>
           <para>This method calls <see cref="M:System.Char.Parse(System.String)" />(<paramref name="s" />).</para>
         </remarks>
@@ -603,6 +620,10 @@ public class App {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.String" /> to a <see cref="T:System.Char" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Char representing the single character.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing a single character to convert. </param>
       </Docs>
@@ -630,9 +651,6 @@ public class App {
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.DateTime" /> equivalent of <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -649,6 +667,10 @@ public class App {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.String" /> to a <see cref="T:System.DateTime" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A DateTime equivalent of the string.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert. </param>
       </Docs>
@@ -672,9 +694,6 @@ public class App {
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.DateTime" /> equivalent of <paramref name="s" />.</para>
-        </returns>
         <remarks>
           <para>This method calls <see cref="M:System.DateTime.ParseExact(System.String,System.String,System.IFormatProvider)" />(<paramref name="s" />, <paramref name="format" />, <see cref="P:System.Globalization.DateTimeFormatInfo.InvariantInfo" />, <see cref="F:System.Globalization.DateTimeStyles.AllowLeadingWhite" />|<see cref="F:System.Globalization.DateTimeStyles.AllowTrailingWhite" />).</para>
           <para>Valid formats include "yyyy-MM-ddTHH:mm:sszzzzzz" and its subsets.</para>
@@ -694,6 +713,10 @@ public class App {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.String" /> to a <see cref="T:System.DateTime" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A DateTime equivalent of the string.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert. </param>
         <param name="format">
@@ -719,9 +742,6 @@ public class App {
         <Parameter Name="formats" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.DateTime" /> equivalent of <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -763,6 +783,10 @@ public class App {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.String" /> to a <see cref="T:System.DateTime" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A DateTime equivalent of the string.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert. </param>
         <param name="formats">
@@ -786,13 +810,16 @@ public class App {
         <Parameter Name="dateTimeOption" Type="System.Xml.XmlDateTimeSerializationMode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.String" /> to a <see cref="T:System.DateTime" /> using the <see cref="T:System.Xml.XmlDateTimeSerializationMode" /> specified</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DateTime" /> equivalent of the <see cref="T:System.String" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> value to convert.</param>
         <param name="dateTimeOption">
@@ -814,7 +841,6 @@ public class App {
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When more than seven digits are specified for fractional seconds, the value is rounded. For example, 00000004 becomes 0000000 and 00000005 becomes 0000001.</para>
@@ -823,6 +849,10 @@ public class App {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the supplied <see cref="T:System.String" /> to a <see cref="T:System.DateTimeOffset" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTimeOffset" /> equivalent of the supplied string.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert.</param>
       </Docs>
@@ -843,7 +873,6 @@ public class App {
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the offset specified within the input string will cause an overflow in the deserialized representation of the DateTimeOffset, a FormatException is thrown.</para>
@@ -853,6 +882,10 @@ public class App {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the supplied <see cref="T:System.String" /> to a <see cref="T:System.DateTimeOffset" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTimeOffset" /> equivalent of the supplied string.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert.</param>
         <param name="format">
@@ -875,7 +908,6 @@ public class App {
         <Parameter Name="formats" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the offset specified within the input string will cause an overflow in the deserialized representation of the DateTimeOffset, a FormatException is thrown.</para>
@@ -885,6 +917,10 @@ public class App {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the supplied <see cref="T:System.String" /> to a <see cref="T:System.DateTimeOffset" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTimeOffset" /> equivalent of the supplied string.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert.</param>
         <param name="formats">
@@ -908,10 +944,6 @@ public class App {
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Decimal" />
-equivalent of <paramref name="s" />.</para>
-        </returns>
         <remarks>
           <para>This method calls <see cref="M:System.Decimal.Parse(System.String)" />(<paramref name="s" />, <see cref="F:System.Globalization.NumberStyles.AllowLeadingSign" />|<see cref="F:System.Globalization.NumberStyles.AllowDecimalPoint" />|<see cref="F:System.Globalization.NumberStyles.AllowLeadingWhite" />|<see cref="F:System.Globalization.NumberStyles.AllowTrailingWhite" />, <see cref="P:System.Globalization.NumberFormatInfo.InvariantInfo" />).</para>
         </remarks>
@@ -925,6 +957,10 @@ equivalent of <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.String" /> to a <see cref="T:System.Decimal" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Decimal equivalent of the string.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert. </param>
       </Docs>
@@ -948,10 +984,6 @@ equivalent of <paramref name="s" />.</para>
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Double" />
-equivalent of <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -966,6 +998,10 @@ equivalent of <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.String" /> to a <see cref="T:System.Double" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Double equivalent of the string.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert. </param>
       </Docs>
@@ -988,12 +1024,15 @@ equivalent of <paramref name="s" />.</para>
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.String" /> to a <see cref="T:System.Guid" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Guid equivalent of the string.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert. </param>
       </Docs>
@@ -1015,10 +1054,6 @@ equivalent of <paramref name="s" />.</para>
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Int16" />
-equivalent of <paramref name="s" />.</para>
-        </returns>
         <remarks>
           <para>This method calls <see cref="M:System.Int16.Parse(System.String)" />(<paramref name="s" />, <see cref="F:System.Globalization.NumberStyles.AllowLeadingSign" />|<see cref="F:System.Globalization.NumberStyles.AllowLeadingWhite" />|<see cref="F:System.Globalization.NumberStyles.AllowTrailingWhite" />, <see cref="P:System.Globalization.NumberFormatInfo.InvariantInfo" />).</para>
         </remarks>
@@ -1032,6 +1067,10 @@ equivalent of <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.String" /> to a <see cref="T:System.Int16" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An Int16 equivalent of the string.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert. </param>
       </Docs>
@@ -1054,10 +1093,6 @@ equivalent of <paramref name="s" />.</para>
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Int32" />
-equivalent of <paramref name="s" />.</para>
-        </returns>
         <remarks>
           <para>This method calls <see cref="M:System.Int32.Parse(System.String)" />(<paramref name="s" />, <see cref="F:System.Globalization.NumberStyles.AllowLeadingSign" />|<see cref="F:System.Globalization.NumberStyles.AllowLeadingWhite" />|<see cref="F:System.Globalization.NumberStyles.AllowTrailingWhite" />, <see cref="P:System.Globalization.NumberFormatInfo.InvariantInfo" />).</para>
         </remarks>
@@ -1071,6 +1106,10 @@ equivalent of <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.String" /> to a <see cref="T:System.Int32" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An Int32 equivalent of the string.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert. </param>
       </Docs>
@@ -1093,10 +1132,6 @@ equivalent of <paramref name="s" />.</para>
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Int64" />
-equivalent of <paramref name="s" />.</para>
-        </returns>
         <remarks>
           <para>This method calls <see cref="M:System.Int64.Parse(System.String)" />(<paramref name="s" />, <see cref="F:System.Globalization.NumberStyles.AllowLeadingSign" />|<see cref="F:System.Globalization.NumberStyles.AllowLeadingWhite" />|<see cref="F:System.Globalization.NumberStyles.AllowTrailingWhite" />, <see cref="P:System.Globalization.NumberFormatInfo.InvariantInfo" />).</para>
         </remarks>
@@ -1110,6 +1145,10 @@ equivalent of <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.String" /> to a <see cref="T:System.Int64" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An Int64 equivalent of the string.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert. </param>
       </Docs>
@@ -1137,10 +1176,6 @@ equivalent of <paramref name="s" />.</para>
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.SByte" /> equivalent of
-<paramref name="s" />.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use
    <see cref="M:System.Xml.XmlConvert.ToInt16(System.String)" />(<see cref="T:System.String" />).</para>
@@ -1156,6 +1191,10 @@ equivalent of <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.String" /> to a <see cref="T:System.SByte" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An SByte equivalent of the string.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert. </param>
       </Docs>
@@ -1178,10 +1217,6 @@ equivalent of <paramref name="s" />.</para>
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Single" /> equivalent of
-<paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -1196,6 +1231,10 @@ equivalent of <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.String" /> to a <see cref="T:System.Single" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Single equivalent of the string.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert. </param>
       </Docs>
@@ -1219,15 +1258,15 @@ equivalent of <paramref name="s" />.</para>
         <Parameter Name="value" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.String" /> "true" or the <see cref="T:System.String" />
-"false".</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.Boolean" /> to a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the Boolean, that is, "true" or "false".</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to convert. </param>
       </Docs>
@@ -1250,9 +1289,6 @@ equivalent of <paramref name="s" />.</para>
         <Parameter Name="value" Type="System.Byte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.String" /> representation of <paramref name="value" />.</para>
-        </returns>
         <remarks>
           <para>This method calls <paramref name="value" />.ToString(<see langword="null" />, <see cref="P:System.Globalization.NumberFormatInfo.InvariantInfo" /> ).</para>
         </remarks>
@@ -1260,6 +1296,10 @@ equivalent of <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.Byte" /> to a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the Byte.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to convert. </param>
       </Docs>
@@ -1282,9 +1322,6 @@ equivalent of <paramref name="s" />.</para>
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.String" /> representation of <paramref name="value" />.</para>
-        </returns>
         <remarks>
           <para>This method calls <paramref name="value" />.ToString(<see langword="null" />).</para>
         </remarks>
@@ -1292,6 +1329,10 @@ equivalent of <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.Char" /> to a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the Char.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to convert. </param>
       </Docs>
@@ -1319,9 +1360,6 @@ equivalent of <paramref name="s" />.</para>
         <Parameter Name="value" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.String" /> representation of <paramref name="value" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1332,6 +1370,10 @@ equivalent of <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.DateTime" /> to a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the DateTime in the format yyyy-MM-ddTHH:mm:ss where 'T' is a constant literal.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to convert. </param>
       </Docs>
@@ -1352,12 +1394,15 @@ equivalent of <paramref name="s" />.</para>
         <Parameter Name="value" Type="System.DateTimeOffset" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the supplied <see cref="T:System.DateTimeOffset" /> to a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> representation of the supplied <see cref="T:System.DateTimeOffset" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTimeOffset" /> to be converted.</param>
       </Docs>
@@ -1379,9 +1424,6 @@ equivalent of <paramref name="s" />.</para>
         <Parameter Name="value" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.String" /> representation of <paramref name="value" />.</para>
-        </returns>
         <remarks>
           <para>This method calls <paramref name="value" />.ToString(<see langword="null" />, <see cref="P:System.Globalization.NumberFormatInfo.InvariantInfo" /> ).</para>
         </remarks>
@@ -1389,6 +1431,10 @@ equivalent of <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.Decimal" /> to a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the Decimal.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to convert. </param>
       </Docs>
@@ -1412,9 +1458,6 @@ equivalent of <paramref name="s" />.</para>
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.String" /> representation of <paramref name="value" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="value" /> is Double.PositiveInfinity or Double.NegativeInfinity, this method returns the string INF or -INF respectively.</para>
@@ -1423,6 +1466,10 @@ equivalent of <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.Double" /> to a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the Double.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to convert. </param>
       </Docs>
@@ -1445,12 +1492,15 @@ equivalent of <paramref name="s" />.</para>
         <Parameter Name="value" Type="System.Guid" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.Guid" /> to a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the Guid.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to convert. </param>
       </Docs>
@@ -1472,9 +1522,6 @@ equivalent of <paramref name="s" />.</para>
         <Parameter Name="value" Type="System.Int16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.String" /> representation of <paramref name="value" />.</para>
-        </returns>
         <remarks>
           <para>This method calls <paramref name="value" />.ToString(<see langword="null" />, <see cref="P:System.Globalization.NumberFormatInfo.InvariantInfo" /> ).</para>
         </remarks>
@@ -1482,6 +1529,10 @@ equivalent of <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.Int16" /> to a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the Int16.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to convert. </param>
       </Docs>
@@ -1504,9 +1555,6 @@ equivalent of <paramref name="s" />.</para>
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.String" /> representation of <paramref name="value" />.</para>
-        </returns>
         <remarks>
           <para>This method calls <paramref name="value" />.ToString(<see langword="null" />, <see cref="P:System.Globalization.NumberFormatInfo.InvariantInfo" /> ).</para>
         </remarks>
@@ -1514,6 +1562,10 @@ equivalent of <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.Int32" /> to a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the Int32.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to convert. </param>
       </Docs>
@@ -1536,9 +1588,6 @@ equivalent of <paramref name="s" />.</para>
         <Parameter Name="value" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.String" /> representation of <paramref name="value" />.</para>
-        </returns>
         <remarks>
           <para>This method calls <paramref name="value" />.ToString(<see langword="null" />, <see cref="P:System.Globalization.NumberFormatInfo.InvariantInfo" />).</para>
         </remarks>
@@ -1546,6 +1595,10 @@ equivalent of <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.Int64" /> to a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the Int64.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to convert. </param>
       </Docs>
@@ -1573,9 +1626,6 @@ equivalent of <paramref name="s" />.</para>
         <Parameter Name="value" Type="System.SByte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.String" /> representation of <paramref name="value" />.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use
    <see cref="M:System.Xml.XmlConvert.ToString(System.Boolean)" />(<see cref="T:System.Int16" />).</para>
@@ -1585,6 +1635,10 @@ equivalent of <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.SByte" /> to a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the SByte.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to convert. </param>
       </Docs>
@@ -1607,9 +1661,6 @@ equivalent of <paramref name="s" />.</para>
         <Parameter Name="value" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.String" /> representation of <paramref name="value" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="value" /> is Single.PositiveInfinity or Single.NegativeInfinity, this method returns the string INF or -INF respectively.</para>
@@ -1618,6 +1669,10 @@ equivalent of <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.Single" /> to a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the Single.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to convert. </param>
       </Docs>
@@ -1641,9 +1696,6 @@ equivalent of <paramref name="s" />.</para>
         <Parameter Name="value" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.String" /> representation of <paramref name="value" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <example>
           <para> The following example converts a <see cref="T:System.TimeSpan" /> to a <see cref="T:System.String" /> and writes the result
@@ -1668,6 +1720,10 @@ public class App {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.TimeSpan" /> to a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the TimeSpan.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to convert. </param>
       </Docs>
@@ -1695,9 +1751,6 @@ public class App {
         <Parameter Name="value" Type="System.UInt16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.String" /> representation of <paramref name="value" />.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant
       alternative, use <see cref="M:System.Xml.XmlConvert.ToString(System.Boolean)" />(<see cref="T:System.Int32" />).</para>
@@ -1707,6 +1760,10 @@ public class App {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.UInt16" /> to a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the UInt16.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to convert. </param>
       </Docs>
@@ -1734,9 +1791,6 @@ public class App {
         <Parameter Name="value" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.String" /> representation of <paramref name="value" />.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use
    <see cref="M:System.Xml.XmlConvert.ToString(System.Boolean)" />(<see cref="T:System.Int64" />).</para>
@@ -1746,6 +1800,10 @@ public class App {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.UInt32" /> to a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the UInt32.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to convert. </param>
       </Docs>
@@ -1773,9 +1831,6 @@ public class App {
         <Parameter Name="value" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.String" /> representation of <paramref name="value" />.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use
    <see cref="M:System.Xml.XmlConvert.ToString(System.Boolean)" />(<see cref="T:System.Decimal" />).</para>
@@ -1785,6 +1840,10 @@ public class App {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.UInt64" /> to a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the UInt64.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to convert. </param>
       </Docs>
@@ -1808,9 +1867,6 @@ public class App {
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.String" /> representation of <paramref name="value" /> in the specified format..</para>
-        </returns>
         <remarks>
           <para> This method calls <paramref name="value" />.ToString(<paramref name="format" />, <see cref="P:System.Globalization.DateTimeFormatInfo.InvariantInfo" />).</para>
         </remarks>
@@ -1820,6 +1876,10 @@ public class App {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.DateTime" /> to a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the DateTime in the specified format.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to convert. </param>
         <param name="format">
@@ -1843,13 +1903,16 @@ public class App {
         <Parameter Name="dateTimeOption" Type="System.Xml.XmlDateTimeSerializationMode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.DateTime" /> to a <see cref="T:System.String" /> using the <see cref="T:System.Xml.XmlDateTimeSerializationMode" /> specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> equivalent of the <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> value to convert.</param>
         <param name="dateTimeOption">
@@ -1872,12 +1935,15 @@ public class App {
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the supplied <see cref="T:System.DateTimeOffset" /> to a <see cref="T:System.String" /> in the specified format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> representation in the specified format of the supplied <see cref="T:System.DateTimeOffset" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTimeOffset" /> to be converted.</param>
         <param name="format">
@@ -1901,10 +1967,6 @@ public class App {
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.TimeSpan" /> equivalent of
-<paramref name="s" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.FormatException">
           <paramref name="s" /> is not in the correct format to represent a <see cref="T:System.TimeSpan" /> value.</exception>
@@ -1912,6 +1974,10 @@ public class App {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.String" /> to a <see cref="T:System.TimeSpan" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A TimeSpan equivalent of the string.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert. The string format must conform to the W3C XML Schema Part 2: Datatypes recommendation for duration.</param>
       </Docs>
@@ -1939,10 +2005,6 @@ public class App {
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.UInt16" /> equivalent of
-<paramref name="s" />.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use
    <see cref="M:System.Xml.XmlConvert.ToInt32(System.String)" />(<see cref="T:System.String" />).</para>
@@ -1958,6 +2020,10 @@ public class App {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.String" /> to a <see cref="T:System.UInt16" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A UInt16 equivalent of the string.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert. </param>
       </Docs>
@@ -1985,10 +2051,6 @@ public class App {
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.UInt32" /> equivalent of
-<paramref name="s" />.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use
    <see cref="M:System.Xml.XmlConvert.ToInt64(System.String)" />(<see cref="T:System.String" />).</para>
@@ -2004,6 +2066,10 @@ public class App {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.String" /> to a <see cref="T:System.UInt32" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A UInt32 equivalent of the string.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert. </param>
       </Docs>
@@ -2031,10 +2097,6 @@ public class App {
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.UInt64" /> equivalent of
-<paramref name="s" />.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use
    <see cref="M:System.Xml.XmlConvert.ToDecimal(System.String)" />(<see cref="T:System.String" />).</para>
@@ -2050,6 +2112,10 @@ public class App {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.String" /> to a <see cref="T:System.UInt64" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A UInt64 equivalent of the string.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert. </param>
       </Docs>
@@ -2072,9 +2138,6 @@ public class App {
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.String" /><paramref name="name" />, if it is a valid XML name.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="name" /> is <see langword="null" /> or <see cref="F:System.String.Empty" />.</exception>
         <exception cref="T:System.Xml.XmlException">
@@ -2094,6 +2157,10 @@ public class App {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies that the name is a valid name according to the W3C Extended Markup Language recommendation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name, if it is a valid XML name.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name to verify. </param>
       </Docs>
@@ -2116,9 +2183,6 @@ public class App {
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> The <see cref="T:System.String" /><paramref name="name" />, if it is a valid XML qualified name.</para>
-        </returns>
         <remarks>
           <para>If <paramref name="name" /> contains a colon, <see cref="T:System.Xml.XmlException" /> is
    thrown.</para>
@@ -2131,6 +2195,10 @@ public class App {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies that the name is a valid NCName according to the W3C Extended Markup Language recommendation. An NCName is a name that cannot contain a colon.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name, if it is a valid NCName.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name to verify. </param>
       </Docs>
@@ -2151,7 +2219,6 @@ public class App {
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2168,6 +2235,10 @@ catch(Exception e) {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies that the string is a valid NMTOKEN according to the W3C XML Schema Part2: Datatypes recommendation</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name token, if it is a valid NMTOKEN.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string you wish to verify.</param>
       </Docs>
@@ -2186,7 +2257,6 @@ catch(Exception e) {
         <Parameter Name="publicId" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No other values than the passed in argument should be returned. The characters valid for public id do not vary between XML editions, so no XmlVersion overload is required. </para>
@@ -2197,6 +2267,10 @@ catch(Exception e) {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the passed in string instance if all the characters in the string argument are valid public id characters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the passed-in string if all the characters in the argument are valid public id characters.</para>
+        </returns>
         <param name="publicId">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.String" /> that contains the id to validate.</param>
@@ -2217,7 +2291,6 @@ catch(Exception e) {
         <Parameter Name="token" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2234,6 +2307,10 @@ catch(Exception e) {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies that the string is a valid token according to the W3C XML Schema Part2: Datatypes recommendation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The token, if it is a valid token.</para>
+        </returns>
         <param name="token">
           <attribution license="cc4" from="Microsoft" modified="false" />The string value you wish to verify.</param>
       </Docs>
@@ -2252,7 +2329,6 @@ catch(Exception e) {
         <Parameter Name="content" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No other values than the passed in argument should be returned. The characters that are valid for whitespace do not vary between XML editions, so no xml version overload is required.</para>
@@ -2264,6 +2340,10 @@ catch(Exception e) {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the passed-in string instance if all the characters in the string argument are valid whitespace characters. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the passed-in string instance if all the characters in the string argument are valid whitespace characters, otherwise null.</para>
+        </returns>
         <param name="content">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.String" /> to verify.</param>
@@ -2283,7 +2363,6 @@ catch(Exception e) {
         <Parameter Name="content" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>No other values than the passed in argument should be returned. See <see cref="http://go.microsoft.com/fwlink/?LinkID=147985">XML 1.0 spec (fourth edition)</see> production [2] Char for details on the allowed characters.</para>
@@ -2293,6 +2372,10 @@ catch(Exception e) {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the passed-in string if all the characters and surrogate pair characters in the string argument are valid XML characters, otherwise null. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the passed-in string if all the characters and surrogate-pair characters in the string argument are valid XML characters, otherwise null.</para>
+        </returns>
         <param name="content">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.String" /> that contains characters to verify.</param>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlDeclaration.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlDeclaration.xml
index c52fa8d38a0..73abf234fd5 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlDeclaration.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlDeclaration.xml
@@ -76,7 +76,6 @@
         <Parameter Name="deep" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>CloneNode serves as a copy constructor for nodes. To see how this method behaves with other node types, see <see cref="M:System.Xml.XmlNode.CloneNode(System.Boolean)" />.</para>
@@ -86,6 +85,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplicate of this node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The cloned node.</para>
+        </returns>
         <param name="deep">
           <attribution license="cc4" from="Microsoft" modified="false" />true to recursively clone the subtree under the specified node; false to clone only the node itself. Because XmlDeclaration nodes do not have children, the cloned node always includes the data value, regardless of the parameter setting. </param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlDocument.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlDocument.xml
index c922191c11c..a1c84b9733f 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlDocument.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlDocument.xml
@@ -151,7 +151,6 @@
         <Parameter Name="deep" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method serves as a copy constructor for nodes. The cloned node has no parent (<see cref="P:System.Xml.XmlNode.ParentNode" /> returns null).</para>
@@ -161,6 +160,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplicate of this node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The cloned XmlDocument node.</para>
+        </returns>
         <param name="deep">
           <attribution license="cc4" from="Microsoft" modified="false" />true to recursively clone the subtree under the specified node; false to clone only the node itself. </param>
       </Docs>
@@ -181,7 +184,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlAttribute'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The XmlAttribute can be added to an <see cref="T:System.Xml.XmlElement" /> using the <see cref="M:System.Xml.XmlElement.SetAttributeNode(System.Xml.XmlAttribute)" /> method.</para>
@@ -190,6 +192,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XmlAttribute" /> with the specified <see cref="P:System.Xml.XmlDocument.Name" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new XmlAttribute.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The qualified name of the attribute. If the name contains a colon, the <see cref="P:System.Xml.XmlNode.Prefix" /> property reflects the part of the name preceding the first colon and the <see cref="P:System.Xml.XmlDocument.LocalName" /> property reflects the part of the name following the first colon. The <see cref="P:System.Xml.XmlNode.NamespaceURI" /> remains empty unless the prefix is a recognized built-in prefix such as xmlns. In this case NamespaceURI has a value of http://www.w3.org/2000/xmlns/. </param>
       </Docs>
@@ -211,7 +217,6 @@
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlAttribute'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The XmlAttribute can be added to an <see cref="T:System.Xml.XmlElement" /> using the <see cref="M:System.Xml.XmlElement.SetAttributeNode(System.Xml.XmlAttribute)" /> method.</para>
@@ -220,6 +225,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XmlAttribute" /> with the specified qualified name and <see cref="P:System.Xml.XmlNode.NamespaceURI" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new XmlAttribute.</para>
+        </returns>
         <param name="qualifiedName">
           <attribution license="cc4" from="Microsoft" modified="false" />The qualified name of the attribute. If the name contains a colon then the <see cref="P:System.Xml.XmlNode.Prefix" /> property will reflect the part of the name preceding the colon and the <see cref="P:System.Xml.XmlDocument.LocalName" /> property will reflect the part of the name after the colon. </param>
         <param name="namespaceURI">
@@ -244,7 +253,6 @@
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>A new <see cref="T:System.Xml.XmlAttribute" /> instance whose <see cref="P:System.Xml.XmlAttribute.OwnerDocument" /> is this document.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The XmlAttribute can be added to an <see cref="T:System.Xml.XmlElement" /> using the <see cref="M:System.Xml.XmlElement.SetAttributeNode(System.Xml.XmlAttribute)" /> method.</para>
@@ -254,6 +262,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XmlAttribute" /> with the specified <see cref="P:System.Xml.XmlNode.Prefix" />, <see cref="P:System.Xml.XmlDocument.LocalName" />, and <see cref="P:System.Xml.XmlNode.NamespaceURI" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new XmlAttribute.</para>
+        </returns>
         <param name="prefix">
           <attribution license="cc4" from="Microsoft" modified="false" />The prefix of the attribute (if any). String.Empty and null are equivalent. </param>
         <param name="localName">
@@ -278,7 +290,6 @@
         <Parameter Name="data" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlCDataSection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Although this method creates the new object in the context of the document, it does not automatically add the new object to the document tree. To add the new object, you must explicitly call one of the node insert methods.</para>
@@ -288,6 +299,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XmlCDataSection" /> containing the specified data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new XmlCDataSection.</para>
+        </returns>
         <param name="data">
           <attribution license="cc4" from="Microsoft" modified="false" />The content of the new XmlCDataSection. </param>
       </Docs>
@@ -308,7 +323,6 @@
         <Parameter Name="data" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlComment'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Although this method creates the new object in the context of the document, it does not automatically add the new object to the document tree. To add the new object, you must explicitly call one of the node insert methods.</para>
@@ -318,6 +332,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XmlComment" /> containing the specified data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new XmlComment.</para>
+        </returns>
         <param name="data">
           <attribution license="cc4" from="Microsoft" modified="false" />The content of the new XmlComment. </param>
       </Docs>
@@ -340,7 +358,6 @@
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is a Microsoft extension to the Document Object Model (DOM).</para>
@@ -349,6 +366,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a default attribute with the specified prefix, local name and namespace URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Xml.XmlAttribute" />.</para>
+        </returns>
         <param name="prefix">
           <attribution license="cc4" from="Microsoft" modified="false" />The prefix of the attribute (if any). </param>
         <param name="localName">
@@ -371,7 +392,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'XmlDocumentFragment'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>DocumentFragment nodes cannot be inserted into a document. However, you can insert children of the DocumentFragment node into a document.</para>
@@ -380,6 +400,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XmlDocumentFragment" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new XmlDocumentFragment.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateDocumentType">
@@ -401,7 +425,6 @@
         <Parameter Name="internalSubset" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlDocumentType'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned node will have parsed <see cref="P:System.Xml.XmlDocumentType.Entities" /> and <see cref="P:System.Xml.XmlDocumentType.Notations" /> collections.</para>
@@ -413,6 +436,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new <see cref="T:System.Xml.XmlDocumentType" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new XmlDocumentType.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />Name of the document type. </param>
         <param name="publicId">
@@ -439,7 +466,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlElement'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Note that the instance returned implements the XmlElement interface, so default attributes would be created directly on the returned object.</para>
@@ -450,6 +476,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an element with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new XmlElement.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The qualified name of the element. If the name contains a colon then the <see cref="P:System.Xml.XmlNode.Prefix" /> property reflects the part of the name preceding the colon and the <see cref="P:System.Xml.XmlDocument.LocalName" /> property reflects the part of the name after the colon. The qualified name cannot include a prefix of'xmlns'. </param>
       </Docs>
@@ -471,7 +501,6 @@
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlElement'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following C# code </para>
@@ -487,6 +516,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XmlElement" /> with the qualified name and <see cref="P:System.Xml.XmlNode.NamespaceURI" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new XmlElement.</para>
+        </returns>
         <param name="qualifiedName">
           <attribution license="cc4" from="Microsoft" modified="false" />The qualified name of the element. If the name contains a colon then the <see cref="P:System.Xml.XmlNode.Prefix" /> property will reflect the part of the name preceding the colon and the <see cref="P:System.Xml.XmlDocument.LocalName" /> property will reflect the part of the name after the colon. The qualified name cannot include a prefix of'xmlns'. </param>
         <param name="namespaceURI">
@@ -511,7 +544,6 @@
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>A new <see cref="T:System.Xml.XmlElement" /> instance whose <see cref="P:System.Xml.XmlElement.OwnerDocument" /> is this document.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following C# code </para>
@@ -527,6 +559,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an element with the specified <see cref="P:System.Xml.XmlNode.Prefix" />, <see cref="P:System.Xml.XmlDocument.LocalName" />, and <see cref="P:System.Xml.XmlNode.NamespaceURI" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Xml.XmlElement" />.</para>
+        </returns>
         <param name="prefix">
           <attribution license="cc4" from="Microsoft" modified="false" />The prefix of the new element (if any). String.Empty and null are equivalent. </param>
         <param name="localName">
@@ -551,7 +587,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlEntityReference'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the referenced entity is known, the child list of the XmlEntityReference node is made the same as that of the corresponding <see cref="T:System.Xml.XmlEntity" /> node.</para>
@@ -569,6 +604,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XmlEntityReference" /> with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new XmlEntityReference.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the entity reference. </param>
       </Docs>
@@ -586,7 +625,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -596,6 +634,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.XPath.XPathNavigator" /> object for navigating this document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XPath.XPathNavigator" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateNavigator">
@@ -614,7 +656,6 @@
         <Parameter Name="node" Type="System.Xml.XmlNode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is a Microsoft extension to the Document Object Model (DOM).</para>
@@ -623,6 +664,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XPath.XPathNavigator" /> object for navigating this document positioned on the <see cref="T:System.Xml.XmlNode" /> specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XPath.XPathNavigator" /> object.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlNode" /> you want the navigator initially positioned on. </param>
       </Docs>
@@ -645,7 +690,6 @@
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>An <see cref="T:System.Xml.XmlNode" /> instance as indicated by the parameters.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="nodeTypeString" /> parameter is case sensitive and must be one of the values in the following table.</para>
@@ -1093,6 +1137,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XmlNode" /> with the specified node type, <see cref="P:System.Xml.XmlDocument.Name" />, and <see cref="P:System.Xml.XmlNode.NamespaceURI" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new XmlNode.</para>
+        </returns>
         <param name="nodeTypeString">
           <attribution license="cc4" from="Microsoft" modified="false" />String version of the <see cref="T:System.Xml.XmlNodeType" /> of the new node. This parameter must be one of the values listed in the table below. </param>
         <param name="name">
@@ -1119,7 +1167,6 @@
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>An <see cref="T:System.Xml.XmlNode" /> instance as indicated by the parameters.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Although this method creates the new object in the context of the document, it does not automatically add the new object to the document tree. To add the new object, you must explicitly call one of the node insert methods.</para>
@@ -1458,6 +1505,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XmlNode" /> with the specified <see cref="T:System.Xml.XmlNodeType" />, <see cref="P:System.Xml.XmlDocument.Name" />, and <see cref="P:System.Xml.XmlNode.NamespaceURI" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new XmlNode.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The XmlNodeType of the new node. </param>
         <param name="name">
@@ -1485,7 +1536,6 @@
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>An <see cref="T:System.Xml.XmlNode" /> instance as indicated by the parameters.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Although this method creates the new object in the context of the document, it does not automatically add the new object to the document tree. To add the new object, you must explicitly call one of the node insert methods.</para>
@@ -1824,6 +1874,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Xml.XmlNode" /> with the specified <see cref="T:System.Xml.XmlNodeType" />, <see cref="P:System.Xml.XmlNode.Prefix" />, <see cref="P:System.Xml.XmlDocument.Name" />, and <see cref="P:System.Xml.XmlNode.NamespaceURI" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new XmlNode.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The XmlNodeType of the new node. </param>
         <param name="prefix">
@@ -1851,7 +1905,6 @@
         <Parameter Name="data" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlProcessingInstruction'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Although this method creates the new object in the context of the document, it does not automatically add the new object to the document tree. To add the new object, you must explicitly call one of the node insert methods.</para>
@@ -1861,6 +1914,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XmlProcessingInstruction" /> with the specified name and data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new XmlProcessingInstruction.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the processing instruction. </param>
         <param name="data">
@@ -1883,7 +1940,6 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlSignificantWhitespace'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is a Microsoft extension to the Document Object Model (DOM). It is used when you want to manually format your document.</para>
@@ -1893,6 +1949,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XmlSignificantWhitespace" /> node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new XmlSignificantWhitespace node.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The string must contain only the following characters &amp;#20; &amp;#10; &amp;#13; and &amp;#9; </param>
       </Docs>
@@ -1913,7 +1973,6 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlText'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Although this method creates the new object in the context of the document, it does not automatically add the new object to the document tree. To add the new object, you must explicitly call one of the node insert methods.</para>
@@ -1923,6 +1982,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XmlText" /> with the specified text.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new XmlText node.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text for the Text node. </param>
       </Docs>
@@ -1943,7 +2006,6 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlWhitespace'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is a Microsoft extension to the Document Object Model (DOM). It is used when you want to manually format your document.</para>
@@ -1953,6 +2015,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XmlWhitespace" /> node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new XmlWhitespace node.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The string must contain only the following characters &amp;#20; &amp;#10; &amp;#13; and &amp;#9; </param>
       </Docs>
@@ -1975,7 +2041,6 @@
         <Parameter Name="standalone" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlDeclaration'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The attributes are exposed as special properties on the XmlDeclaration node, and not as <see cref="T:System.Xml.XmlAttribute" /> nodes.</para>
@@ -1987,6 +2052,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XmlDeclaration" /> node with the specified values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new XmlDeclaration node.</para>
+        </returns>
         <param name="version">
           <attribution license="cc4" from="Microsoft" modified="false" />The version must be "1.0". </param>
         <param name="encoding">
@@ -2067,7 +2136,6 @@
         <Parameter Name="elementId" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>An <see cref="T:System.Xml.XmlElement" /> instance that matches the argument ID, or null if there is no such element.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the document has multiple elements with the matching ID, this method returns the first matching element in the document.</para>
@@ -2079,6 +2147,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Xml.XmlElement" /> with the specified ID.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XmlElement with the matching ID or null if no matching element is found.</para>
+        </returns>
         <param name="elementId">
           <attribution license="cc4" from="Microsoft" modified="false" />The attribute ID to match. </param>
       </Docs>
@@ -2099,8 +2171,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <see cref="T:System.Xml.XmlNodeList" /> that contains the resulting elements.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The nodes are placed in the order in which they would be encountered in the document.</para>
@@ -2112,6 +2182,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Xml.XmlNodeList" /> containing a list of all descendant elements that match the specified <see cref="P:System.Xml.XmlDocument.Name" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlNodeList" /> containing a list of all matching nodes. If no nodes match <paramref name="name" />, the returned collection will be empty.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The qualified name to match. It is matched against the Name property of the matching node. The special value "*" matches all tags. </param>
       </Docs>
@@ -2133,8 +2207,6 @@
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <see cref="T:System.Xml.XmlNodeList" /> that contains the resulting elements.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The nodes are placed in the order in which they would be encountered in the document tree.</para>
@@ -2146,6 +2218,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Xml.XmlNodeList" /> containing a list of all descendant elements that match the specified <see cref="P:System.Xml.XmlDocument.LocalName" /> and <see cref="P:System.Xml.XmlNode.NamespaceURI" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlNodeList" /> containing a list of all matching nodes. If no nodes match the specified <paramref name="localName" /> and <paramref name="namespaceURI" />, the returned collection will be empty.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The LocalName to match. The special value "*" matches all tags. </param>
         <param name="namespaceURI">
@@ -2195,7 +2271,6 @@
         <Parameter Name="deep" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>An <see cref="T:System.Xml.XmlNode" /> that is imported.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned node has no parent. The source node is not altered or removed from the original document; ImportNode creates a copy of the source node.</para>
@@ -2368,6 +2443,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Imports a node from another document to the current document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The imported <see cref="T:System.Xml.XmlNode" />.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The node being imported. </param>
         <param name="deep">
@@ -2989,7 +3068,6 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>An <see cref="T:System.Xml.XmlNode" /> object that represents the node in the argument XmlReader, or null if the reader is not ready to be consumed.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads one XmlNode from the given reader and positions the reader on the next node. This method creates the type of XmlNode matching the <see cref="P:System.Xml.XmlNode.NodeType" /> on which the reader is currently positioned. (If the reader is in the initial state, ReadNode advances the reader to the first node and then operates on that node.) </para>
@@ -3007,6 +3085,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XmlNode" /> object based on the information in the <see cref="T:System.Xml.XmlReader" />. The reader must be positioned on a node or attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new XmlNode or null if no more nodes exist.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The XML source </param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlDocumentFragment.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlDocumentFragment.xml
index d9f66029429..545619b8591 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlDocumentFragment.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlDocumentFragment.xml
@@ -67,7 +67,6 @@
         <Parameter Name="deep" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>CloneNode serves as a copy constructor for nodes. To see how this method behaves with other node types, see <see cref="M:System.Xml.XmlNode.CloneNode(System.Boolean)" />.</para>
@@ -77,6 +76,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplicate of this node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The cloned node.</para>
+        </returns>
         <param name="deep">
           <attribution license="cc4" from="Microsoft" modified="false" />true to recursively clone the subtree under the specified node; false to clone only the node itself. </param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlDocumentType.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlDocumentType.xml
index 4462b52f1ac..88a7f517139 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlDocumentType.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlDocumentType.xml
@@ -79,7 +79,6 @@
         <Parameter Name="deep" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method serves as a copy constructor for nodes. The cloned node has no parent (<see cref="P:System.Xml.XmlNode.ParentNode" /> returns null).</para>
@@ -89,6 +88,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplicate of this node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The cloned node.</para>
+        </returns>
         <param name="deep">
           <attribution license="cc4" from="Microsoft" modified="false" />true to recursively clone the subtree under the specified node; false to clone only the node itself. For document type nodes, the cloned node always includes the subtree, regardless of the parameter setting. </param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlElement.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlElement.xml
index 9dbe61463fe..debe0d0c93d 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlElement.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlElement.xml
@@ -100,7 +100,6 @@
         <Parameter Name="deep" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method serves as a copy constructor for nodes. The duplicate node has no parent (<see cref="P:System.Xml.XmlNode.ParentNode" /> returns null).</para>
@@ -109,6 +108,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplicate of this node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The cloned node.</para>
+        </returns>
         <param name="deep">
           <attribution license="cc4" from="Microsoft" modified="false" />true to recursively clone the subtree under the specified node; false to clone only the node itself (and its attributes if the node is an XmlElement). </param>
       </Docs>
@@ -129,12 +132,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value for the attribute with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified attribute. An empty string is returned if a matching attribute is not found or if the attribute does not have a specified or default value.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the attribute to retrieve. This is a qualified name. It is matched against the Name property of the matching node. </param>
       </Docs>
@@ -156,12 +162,15 @@
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value for the attribute with the specified local name and namespace URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified attribute. An empty string is returned if a matching attribute is not found or if the attribute does not have a specified or default value.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the attribute to retrieve. </param>
         <param name="namespaceURI">
@@ -184,12 +193,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlAttribute'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XmlAttribute with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified XmlAttribute or null if a matching attribute was not found.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the attribute to retrieve. This is a qualified name. It is matched against the Name property of the matching node. </param>
       </Docs>
@@ -211,12 +223,15 @@
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlAttribute'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Xml.XmlAttribute" /> with the specified local name and namespace URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified XmlAttribute or null if a matching attribute was not found.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the attribute. </param>
         <param name="namespaceURI">
@@ -239,7 +254,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlNodeList'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The nodes are placed in the order in which they would be encountered in a preorder traversal of the <see cref="T:System.Xml.XmlElement" /> tree.</para>
@@ -251,6 +265,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Xml.XmlNodeList" /> containing a list of all descendant elements that match the specified <see cref="P:System.Xml.XmlElement.Name" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlNodeList" /> containing a list of all matching nodes. The list is empty if there are no matching nodes.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name tag to match. This is a qualified name. It is matched against the Name property of the matching node. The asterisk (*) is a special value that matches all tags. </param>
       </Docs>
@@ -272,7 +290,6 @@
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlNodeList'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The nodes are placed in the order in which they would be encountered in a preorder traversal of the XmlElement tree.</para>
@@ -284,6 +301,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Xml.XmlNodeList" /> containing a list of all descendant elements that match the specified <see cref="P:System.Xml.XmlElement.LocalName" /> and <see cref="P:System.Xml.XmlElement.NamespaceURI" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlNodeList" /> containing a list of all matching nodes. The list is empty if there are no matching nodes.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name to match. The asterisk (*) is a special value that matches all tags. </param>
         <param name="namespaceURI">
@@ -306,12 +327,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current node has an attribute with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current node has the specified attribute; otherwise, false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the attribute to find. This is a qualified name. It is matched against the Name property of the matching node. </param>
       </Docs>
@@ -333,12 +357,15 @@
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current node has an attribute with the specified local name and namespace URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current node has the specified attribute; otherwise, false.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the attribute to find. </param>
         <param name="namespaceURI">
@@ -742,7 +769,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlNode'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is a Microsoft extension to the Document Object Model (DOM).</para>
@@ -751,6 +777,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the attribute node with the specified index from the element. (If the removed attribute has a default value, it is immediately replaced).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The attribute node removed or null if there is no node at the given index.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the node to remove. The first node has index 0. </param>
       </Docs>
@@ -771,12 +801,15 @@
         <Parameter Name="oldAttr" Type="System.Xml.XmlAttribute" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlAttribute'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the specified <see cref="T:System.Xml.XmlAttribute" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The removed XmlAttribute or null if <paramref name="oldAttr" /> is not an attribute node of the XmlElement.</para>
+        </returns>
         <param name="oldAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />The XmlAttribute node to remove. If the removed attribute has a default value, it is immediately replaced. </param>
       </Docs>
@@ -798,12 +831,15 @@
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlAttribute'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the <see cref="T:System.Xml.XmlAttribute" /> specified by the local name and namespace URI. (If the removed attribute has a default value, it is immediately replaced).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The removed XmlAttribute or null if the XmlElement does not have a matching attribute node.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the attribute. </param>
         <param name="namespaceURI">
@@ -883,12 +919,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the value of the attribute with the specified local name and namespace URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The attribute value.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the attribute. </param>
         <param name="namespaceURI">
@@ -913,7 +952,6 @@
         <Parameter Name="newAttr" Type="System.Xml.XmlAttribute" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlAttribute'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If an attribute with that name is already present in the element, it is replaced by the new one.</para>
@@ -922,6 +960,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Xml.XmlAttribute" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If the attribute replaces an existing attribute with the same name, the old XmlAttribute is returned; otherwise, null is returned.</para>
+        </returns>
         <param name="newAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />The XmlAttribute node to add to the attribute collection for this element. </param>
       </Docs>
@@ -943,7 +985,6 @@
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlAttribute'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The XmlAttribute does not have any children. Use <see cref="P:System.Xml.XmlAttribute.Value" /> to assign a text value to the attribute or use <see cref="M:System.Xml.XmlNode.AppendChild(System.Xml.XmlNode)" /> (or a similar method) to add children to the attribute.</para>
@@ -952,6 +993,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.Xml.XmlAttribute" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XmlAttribute to add.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the attribute. </param>
         <param name="namespaceURI">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlEntity.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlEntity.xml
index 417e58f10c6..2ce841a8017 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlEntity.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlEntity.xml
@@ -270,12 +270,15 @@
         <Parameter Name="deep" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplicate of this node. Entity nodes cannot be cloned. Calling this method on an <see cref="T:System.Xml.XmlEntity" /> object throws an exception.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a copy of the <see cref="T:System.Xml.XmlNode" /> from which the method is called.</para>
+        </returns>
         <param name="deep">
           <attribution license="cc4" from="Microsoft" modified="false" />true to recursively clone the subtree under the specified node; false to clone only the node itself.</param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlEntityReference.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlEntityReference.xml
index 9e1fb55e992..7bd6bf7ae91 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlEntityReference.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlEntityReference.xml
@@ -97,7 +97,6 @@
         <Parameter Name="deep" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method serves as a copy constructor for nodes. The cloned node has no parent (<see cref="P:System.Xml.XmlNode.ParentNode" /> returns null).</para>
@@ -106,6 +105,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplicate of this node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The cloned node.</para>
+        </returns>
         <param name="deep">
           <attribution license="cc4" from="Microsoft" modified="false" />true to recursively clone the subtree under the specified node; false to clone only the node itself. For XmlEntityReference nodes, this method always returns an entity reference node with no children. The replacement text is set when the node is inserted into a parent. </param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlImplementation.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlImplementation.xml
index 7a0dae2fbb0..9bc02548ae0 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlImplementation.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlImplementation.xml
@@ -81,7 +81,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'XmlDocument'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>XmlDocument objects created from the same implementation share the same name table. This enables users to compare attribute and element names between the objects more efficiently.</para>
@@ -91,6 +90,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.XmlDocument" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new XmlDocument object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HasFeature">
@@ -110,12 +113,44 @@
         <Parameter Name="strVersion" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests if the Document Object Model (DOM) implementation implements a specific feature.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the feature is implemented in the specified version; otherwise, false.</para>
+          <para>The following table shows the combinations that cause HasFeature to return true.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>strFeature </para>
+                </term>
+                <description>
+                  <para>strVersion </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>XML </para>
+              </term>
+              <description>
+                <para>1.0 </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>XML </para>
+              </term>
+              <description>
+                <para>2.0 </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="strFeature">
           <attribution license="cc4" from="Microsoft" modified="false" />The package name of the feature to test. This name is not case-sensitive. </param>
         <param name="strVersion">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlNameTable.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlNameTable.xml
index 658ec4e967e..4b45aa3939d 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlNameTable.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlNameTable.xml
@@ -71,12 +71,6 @@
         <Parameter Name="array" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="array" />, if it did not exist in the table at the time of the call, or
-   the <see cref="T:System.String" />
-   instance previously stored in the table with a value equal to <paramref name="array" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="array" /> is <see langword="null" />.</exception>
         <remarks>
@@ -87,6 +81,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, atomizes the specified string and adds it to the XmlNameTable.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new atomized string or the existing one if it already exists.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The name to add. </param>
       </Docs>
@@ -111,12 +109,6 @@
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.String" qualify="true" />
-equivalent of the specified subset of the <see cref="T:System.Char" qualify="true" /> array that is stored in the table, or
-<see cref="F:System.String.Empty" qualify="true" /> if
-<paramref name="length" /> is zero.</para>
-        </returns>
         <exception cref="T:System.IndexOutOfRangeException">
           <para>
             <paramref name="offset" /> &lt; 0.</para>
@@ -138,6 +130,10 @@ equivalent of the specified subset of the <see cref="T:System.Char" qualify="tru
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, atomizes the specified string and adds it to the XmlNameTable.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new atomized string or the existing one if it already exists. If length is zero, String.Empty is returned.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The character array containing the name to add. </param>
         <param name="offset">
@@ -164,10 +160,6 @@ equivalent of the specified subset of the <see cref="T:System.Char" qualify="tru
         <Parameter Name="array" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.String" />
-instance previously stored in the table with a value equal to <paramref name="array" />, or <see langword="null" /> if it does not exist.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="array" /> is <see langword="null" />.</exception>
         <remarks>
@@ -178,6 +170,10 @@ instance previously stored in the table with a value equal to <paramref name="ar
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, gets the atomized string containing the same value as the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The atomized string or null if the string has not already been atomized.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The name to look up. </param>
       </Docs>
@@ -202,11 +198,6 @@ instance previously stored in the table with a value equal to <paramref name="ar
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.String" qualify="true" />
-equivalent of the specified subset of the <see cref="T:System.Char" qualify="true" /> array that is stored in the table, or
-<see langword="null" /> if the equivalent <see cref="T:System.String" /> is not in the table.</para>
-        </returns>
         <exception cref="T:System.IndexOutOfRangeException">
           <paramref name="offset" /> &lt; 0. <para>- or -</para><para><paramref name="offset" /> &gt;= <paramref name="array" />.Length.</para><para>- or -</para><para><paramref name="length" /> &gt; <paramref name="array" />.Length - <paramref name="offset" />.</para><para>The above conditions do not cause an exception to be thrown if <paramref name="length" /> = 0.</para></exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -219,6 +210,10 @@ equivalent of the specified subset of the <see cref="T:System.Char" qualify="tru
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, gets the atomized string containing the same characters as the specified range of characters in the given array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The atomized string or null if the string has not already been atomized. If <paramref name="length" /> is zero, String.Empty is returned.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The character array containing the name to look up. </param>
         <param name="offset">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlNamedNodeMap.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlNamedNodeMap.xml
index 3512e5cb9aa..e04d0a5df71 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlNamedNodeMap.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlNamedNodeMap.xml
@@ -78,12 +78,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'System.Collections.IEnumerator'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides support for the "foreach" style iteration over the collection of nodes in the XmlNamedNodeMap.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetNamedItem">
@@ -102,12 +105,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlNode'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an <see cref="T:System.Xml.XmlNode" /> specified by name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XmlNode with the specified name or null if a matching node is not found.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The qualified name of the node to retrieve. It is matched against the <see cref="P:System.Xml.XmlNode.Name" /> property of the matching node.</param>
       </Docs>
@@ -129,12 +135,15 @@
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlNode'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a node with the matching <see cref="P:System.Xml.XmlNode.LocalName" /> and <see cref="P:System.Xml.XmlNode.NamespaceURI" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlNode" /> with the matching local name and namespace URI or null if a matching node was not found.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the node to retrieve.</param>
         <param name="namespaceURI">
@@ -157,12 +166,15 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlNode'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the node at the specified index in the XmlNamedNodeMap.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.XmlNode" /> at the specified index. If <paramref name="index" /> is less than 0 or greater than or equal to the <see cref="P:System.Xml.XmlNamedNodeMap.Count" /> property, null is returned.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index position of the node to retrieve from the XmlNamedNodeMap. The index is zero-based; therefore, the index of the first node is 0 and the index of the last node is <see cref="P:System.Xml.XmlNamedNodeMap.Count" /> -1.</param>
       </Docs>
@@ -183,12 +195,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlNode'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the node from the XmlNamedNodeMap.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XmlNode removed from this XmlNamedNodeMap or null if a matching node was not found.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The qualified name of the node to remove. The name is matched against the <see cref="P:System.Xml.XmlNode.Name" /> property of the matching node.</param>
       </Docs>
@@ -210,12 +225,15 @@
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlNode'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes a node with the matching <see cref="P:System.Xml.XmlNode.LocalName" /> and <see cref="P:System.Xml.XmlNode.NamespaceURI" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.XmlNode" /> removed or null if a matching node was not found.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the node to remove.</param>
         <param name="namespaceURI">
@@ -238,12 +256,15 @@
         <Parameter Name="node" Type="System.Xml.XmlNode" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlNode'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an <see cref="T:System.Xml.XmlNode" /> using its <see cref="P:System.Xml.XmlNode.Name" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If the <paramref name="node" /> replaces an existing node with the same name, the old node is returned; otherwise, null is returned.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />An XmlNode to store in the XmlNamedNodeMap. If a node with that name is already present in the map, it is replaced by the new one.</param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlNamespaceManager.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlNamespaceManager.xml
index 267038d5170..c5feba685ca 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlNamespaceManager.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlNamespaceManager.xml
@@ -328,9 +328,6 @@ while (reader.Read())
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Collections.IEnumerator" qualify="true" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following code shows how to use the <see cref="T:System.Collections.IEnumerator" /> to view all the namespace pairs stored in the <see cref="T:System.Xml.XmlNamespaceManager" /> object.</para>
@@ -345,6 +342,10 @@ Loop</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator to use to iterate through the namespaces in the <see cref="T:System.Xml.XmlNamespaceManager" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> containing the prefixes stored by the <see cref="T:System.Xml.XmlNamespaceManager" />.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -363,7 +364,6 @@ Loop</code>
         <Parameter Name="scope" Type="System.Xml.XmlNamespaceScope" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -434,6 +434,10 @@ Loop</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of namespace names keyed by prefix which can be used to enumerate the namespaces currently in scope.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of namespace and prefix pairs currently in scope.</para>
+        </returns>
         <param name="scope">
           <attribution license="cc4" from="Microsoft" modified="false" />An enumeration value that specifies the type of namespace nodes to return.</param>
       </Docs>
@@ -455,10 +459,6 @@ Loop</code>
         <Parameter Name="prefix" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" /> where <see langword="true" /> indicates there is a
-   namespace defined; otherwise, <see langword="false" />. If <paramref name="prefix" /> is <see langword="null" />, returns <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To determine whether there is a default empty namespace defined, set <paramref name="prefix" /> to String.Empty. A return value of true indicates that there is a default namespace defined in the current scope; false indicates that no default namespace is defined.</para>
@@ -470,6 +470,10 @@ Loop</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the supplied prefix has a namespace defined for the current pushed scope.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there is a namespace defined; otherwise, false.</para>
+        </returns>
         <param name="prefix">
           <attribution license="cc4" from="Microsoft" modified="false" />The prefix of the namespace you want to find. </param>
       </Docs>
@@ -492,11 +496,6 @@ Loop</code>
         <Parameter Name="prefix" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" qualify="true" /> containing the namespace URI for <paramref name="prefix" />, or <see langword="null" />
-if there is
-no mapped namespace.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="behaviors"> As described above. </block>
@@ -513,6 +512,11 @@ no mapped namespace.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the namespace URI for the specified prefix.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the namespace URI for <paramref name="prefix" /> or null if there is no mapped namespace. The returned string is atomized.</para>
+          <para>For more information on atomized strings, see the <see cref="T:System.Xml.XmlNameTable" /> class.</para>
+        </returns>
         <param name="prefix">
           <attribution license="cc4" from="Microsoft" modified="false" />The prefix whose namespace URI you want to resolve. To match the default namespace, pass String.Empty. </param>
       </Docs>
@@ -535,13 +539,6 @@ no mapped namespace.</para>
         <Parameter Name="uri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" qualify="true" /> containing the
-   matching prefix. If there is no mapped prefix, this method returns
-<see langword="null" />. If a <see langword="null" /> 
-value is supplied, then
-<see langword="null" /> is returned.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method finds the mapped prefix by walking the stack (that is, it looks globally). The supplied string must be atomized for the lookup to succeed. In other words, the supplied string object must exist in the namespace manager's name table (<see cref="P:System.Xml.XmlNamespaceManager.NameTable" />).</para>
@@ -551,6 +548,10 @@ value is supplied, then
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds the prefix declared for the given namespace URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The matching prefix. If there is no mapped prefix, the method returns String.Empty. If a null value is supplied, then null is returned.</para>
+        </returns>
         <param name="uri">
           <attribution license="cc4" from="Microsoft" modified="false" />The namespace to resolve for the prefix. </param>
       </Docs>
@@ -600,11 +601,6 @@ value is supplied, then
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" /> where <see langword="true" /> indicates a namespace
-   scope was popped off the stack; <see langword="false" /> indicates there were no namespaces
-   scopes to pop.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When you call this method, all namespaces which were added to <see cref="T:System.Xml.XmlNamespaceManager" /> (by calling <see cref="M:System.Xml.XmlNamespaceManager.AddNamespace(System.String,System.String)" />) since the last call to <see cref="M:System.Xml.XmlNamespaceManager.PopScope" /> are removed.</para>
@@ -613,6 +609,10 @@ value is supplied, then
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Pops a namespace scope off the stack.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there are namespace scopes left on the stack; false if there are no more namespaces to pop.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlNode.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlNode.xml
index d0fa5c95332..ba9e3f596c2 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlNode.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlNode.xml
@@ -54,7 +54,6 @@
         <Parameter Name="newChild" Type="System.Xml.XmlNode" />
       </Parameters>
       <Docs>
-        <returns>The child node.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <paramref name="newChild" /> is already in the tree, it is removed from its original position and added to its target position. For more information about inserting nodes, see <format type="text/html"><a href="891e54f5-54f6-4bb4-b624-9d1b6a1f1216">Inserting Nodes into an XML Document</a></format>.</para>
@@ -64,6 +63,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified node to the end of the list of child nodes, of this node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node added.</para>
+        </returns>
         <param name="newChild">
           <attribution license="cc4" from="Microsoft" modified="false" />The node to add. All the contents of the node to be added are moved into the specified location. </param>
       </Docs>
@@ -353,7 +356,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>A new node cloned from this node in which all descendents of the node are copies of their counterpart descendents in the original node.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Cloning an <see cref="T:System.Xml.XmlElement" /> copies all attributes and their values, including those generated by the XML processor to represent defaulted attributes. This method recursively clones the node and the subtree underneath it.</para>
@@ -505,6 +507,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplicate of this node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The cloned node.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CloneNode">
@@ -523,7 +529,6 @@
         <Parameter Name="deep" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>A clone of the node.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method serves as a copy constructor for nodes. The duplicate node has no parent (<see cref="P:System.Xml.XmlNode.ParentNode" /> returns null).</para>
@@ -724,6 +729,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplicate of the node, when overridden in a derived class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The cloned node.</para>
+        </returns>
         <param name="deep">
           <attribution license="cc4" from="Microsoft" modified="false" />true to recursively clone the subtree under the specified node; false to clone only the node itself. </param>
       </Docs>
@@ -742,7 +751,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>An <see cref="T:System.Xml.XPath.XPathNavigator" /> located at the node.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The XPathNavigator provides read-only, random access to data. Because it is optimized for XSLT transformations, it provides performance benefits when used as an input mechanism to the <see cref="M:System.Xml.Xsl.XslTransform.Transform(System.Xml.XPath.XPathNavigator,System.Xml.Xsl.XsltArgumentList,System.Xml.XmlResolver)" /> method.</para>
@@ -752,6 +760,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XPath.XPathNavigator" /> for navigating this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XPathNavigator object used to navigate the node. The XPathNavigator is positioned on the node from which the method was called. It is not positioned on the root of the document.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="FirstChild">
@@ -789,7 +801,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>An enumerator over the children of this node.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides support for the “for each” style iteration over the nodes in the XmlNode.</para>
@@ -799,6 +810,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Get an enumerator that iterates through the child nodes in the current node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> object that can be used to iterate through the child nodes in the current node.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetNamespaceOfPrefix">
@@ -817,7 +832,6 @@
         <Parameter Name="prefix" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>The namespace URI corresponding to the prefix, or the empty string if no namespace corresponds to the prefix.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is a Microsoft extension to the Document Object Model (DOM).</para>
@@ -826,6 +840,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Looks up the closest xmlns declaration for the given prefix that is in scope for the current node and returns the namespace URI in the declaration.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The namespace URI of the specified prefix.</para>
+        </returns>
         <param name="prefix">
           <attribution license="cc4" from="Microsoft" modified="false" />The prefix whose namespace URI you want to find. </param>
       </Docs>
@@ -846,7 +864,6 @@
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>The prefix corresponding to the namespace URI, or the empty string if no prefix corresponds to the URI.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is a Microsoft extension to the Document Object Model (DOM).</para>
@@ -855,6 +872,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Looks up the closest xmlns declaration for the given namespace URI that is in scope for the current node and returns the prefix defined in that declaration.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The prefix for the specified namespace URI.</para>
+        </returns>
         <param name="namespaceURI">
           <attribution license="cc4" from="Microsoft" modified="false" />The namespace URI whose prefix you want to find. </param>
       </Docs>
@@ -956,7 +977,6 @@
         <Parameter Name="refChild" Type="System.Xml.XmlNode" />
       </Parameters>
       <Docs>
-        <returns>The inserted node.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="refChild" /> is null, insert <paramref name="newChild" /> at the beginning of the list of child nodes. All the contents of the <paramref name="newChild" /> are inserted, in the same order, after <paramref name="refChild" />. If the <paramref name="newChild" /> is already in the tree, it is removed from its original position and added to its target position. For more information about inserting nodes, see <format type="text/html"><a href="891e54f5-54f6-4bb4-b624-9d1b6a1f1216">Inserting Nodes into an XML Document</a></format>.</para>
@@ -967,6 +987,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts the specified node immediately after the specified reference node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node being inserted.</para>
+        </returns>
         <param name="newChild">
           <attribution license="cc4" from="Microsoft" modified="false" />The XmlNode to insert. </param>
         <param name="refChild">
@@ -990,7 +1014,6 @@
         <Parameter Name="refChild" Type="System.Xml.XmlNode" />
       </Parameters>
       <Docs>
-        <returns>The inserted node.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="refChild" /> is null, insert <paramref name="newChild" /> at the end of the list of child nodes. All the contents of the <paramref name="newChild" /> are inserted, in the same order, before <paramref name="refChild" />. If the <paramref name="newChild" /> is already in the tree, it is removed from its original position and added to its target position. For more information about inserting nodes, see <format type="text/html"><a href="891e54f5-54f6-4bb4-b624-9d1b6a1f1216">Inserting Nodes into an XML Document</a></format>.</para>
@@ -1000,6 +1023,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts the specified node immediately before the specified reference node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node being inserted.</para>
+        </returns>
         <param name="newChild">
           <attribution license="cc4" from="Microsoft" modified="false" />The XmlNode to insert. </param>
         <param name="refChild">
@@ -1347,7 +1374,6 @@
         <Parameter Name="newChild" Type="System.Xml.XmlNode" />
       </Parameters>
       <Docs>
-        <returns>The child node.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <paramref name="newChild" /> is already in the tree, it is removed from its original position and added to its target position. For more information about inserting nodes, see <format type="text/html"><a href="891e54f5-54f6-4bb4-b624-9d1b6a1f1216">Inserting Nodes into an XML Document</a></format>.</para>
@@ -1358,6 +1384,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified node to the beginning of the list of child nodes for this node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node added.</para>
+        </returns>
         <param name="newChild">
           <attribution license="cc4" from="Microsoft" modified="false" />The node to add. All the contents of the node to be added are moved into the specified location.</param>
       </Docs>
@@ -1424,12 +1454,15 @@
         <Parameter Name="oldChild" Type="System.Xml.XmlNode" />
       </Parameters>
       <Docs>
-        <returns>The removed node.</returns>
         <remarks>None.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes specified child node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node removed.</para>
+        </returns>
         <param name="oldChild">
           <attribution license="cc4" from="Microsoft" modified="false" />The node being removed. </param>
       </Docs>
@@ -1451,7 +1484,6 @@
         <Parameter Name="oldChild" Type="System.Xml.XmlNode" />
       </Parameters>
       <Docs>
-        <returns>The removed child.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <paramref name="newChild" /> is already in the tree, it is first removed.</para>
@@ -1461,6 +1493,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Replaces the child node <paramref name="oldChild" /> with <paramref name="newChild" /> node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The node replaced.</para>
+        </returns>
         <param name="newChild">
           <attribution license="cc4" from="Microsoft" modified="false" />The new node to put in the child list. </param>
         <param name="oldChild">
@@ -1507,7 +1543,6 @@
         <Parameter Name="xpath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>The nodes selected by the expression.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the XPath expression requires namespace resolution, you must use the SelectNodes overload which takes an <see cref="T:System.Xml.XmlNamespaceManager" /> as its argument. The XmlNamespaceManager is used to resolve namespaces.</para>
@@ -1532,6 +1567,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Selects a list of nodes matching the XPath expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlNodeList" /> containing a collection of nodes matching the XPath query.</para>
+        </returns>
         <param name="xpath">
           <attribution license="cc4" from="Microsoft" modified="false" />The XPath expression. </param>
       </Docs>
@@ -1553,7 +1592,6 @@
         <Parameter Name="nsmgr" Type="System.Xml.XmlNamespaceManager" />
       </Parameters>
       <Docs>
-        <returns>The nodes selected by the expression.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>XPath expressions can include namespaces. Namespace resolution is supported using the XmlNamespaceManager. If the XPath expression includes a prefix, the prefix and namespace URI pair must be added to the XmlNamespaceManager.</para>
@@ -1590,6 +1628,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Selects a list of nodes matching the XPath expression. Any prefixes found in the XPath expression are resolved using the supplied <see cref="T:System.Xml.XmlNamespaceManager" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlNodeList" /> containing a collection of nodes matching the XPath query.</para>
+        </returns>
         <param name="xpath">
           <attribution license="cc4" from="Microsoft" modified="false" />The XPath expression. </param>
         <param name="nsmgr">
@@ -1612,7 +1654,6 @@
         <Parameter Name="xpath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>The first node that matches the expression, or null if no node matches the expression.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the XPath expression requires namespace resolution, you must use the SelectSingleNode overload which takes an <see cref="T:System.Xml.XmlNamespaceManager" /> as its argument. The XmlNamespaceManager is used to resolve namespaces.</para>
@@ -1636,6 +1677,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Selects the first XmlNode that matches the XPath expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first XmlNode that matches the XPath query or null if no matching node is found. The XmlNode should not be expected to be connected "live" to the XML document. That is, changes that appear in the XML document may not appear in the XmlNode, and vice versa.</para>
+        </returns>
         <param name="xpath">
           <attribution license="cc4" from="Microsoft" modified="false" />The XPath expression. </param>
       </Docs>
@@ -1657,7 +1702,6 @@
         <Parameter Name="nsmgr" Type="System.Xml.XmlNamespaceManager" />
       </Parameters>
       <Docs>
-        <returns>The first node that matches the expression, or null if no node matches the expression.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>XPath expressions can include namespaces. Namespace resolution is supported using the XmlNamespaceManager. If the XPath expression includes a prefix, the prefix and namespace URI pair must be added to the XmlNamespaceManager.</para>
@@ -1693,6 +1737,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Selects the first XmlNode that matches the XPath expression. Any prefixes found in the XPath expression are resolved using the supplied <see cref="T:System.Xml.XmlNamespaceManager" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first XmlNode that matches the XPath query or null if no matching node is found. The XmlNode should not be expected to be connected "live" to the XML document. That is, changes that appear in the XML document may not appear in the XmlNode, and vice versa.</para>
+        </returns>
         <param name="xpath">
           <attribution license="cc4" from="Microsoft" modified="false" />The XPath expression. </param>
         <param name="nsmgr">
@@ -1716,7 +1764,6 @@
         <Parameter Name="version" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>Whether the feature/version pair is supported by the node.</returns>
         <remarks>
           <para>This method currently returns true only when <paramref name="feature" /> is "xml" and <paramref name="version" /> is "1.0" or "2.0". This is the equivalent behavior that W3C Document Object Model Level 2 expects. However, it does not mean that this document object model really conforms to the W3C standard. Actually it does not conform to the standard.
 	</para>
@@ -1725,6 +1772,38 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests if the DOM implementation implements a specific feature.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the feature is implemented in the specified version; otherwise, false. The following table describes the combinations that return true.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Feature </para>
+                </term>
+                <description>
+                  <para>Version </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>XML </para>
+              </term>
+              <description>
+                <para>1.0 </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>XML </para>
+              </term>
+              <description>
+                <para>2.0 </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="feature">
           <attribution license="cc4" from="Microsoft" modified="false" />The package name of the feature to test. This name is not case-sensitive. </param>
         <param name="version">
@@ -1745,7 +1824,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Xml.XmlNode" /> instance is cast to an <see cref="T:System.Collections.IEnumerable" /> interface.</para>
@@ -1754,6 +1832,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Xml.XmlNode.GetEnumerator" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an enumerator for the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ICloneable.Clone">
@@ -1770,7 +1852,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Xml.XmlNode" /> instance is cast to an <see cref="T:System.ICloneable" /> interface.</para>
@@ -1779,6 +1860,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Xml.XmlNode.Clone" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the node from which it is called.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlNodeList.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlNodeList.xml
index 99b4e5126c7..509ebb76d14 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlNodeList.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlNodeList.xml
@@ -97,7 +97,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'System.Collections.IEnumerator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides a simple "foreach" style iteration over the collection of nodes in the XmlNodeList.</para>
@@ -106,6 +105,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an enumerator that iterates through the collection of nodes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator used to iterate through the collection of nodes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Item">
@@ -124,12 +127,15 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlNode'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a node at the given index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.XmlNode" /> with the specified index in the collection. If <paramref name="index" /> is greater than or equal to the number of nodes in the list, this returns null.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index into the list of nodes.</param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlNodeReader.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlNodeReader.xml
index fa71db9fb00..58c4b212dc6 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlNodeReader.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlNodeReader.xml
@@ -267,7 +267,6 @@
         <Parameter Name="attributeIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -279,6 +278,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the attribute with the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified attribute.</para>
+        </returns>
         <param name="attributeIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the attribute. The index is zero-based. (The first attribute has index 0.) </param>
       </Docs>
@@ -299,7 +302,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -312,6 +314,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the attribute with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified attribute. If the attribute is not found, null is returned.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The qualified name of the attribute. </param>
       </Docs>
@@ -333,7 +339,6 @@
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -353,6 +358,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the attribute with the specified local name and namespace URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified attribute. If the attribute is not found, null is returned.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the attribute. </param>
         <param name="namespaceURI">
@@ -657,7 +666,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
         <Parameter Name="prefix" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -674,6 +682,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resolves a namespace prefix in the current element's scope.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The namespace URI to which the prefix maps or null if no matching prefix is found.</para>
+        </returns>
         <param name="prefix">
           <attribution license="cc4" from="Microsoft" modified="false" />The prefix whose namespace URI you want to resolve. To match the default namespace, pass an empty string. This string does not have to be atomized. </param>
       </Docs>
@@ -742,7 +754,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -754,6 +765,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves to the attribute with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute is found; otherwise, false. If false, the reader's position does not change.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The qualified name of the attribute. </param>
       </Docs>
@@ -775,7 +790,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -787,6 +801,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves to the attribute with the specified local name and namespace URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute is found; otherwise, false. If false, the reader's position does not change.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the attribute. </param>
         <param name="namespaceURI">
@@ -807,7 +825,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -819,6 +836,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves to the element that contains the current attribute node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the reader is positioned on an attribute (the reader moves to the element that owns the attribute); false if the reader is not positioned on an attribute (the position of the reader does not change).</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MoveToFirstAttribute">
@@ -835,7 +856,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -846,6 +866,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves to the first attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if an attribute exists (the reader moves to the first attribute); otherwise, false (the position of the reader does not change).</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MoveToNextAttribute">
@@ -862,7 +886,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -874,6 +897,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves to the next attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there is a next attribute; false if there are no more attributes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Name">
@@ -1046,7 +1073,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1058,6 +1084,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the next node from the stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the next node was read successfully; false if there are no more nodes to read.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadAttributeValue">
@@ -1074,7 +1104,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1086,6 +1115,12 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Parses the attribute value into one or more Text, EntityReference, or EndEntity nodes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there are nodes to return.</para>
+          <para>false if the reader is not positioned on an attribute node when the initial call is made or if all the attribute values have been read.</para>
+          <para>An empty attribute, such as, misc="", returns true with a single node with a value of String.Empty.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadContentAsBase64">
@@ -1105,7 +1140,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1135,6 +1169,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the content and returns the Base64 decoded binary bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes written to the buffer.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer into which to copy the resulting text. This value cannot be null.</param>
         <param name="index">
@@ -1160,7 +1198,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1190,6 +1227,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the content and returns the BinHex decoded binary bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes written to the buffer.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer into which to copy the resulting text. This value cannot be null.</param>
         <param name="index">
@@ -1215,7 +1256,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1232,6 +1272,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the element and decodes the Base64 content.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes written to the buffer.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer into which to copy the resulting text. This value cannot be null.</param>
         <param name="index">
@@ -1257,7 +1301,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1274,6 +1317,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the element and decodes the BinHex content.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes written to the buffer.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer into which to copy the resulting text. This value cannot be null.</param>
         <param name="index">
@@ -1322,7 +1369,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1335,6 +1381,11 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the contents of an element or text node as a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The contents of the element or text-like node (This can include CDATA, Text nodes, and so on). This can be an empty string if the reader is positioned on something other than an element or text node, or if there is no more text content to return in the current context.</para>
+          <para>Note: The text node can be either an element or an attribute text node.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ResolveEntity">
@@ -1445,7 +1496,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
         <Parameter Name="scope" Type="System.Xml.XmlNamespaceScope" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1455,6 +1505,11 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Xml.IXmlNamespaceResolver.GetNamespacesInScope(System.Xml.XmlNamespaceScope)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="T:System.Collections.IDictionary" /> object that contains the namespaces that are in scope.</para>
+        </returns>
         <param name="scope">
           <attribution license="cc4" from="Microsoft" modified="false" />
           <see cref="T:System.Xml.XmlNamespaceScope" /> object.</param>
@@ -1476,7 +1531,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
       </Parameters>
       <Docs>
         <param name="ns">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1486,6 +1540,11 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Xml.IXmlNamespaceResolver.LookupPrefix(System.String)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="T:System.String" /> object that contains the namespace prefix.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlNotation.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlNotation.xml
index bd44a9bce01..b9b4f2d5251 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlNotation.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlNotation.xml
@@ -39,12 +39,15 @@
         <Parameter Name="deep" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplicate of this node. Notation nodes cannot be cloned. Calling this method on an <see cref="T:System.Xml.XmlNotation" /> object throws an exception.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a <see cref="T:System.Xml.XmlNode" /> copy of the node from which the method is called.</para>
+        </returns>
         <param name="deep">
           <attribution license="cc4" from="Microsoft" modified="false" />true to recursively clone the subtree under the specified node; false to clone only the node itself.</param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlProcessingInstruction.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlProcessingInstruction.xml
index 41885ba0980..c4757d0c724 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlProcessingInstruction.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlProcessingInstruction.xml
@@ -70,7 +70,6 @@
         <Parameter Name="deep" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>CloneNode serves as a copy constructor for nodes. For processing instruction nodes, the cloned node always includes the target and data. To see how this method behaves with other node types, see the <see cref="M:System.Xml.XmlNode.CloneNode(System.Boolean)" /> method in the XmlNode class.</para>
@@ -80,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplicate of this node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The duplicate node.</para>
+        </returns>
         <param name="deep">
           <attribution license="cc4" from="Microsoft" modified="false" />true to recursively clone the subtree under the specified node; false to clone only the node itself. </param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlQualifiedName.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlQualifiedName.xml
index 2351972e25e..004b7897d09 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlQualifiedName.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlQualifiedName.xml
@@ -137,12 +137,15 @@
         <Parameter Name="other" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Xml.XmlQualifiedName" /> object is equal to the current <see cref="T:System.Xml.XmlQualifiedName" /> object. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two are the same instance object; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlQualifiedName" /> to compare. </param>
       </Docs>
@@ -161,12 +164,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for the <see cref="T:System.Xml.XmlQualifiedName" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for this object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsEmpty">
@@ -249,12 +255,15 @@
         <Parameter Name="b" Type="System.Xml.XmlQualifiedName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Xml.XmlQualifiedName" /> objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two objects have the same name and namespace values; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlQualifiedName" /> to compare. </param>
         <param name="b">
@@ -278,12 +287,15 @@
         <Parameter Name="b" Type="System.Xml.XmlQualifiedName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Xml.XmlQualifiedName" /> objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the name and namespace values for the two objects differ; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlQualifiedName" /> to compare. </param>
         <param name="b">
@@ -304,12 +316,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the string value of the <see cref="T:System.Xml.XmlQualifiedName" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string value of the <see cref="T:System.Xml.XmlQualifiedName" /> in the format of namespace:localname. If the object does not have a namespace defined, this method returns just the local name.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -329,12 +344,15 @@
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the string value of the <see cref="T:System.Xml.XmlQualifiedName" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string value of the <see cref="T:System.Xml.XmlQualifiedName" /> in the format of namespace:localname. If the object does not have a namespace defined, this method returns just the local name.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the object. </param>
         <param name="ns">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlReader.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlReader.xml
index 2e3a682993f..cda5ad02be9 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlReader.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlReader.xml
@@ -496,7 +496,6 @@ equal to <see langword="false" />.</para>
         <Parameter Name="input" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -508,6 +507,10 @@ equal to <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.XmlReader" /> instance using the specified stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlReader" /> object used to read the data contained in the stream.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream containing the XML data.</param>
       </Docs>
@@ -527,7 +530,6 @@ equal to <see langword="false" />.</para>
         <Parameter Name="input" Type="System.IO.TextReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -539,6 +541,10 @@ equal to <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.XmlReader" /> instance with the specified <see cref="T:System.IO.TextReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlReader" /> object to read the XML data.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.TextReader" /> from which to read the XML data. Because a <see cref="T:System.IO.TextReader" /> returns a stream of Unicode characters, the encoding specified in the XML declaration is not used by the <see cref="T:System.Xml.XmlReader" /> to decode the data stream.</param>
       </Docs>
@@ -558,7 +564,6 @@ equal to <see langword="false" />.</para>
         <Parameter Name="inputUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -570,6 +575,10 @@ equal to <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.XmlReader" /> instance with specified URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlReader" /> object to read the XML data.</para>
+        </returns>
         <param name="inputUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI for the file containing the XML data. The <see cref="T:System.Xml.XmlUrlResolver" /> class is used to convert the path to a canonical data representation.</param>
       </Docs>
@@ -590,7 +599,6 @@ equal to <see langword="false" />.</para>
         <Parameter Name="settings" Type="System.Xml.XmlReaderSettings" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -607,6 +615,10 @@ equal to <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.XmlReader" /> instance with the specified stream and <see cref="T:System.Xml.XmlReaderSettings" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlReader" /> object to read the XML data.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream containing the XML data.</param>
         <param name="settings">
@@ -629,7 +641,6 @@ equal to <see langword="false" />.</para>
         <Parameter Name="settings" Type="System.Xml.XmlReaderSettings" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -646,6 +657,10 @@ equal to <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.XmlReader" /> instance using the specified <see cref="T:System.IO.TextReader" /> and <see cref="T:System.Xml.XmlReaderSettings" /> objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlReader" /> object to read XML data.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.TextReader" /> from which to read the XML data. Because a <see cref="T:System.IO.TextReader" /> returns a stream of Unicode characters, the encoding specified in the XML declaration is not used by the <see cref="T:System.Xml.XmlReader" /> to decode the data stream</param>
         <param name="settings">
@@ -668,7 +683,6 @@ equal to <see langword="false" />.</para>
         <Parameter Name="settings" Type="System.Xml.XmlReaderSettings" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -682,6 +696,10 @@ equal to <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance with the specified URI and <see cref="T:System.Xml.XmlReaderSettings" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlReader" /> object to read XML data.</para>
+        </returns>
         <param name="inputUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI for the file containing the XML data. The <see cref="T:System.Xml.XmlResolver" /> object on the <see cref="T:System.Xml.XmlReaderSettings" /> object is used to convert the path to a canonical data representation. If <see cref="P:System.Xml.XmlReaderSettings.XmlResolver" /> is null, a new <see cref="T:System.Xml.XmlUrlResolver" /> object is used.</param>
         <param name="settings">
@@ -704,7 +722,6 @@ equal to <see langword="false" />.</para>
         <Parameter Name="settings" Type="System.Xml.XmlReaderSettings" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -727,6 +744,10 @@ equal to <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.XmlReader" /> instance with the specified <see cref="T:System.Xml.XmlReader" /> and <see cref="T:System.Xml.XmlReaderSettings" /> objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlReader" /> object that is wrapped around the specified <see cref="T:System.Xml.XmlReader" /> object.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> object that you wish to use as the underlying reader.</param>
         <param name="settings">
@@ -750,7 +771,6 @@ equal to <see langword="false" />.</para>
         <Parameter Name="baseUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -767,6 +787,10 @@ equal to <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.XmlReader" /> instance using the specified stream, base URI, and <see cref="T:System.Xml.XmlReaderSettings" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlReader" /> object to read XML data.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream containing the XML data. </param>
         <param name="settings">
@@ -792,7 +816,6 @@ equal to <see langword="false" />.</para>
         <Parameter Name="inputContext" Type="System.Xml.XmlParserContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -809,6 +832,10 @@ equal to <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.XmlReader" /> instance using the specified stream, <see cref="T:System.Xml.XmlReaderSettings" />, and <see cref="T:System.Xml.XmlParserContext" /> objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlReader" /> object to read XML data.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream containing the XML data. </param>
         <param name="settings">
@@ -834,7 +861,6 @@ equal to <see langword="false" />.</para>
         <Parameter Name="baseUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -851,6 +877,10 @@ equal to <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.XmlReader" /> instance using the specified <see cref="T:System.IO.TextReader" />, <see cref="T:System.Xml.XmlReaderSettings" />, and base URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlReader" /> object to read XML data.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.TextReader" /> from which to read the XML data. Because a <see cref="T:System.IO.TextReader" /> returns a stream of Unicode characters, the encoding specified in the XML declaration is not used by the <see cref="T:System.Xml.XmlReader" /> to decode the data stream.</param>
         <param name="settings">
@@ -876,7 +906,6 @@ equal to <see langword="false" />.</para>
         <Parameter Name="inputContext" Type="System.Xml.XmlParserContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -893,6 +922,10 @@ equal to <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.XmlReader" /> instance using the specified <see cref="T:System.IO.TextReader" />, <see cref="T:System.Xml.XmlReaderSettings" />, and <see cref="T:System.Xml.XmlParserContext" /> objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlReader" /> object to read XML data.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.TextReader" /> from which to read the XML data. Because a <see cref="T:System.IO.TextReader" /> returns a stream of Unicode characters, the encoding specified in the XML declaration is not used by the <see cref="T:System.Xml.XmlReader" /> to decode the data stream.</param>
         <param name="settings">
@@ -918,7 +951,6 @@ equal to <see langword="false" />.</para>
         <Parameter Name="inputContext" Type="System.Xml.XmlParserContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -932,6 +964,10 @@ equal to <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.XmlReader" /> instance using the specified URI, <see cref="T:System.Xml.XmlReaderSettings" />, and <see cref="T:System.Xml.XmlParserContext" /> objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlReader" /> object to read XML data.</para>
+        </returns>
         <param name="inputUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI for the file containing the XML data. The <see cref="T:System.Xml.XmlResolver" /> object on the <see cref="T:System.Xml.XmlReaderSettings" /> object is used to convert the path to a canonical data representation. If <see cref="P:System.Xml.XmlReaderSettings.XmlResolver" /> is null, a new <see cref="T:System.Xml.XmlUrlResolver" /> object is used.</param>
         <param name="settings">
@@ -1079,10 +1115,6 @@ containing the depth of the current node in the XML document. </para>
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" qualify="true" />
-containing the value of the specified attribute.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="behaviors"> This method does not move the
@@ -1103,6 +1135,10 @@ containing the value of the specified attribute.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, gets the value of the attribute with the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified attribute. This method does not move the reader.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the attribute. The index is zero-based. (The first attribute has index 0.)</param>
       </Docs>
@@ -1125,11 +1161,6 @@ containing the value of the specified attribute.</para>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" qualify="true" />
-containing the value of the specified attribute, or <see langword="null" /> if the
-attribute is not found.</para>
-        </returns>
         <example>
           <para>For an example demonstrating this method, see <see cref="M:System.Xml.XmlTextReader.GetAttribute(System.Int32)" />(<see cref="T:System.String" />, <see cref="T:System.String" />).</para>
         </example>
@@ -1142,6 +1173,10 @@ attribute is not found.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, gets the value of the attribute with the specified <see cref="P:System.Xml.XmlReader.Name" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified attribute. If the attribute is not found or the value is String.Empty, null is returned.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The qualified name of the attribute.</param>
       </Docs>
@@ -1165,11 +1200,6 @@ attribute is not found.</para>
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" qualify="true" />
-containing the value of the specified attribute, or <see langword="null" /> if the
-attribute is not found.</para>
-        </returns>
         <example>
           <para>For an example demonstrating this method, see <see cref="M:System.Xml.XmlTextReader.GetAttribute(System.Int32)" />(<see cref="T:System.String" />, <see cref="T:System.String" />).</para>
         </example>
@@ -1189,6 +1219,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, gets the value of the attribute with the specified <see cref="P:System.Xml.XmlReader.LocalName" /> and <see cref="P:System.Xml.XmlReader.NamespaceURI" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified attribute. If the attribute is not found or the value is String.Empty, null is returned. This method does not move the reader.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the attribute.</param>
         <param name="namespaceURI">
@@ -1208,7 +1242,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To use this method, you must set the <see cref="P:System.Xml.XmlReaderSettings.Async" /> flag to true.</para>
@@ -1217,6 +1250,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously gets the value of the current node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current node.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HasAttributes">
@@ -1469,10 +1506,6 @@ explicitly set. </para>
         <Parameter Name="str" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" /> where <see langword="true" /> indicates the name
-   is valid; otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses the <see cref="http://go.microsoft.com/fwlink/?LinkId=49863">W3C XML 1.0 Recommendation</see> to determine whether the name is valid.</para>
@@ -1481,6 +1514,10 @@ explicitly set. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the string argument is a valid XML name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the name is valid; otherwise, false.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The name to validate.</param>
       </Docs>
@@ -1503,10 +1540,6 @@ explicitly set. </para>
         <Parameter Name="str" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" /> where <see langword="true" /> indicates
-   the name is valid; otherwise <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses the <see cref="http://go.microsoft.com/fwlink/?LinkId=49863">W3C XML 1.0 Recommendation</see> to determine whether the name token is valid.</para>
@@ -1515,6 +1548,10 @@ explicitly set. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether or not the string argument is a valid XML name token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if it is a valid name token; otherwise false.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The name token to validate.</param>
       </Docs>
@@ -1535,12 +1572,6 @@ explicitly set. </para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" /> where <see langword="true" /> indicates the node is an
-<see langword="Element" /> 
-node; <see langword="false" />
-otherwise.</para>
-        </returns>
         <exception cref="T:System.Xml.XmlException">An error occurred while parsing the XML.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1550,6 +1581,10 @@ otherwise.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calls <see cref="M:System.Xml.XmlReader.MoveToContent" /> and tests if the current content node is a start tag or empty element tag.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <see cref="M:System.Xml.XmlReader.MoveToContent" /> finds a start tag or empty element tag; false if a node type other than XmlNodeType.Element was found.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1570,12 +1605,6 @@ otherwise.</para>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" />
-where <see langword="true" /> indicates the node is an
-<see langword="Element" /> node with the specified name; <see langword="false" /> 
-otherwise.</para>
-        </returns>
         <exception cref="T:System.Xml.XmlException">An error occurred while parsing the XML.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1585,6 +1614,10 @@ otherwise.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calls <see cref="M:System.Xml.XmlReader.MoveToContent" /> and tests if the current content node is a start tag or empty element tag and if the <see cref="P:System.Xml.XmlReader.Name" /> property of the element found matches the given argument.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the resulting node is an element and the Name property matches the specified string. false if a node type other than XmlNodeType.Element was found or if the element Name property does not match the specified string.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string matched against the Name property of the element found.</param>
       </Docs>
@@ -1608,12 +1641,6 @@ otherwise.</para>
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" /> where <see langword="true" /> indicates the node
-   is an <see langword="Element" /> node with the specified local name and namespace
-   URI; <see langword="false" />
-   otherwise.</para>
-        </returns>
         <exception cref="T:System.Xml.XmlException">An error occurred while parsing the XML.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1623,6 +1650,10 @@ otherwise.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calls <see cref="M:System.Xml.XmlReader.MoveToContent" /> and tests if the current content node is a start tag or empty element tag and if the <see cref="P:System.Xml.XmlReader.LocalName" /> and <see cref="P:System.Xml.XmlReader.NamespaceURI" /> properties of the element found match the given strings.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the resulting node is an element. false if a node type other than XmlNodeType.Element was found or if the LocalName and NamespaceURI properties of the element do not match the specified strings.</para>
+        </returns>
         <param name="localname">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to match against the LocalName property of the element found.</param>
         <param name="ns">
@@ -1810,10 +1841,6 @@ have a name (like <see langword="Text" />, <see langword="Comment" /> , and so o
         <Parameter Name="prefix" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.String" qualify="true" /> containing the
-   namespace URI to which the prefix maps. If <paramref name="prefix" /> is not in <see cref="P:System.Xml.XmlReader.NameTable" /> or no matching namespace is found, <see langword="null" /> is returned.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In the following XML string, if the reader is positioned on the href attribute, the prefix a is resolved by calling reader.LookupNamespace("a"). The returned string is urn:456.</para>
@@ -1827,6 +1854,10 @@ have a name (like <see langword="Text" />, <see langword="Comment" /> , and so o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, resolves a namespace prefix in the current element's scope.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The namespace URI to which the prefix maps or null if no matching prefix is found.</para>
+        </returns>
         <param name="prefix">
           <attribution license="cc4" from="Microsoft" modified="false" />The prefix whose namespace URI you want to resolve. To match the default namespace, pass an empty string. </param>
       </Docs>
@@ -1889,12 +1920,6 @@ have a name (like <see langword="Text" />, <see langword="Comment" /> , and so o
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" />
-where <see langword="true" /> indicates the attribute was found; otherwise,
-<see langword="false" />. If <see langword="false" />, the reader's position does 
-not change.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>After calling MoveToAttribute, the <see cref="P:System.Xml.XmlReader.Name" />, <see cref="P:System.Xml.XmlReader.NamespaceURI" />, and <see cref="P:System.Xml.XmlReader.Prefix" /> properties reflect the properties of that attribute.</para>
@@ -1903,6 +1928,10 @@ not change.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, moves to the attribute with the specified <see cref="P:System.Xml.XmlReader.Name" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute is found; otherwise, false. If false, the reader's position does not change.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The qualified name of the attribute.</param>
       </Docs>
@@ -1926,12 +1955,6 @@ not change.</para>
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" />
-where <see langword="true" /> indicates the attribute was found; otherwise,
-<see langword="false" />. If <see langword="false" />, the position of the current 
-instance does not change.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>After calling MoveToAttribute, the <see cref="P:System.Xml.XmlReader.Name" />, <see cref="P:System.Xml.XmlReader.NamespaceURI" />, and <see cref="P:System.Xml.XmlReader.Prefix" /> properties reflect the properties of that attribute.</para>
@@ -1940,6 +1963,10 @@ instance does not change.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, moves to the attribute with the specified <see cref="P:System.Xml.XmlReader.LocalName" /> and <see cref="P:System.Xml.XmlReader.NamespaceURI" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute is found; otherwise, false. If false, the reader's position does not change.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the attribute.</param>
         <param name="ns">
@@ -1962,12 +1989,6 @@ instance does not change.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> The <see cref="T:System.Xml.XmlNodeType" /><see langword=" " />of the content
-   node, or <see cref="F:System.Xml.XmlNodeType.None" /> if the
-   position
-   of the reader has reached the end of the input stream.</para>
-        </returns>
         <exception cref="T:System.Xml.XmlException">An error occurred while parsing the XML.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1978,6 +1999,10 @@ instance does not change.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks whether the current node is a content (non-white space text, CDATA, Element, EndElement, EntityReference, or EndEntity) node. If the node is not a content node, the reader skips ahead to the next content node or end of file. It skips over nodes of the following type: ProcessingInstruction, DocumentType, Comment, Whitespace, or SignificantWhitespace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="P:System.Xml.XmlReader.NodeType" /> of the current node found by the method or XmlNodeType.None if the reader has reached the end of the input stream.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1993,7 +2018,6 @@ instance does not change.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlReader.MoveToContent" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlReaderSettings.Async" /> flag to true.</para>
@@ -2002,6 +2026,10 @@ instance does not change.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously checks whether the current node is a content node. If the node is not a content node, the reader skips ahead to the next content node or end of file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="P:System.Xml.XmlReader.NodeType" /> of the current node found by the method or XmlNodeType.None if the reader has reached the end of the input stream.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MoveToElement">
@@ -2019,11 +2047,6 @@ instance does not change.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" /> where <see langword="true" /> indicates the position of the reader was moved; <see langword="false" /> indicates the reader was not positioned on an <see langword="Attribute" /> node and
-   therefore the position of the reader was not
-   moved.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to return to an element after navigating through its attributes. This method moves the reader to one of the following node types: Element, DocumentType, or XmlDeclaration.</para>
@@ -2032,6 +2055,10 @@ instance does not change.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, moves to the element that contains the current attribute node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the reader is positioned on an attribute (the reader moves to the element that owns the attribute); false if the reader is not positioned on an attribute (the position of the reader does not change).</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -2050,11 +2077,6 @@ instance does not change.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" />
-where <see langword="true" /> indicates the current node contains at least one attribute; otherwise,
-<see langword="false" />.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="behaviors"> If <see cref="P:System.Xml.XmlReader.AttributeCount" /> is non-zero,
@@ -2072,6 +2094,10 @@ where <see langword="true" /> indicates the current node contains at least one a
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, moves to the first attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if an attribute exists (the reader moves to the first attribute); otherwise, false (the position of the reader does not change).</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -2090,9 +2116,6 @@ where <see langword="true" /> indicates the current node contains at least one a
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" /> where <see langword="true" /> indicates the position of the reader moved to the next attribute; <see langword="false" /> if there were no more attributes.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the current node is an element node, this method is equivalent to <see cref="M:System.Xml.XmlReader.MoveToFirstAttribute" />. If MoveToNextAttribute returns true, the reader moves to the next attribute; otherwise, the position of the reader does not change.</para>
@@ -2101,6 +2124,10 @@ where <see langword="true" /> indicates the current node contains at least one a
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, moves to the next attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there is a next attribute; false if there are no more attributes.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -2388,11 +2415,6 @@ containing the namespace prefix associated with the current node. </para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" />
-where <see langword="true" /> indicates the node was read successfully, and
-<see langword="false" /> indicates there were no more nodes to read.</para>
-        </returns>
         <exception cref="T:System.Xml.XmlException">An error occurred while parsing the XML.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2404,6 +2426,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, reads the next node from the stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the next node was read successfully; false if there are no more nodes to read.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -2419,7 +2445,6 @@ where <see langword="true" /> indicates the node was read successfully, and
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlReader.Read" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlReaderSettings.Async" /> flag to true.</para>
@@ -2428,6 +2453,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously reads the next node from the stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the next node was read successfully; false if there are no more nodes to read.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadAttributeValue">
@@ -2445,12 +2474,6 @@ where <see langword="true" /> indicates the node was read successfully, and
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" /> where <see langword="true" /> indicates the attribute value was parsed, and
-<see langword="false" /> indicates the reader was not 
-   positioned on an attribute node or all the attribute values have been read.</para>
-          <see langword="" />
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method after calling <see cref="M:System.Xml.XmlReader.MoveToAttribute(System.String)" /> to read through the text or entity reference nodes that make up the attribute value. The <see cref="P:System.Xml.XmlReader.Depth" /> of the attribute value nodes is one plus the depth of the attribute node; it increments and decrements by one when you step into and out of general entity references.</para>
@@ -2459,6 +2482,12 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, parses the attribute value into one or more Text, EntityReference, or EndEntity nodes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there are nodes to return.</para>
+          <para>false if the reader is not positioned on an attribute node when the initial call is made or if all the attribute values have been read.</para>
+          <para>An empty attribute, such as, misc="", returns true with a single node with a value of String.Empty.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -2478,7 +2507,6 @@ where <see langword="true" /> indicates the node was read successfully, and
         <Parameter Name="namespaceResolver" Type="System.Xml.IXmlNamespaceResolver" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2583,6 +2611,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the content as an object of the type specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The concatenated text content or attribute value converted to the requested type.</para>
+        </returns>
         <param name="returnType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the value to be returned.</param>
         <param name="namespaceResolver">
@@ -2604,7 +2636,6 @@ where <see langword="true" /> indicates the node was read successfully, and
         <Parameter Name="namespaceResolver" Type="System.Xml.IXmlNamespaceResolver" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlReader.ReadContentAs(System.Type,System.Xml.IXmlNamespaceResolver)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlReaderSettings.Async" /> flag to true.</para>
@@ -2613,6 +2644,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously reads the content as an object of the type specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The concatenated text content or attribute value converted to the requested type.</para>
+        </returns>
         <param name="returnType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the value to be returned.</param>
         <param name="namespaceResolver">
@@ -2636,7 +2671,6 @@ where <see langword="true" /> indicates the node was read successfully, and
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2664,6 +2698,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the content and returns the Base64 decoded binary bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes written to the buffer.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer into which to copy the resulting text. This value cannot be null.</param>
         <param name="index">
@@ -2688,7 +2726,6 @@ where <see langword="true" /> indicates the node was read successfully, and
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlReader.ReadContentAsBase64(System.Byte[],System.Int32,System.Int32)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlReaderSettings.Async" /> flag to true.</para>
@@ -2697,6 +2734,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously reads the content and returns the Base64 decoded binary bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes written to the buffer.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer into which to copy the resulting text. This value cannot be null.</param>
         <param name="index">
@@ -2722,7 +2763,6 @@ where <see langword="true" /> indicates the node was read successfully, and
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2750,6 +2790,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the content and returns the BinHex decoded binary bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes written to the buffer.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer into which to copy the resulting text. This value cannot be null.</param>
         <param name="index">
@@ -2774,7 +2818,6 @@ where <see langword="true" /> indicates the node was read successfully, and
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlReader.ReadContentAsBinHex(System.Byte[],System.Int32,System.Int32)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlReaderSettings.Async" /> flag to true.</para>
@@ -2783,6 +2826,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously reads the content and returns the BinHex decoded binary bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes written to the buffer.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer into which to copy the resulting text. This value cannot be null.</param>
         <param name="index">
@@ -2804,7 +2851,6 @@ where <see langword="true" /> indicates the node was read successfully, and
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2900,6 +2946,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the text content at the current position as a Boolean.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The text content as a <see cref="T:System.Boolean" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadContentAsDateTime">
@@ -2915,7 +2965,6 @@ where <see langword="true" /> indicates the node was read successfully, and
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3014,6 +3063,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the text content at the current position as a <see cref="T:System.DateTime" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The text content as a <see cref="T:System.DateTime" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadContentAsDateTimeOffset">
@@ -3028,12 +3081,15 @@ where <see langword="true" /> indicates the node was read successfully, and
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the text content at the current position as a <see cref="T:System.DateTimeOffset" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The text content as a <see cref="T:System.DateTimeOffset" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadContentAsDecimal">
@@ -3049,7 +3105,6 @@ where <see langword="true" /> indicates the node was read successfully, and
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3145,6 +3200,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the text content at the current position as a <see cref="T:System.Decimal" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The text content at the current position as a <see cref="T:System.Decimal" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadContentAsDouble">
@@ -3160,7 +3219,6 @@ where <see langword="true" /> indicates the node was read successfully, and
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3256,6 +3314,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the text content at the current position as a double-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The text content as a double-precision floating-point number.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadContentAsFloat">
@@ -3271,7 +3333,6 @@ where <see langword="true" /> indicates the node was read successfully, and
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3367,6 +3428,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the text content at the current position as a single-precision floating point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The text content at the current position as a single-precision floating point number.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadContentAsInt">
@@ -3382,7 +3447,6 @@ where <see langword="true" /> indicates the node was read successfully, and
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3478,6 +3542,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the text content at the current position as a 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The text content as a 32-bit signed integer.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadContentAsLong">
@@ -3493,7 +3561,6 @@ where <see langword="true" /> indicates the node was read successfully, and
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3589,6 +3656,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the text content at the current position as a 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The text content as a 64-bit signed integer.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadContentAsObject">
@@ -3604,7 +3675,6 @@ where <see langword="true" /> indicates the node was read successfully, and
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3705,6 +3775,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the text content at the current position as an <see cref="T:System.Object" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The text content as the most appropriate common language runtime (CLR) object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadContentAsObjectAsync">
@@ -3719,7 +3793,6 @@ where <see langword="true" /> indicates the node was read successfully, and
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlReader.ReadContentAsObject" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlReaderSettings.Async" /> flag to true.</para>
@@ -3728,6 +3801,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously reads the text content at the current position as an <see cref="T:System.Object" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The text content as the most appropriate common language runtime (CLR) object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadContentAsString">
@@ -3743,7 +3820,6 @@ where <see langword="true" /> indicates the node was read successfully, and
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3840,6 +3916,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the text content at the current position as a <see cref="T:System.String" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The text content as a <see cref="T:System.String" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadContentAsStringAsync">
@@ -3854,7 +3934,6 @@ where <see langword="true" /> indicates the node was read successfully, and
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlReader.ReadContentAsString" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlReaderSettings.Async" /> flag to true.</para>
@@ -3863,6 +3942,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously reads the text content at the current position as a <see cref="T:System.String" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The text content as a <see cref="T:System.String" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadElementContentAs">
@@ -3881,7 +3964,6 @@ where <see langword="true" /> indicates the node was read successfully, and
         <Parameter Name="namespaceResolver" Type="System.Xml.IXmlNamespaceResolver" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3893,6 +3975,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the element content as the requested type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The element content converted to the requested typed object.</para>
+        </returns>
         <param name="returnType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the value to be returned.</param>
         <param name="namespaceResolver">
@@ -3917,7 +4003,6 @@ where <see langword="true" /> indicates the node was read successfully, and
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3928,6 +4013,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks that the specified local name and namespace URI matches that of the current element, then reads the element content as the requested type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The element content converted to the requested typed object.</para>
+        </returns>
         <param name="returnType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the value to be returned.</param>
         <param name="namespaceResolver">
@@ -3953,7 +4042,6 @@ where <see langword="true" /> indicates the node was read successfully, and
         <Parameter Name="namespaceResolver" Type="System.Xml.IXmlNamespaceResolver" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlReader.ReadElementContentAs(System.Type,System.Xml.IXmlNamespaceResolver)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlReaderSettings.Async" /> flag to true.</para>
@@ -3962,6 +4050,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously reads the element content as the requested type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The element content converted to the requested typed object.</para>
+        </returns>
         <param name="returnType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the value to be returned.</param>
         <param name="namespaceResolver">
@@ -3985,7 +4077,6 @@ where <see langword="true" /> indicates the node was read successfully, and
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4001,6 +4092,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the element and decodes the Base64 content.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes written to the buffer.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer into which to copy the resulting text. This value cannot be null.</param>
         <param name="index">
@@ -4025,7 +4120,6 @@ where <see langword="true" /> indicates the node was read successfully, and
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlReader.ReadElementContentAsBase64(System.Byte[],System.Int32,System.Int32)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlReaderSettings.Async" /> flag to true.</para>
@@ -4034,6 +4128,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously reads the element and decodes the Base64 content.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes written to the buffer.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer into which to copy the resulting text. This value cannot be null.</param>
         <param name="index">
@@ -4059,7 +4157,6 @@ where <see langword="true" /> indicates the node was read successfully, and
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4074,6 +4171,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the element and decodes the BinHex content.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes written to the buffer.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer into which to copy the resulting text. This value cannot be null.</param>
         <param name="index">
@@ -4098,7 +4199,6 @@ where <see langword="true" /> indicates the node was read successfully, and
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlReader.ReadElementContentAsBinHex(System.Byte[],System.Int32,System.Int32)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlReaderSettings.Async" /> flag to true.</para>
@@ -4107,6 +4207,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously reads the element and decodes the BinHex content.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes written to the buffer.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer into which to copy the resulting text. This value cannot be null.</param>
         <param name="index">
@@ -4128,7 +4232,6 @@ where <see langword="true" /> indicates the node was read successfully, and
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4140,6 +4243,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the current element and returns the contents as a <see cref="T:System.Boolean" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The element content as a <see cref="T:System.Boolean" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadElementContentAsBoolean">
@@ -4158,7 +4265,6 @@ where <see langword="true" /> indicates the node was read successfully, and
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4170,6 +4276,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a <see cref="T:System.Boolean" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The element content as a <see cref="T:System.Boolean" /> object.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceURI">
@@ -4189,7 +4299,6 @@ where <see langword="true" /> indicates the node was read successfully, and
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4204,6 +4313,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the current element and returns the contents as a <see cref="T:System.DateTime" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The element content as a <see cref="T:System.DateTime" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadElementContentAsDateTime">
@@ -4222,7 +4335,6 @@ where <see langword="true" /> indicates the node was read successfully, and
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4237,6 +4349,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a <see cref="T:System.DateTime" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The element contents as a <see cref="T:System.DateTime" /> object.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceURI">
@@ -4256,7 +4372,6 @@ where <see langword="true" /> indicates the node was read successfully, and
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4268,6 +4383,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the current element and returns the contents as a <see cref="T:System.Decimal" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The element content as a <see cref="T:System.Decimal" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadElementContentAsDecimal">
@@ -4286,7 +4405,6 @@ where <see langword="true" /> indicates the node was read successfully, and
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4298,6 +4416,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a <see cref="T:System.Decimal" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The element content as a <see cref="T:System.Decimal" /> object.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceURI">
@@ -4317,7 +4439,6 @@ where <see langword="true" /> indicates the node was read successfully, and
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4329,6 +4450,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the current element and returns the contents as a double-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The element content as a double-precision floating-point number.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadElementContentAsDouble">
@@ -4347,7 +4472,6 @@ where <see langword="true" /> indicates the node was read successfully, and
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4359,6 +4483,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a double-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The element content as a double-precision floating-point number.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceURI">
@@ -4378,7 +4506,6 @@ where <see langword="true" /> indicates the node was read successfully, and
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4390,6 +4517,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the current element and returns the contents as single-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The element content as a single-precision floating point number.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadElementContentAsFloat">
@@ -4408,7 +4539,6 @@ where <see langword="true" /> indicates the node was read successfully, and
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4420,6 +4550,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a single-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The element content as a single-precision floating point number.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceURI">
@@ -4439,7 +4573,6 @@ where <see langword="true" /> indicates the node was read successfully, and
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4451,6 +4584,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the current element and returns the contents as a 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The element content as a 32-bit signed integer.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadElementContentAsInt">
@@ -4469,7 +4606,6 @@ where <see langword="true" /> indicates the node was read successfully, and
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4481,6 +4617,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The element content as a 32-bit signed integer.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceURI">
@@ -4500,7 +4640,6 @@ where <see langword="true" /> indicates the node was read successfully, and
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4512,6 +4651,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the current element and returns the contents as a 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The element content as a 64-bit signed integer.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadElementContentAsLong">
@@ -4530,7 +4673,6 @@ where <see langword="true" /> indicates the node was read successfully, and
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4542,6 +4684,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The element content as a 64-bit signed integer.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceURI">
@@ -4561,7 +4707,6 @@ where <see langword="true" /> indicates the node was read successfully, and
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4573,6 +4718,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the current element and returns the contents as an <see cref="T:System.Object" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A boxed common language runtime (CLR) object of the most appropriate type. The <see cref="P:System.Xml.XmlReader.ValueType" /> property determines the appropriate CLR type. If the content is typed as a list type, this method returns an array of boxed objects of the appropriate type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadElementContentAsObject">
@@ -4591,7 +4740,6 @@ where <see langword="true" /> indicates the node was read successfully, and
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4602,6 +4750,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as an <see cref="T:System.Object" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A boxed common language runtime (CLR) object of the most appropriate type. The <see cref="P:System.Xml.XmlReader.ValueType" /> property determines the appropriate CLR type. If the content is typed as a list type, this method returns an array of boxed objects of the appropriate type.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceURI">
@@ -4620,7 +4772,6 @@ where <see langword="true" /> indicates the node was read successfully, and
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlReader.ReadElementContentAsObject" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlReaderSettings.Async" /> flag to true.</para>
@@ -4629,6 +4780,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously reads the current element and returns the contents as an <see cref="T:System.Object" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A boxed common language runtime (CLR) object of the most appropriate type. The <see cref="P:System.Xml.XmlReader.ValueType" /> property determines the appropriate CLR type. If the content is typed as a list type, this method returns an array of boxed objects of the appropriate type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadElementContentAsString">
@@ -4644,7 +4799,6 @@ where <see langword="true" /> indicates the node was read successfully, and
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4656,6 +4810,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the current element and returns the contents as a <see cref="T:System.String" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The element content as a <see cref="T:System.String" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadElementContentAsString">
@@ -4674,7 +4832,6 @@ where <see langword="true" /> indicates the node was read successfully, and
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4685,6 +4842,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a <see cref="T:System.String" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The element content as a <see cref="T:System.String" /> object.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceURI">
@@ -4703,7 +4864,6 @@ where <see langword="true" /> indicates the node was read successfully, and
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlReader.ReadElementContentAsString" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlReaderSettings.Async" /> flag to true.</para>
@@ -4712,6 +4872,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously reads the current element and returns the contents as a <see cref="T:System.String" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The element content as a <see cref="T:System.String" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadElementString">
@@ -4729,9 +4893,6 @@ where <see langword="true" /> indicates the node was read successfully, and
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.String" qualify="true" /> containing the contents of the element.</para>
-        </returns>
         <exception cref="T:System.Xml.XmlException">The node is not an <see langword="Element" /> node, the element does not contain a simple text value, or an error occurred while parsing the XML.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4744,6 +4905,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a text-only element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The text contained in the element that was read. An empty string if the element is empty (&lt;item&gt;&lt;/item&gt; or &lt;item/&gt;).</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -4764,9 +4929,6 @@ where <see langword="true" /> indicates the node was read successfully, and
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" qualify="true" /> containing the contents of the element.</para>
-        </returns>
         <exception cref="T:System.Xml.XmlException">The node is not an <see langword="Element" /> node, the <see cref="P:System.Xml.XmlReader.Name" /> property of the <see langword="Element" /> node does not equal <paramref name="name" />, the element does not contain a simple text value, or an error occurred while parsing the XML.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4779,6 +4941,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks that the <see cref="P:System.Xml.XmlReader.Name" /> property of the element found matches the given string before reading a text-only element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The text contained in the element that was read. An empty string if the element is empty (&lt;item&gt;&lt;/item&gt; or &lt;item/&gt;).</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name to check.</param>
       </Docs>
@@ -4802,9 +4968,6 @@ where <see langword="true" /> indicates the node was read successfully, and
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" qualify="true" /> containing the contents of the element.</para>
-        </returns>
         <exception cref="T:System.Xml.XmlException">The node is not an <see langword="Element" /> node, the <see cref="P:System.Xml.XmlReader.LocalName" /> property of the <see langword="Element" /> node does not equal <paramref name="localname" />, or the <see cref="P:System.Xml.XmlReader.NamespaceURI" /> property of the <see langword="Element" /> node does not equal <paramref name="ns" />, the element does not contain a simple text value, or an error occurred while parsing the XML.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4817,6 +4980,10 @@ where <see langword="true" /> indicates the node was read successfully, and
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks that the <see cref="P:System.Xml.XmlReader.LocalName" /> and <see cref="P:System.Xml.XmlReader.NamespaceURI" /> properties of the element found matches the given strings before reading a text-only element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The text contained in the element that was read. An empty string if the element is empty (&lt;item&gt;&lt;/item&gt; or &lt;item/&gt;).</para>
+        </returns>
         <param name="localname">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name to check.</param>
         <param name="ns">
@@ -4888,11 +5055,6 @@ where <see langword="true" /> indicates the node was read successfully, and
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" qualify="true" />
-containing the XML content, or <see cref="F:System.String.Empty" qualify="true" /> if the current node is neither an element nor
-attribute, or has no child nodes.</para>
-        </returns>
         <exception cref="T:System.Xml.XmlException">The XML was not well-formed, or an error occurred while parsing the XML.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4966,6 +5128,11 @@ attribute, or has no child nodes.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, reads all the content, including markup, as a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>All the XML content, including markup, in the current node. If the current node has no children, an empty string is returned.</para>
+          <para>If the current node is neither an element nor attribute, an empty string is returned.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -4981,7 +5148,6 @@ attribute, or has no child nodes.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlReader.ReadInnerXml" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlReaderSettings.Async" /> flag to true.</para>
@@ -4990,6 +5156,10 @@ attribute, or has no child nodes.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously reads all the content, including markup, as a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>All the XML content, including markup, in the current node. If the current node has no children, an empty string is returned.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadOuterXml">
@@ -5007,11 +5177,6 @@ attribute, or has no child nodes.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" qualify="true" />
-containing the XML content, or <see cref="F:System.String.Empty" qualify="true" /> if the current node is neither an element nor
-attribute.</para>
-        </returns>
         <exception cref="T:System.Xml.XmlException">The XML was not well-formed, or an error occurred while parsing the XML.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -5081,6 +5246,10 @@ attribute.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, reads the content, including markup, representing this node and all its children.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If the reader is positioned on an element or an attribute node, this method returns all the XML content, including markup, of the current node and all its children; otherwise, it returns an empty string.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -5096,7 +5265,6 @@ attribute.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlReader.ReadOuterXml" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlReaderSettings.Async" /> flag to true.</para>
@@ -5105,6 +5273,10 @@ attribute.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously reads the content, including markup, representing this node and all its children.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If the reader is positioned on an element or an attribute node, this method returns all the XML content, including markup, of the current node and all its children; otherwise, it returns an empty string.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadStartElement">
@@ -5253,12 +5425,6 @@ attribute.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" qualify="true" />
-containing the contents of the <see langword="Element" /> or <see langword="Text" />
-node, or <see cref="F:System.String.Empty" qualify="true" /> if the reader is positioned on any other type of
-node.</para>
-        </returns>
         <exception cref="T:System.Xml.XmlException">An error occurred while parsing the XML.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -5272,6 +5438,10 @@ node.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, reads the contents of an element or text node as a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The contents of the element or an empty string.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -5288,7 +5458,6 @@ node.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -5303,6 +5472,10 @@ node.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new XmlReader instance that can be used to read the current node, and all its descendants.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new XmlReader instance set to ReadState.Initial. A call to the <see cref="M:System.Xml.XmlReader.Read" /> method positions the new XmlReader on the node that was current before the call to ReadSubtree method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadToDescendant">
@@ -5320,13 +5493,17 @@ node.</para>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the <see cref="T:System.Xml.XmlReader" /> to the next descendant element with the specified qualified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a matching descendant element is found; otherwise false. If a matching child element is not found, the <see cref="T:System.Xml.XmlReader" /> is positioned on the end tag (<see cref="P:System.Xml.XmlReader.NodeType" /> is XmlNodeType.EndElement) of the element.</para>
+          <para>If the <see cref="T:System.Xml.XmlReader" /> is not positioned on an element when <see cref="M:System.Xml.XmlReader.ReadToDescendant(System.String)" /> was called, this method returns false and the position of the <see cref="T:System.Xml.XmlReader" /> is not changed.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The qualified name of the element you wish to move to.</param>
       </Docs>
@@ -5347,13 +5524,17 @@ node.</para>
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the <see cref="T:System.Xml.XmlReader" /> to the next descendant element with the specified local name and namespace URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a matching descendant element is found; otherwise false. If a matching child element is not found, the <see cref="T:System.Xml.XmlReader" /> is positioned on the end tag (<see cref="P:System.Xml.XmlReader.NodeType" /> is XmlNodeType.EndElement) of the element.</para>
+          <para>If the <see cref="T:System.Xml.XmlReader" /> is not positioned on an element when <see cref="M:System.Xml.XmlReader.ReadToDescendant(System.String,System.String)" /> was called, this method returns false and the position of the <see cref="T:System.Xml.XmlReader" /> is not changed.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element you wish to move to.</param>
         <param name="namespaceURI">
@@ -5375,7 +5556,6 @@ node.</para>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -5397,6 +5577,10 @@ reader.ReadToFollowing("item");
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads until an element with the specified qualified name is found.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a matching element is found; otherwise false and the <see cref="T:System.Xml.XmlReader" /> is in an end of file state.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The qualified name of the element.</param>
       </Docs>
@@ -5417,7 +5601,6 @@ reader.ReadToFollowing("item");
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -5439,6 +5622,10 @@ reader.ReadToFollowing("item", "urn:1");
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads until an element with the specified local name and namespace URI is found.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a matching element is found; otherwise false and the <see cref="T:System.Xml.XmlReader" /> is in an end of file state.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the element.</param>
         <param name="namespaceURI">
@@ -5460,7 +5647,6 @@ reader.ReadToFollowing("item", "urn:1");
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -5472,6 +5658,10 @@ reader.ReadToFollowing("item", "urn:1");
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the XmlReader to the next sibling element with the specified qualified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a matching sibling element is found; otherwise false. If a matching sibling element is not found, the XmlReader is positioned on the end tag (<see cref="P:System.Xml.XmlReader.NodeType" /> is XmlNodeType.EndElement) of the parent element.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The qualified name of the sibling element you wish to move to.</param>
       </Docs>
@@ -5492,7 +5682,6 @@ reader.ReadToFollowing("item", "urn:1");
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -5504,6 +5693,10 @@ reader.ReadToFollowing("item", "urn:1");
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the XmlReader to the next sibling element with the specified local name and namespace URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a matching sibling element is found; otherwise, false. If a matching sibling element is not found, the XmlReader is positioned on the end tag (<see cref="P:System.Xml.XmlReader.NodeType" /> is XmlNodeType.EndElement) of the parent element.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the sibling element you wish to move to.</param>
         <param name="namespaceURI">
@@ -5527,7 +5720,6 @@ reader.ReadToFollowing("item", "urn:1");
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -5543,6 +5735,10 @@ reader.ReadToFollowing("item", "urn:1");
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads large streams of text embedded in an XML document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of characters read into the buffer. The value zero is returned when there is no more text content.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of characters that serves as the buffer to which the text contents are written. This value cannot be null.</param>
         <param name="index">
@@ -5567,7 +5763,6 @@ reader.ReadToFollowing("item", "urn:1");
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlReader.ReadValueChunk(System.Char[],System.Int32,System.Int32)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlReaderSettings.Async" /> flag to true.</para>
@@ -5576,6 +5771,10 @@ reader.ReadToFollowing("item", "urn:1");
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously reads large streams of text embedded in an XML document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of characters read into the buffer. The value zero is returned when there is no more text content.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of characters that serves as the buffer to which the text contents are written. This value cannot be null.</param>
         <param name="index">
@@ -5802,7 +6001,6 @@ reader.ReadToFollowing("item", "urn:1");
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlReader.Skip" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlReaderSettings.Async" /> flag to true.</para>
@@ -5811,6 +6009,10 @@ reader.ReadToFollowing("item", "urn:1");
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously skips the children of the current node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current node.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.IDisposable.Dispose">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlReaderSettings.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlReaderSettings.xml
index c6c039208ac..b75598d2b1f 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlReaderSettings.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlReaderSettings.xml
@@ -317,7 +317,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -327,6 +326,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the <see cref="T:System.Xml.XmlReaderSettings" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The cloned <see cref="T:System.Xml.XmlReaderSettings" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CloseInput">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlResolver.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlResolver.xml
index e99bef3c539..4208189c16e 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlResolver.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlResolver.xml
@@ -136,10 +136,6 @@ resolver.Credentials = myCache;</code>
         <Parameter Name="ofObjectToReturn" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Object" qualify="true" />
-containing the resource.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="absoluteUri" /> is <see langword="null" />.</exception>
         <exception cref="T:System.Xml.XmlException">
@@ -158,6 +154,10 @@ containing the resource.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, maps a URI to an object containing the actual resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> object or null if a type other than stream is specified.</para>
+        </returns>
         <param name="absoluteUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI returned from <see cref="M:System.Xml.XmlResolver.ResolveUri(System.Uri,System.String)" />.</param>
         <param name="role">
@@ -183,7 +183,6 @@ containing the resource.</para>
         <Parameter Name="ofObjectToReturn" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlResolver.GetEntity(System.Uri,System.String,System.Type)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlReaderSettings.Async" /> flag to true.</para>
@@ -192,6 +191,10 @@ containing the resource.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously maps a URI to an object containing the actual resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> object or null if a type other than stream is specified.</para>
+        </returns>
         <param name="absoluteUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI returned from <see cref="M:System.Xml.XmlResolver.ResolveUri(System.Uri,System.String)" />.</param>
         <param name="role">
@@ -218,9 +221,6 @@ containing the resource.</para>
         <Parameter Name="relativeUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Uri" qualify="true" /> containing the absolute URI, or <see langword="null" /> if <paramref name="relativeUri" /> can not be resolved.</para>
-        </returns>
         <exception cref="T:System.Xml.XmlException">
           <paramref name="baseUri" /> and <paramref name="relativeUri" /> are <see langword="null" />.</exception>
         <exception cref="T:System.Xml.ArgumentException">
@@ -233,6 +233,10 @@ containing the resource.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, resolves the absolute URI from the base and relative URIs.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Uri" /> representing the absolute URI or null if the relative URI cannot be resolved.</para>
+        </returns>
         <param name="baseUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The base URI used to resolve the relative URI.</param>
         <param name="relativeUri">
@@ -255,12 +259,15 @@ containing the resource.</para>
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the ability for the resolver to return other types than just <see cref="T:System.IO.Stream" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="type" /> is supported; otherwise, false.</para>
+        </returns>
         <param name="absoluteUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI.</param>
         <param name="type">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlSecureResolver.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlSecureResolver.xml
index 21c34da0613..0cb25ba9626 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlSecureResolver.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlSecureResolver.xml
@@ -128,7 +128,6 @@
         <Parameter Name="securityUrl" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -139,6 +138,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates evidence using the supplied URL.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The evidence generated from the supplied URL as defined by the default policy.</para>
+        </returns>
         <param name="securityUrl">
           <attribution license="cc4" from="Microsoft" modified="false" />The URL used to create the evidence.</param>
       </Docs>
@@ -182,7 +185,6 @@
         <Parameter Name="ofObjectToReturn" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -193,6 +195,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Maps a URI to an object containing the actual resource. This method temporarily sets the <see cref="T:System.Security.PermissionSet" /> created in the constructor by calling <see cref="M:System.Security.PermissionSet.PermitOnly" /> before calling GetEntity on the underlying <see cref="T:System.Xml.XmlResolver" /> to open the resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> object returned by calling GetEntity on the underlying <see cref="T:System.Xml.XmlResolver" />. If a type other than stream is specified, null is returned.</para>
+        </returns>
         <param name="absoluteUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI returned from <see cref="M:System.Xml.XmlSecureResolver.ResolveUri(System.Uri,System.String)" />.</param>
         <param name="role">
@@ -217,12 +223,15 @@
         <Parameter Name="ofObjectToReturn" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously maps a URI to an object containing the actual resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> object or null if a type other than stream is specified.</para>
+        </returns>
         <param name="absoluteUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI returned from <see cref="M:System.Xml.XmlSecureResolver.ResolveUri(System.Uri,System.String)" />.</param>
         <param name="role">
@@ -248,12 +257,15 @@
         <Parameter Name="relativeUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resolves the absolute URI from the base and relative URIs by calling ResolveUri on the underlying <see cref="T:System.Xml.XmlResolver" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Uri" /> representing the absolute URI or null if the relative URI cannot be resolved (returned by calling ResolveUri on the underlying <see cref="T:System.Xml.XmlResolver" />).</para>
+        </returns>
         <param name="baseUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The base URI used to resolve the relative URI.</param>
         <param name="relativeUri">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlSignificantWhitespace.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlSignificantWhitespace.xml
index aab5457b681..4284d4649cc 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlSignificantWhitespace.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlSignificantWhitespace.xml
@@ -70,7 +70,6 @@
         <Parameter Name="deep" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>CloneNode serves as a copy constructor for nodes. To see how this method behaves with other node types, see <see cref="M:System.Xml.XmlNode.CloneNode(System.Boolean)" />.</para>
@@ -80,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplicate of this node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The cloned node.</para>
+        </returns>
         <param name="deep">
           <attribution license="cc4" from="Microsoft" modified="false" />true to recursively clone the subtree under the specified node; false to clone only the node itself. For significant white space nodes, the cloned node always includes the data value, regardless of the parameter setting. </param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlText.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlText.xml
index 415c31b4cbd..24e11d55c68 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlText.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlText.xml
@@ -67,7 +67,6 @@
         <Parameter Name="deep" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>CloneNode serves as a copy constructor for nodes. For text nodes, the cloned node always includes the data value. To see how this method behaves with other node types, see the <see cref="M:System.Xml.XmlNode.CloneNode(System.Boolean)" /> method in the XmlNode class.</para>
@@ -77,6 +76,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplicate of this node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The cloned node.</para>
+        </returns>
         <param name="deep">
           <attribution license="cc4" from="Microsoft" modified="false" />true to recursively clone the subtree under the specified node; false to clone only the node itself. </param>
       </Docs>
@@ -179,7 +182,6 @@
         <Parameter Name="offset" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'XmlText'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>After SplitText is called, the original node contains all the content up to the offset point. A new node of the same type contains all the content at and after the offset point and is inserted as the next sibling of the original node. When the offset is equal to the length of this node, the new node has no data.</para>
@@ -188,6 +190,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Splits the node into two nodes at the specified offset, keeping both in the tree as siblings.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new node.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />The offset at which to split the node. </param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlTextReader.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlTextReader.xml
index 3353596f46a..a52b63a8cf0 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlTextReader.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlTextReader.xml
@@ -1127,10 +1127,6 @@ otherwise, <see langword="false" />. </para>
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" qualify="true" /> containing the
-   value of the specified attribute.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="i" /> is less than 0, or greater than or equal to the <see cref="P:System.Xml.XmlTextReader.AttributeCount" /> of the containing element.<para><block subset="none" type="note"><see cref="P:System.Xml.XmlTextReader.AttributeCount" /> returns zero for all node types except <see langword="Attribute" />, <see langword="DocumentType" />, <see langword="Element" />, and <see langword="XmlDeclaration" />. Therefore, this exception is thrown if the reader is not positioned on one of these node types.</block></para></exception>
         <example>
@@ -1148,6 +1144,10 @@ otherwise, <see langword="false" />. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the attribute with the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified attribute.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the attribute. The index is zero-based. (The first attribute has index 0.) </param>
       </Docs>
@@ -1170,13 +1170,6 @@ otherwise, <see langword="false" />. </para>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" qualify="true" /> containing the
-   value of the specified attribute, or <see langword="null" />
-   if
-   the attribute is not found. If <paramref name="name" /> is <see langword="null" />, <see langword="null" />
-   is returned.</para>
-        </returns>
         <example>
           <para>See the <see cref="M:System.Xml.XmlTextReader.GetAttribute(System.Int32)" />(<see langword="String" />, <see langword="String" />) method for an example
    using all three overloads of this method.</para>
@@ -1193,6 +1186,10 @@ otherwise, <see langword="false" />. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the attribute with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified attribute. If the attribute is not found, null is returned.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The qualified name of the attribute. </param>
       </Docs>
@@ -1216,13 +1213,6 @@ otherwise, <see langword="false" />. </para>
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" qualify="true" />
-containing the value of the specified attribute, or <see langword="null" />
-if the attribute is not found. If <paramref name="localname" /> is <see langword="null" />,
-<see langword="null" /> 
-is returned.</para>
-        </returns>
         <example>
           <para>This example writes the value of the attributes from the
       following XML fragment to the console:</para>
@@ -1289,6 +1279,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the attribute with the specified local name and namespace URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified attribute. If the attribute is not found, null is returned. This method does not move the reader.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the attribute. </param>
         <param name="namespaceURI">
@@ -1311,7 +1305,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
         <Parameter Name="scope" Type="System.Xml.XmlNamespaceScope" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1385,6 +1378,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection that contains all namespaces currently in-scope.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IDictionary" /> object that contains all the current in-scope namespaces. If the reader is not positioned on an element, an empty dictionary (no namespaces) is returned.</para>
+        </returns>
         <param name="scope">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlNamespaceScope" /> value that specifies the type of namespace nodes to return.</param>
       </Docs>
@@ -1404,9 +1401,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> The <see cref="T:System.IO.StringReader" qualify="true" /> attached to the XML.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1419,6 +1413,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the remainder of the buffered XML.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.TextReader" /> containing the remainder of the buffered XML.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1435,7 +1433,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1447,6 +1444,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the class can return line information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the class can return line information; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HasValue">
@@ -1868,10 +1869,6 @@ node or, for node types that do not have a name (like
         <Parameter Name="prefix" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.String" qualify="true" /> containing the 
-   namespace URI to which the prefix maps. If <see cref="P:System.Xml.XmlTextReader.Namespaces" /> is <see langword="false" />, <paramref name="prefix" /> is not in <see cref="P:System.Xml.XmlTextReader.NameTable" />, or no matching namespace is found, <see langword="null" /> is returned.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">The <see cref="P:System.Xml.XmlTextReader.Namespaces" /> property of the current instance is <see langword="true" /> and <paramref name="prefix" /> is <see langword="null" />.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1889,6 +1886,10 @@ node or, for node types that do not have a name (like
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resolves a namespace prefix in the current element's scope.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The namespace URI to which the prefix maps or null if no matching prefix is found.</para>
+        </returns>
         <param name="prefix">
           <attribution license="cc4" from="Microsoft" modified="false" />The prefix whose namespace URI you want to resolve. To match the default namespace, pass an empty string. This string does not have to be atomized. </param>
       </Docs>
@@ -1963,12 +1964,6 @@ node or, for node types that do not have a name (like
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" /> where <see langword="true" /> indicates the attribute was found. If
-<paramref name="name" /> is <see langword="null" />, or the attribute was not found, 
-<see langword="false" /> is returned and the position
-   of the reader does not change.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1980,6 +1975,10 @@ node or, for node types that do not have a name (like
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves to the attribute with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute is found; otherwise, false. If false, the reader's position does not change.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The qualified name of the attribute. </param>
       </Docs>
@@ -2003,11 +2002,6 @@ node or, for node types that do not have a name (like
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" /> where <see langword="true" /> indicates the attribute was found. If
-<paramref name="localname" /> is <see langword="null" />, or the attribute was not found, <see langword="false" /> is returned and the position of the reader does
-   not change.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -2019,6 +2013,10 @@ node or, for node types that do not have a name (like
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves to the attribute with the specified local name and namespace URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute is found; otherwise, false. If false, the reader's position does not change.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the attribute. </param>
         <param name="namespaceURI">
@@ -2041,12 +2039,6 @@ node or, for node types that do not have a name (like
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" /> where <see langword="true" /> indicates the reader was moved;
-<see langword="false" /> indicates the reader was not positioned on an 
-<see langword="Attribute" /> node and therefore was not 
-   moved.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -2058,6 +2050,10 @@ node or, for node types that do not have a name (like
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves to the element that contains the current attribute node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the reader is positioned on an attribute (the reader moves to the element that owns the attribute); false if the reader is not positioned on an attribute (the position of the reader does not change).</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -2076,9 +2072,6 @@ node or, for node types that do not have a name (like
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" /> where <see langword="true" /> indicates the current node contains at least one attribute; otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -2089,6 +2082,10 @@ node or, for node types that do not have a name (like
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves to the first attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if an attribute exists (the reader moves to the first attribute); otherwise, false (the position of the reader does not change).</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -2107,10 +2104,6 @@ node or, for node types that do not have a name (like
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" /> where <see langword="true" /> indicates the reader moved to the next attribute;
-<see langword="false" /> if there were no more attributes.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -2122,6 +2115,10 @@ node or, for node types that do not have a name (like
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves to the next attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there is a next attribute; false if there are no more attributes.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -2465,10 +2462,6 @@ have a name (like <see langword="Text" />, <see langword="Comment" /> , and so o
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" /> where <see langword="true" /> indicates the node was read successfully, and
-<see langword="false" /> indicates there were no more nodes to read.</para>
-        </returns>
         <exception cref="T:System.Xml.XmlException">An error occurred while parsing the XML.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2482,6 +2475,10 @@ have a name (like <see langword="Text" />, <see langword="Comment" /> , and so o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the next node from the stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the next node was read successfully; false if there are no more nodes to read.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -2500,12 +2497,6 @@ have a name (like <see langword="Text" />, <see langword="Comment" /> , and so o
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" /> where <see langword="true" /> indicates the attribute value was
-   parsed, and <see langword="false" />
-   indicates the reader was not positioned on an attribute node or all the
-   attribute values have been read.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -2517,6 +2508,12 @@ have a name (like <see langword="Text" />, <see langword="Comment" /> , and so o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Parses the attribute value into one or more Text, EntityReference, or EndEntity nodes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there are nodes to return.</para>
+          <para>false if the reader is not positioned on an attribute node when the initial call is made or if all the attribute values have been read.</para>
+          <para>An empty attribute, such as, misc="", returns true with a single node with a value of String.Empty.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -2539,11 +2536,6 @@ have a name (like <see langword="Text" />, <see langword="Comment" /> , and so o
         <Parameter Name="len" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" qualify="true" />
-containing the number of bytes written to <paramref name="array" />, or zero if the current
-instance is not positioned on an element.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="array" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -2567,6 +2559,10 @@ instance is not positioned on an element.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes Base64 and returns the decoded binary bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes written to the buffer.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of characters that serves as the buffer to which the text contents are written. </param>
         <param name="offset">
@@ -2595,11 +2591,6 @@ instance is not positioned on an element.</para>
         <Parameter Name="len" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" qualify="true" />
-containing the number of bytes written to <paramref name="array" />, or zero if the current
-instance is not positioned on an element.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="array" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -2623,6 +2614,10 @@ instance is not positioned on an element.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes BinHex and returns the decoded binary bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes written to your buffer.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array that serves as the buffer to which the decoded binary bytes are written. </param>
         <param name="offset">
@@ -2651,11 +2646,6 @@ instance is not positioned on an element.</para>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" qualify="true" /> containing the number of characters written to
-<paramref name="buffer" />, 
-   or zero if the current instance is not positioned on an element.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>
             <paramref name="count" /> &gt; <paramref name="buffer" />.<see langword="Length" /> - <paramref name="index" />.</para>
@@ -2715,6 +2705,10 @@ instance is not positioned on an element.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the text contents of an element into a character buffer. This method is designed to read large streams of embedded text by calling it successively.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of characters read. This can be 0 if the reader is not positioned on an element or if there is no more text content to return in the current context.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of characters that serves as the buffer to which the text contents are written. </param>
         <param name="index">
@@ -2741,7 +2735,6 @@ instance is not positioned on an element.</para>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2771,6 +2764,10 @@ instance is not positioned on an element.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the content and returns the Base64 decoded binary bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes written to the buffer.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer into which to copy the resulting text. This value cannot be null.</param>
         <param name="index">
@@ -2796,7 +2793,6 @@ instance is not positioned on an element.</para>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2826,6 +2822,10 @@ instance is not positioned on an element.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the content and returns the BinHex decoded binary bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes written to the buffer.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer into which to copy the resulting text. This value cannot be null.</param>
         <param name="index">
@@ -2851,7 +2851,6 @@ instance is not positioned on an element.</para>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2868,6 +2867,10 @@ instance is not positioned on an element.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the element and decodes the Base64 content.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes written to the buffer.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer into which to copy the resulting text. This value cannot be null.</param>
         <param name="index">
@@ -2893,7 +2896,6 @@ instance is not positioned on an element.</para>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2910,6 +2912,10 @@ instance is not positioned on an element.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the element and decodes the BinHex content.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes written to the buffer.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer into which to copy the resulting text. This value cannot be null.</param>
         <param name="index">
@@ -2963,12 +2969,6 @@ instance is not positioned on an element.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" qualify="true" /> containing the
-   contents of the <see langword="Element" /> or <see langword="Text" />
-   node, or <see cref="F:System.String.Empty" qualify="true" />
-   if the reader is positioned on any other type of node.</para>
-        </returns>
         <since version=".NET 2.0" />
         <exception cref="T:System.InvalidOperationException">An invalid operation was attempted.</exception>
         <exception cref="T:System.Xml.XmlException">An error occurred while parsing the XML.</exception>
@@ -2984,6 +2984,11 @@ instance is not positioned on an element.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the contents of an element or a text node as a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The contents of the element or text node. This can be an empty string if the reader is positioned on something other than an element or text node, or if there is no more text content to return in the current context.</para>
+          <para>Note: The text node can be either an element or an attribute text node.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ResetState">
@@ -3138,7 +3143,6 @@ instance is not positioned on an element.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Xml.XmlTextReader" /> instance is cast to an <see cref="T:System.Xml.IXmlLineInfo" /> interface. </para>
@@ -3147,6 +3151,10 @@ instance is not positioned on an element.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Xml.IXmlLineInfo.HasLineInfo" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <see cref="P:System.Xml.IXmlLineInfo.LineNumber" /> and <see cref="P:System.Xml.IXmlLineInfo.LinePosition" /> can be provided; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -3167,7 +3175,6 @@ instance is not positioned on an element.</para>
         <Parameter Name="scope" Type="System.Xml.XmlNamespaceScope" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3177,6 +3184,10 @@ instance is not positioned on an element.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Xml.IXmlNamespaceResolver.GetNamespacesInScope(System.Xml.XmlNamespaceScope)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IDictionary" /> that contains the current in-scope namespaces.</para>
+        </returns>
         <param name="scope">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlNamespaceScope" /> value that specifies the type of namespace nodes to return.</param>
       </Docs>
@@ -3197,13 +3208,16 @@ instance is not positioned on an element.</para>
       </Parameters>
       <Docs>
         <param name="ns">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Xml.IXmlNamespaceResolver.LookupPrefix(System.String)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The prefix that is mapped to the namespace URI; null if the namespace URI is not mapped to a prefix.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlTextWriter.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlTextWriter.xml
index b8beac71732..ab3e2e83260 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlTextWriter.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlTextWriter.xml
@@ -500,11 +500,6 @@ public class WriteFragment
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" qualify="true" /> containing the
-   corresponding prefix, or <see cref="F:System.String.Empty" qualify="true" /> if the prefix is not found and <paramref name="ns" /> is
-   the default namespace, or <see langword="null" /> if no matching namespace URI is found in the current scope.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="ns " /> is <see langword="null" /> or <see cref="F:System.String.Empty" qualify="true" />.</exception>
         <remarks>
@@ -517,6 +512,10 @@ public class WriteFragment
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the closest prefix defined in the current namespace scope for the namespace URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The matching prefix. Or null if no matching namespace URI is found in the current scope.</para>
+        </returns>
         <param name="ns">
           <attribution license="cc4" from="Microsoft" modified="false" />Namespace URI whose prefix you want to find. </param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlUrlResolver.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlUrlResolver.xml
index d8a68cfa8e6..1dffddf5cbb 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlUrlResolver.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlUrlResolver.xml
@@ -191,11 +191,6 @@ resolver.Credentials = myCache;</code>
         <Parameter Name="ofObjectToReturn" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.IO.Stream" qualify="true" /> containing the
-   resource, or <see langword="null" />
-   if <paramref name="ofObjectToReturn" /> is <see langword="null" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="absoluteUri" /> is <see langword="null" />.</exception>
         <exception cref="T:System.Xml.XmlException">
@@ -214,6 +209,10 @@ resolver.Credentials = myCache;</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Maps a URI to an object containing the actual resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> object or null if a type other than stream is specified.</para>
+        </returns>
         <param name="absoluteUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI returned from <see cref="M:System.Xml.XmlResolver.ResolveUri(System.Uri,System.String)" />.</param>
         <param name="role">
@@ -247,12 +246,15 @@ resolver.Credentials = myCache;</code>
         <Parameter Name="ofObjectToReturn" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously maps a URI to an object containing the actual resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> object or null if a type other than stream is specified.</para>
+        </returns>
         <param name="absoluteUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI returned from <see cref="M:System.Xml.XmlResolver.ResolveUri(System.Uri,System.String)" />.</param>
         <param name="role">
@@ -296,9 +298,6 @@ resolver.Credentials = myCache;</code>
         <Parameter Name="relativeUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Uri" qualify="true" /> containing the absolute URI, or <see langword="null" /> if <paramref name="relativeUri" /> can not be resolved.</para>
-        </returns>
         <since version=".NET 2.0" />
         <exception cref="T:System.ArgumentException">
           <paramref name="relativeUri" /> is <see langword="null" />.</exception>
@@ -310,6 +309,10 @@ resolver.Credentials = myCache;</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resolves the absolute URI from the base and relative URIs.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Uri" /> representing the absolute URI, or null if the relative URI cannot be resolved.</para>
+        </returns>
         <param name="baseUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The base URI used to resolve the relative URI.</param>
         <param name="relativeUri">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlValidatingReader.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlValidatingReader.xml
index c6248a78770..7723e2c6862 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlValidatingReader.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlValidatingReader.xml
@@ -598,7 +598,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method does not move the reader.</para>
@@ -610,6 +609,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the attribute with the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified attribute.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the attribute. The index is zero-based. (The first attribute has index 0.) </param>
       </Docs>
@@ -630,7 +633,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -643,6 +645,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the attribute with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified attribute. If the attribute is not found, null is returned.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The qualified name of the attribute. </param>
       </Docs>
@@ -664,7 +670,6 @@
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -684,6 +689,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the attribute with the specified local name and namespace Uniform Resource Identifier (URI).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified attribute. If the attribute is not found, null is returned. This method does not move the reader.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the attribute. </param>
         <param name="namespaceURI">
@@ -703,7 +712,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -715,6 +723,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the class can return line information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the class can return line information; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HasValue">
@@ -1050,7 +1062,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
         <Parameter Name="prefix" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1067,6 +1078,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resolves a namespace prefix in the current element's scope.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The namespace URI to which the prefix maps or null if no matching prefix is found.</para>
+        </returns>
         <param name="prefix">
           <attribution license="cc4" from="Microsoft" modified="false" />The prefix whose namespace Uniform Resource Identifier (URI) you want to resolve. To match the default namespace, pass an empty string. </param>
       </Docs>
@@ -1135,7 +1150,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1147,6 +1161,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves to the attribute with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute is found; otherwise, false. If false, the position of the reader does not change.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The qualified name of the attribute. </param>
       </Docs>
@@ -1168,7 +1186,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
         <Parameter Name="namespaceURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1180,6 +1197,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves to the attribute with the specified local name and namespace Uniform Resource Identifier (URI).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute is found; otherwise, false. If false, the position of the reader does not change.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the attribute. </param>
         <param name="namespaceURI">
@@ -1200,7 +1221,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1212,6 +1232,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves to the element that contains the current attribute node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the reader is positioned on an attribute (the reader moves to the element that owns the attribute); false if the reader is not positioned on an attribute (the position of the reader does not change).</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MoveToFirstAttribute">
@@ -1228,7 +1252,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1239,6 +1262,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves to the first attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if an attribute exists (the reader moves to the first attribute); otherwise, false (the position of the reader does not change).</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MoveToNextAttribute">
@@ -1255,7 +1282,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1267,6 +1293,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves to the next attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there is a next attribute; false if there are no more attributes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Name">
@@ -1470,7 +1500,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1482,6 +1511,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the next node from the stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the next node was read successfully; false if there are no more nodes to read.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadAttributeValue">
@@ -1498,7 +1531,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1531,6 +1563,12 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Parses the attribute value into one or more Text, EntityReference, or EndEntity nodes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if there are nodes to return.</para>
+          <para>false if the reader is not positioned on an attribute node when the initial call is made or if all the attribute values have been read.</para>
+          <para>An empty attribute, such as, misc="", returns true with a single node with a value of String.Empty.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadContentAsBase64">
@@ -1550,7 +1588,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1580,6 +1617,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the content and returns the Base64 decoded binary bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes written to the buffer.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer into which to copy the resulting text. This value cannot be null.</param>
         <param name="index">
@@ -1605,7 +1646,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1635,6 +1675,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the content and returns the BinHex decoded binary bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes written to the buffer.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer into which to copy the resulting text. This value cannot be null.</param>
         <param name="index">
@@ -1660,7 +1704,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1677,6 +1720,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the element and decodes the Base64 content.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes written to the buffer.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer into which to copy the resulting text. This value cannot be null.</param>
         <param name="index">
@@ -1702,7 +1749,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1719,6 +1765,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the element and decodes the BinHex content.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes written to the buffer.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer into which to copy the resulting text. This value cannot be null.</param>
         <param name="index">
@@ -1795,7 +1845,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1837,6 +1886,13 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the contents of an element or text node as a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The contents of the element or text node. This can be an empty string if the reader is positioned on something other than an element or text node, or if there is no more text content to return in the current context.</para>
+          <block subset="none" type="note">
+            <para>The text node can be either an element or an attribute text node.</para>
+          </block>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadTypedValue">
@@ -1853,7 +1909,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1872,6 +1927,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the common language runtime type for the specified XML Schema definition language (XSD) type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The common language runtime type for the specified XML Schema type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ResolveEntity">
@@ -2020,12 +2079,15 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the class can return line information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <see cref="P:System.Xml.IXmlLineInfo.LineNumber" /> and <see cref="P:System.Xml.IXmlLineInfo.LinePosition" /> can be provided; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -2076,7 +2138,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
         <Parameter Name="scope" Type="System.Xml.XmlNamespaceScope" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2086,6 +2147,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Xml.IXmlNamespaceResolver.GetNamespacesInScope(System.Xml.XmlNamespaceScope)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An T:System.Collections.IDictionary object that identifies the namespaces in scope.</para>
+        </returns>
         <param name="scope">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlNamespaceScope" /> object that identifies the scope of the reader.</param>
       </Docs>
@@ -2106,7 +2171,6 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
       </Parameters>
       <Docs>
         <param name="ns">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2116,6 +2180,10 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/);</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Xml.IXmlNamespaceResolver.LookupPrefix(System.String)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string value that contains the namespace prefix that is associated with the <paramref name="namespaceName" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ValidationEventHandler">
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlWhitespace.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlWhitespace.xml
index 01fa37e2c64..e3376c758ae 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlWhitespace.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlWhitespace.xml
@@ -70,7 +70,6 @@
         <Parameter Name="deep" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -81,6 +80,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a duplicate of this node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The cloned node.</para>
+        </returns>
         <param name="deep">
           <attribution license="cc4" from="Microsoft" modified="false" />true to recursively clone the subtree under the specified node; false to clone only the node itself. For white space nodes, the cloned node always includes the data value, regardless of the parameter setting. </param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlWriter.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlWriter.xml
index 3699f05d972..06ce756700f 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlWriter.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlWriter.xml
@@ -470,7 +470,6 @@
         <Parameter Name="output" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -625,6 +624,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.XmlWriter" /> instance using the specified stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlWriter" /> object.</para>
+        </returns>
         <param name="output">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream to which you want to write. The <see cref="T:System.Xml.XmlWriter" /> writes XML 1.0 text syntax and appends it to the specified stream.</param>
       </Docs>
@@ -644,7 +647,6 @@
         <Parameter Name="output" Type="System.IO.TextWriter" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -798,6 +800,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.XmlWriter" /> instance using the specified <see cref="T:System.IO.TextWriter" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlWriter" /> object.</para>
+        </returns>
         <param name="output">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.TextWriter" /> to which you want to write. The <see cref="T:System.Xml.XmlWriter" /> writes XML 1.0 text syntax and appends it to the specified <see cref="T:System.IO.TextWriter" />.</param>
       </Docs>
@@ -817,7 +823,6 @@
         <Parameter Name="outputFileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -971,6 +976,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.XmlWriter" /> instance using the specified filename.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlWriter" /> object.</para>
+        </returns>
         <param name="outputFileName">
           <attribution license="cc4" from="Microsoft" modified="false" />The file to which you want to write. The <see cref="T:System.Xml.XmlWriter" /> creates a file at the specified path and writes to it in XML 1.0 text syntax. The <paramref name="outputFileName" /> must be a file system path.</param>
       </Docs>
@@ -990,7 +999,6 @@
         <Parameter Name="output" Type="System.Text.StringBuilder" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1144,6 +1152,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.XmlWriter" /> instance using the specified <see cref="T:System.Text.StringBuilder" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlWriter" /> object.</para>
+        </returns>
         <param name="output">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Text.StringBuilder" /> to which to write to. Content written by the <see cref="T:System.Xml.XmlWriter" /> is appended to the <see cref="T:System.Text.StringBuilder" />.</param>
       </Docs>
@@ -1163,7 +1175,6 @@
         <Parameter Name="output" Type="System.Xml.XmlWriter" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1318,6 +1329,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.XmlWriter" /> instance using the specified <see cref="T:System.Xml.XmlWriter" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlWriter" /> object that is wrapped around the specified <see cref="T:System.Xml.XmlWriter" /> object.</para>
+        </returns>
         <param name="output">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlWriter" /> object that you want to use as the underlying writer.</param>
       </Docs>
@@ -1338,7 +1353,6 @@
         <Parameter Name="settings" Type="System.Xml.XmlWriterSettings" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1348,6 +1362,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.XmlWriter" /> instance using the stream and <see cref="T:System.Xml.XmlWriterSettings" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlWriter" /> object.</para>
+        </returns>
         <param name="output">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream to which you want to write. The <see cref="T:System.Xml.XmlWriter" /> writes XML 1.0 text syntax and appends it to the specified stream.</param>
         <param name="settings">
@@ -1370,13 +1388,16 @@
         <Parameter Name="settings" Type="System.Xml.XmlWriterSettings" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.XmlWriter" /> instance using the <see cref="T:System.IO.TextWriter" /> and <see cref="T:System.Xml.XmlWriterSettings" /> objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlWriter" /> object.</para>
+        </returns>
         <param name="output">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.TextWriter" /> to which you want to write. The <see cref="T:System.Xml.XmlWriter" /> writes XML 1.0 text syntax and appends it to the specified <see cref="T:System.IO.TextWriter" />.</param>
         <param name="settings">
@@ -1399,13 +1420,16 @@
         <Parameter Name="settings" Type="System.Xml.XmlWriterSettings" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.XmlWriter" /> instance using the filename and <see cref="T:System.Xml.XmlWriterSettings" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlWriter" /> object.</para>
+        </returns>
         <param name="outputFileName">
           <attribution license="cc4" from="Microsoft" modified="false" />The file to which you want to write. The <see cref="T:System.Xml.XmlWriter" /> creates a file at the specified path and writes to it in XML 1.0 text syntax. The <paramref name="outputFileName" /> must be a file system path.</param>
         <param name="settings">
@@ -1428,13 +1452,16 @@
         <Parameter Name="settings" Type="System.Xml.XmlWriterSettings" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.XmlWriter" /> instance using the <see cref="T:System.Text.StringBuilder" /> and <see cref="T:System.Xml.XmlWriterSettings" /> objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlWriter" /> object.</para>
+        </returns>
         <param name="output">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Text.StringBuilder" /> to which to write to. Content written by the <see cref="T:System.Xml.XmlWriter" /> is appended to the <see cref="T:System.Text.StringBuilder" />.</param>
         <param name="settings">
@@ -1457,7 +1484,6 @@
         <Parameter Name="settings" Type="System.Xml.XmlWriterSettings" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1467,6 +1493,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.XmlWriter" /> instance using the specified <see cref="T:System.Xml.XmlWriter" /> and <see cref="T:System.Xml.XmlWriterSettings" /> objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlWriter" /> object that is wrapped around the specified <see cref="T:System.Xml.XmlWriter" /> object.</para>
+        </returns>
         <param name="output">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlWriter" /> object that you want to use as the underlying writer.</param>
         <param name="settings">
@@ -1556,7 +1586,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.Flush" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -1565,6 +1594,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous Flush operation.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="LookupPrefix">
@@ -1584,11 +1617,6 @@
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" qualify="true" /> containing the corresponding prefix, or <see cref="F:System.String.Empty" qualify="true" /> if
-   the prefix is not found and <paramref name="ns" /> is the default namespace, or
-<see langword="null" /> if no matching namespace URI is found in the current scope.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="behaviors"> As described above. </block>
@@ -1605,6 +1633,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the closest prefix defined in the current namespace scope for the namespace URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The matching prefix or null if no matching namespace URI is found in the current scope.</para>
+        </returns>
         <param name="ns">
           <attribution license="cc4" from="Microsoft" modified="false" />The namespace URI whose prefix you want to find.</param>
       </Docs>
@@ -1711,7 +1743,6 @@
         <Parameter Name="defattr" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteAttributes(System.Xml.XmlReader,System.Boolean)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -1720,6 +1751,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously writes out all the attributes found at the current position in the <see cref="T:System.Xml.XmlReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteAttributes operation.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The XmlReader from which to copy the attributes.</param>
         <param name="defattr">
@@ -1910,7 +1945,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteAttributeString(System.String,System.String,System.String,System.String)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -1919,6 +1953,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously writes out the attribute with the specified prefix, local name, namespace URI, and value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteAttributeString operation.</para>
+        </returns>
         <param name="prefix">
           <attribution license="cc4" from="Microsoft" modified="false" />The namespace prefix of the attribute.</param>
         <param name="localName">
@@ -1988,7 +2026,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteBase64(System.Byte[],System.Int32,System.Int32)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -1997,6 +2034,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously encodes the specified binary bytes as Base64 and writes out the resulting text.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteBase64 operation.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />Byte array to encode.</param>
         <param name="index">
@@ -2063,7 +2104,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteBinHex(System.Byte[],System.Int32,System.Int32)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -2072,6 +2112,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously encodes the specified binary bytes as BinHex and writes out the resulting text.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteBinHex operation.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />Byte array to encode.</param>
         <param name="index">
@@ -2127,7 +2171,6 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteCData(System.String)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -2136,6 +2179,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously writes out a &lt;![CDATA[...]]&gt; block containing the specified text.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteCData operation.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to place inside the CDATA block.</param>
       </Docs>
@@ -2187,7 +2234,6 @@
         <Parameter Name="ch" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteCharEntity(System.Char)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -2196,6 +2242,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously forces the generation of a character entity for the specified Unicode character value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteCharEntity operation.</para>
+        </returns>
         <param name="ch">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character for which to generate a character entity.</param>
       </Docs>
@@ -2260,7 +2310,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteChars(System.Char[],System.Int32,System.Int32)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -2269,6 +2318,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously writes text one buffer at a time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteChars operation.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />Character array containing the text to write.</param>
         <param name="index">
@@ -2325,7 +2378,6 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteComment(System.String)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -2334,6 +2386,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously writes out a comment &lt;!--...--&gt; containing the specified text.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteComment operation.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />Text to place inside the comment.</param>
       </Docs>
@@ -2405,7 +2461,6 @@
         <Parameter Name="subset" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteDocType(System.String,System.String,System.String,System.String)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -2414,6 +2469,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously writes the DOCTYPE declaration with the specified name and optional attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteDocType operation.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the DOCTYPE. This must be non-empty.</param>
         <param name="pubid">
@@ -2553,7 +2612,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteElementString(System.String,System.String,System.String,System.String)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -2562,6 +2620,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously writes an element with the specified prefix, local name, namespace URI, and value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteElementString operation.</para>
+        </returns>
         <param name="prefix">
           <attribution license="cc4" from="Microsoft" modified="false" />The prefix of the element.</param>
         <param name="localName">
@@ -2616,7 +2678,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteEndAttribute" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -2625,6 +2686,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously closes the previous <see cref="M:System.Xml.XmlWriter.WriteStartAttribute(System.String,System.String)" /> call.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteEndAttribute operation.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="WriteEndDocument">
@@ -2669,7 +2734,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteEndDocument" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -2678,6 +2742,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously closes any open elements or attributes and puts the writer back in the Start state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteEndDocument operation.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="WriteEndElement">
@@ -2723,7 +2791,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteEndElement" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -2732,6 +2799,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously closes one element and pops the corresponding namespace scope.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteEndElement operation.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="WriteEntityRef">
@@ -2780,7 +2851,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteEntityRef(System.String)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -2789,6 +2859,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously writes out an entity reference as &amp;name;.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteEntityRef operation.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the entity reference.</param>
       </Docs>
@@ -2833,7 +2907,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteFullEndElement" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -2842,6 +2915,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously closes one element and pops the corresponding namespace scope.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteFullEndElement operation.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="WriteName">
@@ -2894,7 +2971,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteName(System.String)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -2903,6 +2979,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously writes out the specified name, ensuring it is a valid name according to the W3C XML 1.0 recommendation (http://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteName operation.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name to write.</param>
       </Docs>
@@ -2956,7 +3036,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteNmToken(System.String)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -2965,6 +3044,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously writes out the specified name, ensuring it is a valid NmToken according to the W3C XML 1.0 recommendation (http://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteNmToken operation.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name to write.</param>
       </Docs>
@@ -3298,7 +3381,6 @@ while (!reader.EOF){
         <Parameter Name="defattr" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteNode(System.Xml.XmlReader,System.Boolean)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -3307,6 +3389,10 @@ while (!reader.EOF){
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously copies everything from the reader to the writer and moves the reader to the start of the next sibling.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteNode operation.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlReader" /> to read from.</param>
         <param name="defattr">
@@ -3328,7 +3414,6 @@ while (!reader.EOF){
         <Parameter Name="defattr" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteNode(System.Xml.XPath.XPathNavigator,System.Boolean)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -3337,6 +3422,10 @@ while (!reader.EOF){
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously copies everything from the <see cref="T:System.Xml.XPath.XPathNavigator" /> object to the writer. The position of the <see cref="T:System.Xml.XPath.XPathNavigator" /> remains unchanged.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteNode operation.</para>
+        </returns>
         <param name="navigator">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XPath.XPathNavigator" /> to copy from.</param>
         <param name="defattr">
@@ -3409,7 +3498,6 @@ writer.Close();</code>
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteProcessingInstruction(System.String,System.String)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -3418,6 +3506,10 @@ writer.Close();</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously writes out a processing instruction with a space between the name and text as follows: &lt;?name text?&gt;.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteProcessingInstruction operation.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the processing instruction.</param>
         <param name="text">
@@ -3486,7 +3578,6 @@ writer.Close();</code>
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteQualifiedName(System.String,System.String)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -3495,6 +3586,10 @@ writer.Close();</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously writes out the namespace-qualified name. This method looks up the prefix that is in scope for the given namespace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteQualifiedName operation.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />The local name to write.</param>
         <param name="ns">
@@ -3596,7 +3691,6 @@ writer.Close();</code>
         <Parameter Name="data" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteRaw(System.String)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -3605,6 +3699,10 @@ writer.Close();</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously writes raw markup manually from a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteRaw operation.</para>
+        </returns>
         <param name="data">
           <attribution license="cc4" from="Microsoft" modified="false" />String containing the text to write.</param>
       </Docs>
@@ -3625,7 +3723,6 @@ writer.Close();</code>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteRaw(System.Char[],System.Int32,System.Int32)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -3634,6 +3731,10 @@ writer.Close();</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously writes raw markup manually from a character buffer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteRaw operation.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />Character array containing the text to write.</param>
         <param name="index">
@@ -3766,7 +3867,6 @@ writer.Close();</code>
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteStartAttribute(System.String,System.String,System.String)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -3775,6 +3875,10 @@ writer.Close();</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously writes the start of an attribute with the specified prefix, local name, and namespace URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteStartAttribute operation.</para>
+        </returns>
         <param name="prefix">
           <attribution license="cc4" from="Microsoft" modified="false" />The namespace prefix of the attribute.</param>
         <param name="localName">
@@ -3859,7 +3963,6 @@ writer.Close();</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteStartDocument" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -3868,6 +3971,10 @@ writer.Close();</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously writes the XML declaration with the version "1.0".</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteStartDocument operation.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="WriteStartDocumentAsync">
@@ -3884,7 +3991,6 @@ writer.Close();</code>
         <Parameter Name="standalone" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteStartDocument(System.Boolean)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -3893,6 +3999,10 @@ writer.Close();</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously writes the XML declaration with the version "1.0" and the standalone attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteStartDocument operation.</para>
+        </returns>
         <param name="standalone">
           <attribution license="cc4" from="Microsoft" modified="false" />If true, it writes "standalone=yes"; if false, it writes "standalone=no".</param>
       </Docs>
@@ -4024,7 +4134,6 @@ writer.Close();</code>
         <Parameter Name="ns" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteStartElement(System.String,System.String,System.String)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -4033,6 +4142,10 @@ writer.Close();</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously writes the specified start tag and associates it with the given namespace and prefix.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteStartElement operation.</para>
+        </returns>
         <param name="prefix">
           <attribution license="cc4" from="Microsoft" modified="false" />The namespace prefix of the element.</param>
         <param name="localName">
@@ -4146,7 +4259,6 @@ writer.Close();</code>
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteString(System.String)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -4155,6 +4267,10 @@ writer.Close();</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously writes the given text content.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteString operation.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to write.</param>
       </Docs>
@@ -4215,7 +4331,6 @@ writer.Close();</code>
         <Parameter Name="highChar" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteSurrogateCharEntity(System.Char,System.Char)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -4224,6 +4339,10 @@ writer.Close();</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously generates and writes the surrogate character entity for the surrogate character pair.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteSurrogateCharEntity operation.</para>
+        </returns>
         <param name="lowChar">
           <attribution license="cc4" from="Microsoft" modified="false" />The low surrogate. This must be a value between 0xDC00 and 0xDFFF.</param>
         <param name="highChar">
@@ -4590,7 +4709,6 @@ writer.Close();</code>
         <Parameter Name="ws" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the asynchronous version of <see cref="M:System.Xml.XmlWriter.WriteWhitespace(System.String)" />, with the same functionality. To use this method, you must set the <see cref="P:System.Xml.XmlWriterSettings.Async" /> flag to true.</para>
@@ -4599,6 +4717,10 @@ writer.Close();</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously writes out the given white space.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The task that represents the asynchronous WriteWhitespace operation.</para>
+        </returns>
         <param name="ws">
           <attribution license="cc4" from="Microsoft" modified="false" />The string of white space characters.</param>
       </Docs>
diff --git a/mcs/class/System.XML/Documentation/en/System.Xml/XmlWriterSettings.xml b/mcs/class/System.XML/Documentation/en/System.Xml/XmlWriterSettings.xml
index df84a7b1ad8..a442c55c254 100644
--- a/mcs/class/System.XML/Documentation/en/System.Xml/XmlWriterSettings.xml
+++ b/mcs/class/System.XML/Documentation/en/System.Xml/XmlWriterSettings.xml
@@ -441,7 +441,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -451,6 +450,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the <see cref="T:System.Xml.XmlWriterSettings" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The cloned <see cref="T:System.Xml.XmlWriterSettings" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CloseOutput">
diff --git a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/Extensions.xml b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/Extensions.xml
index e0af21d0c21..79e02949917 100644
--- a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/Extensions.xml
+++ b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/Extensions.xml
@@ -45,7 +45,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;T&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If multiple nodes in the source collection have the same ancestor, the ancestor will be included multiple times in the result collection. To avoid this, use the <see cref="Overload:System.Linq.Enumerable.Distinct" /> method.</para>
@@ -55,6 +54,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of elements that contains the ancestors of every node in the source collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> that contains the ancestors of every node in the source collection.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XNode" /> that contains the source collection.</param>
         <typeparam name="T">
@@ -83,7 +86,6 @@
         <Parameter Name="name" Type="System.Xml.Linq.XName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If multiple nodes in the source collection have the same ancestor with a matching <see cref="T:System.Xml.Linq.XName" />, the ancestor will be included multiple times in the result collection.</para>
@@ -93,6 +95,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a filtered collection of elements that contains the ancestors of every node in the source collection. Only elements that have a matching <see cref="T:System.Xml.Linq.XName" /> are included in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> that contains the ancestors of every node in the source collection. Only elements that have a matching <see cref="T:System.Xml.Linq.XName" /> are included in the collection.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XNode" /> that contains the source collection.</param>
         <param name="name">
@@ -115,7 +121,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Xml.Linq.XElement&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If multiple nodes in the source collection have the same ancestor, the ancestor will be included multiple times in the result collection. To avoid this, use the <see cref="Overload:System.Linq.Enumerable.Distinct" /> method.</para>
@@ -125,6 +130,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of elements that contains every element in the source collection, and the ancestors of every element in the source collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> that contains every element in the source collection, and the ancestors of every element in the source collection.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> that contains the source collection.</param>
       </Docs>
@@ -144,7 +153,6 @@
         <Parameter Name="name" Type="System.Xml.Linq.XName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If multiple nodes in the source collection have the same ancestor with a matching <see cref="T:System.Xml.Linq.XName" />, the ancestor will be included multiple times in the result collection.</para>
@@ -154,6 +162,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a filtered collection of elements that contains every element in the source collection, and the ancestors of every element in the source collection. Only elements that have a matching <see cref="T:System.Xml.Linq.XName" /> are included in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> that contains every element in the source collection, and the ancestors of every element in the source collection. Only elements that have a matching <see cref="T:System.Xml.Linq.XName" /> are included in the collection.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> that contains the source collection.</param>
         <param name="name">
@@ -174,7 +186,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Xml.Linq.XElement&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Note that unlike some other XML programming interfaces, in sqltecxlinq, namespaces are surfaced as attributes.</para>
@@ -185,6 +196,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of the attributes of every element in the source collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XAttribute" /> that contains the attributes of every element in the source collection.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> that contains the source collection.</param>
       </Docs>
@@ -204,7 +219,6 @@
         <Parameter Name="name" Type="System.Xml.Linq.XName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Note that unlike some other XML programming interfaces, in sqltecxlinq, namespaces are surfaced as attributes.</para>
@@ -214,6 +228,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a filtered collection of the attributes of every element in the source collection. Only elements that have a matching <see cref="T:System.Xml.Linq.XName" /> are included in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XAttribute" /> that contains a filtered collection of the attributes of every element in the source collection. Only elements that have a matching <see cref="T:System.Xml.Linq.XName" /> are included in the collection.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> that contains the source collection.</param>
         <param name="name">
@@ -241,7 +259,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;T&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This axis extension method is used on <see cref="T:System.Xml.Linq.XDocument" /> and <see cref="T:System.Xml.Linq.XElement" /> objects. Both of these types derive from <see cref="T:System.Xml.Linq.XContainer" />, so this method operates on an <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XContainer" /> that contains the source collection.</para>
@@ -252,6 +269,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of the descendant nodes of every document and element in the source collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XNode" /> of the descendant nodes of every document and element in the source collection.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XContainer" /> that contains the source collection.</param>
         <typeparam name="T">
@@ -272,7 +293,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Xml.Linq.XElement&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Although Visual Basic has an integrated XML axis for descendant elements, there is no integrated axis for descendant nodes, so Visual Basic users must use this axis method explicitly.</para>
@@ -282,6 +302,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of nodes that contains every element in the source collection, and the descendant nodes of every element in the source collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XNode" /> that contains every element in the source collection, and the descendant nodes of every element in the source collection.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> that contains the source collection.</param>
       </Docs>
@@ -307,7 +331,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;T&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visual Basic users can use the integrated XML descendant axis to retrieve the descendant elements of a collection. However, the integrated axis only retrieves descendants with a specified name. If Visual Basic users want to retrieve all descendants, then they must use this axis method explicitly.</para>
@@ -317,6 +340,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of elements that contains the descendant elements of every element and document in the source collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> that contains the descendant elements of every element and document in the source collection.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XContainer" /> that contains the source collection.</param>
         <typeparam name="T">
@@ -345,7 +372,6 @@
         <Parameter Name="name" Type="System.Xml.Linq.XName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visual Basic users can use the <format type="text/html"><a href="4143c385-eb50-4286-a7fd-a50f466c7af0">Language-Integrated Axes in Visual Basic (LINQ to XML)</a></format> instead of using this axis method explicitly.</para>
@@ -355,6 +381,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a filtered collection of elements that contains the descendant elements of every element and document in the source collection. Only elements that have a matching <see cref="T:System.Xml.Linq.XName" /> are included in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> that contains the descendant elements of every element and document in the source collection. Only elements that have a matching <see cref="T:System.Xml.Linq.XName" /> are included in the collection.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XContainer" /> that contains the source collection.</param>
         <param name="name">
@@ -377,7 +407,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;System.Xml.Linq.XElement&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Although Visual Basic has an integrated XML axis for descendant elements, there is no integrated axis that has the semantics of this method, so Visual Basic users must use this axis method explicitly.</para>
@@ -387,6 +416,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of elements that contains every element in the source collection, and the descendent elements of every element in the source collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> that contains every element in the source collection, and the descendent elements of every element in the source collection.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> that contains the source collection.</param>
       </Docs>
@@ -406,7 +439,6 @@
         <Parameter Name="name" Type="System.Xml.Linq.XName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Although Visual Basic has an integrated XML axis for descendant elements, there is no integrated axis that has the semantics of this method, so Visual Basic users must use this axis method explicitly.</para>
@@ -416,6 +448,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a filtered collection of elements that contains every element in the source collection, and the descendents of every element in the source collection. Only elements that have a matching <see cref="T:System.Xml.Linq.XName" /> are included in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> that contains every element in the source collection, and the descendents of every element in the source collection. Only elements that have a matching <see cref="T:System.Xml.Linq.XName" /> are included in the collection.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> that contains the source collection.</param>
         <param name="name">
@@ -443,7 +479,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;T&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Although Visual Basic contains an integrated elements axis that allows you to find all child elements with a specified <see cref="T:System.Xml.Linq.XName" /> for every element in the source collection, there is no integrated elements axis that allows you to retrieve a collection of every child element for every element in the source collection.</para>
@@ -453,6 +488,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of the child elements of every element and document in the source collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> of the child elements of every element or document in the source collection.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> that contains the source collection.</param>
         <typeparam name="T">
@@ -481,7 +520,6 @@
         <Parameter Name="name" Type="System.Xml.Linq.XName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Visual Basic users can use the integrated elements axis to retrieve the child elements of every element in a collection.</para>
@@ -491,6 +529,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a filtered collection of the child elements of every element and document in the source collection. Only elements that have a matching <see cref="T:System.Xml.Linq.XName" /> are included in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> of the child elements of every element and document in the source collection. Only elements that have a matching <see cref="T:System.Xml.Linq.XName" /> are included in the collection.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> that contains the source collection.</param>
         <param name="name">
@@ -520,7 +562,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;T&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This axis method uses deferred execution. However, it first enumerates its source collection, the sorts the nodes in document order, and then yields the results.</para>
@@ -529,6 +570,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of nodes that contains all nodes in the source collection, sorted in document order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XNode" /> that contains all nodes in the source collection, sorted in document order.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XNode" /> that contains the source collection.</param>
         <typeparam name="T">
@@ -556,7 +601,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;T&gt;" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses deferred execution. </para>
@@ -565,6 +609,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of the child nodes of every document and element in the source collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XNode" /> of the child nodes of every document and element in the source collection.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XNode" /> that contains the source collection.</param>
         <typeparam name="T">
diff --git a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XAttribute.xml b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XAttribute.xml
index 0d6a9a25ee2..6ddb6485e56 100644
--- a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XAttribute.xml
+++ b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XAttribute.xml
@@ -910,7 +910,6 @@ XElement root = new XElement(aw + "Root",
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns a string in the form of AttributeName="content".</para>
@@ -922,6 +921,10 @@ XElement root = new XElement(aw + "Root",
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the current <see cref="T:System.Xml.Linq.XAttribute" /> object to a string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the XML text representation of an attribute and its value.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XContainer.xml b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XContainer.xml
index a19dd753dbb..0e67ba310db 100644
--- a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XContainer.xml
+++ b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XContainer.xml
@@ -158,7 +158,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>While serializing, namespace prefixes are inferred from the namespace attributes in the XML tree.</para>
@@ -168,6 +167,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XmlWriter" /> that can be used to add nodes to the <see cref="T:System.Xml.Linq.XContainer" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlWriter" /> that is ready to have content written to it.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DescendantNodes">
@@ -182,7 +185,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Note that attributes are not considered to be nodes in sqltecxlinq, so they will not be part of the collection that is returned by this method.</para>
@@ -192,6 +194,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of the descendant nodes for this document or element, in document order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XNode" /> containing the descendant nodes of the <see cref="T:System.Xml.Linq.XContainer" />, in document order.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Descendants">
@@ -206,7 +212,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Note that this method will not return itself in the resulting <see cref="T:System.Collections.Generic.IEnumerable`1" />. See <see cref="M:System.Xml.Linq.XElement.DescendantsAndSelf" /> if you need to include the current <see cref="T:System.Xml.Linq.XElement" /> in the results.</para>
@@ -216,6 +221,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of the descendant elements for this document or element, in document order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> containing the descendant elements of the <see cref="T:System.Xml.Linq.XContainer" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Descendants">
@@ -232,7 +241,6 @@
         <Parameter Name="name" Type="System.Xml.Linq.XName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses deferred execution. </para>
@@ -241,6 +249,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a filtered collection of the descendant elements for this document or element, in document order. Only elements that have a matching <see cref="T:System.Xml.Linq.XName" /> are included in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> containing the descendant elements of the <see cref="T:System.Xml.Linq.XContainer" /> that match the specified <see cref="T:System.Xml.Linq.XName" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Linq.XName" /> to match.</param>
       </Docs>
@@ -259,7 +271,6 @@
         <Parameter Name="name" Type="System.Xml.Linq.XName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns null if there is no element with the specified name.</para>
@@ -271,6 +282,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the first (in document order) child element with the specified <see cref="T:System.Xml.Linq.XName" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Xml.Linq.XElement" /> that matches the specified <see cref="T:System.Xml.Linq.XName" />, or null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Linq.XName" /> to match.</param>
       </Docs>
@@ -287,7 +302,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses deferred execution. </para>
@@ -296,6 +310,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of the child elements of this element or document, in document order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> containing the child elements of this <see cref="T:System.Xml.Linq.XContainer" />, in document order.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Elements">
@@ -312,7 +330,6 @@
         <Parameter Name="name" Type="System.Xml.Linq.XName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses deferred execution. </para>
@@ -321,6 +338,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a filtered collection of the child elements of this element or document, in document order. Only elements that have a matching <see cref="T:System.Xml.Linq.XName" /> are included in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> containing the children of the <see cref="T:System.Xml.Linq.XContainer" /> that have a matching <see cref="T:System.Xml.Linq.XName" />, in document order.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Linq.XName" /> to match.</param>
       </Docs>
@@ -375,7 +396,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Note that the content does not include attributes. In sqltecxlinq, attributes are not considered to be nodes of the tree. They are name/value pairs associated with an element.</para>
@@ -385,6 +405,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of the child nodes of this element or document, in document order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XNode" /> containing the contents of this <see cref="T:System.Xml.Linq.XContainer" />, in document order.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="RemoveNodes">
diff --git a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XDeclaration.xml b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XDeclaration.xml
index d862c34a10e..7926ce5151a 100644
--- a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XDeclaration.xml
+++ b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XDeclaration.xml
@@ -129,12 +129,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides the declaration as a formatted string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that contains the formatted XML string.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Version">
diff --git a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XDocument.xml b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XDocument.xml
index 4378f8ec1ef..1e1408c9829 100644
--- a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XDocument.xml
+++ b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XDocument.xml
@@ -189,7 +189,6 @@
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you want to control load options, use the <see cref="Overload:System.Xml.Linq.XDocument.Load" /> overload that takes <see cref="T:System.Xml.Linq.LoadOptions" /> as a parameter.</para>
@@ -208,6 +207,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.Linq.XDocument" /> instance by using the specified stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XDocument" /> object that reads the data that is contained in the stream. </para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream that contains the XML data.</param>
       </Docs>
@@ -226,7 +229,6 @@
         <Parameter Name="textReader" Type="System.IO.TextReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>LINQ to XML's loading functionality is built upon <see cref="T:System.Xml.XmlReader" />. Therefore, you might catch any exceptions that are thrown by the <see cref="Overload:System.Xml.XmlReader.Create" /> overload methods and the <see cref="T:System.Xml.XmlReader" /> methods that read and parse the document.</para>
@@ -235,6 +237,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.Linq.XDocument" /> from a <see cref="T:System.IO.TextReader" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XDocument" /> that contains the contents of the specified <see cref="T:System.IO.TextReader" />.</para>
+        </returns>
         <param name="textReader">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IO.TextReader" /> that contains the content for the <see cref="T:System.Xml.Linq.XDocument" />.</param>
       </Docs>
@@ -253,7 +259,6 @@
         <Parameter Name="uri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses an underlying <see cref="T:System.Xml.XmlReader" /> to read the XML into an XML tree.</para>
@@ -264,6 +269,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.Linq.XDocument" /> from a file. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XDocument" /> that contains the contents of the specified file.</para>
+        </returns>
         <param name="uri">
           <attribution license="cc4" from="Microsoft" modified="false" />A URI string that references the file to load into a new <see cref="T:System.Xml.Linq.XDocument" />.</param>
       </Docs>
@@ -282,7 +291,6 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>One possible use for this method is to create a copy of a DOM document in a LINQ to XML tree. To do this, you create an <see cref="T:System.Xml.XmlNodeReader" /> from a DOM document, and then use the <see cref="T:System.Xml.XmlNodeReader" /> to create an <see cref="T:System.Xml.Linq.XDocument" />.</para>
@@ -292,6 +300,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.Linq.XDocument" /> from an <see cref="T:System.Xml.XmlReader" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XDocument" /> that contains the contents of the specified <see cref="T:System.Xml.XmlReader" />.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.XmlReader" /> that contains the content for the <see cref="T:System.Xml.Linq.XDocument" />.</param>
       </Docs>
@@ -311,7 +323,6 @@
         <Parameter Name="options" Type="System.Xml.Linq.LoadOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The loading functionality of LINQ to XML is built upon <see cref="T:System.Xml.XmlReader" />. Therefore, you might catch any exceptions that are thrown by the <see cref="Overload:System.Xml.XmlReader.Create" /> overload methods and the <see cref="T:System.Xml.XmlReader" /> methods that read and parse the document. </para>
@@ -329,6 +340,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.Linq.XDocument" /> instance by using the specified stream, optionally preserving white space, setting the base URI, and retaining line information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XDocument" /> object that reads the data that is contained in the stream.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream containing the XML data.</param>
         <param name="options">
@@ -350,7 +365,6 @@
         <Parameter Name="options" Type="System.Xml.Linq.LoadOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the source XML is indented, setting the <see cref="F:System.Xml.Linq.LoadOptions.PreserveWhitespace" /> flag in <paramref name="options" /> causes the reader to read all white space in the source XML. Nodes of type <see cref="T:System.Xml.Linq.XText" /> are created for both significant and insignificant white space.</para>
@@ -367,6 +381,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.Linq.XDocument" /> from a <see cref="T:System.IO.TextReader" />, optionally preserving white space, setting the base URI, and retaining line information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XDocument" /> that contains the XML that was read from the specified <see cref="T:System.IO.TextReader" />.</para>
+        </returns>
         <param name="textReader">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IO.TextReader" /> that contains the content for the <see cref="T:System.Xml.Linq.XDocument" />.</param>
         <param name="options">
@@ -388,7 +406,6 @@
         <Parameter Name="options" Type="System.Xml.Linq.LoadOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the source XML is indented, setting the <see cref="F:System.Xml.Linq.LoadOptions.PreserveWhitespace" /> flag in <paramref name="options" /> causes the reader to read all white space in the source XML. Nodes of type <see cref="T:System.Xml.Linq.XText" /> are created for both significant and insignificant white space.</para>
@@ -404,6 +421,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.Linq.XDocument" /> from a file, optionally preserving white space, setting the base URI, and retaining line information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XDocument" /> that contains the contents of the specified file.</para>
+        </returns>
         <param name="uri">
           <attribution license="cc4" from="Microsoft" modified="false" />A URI string that references the file to load into a new <see cref="T:System.Xml.Linq.XDocument" />.</param>
         <param name="options">
@@ -425,7 +446,6 @@
         <Parameter Name="options" Type="System.Xml.Linq.LoadOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>By creating an <see cref="T:System.Xml.XmlNodeReader" /> from a DOM document, and then using the <see cref="T:System.Xml.XmlNodeReader" /> to create an <see cref="T:System.Xml.Linq.XElement" />, this method can be used to create a copy of a DOM document in a LINQ to XML tree.</para>
@@ -441,6 +461,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads an <see cref="T:System.Xml.Linq.XDocument" /> from an <see cref="T:System.Xml.XmlReader" />, optionally setting the base URI, and retaining line information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XDocument" /> that contains the XML that was read from the specified <see cref="T:System.Xml.XmlReader" />.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.XmlReader" /> that will be read for the content of the <see cref="T:System.Xml.Linq.XDocument" />.</param>
         <param name="options">
@@ -483,7 +507,6 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method does not preserve white space. If you want to preserve white space in the XML tree, use the overload of <see cref="Overload:System.Xml.Linq.XDocument.Parse" /> that takes <see cref="T:System.Xml.Linq.LoadOptions" /> as a parameter.</para>
@@ -494,6 +517,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.Linq.XDocument" /> from a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XDocument" /> populated from the string that contains XML.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains XML.</param>
       </Docs>
@@ -513,7 +540,6 @@
         <Parameter Name="options" Type="System.Xml.Linq.LoadOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the source XML is indented, setting the <see cref="F:System.Xml.Linq.LoadOptions.PreserveWhitespace" /> flag in <paramref name="options" /> causes the reader to read all white space in the source XML. Nodes of type <see cref="T:System.Xml.Linq.XText" /> are created for both significant and insignificant white space.</para>
@@ -529,6 +555,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.Linq.XDocument" /> from a string, optionally preserving white space, setting the base URI, and retaining line information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XDocument" /> populated from the string that contains XML.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains XML.</param>
         <param name="options">
diff --git a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XElement.xml b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XElement.xml
index 4d992860e3a..7dab019be28 100644
--- a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XElement.xml
+++ b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XElement.xml
@@ -207,7 +207,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The elements in the returned collection are in reverse document order.</para>
@@ -217,6 +216,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of elements that contain this element, and the ancestors of this element. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> of elements that contain this element, and the ancestors of this element. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="AncestorsAndSelf">
@@ -233,7 +236,6 @@
         <Parameter Name="name" Type="System.Xml.Linq.XName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The elements in the returned collection are in reverse document order.</para>
@@ -243,6 +245,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a filtered collection of elements that contain this element, and the ancestors of this element. Only elements that have a matching <see cref="T:System.Xml.Linq.XName" /> are included in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> that contain this element, and the ancestors of this element. Only elements that have a matching <see cref="T:System.Xml.Linq.XName" /> are included in the collection.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Linq.XName" /> to match.</param>
       </Docs>
@@ -261,7 +267,6 @@
         <Parameter Name="name" Type="System.Xml.Linq.XName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Some axis methods return collections of elements or attributes. This method returns only a single attribute. Sometimes this is referred to as a <newTerm>singleton</newTerm> (in contrast to a <newTerm>collection</newTerm>).</para>
@@ -271,6 +276,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Xml.Linq.XAttribute" /> of this <see cref="T:System.Xml.Linq.XElement" /> that has the specified <see cref="T:System.Xml.Linq.XName" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XAttribute" /> that has the specified <see cref="T:System.Xml.Linq.XName" />; null if there is no attribute with the specified name.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Linq.XName" /> of the <see cref="T:System.Xml.Linq.XAttribute" /> to get.</param>
       </Docs>
@@ -287,7 +296,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The attributes in the returned collection are in the order that they were added to the element. If the XML tree was parsed from XML, the attributes are returned in document order.</para>
@@ -297,6 +305,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of attributes of this element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XAttribute" /> of attributes of this element.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Attributes">
@@ -313,7 +325,6 @@
         <Parameter Name="name" Type="System.Xml.Linq.XName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attribute names must be unique within an element. Therefore, this axis method can return either a collection that contains only one attribute, or it can return an empty collection.</para>
@@ -323,6 +334,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a filtered collection of attributes of this element. Only elements that have a matching <see cref="T:System.Xml.Linq.XName" /> are included in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XAttribute" /> that contains the attributes of this element. Only elements that have a matching <see cref="T:System.Xml.Linq.XName" /> are included in the collection.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Linq.XName" /> to match.</param>
       </Docs>
@@ -339,7 +354,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses deferred execution. </para>
@@ -348,6 +362,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of nodes that contain this element, and all descendant nodes of this element, in document order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XNode" /> that contain this element, and all descendant nodes of this element, in document order.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DescendantsAndSelf">
@@ -362,7 +380,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses deferred execution. </para>
@@ -371,6 +388,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of elements that contain this element, and all descendant elements of this element, in document order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> of elements that contain this element, and all descendant elements of this element, in document order.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DescendantsAndSelf">
@@ -387,7 +408,6 @@
         <Parameter Name="name" Type="System.Xml.Linq.XName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses deferred execution. </para>
@@ -396,6 +416,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a filtered collection of elements that contain this element, and all descendant elements of this element, in document order. Only elements that have a matching <see cref="T:System.Xml.Linq.XName" /> are included in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> that contain this element, and all descendant elements of this element, in document order. Only elements that have a matching <see cref="T:System.Xml.Linq.XName" /> are included in the collection.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Linq.XName" /> to match.</param>
       </Docs>
@@ -456,7 +480,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Namespace declarations may be persisted as attributes in the XML tree. These special attributes declare namespaces, including default namespaces. This method finds the namespace declaration that declares the default namespace, if there is one, and returns the <see cref="T:System.Xml.Linq.XNamespace" /> for the default namespace.</para>
@@ -468,6 +491,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the default <see cref="T:System.Xml.Linq.XNamespace" /> of this <see cref="T:System.Xml.Linq.XElement" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XNamespace" /> that contains the default namespace of this <see cref="T:System.Xml.Linq.XElement" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetNamespaceOfPrefix">
@@ -484,7 +511,6 @@
         <Parameter Name="prefix" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method looks through the XML tree for namespace attributes that are in scope for this element. Namespace prefixes are specified in namespace attributes that are in the XML tree.</para>
@@ -493,6 +519,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the namespace associated with a particular prefix for this <see cref="T:System.Xml.Linq.XElement" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XNamespace" /> for the namespace associated with the prefix for this <see cref="T:System.Xml.Linq.XElement" />.</para>
+        </returns>
         <param name="prefix">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the namespace prefix to look up.</param>
       </Docs>
@@ -511,7 +541,6 @@
         <Parameter Name="ns" Type="System.Xml.Linq.XNamespace" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method looks through the XML tree for namespace attributes that are in scope for this element. Namespace prefixes are specified in namespace attributes that are in the XML tree.</para>
@@ -521,6 +550,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the prefix associated with a namespace for this <see cref="T:System.Xml.Linq.XElement" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that contains the namespace prefix.</para>
+        </returns>
         <param name="ns">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.Linq.XNamespace" /> to look up.</param>
       </Docs>
@@ -621,7 +654,6 @@
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you want to control load options, use the <see cref="Overload:System.Xml.Linq.XElement.Load" /> overload that takes <see cref="T:System.Xml.Linq.LoadOptions" /> as a parameter.</para>
@@ -640,6 +672,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.Linq.XElement" /> instance by using the specified stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XElement" /> object used to read the data that is contained in the stream.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream that contains the XML data.</param>
       </Docs>
@@ -658,7 +694,6 @@
         <Parameter Name="textReader" Type="System.IO.TextReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method reads the raw XML into the XML tree. It discards all insignificant white space in the file.</para>
@@ -668,6 +703,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads an <see cref="T:System.Xml.Linq.XElement" /> from a <see cref="T:System.IO.TextReader" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XElement" /> that contains the XML that was read from the specified <see cref="T:System.IO.TextReader" />.</para>
+        </returns>
         <param name="textReader">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IO.TextReader" /> that will be read for the <see cref="T:System.Xml.Linq.XElement" /> content.</param>
       </Docs>
@@ -686,7 +725,6 @@
         <Parameter Name="uri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method reads the raw XML into the XML tree. It discards all insignificant white space in the file.</para>
@@ -696,6 +734,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads an <see cref="T:System.Xml.Linq.XElement" /> from a file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XElement" /> that contains the contents of the specified file.</para>
+        </returns>
         <param name="uri">
           <attribution license="cc4" from="Microsoft" modified="false" />A URI string referencing the file to load into a new <see cref="T:System.Xml.Linq.XElement" />.</param>
       </Docs>
@@ -714,7 +756,6 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>By creating an <see cref="T:System.Xml.XmlNodeReader" /> from a DOM document, and then using the <see cref="T:System.Xml.XmlNodeReader" /> to create an <see cref="T:System.Xml.Linq.XElement" />, this method can be used to create a copy of a DOM document in a LINQ to XML tree.</para>
@@ -724,6 +765,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads an <see cref="T:System.Xml.Linq.XElement" /> from an <see cref="T:System.Xml.XmlReader" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XElement" /> that contains the XML that was read from the specified <see cref="T:System.Xml.XmlReader" />.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.XmlReader" /> that will be read for the content of the <see cref="T:System.Xml.Linq.XElement" />.</param>
       </Docs>
@@ -743,7 +788,6 @@
         <Parameter Name="options" Type="System.Xml.Linq.LoadOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>LINQ to XML's loading functionality is built upon <see cref="T:System.Xml.XmlReader" />. Therefore, you might catch any exceptions that are thrown by the <see cref="Overload:System.Xml.XmlReader.Create" /> overload methods and the <see cref="T:System.Xml.XmlReader" /> methods that read and parse the document. </para>
@@ -761,6 +805,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Xml.Linq.XElement" /> instance by using the specified stream, optionally preserving white space, setting the base URI, and retaining line information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XElement" /> object used to read the data that the stream contains.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream containing the XML data.</param>
         <param name="options">
@@ -782,7 +830,6 @@
         <Parameter Name="options" Type="System.Xml.Linq.LoadOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the source XML is indented, setting the <see cref="F:System.Xml.Linq.LoadOptions.PreserveWhitespace" /> flag in <paramref name="options" /> causes the reader to read all white space in the source XML. Nodes of type <see cref="T:System.Xml.Linq.XText" /> are created for both significant and insignificant white space.</para>
@@ -799,6 +846,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads an <see cref="T:System.Xml.Linq.XElement" /> from a <see cref="T:System.IO.TextReader" />, optionally preserving white space and retaining line information. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XElement" /> that contains the XML that was read from the specified <see cref="T:System.IO.TextReader" />.</para>
+        </returns>
         <param name="textReader">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IO.TextReader" /> that will be read for the <see cref="T:System.Xml.Linq.XElement" /> content.</param>
         <param name="options">
@@ -820,7 +871,6 @@
         <Parameter Name="options" Type="System.Xml.Linq.LoadOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the source XML is indented, setting the <see cref="F:System.Xml.Linq.LoadOptions.PreserveWhitespace" /> flag in <paramref name="options" /> causes the reader to read all white space in the source XML. Nodes of type <see cref="T:System.Xml.Linq.XText" /> are created for both significant and insignificant white space.</para>
@@ -836,6 +886,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads an <see cref="T:System.Xml.Linq.XElement" /> from a file, optionally preserving white space, setting the base URI, and retaining line information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XElement" /> that contains the contents of the specified file.</para>
+        </returns>
         <param name="uri">
           <attribution license="cc4" from="Microsoft" modified="false" />A URI string referencing the file to load into an <see cref="T:System.Xml.Linq.XElement" />.</param>
         <param name="options">
@@ -857,7 +911,6 @@
         <Parameter Name="options" Type="System.Xml.Linq.LoadOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>By creating an <see cref="T:System.Xml.XmlNodeReader" /> from a DOM document, and then using the <see cref="T:System.Xml.XmlNodeReader" /> to create an <see cref="T:System.Xml.Linq.XElement" />, this method can be used to create a copy of a DOM document in a LINQ to XML tree.</para>
@@ -873,6 +926,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads an <see cref="T:System.Xml.Linq.XElement" /> from an <see cref="T:System.Xml.XmlReader" />, optionally preserving white space, setting the base URI, and retaining line information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XElement" /> that contains the XML that was read from the specified <see cref="T:System.Xml.XmlReader" />.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.XmlReader" /> that will be read for the content of the <see cref="T:System.Xml.Linq.XElement" />.</param>
         <param name="options">
@@ -1562,7 +1619,6 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method does not preserve white space. If you want to preserve white space in the XML tree, use the overload of the <see cref="Overload:System.Xml.Linq.XElement.Parse" /> method that takes <see cref="T:System.Xml.Linq.LoadOptions" /> as a parameter. For more information, see <format type="text/html"><a href="093a7169-a04e-4638-b08c-d1cb98aa650d">Preserving White Space while Loading or Parsing XML</a></format> and <format type="text/html"><a href="fb146217-0a49-4efc-ac84-7265b91d3939">Preserving White Space While Serializing</a></format>.</para>
@@ -1572,6 +1628,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Load an <see cref="T:System.Xml.Linq.XElement" /> from a string that contains XML.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XElement" /> populated from the string that contains XML.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that contains XML.</param>
       </Docs>
@@ -1591,7 +1651,6 @@
         <Parameter Name="options" Type="System.Xml.Linq.LoadOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the source XML is indented, setting the <see cref="F:System.Xml.Linq.LoadOptions.PreserveWhitespace" /> flag in <paramref name="options" /> causes the reader to read all white space in the source XML. Nodes of type <see cref="T:System.Xml.Linq.XText" /> are created for both significant and insignificant white space.</para>
@@ -1608,6 +1667,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Load an <see cref="T:System.Xml.Linq.XElement" /> from a string that contains XML, optionally preserving white space and retaining line information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XElement" /> populated from the string that contains XML.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that contains XML.</param>
         <param name="options">
@@ -2086,7 +2149,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is part of implementation of the <see cref="T:System.Xml.Serialization.IXmlSerializable" /> interface.</para>
@@ -2096,6 +2158,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an XML schema definition that describes the XML representation of this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Schema.XmlSchema" /> that describes the XML representation of the object that is produced by the <see cref="M:System.Xml.Serialization.IXmlSerializable.WriteXml(System.Xml.XmlWriter)" /> method and consumed by the <see cref="M:System.Xml.Serialization.IXmlSerializable.ReadXml(System.Xml.XmlReader)" /> method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.Serialization.IXmlSerializable.ReadXml">
diff --git a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XName.xml b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XName.xml
index f27b9ddc1d0..35f025344b2 100644
--- a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XName.xml
+++ b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XName.xml
@@ -111,7 +111,6 @@ Console.WriteLine(root)</code>
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For two <see cref="T:System.Xml.Linq.XName" /> objects to be equal, they must have the same expanded name.</para>
@@ -120,6 +119,10 @@ Console.WriteLine(root)</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Xml.Linq.XName" /> is equal to this <see cref="T:System.Xml.Linq.XName" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Xml.Linq.XName" /> is equal to the current <see cref="T:System.Xml.Linq.XName" />; otherwise false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Linq.XName" /> to compare to the current <see cref="T:System.Xml.Linq.XName" />.</param>
       </Docs>
@@ -138,7 +141,6 @@ Console.WriteLine(root)</code>
         <Parameter Name="expandedName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method contains overloads that allow you to create an <see cref="T:System.Xml.Linq.XName" />. You can create it from a expanded XML name in the form {namespace}localname, or from a namespace and a local name, specified separately.</para>
@@ -149,6 +151,10 @@ Console.WriteLine(root)</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <see cref="T:System.Xml.Linq.XName" /> object from an expanded name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XName" /> object constructed from the expanded name.</para>
+        </returns>
         <param name="expandedName">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that contains an expanded XML name in the format {namespace}localname.</param>
       </Docs>
@@ -168,7 +174,6 @@ Console.WriteLine(root)</code>
         <Parameter Name="namespaceName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method contains overloads that allow you to create an <see cref="T:System.Xml.Linq.XName" />. You can create it from an expanded XML name in the form {namespace}localname, or from a namespace and a local name, specified separately.</para>
@@ -179,6 +184,10 @@ Console.WriteLine(root)</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <see cref="T:System.Xml.Linq.XName" /> object from a local name and a namespace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XName" /> object created from the specified local name and namespace.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />A local (unqualified) name.</param>
         <param name="namespaceName">
@@ -197,7 +206,6 @@ Console.WriteLine(root)</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method serves as a hash function for <see cref="T:System.Xml.Linq.XName" />. You can use <see cref="M:System.Xml.Linq.XName.GetHashCode" /> in hashing algorithms, or in data structures such as a hash table.</para>
@@ -206,6 +214,10 @@ Console.WriteLine(root)</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a hash code for this <see cref="T:System.Xml.Linq.XName" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Int32" /> that contains the hash code for the <see cref="T:System.Xml.Linq.XName" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="LocalName">
@@ -289,7 +301,6 @@ Console.WriteLine(root)</code>
         <Parameter Name="right" Type="System.Xml.Linq.XName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The operator overloads == and != are included to enable comparisons between <see cref="T:System.Xml.Linq.XName" /> and a string, such as element.Name == "SomeElementName". The predefined reference equality operators in C# require one operand to be convertible to the type of the other through reference conversions only. These operators do not consider the implicit conversion from string to <see cref="T:System.Xml.Linq.XName" />.</para>
@@ -298,6 +309,10 @@ Console.WriteLine(root)</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether two instances of <see cref="T:System.Xml.Linq.XName" /> are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> and <paramref name="right" /> are equal; otherwise false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Xml.Linq.XName" /> to compare.</param>
         <param name="right">
@@ -344,7 +359,6 @@ Console.WriteLine(root)</code>
         <Parameter Name="right" Type="System.Xml.Linq.XName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The operator overloads == and != are included to enable comparisons between <see cref="T:System.Xml.Linq.XName" /> and a string, such as element.Name == "SomeElementName". The predefined reference equality operators in C# require one operand to be convertible to the type of the other through reference conversions only. These operators do not consider the implicit conversion from string to <see cref="T:System.Xml.Linq.XName" />.</para>
@@ -353,6 +367,10 @@ Console.WriteLine(root)</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether two instances of <see cref="T:System.Xml.Linq.XName" /> are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> and <paramref name="right" /> are not equal; otherwise false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Xml.Linq.XName" /> to compare.</param>
         <param name="right">
@@ -420,12 +438,15 @@ Console.WriteLine(root)</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the expanded XML name in the format {namespace}localname.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that contains the expanded XML name in the format {namespace}localname.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XNamespace.xml b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XNamespace.xml
index 491eedf5723..90e3f4bfd73 100644
--- a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XNamespace.xml
+++ b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XNamespace.xml
@@ -143,7 +143,6 @@ Console.WriteLine(e)</code>
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For two <see cref="T:System.Xml.Linq.XNamespace" /> objects to be equal, they must have the same URI.</para>
@@ -152,6 +151,10 @@ Console.WriteLine(e)</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Xml.Linq.XNamespace" /> is equal to the current <see cref="T:System.Xml.Linq.XNamespace" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Boolean" /> that indicates whether the specified <see cref="T:System.Xml.Linq.XNamespace" /> is equal to the current <see cref="T:System.Xml.Linq.XNamespace" />.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Linq.XNamespace" /> to compare to the current <see cref="T:System.Xml.Linq.XNamespace" />.</param>
       </Docs>
@@ -170,7 +173,6 @@ Console.WriteLine(e)</code>
         <Parameter Name="namespaceName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned <see cref="T:System.Xml.Linq.XNamespace" /> object is guaranteed to be atomic (that is, it is the only one in the system for that particular URI).</para>
@@ -179,6 +181,10 @@ Console.WriteLine(e)</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <see cref="T:System.Xml.Linq.XNamespace" /> for the specified Uniform Resource Identifier (URI).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XNamespace" /> created from the specified URI.</para>
+        </returns>
         <param name="namespaceName">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that contains a namespace URI.</param>
       </Docs>
@@ -195,7 +201,6 @@ Console.WriteLine(e)</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method serves as a hash function for <see cref="T:System.Xml.Linq.XNamespace" />. You can use <see cref="M:System.Xml.Linq.XNamespace.GetHashCode" /> in hashing algorithms and data structures like a hash table.</para>
@@ -204,6 +209,10 @@ Console.WriteLine(e)</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a hash code for this <see cref="T:System.Xml.Linq.XNamespace" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Int32" /> that contains the hash code for the <see cref="T:System.Xml.Linq.XNamespace" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetName">
@@ -220,7 +229,6 @@ Console.WriteLine(e)</code>
         <Parameter Name="localName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned <see cref="T:System.Xml.Linq.XName" /> object is guaranteed to be atomic (that is, it is the only one in the system for a specific expanded name).</para>
@@ -229,6 +237,10 @@ Console.WriteLine(e)</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Xml.Linq.XName" /> object created from this <see cref="T:System.Xml.Linq.XNamespace" /> and the specified local name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XName" /> created from this <see cref="T:System.Xml.Linq.XNamespace" /> and the specified local name.</para>
+        </returns>
         <param name="localName">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that contains a local name.</param>
       </Docs>
@@ -289,7 +301,6 @@ Console.WriteLine(e)</code>
         <Parameter Name="localName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operator enables the common idiom of combining a namespace and a local name in the construction of an element or attribute. This idiom provides some of the benefits of having namespace prefixes, in that you can refer to a namespace using a variable that is short. This eliminates syntactic noise in the code that creates XML trees.</para>
@@ -298,6 +309,10 @@ Console.WriteLine(e)</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Combines an <see cref="T:System.Xml.Linq.XNamespace" /> object with a local name to create an <see cref="T:System.Xml.Linq.XName" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.Xml.Linq.XName" /> constructed from the namespace and local name.</para>
+        </returns>
         <param name="ns">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.Linq.XNamespace" /> that contains the namespace.</param>
         <param name="localName">
@@ -319,7 +334,6 @@ Console.WriteLine(e)</code>
         <Parameter Name="right" Type="System.Xml.Linq.XNamespace" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The operator overloads == and != are provided to enable comparisons between <see cref="T:System.Xml.Linq.XNamespace" /> and string (for example, element.Name.Namespace == "http://www.adventure-works.com"). The predefined reference equality operators in C# require one operand to be convertible to the type of the other through reference conversions only, and do not consider the implicit conversion from string to <see cref="T:System.Xml.Linq.XNamespace" />.</para>
@@ -328,6 +342,10 @@ Console.WriteLine(e)</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether two instances of <see cref="T:System.Xml.Linq.XNamespace" /> are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Boolean" /> that indicates whether <paramref name="left" /> and <paramref name="right" /> are equal.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Xml.Linq.XNamespace" /> to compare.</param>
         <param name="right">
@@ -374,7 +392,6 @@ Console.WriteLine(e)</code>
         <Parameter Name="right" Type="System.Xml.Linq.XNamespace" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The operator overloads == and != are provided to enable comparisons between <see cref="T:System.Xml.Linq.XNamespace" /> and string (for example, element.Name.Namespace == "http://www.adventure-works.com"). The predefined reference equality operators in C# require one operand to be convertible to the type of the other through reference conversions only, and do not consider the implicit conversion from string to <see cref="T:System.Xml.Linq.XNamespace" />.</para>
@@ -383,6 +400,10 @@ Console.WriteLine(e)</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether two instances of <see cref="T:System.Xml.Linq.XNamespace" /> are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Boolean" /> that indicates whether <paramref name="left" /> and <paramref name="right" /> are not equal.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Xml.Linq.XNamespace" /> to compare.</param>
         <param name="right">
@@ -401,12 +422,15 @@ Console.WriteLine(e)</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the URI of this <see cref="T:System.Xml.Linq.XNamespace" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The URI of this <see cref="T:System.Xml.Linq.XNamespace" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Xml">
diff --git a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XNode.xml b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XNode.xml
index 6c387941698..61acc3beb07 100644
--- a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XNode.xml
+++ b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XNode.xml
@@ -203,7 +203,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method does not return itself in the results.</para>
@@ -214,6 +213,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of the ancestor elements of this node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> of the ancestor elements of this node.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Ancestors">
@@ -230,7 +233,6 @@
         <Parameter Name="name" Type="System.Xml.Linq.XName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method will not return itself in the results.</para>
@@ -239,6 +241,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a filtered collection of the ancestor elements of this node. Only elements that have a matching <see cref="T:System.Xml.Linq.XName" /> are included in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> of the ancestor elements of this node. Only elements that have a matching <see cref="T:System.Xml.Linq.XName" /> are included in the collection.</para>
+          <para>The nodes in the returned collection are in reverse document order.</para>
+          <para>This method uses deferred execution.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Linq.XName" /> to match.</param>
       </Docs>
@@ -258,7 +266,6 @@
         <Parameter Name="n2" Type="System.Xml.Linq.XNode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Xml.Linq.XContainer" /> stores its child nodes as a singly-linked list of <see cref="T:System.Xml.Linq.XNode" /> objects. This means that the <see cref="M:System.Xml.Linq.XNode.CompareDocumentOrder" /> method must traverse the ancestors of the two nodes being compared until it finds the common parent. Then it must traverse the list of the common parent’s child nodes to determine the order of the two nodes being compared. Therefore, using this method might affect your performance.</para>
@@ -267,6 +274,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two nodes to determine their relative XML document order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An int containing 0 if the nodes are equal; -1 if <paramref name="n1" /> is before <paramref name="n2" />; 1 if <paramref name="n1" /> is after <paramref name="n2" />.</para>
+        </returns>
         <param name="n1">
           <attribution license="cc4" from="Microsoft" modified="false" />First <see cref="T:System.Xml.Linq.XNode" /> to compare.</param>
         <param name="n2">
@@ -285,7 +296,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You typically use this method when you have to supply another component with an <see cref="T:System.Xml.XmlReader" />. For example, you can create an <see cref="T:System.Xml.XmlReader" /> from a sqltecxlinq tree, and then pass that reader to <see cref="M:System.Xml.XmlDocument.Load(System.Xml.XmlReader)" />.</para>
@@ -299,6 +309,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XmlReader" /> for this node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlReader" /> that can be used to read this node and its descendants.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateReader">
@@ -315,12 +329,15 @@
         <Parameter Name="readerOptions" Type="System.Xml.Linq.ReaderOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XmlReader" /> with the options specified by the <paramref name="readerOptions" /> parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XmlReader" /> object.</para>
+        </returns>
         <param name="readerOptions">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.Linq.ReaderOptions" /> object that specifies whether to omit duplicate namespaces.</param>
       </Docs>
@@ -340,7 +357,6 @@
         <Parameter Name="n2" Type="System.Xml.Linq.XNode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following criteria determine whether two nodes are equal:</para>
@@ -375,6 +391,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the values of two nodes, including the values of all descendant nodes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the nodes are equal; otherwise false.</para>
+        </returns>
         <param name="n1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Xml.Linq.XNode" /> to compare.</param>
         <param name="n2">
@@ -415,7 +435,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method only includes siblings in the returned collection. It does not include descendants.</para>
@@ -425,6 +444,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of the sibling elements after this node, in document order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> of the sibling elements after this node, in document order.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ElementsAfterSelf">
@@ -441,7 +464,6 @@
         <Parameter Name="name" Type="System.Xml.Linq.XName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method only includes siblings in the returned collection. It does not include descendants.</para>
@@ -451,6 +473,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a filtered collection of the sibling elements after this node, in document order. Only elements that have a matching <see cref="T:System.Xml.Linq.XName" /> are included in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> of the sibling elements after this node, in document order. Only elements that have a matching <see cref="T:System.Xml.Linq.XName" /> are included in the collection.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Linq.XName" /> to match.</param>
       </Docs>
@@ -467,7 +493,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method only includes siblings in the returned collection. It does not include descendants.</para>
@@ -477,6 +502,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of the sibling elements before this node, in document order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> of the sibling elements before this node, in document order.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ElementsBeforeSelf">
@@ -493,7 +522,6 @@
         <Parameter Name="name" Type="System.Xml.Linq.XName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method only includes siblings in the returned collection. It does not include descendants.</para>
@@ -503,6 +531,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a filtered collection of the sibling elements before this node, in document order. Only elements that have a matching <see cref="T:System.Xml.Linq.XName" /> are included in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> of the sibling elements before this node, in document order. Only elements that have a matching <see cref="T:System.Xml.Linq.XName" /> are included in the collection.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Linq.XName" /> to match.</param>
       </Docs>
@@ -540,7 +572,6 @@
         <Parameter Name="node" Type="System.Xml.Linq.XNode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Xml.Linq.XContainer" /> stores its child nodes as a singly-linked list of <see cref="T:System.Xml.Linq.XNode" /> objects. This means that the <see cref="M:System.Xml.Linq.XNode.CompareDocumentOrder" /> method must traverse the ancestors of the two nodes being compared until it finds the common parent. Then it must traverse the list of the common parent’s child nodes to determine the order of the two nodes being compared. Therefore, using this method might affect your performance.</para>
@@ -549,6 +580,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the current node appears after a specified node in terms of document order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this node appears after the specified node; otherwise false.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Linq.XNode" /> to compare for document order.</param>
       </Docs>
@@ -567,7 +602,6 @@
         <Parameter Name="node" Type="System.Xml.Linq.XNode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Xml.Linq.XContainer" /> stores its child nodes as a singly-linked list of <see cref="T:System.Xml.Linq.XNode" /> objects. This means that the <see cref="M:System.Xml.Linq.XNode.IsBefore" /> method must traverse the ancestors of the two nodes being compared until it finds the common parent. Then it must traverse the list of the common parent’s child nodes to determine the order of the two nodes being compared. Therefore, using this method might affect your performance.</para>
@@ -576,6 +610,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the current node appears before a specified node in terms of document order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this node appears before the specified node; otherwise false.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Linq.XNode" /> to compare for document order.</param>
       </Docs>
@@ -614,7 +652,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method only includes siblings in the returned collection. It does not include descendants.</para>
@@ -624,6 +661,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of the sibling nodes after this node, in document order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XNode" /> of the sibling nodes after this node, in document order.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="NodesBeforeSelf">
@@ -638,7 +679,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method only includes siblings in the returned collection. It does not include descendants.</para>
@@ -648,6 +688,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of the sibling nodes before this node, in document order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XNode" /> of the sibling nodes before this node, in document order.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="PreviousNode">
@@ -687,7 +731,6 @@
         <Parameter Name="reader" Type="System.Xml.XmlReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use this method to write a method that returns a collection of nodes, yielding each node as the node is read from the reader. This method enables you to process arbitrarily large XML files with a very small memory footprint.</para>
@@ -700,6 +743,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.Linq.XNode" /> from an <see cref="T:System.Xml.XmlReader" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XNode" /> that contains the node and its descendant nodes that were read from the reader. The runtime type of the node is determined by the node type (<see cref="P:System.Xml.Linq.XObject.NodeType" />) of the first node encountered in the reader.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.XmlReader" /> positioned at the node to read into this <see cref="T:System.Xml.Linq.XNode" />.</param>
       </Docs>
@@ -805,12 +852,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the indented XML for this node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the indented XML.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -827,12 +877,15 @@
         <Parameter Name="options" Type="System.Xml.Linq.SaveOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML for this node, optionally disabling formatting.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the XML.</para>
+        </returns>
         <param name="options">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.Linq.SaveOptions" /> that specifies formatting behavior.</param>
       </Docs>
diff --git a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XNodeDocumentOrderComparer.xml b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XNodeDocumentOrderComparer.xml
index e6385067041..535978d8e2a 100644
--- a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XNodeDocumentOrderComparer.xml
+++ b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XNodeDocumentOrderComparer.xml
@@ -63,7 +63,6 @@
         <Parameter Name="y" Type="System.Xml.Linq.XNode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>We recommend that instead of using this class directly, you use the <see cref="M:System.Xml.Linq.Extensions.InDocumentOrder``1(System.Collections.Generic.IEnumerable{``0})" /> method. This class is used internally by that method.</para>
@@ -72,6 +71,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two nodes to determine their relative document order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Int32" /> that contains 0 if the nodes are equal; -1 if <paramref name="x" /> is before <paramref name="y" />; 1 if <paramref name="x" /> is after <paramref name="y" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Xml.Linq.XNode" /> to compare.</param>
         <param name="y">
@@ -95,7 +98,6 @@
       <Docs>
         <param name="n1">To be added.</param>
         <param name="n2">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>We recommend that instead of using this class directly, you use the <see cref="M:System.Xml.Linq.Extensions.InDocumentOrder``1(System.Collections.Generic.IEnumerable{``0})" /> method. This class is used internally by that method. </para>
@@ -104,6 +106,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two nodes to determine their relative document order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Int32" /> that contains 0 if the nodes are equal; -1 if <paramref name="x" /> is before <paramref name="y" />; 1 if <paramref name="x" /> is after <paramref name="y" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XNodeEqualityComparer.xml b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XNodeEqualityComparer.xml
index 24fd47b4ba2..c858db38d8b 100644
--- a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XNodeEqualityComparer.xml
+++ b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XNodeEqualityComparer.xml
@@ -59,7 +59,6 @@
         <Parameter Name="y" Type="System.Xml.Linq.XNode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following criteria determine whether two nodes are equal:</para>
@@ -94,6 +93,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the values of two nodes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Boolean" /> indicating if the nodes are equal.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Xml.Linq.XNode" /> to compare.</param>
         <param name="y">
@@ -114,7 +117,6 @@
         <Parameter Name="obj" Type="System.Xml.Linq.XNode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Xml.Linq.XNode" /> implementation of <see cref="M:System.Object.GetHashCode" /> is based on the referential identity of the node. This method computes a deep hash code based on the value of the node and all descendants. The hash code reflects all attributes and all descendent nodes.</para>
@@ -123,6 +125,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash code based on an <see cref="T:System.Xml.Linq.XNode" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Int32" /> that contains a value-based hash code for the node.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Linq.XNode" /> to hash.</param>
       </Docs>
@@ -144,7 +150,6 @@
       <Docs>
         <param name="n1">To be added.</param>
         <param name="n2">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following criteria determine whether two nodes are equal:</para>
@@ -179,6 +184,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the values of two nodes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the nodes are equal; otherwise false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IEqualityComparer.GetHashCode">
@@ -195,7 +204,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Xml.Linq.XNode" /> implementation of <see cref="T:System.Object.GetHashCode" /> is based on the referential identity of the node. This method computes a deep hash code based on the value of the node, its attributes, and its descendants.</para>
@@ -204,6 +212,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash code based on the value of a node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Int32" /> that contains a value-based hash code for the node.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The node to hash.</param>
       </Docs>
diff --git a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XObject.xml b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XObject.xml
index 159c2062344..ca6832b3884 100644
--- a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XObject.xml
+++ b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XObject.xml
@@ -66,12 +66,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the first annotation object of the specified type from this <see cref="T:System.Xml.Linq.XObject" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> that contains the first annotation object that matches the specified type, or null if no annotation is of the specified type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the annotation to retrieve.</param>
       </Docs>
@@ -95,12 +98,15 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Get the first annotation object of the specified type from this <see cref="T:System.Xml.Linq.XObject" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first annotation object that matches the specified type, or null if no annotation is of the specified type.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the annotation to retrieve.</typeparam>
       </Docs>
@@ -119,12 +125,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of annotations of the specified type for this <see cref="T:System.Xml.Linq.XObject" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Object" /> that contains the annotations that match the specified type for this <see cref="T:System.Xml.Linq.XObject" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the annotations to retrieve.</param>
       </Docs>
@@ -148,12 +157,15 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of annotations of the specified type for this <see cref="T:System.Xml.Linq.XObject" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> that contains the annotations for this <see cref="T:System.Xml.Linq.XObject" />.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the annotations to retrieve.</typeparam>
       </Docs>
@@ -357,7 +369,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can call this method to determine whether the <see cref="T:System.Xml.Linq.XObject" /> contains valid line information.</para>
@@ -367,6 +378,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether or not this <see cref="T:System.Xml.Linq.XObject" /> has line information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Xml.Linq.XObject" /> has line information, otherwise false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Xml.IXmlLineInfo.LineNumber">
diff --git a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XStreamingElement.xml b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XStreamingElement.xml
index 807a4bcb87d..931d61076da 100644
--- a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XStreamingElement.xml
+++ b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Linq/XStreamingElement.xml
@@ -403,7 +403,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Note that when debugging a program that uses <see cref="T:System.Xml.Linq.XStreamingElement" />, displaying the value of an object causes its <see cref="Overload:System.Xml.Linq.XStreamingElement.ToString" /> method to be called. This causes the XML to be serialized. If the semantics of your streaming element query are such that the streaming element can only be streamed once, this may cause undesirable behavior in your debugging experience.</para>
@@ -412,6 +411,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the formatted (indented) XML for this streaming element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the indented XML.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -428,7 +431,6 @@
         <Parameter Name="options" Type="System.Xml.Linq.SaveOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Note that when debugging a program that uses <see cref="T:System.Xml.Linq.XStreamingElement" />, displaying the value of an object causes its <see cref="Overload:System.Xml.Linq.XStreamingElement.ToString" /> method to be called. This causes the XML to be serialized. If the semantics of your streaming element query are such that the streaming element can only be streamed once, this may cause undesirable behavior in your debugging experience.</para>
@@ -437,6 +439,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML for this streaming element, optionally disabling formatting.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the XML.</para>
+        </returns>
         <param name="options">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Xml.Linq.SaveOptions" /> that specifies formatting behavior.</param>
       </Docs>
diff --git a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Schema/Extensions.xml b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Schema/Extensions.xml
index cc82e426ec6..05c07059e51 100644
--- a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Schema/Extensions.xml
+++ b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.Schema/Extensions.xml
@@ -36,7 +36,6 @@
         <Parameter Name="source" Type="System.Xml.Linq.XAttribute" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the <see cref="T:System.Xml.Schema.IXmlSchemaInfo" /> returned by this method to determine certain characteristics of a validated attribute. For example, you can determine if the attribute came from a default attribute value in an XSD.</para>
@@ -47,6 +46,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the post-schema-validation infoset (PSVI) of a validated attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Xml.Schema.IXmlSchemaInfo" /> that contains the post-schema-validation infoset for an <see cref="T:System.Xml.Linq.XAttribute" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.Linq.XAttribute" /> that has been previously validated.</param>
       </Docs>
@@ -65,7 +68,6 @@
         <Parameter Name="source" Type="System.Xml.Linq.XElement" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the <see cref="T:System.Xml.Schema.IXmlSchemaInfo" /> returned by this method to determine certain characteristics of a validated element. For example, you can determine the dynamic schema type of the element.</para>
@@ -76,6 +78,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the post-schema-validation infoset (PSVI) of a validated element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Xml.Schema.IXmlSchemaInfo" /> that contains the post-schema-validation infoset (PSVI) for an <see cref="T:System.Xml.Linq.XElement" />.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.Linq.XElement" /> that has been previously validated.</param>
       </Docs>
diff --git a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.XPath/Extensions.xml b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.XPath/Extensions.xml
index 2d47ee0875a..65cab9c9d90 100644
--- a/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.XPath/Extensions.xml
+++ b/mcs/class/System.Xml.Linq/Documentation/en/System.Xml.XPath/Extensions.xml
@@ -37,7 +37,6 @@
         <Parameter Name="node" Type="System.Xml.Linq.XNode" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You cannot edit the XML tree by using the <see cref="T:System.Xml.XPath.XPathNavigator" /> that is returned by this method. The <see cref="P:System.Xml.XPath.XPathNavigator.CanEdit" /> property returns false.</para>
@@ -51,6 +50,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XPath.XPathNavigator" /> for an <see cref="T:System.Xml.Linq.XNode" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XPath.XPathNavigator" /> that can process XPath queries.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.Linq.XNode" /> that can process XPath queries.</param>
       </Docs>
@@ -70,7 +73,6 @@
         <Parameter Name="nameTable" Type="System.Xml.XmlNameTable" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You cannot edit the XML tree using the <see cref="T:System.Xml.XPath.XPathNavigator" /> that is returned by this method. The <see cref="P:System.Xml.XPath.XPathNavigator.CanEdit" /> property returns false.</para>
@@ -83,6 +85,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Xml.XPath.XPathNavigator" /> for an <see cref="T:System.Xml.Linq.XNode" />. The <see cref="T:System.Xml.XmlNameTable" /> enables more efficient XPath expression processing.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.XPath.XPathNavigator" /> that can process XPath queries.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Xml.Linq.XNode" /> that can process an XPath query.</param>
         <param name="nameTable">
@@ -104,7 +110,6 @@
         <Parameter Name="expression" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the collection is an enumeration of elements or attributes, you can use the Cast operator to get a collection of <see cref="T:System.Xml.Linq.XElement" /> or <see cref="T:System.Xml.Linq.XAttribute" />.</para>
@@ -115,6 +120,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates an XPath expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that can contain a bool, a double, a string, or an <see cref="T:System.Collections.Generic.IEnumerable`1" />. </para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Linq.XNode" /> on which to evaluate the XPath expression.</param>
         <param name="expression">
@@ -137,7 +146,6 @@
         <Parameter Name="resolver" Type="System.Xml.IXmlNamespaceResolver" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use this method to evaluate XPath expressions that contain namespace prefixes.</para>
@@ -148,6 +156,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evaluates an XPath expression, resolving namespace prefixes using the specified <see cref="T:System.Xml.IXmlNamespaceResolver" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that contains the result of evaluating the expression. The object can be a bool, a double, a string, or an <see cref="T:System.Collections.Generic.IEnumerable`1" />.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Linq.XNode" /> on which to evaluate the XPath expression.</param>
         <param name="expression">
@@ -171,12 +183,15 @@
         <Parameter Name="expression" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Selects an <see cref="T:System.Xml.Linq.XElement" /> using a XPath expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XElement" />, or null.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Linq.XNode" /> on which to evaluate the XPath expression.</param>
         <param name="expression">
@@ -199,7 +214,6 @@
         <Parameter Name="resolver" Type="System.Xml.IXmlNamespaceResolver" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use this method to evaluate XPath expressions that contain namespace prefixes.</para>
@@ -208,6 +222,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Selects an <see cref="T:System.Xml.Linq.XElement" /> using a XPath expression, resolving namespace prefixes using the specified <see cref="T:System.Xml.IXmlNamespaceResolver" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Xml.Linq.XElement" />, or null.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Linq.XNode" /> on which to evaluate the XPath expression.</param>
         <param name="expression">
@@ -231,7 +249,6 @@
         <Parameter Name="expression" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Although the ordering of returned collections is not specified in the XML XPath Language 1.0 Recommendation, this extension method returns nodes in document order.</para>
@@ -241,6 +258,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Selects a collection of elements using an XPath expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> that contains the selected elements.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Linq.XNode" /> on which to evaluate the XPath expression.</param>
         <param name="expression">
@@ -263,7 +284,6 @@
         <Parameter Name="resolver" Type="System.Xml.IXmlNamespaceResolver" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use this method to evaluate XPath expressions that contain namespace prefixes.</para>
@@ -274,6 +294,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Selects a collection of elements using an XPath expression, resolving namespace prefixes using the specified <see cref="T:System.Xml.IXmlNamespaceResolver" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> of <see cref="T:System.Xml.Linq.XElement" /> that contains the selected elements.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.Linq.XNode" /> on which to evaluate the XPath expression.</param>
         <param name="expression">
diff --git a/mcs/class/System/Documentation/en/Microsoft.CSharp/CSharpCodeProvider.xml b/mcs/class/System/Documentation/en/Microsoft.CSharp/CSharpCodeProvider.xml
index 1e4b333d401..641af01c036 100644
--- a/mcs/class/System/Documentation/en/Microsoft.CSharp/CSharpCodeProvider.xml
+++ b/mcs/class/System/Documentation/en/Microsoft.CSharp/CSharpCodeProvider.xml
@@ -87,12 +87,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an instance of the C# code compiler.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the C# <see cref="T:System.CodeDom.Compiler.ICodeCompiler" /> implementation.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateGenerator">
@@ -114,12 +117,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an instance of the C# code generator.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the C# <see cref="T:System.CodeDom.Compiler.ICodeGenerator" /> implementation.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="FileExtension">
@@ -206,7 +212,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A derived class can override this method to provide specific types of type converters for specific data types.</para>
@@ -215,6 +220,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.ComponentModel.TypeConverter" /> for the specified type of object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter" /> for the specified type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of object to retrieve a type converter for. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/Microsoft.VisualBasic/VBCodeProvider.xml b/mcs/class/System/Documentation/en/Microsoft.VisualBasic/VBCodeProvider.xml
index d4e96fbce26..d86d1408199 100644
--- a/mcs/class/System/Documentation/en/Microsoft.VisualBasic/VBCodeProvider.xml
+++ b/mcs/class/System/Documentation/en/Microsoft.VisualBasic/VBCodeProvider.xml
@@ -87,12 +87,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an instance of the Visual Basic code compiler.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the Visual Basic <see cref="T:System.CodeDom.Compiler.ICodeCompiler" /> implementation.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateGenerator">
@@ -114,12 +117,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an instance of the Visual Basic code generator.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the Visual Basic <see cref="T:System.CodeDom.Compiler.ICodeGenerator" /> implementation.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="FileExtension">
@@ -201,7 +207,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A derived class can override this method to provide specific types of type converters for specific data types.</para>
@@ -210,6 +215,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.ComponentModel.TypeConverter" /> for the specified type of object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter" /> for the specified type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of object to retrieve a type converter for. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/Microsoft.Win32/IntranetZoneCredentialPolicy.xml b/mcs/class/System/Documentation/en/Microsoft.Win32/IntranetZoneCredentialPolicy.xml
index eb403b80b15..c5d7d05c898 100644
--- a/mcs/class/System/Documentation/en/Microsoft.Win32/IntranetZoneCredentialPolicy.xml
+++ b/mcs/class/System/Documentation/en/Microsoft.Win32/IntranetZoneCredentialPolicy.xml
@@ -72,7 +72,6 @@
         <Parameter Name="authModule" Type="System.Net.IAuthenticationModule" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -83,6 +82,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Boolean" /> that indicates whether the client's credentials are sent with a request for a resource that was made using <see cref="T:System.Net.WebRequest" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the requested resource is in the same domain as the client making the request; otherwise, false.</para>
+        </returns>
         <param name="challengeUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Uri" /> that will receive the request.</param>
         <param name="request">
diff --git a/mcs/class/System/Documentation/en/Microsoft.Win32/SystemEvents.xml b/mcs/class/System/Documentation/en/Microsoft.Win32/SystemEvents.xml
index 766f32e72ff..ed9c474de22 100644
--- a/mcs/class/System/Documentation/en/Microsoft.Win32/SystemEvents.xml
+++ b/mcs/class/System/Documentation/en/Microsoft.Win32/SystemEvents.xml
@@ -46,12 +46,15 @@
         <Parameter Name="interval" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new window timer associated with the system events window.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The ID of the new timer.</para>
+        </returns>
         <param name="interval">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies the interval between timer notifications, in milliseconds.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.CodeDom.Compiler/CodeCompiler.xml b/mcs/class/System/Documentation/en/System.CodeDom.Compiler/CodeCompiler.xml
index eac7136fee3..c3dc6b9d819 100644
--- a/mcs/class/System/Documentation/en/System.CodeDom.Compiler/CodeCompiler.xml
+++ b/mcs/class/System/Documentation/en/System.CodeDom.Compiler/CodeCompiler.xml
@@ -69,12 +69,15 @@
         <Parameter Name="options" Type="System.CodeDom.Compiler.CompilerParameters" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the command arguments to be passed to the compiler from the specified <see cref="T:System.CodeDom.Compiler.CompilerParameters" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The command arguments.</para>
+        </returns>
         <param name="options">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.Compiler.CompilerParameters" /> that indicates the compiler options. </param>
       </Docs>
@@ -144,12 +147,15 @@
         <Parameter Name="e" Type="System.CodeDom.CodeCompileUnit" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'CompilerResults'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compiles the specified compile unit using the specified options, and returns the results from the compilation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The results of compilation.</para>
+        </returns>
         <param name="options">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.Compiler.CompilerParameters" /> object that indicates the compiler options. </param>
         <param name="e">
@@ -173,12 +179,15 @@
         <Parameter Name="ea" Type="System.CodeDom.CodeCompileUnit[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'CompilerResults'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compiles the specified compile units using the specified options, and returns the results from the compilation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The results of compilation.</para>
+        </returns>
         <param name="options">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.Compiler.CompilerParameters" /> object that indicates the compiler options. </param>
         <param name="ea">
@@ -202,12 +211,15 @@
         <Parameter Name="fileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'CompilerResults'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compiles the specified file using the specified options, and returns the results from the compilation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The results of compilation.</para>
+        </returns>
         <param name="options">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.Compiler.CompilerParameters" /> object that indicates the compiler options. </param>
         <param name="fileName">
@@ -231,12 +243,15 @@
         <Parameter Name="fileNames" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'CompilerResults'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compiles the specified files using the specified options, and returns the results from the compilation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The results of compilation.</para>
+        </returns>
         <param name="options">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.Compiler.CompilerParameters" /> object that indicates the compiler options. </param>
         <param name="fileNames">
@@ -260,12 +275,15 @@
         <Parameter Name="source" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'CompilerResults'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compiles the specified source code string using the specified options, and returns the results from the compilation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The results of compilation.</para>
+        </returns>
         <param name="options">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.Compiler.CompilerParameters" /> object that indicates the compiler options. </param>
         <param name="source">
@@ -289,12 +307,15 @@
         <Parameter Name="sources" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'CompilerResults'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compiles the specified source code strings using the specified options, and returns the results from the compilation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The results of compilation.</para>
+        </returns>
         <param name="options">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.Compiler.CompilerParameters" /> object that indicates the compiler options. </param>
         <param name="sources">
@@ -323,12 +344,15 @@
         <Parameter Name="cmdArgs" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the command arguments to use when invoking the compiler to generate a response file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The command arguments to use to generate a response file, or null if there are no response file arguments.</para>
+        </returns>
         <param name="options">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.Compiler.CompilerParameters" /> object that indicates the compiler options. </param>
         <param name="cmdArgs">
@@ -352,12 +376,15 @@
         <Parameter Name="separator" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Joins the specified string arrays.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The concatenated string.</para>
+        </returns>
         <param name="sa">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of strings to join. </param>
         <param name="separator">
@@ -409,7 +436,6 @@
         <Parameter Name="e" Type="System.CodeDom.CodeCompileUnit" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.CodeDom.Compiler.CodeCompiler" /> instance is cast to an <see cref="T:System.CodeDom.Compiler.ICodeCompiler" /> interface.</para>
@@ -418,6 +444,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.CodeDom.Compiler.ICodeCompiler.CompileAssemblyFromDom(System.CodeDom.Compiler.CompilerParameters,System.CodeDom.CodeCompileUnit)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The results of compilation.</para>
+        </returns>
         <param name="options">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.Compiler.CompilerParameters" /> object that indicates the compiler options. </param>
         <param name="e">
@@ -441,7 +471,6 @@
         <Parameter Name="ea" Type="System.CodeDom.CodeCompileUnit[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.CodeDom.Compiler.CodeCompiler" /> instance is cast to an <see cref="T:System.CodeDom.Compiler.ICodeCompiler" /> interface.</para>
@@ -450,6 +479,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.CodeDom.Compiler.ICodeCompiler.CompileAssemblyFromDomBatch(System.CodeDom.Compiler.CompilerParameters,System.CodeDom.CodeCompileUnit[])" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The results of compilation.</para>
+        </returns>
         <param name="options">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.Compiler.CompilerParameters" /> object that indicates the compiler options. </param>
         <param name="ea">
@@ -473,7 +506,6 @@
         <Parameter Name="fileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.CodeDom.Compiler.CodeCompiler" /> instance is cast to an <see cref="T:System.CodeDom.Compiler.ICodeCompiler" /> interface.</para>
@@ -482,6 +514,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.CodeDom.Compiler.ICodeCompiler.CompileAssemblyFromFile(System.CodeDom.Compiler.CompilerParameters,System.String)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The results of compilation.</para>
+        </returns>
         <param name="options">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.Compiler.CompilerParameters" /> object that indicates the compiler options. </param>
         <param name="fileName">
@@ -505,7 +541,6 @@
         <Parameter Name="fileNames" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.CodeDom.Compiler.CodeCompiler" /> instance is cast to an <see cref="T:System.CodeDom.Compiler.ICodeCompiler" /> interface.</para>
@@ -514,6 +549,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.CodeDom.Compiler.ICodeCompiler.CompileAssemblyFromFileBatch(System.CodeDom.Compiler.CompilerParameters,System.String[])" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The results of compilation.</para>
+        </returns>
         <param name="options">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.Compiler.CompilerParameters" /> object that indicates the compiler options. </param>
         <param name="fileNames">
@@ -537,7 +576,6 @@
         <Parameter Name="source" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.CodeDom.Compiler.CodeCompiler" /> instance is cast to an <see cref="T:System.CodeDom.Compiler.ICodeCompiler" /> interface.</para>
@@ -546,6 +584,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.CodeDom.Compiler.ICodeCompiler.CompileAssemblyFromSource(System.CodeDom.Compiler.CompilerParameters,System.String)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The results of compilation.</para>
+        </returns>
         <param name="options">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.Compiler.CompilerParameters" /> object that indicates the compiler options. </param>
         <param name="source">
@@ -569,7 +611,6 @@
         <Parameter Name="sources" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.CodeDom.Compiler.CodeCompiler" /> instance is cast to an <see cref="T:System.CodeDom.Compiler.ICodeCompiler" /> interface.</para>
@@ -578,6 +619,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.CodeDom.Compiler.ICodeCompiler.CompileAssemblyFromSourceBatch(System.CodeDom.Compiler.CompilerParameters,System.String[])" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The results of compilation.</para>
+        </returns>
         <param name="options">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.Compiler.CompilerParameters" /> object that indicates the compiler options. </param>
         <param name="sources">
diff --git a/mcs/class/System/Documentation/en/System.CodeDom.Compiler/CodeDomProvider.xml b/mcs/class/System/Documentation/en/System.CodeDom.Compiler/CodeDomProvider.xml
index 913af0cc2f1..2db98b9cd53 100644
--- a/mcs/class/System/Documentation/en/System.CodeDom.Compiler/CodeDomProvider.xml
+++ b/mcs/class/System/Documentation/en/System.CodeDom.Compiler/CodeDomProvider.xml
@@ -86,7 +86,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -97,6 +96,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compiles an assembly based on the <see cref="N:System.CodeDom" /> trees contained in the specified array of <see cref="T:System.CodeDom.CodeCompileUnit" /> objects, using the specified compiler settings.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.Compiler.CompilerResults" /> object that indicates the results of the compilation.</para>
+        </returns>
         <param name="options">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.Compiler.CompilerParameters" /> object that indicates the settings for the compilation.</param>
         <param name="compilationUnits">
@@ -125,7 +128,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -136,6 +138,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compiles an assembly from the source code contained in the specified files, using the specified compiler settings.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.Compiler.CompilerResults" /> object that indicates the results of compilation.</para>
+        </returns>
         <param name="options">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.Compiler.CompilerParameters" /> object that indicates the settings for the compilation. </param>
         <param name="fileNames">
@@ -164,7 +170,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -175,6 +180,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compiles an assembly from the specified array of strings containing source code, using the specified compiler settings.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.Compiler.CompilerResults" /> object that indicates the results of compilation.</para>
+        </returns>
         <param name="options">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.Compiler.CompilerParameters" /> object that indicates the compiler settings for this compilation. </param>
         <param name="sources">
@@ -200,7 +209,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ICodeCompiler'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is obsolete in the dnprdnext. The recommended alternative is to call the <see cref="T:System.CodeDom.Compiler.ICodeCompiler" /> methods that are directly available in the code provider.</para>
@@ -209,6 +217,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates a new code compiler. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.CodeDom.Compiler.ICodeCompiler" /> that can be used for compilation of <see cref="N:System.CodeDom" /> based source code representations. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateEscapedIdentifier">
@@ -226,7 +238,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -239,6 +250,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an escaped identifier for the specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The escaped identifier for the value.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string for which to create an escaped identifier.</param>
       </Docs>
@@ -262,7 +277,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ICodeGenerator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is obsolete in the dnprdnext. The recommended alternative is to call the <see cref="T:System.CodeDom.Compiler.ICodeGenerator" /> methods that are directly available in the <see cref="T:System.CodeDom.Compiler.CodeDomProvider" /> class.</para>
@@ -271,6 +285,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates a new code generator.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.CodeDom.Compiler.ICodeGenerator" /> that can be used to generate <see cref="N:System.CodeDom" /> based source code representations.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateGenerator">
@@ -289,7 +307,6 @@
         <Parameter Name="output" Type="System.IO.TextWriter" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ICodeGenerator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses the specified <see cref="T:System.IO.TextWriter" /> for output. This method supports more optimized code generation that incrementally updates the source code.</para>
@@ -301,6 +318,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates a new code generator using the specified <see cref="T:System.IO.TextWriter" /> for output.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.CodeDom.Compiler.ICodeGenerator" /> that can be used to generate <see cref="N:System.CodeDom" /> based source code representations.</para>
+        </returns>
         <param name="output">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IO.TextWriter" /> to use to output. </param>
       </Docs>
@@ -321,7 +342,6 @@
         <Parameter Name="fileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ICodeGenerator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses the specified file name for output.</para>
@@ -333,6 +353,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates a new code generator using the specified file name for output.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.CodeDom.Compiler.ICodeGenerator" /> that can be used to generate <see cref="N:System.CodeDom" /> based source code representations.</para>
+        </returns>
         <param name="fileName">
           <attribution license="cc4" from="Microsoft" modified="false" />The file name to output to. </param>
       </Docs>
@@ -356,12 +380,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ICodeParser'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates a new code parser.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.CodeDom.Compiler.ICodeParser" /> that can be used to parse source code. The base implementation always returns null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateProvider">
@@ -384,7 +411,6 @@
         <Parameter Name="language" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -402,6 +428,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.CodeDom.Compiler.CodeDomProvider" /> instance for the specified language.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A CodeDOM provider that is implemented for the specified language name.</para>
+        </returns>
         <param name="language">
           <attribution license="cc4" from="Microsoft" modified="false" />The language name. </param>
       </Docs>
@@ -426,7 +456,6 @@
         <Parameter Name="providerOptions" Type="System.Collections.Generic.IDictionary&lt;System.String,System.String&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -439,6 +468,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.CodeDom.Compiler.CodeDomProvider" /> instance for the specified language and provider options.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A CodeDOM provider that is implemented for the specified language name and options.</para>
+        </returns>
         <param name="language">
           <attribution license="cc4" from="Microsoft" modified="false" />The language name.</param>
         <param name="providerOptions">
@@ -460,7 +493,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -473,6 +505,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a valid identifier for the specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A valid identifier for the specified value.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string for which to generate a valid identifier.</param>
       </Docs>
@@ -727,7 +763,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.CodeDom.Compiler.CodeDomProvider.GetAllCompilerInfo" /> method to enumerate the language provider settings on a computer. </para>
@@ -739,6 +774,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the language provider and compiler configuration settings for this computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.CodeDom.Compiler.CompilerInfo" /> representing the settings of all configured <see cref="T:System.CodeDom.Compiler.CodeDomProvider" /> implementations.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetCompilerInfo">
@@ -761,7 +800,6 @@
         <Parameter Name="language" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <format type="text/html"><a href="672a68f7-e69f-4479-ac30-e980085ec4fe">&lt;system.codedom&gt;</a></format> in the machine configuration file contains the language provider and compiler configuration settings for each <see cref="T:System.CodeDom.Compiler.CodeDomProvider" /> implementation on the computer. For information about machine configuration files, see the Machine Configuration Files section in <format type="text/html"><a href="86bd26d3-737e-4484-9782-19b17f34cd1f">Configuration Files</a></format>. The <see cref="M:System.CodeDom.Compiler.CodeDomProvider.GetCompilerInfo(System.String)" /> method searches each provider configuration element for the specified language name. The returned <see cref="T:System.CodeDom.Compiler.CompilerInfo" /> instance contains the configured language provider and compiler settings.</para>
@@ -773,6 +811,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the language provider and compiler configuration settings for the specified language.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.Compiler.CompilerInfo" /> object populated with settings of the configured <see cref="T:System.CodeDom.Compiler.CodeDomProvider" /> implementation.</para>
+        </returns>
         <param name="language">
           <attribution license="cc4" from="Microsoft" modified="false" />A language name. </param>
       </Docs>
@@ -793,7 +835,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ComponentModel.TypeConverter'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A derived class can override this method to provide specific types of type converters for specific data types.</para>
@@ -802,6 +843,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.ComponentModel.TypeConverter" /> for the specified data type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter" /> for the specified type, or null if a <see cref="T:System.ComponentModel.TypeConverter" /> for the specified type cannot be found.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of object to retrieve a type converter for. </param>
       </Docs>
@@ -826,7 +871,6 @@
         <Parameter Name="extension" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <format type="text/html"><a href="672a68f7-e69f-4479-ac30-e980085ec4fe">&lt;system.codedom&gt;</a></format> in the machine configuration file (Machine.config) contains the language provider and compiler configuration settings for each <see cref="T:System.CodeDom.Compiler.CodeDomProvider" /> implementation on the computer. The <see cref="M:System.CodeDom.Compiler.CodeDomProvider.GetLanguageFromExtension(System.String)" /> method searches each provider configuration element for the specified file name extension.</para>
@@ -838,6 +882,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a language name associated with the specified file name extension, as configured in the <see cref="T:System.CodeDom.Compiler.CodeDomProvider" /> compiler configuration section.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A language name associated with the file name extension, as configured in the <see cref="T:System.CodeDom.Compiler.CodeDomProvider" /> compiler configuration settings.</para>
+        </returns>
         <param name="extension">
           <attribution license="cc4" from="Microsoft" modified="false" />A file name extension. </param>
       </Docs>
@@ -857,7 +905,6 @@
         <Parameter Name="type" Type="System.CodeDom.CodeTypeReference" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -868,6 +915,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the type indicated by the specified <see cref="T:System.CodeDom.CodeTypeReference" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A text representation of the specified type, formatted for the language in which code is generated by this code generator. In Visual Basic, for example, passing in a <see cref="T:System.CodeDom.CodeTypeReference" /> for the <see cref="T:System.Int32" /> type will return "Integer".</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.CodeTypeReference" /> that indicates the type to return.</param>
       </Docs>
@@ -892,7 +943,6 @@
         <Parameter Name="extension" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <format type="text/html"><a href="672a68f7-e69f-4479-ac30-e980085ec4fe">&lt;system.codedom&gt;</a></format> in the machine configuration file (Machine.config) contains the language provider and compiler configuration settings for each <see cref="T:System.CodeDom.Compiler.CodeDomProvider" /> implementation on the computer. The <see cref="M:System.CodeDom.Compiler.CodeDomProvider.IsDefinedExtension(System.String)" /> method searches the provider configuration elements for the specified file name extension.</para>
@@ -902,6 +952,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether a file name extension has an associated <see cref="T:System.CodeDom.Compiler.CodeDomProvider" /> implementation configured on the computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a <see cref="T:System.CodeDom.Compiler.CodeDomProvider" /> implementation is configured for the specified file name extension; otherwise, false.</para>
+        </returns>
         <param name="extension">
           <attribution license="cc4" from="Microsoft" modified="false" />A file name extension. </param>
       </Docs>
@@ -926,7 +980,6 @@
         <Parameter Name="language" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <format type="text/html"><a href="672a68f7-e69f-4479-ac30-e980085ec4fe">&lt;system.codedom&gt;</a></format> in the machine configuration file (Machine.config) contains the language provider and compiler configuration settings for each <see cref="T:System.CodeDom.Compiler.CodeDomProvider" /> implementation on the computer. The <see cref="M:System.CodeDom.Compiler.CodeDomProvider.IsDefinedLanguage(System.String)" /> method searches the provider configuration elements for the specified language name.</para>
@@ -936,6 +989,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether a language has a <see cref="T:System.CodeDom.Compiler.CodeDomProvider" /> implementation configured on the computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a <see cref="T:System.CodeDom.Compiler.CodeDomProvider" /> implementation is configured for the specified language; otherwise, false.</para>
+        </returns>
         <param name="language">
           <attribution license="cc4" from="Microsoft" modified="false" />The language name. </param>
       </Docs>
@@ -955,7 +1012,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method tests whether an identifier is valid. The <see cref="M:System.CodeDom.Compiler.CodeDomProvider.IsValidIdentifier(System.String)" /> method is provider specific. Identifiers that are valid for one provider might not be valid for other providers. If <paramref name="value" /> contains characters outside of the ASCII character range, check the identifier for all the languages that might be used to compile the code.</para>
@@ -967,6 +1023,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the specified value is a valid identifier for the current language.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="value" /> parameter is a valid identifier; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to verify as a valid identifier.</param>
       </Docs>
@@ -1007,7 +1067,6 @@
         <Parameter Name="codeStream" Type="System.IO.TextReader" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1018,6 +1077,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compiles the code read from the specified text stream into a <see cref="T:System.CodeDom.CodeCompileUnit" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.CodeCompileUnit" /> that contains a representation of the parsed code.</para>
+        </returns>
         <param name="codeStream">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IO.TextReader" /> object that is used to read the code to be parsed. </param>
       </Docs>
@@ -1038,7 +1101,6 @@
       </Parameters>
       <Docs>
         <param name="supports">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be called with a number of <see cref="T:System.CodeDom.Compiler.GeneratorSupport" /> flags at once to test for a set of capabilities by joining a set of appropriate capability flags together with a binary OR operator (|).</para>
@@ -1050,6 +1112,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified code generation support is provided.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified code generation support is provided; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.CodeDom.Compiler/CodeGenerator.xml b/mcs/class/System/Documentation/en/System.CodeDom.Compiler/CodeGenerator.xml
index 7bc8727cf73..0393951aaa8 100644
--- a/mcs/class/System/Documentation/en/System.CodeDom.Compiler/CodeGenerator.xml
+++ b/mcs/class/System/Documentation/en/System.CodeDom.Compiler/CodeGenerator.xml
@@ -93,7 +93,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -106,6 +105,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an escaped identifier for the specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The escaped identifier for the value.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to create an escaped identifier for. </param>
       </Docs>
@@ -126,7 +129,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -139,6 +141,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a valid identifier for the specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A valid identifier for the value.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string to create a valid identifier for. </param>
       </Docs>
@@ -2090,12 +2096,15 @@
       </Parameters>
       <Docs>
         <param name="type">To be added: an object of type 'CodeDom.CodeTypeReference'</param>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the name of the specified data type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the data type reference.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Indent">
@@ -2243,12 +2252,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified value is a valid identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value is a valid identifier; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to test for conflicts with valid identifiers. </param>
       </Docs>
@@ -2269,7 +2281,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method checks the specified string to ensure that it does not contain certain characters that can be used to escape an identifier field. The <see cref="M:System.CodeDom.Compiler.CodeGenerator.ValidateIdentifiers(System.CodeDom.CodeObject)" /> method calls this method to perform string validation. Calling the <see cref="M:System.CodeDom.Compiler.CodeGenerator.ValidateIdentifiers(System.CodeDom.CodeObject)" /> method and passing a <see cref="T:System.CodeDom.CodeCompileUnit" /> before generating code from it can prevent the use of certain character sequences to include hidden code within an identifier field.</para>
@@ -2278,6 +2289,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified string is a valid identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified string is a valid identifier; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to test for validity. </param>
       </Docs>
@@ -2718,7 +2733,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns a modified version of the specified string that has been formatted with escape code characters. For example, /" might be used to represent ". These escape codes are used to replace elements of the specified string that might otherwise conflict with language syntax.</para>
@@ -2727,6 +2741,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string by formatting it with escape codes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted string.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert. </param>
       </Docs>
@@ -2748,12 +2766,15 @@
       </Parameters>
       <Docs>
         <param name="supports">To be added: an object of type 'GeneratorSupport'</param>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified code generation support is provided.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified code generation support is provided; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.CodeDom.Compiler.ICodeGenerator.CreateEscapedIdentifier">
@@ -2772,12 +2793,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an escaped identifier for the specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The escaped identifier for the value.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to create an escaped identifier for.</param>
       </Docs>
@@ -2798,12 +2822,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a valid identifier for the specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A valid identifier for the specified value.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to generate a valid identifier for.</param>
       </Docs>
@@ -2964,12 +2991,15 @@
         <Parameter Name="type" Type="System.CodeDom.CodeTypeReference" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the type indicated by the specified <see cref="T:System.CodeDom.CodeTypeReference" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the data type reference.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to return.</param>
       </Docs>
@@ -2990,12 +3020,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the specified value is a valid identifier for the current language.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="value" /> parameter is a valid identifier; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to test.</param>
       </Docs>
@@ -3017,12 +3050,15 @@
       </Parameters>
       <Docs>
         <param name="value">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the generator provides support for the language features represented by the specified <see cref="T:System.CodeDom.Compiler.GeneratorSupport" />  object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified capabilities are supported; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.CodeDom.Compiler.ICodeGenerator.ValidateIdentifier">
diff --git a/mcs/class/System/Documentation/en/System.CodeDom.Compiler/CodeParser.xml b/mcs/class/System/Documentation/en/System.CodeDom.Compiler/CodeParser.xml
index 2fa96974d52..33dfe373a0e 100644
--- a/mcs/class/System/Documentation/en/System.CodeDom.Compiler/CodeParser.xml
+++ b/mcs/class/System/Documentation/en/System.CodeDom.Compiler/CodeParser.xml
@@ -68,12 +68,15 @@
         <Parameter Name="codeStream" Type="System.IO.TextReader" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'CodeDom.CodeCompileUnit'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compiles the specified text stream into a <see cref="T:System.CodeDom.CodeCompileUnit" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.CodeCompileUnit" /> containing the code model produced from parsing the code.</para>
+        </returns>
         <param name="codeStream">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IO.TextReader" /> that is used to read the code to be parsed. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.CodeDom.Compiler/CompilerError.xml b/mcs/class/System/Documentation/en/System.CodeDom.Compiler/CompilerError.xml
index 7c2d978b448..2843c804f0c 100644
--- a/mcs/class/System/Documentation/en/System.CodeDom.Compiler/CompilerError.xml
+++ b/mcs/class/System/Documentation/en/System.CodeDom.Compiler/CompilerError.xml
@@ -245,7 +245,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is supported so <see cref="T:System.CodeDom.Compiler.CompilerError" /> objects can be treated as objects for simplified debugging output.</para>
@@ -254,6 +253,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides an implementation of Object's <see cref="M:System.Object.ToString" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the compiler error.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.CodeDom.Compiler/CompilerErrorCollection.xml b/mcs/class/System/Documentation/en/System.CodeDom.Compiler/CompilerErrorCollection.xml
index dac472c19c7..3cb70401b1a 100644
--- a/mcs/class/System/Documentation/en/System.CodeDom.Compiler/CompilerErrorCollection.xml
+++ b/mcs/class/System/Documentation/en/System.CodeDom.Compiler/CompilerErrorCollection.xml
@@ -111,12 +111,15 @@
         <Parameter Name="value" Type="System.CodeDom.Compiler.CompilerError" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.CodeDom.Compiler.CompilerError" /> object to the error collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.Compiler.CompilerError" /> object to add. </param>
       </Docs>
@@ -187,12 +190,15 @@
         <Parameter Name="value" Type="System.CodeDom.Compiler.CompilerError" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the collection contains the specified <see cref="T:System.CodeDom.Compiler.CompilerError" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.CodeDom.Compiler.CompilerError" /> is contained in the collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.Compiler.CompilerError" /> to locate. </param>
       </Docs>
@@ -283,12 +289,15 @@
         <Parameter Name="value" Type="System.CodeDom.Compiler.CompilerError" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the specified <see cref="T:System.CodeDom.Compiler.CompilerError" /> object in the collection, if it exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified <see cref="T:System.CodeDom.Compiler.CompilerError" /> in the <see cref="T:System.CodeDom.Compiler.CompilerErrorCollection" />, if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.Compiler.CompilerError" /> to locate. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.CodeDom.Compiler/CompilerInfo.xml b/mcs/class/System/Documentation/en/System.CodeDom.Compiler/CompilerInfo.xml
index b0286385570..ccaa5c49624 100644
--- a/mcs/class/System/Documentation/en/System.CodeDom.Compiler/CompilerInfo.xml
+++ b/mcs/class/System/Documentation/en/System.CodeDom.Compiler/CompilerInfo.xml
@@ -67,7 +67,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -79,6 +78,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the configured compiler settings for the language provider implementation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A read-only <see cref="T:System.CodeDom.Compiler.CompilerParameters" /> instance that contains the compiler options and settings configured for the language provider. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateProvider">
@@ -94,7 +97,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -105,6 +107,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.CodeDom.Compiler.CodeDomProvider" /> instance for the current language provider settings.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A CodeDOM provider associated with the language provider configuration. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateProvider">
@@ -121,7 +127,6 @@
         <Parameter Name="providerOptions" Type="System.Collections.Generic.IDictionary&lt;System.String,System.String&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.CodeDom.Compiler.CompilerInfo.CreateProvider(System.Collections.Generic.IDictionary{System.String,System.String})" /> method returns a <see cref="T:System.CodeDom.Compiler.CodeDomProvider" /> instance for the current language provider settings and the specified provider options. For information about supported provider options, see the specific CodeDOM provider documentation.</para>
@@ -131,6 +136,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.CodeDom.Compiler.CodeDomProvider" /> instance for the current language provider settings and specified options.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A CodeDOM provider associated with the language provider configuration and specified options.</para>
+        </returns>
         <param name="providerOptions">
           <attribution license="cc4" from="Microsoft" modified="false" />A collection of provider options from the configuration file.</param>
       </Docs>
@@ -150,7 +159,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -169,6 +177,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified object represents the same language provider and compiler settings as the current <see cref="T:System.CodeDom.Compiler.CompilerInfo" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="o" /> is a <see cref="T:System.CodeDom.Compiler.CompilerInfo" /> object and its value is the same as this instance; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current <see cref="T:System.CodeDom.Compiler.CompilerInfo" />. </param>
       </Docs>
@@ -186,7 +198,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -196,6 +207,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the file name extensions supported by the language provider.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of file name extensions supported by the language provider.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -211,7 +226,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -222,6 +236,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code for the current <see cref="T:System.CodeDom.Compiler.CompilerInfo" /> instance, suitable for use in hashing algorithms and data structures such as a hash table. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetLanguages">
@@ -237,7 +255,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -247,6 +264,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the language names supported by the language provider.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of language names supported by the language provider.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsCodeDomProviderTypeValid">
diff --git a/mcs/class/System/Documentation/en/System.CodeDom.Compiler/Executor.xml b/mcs/class/System/Documentation/en/System.CodeDom.Compiler/Executor.xml
index cd15488ba23..077fd8bf7f8 100644
--- a/mcs/class/System/Documentation/en/System.CodeDom.Compiler/Executor.xml
+++ b/mcs/class/System/Documentation/en/System.CodeDom.Compiler/Executor.xml
@@ -51,6 +51,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the command using the specified temporary files and waits for the call to return.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value from the compiler.</para>
+        </returns>
         <param name="cmd">
           <attribution license="cc4" from="Microsoft" modified="false" />The command to execute. </param>
         <param name="tempFiles">
diff --git a/mcs/class/System/Documentation/en/System.CodeDom.Compiler/ICodeCompiler.xml b/mcs/class/System/Documentation/en/System.CodeDom.Compiler/ICodeCompiler.xml
index 0b52167a8bc..5b0f551fd0d 100644
--- a/mcs/class/System/Documentation/en/System.CodeDom.Compiler/ICodeCompiler.xml
+++ b/mcs/class/System/Documentation/en/System.CodeDom.Compiler/ICodeCompiler.xml
@@ -45,12 +45,15 @@
         <Parameter Name="compilationUnit" Type="System.CodeDom.CodeCompileUnit" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'CompilerResults'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compiles an assembly from the <see cref="N:System.CodeDom" /> tree contained in the specified <see cref="T:System.CodeDom.CodeCompileUnit" />, using the specified compiler settings.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.Compiler.CompilerResults" /> object that indicates the results of compilation.</para>
+        </returns>
         <param name="options">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.Compiler.CompilerParameters" /> object that indicates the settings for compilation. </param>
         <param name="compilationUnit">
@@ -75,12 +78,15 @@
       </Parameters>
       <Docs>
         <param name="batch">To be added.</param>
-        <returns>To be added: an object of type 'CompilerResults'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compiles an assembly based on the <see cref="N:System.CodeDom" /> trees contained in the specified array of <see cref="T:System.CodeDom.CodeCompileUnit" /> objects, using the specified compiler settings.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.Compiler.CompilerResults" /> object that indicates the results of compilation.</para>
+        </returns>
         <param name="options">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.Compiler.CompilerParameters" /> object that indicates the settings for compilation. </param>
       </Docs>
@@ -102,12 +108,15 @@
         <Parameter Name="fileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'CompilerResults'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compiles an assembly from the source code contained within the specified file, using the specified compiler settings.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.Compiler.CompilerResults" /> object that indicates the results of compilation.</para>
+        </returns>
         <param name="options">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.Compiler.CompilerParameters" /> object that indicates the settings for compilation. </param>
         <param name="fileName">
@@ -132,12 +141,15 @@
       </Parameters>
       <Docs>
         <param name="batch">To be added.</param>
-        <returns>To be added: an object of type 'CompilerResults'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compiles an assembly from the source code contained within the specified files, using the specified compiler settings.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.Compiler.CompilerResults" /> object that indicates the results of compilation.</para>
+        </returns>
         <param name="options">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.Compiler.CompilerParameters" /> object that indicates the settings for compilation. </param>
       </Docs>
@@ -159,12 +171,15 @@
         <Parameter Name="source" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'CompilerResults'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compiles an assembly from the specified string containing source code, using the specified compiler settings.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.Compiler.CompilerResults" /> object that indicates the results of compilation.</para>
+        </returns>
         <param name="options">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.Compiler.CompilerParameters" /> object that indicates the settings for compilation. </param>
         <param name="source">
@@ -189,12 +204,15 @@
       </Parameters>
       <Docs>
         <param name="batch">To be added.</param>
-        <returns>To be added: an object of type 'CompilerResults'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compiles an assembly from the specified array of strings containing source code, using the specified compiler settings.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.Compiler.CompilerResults" /> object that indicates the results of compilation.</para>
+        </returns>
         <param name="options">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.Compiler.CompilerParameters" /> object that indicates the settings for compilation. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.CodeDom.Compiler/ICodeGenerator.xml b/mcs/class/System/Documentation/en/System.CodeDom.Compiler/ICodeGenerator.xml
index f6b70fc30ea..4865f016d30 100644
--- a/mcs/class/System/Documentation/en/System.CodeDom.Compiler/ICodeGenerator.xml
+++ b/mcs/class/System/Documentation/en/System.CodeDom.Compiler/ICodeGenerator.xml
@@ -43,7 +43,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -53,6 +52,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an escaped identifier for the specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The escaped identifier for the value.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to create an escaped identifier for. </param>
       </Docs>
@@ -73,7 +76,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -83,6 +85,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a valid identifier for the specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A valid identifier for the specified value.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to generate a valid identifier for. </param>
       </Docs>
@@ -243,12 +249,15 @@
         <Parameter Name="type" Type="System.CodeDom.CodeTypeReference" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the type indicated by the specified <see cref="T:System.CodeDom.CodeTypeReference" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A text representation of the specified type for the language this code generator is designed to generate code in. For example, in Visual Basic, passing in type System.Int32 will return "Integer".</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.CodeTypeReference" /> that indicates the type to return. </param>
       </Docs>
@@ -269,7 +278,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method tests whether an identifier is valid. When implementing <see cref="M:System.CodeDom.Compiler.ICodeGenerator.IsValidIdentifier(System.String)" /> in a derived class, design the method to test the value passed to it, and return true only if the value fits the rules of the language and does not conflict with a keyword.</para>
@@ -278,6 +286,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the specified value is a valid identifier for the current language.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="value" /> parameter is a valid identifier; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to test for being a valid identifier. </param>
       </Docs>
@@ -298,7 +310,6 @@
         <Parameter Name="supports" Type="System.CodeDom.Compiler.GeneratorSupport" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be called with a number of <see cref="T:System.CodeDom.Compiler.GeneratorSupport" /> flags at once to test for a set of capabilities by joining a set of appropriate capability flags together with a binary "Or" operator (|).</para>
@@ -307,6 +318,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the generator provides support for the language features represented by the specified <see cref="T:System.CodeDom.Compiler.GeneratorSupport" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified capabilities are supported; otherwise, false.</para>
+        </returns>
         <param name="supports">
           <attribution license="cc4" from="Microsoft" modified="false" />The capabilities to test the generator for. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.CodeDom.Compiler/ICodeParser.xml b/mcs/class/System/Documentation/en/System.CodeDom.Compiler/ICodeParser.xml
index ecd613bba47..9e18a1d2237 100644
--- a/mcs/class/System/Documentation/en/System.CodeDom.Compiler/ICodeParser.xml
+++ b/mcs/class/System/Documentation/en/System.CodeDom.Compiler/ICodeParser.xml
@@ -39,12 +39,15 @@
         <Parameter Name="codeStream" Type="System.IO.TextReader" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'CodeDom.CodeCompileUnit'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented in a derived class, compiles the specified text stream into a <see cref="T:System.CodeDom.CodeCompileUnit" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.CodeDom.CodeCompileUnit" /> that contains a representation of the parsed code.</para>
+        </returns>
         <param name="codeStream">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IO.TextReader" /> that can be used to read the code to be compiled. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.CodeDom.Compiler/TempFileCollection.xml b/mcs/class/System/Documentation/en/System.CodeDom.Compiler/TempFileCollection.xml
index 846c102c2cc..e816a1ed9c6 100644
--- a/mcs/class/System/Documentation/en/System.CodeDom.Compiler/TempFileCollection.xml
+++ b/mcs/class/System/Documentation/en/System.CodeDom.Compiler/TempFileCollection.xml
@@ -133,7 +133,6 @@
         <Parameter Name="fileExtension" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns a file name with the specified extension that has been added to the temporary files collection. Other code must still create the file before it can be used.</para>
@@ -143,6 +142,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a file name with the specified file name extension to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A file name with the specified extension that was just added to the collection.</para>
+        </returns>
         <param name="fileExtension">
           <attribution license="cc4" from="Microsoft" modified="false" />The file name extension for the auto-generated temporary file name to add to the collection. </param>
       </Docs>
@@ -164,7 +167,6 @@
         <Parameter Name="keepFile" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns a file name with the specified extension that has been added to the temporary files collection. Other code must still create the file before it can be used.</para>
@@ -174,6 +176,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a file name with the specified file name extension to the collection, using the specified value indicating whether the file should be deleted or retained.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A file name with the specified extension that was just added to the collection.</para>
+        </returns>
         <param name="fileExtension">
           <attribution license="cc4" from="Microsoft" modified="false" />The file name extension for the auto-generated temporary file name to add to the collection. </param>
         <param name="keepFile">
@@ -371,12 +377,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IEnumerator'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an enumerator that can enumerate the members of the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that contains the collection's members.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="KeepFiles">
@@ -522,7 +531,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.CodeDom.Compiler.TempFileCollection" /> instance is cast to an <see cref="T:System.Collections.IEnumerable" /> interface.</para>
@@ -531,6 +539,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through a collection. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.IDisposable.Dispose">
diff --git a/mcs/class/System/Documentation/en/System.CodeDom/CodeAttributeArgumentCollection.xml b/mcs/class/System/Documentation/en/System.CodeDom/CodeAttributeArgumentCollection.xml
index e43ee1e4567..11f85413d6e 100644
--- a/mcs/class/System/Documentation/en/System.CodeDom/CodeAttributeArgumentCollection.xml
+++ b/mcs/class/System/Documentation/en/System.CodeDom/CodeAttributeArgumentCollection.xml
@@ -116,12 +116,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeAttributeArgument" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.CodeDom.CodeAttributeArgument" /> object to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeAttributeArgument" /> object to add. </param>
       </Docs>
@@ -192,12 +195,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeAttributeArgument" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the collection contains the specified <see cref="T:System.CodeDom.CodeAttributeArgument" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the specified object; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeAttributeArgument" /> object to locate in the collection. </param>
       </Docs>
@@ -246,12 +252,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeAttributeArgument" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the specified <see cref="T:System.CodeDom.CodeAttributeArgument" /> object in the collection, if it exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified object, if found, in the collection; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeAttributeArgument" /> object to locate in the collection. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.CodeDom/CodeAttributeDeclarationCollection.xml b/mcs/class/System/Documentation/en/System.CodeDom/CodeAttributeDeclarationCollection.xml
index e2cacc93afa..209ae692a5e 100644
--- a/mcs/class/System/Documentation/en/System.CodeDom/CodeAttributeDeclarationCollection.xml
+++ b/mcs/class/System/Documentation/en/System.CodeDom/CodeAttributeDeclarationCollection.xml
@@ -116,12 +116,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeAttributeDeclaration" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.CodeDom.CodeAttributeDeclaration" /> object with the specified value to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeAttributeDeclaration" /> object to add. </param>
       </Docs>
@@ -192,12 +195,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeAttributeDeclaration" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets or sets a value that indicates whether the collection contains the specified <see cref="T:System.CodeDom.CodeAttributeDeclaration" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the specified object; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeAttributeDeclaration" /> object to locate. </param>
       </Docs>
@@ -246,12 +252,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeAttributeDeclaration" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the specified <see cref="T:System.CodeDom.CodeAttributeDeclaration" /> object in the collection, if it exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index in the collection of the specified object, if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeAttributeDeclaration" /> object to locate in the collection. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.CodeDom/CodeCatchClauseCollection.xml b/mcs/class/System/Documentation/en/System.CodeDom/CodeCatchClauseCollection.xml
index 41d5f478301..bada538ced7 100644
--- a/mcs/class/System/Documentation/en/System.CodeDom/CodeCatchClauseCollection.xml
+++ b/mcs/class/System/Documentation/en/System.CodeDom/CodeCatchClauseCollection.xml
@@ -116,12 +116,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeCatchClause" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.CodeDom.CodeCatchClause" /> object to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeCatchClause" /> object to add. </param>
       </Docs>
@@ -192,12 +195,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeCatchClause" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the collection contains the specified <see cref="T:System.CodeDom.CodeCatchClause" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the specified object; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeCatchClause" /> object to locate in the collection. </param>
       </Docs>
@@ -246,12 +252,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeCatchClause" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the specified <see cref="T:System.CodeDom.CodeCatchClause" /> object in the collection, if it exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified object, if found, in the collection; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeCatchClause" /> object to locate in the collection. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.CodeDom/CodeCommentStatementCollection.xml b/mcs/class/System/Documentation/en/System.CodeDom/CodeCommentStatementCollection.xml
index 1c5f421c0be..cd7b7f73f7f 100644
--- a/mcs/class/System/Documentation/en/System.CodeDom/CodeCommentStatementCollection.xml
+++ b/mcs/class/System/Documentation/en/System.CodeDom/CodeCommentStatementCollection.xml
@@ -116,12 +116,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeCommentStatement" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.CodeDom.CodeCommentStatement" /> object to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeCommentStatement" /> object to add. </param>
       </Docs>
@@ -192,12 +195,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeCommentStatement" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the collection contains the specified <see cref="T:System.CodeDom.CodeCommentStatement" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the specified object; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeCommentStatement" /> to search for in the collection. </param>
       </Docs>
@@ -246,12 +252,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeCommentStatement" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the specified <see cref="T:System.CodeDom.CodeCommentStatement" /> object in the collection, if it exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified object, if found, in the collection; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeCommentStatement" /> object to locate. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.CodeDom/CodeDirectiveCollection.xml b/mcs/class/System/Documentation/en/System.CodeDom/CodeDirectiveCollection.xml
index ff33b4e3eda..68918cc33a5 100644
--- a/mcs/class/System/Documentation/en/System.CodeDom/CodeDirectiveCollection.xml
+++ b/mcs/class/System/Documentation/en/System.CodeDom/CodeDirectiveCollection.xml
@@ -108,13 +108,16 @@
         <Parameter Name="value" Type="System.CodeDom.CodeDirective" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.CodeDom.CodeDirective" /> object to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index position at which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeDirective" /> object to add.</param>
       </Docs>
@@ -184,13 +187,16 @@
         <Parameter Name="value" Type="System.CodeDom.CodeDirective" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the collection contains the specified <see cref="T:System.CodeDom.CodeDirective" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the specified object; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeDirective" /> object to search for in the collection.</param>
       </Docs>
@@ -238,13 +244,16 @@
         <Parameter Name="value" Type="System.CodeDom.CodeDirective" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index in the collection of the specified <see cref="T:System.CodeDom.CodeDirective" /> object, if it exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index position in the collection of the specified object, if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeDirective" /> object to locate in the collection.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.CodeDom/CodeExpressionCollection.xml b/mcs/class/System/Documentation/en/System.CodeDom/CodeExpressionCollection.xml
index 8b480f9ef31..09380adeb01 100644
--- a/mcs/class/System/Documentation/en/System.CodeDom/CodeExpressionCollection.xml
+++ b/mcs/class/System/Documentation/en/System.CodeDom/CodeExpressionCollection.xml
@@ -117,12 +117,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.CodeDom.CodeExpression" /> object to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeExpression" /> object to add. </param>
       </Docs>
@@ -193,12 +196,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the collection contains the specified <see cref="T:System.CodeDom.CodeExpression" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the specified object; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeExpression" /> object to locate in the collection. </param>
       </Docs>
@@ -247,12 +253,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the specified <see cref="T:System.CodeDom.CodeExpression" /> object in the collection, if it exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified object, if found, in the collection; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeExpression" /> object to locate in the collection. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.CodeDom/CodeNamespaceCollection.xml b/mcs/class/System/Documentation/en/System.CodeDom/CodeNamespaceCollection.xml
index 7f695fc050f..be21a0baf71 100644
--- a/mcs/class/System/Documentation/en/System.CodeDom/CodeNamespaceCollection.xml
+++ b/mcs/class/System/Documentation/en/System.CodeDom/CodeNamespaceCollection.xml
@@ -116,12 +116,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeNamespace" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.CodeDom.CodeNamespace" /> object to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeNamespace" /> to add. </param>
       </Docs>
@@ -192,12 +195,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeNamespace" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the collection contains the specified <see cref="T:System.CodeDom.CodeNamespace" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.CodeDom.CodeNamespace" /> is contained in the collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeNamespace" /> to search for in the collection. </param>
       </Docs>
@@ -246,12 +252,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeNamespace" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the specified <see cref="T:System.CodeDom.CodeNamespace" /> object in the <see cref="T:System.CodeDom.CodeNamespaceCollection" />, if it exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified <see cref="T:System.CodeDom.CodeNamespace" />, if it is found, in the collection; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeNamespace" /> to locate. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.CodeDom/CodeNamespaceImportCollection.xml b/mcs/class/System/Documentation/en/System.CodeDom/CodeNamespaceImportCollection.xml
index 8202b1b1e3d..335a1458416 100644
--- a/mcs/class/System/Documentation/en/System.CodeDom/CodeNamespaceImportCollection.xml
+++ b/mcs/class/System/Documentation/en/System.CodeDom/CodeNamespaceImportCollection.xml
@@ -163,12 +163,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IEnumerator'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an enumerator that enumerates the collection members.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that indicates the collection members.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Item">
@@ -301,12 +304,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that can iterate through a collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Add">
@@ -325,7 +331,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.CodeDom.CodeNamespaceImportCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -334,6 +339,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an object to the <see cref="T:System.Collections.IList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position at which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to add to the <see cref="T:System.Collections.IList" />.</param>
       </Docs>
@@ -378,7 +387,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.CodeDom.CodeNamespaceImportCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -387,6 +395,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Collections.IList" /> contains a specific value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value is in the list; otherwise, false. </para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the <see cref="T:System.Collections.IList" />.</param>
       </Docs>
@@ -407,7 +419,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.CodeDom.CodeNamespaceImportCollection" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -416,6 +427,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of a specific item in the <see cref="T:System.Collections.IList" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of <paramref name="value" /> if it is found in the list; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the <see cref="T:System.Collections.IList" />.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.CodeDom/CodeParameterDeclarationExpressionCollection.xml b/mcs/class/System/Documentation/en/System.CodeDom/CodeParameterDeclarationExpressionCollection.xml
index fc4fffa1a67..96764522392 100644
--- a/mcs/class/System/Documentation/en/System.CodeDom/CodeParameterDeclarationExpressionCollection.xml
+++ b/mcs/class/System/Documentation/en/System.CodeDom/CodeParameterDeclarationExpressionCollection.xml
@@ -116,12 +116,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeParameterDeclarationExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.CodeDom.CodeParameterDeclarationExpression" /> to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeParameterDeclarationExpression" /> to add. </param>
       </Docs>
@@ -192,12 +195,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeParameterDeclarationExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the collection contains the specified <see cref="T:System.CodeDom.CodeParameterDeclarationExpression" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the specified object; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.CodeDom.CodeParameterDeclarationExpression" /> to search for in the collection. </param>
       </Docs>
@@ -246,12 +252,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeParameterDeclarationExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index in the collection of the specified <see cref="T:System.CodeDom.CodeParameterDeclarationExpression" />, if it exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index in the collection of the specified object, if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeParameterDeclarationExpression" /> to locate in the collection. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.CodeDom/CodeStatementCollection.xml b/mcs/class/System/Documentation/en/System.CodeDom/CodeStatementCollection.xml
index fc39f41b2f2..a8b0dbcf063 100644
--- a/mcs/class/System/Documentation/en/System.CodeDom/CodeStatementCollection.xml
+++ b/mcs/class/System/Documentation/en/System.CodeDom/CodeStatementCollection.xml
@@ -116,12 +116,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeExpression" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.CodeDom.CodeExpression" /> object to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeExpression" /> object to add. </param>
       </Docs>
@@ -142,12 +145,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeStatement" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.CodeDom.CodeStatement" /> object to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeStatement" /> object to add. </param>
       </Docs>
@@ -218,12 +224,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeStatement" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the collection contains the specified <see cref="T:System.CodeDom.CodeStatement" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the specified object; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeStatement" /> object to search for in the collection. </param>
       </Docs>
@@ -272,12 +281,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeStatement" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the specified <see cref="T:System.CodeDom.CodeStatement" /> object in the <see cref="T:System.CodeDom.CodeStatementCollection" />, if it exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified object, if it is found, in the collection; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeStatement" /> to locate in the collection. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.CodeDom/CodeTypeDeclarationCollection.xml b/mcs/class/System/Documentation/en/System.CodeDom/CodeTypeDeclarationCollection.xml
index 7cb062efd8b..bd7caad6e8b 100644
--- a/mcs/class/System/Documentation/en/System.CodeDom/CodeTypeDeclarationCollection.xml
+++ b/mcs/class/System/Documentation/en/System.CodeDom/CodeTypeDeclarationCollection.xml
@@ -116,12 +116,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeTypeDeclaration" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.CodeDom.CodeTypeDeclaration" /> object to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeTypeDeclaration" /> object to add. </param>
       </Docs>
@@ -192,12 +195,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeTypeDeclaration" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the collection contains the specified <see cref="T:System.CodeDom.CodeTypeDeclaration" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the specified object; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeTypeDeclaration" /> object to search for in the collection. </param>
       </Docs>
@@ -246,12 +252,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeTypeDeclaration" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the specified <see cref="T:System.CodeDom.CodeTypeDeclaration" /> object in the <see cref="T:System.CodeDom.CodeTypeDeclarationCollection" />, if it exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified object, if it is found, in the collection; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeTypeDeclaration" /> to locate in the collection. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.CodeDom/CodeTypeMemberCollection.xml b/mcs/class/System/Documentation/en/System.CodeDom/CodeTypeMemberCollection.xml
index daf7da7ffa5..d2b093039de 100644
--- a/mcs/class/System/Documentation/en/System.CodeDom/CodeTypeMemberCollection.xml
+++ b/mcs/class/System/Documentation/en/System.CodeDom/CodeTypeMemberCollection.xml
@@ -116,12 +116,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeTypeMember" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.CodeDom.CodeTypeMember" /> with the specified value to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeTypeMember" /> to add. </param>
       </Docs>
@@ -192,12 +195,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeTypeMember" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the collection contains the specified <see cref="T:System.CodeDom.CodeTypeMember" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the specified object; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeTypeMember" /> to search for in the collection. </param>
       </Docs>
@@ -246,12 +252,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeTypeMember" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index in the collection of the specified <see cref="T:System.CodeDom.CodeTypeMember" />, if it exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index in the collection of the specified object, if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeTypeMember" /> to locate in the collection. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.CodeDom/CodeTypeParameterCollection.xml b/mcs/class/System/Documentation/en/System.CodeDom/CodeTypeParameterCollection.xml
index f90158a0a84..c5bdfe54ccf 100644
--- a/mcs/class/System/Documentation/en/System.CodeDom/CodeTypeParameterCollection.xml
+++ b/mcs/class/System/Documentation/en/System.CodeDom/CodeTypeParameterCollection.xml
@@ -108,13 +108,16 @@
         <Parameter Name="value" Type="System.CodeDom.CodeTypeParameter" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.CodeDom.CodeTypeParameter" /> object to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index at which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeTypeParameter" /> to add.</param>
       </Docs>
@@ -209,13 +212,16 @@
         <Parameter Name="value" Type="System.CodeDom.CodeTypeParameter" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the collection contains the specified <see cref="T:System.CodeDom.CodeTypeParameter" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.CodeDom.CodeTypeParameter" /> object is contained in the collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeTypeParameter" /> object to search for in the collection.</param>
       </Docs>
@@ -263,13 +269,16 @@
         <Parameter Name="value" Type="System.CodeDom.CodeTypeParameter" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index in the collection of the specified <see cref="T:System.CodeDom.CodeTypeParameter" /> object, if it exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the specified <see cref="T:System.CodeDom.CodeTypeParameter" /> object in the collection if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeTypeParameter" /> object to locate in the collection.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.CodeDom/CodeTypeReferenceCollection.xml b/mcs/class/System/Documentation/en/System.CodeDom/CodeTypeReferenceCollection.xml
index 0c312469601..bf4fdc5c20e 100644
--- a/mcs/class/System/Documentation/en/System.CodeDom/CodeTypeReferenceCollection.xml
+++ b/mcs/class/System/Documentation/en/System.CodeDom/CodeTypeReferenceCollection.xml
@@ -116,12 +116,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeTypeReference" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.CodeDom.CodeTypeReference" /> to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeTypeReference" /> to add. </param>
       </Docs>
@@ -242,12 +245,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeTypeReference" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the collection contains the specified <see cref="T:System.CodeDom.CodeTypeReference" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.CodeDom.CodeTypeReference" /> is contained in the collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeTypeReference" /> to search for in the collection. </param>
       </Docs>
@@ -296,12 +302,15 @@
         <Parameter Name="value" Type="System.CodeDom.CodeTypeReference" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index in the collection of the specified <see cref="T:System.CodeDom.CodeTypeReference" />, if it exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified <see cref="T:System.CodeDom.CodeTypeReference" /> in the collection if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.CodeDom.CodeTypeReference" /> to locate in the collection. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Collections.Concurrent/BlockingCollection`1.xml b/mcs/class/System/Documentation/en/System.Collections.Concurrent/BlockingCollection`1.xml
index bfe648e2a2a..3e723a309c3 100644
--- a/mcs/class/System/Documentation/en/System.Collections.Concurrent/BlockingCollection`1.xml
+++ b/mcs/class/System/Documentation/en/System.Collections.Concurrent/BlockingCollection`1.xml
@@ -377,12 +377,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides a consuming <see cref="T:System.Collections.Generic.IEnumerator`1" /> for items in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> that removes and returns items from the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetConsumingEnumerable">
@@ -399,7 +402,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method enables client code to remove items from the collection by using a foreach loop (For Each in Visual Basic), or <see cref="M:System.Threading.Tasks.Parallel.ForEach``1(System.Collections.Concurrent.Partitioner{``0},System.Action{``0})" /> or a PLINQ query. The enumerator will continue to provide items (if any exist) until <see cref="P:System.Collections.Concurrent.BlockingCollection`1.IsCompleted" /> returns true, and if <see cref="P:System.Collections.Concurrent.BlockingCollection`1.IsCompleted" /> is false the loop blocks until an item becomes available or until the <see cref="T:System.Threading.CancellationToken" /> is cancelled. </para>
@@ -408,6 +410,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides a consuming <see cref="T:System.Collections.Generic.IEnumerable`1" /> for items in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerable`1" /> that removes and returns items from the collection.</para>
+        </returns>
         <param name="cancellationToken">
           <attribution license="cc4" from="Microsoft" modified="false" />A cancellation token to observe.</param>
       </Docs>
@@ -543,12 +549,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides an <see cref="T:System.Collections.IEnumerator" /> for items in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the items in the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Take">
@@ -563,7 +572,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A call to <see cref="M:System.Collections.Concurrent.BlockingCollection`1.Take" /> may block until an item is available to be removed.</para>
@@ -573,6 +581,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes  an item from the <see cref="T:System.Collections.Concurrent.BlockingCollection`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The item removed from the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Take">
@@ -589,7 +601,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A call to <see cref="M:System.Collections.Concurrent.BlockingCollection`1.Take(System.Threading.CancellationToken)" /> may block until an item is available to be removed or the token is canceled.</para>
@@ -599,6 +610,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes an item from the <see cref="T:System.Collections.Concurrent.BlockingCollection`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The item removed from the collection.</para>
+        </returns>
         <param name="cancellationToken">
           <attribution license="cc4" from="Microsoft" modified="false" />Object that can be used to cancel the take operation.</param>
       </Docs>
@@ -661,7 +676,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The copied elements are not removed from the collection. </para>
@@ -671,6 +685,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the items from the <see cref="T:System.Collections.Concurrent.BlockingCollection`1" /> instance into a new array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array containing copies of the elements of the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryAdd">
diff --git a/mcs/class/System/Documentation/en/System.Collections.Concurrent/ConcurrentBag`1.xml b/mcs/class/System/Documentation/en/System.Collections.Concurrent/ConcurrentBag`1.xml
index afce79cfc41..025ef5b0e82 100644
--- a/mcs/class/System/Documentation/en/System.Collections.Concurrent/ConcurrentBag`1.xml
+++ b/mcs/class/System/Documentation/en/System.Collections.Concurrent/ConcurrentBag`1.xml
@@ -152,7 +152,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The enumeration represents a moment-in-time snapshot of the contents of the bag. It does not reflect any updates to the collection after <see cref="M:System.Collections.Concurrent.ConcurrentBag`1.GetEnumerator" /> was called. The enumerator is safe to use concurrently with reads from and writes to the bag.</para>
@@ -161,6 +160,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the <see cref="T:System.Collections.Concurrent.ConcurrentBag`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator for the contents of the <see cref="T:System.Collections.Concurrent.ConcurrentBag`1" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsEmpty">
@@ -278,7 +281,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The items enumerated represent a moment-in-time snapshot of the contents of the bag. It does not reflect any update to the collection after <see cref="M:System.Collections.Concurrent.ConcurrentBag`1.GetEnumerator" /> was called.</para>
@@ -287,6 +289,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the <see cref="T:System.Collections.Concurrent.ConcurrentBag`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator for the contents of the <see cref="T:System.Collections.Concurrent.ConcurrentBag`1" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToArray">
@@ -301,12 +307,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the <see cref="T:System.Collections.Concurrent.ConcurrentBag`1" /> elements to a new array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new array containing a snapshot of elements copied from the <see cref="T:System.Collections.Concurrent.ConcurrentBag`1" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryPeek">
diff --git a/mcs/class/System/Documentation/en/System.Collections.Generic/SortedList`2.xml b/mcs/class/System/Documentation/en/System.Collections.Generic/SortedList`2.xml
index 857a55de109..bdb5f7177aa 100644
--- a/mcs/class/System/Documentation/en/System.Collections.Generic/SortedList`2.xml
+++ b/mcs/class/System/Documentation/en/System.Collections.Generic/SortedList`2.xml
@@ -397,7 +397,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -417,6 +416,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the <see cref="T:System.Collections.Generic.SortedList`2" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerator`1" /> of type <see cref="T:System.Collections.Generic.KeyValuePair`2" /> for the <see cref="T:System.Collections.Generic.SortedList`2" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IndexOfKey">
@@ -880,7 +883,6 @@ finally {
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns false if <paramref name="key" /> is of a type that is not assignable to the key type <paramref name="TKey" /> of the <see cref="T:System.Collections.Generic.SortedList`2" />.</para>
@@ -890,6 +892,10 @@ finally {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Collections.IDictionary" /> contains an element with the specified key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Collections.IDictionary" /> contains an element with the key; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key to locate in the <see cref="T:System.Collections.IDictionary" />.</param>
       </Docs>
@@ -907,7 +913,6 @@ finally {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The foreach statement of the C# language (for each in C++, For Each in Visual Basic) hides the complexity of the enumerators.  Therefore, using foreach is recommended, instead of directly manipulating the enumerator.</para>
@@ -925,6 +930,10 @@ finally {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IDictionaryEnumerator" /> for the <see cref="T:System.Collections.IDictionary" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IDictionaryEnumerator" /> for the <see cref="T:System.Collections.IDictionary" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IDictionary.IsFixedSize">
@@ -1086,7 +1095,6 @@ finally {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The foreach statement of the C# language (for each in C++, For Each in Visual Basic) hides the complexity of the enumerators.  Therefore, using foreach is recommended, instead of directly manipulating the enumerator.</para>
@@ -1104,6 +1112,10 @@ finally {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through a collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TrimExcess">
diff --git a/mcs/class/System/Documentation/en/System.Collections.ObjectModel/ObservableCollection`1.xml b/mcs/class/System/Documentation/en/System.Collections.ObjectModel/ObservableCollection`1.xml
index cfad57c9ed5..551b95f6937 100644
--- a/mcs/class/System/Documentation/en/System.Collections.ObjectModel/ObservableCollection`1.xml
+++ b/mcs/class/System/Documentation/en/System.Collections.ObjectModel/ObservableCollection`1.xml
@@ -133,12 +133,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Disallows reentrant attempts to change this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IDisposable" /> object that can be used to dispose of the object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CheckReentrancy">
diff --git a/mcs/class/System/Documentation/en/System.Collections.Specialized/BitVector32.xml b/mcs/class/System/Documentation/en/System.Collections.Specialized/BitVector32.xml
index ecd2de426a0..2d321ec256e 100644
--- a/mcs/class/System/Documentation/en/System.Collections.Specialized/BitVector32.xml
+++ b/mcs/class/System/Documentation/en/System.Collections.Specialized/BitVector32.xml
@@ -96,7 +96,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use CreateMask() to create the first mask in a series and CreateMask(int) for all subsequent masks.</para>
@@ -109,6 +108,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the first mask in a series of masks that can be used to retrieve individual bits in a <see cref="T:System.Collections.Specialized.BitVector32" /> that is set up as bit flags.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A mask that isolates the first bit flag in the <see cref="T:System.Collections.Specialized.BitVector32" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateMask">
@@ -127,7 +130,6 @@
         <Parameter Name="previous" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use CreateMask() to create the first mask in a series and CreateMask(int) for all subsequent masks.</para>
@@ -140,6 +142,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an additional mask following the specified mask in a series of masks that can be used to retrieve individual bits in a <see cref="T:System.Collections.Specialized.BitVector32" /> that is set up as bit flags.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A mask that isolates the bit flag following the one that <paramref name="previous" /> points to in <see cref="T:System.Collections.Specialized.BitVector32" />.</para>
+        </returns>
         <param name="previous">
           <attribution license="cc4" from="Microsoft" modified="false" />The mask that indicates the previous bit flag. </param>
       </Docs>
@@ -160,7 +166,6 @@
         <Parameter Name="maxValue" Type="System.Int16" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'BitVector32+Section'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A <see cref="T:System.Collections.Specialized.BitVector32.Section" /> is a window into the <see cref="T:System.Collections.Specialized.BitVector32" /> and is composed of the smallest number of consecutive bits that can contain the maximum value specified in <see cref="M:System.Collections.Specialized.BitVector32.CreateSection(System.Int16)" />. For example, a section with a maximum value of 1 is composed of only one bit, whereas a section with a maximum value of 5 is composed of three bits. You can create a <see cref="T:System.Collections.Specialized.BitVector32.Section" /> with a maximum value of 1 to serve as a Boolean, thereby allowing you to store integers and Booleans in the same <see cref="T:System.Collections.Specialized.BitVector32" />.</para>
@@ -171,6 +176,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the first <see cref="T:System.Collections.Specialized.BitVector32.Section" /> in a series of sections that contain small integers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.Specialized.BitVector32.Section" /> that can hold a number from zero to <paramref name="maxValue" />.</para>
+        </returns>
         <param name="maxValue">
           <attribution license="cc4" from="Microsoft" modified="false" />A 16-bit signed integer that specifies the maximum value for the new <see cref="T:System.Collections.Specialized.BitVector32.Section" />. </param>
       </Docs>
@@ -240,7 +249,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The object <paramref name="o" /> is considered equal to the <see cref="T:System.Collections.Specialized.BitVector32" /> if the type of <paramref name="o" /> is compatible with the <see cref="T:System.Collections.Specialized.BitVector32" /> type and if the value of <paramref name="o" /> is equal to the value of <see cref="P:System.Collections.Specialized.BitVector32.Data" />.</para>
@@ -250,6 +258,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified object is equal to the <see cref="T:System.Collections.Specialized.BitVector32" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified object is equal to the <see cref="T:System.Collections.Specialized.BitVector32" />; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current <see cref="T:System.Collections.Specialized.BitVector32" />. </param>
       </Docs>
@@ -268,7 +280,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The hash code of a <see cref="T:System.Collections.Specialized.BitVector32" /> is based on the value of <see cref="P:System.Collections.Specialized.BitVector32.Data" />. Two instances of <see cref="T:System.Collections.Specialized.BitVector32" /> with the same value for <see cref="P:System.Collections.Specialized.BitVector32.Data" /> will also generate the same hash code.</para>
@@ -278,6 +289,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for the <see cref="T:System.Collections.Specialized.BitVector32" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the <see cref="T:System.Collections.Specialized.BitVector32" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Item">
@@ -338,7 +353,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method overrides <see cref="M:System.Object.ToString" />.</para>
@@ -348,6 +362,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Collections.Specialized.BitVector32" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Collections.Specialized.BitVector32" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -366,7 +384,6 @@
         <Parameter Name="value" Type="System.Collections.Specialized.BitVector32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is an O(1) operation.</para>
@@ -375,6 +392,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the specified <see cref="T:System.Collections.Specialized.BitVector32" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the specified <see cref="T:System.Collections.Specialized.BitVector32" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.Specialized.BitVector32" /> to represent. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Collections.Specialized/CollectionsUtil.xml b/mcs/class/System/Documentation/en/System.Collections.Specialized/CollectionsUtil.xml
index 88b03e1d536..f293f964832 100644
--- a/mcs/class/System/Documentation/en/System.Collections.Specialized/CollectionsUtil.xml
+++ b/mcs/class/System/Documentation/en/System.Collections.Specialized/CollectionsUtil.xml
@@ -60,7 +60,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.Hashtable'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Instead of using the <see cref="M:System.Collections.Specialized.CollectionsUtil.CreateCaseInsensitiveHashtable" /> method, use the <see cref="M:System.Collections.Hashtable.#ctor(System.Collections.IEqualityComparer)" /> constructor to create a case-insensitive <see cref="T:System.Collections.Hashtable" /> class.</para>
@@ -69,6 +68,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new case-insensitive instance of the <see cref="T:System.Collections.Hashtable" /> class with the default initial capacity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new case-insensitive instance of the <see cref="T:System.Collections.Hashtable" /> class with the default initial capacity.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateCaseInsensitiveHashtable">
@@ -87,7 +90,6 @@
         <Parameter Name="d" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Collections.Hashtable'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Instead of using the <see cref="M:System.Collections.Specialized.CollectionsUtil.CreateCaseInsensitiveHashtable(System.Collections.IDictionary)" /> method, use the <see cref="M:System.Collections.Hashtable.#ctor(System.Collections.IDictionary,System.Collections.IEqualityComparer)" /> constructor to create a case-insensitive <see cref="T:System.Collections.Hashtable" /> class.</para>
@@ -96,6 +98,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the entries from the specified dictionary to a new case-insensitive instance of the <see cref="T:System.Collections.Hashtable" /> class with the same initial capacity as the number of entries copied.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new case-insensitive instance of the <see cref="T:System.Collections.Hashtable" /> class containing the entries from the specified <see cref="T:System.Collections.IDictionary" />.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.IDictionary" /> to copy to a new case-insensitive <see cref="T:System.Collections.Hashtable" />. </param>
       </Docs>
@@ -116,7 +122,6 @@
         <Parameter Name="capacity" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Collections.Hashtable'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Instead of using the <see cref="M:System.Collections.Specialized.CollectionsUtil.CreateCaseInsensitiveHashtable(System.Int32)" /> method, use the <see cref="M:System.Collections.Hashtable.#ctor(System.Int32,System.Collections.IEqualityComparer)" /> constructor to create a case-insensitive <see cref="T:System.Collections.Hashtable" /> class.</para>
@@ -125,6 +130,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new case-insensitive instance of the <see cref="T:System.Collections.Hashtable" /> class with the specified initial capacity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new case-insensitive instance of the <see cref="T:System.Collections.Hashtable" /> class with the specified initial capacity.</para>
+        </returns>
         <param name="capacity">
           <attribution license="cc4" from="Microsoft" modified="false" />The approximate number of entries that the <see cref="T:System.Collections.Hashtable" /> can initially contain. </param>
       </Docs>
@@ -143,7 +152,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.SortedList'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The new <see cref="T:System.Collections.SortedList" /> instance is sorted according to the <see cref="T:System.Collections.CaseInsensitiveComparer" />.</para>
@@ -152,6 +160,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the <see cref="T:System.Collections.SortedList" /> class that ignores the case of strings.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the <see cref="T:System.Collections.SortedList" /> class that ignores the case of strings.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.Collections.Specialized/HybridDictionary.xml b/mcs/class/System/Documentation/en/System.Collections.Specialized/HybridDictionary.xml
index 87504cd18fa..aa8d62e4658 100644
--- a/mcs/class/System/Documentation/en/System.Collections.Specialized/HybridDictionary.xml
+++ b/mcs/class/System/Documentation/en/System.Collections.Specialized/HybridDictionary.xml
@@ -225,7 +225,6 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is an O(1) operation.</para>
@@ -235,6 +234,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Collections.Specialized.HybridDictionary" /> contains a specific key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Collections.Specialized.HybridDictionary" /> contains an entry with the specified key; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key to locate in the <see cref="T:System.Collections.Specialized.HybridDictionary" />. </param>
       </Docs>
@@ -308,7 +311,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IDictionaryEnumerator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The foreach statement of the C# language (for each in Visual Basic) hides the complexity of the enumerators.  Therefore, using foreach is recommended, instead of directly manipulating the enumerator.</para>
@@ -325,6 +327,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IDictionaryEnumerator" /> that iterates through the <see cref="T:System.Collections.Specialized.HybridDictionary" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IDictionaryEnumerator" /> for the <see cref="T:System.Collections.Specialized.HybridDictionary" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsFixedSize">
@@ -527,7 +533,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The foreach statement of the C# language (for each in Visual Basic) hides the complexity of the enumerators.  Therefore, using foreach is recommended, instead of directly manipulating the enumerator.</para>
@@ -544,6 +549,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IEnumerator" /> that iterates through the <see cref="T:System.Collections.Specialized.HybridDictionary" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.Collections.Specialized.HybridDictionary" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Values">
diff --git a/mcs/class/System/Documentation/en/System.Collections.Specialized/IOrderedDictionary.xml b/mcs/class/System/Documentation/en/System.Collections.Specialized/IOrderedDictionary.xml
index 744546b9613..79a632fe036 100644
--- a/mcs/class/System/Documentation/en/System.Collections.Specialized/IOrderedDictionary.xml
+++ b/mcs/class/System/Documentation/en/System.Collections.Specialized/IOrderedDictionary.xml
@@ -43,7 +43,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -61,6 +60,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the <see cref="T:System.Collections.Specialized.IOrderedDictionary" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IDictionaryEnumerator" /> for the entire <see cref="T:System.Collections.Specialized.IOrderedDictionary" /> collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Insert">
diff --git a/mcs/class/System/Documentation/en/System.Collections.Specialized/ListDictionary.xml b/mcs/class/System/Documentation/en/System.Collections.Specialized/ListDictionary.xml
index 94e8b0677cd..9b1b82be24d 100644
--- a/mcs/class/System/Documentation/en/System.Collections.Specialized/ListDictionary.xml
+++ b/mcs/class/System/Documentation/en/System.Collections.Specialized/ListDictionary.xml
@@ -162,7 +162,6 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is an O(<paramref name="n" />) operation, where <paramref name="n" /> is <see cref="P:System.Collections.Specialized.ListDictionary.Count" />.</para>
@@ -172,6 +171,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Collections.Specialized.ListDictionary" /> contains a specific key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Collections.Specialized.ListDictionary" /> contains an entry with the specified key; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key to locate in the <see cref="T:System.Collections.Specialized.ListDictionary" />. </param>
       </Docs>
@@ -248,7 +251,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IDictionaryEnumerator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The foreach statement of the C# language (for each in Visual Basic) hides the complexity of the enumerators.  Therefore, using foreach is recommended, instead of directly manipulating the enumerator.</para>
@@ -265,6 +267,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IDictionaryEnumerator" /> that iterates through the <see cref="T:System.Collections.Specialized.ListDictionary" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IDictionaryEnumerator" /> for the <see cref="T:System.Collections.Specialized.ListDictionary" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsFixedSize">
@@ -466,7 +472,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The foreach statement of the C# language (for each in Visual Basic) hides the complexity of the enumerators.  Therefore, using foreach is recommended, instead of directly manipulating the enumerator.</para>
@@ -483,6 +488,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IEnumerator" /> that iterates through the <see cref="T:System.Collections.Specialized.ListDictionary" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.Collections.Specialized.ListDictionary" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Values">
diff --git a/mcs/class/System/Documentation/en/System.Collections.Specialized/NameObjectCollectionBase.xml b/mcs/class/System/Documentation/en/System.Collections.Specialized/NameObjectCollectionBase.xml
index eb02e4479e4..13045d5452f 100644
--- a/mcs/class/System/Documentation/en/System.Collections.Specialized/NameObjectCollectionBase.xml
+++ b/mcs/class/System/Documentation/en/System.Collections.Specialized/NameObjectCollectionBase.xml
@@ -340,7 +340,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is an O(1) operation.</para>
@@ -349,6 +348,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the entry at the specified index of the <see cref="T:System.Collections.Specialized.NameObjectCollectionBase" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the value of the entry at the specified index.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the value to get.</param>
       </Docs>
@@ -369,7 +372,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the collection contains multiple entries with the specified key, this method returns only the first entry. To get the values of subsequent entries with the same key, use the enumerator to iterate through the collection and compare the keys.</para>
@@ -382,6 +384,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the first entry with the specified key from the <see cref="T:System.Collections.Specialized.NameObjectCollectionBase" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the value of the first entry with the specified key, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> key of the entry to get. The key can be null.</param>
       </Docs>
@@ -400,7 +406,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is an O(<paramref name="n" />) operation, where <paramref name="n" /> is <see cref="P:System.Collections.Specialized.NameObjectCollectionBase.Count" />.</para>
@@ -409,6 +414,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.String" /> array that contains all the keys in the <see cref="T:System.Collections.Specialized.NameObjectCollectionBase" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> array that contains all the keys in the <see cref="T:System.Collections.Specialized.NameObjectCollectionBase" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="BaseGetAllValues">
@@ -425,7 +434,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is an O(<paramref name="n" />) operation, where <paramref name="n" /> is <see cref="P:System.Collections.Specialized.NameObjectCollectionBase.Count" />.</para>
@@ -434,6 +442,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Object" /> array that contains all the values in the <see cref="T:System.Collections.Specialized.NameObjectCollectionBase" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> array that contains all the values in the <see cref="T:System.Collections.Specialized.NameObjectCollectionBase" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="BaseGetAllValues">
@@ -452,7 +464,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is an O(<paramref name="n" />) operation, where <paramref name="n" /> is <see cref="P:System.Collections.Specialized.NameObjectCollectionBase.Count" />.</para>
@@ -461,6 +472,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of the specified type that contains all the values in the <see cref="T:System.Collections.Specialized.NameObjectCollectionBase" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of the specified type that contains all the values in the <see cref="T:System.Collections.Specialized.NameObjectCollectionBase" /> instance.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents the type of array to return.</param>
       </Docs>
@@ -481,7 +496,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is an O(1) operation.</para>
@@ -490,6 +504,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the key of the entry at the specified index of the <see cref="T:System.Collections.Specialized.NameObjectCollectionBase" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that represents the key of the entry at the specified index.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the key to get.</param>
       </Docs>
@@ -508,7 +526,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is an O(1) operation.</para>
@@ -517,6 +534,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the <see cref="T:System.Collections.Specialized.NameObjectCollectionBase" /> instance contains entries whose keys are not null.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Collections.Specialized.NameObjectCollectionBase" /> instance contains entries whose keys are not null; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="BaseRemove">
@@ -681,7 +702,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IEnumerator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This enumerator returns the keys of the collection as strings.</para>
@@ -699,6 +719,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the <see cref="T:System.Collections.Specialized.NameObjectCollectionBase" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.Collections.Specialized.NameObjectCollectionBase" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetObjectData">
diff --git a/mcs/class/System/Documentation/en/System.Collections.Specialized/NameValueCollection.xml b/mcs/class/System/Documentation/en/System.Collections.Specialized/NameValueCollection.xml
index 1a680adee0e..a5c6e8ef5aa 100644
--- a/mcs/class/System/Documentation/en/System.Collections.Specialized/NameValueCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Collections.Specialized/NameValueCollection.xml
@@ -570,12 +570,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> that contains a
-   comma-separated list of the values at the specified index of the current
-   instance, if found;
-   otherwise, <see langword="null" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="index" /> is outside the valid range of indices for the current instance.</exception>
         <remarks>
@@ -586,6 +580,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the values at the specified index of the <see cref="T:System.Collections.Specialized.NameValueCollection" /> combined into one comma-separated list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that contains a comma-separated list of the values at the specified index of the <see cref="T:System.Collections.Specialized.NameValueCollection" />, if found; otherwise, null.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the entry that contains the values to get from the collection.</param>
       </Docs>
@@ -608,12 +606,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> that contains a
-   comma-separated list of the values associated with the specified key from the
-   current instance, if found;
-   otherwise, <see langword="null" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -625,6 +617,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the values associated with the specified key from the <see cref="T:System.Collections.Specialized.NameValueCollection" /> combined into one comma-separated list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that contains a comma-separated list of the values associated with the specified key from the <see cref="T:System.Collections.Specialized.NameValueCollection" />, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> key of the entry that contains the values to get. The key can be null.</param>
       </Docs>
@@ -647,11 +643,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> that contains the
-   key at the specified index of the current instance, if found;
-   otherwise, <see langword="null" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="index" /> is outside the valid range of indices for the current instance.</exception>
         <remarks>
@@ -662,6 +653,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the key at the specified index of the <see cref="T:System.Collections.Specialized.NameValueCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that contains the key at the specified index of the <see cref="T:System.Collections.Specialized.NameValueCollection" />, if found; otherwise, null.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the key to get from the collection.</param>
       </Docs>
@@ -684,11 +679,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.String" /> array containing the values at the specified index of the
-   current instance, if found;
-   otherwise, <see langword="null" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="index" /> is outside the valid range of indices for the current instance.</exception>
         <remarks>
@@ -699,6 +689,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the values at the specified index of the <see cref="T:System.Collections.Specialized.NameValueCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> array that contains the values at the specified index of the <see cref="T:System.Collections.Specialized.NameValueCollection" />, if found; otherwise, null.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the entry that contains the values to get from the collection.</param>
       </Docs>
@@ -721,12 +715,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.String" />
-array containing the values associated with <paramref name="name" />
-from the current instance, if found;
-otherwise, <see langword="null" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -738,6 +726,10 @@ otherwise, <see langword="null" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the values associated with the specified key from the <see cref="T:System.Collections.Specialized.NameValueCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> array that contains the values associated with the specified key from the <see cref="T:System.Collections.Specialized.NameValueCollection" />, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> key of the entry that contains the values to get. The key can be null.</param>
       </Docs>
@@ -758,12 +750,6 @@ otherwise, <see langword="null" />.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the
-   current instance contains
-   keys that are not <see langword="null" />; otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is an O(1) operation.</para>
@@ -772,6 +758,10 @@ otherwise, <see langword="null" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the <see cref="T:System.Collections.Specialized.NameValueCollection" /> contains keys that are not null.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Collections.Specialized.NameValueCollection" /> contains keys that are not null; otherwise, false.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/System/Documentation/en/System.Collections.Specialized/OrderedDictionary.xml b/mcs/class/System/Documentation/en/System.Collections.Specialized/OrderedDictionary.xml
index b63fcc11f5a..c25de6ef099 100644
--- a/mcs/class/System/Documentation/en/System.Collections.Specialized/OrderedDictionary.xml
+++ b/mcs/class/System/Documentation/en/System.Collections.Specialized/OrderedDictionary.xml
@@ -214,7 +214,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -224,6 +223,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a read-only copy of the current <see cref="T:System.Collections.Specialized.OrderedDictionary" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A read-only copy of the current <see cref="T:System.Collections.Specialized.OrderedDictionary" /> collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Clear">
@@ -265,7 +268,6 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -276,6 +278,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Collections.Specialized.OrderedDictionary" /> collection contains a specific key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Collections.Specialized.OrderedDictionary" /> collection contains an element with the specified key; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key to locate in the <see cref="T:System.Collections.Specialized.OrderedDictionary" /> collection.</param>
       </Docs>
@@ -345,7 +351,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -361,6 +366,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IDictionaryEnumerator" /> object that iterates through the <see cref="T:System.Collections.Specialized.OrderedDictionary" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IDictionaryEnumerator" /> object for the <see cref="T:System.Collections.Specialized.OrderedDictionary" /> collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetObjectData">
@@ -677,12 +686,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IDictionaryEnumerator" /> object that iterates through the <see cref="T:System.Collections.Specialized.OrderedDictionary" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IDictionaryEnumerator" /> object for the <see cref="T:System.Collections.Specialized.OrderedDictionary" /> collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Runtime.Serialization.IDeserializationCallback.OnDeserialization">
diff --git a/mcs/class/System/Documentation/en/System.Collections.Specialized/StringCollection.xml b/mcs/class/System/Documentation/en/System.Collections.Specialized/StringCollection.xml
index 4bff573ce85..71c7c37fbd0 100644
--- a/mcs/class/System/Documentation/en/System.Collections.Specialized/StringCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Collections.Specialized/StringCollection.xml
@@ -71,7 +71,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -82,6 +81,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a string to the end of the <see cref="T:System.Collections.Specialized.StringCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index at which the new element is inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to add to the end of the <see cref="T:System.Collections.Specialized.StringCollection" />. The value can be null. </param>
       </Docs>
@@ -158,7 +161,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Collections.Specialized.StringCollection.Contains(System.String)" /> method can confirm the existence of a string before performing further operations.</para>
@@ -170,6 +172,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified string is in the <see cref="T:System.Collections.Specialized.StringCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is found in the <see cref="T:System.Collections.Specialized.StringCollection" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to locate in the <see cref="T:System.Collections.Specialized.StringCollection" />. The value can be null. </param>
       </Docs>
@@ -245,7 +251,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'StringEnumerator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>[Visual Basic, C#]</para>
@@ -263,6 +268,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Collections.Specialized.StringEnumerator" /> that iterates through the <see cref="T:System.Collections.Specialized.StringCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.Specialized.StringEnumerator" /> for the <see cref="T:System.Collections.Specialized.StringCollection" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IndexOf">
@@ -281,7 +290,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method determines equality by calling <see cref="M:System.Object.Equals(System.Object)" />. String comparisons are case-sensitive.</para>
@@ -292,6 +300,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified string and returns the zero-based index of the first occurrence within the <see cref="T:System.Collections.Specialized.StringCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="value" /> in the <see cref="T:System.Collections.Specialized.StringCollection" />, if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to locate. The value can be null. </param>
       </Docs>
@@ -546,7 +558,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>[Visual Basic, C#]</para>
@@ -564,6 +575,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Collections.IEnumerator" /> that iterates through the <see cref="T:System.Collections.Specialized.StringCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.Collections.Specialized.StringCollection" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Add">
@@ -582,7 +597,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -594,6 +608,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an object to the end of the <see cref="T:System.Collections.Specialized.StringCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Collections.Specialized.StringCollection" /> index at which the <paramref name="value" /> has been added.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to be added to the end of the <see cref="T:System.Collections.Specialized.StringCollection" />. The value can be null. </param>
       </Docs>
@@ -614,7 +632,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method determines equality by calling <see cref="M:System.Object.Equals(System.Object)" />.</para>
@@ -625,6 +642,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether an element is in the <see cref="T:System.Collections.Specialized.StringCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is found in the <see cref="T:System.Collections.Specialized.StringCollection" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the <see cref="T:System.Collections.Specialized.StringCollection" />. The value can be null. </param>
       </Docs>
@@ -645,7 +666,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Collections.Specialized.StringCollection" /> is searched forward starting at the first element and ending at the last element.</para>
@@ -657,6 +677,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified <see cref="T:System.Object" /> and returns the zero-based index of the first occurrence within the entire <see cref="T:System.Collections.Specialized.StringCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="value" /> within the entire <see cref="T:System.Collections.Specialized.StringCollection" />, if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the <see cref="T:System.Collections.Specialized.StringCollection" />. The value can be null. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Collections.Specialized/StringDictionary.xml b/mcs/class/System/Documentation/en/System.Collections.Specialized/StringDictionary.xml
index 207256f5261..b54adee59cb 100644
--- a/mcs/class/System/Documentation/en/System.Collections.Specialized/StringDictionary.xml
+++ b/mcs/class/System/Documentation/en/System.Collections.Specialized/StringDictionary.xml
@@ -131,7 +131,6 @@
         <Parameter Name="key" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The key is handled in a case-insensitive manner; it is translated to lowercase before it is used.</para>
@@ -142,6 +141,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the <see cref="T:System.Collections.Specialized.StringDictionary" /> contains a specific key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Collections.Specialized.StringDictionary" /> contains an entry with the specified key; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key to locate in the <see cref="T:System.Collections.Specialized.StringDictionary" />. </param>
       </Docs>
@@ -162,7 +165,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The values of the elements of the StringDictionary are compared to the specified value using the <see cref="M:System.Object.Equals(System.Object)" /> method.</para>
@@ -173,6 +175,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the <see cref="T:System.Collections.Specialized.StringDictionary" /> contains a specific value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Collections.Specialized.StringDictionary" /> contains an element with the specified value; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to locate in the <see cref="T:System.Collections.Specialized.StringDictionary" />. The value can be null. </param>
       </Docs>
@@ -246,7 +252,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IEnumerator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The foreach statement of the C# language (for each in Visual Basic) hides the complexity of the enumerators.  Therefore, using foreach is recommended, instead of directly manipulating the enumerator.</para>
@@ -263,6 +268,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the string dictionary.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that iterates through the string dictionary.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsSynchronized">
diff --git a/mcs/class/System/Documentation/en/System.Collections.Specialized/StringEnumerator.xml b/mcs/class/System/Documentation/en/System.Collections.Specialized/StringEnumerator.xml
index 18f26ad5151..923664f8a70 100644
--- a/mcs/class/System/Documentation/en/System.Collections.Specialized/StringEnumerator.xml
+++ b/mcs/class/System/Documentation/en/System.Collections.Specialized/StringEnumerator.xml
@@ -76,7 +76,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>After an enumerator is created or after a <see cref="M:System.Collections.Specialized.StringEnumerator.Reset" /> is called, an enumerator is positioned before the first element of the collection, and the first call to <see cref="M:System.Collections.Specialized.StringEnumerator.MoveNext" /> moves the enumerator over the first element of the collection.</para>
@@ -87,6 +86,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the enumerator to the next element of the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Reset">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/ComponentSerializationService.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/ComponentSerializationService.xml
index 94a30b7ec03..71d3a5211e6 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/ComponentSerializationService.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/ComponentSerializationService.xml
@@ -54,7 +54,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Multiple objects can be serialized into the same serialization store. When you are finished with the store, you can call its <see cref="M:System.ComponentModel.Design.Serialization.SerializationStore.System#IDisposable#Dispose" /> or <see cref="M:System.ComponentModel.Design.Serialization.SerializationStore.Close" /> method. Once closed, a serialization store can be used for deserialization, or it can be saved into a stream.</para>
@@ -64,6 +63,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ComponentModel.Design.Serialization.SerializationStore" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new created serialization store.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Deserialize">
@@ -81,7 +84,6 @@
         <Parameter Name="store" Type="System.ComponentModel.Design.Serialization.SerializationStore" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method deserializes <paramref name="store" /> to produce a collection of objects contained within it. Objects are deserialized in the same order in which they were serialized.</para>
@@ -90,6 +92,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes the given store to produce a collection of objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of objects created according to the stored state.</para>
+        </returns>
         <param name="store">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.SerializationStore" /> to deserialize.</param>
       </Docs>
@@ -110,7 +116,6 @@
         <Parameter Name="container" Type="System.ComponentModel.IContainer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method deserializes <paramref name="store" /> to produce a collection of objects contained within it. Objects are deserialized in the same order in which they were serialized.</para>
@@ -120,6 +125,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes the given store and populates the given <see cref="T:System.ComponentModel.IContainer" /> with deserialized <see cref="T:System.ComponentModel.IComponent" /> objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of objects created according to the stored state.</para>
+        </returns>
         <param name="store">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.SerializationStore" /> to deserialize.</param>
         <param name="container">
@@ -240,7 +249,6 @@
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the returned store to deserialize objects by passing it to one of the <see cref="Overload:System.ComponentModel.Design.Serialization.ComponentSerializationService.Deserialize" /> methods.</para>
@@ -249,6 +257,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads a <see cref="T:System.ComponentModel.Design.Serialization.SerializationStore" /> from a stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ComponentModel.Design.Serialization.SerializationStore" /> instance.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.Stream" /> from which the store will be loaded.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/ContextStack.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/ContextStack.xml
index 1a5d1fde0bf..b8fc1250dba 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/ContextStack.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/ContextStack.xml
@@ -157,12 +157,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the current object off of the stack, returning its value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object removed from the stack; null if no objects are on the stack.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Push">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/IDesignerLoaderService.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/IDesignerLoaderService.xml
index c1989195536..005a25040b0 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/IDesignerLoaderService.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/IDesignerLoaderService.xml
@@ -94,7 +94,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Any object can call this method to request that the loader reload the design document. If the loader supports reloading and complies with the reload, the designer loader can return true. Otherwise, it returns false, indicating that the reload will not occur. Callers cannot rely on the reload happening immediately; the designer loader can schedule this for some other time, or it can try to reload at once.</para>
@@ -104,6 +103,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reloads the design document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the reload request is accepted, or false if the loader does not allow the reload.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/IDesignerSerializationManager.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/IDesignerSerializationManager.xml
index 70635fbfc1e..e1a877b9abe 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/IDesignerSerializationManager.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/IDesignerSerializationManager.xml
@@ -98,7 +98,6 @@
         <Parameter Name="addToContainer" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Objects that implement <see cref="T:System.ComponentModel.IComponent" /> are added to the design-time container if the <paramref name="addToContainer" /> parameter is true.</para>
@@ -107,6 +106,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the specified type and adds it to a collection of named instances.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created object instance.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The data type to create. </param>
         <param name="arguments">
@@ -133,7 +136,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The name of the object to retrieve must have been set through a prior call to <see cref="M:System.ComponentModel.Design.Serialization.IDesignerSerializationManager.CreateInstance(System.Type,System.Collections.ICollection,System.String,System.Boolean)" />.</para>
@@ -142,6 +144,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an instance of a created object of the specified name, or null if that object does not exist.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the object with the given name, or null if no object by that name can be found.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the object to retrieve. </param>
       </Docs>
@@ -162,12 +168,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the name of the specified object, or null if the object has no name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the object, or null if the object is unnamed.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to retrieve the name for. </param>
       </Docs>
@@ -189,12 +198,15 @@
         <Parameter Name="serializerType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a serializer of the requested type for the specified object type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the requested serializer, or null if no appropriate serializer can be located.</para>
+        </returns>
         <param name="objectType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the object to get the serializer for. </param>
         <param name="serializerType">
@@ -217,12 +229,15 @@
         <Parameter Name="typeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Type'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a type of the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the type, or null if the type cannot be loaded.</para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The fully qualified name of the type to load. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/IDesignerSerializationProvider.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/IDesignerSerializationProvider.xml
index 22bc0d8129b..14c55f1b17c 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/IDesignerSerializationProvider.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/IDesignerSerializationProvider.xml
@@ -42,7 +42,6 @@
         <Parameter Name="serializerType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The serialization manager calls this method when it is trying to locate a serializer for an object type. If this serialization provider can provide a serializer of the correct type, this provider returns it. Otherwise, it returns null.</para>
@@ -51,6 +50,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a serializer using the specified attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of a serializer of the type requested, or null if the request cannot be satisfied.</para>
+        </returns>
         <param name="manager">
           <attribution license="cc4" from="Microsoft" modified="false" />The serialization manager requesting the serializer. </param>
         <param name="currentSerializer">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/IDesignerSerializationService.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/IDesignerSerializationService.xml
index 9ebe4822b95..14944aac859 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/IDesignerSerializationService.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/IDesignerSerializationService.xml
@@ -41,12 +41,15 @@
         <Parameter Name="serializationData" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Collections.ICollection'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes the specified serialization data object and returns a collection of objects represented by that data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.ICollection" /> of objects rebuilt from the specified serialization data object.</para>
+        </returns>
         <param name="serializationData">
           <attribution license="cc4" from="Microsoft" modified="false" />An object consisting of serialized data. </param>
       </Docs>
@@ -67,7 +70,6 @@
         <Parameter Name="objects" Type="System.Collections.ICollection" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned object fully supports run-time serialization.</para>
@@ -77,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serializes the specified collection of objects and stores them in a serialization data object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that contains the serialized state of the specified collection of objects.</para>
+        </returns>
         <param name="objects">
           <attribution license="cc4" from="Microsoft" modified="false" />A collection of objects to serialize. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/INameCreationService.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/INameCreationService.xml
index 44b0525f89a..97fc4a8834b 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/INameCreationService.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/INameCreationService.xml
@@ -40,7 +40,6 @@
         <Parameter Name="dataType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns a name for the new object that is unique within the specified container.</para>
@@ -49,6 +48,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new name that is unique to all components in the specified container.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A unique name for the data type.</para>
+        </returns>
         <param name="container">
           <attribution license="cc4" from="Microsoft" modified="false" />The container where the new object is added. </param>
         <param name="dataType">
@@ -71,7 +74,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An implementation of the <see cref="T:System.ComponentModel.Design.Serialization.INameCreationService" /> can have rules that define the parameters for valid names. This method can be implemented to validate a name and enforce those rules.</para>
@@ -80,6 +82,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified name is valid.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the name is valid; otherwise, false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name to validate. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/InstanceDescriptor.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/InstanceDescriptor.xml
index 28ad0cb2181..6236f675666 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/InstanceDescriptor.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/InstanceDescriptor.xml
@@ -133,7 +133,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates a new instance of the object indicated by the <see cref="P:System.ComponentModel.Design.Serialization.InstanceDescriptor.MemberInfo" /> property, using the specified arguments to create that particular type of instance.</para>
@@ -142,6 +141,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes this instance descriptor and returns the object the descriptor describes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object this instance descriptor describes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsComplete">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/MemberRelationship.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/MemberRelationship.xml
index 82308ef8d6d..da14abb9557 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/MemberRelationship.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/MemberRelationship.xml
@@ -85,12 +85,15 @@
       </Parameters>
       <Docs>
         <param name="o">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two <see cref="T:System.ComponentModel.Design.Serialization.MemberRelationship" /> instances are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.ComponentModel.Design.Serialization.MemberRelationship" /> is equal to the current <see cref="T:System.ComponentModel.Design.Serialization.MemberRelationship" />; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -106,12 +109,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.ComponentModel.Design.Serialization.MemberRelationship" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsEmpty">
@@ -170,12 +176,15 @@
         <Parameter Name="right" Type="System.ComponentModel.Design.Serialization.MemberRelationship" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether two specified <see cref="T:System.ComponentModel.Design.Serialization.MemberRelationship" /> structures are equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This operator returns true if the two <see cref="T:System.ComponentModel.Design.Serialization.MemberRelationship" /> structures are equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.MemberRelationship" /> structure that is to the left of the equality operator.</param>
         <param name="right">
@@ -198,12 +207,15 @@
         <Parameter Name="right" Type="System.ComponentModel.Design.Serialization.MemberRelationship" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether two specified <see cref="T:System.ComponentModel.Design.Serialization.MemberRelationship" /> structures are different.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This operator returns true if the two <see cref="T:System.ComponentModel.Design.Serialization.MemberRelationship" /> structures are different; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.Serialization.MemberRelationship" /> structure that is to the left of the inequality operator.</param>
         <param name="right">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/MemberRelationshipService.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/MemberRelationshipService.xml
index f17f1644c4e..625ff273692 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/MemberRelationshipService.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design.Serialization/MemberRelationshipService.xml
@@ -57,7 +57,6 @@
         <Parameter Name="source" Type="System.ComponentModel.Design.Serialization.MemberRelationship" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default implementation stores relationships in a dictionary using weak references, so the relationship table does not keep objects alive.</para>
@@ -66,6 +65,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a relationship to the given source relationship.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A relationship to <paramref name="source" />, or <see cref="F:System.ComponentModel.Design.Serialization.MemberRelationship.Empty" /> if no relationship exists.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The source relationship.</param>
       </Docs>
@@ -160,12 +163,15 @@
         <Parameter Name="relationship" Type="System.ComponentModel.Design.Serialization.MemberRelationship" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the given relationship is supported.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a relationship between the given two objects is supported; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The source relationship.</param>
         <param name="relationship">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design/CommandID.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design/CommandID.xml
index bc8f88102af..d37bbf276df 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design/CommandID.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design/CommandID.xml
@@ -76,12 +76,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two <see cref="T:System.ComponentModel.Design.CommandID" /> instances are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified object is equivalent to this one; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare. </param>
       </Docs>
@@ -161,7 +164,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns a string that contains the significant information of the <see cref="T:System.ComponentModel.Design.CommandID" />, a concatenation that consists of the menu group GUID and the numeric ID for the <see cref="T:System.ComponentModel.Design.CommandID" />.</para>
@@ -170,6 +172,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.String" /> that represents the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the command ID information, both the GUID and integer identifier. </para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design/DesignerCollection.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design/DesignerCollection.xml
index 0c3b674bd67..d155299a09a 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design/DesignerCollection.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design/DesignerCollection.xml
@@ -114,12 +114,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IEnumerator'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a new enumerator for this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that enumerates the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Item">
@@ -249,12 +252,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a new enumerator for this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that enumerates the collection.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design/DesignerOptionService.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design/DesignerOptionService.xml
index cdd1aed66a3..b3c4928f006 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design/DesignerOptionService.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design/DesignerOptionService.xml
@@ -174,12 +174,15 @@
         <Parameter Name="valueName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of an option defined in this package.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the option named <paramref name="valueName" />.</para>
+        </returns>
         <param name="pageName">
           <attribution license="cc4" from="Microsoft" modified="false" />The page to which the option is bound.</param>
         <param name="valueName">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design/DesignerVerb.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design/DesignerVerb.xml
index 01bf639785c..06f904cc623 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design/DesignerVerb.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design/DesignerVerb.xml
@@ -147,12 +147,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Overrides <see cref="M:System.Object.ToString" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The verb's text, or an empty string ("") if the text field is empty.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design/DesignerVerbCollection.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design/DesignerVerbCollection.xml
index 69a43f51152..2cb2704a8f9 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design/DesignerVerbCollection.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design/DesignerVerbCollection.xml
@@ -93,12 +93,15 @@
         <Parameter Name="value" Type="System.ComponentModel.Design.DesignerVerb" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.ComponentModel.Design.DesignerVerb" /> to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index in the collection at which the verb was added.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.DesignerVerb" /> to add to the collection. </param>
       </Docs>
@@ -169,12 +172,15 @@
         <Parameter Name="value" Type="System.ComponentModel.Design.DesignerVerb" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified <see cref="T:System.ComponentModel.Design.DesignerVerb" /> exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified object exists in the collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.DesignerVerb" /> to search for in the collection. </param>
       </Docs>
@@ -223,12 +229,15 @@
         <Parameter Name="value" Type="System.ComponentModel.Design.DesignerVerb" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the specified <see cref="T:System.ComponentModel.Design.DesignerVerb" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified object if it is found in the list; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.DesignerVerb" /> whose index to get in the collection. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design/DesigntimeLicenseContext.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design/DesigntimeLicenseContext.xml
index 1d492ddaa69..e1e8279972e 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design/DesigntimeLicenseContext.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design/DesigntimeLicenseContext.xml
@@ -63,12 +63,15 @@
         <Parameter Name="resourceAssembly" Type="System.Reflection.Assembly" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a saved license key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The saved license key that matches the specified type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the license key. </param>
         <param name="resourceAssembly">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design/HelpKeywordAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design/HelpKeywordAttribute.xml
index c551294d0bb..74c34febe24 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design/HelpKeywordAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design/HelpKeywordAttribute.xml
@@ -136,7 +136,6 @@
       </Parameters>
       <Docs>
         <param name="other">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -146,6 +145,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two <see cref="T:System.ComponentModel.Design.HelpKeywordAttribute" /> instances are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.ComponentModel.Design.HelpKeywordAttribute" /> is equal to the current <see cref="T:System.ComponentModel.Design.HelpKeywordAttribute" />; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -161,13 +164,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.ComponentModel.Design.HelpKeywordAttribute" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HelpKeyword">
@@ -204,13 +210,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the Help keyword is null.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the Help keyword is null; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design/IComponentDiscoveryService.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design/IComponentDiscoveryService.xml
index 6eee497f8e5..025c16a0b0d 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design/IComponentDiscoveryService.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design/IComponentDiscoveryService.xml
@@ -36,7 +36,6 @@
         <Parameter Name="baseType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.Design.IComponentDiscoveryService.GetComponentTypes(System.ComponentModel.Design.IDesignerHost,System.Type)" /> method retrieves the list of available component types, which are types implementing the <see cref="T:System.ComponentModel.IComponent" /> interface. If the <paramref name="baseType" /> parameter is null, all components are retrieved; otherwise, only component types derived from <paramref name="baseType" /> are returned.</para>
@@ -47,6 +46,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the list of available component types.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The list of available component types.</para>
+        </returns>
         <param name="designerHost">
           <attribution license="cc4" from="Microsoft" modified="false" />The designer host providing design-time services. Can be null.</param>
         <param name="baseType">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design/IDesignerHost.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design/IDesignerHost.xml
index 2f32aa74da3..dcda2670cd7 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design/IDesignerHost.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design/IDesignerHost.xml
@@ -125,7 +125,6 @@
         <Parameter Name="componentClass" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ComponentModel.IComponent'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the type cannot be resolved into an object that implements <see cref="T:System.ComponentModel.IComponent" />, an exception is thrown.</para>
@@ -135,6 +134,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a component of the specified type and adds it to the design document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created component.</para>
+        </returns>
         <param name="componentClass">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the component to create. </param>
       </Docs>
@@ -156,7 +159,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ComponentModel.IComponent'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the type cannot be resolved into an object that implements <see cref="T:System.ComponentModel.IComponent" />, an exception is thrown.</para>
@@ -166,6 +168,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a component of the specified type and name, and adds it to the design document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created component.</para>
+        </returns>
         <param name="componentClass">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the component to create. </param>
         <param name="name">
@@ -186,7 +192,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'DesignerTransaction'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates a <see cref="T:System.ComponentModel.Design.DesignerTransaction" /> that can be used to encapsulate a series of operations. Designer transactions can improve performance, reduce flicker caused by multiple updates during a process of operations, and enable most operations to be undone.</para>
@@ -196,6 +201,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.ComponentModel.Design.DesignerTransaction" /> that can encapsulate event sequences to improve performance and enable undo and redo support functionality.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.ComponentModel.Design.DesignerTransaction" />. When you complete the steps in your transaction, you should call <see cref="M:System.ComponentModel.Design.DesignerTransaction.Commit" /> on this object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateTransaction">
@@ -214,7 +223,6 @@
         <Parameter Name="description" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DesignerTransaction'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates a <see cref="T:System.ComponentModel.Design.DesignerTransaction" /> that can be used to encapsulate a series of operations. Designer transactions can improve performance, reduce flicker caused by multiple updates during a process of operations, and enable most operations to be undone.</para>
@@ -224,6 +232,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.ComponentModel.Design.DesignerTransaction" /> that can encapsulate event sequences to improve performance and enable undo and redo support functionality, using the specified transaction description.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ComponentModel.Design.DesignerTransaction" />. When you have completed the steps in your transaction, you should call <see cref="M:System.ComponentModel.Design.DesignerTransaction.Commit" /> on this object.</para>
+        </returns>
         <param name="description">
           <attribution license="cc4" from="Microsoft" modified="false" />A title or description for the newly created transaction. </param>
       </Docs>
@@ -293,12 +305,15 @@
         <Parameter Name="component" Type="System.ComponentModel.IComponent" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IDesigner'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the designer instance that contains the specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.Design.IDesigner" />, or null if there is no designer for the specified component.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.IComponent" /> to retrieve the designer for. </param>
       </Docs>
@@ -319,12 +334,15 @@
         <Parameter Name="typeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Type'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an instance of the specified, fully qualified type name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type object for the specified type name, or null if the type cannot be found.</para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the type to load. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design/IDesignerOptionService.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design/IDesignerOptionService.xml
index 85205636b20..e42e0fb2382 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design/IDesignerOptionService.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design/IDesignerOptionService.xml
@@ -41,7 +41,6 @@
         <Parameter Name="valueName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="pageName" /> parameter should consist of "WindowsFormsDesigner\CategoryName", where CategoryName is an options category name without any white space characters. The category name is typically "General". Therefore, you can access the "General" designer options category with the English page name "WindowsFormsDesigner\General".</para>
@@ -179,6 +178,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified Windows Forms Designer option.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified option.</para>
+        </returns>
         <param name="pageName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the page that defines the option. </param>
         <param name="valueName">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design/IDictionaryService.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design/IDictionaryService.xml
index 71ea30dd570..fbcbbfce743 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design/IDictionaryService.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design/IDictionaryService.xml
@@ -39,12 +39,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the key corresponding to the specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The associated key, or null if no key exists.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to look up in the dictionary. </param>
       </Docs>
@@ -65,12 +68,15 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value corresponding to the specified key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The associated value, or null if no value exists.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key to look up the value for. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design/IEventBindingService.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design/IEventBindingService.xml
index 9c103e5107b..b46ae1554ac 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design/IEventBindingService.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design/IEventBindingService.xml
@@ -47,7 +47,6 @@
         <Parameter Name="e" Type="System.ComponentModel.EventDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns a name that is unique from any other method name in the user's source code.</para>
@@ -56,6 +55,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a unique name for an event-handler method for the specified component and event.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The recommended name for the event-handler method for this event.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component instance the event is connected to. </param>
         <param name="e">
@@ -78,7 +81,6 @@
         <Parameter Name="e" Type="System.ComponentModel.EventDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Collections.ICollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Each string in the collection is the name of a method that has a method signature compatible with the specified event.</para>
@@ -87,6 +89,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of event-handler methods that have a method signature compatible with the specified event.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of strings.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />The event to get the compatible event-handler methods for. </param>
       </Docs>
@@ -107,12 +113,15 @@
         <Parameter Name="property" Type="System.ComponentModel.PropertyDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ComponentModel.EventDescriptor'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <see cref="T:System.ComponentModel.EventDescriptor" /> for the event that the specified property descriptor represents, if it represents an event.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptor" /> for the event that the property represents, or null if the property does not represent an event.</para>
+        </returns>
         <param name="property">
           <attribution license="cc4" from="Microsoft" modified="false" />The property that represents an event. </param>
       </Docs>
@@ -133,7 +142,6 @@
         <Parameter Name="events" Type="System.ComponentModel.EventDescriptorCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ComponentModel.PropertyDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Each returned <see cref="T:System.ComponentModel.PropertyDescriptor" /> has a <see cref="P:System.ComponentModel.PropertyDescriptor.PropertyType" /> of string.</para>
@@ -142,6 +150,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a set of event descriptors to a set of property descriptors.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.ComponentModel.PropertyDescriptor" /> objects that describe the event set.</para>
+        </returns>
         <param name="events">
           <attribution license="cc4" from="Microsoft" modified="false" />The events to convert to properties. </param>
       </Docs>
@@ -162,7 +174,6 @@
         <Parameter Name="e" Type="System.ComponentModel.EventDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ComponentModel.PropertyDescriptor'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned <see cref="T:System.ComponentModel.PropertyDescriptor" /> has a <see cref="P:System.ComponentModel.PropertyDescriptor.PropertyType" /> of string.</para>
@@ -171,6 +182,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a single event descriptor to a property descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptor" /> that describes the event.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />The event to convert. </param>
       </Docs>
@@ -189,7 +204,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method displays the code editor.</para>
@@ -198,6 +212,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays the user code for the designer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the code is displayed; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ShowCode">
@@ -216,7 +234,6 @@
         <Parameter Name="lineNumber" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method displays the code editor and positions the cursor on the specified line.</para>
@@ -225,6 +242,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays the user code for the designer at the specified line.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the code is displayed; otherwise, false.</para>
+        </returns>
         <param name="lineNumber">
           <attribution license="cc4" from="Microsoft" modified="false" />The line number to place the caret on. </param>
       </Docs>
@@ -246,7 +267,6 @@
         <Parameter Name="e" Type="System.ComponentModel.EventDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method displays the code editor and positions the cursor on the line that the specified event is declared on.</para>
@@ -255,6 +275,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays the user code for the specified event.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the code is displayed; otherwise, false.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component that the event is connected to. </param>
         <param name="e">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design/IExtenderListService.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design/IExtenderListService.xml
index 07962a9e216..e039fa20425 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design/IExtenderListService.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design/IExtenderListService.xml
@@ -37,12 +37,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ComponentModel.IExtenderProvider []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the set of extender providers for the component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.ComponentModel.IExtenderProvider" /> that lists the active extender providers. If there are no providers, an empty array is returned.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design/IHelpService.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design/IHelpService.xml
index 010344cea34..26d98ade749 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design/IHelpService.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design/IHelpService.xml
@@ -97,12 +97,15 @@
         <Parameter Name="contextType" Type="System.ComponentModel.Design.HelpContextType" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IHelpService'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a local <see cref="T:System.ComponentModel.Design.IHelpService" /> to manage subcontexts.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created <see cref="T:System.ComponentModel.Design.IHelpService" />.</para>
+        </returns>
         <param name="contextType">
           <attribution license="cc4" from="Microsoft" modified="false" />The priority type of the subcontext to add. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design/IInheritanceService.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design/IInheritanceService.xml
index b655cce0152..e472ebf074f 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design/IInheritanceService.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design/IInheritanceService.xml
@@ -71,7 +71,6 @@
         <Parameter Name="component" Type="System.ComponentModel.IComponent" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ComponentModel.InheritanceAttribute'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the component has been profiled by the <see cref="M:System.ComponentModel.Design.IInheritanceService.AddInheritedComponents(System.ComponentModel.IComponent,System.ComponentModel.IContainer)" /> method, this method returns the value <see cref="F:System.ComponentModel.InheritanceAttribute.NotInherited" />. Otherwise, it returns the inheritance attribute for this component.</para>
@@ -81,6 +80,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the inheritance attribute for the specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.ComponentModel.InheritanceAttribute" /> that describes the level of inheritance of the specified component.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.IComponent" /> for which to retrieve the inheritance attribute. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design/IMenuCommandService.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design/IMenuCommandService.xml
index f2d614e3f8c..c6d96aa9be5 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design/IMenuCommandService.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design/IMenuCommandService.xml
@@ -146,12 +146,15 @@
         <Parameter Name="commandID" Type="System.ComponentModel.Design.CommandID" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MenuCommand'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified command ID and returns the menu command associated with it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ComponentModel.Design.MenuCommand" /> associated with the command ID, or null if no command is found.</para>
+        </returns>
         <param name="commandID">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.CommandID" /> to search for. </param>
       </Docs>
@@ -172,7 +175,6 @@
         <Parameter Name="commandID" Type="System.ComponentModel.Design.CommandID" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method searches for a menu command or designer verb with a <see cref="T:System.ComponentModel.Design.CommandID" /> matching the specified <see cref="T:System.ComponentModel.Design.CommandID" />. This method first searches within the designer verbs collection consisting of global and active designer-provided verbs before continuing the search, if necessary, through the global environment command service. If a matching menu command or designer verb is located, the command is invoked.</para>
@@ -181,6 +183,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes a menu or designer verb command matching the specified command ID.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the command was found and invoked successfully; otherwise, false.</para>
+        </returns>
         <param name="commandID">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Design.CommandID" /> of the command to search for and execute. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design/IReferenceService.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design/IReferenceService.xml
index eaed31cca9b..9155f91cbae 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design/IReferenceService.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design/IReferenceService.xml
@@ -53,12 +53,15 @@
         <Parameter Name="reference" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ComponentModel.IComponent'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the component that contains the specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The base <see cref="T:System.ComponentModel.IComponent" /> that contains the specified object, or null if no parent component exists.</para>
+        </returns>
         <param name="reference">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to retrieve the parent component for. </param>
       </Docs>
@@ -79,7 +82,6 @@
         <Parameter Name="reference" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The name of each component sited in a design time project is set in the <see cref="P:System.ComponentModel.ISite.Name" /> property of the <see cref="T:System.ComponentModel.ISite" /> where the component is sited.</para>
@@ -88,6 +90,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the name of the specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the object referenced, or null if the object reference is not valid.</para>
+        </returns>
         <param name="reference">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to return the name of. </param>
       </Docs>
@@ -108,12 +114,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a reference to the component whose name matches the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object the specified name refers to, or null if no reference is found.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the component to return a reference to. </param>
       </Docs>
@@ -132,12 +141,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all available references to project components.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of all objects with references available to the <see cref="T:System.ComponentModel.Design.IReferenceService" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetReferences">
@@ -156,12 +168,15 @@
         <Parameter Name="baseType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all available references to components of the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of all available objects of the specified type.</para>
+        </returns>
         <param name="baseType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of object to return references to instances of. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design/IResourceService.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design/IResourceService.xml
index d5aa06698a9..1d6ac4373ed 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design/IResourceService.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design/IResourceService.xml
@@ -39,7 +39,6 @@
         <Parameter Name="info" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Resources.IResourceReader'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If no resources are associated with the designer for the specified culture, this method returns null.</para>
@@ -48,6 +47,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Locates the resource reader for the specified culture and returns it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Resources.IResourceReader" /> interface that contains the resources for the culture, or null if no resources for the culture exist.</para>
+        </returns>
         <param name="info">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Globalization.CultureInfo" /> of the resource for which to retrieve a resource reader. </param>
       </Docs>
@@ -68,7 +71,6 @@
         <Parameter Name="info" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Resources.IResourceWriter'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates a new resource for the specified culture and destroys an existing resource, if one already exists.</para>
@@ -77,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Locates the resource writer for the specified culture and returns it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Resources.IResourceWriter" /> interface for the specified culture.</para>
+        </returns>
         <param name="info">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Globalization.CultureInfo" /> of the resource for which to create a resource writer. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design/IRootDesigner.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design/IRootDesigner.xml
index e230f304e3d..c5c5219bc2d 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design/IRootDesigner.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design/IRootDesigner.xml
@@ -51,7 +51,6 @@
         <Parameter Name="technology" Type="System.ComponentModel.Design.ViewTechnology" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns a view object that can present a user interface to the user. The returned data type is an <see cref="T:System.Object" />, because there can be a variety of different user interface technologies. Development environments typically support more than one technology.</para>
@@ -63,6 +62,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a view object for the specified view technology.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the view for this designer.</para>
+        </returns>
         <param name="technology">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.Design.ViewTechnology" /> that indicates a particular view technology.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design/ISelectionService.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design/ISelectionService.xml
index 153768b7d98..48ce0c576c1 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design/ISelectionService.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design/ISelectionService.xml
@@ -44,7 +44,6 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to check whether a specific component is currently selected. This process is generally quicker than getting and parsing the entire list of selected components.</para>
@@ -53,6 +52,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified component is currently selected.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the component is part of the user's current selection; otherwise, false.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to test. </param>
       </Docs>
@@ -71,12 +74,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.ICollection'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of components that are currently selected.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection that represents the current set of components that are selected.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="PrimarySelection">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design/ITypeDescriptorFilterService.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design/ITypeDescriptorFilterService.xml
index c483bc5936c..88cc810d758 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design/ITypeDescriptorFilterService.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design/ITypeDescriptorFilterService.xml
@@ -78,7 +78,6 @@
         <Parameter Name="attributes" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called when a user requests a set of attributes for a component. The attributes are added to the dictionary with the attribute's <see cref="P:System.Attribute.TypeId" /> as the keys and the actual attribute as the value. Implementers of this service can add, remove, or alter existing attribute entries in the dictionary.</para>
@@ -87,6 +86,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Filters the attributes that a component exposes through a <see cref="T:System.ComponentModel.TypeDescriptor" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the set of filtered attributes is to be cached; false if the filter service must query again.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to filter the attributes of. </param>
         <param name="attributes">
@@ -110,7 +113,6 @@
         <Parameter Name="events" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called when a user requests a set of events for a component. The events are added to the dictionary with the event names as the keys and the corresponding <see cref="T:System.ComponentModel.EventDescriptor" /> objects as the values. Implementers of this service can add, remove, or alter event entries in the dictionary.</para>
@@ -119,6 +121,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Filters the events that a component exposes through a <see cref="T:System.ComponentModel.TypeDescriptor" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the set of filtered events is to be cached; false if the filter service must query again.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to filter events for. </param>
         <param name="events">
@@ -142,7 +148,6 @@
         <Parameter Name="properties" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called when a user requests a set of properties for a component. The properties are added to the dictionary with the property names as the keys and the corresponding <see cref="T:System.ComponentModel.PropertyDescriptor" /> objects as the values. Implementers of this service can add, remove, or alter property entries in the dictionary.</para>
@@ -151,6 +156,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Filters the properties that a component exposes through a <see cref="T:System.ComponentModel.TypeDescriptor" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the set of filtered properties is to be cached; false if the filter service must query again.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to filter properties for. </param>
         <param name="properties">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design/ITypeDiscoveryService.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design/ITypeDiscoveryService.xml
index ddad5dd6c82..10c12929fd8 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design/ITypeDiscoveryService.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design/ITypeDiscoveryService.xml
@@ -35,7 +35,6 @@
         <Parameter Name="excludeGlobalTypes" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="baseType" /> is null, all types are returned. Otherwise, only types derived from the specified base type are returned. If <paramref name="excludeGlobalTypes" /> is false, types from all referenced assemblies are checked. Otherwise, only types from non-Global Assembly Cache (GAC) referenced assemblies are checked. For more information, see <format type="text/html"><a href="8A18E5C2-D41D-49EF-ABCB-7C27E2469433">Working with Assemblies and the Global Assembly Cache</a></format>.</para>
@@ -44,6 +43,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the list of available types.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of types that match the criteria specified by <paramref name="baseType" /> and <paramref name="excludeGlobalTypes" />.</para>
+        </returns>
         <param name="baseType">
           <attribution license="cc4" from="Microsoft" modified="false" />The base type to match. Can be null.</param>
         <param name="excludeGlobalTypes">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design/ITypeResolutionService.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design/ITypeResolutionService.xml
index 32b5a4876e1..137b768773e 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design/ITypeResolutionService.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design/ITypeResolutionService.xml
@@ -39,12 +39,15 @@
         <Parameter Name="name" Type="System.Reflection.AssemblyName" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.Assembly'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the requested assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the requested assembly, or null if no assembly can be located.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the assembly to retrieve. </param>
       </Docs>
@@ -66,12 +69,15 @@
         <Parameter Name="throwOnError" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.Assembly'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the requested assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the requested assembly, or null if no assembly can be located.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the assembly to retrieve. </param>
         <param name="throwOnError">
@@ -94,12 +100,15 @@
         <Parameter Name="name" Type="System.Reflection.AssemblyName" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the path to the file from which the assembly was loaded.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The path to the file from which the assembly was loaded.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the assembly. </param>
       </Docs>
@@ -120,12 +129,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Type'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads a type with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Type" /> that corresponds to the specified name, or null if no type can be found.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the type. If the type name is not a fully qualified name that indicates an assembly, this service will search its internal set of referenced assemblies. </param>
       </Docs>
@@ -147,7 +159,6 @@
         <Parameter Name="throwOnError" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Type'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the type cannot be loaded and the <paramref name="throwOnError" /> parameter is true, this will throw an exception.</para>
@@ -156,6 +167,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads a type with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Type" /> that corresponds to the specified name, or null if no type can be found.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the type. If the type name is not a fully qualified name that indicates an assembly, this service will search its internal set of referenced assemblies. </param>
         <param name="throwOnError">
@@ -180,7 +195,6 @@
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Type'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the type cannot be loaded and the <paramref name="throwOnError" /> parameter is true, this will throw an exception.</para>
@@ -189,6 +203,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads a type with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Type" /> that corresponds to the specified name, or null if no type can be found.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the type. If the type name is not a fully qualified name that indicates an assembly, this service will search its internal set of referenced assemblies. </param>
         <param name="throwOnError">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design/MenuCommand.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design/MenuCommand.xml
index 39526b5eea6..ed3624fc963 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design/MenuCommand.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design/MenuCommand.xml
@@ -332,12 +332,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of this menu command.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the value of the <see cref="P:System.ComponentModel.Design.MenuCommand.CommandID" /> property appended with the names of any flags that are set, separated by pipe bars (|). These flag properties include <see cref="P:System.ComponentModel.Design.MenuCommand.Checked" />, <see cref="P:System.ComponentModel.Design.MenuCommand.Enabled" />, <see cref="P:System.ComponentModel.Design.MenuCommand.Supported" />, and <see cref="P:System.ComponentModel.Design.MenuCommand.Visible" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Visible">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design/ServiceContainer.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design/ServiceContainer.xml
index f8d9404acd6..f6f4c8b34d7 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design/ServiceContainer.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design/ServiceContainer.xml
@@ -300,12 +300,15 @@
         <Parameter Name="serviceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the requested service.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the service if it could be found, or null if it could not be found.</para>
+        </returns>
         <param name="serviceType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of service to retrieve. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel.Design/TypeDescriptionProviderService.xml b/mcs/class/System/Documentation/en/System.ComponentModel.Design/TypeDescriptionProviderService.xml
index 52a75c06ad1..1d5dc33fe05 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel.Design/TypeDescriptionProviderService.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel.Design/TypeDescriptionProviderService.xml
@@ -48,12 +48,15 @@
         <Parameter Name="instance" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a type description provider for the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeDescriptionProvider" /> that corresponds with <paramref name="instance" />.</para>
+        </returns>
         <param name="instance">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to get a type description provider for.</param>
       </Docs>
@@ -72,12 +75,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a type description provider for the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeDescriptionProvider" /> that corresponds with <paramref name="type" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to get a type description provider for.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/AmbientValueAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/AmbientValueAttribute.xml
index 42df539b6b0..bccea21246b 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/AmbientValueAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/AmbientValueAttribute.xml
@@ -304,12 +304,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.ComponentModel.AmbientValueAttribute" /> is equal to the current <see cref="T:System.ComponentModel.AmbientValueAttribute" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.ComponentModel.AmbientValueAttribute" /> is equal to the current <see cref="T:System.ComponentModel.AmbientValueAttribute" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.AmbientValueAttribute" /> to compare with the current <see cref="T:System.ComponentModel.AmbientValueAttribute" />.</param>
       </Docs>
@@ -328,12 +331,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.ComponentModel.AmbientValueAttribute" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/ArrayConverter.xml b/mcs/class/System/Documentation/en/System.ComponentModel/ArrayConverter.xml
index dd079d7ca74..8d9d0f6b685 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/ArrayConverter.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/ArrayConverter.xml
@@ -67,7 +67,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This converter can convert an array to a string.</para>
@@ -80,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given value object to the specified destination type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
@@ -108,7 +111,6 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -132,6 +134,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of properties for the type of array specified by the value parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> with the properties that are exposed for an array, or null if there are no properties.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="value">
@@ -156,7 +162,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -165,6 +170,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this object supports properties.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true because <see cref="M:System.ComponentModel.ArrayConverter.GetProperties(System.ComponentModel.ITypeDescriptorContext,System.Object,System.Attribute[])" /> should be called to find the properties of this object. This method never returns false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/AsyncOperationManager.xml b/mcs/class/System/Documentation/en/System.ComponentModel/AsyncOperationManager.xml
index 6bb39b470c1..defb7d881a9 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/AsyncOperationManager.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/AsyncOperationManager.xml
@@ -40,7 +40,6 @@
         <Parameter Name="userSuppliedState" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -56,6 +55,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.ComponentModel.AsyncOperation" /> for tracking the duration of a particular asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.AsyncOperation" /> that you can use to track the duration of an asynchronous method invocation.</para>
+        </returns>
         <param name="userSuppliedState">
           <attribution license="cc4" from="Microsoft" modified="false" />An object used to associate a piece of client state, such as a task ID, with a particular asynchronous operation. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/AttributeCollection.xml b/mcs/class/System/Documentation/en/System.ComponentModel/AttributeCollection.xml
index 85fbf99ec4f..a6f35866e14 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/AttributeCollection.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/AttributeCollection.xml
@@ -119,7 +119,6 @@
       </Parameters>
       <Docs>
         <param name="attr">To be added: an object of type 'Attribute'</param>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This collection has the specified attribute if the specified type of attribute exists in the collection, and if the value of the specified attribute is the same as the value of the instance of the attribute in the collection.</para>
@@ -130,6 +129,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether this collection of attributes has the specified attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the attribute or is the default attribute for the type of attribute; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Contains">
@@ -148,7 +151,6 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This collection has the specified array of attributes if all the specified attribute types exist in the collection and if each attribute in the specified array is the same as an attribute in the collection.</para>
@@ -157,6 +159,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether this attribute collection contains all the specified attributes in the attribute array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains all the attributes; otherwise, false.</para>
+        </returns>
         <param name="attributes">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Attribute" /> to find in the collection. </param>
       </Docs>
@@ -256,7 +262,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <paramref name="newAttributes" /> parameter is provided, its <see cref="T:System.Attribute" /> entries are merged with those of the <paramref name="existing" /> parameter.</para>
@@ -265,6 +270,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.ComponentModel.AttributeCollection" /> from an existing <see cref="T:System.ComponentModel.AttributeCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ComponentModel.AttributeCollection" /> that is a copy of <paramref name="existing" />.</para>
+        </returns>
         <param name="existing">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.AttributeCollection" /> from which to create the copy.</param>
         <param name="newAttributes">
@@ -287,12 +296,15 @@
         <Parameter Name="attributeType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Attribute'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the default <see cref="T:System.Attribute" /> of a given <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The default <see cref="T:System.Attribute" /> of a given <paramref name="attributeType" />.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the attribute to retrieve. </param>
       </Docs>
@@ -311,12 +323,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IEnumerator'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an enumerator for this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator of type <see cref="T:System.Collections.IEnumerator" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Item">
@@ -380,7 +395,6 @@
       </Parameters>
       <Docs>
         <param name="attr">To be added: an object of type 'Attribute'</param>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An attribute can provide support for matching.</para>
@@ -391,6 +405,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a specified attribute is the same as an attribute in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute is contained within the collection and has the same value as the attribute in the collection; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Matches">
@@ -409,7 +427,6 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An attribute can provide support for matching.</para>
@@ -418,6 +435,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the attributes in the specified array are the same as the attributes in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if all the attributes in the array are contained in the collection and have the same values as the attributes in the collection; otherwise, false.</para>
+        </returns>
         <param name="attributes">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.CodeDom.MemberAttributes" /> to compare with the attributes in this collection. </param>
       </Docs>
@@ -499,12 +520,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.Collections.IDictionary" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.Collections.IDictionary" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/BaseNumberConverter.xml b/mcs/class/System/Documentation/en/System.ComponentModel/BaseNumberConverter.xml
index 3abfcf1b11e..3e6e3e6fee6 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/BaseNumberConverter.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/BaseNumberConverter.xml
@@ -59,12 +59,15 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if this converter can convert an object in the given source type to the native type of the converter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the operation; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="sourceType">
@@ -88,12 +91,15 @@
         <Parameter Name="t" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this converter can convert an object to the given destination type using the context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the operation; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="t">
@@ -118,12 +124,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given object to the converter's native type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
@@ -151,12 +160,15 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object to another type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/BindableAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/BindableAttribute.xml
index 52c8de5962b..dae15412adc 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/BindableAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/BindableAttribute.xml
@@ -220,12 +220,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two <see cref="T:System.ComponentModel.BindableAttribute" /> objects are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.ComponentModel.BindableAttribute" /> is equal to the current <see cref="T:System.ComponentModel.BindableAttribute" />; false if it is not equal.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare.</param>
       </Docs>
@@ -244,12 +247,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for the <see cref="T:System.ComponentModel.BindableAttribute" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.ComponentModel.BindableAttribute" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsDefaultAttribute">
@@ -266,12 +272,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if this attribute is the default.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute is the default value for this attribute class; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="No">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/BindingList`1.xml b/mcs/class/System/Documentation/en/System.ComponentModel/BindingList`1.xml
index daa5eeb52b7..ec19e515b84 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/BindingList`1.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/BindingList`1.xml
@@ -165,7 +165,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.BindingList`1.AddNew" /> method adds a new item to the collection represented by the <see cref="P:System.Collections.ObjectModel.Collection`1.Items" /> property. To add a new item, the following logic is used:</para>
@@ -194,6 +193,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new item to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The item added to the list.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="AddNewCore">
@@ -209,7 +212,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.BindingList`1.AddNewCore" /> method adds a new item to the collection represented by the <see cref="P:System.Collections.ObjectModel.Collection`1.Items" /> property. <see cref="M:System.ComponentModel.BindingList`1.AddNewCore" /> raises the <see cref="E:System.ComponentModel.BindingList`1.AddingNew" /> event. This allows you to add a new item by setting the <see cref="P:System.ComponentModel.AddingNewEventArgs.NewObject" /> property of the <see cref="T:System.ComponentModel.AddingNewEventArgs" /> parameter to the new item. Otherwise, the new item is automatically created through its public default constructor.</para>
@@ -218,6 +220,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new item to the end of the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The item that was added to the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="AllowEdit">
@@ -430,7 +436,6 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.ComponentModel.BindingList`1" /> class does not provide a base implementation of searching, and so <see cref="M:System.ComponentModel.BindingList`1.FindCore(System.ComponentModel.PropertyDescriptor,System.Object)" /> always throws a <see cref="T:System.NotSupportedException" /> by default. To enable searching, derive from <see cref="T:System.ComponentModel.BindingList`1" /> and perform the following tasks:</para>
@@ -447,6 +452,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the index of the item that has the specified property descriptor with the specified value, if searching is implemented in a derived class; otherwise, a <see cref="T:System.NotSupportedException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the item that matches the property descriptor and contains the specified value.</para>
+        </returns>
         <param name="prop">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.PropertyDescriptor" /> to search for.</param>
         <param name="key">
@@ -908,7 +917,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.ComponentModel.BindingList`1" /> instance is cast to an <see cref="T:System.ComponentModel.IBindingList" /> interface.</para>
@@ -918,6 +926,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new item to the list. For more information, see <see cref="M:System.ComponentModel.IBindingList.AddNew" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The item added to the list.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.ComponentModel.IBindingList.AllowEdit">
@@ -1029,7 +1041,6 @@
       </Parameters>
       <Docs>
         <param name="property">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.ComponentModel.BindingList`1" /> instance is cast to an <see cref="T:System.ComponentModel.IBindingList" /> interface.</para>
@@ -1038,6 +1049,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.ComponentModel.IBindingList.Find(System.ComponentModel.PropertyDescriptor,System.Object)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the row that has the given <see cref="T:System.ComponentModel.PropertyDescriptor" /> .</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The value of the <paramref name="property" /> parameter to search for.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/BooleanConverter.xml b/mcs/class/System/Documentation/en/System.ComponentModel/BooleanConverter.xml
index 14af7f9d4e3..b24accff397 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/BooleanConverter.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/BooleanConverter.xml
@@ -66,7 +66,6 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This converter can only convert a Boolean object to and from a string.</para>
@@ -76,6 +75,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this converter can convert an object in the given source type to a Boolean object using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this object can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="sourceType">
@@ -100,7 +103,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This converter can only convert a Boolean object to and from a string.</para>
@@ -110,6 +112,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given value object to a Boolean object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted <paramref name="value" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
@@ -134,7 +140,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TypeConverter+StandardValuesCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The Boolean data type has two standard values, true and false.</para>
@@ -143,6 +148,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of standard values for the Boolean data type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> that holds a standard set of valid values.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
@@ -163,7 +172,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The Boolean data type has only two standard values, true and false. The <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> returned from this method has all possible values. Therefore, this method always returns true.</para>
@@ -172,6 +180,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the list of standard values returned from the <see cref="M:System.ComponentModel.BooleanConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> method is an exclusive list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true because the <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> returned from <see cref="M:System.ComponentModel.BooleanConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> is an exhaustive list of possible values. This method never returns false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
@@ -192,7 +204,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The Boolean data type supports standard values, because a Boolean can only be true or false. Therefore, this method always returns true.</para>
@@ -201,6 +212,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this object supports a standard set of values that can be picked from a list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true because <see cref="M:System.ComponentModel.BooleanConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> can be called to find a common set of values the object supports. This method never returns false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/BrowsableAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/BrowsableAttribute.xml
index 9f804bfd78e..2ab63ece6c8 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/BrowsableAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/BrowsableAttribute.xml
@@ -122,12 +122,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether this instance and a specified object are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is equal to this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />Another object to compare to. </param>
       </Docs>
@@ -146,12 +149,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsDefaultAttribute">
@@ -168,12 +174,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if this attribute is the default.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute is the default value for this attribute class; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="No">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/CategoryAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/CategoryAttribute.xml
index 4565a6a89d6..d7c8e011c81 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/CategoryAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/CategoryAttribute.xml
@@ -285,12 +285,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the value of the given object is equal to the current <see cref="T:System.ComponentModel.CategoryAttribute" />..</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of the given object is equal to that of the current; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test the value equality of. </param>
       </Docs>
@@ -351,12 +354,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetLocalizedString">
@@ -375,7 +381,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="P:System.ComponentModel.CategoryAttribute.Category" /> property calls this method the first time it is accessed to look up the localized name for the specified category.</para>
@@ -384,6 +389,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Looks up the localized name of the specified category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The localized name of the category, or null if a localized name does not exist.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The identifer for the category to look up. </param>
       </Docs>
@@ -402,12 +411,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if this attribute is the default.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute is the default value for this attribute class; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Key">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/CharConverter.xml b/mcs/class/System/Documentation/en/System.ComponentModel/CharConverter.xml
index bdaafae12db..52b34b081f4 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/CharConverter.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/CharConverter.xml
@@ -66,7 +66,6 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This converter can only convert a string, with a length of 1, to and from a character.</para>
@@ -76,6 +75,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this converter can convert an object in the given source type to a Unicode character object using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="sourceType">
@@ -100,7 +103,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This converter can only convert a string, with a length of 1, to and from a character.</para>
@@ -110,6 +112,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given object to a Unicode character object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted <paramref name="value" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
@@ -137,12 +143,15 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given value object to a Unicode character object using the arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/CollectionConverter.xml b/mcs/class/System/Documentation/en/System.ComponentModel/CollectionConverter.xml
index 0e2beb3cfbf..5a51b1a1427 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/CollectionConverter.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/CollectionConverter.xml
@@ -68,7 +68,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -80,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given value object to the specified destination type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
@@ -108,7 +111,6 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -133,6 +135,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of properties for the type of array specified by the value parameter using the specified context and attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> with the properties that are exposed for this data type, or null if there are no properties. This method always returns null.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="value">
@@ -157,7 +163,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -167,6 +172,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this object supports properties.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>false because <see cref="M:System.ComponentModel.CollectionConverter.GetProperties(System.ComponentModel.ITypeDescriptorContext,System.Object,System.Attribute[])" /> should not be called to find the properties of this object. This method never returns true.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/ComplexBindingPropertiesAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/ComplexBindingPropertiesAttribute.xml
index 81bb706094b..6310db9baea 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/ComplexBindingPropertiesAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/ComplexBindingPropertiesAttribute.xml
@@ -184,7 +184,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.ComplexBindingPropertiesAttribute.Equals(System.Object)" /> method returns true if <paramref name="obj" /> is of type <see cref="T:System.ComponentModel.ComplexBindingPropertiesAttribute" /> and the <see cref="P:System.ComponentModel.ComplexBindingPropertiesAttribute.DataSource" /> and <see cref="P:System.ComponentModel.ComplexBindingPropertiesAttribute.DataMember" /> properties of the two objects are equal.</para>
@@ -193,6 +192,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.ComponentModel.ComplexBindingPropertiesAttribute" /> instance. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object is equal to the current instance; otherwise, false, indicating they are not equal.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to compare with the current <see cref="T:System.ComponentModel.ComplexBindingPropertiesAttribute" /> instance </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/Component.xml b/mcs/class/System/Documentation/en/System.ComponentModel/Component.xml
index ab74c69d9ee..68bba197879 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/Component.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/Component.xml
@@ -305,7 +305,6 @@
         <Parameter Name="service" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be overridden by a derived class.</para>
@@ -314,6 +313,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that represents a service provided by the <see cref="T:System.ComponentModel.Component" /> or by its <see cref="T:System.ComponentModel.Container" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents a service provided by the <see cref="T:System.ComponentModel.Component" />, or null if the <see cref="T:System.ComponentModel.Component" /> does not provide the specified service.</para>
+        </returns>
         <param name="service">
           <attribution license="cc4" from="Microsoft" modified="false" />A service provided by the <see cref="T:System.ComponentModel.Component" />. </param>
       </Docs>
@@ -368,7 +371,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A <see cref="T:System.ComponentModel.Component" /> may or may not have a name. If a <see cref="T:System.ComponentModel.Component" /> is given a name, the name is unique among other <see cref="T:System.ComponentModel.Component" /> objects within its <see cref="T:System.ComponentModel.IContainer" />.</para>
@@ -378,6 +380,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.String" /> containing the name of the <see cref="T:System.ComponentModel.Component" />, if any. This method should not be overridden.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the name of the <see cref="T:System.ComponentModel.Component" />, if any, or null if the <see cref="T:System.ComponentModel.Component" /> is unnamed.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/ComponentConverter.xml b/mcs/class/System/Documentation/en/System.ComponentModel/ComponentConverter.xml
index 3cc2d4b21b7..c19601dc73f 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/ComponentConverter.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/ComponentConverter.xml
@@ -72,7 +72,6 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -96,6 +95,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of properties for the type of component specified by the value parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> with the properties that are exposed for the component, or null if there are no properties.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="value">
@@ -120,7 +123,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -129,6 +131,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this object supports properties using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true because <see cref="M:System.ComponentModel.TypeConverter.GetProperties(System.Object)" /> should be called to find the properties of this object. This method never returns false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/ComponentEditor.xml b/mcs/class/System/Documentation/en/System.ComponentModel/ComponentEditor.xml
index 758f9f86ab7..e28ebaa0571 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/ComponentEditor.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/ComponentEditor.xml
@@ -61,7 +61,6 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method opens an advanced user interface that you can use to edit the component. The default implementation opens a dialog box with a collection of component editor control objects and a user interface.</para>
@@ -70,6 +69,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Edits the component and returns a value indicating whether the component was modified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the component was modified; otherwise, false.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to be edited. </param>
       </Docs>
@@ -91,7 +94,6 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can override this method to provide a custom editing user interface for a component. From within this method you can display a dialog box or other type of user interface.</para>
@@ -100,6 +102,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Edits the component and returns a value indicating whether the component was modified based upon a given context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the component was modified; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An optional context object that can be used to obtain further information about the edit. </param>
         <param name="component">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/Container.xml b/mcs/class/System/Documentation/en/System.ComponentModel/Container.xml
index 4249870df5d..2c97b028ab8 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/Container.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/Container.xml
@@ -157,7 +157,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ISite'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <paramref name="name" /> parameter is null, the <see cref="T:System.ComponentModel.IComponent" /> is added to the <see cref="T:System.ComponentModel.Container" /> without an identifying name.</para>
@@ -167,6 +166,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a site <see cref="T:System.ComponentModel.ISite" /> for the given <see cref="T:System.ComponentModel.IComponent" /> and assigns the given name to the site.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created site.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.IComponent" /> to create a site for. </param>
         <param name="name">
@@ -270,7 +273,6 @@
         <Parameter Name="service" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default implementation of this method returns the current instance of the class if <paramref name="service" /> is an <see cref="T:System.ComponentModel.IContainer" />; otherwise, it returns null. You can override this method to provide a custom implementation to return a service object. For more information, see the <see cref="M:System.IServiceProvider.GetService(System.Type)" /> method.</para>
@@ -279,6 +281,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the service object of the specified type, if it is available.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> implementing the requested service, or null if the service cannot be resolved.</para>
+        </returns>
         <param name="service">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the service to retrieve. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/ContainerFilterService.xml b/mcs/class/System/Documentation/en/System.ComponentModel/ContainerFilterService.xml
index 5d3a607490c..398d555c573 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/ContainerFilterService.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/ContainerFilterService.xml
@@ -54,7 +54,6 @@
         <Parameter Name="components" Type="System.ComponentModel.ComponentCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.ContainerFilterService.FilterComponents(System.ComponentModel.ComponentCollection)" /> method filters the component collection by optionally returning a new, modified collection. The default implementation returns the input collection, thereby performing no filtering.</para>
@@ -63,6 +62,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Filters the component collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.ComponentCollection" /> that represents a modified collection.</para>
+        </returns>
         <param name="components">
           <attribution license="cc4" from="Microsoft" modified="false" />The component collection to filter.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/CultureInfoConverter.xml b/mcs/class/System/Documentation/en/System.ComponentModel/CultureInfoConverter.xml
index 853c12bdac7..1b34cef46d6 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/CultureInfoConverter.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/CultureInfoConverter.xml
@@ -66,7 +66,6 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This converter can only convert a <see cref="T:System.Globalization.CultureInfo" /> object to and from a string.</para>
@@ -76,6 +75,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this converter can convert an object in the given source type to a <see cref="T:System.Globalization.CultureInfo" /> using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="sourceType">
@@ -99,7 +102,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -108,6 +110,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this converter can convert an object to the given destination type using the context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="destinationType">
@@ -132,7 +138,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This converter can only convert a <see cref="T:System.Globalization.CultureInfo" /> object to and from a string.</para>
@@ -142,6 +147,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified value object to a <see cref="T:System.Globalization.CultureInfo" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
         <param name="culture">
@@ -169,7 +178,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This converter can only convert a <see cref="T:System.Globalization.CultureInfo" /> object to and from a string.</para>
@@ -179,6 +187,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given value object to the specified destination type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted <paramref name="value" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
@@ -203,12 +215,15 @@
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the name of the specified culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the specified culture.</para>
+        </returns>
         <param name="culture">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Globalization.CultureInfo" /> that specifies the culture to get the name for.</param>
       </Docs>
@@ -229,7 +244,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TypeConverter+StandardValuesCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -238,6 +252,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of standard values for a <see cref="T:System.Globalization.CultureInfo" /> object using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> containing a standard set of valid values, or null if the data type does not support a standard set of values.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
@@ -258,7 +276,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -268,6 +285,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the list of standard values returned from <see cref="M:System.ComponentModel.CultureInfoConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> is an exhaustive list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>false because the <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> returned from <see cref="M:System.ComponentModel.CultureInfoConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> is not an exhaustive list of possible values (that is, other values are possible). This method never returns true.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
@@ -288,7 +309,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -297,6 +317,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this object supports a standard set of values that can be picked from a list using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true because <see cref="M:System.ComponentModel.CultureInfoConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> should be called to find a common set of values the object supports. This method never returns false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/CustomTypeDescriptor.xml b/mcs/class/System/Documentation/en/System.ComponentModel/CustomTypeDescriptor.xml
index 7a7677263e0..6ffbb452b56 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/CustomTypeDescriptor.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/CustomTypeDescriptor.xml
@@ -137,7 +137,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If a parent custom type descriptor was passed to the <see cref="M:System.ComponentModel.CustomTypeDescriptor.#ctor(System.ComponentModel.ICustomTypeDescriptor)" /> constructor, the <see cref="M:System.ComponentModel.CustomTypeDescriptor.GetAttributes" /> method will call the parent's corresponding method. </para>
@@ -146,6 +145,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of custom attributes for the type represented by this type descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.AttributeCollection" /> containing the attributes for the type. The default is <see cref="F:System.ComponentModel.AttributeCollection.Empty" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetClassName">
@@ -161,7 +164,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If a parent custom type descriptor was passed to the <see cref="M:System.ComponentModel.CustomTypeDescriptor.#ctor(System.ComponentModel.ICustomTypeDescriptor)" /> constructor, the <see cref="M:System.ComponentModel.CustomTypeDescriptor.GetClassName" /> method will call the parent's corresponding method.</para>
@@ -170,6 +172,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the fully qualified name of the class represented by this type descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the fully qualified class name of the type this type descriptor is describing. The default is null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetComponentName">
@@ -185,7 +191,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If a parent custom type descriptor was passed to the <see cref="M:System.ComponentModel.CustomTypeDescriptor.#ctor(System.ComponentModel.ICustomTypeDescriptor)" /> constructor, the <see cref="M:System.ComponentModel.CustomTypeDescriptor.GetComponentName" /> method will call the parent's corresponding method.</para>
@@ -194,6 +199,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the class represented by this type descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the name of the component instance this type descriptor is describing. The default is null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetConverter">
@@ -209,7 +218,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If a parent custom type descriptor was passed into the <see cref="M:System.ComponentModel.CustomTypeDescriptor.#ctor(System.ComponentModel.ICustomTypeDescriptor)" /> constructor, the <see cref="M:System.ComponentModel.CustomTypeDescriptor.GetConverter" /> method will call the parent's corresponding method.</para>
@@ -218,6 +226,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a type converter for the type represented by this type descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter" /> for the type represented by this type descriptor. The default is a newly created <see cref="T:System.ComponentModel.TypeConverter" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetDefaultEvent">
@@ -233,7 +245,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If a parent custom type descriptor was passed into the <see cref="M:System.ComponentModel.CustomTypeDescriptor.#ctor(System.ComponentModel.ICustomTypeDescriptor)" /> constructor, the <see cref="M:System.ComponentModel.CustomTypeDescriptor.GetDefaultEvent" /> method will call the parent's corresponding method.</para>
@@ -242,6 +253,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the event descriptor for the default event of the object represented by this type descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ComponentModel.EventDescriptor" /> for the default event on the object represented by this type descriptor. The default is null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetDefaultProperty">
@@ -257,7 +272,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If a parent custom type descriptor was passed into the <see cref="M:System.ComponentModel.CustomTypeDescriptor.#ctor(System.ComponentModel.ICustomTypeDescriptor)" /> constructor, the <see cref="M:System.ComponentModel.CustomTypeDescriptor.GetDefaultProperty" /> method will call the parent's corresponding method.</para>
@@ -266,6 +280,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the property descriptor for the default property of the object represented by this type descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptor" /> for the default property on the object represented by this type descriptor. The default is null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetEditor">
@@ -283,7 +301,6 @@
         <Parameter Name="editorBaseType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If a parent custom type descriptor was passed into the <see cref="M:System.ComponentModel.CustomTypeDescriptor.#ctor(System.ComponentModel.ICustomTypeDescriptor)" /> constructor, the <see cref="M:System.ComponentModel.CustomTypeDescriptor.GetEditor(System.Type)" /> method will call the parent's corresponding method.</para>
@@ -292,6 +309,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an editor of the specified type that is to be associated with the class represented by this type descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An editor of the given type that is to be associated with the class represented by this type descriptor. The default is null.</para>
+        </returns>
         <param name="editorBaseType">
           <attribution license="cc4" from="Microsoft" modified="false" />The base type of the editor to retrieve.</param>
       </Docs>
@@ -309,7 +330,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If a parent custom type descriptor was passed into the <see cref="M:System.ComponentModel.CustomTypeDescriptor.#ctor(System.ComponentModel.ICustomTypeDescriptor)" /> constructor, the <see cref="M:System.ComponentModel.CustomTypeDescriptor.GetEvents" /> method will call the parent's corresponding method.</para>
@@ -318,6 +338,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of event descriptors for the object represented by this type descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptorCollection" /> containing the event descriptors for the object represented by this type descriptor. The default is <see cref="F:System.ComponentModel.EventDescriptorCollection.Empty" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetEvents">
@@ -335,7 +359,6 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the <paramref name="attributes" /> parameter to filter the collection that is returned.</para>
@@ -345,6 +368,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a filtered collection of event descriptors for the object represented by this type descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptorCollection" /> containing the event descriptions for the object represented by this type descriptor. The default is <see cref="F:System.ComponentModel.EventDescriptorCollection.Empty" />.</para>
+        </returns>
         <param name="attributes">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of attributes to use as a filter. This can be null.</param>
       </Docs>
@@ -362,7 +389,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If a parent custom type descriptor was passed into the <see cref="M:System.ComponentModel.CustomTypeDescriptor.#ctor(System.ComponentModel.ICustomTypeDescriptor)" /> constructor, the <see cref="M:System.ComponentModel.CustomTypeDescriptor.GetProperties" /> method will call the parent's corresponding method.</para>
@@ -371,6 +397,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of property descriptors for the object represented by this type descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> containing the property descriptions for the object represented by this type descriptor. The default is <see cref="F:System.ComponentModel.PropertyDescriptorCollection.Empty" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetProperties">
@@ -388,7 +418,6 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the <paramref name="attributes" /> parameter to filter the collection that is returned. For filtering rules, see <see cref="M:System.ComponentModel.TypeDescriptor.GetProperties(System.Object,System.Attribute[])" />. </para>
@@ -398,6 +427,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a filtered collection of property descriptors for the object represented by this type descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> containing the property descriptions for the object represented by this type descriptor. The default is <see cref="F:System.ComponentModel.PropertyDescriptorCollection.Empty" />.</para>
+        </returns>
         <param name="attributes">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of attributes to use as a filter. This can be null.</param>
       </Docs>
@@ -417,7 +450,6 @@
         <Parameter Name="pd" Type="System.ComponentModel.PropertyDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If a parent custom type descriptor was passed into the <see cref="M:System.ComponentModel.CustomTypeDescriptor.#ctor(System.ComponentModel.ICustomTypeDescriptor)" /> constructor, the <see cref="M:System.ComponentModel.CustomTypeDescriptor.GetPropertyOwner(System.ComponentModel.PropertyDescriptor)" /> method will call the parent's corresponding method.</para>
@@ -426,6 +458,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that contains the property described by the specified property descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that owns the given property specified by the type descriptor. The default is null.</para>
+        </returns>
         <param name="pd">
           <attribution license="cc4" from="Microsoft" modified="false" />The property descriptor for which to retrieve the owning object.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/DataObjectAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/DataObjectAttribute.xml
index dd0651be5d7..432dfdafeb5 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/DataObjectAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/DataObjectAttribute.xml
@@ -132,7 +132,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method determines whether this instance of <see cref="T:System.ComponentModel.DataObjectAttribute" /> fits the pattern of another object.</para>
@@ -141,6 +140,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether this instance of <see cref="T:System.ComponentModel.DataObjectAttribute" /> fits the pattern of another object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this instance is the same as the instance specified by the <paramref name="obj" /> parameter; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance of <see cref="T:System.ComponentModel.DataObjectAttribute" />. </param>
       </Docs>
@@ -158,12 +161,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsDataObject">
@@ -199,12 +205,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the current value of the attribute is the default value for the attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current value of the attribute is the default; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="NonDataObject">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/DataObjectFieldAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/DataObjectFieldAttribute.xml
index 93c53bdad97..18ea0095769 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/DataObjectFieldAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/DataObjectFieldAttribute.xml
@@ -146,7 +146,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method determines whether this instance of <see cref="T:System.ComponentModel.DataObjectFieldAttribute" /> fits the pattern of another object.</para>
@@ -155,6 +154,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this instance is the same as the instance specified by the <paramref name="obj" /> parameter; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance of <see cref="T:System.ComponentModel.DataObjectFieldAttribute" />.</param>
       </Docs>
@@ -172,12 +175,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsIdentity">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/DataObjectMethodAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/DataObjectMethodAttribute.xml
index 7ff7ad30503..258e952d3de 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/DataObjectMethodAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/DataObjectMethodAttribute.xml
@@ -90,7 +90,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method determines whether this <see cref="T:System.ComponentModel.DataObjectMethodAttribute" /> fits the pattern of another object.</para>
@@ -100,6 +99,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this instance is the same as the instance specified by the <paramref name="obj" /> parameter; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance of <see cref="T:System.ComponentModel.DataObjectMethodAttribute" />.</param>
       </Docs>
@@ -117,12 +120,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+          <para />
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsDefault">
@@ -165,7 +172,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method determines whether one <see cref="T:System.ComponentModel.DataObjectMethodAttribute" /> fits the pattern of another. Its implementation is not the same as that of <see cref="M:System.ComponentModel.DataObjectMethodAttribute.Equals(System.Object)" />, however, because it does not test for true equality. </para>
@@ -174,6 +180,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this instance shares a common pattern with a specified attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this instance is the same as the instance specified by the <paramref name="obj" /> parameter; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance of <see cref="T:System.ComponentModel.DataObjectMethodAttribute" />.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/DateTimeConverter.xml b/mcs/class/System/Documentation/en/System.ComponentModel/DateTimeConverter.xml
index 2f54b09752e..6f08c33d957 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/DateTimeConverter.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/DateTimeConverter.xml
@@ -68,7 +68,6 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This converter can only convert a <see cref="T:System.DateTime" /> to and from a string.</para>
@@ -78,6 +77,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this converter can convert an object in the given source type to a <see cref="T:System.DateTime" /> using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this object can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="sourceType">
@@ -101,7 +104,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -110,6 +112,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this converter can convert an object to the given destination type using the context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="destinationType">
@@ -134,7 +140,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This converter can only convert a <see cref="T:System.DateTime" /> to and from a string.</para>
@@ -144,6 +149,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given value object to a <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted <paramref name="value" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
@@ -171,7 +180,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This converter can only convert a <see cref="T:System.DateTime" /> to and from a string.</para>
@@ -181,6 +189,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given value object to a <see cref="T:System.DateTime" /> using the arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted <paramref name="value" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/DateTimeOffsetConverter.xml b/mcs/class/System/Documentation/en/System.ComponentModel/DateTimeOffsetConverter.xml
index 8429fed7892..3802fb29365 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/DateTimeOffsetConverter.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/DateTimeOffsetConverter.xml
@@ -49,12 +49,15 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether an object of the specified source type can be converted to a <see cref="T:System.DateTimeOffset" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified type can be converted to a <see cref="T:System.DateTimeOffset" />; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The date format context.</param>
         <param name="sourceType">
@@ -76,12 +79,15 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a <see cref="T:System.DateTimeOffset" /> can be converted to an object of the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a <see cref="T:System.DateTimeOffset" /> can be converted to the specified type; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The date format context.</param>
         <param name="destinationType">
@@ -104,12 +110,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object to a <see cref="T:System.DateTimeOffset" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DateTimeOffset" /> that represents the specified object.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The date format context.</param>
         <param name="culture">
@@ -135,12 +144,15 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a <see cref="T:System.DateTimeOffset" /> to an object of the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object of the specified type that represents the <see cref="T:System.DateTimeOffset" />. </para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The date format context.</param>
         <param name="culture">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/DecimalConverter.xml b/mcs/class/System/Documentation/en/System.ComponentModel/DecimalConverter.xml
index 1a9a30e5600..6784d20c109 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/DecimalConverter.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/DecimalConverter.xml
@@ -66,7 +66,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -75,6 +74,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this converter can convert an object to the given destination type using the context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="destinationType">
@@ -100,12 +103,15 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given value object to a <see cref="T:System.Decimal" /> using the arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/DefaultBindingPropertyAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/DefaultBindingPropertyAttribute.xml
index 8f464326501..f05fadf7ef7 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/DefaultBindingPropertyAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/DefaultBindingPropertyAttribute.xml
@@ -109,7 +109,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.DefaultBindingPropertyAttribute.Equals(System.Object)" /> method returns true if the value of the <paramref name="obj" /> parameter is of type <see cref="T:System.ComponentModel.DefaultBindingPropertyAttribute" /> and the <see cref="P:System.ComponentModel.DefaultBindingPropertyAttribute.Name" /> properties of the two objects are equal.</para>
@@ -118,6 +117,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.ComponentModel.DefaultBindingPropertyAttribute" /> instance. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object is equal to the current instance; otherwise, false, indicating they are not equal.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to compare with the current <see cref="T:System.ComponentModel.DefaultBindingPropertyAttribute" /> instance</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/DefaultEventAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/DefaultEventAttribute.xml
index cebf67aff8b..25f864d48d6 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/DefaultEventAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/DefaultEventAttribute.xml
@@ -92,12 +92,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the value of the given object is equal to the current <see cref="T:System.ComponentModel.DefaultEventAttribute" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of the given object is equal to that of the current; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test the value equality of. </param>
       </Docs>
@@ -116,12 +119,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Name">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/DefaultPropertyAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/DefaultPropertyAttribute.xml
index fa33dc618c1..fbc2915a45f 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/DefaultPropertyAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/DefaultPropertyAttribute.xml
@@ -92,12 +92,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the value of the given object is equal to the current <see cref="T:System.ComponentModel.DefaultPropertyAttribute" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of the given object is equal to that of the current; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test the value equality of. </param>
       </Docs>
@@ -116,12 +119,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Name">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/DefaultValueAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/DefaultValueAttribute.xml
index 8f7058cc3a9..c20626e53a1 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/DefaultValueAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/DefaultValueAttribute.xml
@@ -307,12 +307,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the value of the given object is equal to the current <see cref="T:System.ComponentModel.DefaultValueAttribute" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of the given object is equal to that of the current; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test the value equality of. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/DescriptionAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/DescriptionAttribute.xml
index 346892d1cb2..f86af717fdd 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/DescriptionAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/DescriptionAttribute.xml
@@ -157,12 +157,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the value of the given object is equal to the current <see cref="T:System.ComponentModel.DescriptionAttribute" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of the given object is equal to that of the current; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test the value equality of. </param>
       </Docs>
@@ -199,7 +202,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default value is an empty string ("").</para>
@@ -208,6 +210,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this is the default <see cref="T:System.ComponentModel.DescriptionAttribute" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if this is the default <see cref="T:System.ComponentModel.DescriptionAttribute" /> instance; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/DesignOnlyAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/DesignOnlyAttribute.xml
index 9e0d3c2abfd..8553e1b49b7 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/DesignOnlyAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/DesignOnlyAttribute.xml
@@ -93,12 +93,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the value of the given object is equal to the current <see cref="T:System.ComponentModel.DesignOnlyAttribute" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of the given object is equal to that of the current; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test the value equality of. </param>
       </Docs>
@@ -136,12 +139,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if this attribute is the default.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute is the default value for this attribute class; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsDesignOnly">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/DesignTimeVisibleAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/DesignTimeVisibleAttribute.xml
index 785f755ca1e..e34866a4624 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/DesignTimeVisibleAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/DesignTimeVisibleAttribute.xml
@@ -152,12 +152,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating if this instance is equal to the <see cref="F:System.ComponentModel.DesignTimeVisibleAttribute.Default" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if this instance is equal to the <see cref="F:System.ComponentModel.DesignTimeVisibleAttribute.Default" /> value; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="No">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/DesignerAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/DesignerAttribute.xml
index bbb7c7dda32..5a5ec209ae3 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/DesignerAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/DesignerAttribute.xml
@@ -233,12 +233,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the value of the given object is equal to the current <see cref="T:System.ComponentModel.DesignerAttribute" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of the given object is equal to that of the current; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test the value equality of. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/DesignerCategoryAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/DesignerCategoryAttribute.xml
index a506e620b7a..f774c2bb9f1 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/DesignerCategoryAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/DesignerCategoryAttribute.xml
@@ -202,12 +202,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the value of the given object is equal to the current <see cref="T:System.ComponentModel.DesignOnlyAttribute" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of the given object is equal to that of the current; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test the value equality of. </param>
       </Docs>
@@ -268,12 +271,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsDefaultAttribute">
@@ -290,12 +296,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if this attribute is the default.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute is the default value for this attribute class; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TypeId">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/DesignerSerializationVisibilityAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/DesignerSerializationVisibilityAttribute.xml
index 99e728fb0b8..b03d4eb554b 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/DesignerSerializationVisibilityAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/DesignerSerializationVisibilityAttribute.xml
@@ -120,12 +120,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether this instance and a specified object are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is equal to this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />Another object to compare to. </param>
       </Docs>
@@ -144,12 +147,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Hidden">
@@ -190,12 +196,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the current value of the attribute is the default value for the attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute is set to the default value; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Visibility">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/DisplayNameAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/DisplayNameAttribute.xml
index cd42178bb94..a344a70019e 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/DisplayNameAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/DisplayNameAttribute.xml
@@ -145,13 +145,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two <see cref="T:System.ComponentModel.DisplayNameAttribute" /> instances are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of the given object is equal to that of the current object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.DisplayNameAttribute" /> to test the value equality of.</param>
       </Docs>
@@ -169,13 +172,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.ComponentModel.DisplayNameAttribute" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsDefaultAttribute">
@@ -191,13 +197,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if this attribute is the default.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute is the default value for this attribute class; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/EditorAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/EditorAttribute.xml
index 255e50f890a..0a25d9ef627 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/EditorAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/EditorAttribute.xml
@@ -206,12 +206,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the value of the given object is equal to the current <see cref="T:System.ComponentModel.EditorAttribute" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of the given object is equal to that of the current object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test the value equality of. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/EditorBrowsableAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/EditorBrowsableAttribute.xml
index 833bdded58a..81932ad32d5 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/EditorBrowsableAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/EditorBrowsableAttribute.xml
@@ -97,12 +97,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the value of the given object is equal to the current <see cref="T:System.ComponentModel.EditorBrowsableAttribute" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of the given object is equal to that of the current; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test the value equality of. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/EnumConverter.xml b/mcs/class/System/Documentation/en/System.ComponentModel/EnumConverter.xml
index 333f677cf22..b9ddfd97fec 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/EnumConverter.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/EnumConverter.xml
@@ -70,7 +70,6 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This converter can only convert an enumeration object to and from a string.</para>
@@ -80,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this converter can convert an object in the given source type to an enumeration object using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="sourceType">
@@ -103,7 +106,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -112,6 +114,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this converter can convert an object to the given destination type using the context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="destinationType">
@@ -160,7 +166,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This converter can only convert an enumeration object to and from a string.</para>
@@ -170,6 +175,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified value object to an enumeration object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted <paramref name="value" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
@@ -197,7 +206,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This converter can only convert an enumeration object to and from a string.</para>
@@ -210,6 +218,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given value object to the specified destination type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted <paramref name="value" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
@@ -257,7 +269,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TypeConverter+StandardValuesCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -269,6 +280,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of standard values for the data type this validator is designed for.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> that holds a standard set of valid values, or null if the data type does not support a standard set of values.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
@@ -289,7 +304,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -298,6 +312,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the list of standard values returned from <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> is an exclusive list using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> returned from <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> is an exhaustive list of possible values; false if other values are possible.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
@@ -318,7 +336,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -327,6 +344,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this object supports a standard set of values that can be picked from a list using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true because <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> should be called to find a common set of values the object supports. This method never returns false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
@@ -348,7 +369,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -357,6 +377,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the given object value is valid for this type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified value is valid for this object; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="value">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/EventDescriptorCollection.xml b/mcs/class/System/Documentation/en/System.ComponentModel/EventDescriptorCollection.xml
index 6e0e419cf18..49510c9a3f7 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/EventDescriptorCollection.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/EventDescriptorCollection.xml
@@ -111,7 +111,6 @@
         <Parameter Name="value" Type="System.ComponentModel.EventDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -122,6 +121,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an <see cref="T:System.ComponentModel.EventDescriptor" /> to the end of the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position of the <see cref="T:System.ComponentModel.EventDescriptor" /> within the collection.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.EventDescriptor" /> to add to the collection. </param>
       </Docs>
@@ -168,7 +171,6 @@
         <Parameter Name="value" Type="System.ComponentModel.EventDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -179,6 +181,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the collection contains the given <see cref="T:System.ComponentModel.EventDescriptor" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the <paramref name="value" /> parameter given; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.EventDescriptor" /> to find within the collection. </param>
       </Docs>
@@ -248,7 +254,6 @@
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'EventDescriptor'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -259,6 +264,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the description of the event with the specified name in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ComponentModel.EventDescriptor" /> with the specified name, or null if the event does not exist.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the event to get from the collection. </param>
         <param name="ignoreCase">
@@ -279,7 +288,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IEnumerator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -290,6 +298,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an enumerator for this <see cref="T:System.ComponentModel.EventDescriptorCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator that implements <see cref="T:System.Collections.IEnumerator" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IndexOf">
@@ -308,7 +320,6 @@
         <Parameter Name="value" Type="System.ComponentModel.EventDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -319,6 +330,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the given <see cref="T:System.ComponentModel.EventDescriptor" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the given <see cref="T:System.ComponentModel.EventDescriptor" /> within the collection.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.EventDescriptor" /> to find within the collection. </param>
       </Docs>
@@ -533,7 +548,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'EventDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -544,6 +558,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sorts the members of this <see cref="T:System.ComponentModel.EventDescriptorCollection" />, using the default sort for this collection, which is usually alphabetical.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.ComponentModel.EventDescriptorCollection" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Sort">
@@ -562,7 +580,6 @@
         <Parameter Name="comparer" Type="System.Collections.IComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'EventDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The specified <see cref="T:System.Collections.IComparer" /> is applied first, followed by the default sort for this collection, which is usually alphabetical.</para>
@@ -574,6 +591,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sorts the members of this <see cref="T:System.ComponentModel.EventDescriptorCollection" />, using the specified <see cref="T:System.Collections.IComparer" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.ComponentModel.EventDescriptorCollection" />.</para>
+        </returns>
         <param name="comparer">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.IComparer" /> to use to sort the <see cref="T:System.ComponentModel.EventDescriptor" /> objects in this collection. </param>
       </Docs>
@@ -595,7 +616,6 @@
       </Parameters>
       <Docs>
         <param name="order">To be added: an object of type 'string []'</param>
-        <returns>To be added: an object of type 'EventDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The specified order is applied first, followed by the default sort for this collection, which is usually alphabetical.</para>
@@ -607,6 +627,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sorts the members of this <see cref="T:System.ComponentModel.EventDescriptorCollection" />, given a specified sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.ComponentModel.EventDescriptorCollection" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Sort">
@@ -627,7 +651,6 @@
       </Parameters>
       <Docs>
         <param name="order">To be added.</param>
-        <returns>To be added: an object of type 'EventDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The specified sort order is applied first, followed by the sort using the specified <see cref="T:System.Collections.IComparer" />.</para>
@@ -639,6 +662,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sorts the members of this <see cref="T:System.ComponentModel.EventDescriptorCollection" />, given a specified sort order and an <see cref="T:System.Collections.IComparer" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new <see cref="T:System.ComponentModel.EventDescriptorCollection" />.</para>
+        </returns>
         <param name="comparer">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.IComparer" /> to use to sort the <see cref="T:System.ComponentModel.EventDescriptor" /> objects in this collection. </param>
       </Docs>
@@ -768,7 +795,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -779,6 +805,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through a collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Add">
@@ -797,7 +827,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -808,6 +837,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an item to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position into which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to add to the collection.</param>
       </Docs>
@@ -854,7 +887,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -865,6 +897,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the collection contains a specific value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Object" /> is found in the collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the collection.</param>
       </Docs>
@@ -885,7 +921,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -896,6 +931,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of a specific item in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of <paramref name="value" /> if found in the list; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the collection.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/ExpandableObjectConverter.xml b/mcs/class/System/Documentation/en/System.ComponentModel/ExpandableObjectConverter.xml
index 4ac07e7bc39..7b5afeefcde 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/ExpandableObjectConverter.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/ExpandableObjectConverter.xml
@@ -67,7 +67,6 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -91,6 +90,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of properties for the type of object specified by the value parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> with the properties that are exposed for the component, or null if there are no properties.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="value">
@@ -115,7 +118,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -124,6 +126,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this object supports properties using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true because <see cref="M:System.ComponentModel.TypeConverter.GetProperties(System.Object)" /> should be called to find the properties of this object. This method never returns false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/ExtenderProvidedPropertyAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/ExtenderProvidedPropertyAttribute.xml
index 34970839c4c..c84aa2833bd 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/ExtenderProvidedPropertyAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/ExtenderProvidedPropertyAttribute.xml
@@ -70,12 +70,15 @@
       </Parameters>
       <Docs>
         <param name="obj">To be added: an object of type 'object'</param>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Object" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Object" />; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ExtenderProperty">
@@ -113,12 +116,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsDefaultAttribute">
@@ -135,12 +141,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides an indication whether the value of this instance is the default value for the derived class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this instance is the default attribute for the class; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Provider">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/GuidConverter.xml b/mcs/class/System/Documentation/en/System.ComponentModel/GuidConverter.xml
index 73f169cd00d..206df4ce42f 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/GuidConverter.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/GuidConverter.xml
@@ -66,7 +66,6 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This converter can only convert a GUID object to and from a string.</para>
@@ -76,6 +75,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this converter can convert an object in the given source type to a GUID object using the context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="sourceType">
@@ -99,7 +102,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -108,6 +110,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this converter can convert an object to the given destination type using the context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="destinationType">
@@ -132,7 +138,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This converter can only convert a GUID object to and from a string.</para>
@@ -142,6 +147,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given object to a GUID object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted <paramref name="value" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
@@ -169,7 +178,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The most common types to convert are to and from a string object. The default implementation will make a call to <see cref="M:System.Object.ToString" /> on the object if the object is valid and if the destination type is string.</para>
@@ -179,6 +187,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given object to another type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted object.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A formatter context. </param>
         <param name="culture">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/IBindingList.xml b/mcs/class/System/Documentation/en/System.ComponentModel/IBindingList.xml
index 10293c63448..31ea8fcefda 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/IBindingList.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/IBindingList.xml
@@ -72,7 +72,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is supported only if <see cref="P:System.ComponentModel.IBindingList.AllowNew" /> is true; otherwise, a <see cref="T:System.NotSupportedException" /> is thrown.</para>
@@ -86,6 +85,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new item to the list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The item added to the list.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="AllowEdit">
@@ -209,7 +212,6 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method will select the first row where the value of the <paramref name="property" /> parameter equals the value of the <paramref name="key" /> parameter.</para>
@@ -219,6 +221,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the row that has the given <see cref="T:System.ComponentModel.PropertyDescriptor" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the row that has the given <see cref="T:System.ComponentModel.PropertyDescriptor" />.</para>
+        </returns>
         <param name="property">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.PropertyDescriptor" /> to search on. </param>
         <param name="key">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/IComNativeDescriptorHandler.xml b/mcs/class/System/Documentation/en/System.ComponentModel/IComNativeDescriptorHandler.xml
index 25a3139178c..ec400772f6c 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/IComNativeDescriptorHandler.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/IComNativeDescriptorHandler.xml
@@ -46,7 +46,6 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'AttributeCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -57,6 +56,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the attributes for the specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of attributes for <paramref name="component" />.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to get attributes for.</param>
       </Docs>
@@ -77,7 +80,6 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -88,6 +90,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the class name for the specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the class that corresponds with <paramref name="component" />.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to get the class name for.</param>
       </Docs>
@@ -108,7 +114,6 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TypeConverter'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -119,6 +124,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the type converter for the specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ComponentModel.TypeConverter" /> for <paramref name="component" />.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to get the <see cref="T:System.ComponentModel.TypeConverter" /> for.</param>
       </Docs>
@@ -139,7 +148,6 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'EventDescriptor'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -150,6 +158,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the default event for the specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptor" /> that represents <paramref name="component" />'s default event.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to get the default event for.</param>
       </Docs>
@@ -170,7 +182,6 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptor'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -181,6 +192,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the default property for the specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptor" /> that represents <paramref name="component" />'s default property.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to get the default property for.</param>
       </Docs>
@@ -202,7 +217,6 @@
         <Parameter Name="baseEditorType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -213,6 +227,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the editor for the specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The editor for <paramref name="component" />. </para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to get the editor for.</param>
         <param name="baseEditorType">
@@ -235,7 +253,6 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'EventDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -246,6 +263,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the events for the specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of event descriptors for <paramref name="component" />. </para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to get events for.</param>
       </Docs>
@@ -267,7 +288,6 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'EventDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -278,6 +298,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the events with the specified attributes for the specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of event descriptors for <paramref name="component" />. </para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to get events for.</param>
         <param name="attributes">
@@ -300,7 +324,6 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -311,6 +334,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the name of the specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of <paramref name="component" />.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to get the name of.</param>
       </Docs>
@@ -332,7 +359,6 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -343,6 +369,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the properties with the specified attributes for the specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of property descriptors for <paramref name="component" />.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to get events for.</param>
         <param name="attributes">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/ICustomTypeDescriptor.xml b/mcs/class/System/Documentation/en/System.ComponentModel/ICustomTypeDescriptor.xml
index eefefa583b3..889eacb9c6f 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/ICustomTypeDescriptor.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/ICustomTypeDescriptor.xml
@@ -42,7 +42,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'AttributeCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is never null.</para>
@@ -52,6 +51,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of custom attributes for this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.AttributeCollection" /> containing the attributes for this object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetClassName">
@@ -68,7 +71,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If null is returned, use the type name from the <see cref="M:System.ComponentModel.ICustomTypeDescriptor.GetComponentName" /> method.</para>
@@ -77,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the class name of this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The class name of the object, or null if the class does not have a name.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetComponentName">
@@ -93,7 +99,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If null is returned, use the default name.</para>
@@ -102,6 +107,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the object, or null if the object does not have a name.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetConverter">
@@ -118,7 +127,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'TypeConverter'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If null is returned, use the default <see cref="T:System.ComponentModel.TypeConverter" />.</para>
@@ -127,6 +135,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a type converter for this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter" /> that is the converter for this object, or null if there is no <see cref="T:System.ComponentModel.TypeConverter" /> for this object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetDefaultEvent">
@@ -143,12 +155,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'EventDescriptor'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the default event for this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptor" /> that represents the default event for this object, or null if this object does not have events.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetDefaultProperty">
@@ -165,12 +180,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptor'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the default property for this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptor" /> that represents the default property for this object, or null if this object does not have properties.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetEditor">
@@ -189,7 +207,6 @@
         <Parameter Name="editorBaseType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The type of the <paramref name="editorBaseType" /> parameter is usually <see cref="T:System.Drawing.Design.UITypeEditor" />, but you can also use other types (for example, <see cref="T:System.ComponentModel.ComponentEditor" /> and <see cref="T:System.ComponentModel.InstanceCreationEditor" />).</para>
@@ -198,6 +215,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an editor of the specified type for this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> of the specified type that is the editor for this object, or null if the editor cannot be found.</para>
+        </returns>
         <param name="editorBaseType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents the editor for this object. </param>
       </Docs>
@@ -216,7 +237,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'EventDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The events for this instance can differ from the set of events that the class provides. For example, if the component is site-based, the site can add or remove additional events.</para>
@@ -226,6 +246,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the events for this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptorCollection" /> that represents the events for this component instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetEvents">
@@ -245,7 +269,6 @@
       </Parameters>
       <Docs>
         <param name="arr">To be added: an object of type 'Attribute []'</param>
-        <returns>To be added: an object of type 'EventDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The events for this instance can differ from the set of events that the class provides. For example, if the component is site-based, the site can add or remove additional events.</para>
@@ -255,6 +278,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the events for this instance of a component using the specified attribute array as a filter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptorCollection" /> that represents the filtered events for this component instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetProperties">
@@ -271,7 +298,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The properties for this instance can differ from the set of properties that the class provides. For example, if the component is sited, the site can add or remove additional properties.</para>
@@ -281,6 +307,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the properties for this instance of a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that represents the properties for this component instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetProperties">
@@ -300,7 +330,6 @@
       </Parameters>
       <Docs>
         <param name="arr">To be added: an object of type 'Attribute []'</param>
-        <returns>To be added: an object of type 'PropertyDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The properties for this instance can differ from the set of properties that the class provides. For example, if the component is sited, the site can add or remove additional properties.</para>
@@ -311,6 +340,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the properties for this instance of a component using the attribute array as a filter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that represents the filtered properties for this component instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetPropertyOwner">
@@ -329,7 +362,6 @@
         <Parameter Name="pd" Type="System.ComponentModel.PropertyDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.ICustomTypeDescriptor.GetPropertyOwner(System.ComponentModel.PropertyDescriptor)" /> method retrieves the object that contains the property member that is described by <see cref="T:System.ComponentModel.PropertyDescriptor" /> parameter. Typically, this object is required for the <see cref="M:System.ComponentModel.PropertyDescriptor.GetValue(System.Object)" /> and <see cref="M:System.ComponentModel.PropertyDescriptor.SetValue(System.Object,System.Object)" /> methods.</para>
@@ -341,6 +373,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that contains the property described by the specified property descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the owner of the specified property.</para>
+        </returns>
         <param name="pd">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.PropertyDescriptor" /> that represents the property whose owner is to be found. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/IExtenderProvider.xml b/mcs/class/System/Documentation/en/System.ComponentModel/IExtenderProvider.xml
index e25a5a2d62b..5b9b782db04 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/IExtenderProvider.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/IExtenderProvider.xml
@@ -41,7 +41,6 @@
         <Parameter Name="extendee" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information on extender properties, see <format type="text/html"><a href="d824f40e-b20b-464c-ac22-97974d5ab4fe">How to: Implement an Extender Provider</a></format>.</para>
@@ -50,6 +49,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Specifies whether this object can provide its extender properties to the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this object can provide extender properties to the specified object; otherwise, false.</para>
+        </returns>
         <param name="extendee">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to receive the extender properties. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/IListSource.xml b/mcs/class/System/Documentation/en/System.ComponentModel/IListSource.xml
index d7c1bb59712..d3cbb8bf2ae 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/IListSource.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/IListSource.xml
@@ -86,12 +86,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IList'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IList" /> that can be bound to a data source from an object that does not implement an <see cref="T:System.Collections.IList" /> itself.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IList" /> that can be bound to a data source from the object.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/INotifyDataErrorInfo.xml b/mcs/class/System/Documentation/en/System.ComponentModel/INotifyDataErrorInfo.xml
index 58318ad6786..6de107d4593 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/INotifyDataErrorInfo.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/INotifyDataErrorInfo.xml
@@ -53,7 +53,6 @@
         <Parameter Name="propertyName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>A System.Collections.IEnumerable of the errors for the provided property or entire object.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns an <see cref="T:System.Collections.IEnumerable" /> that can change as asynchronous validation rules finish processing. This enables the binding engine to automatically update the user interface validation feedback when errors are added, removed, or modified. </para>
@@ -63,6 +62,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the validation errors for a specified property or for the entire entity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The validation errors for the property or entity.</para>
+        </returns>
         <param name="propertyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the property to retrieve validation errors for; or null or <see cref="F:System.String.Empty" />, to retrieve entity-level errors.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/ISynchronizeInvoke.xml b/mcs/class/System/Documentation/en/System.ComponentModel/ISynchronizeInvoke.xml
index d571222fb44..a2929b21a90 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/ISynchronizeInvoke.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/ISynchronizeInvoke.xml
@@ -52,7 +52,6 @@
         <Parameter Name="args" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IAsyncResult'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="method" /> delegate is executed on the thread that created the object, instead of the thread on which <see cref="M:System.ComponentModel.ISynchronizeInvoke.BeginInvoke(System.Delegate,System.Object[])" /> was called.</para>
@@ -63,6 +62,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously executes the delegate on the thread that created this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> interface that represents the asynchronous operation started by calling this method.</para>
+        </returns>
         <param name="method">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Delegate" /> to a method that takes parameters of the same number and type that are contained in <paramref name="args" />. </param>
         <param name="args">
@@ -85,7 +88,6 @@
         <Parameter Name="result" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method gets the return value of the asynchronous operation represented by the <see cref="T:System.IAsyncResult" /> passed by this interface. If the asynchronous operation has not completed, this method will wait until the result is available.</para>
@@ -94,6 +96,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits until the process started by calling <see cref="M:System.ComponentModel.ISynchronizeInvoke.BeginInvoke(System.Delegate,System.Object[])" /> completes, and then returns the value generated by the process.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the return value generated by the asynchronous operation.</para>
+        </returns>
         <param name="result">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IAsyncResult" /> interface that represents the asynchronous operation started by calling <see cref="M:System.ComponentModel.ISynchronizeInvoke.BeginInvoke(System.Delegate,System.Object[])" />. </param>
       </Docs>
@@ -115,7 +121,6 @@
         <Parameter Name="args" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Unlike <see cref="M:System.ComponentModel.ISynchronizeInvoke.BeginInvoke(System.Delegate,System.Object[])" />, this method operates synchronously, that is, it waits until the process completes before returning. Exceptions raised during the call are propagated back to the caller.</para>
@@ -125,6 +130,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Synchronously executes the delegate on the thread that created this object and marshals the call to the creating thread.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the return value from the delegate being invoked, or null if the delegate has no return value.</para>
+        </returns>
         <param name="method">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Delegate" /> that contains a method to call, in the context of the thread for the control. </param>
         <param name="args">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/ITypeDescriptorContext.xml b/mcs/class/System/Documentation/en/System.ComponentModel/ITypeDescriptorContext.xml
index fd40181b40e..bd1df692ead 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/ITypeDescriptorContext.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/ITypeDescriptorContext.xml
@@ -123,7 +123,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.ComponentModel.ITypeDescriptorContext.OnComponentChanging" /> method to send notification that an instance of an object is about to be changed. This method also returns a value indicating whether this object can be changed. When false is returned, do not change the object.</para>
@@ -134,6 +133,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Raises the <see cref="E:System.ComponentModel.Design.IComponentChangeService.ComponentChanging" /> event.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this object can be changed; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="PropertyDescriptor">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/ITypedList.xml b/mcs/class/System/Documentation/en/System.ComponentModel/ITypedList.xml
index 5c5cd943e9e..a2edc17d628 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/ITypedList.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/ITypedList.xml
@@ -55,7 +55,6 @@
         <Parameter Name="listAccessors" Type="System.ComponentModel.PropertyDescriptor[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <paramref name="listAccessors" /> parameter is not null, it typically contains a property descriptor that identifies a list of containers to retrieve for the object that implements <see cref="T:System.ComponentModel.ITypedList" />. For example, a <see cref="T:System.Data.DataSet" /> containing two tables, myCustomers and myOrders, with a relationship between them called myCustOrders. If you create a <see cref="T:System.Data.DataView" /> object to view myCustomers, then calling the <see cref="M:System.ComponentModel.ITypedList.GetItemProperties(System.ComponentModel.PropertyDescriptor[])" /> method with null returns the property descriptors for the columns in myCustomers. As a result, one of the returned property descriptors is a property descriptor for myCustOrders, just as calling the <see cref="M:System.ComponentModel.ITypedList.GetItemProperties(System.ComponentModel.PropertyDescriptor[])" /> method with a list accessor array containing the property descriptors for myCustOrders will return the property descriptors for myOrders.</para>
@@ -64,6 +63,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that represents the properties on each item used to bind data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that represents the properties on each item used to bind data.</para>
+        </returns>
         <param name="listAccessors">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.ComponentModel.PropertyDescriptor" /> objects to find in the collection as bindable. This can be null. </param>
       </Docs>
@@ -84,7 +87,6 @@
         <Parameter Name="listAccessors" Type="System.ComponentModel.PropertyDescriptor[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is used only in the design-time framework and by the obsolete <see cref="T:System.Windows.Forms.DataGrid" /> control.</para>
@@ -93,6 +95,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the list.</para>
+        </returns>
         <param name="listAccessors">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.ComponentModel.PropertyDescriptor" /> objects, for which the list name is returned. This can be null. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/ImmutableObjectAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/ImmutableObjectAttribute.xml
index b8481146663..096413502c5 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/ImmutableObjectAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/ImmutableObjectAttribute.xml
@@ -118,12 +118,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.ComponentModel.ImmutableObjectAttribute" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Immutable">
@@ -164,12 +167,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the value of this instance is the default value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this instance is the default attribute for the class; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="No">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/InheritanceAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/InheritanceAttribute.xml
index c854ce06e87..f149b4309b5 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/InheritanceAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/InheritanceAttribute.xml
@@ -116,12 +116,15 @@
       </Parameters>
       <Docs>
         <param name="obj">To be added: an object of type 'object'</param>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Override to test for equality.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object is the same; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -138,12 +141,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hashcode for this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.ComponentModel.InheritanceAttribute" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InheritanceLevel">
@@ -229,12 +235,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the current value of the attribute is the default value for the attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current value of the attribute is the default; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="NotInherited">
@@ -275,12 +284,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts this attribute to a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents this <see cref="T:System.ComponentModel.InheritanceAttribute" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/InstallerTypeAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/InstallerTypeAttribute.xml
index 09bc9dd33ee..6de96839f48 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/InstallerTypeAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/InstallerTypeAttribute.xml
@@ -94,12 +94,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the value of the given object is equal to the current <see cref="T:System.ComponentModel.InstallerTypeAttribute" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of the given object is equal to that of the current; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test the value equality of. </param>
       </Docs>
@@ -118,12 +121,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hashcode for this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.ComponentModel.InstallerTypeAttribute" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InstallerType">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/InstanceCreationEditor.xml b/mcs/class/System/Documentation/en/System.ComponentModel/InstanceCreationEditor.xml
index 4d15dc7d370..6d40f369c11 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/InstanceCreationEditor.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/InstanceCreationEditor.xml
@@ -56,12 +56,15 @@
       </Parameters>
       <Docs>
         <param name="type">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns an instance of the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the specified type or null.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The context information.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/LicFileLicenseProvider.xml b/mcs/class/System/Documentation/en/System.ComponentModel/LicFileLicenseProvider.xml
index 973f32536c7..691373b5979 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/LicFileLicenseProvider.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/LicFileLicenseProvider.xml
@@ -63,12 +63,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a key for the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A confirmation that the <paramref name="type" /> parameter is licensed.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The object type to return the key. </param>
       </Docs>
@@ -92,7 +95,6 @@
         <Parameter Name="allowExceptions" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'License'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>At design time, the <see cref="M:System.ComponentModel.LicFileLicenseProvider.GetLicense(System.ComponentModel.LicenseContext,System.Type,System.Object,System.Boolean)" /> method looks for a license file named myClassName.LIC, where myClassName is the <see cref="P:System.Type.FullName" /> of the component to create. This file must be in the same directory as the .dll file that contains the component.</para>
@@ -102,6 +104,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a license for the instance of the component, if one is available.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A valid <see cref="T:System.ComponentModel.License" />. If this method cannot find a valid <see cref="T:System.ComponentModel.License" /> or a valid <paramref name="context" /> parameter, it returns null.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.LicenseContext" /> that specifies where you can use the licensed object. </param>
         <param name="type">
@@ -129,7 +135,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method checks the key against the phrase: " myClassName is a licensed component. ", where myClassName is the <see cref="P:System.Type.FullName" /> of the component you want to create.</para>
@@ -138,6 +143,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the key that the <see cref="M:System.ComponentModel.LicFileLicenseProvider.GetLicense(System.ComponentModel.LicenseContext,System.Type,System.Object,System.Boolean)" /> method retrieves is valid for the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key is a valid <see cref="P:System.ComponentModel.License.LicenseKey" /> for the specified type; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.ComponentModel.License.LicenseKey" /> to check. </param>
         <param name="type">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/LicenseContext.xml b/mcs/class/System/Documentation/en/System.ComponentModel/LicenseContext.xml
index dce63529d8a..cb59046a3ba 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/LicenseContext.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/LicenseContext.xml
@@ -66,12 +66,15 @@
         <Parameter Name="resourceAssembly" Type="System.Reflection.Assembly" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns a saved license key for the specified type, from the specified resource assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="P:System.ComponentModel.License.LicenseKey" /> for the specified type. This method returns null unless you override it.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents the type of component. </param>
         <param name="resourceAssembly">
@@ -94,12 +97,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the requested service, if it is available.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the service, or null if the service cannot be found.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of service to retrieve. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/LicenseManager.xml b/mcs/class/System/Documentation/en/System.ComponentModel/LicenseManager.xml
index 24d1a7b930b..6a48ce6e06a 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/LicenseManager.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/LicenseManager.xml
@@ -56,7 +56,6 @@
         <Parameter Name="creationContext" Type="System.ComponentModel.LicenseContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.ComponentModel.LicenseContext" /> you specify as the <paramref name="creationContext" /> parameter is used as the <see cref="P:System.ComponentModel.LicenseManager.CurrentContext" /> for the life of this <see cref="T:System.ComponentModel.License" />. The <see cref="M:System.ComponentModel.LicenseManager.CreateWithContext(System.Type,System.ComponentModel.LicenseContext)" /> method blocks all other threads in the <see cref="T:System.AppDomain" /> from modifying the <see cref="P:System.ComponentModel.LicenseManager.CurrentContext" />, allowing <see cref="M:System.ComponentModel.LicenseManager.CreateWithContext(System.Type,System.ComponentModel.LicenseContext)" /> to behave as an atomic operation.</para>
@@ -65,6 +64,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the specified type, given a context in which you can use the licensed instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the specified type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents the type to create. </param>
         <param name="creationContext">
@@ -89,7 +92,6 @@
         <Parameter Name="args" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.ComponentModel.LicenseContext" /> you specify as the <paramref name="creationContext" /> parameter is used as the <see cref="P:System.ComponentModel.LicenseManager.CurrentContext" /> for the life of this <see cref="T:System.ComponentModel.License" />. This method blocks all other threads in the <see cref="T:System.AppDomain" /> from modifying the <see cref="P:System.ComponentModel.LicenseManager.CurrentContext" />, allowing <see cref="M:System.ComponentModel.LicenseManager.CreateWithContext(System.Type,System.ComponentModel.LicenseContext)" /> to behave as an atomic operation.</para>
@@ -98,6 +100,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the specified type with the specified arguments, given a context in which you can use the licensed instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the specified type with the given array of arguments.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents the type to create. </param>
         <param name="creationContext">
@@ -148,12 +154,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the given type has a valid license.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the given type is licensed; otherwise, false.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> to find a valid license for. </param>
       </Docs>
@@ -174,7 +183,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.LicenseManager.IsValid(System.Type)" /> method returns true when the type is either not licensed, or is licensed and the license is valid.</para>
@@ -184,6 +192,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a valid license can be granted for the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a valid license can be granted; otherwise, false.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents the type of object that requests the <see cref="T:System.ComponentModel.License" />. </param>
       </Docs>
@@ -339,7 +351,6 @@
         <Parameter Name="instance" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'License'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method throws a <see cref="T:System.ComponentModel.LicenseException" /> when a valid <see cref="T:System.ComponentModel.License" /> cannot be granted. The <see cref="M:System.ComponentModel.LicenseManager.IsValid(System.Type)" /> method does not throw an exception.</para>
@@ -349,6 +360,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a license can be granted for the instance of the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A valid <see cref="T:System.ComponentModel.License" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents the type of object that requests the license. </param>
         <param name="instance">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/LicenseProvider.xml b/mcs/class/System/Documentation/en/System.ComponentModel/LicenseProvider.xml
index ecf19aa9612..9a60af5d349 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/LicenseProvider.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/LicenseProvider.xml
@@ -61,12 +61,15 @@
         <Parameter Name="allowExceptions" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'License'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, gets a license for an instance or type of component, when given a context and whether the denial of a license throws an exception.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A valid <see cref="T:System.ComponentModel.License" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.LicenseContext" /> that specifies where you can use the licensed object. </param>
         <param name="type">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/LicenseProviderAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/LicenseProviderAttribute.xml
index c929151b6dc..e71dd45c5d6 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/LicenseProviderAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/LicenseProviderAttribute.xml
@@ -139,12 +139,15 @@
       </Parameters>
       <Docs>
         <param name="obj">To be added: an object of type 'object'</param>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether this instance and a specified object are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is equal to this instance; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -161,12 +164,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.ComponentModel.LicenseProviderAttribute" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="LicenseProvider">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/ListBindableAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/ListBindableAttribute.xml
index c1aa4531f64..3cc1f9ab6c0 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/ListBindableAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/ListBindableAttribute.xml
@@ -117,12 +117,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the object passed is equal to this <see cref="T:System.ComponentModel.ListBindableAttribute" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object passed is equal to this <see cref="T:System.ComponentModel.ListBindableAttribute" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test equality with. </param>
       </Docs>
@@ -141,12 +144,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.ComponentModel.ListBindableAttribute" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsDefaultAttribute">
@@ -163,12 +169,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether <see cref="P:System.ComponentModel.ListBindableAttribute.ListBindable" /> is set to the default value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <see cref="P:System.ComponentModel.ListBindableAttribute.ListBindable" /> is set to the default value; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ListBindable">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/ListSortDescriptionCollection.xml b/mcs/class/System/Documentation/en/System.ComponentModel/ListSortDescriptionCollection.xml
index 10983b78bdf..5243f339ae9 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/ListSortDescriptionCollection.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/ListSortDescriptionCollection.xml
@@ -91,13 +91,16 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the <see cref="T:System.ComponentModel.ListSortDescriptionCollection" /> contains a specific value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Object" /> is found in the collection; otherwise, false. </para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the collection.</param>
       </Docs>
@@ -166,13 +169,16 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the specified item in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of <paramref name="value" /> if found in the list; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the collection.</param>
       </Docs>
@@ -259,12 +265,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Add">
@@ -282,7 +291,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Because the <see cref="T:System.ComponentModel.ListSortDescriptionCollection" /> class implements the <see cref="T:System.Collections.IList" /> interface, it must have an <see cref="M:System.ComponentModel.ListSortDescriptionCollection.System#Collections#IList#Add(System.Object)" /> method. However, because the <see cref="T:System.ComponentModel.ListSortDescriptionCollection" /> class represents a read-only collection, adding items to the collection is an invalid operation.</para>
@@ -291,6 +299,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an item to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position into which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The item to add to the collection.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/LocalizableAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/LocalizableAttribute.xml
index 88efe1bc882..fc4c88ea8a9 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/LocalizableAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/LocalizableAttribute.xml
@@ -98,12 +98,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the value of the given object is equal to the current <see cref="T:System.ComponentModel.LocalizableAttribute" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of the given object is equal to that of the current; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test the value equality of. </param>
       </Docs>
@@ -122,12 +125,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.ComponentModel.LocalizableAttribute" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsDefaultAttribute">
@@ -144,12 +150,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if this attribute is the default.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute is the default value for this attribute class; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsLocalizable">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/LookupBindingPropertiesAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/LookupBindingPropertiesAttribute.xml
index d2b6c0711a9..0da5b6e06fa 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/LookupBindingPropertiesAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/LookupBindingPropertiesAttribute.xml
@@ -164,7 +164,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.LookupBindingPropertiesAttribute.Equals(System.Object)" /> method returns true if the <paramref name="obj" /> parameter is of type <see cref="T:System.ComponentModel.LookupBindingPropertiesAttribute" /> and all the public properties—<see cref="P:System.ComponentModel.LookupBindingPropertiesAttribute.DataSource" />, <see cref="P:System.ComponentModel.LookupBindingPropertiesAttribute.DisplayMember" />, <see cref="P:System.ComponentModel.LookupBindingPropertiesAttribute.ValueMember" />, and <see cref="P:System.ComponentModel.LookupBindingPropertiesAttribute.LookupMember" />—are equal to each other.</para>
@@ -173,6 +172,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.ComponentModel.LookupBindingPropertiesAttribute" /> instance. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object is equal to the current instance; otherwise, false, indicating they are not equal.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to compare with the current <see cref="T:System.ComponentModel.LookupBindingPropertiesAttribute" /> instance </param>
       </Docs>
@@ -190,12 +193,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.ComponentModel.LookupBindingPropertiesAttribute" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="LookupMember">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/MarshalByValueComponent.xml b/mcs/class/System/Documentation/en/System.ComponentModel/MarshalByValueComponent.xml
index cfe7b396b42..eabab6d4d6e 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/MarshalByValueComponent.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/MarshalByValueComponent.xml
@@ -270,7 +270,6 @@
         <Parameter Name="service" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information on designer services you can use, see <format type="text/html"><a href="4881917b-628f-4689-b872-472e4f8a4e3a">Design-Time Architecture</a></format>.</para>
@@ -279,6 +278,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the implementer of the <see cref="T:System.IServiceProvider" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the implementer of the <see cref="T:System.IServiceProvider" />.</para>
+        </returns>
         <param name="service">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents the type of service you want. </param>
       </Docs>
@@ -332,7 +335,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A <see cref="T:System.ComponentModel.Component" /> may or may not have a name. If a <see cref="T:System.ComponentModel.Component" /> is given a name, the name is unique among other <see cref="T:System.ComponentModel.Component" /> objects within its <see cref="T:System.ComponentModel.IContainer" />.</para>
@@ -342,6 +344,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.String" /> containing the name of the <see cref="T:System.ComponentModel.Component" />, if any. This method should not be overridden.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the name of the <see cref="T:System.ComponentModel.Component" />, if any.</para>
+          <para>null if the <see cref="T:System.ComponentModel.Component" /> is unnamed.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/MaskedTextProvider.xml b/mcs/class/System/Documentation/en/System.ComponentModel/MaskedTextProvider.xml
index 20ebdb37850..b447ca07b06 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/MaskedTextProvider.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/MaskedTextProvider.xml
@@ -300,7 +300,6 @@
         <Parameter Name="input" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.MaskedTextProvider.Add(System.Char)" /> method adds the <paramref name="input" /> character value to the first available position in the formatted string after the position that was last assigned, which is represented by the <see cref="P:System.ComponentModel.MaskedTextProvider.LastAssignedPosition" /> property. This method will fail for any of the following reasons:</para>
@@ -317,6 +316,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified input character to the end of the formatted string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the input character was added successfully; otherwise false.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Char" /> value to be appended to the formatted string. </param>
       </Docs>
@@ -336,7 +339,6 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.MaskedTextProvider.Add(System.String)" /> method adds the characters from the <paramref name="input" /> string to the formatted string, starting with the first available position after <see cref="P:System.ComponentModel.MaskedTextProvider.LastAssignedPosition" />. This method will fail for any of the following reasons:</para>
@@ -354,6 +356,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the characters in the specified input string to the end of the formatted string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if all the characters from the input string were added successfully; otherwise false to indicate that no characters were added.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> containing character values to be appended to the formatted string. </param>
       </Docs>
@@ -558,7 +564,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.MaskedTextProvider.Clone" /> method returns a new copy of the current <see cref="T:System.ComponentModel.MaskedTextProvider" />.</para>
@@ -567,6 +572,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the current <see cref="T:System.ComponentModel.MaskedTextProvider" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.ComponentModel.MaskedTextProvider" /> object this method creates, cast as an object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Culture">
@@ -678,7 +687,6 @@
         <Parameter Name="direction" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The formatted string is composed of editable characters and literals copied from the mask. The editable character positions will either be occupied by the prompt character copied from the mask if they are unassigned, or with a valid input character if they have been assigned an input.</para>
@@ -689,6 +697,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the position of the first assigned editable position after the specified position using the specified search direction.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If successful, an <see cref="T:System.Int32" /> representing the zero-based position of the first assigned editable position encountered; otherwise <see cref="P:System.ComponentModel.MaskedTextProvider.InvalidIndex" />.</para>
+        </returns>
         <param name="position">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based position in the formatted string to start the search.</param>
         <param name="direction">
@@ -712,7 +724,6 @@
         <Parameter Name="direction" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The formatted string is composed of editable characters and literals copied from the mask. The editable character positions will either be occupied by the prompt character copied from the mask if they are unassigned, or with a valid input character if they have been assigned an input.</para>
@@ -723,6 +734,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the position of the first assigned editable position between the specified positions using the specified search direction.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If successful, an <see cref="T:System.Int32" /> representing the zero-based position of the first assigned editable position encountered; otherwise <see cref="P:System.ComponentModel.MaskedTextProvider.InvalidIndex" />.</para>
+        </returns>
         <param name="startPosition">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based position in the formatted string where the search starts.</param>
         <param name="endPosition">
@@ -747,7 +762,6 @@
         <Parameter Name="direction" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.MaskedTextProvider.FindEditPositionFrom(System.Int32,System.Boolean)" /> method is used to search for the next assigned or unassigned editable position in the formatted string after the specified position.</para>
@@ -757,6 +771,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the position of the first editable position after the specified position using the specified search direction.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If successful, an <see cref="T:System.Int32" /> representing the zero-based position of the first editable position encountered; otherwise <see cref="P:System.ComponentModel.MaskedTextProvider.InvalidIndex" />.</para>
+        </returns>
         <param name="position">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based position in the formatted string to start the search.</param>
         <param name="direction">
@@ -780,7 +798,6 @@
         <Parameter Name="direction" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.MaskedTextProvider.FindEditPositionInRange(System.Int32,System.Int32,System.Boolean)" /> method is used to search for the first editable character between two specified positions, inclusive, using the specified search direction. The result can subsequently be passed as a parameter to the <see cref="P:System.ComponentModel.MaskedTextProvider.Item(System.Int32)" /> indexer to obtain the assigned value at this position.</para>
@@ -790,6 +807,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the position of the first editable position between the specified positions using the specified search direction.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If successful, an <see cref="T:System.Int32" /> representing the zero-based position of the first editable position encountered; otherwise <see cref="P:System.ComponentModel.MaskedTextProvider.InvalidIndex" />.</para>
+        </returns>
         <param name="startPosition">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based position in the formatted string where the search starts.</param>
         <param name="endPosition">
@@ -814,7 +835,6 @@
         <Parameter Name="direction" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.MaskedTextProvider.FindNonEditPositionFrom(System.Int32,System.Boolean)" /> method is used to search for the next literal character in the formatted string after the specified position. The result can subsequently be passed as a parameter to the <see cref="P:System.ComponentModel.MaskedTextProvider.Item(System.Int32)" /> indexer to obtain the literal value at this position.</para>
@@ -824,6 +844,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the position of the first non-editable position after the specified position using the specified search direction.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If successful, an <see cref="T:System.Int32" /> representing the zero-based position of the first literal position encountered; otherwise <see cref="P:System.ComponentModel.MaskedTextProvider.InvalidIndex" />.</para>
+        </returns>
         <param name="position">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based position in the formatted string to start the search.</param>
         <param name="direction">
@@ -847,7 +871,6 @@
         <Parameter Name="direction" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.MaskedTextProvider.FindNonEditPositionInRange(System.Int32,System.Int32,System.Boolean)" /> method is used to search for the first literal character between two specified positions, inclusive, using the specified search direction. The result can subsequently be passed as a parameter to the <see cref="P:System.ComponentModel.MaskedTextProvider.Item(System.Int32)" /> indexer to obtain the literal value at this position.</para>
@@ -857,6 +880,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the position of the first non-editable position between the specified positions using the specified search direction.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If successful, an <see cref="T:System.Int32" /> representing the zero-based position of the first literal position encountered; otherwise <see cref="P:System.ComponentModel.MaskedTextProvider.InvalidIndex" />.</para>
+        </returns>
         <param name="startPosition">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based position in the formatted string where the search starts.</param>
         <param name="endPosition">
@@ -881,7 +908,6 @@
         <Parameter Name="direction" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The formatted string is composed of editable characters and literals copied from the mask. The editable character positions will either be occupied by the prompt character copied from the mask if they are unassigned, or with a valid input character if they have been assigned an input.</para>
@@ -892,6 +918,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the position of the first unassigned editable position after the specified position using the specified search direction.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If successful, an <see cref="T:System.Int32" /> representing the zero-based position of the first unassigned editable position encountered; otherwise <see cref="P:System.ComponentModel.MaskedTextProvider.InvalidIndex" />.</para>
+        </returns>
         <param name="position">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based position in the formatted string to start the search.</param>
         <param name="direction">
@@ -915,7 +945,6 @@
         <Parameter Name="direction" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The formatted string is composed of editable characters and literals copied from the mask. The editable character positions will either be occupied by the prompt character copied from the mask if they are unassigned, or with a valid input character if they have been assigned an input.</para>
@@ -926,6 +955,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the position of the first unassigned editable position between the specified positions using the specified search direction.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If successful, an <see cref="T:System.Int32" /> representing the zero-based position of the first unassigned editable position encountered; otherwise <see cref="P:System.ComponentModel.MaskedTextProvider.InvalidIndex" />.</para>
+        </returns>
         <param name="startPosition">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based position in the formatted string where the search starts.</param>
         <param name="endPosition">
@@ -949,7 +982,6 @@
         <Parameter Name="hint" Type="System.ComponentModel.MaskedTextResultHint" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following methods of the <see cref="T:System.ComponentModel.MaskedTextProvider" /> class contain a parameter of type <see cref="T:System.ComponentModel.MaskedTextResultHint" /> that is used to output information about the operation of the method: <see cref="Overload:System.ComponentModel.MaskedTextProvider.Add" />, <see cref="Overload:System.ComponentModel.MaskedTextProvider.Clear" />, <see cref="Overload:System.ComponentModel.MaskedTextProvider.InsertAt" />, <see cref="Overload:System.ComponentModel.MaskedTextProvider.Remove" />, <see cref="Overload:System.ComponentModel.MaskedTextProvider.RemoveAt" />, <see cref="Overload:System.ComponentModel.MaskedTextProvider.Replace" />, <see cref="Overload:System.ComponentModel.MaskedTextProvider.Set" />, <see cref="M:System.ComponentModel.MaskedTextProvider.VerifyChar(System.Char,System.Int32,System.ComponentModel.MaskedTextResultHint@)" />, and <see cref="Overload:System.ComponentModel.MaskedTextProvider.VerifyString" />. The <see cref="M:System.ComponentModel.MaskedTextProvider.GetOperationResultFromHint(System.ComponentModel.MaskedTextResultHint)" /> method interprets this value and returns a Boolean value that indicates whether the <see cref="T:System.ComponentModel.MaskedTextResultHint" /> has signaled that the operation was a success or failure.</para>
@@ -958,6 +990,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.ComponentModel.MaskedTextResultHint" /> denotes success or failure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.ComponentModel.MaskedTextResultHint" /> value represents a success; otherwise, false if it represents failure.</para>
+        </returns>
         <param name="hint">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.MaskedTextResultHint" /> value typically obtained as an output parameter from a previous operation. </param>
       </Docs>
@@ -1024,7 +1060,6 @@
         <Parameter Name="position" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.MaskedTextProvider.InsertAt(System.Char,System.Int32)" /> method inserts a character into the first edit position at or beyond that specified by the <paramref name="pos" /> parameter. This method will shift all existing characters after the insertion point over by one position to make room for the inserted <paramref name="input" /> character. If one of the following errors occurs, the insertion is not performed, and the method returns false.</para>
@@ -1051,6 +1086,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts the specified character at the specified position within the formatted string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the insertion was successful; otherwise, false.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Char" /> to be inserted. </param>
         <param name="position">
@@ -1073,7 +1112,6 @@
         <Parameter Name="position" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.MaskedTextProvider.InsertAt(System.String,System.Int32)" /> method inserts each character from the <paramref name="input" /> string into the edit positions located at position <paramref name="pos" /> and beyond. This method will shift all existing characters after the insertion point over by one position for each inserted character. If one of the following errors occurs, no insertion is performed, and the method returns false.</para>
@@ -1100,6 +1138,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts the specified string at a specified position within the formatted string. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the insertion was successful; otherwise, false.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> to be inserted. </param>
         <param name="position">
@@ -1199,7 +1241,6 @@
         <Parameter Name="position" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.MaskedTextProvider.IsAvailablePosition(System.Int32)" /> method returns true only if all of the following conditions are true:</para>
@@ -1219,6 +1260,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified position is available for assignment.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified position in the formatted string is editable and has not been assigned to yet; otherwise false.</para>
+        </returns>
         <param name="position">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based position in the mask to test.</param>
       </Docs>
@@ -1238,7 +1283,6 @@
         <Parameter Name="position" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.MaskedTextProvider.IsEditPosition(System.Int32)" /> method returns true only if both of the following conditions are true:</para>
@@ -1255,6 +1299,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified position is editable. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified position in the formatted string is editable; otherwise false.</para>
+        </returns>
         <param name="position">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based position in the mask to test.</param>
       </Docs>
@@ -1307,7 +1355,6 @@
         <Parameter Name="c" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Valid input characters include all printable characters, which include letters, digits, punctuation, symbols and the space character.</para>
@@ -1316,6 +1363,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified character is a valid input character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified character contains a valid input value; otherwise false.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Char" /> value to test.</param>
       </Docs>
@@ -1335,7 +1386,6 @@
         <Parameter Name="c" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Valid mask characters include all printable characters, which include letters, digits, punctuation, symbols and the space character.</para>
@@ -1344,6 +1394,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified character is a valid mask character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified character contains a valid mask value; otherwise false.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Char" /> value to test.</param>
       </Docs>
@@ -1363,7 +1417,6 @@
         <Parameter Name="c" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Valid password characters include all printable characters and the null character, which is used to disable password functionality. Printable characters include letters, digits, punctuation, symbols and the space character.</para>
@@ -1372,6 +1425,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified character is a valid password character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified character contains a valid password value; otherwise false.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Char" /> value to test.</param>
       </Docs>
@@ -1574,7 +1631,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.ComponentModel.MaskedTextProvider.Remove" /> method has no effect if there are no characters assigned to the mask yet.</para>
@@ -1584,6 +1640,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the last assigned character from the formatted string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character was successfully removed; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Remove">
@@ -1624,7 +1684,6 @@
         <Parameter Name="position" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.ComponentModel.MaskedTextProvider.RemoveAt" /> method has no effect if there are no assigned characters at the removal position specified. Literal characters are not affected by this method.</para>
@@ -1636,6 +1695,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the assigned character at the specified position from the formatted string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character was successfully removed; otherwise, false.</para>
+        </returns>
         <param name="position">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based position of the assigned character to remove.</param>
       </Docs>
@@ -1656,7 +1719,6 @@
         <Parameter Name="endPosition" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.ComponentModel.MaskedTextProvider.RemoveAt" /> method has no effect if there are no assigned characters at the removal positions specified. </para>
@@ -1666,6 +1728,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the assigned characters between the specified positions from the formatted string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character was successfully removed; otherwise, false.</para>
+        </returns>
         <param name="startPosition">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the first assigned character to remove.</param>
         <param name="endPosition">
@@ -1715,7 +1781,6 @@
         <Parameter Name="position" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.MaskedTextProvider.Replace(System.Char,System.Int32)" /> method searches for the first editable position in the formatted string at or beyond the specified position, <paramref name="pos" />. If one is found, the value of the editable position is changed to the specified character, <paramref name="input" />. Any of the following conditions will result in an error that causes no replacement to be performed and a value of false to be returned:</para>
@@ -1735,6 +1800,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Replaces a single character at or beyond the specified position with the specified character value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character was successfully replaced; otherwise, false.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Char" /> value that replaces the existing value.</param>
         <param name="position">
@@ -1757,7 +1826,6 @@
         <Parameter Name="position" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.MaskedTextProvider.Replace(System.String,System.Int32)" /> method searches for the first editable position at or beyond the specified position, <paramref name="pos" />. Operating under the assumption that there are enough editable positions after this point, the existing character values are replaced one-by-one with the contents of the replacement string parameter, <paramref name="input" />. </para>
@@ -1778,6 +1846,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Replaces a range of editable characters starting at the specified position with the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if all the characters were successfully replaced; otherwise, false.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> value used to replace the existing editable characters.</param>
         <param name="position">
@@ -2026,7 +2098,6 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.ComponentModel.MaskedTextProvider.Set" /> method clears the existing contents of the formatted string and then applies the mask against the <paramref name="input" /> string to update the contents of the formatted string. </para>
@@ -2044,6 +2115,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the formatted string to the specified input string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if all the characters were successfully set; otherwise, false.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> value used to set the formatted string.</param>
       </Docs>
@@ -2117,7 +2192,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.MaskedTextProvider.ToDisplayString" /> method will always include prompt and literal characters in the return value, regardless of the value of the <see cref="P:System.ComponentModel.MaskedTextProvider.IncludePrompt" /> or <see cref="P:System.ComponentModel.MaskedTextProvider.IncludeLiterals" /> properties. This method will always display password characters if the <see cref="P:System.ComponentModel.MaskedTextProvider.PasswordChar" /> property is set to a character value other than null. </para>
@@ -2128,6 +2202,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the formatted string in a displayable form.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The formatted <see cref="T:System.String" /> that includes prompts and mask literals.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -2143,7 +2221,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This version of the overloaded <see cref="Overload:System.ComponentModel.MaskedTextProvider.ToString" /> method includes prompts and literals according to the current values of the <see cref="P:System.ComponentModel.MaskedTextProvider.IncludePrompt" /> and <see cref="P:System.ComponentModel.MaskedTextProvider.IncludeLiterals" /> properties, respectively. It will always return the original input characters, ignoring the value of the <see cref="P:System.ComponentModel.MaskedTextProvider.PasswordChar" /> property.</para>
@@ -2155,6 +2232,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the formatted string that includes all the assigned character values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The formatted <see cref="T:System.String" /> that includes all the assigned character values.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -2172,7 +2253,6 @@
         <Parameter Name="ignorePasswordChar" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This version of the overloaded <see cref="Overload:System.ComponentModel.MaskedTextProvider.ToString" /> method includes prompts and literals according to the current values of the <see cref="P:System.ComponentModel.MaskedTextProvider.IncludePrompt" /> and <see cref="P:System.ComponentModel.MaskedTextProvider.IncludeLiterals" /> properties, respectively. If the <paramref name="ignorePasswordChar" /> parameter is true, it will return the original input characters, ignoring the value of the <see cref="P:System.ComponentModel.MaskedTextProvider.PasswordChar" /> property. If this parameter is false, it will use the password character to obscure editable user input if the <see cref="P:System.ComponentModel.MaskedTextProvider.PasswordChar" /> property is set to a value other than null.</para>
@@ -2184,6 +2264,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the formatted string, optionally including password characters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The formatted <see cref="T:System.String" /> that includes literals, prompts, and optionally password characters.</para>
+        </returns>
         <param name="ignorePasswordChar">
           <attribution license="cc4" from="Microsoft" modified="false" />true to return the actual editable characters; otherwise, false to indicate that the <see cref="P:System.ComponentModel.MaskedTextProvider.PasswordChar" /> property is to be honored.</param>
       </Docs>
@@ -2204,7 +2288,6 @@
         <Parameter Name="includeLiterals" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This version of the overloaded <see cref="Overload:System.ComponentModel.MaskedTextProvider.ToString" /> method includes prompts and literals according to the values of the <paramref name="IncludePrompt" /> and <paramref name="IncludeLiterals" /> parameters, respectively. Notice that these parameters override the values of the <see cref="P:System.ComponentModel.MaskedTextProvider.IncludePrompt" /> <see cref="P:System.ComponentModel.MaskedTextProvider.IncludeLiterals" /> properties. This method will always return the original input characters, ignoring the value of the <see cref="P:System.ComponentModel.MaskedTextProvider.PasswordChar" /> property.</para>
@@ -2216,6 +2299,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the formatted string, optionally including prompt and literal characters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The formatted <see cref="T:System.String" /> that includes all the assigned character values and optionally includes literals and prompts.</para>
+        </returns>
         <param name="includePrompt">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include prompt characters in the return string; otherwise, false.</param>
         <param name="includeLiterals">
@@ -2238,7 +2325,6 @@
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This version of the overloaded <see cref="Overload:System.ComponentModel.MaskedTextProvider.ToString" /> method returns a substring of the formatted string, starting at the position <paramref name="startPos" /> and including the subsequent number of characters specified by the <paramref name="length" /> parameter. The returned string includes prompts and literals according to the current values of the <see cref="P:System.ComponentModel.MaskedTextProvider.IncludePrompt" /> and <see cref="P:System.ComponentModel.MaskedTextProvider.IncludeLiterals" /> properties, respectively. The return string will contain the original input characters; the <see cref="P:System.ComponentModel.MaskedTextProvider.PasswordChar" /> property is always ignored.</para>
@@ -2266,6 +2352,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a substring of the formatted string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If successful, a substring of the formatted <see cref="T:System.String" />, which includes all the assigned character values; otherwise the <see cref="F:System.String.Empty" /> string.</para>
+        </returns>
         <param name="startPosition">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based position in the formatted string where the output begins. </param>
         <param name="length">
@@ -2289,7 +2379,6 @@
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This version of the overloaded <see cref="Overload:System.ComponentModel.MaskedTextProvider.ToString" /> method returns a substring of the formatted string, starting at the position <paramref name="startPos" /> and including the subsequent number of characters specified by the <paramref name="length" /> parameter. The returned string includes prompts and literals according to the current values of the <see cref="P:System.ComponentModel.MaskedTextProvider.IncludePrompt" /> and <see cref="P:System.ComponentModel.MaskedTextProvider.IncludeLiterals" /> properties, respectively. If the <paramref name="ignorePasswordChar" /> parameter is true, it will return the original input characters, ignoring the value of the <see cref="P:System.ComponentModel.MaskedTextProvider.PasswordChar" /> property. If this parameter is false, it will use the password character to obscure editable user input if the <see cref="P:System.ComponentModel.MaskedTextProvider.PasswordChar" /> property is set to a value other than null.</para>
@@ -2317,6 +2406,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a substring of the formatted string, optionally including password characters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If successful, a substring of the formatted <see cref="T:System.String" />, which includes literals, prompts, and optionally password characters; otherwise the <see cref="F:System.String.Empty" /> string.</para>
+        </returns>
         <param name="ignorePasswordChar">
           <attribution license="cc4" from="Microsoft" modified="false" />true to return the actual editable characters; otherwise, false to indicate that the <see cref="P:System.ComponentModel.MaskedTextProvider.PasswordChar" /> property is to be honored.</param>
         <param name="startPosition">
@@ -2343,7 +2436,6 @@
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This version of the overloaded <see cref="Overload:System.ComponentModel.MaskedTextProvider.ToString" /> method returns a substring of the formatted string, starting at the position <paramref name="startPos" /> and including the subsequent number of characters specified by the <paramref name="length" /> parameter. The return string includes prompts and literals according to the values of the <paramref name="IncludePrompt" /> and <paramref name="IncludeLiterals" /> parameters, respectively. Notice that these parameters override the values of the <see cref="P:System.ComponentModel.MaskedTextProvider.IncludePrompt" /> <see cref="P:System.ComponentModel.MaskedTextProvider.IncludeLiterals" /> properties. This method will always return the original input characters, ignoring the value of the <see cref="P:System.ComponentModel.MaskedTextProvider.PasswordChar" /> property.</para>
@@ -2371,6 +2463,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a substring of the formatted string, optionally including prompt and literal characters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If successful, a substring of the formatted <see cref="T:System.String" />, which includes all the assigned character values and optionally includes literals and prompts; otherwise the <see cref="F:System.String.Empty" /> string.</para>
+        </returns>
         <param name="includePrompt">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include prompt characters in the return string; otherwise, false.</param>
         <param name="includeLiterals">
@@ -2400,7 +2496,6 @@
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This version of the overloaded <see cref="Overload:System.ComponentModel.MaskedTextProvider.ToString" /> method returns a substring of the formatted string, starting at the position <paramref name="startPos" /> and including the subsequent number of characters specified by the <paramref name="length" /> parameter. The return string includes prompts and literals according to the values of the <paramref name="IncludePrompt" /> and <paramref name="IncludeLiterals" /> parameters, respectively. Notice that these parameters override the values of the <see cref="P:System.ComponentModel.MaskedTextProvider.IncludePrompt" /> and  <see cref="P:System.ComponentModel.MaskedTextProvider.IncludeLiterals" /> properties. If the <paramref name="ignorePasswordChar" /> parameter is true, it will return the original input characters, ignoring the value of the <see cref="P:System.ComponentModel.MaskedTextProvider.PasswordChar" /> property. If this parameter is false, it will use the password character to obscure editable user input if the <see cref="P:System.ComponentModel.MaskedTextProvider.PasswordChar" /> property is set to a value other than null.</para>
@@ -2428,6 +2523,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a substring of the formatted string, optionally including prompt, literal, and password characters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If successful, a substring of the formatted <see cref="T:System.String" />, which includes all the assigned character values and optionally includes literals, prompts, and password characters; otherwise the <see cref="F:System.String.Empty" /> string.</para>
+        </returns>
         <param name="ignorePasswordChar">
           <attribution license="cc4" from="Microsoft" modified="false" />true to return the actual editable characters; otherwise, false to indicate that the <see cref="P:System.ComponentModel.MaskedTextProvider.PasswordChar" /> property is to be honored.</param>
         <param name="includePrompt">
@@ -2481,7 +2580,6 @@
         <Parameter Name="position" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A character is said to be <newTerm>escaped</newTerm> if it is valid input, but is not assigned to that position in the formatted string. Escaped characters fall into the following three categories:</para>
@@ -2502,6 +2600,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether the specified character would be escaped at the specified position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified character would be escaped at the specified position; otherwise, false.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Char" /> value to test.</param>
         <param name="position">
@@ -2523,7 +2625,6 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.ComponentModel.MaskedTextProvider.VerifyString" /> applies the <paramref name="input" /> string against the mask, without actually changing the formatted string, to test whether <paramref name="input" /> would be valid in a corresponding <see cref="Overload:System.ComponentModel.MaskedTextProvider.Set" /> operation. This method also returns true if input is null or has zero length.</para>
@@ -2532,6 +2633,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether the specified string could be set successfully.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified string represents valid input; otherwise, false.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> value to test.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/MemberDescriptor.xml b/mcs/class/System/Documentation/en/System.ComponentModel/MemberDescriptor.xml
index b7ba9b16a4f..f64d495cd76 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/MemberDescriptor.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/MemberDescriptor.xml
@@ -220,7 +220,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'AttributeCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called from the <see cref="P:System.ComponentModel.MemberDescriptor.Attributes" /> property when there is no <see cref="T:System.ComponentModel.AttributeCollection" /> for this member. If there are no attributes in the <see cref="P:System.ComponentModel.MemberDescriptor.AttributeArray" />, this will return an empty <see cref="T:System.ComponentModel.AttributeCollection" />.</para>
@@ -229,6 +228,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a collection of attributes using the array of attributes passed to the constructor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ComponentModel.AttributeCollection" /> that contains the <see cref="P:System.ComponentModel.MemberDescriptor.AttributeArray" /> attributes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Description">
@@ -316,12 +319,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this instance to the given object to see if they are equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if equivalent; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to the current instance. </param>
       </Docs>
@@ -374,12 +380,15 @@
         <Parameter Name="returnType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.MethodInfo'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds the given method through reflection, searching only for public methods.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodInfo" /> that represents the method, or null if the method is not found.</para>
+        </returns>
         <param name="componentClass">
           <attribution license="cc4" from="Microsoft" modified="false" />The component that contains the method. </param>
         <param name="name">
@@ -410,12 +419,15 @@
         <Parameter Name="publicOnly" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.MethodInfo'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds the given method through reflection, with an option to search only public methods.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodInfo" /> that represents the method, or null if the method is not found.</para>
+        </returns>
         <param name="componentClass">
           <attribution license="cc4" from="Microsoft" modified="false" />The component that contains the method. </param>
         <param name="name">
@@ -442,12 +454,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.ComponentModel.MemberDescriptor" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetInvocationTarget">
@@ -466,7 +481,6 @@
         <Parameter Name="instance" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Normally, the return value will be the same as the <paramref name="instance" /> parameter. If another object has been associated with this instance, or if the instance is a custom type descriptor, the <see cref="M:System.ComponentModel.MemberDescriptor.GetInvocationTarget(System.Type,System.Object)" /> method may return a different value.</para>
@@ -475,6 +489,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the object that should be used during invocation of members.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object to be used during member invocations.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the invocation target.</param>
         <param name="instance">
@@ -503,12 +521,15 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the component on which to invoke a method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the component to invoke. This method returns a visual designer when the property is attached to a visual designer.</para>
+        </returns>
         <param name="componentClass">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> representing the type of component this <see cref="T:System.ComponentModel.MemberDescriptor" /> is bound to. For example, if this <see cref="T:System.ComponentModel.MemberDescriptor" /> describes a property, this parameter should be the class that the property is declared on. </param>
         <param name="component">
@@ -531,12 +552,15 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ISite'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a component site for the given component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The site of the component, or null if a site does not exist.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component for which you want to find a site. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/MergablePropertyAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/MergablePropertyAttribute.xml
index 20c6fbe0e97..12b526f86ad 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/MergablePropertyAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/MergablePropertyAttribute.xml
@@ -119,12 +119,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether this instance and a specified object are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is equal to this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />Another object to compare to. </param>
       </Docs>
@@ -143,12 +146,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.ComponentModel.MergablePropertyAttribute" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsDefaultAttribute">
@@ -165,12 +171,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if this attribute is the default.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute is the default value for this attribute class; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="No">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/MultilineStringConverter.xml b/mcs/class/System/Documentation/en/System.ComponentModel/MultilineStringConverter.xml
index a2429f7ecc0..ddae3dbb831 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/MultilineStringConverter.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/MultilineStringConverter.xml
@@ -54,12 +54,15 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given value object to the specified type, using the specified context and culture information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" />  that provides a format context.</param>
         <param name="culture">
@@ -87,12 +90,15 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of properties for the type of array specified by the <paramref name="value" /> parameter, using the specified context and attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> with the properties that are exposed for this data type, or null if there are no properties.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" />  that provides a format context.</param>
         <param name="value">
@@ -116,7 +122,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As implemented in this class, this method always returns false.</para>
@@ -125,6 +130,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether this object supports properties, using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <see cref="Overload:System.ComponentModel.MultilineStringConverter.GetProperties" /> should be called to find the properties of this object; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" />  that provides a format context.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/NestedContainer.xml b/mcs/class/System/Documentation/en/System.ComponentModel/NestedContainer.xml
index ab276842c26..377abe96c9a 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/NestedContainer.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/NestedContainer.xml
@@ -86,7 +86,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <paramref name="name" /> parameter is null, the <see cref="T:System.ComponentModel.IComponent" /> is added to the nested container without an identifying name.</para>
@@ -95,6 +94,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a site for the component within the container.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created <see cref="T:System.ComponentModel.ISite" />.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.IComponent" /> to create a site for.</param>
         <param name="name">
@@ -144,7 +147,6 @@
         <Parameter Name="service" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method overrides the <see cref="M:System.ComponentModel.Container.GetService(System.Type)" /> method. This implementation only resolves requests for the <see cref="T:System.ComponentModel.INestedContainer" /> and <see cref="T:System.ComponentModel.IContainer" /> services.</para>
@@ -153,6 +155,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the service object of the specified type, if it is available.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that implements the requested service, or null if the service cannot be resolved.</para>
+        </returns>
         <param name="service">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the service to retrieve.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/NotifyParentPropertyAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/NotifyParentPropertyAttribute.xml
index b6dbfb7b046..a28a7123050 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/NotifyParentPropertyAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/NotifyParentPropertyAttribute.xml
@@ -92,12 +92,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified object is the same as the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object is the same as this object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test for equality. </param>
       </Docs>
@@ -116,12 +119,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash code for this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the object the attribute belongs to.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsDefaultAttribute">
@@ -138,12 +144,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the current value of the attribute is the default value for the attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current value of the attribute is the default value of the attribute; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="No">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/NullableConverter.xml b/mcs/class/System/Documentation/en/System.ComponentModel/NullableConverter.xml
index 6f9dde52ed4..58f9deed960 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/NullableConverter.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/NullableConverter.xml
@@ -55,12 +55,15 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether this converter can convert an object of the given type to the type of this converter, using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" />  that provides a format context.</param>
         <param name="sourceType">
@@ -83,12 +86,15 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether this converter can convert the object to the specified type, using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
         <param name="destinationType">
@@ -112,12 +118,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given object to the type of this converter, using the specified context and culture information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
         <param name="culture">
@@ -144,12 +153,15 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given value object to the specified type, using the specified context and culture information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
         <param name="culture">
@@ -177,8 +189,11 @@
       </Parameters>
       <Docs>
         <summary>To be added.</summary>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> representing the given <see cref="T:System.Collections.IDictionary" />, or null if the object cannot be created. This method always returns null.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="propertyValues">
@@ -201,8 +216,11 @@
       </Parameters>
       <Docs>
         <summary>To be added.</summary>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if changing a property on this object requires a call to <see cref="M:System.ComponentModel.TypeConverter.CreateInstance(System.Collections.IDictionary)" /> to create a new value; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
       </Docs>
@@ -225,8 +243,11 @@
       </Parameters>
       <Docs>
         <summary>To be added.</summary>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> with the properties that are exposed for this data type, or null if there are no properties.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="value">
@@ -251,8 +272,11 @@
       </Parameters>
       <Docs>
         <summary>To be added.</summary>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <see cref="M:System.ComponentModel.TypeConverter.GetProperties(System.Object)" /> should be called to find the properties of this object; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
       </Docs>
@@ -273,8 +297,11 @@
       </Parameters>
       <Docs>
         <summary>To be added.</summary>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> that holds a standard set of valid values, or null if the data type does not support a standard set of values.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context that can be used to extract additional information about the environment from which this converter is invoked. This parameter or properties of this parameter can be null.</param>
       </Docs>
@@ -295,8 +322,11 @@
       </Parameters>
       <Docs>
         <summary>To be added.</summary>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> returned from <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> is an exhaustive list of possible values; false if other values are possible.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
       </Docs>
@@ -317,8 +347,11 @@
       </Parameters>
       <Docs>
         <summary>To be added.</summary>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> should be called to find a common set of values the object supports; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/ParenthesizePropertyNameAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/ParenthesizePropertyNameAttribute.xml
index ea0d056553b..2d8f7e9d15d 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/ParenthesizePropertyNameAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/ParenthesizePropertyNameAttribute.xml
@@ -110,12 +110,15 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the specified object to this object and tests for equality.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if equal; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be compared. </param>
       </Docs>
@@ -134,12 +137,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash code for this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the object the attribute belongs to.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsDefaultAttribute">
@@ -156,12 +162,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the current value of the attribute is the default value for the attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current value of the attribute is the default value of the attribute; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="NeedParenthesis">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/PasswordPropertyTextAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/PasswordPropertyTextAttribute.xml
index 2aa025f04be..63fab62a298 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/PasswordPropertyTextAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/PasswordPropertyTextAttribute.xml
@@ -105,12 +105,15 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two <see cref="T:System.ComponentModel.PasswordPropertyTextAttribute" /> instances are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.ComponentModel.PasswordPropertyTextAttribute" /> is equal to the current <see cref="T:System.ComponentModel.PasswordPropertyTextAttribute" />; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.PasswordPropertyTextAttribute" /> to compare with the current <see cref="T:System.ComponentModel.PasswordPropertyTextAttribute" />.</param>
       </Docs>
@@ -128,12 +131,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.ComponentModel.PasswordPropertyTextAttribute" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsDefaultAttribute">
@@ -149,12 +155,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an indication whether the value of this instance is the default value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this instance is the default attribute for the class; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="No">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/PropertyDescriptor.xml b/mcs/class/System/Documentation/en/System.ComponentModel/PropertyDescriptor.xml
index b657676380e..87971751fc4 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/PropertyDescriptor.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/PropertyDescriptor.xml
@@ -204,7 +204,6 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Typically, this method is implemented through reflection.</para>
@@ -213,6 +212,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns whether resetting an object changes its value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if resetting the component changes its value; otherwise, false.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to test for reset capability. </param>
       </Docs>
@@ -278,7 +281,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -289,6 +291,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents the type to create. </param>
       </Docs>
@@ -309,12 +315,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this to another object to see if they are equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the values are equivalent; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to this <see cref="T:System.ComponentModel.PropertyDescriptor" />. </param>
       </Docs>
@@ -360,7 +369,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method passes null for both the <paramref name="instance" /> parameter and the <paramref name="filter" /> parameter.</para>
@@ -385,6 +393,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the default <see cref="T:System.ComponentModel.PropertyDescriptorCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of property descriptor.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetChildProperties">
@@ -403,7 +415,6 @@
         <Parameter Name="filter" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method passes null for the <paramref name="instance" /> parameter.</para>
@@ -428,6 +439,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> using a specified array of attributes as a filter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> with the properties that match the specified attributes.</para>
+        </returns>
         <param name="filter">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Attribute" /> to use as a filter. </param>
       </Docs>
@@ -448,7 +463,6 @@
         <Parameter Name="instance" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method passes null for the <paramref name="filter" /> parameter.</para>
@@ -473,6 +487,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> for a given object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> with the properties for the specified component.</para>
+        </returns>
         <param name="instance">
           <attribution license="cc4" from="Microsoft" modified="false" />A component to get the properties for. </param>
       </Docs>
@@ -494,7 +512,6 @@
         <Parameter Name="filter" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The properties for the <paramref name="instance" /> parameter can differ from the properties of a class, because the site can add or remove properties if the <paramref name="instance" /> parameter is sited.</para>
@@ -519,6 +536,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> for a given object using a specified array of attributes as a filter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> with the properties that match the specified attributes for the specified component.</para>
+        </returns>
         <param name="instance">
           <attribution license="cc4" from="Microsoft" modified="false" />A component to get the properties for. </param>
         <param name="filter">
@@ -541,12 +562,15 @@
         <Parameter Name="editorBaseType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an editor of the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the requested editor type, or null if an editor cannot be found.</para>
+        </returns>
         <param name="editorBaseType">
           <attribution license="cc4" from="Microsoft" modified="false" />The base type of editor, which is used to differentiate between multiple editors that a property supports. </param>
       </Docs>
@@ -565,12 +589,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for this object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetInvocationTarget">
@@ -589,7 +616,6 @@
         <Parameter Name="instance" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Typically, the return value will be the same as the <paramref name="instance" /> passed in. If someone associated another object with this instance, or if the instance is a custom type descriptor, the <see cref="M:System.ComponentModel.PropertyDescriptor.GetInvocationTarget(System.Type,System.Object)" /> method may return a different value.</para>
@@ -598,6 +624,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns the object that should be used during invocation of members.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> that should be used during invocation of members.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the invocation target.</param>
         <param name="instance">
@@ -620,7 +650,6 @@
         <Parameter Name="typeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Type'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To find the appropriate type, this method first checks the assembly of the type that this <see cref="T:System.ComponentModel.PropertyDescriptor" /> references. If it does not find the type in the assembly, it calls <see cref="M:System.Type.GetType" />.</para>
@@ -629,6 +658,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a type using its name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> that matches the given type name, or null if a match cannot be found.</para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly-qualified name of the type to retrieve. </param>
       </Docs>
@@ -649,7 +682,6 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Typically, this method is implemented through reflection.</para>
@@ -659,6 +691,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, gets the current value of the property on a component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of a property for a given component.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component with the property for which to retrieve the value. </param>
       </Docs>
@@ -678,12 +714,15 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the current set of ValueChanged event handlers for a specific component</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A combined multicast event handler, or null if no event handlers are currently assigned to <paramref name="component" />.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component for which to retrieve event handlers.</param>
       </Docs>
@@ -962,7 +1001,6 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Typically, this method is implemented through reflection.</para>
@@ -971,6 +1009,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, determines a value indicating whether the value of this property needs to be persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property should be persisted; otherwise, false.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component with the property to be examined for persistence. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/PropertyDescriptorCollection.xml b/mcs/class/System/Documentation/en/System.ComponentModel/PropertyDescriptorCollection.xml
index 9860f2e8747..2250c5c2257 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/PropertyDescriptorCollection.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/PropertyDescriptorCollection.xml
@@ -99,12 +99,15 @@
         <Parameter Name="value" Type="System.ComponentModel.PropertyDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the specified <see cref="T:System.ComponentModel.PropertyDescriptor" /> to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the <see cref="T:System.ComponentModel.PropertyDescriptor" /> that was added to the collection.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.PropertyDescriptor" /> to add to the collection. </param>
       </Docs>
@@ -146,12 +149,15 @@
         <Parameter Name="value" Type="System.ComponentModel.PropertyDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the collection contains the given <see cref="T:System.ComponentModel.PropertyDescriptor" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the given <see cref="T:System.ComponentModel.PropertyDescriptor" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.PropertyDescriptor" /> to find in the collection. </param>
       </Docs>
@@ -246,12 +252,15 @@
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptor'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.ComponentModel.PropertyDescriptor" /> with the specified name, using a Boolean to indicate whether to ignore case.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptor" /> with the specified name, or null if the property does not exist.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.ComponentModel.PropertyDescriptor" /> to return from the collection. </param>
         <param name="ignoreCase">
@@ -272,12 +281,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IEnumerator'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator for this class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator of type <see cref="T:System.Collections.IEnumerator" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IndexOf">
@@ -296,12 +308,15 @@
         <Parameter Name="value" Type="System.ComponentModel.PropertyDescriptor" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the given <see cref="T:System.ComponentModel.PropertyDescriptor" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the given <see cref="T:System.ComponentModel.PropertyDescriptor" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.PropertyDescriptor" /> to return the index of. </param>
       </Docs>
@@ -490,12 +505,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptorCollection'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sorts the members of this collection, using the default sort for this collection, which is usually alphabetical.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that contains the sorted <see cref="T:System.ComponentModel.PropertyDescriptor" /> objects.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Sort">
@@ -514,12 +532,15 @@
         <Parameter Name="comparer" Type="System.Collections.IComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptorCollection'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sorts the members of this collection, using the specified <see cref="T:System.Collections.IComparer" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that contains the sorted <see cref="T:System.ComponentModel.PropertyDescriptor" /> objects.</para>
+        </returns>
         <param name="comparer">
           <attribution license="cc4" from="Microsoft" modified="false" />A comparer to use to sort the <see cref="T:System.ComponentModel.PropertyDescriptor" /> objects in this collection. </param>
       </Docs>
@@ -541,12 +562,15 @@
       </Parameters>
       <Docs>
         <param name="order">To be added: an object of type 'string []'</param>
-        <returns>To be added: an object of type 'PropertyDescriptorCollection'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sorts the members of this collection. The specified order is applied first, followed by the default sort for this collection, which is usually alphabetical.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that contains the sorted <see cref="T:System.ComponentModel.PropertyDescriptor" /> objects.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Sort">
@@ -567,12 +591,15 @@
       </Parameters>
       <Docs>
         <param name="order">To be added.</param>
-        <returns>To be added: an object of type 'PropertyDescriptorCollection'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sorts the members of this collection. The specified order is applied first, followed by the sort using the specified <see cref="T:System.Collections.IComparer" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that contains the sorted <see cref="T:System.ComponentModel.PropertyDescriptor" /> objects.</para>
+        </returns>
         <param name="comparer">
           <attribution license="cc4" from="Microsoft" modified="false" />A comparer to use to sort the <see cref="T:System.ComponentModel.PropertyDescriptor" /> objects in this collection. </param>
       </Docs>
@@ -706,12 +733,15 @@
       </Parameters>
       <Docs>
         <param name="value">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Collections.IDictionary" /> contains an element with the specified key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Collections.IDictionary" /> contains an element with the key; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IDictionary.GetEnumerator">
@@ -733,12 +763,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator for this class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator of type <see cref="T:System.Collections.IEnumerator" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IDictionary.IsFixedSize">
@@ -885,12 +918,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.Collections.IDictionary" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.Collections.IDictionary" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Add">
@@ -909,12 +945,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an item to the <see cref="T:System.Collections.IList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position into which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The item to add to the collection.</param>
       </Docs>
@@ -956,12 +995,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the collection contains a specific value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the item is found in the collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The item to locate in the collection.</param>
       </Docs>
@@ -982,12 +1024,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of a specified item in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of <paramref name="value" /> if found in the list, otherwise -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The item to locate in the collection.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/PropertyTabAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/PropertyTabAttribute.xml
index d724b5de28d..44102e5d699 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/PropertyTabAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/PropertyTabAttribute.xml
@@ -167,12 +167,15 @@
         <Parameter Name="other" Type="System.ComponentModel.PropertyTabAttribute" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ComponentModel.PropertyTabAttribute" /> instances are equal; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.PropertyTabAttribute" /> to compare to this instance, or null.</param>
       </Docs>
@@ -193,12 +196,15 @@
         <Parameter Name="other" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="other" /> refers to the same <see cref="T:System.ComponentModel.PropertyTabAttribute" /> instance; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare to this instance, or null.</param>
       </Docs>
@@ -217,12 +223,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash code for this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the object the attribute belongs to.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InitializeArrays">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/ProvidePropertyAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/ProvidePropertyAttribute.xml
index 66cf33ee1dc..daef2623645 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/ProvidePropertyAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/ProvidePropertyAttribute.xml
@@ -101,12 +101,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the value of the given object is equal to the current <see cref="T:System.ComponentModel.ProvidePropertyAttribute" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of the given object is equal to that of the current; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test the value equality of. </param>
       </Docs>
@@ -125,12 +128,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.ComponentModel.ProvidePropertyAttribute" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="PropertyName">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/ReadOnlyAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/ReadOnlyAttribute.xml
index b2c87fc5d5d..e3538a75c44 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/ReadOnlyAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/ReadOnlyAttribute.xml
@@ -105,12 +105,15 @@
       </Parameters>
       <Docs>
         <param name="obj">To be added: an object of type 'object'</param>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether this instance and a specified object are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is equal to this instance; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -127,12 +130,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.ComponentModel.ReadOnlyAttribute" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsDefaultAttribute">
@@ -149,12 +155,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if this attribute is the default.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute is the default value for this attribute class; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsReadOnly">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/RecommendedAsConfigurableAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/RecommendedAsConfigurableAttribute.xml
index bf3d5bb1753..05ab38cb2b3 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/RecommendedAsConfigurableAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/RecommendedAsConfigurableAttribute.xml
@@ -100,12 +100,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether this instance and a specified object are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is equal to this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />Another object to compare to. </param>
       </Docs>
@@ -124,12 +127,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.ComponentModel.RecommendedAsConfigurableAttribute" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsDefaultAttribute">
@@ -146,12 +152,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the value of this instance is the default value for the class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this instance is the default attribute for the class; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="No">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/ReferenceConverter.xml b/mcs/class/System/Documentation/en/System.ComponentModel/ReferenceConverter.xml
index 469bf396d1c..172762f48a5 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/ReferenceConverter.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/ReferenceConverter.xml
@@ -72,7 +72,6 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -81,6 +80,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this converter can convert an object in the given source type to a reference object using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this object can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="sourceType">
@@ -105,7 +108,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -114,6 +116,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given object to the reference type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted <paramref name="value" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
@@ -141,7 +147,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method most commonly converts types to and from string objects.</para>
@@ -151,6 +156,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given value object to the reference type using the specified context and arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted object.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
@@ -177,7 +186,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TypeConverter+StandardValuesCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -186,6 +194,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of standard values for the reference data type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> that holds a standard set of valid values, or null if the data type does not support a standard set of values.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
@@ -206,7 +218,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -215,6 +226,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the list of standard values returned from <see cref="M:System.ComponentModel.ReferenceConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> is an exclusive list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true because the <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> returned from <see cref="M:System.ComponentModel.ReferenceConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> is an exhaustive list of possible values. This method never returns false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
@@ -235,7 +250,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -244,6 +258,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this object supports a standard set of values that can be picked from a list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true because <see cref="M:System.ComponentModel.ReferenceConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> can be called to find a common set of values the object supports. This method never returns false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
@@ -265,7 +283,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called for each value that matches the type associated with this <see cref="T:System.ComponentModel.ReferenceConverter" /> and for each component found that is of the associated type. By default, this method returns true, that is, it allows adding the value into the standard values collection.</para>
@@ -274,6 +291,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether a particular value can be added to the standard values collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value is allowed and can be added to the standard values collection; false if the value cannot be added to the standard values collection.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides an additional context. </param>
         <param name="value">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/RefreshPropertiesAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/RefreshPropertiesAttribute.xml
index 2defc6270bf..357ba719ae7 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/RefreshPropertiesAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/RefreshPropertiesAttribute.xml
@@ -122,12 +122,15 @@
       </Parameters>
       <Docs>
         <param name="obj">To be added: an object of type 'object'</param>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Overrides the object's <see cref="Overload:System.Object.Equals" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified object is the same; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -144,12 +147,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the object that the attribute belongs to.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsDefaultAttribute">
@@ -166,12 +172,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the current value of the attribute is the default value for the attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current value of the attribute is the default; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="RefreshProperties">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/RunInstallerAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/RunInstallerAttribute.xml
index 58d746696aa..a50e9d8289b 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/RunInstallerAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/RunInstallerAttribute.xml
@@ -98,12 +98,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the value of the specified <see cref="T:System.ComponentModel.RunInstallerAttribute" /> is equivalent to the current <see cref="T:System.ComponentModel.RunInstallerAttribute" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.ComponentModel.RunInstallerAttribute" /> is equal to the current <see cref="T:System.ComponentModel.RunInstallerAttribute" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare.</param>
       </Docs>
@@ -122,12 +125,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a hash code for the current <see cref="T:System.ComponentModel.RunInstallerAttribute" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.ComponentModel.RunInstallerAttribute" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsDefaultAttribute">
@@ -144,12 +150,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if this attribute is the default.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute is the default value for this attribute class; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="No">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/StringConverter.xml b/mcs/class/System/Documentation/en/System.ComponentModel/StringConverter.xml
index f3bd27b98f8..f95fa95f643 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/StringConverter.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/StringConverter.xml
@@ -66,7 +66,6 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -75,6 +74,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this converter can convert an object in the given source type to a string using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="sourceType">
@@ -99,7 +102,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so you always need to check its value. In addition, properties on the context object can return null.</para>
@@ -108,6 +110,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified value object to a <see cref="T:System.String" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/SyntaxCheck.xml b/mcs/class/System/Documentation/en/System.ComponentModel/SyntaxCheck.xml
index 9e7d13732fc..423a5cbd212 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/SyntaxCheck.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/SyntaxCheck.xml
@@ -39,12 +39,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks the syntax of the machine name to confirm that it does not contain "\".</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> matches the proper machine name format; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string containing the machine name to check. </param>
       </Docs>
@@ -65,12 +68,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks the syntax of the path to see whether it starts with "\\".</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> matches the proper path format; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string containing the path to check. </param>
       </Docs>
@@ -91,12 +97,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks the syntax of the path to see if it starts with "\" or drive letter "C:".</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> matches the proper path format; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string containing the path to check. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/TimeSpanConverter.xml b/mcs/class/System/Documentation/en/System.ComponentModel/TimeSpanConverter.xml
index 407bec08d46..51c51c402b4 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/TimeSpanConverter.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/TimeSpanConverter.xml
@@ -66,7 +66,6 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This converter can only convert a <see cref="T:System.TimeSpan" /> object to and from a string.</para>
@@ -76,6 +75,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this converter can convert an object in the given source type to a <see cref="T:System.TimeSpan" /> using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="sourceType">
@@ -99,7 +102,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -108,6 +110,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this converter can convert an object to the given destination type using the context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="destinationType">
@@ -132,7 +138,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This converter can only convert a <see cref="T:System.TimeSpan" /> object to and from a string.</para>
@@ -142,6 +147,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given object to a <see cref="T:System.TimeSpan" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
@@ -169,7 +178,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method most commonly converts types to and from string objects.</para>
@@ -180,6 +188,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given object to another type. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted object.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A formatter context. </param>
         <param name="culture">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/ToolboxItemAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/ToolboxItemAttribute.xml
index ff8e24cef98..37ffc188707 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/ToolboxItemAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/ToolboxItemAttribute.xml
@@ -184,7 +184,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>By default, this value returns false from the method defined in the <see cref="T:System.Attribute" /> class.</para>
@@ -193,6 +192,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the current value of the attribute is the default value for the attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current value of the attribute is the default; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="None">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/ToolboxItemFilterAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/ToolboxItemFilterAttribute.xml
index 1426ab12c75..7122917682d 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/ToolboxItemFilterAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/ToolboxItemFilterAttribute.xml
@@ -185,12 +185,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified object has a matching filter string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified object has a matching filter string; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test for a matching filter string. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/TypeConverter.xml b/mcs/class/System/Documentation/en/System.ComponentModel/TypeConverter.xml
index 791035feab7..f492d5af992 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/TypeConverter.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/TypeConverter.xml
@@ -71,7 +71,6 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As implemented in this class, this method always returns false. It never returns true.</para>
@@ -80,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether this converter can convert an object of the given type to the type of this converter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="sourceType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents the type you want to convert from. </param>
       </Docs>
@@ -101,7 +104,6 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As implemented in this class, this method returns false, unless <paramref name="sourceType" /> is an <see cref="T:System.ComponentModel.Design.Serialization.InstanceDescriptor" />.</para>
@@ -110,6 +112,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether this converter can convert an object of the given type to the type of this converter, using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="sourceType">
@@ -132,7 +138,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="destinationType" /> is a string, the default implementation of <see cref="Overload:System.ComponentModel.TypeConverter.CanConvertTo" /> always returns true.</para>
@@ -141,6 +146,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether this converter can convert the object to the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="destinationType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents the type you want to convert to. </param>
       </Docs>
@@ -162,7 +171,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <paramref name="context" /> parameter to extract additional information about the environment from which this converter is invoked. This parameter can be null, so always check it. Also, properties on the context object can return null.</para>
@@ -172,6 +180,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether this converter can convert the object to the specified type, using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="destinationType">
@@ -195,12 +207,15 @@
       </Parameters>
       <Docs>
         <param name="o">To be added: an object of type 'object'</param>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given value to the type of this converter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ConvertFrom">
@@ -221,7 +236,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Custom type authors that intend to support a type conversion behavior for XAML typically implement a <see cref="T:System.ComponentModel.TypeConverter" /> class that supports <see cref="M:System.ComponentModel.TypeConverter.ConvertFrom(System.ComponentModel.ITypeDescriptorContext,System.Globalization.CultureInfo,System.Object)" /> behavior from a string. This behavior enables type conversion from the string provided as a XAML attribute value and provides a XAML processor with the support needed to create an object from the string, so that the object can be produced in a parsed object graph. Custom types or members of custom types are indicated by applying <see cref="T:System.ComponentModel.TypeConverterAttribute" /> to the definitions, with the attribute referencing the custom <see cref="T:System.ComponentModel.TypeConverter" /> implementation. </para>
@@ -231,6 +245,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given object to the type of this converter, using the specified context and culture information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
@@ -255,7 +273,6 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default implementation always returns null.</para>
@@ -264,6 +281,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given string to the type of this converter, using the invariant culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted text.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> to convert. </param>
       </Docs>
@@ -285,7 +306,6 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An exception is raised if the string cannot be converted into the appropriate object. The default implementation always returns null.</para>
@@ -295,6 +315,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given string to the type of this converter, using the invariant culture and the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted text.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="text">
@@ -317,7 +341,6 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default implementation always returns null.</para>
@@ -326,6 +349,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified text to an object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted text.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text representation of the object to convert. </param>
       </Docs>
@@ -347,7 +374,6 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An exception is raised if the string cannot be converted into the appropriate object. The default implementation always returns null.</para>
@@ -357,6 +383,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given text to an object, using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted text.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="text">
@@ -381,7 +411,6 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An exception is raised if the string cannot be converted into the appropriate object. The default implementation always returns null.</para>
@@ -391,6 +420,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given text to an object, using the specified context and culture information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted text.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
@@ -416,7 +449,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The most common type to convert to and from is a string object. This implementation calls <see cref="M:System.Object.ToString" /> on the object, if the object is valid and if the destination type is a string.</para>
@@ -425,6 +457,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given value object to the specified type, using the arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to convert. </param>
         <param name="destinationType">
@@ -450,7 +486,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The most common types to convert are to and from a string object. This implementation calls <see cref="M:System.Object.ToString" /> on the object if the object is valid and if the destination type is a string.</para>
@@ -462,6 +497,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given value object to the specified type, using the specified context and culture information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
@@ -488,7 +527,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment from which this converter is being invoked. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -498,6 +536,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified value to a culture-invariant string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that represents the converted value.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to convert. </param>
       </Docs>
@@ -519,7 +561,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <paramref name="context" /> parameter to extract additional information about the environment from which this converter is invoked. This parameter can be null, so always check it. Also, properties on the context object can return null.</para>
@@ -529,6 +570,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified value to a culture-invariant string representation, using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that represents the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="value">
@@ -551,7 +596,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Depending on the implementation of the value formatter, it might be possible to pass the returned string back into the value formatter to re-create an instance of the object.</para>
@@ -560,6 +604,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified value to a string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to convert. </param>
       </Docs>
@@ -581,7 +629,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <paramref name="context" /> parameter to extract additional information about the environment from which this converter is invoked. This parameter can be null, so always check it. Also, properties on the context object can return null.</para>
@@ -591,6 +638,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given value to a string representation, using the given context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="value">
@@ -615,7 +666,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <paramref name="context" /> parameter to extract additional information about the environment from which this converter is invoked. This parameter can be null, so always check it. Also, properties on the context object can return null.</para>
@@ -625,6 +675,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given value to a string representation, using the specified context and culture information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
@@ -649,7 +703,6 @@
         <Parameter Name="propertyValues" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method for objects that are immutable, but for which you want to provide changeable properties.</para>
@@ -659,6 +712,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Re-creates an <see cref="T:System.Object" /> given a set of property values for the object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> representing the given <see cref="T:System.Collections.IDictionary" />, or null if the object cannot be created. This method always returns null.</para>
+        </returns>
         <param name="propertyValues">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Collections.IDictionary" /> that represents a dictionary of new property values. </param>
       </Docs>
@@ -680,7 +737,6 @@
         <Parameter Name="propertyValues" Type="System.Collections.IDictionary" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method for objects that are immutable, but for which you want to provide changeable properties.</para>
@@ -689,6 +745,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the type that this <see cref="T:System.ComponentModel.TypeConverter" /> is associated with, using the specified context, given a set of property values for the object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> representing the given <see cref="T:System.Collections.IDictionary" />, or null if the object cannot be created. This method always returns null.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="propertyValues">
@@ -711,12 +771,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Exception'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an exception to throw when a conversion cannot be performed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Exception" /> that represents the exception to throw when a conversion cannot be performed.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to convert, or null if the object is not available. </param>
       </Docs>
@@ -738,12 +801,15 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Exception'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an exception to throw when a conversion cannot be performed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Exception" /> that represents the exception to throw when a conversion cannot be performed.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to convert, or null if the object is not available. </param>
         <param name="destinationType">
@@ -764,12 +830,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether changing a value on this object requires a call to the <see cref="M:System.ComponentModel.TypeConverter.CreateInstance(System.Collections.IDictionary)" /> method to create a new value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if changing a property on this object requires a call to <see cref="M:System.ComponentModel.TypeConverter.CreateInstance(System.Collections.IDictionary)" /> to create a new value; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetCreateInstanceSupported">
@@ -788,7 +857,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As implemented in this class, this method always returns false.</para>
@@ -797,6 +865,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether changing a value on this object requires a call to <see cref="M:System.ComponentModel.TypeConverter.CreateInstance(System.Collections.IDictionary)" /> to create a new value, using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if changing a property on this object requires a call to <see cref="M:System.ComponentModel.TypeConverter.CreateInstance(System.Collections.IDictionary)" /> to create a new value; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
@@ -817,7 +889,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As implemented in this class, this method always returns null.</para>
@@ -827,6 +898,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of properties for the type of array specified by the value parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> with the properties that are exposed for this data type, or null if there are no properties.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Object" /> that specifies the type of array for which to get properties. </param>
       </Docs>
@@ -848,7 +923,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <paramref name="context" /> parameter to extract additional information about the environment from which this converter is invoked. This parameter can be null, so always check it. Also, properties on the context object can return null.</para>
@@ -859,6 +933,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of properties for the type of array specified by the value parameter, using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> with the properties that are exposed for this data type, or null if there are no properties.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="value">
@@ -883,7 +961,6 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As implemented in this class, this method always returns null.</para>
@@ -892,6 +969,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of properties for the type of array specified by the value parameter, using the specified context and attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> with the properties that are exposed for this data type, or null if there are no properties.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="value">
@@ -914,7 +995,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As implemented in this class, this method always returns false.</para>
@@ -923,6 +1003,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether this object supports properties.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <see cref="M:System.ComponentModel.TypeConverter.GetProperties(System.Object)" /> should be called to find the properties of this object; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetPropertiesSupported">
@@ -941,7 +1025,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As implemented in this class, this method always returns false.</para>
@@ -950,6 +1033,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether this object supports properties, using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <see cref="M:System.ComponentModel.TypeConverter.GetProperties(System.Object)" /> should be called to find the properties of this object; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
@@ -968,7 +1055,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.ICollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As implemented in this class, this method always returns null.</para>
@@ -977,6 +1063,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of standard values from the default context for the data type this type converter is designed for.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> containing a standard set of valid values, or null if the data type does not support a standard set of values.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetStandardValues">
@@ -995,7 +1085,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TypeConverter+StandardValuesCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As implemented in <see cref="T:System.ComponentModel.TypeConverter" />, this method always returns null.</para>
@@ -1004,6 +1093,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of standard values for the data type this type converter is designed for when provided with a format context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> that holds a standard set of valid values, or null if the data type does not support a standard set of values.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context that can be used to extract additional information about the environment from which this converter is invoked. This parameter or properties of this parameter can be null. </param>
       </Docs>
@@ -1022,7 +1115,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As implemented in this class, this method always returns false.</para>
@@ -1032,6 +1124,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the collection of standard values returned from <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> is an exclusive list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> returned from <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> is an exhaustive list of possible values; false if other values are possible.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetStandardValuesExclusive">
@@ -1050,7 +1146,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As implemented in this class, this method always returns false.</para>
@@ -1060,6 +1155,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the collection of standard values returned from <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> is an exclusive list of possible values, using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> returned from <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> is an exhaustive list of possible values; false if other values are possible.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
@@ -1078,12 +1177,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether this object supports a standard set of values that can be picked from a list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> should be called to find a common set of values the object supports; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetStandardValuesSupported">
@@ -1102,7 +1204,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As implemented in this class, this method always returns false.</para>
@@ -1112,6 +1213,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether this object supports a standard set of values that can be picked from a list, using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <see cref="M:System.ComponentModel.TypeConverter.GetStandardValues" /> should be called to find a common set of values the object supports; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
@@ -1132,7 +1237,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Starting in net_v40_long, the <see cref="M:System.ComponentModel.TypeConverter.IsValid(System.ComponentModel.ITypeDescriptorContext,System.Object)" /> method catches exceptions from the <see cref="Overload:System.ComponentModel.TypeConverter.CanConvertFrom" /> and <see cref="Overload:System.ComponentModel.TypeConverter.ConvertFrom" /> methods. If the input value type causes <see cref="Overload:System.ComponentModel.TypeConverter.CanConvertFrom" /> to return false, or if the input value causes <see cref="Overload:System.ComponentModel.TypeConverter.ConvertFrom" /> to raise an exception, the <see cref="M:System.ComponentModel.TypeConverter.IsValid(System.ComponentModel.ITypeDescriptorContext,System.Object)" /> method returns false. </para>
@@ -1148,6 +1252,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the given value object is valid for this type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified value is valid for this object; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test for validity. </param>
       </Docs>
@@ -1169,7 +1277,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <paramref name="context" /> parameter to extract additional information about the environment from which this converter is invoked. This parameter can be null, so always check it. Also, properties on the context object can return null. </para>
@@ -1186,6 +1293,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the given value object is valid for this type and for the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified value is valid for this object; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="value">
@@ -1209,7 +1320,6 @@
         <Parameter Name="names" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>All properties in the collection that are not already in the array of names are added alphabetically to the end. If the <paramref name="names" /> parameter is an empty array or null, all the properties in the collection are sorted alphabetically.</para>
@@ -1218,6 +1328,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sorts a collection of properties.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that contains the sorted properties.</para>
+        </returns>
         <param name="props">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> that has the properties to sort. </param>
         <param name="names">
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/TypeConverterAttribute.xml b/mcs/class/System/Documentation/en/System.ComponentModel/TypeConverterAttribute.xml
index 678843edbdf..6b4aef0c767 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/TypeConverterAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/TypeConverterAttribute.xml
@@ -168,12 +168,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the value of the given object is equal to the current <see cref="T:System.ComponentModel.TypeConverterAttribute" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of the given object is equal to that of the current <see cref="T:System.ComponentModel.TypeConverterAttribute" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test the value equality of. </param>
       </Docs>
@@ -192,12 +195,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.ComponentModel.TypeConverterAttribute" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/TypeDescriptionProvider.xml b/mcs/class/System/Documentation/en/System.ComponentModel/TypeDescriptionProvider.xml
index 8471e2c0c8c..7815b1b7fdc 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/TypeDescriptionProvider.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/TypeDescriptionProvider.xml
@@ -159,7 +159,6 @@
         <Parameter Name="args" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.IServiceProvider" /> specified by the <paramref name="provider" /> parameter is passed in by the <see cref="M:System.ComponentModel.TypeDescriptor.CreateInstance(System.IServiceProvider,System.Type,System.Type[],System.Object[])" /> method of the <see cref="T:System.ComponentModel.TypeDescriptor" /> class. If <paramref name="provider" /> is not null, the service provider can be used by the type description provider to obtain additional context about the creation call.</para>
@@ -169,6 +168,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an object that can substitute for another data type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The substitute <see cref="T:System.Object" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An optional service provider.</param>
         <param name="objectType">
@@ -194,7 +197,6 @@
         <Parameter Name="instance" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A <see cref="T:System.ComponentModel.TypeDescriptor" /> may need to perform complex operations on collections of metadata. Because types are not unloaded for the life of a domain, the <see cref="T:System.ComponentModel.TypeDescriptor" /> class will automatically cache the results of these operations based on type. However, some operations use live object instances. These operations cannot be cached within the <see cref="T:System.ComponentModel.TypeDescriptor" /> class because caching them would prevent the object from being garbage collected. Instead, the <see cref="T:System.ComponentModel.TypeDescriptor" /> class allows for a per-object cache, accessed as an <see cref="T:System.Collections.IDictionary" /> of key/value pairs, to exist on an object. The <see cref="M:System.ComponentModel.TypeDescriptionProvider.GetCache(System.Object)" /> method returns an instance of this cache. The <see cref="M:System.ComponentModel.TypeDescriptionProvider.GetCache(System.Object)" /> method will return null if there is no supported cache for an object.</para>
@@ -204,6 +206,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a per-object cache, accessed as an <see cref="T:System.Collections.IDictionary" /> of key/value pairs.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IDictionary" /> if the provided object supports caching; otherwise, null.</para>
+        </returns>
         <param name="instance">
           <attribution license="cc4" from="Microsoft" modified="false" />The object for which to get the cache.</param>
       </Docs>
@@ -223,7 +229,6 @@
         <Parameter Name="instance" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An extended type descriptor is a custom type descriptor that offers properties that other objects have added to this object, but that are not actually defined on the object. For example, in the dnprdnshort component model, objects that implement the <see cref="T:System.ComponentModel.IExtenderProvider" /> interface can attach properties to other objects that reside in the same logical container. The overloaded <see cref="Overload:System.ComponentModel.TypeDescriptionProvider.GetTypeDescriptor" /> methods do not return a type descriptor that provides these extra extended properties. The <see cref="M:System.ComponentModel.TypeDescriptionProvider.GetExtendedTypeDescriptor(System.Object)" /> method returns the set of these extended properties. The <see cref="T:System.ComponentModel.TypeDescriptor" /> will automatically merge the results of these two property collections. While the dnprdnshort component model supports only extended properties, <see cref="M:System.ComponentModel.TypeDescriptionProvider.GetExtendedTypeDescriptor(System.Object)" /> can be used for extended attributes as well as events, if the type description provider supports it. </para>
@@ -234,6 +239,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an extended custom type descriptor for the given object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> that can provide extended metadata for the object.</para>
+        </returns>
         <param name="instance">
           <attribution license="cc4" from="Microsoft" modified="false" />The object for which to get the extended type descriptor.</param>
       </Docs>
@@ -252,12 +261,15 @@
         <Parameter Name="instance" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the extender providers for the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of extender providers for <paramref name="instance" />.</para>
+        </returns>
         <param name="instance">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to get extender providers for.</param>
       </Docs>
@@ -277,12 +289,15 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the name of the specified component, or null if the component has no name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the specified component.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The specified component.</param>
       </Docs>
@@ -302,7 +317,6 @@
         <Parameter Name="instance" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.ComponentModel.TypeDescriptionProvider.GetReflectionType" /> method is a lower-level version of the <see cref="Overload:System.ComponentModel.TypeDescriptionProvider.GetTypeDescriptor" /> method. If no custom type descriptor can be located for an object, <see cref="Overload:System.ComponentModel.TypeDescriptionProvider.GetReflectionType" /> is called to perform normal reflection against the object.</para>
@@ -312,6 +326,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs normal reflection against the given object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type of reflection for this <paramref name="instance" />.</para>
+        </returns>
         <param name="instance">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of the type (should not be null).</param>
       </Docs>
@@ -331,7 +349,6 @@
         <Parameter Name="objectType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.ComponentModel.TypeDescriptionProvider.GetReflectionType" /> method is a lower-level version of the <see cref="Overload:System.ComponentModel.TypeDescriptionProvider.GetTypeDescriptor" /> method. If no custom type descriptor can be located for an object, <see cref="Overload:System.ComponentModel.TypeDescriptionProvider.GetReflectionType" /> is called to perform normal reflection against the object.</para>
@@ -341,6 +358,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs normal reflection against a type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type of reflection for this <paramref name="objectType" />.</para>
+        </returns>
         <param name="objectType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of object for which to retrieve the <see cref="T:System.Reflection.IReflect" />.</param>
       </Docs>
@@ -361,7 +382,6 @@
         <Parameter Name="instance" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.ComponentModel.TypeDescriptionProvider.GetReflectionType" /> method is a lower-level version of the <see cref="Overload:System.ComponentModel.TypeDescriptionProvider.GetTypeDescriptor" /> method. If no custom type descriptor can be located for an object, <see cref="Overload:System.ComponentModel.TypeDescriptionProvider.GetReflectionType" /> is called to perform normal reflection against the object.</para>
@@ -370,6 +390,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs normal reflection against the given object with the given type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type of reflection for this <paramref name="objectType" />.</para>
+        </returns>
         <param name="objectType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of object for which to retrieve the <see cref="T:System.Reflection.IReflect" />.</param>
         <param name="instance">
@@ -390,7 +414,6 @@
         <Parameter Name="reflectionType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.TypeDescriptionProvider.GetRuntimeType(System.Type)" /> method reverses the <see cref="M:System.ComponentModel.TypeDescriptionProvider.GetReflectionType(System.Type)" /> method to convert a reflection type back into a runtime type. Using the <see cref="M:System.ComponentModel.TypeDescriptionProvider.GetRuntimeType(System.Type)" /> method is preferred over using the <see cref="P:System.Type.UnderlyingSystemType" /> property, which was used in earlier versions to return the runtime type. </para>
@@ -399,6 +422,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a reflection type into a runtime type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> that represents the runtime equivalent of <paramref name="reflectionType" />.</para>
+        </returns>
         <param name="reflectionType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to convert to its runtime equivalent.</param>
       </Docs>
@@ -418,12 +445,15 @@
         <Parameter Name="instance" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a custom type descriptor for the given object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> that can provide metadata for the type.</para>
+        </returns>
         <param name="instance">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of the type. Can be null if no instance was passed to the <see cref="T:System.ComponentModel.TypeDescriptor" />.</param>
       </Docs>
@@ -443,12 +473,15 @@
         <Parameter Name="objectType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a custom type descriptor for the given type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> that can provide metadata for the type.</para>
+        </returns>
         <param name="objectType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of object for which to retrieve the type descriptor.</param>
       </Docs>
@@ -469,7 +502,6 @@
         <Parameter Name="instance" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is prototyped as virtual and, by default, returns an empty descriptor if no parent provider was passed. If a parent provider was passed, this method will invoke the parent provider's <see cref="M:System.ComponentModel.TypeDescriptionProvider.GetTypeDescriptor(System.Type,System.Object)" /> method.</para>
@@ -478,6 +510,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a custom type descriptor for the given type and object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> that can provide metadata for the type.</para>
+        </returns>
         <param name="objectType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of object for which to retrieve the type descriptor.</param>
         <param name="instance">
@@ -498,12 +534,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the specified type is compatible with the type description and its chain of type description providers. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="type" /> is compatible with the type description and its chain of type description providers; otherwise, false. </para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to test for compatibility.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/TypeDescriptor.xml b/mcs/class/System/Documentation/en/System.ComponentModel/TypeDescriptor.xml
index 19361882993..50444a18bc4 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/TypeDescriptor.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/TypeDescriptor.xml
@@ -98,7 +98,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.TypeDescriptor.AddAttributes(System.Object,System.Attribute[])" /> method adds class-level attributes to the specified instance of a component. Because this is a common requirement of applications using the vsprvs Windows Forms Designer and Properties window, this method provides a shortcut by creating a type description provider that merges the provided attributes with the attributes that already exist on the class. The return value is the type description provider that was used to add the attributes. This provider can later be passed to the <see cref="M:System.ComponentModel.TypeDescriptor.RemoveProvider(System.ComponentModel.TypeDescriptionProvider,System.Object)" /> method when the added attributes are no longer needed.</para>
@@ -107,6 +106,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds class-level attributes to the target component instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created <see cref="T:System.ComponentModel.TypeDescriptionProvider" /> that was used to add the specified attributes.</para>
+        </returns>
         <param name="instance">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of the target component.</param>
         <param name="attributes">
@@ -140,7 +143,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.TypeDescriptor.AddAttributes(System.Type,System.Attribute[])" /> method adds class-level attributes to the specified type of a component. Because this is a common requirement of applications using the vsprvs Windows Forms Designer and Properties window, this method provides a shortcut by creating a type description provider that merges the provided attributes with the attributes that already exist on the class. The return value is the type description provider that was used to add the attributes. This provider can later be passed to the <see cref="M:System.ComponentModel.TypeDescriptor.RemoveProvider(System.ComponentModel.TypeDescriptionProvider,System.Type)" /> method when the added attributes are no longer needed.</para>
@@ -149,6 +151,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds class-level attributes to the target component type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created <see cref="T:System.ComponentModel.TypeDescriptionProvider" /> that was used to add the specified attributes.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the target component.</param>
         <param name="attributes">
@@ -474,7 +480,6 @@
         <Parameter Name="designerBaseType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Design.IDesigner'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If this method cannot find a valid <see cref="T:System.ComponentModel.DesignerAttribute" />, it searches up the class hierarchy for a designer. If it cannot find a designer in the class hierarchy, it returns null.</para>
@@ -483,6 +488,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the designer associated with the specified component and of the specified type of designer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.Design.IDesigner" /> that is an instance of the designer for the component, or null if no designer can be found.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.IComponent" /> that specifies the component to associate with the designer. </param>
         <param name="designerBaseType">
@@ -513,12 +522,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'EventDescriptor'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new event descriptor that is identical to an existing event descriptor, when passed the existing <see cref="T:System.ComponentModel.EventDescriptor" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ComponentModel.EventDescriptor" /> that has merged the specified metadata attributes with the existing metadata attributes.</para>
+        </returns>
         <param name="componentType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the component for which to create the new event. </param>
         <param name="oldEventDescriptor">
@@ -552,12 +564,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'EventDescriptor'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new event descriptor that is identical to an existing event descriptor by dynamically generating descriptor information from a specified event on a type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptor" /> that is bound to a type.</para>
+        </returns>
         <param name="componentType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the component the event lives on. </param>
         <param name="name">
@@ -591,7 +606,6 @@
         <Parameter Name="args" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ComponentModel.TypeDescriptor.CreateInstance(System.IServiceProvider,System.Type,System.Type[],System.Object[])" /> method will search for a <see cref="T:System.ComponentModel.TypeDescriptionProvider" /> that is associated with the specified <paramref name="objectType" /> data type. This method first tries to obtain a type description provider from the <paramref name="provider" /> parameter. If this fails, it searches its own internal tables for a provider (these entries were created through previous calls to <see cref="Overload:System.ComponentModel.TypeDescriptor.AddProvider" />). If it finds a provider, this method will delegate the creation call to that object. </para>
@@ -600,6 +614,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an object that can substitute for another data type. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the substitute data type if an associated <see cref="T:System.ComponentModel.TypeDescriptionProvider" /> is found; otherwise, null.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />The service provider that provides a <see cref="T:System.ComponentModel.TypeDescriptionProvider" /> service. This parameter can be null.</param>
         <param name="objectType">
@@ -634,12 +652,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptor'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new property descriptor from an existing property descriptor, using the specified existing <see cref="T:System.ComponentModel.PropertyDescriptor" /> and attribute array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.ComponentModel.PropertyDescriptor" /> that has the specified metadata attributes merged with the existing metadata attributes.</para>
+        </returns>
         <param name="componentType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the component that the property is a member of. </param>
         <param name="oldPropertyDescriptor">
@@ -673,12 +694,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptor'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and dynamically binds a property descriptor to a type, using the specified property name, type, and attribute array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptor" /> that is bound to the specified type and that has the specified metadata attributes merged with the existing metadata attributes.</para>
+        </returns>
         <param name="componentType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the component that the property is a member of. </param>
         <param name="name">
@@ -713,7 +737,6 @@
         <Parameter Name="primary" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If a previous association has been made for the <paramref name="type" /> parameter using the <see cref="M:System.ComponentModel.TypeDescriptor.CreateAssociation(System.Object,System.Object)" /> method, then the <see cref="M:System.ComponentModel.TypeDescriptor.GetAssociation(System.Type,System.Object)" /> method returns the correct secondary object to invoke for the requested type. Otherwise, <see cref="M:System.ComponentModel.TypeDescriptor.GetAssociation(System.Type,System.Object)" /> searches for a compatible designer for <paramref name="type" /> and returns the designer if one is found. This method never returns null.</para>
@@ -723,6 +746,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an instance of the type associated with the specified primary object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the secondary type that has been associated with the primary object if an association exists; otherwise, <paramref name="primary" /> if no specified association exists.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the target component.</param>
         <param name="primary">
@@ -745,7 +772,6 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'AttributeCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The attributes returned by the <see cref="Overload:System.ComponentModel.TypeDescriptor.GetAttributes" /> method may be dynamically modified from the original component's source listing by extender providers (<see cref="T:System.ComponentModel.IExtenderProvider" />), filter services (<see cref="T:System.ComponentModel.Design.ITypeDescriptorFilterService" />), and attribute filters.</para>
@@ -758,6 +784,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the collection of attributes for the specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.AttributeCollection" /> containing the attributes for the component. If <paramref name="component" /> is null, this method returns an empty collection.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component for which you want to get attributes. </param>
       </Docs>
@@ -778,7 +808,6 @@
         <Parameter Name="componentType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'AttributeCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this version of this method only when you do not have an instance of the object.</para>
@@ -792,6 +821,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of attributes for the specified type of component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.AttributeCollection" /> with the attributes for the type of the component. If the component is null, this method returns an empty collection.</para>
+        </returns>
         <param name="componentType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the target component. </param>
       </Docs>
@@ -818,7 +851,6 @@
         <Parameter Name="noCustomTypeDesc" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'AttributeCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The attributes returned by the <see cref="Overload:System.ComponentModel.TypeDescriptor.GetAttributes" /> method may be dynamically modified from the original components source listing by extender providers (<see cref="T:System.ComponentModel.IExtenderProvider" />), filter services (<see cref="T:System.ComponentModel.Design.ITypeDescriptorFilterService" />), and attribute filters.</para>
@@ -831,6 +863,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection of attributes for the specified component and a Boolean indicating that a custom type descriptor has been created.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.AttributeCollection" /> with the attributes for the component. If the component is null, this method returns an empty collection.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component for which you want to get attributes. </param>
         <param name="noCustomTypeDesc">
@@ -853,7 +889,6 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Typically, this method returns the full <see cref="T:System.Type" /> name for the <paramref name="component" /> parameter type. For example, the class name for a button is "System.Windows.Forms.Button". If <paramref name="component" /> implements <see cref="T:System.ComponentModel.ICustomTypeDescriptor" />, it can return an alternate name. </para>
@@ -863,6 +898,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the class for the specified component using the default type descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the name of the class for the specified component.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> for which you want the class name. </param>
       </Docs>
@@ -887,7 +926,6 @@
         <Parameter Name="componentType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses the cached custom type descriptor for the specified type to discover the associated class name.</para>
@@ -896,6 +934,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the class for the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the name of the class for the specified component type.</para>
+        </returns>
         <param name="componentType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the target component.</param>
       </Docs>
@@ -922,7 +964,6 @@
         <Parameter Name="noCustomTypeDesc" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Typically, this method returns the full <see cref="T:System.Type" /> name for the <paramref name="component" /> parameter type. For example, the class name for a button is "System.Windows.Forms.Button". If the <paramref name="component" /> parameter implements <see cref="T:System.ComponentModel.ICustomTypeDescriptor" />, it can return an alternate name. </para>
@@ -931,6 +972,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the class for the specified component using a custom type descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the name of the class for the specified component.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> for which you want the class name. </param>
         <param name="noCustomTypeDesc">
@@ -953,7 +998,6 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Typically, this method returns the name for the site of the component, if one exists. For example, the class name for a button is "System.Windows.Forms.Button".</para>
@@ -964,6 +1008,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the specified component using the default type descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the name of the specified component, or null if there is no component name.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> for which you want the class name. </param>
       </Docs>
@@ -990,7 +1038,6 @@
         <Parameter Name="noCustomTypeDesc" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is used at design time to retrieve the name of an instance of a component. Typically, this method returns the name for the site of the component, if one exists. For example, the class name for a button is "System.Windows.Forms.Button". If the component implements the <see cref="T:System.ComponentModel.ICustomTypeDescriptor" /> interface, it can return an alternate name.</para>
@@ -999,6 +1046,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the specified component using a custom type descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the class for the specified component, or null if there is no component name.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> for which you want the class name. </param>
         <param name="noCustomTypeDesc">
@@ -1021,7 +1072,6 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TypeConverter'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method locates an appropriate type converter by looking for a <see cref="T:System.ComponentModel.TypeConverterAttribute" />. If it cannot find a <see cref="T:System.ComponentModel.TypeConverterAttribute" />, it traverses the base class hierarchy of the class until it finds a primitive type.</para>
@@ -1031,6 +1081,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a type converter for the type of the specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter" /> for the specified component.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />A component to get the converter for. </param>
       </Docs>
@@ -1051,7 +1105,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TypeConverter'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this version of this method only when you do not have an instance of the object.</para>
@@ -1061,6 +1114,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a type converter for the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter" /> for the specified type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the target component. </param>
       </Docs>
@@ -1087,7 +1144,6 @@
         <Parameter Name="noCustomTypeDesc" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TypeConverter'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method looks for the appropriate type converter by trying to find a <see cref="T:System.ComponentModel.TypeConverterAttribute" />. If it cannot find a <see cref="T:System.ComponentModel.TypeConverterAttribute" />, it traverses the base class hierarchy of the class until it finds a primitive type.</para>
@@ -1096,6 +1152,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a type converter for the type of the specified component with a custom type descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter" /> for the specified component.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />A component to get the converter for. </param>
         <param name="noCustomTypeDesc">
@@ -1118,7 +1178,6 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'EventDescriptor'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is equivalent to the overloaded <see cref="M:System.ComponentModel.TypeDescriptor.GetDefaultEvent(System.Object,System.Boolean)" /> method with a second parameter of false.</para>
@@ -1127,6 +1186,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the default event for the specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptor" /> with the default event, or null if there are no events.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to get the event for. </param>
       </Docs>
@@ -1147,7 +1210,6 @@
         <Parameter Name="componentType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'EventDescriptor'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this version of this method only when you do not have an instance of the object.</para>
@@ -1156,6 +1218,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the default event for the specified type of component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptor" /> with the default event, or null if there are no events.</para>
+        </returns>
         <param name="componentType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the target component.</param>
       </Docs>
@@ -1182,12 +1248,15 @@
         <Parameter Name="noCustomTypeDesc" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'EventDescriptor'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the default event for a component with a custom type descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptor" /> with the default event, or null if there are no events.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to get the event for. </param>
         <param name="noCustomTypeDesc">
@@ -1210,7 +1279,6 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptor'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <paramref name="component" /> parameter is null, this method returns null.</para>
@@ -1219,6 +1287,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the default property for the specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptor" /> with the default property, or null if there are no properties.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to get the default property for. </param>
       </Docs>
@@ -1239,7 +1311,6 @@
         <Parameter Name="componentType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptor'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this version of this method only when you do not have an instance of the object.</para>
@@ -1249,6 +1320,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the default property for the specified type of component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptor" /> with the default property, or null if there are no properties.</para>
+        </returns>
         <param name="componentType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents the class to get the property for. </param>
       </Docs>
@@ -1275,7 +1350,6 @@
         <Parameter Name="noCustomTypeDesc" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptor'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <paramref name="component" /> parameter is null, this method returns null.</para>
@@ -1284,6 +1358,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the default property for the specified component with a custom type descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptor" /> with the default property, or null if there are no properties.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to get the default property for. </param>
         <param name="noCustomTypeDesc">
@@ -1307,7 +1385,6 @@
         <Parameter Name="editorBaseType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The type of <paramref name="editorBaseType" /> is usually <see cref="T:System.Drawing.Design.UITypeEditor" />, but you can also use other types (for example, <see cref="T:System.ComponentModel.ComponentEditor" /> and <see cref="T:System.ComponentModel.InstanceCreationEditor" />).</para>
@@ -1317,6 +1394,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an editor with the specified base type for the specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the editor that can be cast to the specified editor type, or null if no editor of the requested type can be found.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to get the editor for. </param>
         <param name="editorBaseType">
@@ -1341,7 +1422,6 @@
       </Parameters>
       <Docs>
         <param name="componentType">To be added.</param>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The type of <paramref name="editorBaseType" /> is usually <see cref="T:System.Drawing.Design.UITypeEditor" />, but you can also use other types (for example <see cref="T:System.ComponentModel.ComponentEditor" /> and <see cref="T:System.ComponentModel.InstanceCreationEditor" />).</para>
@@ -1352,6 +1432,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an editor with the specified base type for the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the editor object that can be cast to the given base type, or null if no editor of the requested type can be found.</para>
+        </returns>
         <param name="editorBaseType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents the base type of the editor you are trying to find. </param>
       </Docs>
@@ -1379,7 +1463,6 @@
         <Parameter Name="noCustomTypeDesc" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The type of <paramref name="editorBaseType" /> is usually <see cref="T:System.Drawing.Design.UITypeEditor" />, but you can also use other types (for example <see cref="T:System.ComponentModel.ComponentEditor" /> and <see cref="T:System.ComponentModel.InstanceCreationEditor" />).</para>
@@ -1389,6 +1472,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an editor with the specified base type and with a custom type descriptor for the specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the editor that can be cast to the specified editor type, or null if no editor of the requested type can be found.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The component to get the editor for. </param>
         <param name="editorBaseType">
@@ -1413,7 +1500,6 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'EventDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection of events that the given <paramref name="component" /> parameter instance provides. This collection can differ from the set of events the class provides. If the <paramref name="component" /> parameter is sited, the site can add or remove additional events.</para>
@@ -1424,6 +1510,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the collection of events for the specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptorCollection" /> with the events for this component.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />A component to get the events for. </param>
       </Docs>
@@ -1444,7 +1534,6 @@
         <Parameter Name="componentType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'EventDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this version of this method only when you do not have an instance of the object.</para>
@@ -1455,6 +1544,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the collection of events for a specified type of component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptorCollection" /> with the events for this component.</para>
+        </returns>
         <param name="componentType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the target component.</param>
       </Docs>
@@ -1476,7 +1569,6 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'EventDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The events for the <paramref name="component" /> parameter can differ from the events of a class, because the site can add or remove events if the <paramref name="component" /> parameter is sited.</para>
@@ -1502,6 +1594,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the collection of events for a specified component using a specified array of attributes as a filter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptorCollection" /> with the events that match the specified attributes for this component.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />A component to get the events for. </param>
         <param name="attributes">
@@ -1530,7 +1626,6 @@
         <Parameter Name="noCustomTypeDesc" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'EventDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method retrieves a collection of events that the given <paramref name="component" /> parameter instance provides. This can differ from the set of events the class provides. If the <paramref name="component" /> parameter is sited, the site can add or remove additional events.</para>
@@ -1541,6 +1636,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the collection of events for a specified component with a custom type descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptorCollection" /> with the events for this component.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />A component to get the events for. </param>
         <param name="noCustomTypeDesc">
@@ -1564,7 +1663,6 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'EventDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this version of this method only when you do not have an instance of the object.</para>
@@ -1590,6 +1688,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the collection of events for a specified type of component using a specified array of attributes as a filter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptorCollection" /> with the events that match the specified attributes for this component.</para>
+        </returns>
         <param name="componentType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the target component.</param>
         <param name="attributes">
@@ -1619,7 +1721,6 @@
         <Parameter Name="noCustomTypeDesc" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'EventDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The events for the <paramref name="component" /> parameter can differ from the events of a class, because the site can add or remove events if the <paramref name="component" /> parameter is sited.</para>
@@ -1645,6 +1746,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the collection of events for a specified component using a specified array of attributes as a filter and using a custom type descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ComponentModel.EventDescriptorCollection" /> with the events that match the specified attributes for this component.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />A component to get the events for. </param>
         <param name="attributes">
@@ -1673,7 +1778,6 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In many cases, the <see cref="M:System.ComponentModel.TypeDescriptor.GetFullComponentName(System.Object)" /> method will return the same value as the <see cref="Overload:System.ComponentModel.TypeDescriptor.GetComponentName" /> method. However, if the component resides in a nested container or has other nested semantics, it may return a different fully qualified name.</para>
@@ -1682,6 +1786,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the fully qualified name of the component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The fully qualified name of the specified component, or null if the component has no name.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ComponentModel.Component" /> to find the name for.</param>
       </Docs>
@@ -1702,7 +1810,6 @@
         <Parameter Name="component" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The properties for a component can differ from the properties of a class, because the site can add or remove properties if the component is sited.</para>
@@ -1713,6 +1820,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the collection of properties for a specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> with the properties for the specified component.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />A component to get the properties for. </param>
       </Docs>
@@ -1733,7 +1844,6 @@
         <Parameter Name="componentType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this version of this method only when you do not have an instance of the object.</para>
@@ -1744,6 +1854,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the collection of properties for a specified type of component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> with the properties for a specified type of component.</para>
+        </returns>
         <param name="componentType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that represents the component to get properties for.</param>
       </Docs>
@@ -1765,7 +1879,6 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The properties for the <paramref name="component" /> parameter can differ from the properties of a class, because the site can add or remove properties if the <paramref name="component" /> parameter is sited.</para>
@@ -1791,6 +1904,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the collection of properties for a specified component using a specified array of attributes as a filter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> with the properties that match the specified attributes for the specified component.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />A component to get the properties for. </param>
         <param name="attributes">
@@ -1819,7 +1936,6 @@
         <Parameter Name="noCustomTypeDesc" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The properties for the <paramref name="component" /> parameter can differ from the properties of a class, because the site can add or remove properties if the <paramref name="component" /> parameter is sited.</para>
@@ -1830,6 +1946,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the collection of properties for a specified component using the default type descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> with the properties for a specified component.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />A component to get the properties for. </param>
         <param name="noCustomTypeDesc">
@@ -1853,7 +1973,6 @@
         <Parameter Name="attributes" Type="System.Attribute[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this version of this method only when you do not have an instance of the object.</para>
@@ -1879,6 +1998,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the collection of properties for a specified type of component using a specified array of attributes as a filter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> with the properties that match the specified attributes for this type of component.</para>
+        </returns>
         <param name="componentType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the target component.</param>
         <param name="attributes">
@@ -1903,7 +2026,6 @@
         <Parameter Name="noCustomTypeDesc" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyDescriptorCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The properties for a <paramref name="component" /> can differ from the properties of a class, because the site can add or remove properties if the <paramref name="component" /> is sited.</para>
@@ -1929,6 +2051,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the collection of properties for a specified component using a specified array of attributes as a filter and using a custom type descriptor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.PropertyDescriptorCollection" /> with the events that match the specified attributes for the specified component.</para>
+        </returns>
         <param name="component">
           <attribution license="cc4" from="Microsoft" modified="false" />A component to get the properties for. </param>
         <param name="attributes">
@@ -1957,7 +2083,6 @@
         <Parameter Name="instance" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.ComponentModel.TypeDescriptor.GetProvider" /> method will always return a type description provider. Even the default <see cref="T:System.ComponentModel.TypeDescriptor" /> implementation is built on a <see cref="T:System.ComponentModel.TypeDescriptionProvider" />.</para>
@@ -1966,6 +2091,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the type description provider for the specified component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeDescriptionProvider" /> associated with the specified component.</para>
+        </returns>
         <param name="instance">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of the target component.</param>
       </Docs>
@@ -1990,7 +2119,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.ComponentModel.TypeDescriptor.GetProvider" /> method will always return a type description provider. Even the default <see cref="T:System.ComponentModel.TypeDescriptor" /> implementation is built on a <see cref="T:System.ComponentModel.TypeDescriptionProvider" />.</para>
@@ -1999,6 +2127,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the type description provider for the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeDescriptionProvider" /> associated with the specified type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the target component.</param>
       </Docs>
@@ -2023,7 +2155,6 @@
         <Parameter Name="instance" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.ComponentModel.TypeDescriptor.GetReflectionType" /> method is a low-level version of the <see cref="Overload:System.ComponentModel.TypeDescriptionProvider.GetTypeDescriptor" /> method. <see cref="Overload:System.ComponentModel.TypeDescriptor.GetReflectionType" /> is typically used to perform standard reflection against an object when no custom type descriptor can be located for it.</para>
@@ -2032,6 +2163,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Type" /> that can be used to perform reflection, given an object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> for the specified object.</para>
+        </returns>
         <param name="instance">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of the target component.</param>
       </Docs>
@@ -2056,7 +2191,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.ComponentModel.TypeDescriptor.GetReflectionType" /> method is a low-level version of the <see cref="Overload:System.ComponentModel.TypeDescriptionProvider.GetTypeDescriptor" /> method. <see cref="Overload:System.ComponentModel.TypeDescriptor.GetReflectionType" /> is typically used to perform standard reflection against a class when no custom type descriptor can be located for it.</para>
@@ -2065,6 +2199,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Type" /> that can be used to perform reflection, given a class type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> of the specified class.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the target component.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.ComponentModel/TypeListConverter.xml b/mcs/class/System/Documentation/en/System.ComponentModel/TypeListConverter.xml
index 14056041e7b..f68ff9b4510 100644
--- a/mcs/class/System/Documentation/en/System.ComponentModel/TypeListConverter.xml
+++ b/mcs/class/System/Documentation/en/System.ComponentModel/TypeListConverter.xml
@@ -73,12 +73,15 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this converter can convert the specified <see cref="T:System.Type" /> of the source object using the given context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
         <param name="sourceType">
@@ -102,7 +105,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -111,6 +113,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this converter can convert an object to the given destination type using the context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="destinationType">
@@ -135,12 +141,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object to the native type of the converter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
@@ -168,7 +177,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method most commonly converts types to and from string objects.</para>
@@ -178,6 +186,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given value object to the specified destination type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted <paramref name="value" />.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
         <param name="culture">
@@ -204,7 +216,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TypeConverter+StandardValuesCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -213,6 +224,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of standard values for the data type this validator is designed for.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> that holds a standard set of valid values, or null if the data type does not support a standard set of values.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
@@ -233,7 +248,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -243,6 +257,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the list of standard values returned from the <see cref="M:System.ComponentModel.TypeListConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> method is an exclusive list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true because the <see cref="T:System.ComponentModel.TypeConverter.StandardValuesCollection" /> returned from <see cref="M:System.ComponentModel.TypeListConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> is an exhaustive list of possible values. This method never returns false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
@@ -263,7 +281,6 @@
         <Parameter Name="context" Type="System.ComponentModel.ITypeDescriptorContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="context" /> parameter can be used to extract additional information about the environment this converter is being invoked from. This can be null, so always check. Also, properties on the context object can return null.</para>
@@ -272,6 +289,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this object supports a standard set of values that can be picked from a list using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true because <see cref="M:System.ComponentModel.TypeListConverter.GetStandardValues(System.ComponentModel.ITypeDescriptorContext)" /> should be called to find a common set of values the object supports. This method never returns false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Configuration/AppSettingsReader.xml b/mcs/class/System/Documentation/en/System.Configuration/AppSettingsReader.xml
index 659c8f65825..13ba799865b 100644
--- a/mcs/class/System/Documentation/en/System.Configuration/AppSettingsReader.xml
+++ b/mcs/class/System/Documentation/en/System.Configuration/AppSettingsReader.xml
@@ -59,12 +59,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value for a specified key from the <see cref="P:System.Configuration.ConfigurationSettings.AppSettings" /> property and returns an object of the specified type containing the value from the configuration.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified key.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key for which to get the value.</param>
         <param name="type">
diff --git a/mcs/class/System/Documentation/en/System.Configuration/ApplicationSettingsBase.xml b/mcs/class/System/Documentation/en/System.Configuration/ApplicationSettingsBase.xml
index 50a1eb89bb3..457d47defcb 100644
--- a/mcs/class/System/Documentation/en/System.Configuration/ApplicationSettingsBase.xml
+++ b/mcs/class/System/Documentation/en/System.Configuration/ApplicationSettingsBase.xml
@@ -228,7 +228,6 @@
         <Parameter Name="propertyName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -238,6 +237,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the named settings property for the previous version of the same application.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> containing the value of the specified <see cref="T:System.Configuration.SettingsProperty" /> if found; otherwise, null.</para>
+        </returns>
         <param name="propertyName">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> containing the name of the settings property whose value is to be returned.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Configuration/ConfigXmlDocument.xml b/mcs/class/System/Documentation/en/System.Configuration/ConfigXmlDocument.xml
index b16ce39ec4b..c8039fcfe18 100644
--- a/mcs/class/System/Documentation/en/System.Configuration/ConfigXmlDocument.xml
+++ b/mcs/class/System/Documentation/en/System.Configuration/ConfigXmlDocument.xml
@@ -70,12 +70,15 @@
         <Parameter Name="namespaceUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Xml.XmlAttribute'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a configuration element attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="P:System.Xml.Serialization.XmlAttributes.XmlAttribute" /> attribute.</para>
+        </returns>
         <param name="prefix">
           <attribution license="cc4" from="Microsoft" modified="false" />The prefix definition.</param>
         <param name="localName">
@@ -100,12 +103,15 @@
         <Parameter Name="data" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Xml.XmlCDataSection'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML CData section.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.XmlCDataSection" /> value.</para>
+        </returns>
         <param name="data">
           <attribution license="cc4" from="Microsoft" modified="false" />The data to use.</param>
       </Docs>
@@ -127,12 +133,15 @@
       </Parameters>
       <Docs>
         <param name="comment">To be added: an object of type 'string'</param>
-        <returns>To be added: an object of type 'Xml.XmlComment'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Create an XML comment.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.XmlComment" /> value.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateElement">
@@ -153,12 +162,15 @@
         <Parameter Name="namespaceUri" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Xml.XmlElement'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a configuration element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.XmlElement" /> value.</para>
+        </returns>
         <param name="prefix">
           <attribution license="cc4" from="Microsoft" modified="false" />The prefix definition.</param>
         <param name="localName">
@@ -183,12 +195,15 @@
         <Parameter Name="data" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Xml.XmlSignificantWhitespace'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates white spaces.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.XmlSignificantWhitespace" /> value.</para>
+        </returns>
         <param name="data">
           <attribution license="cc4" from="Microsoft" modified="false" />The data to use.</param>
       </Docs>
@@ -209,12 +224,15 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Xml.XmlText'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Create a text node.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.XmlText" /> value.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to use.</param>
       </Docs>
@@ -235,12 +253,15 @@
         <Parameter Name="data" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Xml.XmlWhitespace'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates white space.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Xml.XmlWhitespace" /> value.</para>
+        </returns>
         <param name="data">
           <attribution license="cc4" from="Microsoft" modified="false" />The data to use.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Configuration/ConfigurationException.xml b/mcs/class/System/Documentation/en/System.Configuration/ConfigurationException.xml
index bc59cc1541e..ce41b347d3d 100644
--- a/mcs/class/System/Documentation/en/System.Configuration/ConfigurationException.xml
+++ b/mcs/class/System/Documentation/en/System.Configuration/ConfigurationException.xml
@@ -372,12 +372,15 @@
         <Parameter Name="node" Type="System.Xml.XmlNode" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the path to the configuration file from which the internal <see cref="T:System.Xml.XmlNode" /> object was loaded when this configuration exception was thrown.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representing the node file name.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlNode" /> that caused this <see cref="T:System.Configuration.ConfigurationException" /> exception to be thrown.</param>
       </Docs>
@@ -403,12 +406,15 @@
         <Parameter Name="node" Type="System.Xml.XmlNode" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the line number within the configuration file that the internal <see cref="T:System.Xml.XmlNode" /> object represented when this configuration exception was thrown.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An int representing the node line number.</para>
+        </returns>
         <param name="node">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlNode" /> that caused this <see cref="T:System.Configuration.ConfigurationException" /> exception to be thrown.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Configuration/ConfigurationSettings.xml b/mcs/class/System/Documentation/en/System.Configuration/ConfigurationSettings.xml
index 1267053eac2..f9599b71c18 100644
--- a/mcs/class/System/Documentation/en/System.Configuration/ConfigurationSettings.xml
+++ b/mcs/class/System/Documentation/en/System.Configuration/ConfigurationSettings.xml
@@ -83,7 +83,6 @@
         <Parameter Name="sectionName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>The configuration settings for the specified section.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is deprecated and is maintained for backward compatibility. Please use the GetSection method instead.</para>
@@ -92,6 +91,13 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Configuration.ConfigurationSection" /> object for the passed configuration section name and path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Configuration.ConfigurationSection" /> object for the passed configuration section name and path.</para>
+          <block subset="none" type="note">
+            <para>The <see cref="T:System.Configuration.ConfigurationSettings" /> class provides backward compatibility only. You should use the <see cref="T:System.Configuration.ConfigurationManager" /> class or <see cref="T:System.Web.Configuration.WebConfigurationManager" /> class instead.</para>
+          </block>
+        </returns>
         <param name="sectionName">
           <attribution license="cc4" from="Microsoft" modified="false" />A configuration name and path, such as "system.net/settings".</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Configuration/DictionarySectionHandler.xml b/mcs/class/System/Documentation/en/System.Configuration/DictionarySectionHandler.xml
index a520d436048..f17f0d8e1b0 100644
--- a/mcs/class/System/Documentation/en/System.Configuration/DictionarySectionHandler.xml
+++ b/mcs/class/System/Documentation/en/System.Configuration/DictionarySectionHandler.xml
@@ -67,7 +67,6 @@
         <Parameter Name="section" Type="System.Xml.XmlNode" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="parent" /> object parameter acts as the configuration settings in the corresponding parent configuration section. The <paramref name="context" /> object parameter is the virtual path for which the configuration section handler computes configuration values. Normally this parameter is reserved and is null.  The <paramref name="section" /> parameter is the <see cref="T:System.Xml.XmlNode" /> that contains the configuration information to be handled. The <paramref name="section" /> parameter provides direct access to the XML contents of the configuration section.</para>
@@ -76,6 +75,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new configuration handler and adds it to the section-handler collection based on the specified parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A configuration object.</para>
+        </returns>
         <param name="parent">
           <attribution license="cc4" from="Microsoft" modified="false" />Parent object.</param>
         <param name="context">
diff --git a/mcs/class/System/Documentation/en/System.Configuration/IApplicationSettingsProvider.xml b/mcs/class/System/Documentation/en/System.Configuration/IApplicationSettingsProvider.xml
index 6c73ba60269..6810b030309 100644
--- a/mcs/class/System/Documentation/en/System.Configuration/IApplicationSettingsProvider.xml
+++ b/mcs/class/System/Documentation/en/System.Configuration/IApplicationSettingsProvider.xml
@@ -51,7 +51,6 @@
         <Parameter Name="property" Type="System.Configuration.SettingsProperty" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -61,6 +60,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified settings property for the previous version of the same application.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Configuration.SettingsPropertyValue" /> containing the value of the specified property setting as it was last set in the previous version of the application; or null if the setting cannot be found.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Configuration.SettingsContext" /> describing the current application usage.</param>
         <param name="property">
diff --git a/mcs/class/System/Documentation/en/System.Configuration/IConfigurationSectionHandler.xml b/mcs/class/System/Documentation/en/System.Configuration/IConfigurationSectionHandler.xml
index 8db1206f7d9..a0bc3e65fa1 100644
--- a/mcs/class/System/Documentation/en/System.Configuration/IConfigurationSectionHandler.xml
+++ b/mcs/class/System/Documentation/en/System.Configuration/IConfigurationSectionHandler.xml
@@ -44,7 +44,6 @@
         <Parameter Name="section" Type="System.Xml.XmlNode" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Instances of the <see cref="T:System.Configuration.IConfigurationSectionHandler" /> class must be thread safe and stateless. The <see cref="M:System.Configuration.IConfigurationSectionHandler.Create(System.Object,System.Object,System.Xml.XmlNode)" /> method must be callable from multiple threads simultaneously.</para>
@@ -54,6 +53,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a configuration section handler.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created section handler object.</para>
+        </returns>
         <param name="parent">
           <attribution license="cc4" from="Microsoft" modified="false" />Parent object.</param>
         <param name="configContext">
diff --git a/mcs/class/System/Documentation/en/System.Configuration/IConfigurationSystem.xml b/mcs/class/System/Documentation/en/System.Configuration/IConfigurationSystem.xml
index f44c2e9ed11..62a10f5c10c 100644
--- a/mcs/class/System/Documentation/en/System.Configuration/IConfigurationSystem.xml
+++ b/mcs/class/System/Documentation/en/System.Configuration/IConfigurationSystem.xml
@@ -41,12 +41,15 @@
         <Parameter Name="configKey" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the specified configuration.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object representing the configuration.</para>
+        </returns>
         <param name="configKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The configuration key.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Configuration/ISettingsProviderService.xml b/mcs/class/System/Documentation/en/System.Configuration/ISettingsProviderService.xml
index 441489739c8..9bfbf4d25d3 100644
--- a/mcs/class/System/Documentation/en/System.Configuration/ISettingsProviderService.xml
+++ b/mcs/class/System/Documentation/en/System.Configuration/ISettingsProviderService.xml
@@ -37,7 +37,6 @@
         <Parameter Name="property" Type="System.Configuration.SettingsProperty" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -47,6 +46,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the settings provider compatible with the specified settings property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If found, the <see cref="T:System.Configuration.SettingsProvider" /> that can persist the specified settings property; otherwise, null.</para>
+        </returns>
         <param name="property">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Configuration.SettingsProperty" /> that requires serialization.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Configuration/IgnoreSectionHandler.xml b/mcs/class/System/Documentation/en/System.Configuration/IgnoreSectionHandler.xml
index edb695ee5d9..4023288ee28 100644
--- a/mcs/class/System/Documentation/en/System.Configuration/IgnoreSectionHandler.xml
+++ b/mcs/class/System/Documentation/en/System.Configuration/IgnoreSectionHandler.xml
@@ -69,12 +69,15 @@
         <Parameter Name="section" Type="System.Xml.XmlNode" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new configuration handler and adds the specified configuration object to the section-handler collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created configuration handler object.</para>
+        </returns>
         <param name="parent">
           <attribution license="cc4" from="Microsoft" modified="false" />The configuration settings in a corresponding parent configuration section. </param>
         <param name="configContext">
diff --git a/mcs/class/System/Documentation/en/System.Configuration/LocalFileSettingsProvider.xml b/mcs/class/System/Documentation/en/System.Configuration/LocalFileSettingsProvider.xml
index d5ec574038c..9360a0377ec 100644
--- a/mcs/class/System/Documentation/en/System.Configuration/LocalFileSettingsProvider.xml
+++ b/mcs/class/System/Documentation/en/System.Configuration/LocalFileSettingsProvider.xml
@@ -98,7 +98,6 @@
         <Parameter Name="property" Type="System.Configuration.SettingsProperty" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -108,6 +107,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the named settings property for the previous version of the same application. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Configuration.SettingsPropertyValue" /> representing the application setting if found; otherwise, null.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Configuration.SettingsContext" /> that describes where the application settings property is used.</param>
         <param name="property">
@@ -135,7 +138,6 @@
         <Parameter Name="properties" Type="System.Configuration.SettingsPropertyCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -149,6 +151,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the collection of setting property values for the specified application instance and settings property group.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Configuration.SettingsPropertyValueCollection" /> containing the values for the specified settings property group.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Configuration.SettingsContext" /> describing the current application usage.</param>
         <param name="properties">
diff --git a/mcs/class/System/Documentation/en/System.Configuration/NameValueFileSectionHandler.xml b/mcs/class/System/Documentation/en/System.Configuration/NameValueFileSectionHandler.xml
index fb9e74d8e28..c3f6458b603 100644
--- a/mcs/class/System/Documentation/en/System.Configuration/NameValueFileSectionHandler.xml
+++ b/mcs/class/System/Documentation/en/System.Configuration/NameValueFileSectionHandler.xml
@@ -67,7 +67,6 @@
         <Parameter Name="section" Type="System.Xml.XmlNode" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="parent" /> object parameter acts as the configuration settings in the corresponding parent configuration section. The <paramref name="configContext" /> object parameter is the virtual path for which the configuration section handler computes configuration values. Normally this parameter is reserved and is null. The <paramref name="section" /> parameter is the <see cref="T:System.Xml.XmlNode" /> that contains the configuration information to be handled. The <paramref name="section" /> parameter provides direct access to the XML contents of the configuration section.</para>
@@ -76,6 +75,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new configuration handler and adds it to the section-handler collection based on the specified parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A configuration object.</para>
+        </returns>
         <param name="parent">
           <attribution license="cc4" from="Microsoft" modified="false" />The parent object.</param>
         <param name="configContext">
diff --git a/mcs/class/System/Documentation/en/System.Configuration/NameValueSectionHandler.xml b/mcs/class/System/Documentation/en/System.Configuration/NameValueSectionHandler.xml
index 708f1604a48..8654a2eb167 100644
--- a/mcs/class/System/Documentation/en/System.Configuration/NameValueSectionHandler.xml
+++ b/mcs/class/System/Documentation/en/System.Configuration/NameValueSectionHandler.xml
@@ -67,7 +67,6 @@
         <Parameter Name="section" Type="System.Xml.XmlNode" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="parent" /> object parameter acts as the configuration settings in the corresponding parent configuration section. The <paramref name="context" /> object parameter is the virtual path for which the configuration section handler computes configuration values. Normally this parameter is reserved and is null. The <paramref name="section" /> parameter is the <see cref="T:System.Xml.XmlNode" /> object that contains the configuration information to be handled. The <paramref name="section" /> parameter provides direct access to the XML contents of the configuration section.</para>
@@ -76,6 +75,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new configuration handler and adds it to the section-handler collection based on the specified parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A configuration object.</para>
+        </returns>
         <param name="parent">
           <attribution license="cc4" from="Microsoft" modified="false" />Parent object.</param>
         <param name="context">
diff --git a/mcs/class/System/Documentation/en/System.Configuration/SettingElement.xml b/mcs/class/System/Documentation/en/System.Configuration/SettingElement.xml
index c0f47b8a638..b9b27f66691 100644
--- a/mcs/class/System/Documentation/en/System.Configuration/SettingElement.xml
+++ b/mcs/class/System/Documentation/en/System.Configuration/SettingElement.xml
@@ -82,13 +82,16 @@
       </Parameters>
       <Docs>
         <param name="o">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current <see cref="T:System.Configuration.SettingElement" /> instance to the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Configuration.SettingElement" /> instance is equal to the specified object; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -104,13 +107,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a unique value representing the <see cref="T:System.Configuration.SettingElement" /> current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A unique value representing the <see cref="T:System.Configuration.SettingElement" /> current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Name">
diff --git a/mcs/class/System/Documentation/en/System.Configuration/SettingElementCollection.xml b/mcs/class/System/Documentation/en/System.Configuration/SettingElementCollection.xml
index 35ba86b4f9c..91982dfcc54 100644
--- a/mcs/class/System/Documentation/en/System.Configuration/SettingElementCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Configuration/SettingElementCollection.xml
@@ -160,13 +160,16 @@
         <Parameter Name="elementKey" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Configuration.SettingElement" /> object from the collection. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Configuration.SettingElement" /> object.</para>
+        </returns>
         <param name="elementKey">
           <attribution license="cc4" from="Microsoft" modified="false" />A string value representing the <see cref="T:System.Configuration.SettingElement" /> object in the collection.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Configuration/SettingValueElement.xml b/mcs/class/System/Documentation/en/System.Configuration/SettingValueElement.xml
index a68f580a1a2..dde4bc8100f 100644
--- a/mcs/class/System/Documentation/en/System.Configuration/SettingValueElement.xml
+++ b/mcs/class/System/Documentation/en/System.Configuration/SettingValueElement.xml
@@ -86,13 +86,16 @@
         <Parameter Name="settingValue" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current <see cref="T:System.Configuration.SettingValueElement" /> instance to the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Configuration.SettingValueElement" /> instance is equal to the specified object; otherwise, false.</para>
+        </returns>
         <param name="settingValue">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare.</param>
       </Docs>
@@ -110,13 +113,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a unique value representing the <see cref="T:System.Configuration.SettingValueElement" /> current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A unique value representing the <see cref="T:System.Configuration.SettingValueElement" /> current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsModified">
diff --git a/mcs/class/System/Documentation/en/System.Configuration/SettingsBase.xml b/mcs/class/System/Documentation/en/System.Configuration/SettingsBase.xml
index 4b38f5baf7d..4d6cad1d4d6 100644
--- a/mcs/class/System/Documentation/en/System.Configuration/SettingsBase.xml
+++ b/mcs/class/System/Documentation/en/System.Configuration/SettingsBase.xml
@@ -253,7 +253,6 @@
         <Parameter Name="settingsBase" Type="System.Configuration.SettingsBase" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -263,6 +262,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides a <see cref="T:System.Configuration.SettingsBase" /> class that is synchronized (thread safe).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Configuration.SettingsBase" /> class that is synchronized.</para>
+        </returns>
         <param name="settingsBase">
           <attribution license="cc4" from="Microsoft" modified="false" />The class used to support user property settings.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Configuration/SettingsPropertyCollection.xml b/mcs/class/System/Documentation/en/System.Configuration/SettingsPropertyCollection.xml
index 0ec872c2c38..c97fa0ec3cd 100644
--- a/mcs/class/System/Documentation/en/System.Configuration/SettingsPropertyCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Configuration/SettingsPropertyCollection.xml
@@ -107,13 +107,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the existing collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Configuration.SettingsPropertyCollection" /> class.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CopyTo">
@@ -178,13 +181,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Collections.IEnumerator" /> object as it applies to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Collections.IEnumerator" /> object as it applies to the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsSynchronized">
diff --git a/mcs/class/System/Documentation/en/System.Configuration/SettingsPropertyValueCollection.xml b/mcs/class/System/Documentation/en/System.Configuration/SettingsPropertyValueCollection.xml
index b502aa0c847..eaf273a2676 100644
--- a/mcs/class/System/Documentation/en/System.Configuration/SettingsPropertyValueCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Configuration/SettingsPropertyValueCollection.xml
@@ -104,13 +104,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the existing collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Configuration.SettingsPropertyValueCollection" /> class.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CopyTo">
@@ -175,13 +178,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Collections.IEnumerator" /> object as it applies to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Collections.IEnumerator" /> object as it applies to the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsSynchronized">
diff --git a/mcs/class/System/Documentation/en/System.Configuration/SettingsProvider.xml b/mcs/class/System/Documentation/en/System.Configuration/SettingsProvider.xml
index b796b9804fb..f06cbbcf97d 100644
--- a/mcs/class/System/Documentation/en/System.Configuration/SettingsProvider.xml
+++ b/mcs/class/System/Documentation/en/System.Configuration/SettingsProvider.xml
@@ -108,7 +108,6 @@
         <Parameter Name="collection" Type="System.Configuration.SettingsPropertyCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -118,6 +117,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the collection of settings property values for the specified application instance and settings property group.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Configuration.SettingsPropertyValueCollection" /> containing the values for the specified settings property group.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Configuration.SettingsContext" /> describing the current application use.</param>
         <param name="collection">
diff --git a/mcs/class/System/Documentation/en/System.Configuration/SingleTagSectionHandler.xml b/mcs/class/System/Documentation/en/System.Configuration/SingleTagSectionHandler.xml
index 2f8c15a4612..230b79fc33b 100644
--- a/mcs/class/System/Documentation/en/System.Configuration/SingleTagSectionHandler.xml
+++ b/mcs/class/System/Documentation/en/System.Configuration/SingleTagSectionHandler.xml
@@ -64,12 +64,15 @@
         <Parameter Name="section" Type="System.Xml.XmlNode" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used internally to create a new instance of this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created object handler.</para>
+        </returns>
         <param name="parent">
           <attribution license="cc4" from="Microsoft" modified="false" />The parent of this object.</param>
         <param name="context">
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/CounterCreationDataCollection.xml b/mcs/class/System/Documentation/en/System.Diagnostics/CounterCreationDataCollection.xml
index fa267bd3945..b45bb74ef09 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/CounterCreationDataCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/CounterCreationDataCollection.xml
@@ -105,12 +105,15 @@
         <Parameter Name="value" Type="System.Diagnostics.CounterCreationData" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an instance of the <see cref="T:System.Diagnostics.CounterCreationData" /> class to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the new <see cref="T:System.Diagnostics.CounterCreationData" /> object.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Diagnostics.CounterCreationData" /> object to append to the existing collection. </param>
       </Docs>
@@ -181,12 +184,15 @@
         <Parameter Name="value" Type="System.Diagnostics.CounterCreationData" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a <see cref="T:System.Diagnostics.CounterCreationData" /> instance exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Diagnostics.CounterCreationData" /> object exists in the collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Diagnostics.CounterCreationData" /> object to find in the collection. </param>
       </Docs>
@@ -235,12 +241,15 @@
         <Parameter Name="value" Type="System.Diagnostics.CounterCreationData" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of a <see cref="T:System.Diagnostics.CounterCreationData" /> object in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the specified <see cref="T:System.Diagnostics.CounterCreationData" />, if it is found, in the collection; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Diagnostics.CounterCreationData" /> object to locate in the collection. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/CounterSample.xml b/mcs/class/System/Documentation/en/System.Diagnostics/CounterSample.xml
index 0456f351344..b2e82336ffd 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/CounterSample.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/CounterSample.xml
@@ -151,12 +151,15 @@
         <Parameter Name="counterSample" Type="System.Diagnostics.CounterSample" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'float'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the performance data of the counter, using a single sample point. This method is generally used for uncalculated performance counter types.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The calculated performance value.</para>
+        </returns>
         <param name="counterSample">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Diagnostics.CounterSample" /> structure to use as a base point for calculating performance data. </param>
       </Docs>
@@ -178,12 +181,15 @@
         <Parameter Name="nextCounterSample" Type="System.Diagnostics.CounterSample" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'float'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the performance data of the counter, using two sample points. This method is generally used for calculated performance counter types, such as averages.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The calculated performance value.</para>
+        </returns>
         <param name="counterSample">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Diagnostics.CounterSample" /> structure to use as a base point for calculating performance data. </param>
         <param name="nextCounterSample">
@@ -290,7 +296,6 @@
       </Parameters>
       <Docs>
         <param name="other">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Two <see cref="T:System.Diagnostics.CounterSample" /> structures are equal if they have identical property values.</para>
@@ -299,6 +304,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified <see cref="T:System.Diagnostics.CounterSample" /> structure is equal to the current <see cref="T:System.Diagnostics.CounterSample" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="sample" /> is equal to the current instance; otherwise, false. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Equals">
@@ -317,7 +326,6 @@
       </Parameters>
       <Docs>
         <param name="obj">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Two <see cref="T:System.Diagnostics.CounterSample" /> structures are equal if they have identical property values.</para>
@@ -326,6 +334,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified structure is a <see cref="T:System.Diagnostics.CounterSample" /> structure and is identical to the current <see cref="T:System.Diagnostics.CounterSample" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="o" /> is a <see cref="T:System.Diagnostics.CounterSample" /> structure and is identical to the current instance; otherwise, false. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -341,12 +353,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a hash code for the current counter sample.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current counter sample.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="op_Equality">
@@ -367,7 +382,6 @@
       <Docs>
         <param name="obj1">To be added.</param>
         <param name="obj2">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Two <see cref="T:System.Diagnostics.CounterSample" /> structures are equal if they have identical property values.</para>
@@ -376,6 +390,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether two <see cref="T:System.Diagnostics.CounterSample" /> structures are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> and <paramref name="b" /> are equal; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="op_Inequality">
@@ -396,7 +414,6 @@
       <Docs>
         <param name="obj1">To be added.</param>
         <param name="obj2">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Two <see cref="T:System.Diagnostics.CounterSample" /> structures are not equal if any of their property values are different.</para>
@@ -405,6 +422,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether two <see cref="T:System.Diagnostics.CounterSample" /> structures are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> and <paramref name="b" /> are not equal; otherwise, false</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="RawValue">
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/CounterSampleCalculator.xml b/mcs/class/System/Documentation/en/System.Diagnostics/CounterSampleCalculator.xml
index 3739e34baae..e7d1997d2f3 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/CounterSampleCalculator.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/CounterSampleCalculator.xml
@@ -39,7 +39,6 @@
         <Parameter Name="newSample" Type="System.Diagnostics.CounterSample" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'float'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Diagnostics.CounterSampleCalculator.ComputeCounterValue(System.Diagnostics.CounterSample)" /> method overload returns meaningful results only for performance counters of the following <see cref="T:System.Diagnostics.PerformanceCounterType" />:</para>
@@ -75,6 +74,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the calculated value of a single raw counter sample.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A floating-point representation of the performance counter's calculated value.</para>
+        </returns>
         <param name="newSample">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Diagnostics.CounterSample" /> that indicates the most recent sample the system has taken. </param>
       </Docs>
@@ -101,12 +104,15 @@
         <Parameter Name="newSample" Type="System.Diagnostics.CounterSample" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'float'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the calculated value of two raw counter samples.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A floating-point representation of the performance counter's calculated value.</para>
+        </returns>
         <param name="oldSample">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Diagnostics.CounterSample" /> that indicates a previous sample the system has taken. </param>
         <param name="newSample">
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/DelimitedListTraceListener.xml b/mcs/class/System/Documentation/en/System.Diagnostics/DelimitedListTraceListener.xml
index 924da13e6db..e3726ccb09e 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/DelimitedListTraceListener.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/DelimitedListTraceListener.xml
@@ -257,7 +257,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A custom attribute is an attribute that is not inherited from the base class that can be used to set a property for the class. The custom attribute for <see cref="T:System.Diagnostics.DelimitedListTraceListener" /> is used to set the <see cref="P:System.Diagnostics.DelimitedListTraceListener.Delimiter" /> property. The following configuration file example shows the use of the delimiter attribute to set the <see cref="P:System.Diagnostics.DelimitedListTraceListener.Delimiter" /> property:</para>
@@ -280,6 +279,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the custom configuration file attribute supported by the delimited trace listener.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string array that contains the single value "delimiter".</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TraceData">
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/DiagnosticsConfigurationHandler.xml b/mcs/class/System/Documentation/en/System.Diagnostics/DiagnosticsConfigurationHandler.xml
index ed1f5816ac6..dbf5cdfecfc 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/DiagnosticsConfigurationHandler.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/DiagnosticsConfigurationHandler.xml
@@ -75,7 +75,6 @@
         <Parameter Name="section" Type="System.Xml.XmlNode" />
       </Parameters>
       <Docs>
-        <returns>An object implementing the <see cref="T:System.Collections.IDictionary" /> interface which contains the settings specified in the XML section <paramref name="section" />.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Diagnostics.DiagnosticsConfigurationHandler.Create(System.Object,System.Object,System.Xml.XmlNode)" /> method populates a <see cref="T:System.Collections.Hashtable" /> with the values obtained from the <format type="text/html"><a href="3f348f42-fa72-4ff2-aa1c-bb9eecad4bb2">&lt;system.diagnostics&gt; Element</a></format> section of a configuration file and returns the hashtable.</para>
@@ -84,6 +83,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Parses the configuration settings for the <format type="text/html"><a href="3f348f42-fa72-4ff2-aa1c-bb9eecad4bb2">&lt;system.diagnostics&gt; Element</a></format> section of configuration files.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new configuration object, in the form of a <see cref="T:System.Collections.Hashtable" />.</para>
+        </returns>
         <param name="parent">
           <attribution license="cc4" from="Microsoft" modified="false" />The object inherited from the parent path</param>
         <param name="configContext">
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/EventLog.xml b/mcs/class/System/Documentation/en/System.Diagnostics/EventLog.xml
index 471519eaf5e..8a07a040af8 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/EventLog.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/EventLog.xml
@@ -928,7 +928,6 @@
         <Parameter Name="logName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to determine if a log exists on the local computer. If you want to determine whether a source exists on the local computer, use <see cref="M:System.Diagnostics.EventLog.SourceExists(System.String)" />.</para>
@@ -941,6 +940,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the log exists on the local computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the log exists on the local computer; otherwise, false.</para>
+        </returns>
         <param name="logName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the log to search for. Possible values include: Application, Security, System, other application-specific logs (such as those associated with Active Directory), or any custom log on the computer. </param>
       </Docs>
@@ -967,7 +970,6 @@
         <Parameter Name="machineName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to determine if a log exists on a remote computer. If you want to determine whether a source exists on a remote computer, use <see cref="M:System.Diagnostics.EventLog.SourceExists(System.String)" />.</para>
@@ -980,6 +982,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the log exists on the specified computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the log exists on the specified computer; otherwise, false.</para>
+        </returns>
         <param name="logName">
           <attribution license="cc4" from="Microsoft" modified="false" />The log for which to search. Possible values include: Application, Security, System, other application-specific logs (such as those associated with Active Directory), or any custom log on the computer. </param>
         <param name="machineName">
@@ -1000,7 +1006,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'EventLog []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The array of <see cref="T:System.Diagnostics.EventLog" /> objects is a snapshot of all event logs on the local computer when the call to <see cref="M:System.Diagnostics.EventLog.GetEventLogs" /> is made. This is not a dynamic collection, so it does not reflect the deletion or creation of logs in real time. You should verify that a log in the array exists before you read or write to it. The array usually includes at least three logs: Application, System, and Security. If you created custom logs on the local computer, they will appear in the array as well.</para>
@@ -1010,6 +1015,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for all event logs on the local computer and creates an array of <see cref="T:System.Diagnostics.EventLog" /> objects that contain the list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Diagnostics.EventLog" /> that represents the logs on the local computer.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetEventLogs">
@@ -1033,7 +1042,6 @@
         <Parameter Name="machineName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'EventLog []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The array of <see cref="T:System.Diagnostics.EventLog" /> objects is a snapshot of all event logs on the computer specified by the <paramref name="machineName" /> parameter when the call to <see cref="M:System.Diagnostics.EventLog.GetEventLogs" /> is made. This is not a dynamic collection, so it does not reflect the deletion or creation of logs in real time. You should verify that a log in the array exists before you read or write to it. The array usually includes at least three logs: Application, System, and Security. If you created custom logs on the specified computer, they will appear in the array as well.</para>
@@ -1045,6 +1053,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for all event logs on the given computer and creates an array of <see cref="T:System.Diagnostics.EventLog" /> objects that contain the list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Diagnostics.EventLog" /> that represents the logs on the given computer.</para>
+        </returns>
         <param name="machineName">
           <attribution license="cc4" from="Microsoft" modified="false" />The computer on which to search for event logs. </param>
       </Docs>
@@ -1161,7 +1173,6 @@
         <Parameter Name="machineName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The event source indicates what logs the event. It is often the name of the application, or the name of a subcomponent of the application, if the application is large. Applications and services should write to the Application log or a custom log. Device drivers should write to the System log.</para>
@@ -1171,6 +1182,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the name of the log to which the specified source is registered.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the log associated with the specified source in the registry.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the event source. </param>
         <param name="machineName">
@@ -1503,7 +1518,6 @@
         <Parameter Name="source" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to determine whether an event source exists on the local computer. If you want to determine whether a log exists on the local computer, use <see cref="M:System.Diagnostics.EventLog.Exists(System.String)" />.</para>
@@ -1522,6 +1536,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether an event source is registered on the local computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the event source is registered on the local computer; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the event source. </param>
       </Docs>
@@ -1548,7 +1566,6 @@
         <Parameter Name="machineName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to determine whether an event source exists on the computer specified by the <paramref name="machineName" /> parameter. If you want to determine whether a log exists on the specified computer, use <see cref="M:System.Diagnostics.EventLog.Exists(System.String)" />.</para>
@@ -1570,6 +1587,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether an event source is registered on a specified computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the event source is registered on the given computer; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the event source. </param>
         <param name="machineName">
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/EventLogEntry.xml b/mcs/class/System/Documentation/en/System.Diagnostics/EventLogEntry.xml
index 4cd97464afc..f2235403431 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/EventLogEntry.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/EventLogEntry.xml
@@ -170,7 +170,6 @@
         <Parameter Name="otherEntry" Type="System.Diagnostics.EventLogEntry" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method performs a byte-by-byte comparison between the two objects. It does not determine whether the two <see cref="T:System.Diagnostics.EventLogEntry" /> instances refer to the same object.</para>
@@ -179,6 +178,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a comparison between two event log entries.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Diagnostics.EventLogEntry" /> objects are identical; otherwise, false.</para>
+        </returns>
         <param name="otherEntry">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Diagnostics.EventLogEntry" /> to compare. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/EventLogEntryCollection.xml b/mcs/class/System/Documentation/en/System.Diagnostics/EventLogEntryCollection.xml
index 86468f71498..a76cd952fa8 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/EventLogEntryCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/EventLogEntryCollection.xml
@@ -99,7 +99,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IEnumerator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The object that is returned by the <see cref="M:System.Diagnostics.EventLogEntryCollection.GetEnumerator" /> method is a wrapper for the <see cref="T:System.Diagnostics.EventLogEntryCollection" /> class that implements the <see cref="T:System.Collections.IEnumerator" /> enumerator.</para>
@@ -111,6 +110,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Supports a simple iteration over the <see cref="T:System.Diagnostics.EventLogEntryCollection" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that can be used to iterate over the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Item">
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/EventLogPermissionAttribute.xml b/mcs/class/System/Documentation/en/System.Diagnostics/EventLogPermissionAttribute.xml
index 41090357488..8e5aaae175e 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/EventLogPermissionAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/EventLogPermissionAttribute.xml
@@ -68,12 +68,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Security.IPermission'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the permission based on the <see cref="P:System.Diagnostics.EventLogPermissionAttribute.MachineName" /> property and the requested access levels that are set through the <see cref="P:System.Diagnostics.EventLogPermissionAttribute.PermissionAccess" /> property on the attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.IPermission" /> that represents the created permission.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MachineName">
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/EventLogPermissionEntryCollection.xml b/mcs/class/System/Documentation/en/System.Diagnostics/EventLogPermissionEntryCollection.xml
index 89080baaf2a..7e458ef365e 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/EventLogPermissionEntryCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/EventLogPermissionEntryCollection.xml
@@ -40,12 +40,15 @@
         <Parameter Name="value" Type="System.Diagnostics.EventLogPermissionEntry" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a specified <see cref="T:System.Diagnostics.EventLogPermissionEntry" /> to this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the added <see cref="T:System.Diagnostics.EventLogPermissionEntry" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Diagnostics.EventLogPermissionEntry" /> to add. </param>
       </Docs>
@@ -116,12 +119,15 @@
         <Parameter Name="value" Type="System.Diagnostics.EventLogPermissionEntry" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether this collection contains a specified <see cref="T:System.Diagnostics.EventLogPermissionEntry" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Diagnostics.EventLogPermissionEntry" /> belongs to this collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Diagnostics.EventLogPermissionEntry" /> to find. </param>
       </Docs>
@@ -170,12 +176,15 @@
         <Parameter Name="value" Type="System.Diagnostics.EventLogPermissionEntry" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of a specified permission entry in this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the specified permission entry, or -1 if the permission entry was not found in the collection.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The permission entry to search for. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/EventTypeFilter.xml b/mcs/class/System/Documentation/en/System.Diagnostics/EventTypeFilter.xml
index 516afad90b5..a5720fdf992 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/EventTypeFilter.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/EventTypeFilter.xml
@@ -103,7 +103,6 @@
         <Parameter Name="data" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the value of the <paramref name="eventType" /> parameter is greater than or equal to the value of the <see cref="P:System.Diagnostics.EventTypeFilter.EventType" /> property, the method returns true.</para>
@@ -112,6 +111,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the trace listener should trace the event. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>trueif the trace should be produced; otherwise, false.</para>
+        </returns>
         <param name="cache">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Diagnostics.TraceEventCache" /> that represents the information cache for the trace event.</param>
         <param name="source">
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/FileVersionInfo.xml b/mcs/class/System/Documentation/en/System.Diagnostics/FileVersionInfo.xml
index 42001a9705b..7e1f75e82e4 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/FileVersionInfo.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/FileVersionInfo.xml
@@ -344,12 +344,15 @@
         <Parameter Name="fileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'FileVersionInfo'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Diagnostics.FileVersionInfo" /> representing the version information associated with the specified file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Diagnostics.FileVersionInfo" /> containing information about the file. If the file did not contain version information, the <see cref="T:System.Diagnostics.FileVersionInfo" /> contains only the name of the file requested.</para>
+        </returns>
         <param name="fileName">
           <attribution license="cc4" from="Microsoft" modified="false" />The fully qualified path and name of the file to retrieve the version information for. </param>
       </Docs>
@@ -860,12 +863,20 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a partial list of properties in the <see cref="T:System.Diagnostics.FileVersionInfo" /> and their values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A list of the following properties in this class and their values: </para>
+          <para>
+            <see cref="P:System.Diagnostics.FileVersionInfo.FileName" />, <see cref="P:System.Diagnostics.FileVersionInfo.InternalName" />, <see cref="P:System.Diagnostics.FileVersionInfo.OriginalFilename" />, <see cref="P:System.Diagnostics.FileVersionInfo.FileVersion" />, <see cref="P:System.Diagnostics.FileVersionInfo.FileDescription" />, <see cref="P:System.Diagnostics.FileVersionInfo.ProductName" />, <see cref="P:System.Diagnostics.FileVersionInfo.ProductVersion" />, <see cref="P:System.Diagnostics.FileVersionInfo.IsDebug" />, <see cref="P:System.Diagnostics.FileVersionInfo.IsPatched" />, <see cref="P:System.Diagnostics.FileVersionInfo.IsPreRelease" />, <see cref="P:System.Diagnostics.FileVersionInfo.IsPrivateBuild" />, <see cref="P:System.Diagnostics.FileVersionInfo.IsSpecialBuild" />,</para>
+          <para>
+            <see cref="P:System.Diagnostics.FileVersionInfo.Language" />.</para>
+          <para>If the file did not contain version information, this list will contain only the name of the requested file. Boolean values will be false, and all other entries will be null.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/InstanceDataCollection.xml b/mcs/class/System/Documentation/en/System.Diagnostics/InstanceDataCollection.xml
index 732af7328f4..4f63a3591d6 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/InstanceDataCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/InstanceDataCollection.xml
@@ -71,7 +71,6 @@
         <Parameter Name="instanceName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="instanceName" /> parameter is case-insensitive.</para>
@@ -80,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a performance instance with a specified name (identified by one of the indexed <see cref="T:System.Diagnostics.InstanceData" /> objects) exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the instance exists in the collection; otherwise, false.</para>
+        </returns>
         <param name="instanceName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the instance to find in this collection. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/InstanceDataCollectionCollection.xml b/mcs/class/System/Documentation/en/System.Diagnostics/InstanceDataCollectionCollection.xml
index 0b178f26a56..f72fe50ca13 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/InstanceDataCollectionCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/InstanceDataCollectionCollection.xml
@@ -67,7 +67,6 @@
         <Parameter Name="counterName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="counterName" /> parameter is case-insensitive.</para>
@@ -77,6 +76,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether an instance data collection for the specified counter (identified by one of the indexed <see cref="T:System.Diagnostics.InstanceDataCollection" /> objects) exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if an instance data collection containing the specified counter exists in the collection; otherwise, false.</para>
+        </returns>
         <param name="counterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the performance counter. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/PerformanceCounter.xml b/mcs/class/System/Documentation/en/System.Diagnostics/PerformanceCounter.xml
index cd73592f549..22c7784732d 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/PerformanceCounter.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/PerformanceCounter.xml
@@ -624,7 +624,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can write only to custom counters. All system counters are read-only.</para>
@@ -639,6 +638,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decrements the associated performance counter by one through an efficient atomic operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The decremented counter value.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DefaultFileMappingSize">
@@ -726,7 +729,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can write only to custom counters. All system counters are read-only.</para>
@@ -742,6 +744,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Increments the associated performance counter by one through an efficient atomic operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The incremented counter value.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IncrementBy">
@@ -765,7 +771,6 @@
         <Parameter Name="value" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can write only to custom counters. All system counters are read-only.</para>
@@ -780,6 +785,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Increments or decrements the value of the associated performance counter by a specified amount through an efficient atomic operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new counter value.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to increment by. (A negative value decrements the counter.) </param>
       </Docs>
@@ -976,7 +985,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'CounterSample'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is generally used for counters that contain uncalculated values.</para>
@@ -993,6 +1001,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains a counter sample, and returns the raw, or uncalculated, value for it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Diagnostics.CounterSample" /> that represents the next raw value that the system obtains for this counter.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="NextValue">
@@ -1009,7 +1021,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'float'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1023,6 +1034,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains a counter sample and returns the calculated value for it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The next calculated value that the system obtains for this counter.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="RawValue">
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/PerformanceCounterCategory.xml b/mcs/class/System/Documentation/en/System.Diagnostics/PerformanceCounterCategory.xml
index 7ed322bbc48..e84ff3589b3 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/PerformanceCounterCategory.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/PerformanceCounterCategory.xml
@@ -197,7 +197,6 @@
         <Parameter Name="counterName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You must set the <see cref="P:System.Diagnostics.PerformanceCounterCategory.CategoryName" /> property before calling this method. Otherwise, an exception is thrown.</para>
@@ -212,6 +211,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified counter is registered to this category, which is indicated by the <see cref="P:System.Diagnostics.PerformanceCounterCategory.CategoryName" /> and <see cref="P:System.Diagnostics.PerformanceCounterCategory.MachineName" /> properties.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the counter is registered to the category that is specified by the <see cref="P:System.Diagnostics.PerformanceCounterCategory.CategoryName" /> and <see cref="P:System.Diagnostics.PerformanceCounterCategory.MachineName" /> properties; otherwise, false.</para>
+        </returns>
         <param name="counterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the performance counter to look for. </param>
       </Docs>
@@ -233,7 +236,6 @@
         <Parameter Name="categoryName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -246,6 +248,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified counter is registered to the specified category on the local computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if the counter is registered to the specified category on the local computer; otherwise, false.</para>
+        </returns>
         <param name="counterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the performance counter to look for. </param>
         <param name="categoryName">
@@ -270,7 +276,6 @@
         <Parameter Name="machineName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -283,6 +288,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified counter is registered to the specified category on a remote computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if the counter is registered to the specified category on the specified computer; otherwise, false.</para>
+        </returns>
         <param name="counterName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the performance counter to look for. </param>
         <param name="categoryName">
@@ -314,7 +323,6 @@
         <Parameter Name="counterData" Type="System.Diagnostics.CounterCreationDataCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PerformanceCounterCategory'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -327,6 +335,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Registers the custom performance counter category containing the specified counters on the local computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Diagnostics.PerformanceCounterCategory" /> that is associated with the new custom category, or performance object.</para>
+        </returns>
         <param name="categoryName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the custom performance counter category to create and register with the system. </param>
         <param name="categoryHelp">
@@ -353,7 +365,6 @@
         <Parameter Name="counterData" Type="System.Diagnostics.CounterCreationDataCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="categoryType" /> parameter specifies whether the performance counter category is single-instance or multi-instance. By default, a category is single-instance when it is created and becomes multi-instance when another instance is added. Categories are created when an application is set up, and instances are added at run time. In the  .NET Framework versions 1.0 and 1.1, it is not necessary to know if a performance counter category is multi-instance or single-instance. In the dnprdnext, the <see cref="T:System.Diagnostics.PerformanceCounterCategoryType" /> enumeration is used to indicate whether a performance counter can have multiple instances.</para>
@@ -371,6 +382,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Registers the custom performance counter category containing the specified counters on the local computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Diagnostics.PerformanceCounterCategory" /> that is associated with the new custom category, or performance object.</para>
+        </returns>
         <param name="categoryName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the custom performance counter category to create and register with the system.</param>
         <param name="categoryHelp">
@@ -405,7 +420,6 @@
         <Parameter Name="counterHelp" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PerformanceCounterCategory'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -418,6 +432,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Registers a custom performance counter category containing a single counter of type NumberOfItems32 on the local computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Diagnostics.PerformanceCounterCategory" /> that is associated with the new system category, or performance object.</para>
+        </returns>
         <param name="categoryName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the custom performance counter category to create and register with the system. </param>
         <param name="categoryHelp">
@@ -447,7 +465,6 @@
         <Parameter Name="counterHelp" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="categoryType" /> parameter specifies whether the performance counter category is single-instance or multi-instance. By default, a category is single-instance when it is created and becomes multi-instance when another instance is added. Categories are created when an application is set up, and instances are added at run time. In the .NET Framework versions 1.0 and 1.1, it is not necessary to know if a performance counter category is multi-instance or single-instance. In the dnprdnext, the <see cref="T:System.Diagnostics.PerformanceCounterCategoryType" /> enumeration is used to indicate whether a performance counter can have multiple instances.</para>
@@ -465,6 +482,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Registers the custom performance counter category containing a single counter of type <see cref="F:System.Diagnostics.PerformanceCounterType.NumberOfItems32" /> on the local computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Diagnostics.PerformanceCounterCategory" /> that is associated with the new system category, or performance object.</para>
+        </returns>
         <param name="categoryName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the custom performance counter category to create and register with the system.</param>
         <param name="categoryHelp">
@@ -526,7 +547,6 @@
         <Parameter Name="categoryName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use of the <see cref="M:System.Diagnostics.PerformanceCounterCategory.Exists(System.String)" /> method can result in a noticeable performance penalty while all performance counters on the machine are checked for availability. If you are only writing to a performance counter, you can avoid the global search for performance counters by creating the performance counter when the application is installed and assuming the category exists when accessing the counter. There is no way to avoid the performance counter search when reading from performance counters.</para>
@@ -540,6 +560,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the category is registered on the local computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the category is registered; otherwise, false.</para>
+        </returns>
         <param name="categoryName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the performance counter category to look for. </param>
       </Docs>
@@ -561,7 +585,6 @@
         <Parameter Name="machineName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use of the <see cref="M:System.Diagnostics.PerformanceCounterCategory.Exists(System.String,System.String)" /> method can result in a noticeable performance penalty while all performance counters on the machine are checked for availability. If you are only writing to a performance counter, you can avoid the global search for performance counters by creating the performance counter when the application is installed and assuming the category exists when accessing the counter. There is no way to avoid the performance counter search when reading from performance counters.</para>
@@ -575,6 +598,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the category is registered on the specified computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the category is registered; otherwise, false.</para>
+        </returns>
         <param name="categoryName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the performance counter category to look for. </param>
         <param name="machineName">
@@ -595,7 +622,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'PerformanceCounterCategory []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -608,6 +634,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a list of the performance counter categories that are registered on the local computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Diagnostics.PerformanceCounterCategory" /> objects indicating the categories that are registered on the local computer.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetCategories">
@@ -626,7 +656,6 @@
         <Parameter Name="machineName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PerformanceCounterCategory []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To retrieve the categories on the local computer, use another overload or pass "." as the <paramref name="machineName" /> parameter.</para>
@@ -640,6 +669,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a list of the performance counter categories that are registered on the specified computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Diagnostics.PerformanceCounterCategory" /> objects indicating the categories that are registered on the specified computer.</para>
+        </returns>
         <param name="machineName">
           <attribution license="cc4" from="Microsoft" modified="false" />The computer to look on. </param>
       </Docs>
@@ -658,7 +691,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'PerformanceCounter []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information about performance object instances, see the <see cref="T:System.Diagnostics.PerformanceCounter" /> class overview.</para>
@@ -672,6 +704,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a list of the counters in a performance counter category that contains exactly one instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Diagnostics.PerformanceCounter" /> objects indicating the counters that are associated with this single-instance performance counter category.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetCounters">
@@ -690,7 +726,6 @@
         <Parameter Name="instanceName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PerformanceCounter []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To represent a single-instance category, pass an empty string ("") for the <paramref name="instanceName" /> parameter.</para>
@@ -705,6 +740,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a list of the counters in a performance counter category that contains one or more instances.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Diagnostics.PerformanceCounter" /> objects indicating the counters that are associated with the specified object instance of this performance counter category.</para>
+        </returns>
         <param name="instanceName">
           <attribution license="cc4" from="Microsoft" modified="false" />The performance object instance for which to retrieve the list of associated counters. </param>
       </Docs>
@@ -723,7 +762,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -736,6 +774,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the list of performance object instances that are associated with this category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of strings representing the performance object instance names that are associated with this category or, if the category contains only one performance object instance, a single-entry array that contains an empty string ("").</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InstanceExists">
@@ -754,7 +796,6 @@
         <Parameter Name="instanceName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload of <see cref="M:System.Diagnostics.PerformanceCounterCategory.InstanceExists(System.String)" /> is not static. It requires you to create a <see cref="T:System.Diagnostics.PerformanceCounterCategory" /> object and to set the <see cref="P:System.Diagnostics.PerformanceCounterCategory.CategoryName" /> property.</para>
@@ -768,6 +809,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified performance object instance exists in the category that is identified by this <see cref="T:System.Diagnostics.PerformanceCounterCategory" /> object's <see cref="P:System.Diagnostics.PerformanceCounterCategory.CategoryName" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the category contains the specified performance object instance; otherwise, false.</para>
+        </returns>
         <param name="instanceName">
           <attribution license="cc4" from="Microsoft" modified="false" />The performance object instance in this performance counter category to search for. </param>
       </Docs>
@@ -789,7 +834,6 @@
         <Parameter Name="categoryName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>It is not possible to determine whether a performance object instance exists on a computer without specifying a specific category to look in.</para>
@@ -803,6 +847,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a specified category on the local computer contains the specified performance object instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the category contains the specified performance object instance; otherwise, false.</para>
+        </returns>
         <param name="instanceName">
           <attribution license="cc4" from="Microsoft" modified="false" />The performance object instance to search for. </param>
         <param name="categoryName">
@@ -827,7 +875,6 @@
         <Parameter Name="machineName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>It is not possible to determine whether a performance object instance exists on a computer without specifying a specific category to look in.</para>
@@ -842,6 +889,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a specified category on a specified computer contains the specified performance object instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the category contains the specified performance object instance; otherwise, false.</para>
+        </returns>
         <param name="instanceName">
           <attribution license="cc4" from="Microsoft" modified="false" />The performance object instance to search for. </param>
         <param name="categoryName">
@@ -892,7 +943,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'InstanceDataCollectionCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You must set the <see cref="P:System.Diagnostics.PerformanceCounterCategory.CategoryName" /> property before you call <see cref="M:System.Diagnostics.PerformanceCounterCategory.ReadCategory" />.</para>
@@ -907,6 +957,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads all the counter and performance object instance data that is associated with this performance counter category.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Diagnostics.InstanceDataCollectionCollection" /> that contains the counter and performance object instance data for the category.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/PerformanceCounterPermissionAttribute.xml b/mcs/class/System/Documentation/en/System.Diagnostics/PerformanceCounterPermissionAttribute.xml
index ee06a23beb0..2b3160ab4ca 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/PerformanceCounterPermissionAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/PerformanceCounterPermissionAttribute.xml
@@ -91,12 +91,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Security.IPermission'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the permission based on the requested access levels that are set through the <see cref="P:System.Diagnostics.PerformanceCounterPermissionAttribute.PermissionAccess" /> property on the attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.IPermission" /> that represents the created permission.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MachineName">
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/PerformanceCounterPermissionEntryCollection.xml b/mcs/class/System/Documentation/en/System.Diagnostics/PerformanceCounterPermissionEntryCollection.xml
index 6350ec67f54..5237b919450 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/PerformanceCounterPermissionEntryCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/PerformanceCounterPermissionEntryCollection.xml
@@ -40,12 +40,15 @@
         <Parameter Name="value" Type="System.Diagnostics.PerformanceCounterPermissionEntry" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a specified <see cref="T:System.Diagnostics.PerformanceCounterPermissionEntry" /> to this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the added <see cref="T:System.Diagnostics.PerformanceCounterPermissionEntry" /> object.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Diagnostics.PerformanceCounterPermissionEntry" /> object to add. </param>
       </Docs>
@@ -116,12 +119,15 @@
         <Parameter Name="value" Type="System.Diagnostics.PerformanceCounterPermissionEntry" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether this collection contains a specified <see cref="T:System.Diagnostics.PerformanceCounterPermissionEntry" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Diagnostics.PerformanceCounterPermissionEntry" /> object belongs to this collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Diagnostics.PerformanceCounterPermissionEntry" /> object to find. </param>
       </Docs>
@@ -170,12 +176,15 @@
         <Parameter Name="value" Type="System.Diagnostics.PerformanceCounterPermissionEntry" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of a specified permission entry in this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the specified permission entry, or -1 if the permission entry was not found in the collection.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The permission entry for which to search. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/Process.xml b/mcs/class/System/Documentation/en/System.Diagnostics/Process.xml
index c20641f3b4e..b3cf55201b7 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/Process.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/Process.xml
@@ -405,7 +405,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When a process is executing, its message loop is in a wait state. The message loop executes every time a Windows message is sent to the process by the operating system. Calling <see cref="M:System.Diagnostics.Process.CloseMainWindow" /> sends a request to close to the main window, which, in a well-formed application, closes child windows and revokes all running message loops for the application. The request to exit the process by calling <see cref="M:System.Diagnostics.Process.CloseMainWindow" /> does not force the application to quit. The application can ask for user verification before quitting, or it can refuse to quit. To force the application to quit, use the <see cref="M:System.Diagnostics.Process.Kill" /> method. The behavior of <see cref="M:System.Diagnostics.Process.CloseMainWindow" /> is identical to that of a user closing an application's main window using the system menu. Therefore, the request to exit the process by closing the main window does not force the application to quit immediately.</para>
@@ -416,6 +415,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Closes a process that has a user interface by sending a close message to its main window.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the close message was successfully sent; false if the associated process does not have a main window or if the main window is disabled (for example if a modal dialog is being shown).</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Dispose">
@@ -699,7 +702,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Process'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create a new <see cref="T:System.Diagnostics.Process" /> instance and associate it with the process resource on the local computer.</para>
@@ -709,6 +711,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a new <see cref="T:System.Diagnostics.Process" /> component and associates it with the currently active process.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Diagnostics.Process" /> component associated with the process resource that is running the calling application.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetProcessById">
@@ -727,7 +733,6 @@
         <Parameter Name="processId" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Process'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create a new <see cref="T:System.Diagnostics.Process" /> component and associate it with a process resource on the local computer. The process resource must already exist on the computer, because <see cref="M:System.Diagnostics.Process.GetProcessById(System.Int32)" /> does not create a system resource, but rather associates a resource with an application-generated <see cref="T:System.Diagnostics.Process" /> component. A process <see cref="P:System.Diagnostics.Process.Id" /> can be retrieved only for a process that is currently running on the computer. After the process terminates, <see cref="M:System.Diagnostics.Process.GetProcessById(System.Int32)" /> throws an exception if you pass it an expired identifier.</para>
@@ -737,6 +742,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new <see cref="T:System.Diagnostics.Process" /> component, given the identifier of a process on the local computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Diagnostics.Process" /> component that is associated with the local process resource identified by the <paramref name="processId" /> parameter.</para>
+        </returns>
         <param name="processId">
           <attribution license="cc4" from="Microsoft" modified="false" />The system-unique identifier of a process resource. </param>
       </Docs>
@@ -763,7 +772,6 @@
         <Parameter Name="machineName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Process'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create a new <see cref="T:System.Diagnostics.Process" /> component and associate it with a process resource on a remote computer on the network. The process resource must already exist on the specified computer, because <see cref="M:System.Diagnostics.Process.GetProcessById(System.Int32,System.String)" /> does not create a system resource, but rather associates a resource with an application-generated <see cref="T:System.Diagnostics.Process" /> component. A process <see cref="P:System.Diagnostics.Process.Id" /> can be retrieved only for a process that is currently running on the computer. After the process terminates, <see cref="M:System.Diagnostics.Process.GetProcessById(System.Int32,System.String)" /> throws an exception if you pass it an expired identifier.</para>
@@ -774,6 +782,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new <see cref="T:System.Diagnostics.Process" /> component, given a process identifier and the name of a computer on the network.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Diagnostics.Process" /> component that is associated with a remote process resource identified by the <paramref name="processId" /> parameter.</para>
+        </returns>
         <param name="processId">
           <attribution license="cc4" from="Microsoft" modified="false" />The system-unique identifier of a process resource. </param>
         <param name="machineName">
@@ -794,7 +806,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Process []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create an array of new <see cref="T:System.Diagnostics.Process" /> components and associate them with all the process resources on the local computer. The process resources must already exist on the local computer, because <see cref="M:System.Diagnostics.Process.GetProcesses" /> does not create system resources but rather associates resources with application-generated <see cref="T:System.Diagnostics.Process" /> components. Because the operating system itself is running background processes, this array is never empty.</para>
@@ -804,6 +815,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Diagnostics.Process" /> component for each process resource on the local computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Diagnostics.Process" /> that represents all the process resources running on the local computer.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetProcesses">
@@ -827,7 +842,6 @@
         <Parameter Name="machineName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Process []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create an array of new <see cref="T:System.Diagnostics.Process" /> components and associate them with all the process resources on the specified (usually remote) computer. The process resources must already exist on the local computer, because <see cref="M:System.Diagnostics.Process.GetProcesses" /> does not create system resources but rather associates resources with application-generated <see cref="T:System.Diagnostics.Process" /> components. Because the operating system itself is running background processes, this array is never empty.</para>
@@ -838,6 +852,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Diagnostics.Process" /> component for each process resource on the specified computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Diagnostics.Process" /> that represents all the process resources running on the specified computer.</para>
+        </returns>
         <param name="machineName">
           <attribution license="cc4" from="Microsoft" modified="false" />The computer from which to read the list of processes. </param>
       </Docs>
@@ -858,7 +876,6 @@
         <Parameter Name="processName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Process []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create an array of new <see cref="T:System.Diagnostics.Process" /> components and associate them with all the process resources that are running the same executable file on the local computer. The process resources must already exist on the computer, because <see cref="M:System.Diagnostics.Process.GetProcessesByName(System.String)" /> does not create system resources but rather associates them with application-generated <see cref="T:System.Diagnostics.Process" /> components. A <paramref name="processName" /> can be specified for an executable file that is not currently running on the local computer, so the array the method returns can be empty.</para>
@@ -869,6 +886,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an array of new <see cref="T:System.Diagnostics.Process" /> components and associates them with all the process resources on the local computer that share the specified process name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Diagnostics.Process" /> that represents the process resources running the specified application or file.</para>
+        </returns>
         <param name="processName">
           <attribution license="cc4" from="Microsoft" modified="false" />The friendly name of the process. </param>
       </Docs>
@@ -895,7 +916,6 @@
         <Parameter Name="machineName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Process []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create an array of new <see cref="T:System.Diagnostics.Process" /> components and associate them with all the process resources that are running the same executable file on the specified computer. The process resources must already exist on the computer, because <see cref="M:System.Diagnostics.Process.GetProcessesByName(System.String)" /> does not create system resources but rather associates them with application-generated <see cref="T:System.Diagnostics.Process" /> components. A <paramref name="processName" /> can be specified for an executable file that is not currently running on the local computer, so the array the method returns can be empty.</para>
@@ -908,6 +928,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an array of new <see cref="T:System.Diagnostics.Process" /> components and associates them with all the process resources on a remote computer that share the specified process name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Diagnostics.Process" /> that represents the process resources running the specified application or file.</para>
+        </returns>
         <param name="processName">
           <attribution license="cc4" from="Microsoft" modified="false" />The friendly name of the process. </param>
         <param name="machineName">
@@ -2543,7 +2567,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>Boolean value representing how process was started. This is true when a new process is created, and false when an existing process is reused.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this overload to start a process resource and associate it with the current <see cref="T:System.Diagnostics.Process" /> component. The return value true indicates that a new process resource was started. If the process resource specified by the <see cref="P:System.Diagnostics.ProcessStartInfo.FileName" /> member of the <see cref="P:System.Diagnostics.Process.StartInfo" /> property is already running on the computer, no additional process resource is started. Instead, the running process resource is reused and false is returned.</para>
@@ -2566,6 +2589,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Starts (or reuses) the process resource that is specified by the <see cref="P:System.Diagnostics.Process.StartInfo" /> property of this <see cref="T:System.Diagnostics.Process" /> component and associates it with the component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a process resource is started; false if no new process resource is started (for example, if an existing process is reused).</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Start">
@@ -2584,7 +2611,6 @@
         <Parameter Name="startInfo" Type="System.Diagnostics.ProcessStartInfo" />
       </Parameters>
       <Docs>
-        <returns>This method is useful for creating a new <see cref="T:System.Diagnostics.Process" /> object and starting it.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this overload to start a process resource by specifying a <see cref="T:System.Diagnostics.ProcessStartInfo" /> instance. The overload associates the resource with a new <see cref="T:System.Diagnostics.Process" /> component. If the process is already running, no additional process resource is started. Instead, the existing process resource is reused and no new <see cref="T:System.Diagnostics.Process" /> component is created. In such a case, instead of returning a new <see cref="T:System.Diagnostics.Process" /> component, <see cref="M:System.Diagnostics.Process.Start" /> returns null to the calling procedure.</para>
@@ -2607,6 +2633,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Starts the process resource that is specified by the parameter containing process start information (for example, the file name of the process to start) and associates the resource with a new <see cref="T:System.Diagnostics.Process" /> component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Diagnostics.Process" /> component that is associated with the process resource, or null if no process resource is started (for example, if an existing process is reused).</para>
+        </returns>
         <param name="startInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Diagnostics.ProcessStartInfo" /> that contains the information that is used to start the process, including the file name and any command-line arguments. </param>
       </Docs>
@@ -2627,7 +2657,6 @@
         <Parameter Name="fileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>Process for the specified commandline.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this overload to start a process resource by specifying its file name. The overload associates the resource with a new <see cref="T:System.Diagnostics.Process" /> component. If the process is already running, no additional process resource is started. Instead, the existing process resource is reused and no new <see cref="T:System.Diagnostics.Process" /> component is created. In such a case, instead of returning a new <see cref="T:System.Diagnostics.Process" /> component, <see cref="M:System.Diagnostics.Process.Start" /> returns null to the calling procedure.</para>
@@ -2650,6 +2679,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Starts a process resource by specifying the name of a document or application file and associates the resource with a new <see cref="T:System.Diagnostics.Process" /> component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Diagnostics.Process" /> component that is associated with the process resource, or null, if no process resource is started (for example, if an existing process is reused).</para>
+        </returns>
         <param name="fileName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a document or application file to run in the process. </param>
       </Docs>
@@ -2671,7 +2704,6 @@
         <Parameter Name="arguments" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>Process for the specified commandline.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this overload to start a process resource by specifying its file name and command-line arguments. The overload associates the resource with a new <see cref="T:System.Diagnostics.Process" /> component. If the process is already running, no additional process is started. Instead, the existing process resource is reused and no new <see cref="T:System.Diagnostics.Process" /> component is created. In such a case, instead of returning a new <see cref="T:System.Diagnostics.Process" /> component, <see cref="M:System.Diagnostics.Process.Start" /> returns null to the calling procedure.</para>
@@ -2692,6 +2724,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Starts a process resource by specifying the name of an application and a set of command-line arguments, and associates the resource with a new <see cref="T:System.Diagnostics.Process" /> component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Diagnostics.Process" /> component that is associated with the process, or null, if no process resource is started (for example, if an existing process is reused).</para>
+        </returns>
         <param name="fileName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of an application file to run in the process. </param>
         <param name="arguments">
@@ -2717,7 +2753,6 @@
       </Parameters>
       <Docs>
         <param name="username">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this overload to create a new process and its primary thread by specifying its file name, user name, password, and domain. The new process then runs the specified executable file in the security context of the specified credentials (user, domain, and password). </para>
@@ -2738,6 +2773,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Starts a process resource by specifying the name of an application, a user name, a password, and a domain and associates the resource with a new <see cref="T:System.Diagnostics.Process" /> component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Diagnostics.Process" /> component that is associated with the process resource, or null if no process resource is started (for example, if an existing process is reused).</para>
+        </returns>
         <param name="fileName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of an application file to run in the process.</param>
         <param name="password">
@@ -2766,7 +2805,6 @@
       </Parameters>
       <Docs>
         <param name="username">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this overload to create a new process and its primary thread by specifying its file name, command-line arguments, user name, password, and domain. The new process then runs the specified executable file in the security context of the specified credentials (user, domain, and password). </para>
@@ -2787,6 +2825,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Starts a process resource by specifying the name of an application, a set of command-line arguments, a user name, a password, and a domain and associates the resource with a new <see cref="T:System.Diagnostics.Process" /> component.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Diagnostics.Process" /> component that is associated with the process resource, or null if no process resource is started (for example, if an existing process is reused).</para>
+        </returns>
         <param name="fileName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of an application file to run in the process. </param>
         <param name="arguments">
@@ -2960,12 +3002,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Formats the process's name as a string, combined with the parent component type, if applicable.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="P:System.Diagnostics.Process.ProcessName" />, combined with the base component's <see cref="M:System.Object.ToString" /> return value.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TotalProcessorTime">
@@ -3139,7 +3184,6 @@
         <Parameter Name="milliseconds" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Diagnostics.Process.WaitForExit(System.Int32)" /> overload is used to make the current thread wait until the associated process terminates. This overload instructs the <see cref="T:System.Diagnostics.Process" /> component to wait a finite amount of time for the process to exit. If the associated process does not exit by the end of the interval because the request to terminate is denied, false is returned to the calling procedure. You can specify a negative number (<see cref="F:System.Threading.Timeout.Infinite" />) for <paramref name="milliseconds" />, and <see cref="M:System.Diagnostics.Process.WaitForExit(System.Int32)" /> will behave the same as the <see cref="M:System.Diagnostics.Process.WaitForExit" /> overload. If you pass 0 (zero) to the method, it returns true only if the process has already exited; otherwise, it immediately returns false.</para>
@@ -3154,6 +3198,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Instructs the <see cref="T:System.Diagnostics.Process" /> component to wait the specified number of milliseconds for the associated process to exit.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the associated process has exited; otherwise, false.</para>
+        </returns>
         <param name="milliseconds">
           <attribution license="cc4" from="Microsoft" modified="false" />The amount of time, in milliseconds, to wait for the associated process to exit. The maximum is the largest possible value of a 32-bit integer, which represents infinity to the operating system. </param>
       </Docs>
@@ -3177,7 +3225,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use <see cref="M:System.Diagnostics.Process.WaitForInputIdle" /> to force the processing of your application to wait until the message loop has returned to the idle state. When a process with a user interface is executing, its message loop executes every time a Windows message is sent to the process by the operating system. The process then returns to the message loop. A process is said to be in an idle state when it is waiting for messages inside of a message loop. This state is useful, for example, when your application needs to wait for a starting process to finish creating its main window before the application communicates with that window.</para>
@@ -3188,6 +3235,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Causes the <see cref="T:System.Diagnostics.Process" /> component to wait indefinitely for the associated process to enter an idle state. This overload applies only to processes with a user interface and, therefore, a message loop.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the associated process has reached an idle state.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="WaitForInputIdle">
@@ -3211,7 +3262,6 @@
         <Parameter Name="milliseconds" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use <see cref="M:System.Diagnostics.Process.WaitForInputIdle(System.Int32)" /> to force the processing of your application to wait until the message loop has returned to the idle state. When a process with a user interface is executing, its message loop executes every time a Windows message is sent to the process by the operating system. The process then returns to the message loop. A process is said to be in an idle state when it is waiting for messages inside of a message loop. This state is useful, for example, when your application needs to wait for a starting process to finish creating its main window before the application communicates with that window.</para>
@@ -3223,6 +3273,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Causes the <see cref="T:System.Diagnostics.Process" /> component to wait the specified number of milliseconds for the associated process to enter an idle state. This overload applies only to processes with a user interface and, therefore, a message loop.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the associated process has reached an idle state; otherwise, false.</para>
+        </returns>
         <param name="milliseconds">
           <attribution license="cc4" from="Microsoft" modified="false" />A value of 1 to <see cref="F:System.Int32.MaxValue" /> that specifies the amount of time, in milliseconds, to wait for the associated process to become idle. A value of 0 specifies an immediate return, and a value of -1 specifies an infinite wait. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/ProcessModule.xml b/mcs/class/System/Documentation/en/System.Diagnostics/ProcessModule.xml
index 7639bbf5b3c..d783df7303b 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/ProcessModule.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/ProcessModule.xml
@@ -218,12 +218,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the name of the module to a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the <see cref="P:System.Diagnostics.ProcessModule.ModuleName" /> property.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/ProcessModuleCollection.xml b/mcs/class/System/Documentation/en/System.Diagnostics/ProcessModuleCollection.xml
index 385391c36e1..568be40dffc 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/ProcessModuleCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/ProcessModuleCollection.xml
@@ -85,7 +85,6 @@
         <Parameter Name="module" Type="System.Diagnostics.ProcessModule" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A module is identified by its module name and its fully qualified file path.</para>
@@ -94,6 +93,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified process module exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the module exists in the collection; otherwise, false.</para>
+        </returns>
         <param name="module">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Diagnostics.ProcessModule" /> instance that indicates the module to find in this collection. </param>
       </Docs>
@@ -142,12 +145,15 @@
         <Parameter Name="module" Type="System.Diagnostics.ProcessModule" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides the location of a specified module within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index that defines the location of the module within the <see cref="T:System.Diagnostics.ProcessModuleCollection" />.</para>
+        </returns>
         <param name="module">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Diagnostics.ProcessModule" /> whose index is retrieved. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/ProcessThreadCollection.xml b/mcs/class/System/Documentation/en/System.Diagnostics/ProcessThreadCollection.xml
index 48a595273dd..00d55bf30d5 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/ProcessThreadCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/ProcessThreadCollection.xml
@@ -82,12 +82,15 @@
         <Parameter Name="thread" Type="System.Diagnostics.ProcessThread" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends a process thread to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the thread in the collection.</para>
+        </returns>
         <param name="thread">
           <attribution license="cc4" from="Microsoft" modified="false" />The thread to add to the collection. </param>
       </Docs>
@@ -108,7 +111,6 @@
         <Parameter Name="thread" Type="System.Diagnostics.ProcessThread" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A module is identified by its module name and its fully qualified file path.</para>
@@ -117,6 +119,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified process thread exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the thread exists in the collection; otherwise, false.</para>
+        </returns>
         <param name="thread">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Diagnostics.ProcessThread" /> instance that indicates the thread to find in this collection. </param>
       </Docs>
@@ -165,12 +171,15 @@
         <Parameter Name="thread" Type="System.Diagnostics.ProcessThread" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides the location of a specified thread within the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index that defines the location of the thread within the <see cref="T:System.Diagnostics.ProcessThreadCollection" />.</para>
+        </returns>
         <param name="thread">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Diagnostics.ProcessThread" /> whose index is retrieved. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/SourceFilter.xml b/mcs/class/System/Documentation/en/System.Diagnostics/SourceFilter.xml
index b988ad690cc..03d80f1dd65 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/SourceFilter.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/SourceFilter.xml
@@ -74,7 +74,6 @@
         <Parameter Name="data" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the value of the <paramref name="source" /> parameter matches the value of the <see cref="P:System.Diagnostics.SourceFilter.Source" /> property, the method returns true.</para>
@@ -83,6 +82,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the trace listener should trace the event.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the trace should be produced; otherwise, false. </para>
+        </returns>
         <param name="cache">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that represents the information cache for the trace event.</param>
         <param name="source">
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/SourceSwitch.xml b/mcs/class/System/Documentation/en/System.Diagnostics/SourceSwitch.xml
index 61e3e17728c..6c16d3af70f 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/SourceSwitch.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/SourceSwitch.xml
@@ -161,7 +161,6 @@
         <Parameter Name="eventType" Type="System.Diagnostics.TraceEventType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called by the Trace methods in the <see cref="T:System.Diagnostics.TraceSource" /> class to determine whether listeners should be called to write a trace.</para>
@@ -173,6 +172,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if trace listeners should be called, based on the trace event type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True if the trace listeners should be called; otherwise, false.</para>
+        </returns>
         <param name="eventType">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Diagnostics.TraceEventType" /> values.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/Stopwatch.xml b/mcs/class/System/Documentation/en/System.Diagnostics/Stopwatch.xml
index 2d0fd7e41d3..b9ca04678a6 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/Stopwatch.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/Stopwatch.xml
@@ -174,7 +174,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -184,6 +183,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the current number of ticks in the timer mechanism.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A long integer representing the tick counter value of the underlying timer mechanism.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsHighResolution">
@@ -318,7 +321,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -328,6 +330,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new <see cref="T:System.Diagnostics.Stopwatch" /> instance, sets the elapsed time property to zero, and starts measuring elapsed time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Diagnostics.Stopwatch" /> that has just begun measuring elapsed time.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Stop">
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/Switch.xml b/mcs/class/System/Documentation/en/System.Diagnostics/Switch.xml
index df6c8e9217b..48e903f79d9 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/Switch.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/Switch.xml
@@ -205,7 +205,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default implementation for the <see cref="M:System.Diagnostics.Switch.GetSupportedAttributes" /> method returns null. If a switch is added in a configuration file and custom attributes are specified that are not included in the string array returned by <see cref="M:System.Diagnostics.Switch.GetSupportedAttributes" />, a <see cref="T:System.Configuration.ConfigurationException" /> is thrown when the switch is loaded.</para>
@@ -214,6 +213,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the custom attributes supported by the switch.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string array that contains the names of the custom attributes supported by the switch, or null if there no custom attributes are supported.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="OnSwitchSettingChanged">
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/SwitchAttribute.xml b/mcs/class/System/Documentation/en/System.Diagnostics/SwitchAttribute.xml
index 61a53c3344d..d5f0a335dcd 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/SwitchAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/SwitchAttribute.xml
@@ -73,12 +73,15 @@
         <Parameter Name="assembly" Type="System.Reflection.Assembly" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all switch attributes for the specified assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains all the switch attributes for the assembly.</para>
+        </returns>
         <param name="assembly">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly to check for switch attributes.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/TraceFilter.xml b/mcs/class/System/Documentation/en/System.Diagnostics/TraceFilter.xml
index 300ab252657..5af06997038 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/TraceFilter.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/TraceFilter.xml
@@ -62,12 +62,15 @@
         <Parameter Name="data" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, determines whether the trace listener should trace the event.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true to trace the specified event; otherwise, false. </para>
+        </returns>
         <param name="cache">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Diagnostics.TraceEventCache" /> that contains information for the trace event.</param>
         <param name="source">
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/TraceListener.xml b/mcs/class/System/Documentation/en/System.Diagnostics/TraceListener.xml
index d96e9646abd..0903920e6f8 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/TraceListener.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/TraceListener.xml
@@ -362,7 +362,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default implementation for <see cref="M:System.Diagnostics.TraceListener.GetSupportedAttributes" /> returns null.</para>
@@ -371,6 +370,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the custom attributes supported by the trace listener.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string array naming the custom attributes supported by the trace listener, or null if there are no custom attributes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IndentLevel">
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/TraceListenerCollection.xml b/mcs/class/System/Documentation/en/System.Diagnostics/TraceListenerCollection.xml
index 99a7c2059d6..257f5fdeb34 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/TraceListenerCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/TraceListenerCollection.xml
@@ -49,12 +49,15 @@
         <Parameter Name="listener" Type="System.Diagnostics.TraceListener" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Diagnostics.TraceListener" /> to the list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position at which the new listener was inserted.</para>
+        </returns>
         <param name="listener">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Diagnostics.TraceListener" /> to add to the list. </param>
       </Docs>
@@ -146,7 +149,6 @@
         <Parameter Name="listener" Type="System.Diagnostics.TraceListener" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Diagnostics.TraceListenerCollection.Contains(System.Diagnostics.TraceListener)" /> method can confirm the existence of a <see cref="T:System.Diagnostics.TraceListener" /> before you perform further operations.</para>
@@ -155,6 +157,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks whether the list contains the specified listener.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the listener is in the list; otherwise, false.</para>
+        </returns>
         <param name="listener">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Diagnostics.TraceListener" /> to find in the list. </param>
       </Docs>
@@ -222,12 +228,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IEnumerator'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an enumerator for this list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator of type <see cref="T:System.Collections.IEnumerator" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IndexOf">
@@ -246,12 +255,15 @@
         <Parameter Name="listener" Type="System.Diagnostics.TraceListener" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the specified listener.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the listener, if it can be found in the list; otherwise, -1.</para>
+        </returns>
         <param name="listener">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Diagnostics.TraceListener" /> to find in the list. </param>
       </Docs>
@@ -502,7 +514,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Diagnostics.TraceListenerCollection.Add(System.Diagnostics.TraceListener)" /> method to add a new trace listener to the collection.</para>
@@ -511,6 +522,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a trace listener to the <see cref="T:System.Diagnostics.TraceListenerCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position into which the new trace listener was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to add to the <see cref="T:System.Diagnostics.TraceListenerCollection" />.</param>
       </Docs>
@@ -531,7 +546,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Diagnostics.TraceListenerCollection.Contains(System.Diagnostics.TraceListener)" /> method of the <see cref="T:System.Diagnostics.TraceListenerCollection" /> class to determine whether the collection contains a specific <see cref="T:System.Diagnostics.TraceListener" /> object.</para>
@@ -540,6 +554,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Diagnostics.TraceListenerCollection" /> contains a specific object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Object" /> is found in the <see cref="T:System.Diagnostics.TraceListenerCollection" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to locate in the <see cref="T:System.Diagnostics.TraceListenerCollection" />.</param>
       </Docs>
@@ -560,7 +578,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Diagnostics.TraceListenerCollection.IndexOf(System.Diagnostics.TraceListener)" /> method of the <see cref="T:System.Diagnostics.TraceListenerCollection" /> class to determine the index of a <see cref="T:System.Diagnostics.TraceListener" /> object in the collection.</para>
@@ -569,6 +586,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of a specific object in the <see cref="T:System.Diagnostics.TraceListenerCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of <paramref name="value" /> if found in the <see cref="T:System.Diagnostics.TraceListenerCollection" />; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to locate in the <see cref="T:System.Diagnostics.TraceListenerCollection" />.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Diagnostics/TraceSource.xml b/mcs/class/System/Documentation/en/System.Diagnostics/TraceSource.xml
index ec7c9cfe981..7f323735454 100644
--- a/mcs/class/System/Documentation/en/System.Diagnostics/TraceSource.xml
+++ b/mcs/class/System/Documentation/en/System.Diagnostics/TraceSource.xml
@@ -219,7 +219,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default implementation for <see cref="M:System.Diagnostics.TraceSource.GetSupportedAttributes" /> returns null.</para>
@@ -228,6 +227,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the custom attributes supported by the trace source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string array naming the custom attributes supported by the trace source, or null if there are no custom attributes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Listeners">
diff --git a/mcs/class/System/Documentation/en/System.IO.Compression/DeflateStream.xml b/mcs/class/System/Documentation/en/System.IO.Compression/DeflateStream.xml
index d46327c84a9..36c3b64b836 100644
--- a/mcs/class/System/Documentation/en/System.IO.Compression/DeflateStream.xml
+++ b/mcs/class/System/Documentation/en/System.IO.Compression/DeflateStream.xml
@@ -199,7 +199,6 @@
         <param name="buffer">To be added.</param>
         <param name="cback">To be added.</param>
         <param name="state">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -214,6 +213,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous read operation. (Consider using the <see cref="M:System.IO.Stream.ReadAsync(System.Byte[],System.Int32,System.Int32)" /> method instead; see the Remarks section.)</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An  object that represents the asynchronous read operation, which could still be pending.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte offset in <paramref name="array" /> at which to begin reading data from the stream.</param>
         <param name="count">
@@ -242,7 +245,6 @@
         <param name="buffer">To be added.</param>
         <param name="cback">To be added.</param>
         <param name="state">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -257,6 +259,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous write operation. (Consider using the <see cref="M:System.IO.Stream.WriteAsync(System.Byte[],System.Int32,System.Int32)" /> method instead; see the Remarks section.)</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An  object that represents the asynchronous write operation, which could still be pending.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte offset in <paramref name="buffer" /> to begin writing from.</param>
         <param name="count">
@@ -371,7 +377,6 @@
       </Parameters>
       <Docs>
         <param name="async_result">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -383,6 +388,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits for the pending asynchronous read to complete. (Consider using the <see cref="M:System.IO.Stream.ReadAsync(System.Byte[],System.Int32,System.Int32)" /> method instead; see the Remarks section.)</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes read from the stream, between 0 (zero) and the number of bytes you requested. <see cref="T:System.IO.Compression.DeflateStream" /> returns 0 only at the end of the stream; otherwise, it blocks until at least one byte is available.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="EndWrite">
@@ -500,13 +509,16 @@
       <Docs>
         <param name="dest">To be added.</param>
         <param name="dest_offset">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a number of decompressed bytes into the specified byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes that were read into the byte array.</para>
+        </returns>
         <param name="count">
           <attribution license="cc4" from="Microsoft" modified="false" />The maximum number of decompressed bytes to read.</param>
       </Docs>
@@ -527,13 +539,16 @@
         <Parameter Name="origin" Type="System.IO.SeekOrigin" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation is not supported and always throws a <see cref="T:System.NotSupportedException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A long value.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />The location in the stream.</param>
         <param name="origin">
diff --git a/mcs/class/System/Documentation/en/System.IO.Compression/GZipStream.xml b/mcs/class/System/Documentation/en/System.IO.Compression/GZipStream.xml
index 7990224756b..6a98f3f6b50 100644
--- a/mcs/class/System/Documentation/en/System.IO.Compression/GZipStream.xml
+++ b/mcs/class/System/Documentation/en/System.IO.Compression/GZipStream.xml
@@ -197,7 +197,6 @@
         <param name="buffer">To be added.</param>
         <param name="cback">To be added.</param>
         <param name="state">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -212,6 +211,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous read operation. (Consider using the <see cref="M:System.IO.Stream.ReadAsync(System.Byte[],System.Int32,System.Int32)" /> method instead; see the Remarks section.)</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the asynchronous read operation, which could still be pending.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte offset in <paramref name="array" /> at which to begin reading data from the stream.</param>
         <param name="count">
@@ -240,7 +243,6 @@
         <param name="buffer">To be added.</param>
         <param name="cback">To be added.</param>
         <param name="state">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -252,6 +254,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous write operation. (Consider using the <see cref="M:System.IO.Stream.WriteAsync(System.Byte[],System.Int32,System.Int32)" /> method instead; see the Remarks section.)</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An  object that represents the asynchronous write operation, which could still be pending.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte offset in <paramref name="array" /> at which to begin writing.</param>
         <param name="count">
@@ -366,7 +372,6 @@
       </Parameters>
       <Docs>
         <param name="async_result">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -378,6 +383,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits for the pending asynchronous read to complete. (Consider using the the <see cref="M:System.IO.Stream.ReadAsync(System.Byte[],System.Int32,System.Int32)" /> method instead; see the Remarks section.)</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes read from the stream, between 0 (zero) and the number of bytes you requested. <see cref="T:System.IO.Compression.GZipStream" /> returns 0 only at the end of the stream; otherwise, it blocks until at least one byte is available.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="EndWrite">
@@ -493,7 +502,6 @@
       <Docs>
         <param name="dest">To be added.</param>
         <param name="dest_offset">To be added.</param>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -503,6 +511,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a number of decompressed bytes into the specified byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes that were decompressed into the byte array. If the end of the stream has been reached, zero or the number of bytes read is returned.</para>
+        </returns>
         <param name="count">
           <attribution license="cc4" from="Microsoft" modified="false" />The maximum number of decompressed bytes to read.</param>
       </Docs>
@@ -523,13 +535,16 @@
         <Parameter Name="origin" Type="System.IO.SeekOrigin" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This property is not supported and always throws a <see cref="T:System.NotSupportedException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A long value.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />The location in the stream.</param>
         <param name="origin">
diff --git a/mcs/class/System/Documentation/en/System.IO.Ports/SerialPort.xml b/mcs/class/System/Documentation/en/System.IO.Ports/SerialPort.xml
index 18c2dce60ae..9dc6460a61e 100644
--- a/mcs/class/System/Documentation/en/System.IO.Ports/SerialPort.xml
+++ b/mcs/class/System/Documentation/en/System.IO.Ports/SerialPort.xml
@@ -816,7 +816,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -828,6 +827,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of serial port names for the current computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of serial port names for the current computer.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Handshake">
@@ -1139,7 +1142,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1151,6 +1153,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a number of bytes from the <see cref="T:System.IO.Ports.SerialPort" /> input buffer and writes those bytes into a byte array at the specified offset.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes read.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array to write the input to. </param>
         <param name="offset">
@@ -1176,7 +1182,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1189,6 +1194,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a number of characters from the <see cref="T:System.IO.Ports.SerialPort" /> input buffer and writes them into an array of characters at a given offset.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of characters read.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The character array to write the input to. </param>
         <param name="offset">
@@ -1246,7 +1255,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1260,6 +1268,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Synchronously reads one byte from the <see cref="T:System.IO.Ports.SerialPort" /> input buffer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The byte, cast to an <see cref="T:System.Int32" />, or -1 if the end of the stream has been read.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadChar">
@@ -1275,7 +1287,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1289,6 +1300,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Synchronously reads one character from the <see cref="T:System.IO.Ports.SerialPort" /> input buffer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The character that was read.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadExisting">
@@ -1304,7 +1319,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1318,6 +1332,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads all immediately available bytes, based on the encoding, in both the stream and the input buffer of the <see cref="T:System.IO.Ports.SerialPort" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The contents of the stream and the input buffer of the <see cref="T:System.IO.Ports.SerialPort" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadLine">
@@ -1333,7 +1351,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1348,6 +1365,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads up to the <see cref="P:System.IO.Ports.SerialPort.NewLine" /> value in the input buffer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The contents of the input buffer up to the first occurrence of a <see cref="P:System.IO.Ports.SerialPort.NewLine" /> value.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadTimeout">
@@ -1404,7 +1425,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1418,6 +1438,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a string up to the specified <paramref name="value" /> in the input buffer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The contents of the input buffer up to the specified <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A value that indicates where the read operation stops. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.IO/ErrorEventArgs.xml b/mcs/class/System/Documentation/en/System.IO/ErrorEventArgs.xml
index f257752c4b2..8d621ba3e6c 100644
--- a/mcs/class/System/Documentation/en/System.IO/ErrorEventArgs.xml
+++ b/mcs/class/System/Documentation/en/System.IO/ErrorEventArgs.xml
@@ -64,12 +64,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Exception'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Exception" /> that represents the error that occurred.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Exception" /> that represents the error that occurred.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.IO/FileSystemWatcher.xml b/mcs/class/System/Documentation/en/System.IO/FileSystemWatcher.xml
index ec74dae01de..05fd69c5628 100644
--- a/mcs/class/System/Documentation/en/System.IO/FileSystemWatcher.xml
+++ b/mcs/class/System/Documentation/en/System.IO/FileSystemWatcher.xml
@@ -1098,7 +1098,6 @@
         <Parameter Name="changeType" Type="System.IO.WatcherChangeTypes" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'WaitForChangedResult'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method waits indefinitely until the first change occurs and then returns. This is the same as using <see cref="M:System.IO.FileSystemWatcher.WaitForChanged(System.IO.WatcherChangeTypes)" /> with the <paramref name="timeout" /> parameter set to -1.</para>
@@ -1111,6 +1110,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A synchronous method that returns a structure that contains specific information on the change that occurred, given the type of change you want to monitor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.WaitForChangedResult" /> that contains specific information on the change that occurred.</para>
+        </returns>
         <param name="changeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.WatcherChangeTypes" /> to watch for. </param>
       </Docs>
@@ -1132,7 +1135,6 @@
         <Parameter Name="timeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'WaitForChangedResult'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method waits until a change occurs or it has timed out. A value of -1 for the <paramref name="timeout" /> parameter means wait indefinitely.</para>
@@ -1145,6 +1147,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A synchronous method that returns a structure that contains specific information on the change that occurred, given the type of change you want to monitor and the time (in milliseconds) to wait before timing out.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.WaitForChangedResult" /> that contains specific information on the change that occurred.</para>
+        </returns>
         <param name="changeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.WatcherChangeTypes" /> to watch for. </param>
         <param name="timeout">
diff --git a/mcs/class/System/Documentation/en/System.Net.Cache/HttpRequestCachePolicy.xml b/mcs/class/System/Documentation/en/System.Net.Cache/HttpRequestCachePolicy.xml
index dc62f814d75..5d6b8f36c22 100644
--- a/mcs/class/System/Documentation/en/System.Net.Cache/HttpRequestCachePolicy.xml
+++ b/mcs/class/System/Documentation/en/System.Net.Cache/HttpRequestCachePolicy.xml
@@ -334,7 +334,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -344,6 +343,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> value that contains the property values for this instance.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.Net.Cache/RequestCachePolicy.xml b/mcs/class/System/Documentation/en/System.Net.Cache/RequestCachePolicy.xml
index 8c424d7358a..8cf2b484620 100644
--- a/mcs/class/System/Documentation/en/System.Net.Cache/RequestCachePolicy.xml
+++ b/mcs/class/System/Documentation/en/System.Net.Cache/RequestCachePolicy.xml
@@ -115,13 +115,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the <see cref="P:System.Net.Cache.RequestCachePolicy.Level" /> for this instance.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.Net.Configuration/AuthenticationModuleElementCollection.xml b/mcs/class/System/Documentation/en/System.Net.Configuration/AuthenticationModuleElementCollection.xml
index 791f179d8a5..bccd52d8e9a 100644
--- a/mcs/class/System/Documentation/en/System.Net.Configuration/AuthenticationModuleElementCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Net.Configuration/AuthenticationModuleElementCollection.xml
@@ -113,13 +113,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new configuration element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.Configuration.AuthenticationModuleElement" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetElementKey">
@@ -142,13 +145,16 @@
         <Parameter Name="element" Type="System.Configuration.ConfigurationElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the key for the specified configuration element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The key value of <paramref name="element" />.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Net.Configuration.AuthenticationModuleElement" />.</param>
       </Docs>
@@ -168,13 +174,16 @@
         <Parameter Name="element" Type="System.Net.Configuration.AuthenticationModuleElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the specified configuration element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of <paramref name="element" />.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Net.Configuration.AuthenticationModuleElement" />.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Net.Configuration/BypassElementCollection.xml b/mcs/class/System/Documentation/en/System.Net.Configuration/BypassElementCollection.xml
index e5635fb361e..c508b37df10 100644
--- a/mcs/class/System/Documentation/en/System.Net.Configuration/BypassElementCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Net.Configuration/BypassElementCollection.xml
@@ -105,13 +105,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new configuration element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.Configuration.BypassElement" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetElementKey">
@@ -134,13 +137,16 @@
         <Parameter Name="element" Type="System.Configuration.ConfigurationElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the key for the specified configuration element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The key value of <paramref name="element" />.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Net.Configuration.BypassElement" />.</param>
       </Docs>
@@ -160,13 +166,16 @@
         <Parameter Name="element" Type="System.Net.Configuration.BypassElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the specified configuration element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of <paramref name="element" />.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Net.Configuration.BypassElement" />.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Net.Configuration/ConnectionManagementElementCollection.xml b/mcs/class/System/Documentation/en/System.Net.Configuration/ConnectionManagementElementCollection.xml
index eb0919777a3..5b7a0d4bd33 100644
--- a/mcs/class/System/Documentation/en/System.Net.Configuration/ConnectionManagementElementCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Net.Configuration/ConnectionManagementElementCollection.xml
@@ -105,13 +105,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new configuration element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.Configuration.ConnectionManagementElement" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetElementKey">
@@ -129,13 +132,16 @@
         <Parameter Name="element" Type="System.Configuration.ConfigurationElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the key for the specified configuration element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The key value of <paramref name="element" />.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Net.Configuration.ConnectionManagementElement" />.</param>
       </Docs>
@@ -155,13 +161,16 @@
         <Parameter Name="element" Type="System.Net.Configuration.ConnectionManagementElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the specified configuration element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of <paramref name="element" />.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Net.Configuration.ConnectionManagementElement" />.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Net.Configuration/NetSectionGroup.xml b/mcs/class/System/Documentation/en/System.Net.Configuration/NetSectionGroup.xml
index 73d954ebd40..849d476689d 100644
--- a/mcs/class/System/Documentation/en/System.Net.Configuration/NetSectionGroup.xml
+++ b/mcs/class/System/Documentation/en/System.Net.Configuration/NetSectionGroup.xml
@@ -175,7 +175,6 @@
         <Parameter Name="config" Type="System.Configuration.Configuration" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -185,6 +184,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the System.Net configuration section group from the specified configuration file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.Configuration.NetSectionGroup" /> that represents the System.Net settings in <paramref name="config" />.</para>
+        </returns>
         <param name="config">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Configuration.Configuration" /> that represents a configuration file.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Net.Configuration/WebRequestModuleElementCollection.xml b/mcs/class/System/Documentation/en/System.Net.Configuration/WebRequestModuleElementCollection.xml
index 4189569fa7e..f30555a862c 100644
--- a/mcs/class/System/Documentation/en/System.Net.Configuration/WebRequestModuleElementCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Net.Configuration/WebRequestModuleElementCollection.xml
@@ -108,13 +108,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new configuration element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.Configuration.WebRequestModuleElement" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetElementKey">
@@ -132,13 +135,16 @@
         <Parameter Name="element" Type="System.Configuration.ConfigurationElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the key for the specified configuration element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The key value of <paramref name="element" />.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Net.Configuration.WebRequestModuleElement" />.</param>
       </Docs>
@@ -158,13 +164,16 @@
         <Parameter Name="element" Type="System.Net.Configuration.WebRequestModuleElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the specified configuration element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of <paramref name="element" />.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Net.Configuration.WebRequestModuleElement" />.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Net.Mail/AlternateView.xml b/mcs/class/System/Documentation/en/System.Net.Mail/AlternateView.xml
index 8e79bd2aa85..c3d505dcc2a 100644
--- a/mcs/class/System/Documentation/en/System.Net.Mail/AlternateView.xml
+++ b/mcs/class/System/Documentation/en/System.Net.Mail/AlternateView.xml
@@ -222,7 +222,6 @@
         <Parameter Name="content" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -232,6 +231,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Net.Mail.AlternateView" /> of an email message using the content specified in a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.Mail.AlternateView" /> object that represents an alternate view of an email message.</para>
+        </returns>
         <param name="content">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> that contains the content of the email message.</param>
       </Docs>
@@ -252,13 +255,16 @@
         <Parameter Name="contentType" Type="System.Net.Mime.ContentType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Net.Mail.AlternateView" /> of an email message using the content specified in a <see cref="T:System.String" /> and the specified MIME media type of the content.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.Mail.AlternateView" /> object that represents an alternate view of an email message.</para>
+        </returns>
         <param name="content">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that contains the content for this attachment.</param>
         <param name="contentType">
@@ -283,13 +289,16 @@
       </Parameters>
       <Docs>
         <param name="encoding">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Net.Mail.AlternateView" /> of an email message using the content specified in a <see cref="T:System.String" />, the specified text encoding, and MIME media type of the content.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.Mail.AlternateView" /> object that represents an alternate view of an email message.</para>
+        </returns>
         <param name="content">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that contains the content for this attachment.</param>
         <param name="mediaType">
diff --git a/mcs/class/System/Documentation/en/System.Net.Mail/Attachment.xml b/mcs/class/System/Documentation/en/System.Net.Mail/Attachment.xml
index 5015ae22e6a..a73c72a02bd 100644
--- a/mcs/class/System/Documentation/en/System.Net.Mail/Attachment.xml
+++ b/mcs/class/System/Documentation/en/System.Net.Mail/Attachment.xml
@@ -270,13 +270,16 @@
         <Parameter Name="contentType" Type="System.Net.Mime.ContentType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a mail attachment using the content from the specified string, and the specified <see cref="T:System.Net.Mime.ContentType" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object of type <see cref="T:System.Net.Mail.Attachment" />.</para>
+        </returns>
         <param name="content">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that contains the content for this attachment.</param>
         <param name="contentType">
@@ -299,7 +302,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -310,6 +312,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a mail attachment using the content from the specified string, and the specified MIME content type name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object of type <see cref="T:System.Net.Mail.Attachment" />.</para>
+        </returns>
         <param name="content">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that contains the content for this attachment.</param>
         <param name="name">
@@ -334,13 +340,16 @@
         <Parameter Name="mediaType" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a mail attachment using the content from the specified string, the specified MIME content type name, character encoding, and MIME header information for the attachment.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object of type <see cref="T:System.Net.Mail.Attachment" />.</para>
+        </returns>
         <param name="content">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that contains the content for this attachment.</param>
         <param name="name">
diff --git a/mcs/class/System/Documentation/en/System.Net.Mail/LinkedResource.xml b/mcs/class/System/Documentation/en/System.Net.Mail/LinkedResource.xml
index 9719c605c67..e9fbe1402f3 100644
--- a/mcs/class/System/Documentation/en/System.Net.Mail/LinkedResource.xml
+++ b/mcs/class/System/Documentation/en/System.Net.Mail/LinkedResource.xml
@@ -200,13 +200,16 @@
         <Parameter Name="content" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Net.Mail.LinkedResource" /> object from a string to be included in an email attachment as an embedded resource. The default media type is plain text, and the default content type is ASCII.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.Mail.LinkedResource" /> object that contains the embedded resource to be included in the email attachment.</para>
+        </returns>
         <param name="content">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the embedded resource to be included in the email attachment.</param>
       </Docs>
@@ -227,13 +230,16 @@
         <Parameter Name="contentType" Type="System.Net.Mime.ContentType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Net.Mail.LinkedResource" /> object from a string to be included in an email attachment as an embedded resource, with the specified content type, and media type as plain text.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.Mail.LinkedResource" /> object that contains the embedded resource to be included in the email attachment.</para>
+        </returns>
         <param name="content">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the embedded resource to be included in the email attachment.</param>
         <param name="contentType">
@@ -257,13 +263,16 @@
         <Parameter Name="mediaType" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Net.Mail.LinkedResource" /> object from a string to be included in an email attachment as an embedded resource, with the specified content type, and media type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.Mail.LinkedResource" /> object that contains the embedded resource to be included in the email attachment.</para>
+        </returns>
         <param name="content">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the embedded resource to be included in the email attachment.</param>
         <param name="contentEncoding">
diff --git a/mcs/class/System/Documentation/en/System.Net.Mail/MailAddress.xml b/mcs/class/System/Documentation/en/System.Net.Mail/MailAddress.xml
index b0ed9ebb7a6..051651ec018 100644
--- a/mcs/class/System/Documentation/en/System.Net.Mail/MailAddress.xml
+++ b/mcs/class/System/Documentation/en/System.Net.Mail/MailAddress.xml
@@ -284,13 +284,16 @@
       </Parameters>
       <Docs>
         <param name="obj">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two mail addresses.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two mail addresses are equal; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -306,7 +309,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -316,6 +318,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash value for a mail address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer hash value.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Host">
@@ -355,7 +361,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -368,6 +373,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that contains the contents of this <see cref="T:System.Net.Mail.MailAddress" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="User">
diff --git a/mcs/class/System/Documentation/en/System.Net.Mail/MailAddressCollection.xml b/mcs/class/System/Documentation/en/System.Net.Mail/MailAddressCollection.xml
index 3bef2b4f51c..5372faa22b1 100644
--- a/mcs/class/System/Documentation/en/System.Net.Mail/MailAddressCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Net.Mail/MailAddressCollection.xml
@@ -142,7 +142,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -152,6 +151,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of the e-mail addresses in this <see cref="T:System.Net.Mail.MailAddressCollection" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the e-mail addresses in this collection.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.Net.Mail/SmtpPermission.xml b/mcs/class/System/Documentation/en/System.Net.Mail/SmtpPermission.xml
index 140e6b65db1..b1e9a3a60c6 100644
--- a/mcs/class/System/Documentation/en/System.Net.Mail/SmtpPermission.xml
+++ b/mcs/class/System/Documentation/en/System.Net.Mail/SmtpPermission.xml
@@ -165,7 +165,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -175,6 +174,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an identical copy of the current permission. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.Mail.SmtpPermission" /> that is identical to the current permission.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="FromXml">
@@ -220,7 +223,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -230,6 +232,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a permission that is the intersection of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.Mail.SmtpPermission" /> that represents the intersection of the current permission and the specified permission. Returns null if the intersection is empty or <paramref name="target" /> is null.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Security.IPermission" /> to intersect with the current permission. It must be of the same type as the current permission.</param>
       </Docs>
@@ -249,7 +255,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -259,6 +264,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the current permission is a subset of the specified permission. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is a subset of the specified permission; otherwise, false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Security.IPermission" /> that is to be tested for the subset relationship. This permission must be of the same type as the current permission.</param>
       </Docs>
@@ -276,7 +285,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -286,6 +294,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the current permission is unrestricted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is unrestricted; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToXml">
@@ -301,7 +313,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -311,6 +322,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the state of the permission. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.SecurityElement" /> that contains an XML encoding of the current permission.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Union">
@@ -328,7 +343,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -338,6 +352,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a permission that is the union of the current permission and the specified permission. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Net.Mail.SmtpPermission" /> permission that represents the union of the current permission and the specified permission.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Security.IPermission" /> to combine with the current permission. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Net.Mail/SmtpPermissionAttribute.xml b/mcs/class/System/Documentation/en/System.Net.Mail/SmtpPermissionAttribute.xml
index 18d63553353..8818454437b 100644
--- a/mcs/class/System/Documentation/en/System.Net.Mail/SmtpPermissionAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.Net.Mail/SmtpPermissionAttribute.xml
@@ -91,7 +91,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -102,6 +101,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a permission object that can be stored with the <see cref="T:System.Security.Permissions.SecurityAction" /> in an assembly's metadata.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.Mail.SmtpPermission" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.Net.Mime/ContentDisposition.xml b/mcs/class/System/Documentation/en/System.Net.Mime/ContentDisposition.xml
index 1e1acebb2fc..0f929c8f9dc 100644
--- a/mcs/class/System/Documentation/en/System.Net.Mime/ContentDisposition.xml
+++ b/mcs/class/System/Documentation/en/System.Net.Mime/ContentDisposition.xml
@@ -137,13 +137,16 @@
       </Parameters>
       <Docs>
         <param name="obj">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the content-disposition header of the specified <see cref="T:System.Net.Mime.ContentDisposition" /> object is equal to the content-disposition header of this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the content-disposition headers are the same; otherwise false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="FileName">
@@ -185,13 +188,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the hash code of the specified <see cref="T:System.Net.Mime.ContentDisposition" /> object</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer hash value.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Inline">
@@ -334,7 +340,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -345,6 +350,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.String" /> representation of this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that contains the property values for this instance.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.Net.Mime/ContentType.xml b/mcs/class/System/Documentation/en/System.Net.Mime/ContentType.xml
index e77bf972b56..11f178a9013 100644
--- a/mcs/class/System/Documentation/en/System.Net.Mime/ContentType.xml
+++ b/mcs/class/System/Documentation/en/System.Net.Mime/ContentType.xml
@@ -140,13 +140,16 @@
       </Parameters>
       <Docs>
         <param name="obj">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the content-type header of the specified <see cref="T:System.Net.Mime.ContentType" /> object is equal to the content-type header of this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the content-type headers are the same; otherwise false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -162,13 +165,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the hash code of the specified <see cref="T:System.Net.Mime.ContentType" /> object</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer hash value.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MediaType">
@@ -264,7 +270,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -275,6 +280,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of this <see cref="T:System.Net.Mime.ContentType" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that contains the current settings for this <see cref="T:System.Net.Mime.ContentType" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.Net.NetworkInformation/GatewayIPAddressInformationCollection.xml b/mcs/class/System/Documentation/en/System.Net.NetworkInformation/GatewayIPAddressInformationCollection.xml
index d22d28359fb..3f0f1c9096c 100644
--- a/mcs/class/System/Documentation/en/System.Net.NetworkInformation/GatewayIPAddressInformationCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Net.NetworkInformation/GatewayIPAddressInformationCollection.xml
@@ -106,13 +106,16 @@
         <Parameter Name="address" Type="System.Net.NetworkInformation.GatewayIPAddressInformation" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks whether the collection contains the specified <see cref="T:System.Net.NetworkInformation.GatewayIPAddressInformation" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Net.NetworkInformation.GatewayIPAddressInformation" /> object exists in the collection; otherwise false.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.NetworkInformation.GatewayIPAddressInformation" /> object to be searched in the collection.</param>
       </Docs>
@@ -182,7 +185,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -194,6 +196,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that can be used to iterate through this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that implements the <see cref="T:System.Collections.IEnumerator" /> interface and provides access to the <see cref="T:System.Net.NetworkInformation.UnicastIPAddressInformation" /> types in this collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsReadOnly">
@@ -254,13 +260,16 @@
         <Parameter Name="address" Type="System.Net.NetworkInformation.GatewayIPAddressInformation" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Throws a <see cref="T:System.NotSupportedException" /> because this operation is not supported for this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always throws a <see cref="T:System.NotSupportedException" />.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be removed.</param>
       </Docs>
@@ -278,7 +287,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The object that is returned by this method is initially positioned before the first element in this collection. You must call the <see cref="M:System.Collections.IEnumerator.MoveNext" /> method before you can access the first element. To access the element at the current position, call the <see cref="P:System.Collections.IEnumerator.Current" /> property.</para>
@@ -289,6 +297,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that can be used to iterate through this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that implements the <see cref="T:System.Collections.IEnumerator" /> interface and provides access to the <see cref="T:System.Net.NetworkInformation.UnicastIPAddressInformation" /> types in this collection.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.Net.NetworkInformation/IPAddressCollection.xml b/mcs/class/System/Documentation/en/System.Net.NetworkInformation/IPAddressCollection.xml
index a96d1fa3df3..08409cdd0c4 100644
--- a/mcs/class/System/Documentation/en/System.Net.NetworkInformation/IPAddressCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Net.NetworkInformation/IPAddressCollection.xml
@@ -105,13 +105,16 @@
         <Parameter Name="address" Type="System.Net.IPAddress" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks whether the collection contains the specified <see cref="T:System.Net.IPAddress" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Net.IPAddress" /> object exists in the collection; otherwise, false.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.IPAddress" /> object to be searched in the collection.</param>
       </Docs>
@@ -181,7 +184,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -193,6 +195,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that can be used to iterate through this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that implements the <see cref="T:System.Collections.IEnumerator" /> interface and provides access to the <see cref="T:System.Net.NetworkInformation.IPAddressCollection" /> types in this collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsReadOnly">
@@ -253,13 +259,16 @@
         <Parameter Name="address" Type="System.Net.IPAddress" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Throws a <see cref="T:System.NotSupportedException" /> because this operation is not supported for this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always throws a <see cref="T:System.NotSupportedException" />.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be removed.</param>
       </Docs>
@@ -277,7 +286,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The object that is returned by this method is initially positioned before the first element in this collection. You must call the <see cref="M:System.Collections.IEnumerator.MoveNext" /> method before you can access the first element. To access the element at the current position, call the <see cref="P:System.Collections.IEnumerator.Current" /> property.</para>
@@ -288,6 +296,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that can be used to iterate through this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that implements the <see cref="T:System.Collections.IEnumerator" /> interface and provides access to the <see cref="T:System.Net.NetworkInformation.IPAddressCollection" /> types in this collection.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.Net.NetworkInformation/IPAddressInformationCollection.xml b/mcs/class/System/Documentation/en/System.Net.NetworkInformation/IPAddressInformationCollection.xml
index e005cf6a85c..b3fc71704fc 100644
--- a/mcs/class/System/Documentation/en/System.Net.NetworkInformation/IPAddressInformationCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Net.NetworkInformation/IPAddressInformationCollection.xml
@@ -91,13 +91,16 @@
         <Parameter Name="address" Type="System.Net.NetworkInformation.IPAddressInformation" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks whether the collection contains the specified <see cref="T:System.Net.NetworkInformation.IPAddressInformation" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Net.NetworkInformation.IPAddressInformation" /> object exists in the collection; otherwise. false.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.NetworkInformation.IPAddressInformation" /> object to be searched in the collection.</param>
       </Docs>
@@ -167,7 +170,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -179,6 +181,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that can be used to iterate through this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that implements the <see cref="T:System.Collections.IEnumerator" /> interface and provides access to the <see cref="T:System.Net.NetworkInformation.IPAddressInformation" /> types in this collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsReadOnly">
@@ -239,13 +245,16 @@
         <Parameter Name="address" Type="System.Net.NetworkInformation.IPAddressInformation" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Throws a <see cref="T:System.NotSupportedException" /> because this operation is not supported for this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always throws a <see cref="T:System.NotSupportedException" />.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be removed.</param>
       </Docs>
@@ -263,7 +272,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The object that is returned by this method is initially positioned before the first element in this collection. You must call the <see cref="M:System.Collections.IEnumerator.MoveNext" /> method before you can access the first element. To access the element at the current position, call the <see cref="P:System.Collections.IEnumerator.Current" /> property.</para>
@@ -274,6 +282,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that can be used to iterate through this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that implements the <see cref="T:System.Collections.IEnumerator" /> interface and provides access to the <see cref="T:System.Net.NetworkInformation.IPAddressInformation" /> types in this collection.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.Net.NetworkInformation/IPGlobalProperties.xml b/mcs/class/System/Documentation/en/System.Net.NetworkInformation/IPGlobalProperties.xml
index 205ead43510..a9e7d59b0cb 100644
--- a/mcs/class/System/Documentation/en/System.Net.NetworkInformation/IPGlobalProperties.xml
+++ b/mcs/class/System/Documentation/en/System.Net.NetworkInformation/IPGlobalProperties.xml
@@ -103,7 +103,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -114,6 +113,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns information about the Internet Protocol version 4 (IPv4) and IPv6 Transmission Control Protocol (TCP) connections on the local computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.NetworkInformation.TcpConnectionInformation" /> array that contains objects that describe the active TCP connections, or an empty array if no active TCP connections are detected.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetActiveTcpListeners">
@@ -129,7 +132,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -140,6 +142,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns endpoint information about the Internet Protocol version 4 (IPv4) and IPv6 Transmission Control Protocol (TCP) listeners on the local computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.IPEndPoint" /> array that contains objects that describe the active TCP listeners, or an empty array, if no active TCP listeners are detected.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetActiveUdpListeners">
@@ -155,7 +161,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -166,6 +171,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns information about the Internet Protocol version 4 (IPv4) and IPv6 User Datagram Protocol (UDP) listeners on the local computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.IPEndPoint" /> array that contains objects that describe the UDP listeners, or an empty array if no UDP listeners are detected.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetIcmpV4Statistics">
@@ -181,7 +190,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -192,6 +200,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides Internet Control Message Protocol (ICMP) version 4 statistical data for the local computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.NetworkInformation.IcmpV4Statistics" /> object that provides ICMP version 4 traffic statistics for the local computer.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetIcmpV6Statistics">
@@ -207,7 +219,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -219,6 +230,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides Internet Control Message Protocol (ICMP) version 6 statistical data for the local computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.NetworkInformation.IcmpV6Statistics" /> object that provides ICMP version 6 traffic statistics for the local computer.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetIPGlobalProperties">
@@ -234,7 +249,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -244,6 +258,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an object that provides information about the local computer's network connectivity and traffic statistics.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.NetworkInformation.IPGlobalProperties" /> object that contains information about the local computer.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetIPv4GlobalStatistics">
@@ -259,7 +277,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -270,6 +287,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides Internet Protocol version 4 (IPv4) statistical data for the local computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.NetworkInformation.IPGlobalStatistics" /> object that provides IPv4 traffic statistics for the local computer.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetIPv6GlobalStatistics">
@@ -285,7 +306,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -296,6 +316,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides Internet Protocol version 6 (IPv6) statistical data for the local computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.NetworkInformation.IPGlobalStatistics" /> object that provides IPv6 traffic statistics for the local computer.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetTcpIPv4Statistics">
@@ -311,7 +335,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -322,6 +345,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides Transmission Control Protocol/Internet Protocol version 4 (TCP/IPv4) statistical data for the local computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.NetworkInformation.TcpStatistics" /> object that provides TCP/IPv4 traffic statistics for the local computer.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetTcpIPv6Statistics">
@@ -337,7 +364,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -348,6 +374,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides Transmission Control Protocol/Internet Protocol version 6 (TCP/IPv6) statistical data for the local computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.NetworkInformation.TcpStatistics" /> object that provides TCP/IPv6 traffic statistics for the local computer.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetUdpIPv4Statistics">
@@ -363,7 +393,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -374,6 +403,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides User Datagram Protocol/Internet Protocol version 4 (UDP/IPv4) statistical data for the local computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.NetworkInformation.UdpStatistics" /> object that provides UDP/IPv4 traffic statistics for the local computer.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetUdpIPv6Statistics">
@@ -389,7 +422,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -400,6 +432,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides User Datagram Protocol/Internet Protocol version 6 (UDP/IPv6) statistical data for the local computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.NetworkInformation.UdpStatistics" /> object that provides UDP/IPv6 traffic statistics for the local computer.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HostName">
diff --git a/mcs/class/System/Documentation/en/System.Net.NetworkInformation/IPInterfaceProperties.xml b/mcs/class/System/Documentation/en/System.Net.NetworkInformation/IPInterfaceProperties.xml
index 3a718160dbd..7f1a69359f1 100644
--- a/mcs/class/System/Documentation/en/System.Net.NetworkInformation/IPInterfaceProperties.xml
+++ b/mcs/class/System/Documentation/en/System.Net.NetworkInformation/IPInterfaceProperties.xml
@@ -178,7 +178,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -189,6 +188,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides Internet Protocol version 4 (IPv4) configuration data for this network interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.NetworkInformation.IPv4InterfaceProperties" /> object that contains IPv4 configuration data, or null if no data is available for the interface.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetIPv6Properties">
@@ -204,7 +207,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -214,6 +216,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides Internet Protocol version 6 (IPv6) configuration data for this network interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.NetworkInformation.IPv6InterfaceProperties" /> object that contains IPv6 configuration data.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsDnsEnabled">
diff --git a/mcs/class/System/Documentation/en/System.Net.NetworkInformation/MulticastIPAddressInformationCollection.xml b/mcs/class/System/Documentation/en/System.Net.NetworkInformation/MulticastIPAddressInformationCollection.xml
index 463275e72dd..9cb8cc7e842 100644
--- a/mcs/class/System/Documentation/en/System.Net.NetworkInformation/MulticastIPAddressInformationCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Net.NetworkInformation/MulticastIPAddressInformationCollection.xml
@@ -105,13 +105,16 @@
         <Parameter Name="address" Type="System.Net.NetworkInformation.MulticastIPAddressInformation" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks whether the collection contains the specified <see cref="T:System.Net.NetworkInformation.MulticastIPAddressInformation" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Net.NetworkInformation.MulticastIPAddressInformation" /> object exists in the collection; otherwise, false.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.NetworkInformation.MulticastIPAddressInformation" /> object to be searched in the collection.</param>
       </Docs>
@@ -181,7 +184,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -193,6 +195,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that can be used to iterate through this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that implements the <see cref="T:System.Collections.IEnumerator" /> interface and provides access to the <see cref="T:System.Net.NetworkInformation.UnicastIPAddressInformation" /> types in this collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsReadOnly">
@@ -253,13 +259,16 @@
         <Parameter Name="address" Type="System.Net.NetworkInformation.MulticastIPAddressInformation" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Throws a <see cref="T:System.NotSupportedException" /> because the collection is read-only and elements cannot be removed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always throws a <see cref="T:System.NotSupportedException" />.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be removed.</param>
       </Docs>
@@ -277,7 +286,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The object that is returned by this method is initially positioned before the first element in this collection. You must call the <see cref="M:System.Collections.IEnumerator.MoveNext" /> method before you can access the first element. To access the element at the current position, call the <see cref="P:System.Collections.IEnumerator.Current" /> property.</para>
@@ -288,6 +296,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that can be used to iterate through this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that implements the <see cref="T:System.Collections.IEnumerator" /> interface and provides access to the <see cref="T:System.Net.NetworkInformation.UnicastIPAddressInformation" /> types in this collection.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.Net.NetworkInformation/NetworkInformationPermission.xml b/mcs/class/System/Documentation/en/System.Net.NetworkInformation/NetworkInformationPermission.xml
index 919be25f673..355e6560022 100644
--- a/mcs/class/System/Documentation/en/System.Net.NetworkInformation/NetworkInformationPermission.xml
+++ b/mcs/class/System/Documentation/en/System.Net.NetworkInformation/NetworkInformationPermission.xml
@@ -168,7 +168,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -178,6 +177,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an identical copy of this permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.NetworkInformation.NetworkInformationPermission" /> that is identical to the current permission</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="FromXml">
@@ -233,7 +236,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -243,6 +245,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a permission that is the intersection of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.NetworkInformation.NetworkInformationPermission" /> that represents the intersection of the current permission and the specified permission. This new permission is null if the intersection is empty or <paramref name="target" /> is null.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Security.IPermission" /> to intersect with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
@@ -267,7 +273,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -277,6 +282,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current permission is a subset of the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is a subset of the specified permission; otherwise, false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Security.IPermission" /> that is to be tested for the subset relationship. This permission must be of the same type as the current permission</param>
       </Docs>
@@ -299,7 +308,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -309,6 +317,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the current permission is unrestricted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is unrestricted; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToXml">
@@ -329,7 +341,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -339,6 +350,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the state of this permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.SecurityElement" /> that contains the XML encoding of the current permission.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Union">
@@ -361,7 +376,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -371,6 +385,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a permission that is the union of this permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the union of the current permission and the specified permission.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Net.NetworkInformation.NetworkInformationPermission" />  permission to combine with the current permission. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Net.NetworkInformation/NetworkInformationPermissionAttribute.xml b/mcs/class/System/Documentation/en/System.Net.NetworkInformation/NetworkInformationPermissionAttribute.xml
index 465be35ea62..b22e93bcabe 100644
--- a/mcs/class/System/Documentation/en/System.Net.NetworkInformation/NetworkInformationPermissionAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.Net.NetworkInformation/NetworkInformationPermissionAttribute.xml
@@ -132,7 +132,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -142,6 +141,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new <see cref="T:System.Net.NetworkInformation.NetworkInformationPermission" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.NetworkInformation.NetworkInformationPermission" /> that corresponds to this attribute.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.Net.NetworkInformation/NetworkInterface.xml b/mcs/class/System/Documentation/en/System.Net.NetworkInformation/NetworkInterface.xml
index d6d53e433bf..51bafb285b4 100644
--- a/mcs/class/System/Documentation/en/System.Net.NetworkInformation/NetworkInterface.xml
+++ b/mcs/class/System/Documentation/en/System.Net.NetworkInformation/NetworkInterface.xml
@@ -81,7 +81,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -91,6 +90,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns objects that describe the network interfaces on the local computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.NetworkInformation.NetworkInterface" /> array that contains objects that describe the available network interfaces, or an empty array if no interfaces are detected.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetIPProperties">
@@ -106,7 +109,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -116,6 +118,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that describes the configuration of this network interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.NetworkInformation.IPInterfaceProperties" /> object that describes this network interface.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetIPv4Statistics">
@@ -131,13 +137,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the IPv4 statistics for this <see cref="T:System.Net.NetworkInformation.NetworkInterface" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.NetworkInformation.IPv4InterfaceStatistics" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetIsNetworkAvailable">
@@ -158,7 +167,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -168,6 +176,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether any network connection is available.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a network connection is available; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetPhysicalAddress">
@@ -183,7 +195,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -193,6 +204,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the Media Access Control (MAC) or physical address for this adapter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.NetworkInformation.PhysicalAddress" /> object that contains the physical address.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Id">
@@ -413,13 +428,16 @@
         <Parameter Name="networkInterfaceComponent" Type="System.Net.NetworkInformation.NetworkInterfaceComponent" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Boolean" /> value that indicates whether the interface supports the specified protocol.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified protocol is supported; otherwise, false.</para>
+        </returns>
         <param name="networkInterfaceComponent">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Net.NetworkInformation.NetworkInterfaceComponent" /> value.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Net.NetworkInformation/PhysicalAddress.xml b/mcs/class/System/Documentation/en/System.Net.NetworkInformation/PhysicalAddress.xml
index 02c37f9bfce..9fdac11d941 100644
--- a/mcs/class/System/Documentation/en/System.Net.NetworkInformation/PhysicalAddress.xml
+++ b/mcs/class/System/Documentation/en/System.Net.NetworkInformation/PhysicalAddress.xml
@@ -65,13 +65,16 @@
         <Parameter Name="comparand" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Net.NetworkInformation.PhysicalAddress" /> instances.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this instance and the specified instance contain the same address; otherwise false.</para>
+        </returns>
         <param name="comparand">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.NetworkInformation.PhysicalAddress" />  to compare to the current instance.</param>
       </Docs>
@@ -89,13 +92,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the address of the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Byte" /> array containing the address.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -111,13 +117,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash value of a physical address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer hash value.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="None">
@@ -158,7 +167,6 @@
         <Parameter Name="address" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -173,6 +181,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Parses the specified <see cref="T:System.String" /> and stores its contents as the address bytes of the <see cref="T:System.Net.NetworkInformation.PhysicalAddress" /> returned by this method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.NetworkInformation.PhysicalAddress" /> instance with the specified address.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> containing the address that will be used to initialize the <see cref="T:System.Net.NetworkInformation.PhysicalAddress" /> instance returned by this method.</param>
       </Docs>
@@ -190,13 +202,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.String" /> representation of the address of this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the address contained in this instance.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.Net.NetworkInformation/Ping.xml b/mcs/class/System/Documentation/en/System.Net.NetworkInformation/Ping.xml
index c15d1ebafd7..7cb55b1d2cd 100644
--- a/mcs/class/System/Documentation/en/System.Net.NetworkInformation/Ping.xml
+++ b/mcs/class/System/Documentation/en/System.Net.NetworkInformation/Ping.xml
@@ -211,7 +211,6 @@
         <Parameter Name="address" Type="System.Net.IPAddress" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -222,6 +221,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to send an Internet Control Message Protocol (ICMP) echo message to the computer that has the specified <see cref="T:System.Net.IPAddress" />, and receive a corresponding ICMP echo reply message from that computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.NetworkInformation.PingReply" /> object that provides information about the ICMP echo reply message, if one was received, or describes the reason for the failure if no message was received.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Net.IPAddress" /> that identifies the computer that is the destination for the ICMP echo message.</param>
       </Docs>
@@ -241,7 +244,6 @@
         <Parameter Name="hostNameOrAddress" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -252,6 +254,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to send an Internet Control Message Protocol (ICMP) echo message to the specified computer, and receive a corresponding ICMP echo reply message from that computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.NetworkInformation.PingReply" /> object that provides information about the ICMP echo reply message, if one was received, or provides the reason for the failure, if no message was received.</para>
+        </returns>
         <param name="hostNameOrAddress">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that identifies the computer that is the destination for the ICMP echo message. The value specified for this parameter can be a host name or a string representation of an IP address.</param>
       </Docs>
@@ -272,7 +278,6 @@
         <Parameter Name="timeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -287,6 +292,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified <see cref="T:System.Net.IPAddress" />, and receive a corresponding ICMP echo reply message from that computer. This method allows you to specify a time-out value for the operation. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.NetworkInformation.PingReply" /> object that provides information about the ICMP echo reply message if one was received, or provides the reason for the failure if no message was received.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Net.IPAddress" /> that identifies the computer that is the destination for the ICMP echo message.</param>
         <param name="timeout">
@@ -309,7 +318,6 @@
         <Parameter Name="timeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -323,6 +331,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to send an Internet Control Message Protocol (ICMP) echo message to the specified computer, and receive a corresponding ICMP echo reply message from that computer. This method allows you to specify a time-out value for the operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.NetworkInformation.PingReply" /> object that provides information about the ICMP echo reply message if one was received, or provides the reason for the failure if no message was received.</para>
+        </returns>
         <param name="hostNameOrAddress">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that identifies the computer that is the destination for the ICMP echo message. The value specified for this parameter can be a host name or a string representation of an IP address.</param>
         <param name="timeout">
@@ -346,7 +358,6 @@
         <Parameter Name="buffer" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -361,6 +372,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified <see cref="T:System.Net.IPAddress" />, and receive a corresponding ICMP echo reply message from that computer. This overload allows you to specify a time-out value for the operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.NetworkInformation.PingReply" /> object that provides information about the ICMP echo reply message, if one was received, or provides the reason for the failure, if no message was received. The method will return <see cref="F:System.Net.NetworkInformation.IPStatus.PacketTooBig" /> if the packet exceeds the Maximum Transmission Unit (MTU).</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Net.IPAddress" /> that identifies the computer that is the destination for the ICMP echo message.</param>
         <param name="timeout">
@@ -386,7 +401,6 @@
         <Parameter Name="buffer" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -401,6 +415,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the specified computer, and receive a corresponding ICMP echo reply message from that computer. This overload allows you to specify a time-out value for the operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.NetworkInformation.PingReply" /> object that provides information about the ICMP echo reply message if one was received, or provides the reason for the failure if no message was received.</para>
+        </returns>
         <param name="hostNameOrAddress">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that identifies the computer that is the destination for the ICMP echo message. The value specified for this parameter can be a host name or a string representation of an IP address.</param>
         <param name="timeout">
@@ -427,7 +445,6 @@
         <Parameter Name="options" Type="System.Net.NetworkInformation.PingOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -442,6 +459,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified <see cref="T:System.Net.IPAddress" /> and receive a corresponding ICMP echo reply message from that computer. This overload allows you to specify a time-out value for the operation and control fragmentation and Time-to-Live values for the ICMP echo message packet.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.NetworkInformation.PingReply" /> object that provides information about the ICMP echo reply message, if one was received, or provides the reason for the failure, if no message was received. The method will return <see cref="F:System.Net.NetworkInformation.IPStatus.PacketTooBig" /> if the packet exceeds the Maximum Transmission Unit (MTU).</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Net.IPAddress" /> that identifies the computer that is the destination for the ICMP echo message.</param>
         <param name="timeout">
@@ -470,7 +491,6 @@
         <Parameter Name="options" Type="System.Net.NetworkInformation.PingOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -485,6 +505,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the specified computer, and receive a corresponding ICMP echo reply message from that computer. This overload allows you to specify a time-out value for the operation and control fragmentation and Time-to-Live values for the ICMP packet.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.NetworkInformation.PingReply" /> object that provides information about the ICMP echo reply message if one was received, or provides the reason for the failure if no message was received.</para>
+        </returns>
         <param name="hostNameOrAddress">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that identifies the computer that is the destination for the ICMP echo message. The value specified for this parameter can be a host name or a string representation of an IP address.</param>
         <param name="timeout">
@@ -869,7 +893,6 @@
         <Parameter Name="address" Type="System.Net.IPAddress" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" />&gt; object will complete after the ICMP packet has been sent and the response has been received.</para>
@@ -878,6 +901,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified <see cref="T:System.Net.IPAddress" />, and receives a corresponding ICMP echo reply message from that computer as an asynchronous operation. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />An IP address that identifies the computer that is the destination for the ICMP echo message.</param>
       </Docs>
@@ -896,7 +924,6 @@
         <Parameter Name="hostNameOrAddress" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" />&gt; object will complete after the ICMP packet has been sent and the response has been received.</para>
@@ -905,6 +932,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the specified computer, and receive a corresponding ICMP echo reply message from that computer as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="hostNameOrAddress">
           <attribution license="cc4" from="Microsoft" modified="false" />The computer that is the destination for the ICMP echo message. The value specified for this parameter can be a host name or a string representation of an IP address.</param>
       </Docs>
@@ -924,7 +956,6 @@
         <Parameter Name="timeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" />&gt; object will complete after the ICMP packet has been sent and the response has been received.</para>
@@ -933,6 +964,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified <see cref="T:System.Net.IPAddress" />, and receives a corresponding ICMP echo reply message from that computer as an asynchronous operation. This overload allows you to specify a time-out value for the operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />An IP address that identifies the computer that is the destination for the ICMP echo message.</param>
         <param name="timeout">
@@ -954,7 +990,6 @@
         <Parameter Name="timeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" />&gt; object will complete after the ICMP packet has been sent and the response has been received.</para>
@@ -963,6 +998,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the specified computer, and receive a corresponding ICMP echo reply message from that computer as an asynchronous operation. This overload allows you to specify a time-out value for the operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="hostNameOrAddress">
           <attribution license="cc4" from="Microsoft" modified="false" />The computer that is the destination for the ICMP echo message. The value specified for this parameter can be a host name or a string representation of an IP address.</param>
         <param name="timeout">
@@ -985,7 +1025,6 @@
         <Parameter Name="buffer" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" />&gt; object will complete after the ICMP packet has been sent and the response has been received.</para>
@@ -994,6 +1033,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified <see cref="T:System.Net.IPAddress" />, and receives a corresponding ICMP echo reply message from that computer as an asynchronous operation. This overload allows you to specify a time-out value for the operation and a buffer to use for send and receive.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />An IP address that identifies the computer that is the destination for the ICMP echo message.</param>
         <param name="timeout">
@@ -1018,7 +1062,6 @@
         <Parameter Name="buffer" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" />&gt; object will complete after the ICMP packet has been sent and the response has been received.</para>
@@ -1027,6 +1070,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the specified computer, and receive a corresponding ICMP echo reply message from that computer as an asynchronous operation. This overload allows you to specify a time-out value for the operation and a buffer to use for send and receive.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="hostNameOrAddress">
           <attribution license="cc4" from="Microsoft" modified="false" />The computer that is the destination for the ICMP echo message. The value specified for this parameter can be a host name or a string representation of an IP address.</param>
         <param name="timeout">
@@ -1052,7 +1100,6 @@
         <Parameter Name="options" Type="System.Net.NetworkInformation.PingOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" />&gt; object will complete after the ICMP packet has been sent and the response has been received.</para>
@@ -1061,6 +1108,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the computer that has the specified <see cref="T:System.Net.IPAddress" />, and receives a corresponding ICMP echo reply message from that computer as an asynchronous operation. This overload allows you to specify a time-out value for the operation, a buffer to use for send and receive, and control fragmentation and Time-to-Live values for the ICMP echo message packet.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />An IP address that identifies the computer that is the destination for the ICMP echo message.</param>
         <param name="timeout">
@@ -1088,7 +1140,6 @@
         <Parameter Name="options" Type="System.Net.NetworkInformation.PingOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" />&gt; object will complete after the ICMP packet has been sent and the response has been received.</para>
@@ -1097,6 +1148,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends an Internet Control Message Protocol (ICMP) echo message with the specified data buffer to the specified computer, and receive a corresponding ICMP echo reply message from that computer as an asynchronous operation. This overload allows you to specify a time-out value for the operation, a buffer to use for send and receive, and control fragmentation and Time-to-Live values for the ICMP echo message packet.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="hostNameOrAddress">
           <attribution license="cc4" from="Microsoft" modified="false" />The computer that is the destination for the ICMP echo message. The value specified for this parameter can be a host name or a string representation of an IP address.</param>
         <param name="timeout">
diff --git a/mcs/class/System/Documentation/en/System.Net.NetworkInformation/UnicastIPAddressInformationCollection.xml b/mcs/class/System/Documentation/en/System.Net.NetworkInformation/UnicastIPAddressInformationCollection.xml
index ad8daa775c7..8bd4fd4dee5 100644
--- a/mcs/class/System/Documentation/en/System.Net.NetworkInformation/UnicastIPAddressInformationCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Net.NetworkInformation/UnicastIPAddressInformationCollection.xml
@@ -105,13 +105,16 @@
         <Parameter Name="address" Type="System.Net.NetworkInformation.UnicastIPAddressInformation" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks whether the collection contains the specified <see cref="T:System.Net.NetworkInformation.UnicastIPAddressInformation" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Net.NetworkInformation.UnicastIPAddressInformation" /> object exists in the collection; otherwise, false.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.NetworkInformation.UnicastIPAddressInformation" /> object to be searched in the collection.</param>
       </Docs>
@@ -181,7 +184,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -193,6 +195,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that can be used to iterate through this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that implements the <see cref="T:System.Collections.IEnumerator" /> interface and provides access to the <see cref="T:System.Net.NetworkInformation.UnicastIPAddressInformation" /> types in this collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsReadOnly">
@@ -253,13 +259,16 @@
         <Parameter Name="address" Type="System.Net.NetworkInformation.UnicastIPAddressInformation" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Throws a <see cref="T:System.NotSupportedException" /> because the collection is read-only and elements cannot be removed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always throws a <see cref="T:System.NotSupportedException" />.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be removed.</param>
       </Docs>
@@ -277,7 +286,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The object that is returned by this method is initially positioned before the first element in this collection. You must call the <see cref="M:System.Collections.IEnumerator.MoveNext" /> method before you can access the first element. To access the element at the current position, call the <see cref="P:System.Collections.IEnumerator.Current" /> property.</para>
@@ -288,6 +296,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that can be used to iterate through this collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that implements the <see cref="T:System.Collections.IEnumerator" /> interface and provides access to the <see cref="T:System.Net.NetworkInformation.UnicastIPAddressInformation" /> types in this collection.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.Net.Security/NegotiateStream.xml b/mcs/class/System/Documentation/en/System.Net.Security/NegotiateStream.xml
index 3485e1d0098..89079e80af8 100644
--- a/mcs/class/System/Documentation/en/System.Net.Security/NegotiateStream.xml
+++ b/mcs/class/System/Documentation/en/System.Net.Security/NegotiateStream.xml
@@ -304,7 +304,6 @@
         <Parameter Name="asyncState" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -317,6 +316,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called by clients to begin an asynchronous operation to authenticate the client, and optionally the server, in a client-server connection. This method does not block.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object indicating the status of the asynchronous operation. </para>
+        </returns>
         <param name="asyncCallback">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.AsyncCallback" /> delegate that references the method to invoke when the authentication is complete.</param>
         <param name="asyncState">
@@ -346,7 +349,6 @@
         <Parameter Name="asyncState" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -358,6 +360,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called by clients to begin an asynchronous operation to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified credentials. This method does not block.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object indicating the status of the asynchronous operation. </para>
+        </returns>
         <param name="credential">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.NetworkCredential" /> that is used to establish the identity of the client.</param>
         <param name="targetName">
@@ -393,7 +399,6 @@
         <Parameter Name="asyncState" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -406,6 +411,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called by clients to begin an asynchronous operation to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified credentials and authentication options. This method does not block.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object indicating the status of the asynchronous operation. </para>
+        </returns>
         <param name="credential">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.NetworkCredential" /> that is used to establish the identity of the client.</param>
         <param name="targetName">
@@ -441,7 +450,6 @@
         <Parameter Name="asyncState" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -454,6 +462,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called by servers to begin an asynchronous operation to authenticate the client, and optionally the server, in a client-server connection. This method does not block.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object indicating the status of the asynchronous operation. </para>
+        </returns>
         <param name="asyncCallback">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.AsyncCallback" /> delegate that references the method to invoke when the authentication is complete.</param>
         <param name="asyncState">
@@ -484,7 +496,6 @@
         <Parameter Name="asyncState" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -497,6 +508,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called by servers to begin an asynchronous operation to authenticate the client, and optionally the server, in a client-server connection. The authentication process uses the specified server credentials and authentication options. This method does not block.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object indicating the status of the asynchronous operation. </para>
+        </returns>
         <param name="credential">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.NetworkCredential" /> that is used to establish the identity of the client.</param>
         <param name="requiredProtectionLevel">
@@ -533,7 +548,6 @@
         <Parameter Name="asyncState" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -547,6 +561,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous read operation that reads data from the stream and stores it in the specified array. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object indicating the status of the asynchronous operation. </para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Byte" /> array that receives the bytes read from the stream.</param>
         <param name="offset">
@@ -583,7 +601,6 @@
         <Parameter Name="asyncState" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -597,6 +614,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous write operation that writes <see cref="T:System.Byte" />s from the specified buffer to the stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object indicating the status of the asynchronous operation. </para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Byte" /> array that supplies the bytes to be written to the stream.</param>
         <param name="offset">
@@ -835,7 +856,6 @@
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -847,6 +867,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ends an asynchronous read operation that was started with a call to <see cref="M:System.Net.Security.NegotiateStream.BeginRead(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Int32" /> value that specifies the number of bytes read from the underlying stream.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IAsyncResult" /> instance returned by a call to <see cref="M:System.Net.Security.NegotiateStream.BeginRead(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)" /> </param>
       </Docs>
@@ -1161,7 +1185,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1173,6 +1196,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads data from this stream and stores it in the specified array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Int32" /> value that specifies the number of bytes read from the underlying stream. When there is no more data to be read, returns 0.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Byte" /> array that receives the bytes read from the stream.</param>
         <param name="offset">
@@ -1256,7 +1283,6 @@
         <Parameter Name="origin" Type="System.IO.SeekOrigin" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1266,6 +1292,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Throws <see cref="T:System.NotSupportedException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always throws a <see cref="T:System.NotSupportedException" />.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />This value is ignored.</param>
         <param name="origin">
diff --git a/mcs/class/System/Documentation/en/System.Net.Security/SslStream.xml b/mcs/class/System/Documentation/en/System.Net.Security/SslStream.xml
index 8174b7efaab..ebb2724a29f 100644
--- a/mcs/class/System/Documentation/en/System.Net.Security/SslStream.xml
+++ b/mcs/class/System/Documentation/en/System.Net.Security/SslStream.xml
@@ -327,7 +327,6 @@
         <Parameter Name="targetHost" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method authenticates using <see cref="F:System.Security.Authentication.SslProtocols.Default" />. No client certificates are used in the authentication. The certificate revocation list is not checked during authentication. The value specified for <paramref name="targetHost" /> must match the name on the server's certificate. </para>
@@ -338,6 +337,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called by clients to authenticate the server and optionally the client in a client-server connection as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task" /></para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="targetHost">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the server that shares this <see cref="T:System.Net.Security.SslStream" />.</param>
       </Docs>
@@ -359,7 +363,6 @@
         <Parameter Name="checkCertificateRevocation" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When authentication succeeds, you must check the <see cref="P:System.Net.Security.SslStream.IsEncrypted" /> and <see cref="P:System.Net.Security.SslStream.IsSigned" /> properties to determine what security services are used by the <see cref="T:System.Net.Security.SslStream" />. Check the <see cref="P:System.Net.Security.SslStream.IsMutuallyAuthenticated" /> property to determine whether mutual authentication occurred.</para>
@@ -372,6 +375,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called by clients to authenticate the server and optionally the client in a client-server connection as an asynchronous operation. The authentication process uses the specified certificate collection and SSL protocol.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task" /></para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="targetHost">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the server that will share this <see cref="T:System.Net.Security.SslStream" />.</param>
         <param name="clientCertificates">
@@ -464,7 +472,6 @@
         <Parameter Name="serverCertificate" Type="System.Security.Cryptography.X509Certificates.X509Certificate" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method authenticates using <see cref="F:System.Security.Authentication.SslProtocols.Default" />. The certificate revocation list is not checked during authentication. The client is not required to provide a certificate for authentication.</para>
@@ -474,6 +481,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called by servers to authenticate the server and optionally the client in a client-server connection using the specified certificate as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task" /></para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="serverCertificate">
           <attribution license="cc4" from="Microsoft" modified="false" />The certificate used to authenticate the server.</param>
       </Docs>
@@ -495,7 +507,6 @@
         <Parameter Name="checkCertificateRevocation" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the authentication fails, you receive a <see cref="T:System.Security.Authentication.AuthenticationException" />, and this <see cref="T:System.Net.Security.SslStream" /> is no longer useable. You should close this object and remove all references to it so that it can be collected by the garbage collector. </para>
@@ -504,6 +515,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called by servers to authenticate the server and optionally the client in a client-server connection using the specified certificates, requirements and security protocol as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task" /></para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="serverCertificate">
           <attribution license="cc4" from="Microsoft" modified="false" />The X509Certificate used to authenticate the server.</param>
         <param name="clientCertificateRequired">
@@ -531,7 +547,6 @@
         <Parameter Name="asyncState" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -546,6 +561,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called by clients to begin an asynchronous operation to authenticate the server and optionally the client.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object that indicates the status of the asynchronous operation. </para>
+        </returns>
         <param name="targetHost">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the server that shares this <see cref="T:System.Net.Security.SslStream" />.</param>
         <param name="asyncCallback">
@@ -574,7 +593,6 @@
         <Parameter Name="asyncState" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -591,6 +609,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called by clients to begin an asynchronous operation to authenticate the server and optionally the client using the specified certificates and security protocol.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object that indicates the status of the asynchronous operation. </para>
+        </returns>
         <param name="targetHost">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the server that shares this <see cref="T:System.Net.Security.SslStream" />.</param>
         <param name="clientCertificates">
@@ -622,7 +644,6 @@
         <Parameter Name="asyncState" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -636,6 +657,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called by servers to begin an asynchronous operation to authenticate the client and optionally the server in a client-server connection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object indicating the status of the asynchronous operation. </para>
+        </returns>
         <param name="serverCertificate">
           <attribution license="cc4" from="Microsoft" modified="false" />The X509Certificate used to authenticate the server.</param>
         <param name="asyncCallback">
@@ -664,7 +689,6 @@
         <Parameter Name="asyncState" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -677,6 +701,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called by servers to begin an asynchronous operation to authenticate the server and optionally the client using the specified certificates, requirements and security protocol.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object that indicates the status of the asynchronous operation. </para>
+        </returns>
         <param name="serverCertificate">
           <attribution license="cc4" from="Microsoft" modified="false" />The X509Certificate used to authenticate the server.</param>
         <param name="clientCertificateRequired">
@@ -710,7 +738,6 @@
         <Parameter Name="asyncState" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -724,6 +751,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous read operation that reads data from the stream and stores it in the specified array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object that indicates the status of the asynchronous operation. </para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Byte" /> array that receives the bytes read from the stream.</param>
         <param name="offset">
@@ -755,13 +786,16 @@
         <Parameter Name="asyncState" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous write operation that writes <see cref="T:System.Byte" />s from the specified buffer to the stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object indicating the status of the asynchronous operation. </para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Byte" /> array that supplies the bytes to be written to the stream.</param>
         <param name="offset">
@@ -1078,7 +1112,6 @@
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1090,6 +1123,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ends an asynchronous read operation started with a previous call to <see cref="M:System.Net.Security.SslStream.BeginRead(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Int32" /> value that specifies the number of bytes read from the underlying stream.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IAsyncResult" /> instance returned by a call to <see cref="M:System.Net.Security.SslStream.BeginRead(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)" /></param>
       </Docs>
@@ -1467,7 +1504,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1479,6 +1515,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads data from this stream and stores it in the specified array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Int32" /> value that specifies the number of bytes read. When there is no more data to be read, returns 0.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Byte" /> array that receives the bytes read from this stream.</param>
         <param name="offset">
@@ -1549,7 +1589,6 @@
         <Parameter Name="origin" Type="System.IO.SeekOrigin" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1559,6 +1598,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Throws a <see cref="T:System.NotSupportedException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always throws a <see cref="T:System.NotSupportedException" />.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />This value is ignored.</param>
         <param name="origin">
diff --git a/mcs/class/System/Documentation/en/System.Net.Sockets/IPPacketInformation.xml b/mcs/class/System/Documentation/en/System.Net.Sockets/IPPacketInformation.xml
index 17ed87b086b..194c4993c5f 100644
--- a/mcs/class/System/Documentation/en/System.Net.Sockets/IPPacketInformation.xml
+++ b/mcs/class/System/Documentation/en/System.Net.Sockets/IPPacketInformation.xml
@@ -54,12 +54,15 @@
         <Parameter Name="comparand" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="comparand" /> is an instance of <see cref="T:System.Net.Sockets.IPPacketInformation" /> and equals the value of the instance; otherwise, false.</para>
+        </returns>
         <param name="comparand">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this instance.</param>
       </Docs>
@@ -77,7 +80,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The hash code is constructed from the values of the <see cref="P:System.Net.Sockets.IPPacketInformation.Address" /> and <see cref="P:System.Net.Sockets.IPPacketInformation.Interface" /> properties.</para>
@@ -86,6 +88,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An Int32 hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Interface">
@@ -126,7 +132,6 @@
       <Docs>
         <param name="p1">To be added.</param>
         <param name="p2">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operator tests both the <see cref="P:System.Net.Sockets.IPPacketInformation.Address" /> and <see cref="P:System.Net.Sockets.IPPacketInformation.Interface" /> values for both arguments.</para>
@@ -135,6 +140,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether two specified <see cref="T:System.Net.Sockets.IPPacketInformation" /> instances are equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="packetInformation1" /> and <paramref name="packetInformation2" /> are equal; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="op_Inequality">
@@ -155,7 +164,6 @@
       <Docs>
         <param name="p1">To be added.</param>
         <param name="p2">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operator tests both the <see cref="P:System.Net.Sockets.IPPacketInformation.Address" /> and <see cref="P:System.Net.Sockets.IPPacketInformation.Interface" /> values for both arguments.</para>
@@ -164,6 +172,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether two specified <see cref="T:System.Net.Sockets.IPPacketInformation" /> instances are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="packetInformation1" /> and <paramref name="packetInformation2" /> are unequal; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.Net.Sockets/NetworkStream.xml b/mcs/class/System/Documentation/en/System.Net.Sockets/NetworkStream.xml
index 8b2fd8ec924..9a19c5f2b20 100644
--- a/mcs/class/System/Documentation/en/System.Net.Sockets/NetworkStream.xml
+++ b/mcs/class/System/Documentation/en/System.Net.Sockets/NetworkStream.xml
@@ -216,10 +216,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.IAsyncResult" /> instance that contains information about the asynchronous operation.
-   </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="buffer" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -261,6 +257,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous read from the <see cref="T:System.Net.Sockets.NetworkStream" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that represents the asynchronous call.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Byte" /> that is the location in memory to store data read from the <see cref="T:System.Net.Sockets.NetworkStream" />. </param>
         <param name="offset">
@@ -295,9 +295,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.IAsyncResult" /> instance that contains information about the asynchronous operation. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="buffer" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -338,6 +335,10 @@ method. For the complete example, see the <see cref="T:System.Net.Sockets.Socket
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous write to a stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that represents the asynchronous call.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Byte" /> that contains the data to write to the <see cref="T:System.Net.Sockets.NetworkStream" />. </param>
         <param name="offset">
@@ -604,10 +605,6 @@ indicates that the current stream does not support writing.</para>
       </Parameters>
       <Docs>
         <param name="ar">A <see cref="T:System.IAsyncResult" /> object that holds the state information for the asynchronous operation. </param>
-        <returns>
-          <para> A <see cref="T:System.Int32" qualify="true" /> containing the number of bytes read from the stream.
-   </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="asyncResult" /> is <see langword="null" />.</exception>
         <exception cref="T:System.IO.IOException">An error occurred while accessing the underlying socket. <para><block subset="none" type="note">This method catches all exceptions thrown by the <see cref="M:System.Net.Sockets.Socket.EndReceive(System.IAsyncResult)" qualify="true" /> method.</block></para></exception>
@@ -631,6 +628,10 @@ indicates that the current stream does not support writing.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Handles the end of an asynchronous read.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes read from the <see cref="T:System.Net.Sockets.NetworkStream" />.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -815,11 +816,6 @@ indicates that the current stream does not support writing.</para>
         <Parameter Name="size" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Int32" qualify="true" /> containing the number of bytes read from the
-   stream.
-   </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="buffer" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -851,6 +847,10 @@ indicates that the current stream does not support writing.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads data from the <see cref="T:System.Net.Sockets.NetworkStream" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes read from the <see cref="T:System.Net.Sockets.NetworkStream" />.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Byte" /> that is the location in memory to store data read from the <see cref="T:System.Net.Sockets.NetworkStream" />. </param>
         <param name="offset">
@@ -929,7 +929,6 @@ indicates that the current stream does not support writing.</para>
         <Parameter Name="origin" Type="System.IO.SeekOrigin" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <block subset="none" type="note">
             <para> The <see cref="T:System.IO.Stream" /> base class uses this method to set the current
@@ -943,6 +942,10 @@ indicates that the current stream does not support writing.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the current position of the stream to the given value. This method is not currently supported and always throws a <see cref="T:System.NotSupportedException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position in the stream.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is not used. </param>
         <param name="origin">
diff --git a/mcs/class/System/Documentation/en/System.Net.Sockets/Socket.xml b/mcs/class/System/Documentation/en/System.Net.Sockets/Socket.xml
index fd2372e732d..f9af69eaf40 100644
--- a/mcs/class/System/Documentation/en/System.Net.Sockets/Socket.xml
+++ b/mcs/class/System/Documentation/en/System.Net.Sockets/Socket.xml
@@ -451,10 +451,6 @@ public class Client {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A new connected <see cref="T:System.Net.Sockets.Socket" />
-instance.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">An error occurred while creating the new <see cref="T:System.Net.Sockets.Socket" />.</exception>
         <exception cref="T:System.InvalidOperationException">
           <para>An asynchronous call is pending and a blocking method has been called.</para>
@@ -485,6 +481,10 @@ instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Net.Sockets.Socket" /> for a newly created connection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.Sockets.Socket" /> for a newly created connection.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -503,7 +503,6 @@ instance.</para>
         <Parameter Name="e" Type="System.Net.Sockets.SocketAsyncEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Connection-oriented protocols can use the <see cref="M:System.Net.Sockets.Socket.AcceptAsync(System.Net.Sockets.SocketAsyncEventArgs)" /> method to asynchronously process incoming connection attempts. Accepting connections asynchronously gives you the ability to send and receive data within a separate execution thread. Before calling the <see cref="M:System.Net.Sockets.Socket.AcceptAsync(System.Net.Sockets.SocketAsyncEventArgs)" /> method, you must call the <see cref="M:System.Net.Sockets.Socket.Listen(System.Int32)" /> method to listen for and queue incoming connection requests.</para>
@@ -527,6 +526,11 @@ instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to accept an incoming connection attempt.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the I/O operation is pending. The <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> event on the <paramref name="e" /> parameter will be raised upon completion of the operation.</para>
+          <para>Returns false if the I/O operation completed synchronously. The <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> event on the <paramref name="e" /> parameter will not be raised and the <paramref name="e" /> object passed as a parameter may be examined immediately after the method call returns to retrieve the result of the operation.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.Sockets.SocketAsyncEventArgs" /> object to use for this asynchronous socket operation.</param>
       </Docs>
@@ -615,9 +619,6 @@ instance.</para>
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.IAsyncResult" /> instance that contains information about the asynchronous operation.</para>
-        </returns>
         <exception cref="T:System.Net.Sockets.SocketException">An error occurred while accepting the connection. <para><block subset="none" type="note">For additional information on causes of the <see langword=" SocketException" />, see the <see cref="T:System.Net.Sockets.SocketException" qualify="true" /> class.</block></para></exception>
         <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
         <example>
@@ -685,6 +686,10 @@ instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to accept an incoming connection attempt.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that references the asynchronous <see cref="T:System.Net.Sockets.Socket" /> creation.</para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.AsyncCallback" /> delegate. </param>
         <param name="state">
@@ -709,7 +714,6 @@ instance.</para>
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Connection-oriented protocols can use the <see cref="M:System.Net.Sockets.Socket.BeginAccept(System.AsyncCallback,System.Object)" /> method to asynchronously process incoming connection attempts. Accepting connections asynchronously enables you to send and receive data within a separate execution thread. This overload allows you to specify the number of bytes to accept in the initial transfer in the <paramref name="receiveSize" /> parameter.</para>
@@ -738,6 +742,10 @@ instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to accept an incoming connection attempt and receives the first block of data sent by the client application.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that references the asynchronous <see cref="T:System.Net.Sockets.Socket" /> creation.</para>
+        </returns>
         <param name="receiveSize">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of bytes to accept from the sender. </param>
         <param name="callback">
@@ -764,7 +772,6 @@ instance.</para>
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Connection-oriented protocols can use the <see cref="M:System.Net.Sockets.Socket.BeginAccept(System.AsyncCallback,System.Object)" /> method to asynchronously process incoming connection attempts. Accepting connections asynchronously gives you the ability to send and receive data within a separate execution thread. This overload allows you to specify the accepted socket in the <paramref name="acceptSocket" /> parameter. If this parameter is null, the accepted socket is created by the <see cref="M:System.Net.Sockets.Socket.BeginAccept(System.AsyncCallback,System.Object)" /> method. You can specify the number of bytes to accept in the initial transfer in the <paramref name="receiveSize" /> parameter.</para>
@@ -793,6 +800,10 @@ instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to accept an incoming connection attempt from a specified socket and receives the first block of data sent by the client application.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object that references the asynchronous <see cref="T:System.Net.Sockets.Socket" /> object creation.</para>
+        </returns>
         <param name="acceptSocket">
           <attribution license="cc4" from="Microsoft" modified="false" />The accepted <see cref="T:System.Net.Sockets.Socket" /> object. This value may be null. </param>
         <param name="receiveSize">
@@ -823,9 +834,6 @@ instance.</para>
       </Parameters>
       <Docs>
         <param name="end_point">To be added.</param>
-        <returns>
-          <para>A <see cref="T:System.IAsyncResult" /> instance that contains information about the asynchronous operation.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <para>
             <paramref name="remoteEP " />is <see langword="null" />.</para>
@@ -865,6 +873,10 @@ instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous request for a remote host connection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that references the asynchronous connection.</para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.AsyncCallback" /> delegate. </param>
         <param name="state">
@@ -891,7 +903,6 @@ instance.</para>
       </Parameters>
       <Docs>
         <param name="callback">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The asynchronous <see cref="M:System.Net.Sockets.Socket.BeginConnect(System.Net.IPAddress,System.Int32,System.AsyncCallback,System.Object)" /> operation must be completed by calling the <see cref="M:System.Net.Sockets.Socket.EndConnect(System.IAsyncResult)" /> method. Typically, the method is invoked by the <paramref name="requestCallback" /> delegate.</para>
@@ -915,6 +926,10 @@ instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous request for a remote host connection. The host is specified by an <see cref="T:System.Net.IPAddress" /> and a port number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that references the asynchronous connection.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.IPAddress" /> of the remote host.</param>
         <param name="port">
@@ -942,7 +957,6 @@ instance.</para>
       </Parameters>
       <Docs>
         <param name="callback">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The asynchronous <see cref="M:System.Net.Sockets.Socket.BeginConnect(System.Net.IPAddress[],System.Int32,System.AsyncCallback,System.Object)" /> operation must be completed by calling the <see cref="M:System.Net.Sockets.Socket.EndConnect(System.IAsyncResult)" /> method. Typically, the method is invoked by the <paramref name="requestCallback" /> delegate.</para>
@@ -966,6 +980,10 @@ instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous request for a remote host connection. The host is specified by an <see cref="T:System.Net.IPAddress" /> array and a port number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that references the asynchronous connections.</para>
+        </returns>
         <param name="addresses">
           <attribution license="cc4" from="Microsoft" modified="false" />At least one <see cref="T:System.Net.IPAddress" />, designating the remote host.</param>
         <param name="port">
@@ -993,7 +1011,6 @@ instance.</para>
       </Parameters>
       <Docs>
         <param name="callback">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The asynchronous <see cref="M:System.Net.Sockets.Socket.BeginConnect(System.String,System.Int32,System.AsyncCallback,System.Object)" /> operation must be completed by calling the <see cref="M:System.Net.Sockets.Socket.EndConnect(System.IAsyncResult)" /> method. Typically, the method is invoked by the <paramref name="requestCallback" /> delegate.</para>
@@ -1017,6 +1034,10 @@ instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous request for a remote host connection. The host is specified by a host name and a port number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that references the asynchronous connection.</para>
+        </returns>
         <param name="host">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the remote host.</param>
         <param name="port">
@@ -1042,7 +1063,6 @@ instance.</para>
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you are using a connection-oriented protocol, you can call the <see cref="M:System.Net.Sockets.Socket.BeginDisconnect(System.Boolean,System.AsyncCallback,System.Object)" /> method to request a disconnect from a remote endpoint. If <paramref name="reuseSocket" /> is true, you can reuse the socket.</para>
@@ -1058,6 +1078,10 @@ instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous request to disconnect from a remote endpoint.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object that references the asynchronous operation.</para>
+        </returns>
         <param name="reuseSocket">
           <attribution license="cc4" from="Microsoft" modified="false" />true if this socket can be reused after the connection is closed; otherwise, false. </param>
         <param name="callback">
@@ -1089,7 +1113,6 @@ instance.</para>
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The asynchronous <see cref="M:System.Net.Sockets.Socket.BeginReceive(System.Byte[],System.Int32,System.Int32,System.Net.Sockets.SocketFlags,System.AsyncCallback,System.Object)" /> operation must be completed by calling the <see cref="M:System.Net.Sockets.Socket.EndReceive(System.IAsyncResult)" /> method. Typically, the method is invoked by the <paramref name="callback" /> delegate.</para>
@@ -1117,6 +1140,10 @@ instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins to asynchronously receive data from a connected <see cref="T:System.Net.Sockets.Socket" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that references the asynchronous read.</para>
+        </returns>
         <param name="buffers">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Byte" /> that is the storage location for the received data.</param>
         <param name="socketFlags">
@@ -1184,9 +1211,6 @@ instance.</para>
       </Parameters>
       <Docs>
         <param name="socket_flags">To be added.</param>
-        <returns>
-          <para>A <see cref="T:System.IAsyncResult" /> instance that contains information about the asynchronous operation.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="buffer " />is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -1244,6 +1268,10 @@ instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins to asynchronously receive data from a connected <see cref="T:System.Net.Sockets.Socket" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that references the asynchronous read.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Byte" /> that is the storage location for the received data. </param>
         <param name="offset">
@@ -1457,7 +1485,6 @@ method.</para>
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.Sockets.Socket.BeginSend(System.Byte[],System.Int32,System.Int32,System.Net.Sockets.SocketFlags,System.AsyncCallback,System.Object)" /> method starts an asynchronous send operation to the remote host established in the <see cref="M:System.Net.Sockets.Socket.Connect(System.Net.EndPoint)" />, <see cref="M:System.Net.Sockets.Socket.BeginConnect(System.Net.EndPoint,System.AsyncCallback,System.Object)" />, <see cref="M:System.Net.Sockets.Socket.Accept" />, or <see cref="M:System.Net.Sockets.Socket.BeginAccept(System.AsyncCallback,System.Object)" /> method. <see cref="M:System.Net.Sockets.Socket.BeginSend(System.Byte[],System.Int32,System.Int32,System.Net.Sockets.SocketFlags,System.AsyncCallback,System.Object)" /> will throw an exception if you do not first call <see cref="M:System.Net.Sockets.Socket.Accept" />, <see cref="M:System.Net.Sockets.Socket.BeginAccept(System.AsyncCallback,System.Object)" />, <see cref="M:System.Net.Sockets.Socket.Connect(System.Net.EndPoint)" />, or <see cref="M:System.Net.Sockets.Socket.BeginConnect(System.Net.EndPoint,System.AsyncCallback,System.Object)" />. Calling the <see cref="M:System.Net.Sockets.Socket.BeginSend(System.Byte[],System.Int32,System.Int32,System.Net.Sockets.SocketFlags,System.AsyncCallback,System.Object)" /> method gives you the ability to send data within a separate execution thread.</para>
@@ -1489,6 +1516,10 @@ method.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends data asynchronously to a connected <see cref="T:System.Net.Sockets.Socket" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that references the asynchronous send.</para>
+        </returns>
         <param name="buffers">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Byte" /> that contains the data to send. </param>
         <param name="socketFlags">
@@ -1556,9 +1587,6 @@ method.</para>
       </Parameters>
       <Docs>
         <param name="socket_flags">To be added.</param>
-        <returns>
-          <para>A <see cref="T:System.IAsyncResult" /> instance that contains information about the asynchronous operation.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="buffer " />is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -1620,6 +1648,10 @@ method.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends data asynchronously to a connected <see cref="T:System.Net.Sockets.Socket" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that references the asynchronous send.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Byte" /> that contains the data to send. </param>
         <param name="offset">
@@ -1683,7 +1715,6 @@ method.</para>
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload sends the file <paramref name="fileName" /> to the connected socket. If <paramref name="fileName" /> is in the local directory, it may be identified with just the name of the file; otherwise, the full path and name of the file must be specified. Wildcards ("..\\myfile.txt") and UNC share names ("\\\\shared directory\\myfile.txt") are supported. If the file is not found, the exception <see cref="T:System.IO.FileNotFoundException" /> is thrown.</para>
@@ -1706,6 +1737,10 @@ method.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends the file <paramref name="fileName" /> to a connected <see cref="T:System.Net.Sockets.Socket" /> object using the <see cref="F:System.Net.Sockets.TransmitFileOptions.UseDefaultWorkerThread" /> flag.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object that represents the asynchronous send.</para>
+        </returns>
         <param name="fileName">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the path and name of the file to send. This parameter can be null. </param>
         <param name="callback">
@@ -1734,7 +1769,6 @@ method.</para>
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload requires the name of the file you want to send and a bitwise combination of <see cref="T:System.Net.Sockets.TransmitFileOptions" /> values. The <paramref name="preBuffer" /> parameter contains any data you want to precede the file. <paramref name="postBuffer" /> contains data you want to follow the file. If <paramref name="fileName" /> is in the local directory, it may be identified with just the name of the file; otherwise, the full path and name of the file must be specified. Wildcards ("..\\myfile.txt") and UNC share names ("\\\\shared directory\\myfile.txt") are supported. If the file is not found, the exception <see cref="T:System.IO.FileNotFoundException" /> is thrown.</para>
@@ -1758,6 +1792,10 @@ method.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends a file and buffers of data asynchronously to a connected <see cref="T:System.Net.Sockets.Socket" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object that represents the asynchronous operation.</para>
+        </returns>
         <param name="fileName">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the path and name of the file to be sent. This parameter can be null. </param>
         <param name="preBuffer">
@@ -1797,9 +1835,6 @@ method.</para>
       <Docs>
         <param name="socket_flags">To be added.</param>
         <param name="remote_end">To be added.</param>
-        <returns>
-          <para>A <see cref="T:System.IAsyncResult" /> instance that contains information about the asynchronous operation.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <para>
             <paramref name="buffer " />is <see langword="null" />.</para>
@@ -1863,6 +1898,10 @@ method.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends data asynchronously to a specific remote host.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that references the asynchronous send.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Byte" /> that contains the data to send. </param>
         <param name="offset">
@@ -2230,7 +2269,6 @@ method.</para>
         <Parameter Name="e" Type="System.Net.Sockets.SocketAsyncEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you are using a connection-oriented protocol, the <see cref="M:System.Net.Sockets.Socket.ConnectAsync(System.Net.Sockets.SocketAsyncEventArgs)" /> method starts an asynchronous request for a connection to the remote host. If you are using a connectionless protocol, <see cref="M:System.Net.Sockets.Socket.ConnectAsync(System.Net.Sockets.SocketAsyncEventArgs)" /> establishes a default remote host. </para>
@@ -2264,6 +2302,11 @@ method.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous request for a connection to a remote host.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the I/O operation is pending. The <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> event on the <paramref name="e" /> parameter will be raised upon completion of the operation. </para>
+          <para>Returns false if the I/O operation completed synchronously. In this case, The <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> event on the <paramref name="e" /> parameter will not be raised and the <paramref name="e" /> object passed as a parameter may be examined immediately after the method call returns to retrieve the result of the operation. </para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.Sockets.SocketAsyncEventArgs" /> object to use for this asynchronous socket operation.</param>
       </Docs>
@@ -2355,7 +2398,6 @@ method.</para>
         <Parameter Name="e" Type="System.Net.Sockets.SocketAsyncEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When using a connection-oriented protocol, calling the <see cref="M:System.Net.Sockets.Socket.DisconnectAsync(System.Net.Sockets.SocketAsyncEventArgs)" /> method requests a disconnect from a remote endpoint. If you set <see cref="P:System.Net.Sockets.SocketAsyncEventArgs.DisconnectReuseSocket" /> to true in the <paramref name="e" /> parameter, the socket can be reused.</para>
@@ -2364,6 +2406,11 @@ method.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous request to disconnect from a remote endpoint.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the I/O operation is pending. The <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> event on the <paramref name="e" /> parameter will be raised upon completion of the operation. </para>
+          <para>Returns false if the I/O operation completed synchronously. In this case, The <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> event on the <paramref name="e" /> parameter will not be raised and the <paramref name="e" /> object passed as a parameter may be examined immediately after the method call returns to retrieve the result of the operation.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.Sockets.SocketAsyncEventArgs" /> object to use for this asynchronous socket operation.</param>
       </Docs>
@@ -2472,7 +2519,6 @@ method.</para>
         <Parameter Name="targetProcessId" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The target process should use <see cref="M:System.Net.Sockets.Socket.#ctor(System.Net.Sockets.SocketInformation)" /> to create the duplicate socket instance. </para>
@@ -2483,6 +2529,10 @@ method.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Duplicates the socket reference for the target process, and closes the socket for this process.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The socket reference to be passed to the target process.</para>
+        </returns>
         <param name="targetProcessId">
           <attribution license="cc4" from="Microsoft" modified="false" />The ID of the target process where a duplicate of the socket reference is created.</param>
       </Docs>
@@ -2529,10 +2579,6 @@ method.</para>
       </Parameters>
       <Docs>
         <param name="result">A <see cref="T:System.IAsyncResult" /> object that holds the state information for the asynchronous operation.</param>
-        <returns>
-          <para> A new connected <see cref="T:System.Net.Sockets.Socket" />
-instance.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="asyncResult " />is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -2563,6 +2609,10 @@ instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously accepts an incoming connection attempt and creates a new <see cref="T:System.Net.Sockets.Socket" /> to handle remote host communication.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.Sockets.Socket" /> to handle communication with the remote host.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -2719,9 +2769,6 @@ instance.</para>
         <param name="result">
           <para>A <see cref="T:System.IAsyncResult" /> object that holds the state information for the asynchronous operation.</para>
         </param>
-        <returns>
-          <para> A <see cref="T:System.Int32" qualify="true" /> containing the number of bytes received.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="asyncResult " />is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -2757,6 +2804,10 @@ instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ends a pending asynchronous read.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes received.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -2895,9 +2946,6 @@ delegate's method.</para>
         <param name="result">
           <para>A <see cref="T:System.IAsyncResult" /> object that holds the state information for the asynchronous operation.</para>
         </param>
-        <returns>
-          <para>A <see cref="T:System.Int32" qualify="true" /> containing the number of bytes sent. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="asyncResult " />is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -2936,6 +2984,10 @@ delegate's method.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ends a pending asynchronous send.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If successful, the number of bytes sent to the <see cref="T:System.Net.Sockets.Socket" />; otherwise, an invalid <see cref="T:System.Net.Sockets.Socket" /> error.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -3019,9 +3071,6 @@ delegate's method.</para>
         <param name="result">
           <para>A <see cref="T:System.IAsyncResult" /> object that holds the state information for the asynchronous operation.</para>
         </param>
-        <returns>
-          <para>A <see cref="T:System.Int32" qualify="true" /> containing the number of bytes sent. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="asyncResult " />is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -3054,6 +3103,10 @@ delegate's method.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ends a pending asynchronous send to a specific location.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If successful, the number of bytes sent; otherwise, an invalid <see cref="T:System.Net.Sockets.Socket" /> error.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -3117,9 +3170,6 @@ delegate's method.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" qualify="true" /> containing the hash code for the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.Sockets.Socket.GetHashCode" /> method returns a hash code of this instance. This value can be used as a key in hash tables.</para>
@@ -3128,6 +3178,10 @@ delegate's method.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash value for a <see cref="T:System.Net.Sockets.Socket" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer hash value.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
       <AssemblyInfo>
@@ -3152,42 +3206,6 @@ delegate's method.</para>
         <Parameter Name="optionName" Type="System.Net.Sockets.SocketOptionName" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> The following table describes the values returned 
-      by this method.</para>
-          <list type="table">
-            <listheader>
-              <term>optionName</term>
-              <description>Return value</description>
-            </listheader>
-            <item>
-              <term>
-                <see langword="Linger" />
-              </term>
-              <description> An instance of the <see cref="T:System.Net.Sockets.LingerOption" qualify="true" />
-   class.</description>
-            </item>
-            <item>
-              <term>
-                <para>
-                  <see langword="AddMembership" />
-                </para>
-                <para> -or-</para>
-                <para>
-                  <see langword="DropMembership" />
-                </para>
-              </term>
-              <description> An instance of
-   the <see cref="T:System.Net.Sockets.MulticastOption" qualify="true" />
-   class.</description>
-            </item>
-            <item>
-              <term> All other values defined in the <see cref="T:System.Net.Sockets.SocketOptionName" /> enumeration.</term>
-              <description>A <see cref="T:System.Int32" qualify="true" /> containing the value
-of the option.</description>
-            </item>
-          </list>
-        </returns>
         <exception cref="T:System.Net.Sockets.SocketException">An error occurred while accessing the socket. <para><block subset="none" type="note">For additional information on causes of the <see langword=" SocketException" />, see the <see cref="T:System.Net.Sockets.SocketException" qualify="true" /> class.</block></para></exception>
         <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
         <example>
@@ -3285,6 +3303,10 @@ class OptionTest{
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of a specified <see cref="T:System.Net.Sockets.Socket" /> option, represented as an object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the value of the option. When the <paramref name="optionName" /> parameter is set to <see cref="F:System.Net.Sockets.SocketOptionName.Linger" /> the return value is an instance of the <see cref="T:System.Net.Sockets.LingerOption" /> class. When <paramref name="optionName" /> is set to <see cref="F:System.Net.Sockets.SocketOptionName.AddMembership" /> or <see cref="F:System.Net.Sockets.SocketOptionName.DropMembership" />, the return value is an instance of the <see cref="T:System.Net.Sockets.MulticastOption" /> class. When <paramref name="optionName" /> is any other value, the return value is an integer.</para>
+        </returns>
         <param name="optionLevel">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Net.Sockets.SocketOptionLevel" /> values. </param>
         <param name="optionName">
@@ -3363,9 +3385,6 @@ class OptionTest{
       </Parameters>
       <Docs>
         <param name="length">To be added.</param>
-        <returns>
-          <para> A <see cref="T:System.Byte" qualify="true" /> array containing the value of the specified socket option.</para>
-        </returns>
         <exception cref="T:System.Net.Sockets.SocketException">
           <para>
             <paramref name="optionLength" /> is smaller than the number of bytes required to store the value of the specified socket option.</para>
@@ -3390,6 +3409,10 @@ class OptionTest{
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified <see cref="T:System.Net.Sockets.Socket" /> option in an array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Byte" /> that contains the value of the socket option.</para>
+        </returns>
         <param name="optionLevel">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Net.Sockets.SocketOptionLevel" /> values. </param>
         <param name="optionName">
@@ -3449,10 +3472,6 @@ class OptionTest{
         <param name="ioctl_code">To be added.</param>
         <param name="in_value">To be added.</param>
         <param name="out_value">To be added.</param>
-        <returns>
-          <para> A <see cref="T:System.Int32" qualify="true" /> containing the length of the
-<paramref name="optionOutValue" /> array after the method returns.</para>
-        </returns>
         <exception cref="T:System.InvalidOperationException">
           <para>An attempt was made to change the blocking mode.</para>
           <block subset="none" type="note">
@@ -3521,6 +3540,10 @@ class App {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets low-level operating modes for the <see cref="T:System.Net.Sockets.Socket" /> using numerical control codes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes in the <paramref name="optionOutValue" /> parameter.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -3541,7 +3564,6 @@ class App {
         <Parameter Name="optionOutValue" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method provides low-level access to the operating system <see cref="T:System.Net.Sockets.Socket" /> underlying the current instance of the <see cref="T:System.Net.Sockets.Socket" /> class. For more, see the WSAIoctl documentation in the MSDN library.</para>
@@ -3556,6 +3578,10 @@ class App {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets low-level operating modes for the <see cref="T:System.Net.Sockets.Socket" /> using the <see cref="T:System.Net.Sockets.IOControlCode" /> enumeration to specify control codes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes in the <paramref name="optionOutValue" /> parameter.</para>
+        </returns>
         <param name="ioControlCode">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Net.Sockets.IOControlCode" /> value that specifies the control code of the operation to perform. </param>
         <param name="optionInValue">
@@ -3838,57 +3864,6 @@ instance.</para>
       </Parameters>
       <Docs>
         <param name="time_us">To be added.</param>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" /> where <see langword="true" /> indicates the current instance
-   satisfies at least one of the conditions in the following table
-   corresponding to the specified <see cref="T:System.Net.Sockets.SelectMode" />
-   value; otherwise, <see langword="false" />. <see langword="false" /> is returned if the status of the current instance cannot be determined within the time specified by <paramref name="microSeconds" /> . </para>
-          <list type="table">
-            <listheader>
-              <term>SelectMode value</term>
-              <description> Condition</description>
-            </listheader>
-            <item>
-              <term> SelectRead</term>
-              <description>
-                <para> Data is available for reading (includes
-            out-of-band data if the <see cref="F:System.Net.Sockets.SocketOptionName.OutOfBandInline" /> value defined in
-            the <see cref="T:System.Net.Sockets.SocketOptionName" />
-            enumeration
-            is set).</para>
-                <para>-or-</para>
-                <para>The socket is in the listening state with a
-            pending connection, and
-            the <see cref="M:System.Net.Sockets.Socket.Accept" /> method has been called and is guaranteed to succeed without
-            blocking.</para>
-                <para>-or-</para>
-                <para> The connection has been closed, reset,
-            or terminated.</para>
-              </description>
-            </item>
-            <item>
-              <term> SelectWrite</term>
-              <description>
-                <para>Data can be sent.</para>
-                <para>-or-</para>
-                <para> A non-blocking <see cref="M:System.Net.Sockets.Socket.Connect(System.Net.EndPoint)" /> method is being processed and the connection has
-            succeeded.</para>
-              </description>
-            </item>
-            <item>
-              <term> SelectError</term>
-              <description>
-                <para>The <see cref="F:System.Net.Sockets.SocketOptionName.OutOfBandInline" /> value defined in
-            the <see cref="T:System.Net.Sockets.SocketOptionName" /> enumeration is not set
-            and out-of-band data is available.</para>
-                <para>-or-</para>
-                <para> A non-blocking <see cref="M:System.Net.Sockets.Socket.Connect(System.Net.EndPoint)" />
-      method is being processed and the connection has
-      failed.</para>
-              </description>
-            </item>
-          </list>
-        </returns>
         <exception cref="T:System.NotSupportedException">
           <paramref name="mode " />is not one of the values defined in the <see cref="T:System.Net.Sockets.SelectMode" /> enumeration.</exception>
         <exception cref="T:System.Net.Sockets.SocketException">
@@ -3915,6 +3890,60 @@ instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the status of the <see cref="T:System.Net.Sockets.Socket" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The status of the <see cref="T:System.Net.Sockets.Socket" /> based on the polling mode value passed in the <paramref name="mode" /> parameter.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Mode </para>
+                </term>
+                <description>
+                  <para>Return Value </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>
+                  <see cref="F:System.Net.Sockets.SelectMode.SelectRead" /> </para>
+              </term>
+              <description>
+                <para>true if <see cref="M:System.Net.Sockets.Socket.Listen(System.Int32)" /> has been called and a connection is pending; </para>
+                <para>-or- </para>
+                <para>true if data is available for reading; </para>
+                <para>-or- </para>
+                <para>true if the connection has been closed, reset, or terminated; </para>
+                <para>otherwise, returns false. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>
+                  <see cref="F:System.Net.Sockets.SelectMode.SelectWrite" /> </para>
+              </term>
+              <description>
+                <para>true, if processing a <see cref="M:System.Net.Sockets.Socket.Connect(System.Net.EndPoint)" />, and the connection has succeeded; </para>
+                <para>-or- </para>
+                <para>true if data can be sent; </para>
+                <para>otherwise, returns false. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>
+                  <see cref="F:System.Net.Sockets.SelectMode.SelectError" /> </para>
+              </term>
+              <description>
+                <para>true if processing a <see cref="M:System.Net.Sockets.Socket.Connect(System.Net.EndPoint)" /> that does not block, and the connection has failed; </para>
+                <para>-or- </para>
+                <para>true if <see cref="F:System.Net.Sockets.SocketOptionName.OutOfBandInline" /> is not set and out-of-band data is available; </para>
+                <para>otherwise, returns false. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="mode">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Net.Sockets.SelectMode" /> values. </param>
       </Docs>
@@ -3967,10 +3996,6 @@ instance.</para>
         <Parameter Name="buffer" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" qualify="true" />
-containing the number of bytes received.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="buffer " />is <see langword="null" />.</exception>
         <exception cref="T:System.InvalidOperationException">
@@ -4004,6 +4029,10 @@ containing the number of bytes received.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Receives data from a bound <see cref="T:System.Net.Sockets.Socket" /> into a receive buffer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes received.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Byte" /> that is the storage location for the received data. </param>
       </Docs>
@@ -4024,7 +4053,6 @@ containing the number of bytes received.</para>
         <Parameter Name="buffers" Type="System.Collections.Generic.IList&lt;System.ArraySegment&lt;System.Byte&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method reads data into the buffers parameter and returns the number of bytes successfully read. You can call from both connection-oriented and connectionless sockets.</para>
@@ -4042,6 +4070,10 @@ containing the number of bytes received.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Receives data from a bound <see cref="T:System.Net.Sockets.Socket" /> into the list of receive buffers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes received.</para>
+        </returns>
         <param name="buffers">
           <attribution license="cc4" from="Microsoft" modified="false" />A list of <see cref="T:System.ArraySegment`1" />s of type <see cref="T:System.Byte" /> that contains the received data.</param>
       </Docs>
@@ -4065,9 +4097,6 @@ containing the number of bytes received.</para>
       </Parameters>
       <Docs>
         <param name="flags">To be added.</param>
-        <returns>
-          <para>A <see cref="T:System.Int32" qualify="true" /> containing the number of bytes received.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="buffer " />is <see langword="null" />.</exception>
         <exception cref="T:System.InvalidOperationException">
@@ -4102,6 +4131,10 @@ containing the number of bytes received.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Receives data from a bound <see cref="T:System.Net.Sockets.Socket" /> into a receive buffer, using the specified <see cref="T:System.Net.Sockets.SocketFlags" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes received.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Byte" /> that is the storage location for the received data. </param>
       </Docs>
@@ -4128,7 +4161,6 @@ containing the number of bytes received.</para>
         <Parameter Name="socketFlags" Type="System.Net.Sockets.SocketFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method reads data into the <paramref name="buffers" /> parameter and returns the number of bytes successfully read. You can call from both connection-oriented and connectionless sockets.</para>
@@ -4148,6 +4180,10 @@ containing the number of bytes received.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Receives data from a bound <see cref="T:System.Net.Sockets.Socket" /> into the list of receive buffers, using the specified <see cref="T:System.Net.Sockets.SocketFlags" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes received.</para>
+        </returns>
         <param name="buffers">
           <attribution license="cc4" from="Microsoft" modified="false" />A list of <see cref="T:System.ArraySegment`1" />s of type <see cref="T:System.Byte" /> that contains the received data.</param>
         <param name="socketFlags">
@@ -4174,9 +4210,6 @@ containing the number of bytes received.</para>
       </Parameters>
       <Docs>
         <param name="flags">To be added.</param>
-        <returns>
-          <para>A <see cref="T:System.Int32" qualify="true" /> containing the number of bytes received.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="buffer " />is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -4220,6 +4253,10 @@ containing the number of bytes received.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Receives the specified number of bytes of data from a bound <see cref="T:System.Net.Sockets.Socket" /> into a receive buffer, using the specified <see cref="T:System.Net.Sockets.SocketFlags" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes received.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Byte" /> that is the storage location for the received data. </param>
         <param name="size">
@@ -4278,10 +4315,6 @@ containing the number of bytes received.</para>
       </Parameters>
       <Docs>
         <param name="flags">To be added.</param>
-        <returns>
-          <para>A <see cref="T:System.Int32" qualify="true" />
-containing the number of bytes received.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="buffer " />is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -4334,6 +4367,10 @@ containing the number of bytes received.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Receives the specified number of bytes from a bound <see cref="T:System.Net.Sockets.Socket" /> into the specified offset position of the receive buffer, using the specified <see cref="T:System.Net.Sockets.SocketFlags" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes received.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Byte" /> that is the storage location for received data. </param>
         <param name="offset">
@@ -4387,7 +4424,6 @@ containing the number of bytes received.</para>
         <Parameter Name="e" Type="System.Net.Sockets.SocketAsyncEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.Sockets.Socket.ReceiveAsync(System.Net.Sockets.SocketAsyncEventArgs)" /> method is used on connected sockets or bound connectionless sockets and is used to read incoming data. The socket's local address must be known.</para>
@@ -4422,6 +4458,11 @@ containing the number of bytes received.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous request to receive data from a connected <see cref="T:System.Net.Sockets.Socket" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the I/O operation is pending. The <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> event on the <paramref name="e" /> parameter will be raised upon completion of the operation. </para>
+          <para>Returns false if the I/O operation completed synchronously. In this case, The <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> event on the <paramref name="e" /> parameter will not be raised and the <paramref name="e" /> object passed as a parameter may be examined immediately after the method call returns to retrieve the result of the operation.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.Sockets.SocketAsyncEventArgs" /> object to use for this asynchronous socket operation.</param>
       </Docs>
@@ -4732,7 +4773,6 @@ buffer.</para>
         <Parameter Name="e" Type="System.Net.Sockets.SocketAsyncEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.Sockets.Socket.ReceiveFromAsync(System.Net.Sockets.SocketAsyncEventArgs)" /> method is used primarily to receive data on a connectionless socket. The socket's local address must be known.</para>
@@ -4773,6 +4813,11 @@ buffer.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins to asynchronously receive data from a specified network device.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the I/O operation is pending. The <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> event on the <paramref name="e" /> parameter will be raised upon completion of the operation. </para>
+          <para>Returns false if the I/O operation completed synchronously. In this case, The <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> event on the <paramref name="e" /> parameter will not be raised and the <paramref name="e" /> object passed as a parameter may be examined immediately after the method call returns to retrieve the result of the operation.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.Sockets.SocketAsyncEventArgs" /> object to use for this asynchronous socket operation.</param>
       </Docs>
@@ -4833,7 +4878,6 @@ buffer.</para>
         <Parameter Name="e" Type="System.Net.Sockets.SocketAsyncEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.Sockets.Socket.ReceiveMessageFromAsync(System.Net.Sockets.SocketAsyncEventArgs)" /> method is used primarily to receive message data on a connectionless socket. The socket's local address must be known. This method can only be used with datagram and raw sockets. The socket must be initialized with the socket type set to <see cref="F:System.Net.Sockets.SocketType.Dgram" /> or <see cref="F:System.Net.Sockets.SocketType.Raw" /> before calling this method. This can be done when the socket is constructed using <see cref="M:System.Net.Sockets.Socket.#ctor(System.Net.Sockets.AddressFamily,System.Net.Sockets.SocketType,System.Net.Sockets.ProtocolType)" />. </para>
@@ -4875,6 +4919,11 @@ buffer.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins to asynchronously receive the specified number of bytes of data into the specified location in the data buffer, using the specified <see cref="P:System.Net.Sockets.SocketAsyncEventArgs.SocketFlags" />, and stores the endpoint and packet information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the I/O operation is pending. The <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> event on the <paramref name="e" /> parameter will be raised upon completion of the operation. </para>
+          <para>Returns false if the I/O operation completed synchronously. In this case, The <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> event on the <paramref name="e" /> parameter will not be raised and the <paramref name="e" /> object passed as a parameter may be examined immediately after the method call returns to retrieve the result of the operation.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.Sockets.SocketAsyncEventArgs" /> object to use for this asynchronous socket operation.</param>
       </Docs>
@@ -5086,10 +5135,6 @@ class SelectTest {
       </Parameters>
       <Docs>
         <param name="buf">A <see cref="T:System.Byte" qualify="true" /> array containing data to send to the socket.</param>
-        <returns>
-          <para>A <see cref="T:System.Int32" qualify="true" />
-containing the number of bytes sent.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="buffer " />is <see langword="null" />.</exception>
         <exception cref="T:System.InvalidOperationException">
@@ -5124,6 +5169,10 @@ containing the number of bytes sent.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends data to a connected <see cref="T:System.Net.Sockets.Socket" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes sent to the <see cref="T:System.Net.Sockets.Socket" />.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -5142,7 +5191,6 @@ containing the number of bytes sent.</para>
         <Parameter Name="buffers" Type="System.Collections.Generic.IList&lt;System.ArraySegment&lt;System.Byte&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -5165,6 +5213,10 @@ containing the number of bytes sent.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends the set of buffers in the list to a connected <see cref="T:System.Net.Sockets.Socket" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes sent to the <see cref="T:System.Net.Sockets.Socket" />.</para>
+        </returns>
         <param name="buffers">
           <attribution license="cc4" from="Microsoft" modified="false" />A list of <see cref="T:System.ArraySegment`1" />s of type <see cref="T:System.Byte" /> that contains the data to be sent. </param>
       </Docs>
@@ -5189,10 +5241,6 @@ containing the number of bytes sent.</para>
       <Docs>
         <param name="buf">To be added.</param>
         <param name="flags">To be added.</param>
-        <returns>
-          <para>A <see cref="T:System.Int32" qualify="true" />
-containing the number of bytes sent.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="buffer " />is <see langword="null" />.</exception>
         <exception cref="T:System.InvalidOperationException">
@@ -5230,6 +5278,10 @@ containing the number of bytes sent.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends data to a connected <see cref="T:System.Net.Sockets.Socket" /> using the specified <see cref="T:System.Net.Sockets.SocketFlags" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes sent to the <see cref="T:System.Net.Sockets.Socket" />.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -5249,7 +5301,6 @@ containing the number of bytes sent.</para>
         <Parameter Name="socketFlags" Type="System.Net.Sockets.SocketFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload requires at least one buffer that contains the data you want to send. The <see cref="T:System.Net.Sockets.SocketFlags" /> value defaults to 0. If you specify the <see cref="F:System.Net.Sockets.SocketFlags.DontRoute" /> flag as the <paramref name="socketFlags" /> parameter, the data you are sending will not be routed. </para>
@@ -5270,6 +5321,10 @@ containing the number of bytes sent.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends the set of buffers in the list to a connected <see cref="T:System.Net.Sockets.Socket" />, using the specified <see cref="T:System.Net.Sockets.SocketFlags" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes sent to the <see cref="T:System.Net.Sockets.Socket" />.</para>
+        </returns>
         <param name="buffers">
           <attribution license="cc4" from="Microsoft" modified="false" />A list of <see cref="T:System.ArraySegment`1" />s of type <see cref="T:System.Byte" /> that contains the data to be sent.</param>
         <param name="socketFlags">
@@ -5297,10 +5352,6 @@ containing the number of bytes sent.</para>
       <Docs>
         <param name="buf">To be added.</param>
         <param name="flags">To be added.</param>
-        <returns>
-          <para>A <see cref="T:System.Int32" qualify="true" />
-containing the number of bytes sent.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="buffer " />is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -5345,6 +5396,10 @@ containing the number of bytes sent.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends the specified number of bytes of data to a connected <see cref="T:System.Net.Sockets.Socket" />, using the specified <see cref="T:System.Net.Sockets.SocketFlags" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes sent to the <see cref="T:System.Net.Sockets.Socket" />.</para>
+        </returns>
         <param name="size">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of bytes to send. </param>
       </Docs>
@@ -5402,10 +5457,6 @@ containing the number of bytes sent.</para>
       <Docs>
         <param name="buf">To be added.</param>
         <param name="flags">To be added.</param>
-        <returns>
-          <para>A <see cref="T:System.Int32" qualify="true" />
-containing the number of bytes sent.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="buffer " />is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -5457,6 +5508,10 @@ containing the number of bytes sent.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends the specified number of bytes of data to a connected <see cref="T:System.Net.Sockets.Socket" />, starting at the specified offset, and using the specified <see cref="T:System.Net.Sockets.SocketFlags" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes sent to the <see cref="T:System.Net.Sockets.Socket" />.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />The position in the data buffer at which to begin sending data. </param>
         <param name="size">
@@ -5508,7 +5563,6 @@ containing the number of bytes sent.</para>
         <Parameter Name="e" Type="System.Net.Sockets.SocketAsyncEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.Sockets.Socket.SendAsync(System.Net.Sockets.SocketAsyncEventArgs)" /> method is used to write outgoing data from one or more buffers on a connection-oriented socket. This method can also be used, however, on connectionless sockets that have specified a remote host on a connect operation. </para>
@@ -5543,6 +5597,11 @@ containing the number of bytes sent.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends data asynchronously to a connected <see cref="T:System.Net.Sockets.Socket" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the I/O operation is pending. The <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> event on the <paramref name="e" /> parameter will be raised upon completion of the operation. </para>
+          <para>Returns false if the I/O operation completed synchronously. In this case, The <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> event on the <paramref name="e" /> parameter will not be raised and the <paramref name="e" /> object passed as a parameter may be examined immediately after the method call returns to retrieve the result of the operation.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.Sockets.SocketAsyncEventArgs" /> object to use for this asynchronous socket operation.</param>
       </Docs>
@@ -5676,7 +5735,6 @@ containing the number of bytes sent.</para>
         <Parameter Name="e" Type="System.Net.Sockets.SocketAsyncEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.Sockets.Socket.SendPacketsAsync(System.Net.Sockets.SocketAsyncEventArgs)" /> method is used to send a collection of files or in memory data buffers to remote host. The <see cref="T:System.Net.Sockets.Socket" /> must already be connected to the remote host.</para>
@@ -5707,6 +5765,11 @@ containing the number of bytes sent.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends a collection of files or in memory data buffers asynchronously to a connected <see cref="T:System.Net.Sockets.Socket" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the I/O operation is pending. The <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> event on the <paramref name="e" /> parameter will be raised upon completion of the operation. </para>
+          <para>Returns false if the I/O operation completed synchronously. In this case, The <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> event on the <paramref name="e" /> parameter will not be raised and the <paramref name="e" /> object passed as a parameter may be examined immediately after the method call returns to retrieve the result of the operation.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.Sockets.SocketAsyncEventArgs" /> object to use for this asynchronous socket operation.</param>
       </Docs>
@@ -5753,10 +5816,6 @@ containing the number of bytes sent.</para>
       </Parameters>
       <Docs>
         <param name="remote_end">To be added.</param>
-        <returns>
-          <para>A <see cref="T:System.Int32" qualify="true" />
-containing the number of bytes sent.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <para>
             <paramref name="buffer or remoteEP " />is <see langword="null" />.</para>
@@ -5786,6 +5845,10 @@ containing the number of bytes sent.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends data to the specified endpoint.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes sent.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Byte" /> that contains the data to be sent. </param>
       </Docs>
@@ -5812,10 +5875,6 @@ containing the number of bytes sent.</para>
       <Docs>
         <param name="flags">To be added.</param>
         <param name="remote_end">To be added.</param>
-        <returns>
-          <para>A <see cref="T:System.Int32" qualify="true" />
-containing the number of bytes sent.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <para>
             <paramref name="buffer or remoteEP " />is <see langword="null" />.</para>
@@ -5853,6 +5912,10 @@ containing the number of bytes sent.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends data to a specific endpoint using the specified <see cref="T:System.Net.Sockets.SocketFlags" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes sent.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Byte" /> that contains the data to be sent. </param>
       </Docs>
@@ -5880,10 +5943,6 @@ containing the number of bytes sent.</para>
       <Docs>
         <param name="flags">To be added.</param>
         <param name="remote_end">To be added.</param>
-        <returns>
-          <para>A <see cref="T:System.Int32" qualify="true" />
-containing the number of bytes sent.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <para>
             <paramref name="buffer or remoteEP " />is <see langword="null" />.</para>
@@ -5928,6 +5987,10 @@ containing the number of bytes sent.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends the specified number of bytes of data to the specified endpoint using the specified <see cref="T:System.Net.Sockets.SocketFlags" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes sent.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Byte" /> that contains the data to be sent. </param>
         <param name="size">
@@ -5958,10 +6021,6 @@ containing the number of bytes sent.</para>
       <Docs>
         <param name="flags">To be added.</param>
         <param name="remote_end">To be added.</param>
-        <returns>
-          <para>A <see cref="T:System.Int32" qualify="true" />
-containing the number of bytes sent.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <para>
             <paramref name="buffer or remoteEP " />is <see langword="null" />.</para>
@@ -6012,6 +6071,10 @@ containing the number of bytes sent.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends the specified number of bytes of data to the specified endpoint, starting at the specified location in the buffer, and using the specified <see cref="T:System.Net.Sockets.SocketFlags" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes sent.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Byte" /> that contains the data to be sent. </param>
         <param name="offset">
@@ -6036,7 +6099,6 @@ containing the number of bytes sent.</para>
         <Parameter Name="e" Type="System.Net.Sockets.SocketAsyncEventArgs" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.Sockets.Socket.SendToAsync(System.Net.Sockets.SocketAsyncEventArgs)" /> method starts an asynchronous send operation to the remote host specified in the <see cref="P:System.Net.Sockets.SocketAsyncEventArgs.RemoteEndPoint" /> property of the <paramref name="e" /> parameter. Calling the <see cref="M:System.Net.Sockets.Socket.SendToAsync(System.Net.Sockets.SocketAsyncEventArgs)" /> method gives you the ability to send data within a separate execution thread. Although this method is intended for connectionless protocols, <see cref="M:System.Net.Sockets.Socket.SendToAsync(System.Net.Sockets.SocketAsyncEventArgs)" /> works with both connectionless and connection-oriented protocols.</para>
@@ -6079,6 +6141,11 @@ containing the number of bytes sent.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends data asynchronously to a specific remote host.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the I/O operation is pending. The <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> event on the <paramref name="e" /> parameter will be raised upon completion of the operation. </para>
+          <para>Returns false if the I/O operation completed synchronously. In this case, The <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> event on the <paramref name="e" /> parameter will not be raised and the <paramref name="e" /> object passed as a parameter may be examined immediately after the method call returns to retrieve the result of the operation.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.Sockets.SocketAsyncEventArgs" /> object to use for this asynchronous socket operation.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Net.Sockets/TcpClient.xml b/mcs/class/System/Documentation/en/System.Net.Sockets/TcpClient.xml
index d81dbef24a4..85de3695f42 100644
--- a/mcs/class/System/Documentation/en/System.Net.Sockets/TcpClient.xml
+++ b/mcs/class/System/Documentation/en/System.Net.Sockets/TcpClient.xml
@@ -230,7 +230,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The asynchronous <see cref="M:System.Net.Sockets.TcpClient.BeginConnect(System.Net.IPAddress,System.Int32,System.AsyncCallback,System.Object)" /> operation must be completed by calling the <see cref="M:System.Net.Sockets.TcpClient.EndConnect(System.IAsyncResult)" /> method. Typically, the method is invoked by the <paramref name="asyncCallback" /> delegate.</para>
@@ -241,6 +240,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous request for a remote host connection. The remote host is specified by an <see cref="T:System.Net.IPAddress" /> and a port number (<see cref="T:System.Int32" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object that references the asynchronous connection.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.IPAddress" /> of the remote host.</param>
         <param name="port">
@@ -269,7 +272,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The asynchronous <see cref="M:System.Net.Sockets.TcpClient.BeginConnect(System.Net.IPAddress,System.Int32,System.AsyncCallback,System.Object)" /> operation must be completed by calling the <see cref="M:System.Net.Sockets.TcpClient.EndConnect(System.IAsyncResult)" /> method. Typically, the method is invoked by the <paramref name="asyncCallback" /> delegate.</para>
@@ -281,6 +283,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous request for a remote host connection. The remote host is specified by an <see cref="T:System.Net.IPAddress" /> array and a port number (<see cref="T:System.Int32" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object that references the asynchronous connection.</para>
+        </returns>
         <param name="addresses">
           <attribution license="cc4" from="Microsoft" modified="false" />At least one <see cref="T:System.Net.IPAddress" /> that designates the remote hosts.</param>
         <param name="port">
@@ -309,7 +315,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The asynchronous <see cref="M:System.Net.Sockets.TcpClient.BeginConnect(System.String,System.Int32,System.AsyncCallback,System.Object)" /> operation must be completed by calling the <see cref="M:System.Net.Sockets.TcpClient.EndConnect(System.IAsyncResult)" /> method. Typically, the method is invoked by the <paramref name="asyncCallback" /> delegate.</para>
@@ -320,6 +325,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous request for a remote host connection. The remote host is specified by a host name (<see cref="T:System.String" />) and a port number (<see cref="T:System.Int32" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object that references the asynchronous connection.</para>
+        </returns>
         <param name="host">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the remote host.</param>
         <param name="port">
@@ -543,7 +552,6 @@
         <Parameter Name="port" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned Returns <see cref="T:System.Threading.Tasks.Task" />  object will complete after the TCP connection has been established. This method does not block the calling thread while the connection request is underway.</para>
@@ -559,6 +567,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Connects the client to a remote TCP host using the specified IP address and port number as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task" /></para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.IPAddress" /> of the host to which you intend to connect. </param>
         <param name="port">
@@ -580,7 +593,6 @@
         <Parameter Name="port" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned Returns <see cref="T:System.Threading.Tasks.Task" />  object will complete after the TCP connection has been established. This method does not block the calling thread while the connection request is underway.</para>
@@ -596,6 +608,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Connects the client to a remote TCP host using the specified IP addresses and port number as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task" /></para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="addresses">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.IPAddress" /> array of the host to which you intend to connect.</param>
         <param name="port">
@@ -617,7 +634,6 @@
         <Parameter Name="port" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned Returns <see cref="T:System.Threading.Tasks.Task" />  object will complete after the TCP connection has been established. This method does not block the calling thread while the connection request is underway.</para>
@@ -634,6 +650,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Connects the client to the specified TCP port on the specified host as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task" /></para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="host">
           <attribution license="cc4" from="Microsoft" modified="false" />The DNS name of the remote host to which you intend to connect. </param>
         <param name="port">
@@ -790,7 +811,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>The <see cref="T:System.Net.Sockets.NetworkStream" /> object connected to the connection socket.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -810,6 +830,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Net.Sockets.NetworkStream" /> used to send and receive data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The underlying <see cref="T:System.Net.Sockets.NetworkStream" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="LingerState">
diff --git a/mcs/class/System/Documentation/en/System.Net.Sockets/TcpListener.xml b/mcs/class/System/Documentation/en/System.Net.Sockets/TcpListener.xml
index 10bfc31d64a..42ac69cfb33 100644
--- a/mcs/class/System/Documentation/en/System.Net.Sockets/TcpListener.xml
+++ b/mcs/class/System/Documentation/en/System.Net.Sockets/TcpListener.xml
@@ -142,7 +142,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>A newly connected <see cref="T:System.Net.Sockets.Socket" />.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -156,6 +155,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Accepts a pending connection request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.Sockets.Socket" /> used to send and receive data.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="AcceptSocketAsync">
@@ -170,7 +173,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" />  object will complete after the socket connection has been accepted.</para>
@@ -183,6 +185,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Accepts a pending connection request as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" /></para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.Net.Sockets.Socket" /> used to send and receive data.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="AcceptTcpClient">
@@ -199,7 +206,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>A newly connected <see cref="T:System.Net.Sockets.TcpClient" />.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -213,6 +219,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Accepts a pending connection request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.Sockets.TcpClient" /> used to send and receive data.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="AcceptTcpClientAsync">
@@ -227,7 +237,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" />  object will complete after the TCP connection has been accepted.</para>
@@ -240,6 +249,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Accepts a pending connection request as an asynchronous operation. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" /></para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.Net.Sockets.TcpClient" /> used to send and receive data.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Active">
@@ -282,7 +296,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The asynchronous <see cref="M:System.Net.Sockets.TcpListener.BeginAcceptSocket(System.AsyncCallback,System.Object)" /> operation must be completed by calling the <see cref="M:System.Net.Sockets.TcpListener.EndAcceptSocket(System.IAsyncResult)" /> method. Typically, the method is invoked by the <paramref name="callback" /> delegate.</para>
@@ -302,6 +315,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to accept an incoming connection attempt.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that references the asynchronous creation of the <see cref="T:System.Net.Sockets.Socket" />.</para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.AsyncCallback" /> delegate that references the method to invoke when the operation is complete.</param>
         <param name="state">
@@ -324,7 +341,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The asynchronous <see cref="M:System.Net.Sockets.TcpListener.BeginAcceptTcpClient(System.AsyncCallback,System.Object)" /> operation must be completed by calling the <see cref="M:System.Net.Sockets.TcpListener.EndAcceptTcpClient(System.IAsyncResult)" /> method. Typically, the method is invoked by the <paramref name="callback" /> delegate.</para>
@@ -341,6 +357,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous operation to accept an incoming connection attempt.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that references the asynchronous creation of the <see cref="T:System.Net.Sockets.TcpClient" />.</para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.AsyncCallback" /> delegate that references the method to invoke when the operation is complete.</param>
         <param name="state">
@@ -362,7 +382,6 @@
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method blocks until the operation is complete. To perform this operation synchronously, use the <see cref="M:System.Net.Sockets.TcpListener.AcceptSocket" /> method.</para>
@@ -380,6 +399,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously accepts an incoming connection attempt and creates a new <see cref="T:System.Net.Sockets.Socket" /> to handle remote host communication.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.Sockets.Socket" />.</para>
+          <para>The <see cref="T:System.Net.Sockets.Socket" /> used to send and receive data.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IAsyncResult" /> returned by a call to the <see cref="M:System.Net.Sockets.TcpListener.BeginAcceptSocket(System.AsyncCallback,System.Object)" />  method.</param>
       </Docs>
@@ -399,7 +423,6 @@
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method blocks until the operation is complete. To perform this operation synchronously, use the <see cref="M:System.Net.Sockets.TcpListener.AcceptTcpClient" /> method.</para>
@@ -417,6 +440,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously accepts an incoming connection attempt and creates a new <see cref="T:System.Net.Sockets.TcpClient" /> to handle remote host communication.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.Sockets.TcpClient" />.</para>
+          <para>The <see cref="T:System.Net.Sockets.TcpClient" /> used to send and receive data.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IAsyncResult" /> returned by a call to the <see cref="M:System.Net.Sockets.TcpListener.BeginAcceptTcpClient(System.AsyncCallback,System.Object)" /> method.</param>
       </Docs>
@@ -507,7 +535,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>Returns 'true' if there are pending connections and 'false' otherwise.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This non-blocking method determines if there are any pending connection requests. Because the <see cref="M:System.Net.Sockets.TcpListener.AcceptSocket" /> and <see cref="M:System.Net.Sockets.TcpListener.AcceptTcpClient" /> methods block execution until the <see cref="M:System.Net.Sockets.TcpListener.Start" /> method has queued an incoming connection request, the <see cref="M:System.Net.Sockets.TcpListener.Pending" /> method can be used to determine if connections are available before attempting to accept them.</para>
@@ -516,6 +543,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if there are pending connection requests.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if connections are pending; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Server">
diff --git a/mcs/class/System/Documentation/en/System.Net.Sockets/UdpClient.xml b/mcs/class/System/Documentation/en/System.Net.Sockets/UdpClient.xml
index 2d86fe5d265..577bffa27f6 100644
--- a/mcs/class/System/Documentation/en/System.Net.Sockets/UdpClient.xml
+++ b/mcs/class/System/Documentation/en/System.Net.Sockets/UdpClient.xml
@@ -292,7 +292,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The asynchronous <see cref="M:System.Net.Sockets.UdpClient.BeginReceive(System.AsyncCallback,System.Object)" /> operation must be completed by calling the <see cref="M:System.Net.Sockets.UdpClient.EndReceive(System.IAsyncResult,System.Net.IPEndPoint@)" /> method. Typically, the method is invoked by the <paramref name="requestCallback" /> delegate.</para>
@@ -303,6 +302,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Receives a datagram from a remote host asynchronously.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object that references the asynchronous receive.</para>
+        </returns>
         <param name="requestCallback">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.AsyncCallback" /> delegate that references the method to invoke when the operation is complete. </param>
         <param name="state">
@@ -327,7 +330,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The asynchronous <see cref="M:System.Net.Sockets.UdpClient.BeginSend(System.Byte[],System.Int32,System.AsyncCallback,System.Object)" /> operation must be completed by calling the <see cref="M:System.Net.Sockets.UdpClient.EndSend(System.IAsyncResult)" /> method. Typically, the method is invoked by the <paramref name="requestCallback" /> delegate.</para>
@@ -338,6 +340,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends a datagram to a remote host asynchronously. The destination was specified previously by a call to <see cref="Overload:System.Net.Sockets.UdpClient.Connect" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object that references the asynchronous send.</para>
+        </returns>
         <param name="datagram">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Byte" /> array that contains the data to be sent.</param>
         <param name="bytes">
@@ -367,7 +373,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The asynchronous <see cref="M:System.Net.Sockets.UdpClient.BeginSend(System.Byte[],System.Int32,System.Net.IPEndPoint,System.AsyncCallback,System.Object)" /> operation must be completed by calling the <see cref="M:System.Net.Sockets.UdpClient.EndSend(System.IAsyncResult)" /> method. Typically, the method is invoked by the <paramref name="requestCallback" /> delegate.</para>
@@ -378,6 +383,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends a datagram to a destination asynchronously. The destination is specified by a <see cref="T:System.Net.EndPoint" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object that references the asynchronous send.</para>
+        </returns>
         <param name="datagram">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Byte" /> array that contains the data to be sent.</param>
         <param name="bytes">
@@ -410,7 +419,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The asynchronous <see cref="M:System.Net.Sockets.UdpClient.BeginSend(System.Byte[],System.Int32,System.String,System.Int32,System.AsyncCallback,System.Object)" /> operation must be completed by calling the <see cref="M:System.Net.Sockets.UdpClient.EndSend(System.IAsyncResult)" /> method. Typically, the method is invoked by the <paramref name="requestCallback" /> delegate.</para>
@@ -421,6 +429,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends a datagram to a destination asynchronously. The destination is specified by the host name and port number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object that references the asynchronous send.</para>
+        </returns>
         <param name="datagram">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Byte" /> array that contains the data to be sent.</param>
         <param name="bytes">
@@ -773,7 +785,6 @@
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method blocks until the operation is complete. </para>
@@ -783,6 +794,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ends a pending asynchronous send.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If successful, the number of bytes sent to the <see cref="T:System.Net.Sockets.UdpClient" />.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IAsyncResult" /> object returned by a call to <see cref="Overload:System.Net.Sockets.UdpClient.BeginSend" />.</param>
       </Docs>
@@ -1038,7 +1053,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" />&gt; object will complete after the UDP packet has been received.</para>
@@ -1052,6 +1066,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a UDP datagram asynchronously that was sent by a remote host.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Send">
@@ -1071,7 +1090,6 @@
         <Parameter Name="bytes" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload sends datagrams to the remote host established in the <see cref="M:System.Net.Sockets.UdpClient.Connect(System.String,System.Int32)" /> method and returns the number of bytes sent. If you do not call <see cref="M:System.Net.Sockets.UdpClient.Connect(System.String,System.Int32)" /> before calling this overload, the <see cref="M:System.Net.Sockets.UdpClient.Send(System.Byte[],System.Int32,System.Net.IPEndPoint)" /> method will throw a <see cref="T:System.Net.Sockets.SocketException" />. If you receive a <see cref="T:System.Net.Sockets.SocketException" />, use <see cref="P:System.Net.Sockets.SocketException.ErrorCode" /> to obtain the specific error code. Once you have obtained this code, you can refer to the Windows Sockets version 2 API error code documentation in MSDN for a detailed description of the error.</para>
@@ -1081,6 +1099,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends a UDP datagram to a remote host.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes sent.</para>
+        </returns>
         <param name="dgram">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Byte" /> that specifies the UDP datagram that you intend to send represented as an array of bytes. </param>
         <param name="bytes">
@@ -1105,7 +1127,6 @@
         <Parameter Name="endPoint" Type="System.Net.IPEndPoint" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.Sockets.UdpClient.Send(System.Byte[],System.Int32,System.Net.IPEndPoint)" /> method sends datagrams to the specified endpoint and returns the number of bytes successfully sent. Before calling this overload, you must first create an <see cref="T:System.Net.IPEndPoint" /> using the IP address and port number of the remote host to which your datagrams will be delivered. You can send datagrams to the default broadcast address, 255.255.255.255, by specifying <see cref="F:System.Net.Sockets.SocketOptionName.Broadcast" /> for the <see cref="P:System.Net.IPAddress.Address" /> property of the <see cref="T:System.Net.IPEndPoint" />. After you have created this <see cref="T:System.Net.IPEndPoint" />, pass it to the <see cref="M:System.Net.Sockets.UdpClient.Send(System.Byte[],System.Int32,System.Net.IPEndPoint)" /> method as the <paramref name="endPoint" /> parameter.</para>
@@ -1118,6 +1139,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends a UDP datagram to the host at the specified remote endpoint.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes sent.</para>
+        </returns>
         <param name="dgram">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Byte" /> that specifies the UDP datagram that you intend to send, represented as an array of bytes. </param>
         <param name="bytes">
@@ -1145,7 +1170,6 @@
         <Parameter Name="port" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.Sockets.UdpClient.Send(System.Byte[],System.Int32,System.Net.IPEndPoint)" /> method sends datagrams to the values specified by the <paramref name="hostname" /> and <paramref name="port" /> parameters and returns the number of bytes successfully sent. You can send datagrams to the default broadcast address by specifying "255.255.255.255" for the <paramref name="hostname" /> parameter value.</para>
@@ -1158,6 +1182,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends a UDP datagram to a specified port on a specified remote host.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes sent.</para>
+        </returns>
         <param name="dgram">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Byte" /> that specifies the UDP datagram that you intend to send represented as an array of bytes. </param>
         <param name="bytes">
@@ -1183,7 +1211,6 @@
         <Parameter Name="bytes" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload sends datagrams to the remote host established in the <see cref="M:System.Net.Sockets.UdpClient.Connect(System.String,System.Int32)" /> method. If you do not call <see cref="M:System.Net.Sockets.UdpClient.Connect(System.String,System.Int32)" /> before calling this overload, the method will throw a <see cref="T:System.Net.Sockets.SocketException" />. If you receive a <see cref="T:System.Net.Sockets.SocketException" />, use <see cref="P:System.Net.Sockets.SocketException.ErrorCode" /> to obtain the specific error code. Once you have obtained this code, you can refer to the Windows Sockets version 2 API error code documentation in MSDN for a detailed description of the error.</para>
@@ -1193,6 +1220,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends a UDP datagram asynchronously to a remote host.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="datagram">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Byte" /> that specifies the UDP datagram that you intend to send represented as an array of bytes.</param>
         <param name="bytes">
@@ -1215,7 +1246,6 @@
         <Parameter Name="endPoint" Type="System.Net.IPEndPoint" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method sends datagrams to the specified endpoint. Before calling this overload, you must first create an <see cref="T:System.Net.IPEndPoint" /> using the IP address and port number of the remote host to which your datagrams will be delivered. You can send datagrams to the default broadcast address, 255.255.255.255, by specifying <see cref="F:System.Net.Sockets.SocketOptionName.Broadcast" /> for the <see cref="P:System.Net.IPAddress.Address" /> property of the <see cref="T:System.Net.IPEndPoint" />. After you have created this <see cref="T:System.Net.IPEndPoint" />, pass it to this method as the <paramref name="endPoint" /> parameter.</para>
@@ -1228,6 +1258,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends a UDP datagram asynchronously to a remote host.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="datagram">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Byte" /> that specifies the UDP datagram that you intend to send represented as an array of bytes.</param>
         <param name="bytes">
@@ -1253,7 +1287,6 @@
         <Parameter Name="port" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method sends datagrams to the values specified by the <paramref name="hostname" /> and <paramref name="port" /> parameters. You can send datagrams to the default broadcast address by specifying "255.255.255.255" for the <paramref name="hostname" /> parameter value.</para>
@@ -1266,6 +1299,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends a UDP datagram asynchronously to a remote host.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="datagram">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.Byte" /> that specifies the UDP datagram that you intend to send represented as an array of bytes.</param>
         <param name="bytes">
diff --git a/mcs/class/System/Documentation/en/System.Net.Sockets/UdpReceiveResult.xml b/mcs/class/System/Documentation/en/System.Net.Sockets/UdpReceiveResult.xml
index dcc259d8523..540404c6190 100644
--- a/mcs/class/System/Documentation/en/System.Net.Sockets/UdpReceiveResult.xml
+++ b/mcs/class/System/Documentation/en/System.Net.Sockets/UdpReceiveResult.xml
@@ -78,12 +78,16 @@
         <Parameter Name="other" Type="System.Net.Sockets.UdpReceiveResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if <paramref name="other" /> is an instance of <see cref="T:System.Net.Sockets.UdpReceiveResult" /> and equals the value of the instance; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this instance.</param>
       </Docs>
@@ -102,12 +106,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if <paramref name="obj" /> is an instance of <see cref="T:System.Net.Sockets.UdpReceiveResult" /> and equals the value of the instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this instance.</param>
       </Docs>
@@ -124,12 +132,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Int32" />.</para>
+          <para>The hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="op_Equality">
@@ -147,12 +159,16 @@
         <Parameter Name="right" Type="System.Net.Sockets.UdpReceiveResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether two specified <see cref="T:System.Net.Sockets.UdpReceiveResult" /> instances are equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if <paramref name="left" /> and <paramref name="right" /> are equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.Sockets.UdpReceiveResult" /> instance that is to the left of the equality operator.</param>
         <param name="right">
@@ -174,12 +190,16 @@
         <Parameter Name="right" Type="System.Net.Sockets.UdpReceiveResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether two specified <see cref="T:System.Net.Sockets.UdpReceiveResult" /> instances are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if <paramref name="left" /> and <paramref name="right" /> are unequal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.Sockets.UdpReceiveResult" /> instance that is to the left of the not equal operator.</param>
         <param name="right">
diff --git a/mcs/class/System/Documentation/en/System.Net.WebSockets/ClientWebSocket.xml b/mcs/class/System/Documentation/en/System.Net.WebSockets/ClientWebSocket.xml
index b2d07275706..7b4d7bd3afc 100644
--- a/mcs/class/System/Documentation/en/System.Net.WebSockets/ClientWebSocket.xml
+++ b/mcs/class/System/Documentation/en/System.Net.WebSockets/ClientWebSocket.xml
@@ -90,7 +90,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task" /> object will complete after the <see cref="T:System.Net.WebSockets.ClientWebSocket" /> instance is closed.</para>
@@ -99,6 +98,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Close the <see cref="T:System.Net.WebSockets.ClientWebSocket" /> instance as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="closeStatus">
           <attribution license="cc4" from="Microsoft" modified="false" />The WebSocket close status.</param>
         <param name="statusDescription">
@@ -131,7 +135,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task" />  object will complete after the output on the <see cref="T:System.Net.WebSockets.ClientWebSocket" /> instance is closed.</para>
@@ -140,6 +143,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Close the output for the <see cref="T:System.Net.WebSockets.ClientWebSocket" /> instance as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="closeStatus">
           <attribution license="cc4" from="Microsoft" modified="false" />The WebSocket close status.</param>
         <param name="statusDescription">
@@ -209,7 +217,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.WebSockets.ClientWebSocket.ConnectAsync(System.Uri,System.Threading.CancellationToken)" />  method initiates the WebSocket handshake with a remote network destination, and then negotiates the sub-protocol.</para>
@@ -220,6 +227,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Connect to a WebSocket server as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="uri">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the WebSocket server to connect to.</param>
         <param name="cancellationToken">
@@ -279,7 +291,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the receive request on the <see cref="T:System.Net.WebSockets.ClientWebSocket" /> instance has completed.</para>
@@ -288,6 +299,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Receive data on <see cref="T:System.Net.WebSockets.ClientWebSocket" /> as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer to receive the response.</param>
         <param name="cancellationToken">
@@ -311,7 +327,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task" />  object will complete after the send request on the <see cref="T:System.Net.WebSockets.ClientWebSocket" /> instance has completed.</para>
@@ -320,6 +335,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Send data on <see cref="T:System.Net.WebSockets.ClientWebSocket" /> as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer containing the message to be sent.</param>
         <param name="messageType">
diff --git a/mcs/class/System/Documentation/en/System.Net.WebSockets/WebSocket.xml b/mcs/class/System/Documentation/en/System.Net.WebSockets/WebSocket.xml
index 1d878f31d53..2b1b172709c 100644
--- a/mcs/class/System/Documentation/en/System.Net.WebSockets/WebSocket.xml
+++ b/mcs/class/System/Documentation/en/System.Net.WebSockets/WebSocket.xml
@@ -77,7 +77,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task" />   object will complete after the WebSocket has been closed.</para>
@@ -87,6 +86,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Closes the WebSocket connection as an asynchronous operation using the close handshake defined in the <see cref="http://tools.ietf.org/html/draft-ietf-hybi-thewebsocketprotocol-06">WebSocket protocol specification</see> section 7.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task" />.</para>
+          <para>The task object representing the asynchronous operation. </para>
+        </returns>
         <param name="closeStatus">
           <attribution license="cc4" from="Microsoft" modified="false" />Indicates the reason for closing the WebSocket connection.</param>
         <param name="statusDescription">
@@ -111,7 +115,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task" />   object will complete after the output on the WebSocket has been closed.</para>
@@ -120,6 +123,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initiates or completes the close handshake defined in the <see cref="http://tools.ietf.org/html/draft-ietf-hybi-thewebsocketprotocol-06">WebSocket protocol specification section 7</see>.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task" />.</para>
+          <para>The task object representing the asynchronous operation. </para>
+        </returns>
         <param name="closeStatus">
           <attribution license="cc4" from="Microsoft" modified="false" />Indicates the reason for closing the WebSocket connection.</param>
         <param name="statusDescription">
@@ -189,12 +197,16 @@
         <Parameter Name="sendBufferSize" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Create client buffers to use with this <see cref="T:System.Net.WebSockets.WebSocket" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.ArraySegment`1" />.</para>
+          <para>An array with the client buffers.</para>
+        </returns>
         <param name="receiveBufferSize">
           <attribution license="cc4" from="Microsoft" modified="false" />The size, in bytes, of the client receive buffer.</param>
         <param name="sendBufferSize">
@@ -226,13 +238,16 @@
         <Parameter Name="internalBuffer" Type="System.ArraySegment&lt;System.Byte&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.</para>
           <para>Allows callers to create a client side WebSocket class which will use the WSPC for framing purposes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Net.WebSockets.WebSocket" />.</para>
+        </returns>
         <param name="innerStream">
           <attribution license="cc4" from="Microsoft" modified="false" />The connection to be used for IO operations.</param>
         <param name="subProtocol">
@@ -268,12 +283,15 @@
         <Parameter Name="receiveBufferSize" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a WebSocket server buffer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.ArraySegment`1" />.</para>
+        </returns>
         <param name="receiveBufferSize">
           <attribution license="cc4" from="Microsoft" modified="false" />The size, in bytes, of the desired buffer.</param>
       </Docs>
@@ -341,12 +359,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates if the WebSocket instance is targeting net_v45.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if the <see cref="T:System.Net.WebSockets.WebSocket" /> is targeting net_v45; otherwise false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsStateTerminal">
@@ -363,12 +385,16 @@
         <Parameter Name="state" Type="System.Net.WebSockets.WebSocketState" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates if the state of the WebSocket instance is closed or aborted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+          <para>true if the <see cref="T:System.Net.WebSockets.WebSocket" /> is closed or aborted; otherwise false.</para>
+        </returns>
         <param name="state">
           <attribution license="cc4" from="Microsoft" modified="false" />The current state of the WebSocket.</param>
       </Docs>
@@ -388,7 +414,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" />   object will complete after the data has been received on the  WebSocket.</para>
@@ -397,6 +422,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Receives data from the WebSocket connection asynchronously.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.Byte" /> array containing the received data.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />References the application buffer that is the storage location for the received data.</param>
         <param name="cancellationToken">
@@ -444,7 +474,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task" />   object will complete after the data has been sent on the WebSocket.</para>
@@ -453,6 +482,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sends data over the WebSocket connection asynchronously.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task" />.</para>
+          <para>The task object representing the asynchronous operation. </para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer to be sent over the connection.</param>
         <param name="messageType">
diff --git a/mcs/class/System/Documentation/en/System.Net/AuthenticationManager.xml b/mcs/class/System/Documentation/en/System.Net/AuthenticationManager.xml
index 0beaab1c10c..ba535481a48 100644
--- a/mcs/class/System/Documentation/en/System.Net/AuthenticationManager.xml
+++ b/mcs/class/System/Documentation/en/System.Net/AuthenticationManager.xml
@@ -53,14 +53,6 @@
         <Parameter Name="credentials" Type="System.Net.ICredentials" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Net.Authorization" /> instance containing the response from the
-   authentication module, or <see langword="null" /> if no authentication module
-   responded to the challenge.</para>
-          <para> Applications do not call this method; it is called by
-<see cref="T:System.Net.WebRequest" /> 
-instances.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="challenge " />, <paramref name="request " />, or <paramref name="credentials " /> is <see langword="null" />.</exception>
         <remarks>
@@ -73,6 +65,10 @@ instances.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calls each registered authentication module to find the first module that can respond to the authentication request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the <see cref="T:System.Net.Authorization" /> class containing the result of the authorization attempt. If there is no authentication module to respond to the challenge, this method returns null.</para>
+        </returns>
         <param name="challenge">
           <attribution license="cc4" from="Microsoft" modified="false" />The challenge returned by the Internet resource. </param>
         <param name="request">
@@ -161,12 +157,6 @@ instances.</para>
         <Parameter Name="credentials" Type="System.Net.ICredentials" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Net.Authorization" /> instance if an authentication module can provide
-   authentication information to be sent with <paramref name="request" /> ;
-   otherwise, <see langword="null" />. If <paramref name="credentials" />
-   is <see langword="null" />, this method returns <see langword="null" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <para>
             <paramref name="request " />is <see langword="null." /></para>
@@ -180,6 +170,10 @@ instances.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Preauthenticates a request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the <see cref="T:System.Net.Authorization" /> class if the request can be preauthenticated; otherwise, null. If <paramref name="credentials" /> is null, this method returns null.</para>
+        </returns>
         <param name="request">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Net.WebRequest" /> to an Internet resource. </param>
         <param name="credentials">
diff --git a/mcs/class/System/Documentation/en/System.Net/Cookie.xml b/mcs/class/System/Documentation/en/System.Net/Cookie.xml
index 9559e929bfa..083f4171e71 100644
--- a/mcs/class/System/Documentation/en/System.Net/Cookie.xml
+++ b/mcs/class/System/Documentation/en/System.Net/Cookie.xml
@@ -280,12 +280,15 @@
         <Parameter Name="comparand" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Overrides the <see cref="M:System.Object.Equals(System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if the <see cref="T:System.Net.Cookie" /> is equal to <paramref name="comparand" />. Two <see cref="T:System.Net.Cookie" /> instances are equal if their <see cref="P:System.Net.Cookie.Name" />, <see cref="P:System.Net.Cookie.Value" />, <see cref="P:System.Net.Cookie.Path" />, <see cref="P:System.Net.Cookie.Domain" />, and <see cref="P:System.Net.Cookie.Version" /> properties are equal. <see cref="P:System.Net.Cookie.Name" /> and <see cref="P:System.Net.Cookie.Domain" /> string comparisons are case-insensitive.</para>
+        </returns>
         <param name="comparand">
           <attribution license="cc4" from="Microsoft" modified="false" />A reference to a <see cref="T:System.Net.Cookie" />. </param>
       </Docs>
@@ -357,7 +360,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Classes that might be used as a key in a hash table must provide this override, because objects that are used as keys in a hash table are required to generate their own hash code through this method.</para>
@@ -366,6 +368,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Overrides the <see cref="M:System.Object.GetHashCode" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 32-bit signed integer hash code for this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HttpOnly">
@@ -534,7 +540,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The exact format of the string depends on the RFC that this cookie conforms to.</para>
@@ -543,6 +548,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Overrides the <see cref="M:System.Object.ToString" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a string representation of this <see cref="T:System.Net.Cookie" /> object that is suitable for including in a HTTP Cookie: request header.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/System/Documentation/en/System.Net/CookieCollection.xml b/mcs/class/System/Documentation/en/System.Net/CookieCollection.xml
index 44ce164cc6a..9dc2e8e099a 100644
--- a/mcs/class/System/Documentation/en/System.Net/CookieCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Net/CookieCollection.xml
@@ -240,7 +240,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IEnumerator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You should use an <see cref="T:System.Collections.IEnumerator" /> only to read data in the collection. Enumerators cannot be used to modify the underlying collection. The enumerator does not have exclusive access to the collection.</para>
@@ -250,6 +249,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an enumerator that can iterate through a <see cref="T:System.Net.CookieCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of an implementation of an <see cref="T:System.Collections.IEnumerator" /> interface that can iterate through a <see cref="T:System.Net.CookieCollection" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsReadOnly">
diff --git a/mcs/class/System/Documentation/en/System.Net/CookieContainer.xml b/mcs/class/System/Documentation/en/System.Net/CookieContainer.xml
index 9a0ee1aa405..2640c998196 100644
--- a/mcs/class/System/Documentation/en/System.Net/CookieContainer.xml
+++ b/mcs/class/System/Documentation/en/System.Net/CookieContainer.xml
@@ -375,7 +375,6 @@
         <Parameter Name="uri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -386,6 +385,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the HTTP cookie header that contains the HTTP cookies that represent the <see cref="T:System.Net.Cookie" /> instances that are associated with a specific URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An HTTP cookie header, with strings representing <see cref="T:System.Net.Cookie" /> instances delimited by semicolons.</para>
+        </returns>
         <param name="uri">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the <see cref="T:System.Net.Cookie" /> instances desired. </param>
       </Docs>
@@ -406,7 +409,6 @@
         <Parameter Name="uri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'CookieCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A new instance of a <see cref="T:System.Net.CookieCollection" /> is created. Then the <see cref="T:System.Net.Cookie" /> instances in the internal collection that are associated with the specified URI are read out and added to the new <see cref="T:System.Net.CookieCollection" />.</para>
@@ -415,6 +417,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Net.CookieCollection" /> that contains the <see cref="T:System.Net.Cookie" /> instances that are associated with a specific URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.CookieCollection" /> that contains the <see cref="T:System.Net.Cookie" /> instances that are associated with a specific URI.</para>
+        </returns>
         <param name="uri">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the <see cref="T:System.Net.Cookie" /> instances desired. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Net/CredentialCache.xml b/mcs/class/System/Documentation/en/System.Net/CredentialCache.xml
index bacf6d86b0d..add97957099 100644
--- a/mcs/class/System/Documentation/en/System.Net/CredentialCache.xml
+++ b/mcs/class/System/Documentation/en/System.Net/CredentialCache.xml
@@ -223,10 +223,6 @@
         <Parameter Name="authType" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Net.NetworkCredential" />, or <see langword="null" /> if there is no
-   matching credential in the cache.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">The <paramref name="uriPrefix" /> or <paramref name="authType" /> parameter is <see langword="null" />.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -274,6 +270,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Net.NetworkCredential" /> instance associated with the specified Uniform Resource Identifier (URI) and authentication type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.NetworkCredential" /> or, if there is no matching credential in the cache, null.</para>
+        </returns>
         <param name="uriPrefix">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Uri" /> that specifies the URI prefix of the resources that the credential grants access to. </param>
         <param name="authType">
@@ -298,7 +298,6 @@
         <Parameter Name="authenticationType" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method searches the <see cref="T:System.Net.CredentialCache" /> and returns the <see cref="T:System.Net.NetworkCredential" /> instance for the specified host, port, and authorization type. The <paramref name="host" />, <paramref name="port" />, and <paramref name="authType" /> values passed to this method are case-insensitively compared to the values specified when the credential was added to the <see cref="T:System.Net.CredentialCache" /> using the <see cref="Overload:System.Net.CredentialCache.Add" /> methods.</para>
@@ -308,6 +307,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Net.NetworkCredential" /> instance associated with the specified host, port, and authentication protocol.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.NetworkCredential" /> or, if there is no matching credential in the cache, null.</para>
+        </returns>
         <param name="host">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that identifies the host computer.</param>
         <param name="port">
@@ -331,14 +334,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Collections.IEnumerator" /> for the current <see cref="T:System.Net.CredentialCache" /> instance.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that can iterate through the <see cref="T:System.Net.CredentialCache" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.Net.CredentialCache" />.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/System/Documentation/en/System.Net/Dns.xml b/mcs/class/System/Documentation/en/System.Net/Dns.xml
index 10a835169d2..959d7eb05ac 100644
--- a/mcs/class/System/Documentation/en/System.Net/Dns.xml
+++ b/mcs/class/System/Documentation/en/System.Net/Dns.xml
@@ -46,7 +46,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.Dns.BeginGetHostAddresses(System.String,System.AsyncCallback,System.Object)" /> method asynchronously queries a DNS server for the IP addresses that are associated with a host name. If <paramref name="hostNameOrAddress" /> is an IP address, this address is returned without querying the DNS server.</para>
@@ -62,6 +61,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously returns the Internet Protocol (IP) addresses for the specified host.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> instance that references the asynchronous request.</para>
+        </returns>
         <param name="hostNameOrAddress">
           <attribution license="cc4" from="Microsoft" modified="false" />The host name or IP address to resolve.</param>
         <param name="requestCallback">
@@ -94,9 +97,6 @@
         <Parameter Name="stateObject" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.IAsyncResult" /> instance that contains information about the asynchronous operation.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="hostName" /> is <see langword="null" /> .</exception>
         <exception cref="T:System.Net.Sockets.SocketException">An error was encountered executing the DNS query .</exception>
@@ -115,6 +115,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous request for <see cref="T:System.Net.IPHostEntry" /> information about the specified DNS host name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> instance that references the asynchronous request.</para>
+        </returns>
         <param name="hostName">
           <attribution license="cc4" from="Microsoft" modified="false" />The DNS name of the host. </param>
         <param name="requestCallback">
@@ -141,7 +145,6 @@
         <Parameter Name="stateObject" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.Dns.BeginGetHostEntry(System.Net.IPAddress,System.AsyncCallback,System.Object)" /> method asynchronously queries a DNS server for the IP addresses and aliases associated with an IP address.</para>
@@ -154,6 +157,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously resolves an IP address to an <see cref="T:System.Net.IPHostEntry" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> instance that references the asynchronous request.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The IP address to resolve.</param>
         <param name="requestCallback">
@@ -179,7 +186,6 @@
         <Parameter Name="stateObject" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.Dns.BeginGetHostEntry(System.String,System.AsyncCallback,System.Object)" /> method queries a DNS server for the IP address that is associated with a host name or IP address.</para>
@@ -192,6 +198,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously resolves a host name or IP address to an <see cref="T:System.Net.IPHostEntry" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> instance that references the asynchronous request.</para>
+        </returns>
         <param name="hostNameOrAddress">
           <attribution license="cc4" from="Microsoft" modified="false" />The host name or IP address to resolve.</param>
         <param name="requestCallback">
@@ -224,9 +234,6 @@
         <Parameter Name="stateObject" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.IAsyncResult" /> instance that contains information about the asynchronous operation.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="hostName" /> is <see langword="null" /> .</exception>
         <exception cref="T:System.Net.Sockets.SocketException">An error was encountered executing the DNS query .</exception>
@@ -245,6 +252,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous request to resolve a DNS host name or IP address to an <see cref="T:System.Net.IPAddress" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> instance that references the asynchronous request.</para>
+        </returns>
         <param name="hostName">
           <attribution license="cc4" from="Microsoft" modified="false" />The DNS name of the host. </param>
         <param name="requestCallback">
@@ -269,7 +280,6 @@
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.Dns.BeginGetHostAddresses(System.String,System.AsyncCallback,System.Object)" /> method queries a DNS server for the IP addresses associated with a host name. If <paramref name="hostNameOrAddress" /> is an IP address, this address is returned without querying the DNS server.</para>
@@ -282,6 +292,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ends an asynchronous request for DNS information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Net.IPAddress" /> that holds the IP addresses for the host specified by the <paramref name="hostNameOrAddress" /> parameter of <see cref="M:System.Net.Dns.BeginGetHostAddresses(System.String,System.AsyncCallback,System.Object)" />.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IAsyncResult" /> instance returned by a call to the <see cref="M:System.Net.Dns.BeginGetHostAddresses(System.String,System.AsyncCallback,System.Object)" /> method.</param>
       </Docs>
@@ -308,9 +322,6 @@
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Net.IPHostEntry" /> object containing DNS address information about a host. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="asyncResult " />is <see langword="null" />.</exception>
         <remarks>
@@ -326,6 +337,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ends an asynchronous request for DNS information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.IPHostEntry" /> object that contains DNS information about a host.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IAsyncResult" /> instance that is returned by a call to the <see cref="M:System.Net.Dns.BeginGetHostByName(System.String,System.AsyncCallback,System.Object)" /> method.</param>
       </Docs>
@@ -346,7 +361,6 @@
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method blocks until the operation is complete. </para>
@@ -360,6 +374,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ends an asynchronous request for DNS information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.IPHostEntry" /> instance that contains address information about the host.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IAsyncResult" /> instance returned by a call to an <see cref="Overload:System.Net.Dns.BeginGetHostEntry" /> method.</param>
       </Docs>
@@ -386,9 +404,6 @@
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Net.IPHostEntry" /> object containing address information about a host. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="asyncResult " />is <see langword="null" />.</exception>
         <remarks>
@@ -404,6 +419,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ends an asynchronous request for DNS information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.IPHostEntry" /> object that contains DNS information about a host.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IAsyncResult" /> instance that is returned by a call to the <see cref="M:System.Net.Dns.BeginResolve(System.String,System.AsyncCallback,System.Object)" /> method.</param>
       </Docs>
@@ -424,7 +443,6 @@
         <Parameter Name="hostNameOrAddress" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.Dns.GetHostAddresses(System.String)" /> method queries a DNS server for the IP addresses associated with a host name. If <paramref name="hostNameOrAddress" /> is an IP address, this address is returned without querying the DNS server.</para>
@@ -438,6 +456,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the Internet Protocol (IP) addresses for the specified host.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Net.IPAddress" /> that holds the IP addresses for the host that is specified by the <paramref name="hostNameOrAddress" /> parameter.</para>
+        </returns>
         <param name="hostNameOrAddress">
           <attribution license="cc4" from="Microsoft" modified="false" />The host name or IP address to resolve.</param>
       </Docs>
@@ -456,7 +478,6 @@
         <Parameter Name="hostNameOrAddress" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" />  object will complete after the <paramref name="hostNameOrAddress" /> has been resolved.</para>
@@ -466,6 +487,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the Internet Protocol (IP) addresses for the specified host as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns an array of type <see cref="T:System.Net.IPAddress" /> that holds the IP addresses for the host that is specified by the <paramref name="hostNameOrAddress" /> parameter.</para>
+        </returns>
         <param name="hostNameOrAddress">
           <attribution license="cc4" from="Microsoft" modified="false" />The host name or IP address to resolve.</param>
       </Docs>
@@ -492,9 +518,6 @@
         <Parameter Name="address" Type="System.Net.IPAddress" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Net.IPHostEntry" /> instance containing the host information.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="address " />is <see langword="null" /> .</exception>
         <exception cref="T:System.Net.Sockets.SocketException">An error was encountered executing the DNS query .</exception>
@@ -510,6 +533,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Net.IPHostEntry" /> instance from the specified <see cref="T:System.Net.IPAddress" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.IPHostEntry" />.</para>
+          <para>An <see cref="T:System.Net.IPHostEntry" /> instance.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Net.IPAddress" />. </param>
       </Docs>
@@ -537,9 +565,6 @@
         <Parameter Name="address" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Net.IPHostEntry" /> instance containing the host information.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="address " />is <see langword="null" /> .</exception>
         <exception cref="T:System.FormatException">
@@ -557,6 +582,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Net.IPHostEntry" /> instance from an IP address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.IPHostEntry" /> instance.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />An IP address. </param>
       </Docs>
@@ -584,11 +613,6 @@
         <Parameter Name="hostName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Net.IPHostEntry" /> object containing host information for the address
-   specified in <paramref name="hostName" />
-   .</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="hostName " />is <see langword="null" /> .</exception>
         <exception cref="T:System.Net.Sockets.SocketException">An error was encountered executing the DNS query .</exception>
@@ -607,6 +631,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the DNS information for the specified DNS host name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.IPHostEntry" /> object that contains host information for the address specified in <paramref name="hostName" />.</para>
+        </returns>
         <param name="hostName">
           <attribution license="cc4" from="Microsoft" modified="false" />The DNS name of the host. </param>
       </Docs>
@@ -627,7 +655,6 @@
         <Parameter Name="address" Type="System.Net.IPAddress" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.Dns.GetHostEntry(System.Net.IPAddress)" /> method queries a DNS server for the IP addresses and aliases associated with an IP address.</para>
@@ -641,6 +668,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resolves an IP address to an <see cref="T:System.Net.IPHostEntry" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.IPHostEntry" /> instance that contains address information about the host specified in <paramref name="address" />.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />An IP address.</param>
       </Docs>
@@ -660,7 +691,6 @@
         <Parameter Name="hostNameOrAddress" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.Dns.GetHostEntry(System.String)" /> method queries a DNS server for the IP address that is associated with a host name or IP address.</para>
@@ -692,6 +722,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resolves a host name or IP address to an <see cref="T:System.Net.IPHostEntry" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.IPHostEntry" /> instance that contains address information about the host specified in <paramref name="hostNameOrAddress" />.</para>
+        </returns>
         <param name="hostNameOrAddress">
           <attribution license="cc4" from="Microsoft" modified="false" />The host name or IP address to resolve.</param>
       </Docs>
@@ -710,7 +744,6 @@
         <Parameter Name="address" Type="System.Net.IPAddress" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" />  object will complete after the <paramref name="address" /> has been resolved.</para>
@@ -725,6 +758,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resolves an IP address to an <see cref="T:System.Net.IPHostEntry" /> instance as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns an <see cref="T:System.Net.IPHostEntry" /> instance that contains address information about the host specified in <paramref name="address" />.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />An IP address.</param>
       </Docs>
@@ -743,7 +781,6 @@
         <Parameter Name="hostNameOrAddress" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" />  object will complete after the <paramref name="hostNameOrAddress" /> has been resolved.</para>
@@ -776,6 +813,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resolves a host name or IP address to an <see cref="T:System.Net.IPHostEntry" /> instance as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns an <see cref="T:System.Net.IPHostEntry" /> instance that contains address information about the host specified in <paramref name="hostNameOrAddress" />.</para>
+        </returns>
         <param name="hostNameOrAddress">
           <attribution license="cc4" from="Microsoft" modified="false" />The host name or IP address to resolve.</param>
       </Docs>
@@ -795,10 +837,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing the DNS host name
-   of the local machine.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.Net.Sockets.SocketException">An error was encountered resolving the local host name.</exception>
         <exception cref="T:System.Security.SecurityException">The caller does not have permission to access DNS information.</exception>
@@ -807,6 +845,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the host name of the local computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the DNS host name of the local computer.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -832,12 +874,6 @@
         <Parameter Name="hostName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Net.IPHostEntry" /> instance
-   containing address information about the host specified in
-<paramref name="hostName" />
-.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="hostName " />is <see langword="null" /> .</exception>
         <exception cref="T:System.Net.Sockets.SocketException">An error was encountered executing the DNS query .</exception>
@@ -884,6 +920,10 @@ public class DnsTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resolves a DNS host name or IP address to an <see cref="T:System.Net.IPHostEntry" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.IPHostEntry" /> instance that contains address information about the host specified in <paramref name="hostName" />.</para>
+        </returns>
         <param name="hostName">
           <attribution license="cc4" from="Microsoft" modified="false" />A DNS-style host name or IP address. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Net/DnsEndPoint.xml b/mcs/class/System/Documentation/en/System.Net/DnsEndPoint.xml
index 4cbad76da34..cb11a4b139e 100644
--- a/mcs/class/System/Documentation/en/System.Net/DnsEndPoint.xml
+++ b/mcs/class/System/Documentation/en/System.Net/DnsEndPoint.xml
@@ -114,7 +114,6 @@
         <Parameter Name="comparand" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.DnsEndPoint.Equals(System.Object)" /> method compares the current <see cref="T:System.Net.DnsEndPoint" /> instance with the <paramref name="comparand" /> parameter and returns true if the two instances contain the same endpoint.</para>
@@ -123,6 +122,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Net.DnsEndPoint" /> objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two <see cref="T:System.Net.DnsEndPoint" /> instances are equal; otherwise, false.</para>
+        </returns>
         <param name="comparand">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Net.DnsEndPoint" /> instance to compare to the current instance.</param>
       </Docs>
@@ -139,7 +142,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.DnsEndPoint.GetHashCode" /> method returns a hash code of the <see cref="T:System.Net.DnsEndPoint" />. This value can be used as a key in hash tables.</para>
@@ -148,6 +150,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash value for a <see cref="T:System.Net.DnsEndPoint" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer hash value for the <see cref="T:System.Net.DnsEndPoint" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Host">
@@ -203,7 +209,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.DnsEndPoint.ToString" /> method returns a string that contains the address family, the host name or IP address string, and the port number.</para>
@@ -212,6 +217,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the host name or string representation of the IP address and port number of the <see cref="T:System.Net.DnsEndPoint" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the address family, host name or IP address string, and the port number of the specified <see cref="T:System.Net.DnsEndPoint" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.Net/DnsPermission.xml b/mcs/class/System/Documentation/en/System.Net/DnsPermission.xml
index d4dce8e7a11..c40e0b56d2e 100644
--- a/mcs/class/System/Documentation/en/System.Net/DnsPermission.xml
+++ b/mcs/class/System/Documentation/en/System.Net/DnsPermission.xml
@@ -77,10 +77,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A new <see cref="T:System.Net.DnsPermission" /> instance containing the same values as the current instance.
-   </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A copy of a <see cref="T:System.Net.DnsPermission" /> instance provides the same access to DNS servers as the original permission instance.</para>
@@ -89,6 +85,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an identical copy of the current permission instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the <see cref="T:System.Net.DnsPermission" /> class that is an identical copy of the current instance.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -148,14 +148,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Net.DnsPermission" /> instance that represents the intersection of the
-   current instance and <paramref name="target" />. If the intersection is
-   empty, returns <see langword="null" />. If the
-   current instance is unrestricted, returns a copy of <paramref name="target" />. If
-<paramref name="target" /> is unrestricted, returns a copy of 
-   the current instance.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="target " />is <see langword="null" />.</exception>
         <remarks>
@@ -166,6 +158,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a permission instance that is the intersection of the current permission instance and the specified permission instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.DnsPermission" /> instance that represents the intersection of the current <see cref="T:System.Net.DnsPermission" /> instance with the specified <see cref="T:System.Net.DnsPermission" /> instance, or null if the intersection is empty. If both the current instance and <paramref name="target" /> are unrestricted, this method returns a new <see cref="T:System.Net.DnsPermission" /> instance that is unrestricted; otherwise, it returns null.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.DnsPermission" /> instance to intersect with the current instance. </param>
       </Docs>
@@ -188,15 +184,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the current instance is a
-   subset of <paramref name="target" /> ; otherwise,<see langword=" false" />. If the current
-   instance is unrestricted, and <paramref name="target" /> is not, returns
-<see langword="false" />. If <paramref name="target" /> is unrestricted, returns 
-<see langword="true" />. If <paramref name="target" /> is <see langword="null" /> , returns 
-<see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current <see cref="T:System.Net.DnsPermission" /> instance is a subset of the specified <see cref="T:System.Net.DnsPermission" /> instance if the current <see cref="T:System.Net.DnsPermission" /> instance specifies a set of operations that is wholly contained by the specified <see cref="T:System.Net.DnsPermission" /> instance.</para>
@@ -206,6 +193,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current permission instance is a subset of the specified permission instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>false if the current instance is unrestricted and <paramref name="target" /> is either null or unrestricted; otherwise, true.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The second <see cref="T:System.Net.DnsPermission" /> instance to be tested for the subset relationship. </param>
       </Docs>
@@ -225,12 +216,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks the overall permission state of the object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Net.DnsPermission" /> instance was created with <see cref="F:System.Security.Permissions.PermissionState.Unrestricted" />; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToXml">
@@ -248,10 +242,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Security.SecurityElement" /> containing the XML encoding of the state of the
-   current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.DnsPermission.ToXml" /> method creates a <see cref="T:System.Security.SecurityElement" /> instance to XML-encode a representation of the <see cref="T:System.Net.DnsPermission" /> instance, including state information.</para>
@@ -261,6 +251,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of a <see cref="T:System.Net.DnsPermission" /> instance and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.SecurityElement" /> instance that contains an XML-encoded representation of the security object, including state information.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -281,12 +275,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Net.DnsPermission" /> instance that represents the union of the 
-   current instance and
-<paramref name="target" />. If the current instance or <paramref name="target" /> is unrestricted, 
-   returns a <see cref="T:System.Net.DnsPermission" /> instance that is unrestricted.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="target " />is <see langword="null" />.</exception>
         <remarks>
@@ -297,6 +285,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a permission instance that is the union of the current permission instance and the specified permission instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.DnsPermission" /> instance that represents the union of the current <see cref="T:System.Net.DnsPermission" /> instance with the specified <see cref="T:System.Net.DnsPermission" /> instance. If <paramref name="target" /> is null, this method returns a copy of the current instance. If the current instance or <paramref name="target" /> is unrestricted, this method returns a <see cref="T:System.Net.DnsPermission" /> instance that is unrestricted; otherwise, it returns a <see cref="T:System.Net.DnsPermission" /> instance that is restricted.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.DnsPermission" /> instance to combine with the current instance. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Net/DnsPermissionAttribute.xml b/mcs/class/System/Documentation/en/System.Net/DnsPermissionAttribute.xml
index fc8d6f11083..413c1fbc201 100644
--- a/mcs/class/System/Documentation/en/System.Net/DnsPermissionAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.Net/DnsPermissionAttribute.xml
@@ -81,9 +81,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Net.DnsPermission" /> object with the security information of the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The CreatePermission method is called by the security system, not by application code.</para>
@@ -93,6 +90,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new instance of the <see cref="T:System.Net.DnsPermission" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.DnsPermission" /> that corresponds to the security declaration.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/System/Documentation/en/System.Net/EndPoint.xml b/mcs/class/System/Documentation/en/System.Net/EndPoint.xml
index d9d5c14a26c..0d20f8d4235 100644
--- a/mcs/class/System/Documentation/en/System.Net/EndPoint.xml
+++ b/mcs/class/System/Documentation/en/System.Net/EndPoint.xml
@@ -96,10 +96,6 @@
         <Parameter Name="socketAddress" Type="System.Net.SocketAddress" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Net.EndPoint" /> instance containing the address
-   information from the specified <see cref="T:System.Net.SocketAddress" /> instance.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="behaviors"> As described above.</block>
@@ -125,6 +121,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Net.EndPoint" /> instance from a <see cref="T:System.Net.SocketAddress" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Net.EndPoint" /> instance that is initialized from the specified <see cref="T:System.Net.SocketAddress" /> instance.</para>
+        </returns>
         <param name="socketAddress">
           <attribution license="cc4" from="Microsoft" modified="false" />The socket address that serves as the endpoint for a connection. </param>
       </Docs>
@@ -144,12 +144,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serializes endpoint information into a <see cref="T:System.Net.SocketAddress" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.SocketAddress" /> instance that contains the endpoint information.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.Net/EndpointPermission.xml b/mcs/class/System/Documentation/en/System.Net/EndpointPermission.xml
index 0a566216869..83f4104ccdd 100644
--- a/mcs/class/System/Documentation/en/System.Net/EndpointPermission.xml
+++ b/mcs/class/System/Documentation/en/System.Net/EndpointPermission.xml
@@ -133,7 +133,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.EndpointPermission.ToString" /> method returns a string that represents the contents for the <see cref="T:System.Net.EndpointPermission" /> instance. The string is in the form <see cref="P:System.Net.EndpointPermission.Hostname" /> # <see cref="P:System.Net.EndpointPermission.Port" /> # <see cref="P:System.Net.EndpointPermission.Transport" />.</para>
@@ -142,6 +141,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Net.EndpointPermission" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Net.EndpointPermission" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Transport">
diff --git a/mcs/class/System/Documentation/en/System.Net/FileWebRequest.xml b/mcs/class/System/Documentation/en/System.Net/FileWebRequest.xml
index fbcc8f26da8..959ed9564d0 100644
--- a/mcs/class/System/Documentation/en/System.Net/FileWebRequest.xml
+++ b/mcs/class/System/Documentation/en/System.Net/FileWebRequest.xml
@@ -114,7 +114,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IAsyncResult'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.FileWebRequest.BeginGetRequestStream(System.AsyncCallback,System.Object)" /> method starts an asynchronous request for a stream used to send data to a file system resource. The callback method that implements the <see cref="T:System.AsyncCallback" /> delegate uses the <see cref="M:System.Net.FileWebRequest.EndGetRequestStream(System.IAsyncResult)" /> method to return the request stream.</para>
@@ -123,6 +122,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous request for a <see cref="T:System.IO.Stream" /> object to use to write data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that references the asynchronous request.</para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.AsyncCallback" /> delegate. </param>
         <param name="state">
@@ -146,7 +149,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IAsyncResult'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The asynchronous callback method that implements the <see cref="T:System.AsyncCallback" /> delegate uses the <see cref="M:System.Net.FileWebRequest.EndGetResponse(System.IAsyncResult)" /> method to return the actual <see cref="T:System.Net.FileWebResponse" />.</para>
@@ -155,6 +157,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous request for a file system resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that references the asynchronous request.</para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.AsyncCallback" /> delegate. </param>
         <param name="state">
@@ -278,7 +284,6 @@
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IO.Stream'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.FileWebRequest.EndGetRequestStream(System.IAsyncResult)" /> method completes an asynchronous stream request that was started by the <see cref="M:System.Net.FileWebRequest.BeginGetRequestStream(System.AsyncCallback,System.Object)" /> method.</para>
@@ -290,6 +295,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ends an asynchronous request for a <see cref="T:System.IO.Stream" /> instance that the application uses to write data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> object that the application uses to write data.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IAsyncResult" /> that references the pending request for a stream. </param>
       </Docs>
@@ -310,7 +319,6 @@
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'WebResponse'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.FileWebRequest.EndGetResponse(System.IAsyncResult)" /> method completes an asynchronous request for a file system resource that was started with the <see cref="M:System.Net.FileWebRequest.BeginGetResponse(System.AsyncCallback,System.Object)" /> method.</para>
@@ -319,6 +327,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ends an asynchronous request for a file system resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.WebResponse" /> that contains the response from the file system resource.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IAsyncResult" /> that references the pending request for a response. </param>
       </Docs>
@@ -367,7 +379,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IO.Stream'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.FileWebRequest.GetRequestStream" /> method provides synchronous access to the <see cref="T:System.IO.Stream" />. For asynchronous access, use the <see cref="M:System.Net.FileWebRequest.BeginGetRequestStream(System.AsyncCallback,System.Object)" /> and <see cref="M:System.Net.FileWebRequest.EndGetRequestStream(System.IAsyncResult)" /> methods.</para>
@@ -376,6 +387,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.IO.Stream" /> object for writing data to the file system resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> for writing data to the file system resource.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetResponse">
@@ -392,7 +407,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'WebResponse'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.FileWebRequest.GetResponse" /> method returns a <see cref="T:System.Net.WebResponse" /> object that contains the response from the file system resource.</para>
@@ -402,6 +416,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a response to a file system request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.WebResponse" /> that contains the response from the file system resource.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Headers">
diff --git a/mcs/class/System/Documentation/en/System.Net/FileWebResponse.xml b/mcs/class/System/Documentation/en/System.Net/FileWebResponse.xml
index 5f0ee61e6ab..e0cf432610e 100644
--- a/mcs/class/System/Documentation/en/System.Net/FileWebResponse.xml
+++ b/mcs/class/System/Documentation/en/System.Net/FileWebResponse.xml
@@ -235,7 +235,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IO.Stream'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.FileWebResponse.GetResponseStream" /> method returns the data stream from the file system resource.</para>
@@ -247,6 +246,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the data stream from the file system resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> for reading data from the file system resource.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Headers">
diff --git a/mcs/class/System/Documentation/en/System.Net/FtpWebRequest.xml b/mcs/class/System/Documentation/en/System.Net/FtpWebRequest.xml
index edf20d40bff..7ba79e25f9e 100644
--- a/mcs/class/System/Documentation/en/System.Net/FtpWebRequest.xml
+++ b/mcs/class/System/Documentation/en/System.Net/FtpWebRequest.xml
@@ -81,7 +81,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -96,6 +95,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins asynchronously opening a request's content stream for writing.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> instance that indicates the status of the operation.</para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.AsyncCallback" /> delegate that references the method to invoke when the operation is complete. </param>
         <param name="state">
@@ -118,7 +121,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -136,6 +138,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins sending a request and receiving a response from an FTP server asynchronously.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> instance that indicates the status of the operation.</para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.AsyncCallback" /> delegate that references the method to invoke when the operation is complete. </param>
         <param name="state">
@@ -461,7 +467,6 @@
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -475,6 +480,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ends a pending asynchronous operation started with <see cref="M:System.Net.FtpWebRequest.BeginGetRequestStream(System.AsyncCallback,System.Object)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A writable <see cref="T:System.IO.Stream" /> instance associated with this instance.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IAsyncResult" /> object that was returned when the operation started. </param>
       </Docs>
@@ -494,7 +503,6 @@
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -508,6 +516,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ends a pending asynchronous operation started with <see cref="M:System.Net.FtpWebRequest.BeginGetResponse(System.AsyncCallback,System.Object)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.WebResponse" /> reference that contains an <see cref="T:System.Net.FtpWebResponse" /> instance. This object contains the FTP server's response to the request.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IAsyncResult" /> that was returned when the operation started. </param>
       </Docs>
@@ -525,7 +537,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -541,6 +552,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the stream used to upload data to an FTP server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A writable <see cref="T:System.IO.Stream" /> instance used to store data to be sent to the server by the current request.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetResponse">
@@ -556,7 +571,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -574,6 +588,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the FTP server response.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.WebResponse" /> reference that contains an <see cref="T:System.Net.FtpWebResponse" /> instance. This object contains the FTP server's response to the request.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Headers">
diff --git a/mcs/class/System/Documentation/en/System.Net/FtpWebResponse.xml b/mcs/class/System/Documentation/en/System.Net/FtpWebResponse.xml
index 60755cbb076..185fa924b96 100644
--- a/mcs/class/System/Documentation/en/System.Net/FtpWebResponse.xml
+++ b/mcs/class/System/Documentation/en/System.Net/FtpWebResponse.xml
@@ -135,7 +135,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -146,6 +145,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the stream that contains response data sent from an FTP server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A readable <see cref="T:System.IO.Stream" /> instance that contains data returned with the response; otherwise, <see cref="F:System.IO.Stream.Null" /> if no response data was returned by the server.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Headers">
diff --git a/mcs/class/System/Documentation/en/System.Net/GlobalProxySelection.xml b/mcs/class/System/Documentation/en/System.Net/GlobalProxySelection.xml
index a997243e56a..9251951c8ff 100644
--- a/mcs/class/System/Documentation/en/System.Net/GlobalProxySelection.xml
+++ b/mcs/class/System/Documentation/en/System.Net/GlobalProxySelection.xml
@@ -71,9 +71,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Net.IWebProxy" /> that contains no information.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.GlobalProxySelection.GetEmptyWebProxy" /> method returns a blank <see cref="T:System.Net.IWebProxy" /> instance to indicate that no proxy is used to access an Internet resource.</para>
@@ -82,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an empty proxy instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.IWebProxy" /> that contains no information.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/System/Documentation/en/System.Net/HttpListener.xml b/mcs/class/System/Documentation/en/System.Net/HttpListener.xml
index a558df4b38e..a6473b233f0 100644
--- a/mcs/class/System/Documentation/en/System.Net/HttpListener.xml
+++ b/mcs/class/System/Documentation/en/System.Net/HttpListener.xml
@@ -169,7 +169,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -182,6 +181,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins asynchronously retrieving an incoming request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object that indicates the status of the asynchronous operation.</para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.AsyncCallback" /> delegate that references the method to invoke when a client request is available.</param>
         <param name="state">
@@ -228,7 +231,6 @@
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -240,6 +242,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Completes an asynchronous operation to retrieve an incoming client request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.HttpListenerContext" /> object that represents the client request.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IAsyncResult" /> object that was obtained when the asynchronous operation was started.</param>
       </Docs>
@@ -257,7 +263,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -268,6 +273,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits for an incoming request and returns when one is received.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.HttpListenerContext" /> object that represents a client request.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetContextAsync">
@@ -282,7 +291,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete when the incoming request has been received.</para>
@@ -292,6 +300,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits for an incoming request as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns an <see cref="T:System.Net.HttpListenerContext" /> object that represents a client request.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IgnoreWriteExceptions">
diff --git a/mcs/class/System/Documentation/en/System.Net/HttpListenerPrefixCollection.xml b/mcs/class/System/Documentation/en/System.Net/HttpListenerPrefixCollection.xml
index 6bb4ac702ae..4f101b240af 100644
--- a/mcs/class/System/Documentation/en/System.Net/HttpListenerPrefixCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Net/HttpListenerPrefixCollection.xml
@@ -99,7 +99,6 @@
         <Parameter Name="uriPrefix" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -109,6 +108,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Boolean" /> value that indicates whether the specified prefix is contained in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this collection contains the prefix specified by <paramref name="uriPrefix" />; otherwise, false.</para>
+        </returns>
         <param name="uriPrefix">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that contains the Uniform Resource Identifier (URI) prefix to test.</param>
       </Docs>
@@ -209,7 +212,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -221,6 +223,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that can be used to iterate through the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that implements the <see cref="T:System.Collections.IEnumerator" /> interface and provides access to the strings in this collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsReadOnly">
@@ -283,7 +289,6 @@
         <Parameter Name="uriPrefix" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -293,6 +298,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the specified Uniform Resource Identifier (URI) from the list of prefixes handled by the <see cref="T:System.Net.HttpListener" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="uriPrefix" /> was found in the <see cref="T:System.Net.HttpListenerPrefixCollection" /> and removed; otherwise false.</para>
+        </returns>
         <param name="uriPrefix">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> that contains the URI prefix to remove.</param>
       </Docs>
@@ -310,7 +319,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The object that is returned by this method is initially positioned before the first element in this collection. You must call the <see cref="M:System.Collections.IEnumerator.MoveNext" /> method before you can access the first element. To access the element at the current position, call the <see cref="P:System.Collections.IEnumerator.Current" /> property.</para>
@@ -321,6 +329,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that can be used to iterate through the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that implements the <see cref="T:System.Collections.IEnumerator" /> interface and provides access to the strings in this collection.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.Net/HttpListenerRequest.xml b/mcs/class/System/Documentation/en/System.Net/HttpListenerRequest.xml
index 62cb9dfcad1..7e591f38aea 100644
--- a/mcs/class/System/Documentation/en/System.Net/HttpListenerRequest.xml
+++ b/mcs/class/System/Documentation/en/System.Net/HttpListenerRequest.xml
@@ -66,13 +66,16 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous request for the client's X.509 v.3 certificate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that indicates the status of the operation.</para>
+        </returns>
         <param name="requestCallback">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.AsyncCallback" /> delegate that references the method to invoke when the operation is complete.</param>
         <param name="state">
@@ -217,13 +220,16 @@
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ends an asynchronous request for the client's X.509 v.3 certificate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IAsyncResult" /> object that is returned when the operation started.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />The pending request for the certificate.</param>
       </Docs>
@@ -241,7 +247,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -251,6 +256,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the client's X.509 v.3 certificate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="N:System.Security.Cryptography.X509Certificates" /> object that contains the client's X.509 v.3 certificate.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetClientCertificateAsync">
@@ -265,7 +274,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete when the certificate has been retrieved.</para>
@@ -275,6 +283,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the client's X.509 v.3 certificate as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="N:System.Security.Cryptography.X509Certificates" /> object that contains the client's X.509 v.3 certificate.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HasEntityBody">
diff --git a/mcs/class/System/Documentation/en/System.Net/HttpWebRequest.xml b/mcs/class/System/Documentation/en/System.Net/HttpWebRequest.xml
index 1b54aea623f..300c67d4e5b 100644
--- a/mcs/class/System/Documentation/en/System.Net/HttpWebRequest.xml
+++ b/mcs/class/System/Documentation/en/System.Net/HttpWebRequest.xml
@@ -790,9 +790,6 @@ instance. </para>
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.IAsyncResult" /> that contains information about the asynchronous operation.</para>
-        </returns>
         <exception cref="T:System.InvalidOperationException">
           <para>The stream is being used by a previous call to <see cref="M:System.Net.HttpWebRequest.BeginGetRequestStream(System.AsyncCallback,System.Object)" /> .</para>
           <para>-or-</para>
@@ -825,6 +822,10 @@ instance. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous request for a <see cref="T:System.IO.Stream" /> object to use to write data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that references the asynchronous request.</para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.AsyncCallback" /> delegate. </param>
         <param name="state">
@@ -850,10 +851,6 @@ instance. </para>
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.IAsyncResult" /> that contains information about the asynchronous
-   operation.</para>
-        </returns>
         <exception cref="T:System.InvalidOperationException">
           <see cref="M:System.Net.HttpWebRequest.BeginGetResponse(System.AsyncCallback,System.Object)" /> or <see cref="M:System.Net.HttpWebRequest.GetResponse" /> was previously called on this instance.</exception>
         <exception cref="T:System.Net.ProtocolViolationException">The <see cref="P:System.Net.HttpWebRequest.ContentLength" /> property of the current instance has not been set.</exception>
@@ -877,6 +874,10 @@ instance. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous request to an Internet resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that references the asynchronous request for a response.</para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.AsyncCallback" /> delegate </param>
         <param name="state">
@@ -1323,9 +1324,6 @@ received. The default value is <see langword="null" />
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.IO.Stream" /> to write request data to.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="asyncResult " />is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -1358,6 +1356,10 @@ received. The default value is <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ends an asynchronous request for a <see cref="T:System.IO.Stream" /> object to use to write data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> to use to write request data.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />The pending request for a stream. </param>
       </Docs>
@@ -1402,10 +1404,6 @@ received. The default value is <see langword="null" />
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Net.WebResponse" /> that contains a response to the Internet request
-   referenced by <paramref name="asyncResult" /> .</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="asyncResult " />is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -1435,6 +1433,10 @@ received. The default value is <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ends an asynchronous request to an Internet resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.WebResponse" /> that contains the response from the Internet resource.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />The pending request for a response. </param>
       </Docs>
@@ -1550,10 +1552,6 @@ received. The default value is <see langword="null" />
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.IO.Stream" /> for writing
-   data to an Internet resource requested by the current instance.</para>
-        </returns>
         <exception cref="T:System.Net.ProtocolViolationException">
           <para>The <see cref="P:System.Net.HttpWebRequest.Method" /> property of the current instance is "GET" or "HEAD". </para>
           <para> -or- </para>
@@ -1588,6 +1586,10 @@ received. The default value is <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.IO.Stream" /> object to use to write request data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> to use to write request data.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1606,10 +1608,6 @@ received. The default value is <see langword="null" />
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Net.WebResponse" /> containing the response from the Internet resource requested by the current
-   instance.</para>
-        </returns>
         <exception cref="T:System.Net.ProtocolViolationException">The <see cref="P:System.Net.HttpWebRequest.ContentLength" /> property of the current instance is not set. </exception>
         <exception cref="T:System.Net.WebException">
           <para>
@@ -1647,6 +1645,10 @@ received. The default value is <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a response from an Internet resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.WebResponse" /> that contains the response from the Internet resource.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/System/Documentation/en/System.Net/HttpWebResponse.xml b/mcs/class/System/Documentation/en/System.Net/HttpWebResponse.xml
index 14458750adb..2d58fa1c05c 100644
--- a/mcs/class/System/Documentation/en/System.Net/HttpWebResponse.xml
+++ b/mcs/class/System/Documentation/en/System.Net/HttpWebResponse.xml
@@ -353,10 +353,6 @@ value does not include header information.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" />
-containing the hash code for the current instance.</para>
-        </returns>
         <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -366,6 +362,10 @@ containing the hash code for the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash value for a <see cref="T:System.Net.HttpWebResponse" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer hash value.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
       <AssemblyInfo>
@@ -419,10 +419,6 @@ containing the hash code for the current instance.</para>
         <Parameter Name="headerName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.String" /> containing the value of the specified header.
-   </para>
-        </returns>
         <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -432,6 +428,10 @@ containing the hash code for the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the contents of a header that was returned with the response.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The contents of the specified header.</para>
+        </returns>
         <param name="headerName">
           <attribution license="cc4" from="Microsoft" modified="false" />The header value to return. </param>
       </Docs>
@@ -452,9 +452,6 @@ containing the hash code for the current instance.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.IO.Stream" /> containing the body of the response.</para>
-        </returns>
         <exception cref="T:System.ObjectDisposedException">The current instance has been disposed.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -470,6 +467,10 @@ containing the hash code for the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the stream that is used to read the body of the response from the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> containing the body of the response.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/System/Documentation/en/System.Net/IAuthenticationModule.xml b/mcs/class/System/Documentation/en/System.Net/IAuthenticationModule.xml
index 6ee9a640bb0..b6662b66a92 100644
--- a/mcs/class/System/Documentation/en/System.Net/IAuthenticationModule.xml
+++ b/mcs/class/System/Documentation/en/System.Net/IAuthenticationModule.xml
@@ -45,10 +45,6 @@
         <Parameter Name="credentials" Type="System.Net.ICredentials" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Net.Authorization" /> instance containing the
-   challenge response, or <see langword="null " />if the challenge cannot be handled.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.IAuthenticationModule.Authenticate(System.String,System.Net.WebRequest,System.Net.ICredentials)" /> method conducts the authentication process with the server and returns an <see cref="T:System.Net.Authorization" /> instance to the <see cref="T:System.Net.AuthenticationManager" />.</para>
@@ -57,6 +53,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an instance of the <see cref="T:System.Net.Authorization" /> class in respose to an authentication challenge from a server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.Authorization" /> instance containing the authorization message for the request, or null if the challenge cannot be handled.</para>
+        </returns>
         <param name="challenge">
           <attribution license="cc4" from="Microsoft" modified="false" />The authentication challenge sent by the server. </param>
         <param name="request">
@@ -145,10 +145,6 @@
         <Parameter Name="credentials" Type="System.Net.ICredentials" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Net.Authorization" /> instance containing client authentication
-   information to be sent with <paramref name="request" />, or <see langword="null " />if the current instance does not support preauthentication.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When the <see cref="P:System.Net.IAuthenticationModule.CanPreAuthenticate" /> property is true, the <see cref="M:System.Net.IAuthenticationModule.PreAuthenticate(System.Net.WebRequest,System.Net.ICredentials)" /> method will return an instance of the <see cref="T:System.Net.Authorization" /> class containing an authentication message.</para>
@@ -157,6 +153,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an instance of the <see cref="T:System.Net.Authorization" /> class for an authentication request to a server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.Authorization" /> instance containing the authorization message for the request.</para>
+        </returns>
         <param name="request">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.WebRequest" /> instance associated with the authentication request. </param>
         <param name="credentials">
diff --git a/mcs/class/System/Documentation/en/System.Net/ICertificatePolicy.xml b/mcs/class/System/Documentation/en/System.Net/ICertificatePolicy.xml
index 6fa46caf769..4befd32730f 100644
--- a/mcs/class/System/Documentation/en/System.Net/ICertificatePolicy.xml
+++ b/mcs/class/System/Documentation/en/System.Net/ICertificatePolicy.xml
@@ -44,7 +44,6 @@
         <Parameter Name="certificateProblem" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.ICertificatePolicy.CheckValidationResult(System.Net.ServicePoint,System.Security.Cryptography.X509Certificates.X509Certificate,System.Net.WebRequest,System.Int32)" /> method implements the application certificate validation policy. The method can examine the <paramref name="srvPoint" />, <paramref name="certificate" />, <paramref name="request" />, and <paramref name="certificateProblem" /> parameters to determine whether the certificate should be honored.</para>
@@ -54,6 +53,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Validates a server certificate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the certificate should be honored; otherwise, false.</para>
+        </returns>
         <param name="srvPoint">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.ServicePoint" /> that will use the certificate. </param>
         <param name="certificate">
diff --git a/mcs/class/System/Documentation/en/System.Net/ICredentialPolicy.xml b/mcs/class/System/Documentation/en/System.Net/ICredentialPolicy.xml
index 84668937318..b7d27b5b9fe 100644
--- a/mcs/class/System/Documentation/en/System.Net/ICredentialPolicy.xml
+++ b/mcs/class/System/Documentation/en/System.Net/ICredentialPolicy.xml
@@ -44,7 +44,6 @@
         <Parameter Name="authenticationModule" Type="System.Net.IAuthenticationModule" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -55,6 +54,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Boolean" /> that indicates whether the client's credentials are sent with a resource request made using an instance of the <see cref="T:System.Net.WebRequest" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the credentials are sent with the request; otherwise, false.</para>
+        </returns>
         <param name="challengeUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Uri" /> that will receive the request. For more information, see the Remarks section.</param>
         <param name="request">
diff --git a/mcs/class/System/Documentation/en/System.Net/ICredentials.xml b/mcs/class/System/Documentation/en/System.Net/ICredentials.xml
index 4cdcd614412..ee0788da975 100644
--- a/mcs/class/System/Documentation/en/System.Net/ICredentials.xml
+++ b/mcs/class/System/Documentation/en/System.Net/ICredentials.xml
@@ -42,10 +42,6 @@
         <Parameter Name="authType" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Net.NetworkCredential" /> associated with the specified URI and authentication
-   type, or <see langword="null" /> if the credentials cannot be provided.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.ICredentials.GetCredential(System.Uri,System.String)" /> method returns a <see cref="T:System.Net.NetworkCredential" /> instance that contains the credentials that are associated with the specified URI and authorization scheme. When no credentials are available, the <see cref="M:System.Net.ICredentials.GetCredential(System.Uri,System.String)" /> method returns null.</para>
@@ -54,6 +50,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Net.NetworkCredential" /> object that is associated with the specified URI, and authentication type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Net.NetworkCredential" /> that is associated with the specified URI and authentication type, or, if no credentials are available, null.</para>
+        </returns>
         <param name="uri">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Uri" /> that the client is providing authentication for. </param>
         <param name="authType">
diff --git a/mcs/class/System/Documentation/en/System.Net/ICredentialsByHost.xml b/mcs/class/System/Documentation/en/System.Net/ICredentialsByHost.xml
index 35a2935e875..e215fe5c2f1 100644
--- a/mcs/class/System/Documentation/en/System.Net/ICredentialsByHost.xml
+++ b/mcs/class/System/Documentation/en/System.Net/ICredentialsByHost.xml
@@ -37,7 +37,6 @@
         <Parameter Name="authenticationType" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -47,6 +46,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the credential for the specified host, port, and authentication protocol.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.NetworkCredential" /> for the specified host, port, and authentication protocol, or null if there are no credentials available for the specified host, port, and authentication protocol.</para>
+        </returns>
         <param name="host">
           <attribution license="cc4" from="Microsoft" modified="false" />The host computer that is authenticating the client.</param>
         <param name="port">
diff --git a/mcs/class/System/Documentation/en/System.Net/IPAddress.xml b/mcs/class/System/Documentation/en/System.Net/IPAddress.xml
index 939de03545f..147902b5ba3 100644
--- a/mcs/class/System/Documentation/en/System.Net/IPAddress.xml
+++ b/mcs/class/System/Documentation/en/System.Net/IPAddress.xml
@@ -252,12 +252,6 @@
         <Parameter Name="comparand" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" /> where <see langword="true" /> indicates <paramref name="comparand" /> is an instance of the <see cref="T:System.Net.IPAddress" /> class
-   and has the same <see cref="P:System.Net.IPAddress.Address" /> property value
-   as the current instance; otherwise
-<see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.IPAddress.Equals(System.Object)" /> method compares the current <see cref="T:System.Net.IPAddress" /> instance with the <paramref name="comparand" /> parameter and returns true if the two instances contain the same IP address.</para>
@@ -266,6 +260,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two IP addresses.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two addresses are equal; otherwise, false.</para>
+        </returns>
         <param name="comparand">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Net.IPAddress" /> instance to compare to the current instance. </param>
       </Docs>
@@ -285,12 +283,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides a copy of the <see cref="T:System.Net.IPAddress" /> as an array of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Byte" /> array.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -308,10 +309,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" />
-containing the hash code for the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.IPAddress.GetHashCode" /> method returns a hash code of the IP address. This value can be used as a key in hash tables.</para>
@@ -320,6 +317,10 @@ containing the hash code for the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash value for an IP address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer hash value.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -340,10 +341,6 @@ containing the hash code for the current instance.</para>
         <Parameter Name="host" Type="System.Int16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int16" />
-in network-byte-order.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Different computers use different conventions for ordering the bytes within multibyte integer values. Some computers put the most significant byte first (known as big-endian order) and others put the least-significant byte first (known as little-endian order). To work with computers that use different byte ordering, all integer values that are sent over the network are sent in network byte order which has the most significant byte first.</para>
@@ -353,6 +350,10 @@ in network-byte-order.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a short value from host byte order to network byte order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A short value, expressed in network byte order.</para>
+        </returns>
         <param name="host">
           <attribution license="cc4" from="Microsoft" modified="false" />The number to convert, expressed in host byte order. </param>
       </Docs>
@@ -375,10 +376,6 @@ in network-byte-order.</para>
         <Parameter Name="host" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" />
-in network-byte-order.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Different computers use different conventions for ordering the bytes within multibyte integer values. Some computers put the most significant byte first (known as big-endian order) and others put the least-significant byte first (known as little-endian order). To work with computers that use different byte ordering, all integer values that are sent over the network are sent in network byte order which has the most significant byte first.</para>
@@ -388,6 +385,10 @@ in network-byte-order.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an integer value from host byte order to network byte order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer value, expressed in network byte order.</para>
+        </returns>
         <param name="host">
           <attribution license="cc4" from="Microsoft" modified="false" />The number to convert, expressed in host byte order. </param>
       </Docs>
@@ -410,9 +411,6 @@ in network-byte-order.</para>
         <Parameter Name="host" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int64" /> in network-byte-order.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Different computers use different conventions for ordering the bytes within multibyte integer values. Some computers put the most significant byte first (known as big-endian order) and others put the least-significant byte first (known as little-endian order). To work with computers that use different byte ordering, all integer values that are sent over the network are sent in network byte order which has the most significant byte first.</para>
@@ -422,6 +420,10 @@ in network-byte-order.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a long value from host byte order to network byte order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A long value, expressed in network byte order.</para>
+        </returns>
         <param name="host">
           <attribution license="cc4" from="Microsoft" modified="false" />The number to convert, expressed in host byte order. </param>
       </Docs>
@@ -595,12 +597,6 @@ in network-byte-order.</para>
         <Parameter Name="address" Type="System.Net.IPAddress" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true " />if
-<paramref name="address " /> is a loopback address; otherwise
-<see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.IPAddress.IsLoopback(System.Net.IPAddress)" /> method compares <paramref name="address" /> to <see cref="F:System.Net.IPAddress.Loopback" /> and returns true if the two IP addresses are the same.</para>
@@ -610,6 +606,10 @@ in network-byte-order.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified IP address is the loopback address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="address" /> is the loopback address; otherwise, false.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />An IP address. </param>
       </Docs>
@@ -658,10 +658,6 @@ in network-byte-order.</para>
         <Parameter Name="network" Type="System.Int16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int16" />
-in host-byte-order.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Different computers use different conventions for ordering the bytes within multibyte integer values. Some computers put the most significant byte first (known as big-endian order) and others put the least-significant byte first (known as little-endian order). To work with computers that use different byte ordering, all integer values that are sent over the network are sent in network byte order which has the most significant byte first.</para>
@@ -671,6 +667,10 @@ in host-byte-order.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a short value from network byte order to host byte order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A short value, expressed in host byte order.</para>
+        </returns>
         <param name="network">
           <attribution license="cc4" from="Microsoft" modified="false" />The number to convert, expressed in network byte order. </param>
       </Docs>
@@ -693,9 +693,6 @@ in host-byte-order.</para>
         <Parameter Name="network" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> in host-byte-order.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Different computers use different conventions for ordering the bytes within multibyte integer values. Some computers put the most significant byte first (known as big-endian order) and others put the least-significant byte first (known as little-endian order). To work with computers that use different byte ordering, all integer values that are sent over the network are sent in network byte order which has the most significant byte first.</para>
@@ -705,6 +702,10 @@ in host-byte-order.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an integer value from network byte order to host byte order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer value, expressed in host byte order.</para>
+        </returns>
         <param name="network">
           <attribution license="cc4" from="Microsoft" modified="false" />The number to convert, expressed in network byte order. </param>
       </Docs>
@@ -727,9 +728,6 @@ in host-byte-order.</para>
         <Parameter Name="network" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int64" /> in host-byte-order.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Different computers use different conventions for ordering the bytes within multibyte integer values. Some computers put the most significant byte first (known as big-endian order) and others put the least-significant byte first (known as little-endian order). To work with computers that use different byte ordering, all integer values that are sent over the network are sent in network byte order which has the most significant byte first.</para>
@@ -739,6 +737,10 @@ in host-byte-order.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a long value from network byte order to host byte order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A long value, expressed in host byte order.</para>
+        </returns>
         <param name="network">
           <attribution license="cc4" from="Microsoft" modified="false" />The number to convert, expressed in network byte order. </param>
       </Docs>
@@ -787,9 +789,6 @@ in host-byte-order.</para>
         <Parameter Name="ipString" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Net.IPAddress" /> instance that represents the address specified in <paramref name="ipString" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="ipString " />is <see langword="null" />.</exception>
         <exception cref="T:System.FormatException">
@@ -848,6 +847,10 @@ in host-byte-order.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an IP address string to an <see cref="T:System.Net.IPAddress" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.IPAddress" /> instance.</para>
+        </returns>
         <param name="ipString">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains an IP address in dotted-quad notation for IPv4 and in colon-hexadecimal notation for IPv6. </param>
       </Docs>
@@ -909,10 +912,6 @@ in host-byte-order.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of 
-   the current instance. The returned string is an IP address expressed in dotted-quad notation (for example, "192.168.1.2").</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.IPAddress.ToString" /> method converts the IP address that is stored in the <see cref="P:System.Net.IPAddress.Address" /> property to either IPv4 dotted-quad or IPv6 colon-hexadecimal notation.</para>
@@ -921,6 +920,10 @@ in host-byte-order.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an Internet address to its standard notation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the IP address in either IPv4 dotted-quad or in IPv6 colon-hexadecimal notation.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/System/Documentation/en/System.Net/IPEndPoint.xml b/mcs/class/System/Documentation/en/System.Net/IPEndPoint.xml
index 0c404e0509e..5ba57826959 100644
--- a/mcs/class/System/Documentation/en/System.Net/IPEndPoint.xml
+++ b/mcs/class/System/Documentation/en/System.Net/IPEndPoint.xml
@@ -167,10 +167,6 @@
         <Parameter Name="socketAddress" Type="System.Net.SocketAddress" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Net.IPEndPoint" /> instance containing the address
-   information from the specified <see cref="T:System.Net.SocketAddress" /> instance.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note">This method
@@ -182,6 +178,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an endpoint from a socket address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.EndPoint" /> instance using the specified socket address.</para>
+        </returns>
         <param name="socketAddress">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.SocketAddress" /> to use for the endpoint. </param>
       </Docs>
@@ -243,9 +243,6 @@ and <see cref="P:System.Net.IPEndPoint.Port" /> properties contain the same valu
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the hash code for the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.IPEndPoint.GetHashCode" /> method returns a hash code of the IP endpoint instance. This value can be used as a key in hash tables.</para>
@@ -254,6 +251,10 @@ and <see cref="P:System.Net.IPEndPoint.Port" /> properties contain the same valu
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash value for a <see cref="T:System.Net.IPEndPoint" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer hash value.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -351,12 +352,15 @@ inclusive.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serializes endpoint information into a <see cref="T:System.Net.SocketAddress" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.SocketAddress" /> instance containing the socket address for the endpoint.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -374,11 +378,6 @@ inclusive.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" />
-containing the IP address, in dotted-quad notation, followed by a colon and the port number for the
-specified endpoint, for example, 127.0.0.1:80.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note">This method overrides <see cref="M:System.Object.ToString" />.</block>
@@ -388,6 +387,10 @@ specified endpoint, for example, 127.0.0.1:80.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the IP address and port number of the specified endpoint.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the IP address and the port number of the specified endpoint (for example, 192.168.1.2:80).</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/System/Documentation/en/System.Net/IWebProxy.xml b/mcs/class/System/Documentation/en/System.Net/IWebProxy.xml
index 9bb61b633bd..41af23fa7b4 100644
--- a/mcs/class/System/Documentation/en/System.Net/IWebProxy.xml
+++ b/mcs/class/System/Documentation/en/System.Net/IWebProxy.xml
@@ -71,11 +71,6 @@
         <Parameter Name="destination" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Uri" /> instance
-   containing the URI of the proxy used to contact
-<paramref name="destination" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.IWebProxy.GetProxy(System.Uri)" /> method returns the URI of the proxy server that handles requests to the Internet resource that is specified in the <paramref name="destination" /> parameter.</para>
@@ -84,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the URI of a proxy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Uri" /> instance that contains the URI of the proxy used to contact <paramref name="destination" />.</para>
+        </returns>
         <param name="destination">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Uri" /> that specifies the requested Internet resource. </param>
       </Docs>
@@ -106,12 +105,6 @@
         <Parameter Name="host" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true " /> if
-   the proxy server is not used to access the server specified in <paramref name="host" />;
-   otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.IWebProxy.IsBypassed(System.Uri)" /> method indicates whether to use the proxy server to access the host that is specified in the <paramref name="host" /> parameter. If <see cref="M:System.Net.IWebProxy.IsBypassed(System.Uri)" /> is true, the proxy is not used to contact the host and the request is passed directly to the server.</para>
@@ -120,6 +113,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates that the proxy should not be used for the specified host.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the proxy server should not be used for <paramref name="host" />; otherwise, false.</para>
+        </returns>
         <param name="host">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Uri" /> of the host to check for proxy use. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Net/IWebProxyScript.xml b/mcs/class/System/Documentation/en/System.Net/IWebProxyScript.xml
index 61cfc884d91..653ee3c9ecf 100644
--- a/mcs/class/System/Documentation/en/System.Net/IWebProxyScript.xml
+++ b/mcs/class/System/Documentation/en/System.Net/IWebProxyScript.xml
@@ -53,12 +53,15 @@
         <Parameter Name="helperType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads a script.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Boolean" /> indicating whether the script was successfully loaded.</para>
+        </returns>
         <param name="scriptLocation">
           <attribution license="cc4" from="Microsoft" modified="false" />Internal only.</param>
         <param name="script">
@@ -83,7 +86,6 @@
         <Parameter Name="host" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When the <see cref="T:System.Net.HttpWebRequest" /> object is run, it may need to run the WPAD (Web Proxy Automatic Detection) protocol to detect whether a proxy is required for reaching the destination URL. During this process, the system downloads and compiles the PAC (Proxy Auto-Configuration) script in memory and tries to execute the FindProxyForURL function as per the PAC specification.
@@ -94,6 +96,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Runs a script.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" />.</para>
+          <para>An internal-only value returned.</para>
+        </returns>
         <param name="url">
           <attribution license="cc4" from="Microsoft" modified="false" />Internal only.</param>
         <param name="host">
diff --git a/mcs/class/System/Documentation/en/System.Net/IWebRequestCreate.xml b/mcs/class/System/Documentation/en/System.Net/IWebRequestCreate.xml
index afc2152f6e9..f0779718982 100644
--- a/mcs/class/System/Documentation/en/System.Net/IWebRequestCreate.xml
+++ b/mcs/class/System/Documentation/en/System.Net/IWebRequestCreate.xml
@@ -42,10 +42,6 @@
         <Parameter Name="uri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Net.WebRequest" />
-instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.IWebRequestCreate.Create(System.Uri)" /> method must return an initialized instance of the <see cref="T:System.Net.WebRequest" /> descendant that is capable of performing a standard request/response transaction for the protocol without needing any protocol-specific fields modified.</para>
@@ -54,6 +50,10 @@ instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Net.WebRequest" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.WebRequest" /> instance.</para>
+        </returns>
         <param name="uri">
           <attribution license="cc4" from="Microsoft" modified="false" />The uniform resource identifier (URI) of the Web resource. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Net/NetworkCredential.xml b/mcs/class/System/Documentation/en/System.Net/NetworkCredential.xml
index 86fd6d85269..a4b9e0c2b2a 100644
--- a/mcs/class/System/Documentation/en/System.Net/NetworkCredential.xml
+++ b/mcs/class/System/Documentation/en/System.Net/NetworkCredential.xml
@@ -233,14 +233,15 @@
         <Parameter Name="authType" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current <see cref="T:System.Net.NetworkCredential" /> instance.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an instance of the <see cref="T:System.Net.NetworkCredential" /> class for the specified Uniform Resource Identifier (URI) and authentication type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.NetworkCredential" /> object.</para>
+        </returns>
         <param name="uri">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI that the client provides authentication for. </param>
         <param name="authType">
@@ -265,7 +266,6 @@
         <Parameter Name="authenticationType" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The value of <paramref name="authType" /> corresponds to the <see cref="P:System.Net.IAuthenticationModule.AuthenticationType" /> property.</para>
@@ -274,6 +274,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an instance of the <see cref="T:System.Net.NetworkCredential" /> class for the specified host, port, and authentication type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.NetworkCredential" /> for the specified host, port, and authentication protocol, or null if there are no credentials available for the specified host, port, and authentication protocol.</para>
+        </returns>
         <param name="host">
           <attribution license="cc4" from="Microsoft" modified="false" />The host computer that authenticates the client.</param>
         <param name="port">
diff --git a/mcs/class/System/Documentation/en/System.Net/ServicePoint.xml b/mcs/class/System/Documentation/en/System.Net/ServicePoint.xml
index fcf0cac58eb..f7bc00fb9a9 100644
--- a/mcs/class/System/Documentation/en/System.Net/ServicePoint.xml
+++ b/mcs/class/System/Documentation/en/System.Net/ServicePoint.xml
@@ -152,7 +152,6 @@
         <Parameter Name="connectionGroupName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Connection groups associate a set of requests with a particular connection or set of connections. This method removes and closes all connections that belong to the specified connection group.</para>
@@ -161,6 +160,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the specified connection group from this <see cref="T:System.Net.ServicePoint" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Boolean" /> value that indicates whether the connection group was closed.</para>
+        </returns>
         <param name="connectionGroupName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the connection group that contains the connections to close and remove from this service point. </param>
       </Docs>
@@ -327,9 +330,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the hash code for this instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.ServicePoint.GetHashCode" /> method returns a hash code of this instance. This value can be used as a key in hash tables.</para>
@@ -338,6 +338,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash value for a <see cref="T:System.Net.ServicePoint" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer hash value.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
       <AssemblyInfo>
diff --git a/mcs/class/System/Documentation/en/System.Net/ServicePointManager.xml b/mcs/class/System/Documentation/en/System.Net/ServicePointManager.xml
index 4749a233d97..82fe8fbeae5 100644
--- a/mcs/class/System/Documentation/en/System.Net/ServicePointManager.xml
+++ b/mcs/class/System/Documentation/en/System.Net/ServicePointManager.xml
@@ -325,11 +325,6 @@ ServicePointManager.ClientCipherSuitesCallback += (SecurityProtocolType p, IEnum
         <Parameter Name="address" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Net.ServicePoint" /> that connects to the host identified in
-<paramref name="address" /> 
-.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="address " />is <see langword="null" />.</exception>
         <exception cref="T:System.InvalidOperationException">The maximum number of service points defined in <see cref="P:System.Net.ServicePointManager.MaxServicePoints" /> has been reached and there is no service point that connects to the specified host.</exception>
@@ -341,6 +336,10 @@ ServicePointManager.ClientCipherSuitesCallback += (SecurityProtocolType p, IEnum
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds an existing <see cref="T:System.Net.ServicePoint" /> object or creates a new <see cref="T:System.Net.ServicePoint" /> object to manage communications with the specified <see cref="T:System.Uri" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Net.ServicePoint" /> object that manages communications for the request.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Uri" /> object of the Internet resource to contact. </param>
       </Docs>
@@ -364,11 +363,6 @@ ServicePointManager.ClientCipherSuitesCallback += (SecurityProtocolType p, IEnum
         <Parameter Name="proxy" Type="System.Net.IWebProxy" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Net.ServicePoint" /> that connects to the host identified in
-<paramref name="uriString" /> 
-.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="uriString" /> is <see langword="null" />.</exception>
         <exception cref="T:System.UriFormatException">The URI specified in <paramref name="uriString" /> is in an invalid form.</exception>
@@ -381,6 +375,10 @@ ServicePointManager.ClientCipherSuitesCallback += (SecurityProtocolType p, IEnum
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds an existing <see cref="T:System.Net.ServicePoint" /> object or creates a new <see cref="T:System.Net.ServicePoint" /> object to manage communications with the specified Uniform Resource Identifier (URI).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Net.ServicePoint" /> object that manages communications for the request.</para>
+        </returns>
         <param name="uriString">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the Internet resource to be contacted. </param>
         <param name="proxy">
@@ -406,11 +404,6 @@ ServicePointManager.ClientCipherSuitesCallback += (SecurityProtocolType p, IEnum
         <Parameter Name="proxy" Type="System.Net.IWebProxy" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Net.ServicePoint" /> that connects to the host identified in
-<paramref name="address" /> 
-.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="address " />is <see langword="null" />.</exception>
         <exception cref="T:System.InvalidOperationException">The maximum number of service points defined in <see cref="P:System.Net.ServicePointManager.MaxServicePoints" /> has been reached and there is no service point that connects to the specified host.</exception>
@@ -422,6 +415,10 @@ ServicePointManager.ClientCipherSuitesCallback += (SecurityProtocolType p, IEnum
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds an existing <see cref="T:System.Net.ServicePoint" /> object or creates a new <see cref="T:System.Net.ServicePoint" /> object to manage communications with the specified <see cref="T:System.Uri" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Net.ServicePoint" /> object that manages communications for the request.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Uri" /> object that contains the address of the Internet resource to contact. </param>
         <param name="proxy">
diff --git a/mcs/class/System/Documentation/en/System.Net/SocketAddress.xml b/mcs/class/System/Documentation/en/System.Net/SocketAddress.xml
index 4d49b221eef..e881c0b8c76 100644
--- a/mcs/class/System/Documentation/en/System.Net/SocketAddress.xml
+++ b/mcs/class/System/Documentation/en/System.Net/SocketAddress.xml
@@ -269,10 +269,6 @@ instance; otherwise <see langword="false" />.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" qualify="true" /> representation of the current
-   instance.</para>
-        </returns>
         <example>
           <para>The following example writes a socket address to the
       console.</para>
@@ -303,6 +299,10 @@ public class SocketAddressToString{
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns information about the socket address.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains information about the <see cref="T:System.Net.SocketAddress" />.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/System/Documentation/en/System.Net/SocketPermission.xml b/mcs/class/System/Documentation/en/System.Net/SocketPermission.xml
index f6dde80a002..eb3f40b541f 100644
--- a/mcs/class/System/Documentation/en/System.Net/SocketPermission.xml
+++ b/mcs/class/System/Documentation/en/System.Net/SocketPermission.xml
@@ -225,9 +225,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Net.SocketPermission" /> containing the same values as the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The object returned by this method represents the same level of access as the current instance. This method overrides <see cref="M:System.Security.CodeAccessPermission.Copy" /> and is implemented to support the <see cref="T:System.Security.IPermission" /> interface.</para>
@@ -236,6 +233,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of a <see cref="T:System.Net.SocketPermission" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the <see cref="T:System.Net.SocketPermission" /> class that is a copy of the current instance.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -295,14 +296,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Net.SocketPermission" /> instance that represents the intersection of the
-   current instance and <paramref name="target" />. If target is
-<see langword="null" />, returns <see langword="null" />. If the intersection is
-   empty, returns <see langword="null" />. If the
-   current instance is unrestricted, returns a copy of <paramref name="target" />. If
-<paramref name="target" /> is unrestricted, returns a copy of the current instance.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="target" /> is not of type <see cref="T:System.Net.SocketPermission" /> .</exception>
         <remarks>
@@ -313,6 +306,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the logical intersection between two <see cref="T:System.Net.SocketPermission" /> instances.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Net.SocketPermission" /> instance that represents the intersection of two <see cref="T:System.Net.SocketPermission" /> instances. If the intersection is empty, the method returns null. If the <paramref name="target" /> parameter is a null reference, the method returns null.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.SocketPermission" /> instance to intersect with the current instance. </param>
       </Docs>
@@ -335,15 +332,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the current instance is a subset of <paramref name="target" /> ;
-   otherwise,<see langword=" false" />. If the current instance is unrestricted, and
-<paramref name="target" /> is not, returns <see langword="false" />. If <paramref name="target" /> is 
-   unrestricted, returns <see langword="true" />. If <paramref name="target" /> is
-<see langword="null" /> 
-and the current instance does not secure any resources and is not unrestricted, returns <see langword="true" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>
             <paramref name="target " />is not <see langword="null" /> and is not of type <see cref="T:System.Net.SocketPermission" />.</para>
@@ -357,6 +345,10 @@ and the current instance does not secure any resources and is not unrestricted,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the current permission is a subset of the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If <paramref name="target" /> is null, this method returns true if the current instance defines no permissions; otherwise, false. If <paramref name="target" /> is not null, this method returns true if the current instance defines a subset of <paramref name="target" /> permissions; otherwise, false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Net.SocketPermission" /> that is to be tested for the subset relationship. </param>
       </Docs>
@@ -376,12 +368,15 @@ and the current instance does not secure any resources and is not unrestricted,
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks the overall permission state of the object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Net.SocketPermission" /> instance is created with the Unrestricted value from <see cref="T:System.Security.Permissions.PermissionState" />; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToXml">
@@ -399,9 +394,6 @@ and the current instance does not secure any resources and is not unrestricted,
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Security.SecurityElement" /> containing the XML encoding of the state of the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.SocketPermission.ToXml" /> method creates a <see cref="T:System.Security.SecurityElement" /> instance to encode a representation of the <see cref="T:System.Net.SocketPermission" /> instance, including state information, in XML.</para>
@@ -411,6 +403,10 @@ and the current instance does not secure any resources and is not unrestricted,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of a <see cref="T:System.Net.SocketPermission" /> instance and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.SecurityElement" /> instance that contains an XML-encoded representation of the <see cref="T:System.Net.SocketPermission" /> instance, including state information.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -431,11 +427,6 @@ and the current instance does not secure any resources and is not unrestricted,
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Net.SocketPermission" /> instance that represents the union of the current
- instance and <paramref name="target" />. If the current instance or <paramref name="target " />is
- unrestricted, returns a <see cref="T:System.Net.SocketPermission" /> instance that is unrestricted.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="target " /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -448,6 +439,10 @@ and the current instance does not secure any resources and is not unrestricted,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the logical union between two <see cref="T:System.Net.SocketPermission" /> instances.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Net.SocketPermission" /> instance that represents the union of two <see cref="T:System.Net.SocketPermission" /> instances. If <paramref name="target" /> parameter is null, it returns a copy of the current instance.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.SocketPermission" /> instance to combine with the current instance. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Net/SocketPermissionAttribute.xml b/mcs/class/System/Documentation/en/System.Net/SocketPermissionAttribute.xml
index 2aa1f85e509..7db54238836 100644
--- a/mcs/class/System/Documentation/en/System.Net/SocketPermissionAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.Net/SocketPermissionAttribute.xml
@@ -117,11 +117,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Net.SocketPermission" />
-object with the security information of the current
-instance.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">One or more of the current instance's <see cref="P:System.Net.SocketPermissionAttribute.Access" />, <see cref="P:System.Net.SocketPermissionAttribute.Host" />, <see cref="P:System.Net.SocketPermissionAttribute.Transport" /> or <see cref="P:System.Net.SocketPermissionAttribute.Port" /> properties is <see langword="null" />.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -131,6 +126,10 @@ instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new instance of the <see cref="T:System.Net.SocketPermission" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the <see cref="T:System.Net.SocketPermission" /> class that corresponds to the security declaration.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/System/Documentation/en/System.Net/TransportContext.xml b/mcs/class/System/Documentation/en/System.Net/TransportContext.xml
index 63a2bdc7266..e2555856d9b 100644
--- a/mcs/class/System/Documentation/en/System.Net/TransportContext.xml
+++ b/mcs/class/System/Documentation/en/System.Net/TransportContext.xml
@@ -55,7 +55,6 @@
         <Parameter Name="kind" Type="System.Security.Authentication.ExtendedProtection.ChannelBindingKind" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The possible values for the <paramref name="kind" /> parameter are <see cref="F:System.Security.Authentication.ExtendedProtection.ChannelBindingKind.Endpoint" /> or <see cref="F:System.Security.Authentication.ExtendedProtection.ChannelBindingKind.Unique" />. </para>
@@ -65,6 +64,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the requested channel binding. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The requested <see cref="T:System.Security.Authentication.ExtendedProtection.ChannelBinding" />, or null if the channel binding is not supported by the current transport or by the operating system.</para>
+        </returns>
         <param name="kind">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of channel binding to retrieve.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Net/WebClient.xml b/mcs/class/System/Documentation/en/System.Net/WebClient.xml
index 1a53330cee9..f29bd476cf1 100644
--- a/mcs/class/System/Documentation/en/System.Net/WebClient.xml
+++ b/mcs/class/System/Documentation/en/System.Net/WebClient.xml
@@ -404,10 +404,6 @@
         <Parameter Name="address" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Byte" /> array containing the data downloaded from the resource
-   specified by <paramref name="address" />.</para>
-        </returns>
         <exception cref="T:System.Net.WebException">
           <para>The absolute URI is not valid.</para>
           <para> -or-</para>
@@ -426,6 +422,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Downloads the resource as a <see cref="T:System.Byte" /> array from the URI specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Byte" /> array containing the downloaded resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI from which to download data. </param>
       </Docs>
@@ -446,7 +446,6 @@
         <Parameter Name="address" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.WebClient.DownloadData(System.String)" /> method downloads the resource with the URI specified by the <paramref name="address" /> parameter. This method blocks while downloading the resource. To download a resource and continue executing while waiting for the server's response, use one of the <see cref="Overload:System.Net.WebClient.DownloadDataAsync" /> methods. </para>
@@ -458,6 +457,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Downloads the resource as a <see cref="T:System.Byte" /> array from the URI specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Byte" /> array containing the downloaded resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI represented by the <see cref="T:System.Uri" />  object, from which to download data.</param>
       </Docs>
@@ -571,7 +574,6 @@
         <Parameter Name="address" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" />  object will complete after the data resource has been downloaded.</para>
@@ -587,6 +589,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Downloads the resource as a <see cref="T:System.Byte" /> array from the URI specified as an asynchronous operation using a task object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.Byte" /> array containing the downloaded resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to download. </param>
       </Docs>
@@ -613,7 +620,6 @@
         <Parameter Name="address" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" />  object will complete after the data resource has been downloaded.</para>
@@ -626,6 +632,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Downloads the resource as a <see cref="T:System.Byte" /> array from the URI specified as an asynchronous operation using a task object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.Byte" /> array containing the downloaded resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to download.</param>
       </Docs>
@@ -833,7 +844,6 @@
         <Parameter Name="fileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task" />  object will complete after the data resource has been downloaded.</para>
@@ -850,6 +860,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Downloads the specified resource to a local file as an asynchronous operation using a task object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to download.</param>
         <param name="fileName">
@@ -879,7 +894,6 @@
         <Parameter Name="fileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task" />  object will complete after the data resource has been downloaded.</para>
@@ -896,6 +910,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Downloads the specified resource to a local file as an asynchronous operation using a task object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to download.</param>
         <param name="fileName">
@@ -993,7 +1012,6 @@
         <Parameter Name="address" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method retrieves the specified resource. After it downloads the resource, the method uses the encoding specified in the <see cref="P:System.Net.WebClient.Encoding" /> property to convert the resource to a <see cref="T:System.String" />. This method blocks while downloading the resource. To download a resource and continue executing while waiting for the server's response, use one of the <see cref="Overload:System.Net.WebClient.DownloadStringAsync" /> methods. </para>
@@ -1007,6 +1025,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Downloads the requested resource as a <see cref="T:System.String" />. The resource to download is specified as a <see cref="T:System.String" /> containing the URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the requested resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" /> containing the URI to download.</param>
       </Docs>
@@ -1026,7 +1048,6 @@
         <Parameter Name="address" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method retrieves the specified resource. After it downloads the resource, the method uses the encoding specified in the <see cref="P:System.Net.WebClient.Encoding" /> property to convert the resource to a <see cref="T:System.String" />. This method blocks while downloading the resource. To download a resource and continue executing while waiting for the server's response, use one of the <see cref="Overload:System.Net.WebClient.DownloadStringAsync" /> methods. </para>
@@ -1040,6 +1061,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Downloads the requested resource as a <see cref="T:System.String" />. The resource to download is specified as a <see cref="T:System.Uri" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the requested resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Uri" /> object containing the URI to download.</param>
       </Docs>
@@ -1153,7 +1178,6 @@
         <Parameter Name="address" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the data resource has been downloaded.  The resource is downloaded asynchronously using thread resources that are automatically allocated from the thread pool.</para>
@@ -1167,6 +1191,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Downloads the resource as a <see cref="T:System.String" /> from the URI specified as an asynchronous operation using a task object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.Byte" /> array containing the downloaded resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to download.</param>
       </Docs>
@@ -1193,7 +1222,6 @@
         <Parameter Name="address" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the data resource has been downloaded. The resource is downloaded asynchronously using thread resources that are automatically allocated from the thread pool.</para>
@@ -1207,6 +1235,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Downloads the resource as a <see cref="T:System.String" /> from the URI specified as an asynchronous operation using a task object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.Byte" /> array containing the downloaded resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to download.</param>
       </Docs>
@@ -1250,7 +1283,6 @@
         <Parameter Name="address" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method copies the existing <see cref="P:System.Net.WebClient.Headers" />, <see cref="P:System.Net.WebClient.Credentials" />, and method to the newly created <see cref="T:System.Net.WebRequest" /> object.</para>
@@ -1260,6 +1292,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Net.WebRequest" /> object for the specified resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Net.WebRequest" /> object for the specified resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Uri" /> that identifies the resource to request.</param>
       </Docs>
@@ -1279,7 +1315,6 @@
         <Parameter Name="request" Type="System.Net.WebRequest" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The object returned by this method is obtained by calling the <see cref="M:System.Net.WebRequest.GetResponse" /> method on the specified <see cref="T:System.Net.WebRequest" /> object. </para>
@@ -1289,6 +1324,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Net.WebResponse" /> for the specified <see cref="T:System.Net.WebRequest" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.WebResponse" /> containing the response for the specified <see cref="T:System.Net.WebRequest" />.</para>
+        </returns>
         <param name="request">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Net.WebRequest" /> that is used to obtain the response. </param>
       </Docs>
@@ -1309,7 +1348,6 @@
         <Parameter Name="result" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The object returned by this method is obtained by calling the <see cref="M:System.Net.WebRequest.EndGetResponse(System.IAsyncResult)" /> method on the specified <see cref="T:System.Net.WebRequest" /> object. </para>
@@ -1319,6 +1357,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Net.WebResponse" /> for the specified <see cref="T:System.Net.WebRequest" /> using the specified <see cref="T:System.IAsyncResult" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.WebResponse" /> containing the response for the specified <see cref="T:System.Net.WebRequest" />.</para>
+        </returns>
         <param name="request">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Net.WebRequest" /> that is used to obtain the response.</param>
         <param name="result">
@@ -1749,10 +1791,6 @@
         <Parameter Name="address" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.IO.Stream" /> used to read data from
-   a resource.</para>
-        </returns>
         <exception cref="T:System.Net.WebException">
           <para>The absolute URI is not valid.</para>
           <para> -or-</para>
@@ -1774,6 +1812,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a readable stream for the data downloaded from a resource with the URI specified as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> used to read data from a resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI specified as a <see cref="T:System.String" /> from which to download data. </param>
       </Docs>
@@ -1794,7 +1836,6 @@
         <Parameter Name="address" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.WebClient.OpenRead(System.String)" /> method creates a <see cref="T:System.IO.Stream" /> instance used to read the contents of the resource specified by the <paramref name="address" /> parameter. This method blocks while opening the stream. To continue executing while waiting for the stream, use one of the <see cref="Overload:System.Net.WebClient.OpenReadAsync" /> methods.</para>
@@ -1809,6 +1850,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a readable stream for the data downloaded from a resource with the URI specified as a <see cref="T:System.Uri" /></para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> used to read data from a resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI specified as a <see cref="T:System.Uri" /> from which to download data. </param>
       </Docs>
@@ -1928,7 +1973,6 @@
         <Parameter Name="address" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the a readable stream to the data resource has been opened. This method does not block the calling thread while the stream is opening.</para>
@@ -1947,6 +1991,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a readable stream containing the specified resource as an asynchronous operation using a task object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.IO.Stream" /> used to read data from a resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to retrieve.</param>
       </Docs>
@@ -1973,7 +2022,6 @@
         <Parameter Name="address" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the a readable stream to the data resource has been opened. This method does not block the calling thread while the stream is opening.</para>
@@ -1992,6 +2040,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a readable stream containing the specified resource as an asynchronous operation using a task object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.IO.Stream" /> used to read data from a resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to retrieve.</param>
       </Docs>
@@ -2013,9 +2066,6 @@
         <Parameter Name="address" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.IO.Stream" /> used to write data to the resource.</para>
-        </returns>
         <exception cref="T:System.Net.WebException">
           <para>The absolute URI is not valid.</para>
           <para> -or-</para>
@@ -2034,6 +2084,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a stream for writing data to the specified resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> used to write data to the resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the data. </param>
       </Docs>
@@ -2054,7 +2108,6 @@
         <Parameter Name="address" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.WebClient.OpenWrite(System.String)" /> method returns a writable stream that is used to send data to a resource. This method blocks while opening the stream. To continue executing while waiting for the stream, use one of the <see cref="Overload:System.Net.WebClient.OpenWriteAsync" /> methods.</para>
@@ -2068,6 +2121,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a stream for writing data to the specified resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> used to write data to the resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the data.</param>
       </Docs>
@@ -2090,9 +2147,6 @@
         <Parameter Name="method" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.IO.Stream" /> used to write data to the resource.</para>
-        </returns>
         <exception cref="T:System.Net.WebException">
           <para>The absolute URI is not valid.</para>
           <para> -or-</para>
@@ -2111,6 +2165,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a stream for writing data to the specified resource, using the specified method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> used to write data to the resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the data. </param>
         <param name="method">
@@ -2134,7 +2192,6 @@
         <Parameter Name="method" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.WebClient.OpenWrite(System.String)" /> method returns a writable stream that is used to send data to a resource. This method blocks while opening the stream. To continue executing while waiting for the stream, use one of the <see cref="Overload:System.Net.WebClient.OpenWriteAsync" /> methods.</para>
@@ -2147,6 +2204,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a stream for writing data to the specified resource, by using the specified method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> used to write data to the resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the data.</param>
         <param name="method">
@@ -2299,7 +2360,6 @@
         <Parameter Name="address" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the a writable stream to the data resource has been opened. This method does not block the calling thread while the stream is opening.</para>
@@ -2316,6 +2376,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.IO.Stream" /> used to write data to the resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the data.</param>
       </Docs>
@@ -2334,7 +2399,6 @@
         <Parameter Name="address" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the a writable stream to the data resource has been opened. This method does not block the calling thread while the stream is opening.</para>
@@ -2351,6 +2415,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.IO.Stream" /> used to write data to the resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the data.</param>
       </Docs>
@@ -2370,7 +2439,6 @@
         <Parameter Name="method" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the a writable stream to the data resource has been opened. This method does not block the calling thread while the stream is opening.</para>
@@ -2388,6 +2456,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.IO.Stream" /> used to write data to the resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the data.</param>
         <param name="method">
@@ -2417,7 +2490,6 @@
         <Parameter Name="method" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the a writable stream to the data resource has been opened. This method does not block the calling thread while the stream is opening.</para>
@@ -2435,6 +2507,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a stream for writing data to the specified resource as an asynchronous operation using a task object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.IO.Stream" /> used to write data to the resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the data.</param>
         <param name="method">
@@ -2545,11 +2622,6 @@
         <Parameter Name="data" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Byte" /> array containing
-   the body of the response, if any, from the server hosting the
-   resource.</para>
-        </returns>
         <exception cref="T:System.Net.WebException">
           <para>The absolute URI is not valid.</para>
           <para> -or-</para>
@@ -2574,6 +2646,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads a data buffer to a resource identified by a URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Byte" /> array containing the body of the response from the resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the data. </param>
         <param name="data">
@@ -2597,7 +2673,6 @@
         <Parameter Name="data" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.WebClient.UploadData(System.String,System.Byte[])" /> method sends a data buffer to a resource. </para>
@@ -2612,6 +2687,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads a data buffer to a resource identified by a URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Byte" /> array containing the body of the response from the resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the data. </param>
         <param name="data">
@@ -2637,11 +2716,6 @@
         <Parameter Name="data" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Byte" /> array containing the body of
-   the response, if any, from the server hosting the
-   resource.</para>
-        </returns>
         <exception cref="T:System.Net.WebException">
           <para>The absolute URI is not valid.</para>
           <para> -or-</para>
@@ -2666,6 +2740,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads a data buffer to the specified resource, using the specified method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Byte" /> array containing the body of the response from the resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the data. </param>
         <param name="method">
@@ -2692,7 +2770,6 @@
         <Parameter Name="data" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.WebClient.UploadData(System.String,System.Byte[])" /> method sends a data buffer to a resource using the HTTP method specified in the <paramref name="method" /> parameter, and returns any response from the server. This method blocks while uploading the data. To continue executing while waiting for the server's response, use one of the <see cref="Overload:System.Net.WebClient.UploadDataAsync" /> methods.</para>
@@ -2707,6 +2784,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads a data buffer to the specified resource, using the specified method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Byte" /> array containing the body of the response from the resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the data. </param>
         <param name="method">
@@ -2872,7 +2953,6 @@
         <Parameter Name="data" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the a data buffer has been uploaded to the resource. </para>
@@ -2888,6 +2968,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads a data buffer that contains a <see cref="T:System.Byte" /> array to the URI specified as an asynchronous operation using a task object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.Byte" /> array containing the body of the response received from the resource when the data buffer was uploaded.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the data.</param>
         <param name="data">
@@ -2909,7 +2994,6 @@
         <Parameter Name="data" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the a data buffer has been uploaded to the resource. </para>
@@ -2925,6 +3009,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads a data buffer that contains a <see cref="T:System.Byte" /> array to the URI specified as an asynchronous operation using a task object.  </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.Byte" /> array containing the body of the response received from the resource when the data buffer was uploaded.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the data.</param>
         <param name="data">
@@ -2947,7 +3036,6 @@
         <Parameter Name="data" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the a data buffer has been uploaded to the resource. </para>
@@ -2962,6 +3050,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads a data buffer that contains a <see cref="T:System.Byte" /> array to the URI specified as an asynchronous operation using a task object.  </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.Byte" /> array containing the body of the response received from the resource when the data buffer was uploaded.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the data.</param>
         <param name="method">
@@ -2994,7 +3087,6 @@
         <Parameter Name="data" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the a data buffer has been uploaded to the resource. </para>
@@ -3009,6 +3101,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads a data buffer that contains a <see cref="T:System.Byte" /> array to the URI specified as an asynchronous operation using a task object.  </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.Byte" /> array containing the body of the response received from the resource when the data buffer was uploaded.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the data.</param>
         <param name="method">
@@ -3035,10 +3132,6 @@
         <Parameter Name="fileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Byte" /> array containing the body of the response, if any, from the server hosting the
-   resource.</para>
-        </returns>
         <exception cref="T:System.Net.WebException">
           <para>The absolute URI is not valid.</para>
           <para> -or-</para>
@@ -3067,6 +3160,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads the specified local file to a resource with the specified URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Byte" /> array containing the body of the response from the resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the file. For example, ftp://localhost/samplefile.txt.</param>
         <param name="fileName">
@@ -3090,7 +3187,6 @@
         <Parameter Name="fileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.WebClient.UploadFile(System.String,System.String)" /> method sends a local file to a resource. This method uses the STOR command to upload an FTP resource. For an HTTP resource, the POST method is used.</para>
@@ -3105,6 +3201,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads the specified local file to a resource with the specified URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Byte" /> array containing the body of the response from the resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the file. For example, ftp://localhost/samplefile.txt.</param>
         <param name="fileName">
@@ -3130,10 +3230,6 @@
         <Parameter Name="fileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Byte" /> array containing the body of
-   the response, if any, from the server hosting the resource.</para>
-        </returns>
         <exception cref="T:System.Net.WebException">
           <para>The absolute URI is not valid.</para>
           <para> -or-</para>
@@ -3161,6 +3257,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads the specified local file to the specified resource, using the specified method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Byte" /> array containing the body of the response from the resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the file.</param>
         <param name="method">
@@ -3187,7 +3287,6 @@
         <Parameter Name="fileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When address specifies an HTTP resource, the <see cref="M:System.Net.WebClient.UploadFile(System.String,System.String)" /> method sends a local file to a resource using the HTTP method specified in the <paramref name="method" /> parameter and returns any response from the server. This method blocks while uploading the file. To continue executing while waiting for the server's response, use one of the <see cref="Overload:System.Net.WebClient.UploadFileAsync" /> methods.</para>
@@ -3201,6 +3300,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads the specified local file to the specified resource, using the specified method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Byte" /> array containing the body of the response from the resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the file.</param>
         <param name="method">
@@ -3368,7 +3471,6 @@
         <Parameter Name="fileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the file has been uploaded to the resource. The file is sent asynchronously using thread resources that are automatically allocated from the thread pool.</para>
@@ -3383,6 +3485,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads the specified local file to a resource as an asynchronous operation using a task object. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.Byte" /> array containing the body of the response received from the resource when the file was uploaded.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the file. For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.</param>
         <param name="fileName">
@@ -3404,7 +3511,6 @@
         <Parameter Name="fileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the file has been uploaded to the resource. The file is sent asynchronously using thread resources that are automatically allocated from the thread pool.</para>
@@ -3419,6 +3525,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads the specified local file to a resource as an asynchronous operation using a task object. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.Byte" /> array containing the body of the response received from the resource when the file was uploaded.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the file. For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.</param>
         <param name="fileName">
@@ -3441,7 +3552,6 @@
         <Parameter Name="fileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the file has been uploaded to the resource. The file is sent asynchronously using thread resources that are automatically allocated from the thread pool.</para>
@@ -3456,6 +3566,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads the specified local file to a resource as an asynchronous operation using a task object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.Byte" /> array containing the body of the response received from the resource when the file was uploaded.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the file. For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.</param>
         <param name="method">
@@ -3488,7 +3603,6 @@
         <Parameter Name="fileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the file has been uploaded to the resource. The file is sent asynchronously using thread resources that are automatically allocated from the thread pool.</para>
@@ -3503,6 +3617,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads the specified local file to a resource as an asynchronous operation using a task object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.Byte" /> array containing the body of the response received from the resource when the file was uploaded.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the file. For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.</param>
         <param name="method">
@@ -3593,7 +3712,6 @@
         <Parameter Name="data" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Before uploading the string, this method converts it to a <see cref="T:System.Byte" /> array using the encoding specified in the <see cref="P:System.Net.WebClient.Encoding" /> property. This method blocks while the string is transmitted. To send a string and continue executing while waiting for the server's response, use one of the <see cref="Overload:System.Net.WebClient.UploadStringAsync" /> methods.</para>
@@ -3607,6 +3725,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads the specified string to the specified resource, using the POST method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the response sent by the server.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the string. For Http resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page. </param>
         <param name="data">
@@ -3629,7 +3751,6 @@
         <Parameter Name="data" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Before uploading the string, this method converts it to a <see cref="T:System.Byte" /> array using the encoding specified in the <see cref="P:System.Net.WebClient.Encoding" /> property. This method blocks while the string is transmitted. To send a string and continue executing while waiting for the server's response, use one of the <see cref="Overload:System.Net.WebClient.UploadStringAsync" /> methods.</para>
@@ -3643,6 +3764,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads the specified string to the specified resource, using the POST method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the response sent by the server.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the string. For Http resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page. </param>
         <param name="data">
@@ -3666,7 +3791,6 @@
         <Parameter Name="data" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Before uploading the string, this method converts it to a <see cref="T:System.Byte" /> array using the encoding specified in the <see cref="P:System.Net.WebClient.Encoding" /> property. This method blocks while the string is transmitted. To send a string and continue executing while waiting for the server's response, use one of the <see cref="Overload:System.Net.WebClient.UploadStringAsync" /> methods. </para>
@@ -3679,6 +3803,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads the specified string to the specified resource, using the specified method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the response sent by the server.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the string. This URI must identify a resource that can accept a request sent with the <paramref name="method" /> method. </param>
         <param name="method">
@@ -3704,7 +3832,6 @@
         <Parameter Name="data" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Before uploading the string, this method converts it to a <see cref="T:System.Byte" /> array using the encoding specified in the <see cref="P:System.Net.WebClient.Encoding" /> property. This method blocks while the string is transmitted. To send a string and continue executing while waiting for the server's response, use one of the <see cref="Overload:System.Net.WebClient.UploadStringAsync" /> methods. </para>
@@ -3717,6 +3844,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads the specified string to the specified resource, using the specified method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the response sent by the server.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the string. This URI must identify a resource that can accept a request sent with the <paramref name="method" /> method. </param>
         <param name="method">
@@ -3882,7 +4013,6 @@
         <Parameter Name="data" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the string has been uploaded to the resource. The string is sent asynchronously using thread resources that are automatically allocated from the thread pool.</para>
@@ -3897,6 +4027,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads the specified string to the specified resource as an asynchronous operation using a task object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.String" /> containing the response sent by the server.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the string. For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.</param>
         <param name="data">
@@ -3918,7 +4053,6 @@
         <Parameter Name="data" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the string has been uploaded to the resource. The string is sent asynchronously using thread resources that are automatically allocated from the thread pool.</para>
@@ -3933,6 +4067,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads the specified string to the specified resource as an asynchronous operation using a task object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.String" /> containing the response sent by the server.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the string. For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.</param>
         <param name="data">
@@ -3955,7 +4094,6 @@
         <Parameter Name="data" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the string has been uploaded to the resource. The string is sent asynchronously using thread resources that are automatically allocated from the thread pool.</para>
@@ -3970,6 +4108,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads the specified string to the specified resource as an asynchronous operation using a task object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.String" /> containing the response sent by the server.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the string. For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.</param>
         <param name="method">
@@ -4002,7 +4145,6 @@
         <Parameter Name="data" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the string has been uploaded to the resource. The string is sent asynchronously using thread resources that are automatically allocated from the thread pool.</para>
@@ -4017,6 +4159,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads the specified string to the specified resource as an asynchronous operation using a task object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.String" /> containing the response sent by the server.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the string. For HTTP resources, this URI must identify a resource that can accept a request sent with the POST method, such as a script or ASP page.</param>
         <param name="method">
@@ -4043,10 +4190,6 @@
         <Parameter Name="data" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Byte" /> array containing the body of the response, if any, from the server hosting the
-   resource.</para>
-        </returns>
         <exception cref="T:System.Net.WebException">
           <para>The absolute URI is not valid.</para>
           <para> -or-</para>
@@ -4074,6 +4217,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads the specified name/value collection to the resource identified by the specified URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Byte" /> array containing the body of the response from the resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the collection. </param>
         <param name="data">
@@ -4097,7 +4244,6 @@
         <Parameter Name="data" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.WebClient.UploadValues(System.String,System.Collections.Specialized.NameValueCollection)" /> method sends a <see cref="T:System.Collections.Specialized.NameValueCollection" /> to a server. This method blocks while uploading the data. To continue executing while waiting for the server's response, use one of the <see cref="Overload:System.Net.WebClient.UploadValuesAsync" /> methods.</para>
@@ -4113,6 +4259,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads the specified name/value collection to the resource identified by the specified URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Byte" /> array containing the body of the response from the resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the collection. </param>
         <param name="data">
@@ -4138,10 +4288,6 @@
         <Parameter Name="data" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Byte" /> array containing the body of the response, if any, from the server hosting the
-   resource.</para>
-        </returns>
         <exception cref="T:System.Net.WebException">
           <para>The absolute URI is not valid.</para>
           <para> -or-</para>
@@ -4168,6 +4314,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads the specified name/value collection to the resource identified by the specified URI, using the specified method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Byte" /> array containing the body of the response from the resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the collection. </param>
         <param name="method">
@@ -4194,7 +4344,6 @@
         <Parameter Name="data" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.WebClient.UploadValues(System.String,System.Collections.Specialized.NameValueCollection)" /> method sends a <see cref="T:System.Collections.Specialized.NameValueCollection" /> to a resource using the method specified in the <paramref name="method" /> parameter and returns any response from the server. This method blocks while uploading the data. To continue executing while waiting for the server's response, use one of the <see cref="Overload:System.Net.WebClient.UploadValuesAsync" /> methods.</para>
@@ -4209,6 +4358,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads the specified name/value collection to the resource identified by the specified URI, using the specified method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Byte" /> array containing the body of the response from the resource.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the collection. </param>
         <param name="method">
@@ -4379,7 +4532,6 @@
         <Parameter Name="data" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the name/value collection has been uploaded to the resource. The name/value collection is sent asynchronously using thread resources that are automatically allocated from the thread pool.</para>
@@ -4396,6 +4548,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads the specified name/value collection to the resource identified by the specified URI as an asynchronous operation using a task object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.Byte" /> array containing the response sent by the server.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the collection.</param>
         <param name="data">
@@ -4417,7 +4574,6 @@
         <Parameter Name="data" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the name/value collection has been uploaded to the resource. The name/value collection is sent asynchronously using thread resources that are automatically allocated from the thread pool.</para>
@@ -4434,6 +4590,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads the specified name/value collection to the resource identified by the specified URI as an asynchronous operation using a task object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.Byte" /> array containing the response sent by the server.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the collection.</param>
         <param name="data">
@@ -4456,7 +4617,6 @@
         <Parameter Name="data" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the name/value collection has been uploaded to the resource. The name/value collection is sent asynchronously using thread resources that are automatically allocated from the thread pool.</para>
@@ -4473,6 +4633,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads the specified name/value collection to the resource identified by the specified URI as an asynchronous operation using a task object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.Byte" /> array containing the response sent by the server.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the collection.</param>
         <param name="method">
@@ -4505,7 +4670,6 @@
         <Parameter Name="data" Type="System.Collections.Specialized.NameValueCollection" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after the name/value collection has been uploaded to the resource. The name/value collection is sent asynchronously using thread resources that are automatically allocated from the thread pool.</para>
@@ -4522,6 +4686,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uploads the specified name/value collection to the resource identified by the specified URI as an asynchronous operation using a task object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="T:System.Byte" /> array containing the response sent by the server.</para>
+        </returns>
         <param name="address">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the resource to receive the collection.</param>
         <param name="method">
diff --git a/mcs/class/System/Documentation/en/System.Net/WebHeaderCollection.xml b/mcs/class/System/Documentation/en/System.Net/WebHeaderCollection.xml
index 6fcb4e0c815..dd15001d0b2 100644
--- a/mcs/class/System/Documentation/en/System.Net/WebHeaderCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Net/WebHeaderCollection.xml
@@ -398,12 +398,15 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Get the value of a particular header in the collection, specified by an index into the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the value of the specified header.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the key to get from the collection.</param>
       </Docs>
@@ -424,7 +427,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns null if there is no <paramref name="name" /> header in the collection.</para>
@@ -433,6 +435,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Get the value of a particular header in the collection, specified by the name of the header.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> holding the value of the specified header.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the Web header.</param>
       </Docs>
@@ -450,12 +456,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that can iterate through the <see cref="T:System.Net.WebHeaderCollection" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.Net.WebHeaderCollection" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetKey">
@@ -474,12 +483,15 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Get the header name at the specified position in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> holding the header name.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the key to get from the collection.</param>
       </Docs>
@@ -531,7 +543,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -541,6 +552,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of header values stored in the <paramref name="index" /> position of the header collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of header strings.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The header index to return.</param>
       </Docs>
@@ -562,13 +577,6 @@
         <Parameter Name="header" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> An array of <see cref="T:System.String" /> objects that contain the values of the protocol
-   header named <paramref name="header" />
-   in the current instance. If <paramref name="header " />is not found in the current
-   instance, returns <see langword="null" /> .
-   </para>
-        </returns>
         <example>
           <para>This example demonstrates the <see cref="M:System.Net.WebHeaderCollection.GetValues(System.String)" /> method.</para>
           <code lang="C#">
@@ -612,6 +620,10 @@ Transfer-Encoding:</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of header values stored in a header.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of header strings.</para>
+        </returns>
         <param name="header">
           <attribution license="cc4" from="Microsoft" modified="false" />The header to return. </param>
       </Docs>
@@ -634,11 +646,6 @@ Transfer-Encoding:</para>
         <Parameter Name="headerName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if
-   the header is protected; otherwise <see langword="false" /> .</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="headerName" /> is <see langword="null" /> or <see cref="F:System.String.Empty" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -694,6 +701,10 @@ Transfer-Encoding:</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether the specified HTTP header can be set for the request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the header is restricted; otherwise false.</para>
+        </returns>
         <param name="headerName">
           <attribution license="cc4" from="Microsoft" modified="false" />The header to test. </param>
       </Docs>
@@ -715,7 +726,6 @@ Transfer-Encoding:</para>
         <Parameter Name="response" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.WebHeaderCollection.IsRestricted(System.String,System.Boolean)" /> method returns true to indicate that a request or response header is restricted and must be set using properties instead of directly or is set by the system. The restricted headers are: </para>
@@ -765,6 +775,10 @@ Transfer-Encoding:</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether the specified HTTP header can be set for the request or the response.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the header is restricted; otherwise, false.</para>
+        </returns>
         <param name="headerName">
           <attribution license="cc4" from="Microsoft" modified="false" />The header to test.</param>
         <param name="response">
@@ -1105,12 +1119,15 @@ Transfer-Encoding:</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the <see cref="T:System.Net.WebHeaderCollection" /> to a byte array..</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Byte" /> array holding the header collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -1127,12 +1144,15 @@ Transfer-Encoding:</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is obsolete.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.String" /> representation of the collection.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.Net/WebPermission.xml b/mcs/class/System/Documentation/en/System.Net/WebPermission.xml
index 891f9192031..41aa2a757a1 100644
--- a/mcs/class/System/Documentation/en/System.Net/WebPermission.xml
+++ b/mcs/class/System/Documentation/en/System.Net/WebPermission.xml
@@ -331,11 +331,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A new <see cref="T:System.Net.WebPermission" /> instance
-   containing the same values as the current instance.
-   </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Security.IPermission" /> returned by this method represents the same access to resources as the original <see cref="T:System.Net.WebPermission" />. This method overrides <see cref="M:System.Security.CodeAccessPermission.Copy" /> and is implemented to support the <see cref="T:System.Security.IPermission" /> interface.</para>
@@ -344,6 +339,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of a <see cref="T:System.Net.WebPermission" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the <see cref="T:System.Net.WebPermission" /> class that has the same values as the original. </para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -403,13 +402,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Net.WebPermission" /> instance that represents the intersection of the
-   current instance and <paramref name="target" />. If the intersection is
-   empty, returns <see langword="null" />. If the
-   current instance is unrestricted, returns a copy of <paramref name="target" />. If
-<paramref name="target" /> is unrestricted, returns a copy of the current instance.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="target " />is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -424,6 +416,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the logical intersection of two <see cref="T:System.Net.WebPermission" /> instances.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Net.WebPermission" /> that represents the intersection of the current instance and the <paramref name="target" /> parameter. If the intersection is empty, the method returns null.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.WebPermission" /> to compare with the current instance. </param>
       </Docs>
@@ -446,14 +442,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the current instance is a subset of <paramref name="target" /> ;
-   otherwise,<see langword=" false" />. If target is null, return
-<see langword="false" />. If the current instance is unrestricted, and
-<paramref name="target" /> is not, returns <see langword="false" />. If <paramref name="target" /> is 
-   unrestricted, returns <see langword="true" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>
             <paramref name="target " />is not of type <see cref="T:System.Net.WebPermission" />.</para>
@@ -466,6 +454,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current <see cref="T:System.Net.WebPermission" /> is a subset of the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current instance is a subset of the <paramref name="target" /> parameter; otherwise, false. If the target is null, the method returns true for an empty current permission that is not unrestricted and false otherwise.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.WebPermission" /> to compare to the current <see cref="T:System.Net.WebPermission" />. </param>
       </Docs>
@@ -485,7 +477,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <see cref="T:System.Net.WebPermission" /> is <see cref="F:System.Security.Permissions.PermissionState.Unrestricted" />, then the target class can use all URIs. Otherwise, specific permission must be given for any URI you want to use with the target class.</para>
@@ -497,6 +488,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks the overall permission state of the <see cref="T:System.Net.WebPermission" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Net.WebPermission" /> was created with the <see cref="F:System.Security.Permissions.PermissionState.Unrestricted" /> <see cref="T:System.Security.Permissions.PermissionState" />; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToXml">
@@ -514,10 +509,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Security.SecurityElement" /> containing the XML encoding of the state of the
-   current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Net.WebPermission.FromXml(System.Security.SecurityElement)" /> method to restore the state information from a <see cref="T:System.Security.SecurityElement" />.</para>
@@ -526,6 +517,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of a <see cref="T:System.Net.WebPermission" /> and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.SecurityElement" /> that contains an XML-encoded representation of the <see cref="T:System.Net.WebPermission" />, including state information.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -546,11 +541,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Net.WebPermission" /> instance that represents the union of the current
-   instance and <paramref name="target" />. If the current instance
-   or <paramref name="target" /> is unrestricted, returns a <see cref="T:System.Net.WebPermission" /> instance that is unrestricted.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="target " />is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -564,6 +554,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the logical union between two instances of the <see cref="T:System.Net.WebPermission" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.WebPermission" /> that represents the union of the current instance and the <paramref name="target" /> parameter. If either WebPermission is <see cref="F:System.Security.Permissions.PermissionState.Unrestricted" />, the method returns a <see cref="T:System.Net.WebPermission" /> that is <see cref="F:System.Security.Permissions.PermissionState.Unrestricted" />. If the target is null, the method returns a copy of the current <see cref="T:System.Net.WebPermission" />.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Net.WebPermission" /> to combine with the current <see cref="T:System.Net.WebPermission" />. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Net/WebPermissionAttribute.xml b/mcs/class/System/Documentation/en/System.Net/WebPermissionAttribute.xml
index 22e6e4476ff..e7c7ab528e8 100644
--- a/mcs/class/System/Documentation/en/System.Net/WebPermissionAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.Net/WebPermissionAttribute.xml
@@ -196,10 +196,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Net.WebPermission" /> object with the security information of the current 
- instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.SocketPermissionAttribute.CreatePermission" /> method is called by the security system, not by application code.</para>
@@ -209,6 +205,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new instance of the <see cref="T:System.Net.WebPermission" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.WebPermission" /> corresponding to the security declaration.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/System/Documentation/en/System.Net/WebProxy.xml b/mcs/class/System/Documentation/en/System.Net/WebProxy.xml
index 2516cfd08a0..a1bff086b84 100644
--- a/mcs/class/System/Documentation/en/System.Net/WebProxy.xml
+++ b/mcs/class/System/Documentation/en/System.Net/WebProxy.xml
@@ -596,11 +596,6 @@ public class WebProxyExample {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Net.WebProxy" />
-instance that contains the default proxy settings of the
-system.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.WebProxy.GetDefaultProxy" /> method reads the nondynamic proxy settings stored by Internet Explorer 5.5 and later, and creates a <see cref="T:System.Net.WebProxy" /> instance with those settings.</para>
@@ -611,6 +606,10 @@ system.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the Internet Explorer nondynamic proxy settings.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.WebProxy" /> instance that contains the nondynamic proxy settings from Internet Explorer 5.5 and later.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -661,11 +660,6 @@ system.</para>
         <Parameter Name="destination" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>If <paramref name="destination" /> is on the bypass list of the 
- current instance, returns <paramref name="destination" />; otherwise, returns the <see cref="P:System.Net.WebProxy.Address" /> of
- the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.WebProxy.GetProxy(System.Uri)" /> method returns the URI that the <see cref="T:System.Net.WebRequest" /> instance uses to access the Internet resource.</para>
@@ -677,6 +671,10 @@ system.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the proxied URI for a request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Uri" /> instance of the Internet resource, if the resource is on the bypass list; otherwise, the <see cref="T:System.Uri" /> instance of the proxy.</para>
+        </returns>
         <param name="destination">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Uri" /> instance of the requested Internet resource. </param>
       </Docs>
@@ -699,28 +697,6 @@ system.</para>
         <Parameter Name="host" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns <see langword="true" /> under any of the following conditions:</para>
-          <list type="bullet">
-            <item>
-              <term>
-      
-      The <see cref="P:System.Net.WebProxy.BypassProxyOnLocal" /> property of the current instance is
-   <see langword="true" /> and <paramref name="host " />is a local URI.</term>
-            </item>
-            <item>
-              <term>
-                <paramref name="host " />matches a regular expression in <see cref="P:System.Net.WebProxy.BypassList" />.</term>
-            </item>
-            <item>
-              <term>
-      
-      The <see cref="P:System.Net.WebProxy.Address" /> of the current instance is
-   <see langword="null" />.</term>
-            </item>
-          </list>
-          <para>All other conditions return <see langword="false" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">The <see cref="P:System.Net.WebProxy.BypassList" /> of the current instance contains an invalid regular expression.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -745,6 +721,10 @@ system.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether to use the proxy server for the specified host.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the proxy server should not be used for <paramref name="host" />; otherwise, false.</para>
+        </returns>
         <param name="host">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Uri" /> instance of the host to check for proxy use. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Net/WebRequest.xml b/mcs/class/System/Documentation/en/System.Net/WebRequest.xml
index 6d9d9a9e6c4..fd261142225 100644
--- a/mcs/class/System/Documentation/en/System.Net/WebRequest.xml
+++ b/mcs/class/System/Documentation/en/System.Net/WebRequest.xml
@@ -186,9 +186,6 @@ public class WebRequestExample {
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.IAsyncResult" /> object that contains information about the asynchronous operation.</para>
-        </returns>
         <exception cref="T:System.NotSupportedException">This method is not overridden in the derived class.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -201,6 +198,10 @@ public class WebRequestExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a descendant class, provides an asynchronous version of the <see cref="M:System.Net.WebRequest.GetRequestStream" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that references the asynchronous request.</para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.AsyncCallback" /> delegate. </param>
         <param name="state">
@@ -226,9 +227,6 @@ public class WebRequestExample {
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.IAsyncResult" /> object that contains information about the asynchronous operation. </para>
-        </returns>
         <exception cref="T:System.NotSupportedException">This method is not overridden in the derived class.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -244,6 +242,10 @@ public class WebRequestExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a descendant class, begins an asynchronous request for an Internet resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that references the asynchronous request.</para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.AsyncCallback" /> delegate. </param>
         <param name="state">
@@ -399,10 +401,6 @@ public class WebRequestExample {
         <Parameter Name="requestUriString" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new instance of a class that derived from <see cref="T:System.Net.WebRequest" /> and is registered to handle the
-   scheme of <paramref name="requestUriString" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="requestUriString " />is <see langword="null" />.</exception>
         <exception cref="T:System.NotSupportedException">The request scheme specified in <paramref name="requestUri " /> is not registered.</exception>
@@ -438,6 +436,10 @@ public class WebRequestExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new <see cref="T:System.Net.WebRequest" /> instance for the specified URI scheme.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.WebRequest" /> descendant for the specific URI scheme.</para>
+        </returns>
         <param name="requestUriString">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI that identifies the Internet resource. </param>
       </Docs>
@@ -460,10 +462,6 @@ public class WebRequestExample {
         <Parameter Name="requestUri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A new instance of a class derived from <see cref="T:System.Net.WebRequest" /> that is registered to handle the closest registered
-   match for <paramref name="requestUri" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="requestUri " />is <see langword="null" />.</exception>
         <exception cref="T:System.NotSupportedException">The request scheme specified in <paramref name="requestUri " /> is not registered.</exception>
@@ -499,6 +497,10 @@ public class WebRequestExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new <see cref="T:System.Net.WebRequest" /> instance for the specified URI scheme.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.WebRequest" /> descendant for the specified URI scheme.</para>
+        </returns>
         <param name="requestUri">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Uri" /> containing the URI of the requested resource. </param>
       </Docs>
@@ -521,9 +523,6 @@ public class WebRequestExample {
         <Parameter Name="requestUri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A new instance of the type derived from <see cref="T:System.Net.WebRequest" /> that is registered for the scheme of the specified <see cref="T:System.Uri" /> .</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="requestUri" /> is <see langword="null" />.</exception>
         <exception cref="T:System.NotSupportedException">The request scheme specified in <paramref name="requestUri " /> is not registered.</exception>
@@ -577,6 +576,10 @@ public class CreateDefaultExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new <see cref="T:System.Net.WebRequest" /> instance for the specified URI scheme.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.WebRequest" /> descendant for the specified URI scheme.</para>
+        </returns>
         <param name="requestUri">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Uri" /> containing the URI of the requested resource. </param>
       </Docs>
@@ -601,7 +604,6 @@ public class CreateDefaultExample
         <Parameter Name="requestUriString" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.WebRequest.CreateHttp(System.String)" /> method returns an instance of the <see cref="T:System.Net.HttpWebRequest" /> class for the <paramref name="requestUriString" />.</para>
@@ -613,6 +615,11 @@ public class CreateDefaultExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new <see cref="T:System.Net.HttpWebRequest" /> instance for the specified URI string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Net.HttpWebRequest" />.</para>
+          <para>An <see cref="T:System.Net.HttpWebRequest" />  instance for the specific URI string.</para>
+        </returns>
         <param name="requestUriString">
           <attribution license="cc4" from="Microsoft" modified="false" />A URI string that identifies the Internet resource. </param>
       </Docs>
@@ -636,7 +643,6 @@ public class CreateDefaultExample
         <Parameter Name="requestUri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Net.WebRequest.CreateHttp(System.Uri)" /> method returns an instance of the <see cref="T:System.Net.HttpWebRequest" /> class for the <paramref name="requestUri" />.</para>
@@ -648,6 +654,11 @@ public class CreateDefaultExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new <see cref="T:System.Net.HttpWebRequest" /> instance for the specified URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Net.HttpWebRequest" />.</para>
+          <para>An <see cref="T:System.Net.HttpWebRequest" /> instance for the specific URI string.</para>
+        </returns>
         <param name="requestUri">
           <attribution license="cc4" from="Microsoft" modified="false" />A URI that identifies the Internet resource.</param>
       </Docs>
@@ -761,10 +772,6 @@ public class CreateDefaultExample
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.IO.Stream" /> to write data
-   to.</para>
-        </returns>
         <exception cref="T:System.NotSupportedException">This method is not overridden in the derived class.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="asyncResult" /> was not returned by a call to <see cref="M:System.Net.WebRequest.BeginGetRequestStream(System.AsyncCallback,System.Object)" />.</exception>
@@ -790,6 +797,10 @@ public class CreateDefaultExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a descendant class, returns a <see cref="T:System.IO.Stream" /> for writing data to the Internet resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> to write data to.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IAsyncResult" /> that references a pending request for a stream. </param>
       </Docs>
@@ -812,10 +823,6 @@ public class CreateDefaultExample
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Net.WebResponse" /> that contains a response to the request
-   referenced by <paramref name="asyncResult" />.</para>
-        </returns>
         <exception cref="T:System.NotSupportedException">This method is not overridden in the derived class.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="asyncResult" /> was not returned by a call to <see cref="M:System.Net.WebRequest.BeginGetResponse(System.AsyncCallback,System.Object)" />.</exception>
@@ -838,6 +845,10 @@ public class CreateDefaultExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a descendant class, returns a <see cref="T:System.Net.WebResponse" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.WebResponse" /> that contains a response to the Internet request.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IAsyncResult" /> that references a pending request for a response. </param>
       </Docs>
@@ -888,10 +899,6 @@ public class CreateDefaultExample
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.IO.Stream" /> for writing data to
-   a resource.</para>
-        </returns>
         <exception cref="T:System.NotSupportedException">This method is not overridden in the derived class.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -905,6 +912,10 @@ public class CreateDefaultExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a descendant class, returns a <see cref="T:System.IO.Stream" /> for writing data to the Internet resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> for writing data to the Internet resource.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -920,7 +931,6 @@ public class CreateDefaultExample
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" />object will complete when the <see cref="T:System.IO.Stream" /> for writing data to the Internet resource is available.</para>
@@ -929,6 +939,11 @@ public class CreateDefaultExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a descendant class, returns a <see cref="T:System.IO.Stream" /> for writing data to the Internet resource as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetResponse">
@@ -946,9 +961,6 @@ public class CreateDefaultExample
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Net.WebResponse" /> containing the response to the request.</para>
-        </returns>
         <exception cref="T:System.NotSupportedException">This method is not overridden in the derived class.</exception>
         <exception cref="T:System.Net.WebException">
           <para> The request timed out.</para>
@@ -971,6 +983,10 @@ public class CreateDefaultExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a descendant class, returns a response to an Internet request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Net.WebResponse" /> containing the response to the Internet request.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -986,7 +1002,6 @@ public class CreateDefaultExample
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will not block. The returned <see cref="T:System.Threading.Tasks.Task`1" /> object will complete after a response to an Internet request is available.</para>
@@ -995,6 +1010,11 @@ public class CreateDefaultExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a descendant class, returns a response to an Internet request as an asynchronous operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+          <para>The task object representing the asynchronous operation.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetSystemWebProxy">
@@ -1015,7 +1035,6 @@ public class CreateDefaultExample
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -1026,6 +1045,10 @@ public class CreateDefaultExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a proxy configured with the Internet Explorer settings of the currently impersonated user.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Net.IWebProxy" /> used by every call to instances of <see cref="T:System.Net.WebRequest" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Headers">
@@ -1208,13 +1231,6 @@ public class CreateDefaultExample
         <Parameter Name="creator" Type="System.Net.IWebRequestCreate" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true " /> if registration is successful;
-<see langword="false" />, if 
-<paramref name="prefix" /> 
-is already registered.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <para>
             <paramref name="prefix" /> is <see langword="null" /> or 
@@ -1282,6 +1298,10 @@ public class RegisterPrefixExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Registers a <see cref="T:System.Net.WebRequest" /> descendant for the specified URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if registration is successful; otherwise, false.</para>
+        </returns>
         <param name="prefix">
           <attribution license="cc4" from="Microsoft" modified="false" />The complete URI or URI prefix that the <see cref="T:System.Net.WebRequest" /> descendant services. </param>
         <param name="creator">
diff --git a/mcs/class/System/Documentation/en/System.Net/WebResponse.xml b/mcs/class/System/Documentation/en/System.Net/WebResponse.xml
index a4b9fd44f30..9b15b723f09 100644
--- a/mcs/class/System/Documentation/en/System.Net/WebResponse.xml
+++ b/mcs/class/System/Documentation/en/System.Net/WebResponse.xml
@@ -314,11 +314,6 @@ containing the number of bytes returned from the resource.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.IO.Stream" /> for reading data from the
-   current
-   host.</para>
-        </returns>
         <exception cref="T:System.NotSupportedException">This method is not implemented in the derived class. </exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -331,6 +326,10 @@ containing the number of bytes returned from the resource.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a descendant class, returns the data stream from the Internet resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the <see cref="T:System.IO.Stream" /> class for reading data from the Internet resource.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/System/Documentation/en/System.Net/WebUtility.xml b/mcs/class/System/Documentation/en/System.Net/WebUtility.xml
index 688fdd4ef35..a5d3e0a9cbd 100644
--- a/mcs/class/System/Documentation/en/System.Net/WebUtility.xml
+++ b/mcs/class/System/Documentation/en/System.Net/WebUtility.xml
@@ -35,7 +35,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If characters such as blanks and punctuation are passed in an HTTP stream, they might be misinterpreted at the receiving end. HTML encoding converts characters that are not allowed in HTML into character-entity equivalents; HTML decoding reverses the encoding. For example, when embedded in a block of text, the characters &lt; and &gt; are encoded as &amp;lt; and &amp;gt; for HTTP transmission.</para>
@@ -45,6 +44,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string that has been HTML-encoded for HTTP transmission into a decoded string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decoded string.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to decode.</param>
       </Docs>
@@ -92,7 +95,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If characters such as blanks and punctuation are passed in an HTTP stream, they might be misinterpreted at the receiving end. HTML encoding converts characters that are not allowed in HTML into character-entity equivalents; HTML decoding reverses the encoding. For example, when embedded in a block of text, the characters &lt; and &gt; are encoded as &amp;lt; and &amp;gt; for HTTP transmission.</para>
@@ -102,6 +104,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string to an HTML-encoded string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An encoded string.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to encode.</param>
       </Docs>
@@ -149,7 +155,6 @@
         <Parameter Name="encodedValue" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If characters such as blanks and punctuation are passed in an HTTP stream, they might be misinterpreted at the receiving end. URL encoding converts characters that are not allowed in a URL into equivalent hexadecimal escape sequences. The <see cref="M:System.Net.WebUtility.UrlEncode(System.String)" /> method creates a URL-encoded string.</para>
@@ -159,6 +164,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string that has been encoded for transmission in a URL into a decoded string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.String" />.</para>
+          <para>A decoded string.</para>
+        </returns>
         <param name="encodedValue">
           <attribution license="cc4" from="Microsoft" modified="false" />A URL-encoded string to decode.</param>
       </Docs>
@@ -179,7 +189,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If characters such as blanks and punctuation are passed in an HTTP stream, they might be misinterpreted at the receiving end. URL encoding converts characters that are not allowed in a URL into equivalent hexadecimal escape sequences. The <see cref="M:System.Net.WebUtility.UrlEncodeToBytes(System.Byte[],System.Int32,System.Int32)" /> method creates a URL-encoded byte array.</para>
@@ -189,6 +198,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an encoded byte array that has been encoded for transmission in a URL into a decoded byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Byte" />.</para>
+          <para>A decoded <see cref="T:System.Byte" /> array.</para>
+        </returns>
         <param name="encodedValue">
           <attribution license="cc4" from="Microsoft" modified="false" />A URL-encoded <see cref="T:System.Byte" /> array to decode.</param>
         <param name="offset">
@@ -211,7 +225,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If characters such as blanks and punctuation are passed in an HTTP stream, they might be misinterpreted at the receiving end. URL encoding replaces characters that are not allowed in a URL with character-entity equivalents consisting of hexadecimal escape sequences. The converted string is expected to conform to the UTF-8 format.</para>
@@ -246,6 +259,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a text string into a URL-encoded string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.String" />.</para>
+          <para>A URL-encoded string.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to URL-encode.</param>
       </Docs>
@@ -266,7 +284,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If characters such as blanks and punctuation are passed in an HTTP stream, they might be misinterpreted at the receiving end. URL encoding replaces characters that are not allowed in a URL with character-entity equivalents consisting of hexadecimal escape sequences. The converted string is expected to conform to the UTF-8 format.</para>
@@ -301,6 +318,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a byte array into a URL-encoded byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Byte" />.</para>
+          <para>An encoded <see cref="T:System.Byte" /> array.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Byte" /> array to URL-encode.</param>
         <param name="offset">
diff --git a/mcs/class/System/Documentation/en/System.Runtime.InteropServices.ComTypes/IDataObject.xml b/mcs/class/System/Documentation/en/System.Runtime.InteropServices.ComTypes/IDataObject.xml
index a1aa1f031b6..f87071da078 100644
--- a/mcs/class/System/Documentation/en/System.Runtime.InteropServices.ComTypes/IDataObject.xml
+++ b/mcs/class/System/Documentation/en/System.Runtime.InteropServices.ComTypes/IDataObject.xml
@@ -78,6 +78,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Destroys a notification connection that had been previously established.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method supports the following return values:</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>S_OK</para>
+              </term>
+              <description>
+                <para>The specified connection was successfully deleted.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>OLE_E_NOCONNECTION</para>
+              </term>
+              <description>
+                <para>The specified connection is not valid.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>OLE_E_ADVISENOTSUPPORTED</para>
+              </term>
+              <description>
+                <para>This <see cref="T:System.Runtime.InteropServices.ComTypes.IDataObject" /> implementation does not support notification.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="connection">
           <attribution license="cc4" from="Microsoft" modified="false" />A DWORD token that specifies the connection to remove. Use the value returned by <see cref="M:System.Runtime.InteropServices.ComTypes.IDataObject.DAdvise(System.Runtime.InteropServices.ComTypes.FORMATETC@,System.Runtime.InteropServices.ComTypes.ADVF,System.Runtime.InteropServices.ComTypes.IAdviseSink,System.Int32@)" /> when the connection was originally established.</param>
       </Docs>
@@ -118,7 +158,6 @@
         <Parameter Name="direction" Type="System.Runtime.InteropServices.ComTypes.DATADIR" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information about IDataObject::EnumFormatEtc, see the MSDN Library.</para>
@@ -127,6 +166,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an object for enumerating the <see cref="T:System.Runtime.InteropServices.ComTypes.FORMATETC" /> structures for a data object. These structures are used in calls to <see cref="M:System.Runtime.InteropServices.ComTypes.IDataObject.GetData(System.Runtime.InteropServices.ComTypes.FORMATETC@,System.Runtime.InteropServices.ComTypes.STGMEDIUM@)" /> or <see cref="M:System.Runtime.InteropServices.ComTypes.IDataObject.SetData(System.Runtime.InteropServices.ComTypes.FORMATETC@,System.Runtime.InteropServices.ComTypes.STGMEDIUM@,System.Boolean)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method supports the standard return values E_INVALIDARG and E_OUTOFMEMORY, as well as the following:</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>S_OK</para>
+              </term>
+              <description>
+                <para>The enumerator object was successfully created.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>E_NOTIMPL</para>
+              </term>
+              <description>
+                <para>The direction specified by the <paramref name="direction" /> parameter is not supported.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>OLE_S_USEREG</para>
+              </term>
+              <description>
+                <para>Requests that OLE enumerate the formats from the registry.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="direction">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Runtime.InteropServices.ComTypes.DATADIR" /> values that specifies the direction of the data.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Runtime.InteropServices.ComTypes/IEnumFORMATETC.xml b/mcs/class/System/Documentation/en/System.Runtime.InteropServices.ComTypes/IEnumFORMATETC.xml
index 4247f1d4538..96b57c27e77 100644
--- a/mcs/class/System/Documentation/en/System.Runtime.InteropServices.ComTypes/IEnumFORMATETC.xml
+++ b/mcs/class/System/Documentation/en/System.Runtime.InteropServices.ComTypes/IEnumFORMATETC.xml
@@ -66,7 +66,6 @@
         <Parameter Name="pceltFetched" Type="System.Int32[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information about IEnumFORMATETC::Next, see the MSDN Library.</para>
@@ -75,6 +74,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a specified number of items in the enumeration sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>S_OK if the <paramref name="pceltFetched" /> parameter equals the <paramref name="celt" /> parameter; otherwise, S_FALSE.</para>
+        </returns>
         <param name="celt">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of <see cref="T:System.Runtime.InteropServices.ComTypes.FORMATETC" /> references to return in <paramref name="rgelt" />.</param>
         <param name="rgelt">
@@ -96,7 +99,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information about IEnumFORMATETC::Reset, see the MSDN Library.</para>
@@ -105,6 +107,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resets the enumeration sequence to the beginning.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An HRESULT with the value S_OK.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Skip">
@@ -122,7 +128,6 @@
         <Parameter Name="celt" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information about IEnumFORMATETC::Skip, see the MSDN Library.</para>
@@ -131,6 +136,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Skips a specified number of items in the enumeration sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>S_OK if the number of elements skipped equals the <paramref name="celt" /> parameter; otherwise, S_FALSE.</para>
+        </returns>
         <param name="celt">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of elements to skip in the enumeration.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Runtime.InteropServices.ComTypes/IEnumSTATDATA.xml b/mcs/class/System/Documentation/en/System.Runtime.InteropServices.ComTypes/IEnumSTATDATA.xml
index 6d32daaf51a..990f1c14c2f 100644
--- a/mcs/class/System/Documentation/en/System.Runtime.InteropServices.ComTypes/IEnumSTATDATA.xml
+++ b/mcs/class/System/Documentation/en/System.Runtime.InteropServices.ComTypes/IEnumSTATDATA.xml
@@ -66,7 +66,6 @@
         <Parameter Name="pceltFetched" Type="System.Int32[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information about IEnumSTATDATA::Next, see the MSDN Library.</para>
@@ -75,6 +74,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a specified number of items in the enumeration sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>S_OK if the <paramref name="pceltFetched" /> parameter equals the <paramref name="celt" /> parameter; otherwise, S_FALSE.</para>
+        </returns>
         <param name="celt">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of <see cref="T:System.Runtime.InteropServices.ComTypes.STATDATA" /> references to return in <paramref name="rgelt" />.</param>
         <param name="rgelt">
@@ -96,7 +99,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information about IEnumSTATDATA::Reset, see the MSDN Library.</para>
@@ -105,6 +107,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resets the enumeration sequence to the beginning.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An HRESULT with the value S_OK.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Skip">
@@ -122,7 +128,6 @@
         <Parameter Name="celt" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information about IEnumSTATDATA::Skip, see the MSDN Library.</para>
@@ -131,6 +136,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Skips a specified number of items in the enumeration sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>S_OK if the number of elements skipped equals the <paramref name="celt" /> parameter; otherwise, S_FALSE.</para>
+        </returns>
         <param name="celt">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of elements to skip in the enumeration.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Runtime.Versioning/FrameworkName.xml b/mcs/class/System/Documentation/en/System.Runtime.Versioning/FrameworkName.xml
index babdc2016af..27747f59c81 100644
--- a/mcs/class/System/Documentation/en/System.Runtime.Versioning/FrameworkName.xml
+++ b/mcs/class/System/Documentation/en/System.Runtime.Versioning/FrameworkName.xml
@@ -183,7 +183,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method converts <paramref name="obj" /> to a <see cref="T:System.Runtime.Versioning.FrameworkName" /> object and calls the <see cref="M:System.Runtime.Versioning.FrameworkName.Equals(System.Runtime.Versioning.FrameworkName)" /> overload to test for equality. If the conversion does not succeed or if <paramref name="obj" /> is null, the method returns false.</para>
@@ -192,6 +191,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether this <see cref="T:System.Runtime.Versioning.FrameworkName" /> instance represents the same .NET Framework version as a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if every component of the current <see cref="T:System.Runtime.Versioning.FrameworkName" /> object matches the corresponding component of <paramref name="obj" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to the current instance.</param>
       </Docs>
@@ -210,7 +213,6 @@
         <Parameter Name="other" Type="System.Runtime.Versioning.FrameworkName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method tests for equality by returning the result of the following comparisons:</para>
@@ -230,6 +232,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether this <see cref="T:System.Runtime.Versioning.FrameworkName" /> instance represents the same .NET Framework version as a specified <see cref="T:System.Runtime.Versioning.FrameworkName" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if every component of the current <see cref="T:System.Runtime.Versioning.FrameworkName" /> object matches the corresponding component of <paramref name="other" />; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to the current instance.</param>
       </Docs>
@@ -271,12 +277,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for the <see cref="T:System.Runtime.Versioning.FrameworkName" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer that represents the hash code of this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Identifier">
@@ -316,7 +325,6 @@
         <Parameter Name="right" Type="System.Runtime.Versioning.FrameworkName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Runtime.Versioning.FrameworkName.op_Equality(System.Runtime.Versioning.FrameworkName,System.Runtime.Versioning.FrameworkName)" /> method defines the operation of the equality operator for <see cref="T:System.Runtime.Versioning.FrameworkName" /> objects. </para>
@@ -326,6 +334,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether two <see cref="T:System.Runtime.Versioning.FrameworkName" /> objects represent the same .NET Framework version.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="left" /> and <paramref name="right" /> parameters represent the same .NET Framework version; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare.</param>
         <param name="right">
@@ -347,7 +359,6 @@
         <Parameter Name="right" Type="System.Runtime.Versioning.FrameworkName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Runtime.Versioning.FrameworkName.op_Inequality(System.Runtime.Versioning.FrameworkName,System.Runtime.Versioning.FrameworkName)" /> method defines the operation of the inequality operator for <see cref="T:System.Runtime.Versioning.FrameworkName" /> objects. </para>
@@ -357,6 +368,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether two <see cref="T:System.Runtime.Versioning.FrameworkName" /> objects represent different .NET Framework versions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="left" /> and <paramref name="right" /> parameters represent different .NET Framework versions; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare.</param>
         <param name="right">
@@ -397,7 +412,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The string returned by the <see cref="M:System.Runtime.Versioning.FrameworkName.ToString" /> method has the following format:</para>
@@ -409,6 +423,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the string representation of this <see cref="T:System.Runtime.Versioning.FrameworkName" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents this <see cref="T:System.Runtime.Versioning.FrameworkName" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Version">
diff --git a/mcs/class/System/Documentation/en/System.Security.AccessControl/SemaphoreSecurity.xml b/mcs/class/System/Documentation/en/System.Security.AccessControl/SemaphoreSecurity.xml
index 5f9caedc6e9..134cfafecc8 100644
--- a/mcs/class/System/Documentation/en/System.Security.AccessControl/SemaphoreSecurity.xml
+++ b/mcs/class/System/Documentation/en/System.Security.AccessControl/SemaphoreSecurity.xml
@@ -165,7 +165,6 @@
         <Parameter Name="type" Type="System.Security.AccessControl.AccessControlType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -178,6 +177,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new access control rule for the specified user, with the specified access rights, access control, and flags.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.AccessControl.SemaphoreAccessRule" /> object representing the specified rights for the specified user.</para>
+        </returns>
         <param name="identityReference">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Security.Principal.IdentityReference" /> that identifies the user or group the rule applies to.</param>
         <param name="accessMask">
@@ -292,7 +295,6 @@
         <Parameter Name="flags" Type="System.Security.AccessControl.AuditFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -305,6 +307,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new audit rule, specifying the user the rule applies to, the access rights to audit, and the outcome that triggers the audit rule.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.AccessControl.SemaphoreAuditRule" /> object representing the specified audit rule for the specified user. The return type of the method is the base class, <see cref="T:System.Security.AccessControl.AuditRule" />, but the return value can be cast safely to the derived class.</para>
+        </returns>
         <param name="identityReference">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Security.Principal.IdentityReference" /> that identifies the user or group the rule applies to.</param>
         <param name="accessMask">
@@ -358,7 +364,6 @@
         <Parameter Name="rule" Type="System.Security.AccessControl.SemaphoreAccessRule" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -371,6 +376,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for an access control rule with the same user and <see cref="T:System.Security.AccessControl.AccessControlType" /> (allow or deny) as the specified rule, and with compatible inheritance and propagation flags; if such a rule is found, the rights contained in the specified access rule are removed from it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a compatible rule is found; otherwise false.</para>
+        </returns>
         <param name="rule">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Security.AccessControl.SemaphoreAccessRule" /> that specifies the user and <see cref="T:System.Security.AccessControl.AccessControlType" /> to search for, and a set of inheritance and propagation flags that a matching rule, if found, must be compatible with. Specifies the rights to remove from the compatible rule, if found.</param>
       </Docs>
@@ -449,7 +458,6 @@
         <Parameter Name="rule" Type="System.Security.AccessControl.SemaphoreAuditRule" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -462,6 +470,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for an audit control rule with the same user as the specified rule, and with compatible inheritance and propagation flags; if a compatible rule is found, the rights contained in the specified rule are removed from it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a compatible rule is found; otherwise, false.</para>
+        </returns>
         <param name="rule">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Security.AccessControl.SemaphoreAuditRule" /> that specifies the user to search for, and a set of inheritance and propagation flags that a matching rule, if found, must be compatible with. Specifies the rights to remove from the compatible rule, if found.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Security.Authentication.ExtendedProtection.Configuration/ExtendedProtectionPolicyElement.xml b/mcs/class/System/Documentation/en/System.Security.Authentication.ExtendedProtection.Configuration/ExtendedProtectionPolicyElement.xml
index 006916cf785..5c54070e336 100644
--- a/mcs/class/System/Documentation/en/System.Security.Authentication.ExtendedProtection.Configuration/ExtendedProtectionPolicyElement.xml
+++ b/mcs/class/System/Documentation/en/System.Security.Authentication.ExtendedProtection.Configuration/ExtendedProtectionPolicyElement.xml
@@ -58,7 +58,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The properties on the <see cref="T:System.Security.Authentication.ExtendedProtection.Configuration.ExtendedProtectionPolicyElement" /> class instance must be set before calling the <see cref="M:System.Security.Authentication.ExtendedProtection.Configuration.ExtendedProtectionPolicyElement.BuildPolicy" /> method.</para>
@@ -67,6 +66,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Security.Authentication.ExtendedProtection.Configuration.ExtendedProtectionPolicyElement.BuildPolicy" /> method builds a new <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy" /> instance based on the properties set on the <see cref="T:System.Security.Authentication.ExtendedProtection.Configuration.ExtendedProtectionPolicyElement" /> class. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy" /> instance that represents the extended protection policy created.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CustomServiceNames">
diff --git a/mcs/class/System/Documentation/en/System.Security.Authentication.ExtendedProtection.Configuration/ServiceNameElementCollection.xml b/mcs/class/System/Documentation/en/System.Security.Authentication.ExtendedProtection.Configuration/ServiceNameElementCollection.xml
index a02d937065a..9d2e4765dee 100644
--- a/mcs/class/System/Documentation/en/System.Security.Authentication.ExtendedProtection.Configuration/ServiceNameElementCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Security.Authentication.ExtendedProtection.Configuration/ServiceNameElementCollection.xml
@@ -136,12 +136,15 @@
         <Parameter Name="element" Type="System.Security.Authentication.ExtendedProtection.Configuration.ServiceNameElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Security.Authentication.ExtendedProtection.Configuration.ServiceNameElementCollection.IndexOf(System.Security.Authentication.ExtendedProtection.Configuration.ServiceNameElement)" /> method retrieves the index of the specified configuration element in this <see cref="T:System.Security.Authentication.ExtendedProtection.Configuration.ServiceNameElementCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified <see cref="T:System.Security.Authentication.ExtendedProtection.Configuration.ServiceNameElement" /> in this <see cref="T:System.Security.Authentication.ExtendedProtection.Configuration.ServiceNameElementCollection" />.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Authentication.ExtendedProtection.Configuration.ServiceNameElement" /> instance to retrieve the index of in this <see cref="T:System.Security.Authentication.ExtendedProtection.Configuration.ServiceNameElementCollection" />.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Security.Authentication.ExtendedProtection/ExtendedProtectionPolicy.xml b/mcs/class/System/Documentation/en/System.Security.Authentication.ExtendedProtection/ExtendedProtectionPolicy.xml
index c3c3e303781..ee9bca9e37c 100644
--- a/mcs/class/System/Documentation/en/System.Security.Authentication.ExtendedProtection/ExtendedProtectionPolicy.xml
+++ b/mcs/class/System/Documentation/en/System.Security.Authentication.ExtendedProtection/ExtendedProtectionPolicy.xml
@@ -328,12 +328,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a string representation for the extended protection policy instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> instance that contains the representation of the <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.Security.Authentication.ExtendedProtection/ExtendedProtectionPolicyTypeConverter.xml b/mcs/class/System/Documentation/en/System.Security.Authentication.ExtendedProtection/ExtendedProtectionPolicyTypeConverter.xml
index f32de354706..82eb47a3570 100644
--- a/mcs/class/System/Documentation/en/System.Security.Authentication.ExtendedProtection/ExtendedProtectionPolicyTypeConverter.xml
+++ b/mcs/class/System/Documentation/en/System.Security.Authentication.ExtendedProtection/ExtendedProtectionPolicyTypeConverter.xml
@@ -57,12 +57,15 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether this converter can convert the object to the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this converter can perform the conversion; otherwise false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to convert.</param>
         <param name="destinationType">
@@ -86,7 +89,6 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <paramref name="context" /> parameter to extract additional information about the environment from which this converter is invoked. This parameter can be null, so always check it. Also, properties on the <paramref name="context" /> object can return null.</para>
@@ -95,6 +97,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Convert the object to the specified type</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted <paramref name="value" /> parameter.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
         <param name="culture">
diff --git a/mcs/class/System/Documentation/en/System.Security.Authentication.ExtendedProtection/ServiceNameCollection.xml b/mcs/class/System/Documentation/en/System.Security.Authentication.ExtendedProtection/ServiceNameCollection.xml
index 3ba9c55f46c..c1befd90428 100644
--- a/mcs/class/System/Documentation/en/System.Security.Authentication.ExtendedProtection/ServiceNameCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Security.Authentication.ExtendedProtection/ServiceNameCollection.xml
@@ -63,7 +63,6 @@
         <Parameter Name="serviceNames" Type="System.Collections.IEnumerable" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection" /> class that is initialized contains the specified values passed in the <paramref name="items" /> parameter.</para>
@@ -72,6 +71,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Merges the current <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection" /> with the specified values to create a new <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection" /> containing the union.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection" /> instance that contains the union of the existing <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection" /> instance merged with the specified values.</para>
+        </returns>
         <param name="serviceNames">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of the <see cref="T:System.Collections.IEnumerable" /> class that contains the specified values of service names to be merged.</param>
       </Docs>
@@ -90,7 +93,6 @@
         <Parameter Name="serviceName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection" /> class that is initialized contains the specified values passed in the <paramref name="items" /> parameter.</para>
@@ -99,6 +101,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Merges the current <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection" /> with the specified values to create a new <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection" /> containing the union.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection" /> instance that contains the union of the existing <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection" /> instance merged with the specified values.</para>
+        </returns>
         <param name="serviceName">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the specified values of service names to be used to initialize the class.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X500DistinguishedName.xml b/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X500DistinguishedName.xml
index 33566fa6d60..283a30c34a6 100644
--- a/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X500DistinguishedName.xml
+++ b/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X500DistinguishedName.xml
@@ -230,7 +230,6 @@
         <Parameter Name="flag" Type="System.Security.Cryptography.X509Certificates.X500DistinguishedNameFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -240,6 +239,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes a distinguished name using the characteristics specified by the <paramref name="flag" /> parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The decoded distinguished name.</para>
+        </returns>
         <param name="flag">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of the enumeration values that specify the characteristics of the distinguished name.</param>
       </Docs>
@@ -259,7 +262,6 @@
         <Parameter Name="multiLine" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -269,6 +271,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a formatted version of an X500 distinguished name for printing or for output to a text window or to a console.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A formatted string that represents the X500 distinguished name.</para>
+        </returns>
         <param name="multiLine">
           <attribution license="cc4" from="Microsoft" modified="false" />true if the return string should contain carriage returns; otherwise, false.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509Certificate2.xml b/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509Certificate2.xml
index 3d0b60e6405..e220ad99792 100644
--- a/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509Certificate2.xml
+++ b/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509Certificate2.xml
@@ -508,7 +508,6 @@
         <Parameter Name="rawData" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -518,6 +517,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates the type of certificate contained in a byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.Cryptography.X509Certificates.X509ContentType" /> object.</para>
+        </returns>
         <param name="rawData">
           <attribution license="cc4" from="Microsoft" modified="false" />A byte array containing data from an X.509 certificate. </param>
       </Docs>
@@ -542,7 +545,6 @@
         <Parameter Name="fileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -552,6 +554,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates the type of certificate contained in a file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.Cryptography.X509Certificates.X509ContentType" /> object.</para>
+        </returns>
         <param name="fileName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a certificate file. </param>
       </Docs>
@@ -577,7 +583,6 @@
         <Parameter Name="forIssuer" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -587,6 +592,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the subject and issuer names from a certificate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the certificate.</para>
+        </returns>
         <param name="nameType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Cryptography.X509Certificates.X509NameType" /> value for the subject. </param>
         <param name="forIssuer">
@@ -1118,7 +1127,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1129,6 +1137,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays an X.509 certificate in text format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The certificate information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -1146,7 +1158,6 @@
         <Parameter Name="verbose" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1157,6 +1168,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Displays an X.509 certificate in text format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The certificate information.</para>
+        </returns>
         <param name="verbose">
           <attribution license="cc4" from="Microsoft" modified="false" />true to display the public key, private key, extensions, and so forth; false to display information that is similar to the <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate2" /> class, including thumbprint, serial number, subject and issuer names, and so on. </param>
       </Docs>
@@ -1179,7 +1194,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1190,6 +1204,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a X.509 chain validation using basic validation policy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the validation succeeds; false if the validation fails.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Version">
diff --git a/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509Certificate2Collection.xml b/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509Certificate2Collection.xml
index 72dcb21bc3c..3faa0783229 100644
--- a/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509Certificate2Collection.xml
+++ b/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509Certificate2Collection.xml
@@ -125,7 +125,6 @@
         <Parameter Name="certificate" Type="System.Security.Cryptography.X509Certificates.X509Certificate2" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -135,6 +134,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an object to the end of the <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate2Collection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate2Collection" /> index at which the <paramref name="certificate" /> has been added.</para>
+        </returns>
         <param name="certificate">
           <attribution license="cc4" from="Microsoft" modified="false" />An X.509 certificate represented as an <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate2" /> object. </param>
       </Docs>
@@ -220,7 +223,6 @@
         <Parameter Name="certificate" Type="System.Security.Cryptography.X509Certificates.X509Certificate2" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -231,6 +233,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate2Collection" /> object contains a specific certificate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate2Collection" /> contains the specified <paramref name="certificate" />; otherwise, false.</para>
+        </returns>
         <param name="certificate">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate2" /> object to locate in the collection. </param>
       </Docs>
@@ -255,7 +261,6 @@
         <Parameter Name="contentType" Type="System.Security.Cryptography.X509Certificates.X509ContentType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -265,6 +270,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Exports X.509 certificate information into a byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>X.509 certificate information in a byte array.</para>
+        </returns>
         <param name="contentType">
           <attribution license="cc4" from="Microsoft" modified="false" />A supported <see cref="T:System.Security.Cryptography.X509Certificates.X509ContentType" /> object. </param>
       </Docs>
@@ -290,7 +299,6 @@
         <Parameter Name="password" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -322,6 +330,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Exports X.509 certificate information into a byte array using a password.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>X.509 certificate information in a byte array.</para>
+        </returns>
         <param name="contentType">
           <attribution license="cc4" from="Microsoft" modified="false" />A supported <see cref="T:System.Security.Cryptography.X509Certificates.X509ContentType" /> object. </param>
         <param name="password">
@@ -350,7 +362,6 @@
         <Parameter Name="validOnly" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -361,6 +372,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches an <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate2Collection" /> object using the search criteria specified by the <see cref="T:System.Security.Cryptography.X509Certificates.X509FindType" /> enumeration and the <paramref name="findValue" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate2Collection" /> object.</para>
+        </returns>
         <param name="findType">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Security.Cryptography.X509Certificates.X509FindType" />  values. </param>
         <param name="findValue">
@@ -382,7 +397,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -392,6 +406,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that can iterate through a <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate2Collection" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate2Enumerator" /> object that can iterate through the <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate2Collection" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Import">
diff --git a/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509Certificate2Enumerator.xml b/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509Certificate2Enumerator.xml
index 180530b41aa..bd419395800 100644
--- a/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509Certificate2Enumerator.xml
+++ b/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509Certificate2Enumerator.xml
@@ -67,7 +67,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -77,6 +76,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the enumerator to the next element in the <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate2Collection" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Reset">
@@ -139,7 +142,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate2Enumerator" /> instance is cast to an <see cref="T:System.Collections.IEnumerator" /> interface.</para>
@@ -148,6 +150,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Collections.IEnumerator.MoveNext" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IEnumerator.Reset">
diff --git a/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509CertificateCollection.xml b/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509CertificateCollection.xml
index 718f3b4a518..fe01d9f516c 100644
--- a/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509CertificateCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509CertificateCollection.xml
@@ -105,12 +105,15 @@
         <Parameter Name="value" Type="System.Security.Cryptography.X509Certificates.X509Certificate" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate" /> with the specified value to the current <see cref="T:System.Security.Cryptography.X509Certificates.X509CertificateCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index into the current <see cref="T:System.Security.Cryptography.X509Certificates.X509CertificateCollection" /> at which the new <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate" /> was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate" /> to add to the current <see cref="T:System.Security.Cryptography.X509Certificates.X509CertificateCollection" />. </param>
       </Docs>
@@ -181,12 +184,15 @@
         <Parameter Name="value" Type="System.Security.Cryptography.X509Certificates.X509Certificate" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the current <see cref="T:System.Security.Cryptography.X509Certificates.X509CertificateCollection" /> contains the specified <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate" /> is contained in this collection; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate" /> to locate. </param>
       </Docs>
@@ -233,12 +239,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'X509CertificateCollection+X509CertificateEnumerator'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that can iterate through the <see cref="T:System.Security.Cryptography.X509Certificates.X509CertificateCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator of the subelements of <see cref="T:System.Security.Cryptography.X509Certificates.X509CertificateCollection" /> you can use to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -255,12 +264,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds a hash value based on all values contained in the current <see cref="T:System.Security.Cryptography.X509Certificates.X509CertificateCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash value based on all values contained in the current <see cref="T:System.Security.Cryptography.X509Certificates.X509CertificateCollection" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IndexOf">
@@ -279,12 +291,15 @@
         <Parameter Name="value" Type="System.Security.Cryptography.X509Certificates.X509Certificate" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the index of the specified <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate" /> in the current <see cref="T:System.Security.Cryptography.X509Certificates.X509CertificateCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate" /> specified by the <paramref name="value" /> parameter in the <see cref="T:System.Security.Cryptography.X509Certificates.X509CertificateCollection" />, if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate" /> to locate. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509Chain.xml b/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509Chain.xml
index 38466b55cff..f71d1598d9b 100644
--- a/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509Chain.xml
+++ b/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509Chain.xml
@@ -116,7 +116,6 @@
         <Parameter Name="certificate" Type="System.Security.Cryptography.X509Certificates.X509Certificate2" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -126,6 +125,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds an X.509 chain using the policy specified in <see cref="T:System.Security.Cryptography.X509Certificates.X509ChainPolicy" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the X.509 certificate is valid; otherwise, false.</para>
+        </returns>
         <param name="certificate">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate2" /> object.</param>
       </Docs>
@@ -245,7 +248,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -255,6 +257,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Security.Cryptography.X509Certificates.X509Chain" /> object after querying for the mapping defined in the CryptoConfig file, and maps the chain to that mapping.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.Cryptography.X509Certificates.X509Chain" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Reset">
diff --git a/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509ChainElementCollection.xml b/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509ChainElementCollection.xml
index 72f90d8e9b1..6cca84cb8aa 100644
--- a/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509ChainElementCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509ChainElementCollection.xml
@@ -92,7 +92,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -102,6 +101,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <see cref="T:System.Security.Cryptography.X509Certificates.X509ChainElementEnumerator" /> object that can be used to navigate through a collection of chain elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.Cryptography.X509Certificates.X509ChainElementEnumerator" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsSynchronized">
@@ -214,7 +217,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns an enumerator interface.</para>
@@ -223,6 +225,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <see cref="T:System.Collections.IEnumerator" /> object that can be used to navigate a collection of chain elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> object.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509ChainElementEnumerator.xml b/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509ChainElementEnumerator.xml
index 8e6d362aa82..d207d5e687c 100644
--- a/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509ChainElementEnumerator.xml
+++ b/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509ChainElementEnumerator.xml
@@ -67,7 +67,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -77,6 +76,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the enumerator to the next element in the <see cref="T:System.Security.Cryptography.X509Certificates.X509ChainElementCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Reset">
diff --git a/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509ExtensionCollection.xml b/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509ExtensionCollection.xml
index 44ff1deec16..5437b4ab74f 100644
--- a/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509ExtensionCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509ExtensionCollection.xml
@@ -60,7 +60,6 @@
         <Parameter Name="extension" Type="System.Security.Cryptography.X509Certificates.X509Extension" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -70,6 +69,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an <see cref="T:System.Security.Cryptography.X509Certificates.X509Extension" /> object to an <see cref="T:System.Security.Cryptography.X509Certificates.X509ExtensionCollection" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the <paramref name="extension" /> parameter was added.</para>
+        </returns>
         <param name="extension">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Security.Cryptography.X509Certificates.X509Extension" />  object to add to the <see cref="T:System.Security.Cryptography.X509Certificates.X509ExtensionCollection" /> object. </param>
       </Docs>
@@ -136,7 +139,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -146,6 +148,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that can iterate through an <see cref="T:System.Security.Cryptography.X509Certificates.X509ExtensionCollection" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.Cryptography.X509Certificates.X509ExtensionEnumerator" /> object to use to iterate through the <see cref="T:System.Security.Cryptography.X509Certificates.X509ExtensionCollection" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsSynchronized">
@@ -281,7 +287,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Enumerators allow read-only access to data in the collection and cannot be used to modify the underlying collection.</para>
@@ -290,6 +295,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that can iterate through an <see cref="T:System.Security.Cryptography.X509Certificates.X509ExtensionCollection" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> object to use to iterate through the <see cref="T:System.Security.Cryptography.X509Certificates.X509ExtensionCollection" /> object.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509ExtensionEnumerator.xml b/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509ExtensionEnumerator.xml
index a52ac8ad7d2..b296aeb2080 100644
--- a/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509ExtensionEnumerator.xml
+++ b/mcs/class/System/Documentation/en/System.Security.Cryptography.X509Certificates/X509ExtensionEnumerator.xml
@@ -67,7 +67,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -77,6 +76,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the enumerator to the next element in the <see cref="T:System.Security.Cryptography.X509Certificates.X509ExtensionCollection" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Reset">
diff --git a/mcs/class/System/Documentation/en/System.Security.Cryptography/AsnEncodedData.xml b/mcs/class/System/Documentation/en/System.Security.Cryptography/AsnEncodedData.xml
index 111c90eaa74..a569d96f7a4 100644
--- a/mcs/class/System/Documentation/en/System.Security.Cryptography/AsnEncodedData.xml
+++ b/mcs/class/System/Documentation/en/System.Security.Cryptography/AsnEncodedData.xml
@@ -182,7 +182,6 @@
         <Parameter Name="multiLine" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -192,6 +191,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a formatted version of the Abstract Syntax Notation One (ASN.1)-encoded data as a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A formatted string that represents the Abstract Syntax Notation One (ASN.1)-encoded data.</para>
+        </returns>
         <param name="multiLine">
           <attribution license="cc4" from="Microsoft" modified="false" />true if the return string should contain carriage returns; otherwise, false.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Security.Cryptography/AsnEncodedDataCollection.xml b/mcs/class/System/Documentation/en/System.Security.Cryptography/AsnEncodedDataCollection.xml
index ede99a186f6..32416cc8536 100644
--- a/mcs/class/System/Documentation/en/System.Security.Cryptography/AsnEncodedDataCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Security.Cryptography/AsnEncodedDataCollection.xml
@@ -82,13 +82,16 @@
         <Parameter Name="asnEncodedData" Type="System.Security.Cryptography.AsnEncodedData" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an <see cref="T:System.Security.Cryptography.AsnEncodedData" /> object to the <see cref="T:System.Security.Cryptography.AsnEncodedDataCollection" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the added <see cref="T:System.Security.Cryptography.AsnEncodedData" /> object.</para>
+        </returns>
         <param name="asnEncodedData">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Cryptography.AsnEncodedData" /> object to add to the collection.</param>
       </Docs>
@@ -161,7 +164,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -171,6 +173,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Security.Cryptography.AsnEncodedDataEnumerator" /> object that can be used to navigate the <see cref="T:System.Security.Cryptography.AsnEncodedDataCollection" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.Cryptography.AsnEncodedDataEnumerator" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsSynchronized">
@@ -312,7 +318,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Security.Cryptography.AsnEncodedDataEnumerator" /> class implements the <see cref="T:System.Collections.IEnumerator" /> interface, which allows you to move within a collection.</para>
@@ -321,6 +326,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Security.Cryptography.AsnEncodedDataEnumerator" /> object that can be used to navigate the <see cref="T:System.Security.Cryptography.AsnEncodedDataCollection" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.Cryptography.AsnEncodedDataEnumerator" /> object that can be used to navigate the collection.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.Security.Cryptography/AsnEncodedDataEnumerator.xml b/mcs/class/System/Documentation/en/System.Security.Cryptography/AsnEncodedDataEnumerator.xml
index e159732db46..cde46d7ffb3 100644
--- a/mcs/class/System/Documentation/en/System.Security.Cryptography/AsnEncodedDataEnumerator.xml
+++ b/mcs/class/System/Documentation/en/System.Security.Cryptography/AsnEncodedDataEnumerator.xml
@@ -68,7 +68,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -80,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances to the next <see cref="T:System.Security.Cryptography.AsnEncodedData" /> object in an <see cref="T:System.Security.Cryptography.AsnEncodedDataCollection" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if the enumerator was successfully advanced to the next element; false, if the enumerator has passed the end of the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Reset">
diff --git a/mcs/class/System/Documentation/en/System.Security.Cryptography/OidCollection.xml b/mcs/class/System/Documentation/en/System.Security.Cryptography/OidCollection.xml
index d968e9966ab..9d1f0289e72 100644
--- a/mcs/class/System/Documentation/en/System.Security.Cryptography/OidCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Security.Cryptography/OidCollection.xml
@@ -63,7 +63,6 @@
         <Parameter Name="oid" Type="System.Security.Cryptography.Oid" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -73,6 +72,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an <see cref="T:System.Security.Cryptography.Oid" /> object to the <see cref="T:System.Security.Cryptography.OidCollection" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the added <see cref="T:System.Security.Cryptography.Oid" /> object.</para>
+        </returns>
         <param name="oid">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Cryptography.Oid" /> object to add to the collection.</param>
       </Docs>
@@ -142,7 +145,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -152,6 +154,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Security.Cryptography.OidEnumerator" /> object that can be used to navigate the <see cref="T:System.Security.Cryptography.OidCollection" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.Cryptography.OidEnumerator" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsSynchronized">
@@ -290,7 +296,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Security.Cryptography.OidEnumerator" /> class implements the <see cref="T:System.Collections.IEnumerator" /> interface, which allows you to move within a collection.</para>
@@ -299,6 +304,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Security.Cryptography.OidEnumerator" /> object that can be used to navigate the <see cref="T:System.Security.Cryptography.OidCollection" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.Cryptography.OidEnumerator" /> object that can be used to navigate the collection.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.Security.Cryptography/OidEnumerator.xml b/mcs/class/System/Documentation/en/System.Security.Cryptography/OidEnumerator.xml
index dcd79ad2aa2..324bfef90e0 100644
--- a/mcs/class/System/Documentation/en/System.Security.Cryptography/OidEnumerator.xml
+++ b/mcs/class/System/Documentation/en/System.Security.Cryptography/OidEnumerator.xml
@@ -68,7 +68,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -80,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances to the next <see cref="T:System.Security.Cryptography.Oid" /> object in an <see cref="T:System.Security.Cryptography.OidCollection" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if the enumerator was successfully advanced to the next element; false, if the enumerator has passed the end of the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Reset">
diff --git a/mcs/class/System/Documentation/en/System.Security.Permissions/ResourcePermissionBase.xml b/mcs/class/System/Documentation/en/System.Security.Permissions/ResourcePermissionBase.xml
index c088a637cb4..f604c04b086 100644
--- a/mcs/class/System/Documentation/en/System.Security.Permissions/ResourcePermissionBase.xml
+++ b/mcs/class/System/Documentation/en/System.Security.Permissions/ResourcePermissionBase.xml
@@ -158,7 +158,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Security.IPermission'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A copy of the permission object represents the same access to resources as the original permission object.</para>
@@ -167,6 +166,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an identical copy of the current permission object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current permission object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="FromXml">
@@ -213,7 +216,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ResourcePermissionBaseEntry []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use <see cref="M:System.Security.Permissions.ResourcePermissionBase.AddPermissionAccess(System.Security.Permissions.ResourcePermissionBaseEntry)" /> and <see cref="M:System.Security.Permissions.ResourcePermissionBase.RemovePermissionAccess(System.Security.Permissions.ResourcePermissionBaseEntry)" /> to add and remove permission entries to this permission.</para>
@@ -222,6 +224,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of the <see cref="T:System.Security.Permissions.ResourcePermissionBaseEntry" /> objects added to this permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Security.Permissions.ResourcePermissionBaseEntry" /> objects that were added to this permission.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Intersect">
@@ -240,7 +246,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Security.IPermission'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The intersection of two permission objects is a permission that describes the set of operations they both hold in common. Specifically, it represents the minimum permissions required for a demand to pass both permissions.</para>
@@ -249,6 +254,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a permission object that is the intersection of the current permission object and a target permission object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission object that represents the intersection of the current object and the specified target. This object is null if the intersection is empty.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission object of the same type as the current permission object. </param>
       </Docs>
@@ -269,7 +278,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current permission object is a subset of the specified permission object if the current permission object specifies a set of operations that is wholly contained by the specified permission object. For example, a permission that represents access to C:\Example.txt is a subset of a permission that represents access to C:\. If this method returns true, the current permission object represents no more access to the protected resource than does the specified permission object.</para>
@@ -279,6 +287,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current permission object is a subset of the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission object is a subset of the specified permission object; otherwise, false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission object that is to be tested for the subset relationship. </param>
       </Docs>
@@ -297,7 +309,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An unrestricted permission object represents access to any and all resources protected by the permission.</para>
@@ -306,6 +317,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the permission is unrestricted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if permission is unrestricted; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Local">
@@ -413,12 +428,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Security.SecurityElement'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an XML encoding of the security object and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the security object, including any state information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Union">
@@ -437,7 +455,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Security.IPermission'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The result of a call to <see cref="M:System.Security.Permissions.ResourcePermissionBase.Union(System.Security.IPermission)" /> is a permission that represents all the operations represented by both the current permission object and the specified permission object. Any demand that passes either permission passes their union.</para>
@@ -446,6 +463,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a permission object that combines the current permission object and the target permission object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission object that represents the union of the current permission object and the specified permission object.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission object to combine with the current permission object. It must be of the same type as the current permission object. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Security.Permissions/StorePermission.xml b/mcs/class/System/Documentation/en/System.Security.Permissions/StorePermission.xml
index 0c5c2745fdd..06c865eb554 100644
--- a/mcs/class/System/Documentation/en/System.Security.Permissions/StorePermission.xml
+++ b/mcs/class/System/Documentation/en/System.Security.Permissions/StorePermission.xml
@@ -90,7 +90,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -100,6 +99,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an identical copy of the current permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current permission.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Flags">
@@ -168,7 +171,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -178,6 +180,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a permission that is the intersection of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the intersection of the current permission and the specified permission. This new permission is null if the intersection is empty.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to intersect with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
@@ -197,7 +203,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -207,6 +212,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current permission is a subset of the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is a subset of the specified permission; otherwise, false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to test for the subset relationship. This permission must be of the same type as the current permission. </param>
       </Docs>
@@ -224,7 +233,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -234,6 +242,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the current permission is unrestricted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is unrestricted; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToXml">
@@ -249,7 +261,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -259,6 +270,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the permission and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.SecurityElement" /> that contains an XML encoding of the permission, including any state information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Union">
@@ -276,7 +291,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -286,6 +300,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a permission that is the union of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the union of the current permission and the specified permission.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to combine with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Security.Permissions/StorePermissionAttribute.xml b/mcs/class/System/Documentation/en/System.Security.Permissions/StorePermissionAttribute.xml
index dc90311f993..763cb01e27d 100644
--- a/mcs/class/System/Documentation/en/System.Security.Permissions/StorePermissionAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.Security.Permissions/StorePermissionAttribute.xml
@@ -88,7 +88,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -99,6 +98,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new <see cref="T:System.Security.Permissions.StorePermission" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Permissions.StorePermission" /> that corresponds to the attribute.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateStore">
diff --git a/mcs/class/System/Documentation/en/System.Text.RegularExpressions/Capture.xml b/mcs/class/System/Documentation/en/System.Text.RegularExpressions/Capture.xml
index 9fc6776e8b9..055fa36e4d7 100644
--- a/mcs/class/System/Documentation/en/System.Text.RegularExpressions/Capture.xml
+++ b/mcs/class/System/Documentation/en/System.Text.RegularExpressions/Capture.xml
@@ -83,7 +83,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>ToString is actually an internal call to the <see cref="P:System.Text.RegularExpressions.Capture.Value" /> property.</para>
@@ -92,6 +91,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the captured substring from the input string by calling the <see cref="P:System.Text.RegularExpressions.Capture.Value" /> property. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The substring that was captured by the match.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/System/Documentation/en/System.Text.RegularExpressions/CaptureCollection.xml b/mcs/class/System/Documentation/en/System.Text.RegularExpressions/CaptureCollection.xml
index 69c73e576bb..6e0859e797a 100644
--- a/mcs/class/System/Documentation/en/System.Text.RegularExpressions/CaptureCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Text.RegularExpressions/CaptureCollection.xml
@@ -109,7 +109,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Instead of calling the <see cref="M:System.Text.RegularExpressions.GroupCollection.GetEnumerator" /> method to retrieve an enumerator that lets you iterate through the <see cref="T:System.Text.RegularExpressions.Group" /> objects in the collection, you should use the group iteration construct (such as foreach in C# and For Each…Next in Visual Basic) that is provided by your programming language.</para>
@@ -118,6 +117,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides an enumerator that iterates through the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that contains all <see cref="T:System.Text.RegularExpressions.Capture" /> objects within the <see cref="T:System.Text.RegularExpressions.CaptureCollection" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsReadOnly">
diff --git a/mcs/class/System/Documentation/en/System.Text.RegularExpressions/Group.xml b/mcs/class/System/Documentation/en/System.Text.RegularExpressions/Group.xml
index 581b7b375dd..ac069c3e0ae 100644
--- a/mcs/class/System/Documentation/en/System.Text.RegularExpressions/Group.xml
+++ b/mcs/class/System/Documentation/en/System.Text.RegularExpressions/Group.xml
@@ -161,12 +161,15 @@
         <Parameter Name="inner" Type="System.Text.RegularExpressions.Group" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Group'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Group object equivalent to the one supplied that is safe to share between multiple threads.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A regular expression Group object. </para>
+        </returns>
         <param name="inner">
           <attribution license="cc4" from="Microsoft" modified="false" />The input <see cref="T:System.Text.RegularExpressions.Group" /> object.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Text.RegularExpressions/GroupCollection.xml b/mcs/class/System/Documentation/en/System.Text.RegularExpressions/GroupCollection.xml
index 7266219ab0d..f85137175d3 100644
--- a/mcs/class/System/Documentation/en/System.Text.RegularExpressions/GroupCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Text.RegularExpressions/GroupCollection.xml
@@ -104,7 +104,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Instead of calling the <see cref="M:System.Text.RegularExpressions.GroupCollection.GetEnumerator" /> method to retrieve an enumerator that lets you iterate through the <see cref="T:System.Text.RegularExpressions.Group" /> objects in the collection, you should use the group iteration construct (such as foreach in C# and For Each…Next in Visual Basic) that is provided by your programming language.</para>
@@ -113,6 +112,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides an enumerator that iterates through the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator that contains all <see cref="T:System.Text.RegularExpressions.Group" /> objects in the <see cref="T:System.Text.RegularExpressions.GroupCollection" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsReadOnly">
diff --git a/mcs/class/System/Documentation/en/System.Text.RegularExpressions/Match.xml b/mcs/class/System/Documentation/en/System.Text.RegularExpressions/Match.xml
index c982bc6e461..c1419b7ed60 100644
--- a/mcs/class/System/Documentation/en/System.Text.RegularExpressions/Match.xml
+++ b/mcs/class/System/Documentation/en/System.Text.RegularExpressions/Match.xml
@@ -95,7 +95,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Match'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is similar to calling <see cref="M:System.Text.RegularExpressions.Regex.Match(System.String,System.Int32)" /> again and passing (Index+Length) as the new starting position. </para>
@@ -108,6 +107,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new <see cref="T:System.Text.RegularExpressions.Match" /> object with the results for the next match, starting at the position at which the last match ended (at the character after the last matched character).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The next regular expression match.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Result">
@@ -126,7 +129,6 @@
         <Parameter Name="replacement" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Whereas the <see cref="M:System.Text.RegularExpressions.Regex.Replace(System.String,System.String)" /> method replaces all matches in an input string with a specified replacement pattern, the <see cref="M:System.Text.RegularExpressions.Match.Result(System.String)" /> method replaces a single match with a specified replacement pattern. Because it operates on an individual match, it is also possible to perform processing on the matched string before you call the <see cref="M:System.Text.RegularExpressions.Match.Result(System.String)" /> method.</para>
@@ -136,6 +138,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the expansion of the specified replacement pattern. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The expanded version of the <paramref name="replacement" /> parameter.</para>
+        </returns>
         <param name="replacement">
           <attribution license="cc4" from="Microsoft" modified="false" />The replacement pattern to use. </param>
       </Docs>
@@ -161,12 +167,15 @@
         <Parameter Name="inner" Type="System.Text.RegularExpressions.Match" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Match'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Text.RegularExpressions.Match" /> instance equivalent to the one supplied that is suitable to share between multiple threads.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A regular expression match that is suitable to share between multiple threads. </para>
+        </returns>
         <param name="inner">
           <attribution license="cc4" from="Microsoft" modified="false" />A regular expression match equivalent to the one expected. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Text.RegularExpressions/MatchCollection.xml b/mcs/class/System/Documentation/en/System.Text.RegularExpressions/MatchCollection.xml
index 2f5ac8cffd8..2436fa87688 100644
--- a/mcs/class/System/Documentation/en/System.Text.RegularExpressions/MatchCollection.xml
+++ b/mcs/class/System/Documentation/en/System.Text.RegularExpressions/MatchCollection.xml
@@ -117,7 +117,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Instead of  calling the <see cref="M:System.Text.RegularExpressions.MatchCollection.GetEnumerator" /> method to retrieve an enumerator that lets you iterate through the <see cref="T:System.Text.RegularExpressions.Match" /> objects in the collection, you should use the group iteration construct (such as foreach in C# and For Each…Next in Visual Basic) provided by your programming language.</para>
@@ -128,6 +127,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides an enumerator that iterates through the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that contains all <see cref="T:System.Text.RegularExpressions.Match" /> objects within the <see cref="T:System.Text.RegularExpressions.MatchCollection" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsReadOnly">
diff --git a/mcs/class/System/Documentation/en/System.Text.RegularExpressions/Regex.xml b/mcs/class/System/Documentation/en/System.Text.RegularExpressions/Regex.xml
index 1676a9589ae..4eb9efe0c89 100644
--- a/mcs/class/System/Documentation/en/System.Text.RegularExpressions/Regex.xml
+++ b/mcs/class/System/Documentation/en/System.Text.RegularExpressions/Regex.xml
@@ -689,7 +689,6 @@
         <Parameter Name="str" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -707,6 +706,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Escapes a minimal set of characters (\, *, +, ?, |, {, [, (,), ^, $,., #, and white space) by replacing them with their escape codes. This instructs the regular expression engine to interpret these characters literally rather than as metacharacters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string of characters with metacharacters converted to their escaped form.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The input string that contains the text to convert. </param>
       </Docs>
@@ -765,7 +768,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The collection of group names contains the set of strings used to name capturing groups in the expression. Even if capturing groups are not explicitly named, they are automatically assigned numerical names (1, 2, 3, and so on). Therefore, this collection can be used to determine the number of groups.</para>
@@ -774,6 +776,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of capturing group names for the regular expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string array of group names.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetGroupNumbers">
@@ -790,7 +796,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Both unnamed and named capturing groups can be accessed by number. Unnamed groups are numbered from left to right starting with 1. (The capturing group in index 0 (zero) represents the match as a whole.)  Named groups are then numbered from left to right starting with a number that is one greater than the number of unnamed capturing groups.</para>
@@ -800,6 +805,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of capturing group numbers that correspond to group names in an array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer array of group numbers.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GroupNameFromNumber">
@@ -818,7 +827,6 @@
         <Parameter Name="i" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A regular expression pattern may contain either named or numbered capturing groups, which delineate subexpressions within a pattern match. Numbered groups are delimited by the syntax (subexpression) and are assigned numbers based on their order in the regular expression. Named groups are delimited by the syntax (?&lt;name&gt;subexpression) or (?'name'subexpression), where name is the name by which the subexpression will be identified. (For more information, see <format type="text/html"><a href="0fc18634-f590-4062-8d5c-f0b71abe405b">Grouping Constructs</a></format>.) The <see cref="M:System.Text.RegularExpressions.Regex.GroupNameFromNumber(System.Int32)" /> method identifies both named groups and numbered groups by their ordinal positions in the regular expression. Ordinal position zero always represents the entire regular expression. All numbered groups are then counted before named groups, regardless of their actual position in the regular expression pattern. </para>
@@ -829,6 +837,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the group name that corresponds to the specified group number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the group name associated with the specified group number. If there is no group name that corresponds to <paramref name="i" />, the method returns <see cref="F:System.String.Empty" />.</para>
+        </returns>
         <param name="i">
           <attribution license="cc4" from="Microsoft" modified="false" />The group number to convert to the corresponding group name. </param>
       </Docs>
@@ -849,7 +861,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A regular expression pattern may contain either named or numbered capturing groups, which delineate subexpressions within a pattern match. Numbered groups are delimited by the syntax (subexpression) and are assigned numbers based on their order in the regular expression. Named groups are delimited by the syntax (?&lt;name&gt;subexpression) or (?'name'subexpression), where name is the name by which the subexpression will be identified. (For more information, see <format type="text/html"><a href="0fc18634-f590-4062-8d5c-f0b71abe405b">Grouping Constructs</a></format>.) The <see cref="M:System.Text.RegularExpressions.Regex.GroupNumberFromName(System.String)" /> method identifies both named groups and numbered groups by their ordinal positions in the regular expression. Ordinal position zero always represents the entire regular expression. All numbered groups are then counted before named groups, regardless of their actual position in the regular expression pattern. </para>
@@ -859,6 +870,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the group number that corresponds to the specified group name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The group number that corresponds to the specified group name, or -1 if <paramref name="name" /> is not a valid group name.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The group name to convert to the corresponding group number. </param>
       </Docs>
@@ -968,7 +983,6 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.Text.RegularExpressions.Regex.IsMatch" /> method is typically used to validate a string or to ensure that a string conforms to a particular pattern without retrieving that string for subsequent manipulation. If you want to determine whether one or more strings match a regular expression pattern and then retrieve them for subsequent manipulation, call the <see cref="Overload:System.Text.RegularExpressions.Regex.Match" /> or <see cref="Overload:System.Text.RegularExpressions.Regex.Matches" /> method.</para>
@@ -978,6 +992,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the regular expression specified in the <see cref="T:System.Text.RegularExpressions.Regex" /> constructor finds a match in a specified input string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the regular expression finds a match; otherwise, false.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search for a match. </param>
       </Docs>
@@ -999,7 +1017,6 @@
         <Parameter Name="startat" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.Text.RegularExpressions.Regex.IsMatch" /> method is typically used to validate a string or to ensure that a string conforms to a particular pattern without retrieving that string for subsequent manipulation. If you want to determine whether one or more strings match a regular expression pattern and then retrieve them for subsequent manipulation, call the <see cref="Overload:System.Text.RegularExpressions.Regex.Match" /> or <see cref="Overload:System.Text.RegularExpressions.Regex.Matches" /> method.</para>
@@ -1009,6 +1026,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the regular expression specified in the <see cref="T:System.Text.RegularExpressions.Regex" /> constructor finds a match in the specified input string, beginning at the specified starting position in the string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the regular expression finds a match; otherwise, false.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search for a match. </param>
         <param name="startat">
@@ -1032,7 +1053,6 @@
         <Parameter Name="pattern" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>Returns true if the input string matches the regular expression defined in pattern.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.Text.RegularExpressions.Regex.IsMatch" /> method is typically used to validate a string or to ensure that a string conforms to a particular pattern without retrieving that string for subsequent manipulation. If you want to determine whether one or more strings match a regular expression pattern and then retrieve them for subsequent manipulation, call the <see cref="Overload:System.Text.RegularExpressions.Regex.Match" /> or <see cref="Overload:System.Text.RegularExpressions.Regex.Matches" /> method.</para>
@@ -1044,6 +1064,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified regular expression finds a match in the specified input string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the regular expression finds a match; otherwise, false.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search for a match. </param>
         <param name="pattern">
@@ -1068,7 +1092,6 @@
         <Parameter Name="options" Type="System.Text.RegularExpressions.RegexOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.Text.RegularExpressions.Regex.IsMatch" /> method is typically used to validate a string or to ensure that a string conforms to a particular pattern without retrieving that string for subsequent manipulation. If you want to determine whether one or more strings match a regular expression pattern and then retrieve them for subsequent manipulation, call the <see cref="Overload:System.Text.RegularExpressions.Regex.Match" /> or <see cref="Overload:System.Text.RegularExpressions.Regex.Matches" /> method.</para>
@@ -1080,6 +1103,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified regular expression finds a match in the specified input string, using the specified matching options.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the regular expression finds a match; otherwise, false.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search for a match. </param>
         <param name="pattern">
@@ -1110,7 +1137,6 @@
         <Parameter Name="matchTimeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.Text.RegularExpressions.Regex.IsMatch" /> method is typically used to validate a string or to ensure that a string conforms to a particular pattern without retrieving that string for subsequent manipulation. If you want to determine whether one or more strings match a regular expression pattern and then retrieve them for subsequent manipulation, call the <see cref="Overload:System.Text.RegularExpressions.Regex.Match" /> or <see cref="Overload:System.Text.RegularExpressions.Regex.Matches" /> method.</para>
@@ -1122,6 +1148,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified regular expression finds a match in the specified input string, using the specified matching options and time-out interval.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the regular expression finds a match; otherwise, false.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search for a match.</param>
         <param name="pattern">
@@ -1148,7 +1178,6 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Match'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.RegularExpressions.Regex.Match(System.String)" /> method returns the first substring that matches a regular expression pattern in an input string. For information about the language elements used to build a regular expression pattern, see <format type="text/html"><a href="930653a6-95d2-4697-9d5a-52d11bb6fd4c">Regular Expression Language - Quick Reference</a></format>.</para>
@@ -1160,6 +1189,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the specified input string for the first occurrence of the regular expression specified in the <see cref="T:System.Text.RegularExpressions.Regex" /> constructor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that contains information about the match.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search for a match. </param>
       </Docs>
@@ -1181,7 +1214,6 @@
         <Parameter Name="startat" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Match'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.RegularExpressions.Regex.Match(System.String,System.Int32)" /> method returns the first substring that matches a regular expression pattern, starting at or after the <paramref name="startat" /> character position, in an input string. For information about the language elements used to build a regular expression pattern, see <format type="text/html"><a href="930653a6-95d2-4697-9d5a-52d11bb6fd4c">Regular Expression Language - Quick Reference</a></format>.</para>
@@ -1196,6 +1228,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the input string for the first occurrence of a regular expression, beginning at the specified starting position in the string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that contains information about the match.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search for a match. </param>
         <param name="startat">
@@ -1219,7 +1255,6 @@
         <Parameter Name="pattern" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Match'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.RegularExpressions.Regex.Match(System.String,System.String)" /> method returns the first substring that matches a regular expression pattern in an input string. For information about the language elements used to build a regular expression pattern, see <format type="text/html"><a href="930653a6-95d2-4697-9d5a-52d11bb6fd4c">Regular Expression Language - Quick Reference</a></format>.</para>
@@ -1233,6 +1268,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the specified input string for the first occurrence of the specified regular expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that contains information about the match.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search for a match. </param>
         <param name="pattern">
@@ -1257,7 +1296,6 @@
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Match'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.RegularExpressions.Regex.Match(System.String,System.Int32,System.Int32)" /> method returns the first substring that matches a regular expression pattern in a portion of an input string. For information about the language elements used to build a regular expression pattern, see <format type="text/html"><a href="930653a6-95d2-4697-9d5a-52d11bb6fd4c">Regular Expression Language - Quick Reference</a></format>.</para>
@@ -1270,6 +1308,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the input string for the first occurrence of a regular expression, beginning at the specified starting position and searching only the specified number of characters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that contains information about the match.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search for a match. </param>
         <param name="beginning">
@@ -1296,7 +1338,6 @@
         <Parameter Name="options" Type="System.Text.RegularExpressions.RegexOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Match'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.RegularExpressions.Regex.Match(System.String,System.String,System.Text.RegularExpressions.RegexOptions)" /> method returns the first substring that matches a regular expression pattern in an input string. For information about the language elements used to build a regular expression pattern, see <format type="text/html"><a href="930653a6-95d2-4697-9d5a-52d11bb6fd4c">Regular Expression Language - Quick Reference</a></format>.</para>
@@ -1310,6 +1351,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the input string for the first occurrence of the specified regular expression, using the specified matching options.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that contains information about the match.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search for a match. </param>
         <param name="pattern">
@@ -1340,7 +1385,6 @@
         <Parameter Name="matchTimeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.RegularExpressions.Regex.Match(System.String,System.String,System.Text.RegularExpressions.RegexOptions,System.TimeSpan)" /> method returns the first substring that matches a regular expression pattern in an input string. For information about the language elements used to build a regular expression pattern, see <format type="text/html"><a href="930653a6-95d2-4697-9d5a-52d11bb6fd4c">Regular Expression Language - Quick Reference</a></format>.</para>
@@ -1354,6 +1398,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the input string for the first occurrence of the specified regular expression, using the specified matching options and time-out interval.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that contains information about the match.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search for a match.</param>
         <param name="pattern">
@@ -1380,7 +1428,6 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MatchCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.RegularExpressions.Regex.Matches(System.String)" /> method is similar to the <see cref="M:System.Text.RegularExpressions.Regex.Match(System.String)" /> method, except that it returns information about all the matches found in the input string, instead of a single match. It is equivalent to the following code: </para>
@@ -1394,6 +1441,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the specified input string for all occurrences of a regular expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of the <see cref="T:System.Text.RegularExpressions.Match" /> objects found by the search. If no matches are found, the method returns an empty collection object.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search for a match.</param>
       </Docs>
@@ -1415,7 +1466,6 @@
         <Parameter Name="startat" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MatchCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The  <see cref="M:System.Text.RegularExpressions.Regex.Matches(System.String,System.Int32)" /> method is similar to the  <see cref="M:System.Text.RegularExpressions.Regex.Match(System.String,System.Int32)" /> method, except that it returns information about all the matches found in the input string, instead of a single match. It is equivalent to the following code:</para>
@@ -1428,6 +1478,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the specified input string for all occurrences of a regular expression, beginning at the specified starting position in the string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of the <see cref="T:System.Text.RegularExpressions.Match" /> objects found by the search. If no matches are found, the method returns an empty collection object.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search for a match. </param>
         <param name="startat">
@@ -1451,7 +1505,6 @@
         <Parameter Name="pattern" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MatchCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.RegularExpressions.Regex.Matches(System.String,System.String)" /> method is similar to the <see cref="M:System.Text.RegularExpressions.Regex.Match(System.String,System.String)" /> method, except that it returns information about all the matches found in the input string, instead of a single match. It is equivalent to the following code: </para>
@@ -1465,6 +1518,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the specified input string for all occurrences of a specified regular expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of the <see cref="T:System.Text.RegularExpressions.Match" /> objects found by the search. If no matches are found, the method returns an empty collection object.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search for a match. </param>
         <param name="pattern">
@@ -1489,7 +1546,6 @@
         <Parameter Name="options" Type="System.Text.RegularExpressions.RegexOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MatchCollection'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.RegularExpressions.Regex.Matches(System.String,System.String,System.Text.RegularExpressions.RegexOptions)" /> method is similar to the <see cref="M:System.Text.RegularExpressions.Regex.Match(System.String,System.String,System.Text.RegularExpressions.RegexOptions)" /> method, except that it returns information about all the matches found in the input string, instead of a single match. It is equivalent to the following code:</para>
@@ -1503,6 +1559,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the specified input string for all occurrences of a specified regular expression, using the specified matching options.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of the <see cref="T:System.Text.RegularExpressions.Match" /> objects found by the search. If no matches are found, the method returns an empty collection object.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search for a match. </param>
         <param name="pattern">
@@ -1533,7 +1593,6 @@
         <Parameter Name="matchTimeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.RegularExpressions.Regex.Matches(System.String,System.String,System.Text.RegularExpressions.RegexOptions,System.TimeSpan)" /> method is similar to the <see cref="M:System.Text.RegularExpressions.Regex.Match(System.String,System.String,System.Text.RegularExpressions.RegexOptions,System.TimeSpan)" />  method, except that it returns information about all the matches found in the input string, instead of a single match. It is equivalent to the following code:</para>
@@ -1547,6 +1606,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the specified input string for all occurrences of a specified regular expression, using the specified matching options and time-out interval.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of the <see cref="T:System.Text.RegularExpressions.Match" /> objects found by the search. If no matches are found, the method returns an empty collection object.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search for a match.</param>
         <param name="pattern">
@@ -1646,7 +1709,6 @@
         <Parameter Name="replacement" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The search for matches starts at the beginning of the <paramref name="input" /> string. The regular expression is the pattern defined by the constructor for the current <see cref="T:System.Text.RegularExpressions.Regex" /> object.</para>
@@ -1661,6 +1723,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In a specified input string, replaces all strings that match a regular expression pattern with a specified replacement string. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new string that is identical to the input string, except that the replacement string takes the place of each matched string. If the regular expression pattern is not matched in the current instance, the method returns the current instance unchanged. </para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search for a match. </param>
         <param name="replacement">
@@ -1684,7 +1750,6 @@
         <Parameter Name="evaluator" Type="System.Text.RegularExpressions.MatchEvaluator" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.RegularExpressions.Regex.Replace(System.String,System.Text.RegularExpressions.MatchEvaluator)" /> method is useful for replacing a regular expression match if any of the following conditions is true:</para>
@@ -1711,6 +1776,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In a specified input string, replaces all strings that match a specified regular expression with a string returned by a <see cref="T:System.Text.RegularExpressions.MatchEvaluator" /> delegate. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new string that is identical to the input string, except that a replacement string takes the place of each matched string. If the regular expression pattern is not matched in the current instance, the method returns the current instance unchanged. </para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search for a match. </param>
         <param name="evaluator">
@@ -1735,7 +1804,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The search for matches starts at the beginning of the <paramref name="input" /> string. The regular expression is the pattern that is defined by the constructor for the current <see cref="T:System.Text.RegularExpressions.Regex" /> object. If <paramref name="count" /> is negative, replacements continue to the end of the string. If <paramref name="count" /> exceeds the number of matches, all matches are replaced.</para>
@@ -1750,6 +1818,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In a specified input string, replaces a specified maximum number of strings that match a regular expression pattern with a specified replacement string. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new string that is identical to the input string, except that the replacement string takes the place of each matched string. If the regular expression pattern is not matched in the current instance, the method returns the current instance unchanged.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search for a match. </param>
         <param name="replacement">
@@ -1776,7 +1848,6 @@
         <Parameter Name="replacement" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The static Replace methods are equivalent to constructing a <see cref="T:System.Text.RegularExpressions.Regex" /> object with the specified regular expression pattern and calling the instance method Replace. </para>
@@ -1792,6 +1863,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In a specified input string, replaces all strings that match a specified regular expression with a specified replacement string. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new string that is identical to the input string, except that the replacement string takes the place of each matched string. If <paramref name="pattern" /> is not matched in the current instance, the method returns the current instance unchanged.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search for a match. </param>
         <param name="pattern">
@@ -1818,7 +1893,6 @@
         <Parameter Name="evaluator" Type="System.Text.RegularExpressions.MatchEvaluator" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.RegularExpressions.Regex.Replace(System.String,System.String,System.Text.RegularExpressions.MatchEvaluator)" /> method is useful for replacing a regular expression match if any of the following conditions is true:</para>
@@ -1845,6 +1919,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In a specified input string, replaces all strings that match a specified regular expression with a string returned by a <see cref="T:System.Text.RegularExpressions.MatchEvaluator" /> delegate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new string that is identical to the input string, except that a replacement string takes the place of each matched string. If <paramref name="pattern" /> is not matched in the current instance, the method returns the current instance unchanged. </para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search for a match. </param>
         <param name="pattern">
@@ -1871,7 +1949,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.RegularExpressions.Regex.Replace(System.String,System.Text.RegularExpressions.MatchEvaluator,System.Int32)" /> method is useful for replacing a regular expression match if any of the following conditions is true:</para>
@@ -1898,6 +1975,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In a specified input string, replaces a specified maximum number of strings that match a regular expression pattern with a string returned by a <see cref="T:System.Text.RegularExpressions.MatchEvaluator" /> delegate. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new string that is identical to the input string, except that a replacement string takes the place of each matched string. If the regular expression pattern is not matched in the current instance, the method returns the current instance unchanged. </para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search for a match. </param>
         <param name="evaluator">
@@ -1925,7 +2006,6 @@
         <Parameter Name="startat" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The search for matches starts in the <paramref name="input" /> string at the position specified by the <paramref name="startat" /> parameter. The regular expression is the pattern defined by the constructor for the current <see cref="T:System.Text.RegularExpressions.Regex" /> object. If <paramref name="count" /> is negative, replacements continue to the end of the string. If <paramref name="count" /> exceeds the number of matches, all matches are replaced.</para>
@@ -1940,6 +2020,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In a specified input substring, replaces a specified maximum number of strings that match a regular expression pattern with a specified replacement string. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new string that is identical to the input string, except that the replacement string takes the place of each matched string. If the regular expression pattern is not matched in the current instance, the method returns the current instance unchanged. </para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search for a match. </param>
         <param name="replacement">
@@ -1969,7 +2053,6 @@
         <Parameter Name="options" Type="System.Text.RegularExpressions.RegexOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The static Replace methods are equivalent to constructing a <see cref="T:System.Text.RegularExpressions.Regex" /> object with the specified regular expression pattern and calling the instance method Replace. </para>
@@ -1985,6 +2068,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In a specified input string, replaces all strings that match a specified regular expression with a specified replacement string. Specified options modify the matching operation. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new string that is identical to the input string, except that the replacement string takes the place of each matched string. If <paramref name="pattern" /> is not matched in the current instance, the method returns the current instance unchanged.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search for a match. </param>
         <param name="pattern">
@@ -2014,7 +2101,6 @@
         <Parameter Name="options" Type="System.Text.RegularExpressions.RegexOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.RegularExpressions.Regex.Replace(System.String,System.String,System.Text.RegularExpressions.MatchEvaluator,System.Text.RegularExpressions.RegexOptions)" /> method is useful for replacing a regular expression match in if any of the following conditions is true:</para>
@@ -2042,6 +2128,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In a specified input string, replaces all strings that match a specified regular expression with a string returned by a <see cref="T:System.Text.RegularExpressions.MatchEvaluator" /> delegate. Specified options modify the matching operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new string that is identical to the input string, except that a replacement string takes the place of each matched string. If <paramref name="pattern" /> is not matched in the current instance, the method returns the current instance unchanged.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search for a match. </param>
         <param name="pattern">
@@ -2071,7 +2161,6 @@
         <Parameter Name="startat" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.RegularExpressions.Regex.Replace(System.String,System.Text.RegularExpressions.MatchEvaluator,System.Int32,System.Int32)" /> method is useful for replacing a regular expression match if any of the following conditions is true:</para>
@@ -2098,6 +2187,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In a specified input substring, replaces a specified maximum number of strings that match a regular expression pattern with a string returned by a <see cref="T:System.Text.RegularExpressions.MatchEvaluator" /> delegate. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new string that is identical to the input string, except that a replacement string takes the place of each matched string. If the regular expression pattern is not matched in the current instance, the method returns the current instance unchanged. </para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search for a match. </param>
         <param name="evaluator">
@@ -2131,7 +2224,6 @@
         <Parameter Name="matchTimeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The static Replace methods are equivalent to constructing a <see cref="T:System.Text.RegularExpressions.Regex" /> object with the specified regular expression pattern and calling the instance method Replace. </para>
@@ -2147,6 +2239,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In a specified input string, replaces all strings that match a specified regular expression with a specified replacement string. Additional parameters specify options that modify the matching operation and a time-out interval if no match is found.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new string that is identical to the input string, except that the replacement string takes the place of each matched string. If <paramref name="pattern" /> is not matched in the current instance, the method returns the current instance unchanged. </para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search for a match.</param>
         <param name="pattern">
@@ -2182,7 +2278,6 @@
         <Parameter Name="matchTimeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.RegularExpressions.Regex.Replace(System.String,System.String,System.Text.RegularExpressions.MatchEvaluator,System.Text.RegularExpressions.RegexOptions)" /> method is useful for replacing a regular expression match if any of the following conditions is true:</para>
@@ -2210,6 +2305,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In a specified input string, replaces all substrings that match a specified regular expression with a string returned by a <see cref="T:System.Text.RegularExpressions.MatchEvaluator" /> delegate. Additional parameters specify options that modify the matching operation and a time-out interval if no match is found.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new string that is identical to the input string, except that the replacement string takes the place of each matched string. If <paramref name="pattern" /> is not matched in the current instance, the method returns the current instance unchanged. </para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search for a match.</param>
         <param name="pattern">
@@ -2283,7 +2382,6 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.RegularExpressions.Regex.Split(System.String)" /> methods are similar to the <see cref="M:System.String.Split(System.Char[])" /> method, except that <see cref="M:System.Text.RegularExpressions.Regex.Split(System.String)" /> splits the string at a delimiter determined by a regular expression instead of a set of characters. The string is split as many times as possible. If no delimiter is found, the return value contains one element whose value is the original input string.  </para>
@@ -2304,6 +2402,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Splits an input string into an array of substrings at the positions defined by a regular expression pattern specified in the <see cref="T:System.Text.RegularExpressions.Regex" /> constructor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of strings.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to split. </param>
       </Docs>
@@ -2325,7 +2427,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.RegularExpressions.Regex.Split(System.String)" /> methods are similar to the <see cref="M:System.String.Split(System.Char[])" /> method, except that <see cref="M:System.Text.RegularExpressions.Regex.Split(System.String)" /> splits the string at a delimiter determined by a regular expression instead of a set of characters. The <paramref name="count" /> parameter specifies the maximum number of substrings into which the <paramref name="input" /> string can be split; the last string contains the unsplit remainder of the string. A <paramref name="count" /> value of zero provides the default behavior of splitting as many times as possible. </para>
@@ -2343,6 +2444,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Splits an input string a specified maximum number of times into an array of substrings, at the positions defined by a regular expression specified in the <see cref="T:System.Text.RegularExpressions.Regex" /> constructor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of strings.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to be split. </param>
         <param name="count">
@@ -2366,7 +2471,6 @@
         <Parameter Name="pattern" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.RegularExpressions.Regex.Split(System.String)" /> methods are similar to the <see cref="M:System.String.Split(System.Char[])" /> method, except that <see cref="M:System.Text.RegularExpressions.Regex.Split(System.String)" /> splits the string at a delimiter determined by a regular expression instead of a set of characters. The <paramref name="input" /> string is split as many times as possible. If <paramref name="pattern" /> is not found in the <paramref name="input" /> string, the return value contains one element whose value is the original <paramref name="input" /> string. </para>
@@ -2391,6 +2495,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Splits an input string into an array of substrings at the positions defined by a regular expression pattern.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of strings.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to split. </param>
         <param name="pattern">
@@ -2415,7 +2523,6 @@
         <Parameter Name="startat" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.RegularExpressions.Regex.Split(System.String)" /> methods are similar to the <see cref="M:System.String.Split(System.Char[])" /> method, except that <see cref="M:System.Text.RegularExpressions.Regex.Split(System.String)" />  splits the string at a delimiter determined by a regular expression instead of a set of characters. The <paramref name="count" /> parameter specifies the maximum number of substrings into which the <paramref name="input" /> string is split; the last string contains the unsplit remainder of the string. A <paramref name="count" /> value of zero provides the default behavior of splitting as many times as possible. The <paramref name="startat" /> parameter defines the point at which the search for the first delimiter begins (this can be used for skipping leading white space).</para>
@@ -2434,6 +2541,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Splits an input string a specified maximum number of times into an array of substrings, at the positions defined by a regular expression specified in the <see cref="T:System.Text.RegularExpressions.Regex" /> constructor. The search for the regular expression pattern starts at a specified character position in the input string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of strings.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to be split. </param>
         <param name="count">
@@ -2460,7 +2571,6 @@
         <Parameter Name="options" Type="System.Text.RegularExpressions.RegexOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.RegularExpressions.Regex.Split(System.String)" /> methods are similar to the <see cref="M:System.String.Split(System.Char[])" /> method, except that <see cref="M:System.Text.RegularExpressions.Regex.Split(System.String)" /> splits the string at a delimiter determined by a regular expression instead of a set of characters. The string is split as many times as possible. If no delimiter is found, the return value contains one element whose value is the original <paramref name="input" /> string. </para>
@@ -2482,6 +2592,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Splits an input string into an array of substrings at the positions defined by a specified regular expression pattern. Specified options modify the matching operation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of strings.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to split. </param>
         <param name="pattern">
@@ -2512,7 +2626,6 @@
         <Parameter Name="matchTimeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.RegularExpressions.Regex.Split(System.String)" /> methods are similar to the <see cref="M:System.String.Split(System.Char[])" /> method, except that <see cref="M:System.Text.RegularExpressions.Regex.Split(System.String)" /> splits the string at a delimiter determined by a regular expression instead of a set of characters. The string is split as many times as possible. If no delimiter is found, the return value contains one element whose value is the original <paramref name="input" /> string. </para>
@@ -2534,6 +2647,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Splits an input string into an array of substrings at the positions defined by a specified regular expression pattern. Additional parameters specify options that modify the matching operation and a time-out interval if no match is found.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string array.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to split.</param>
         <param name="pattern">
@@ -2585,7 +2702,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="pattern" /> parameter consists of regular expression language elements that symbolically describe the string to match. For more information about regular expressions, see <format type="text/html"><a href="521b3f6d-f869-42e1-93e5-158c54a6895d">.NET Framework Regular Expressions</a></format> and <format type="text/html"><a href="930653a6-95d2-4697-9d5a-52d11bb6fd4c">Regular Expression Language Elements</a></format>.</para>
@@ -2594,6 +2710,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the regular expression pattern that was passed into the Regex constructor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <paramref name="pattern" /> parameter that was passed into the Regex constructor.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Unescape">
@@ -2612,7 +2732,6 @@
         <Parameter Name="str" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.RegularExpressions.Regex.Unescape(System.String)" /> method performs one of the following two transformations: </para>
@@ -2636,6 +2755,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts any escaped characters in the input string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string of characters with any escaped characters converted to their unescaped form.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The input string containing the text to convert. </param>
       </Docs>
@@ -2654,12 +2777,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used by a <see cref="T:System.Text.RegularExpressions.Regex" /> object generated by the <see cref="Overload:System.Text.RegularExpressions.Regex.CompileToAssembly" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="P:System.Text.RegularExpressions.Regex.Options" /> property contains the <see cref="F:System.Text.RegularExpressions.RegexOptions.Compiled" /> option; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="UseOptionR">
@@ -2676,12 +2802,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used by a <see cref="T:System.Text.RegularExpressions.Regex" /> object generated by the <see cref="Overload:System.Text.RegularExpressions.Regex.CompileToAssembly" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="P:System.Text.RegularExpressions.Regex.Options" /> property contains the <see cref="F:System.Text.RegularExpressions.RegexOptions.RightToLeft" /> option; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.Text.RegularExpressions/RegexRunner.xml b/mcs/class/System/Documentation/en/System.Text.RegularExpressions/RegexRunner.xml
index 53fc5088957..4220239b929 100644
--- a/mcs/class/System/Documentation/en/System.Text.RegularExpressions/RegexRunner.xml
+++ b/mcs/class/System/Documentation/en/System.Text.RegularExpressions/RegexRunner.xml
@@ -108,12 +108,15 @@
         <Parameter Name="charClass" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used by a <see cref="T:System.Text.RegularExpressions.Regex" /> object generated by the <see cref="Overload:System.Text.RegularExpressions.Regex.CompileToAssembly" /> method. Determines whether a character is in a character class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="ch" /> parameter is in the character class specified by the <paramref name="charClass" /> parameter.</para>
+        </returns>
         <param name="ch">
           <attribution license="cc4" from="Microsoft" modified="false" />A character to test.</param>
         <param name="charClass">
@@ -146,12 +149,15 @@
         <param name="ch">To be added: an object of type 'char'</param>
         <param name="set">To be added: an object of type 'string'</param>
         <param name="category">To be added: an object of type 'string'</param>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used by a <see cref="T:System.Text.RegularExpressions.Regex" /> object generated by the <see cref="Overload:System.Text.RegularExpressions.Regex.CompileToAssembly" /> method. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Crawl">
@@ -202,12 +208,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used by a <see cref="T:System.Text.RegularExpressions.Regex" /> object generated by the <see cref="Overload:System.Text.RegularExpressions.Regex.CompileToAssembly" /> method. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Int32" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DoubleCrawl">
@@ -328,12 +337,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used by a <see cref="T:System.Text.RegularExpressions.Regex" /> object generated by the <see cref="Overload:System.Text.RegularExpressions.Regex.CompileToAssembly" /> method. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Go">
@@ -404,12 +416,15 @@
         <param name="index">To be added: an object of type 'int'</param>
         <param name="startpos">To be added: an object of type 'int'</param>
         <param name="endpos">To be added: an object of type 'int'</param>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used by a <see cref="T:System.Text.RegularExpressions.Regex" /> object generated by the <see cref="Overload:System.Text.RegularExpressions.Regex.CompileToAssembly" /> method. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsECMABoundary">
@@ -438,12 +453,15 @@
         <param name="index">To be added: an object of type 'int'</param>
         <param name="startpos">To be added: an object of type 'int'</param>
         <param name="endpos">To be added: an object of type 'int'</param>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used by a <see cref="T:System.Text.RegularExpressions.Regex" /> object generated by the <see cref="Overload:System.Text.RegularExpressions.Regex.CompileToAssembly" /> method. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsMatched">
@@ -468,12 +486,15 @@
       </Parameters>
       <Docs>
         <param name="cap">To be added: an object of type 'int'</param>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used by a <see cref="T:System.Text.RegularExpressions.Regex" /> object generated by the <see cref="Overload:System.Text.RegularExpressions.Regex.CompileToAssembly" /> method. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Boolean" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MatchIndex">
@@ -498,12 +519,15 @@
       </Parameters>
       <Docs>
         <param name="cap">To be added: an object of type 'int'</param>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used by a <see cref="T:System.Text.RegularExpressions.Regex" /> object generated by the <see cref="Overload:System.Text.RegularExpressions.Regex.CompileToAssembly" /> method. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Int32" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MatchLength">
@@ -528,12 +552,15 @@
       </Parameters>
       <Docs>
         <param name="cap">To be added: an object of type 'int'</param>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used by a <see cref="T:System.Text.RegularExpressions.Regex" /> object generated by the <see cref="Overload:System.Text.RegularExpressions.Regex.CompileToAssembly" /> method. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Int32" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Popcrawl">
@@ -555,12 +582,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used by a <see cref="T:System.Text.RegularExpressions.Regex" /> object generated by the <see cref="Overload:System.Text.RegularExpressions.Regex.CompileToAssembly" /> method. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Int32" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="runcrawl">
@@ -943,8 +973,11 @@
         <param name="prevlen">To be added.</param>
         <param name="quick">To be added.</param>
         <summary>To be added.</summary>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns <see cref="T:System.Text.RegularExpressions.Match" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TransferCapture">
diff --git a/mcs/class/System/Documentation/en/System.Text.RegularExpressions/RegexRunnerFactory.xml b/mcs/class/System/Documentation/en/System.Text.RegularExpressions/RegexRunnerFactory.xml
index da30f992697..dc4d12476de 100644
--- a/mcs/class/System/Documentation/en/System.Text.RegularExpressions/RegexRunnerFactory.xml
+++ b/mcs/class/System/Documentation/en/System.Text.RegularExpressions/RegexRunnerFactory.xml
@@ -64,12 +64,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates a <see cref="T:System.Text.RegularExpressions.RegexRunner" /> object for a specific compiled regular expression.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Text.RegularExpressions.RegexRunner" /> object designed to execute a specific compiled regular expression. </para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/System/Documentation/en/System.Threading/Barrier.xml b/mcs/class/System/Documentation/en/System.Threading/Barrier.xml
index fb3c90dca09..dcf75d492f8 100644
--- a/mcs/class/System/Documentation/en/System.Threading/Barrier.xml
+++ b/mcs/class/System/Documentation/en/System.Threading/Barrier.xml
@@ -88,7 +88,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the barrier is currently executing a post phase action, this call is blocked until the post phase action completes and the barrier has moved on to the next phase.</para>
@@ -97,6 +96,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Notifies the <see cref="T:System.Threading.Barrier" /> that there will be an additional participant.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The phase number of the barrier in which the new participants will first participate.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="AddParticipants">
@@ -113,7 +116,6 @@
         <Parameter Name="participantCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the barrier is currently executing a post phase action, this call is blocked until the post phase action completes and the barrier has moved on to the next phase.</para>
@@ -122,6 +124,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Notifies the <see cref="T:System.Threading.Barrier" /> that there will be additional participants.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The phase number of the barrier in which the new participants will first participate.</para>
+        </returns>
         <param name="participantCount">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of additional participants to add to the barrier.</param>
       </Docs>
@@ -321,12 +327,15 @@
         <Parameter Name="millisecondsTimeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Signals that a participant has reached the barrier and waits for all other participants to reach the barrier as well, using a 32-bit signed integer to measure the timeout.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>if all participants reached the barrier within the specified time; otherwise false.</para>
+        </returns>
         <param name="millisecondsTimeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of milliseconds to wait, or <see cref="F:System.Threading.Timeout.Infinite" />(-1) to wait indefinitely.</param>
       </Docs>
@@ -368,12 +377,15 @@
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Signals that a participant has reached the barrier and waits for all other participants to reach the barrier as well, using a <see cref="T:System.TimeSpan" /> object to measure the time interval.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if all other participants reached the barrier; otherwise, false.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.TimeSpan" /> that represents the number of milliseconds to wait, or a <see cref="T:System.TimeSpan" /> that represents -1 milliseconds to wait indefinitely.</param>
       </Docs>
@@ -393,7 +405,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <paramref name="cancellationToken" /> was canceled before the signal took effect, then an <see cref="T:System.OperationCanceledException" /> is thrown and the <see cref="P:System.Threading.Barrier.ParticipantsRemaining" /> value is not decreased. If the <paramref name="cancellationToken" /> is not canceled or is canceled after the signal takes effect then <see cref="P:System.Threading.Barrier.ParticipantsRemaining" /> is decreased and no <see cref="T:System.OperationCanceledException" /> is thrown.</para>
@@ -402,6 +413,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Signals that a participant has reached the barrier and waits for all other participants to reach the barrier as well, using a 32-bit signed integer to measure the timeout, while observing a cancellation token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>if all participants reached the barrier within the specified time; otherwise false</para>
+        </returns>
         <param name="millisecondsTimeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of milliseconds to wait, or <see cref="F:System.Threading.Timeout.Infinite" />(-1) to wait indefinitely.</param>
         <param name="cancellationToken">
@@ -423,12 +438,15 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Signals that a participant has reached the barrier and waits for all other participants to reach the barrier as well, using a <see cref="T:System.TimeSpan" /> object to measure the time interval, while observing a cancellation token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if all other participants reached the barrier; otherwise, false.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.TimeSpan" /> that represents the number of milliseconds to wait, or a <see cref="T:System.TimeSpan" /> that represents -1 milliseconds to wait indefinitely.</param>
         <param name="cancellationToken">
diff --git a/mcs/class/System/Documentation/en/System.Threading/Semaphore.xml b/mcs/class/System/Documentation/en/System.Threading/Semaphore.xml
index 81c3a1d4075..c2100c8cc87 100644
--- a/mcs/class/System/Documentation/en/System.Threading/Semaphore.xml
+++ b/mcs/class/System/Documentation/en/System.Threading/Semaphore.xml
@@ -169,7 +169,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -181,6 +180,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the access control security for a named system semaphore.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.AccessControl.SemaphoreSecurity" /> object that represents the access control security for the named system semaphore.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="OpenExisting">
@@ -198,7 +201,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -211,6 +213,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens the specified named semaphore, if it already exists.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the named system semaphore.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the system semaphore to open.</param>
       </Docs>
@@ -231,7 +237,6 @@
         <Parameter Name="rights" Type="System.Security.AccessControl.SemaphoreRights" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -243,6 +248,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens the specified named semaphore, if it already exists, with the desired security access.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the named system semaphore.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the system semaphore to open. </param>
         <param name="rights">
@@ -270,7 +279,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -282,6 +290,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Exits the semaphore and returns the previous count.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The count on the semaphore before the <see cref="Overload:System.Threading.Semaphore.Release" /> method was called. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Release">
@@ -304,7 +316,6 @@
         <Parameter Name="releaseCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -316,6 +327,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Exits the semaphore a specified number of times and returns the previous count.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The count on the semaphore before the <see cref="Overload:System.Threading.Semaphore.Release" /> method was called. </para>
+        </returns>
         <param name="releaseCount">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of times to exit the semaphore.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Web/AspNetHostingPermission.xml b/mcs/class/System/Documentation/en/System.Web/AspNetHostingPermission.xml
index 4e82b2019c4..10374128f4e 100644
--- a/mcs/class/System/Documentation/en/System.Web/AspNetHostingPermission.xml
+++ b/mcs/class/System/Documentation/en/System.Web/AspNetHostingPermission.xml
@@ -88,12 +88,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented by a derived class, creates and returns an identical copy of the current permission object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current permission object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="FromXml">
@@ -140,12 +143,15 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented by a derived class, creates and returns a permission that is the intersection of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.IPermission" /> that represents the intersection of the current permission and the specified permission; otherwise, null if the intersection is empty.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to combine with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
@@ -166,12 +172,15 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the current permission is a subset of the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current <see cref="T:System.Security.IPermission" /> is a subset of the specified <see cref="T:System.Security.IPermission" />; otherwise, false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.IPermission" /> to combine with the current permission. It must be of the same type as the current <see cref="T:System.Security.IPermission" />. </param>
       </Docs>
@@ -190,12 +199,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether unrestricted access to the resource that is protected by the current permission is allowed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if unrestricted use of the resource protected by the permission is allowed; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Level">
@@ -233,12 +245,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the permission object and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.SecurityElement" /> containing the XML encoding of the permission object, including any state information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Union">
@@ -257,12 +272,15 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a permission that is the union of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.IPermission" /> that represents the union of the current permission and the specified permission.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to combine with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System.Web/AspNetHostingPermissionAttribute.xml b/mcs/class/System/Documentation/en/System.Web/AspNetHostingPermissionAttribute.xml
index c6bbf9aaf70..d83c41d38e8 100644
--- a/mcs/class/System/Documentation/en/System.Web/AspNetHostingPermissionAttribute.xml
+++ b/mcs/class/System/Documentation/en/System.Web/AspNetHostingPermissionAttribute.xml
@@ -61,12 +61,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Web.AspNetHostingPermission" /> with the permission level previously set by the <see cref="P:System.Web.AspNetHostingPermissionAttribute.Level" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.IPermission" /> that is the new <see cref="T:System.Web.AspNetHostingPermission" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Level">
diff --git a/mcs/class/System/Documentation/en/System.Windows.Input/ICommand.xml b/mcs/class/System/Documentation/en/System.Windows.Input/ICommand.xml
index 875a6a0698d..69b52fe58f3 100644
--- a/mcs/class/System/Documentation/en/System.Windows.Input/ICommand.xml
+++ b/mcs/class/System/Documentation/en/System.Windows.Input/ICommand.xml
@@ -89,7 +89,6 @@
         <Parameter Name="parameter" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Typically, a command source calls the <see cref="M:System.Windows.Input.ICommand.CanExecute(System.Object)" /> method when the <see cref="E:System.Windows.Input.ICommand.CanExecuteChanged" /> event is raised.</para>
@@ -98,6 +97,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines the method that determines whether the command can execute in its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this command can be executed; otherwise, false.</para>
+        </returns>
         <param name="parameter">
           <attribution license="cc4" from="Microsoft" modified="false" />Data used by the command.  If the command does not require data to be passed, this object can be set to null.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System/Uri.xml b/mcs/class/System/Documentation/en/System/Uri.xml
index a37e7080104..19abc66bacf 100644
--- a/mcs/class/System/Documentation/en/System/Uri.xml
+++ b/mcs/class/System/Documentation/en/System/Uri.xml
@@ -641,12 +641,6 @@ public class UriTest {
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.UriHostNameType" /> that indicates the type of the host name. If the type of
-   the host name cannot be determined, or the host name is <see langword="null" /> or
-   a zero-length string, returns <see cref="F:System.UriHostNameType.Unknown" /> .
-   </para>
-        </returns>
         <example>
           <para> The following example demonstrates using the <see cref="M:System.Uri.CheckHostName(System.String)" /> method.
    </para>
@@ -672,6 +666,10 @@ public class UriTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified host name is a valid DNS name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.UriHostNameType" /> that indicates the type of the host name. If the type of the host name cannot be determined or if the host name is null or a zero-length string, this method returns <see cref="F:System.UriHostNameType.Unknown" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The host name to validate. This can be an IPv4 or IPv6 address or an Internet host name. </param>
       </Docs>
@@ -694,14 +692,6 @@ public class UriTest {
         <Parameter Name="schemeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true " />if the scheme name is valid; otherwise,
-<see langword="false" />. If 
-<paramref name="schemeName" /> is <see langword="null" /> or is a zero-length string, returns 
-<see langword="false" />.
-   </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method checks the scheme name for validity according to RFC 2396 by default. If International Resource Identifiers (IRIs) or Internationalized Domain Name (IDN) parsing is enabled, this method checks the scheme name for validity according to RFC 3986. The scheme name must begin with a letter and must contain only letters, digits, and the characters ".", "+", or "-".</para>
@@ -711,6 +701,10 @@ public class UriTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified scheme name is valid.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Boolean" /> value that is true if the scheme name is valid; otherwise, false.</para>
+        </returns>
         <param name="schemeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The scheme name to validate. </param>
       </Docs>
@@ -787,7 +781,6 @@ public class UriTest {
         <Parameter Name="comparisonType" Type="System.StringComparison" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If both <paramref name="uri1" /> and <paramref name="uri2" /> are null, this method returns 0. When comparing URI values, a relative URI is always less than an absolute URI, and a non-null URI is always greater than a null URI. For cases where both <paramref name="uri1" /> and <paramref name="uri2" /> are not null and are both relative URIs or both absolute URIs, the <see cref="M:System.String.Compare(System.String,System.String,System.StringComparison)" /> method performs the comparison.</para>
@@ -796,6 +789,49 @@ public class UriTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the specified parts of two URIs using the specified comparison rules.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Int32" /> value that indicates the lexical relationship between the compared <see cref="T:System.Uri" /> components.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value</para>
+                </term>
+                <description>
+                  <para>Meaning</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero</para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="uri1" /> is less than <paramref name="uri2" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="uri1" /> equals <paramref name="uri2" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero</para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="uri1" /> is greater than <paramref name="uri2" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="uri1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Uri" />.</param>
         <param name="uri2">
@@ -884,14 +920,6 @@ public class UriTest {
         <Parameter Name="comparand" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true " />if
-<paramref name="comparand " />represents the same URI (ignoring any fragment or query information) as
-   the current instance; otherwise, <see langword="false" /> . If <paramref name="comparand" /> is
-<see langword="null" />, a zero-length string, or is not an instance of <see cref="T:System.String" /> or <see cref="T:System.Uri" /> 
-, returns false.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Uri.Equals(System.Object)" /> method compares the two instances without regard to user information (<see cref="P:System.Uri.UserInfo" />) and fragment (<see cref="P:System.Uri.Fragment" />) parts that they might contain. For example, given the URIs http://www.contoso.com/index.htm#search and http://user:password@www.contoso.com/index.htm, the <see cref="M:System.Uri.Equals(System.Object)" /> method would return true.</para>
@@ -908,6 +936,10 @@ public class UriTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Uri" /> instances for equality.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Boolean" /> value that is true if the two instances represent the same URI; otherwise, false.</para>
+        </returns>
         <param name="comparand">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Uri" /> instance or a URI identifier to compare with the current instance. </param>
       </Docs>
@@ -983,7 +1015,6 @@ public class UriTest {
         <Parameter Name="stringToEscape" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>By default, the <see cref="M:System.Uri.EscapeDataString(System.String)" /> method converts all characters except for RFC 2396 unreserved characters to their hexadecimal representation. If International Resource Identifiers (IRIs) or Internationalized Domain Name (IDN) parsing is enabled, the <see cref="M:System.Uri.EscapeDataString(System.String)" /> method converts all characters, except for RFC 3986 unreserved characters, to their hexadecimal representation. All Unicode characters are converted to UTF-8 format before being escaped. </para>
@@ -995,6 +1026,10 @@ public class UriTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string to its escaped representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that contains the escaped representation of <paramref name="stringToEscape" />.</para>
+        </returns>
         <param name="stringToEscape">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to escape.</param>
       </Docs>
@@ -1021,10 +1056,6 @@ public class UriTest {
         <Parameter Name="str" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing the escaped representation of
-<paramref name="str" /> .</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Uri.EscapeString(System.String)" /> method converts RFC 2396 reserved characters and all characters with a character value greater than 127 to hexadecimal representation. All Unicode characters are converted to UTF-8 format before being escaped.</para>
@@ -1035,6 +1066,10 @@ public class UriTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string to its escaped representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The escaped representation of the string.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to transform to its escaped representation. </param>
       </Docs>
@@ -1055,7 +1090,6 @@ public class UriTest {
         <Parameter Name="stringToEscape" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Uri.EscapeUriString(System.String)" /> method to prepare an unescaped URI string to be a parameter to the <see cref="M:System.Uri.#ctor(System.String,System.UriKind)" /> constructor.</para>
@@ -1068,6 +1102,10 @@ public class UriTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a URI string to its escaped representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that contains the escaped representation of <paramref name="stringToEscape" />.</para>
+        </returns>
         <param name="stringToEscape">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to escape.</param>
       </Docs>
@@ -1141,11 +1179,6 @@ public class UriTest {
         <Parameter Name="digit" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Int32" /> containing an integer from 0 - 15 that corresponds to the specified hexadecimal
- digit.
- </para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="digit " />is not a valid hexadecimal digit (0-9, a-f, A-F).</exception>
         <remarks>
@@ -1156,6 +1189,10 @@ public class UriTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the decimal value of a hexadecimal digit.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Int32" /> value that contains a number from 0 to 15 that corresponds to the specified hexadecimal digit.</para>
+        </returns>
         <param name="digit">
           <attribution license="cc4" from="Microsoft" modified="false" />The hexadecimal digit (0-9, a-f, A-F) to convert. </param>
       </Docs>
@@ -1177,7 +1214,6 @@ public class UriTest {
         <Parameter Name="format" Type="System.UriFormat" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When <see cref="F:System.UriComponents.Query" /> or <see cref="F:System.UriComponents.Fragment" /> is specified alone, the return value includes the delimiter. The <see cref="F:System.UriComponents.Scheme" />, <see cref="F:System.UriComponents.UserInfo" />, <see cref="F:System.UriComponents.Host" />, <see cref="F:System.UriComponents.Port" />, and <see cref="F:System.UriComponents.Path" /> components do not include the delimiter. For all other <see cref="T:System.UriComponents" /> values, and combinations of values, the delimiters are included in the returned value.</para>
@@ -1192,6 +1228,10 @@ public class UriTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the specified components of the current instance using the specified escaping for special characters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that contains the components.</para>
+        </returns>
         <param name="components">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of the <see cref="T:System.UriComponents" /> values that specifies which parts of the current instance to return to the caller.</param>
         <param name="format">
@@ -1213,9 +1253,6 @@ public class UriTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the hash code for this instance.</para>
-        </returns>
         <remarks>
           <para> The hash code is generated without the fragment component.
       For example, the URIs "http://www.contoso.com/index.htm#search"
@@ -1231,6 +1268,10 @@ public class UriTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash code for the URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Int32" /> containing the hash value generated for this URI.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1251,12 +1292,6 @@ public class UriTest {
         <Parameter Name="part" Type="System.UriPartial" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing all
-   components up to the specified portion of the URI, or <see cref="F:System.String.Empty" /> if
-   the current instance does not contain the component identified by
-<paramref name="part" /> .</para>
-        </returns>
         <exception cref="T:System.ArgumentException">The <paramref name="part" /> parameter is not a valid <see cref="T:System.UriPartial" /> value.</exception>
         <example>
           <para>The following example demonstrates the <see cref="M:System.Uri.GetLeftPart(System.UriPartial)" /> method.</para>
@@ -1452,6 +1487,10 @@ public class UriTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the specified portion of a <see cref="T:System.Uri" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that contains the specified portion of the <see cref="T:System.Uri" /> instance.</para>
+        </returns>
         <param name="part">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.UriPartial" /> values that specifies the end of the URI portion to return. </param>
       </Docs>
@@ -1501,10 +1540,6 @@ public class UriTest {
         <Parameter Name="character" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.String" /> containing the escaped hexadecimal representation of the specified character.
-   </para>
-        </returns>
         <remarks>
           <para> The returned string is in the
       form "%XX", where X represents a hexadecimal digit (0-9, A-F).</para>
@@ -1514,6 +1549,10 @@ public class UriTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a specified character into its hexadecimal equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hexadecimal representation of the specified character.</para>
+        </returns>
         <param name="character">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to convert to hexadecimal representation. </param>
       </Docs>
@@ -1687,13 +1726,6 @@ public class UriTest {
         <Parameter Name="character" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the specified character is not acceptable for use in a file
-   system name; otherwise, <see langword="false" />.</para>
-          <para>The value returned by this
-   method is implementation-specific.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The character is analyzed according to the rules for the NTFS file system.</para>
@@ -1702,6 +1734,10 @@ public class UriTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets whether a character is invalid in a file system name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Boolean" /> value that is true if the specified character is invalid; otherwise false.</para>
+        </returns>
         <param name="character">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Char" /> to test. </param>
       </Docs>
@@ -1722,7 +1758,6 @@ public class UriTest {
         <Parameter Name="uri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -1840,6 +1875,10 @@ public class UriTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current <see cref="T:System.Uri" /> instance is a base of the specified <see cref="T:System.Uri" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current <see cref="T:System.Uri" /> instance is a base of <paramref name="uri" />; otherwise, false.</para>
+        </returns>
         <param name="uri">
           <attribution license="cc4" from="Microsoft" modified="false" />The specified <see cref="T:System.Uri" /> instance to test. </param>
       </Docs>
@@ -1901,12 +1940,6 @@ public class UriTest {
         <Parameter Name="character" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the
-   specified character is required to
-   be escaped; otherwise, <see langword="false" /> .</para>
-        </returns>
         <remarks>
           <para>This method returns <see langword="true" /> for the following characters:
    </para>
@@ -1987,6 +2020,10 @@ public class UriTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets whether the specified character should be escaped.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Boolean" /> value that is true if the specified character should be escaped; otherwise, false.</para>
+        </returns>
         <param name="character">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Char" /> to test. </param>
       </Docs>
@@ -2041,13 +2078,6 @@ public class UriTest {
         <Parameter Name="character" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true " />if the
-   character is a valid hexadecimal digit (0-9, A-F, a-f);
-   otherwise <see langword="false" />.
-   </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Hexadecimal digits are the digits 0 to 9 and the letters A-F or a-f.</para>
@@ -2056,6 +2086,10 @@ public class UriTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a specified character is a valid hexadecimal digit.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Boolean" /> value that is true if the character is a valid hexadecimal digit; otherwise false.</para>
+        </returns>
         <param name="character">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to validate. </param>
       </Docs>
@@ -2079,14 +2113,6 @@ public class UriTest {
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true " />if the 
-   specified location in <paramref name="pattern " />contains a
-   substring in escaped hexadecimal encoding
-   format; otherwise, <see langword="false" />.
-   </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Uri.IsHexEncoding(System.String,System.Int32)" /> method checks for hexadecimal encoding that follows the pattern "%hexhex" in a string, where "hex" is a digit from 0 to 9 or a letter from A-F (case-insensitive).</para>
@@ -2095,6 +2121,10 @@ public class UriTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a character in a string is hexadecimal encoded.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Boolean" /> value that is true if <paramref name="pattern" /> is hexadecimal encoded at the specified location; otherwise, false.</para>
+        </returns>
         <param name="pattern">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to check. </param>
         <param name="index">
@@ -2179,11 +2209,6 @@ public class UriTest {
         <Parameter Name="character" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="character" /> is a URI reserved character as defined by IETF RFC
-   2396; otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>
           <para>The following characters are reserved for the use in URI:</para>
           <list type="table">
@@ -2246,6 +2271,10 @@ public class UriTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets whether the specified character is a reserved character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Boolean" /> value that is true if the specified character is a reserved character otherwise, false.</para>
+        </returns>
         <param name="character">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Char" /> to test. </param>
       </Docs>
@@ -2288,7 +2317,6 @@ public class UriTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The string is considered to be well-formed in accordance with RFC 2396 and RFC 2732 by default. If International Resource Identifiers (IRIs) or Internationalized Domain Name (IDN) parsing is enabled, the string is considered to be well-formed in accordance with RFC 3986 and RFC 3987 </para>
@@ -2362,6 +2390,10 @@ public class UriTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the string used to construct this <see cref="T:System.Uri" /> was well-formed and is not required to be further escaped.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Boolean" /> value that is true if the string was well-formed; else false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsWellFormedUriString">
@@ -2380,7 +2412,6 @@ public class UriTest {
         <Parameter Name="uriKind" Type="System.UriKind" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>By default, the string is considered well-formed in accordance with RFC 2396 and RFC 2732. If International Resource Identifiers (IRIs) or Internationalized Domain Name (IDN) parsing is enabled, the string is considered well-formed in accordance with RFC 3986 and RFC 3987.</para>
@@ -2452,6 +2483,10 @@ public class UriTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the string is well-formed by attempting to construct a URI with the string and ensures that the string does not require further escaping.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Boolean" /> value that is true if the string was well-formed; else false.</para>
+        </returns>
         <param name="uriString">
           <attribution license="cc4" from="Microsoft" modified="false" />The string used to attempt to construct a <see cref="T:System.Uri" />.</param>
         <param name="uriKind">
@@ -2512,13 +2547,6 @@ public class UriTest {
         <Parameter Name="toUri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> with
-   the difference between the current instance and <paramref name="toUri" /> if the two
-   URIs are the same except for the path information. If the two
-   URIs differ in more than the <see cref="P:System.Uri.AbsolutePath" />, this method returns the <see cref="T:System.String" />
- representation of <paramref name="toUri" />.</para>
-        </returns>
         <example>
           <para>The following example demonstrates the <see cref="M:System.Uri.MakeRelative(System.Uri)" />
 method.</para>
@@ -2607,6 +2635,11 @@ public class UriTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the difference between two <see cref="T:System.Uri" /> instances.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If the hostname and scheme of this URI instance and <paramref name="toUri" /> are the same, then this method returns a <see cref="T:System.String" /> that represents a relative URI that, when appended to the current URI instance, yields the <paramref name="toUri" /> parameter.</para>
+          <para>If the hostname or scheme is different, then this method returns a <see cref="T:System.String" /> that represents the <paramref name="toUri" /> parameter.</para>
+        </returns>
         <param name="toUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI to compare to the current URI. </param>
       </Docs>
@@ -2627,7 +2660,6 @@ public class UriTest {
         <Parameter Name="uri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following table shows the URI instance, <paramref name="toUri" />, and the results of calling <see cref="M:System.Uri.MakeRelativeUri(System.Uri)" />.</para>
@@ -2698,6 +2730,11 @@ public class UriTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the difference between two <see cref="T:System.Uri" /> instances.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If the hostname and scheme of this URI instance and <paramref name="uri" /> are the same, then this method returns a relative <see cref="T:System.Uri" /> that, when appended to the current URI instance, yields <paramref name="uri" />.</para>
+          <para>If the hostname or scheme is different, then this method returns a <see cref="T:System.Uri" />  that represents the <paramref name="uri" /> parameter.</para>
+        </returns>
         <param name="uri">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI to compare to the current URI.</param>
       </Docs>
@@ -2718,7 +2755,6 @@ public class UriTest {
         <Parameter Name="uri2" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload uses the <see cref="M:System.Uri.Equals(System.Object)" /> method to determine whether the two <see cref="T:System.Uri" /> instances are equivalent. <see cref="P:System.Uri.UserInfo" /> and <see cref="P:System.Uri.Fragment" /> content is ignored when making this comparison.</para>
@@ -2727,6 +2763,10 @@ public class UriTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two <see cref="T:System.Uri" /> instances have the same value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Boolean" /> value that is true if the <see cref="T:System.Uri" /> instances are equivalent; otherwise, false.</para>
+        </returns>
         <param name="uri1">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Uri" /> instance to compare with <paramref name="uri2" />. </param>
         <param name="uri2">
@@ -2749,7 +2789,6 @@ public class UriTest {
         <Parameter Name="uri2" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload uses the <see cref="M:System.Uri.Equals(System.Object)" /> method to determine whether the two <see cref="T:System.Uri" /> instances are not equivalent. <see cref="P:System.Uri.UserInfo" /> and <see cref="P:System.Uri.Fragment" /> content is ignored when making this comparison.</para>
@@ -2758,6 +2797,10 @@ public class UriTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two <see cref="T:System.Uri" /> instances do not have the same value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Boolean" /> value that is true if the two <see cref="T:System.Uri" /> instances are not equal; otherwise, false. If either parameter is null, this method returns true.</para>
+        </returns>
         <param name="uri1">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Uri" /> instance to compare with <paramref name="uri2" />. </param>
         <param name="uri2">
@@ -3261,11 +3304,6 @@ public class UriTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.String" /> containing the unescaped, canonical form of the URI
-   represented by the current instance.
-   </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The string returned by this method does not contain port information when the port is the default port for the scheme.</para>
@@ -3277,6 +3315,10 @@ public class UriTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a canonical string representation for the specified <see cref="T:System.Uri" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> instance that contains the unescaped canonical representation of the <see cref="T:System.Uri" /> instance. All characters are unescaped except #, ?, and %.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -3377,11 +3419,6 @@ public class UriTest {
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing <paramref name="path" /> with its escaped characters
- converted to their unescaped equivalents. If path is <see langword="null" /> or a
- zero-length string, returns <see cref="F:System.String.Empty" />.</para>
-        </returns>
         <remarks>
           <block subset="none" type="note">
             <para> Escape sequences can be hex-encoded reserved characters (for example
@@ -3392,6 +3429,10 @@ public class UriTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string by replacing any escape sequences with their unescaped representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that contains the unescaped value of the <paramref name="path" /> parameter.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> to convert. </param>
       </Docs>
@@ -3412,7 +3453,6 @@ public class UriTest {
         <Parameter Name="stringToUnescape" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You should use this method with care. Unescaping a string that has been previously unescaped can lead to ambiguities and errors.</para>
@@ -3422,6 +3462,10 @@ public class UriTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a string to its unescaped representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that contains the unescaped representation of <paramref name="stringToUnescape" />. </para>
+        </returns>
         <param name="stringToUnescape">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to unescape.</param>
       </Docs>
diff --git a/mcs/class/System/Documentation/en/System/UriBuilder.xml b/mcs/class/System/Documentation/en/System/UriBuilder.xml
index aa6e50e160e..6b4be11e6d3 100644
--- a/mcs/class/System/Documentation/en/System/UriBuilder.xml
+++ b/mcs/class/System/Documentation/en/System/UriBuilder.xml
@@ -379,14 +379,6 @@
         <Parameter Name="rparam" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if
-<paramref name="rparam" /><paramref name=" " /> 
-represents the same URI as the current instance. If <paramref name="rparam" /> is
-<see langword="null" /> 
-, returns <see langword="false" /> .</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.UriBuilder.Equals(System.Object)" /> method compares a specified <see cref="T:System.Uri" /> instance with the <see cref="T:System.Uri" /> instance built by the <see cref="T:System.UriBuilder" /> instance. If the two are the same, the <see cref="M:System.UriBuilder.Equals(System.Object)" /> method returns true.</para>
@@ -395,6 +387,10 @@ represents the same URI as the current instance. If <paramref name="rparam" /> i
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares an existing <see cref="T:System.Uri" /> instance with the contents of the <see cref="T:System.UriBuilder" /> for equality.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="rparam" /> represents the same <see cref="T:System.Uri" /> as the <see cref="T:System.Uri" /> constructed by this <see cref="T:System.UriBuilder" /> instance; otherwise, false.</para>
+        </returns>
         <param name="rparam">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current instance. </param>
       </Docs>
@@ -447,9 +443,6 @@ represents the same URI as the current instance. If <paramref name="rparam" /> i
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the hash code for this instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The hash code is generated without including any fragment. The URIs http://www.contoso.com/index.htm#search and http://www.contoso.com/index.htm generate the same hash code.</para>
@@ -460,6 +453,10 @@ represents the same URI as the current instance. If <paramref name="rparam" /> i
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for the URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code generated for the URI.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -728,10 +725,6 @@ represents the same URI as the current instance. If <paramref name="rparam" /> i
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.String" /> containing the escaped URI contained in the current <see cref="T:System.UriBuilder" /> instance.
-   </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The display string contains the <see cref="P:System.UriBuilder.Port" /> property value if the <see cref="P:System.UriBuilder.Port" /> property was set or the port was specified when the <see cref="T:System.UriBuilder" /> was constructed using of the <see cref="M:System.UriBuilder.#ctor" /> methods that accept a port number parameter except for the case when the <see cref="P:System.UriBuilder.Port" />.property value was set to a value of -1 to indicate the default port.</para>
@@ -741,6 +734,11 @@ represents the same URI as the current instance. If <paramref name="rparam" /> i
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the display string for the specified <see cref="T:System.UriBuilder" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string that contains the unescaped display string of the <see cref="T:System.UriBuilder" />.</para>
+          <para />
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/System/Documentation/en/System/UriParser.xml b/mcs/class/System/Documentation/en/System/UriParser.xml
index 9afebe24f96..dc2ae11043e 100644
--- a/mcs/class/System/Documentation/en/System/UriParser.xml
+++ b/mcs/class/System/Documentation/en/System/UriParser.xml
@@ -59,7 +59,6 @@
         <Parameter Name="format" Type="System.UriFormat" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.UriParser.GetComponents(System.Uri,System.UriComponents,System.UriFormat)" /> method to determine the value of various parts of the URI, such as the <see cref="F:System.UriComponents.Scheme" />, <see cref="F:System.UriComponents.Host" />, or <see cref="F:System.UriComponents.Port" />.</para>
@@ -69,6 +68,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the components from a URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the components.</para>
+        </returns>
         <param name="uri">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI to parse.</param>
         <param name="components">
@@ -115,12 +118,15 @@
         <Parameter Name="relativeUri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether <paramref name="baseUri" /> is a base URI for <paramref name="relativeUri" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="baseUri" /> is a base URI for <paramref name="relativeUri" />; otherwise, false.</para>
+        </returns>
         <param name="baseUri">
           <attribution license="cc4" from="Microsoft" modified="false" />The base URI.</param>
         <param name="relativeUri">
@@ -142,13 +148,16 @@
         <Parameter Name="schemeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the parser for a scheme is registered.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="schemeName" /> has been registered; otherwise, false.</para>
+        </returns>
         <param name="schemeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The scheme name to check.</param>
       </Docs>
@@ -168,7 +177,6 @@
         <Parameter Name="uri" Type="System.Uri" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.UriParser.IsWellFormedOriginalString(System.Uri)" /> method will return false if:</para>
@@ -191,6 +199,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a URI is well-formed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="uri" /> is well-formed; otherwise, false.</para>
+        </returns>
         <param name="uri">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI to check.</param>
       </Docs>
@@ -208,7 +220,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default implementation returns the same <see cref="T:System.UriParser" /> instance. You may need to override this method and return a different <see cref="T:System.UriParser" /> for each invocation if you are operating in a multithreaded environment.</para>
@@ -217,6 +228,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invoked by a <see cref="T:System.Uri" /> constructor to get a <see cref="T:System.UriParser" /> instance</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.UriParser" /> for the constructed <see cref="T:System.Uri" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="OnRegister">
diff --git a/mcs/class/System/Documentation/en/System/UriTypeConverter.xml b/mcs/class/System/Documentation/en/System/UriTypeConverter.xml
index 0573691d1c0..49b1918b353 100644
--- a/mcs/class/System/Documentation/en/System/UriTypeConverter.xml
+++ b/mcs/class/System/Documentation/en/System/UriTypeConverter.xml
@@ -54,13 +54,16 @@
         <Parameter Name="sourceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether this converter can convert an object of the given type to the type of this converter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="sourceType" /> is a <see cref="T:System.String" /> type or a <see cref="T:System.Uri" /> type can be assigned from <paramref name="sourceType" />; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" />  that provides a format context.</param>
         <param name="sourceType">
@@ -83,13 +86,16 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether this converter can convert the object to the specified type, using the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="destinationType" /> is of type <see cref="T:System.ComponentModel.Design.Serialization.InstanceDescriptor" />, <see cref="T:System.String" />, or <see cref="T:System.Uri" />; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" />  that provides a format context.</param>
         <param name="destinationType">
@@ -113,13 +119,16 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given object to the type of this converter, using the specified context and culture information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" />  that provides a format context.</param>
         <param name="culture">
@@ -146,13 +155,16 @@
         <Parameter Name="destinationType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a given value object to the specified type, using the specified context and culture information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that represents the converted value.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" />  that provides a format context.</param>
         <param name="culture">
@@ -179,13 +191,16 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns whether the given value object is a <see cref="T:System.Uri" /> or a <see cref="T:System.Uri" /> can be created from it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is a <see cref="T:System.Uri" /> or a <see cref="T:System.String" /> from which a <see cref="T:System.Uri" /> can be created; otherwise, false.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ComponentModel.ITypeDescriptorContext" />  that provides a format context.</param>
         <param name="value">
diff --git a/mcs/class/corlib/Documentation/en/Microsoft.Win32/Registry.xml b/mcs/class/corlib/Documentation/en/Microsoft.Win32/Registry.xml
index c934ed60870..a303424351b 100644
--- a/mcs/class/corlib/Documentation/en/Microsoft.Win32/Registry.xml
+++ b/mcs/class/corlib/Documentation/en/Microsoft.Win32/Registry.xml
@@ -213,7 +213,6 @@
         <Parameter Name="defaultValue" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The string <paramref name="valueName" /> is not case-sensitive.</para>
@@ -233,6 +232,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the value associated with the specified name, in the specified registry key. If the name is not found in the specified key, returns a default value that you provide, or null if the specified key does not exist. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>null if the subkey specified by <paramref name="keyName" /> does not exist; otherwise, the value associated with <paramref name="valueName" />, or <paramref name="defaultValue" /> if <paramref name="valueName" /> is not found.</para>
+        </returns>
         <param name="keyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The full registry path of the key, beginning with a valid registry root, such as "HKEY_CURRENT_USER".</param>
         <param name="valueName">
diff --git a/mcs/class/corlib/Documentation/en/Microsoft.Win32/RegistryKey.xml b/mcs/class/corlib/Documentation/en/Microsoft.Win32/RegistryKey.xml
index 5060c54d51f..0276c64509a 100644
--- a/mcs/class/corlib/Documentation/en/Microsoft.Win32/RegistryKey.xml
+++ b/mcs/class/corlib/Documentation/en/Microsoft.Win32/RegistryKey.xml
@@ -80,7 +80,6 @@
         <Parameter Name="subkey" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>The newly created key.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In order to perform this action, the user must have permission at this level and below in the registry hierarchy.</para>
@@ -92,6 +91,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new subkey or opens an existing subkey for write access.  </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created subkey, or null if the operation failed. If a zero-length string is specified for <paramref name="subkey" />, the current <see cref="T:Microsoft.Win32.RegistryKey" /> object is returned.</para>
+        </returns>
         <param name="subkey">
           <attribution license="cc4" from="Microsoft" modified="false" />The name or path of the subkey to create or open. This string is not case-sensitive.</param>
       </Docs>
@@ -117,7 +120,6 @@
         <Parameter Name="permissionCheck" Type="Microsoft.Win32.RegistryKeyPermissionCheck" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -131,6 +133,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new subkey or opens an existing subkey for write access, using the specified permission check option. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created subkey, or null if the operation failed. If a zero-length string is specified for <paramref name="subkey" />, the current <see cref="T:Microsoft.Win32.RegistryKey" /> object is returned.</para>
+        </returns>
         <param name="subkey">
           <attribution license="cc4" from="Microsoft" modified="false" />The name or path of the subkey to create or open. This string is not case-sensitive.</param>
         <param name="permissionCheck">
@@ -158,7 +164,6 @@
         <Parameter Name="options" Type="Microsoft.Win32.RegistryOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To obtain the current <see cref="T:Microsoft.Win32.RegistryKey" /> object, specify an empty string ("") for <paramref name="subkey" />.</para>
@@ -167,6 +172,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a subkey or opens a subkey for write access, using the specified permission check and registry options. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created subkey, or null if the operation failed.</para>
+        </returns>
         <param name="subkey">
           <attribution license="cc4" from="Microsoft" modified="false" />The name or path of the subkey to create or open. </param>
         <param name="permissionCheck">
@@ -197,7 +206,6 @@
         <Parameter Name="registrySecurity" Type="System.Security.AccessControl.RegistrySecurity" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -214,6 +222,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new subkey or opens an existing subkey for write access, using the specified permission check option and registry security. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created subkey, or null if the operation failed. If a zero-length string is specified for <paramref name="subkey" />, the current <see cref="T:Microsoft.Win32.RegistryKey" /> object is returned.</para>
+        </returns>
         <param name="subkey">
           <attribution license="cc4" from="Microsoft" modified="false" />The name or path of the subkey to create or open. This string is not case-sensitive.</param>
         <param name="permissionCheck">
@@ -244,7 +256,6 @@
         <Parameter Name="registrySecurity" Type="System.Security.AccessControl.RegistrySecurity" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To obtain the current <see cref="T:Microsoft.Win32.RegistryKey" /> object, specify an empty string ("") for <paramref name="subkey" />.</para>
@@ -253,6 +264,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a subkey or opens a subkey for write access, using the specified permission check option, registry option, and registry security.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created subkey, or null if the operation failed.  </para>
+        </returns>
         <param name="subkey">
           <attribution license="cc4" from="Microsoft" modified="false" />The name or path of the subkey to create or open.</param>
         <param name="permissionCheck">
@@ -531,12 +546,15 @@
         <Parameter Name="handle" Type="Microsoft.Win32.SafeHandles.SafeRegistryHandle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a registry key from a specified handle.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A registry key.</para>
+        </returns>
         <param name="handle">
           <attribution license="cc4" from="Microsoft" modified="false" />The handle to the registry key.</param>
       </Docs>
@@ -561,7 +579,6 @@
         <Parameter Name="view" Type="Microsoft.Win32.RegistryView" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="view" /> parameter for this method is used in subsequent operations, such as opening subkeys. </para>
@@ -571,6 +588,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a registry key from a specified handle and registry view setting. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A registry key.</para>
+        </returns>
         <param name="handle">
           <attribution license="cc4" from="Microsoft" modified="false" />The handle to the registry key.</param>
         <param name="view">
@@ -590,7 +611,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -601,6 +621,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the access control security for the current registry key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that describes the access control permissions on the registry key represented by the current <see cref="T:Microsoft.Win32.RegistryKey" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetAccessControl">
@@ -618,7 +642,6 @@
         <Parameter Name="includeSections" Type="System.Security.AccessControl.AccessControlSections" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -629,6 +652,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified sections of the access control security for the current registry key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that describes the access control permissions on the registry key represented by the current <see cref="T:Microsoft.Win32.RegistryKey" />.</para>
+        </returns>
         <param name="includeSections">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of enumeration values that specifies the type of security information to get. </param>
       </Docs>
@@ -647,7 +674,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method does not recursively find names. It returns the names on the base level from which it was called.</para>
@@ -656,6 +682,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of strings that contains all the subkey names.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of strings that contains the names of the subkeys for the current key.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetValue">
@@ -674,7 +704,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>The value stored, or null if the given key does not exist on the Registrykey.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -694,6 +723,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the value associated with the specified name. Returns null if the name/value pair does not exist in the registry.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value associated with <paramref name="name" />, or null if <paramref name="name" /> is not found.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the value to retrieve. This string is not case-sensitive.</param>
       </Docs>
@@ -715,7 +748,6 @@
         <Parameter Name="defaultValue" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>The value associated with the key on the RegistryKey or the default value if not found.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this overload of <see cref="Overload:Microsoft.Win32.RegistryKey.GetValue" /> to handle the case where a name does not exist yet — for example, the first time your application is run. Whenever you call this overload, use the <paramref name="defaultValue" /> parameter to specify the value to return if <paramref name="name" /> does not exist.</para>
@@ -736,6 +768,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the value associated with the specified name. If the name is not found, returns the default value that you provide.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value associated with <paramref name="name" />, with any embedded environment variables left unexpanded, or <paramref name="defaultValue" /> if <paramref name="name" /> is not found.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the value to retrieve. This string is not case-sensitive.</param>
         <param name="defaultValue">
@@ -764,7 +800,6 @@
         <Parameter Name="options" Type="Microsoft.Win32.RegistryValueOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -780,6 +815,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the value associated with the specified name and retrieval options. If the name is not found, returns the default value that you provide.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value associated with <paramref name="name" />, processed according to the specified <paramref name="options" />, or <paramref name="defaultValue" /> if <paramref name="name" /> is not found.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the value to retrieve. This string is not case-sensitive.</param>
         <param name="defaultValue">
@@ -808,7 +847,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -821,6 +859,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the registry data type of the value associated with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The registry data type of the value associated with <paramref name="name" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the value whose registry data type is to be retrieved. This string is not case-sensitive.</param>
       </Docs>
@@ -839,7 +881,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If no value names for the key are found, an empty array is returned.</para>
@@ -849,6 +890,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of strings that contains all the value names associated with this key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of strings that contains the value names for the current key.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Handle">
@@ -919,12 +964,15 @@
         <Parameter Name="view" Type="Microsoft.Win32.RegistryView" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a new <see cref="T:Microsoft.Win32.RegistryKey" /> that represents the requested key on the local machine with the specified view.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The requested registry key.</para>
+        </returns>
         <param name="hKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The HKEY to open.</param>
         <param name="view">
@@ -948,7 +996,6 @@
         <Parameter Name="machineName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The local machine registry is opened if <paramref name="machineName" /> is <see cref="F:System.String.Empty" />. The requested key must be a root key on the remote machine, and is identified by the appropriate <see cref="T:Microsoft.Win32.RegistryHive" /> value.</para>
@@ -958,6 +1005,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a new <see cref="T:Microsoft.Win32.RegistryKey" /> that represents the requested key on a remote machine.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The requested registry key.</para>
+        </returns>
         <param name="hKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The HKEY to open, from the <see cref="T:Microsoft.Win32.RegistryHive" /> enumeration. </param>
         <param name="machineName">
@@ -985,7 +1036,6 @@
         <Parameter Name="view" Type="Microsoft.Win32.RegistryView" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The local machine registry is opened if <paramref name="machineName" /> is <see cref="F:System.String.Empty" />. The requested key must be a root key on the remote machine, and is identified by the appropriate <see cref="T:Microsoft.Win32.RegistryHive" /> value.</para>
@@ -996,6 +1046,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a new registry key that represents the requested key on a remote machine with the specified view.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The requested registry key.</para>
+        </returns>
         <param name="hKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The HKEY to open from the <see cref="T:Microsoft.Win32.RegistryHive" /> enumeration.. </param>
         <param name="machineName">
@@ -1020,7 +1074,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You must open a key before it can be manipulated with other methods and properties. To modify a key, you must open it with an overload of the <see cref="Overload:Microsoft.Win32.RegistryKey.OpenSubKey" /> method that allows you to specify write access, such as the <see cref="M:Microsoft.Win32.RegistryKey.OpenSubKey(System.String,Microsoft.Win32.RegistryKeyPermissionCheck)" /> overload or the <see cref="M:Microsoft.Win32.RegistryKey.OpenSubKey(System.String,System.Boolean)" /> overload.</para>
@@ -1031,6 +1084,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a subkey as read-only.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The subkey requested, or null if the operation failed.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name or path of the subkey to open as read-only. </param>
       </Docs>
@@ -1056,7 +1113,6 @@
         <Parameter Name="permissionCheck" Type="Microsoft.Win32.RegistryKeyPermissionCheck" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1068,6 +1124,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the specified subkey for read or read/write access.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The subkey requested, or null if the operation failed.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name or path of the subkey to create or open.</param>
         <param name="permissionCheck">
@@ -1091,7 +1151,6 @@
         <Parameter Name="writable" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the requested key does not exist, this method returns null instead of throwing an exception.</para>
@@ -1102,6 +1161,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a specified subkey, and specifies whether write access is to be applied to the key. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The subkey requested, or null if the operation failed.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />Name or path of the subkey to open. </param>
         <param name="writable">
@@ -1130,7 +1193,6 @@
         <Parameter Name="rights" Type="System.Security.AccessControl.RegistryRights" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1143,6 +1205,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the specified subkey for read or read/write access, requesting the specified access rights.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The subkey requested, or null if the operation failed.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name or path of the subkey to create or open.</param>
         <param name="permissionCheck">
@@ -1344,7 +1410,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value includes the registry path of the specified key and the hexadecimal value for the key. The registry path includes the absolute root of the specified key, always starts at one of the base keys for the registry, for example, HKEY_LOCAL_MACHINE.</para>
@@ -1353,6 +1418,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a string representation of this key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representing the key. If the specified key is invalid (cannot be found) then null is returned.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ValueCount">
diff --git a/mcs/class/corlib/Documentation/en/System.Collections.Concurrent/ConcurrentDictionary`2.xml b/mcs/class/corlib/Documentation/en/System.Collections.Concurrent/ConcurrentDictionary`2.xml
index 8ecabbccc12..cd514030051 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections.Concurrent/ConcurrentDictionary`2.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections.Concurrent/ConcurrentDictionary`2.xml
@@ -396,7 +396,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The enumerator returned from the dictionary is safe to use concurrently with reads and writes to the dictionary, however it does not represent a moment-in-time snapshot of the dictionary. The contents exposed through the enumerator may contain modifications made to the dictionary after <see cref="M:System.Collections.Concurrent.ConcurrentDictionary`2.GetEnumerator" /> was called.</para>
@@ -405,6 +404,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the <see cref="T:System.Collections.Concurrent.ConcurrentDictionary`2" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator for the <see cref="T:System.Collections.Concurrent.ConcurrentDictionary`2" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOrAdd">
@@ -749,12 +752,15 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets whether the <see cref="T:System.Collections.Generic.IDictionary`2" /> contains an element with the specified key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Collections.Generic.IDictionary`2" /> contains an element with the specified key; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key to locate in the <see cref="T:System.Collections.Generic.IDictionary`2" />.</param>
       </Docs>
@@ -771,12 +777,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides a <see cref="T:System.Collections.IDictionaryEnumerator" /> for the <see cref="T:System.Collections.Generic.IDictionary`2" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.IDictionaryEnumerator" /> for the <see cref="T:System.Collections.Generic.IDictionary`2" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IDictionary.IsFixedSize">
@@ -910,7 +919,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The enumerator returned from the dictionary is safe to use concurrently with reads and writes to the dictionary, however it does not represent a moment-in-time snapshot of the dictionary. The contents exposed through the enumerator may contain modifications made to the dictionary after <see cref="M:System.Collections.Concurrent.ConcurrentDictionary`2.GetEnumerator" /> was called.</para>
@@ -919,6 +927,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the <see cref="T:System.Collections.Concurrent.ConcurrentDictionary`2" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator for the <see cref="T:System.Collections.Concurrent.ConcurrentDictionary`2" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToArray">
@@ -933,12 +945,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the key and value pairs stored in the <see cref="T:System.Collections.Concurrent.ConcurrentDictionary`2" /> to a new array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new array containing a snapshot of key and value pairs copied from the <see cref="T:System.Collections.Concurrent.ConcurrentDictionary`2" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryAdd">
diff --git a/mcs/class/corlib/Documentation/en/System.Collections.Concurrent/ConcurrentQueue`1.xml b/mcs/class/corlib/Documentation/en/System.Collections.Concurrent/ConcurrentQueue`1.xml
index dad85c4eadc..0df84bdf833 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections.Concurrent/ConcurrentQueue`1.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections.Concurrent/ConcurrentQueue`1.xml
@@ -143,7 +143,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The enumeration represents a moment-in-time snapshot of the contents of the queue. It does not reflect any updates to the collection after <see cref="M:System.Collections.Concurrent.ConcurrentQueue`1.GetEnumerator" /> was called. The enumerator is safe to use concurrently with reads from and writes to the queue.</para>
@@ -153,6 +152,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the <see cref="T:System.Collections.Concurrent.ConcurrentQueue`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator for the contents of the <see cref="T:System.Collections.Concurrent.ConcurrentQueue`1" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsEmpty">
@@ -293,12 +296,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through a collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToArray">
@@ -313,12 +319,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the elements stored in the <see cref="T:System.Collections.Concurrent.ConcurrentQueue`1" /> to a new array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new array containing a snapshot of elements copied from the <see cref="T:System.Collections.Concurrent.ConcurrentQueue`1" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryDequeue">
diff --git a/mcs/class/corlib/Documentation/en/System.Collections.Concurrent/ConcurrentStack`1.xml b/mcs/class/corlib/Documentation/en/System.Collections.Concurrent/ConcurrentStack`1.xml
index 2d5a35c0f4b..253d6bbf021 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections.Concurrent/ConcurrentStack`1.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections.Concurrent/ConcurrentStack`1.xml
@@ -143,7 +143,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The enumeration represents a moment-in-time snapshot of the contents of the stack. It does not reflect any updates to the collection after <see cref="M:System.Collections.Concurrent.ConcurrentStack`1.GetEnumerator" /> was called. The enumerator is safe to use concurrently with reads from and writes to the stack. The enumerator returns items in LIFO (last-in, first-out) order.</para>
@@ -152,6 +151,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the <see cref="T:System.Collections.Concurrent.ConcurrentStack`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator for the <see cref="T:System.Collections.Concurrent.ConcurrentStack`1" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsEmpty">
@@ -354,7 +357,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The enumeration represents a moment-in-time snapshot of the contents of the stack. It does not reflect any updates to the collection after <see cref="M:System.Collections.Concurrent.ConcurrentStack`1.GetEnumerator" /> was called. The enumerator is safe to use concurrently with reads from and writes to the stack.</para>
@@ -363,6 +365,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through a collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToArray">
@@ -377,12 +383,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the items stored in the <see cref="T:System.Collections.Concurrent.ConcurrentStack`1" /> to a new array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new array containing a snapshot of elements copied from the <see cref="T:System.Collections.Concurrent.ConcurrentStack`1" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryPeek">
diff --git a/mcs/class/corlib/Documentation/en/System.Collections.Concurrent/IProducerConsumerCollection`1.xml b/mcs/class/corlib/Documentation/en/System.Collections.Concurrent/IProducerConsumerCollection`1.xml
index db7af9efd59..51316afd282 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections.Concurrent/IProducerConsumerCollection`1.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections.Concurrent/IProducerConsumerCollection`1.xml
@@ -62,7 +62,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method provides a snapshot of the underlying collection. It is possible for other threads to add or remove items immediately after the array is made.</para>
@@ -71,6 +70,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the elements contained in the <see cref="T:System.Collections.Concurrent.IProducerConsumerCollection`1" /> to a new array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new array containing the elements copied from the <see cref="T:System.Collections.Concurrent.IProducerConsumerCollection`1" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryAdd">
diff --git a/mcs/class/corlib/Documentation/en/System.Collections.Concurrent/OrderablePartitioner`1.xml b/mcs/class/corlib/Documentation/en/System.Collections.Concurrent/OrderablePartitioner`1.xml
index 0841a0ecf39..65d63877474 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections.Concurrent/OrderablePartitioner`1.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections.Concurrent/OrderablePartitioner`1.xml
@@ -69,7 +69,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para> The returned object implements the <see cref="T:System.Collections.Generic.IEnumerable`1" /> interface. Calling <see cref="M:System.Collections.Generic.IEnumerable`1.GetEnumerator" /> on the object creates another partition over the sequence.</para>
@@ -81,6 +80,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an object that can partition the underlying collection into a variable number of partitions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that can create partitions over the underlying data source.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOrderableDynamicPartitions">
@@ -95,7 +98,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para> The returned object implements the <see cref="T:System.Collections.Generic.IEnumerable`1" /> interface. Calling <see cref="M:System.Collections.Generic.IEnumerable`1.GetEnumerator" /> on the object creates another partition over the sequence.</para>
@@ -107,6 +109,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an object that can partition the underlying collection into a variable number of partitions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that can create partitions over the underlying data source.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOrderablePartitions">
@@ -123,7 +129,6 @@
         <Parameter Name="partitionCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Each partition is represented as an enumerator over key-value pairs.</para>
@@ -134,6 +139,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Partitions the underlying collection into the specified number of orderable partitions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A list containing <paramref name="partitionCount" /> enumerators.</para>
+        </returns>
         <param name="partitionCount">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of partitions to create.</param>
       </Docs>
@@ -152,7 +161,6 @@
         <Parameter Name="partitionCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default implementation provides the same behavior as <see cref="M:System.Collections.Concurrent.OrderablePartitioner`1.GetOrderablePartitions(System.Int32)" /> except that the returned set of partitions does not provide the keys for the elements.</para>
@@ -162,6 +170,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Partitions the underlying collection into the given number of ordered partitions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A list containing <paramref name="partitionCount" /> enumerators.</para>
+        </returns>
         <param name="partitionCount">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of partitions to create.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Collections.Concurrent/Partitioner.xml b/mcs/class/corlib/Documentation/en/System.Collections.Concurrent/Partitioner.xml
index 15456dfc0ca..9e1eab31837 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections.Concurrent/Partitioner.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections.Concurrent/Partitioner.xml
@@ -36,7 +36,6 @@
         <Parameter Name="toExclusive" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information and examples, see <format type="text/html"><a href="96153688-9a01-47c4-8430-909cee9a2887">Custom Partitioners for PLINQ and TPL</a></format>.</para>
@@ -45,6 +44,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a partitioner that chunks the user-specified range.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A partitioner.</para>
+        </returns>
         <param name="fromInclusive">
           <attribution license="cc4" from="Microsoft" modified="false" />The lower, inclusive bound of the range.</param>
         <param name="toExclusive">
@@ -66,7 +69,6 @@
         <Parameter Name="toExclusive" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information and examples, see <format type="text/html"><a href="96153688-9a01-47c4-8430-909cee9a2887">Custom Partitioners for PLINQ and TPL</a></format>.</para>
@@ -75,6 +77,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a partitioner that chunks the user-specified range.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A partitioner.</para>
+        </returns>
         <param name="fromInclusive">
           <attribution license="cc4" from="Microsoft" modified="false" />The lower, inclusive bound of the range.</param>
         <param name="toExclusive">
@@ -97,7 +103,6 @@
         <Parameter Name="rangeSize" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information and examples, see <format type="text/html"><a href="96153688-9a01-47c4-8430-909cee9a2887">Custom Partitioners for PLINQ and TPL</a></format>.</para>
@@ -106,6 +111,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a partitioner that chunks the user-specified range.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A partitioner.</para>
+        </returns>
         <param name="fromInclusive">
           <attribution license="cc4" from="Microsoft" modified="false" />The lower, inclusive bound of the range.</param>
         <param name="toExclusive">
@@ -130,7 +139,6 @@
         <Parameter Name="rangeSize" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information and examples, see <format type="text/html"><a href="96153688-9a01-47c4-8430-909cee9a2887">Custom Partitioners for PLINQ and TPL</a></format>.</para>
@@ -139,6 +147,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a partitioner that chunks the user-specified range.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A partitioner.</para>
+        </returns>
         <param name="fromInclusive">
           <attribution license="cc4" from="Microsoft" modified="false" />The lower, inclusive bound of the range.</param>
         <param name="toExclusive">
@@ -164,7 +176,6 @@
         <Parameter Name="source" Type="System.Collections.Generic.IEnumerable&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The ordering used in the created partitioner is determined by the natural order of the elements as retrieved from the source enumerable. For more information and examples, see <format type="text/html"><a href="96153688-9a01-47c4-8430-909cee9a2887">Custom Partitioners for PLINQ and TPL</a></format>.</para>
@@ -173,6 +184,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an orderable partitioner from a <see cref="T:System.Collections.Generic.IEnumerable`1" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An orderable partitioner based on the input array.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The enumerable to be partitioned.</param>
         <typeparam name="TSource">
@@ -197,7 +212,6 @@
         <Parameter Name="partitionerOptions" Type="System.Collections.Concurrent.EnumerablePartitionerOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The ordering used in the created partitioner is determined by the natural order of the elements as retrieved from the source enumerable.</para>
@@ -206,6 +220,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an orderable partitioner from a <see cref="T:System.Collections.Generic.IEnumerable`1" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An orderable partitioner based on the input array.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The enumerable to be partitioned.</param>
         <param name="partitionerOptions">
@@ -232,7 +250,6 @@
         <Parameter Name="loadBalance" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information and examples, see <format type="text/html"><a href="96153688-9a01-47c4-8430-909cee9a2887">Custom Partitioners for PLINQ and TPL</a></format>.</para>
@@ -241,6 +258,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an orderable partitioner from an <see cref="T:System.Collections.Generic.IList`1" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An orderable partitioner based on the input list.</para>
+        </returns>
         <param name="list">
           <attribution license="cc4" from="Microsoft" modified="false" />The list to be partitioned.</param>
         <param name="loadBalance">
diff --git a/mcs/class/corlib/Documentation/en/System.Collections.Concurrent/Partitioner`1.xml b/mcs/class/corlib/Documentation/en/System.Collections.Concurrent/Partitioner`1.xml
index e23193ade65..84483d69197 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections.Concurrent/Partitioner`1.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections.Concurrent/Partitioner`1.xml
@@ -53,7 +53,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para> The returned object implements the <see cref="T:System.Collections.Generic.IEnumerable`1" />interface. Calling <see cref="M:System.Collections.Generic.IEnumerable`1.GetEnumerator" /> on the object creates another partition over the sequence.</para>
@@ -63,6 +62,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an object that can partition the underlying collection into a variable number of partitions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that can create partitions over the underlying data source.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetPartitions">
@@ -79,7 +82,6 @@
         <Parameter Name="partitionCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A class that implements this method is expected to return exactly the number of partitions that are specified in <paramref name="partitionCount" />. If a partition contains no elements, then return an empty enumerator rather than null (Nothing in Visual Basic). For more information, see <format type="text/html"><a href="96153688-9a01-47c4-8430-909cee9a2887">Custom Partitioners for PLINQ and TPL</a></format>.</para>
@@ -88,6 +90,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Partitions the underlying collection into the given number of partitions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A list containing <paramref name="partitionCount" /> enumerators.</para>
+        </returns>
         <param name="partitionCount">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of partitions to create.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Collections.Generic/Comparer`1.xml b/mcs/class/corlib/Documentation/en/System.Collections.Generic/Comparer`1.xml
index b98038a076c..2343e6b085a 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections.Generic/Comparer`1.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections.Generic/Comparer`1.xml
@@ -146,7 +146,6 @@
         <Parameter Name="y" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -157,6 +156,49 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two objects and returns a value indicating whether one is less than, equal to, or greater than the other.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative values of <paramref name="x" /> and <paramref name="y" />, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Meaning </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero</para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="x" /> is less than <paramref name="y" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="x" /> equals <paramref name="y" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero</para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="x" /> is greater than <paramref name="y" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare.</param>
         <param name="y">
diff --git a/mcs/class/corlib/Documentation/en/System.Collections.Generic/EqualityComparer`1.xml b/mcs/class/corlib/Documentation/en/System.Collections.Generic/EqualityComparer`1.xml
index 9419e6440bd..8bf8d18b56d 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections.Generic/EqualityComparer`1.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections.Generic/EqualityComparer`1.xml
@@ -140,7 +140,6 @@
         <Parameter Name="y" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -151,6 +150,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified objects are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified objects are equal; otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare.</param>
         <param name="y">
@@ -172,7 +175,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -182,6 +184,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash code for the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the specified object.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> for which a hash code is to be returned.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Collections.Generic/IEnumerable`1.xml b/mcs/class/corlib/Documentation/en/System.Collections.Generic/IEnumerable`1.xml
index 90218c92d85..9dc6255a4e5 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections.Generic/IEnumerable`1.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections.Generic/IEnumerable`1.xml
@@ -46,10 +46,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Collections.Generic.IEnumerator&lt;T&gt;" />
-that can be used for simple iteration over a collection.</para>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -67,6 +63,10 @@ that can be used for simple iteration over a collection.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.Generic.IEnumerator`1" /> that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Collections.Generic/KeyValuePair`2.xml b/mcs/class/corlib/Documentation/en/System.Collections.Generic/KeyValuePair`2.xml
index 8a8d91278ae..827375555e1 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections.Generic/KeyValuePair`2.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections.Generic/KeyValuePair`2.xml
@@ -89,7 +89,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -102,6 +101,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of the <see cref="T:System.Collections.Generic.KeyValuePair`2" />, using the string representations of the key and value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the <see cref="T:System.Collections.Generic.KeyValuePair`2" />, which includes the string representations of the key and value.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Collections.ObjectModel/Collection`1.xml b/mcs/class/corlib/Documentation/en/System.Collections.ObjectModel/Collection`1.xml
index 03cf093bd20..7c5684ca57d 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections.ObjectModel/Collection`1.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections.ObjectModel/Collection`1.xml
@@ -256,7 +256,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -275,6 +274,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the <see cref="T:System.Collections.ObjectModel.Collection`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerator`1" /> for the <see cref="T:System.Collections.ObjectModel.Collection`1" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IndexOf">
@@ -630,7 +633,6 @@ finally {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -649,6 +651,10 @@ finally {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through a collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Add">
@@ -666,7 +672,6 @@ finally {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -676,6 +681,10 @@ finally {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an item to the <see cref="T:System.Collections.IList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position into which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to add to the <see cref="T:System.Collections.IList" />.</param>
       </Docs>
@@ -695,7 +704,6 @@ finally {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -706,6 +714,10 @@ finally {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Collections.IList" /> contains a specific value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Object" /> is found in the <see cref="T:System.Collections.IList" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the <see cref="T:System.Collections.IList" />.</param>
       </Docs>
@@ -725,7 +737,6 @@ finally {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -736,6 +747,10 @@ finally {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of a specific item in the <see cref="T:System.Collections.IList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of <paramref name="value" /> if found in the list; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the <see cref="T:System.Collections.IList" />.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Collections.ObjectModel/ReadOnlyCollection`1.xml b/mcs/class/corlib/Documentation/en/System.Collections.ObjectModel/ReadOnlyCollection`1.xml
index 990992a70eb..76ddf9a349b 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections.ObjectModel/ReadOnlyCollection`1.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections.ObjectModel/ReadOnlyCollection`1.xml
@@ -157,7 +157,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -176,6 +175,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the <see cref="T:System.Collections.ObjectModel.ReadOnlyCollection`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.Generic.IEnumerator`1" /> for the <see cref="T:System.Collections.ObjectModel.ReadOnlyCollection`1" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IndexOf">
@@ -512,7 +515,6 @@ finally {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -532,6 +534,10 @@ finally {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through a collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IList.Add">
@@ -549,7 +555,6 @@ finally {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -559,6 +564,10 @@ finally {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an item to the <see cref="T:System.Collections.IList" />.  This implementation always throws <see cref="T:System.NotSupportedException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position into which the new element was inserted.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to add to the <see cref="T:System.Collections.IList" />.</param>
       </Docs>
@@ -602,7 +611,6 @@ finally {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -614,6 +622,10 @@ finally {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Collections.IList" /> contains a specific value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Object" /> is found in the <see cref="T:System.Collections.IList" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the <see cref="T:System.Collections.IList" />.</param>
       </Docs>
@@ -633,7 +645,6 @@ finally {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -645,6 +656,10 @@ finally {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of a specific item in the <see cref="T:System.Collections.IList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of <paramref name="value" /> if found in the list; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the <see cref="T:System.Collections.IList" />.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Collections.ObjectModel/ReadOnlyDictionary`2+KeyCollection.xml b/mcs/class/corlib/Documentation/en/System.Collections.ObjectModel/ReadOnlyDictionary`2+KeyCollection.xml
index 34d41732257..47d72a50745 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections.ObjectModel/ReadOnlyDictionary`2+KeyCollection.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections.ObjectModel/ReadOnlyDictionary`2+KeyCollection.xml
@@ -92,12 +92,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the <see cref="T:System.Collections.ObjectModel.ReadOnlyDictionary`2" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.Generic.ICollection&lt;TKey&gt;.Add">
@@ -276,7 +279,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Collections.ObjectModel.ReadOnlyDictionary`2" /> instance is cast to an <see cref="T:System.Collections.IEnumerable" /> interface.</para>
@@ -285,6 +287,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through a collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Collections/ArrayList.xml b/mcs/class/corlib/Documentation/en/System.Collections/ArrayList.xml
index 95b6f936805..cddcab53eef 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections/ArrayList.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections/ArrayList.xml
@@ -206,9 +206,6 @@ public static void PrintValues( IEnumerable myList ) {
         <Parameter Name="list" Type="System.Collections.IList" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Collections.ArrayList" /> wrapper for <paramref name="list" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="list" /> is <see langword="null" />.</exception>
         <remarks>
@@ -226,6 +223,10 @@ public static void PrintValues( IEnumerable myList ) {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Collections.ArrayList" /> wrapper for a specific <see cref="T:System.Collections.IList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Collections.ArrayList" /> wrapper around the <see cref="T:System.Collections.IList" />.</para>
+        </returns>
         <param name="list">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.IList" /> to wrap.</param>
       </Docs>
@@ -248,10 +249,6 @@ public static void PrintValues( IEnumerable myList ) {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> that specifies the index of the current instance at which <paramref name="value" /> has
-   been added.</para>
-        </returns>
         <exception cref="T:System.NotSupportedException">
           <para>The current instance is read-only or has a fixed size.</para>
         </exception>
@@ -266,6 +263,10 @@ public static void PrintValues( IEnumerable myList ) {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an object to the end of the <see cref="T:System.Collections.ArrayList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Collections.ArrayList" /> index at which the <paramref name="value" /> has been added.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to be added to the end of the <see cref="T:System.Collections.ArrayList" />. The value can be null. </param>
       </Docs>
@@ -327,45 +328,6 @@ public static void PrintValues( IEnumerable myList ) {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> that
-   specifies the results of the search as follows:</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> The index of <paramref name="value" /> in the current
-      instance.</term>
-              <description>
-                <paramref name="value" /> was found.</description>
-            </item>
-            <item>
-              <term> The
-      bitwise complement
-      of the index of the first element
-      that is greater than <paramref name="value" />.</term>
-              <description>
-                <paramref name="value" /> was not found, and at least one
-   element in the current instance is greater than
-<paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> The bitwise complement of the <see cref="P:System.Collections.ArrayList.Count" /> of the current instance.</term>
-              <description>
-                <paramref name="value" /> was not found, and <paramref name="value" />
-is greater than all elements in the current
-instance.</description>
-            </item>
-          </list>
-          <para>
-            <block subset="none" type="note">If <paramref name="value" /> is not found and the current instance is already sorted, the
-bitwise complement of the return value indicates the index in the current instance
-where <paramref name="value" /> would be
-found.</block>
-          </para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>
             <paramref name="value" /> is not assignment-compatible with at least one element in the current instance.</para>
@@ -385,6 +347,10 @@ found.</block>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the entire sorted <see cref="T:System.Collections.ArrayList" /> for an element using the default comparer and returns the zero-based index of the element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of <paramref name="value" /> in the sorted <see cref="T:System.Collections.ArrayList" />, if <paramref name="value" /> is found; otherwise, a negative number, which is the bitwise complement of the index of the next element that is larger than <paramref name="value" /> or, if there is no larger element, the bitwise complement of <see cref="P:System.Collections.ArrayList.Count" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate. The value can be null. </param>
       </Docs>
@@ -408,44 +374,6 @@ found.</block>
         <Parameter Name="comparer" Type="System.Collections.IComparer" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> that
-   specifies the results of the search as follows:</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> The index of <paramref name="value" /> in the current
-      instance.</term>
-              <description>
-                <paramref name="value" /> was found.</description>
-            </item>
-            <item>
-              <term> The
-      bitwise
-      complement of the index of the first element
-      that is greater than <paramref name="value" />.</term>
-              <description>
-                <paramref name="value" /> was not found, and at least one
-   element in the current instance is greater than <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> The bitwise complement of the <see cref="P:System.Collections.ArrayList.Count" /> of the current instance.</term>
-              <description>
-                <paramref name="value" /> was not found, and <paramref name="value" />
-is greater than all elements in the current
-instance.</description>
-            </item>
-          </list>
-          <para>
-            <block subset="none" type="note">If <paramref name="value" /> is not found and the current instance is already sorted, the
-bitwise complement of the return value indicates the index in the current instance
-where <paramref name="value" /> would be
-found.</block>
-          </para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>
             <paramref name="comparer" /> is <see langword="null" />, and <paramref name="value" /> is not assignment-compatible with at least one element in the current instance.</para>
@@ -468,6 +396,10 @@ found.</block>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches the entire sorted <see cref="T:System.Collections.ArrayList" /> for an element using the specified comparer and returns the zero-based index of the element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of <paramref name="value" /> in the sorted <see cref="T:System.Collections.ArrayList" />, if <paramref name="value" /> is found; otherwise, a negative number, which is the bitwise complement of the index of the next element that is larger than <paramref name="value" /> or, if there is no larger element, the bitwise complement of <see cref="P:System.Collections.ArrayList.Count" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate. The value can be null. </param>
         <param name="comparer">
@@ -495,48 +427,6 @@ found.</block>
         <Parameter Name="comparer" Type="System.Collections.IComparer" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> that
-   specifies the results of the search as follows:</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> The index of <paramref name="value" /> in the current
-      instance.</term>
-              <description>
-                <paramref name="value" /> was found.</description>
-            </item>
-            <item>
-              <term> The
-      bitwise complement
-      of the index of the first element that is
-      greater than <paramref name="value" />.</term>
-              <description>
-                <paramref name="value" /> was not found, and at
-   least one element in the range of <paramref name="index" /> to <paramref name="index" /> +
-<paramref name="count" /> - 1 in the current instance is greater than
-<paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> The bitwise complement of (<paramref name="index" /> +
-<paramref name="count" />)</term>
-              <description>
-                <paramref name="value" /> was not found, and
-<paramref name="value" /> is greater than all elements in the range of 
-<paramref name="index" /> to <paramref name="index" /> + <paramref name="count" /> - 1 in the current 
-instance.</description>
-            </item>
-          </list>
-          <para>
-            <block subset="none" type="note">If <paramref name="value" /> is not found and the current instance is already sorted, the
-bitwise complement of the return value indicates the index in the current instance
-where <paramref name="value" /> would be found in the range of <paramref name="index" /> to
-<paramref name="index" /> + <paramref name="count" /> - 1.</block>
-          </para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>
             <see cref="P:System.Collections.ArrayList.Count" /> of the current instance - <paramref name="index" /> &lt; <paramref name="count" />.</para>
@@ -567,6 +457,10 @@ where <paramref name="value" /> would be found in the range of <paramref name="i
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches a range of elements in the sorted <see cref="T:System.Collections.ArrayList" /> for an element using the specified comparer and returns the zero-based index of the element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of <paramref name="value" /> in the sorted <see cref="T:System.Collections.ArrayList" />, if <paramref name="value" /> is found; otherwise, a negative number, which is the bitwise complement of the index of the next element that is larger than <paramref name="value" /> or, if there is no larger element, the bitwise complement of <see cref="P:System.Collections.ArrayList.Count" />.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based starting index of the range to search. </param>
         <param name="count">
@@ -663,10 +557,6 @@ where <paramref name="value" /> would be found in the range of <paramref name="i
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Object" /> that is a copy of the current
-   instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A shallow copy of a collection copies only the elements of the collection, whether they are reference types or value types, but it does not copy the objects that the references refer to. The references in the new collection point to the same objects that the references in the original collection point to.</para>
@@ -677,6 +567,10 @@ where <paramref name="value" /> would be found in the range of <paramref name="i
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a shallow copy of the <see cref="T:System.Collections.ArrayList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A shallow copy of the <see cref="T:System.Collections.ArrayList" />.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -697,11 +591,6 @@ where <paramref name="value" /> would be found in the range of <paramref name="i
         <Parameter Name="item" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="item" /> is contained in the current instance;
-   otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method performs a linear search; therefore, this method is an O(<paramref name="n" />) operation, where <paramref name="n" /> is <see cref="P:System.Collections.ArrayList.Count" />.</para>
@@ -712,6 +601,10 @@ where <paramref name="value" /> would be found in the range of <paramref name="i
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether an element is in the <see cref="T:System.Collections.ArrayList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="item" /> is found in the <see cref="T:System.Collections.ArrayList" />; otherwise, false.</para>
+        </returns>
         <param name="item">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the <see cref="T:System.Collections.ArrayList" />. The value can be null. </param>
       </Docs>
@@ -930,10 +823,6 @@ where <paramref name="value" /> would be found in the range of <paramref name="i
         <Parameter Name="list" Type="System.Collections.ArrayList" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Collections.ArrayList" />
-wrapper with a fixed size.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="list" /> is <see langword="null" />.</exception>
         <remarks>
@@ -946,6 +835,10 @@ wrapper with a fixed size.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.ArrayList" /> wrapper with a fixed size.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.ArrayList" /> wrapper with a fixed size.</para>
+        </returns>
         <param name="list">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.ArrayList" /> to wrap. </param>
       </Docs>
@@ -967,7 +860,6 @@ wrapper with a fixed size.</para>
         <Parameter Name="list" Type="System.Collections.IList" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This wrapper can be used to prevent additions to and deletions from the original <see cref="T:System.Collections.IList" />. The elements can still be modified or replaced.</para>
@@ -978,6 +870,10 @@ wrapper with a fixed size.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IList" /> wrapper with a fixed size.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IList" /> wrapper with a fixed size.</para>
+        </returns>
         <param name="list">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.IList" /> to wrap. </param>
       </Docs>
@@ -997,9 +893,6 @@ wrapper with a fixed size.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Collections.IEnumerator" /> for the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The foreach statement of the C# language (for each in Visual Basic) hides the complexity of the enumerators.  Therefore, using foreach is recommended, instead of directly manipulating the enumerator.</para>
@@ -1016,6 +909,10 @@ wrapper with a fixed size.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator for the entire <see cref="T:System.Collections.ArrayList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the entire <see cref="T:System.Collections.ArrayList" />.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1037,11 +934,6 @@ wrapper with a fixed size.</para>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Collections.IEnumerator" /> that can iterate over the range
-   of <paramref name="index" /> to <paramref name="index" /> + <paramref name="count" /> - 1 in the current
-   instance.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="index" /> &lt; 0.</para>
@@ -1071,6 +963,10 @@ wrapper with a fixed size.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator for a range of elements in the <see cref="T:System.Collections.ArrayList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the specified range of elements in the <see cref="T:System.Collections.ArrayList" />.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based starting index of the <see cref="T:System.Collections.ArrayList" /> section that the enumerator should refer to. </param>
         <param name="count">
@@ -1096,11 +992,6 @@ wrapper with a fixed size.</para>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Collections.ArrayList" /> that
-   represents the range in the current instance from <paramref name="index" /> to
-<paramref name="index" /> + <paramref name="count" /> - 1.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="index" /> &lt; 0.</para>
@@ -1121,6 +1012,10 @@ wrapper with a fixed size.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.ArrayList" /> which represents a subset of the elements in the source <see cref="T:System.Collections.ArrayList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.ArrayList" /> which represents a subset of the elements in the source <see cref="T:System.Collections.ArrayList" />.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based <see cref="T:System.Collections.ArrayList" /> index at which the range starts. </param>
         <param name="count">
@@ -1145,14 +1040,6 @@ wrapper with a fixed size.</para>
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> that specifies the index of the first occurrence of <paramref name="    value" /> in the current instance, if found;
-   otherwise, -1.</para>
-          <para>
-            <block subset="none" type="note">This provides the caller with a standard
-   code for a failed search.</block>
-          </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Collections.ArrayList" /> is searched forward starting at the first element and ending at the last element.</para>
@@ -1164,6 +1051,10 @@ wrapper with a fixed size.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified <see cref="T:System.Object" /> and returns the zero-based index of the first occurrence within the entire <see cref="T:System.Collections.ArrayList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="value" /> within the entire <see cref="T:System.Collections.ArrayList" />, if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the <see cref="T:System.Collections.ArrayList" />. The value can be null. </param>
       </Docs>
@@ -1187,15 +1078,6 @@ wrapper with a fixed size.</para>
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> that specifies the index of the first occurrence of <paramref name="value" /> in the current
-   instance, if found within the range <paramref name="    startIndex" />
-   to the end of the current instance; otherwise, -1.</para>
-          <para>
-            <block subset="none" type="note">This provides the caller with a standard
-   code for a failed search.</block>
-          </para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="startIndex" /> &lt; 0.</para>
@@ -1214,6 +1096,10 @@ wrapper with a fixed size.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified <see cref="T:System.Object" /> and returns the zero-based index of the first occurrence within the range of elements in the <see cref="T:System.Collections.ArrayList" /> that extends from the specified index to the last element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="value" /> within the range of elements in the <see cref="T:System.Collections.ArrayList" /> that extends from <paramref name="startIndex" /> to the last element, if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the <see cref="T:System.Collections.ArrayList" />. The value can be null. </param>
         <param name="startIndex">
@@ -1240,15 +1126,6 @@ wrapper with a fixed size.</para>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> that specifies the index of the first occurrence of <paramref name="value" /> in
-   the current instance, within the range <paramref name="startIndex " />to
-<paramref name="startIndex" /> + <paramref name=" count" /> - 1, if found; otherwise, -1.</para>
-          <para>
-            <block subset="none" type="note">This provides the caller with a standard
-   code for a failed search.</block>
-          </para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="startIndex" />&gt;= <see cref="P:System.Collections.ArrayList.Count" /> of the current instance.</para>
@@ -1270,6 +1147,10 @@ wrapper with a fixed size.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified <see cref="T:System.Object" /> and returns the zero-based index of the first occurrence within the range of elements in the <see cref="T:System.Collections.ArrayList" /> that starts at the specified index and contains the specified number of elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="value" /> within the range of elements in the <see cref="T:System.Collections.ArrayList" /> that starts at <paramref name="startIndex" /> and contains <paramref name="count" /> number of elements, if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the <see cref="T:System.Collections.ArrayList" />. The value can be null. </param>
         <param name="startIndex">
@@ -1540,14 +1421,6 @@ wrapper with a fixed size.</para>
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> that specifies the index of the last occurrence of <paramref name="    value" /> in the current
-   instance, if found; otherwise, -1.</para>
-          <para>
-            <block subset="none" type="note">This provides the caller with a standard
-   code for a failed search.</block>
-          </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Collections.ArrayList" /> is searched backward starting at the last element and ending at the first element.</para>
@@ -1558,6 +1431,10 @@ wrapper with a fixed size.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified <see cref="T:System.Object" /> and returns the zero-based index of the last occurrence within the entire <see cref="T:System.Collections.ArrayList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the last occurrence of <paramref name="value" /> within the entire the <see cref="T:System.Collections.ArrayList" />, if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the <see cref="T:System.Collections.ArrayList" />. The value can be null. </param>
       </Docs>
@@ -1581,16 +1458,6 @@ wrapper with a fixed size.</para>
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> that specifies the index of the last occurrence of <paramref name="value" /> in
-   the range of <paramref name="startIndex" />
-   through the first element of the current
-   instance, if found; otherwise, -1.</para>
-          <para>
-            <block subset="none" type="note">This provides the caller with a standard
-   code for a failed search.</block>
-          </para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="startIndex" /> &lt; 0.</para>
@@ -1609,6 +1476,10 @@ wrapper with a fixed size.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified <see cref="T:System.Object" /> and returns the zero-based index of the last occurrence within the range of elements in the <see cref="T:System.Collections.ArrayList" /> that extends from the first element to the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the last occurrence of <paramref name="value" /> within the range of elements in the <see cref="T:System.Collections.ArrayList" /> that extends from the first element to <paramref name="startIndex" />, if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the <see cref="T:System.Collections.ArrayList" />. The value can be null. </param>
         <param name="startIndex">
@@ -1635,15 +1506,6 @@ wrapper with a fixed size.</para>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> that specifies the index of the last occurrence of value in the current
-   instance, within the range <paramref name="startIndex" /> through
-<paramref name="startIndex" /> - <paramref name="count" /> + 1, if found; otherwise, -1. </para>
-          <para>
-            <block subset="none" type="note">This provides the caller with a standard
-   code for a failed search.</block>
-          </para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="startIndex" /> &lt; 0.</para>
@@ -1671,6 +1533,10 @@ wrapper with a fixed size.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified <see cref="T:System.Object" /> and returns the zero-based index of the last occurrence within the range of elements in the <see cref="T:System.Collections.ArrayList" /> that contains the specified number of elements and ends at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the last occurrence of <paramref name="value" /> within the range of elements in the <see cref="T:System.Collections.ArrayList" /> that contains <paramref name="count" /> number of elements and ends at <paramref name="startIndex" />, if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the <see cref="T:System.Collections.ArrayList" />. The value can be null. </param>
         <param name="startIndex">
@@ -1697,10 +1563,6 @@ wrapper with a fixed size.</para>
         <Parameter Name="list" Type="System.Collections.ArrayList" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A read-only <see cref="T:System.Collections.ArrayList" />
-wrapper around <paramref name="list" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="list" /> is <see langword="null" />. </exception>
         <remarks>
@@ -1713,6 +1575,10 @@ wrapper around <paramref name="list" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a read-only <see cref="T:System.Collections.ArrayList" /> wrapper.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A read-only <see cref="T:System.Collections.ArrayList" /> wrapper around <paramref name="list" />.</para>
+        </returns>
         <param name="list">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.ArrayList" /> to wrap. </param>
       </Docs>
@@ -1734,7 +1600,6 @@ wrapper around <paramref name="list" />.</para>
         <Parameter Name="list" Type="System.Collections.IList" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To prevent any modifications to <paramref name="list" />, expose <paramref name="list" /> only through this wrapper.</para>
@@ -1745,6 +1610,10 @@ wrapper around <paramref name="list" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a read-only <see cref="T:System.Collections.IList" /> wrapper.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A read-only <see cref="T:System.Collections.IList" /> wrapper around <paramref name="list" />.</para>
+        </returns>
         <param name="list">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.IList" /> to wrap. </param>
       </Docs>
@@ -1891,11 +1760,6 @@ wrapper around <paramref name="list" />.</para>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Collections.ArrayList" />
-with <paramref name="count" /> number of elements, all of which are copies of
-<paramref name="value" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="count" /> &lt; 0.</exception>
         <remarks>
@@ -1908,6 +1772,10 @@ with <paramref name="count" /> number of elements, all of which are copies of
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.ArrayList" /> whose elements are copies of the specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.ArrayList" /> with <paramref name="count" /> number of elements, all of which are copies of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to copy multiple times in the new <see cref="T:System.Collections.ArrayList" />. The value can be null. </param>
         <param name="count">
@@ -2171,10 +2039,6 @@ with <paramref name="count" /> number of elements, all of which are copies of
         <Parameter Name="list" Type="System.Collections.ArrayList" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Collections.ArrayList" /> wrapper that is
-   synchronized (thread-safe).</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="list" /> is <see langword="null" />. </exception>
         <remarks>
@@ -2186,6 +2050,10 @@ with <paramref name="count" /> number of elements, all of which are copies of
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.ArrayList" /> wrapper that is synchronized (thread safe).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.ArrayList" /> wrapper that is synchronized (thread safe).</para>
+        </returns>
         <param name="list">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.ArrayList" /> to synchronize. </param>
       </Docs>
@@ -2207,7 +2075,6 @@ with <paramref name="count" /> number of elements, all of which are copies of
         <Parameter Name="list" Type="System.Collections.IList" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To guarantee the thread safety of the <see cref="T:System.Collections.ArrayList" />, all operations must be done through this wrapper.</para>
@@ -2217,6 +2084,10 @@ with <paramref name="count" /> number of elements, all of which are copies of
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IList" /> wrapper that is synchronized (thread safe).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IList" /> wrapper that is synchronized (thread safe).</para>
+        </returns>
         <param name="list">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.IList" /> to synchronize. </param>
       </Docs>
@@ -2267,10 +2138,6 @@ with <paramref name="count" /> number of elements, all of which are copies of
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Object" /> array containing
-   copies of the elements of the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The elements are copied using <see cref="Overload:System.Array.Copy" />, which is an O(<paramref name="n" />) operation, where <paramref name="n" /> is <see cref="P:System.Collections.ArrayList.Count" />.</para>
@@ -2279,6 +2146,10 @@ with <paramref name="count" /> number of elements, all of which are copies of
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the elements of the <see cref="T:System.Collections.ArrayList" /> to a new <see cref="T:System.Object" /> array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> array containing copies of the elements of the <see cref="T:System.Collections.ArrayList" />.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -2299,10 +2170,6 @@ with <paramref name="count" /> number of elements, all of which are copies of
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>An array of <see cref="T:System.Type" /><paramref name="type" /> containing copies of the elements of the current
-instance.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="type" /> is <see langword="null" />.</exception>
         <exception cref="T:System.InvalidCastException">At least one element of the current instance cannot be cast to the <see cref="T:System.Type" /><paramref name="type" />.</exception>
@@ -2315,6 +2182,10 @@ instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the elements of the <see cref="T:System.Collections.ArrayList" /> to a new array of the specified element type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of the specified element type containing copies of the elements of the <see cref="T:System.Collections.ArrayList" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The element <see cref="T:System.Type" /> of the destination array to create and copy elements to.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Collections/BitArray.xml b/mcs/class/corlib/Documentation/en/System.Collections/BitArray.xml
index 68d42370aaf..e1afd24509b 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections/BitArray.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections/BitArray.xml
@@ -215,7 +215,6 @@
         <Parameter Name="value" Type="System.Collections.BitArray" />
       </Parameters>
       <Docs>
-        <returns>A BitAray whose bit values are the bitwise <c>And</c> of the BItArray instance and the argument BitArray.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The bitwise AND operation returns true if both operands are true, and returns false if one or both operands are false.</para>
@@ -225,6 +224,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the bitwise AND operation on the elements in the current <see cref="T:System.Collections.BitArray" /> against the corresponding elements in the specified <see cref="T:System.Collections.BitArray" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current instance containing the result of the bitwise AND operation on the elements in the current <see cref="T:System.Collections.BitArray" /> against the corresponding elements in the specified <see cref="T:System.Collections.BitArray" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.BitArray" /> with which to perform the bitwise AND operation. </param>
       </Docs>
@@ -243,10 +246,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Object" /> that is a copy of the current
-   instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A shallow copy of a collection copies only the elements of the collection, whether they are reference types or value types, but it does not copy the objects that the references refer to. The references in the new collection point to the same objects that the references in the original collection point to.</para>
@@ -257,6 +256,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a shallow copy of the <see cref="T:System.Collections.BitArray" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A shallow copy of the <see cref="T:System.Collections.BitArray" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CopyTo">
@@ -337,7 +340,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>Returns the value of the specified element.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is an O(1) operation.</para>
@@ -346,6 +348,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the bit at a specific position in the <see cref="T:System.Collections.BitArray" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the bit at position <paramref name="index" />.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the value to get. </param>
       </Docs>
@@ -364,9 +370,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>An <see cref="T:System.Collections.IEnumerator" /> for the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The foreach statement of the C# language (for each in Visual Basic) hides the complexity of the enumerators.  Therefore, using foreach is recommended, instead of directly manipulating the enumerator.</para>
@@ -383,6 +386,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the <see cref="T:System.Collections.BitArray" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the entire <see cref="T:System.Collections.BitArray" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsReadOnly">
@@ -520,7 +527,6 @@ The value of this property is always <c>false</c>.
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>A BitAray whose bit values are the negation of the BItArray instance.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is an O(<paramref name="n" />) operation, where <paramref name="n" /> is <see cref="P:System.Collections.BitArray.Count" />.</para>
@@ -529,6 +535,10 @@ The value of this property is always <c>false</c>.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inverts all the bit values in the current <see cref="T:System.Collections.BitArray" />, so that elements set to true are changed to false, and elements set to false are changed to true.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current instance with inverted bit values.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Or">
@@ -547,7 +557,6 @@ The value of this property is always <c>false</c>.
         <Parameter Name="value" Type="System.Collections.BitArray" />
       </Parameters>
       <Docs>
-        <returns>A BitAray whose bit values are the bitwise <c>Or</c> of the BItArray instance and the argument BitArray.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The bitwise OR operation returns true if one or both operands are true, and returns false if both operands are false.</para>
@@ -557,6 +566,10 @@ The value of this property is always <c>false</c>.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the bitwise OR operation on the elements in the current <see cref="T:System.Collections.BitArray" /> against the corresponding elements in the specified <see cref="T:System.Collections.BitArray" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current instance containing the result of the bitwise OR operation on the elements in the current <see cref="T:System.Collections.BitArray" /> against the corresponding elements in the specified <see cref="T:System.Collections.BitArray" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.BitArray" /> with which to perform the bitwise OR operation. </param>
       </Docs>
@@ -664,7 +677,6 @@ The value of this property is always <c>false</c>.
         <Parameter Name="value" Type="System.Collections.BitArray" />
       </Parameters>
       <Docs>
-        <returns>A BitAray whose bit values are the bitwise <c>Xor</c> of the BItArray instance and the argument BitArray.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The bitwise exclusive OR operation returns true if exactly one operand is true, and returns false if both operands have the same Boolean value.</para>
@@ -674,6 +686,10 @@ The value of this property is always <c>false</c>.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs the bitwise exclusive OR operation on the elements in the current <see cref="T:System.Collections.BitArray" /> against the corresponding elements in the specified <see cref="T:System.Collections.BitArray" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current instance containing the result of the bitwise exclusive OR operation on the elements in the current <see cref="T:System.Collections.BitArray" /> against the corresponding elements in the specified <see cref="T:System.Collections.BitArray" />. </para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.BitArray" /> with which to perform the bitwise exclusive OR operation. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Collections/CaseInsensitiveComparer.xml b/mcs/class/corlib/Documentation/en/System.Collections/CaseInsensitiveComparer.xml
index 394674b08fc..e87e043e77c 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections/CaseInsensitiveComparer.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections/CaseInsensitiveComparer.xml
@@ -103,7 +103,6 @@
         <Parameter Name="b" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="a" /> and <paramref name="b" /> are both strings, this method uses <see cref="M:System.Globalization.CompareInfo.Compare(System.String,System.String)" /> to compare the strings with the casing ignored; otherwise, it uses the <see cref="T:System.IComparable" /> implementation of either object. That is, if <paramref name="a" /> implements <see cref="T:System.IComparable" />, then this method returns the result of <paramref name="a" />. CompareTo (<paramref name="b" />); otherwise, if <paramref name="b" /> implements <see cref="T:System.IComparable" />, then it returns the negated result of <paramref name="b" />. CompareTo (<paramref name="a" />).</para>
@@ -114,6 +113,49 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a case-insensitive comparison of two objects of the same type and returns a value indicating whether one is less than, equal to, or greater than the other.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative values of <paramref name="a" /> and <paramref name="b" />, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Meaning </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="a" /> is less than <paramref name="b" />, with casing ignored. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="a" /> equals <paramref name="b" />, with casing ignored. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="a" /> is greater than <paramref name="b" />, with casing ignored. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare. </param>
         <param name="b">
diff --git a/mcs/class/corlib/Documentation/en/System.Collections/CaseInsensitiveHashCodeProvider.xml b/mcs/class/corlib/Documentation/en/System.Collections/CaseInsensitiveHashCodeProvider.xml
index 8f55be661b7..af66aa845fd 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections/CaseInsensitiveHashCodeProvider.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections/CaseInsensitiveHashCodeProvider.xml
@@ -151,7 +151,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value from this method must not be persisted for two reasons. First, the hash function of a class might be altered to generate a better distribution, thereby rendering any values from the old hash function useless. Second, the default implementation of this class does not guarantee that the same value will be returned by different instances.</para>
@@ -160,6 +159,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash code for the given object, using a hashing algorithm that ignores the case of strings.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the given object, using a hashing algorithm that ignores the case of strings.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> for which a hash code is to be returned. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Collections/CollectionBase.xml b/mcs/class/corlib/Documentation/en/System.Collections/CollectionBase.xml
index bf776c45120..68218c935dd 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections/CollectionBase.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections/CollectionBase.xml
@@ -188,7 +188,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IEnumerator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>[Visual Basic, C#]</para>
@@ -207,6 +206,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the <see cref="T:System.Collections.CollectionBase" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.Collections.CollectionBase" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InnerList">
@@ -709,7 +712,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <see cref="P:System.Collections.CollectionBase.Count" /> already equals the capacity, the capacity of the list is doubled by automatically reallocating the internal array and copying the existing elements to the new array before the new element is added.</para>
@@ -719,6 +721,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an object to the end of the <see cref="T:System.Collections.CollectionBase" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Collections.CollectionBase" /> index at which the <paramref name="value" /> has been added.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to be added to the end of the <see cref="T:System.Collections.CollectionBase" />.</param>
       </Docs>
@@ -739,7 +745,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method performs a linear search; therefore, this method is an O(<paramref name="n" />) operation, where <paramref name="n" /> is <see cref="P:System.Collections.CollectionBase.Count" />.</para>
@@ -750,6 +755,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Collections.CollectionBase" /> contains a specific element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Collections.CollectionBase" /> contains the specified <paramref name="value" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the <see cref="T:System.Collections.CollectionBase" />.</param>
       </Docs>
@@ -770,7 +779,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method performs a linear search; therefore, this method is an O(<paramref name="n" />) operation, where <paramref name="n" /> is <see cref="P:System.Collections.CollectionBase.Count" />.</para>
@@ -781,6 +789,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified <see cref="T:System.Object" /> and returns the zero-based index of the first occurrence within the entire <see cref="T:System.Collections.CollectionBase" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="value" /> within the entire <see cref="T:System.Collections.CollectionBase" />, if found; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the <see cref="T:System.Collections.CollectionBase" />.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Collections/Comparer.xml b/mcs/class/corlib/Documentation/en/System.Collections/Comparer.xml
index 5f831e5fe7e..90bb6778372 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections/Comparer.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections/Comparer.xml
@@ -83,38 +83,6 @@
         <Parameter Name="b" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of <paramref name="a" /> as compared to <paramref name="b" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
-          <list type="table">
-            <listheader>
-              <term>Value</term>
-              <description>Condition</description>
-            </listheader>
-            <item>
-              <term> A negative number</term>
-              <description>
-                <paramref name="a " />&lt;
-      <paramref name="b." /></description>
-            </item>
-            <item>
-              <term> Zero</term>
-              <description>
-                <paramref name="a " />==
-<paramref name="b." /></description>
-            </item>
-            <item>
-              <term> A positive number</term>
-              <description>
-                <paramref name="a " />&gt;
-<paramref name="b." /></description>
-            </item>
-          </list>
-          <para>
-            <block subset="none" type="note">A null reference is considered to
-   compare less than any other non-null object, and equal to any other null
-   reference, independent of the underlying <see cref="T:System.Type" /> of either object.</block>
-          </para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>Both <paramref name="a" /> and <paramref name="b" /> are not <see langword="null" /> and do not implement the <see cref="T:System.IComparable" /> interface.</para>
           <para> -or-</para>
@@ -132,6 +100,49 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Performs a case-sensitive comparison of two objects of the same type and returns a value indicating whether one is less than, equal to, or greater than the other.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative values of <paramref name="a" /> and <paramref name="b" />, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Meaning </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="a" /> is less than <paramref name="b" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="a" /> equals <paramref name="b" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="a" /> is greater than <paramref name="b" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare. </param>
         <param name="b">
diff --git a/mcs/class/corlib/Documentation/en/System.Collections/DictionaryBase.xml b/mcs/class/corlib/Documentation/en/System.Collections/DictionaryBase.xml
index 4735ac30352..4264f514524 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections/DictionaryBase.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections/DictionaryBase.xml
@@ -181,7 +181,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>The enumerator for the underlying hashtable.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The foreach statement of the C# language (for each in Visual Basic) hides the complexity of the enumerators.  Therefore, using foreach is recommended, instead of directly manipulating the enumerator.</para>
@@ -198,6 +197,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IDictionaryEnumerator" /> that iterates through the <see cref="T:System.Collections.DictionaryBase" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IDictionaryEnumerator" /> for the <see cref="T:System.Collections.DictionaryBase" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InnerHashtable">
@@ -294,8 +297,6 @@
         <Parameter Name="currentValue" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>This method is provided as a simple way to override the values
-returned by the DictionaryBase. </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default implementation of this method returns <paramref name="currentValue" />. It is intended to be overridden by a derived class to perform additional action when the specified element is retrieved.</para>
@@ -306,6 +307,10 @@ returned by the DictionaryBase. </returns>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the element with the specified key and value in the <see cref="T:System.Collections.DictionaryBase" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> containing the element with the specified key and value.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key of the element to get. </param>
         <param name="currentValue">
@@ -648,7 +653,6 @@ returned by the DictionaryBase. </returns>
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is an O(1) operation.</para>
@@ -658,6 +662,10 @@ returned by the DictionaryBase. </returns>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Collections.DictionaryBase" /> contains a specific key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Collections.DictionaryBase" /> contains an element with the specified key; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key to locate in the <see cref="T:System.Collections.DictionaryBase" />.</param>
       </Docs>
@@ -831,7 +839,6 @@ returned by the DictionaryBase. </returns>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The foreach statement of the C# language (for each in Visual Basic) hides the complexity of the enumerators. Therefore, using foreach is recommended, instead of directly manipulating the enumerator.</para>
@@ -848,6 +855,10 @@ returned by the DictionaryBase. </returns>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IEnumerator" /> that iterates through the <see cref="T:System.Collections.DictionaryBase" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.Collections.DictionaryBase" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Collections/Hashtable.xml b/mcs/class/corlib/Documentation/en/System.Collections/Hashtable.xml
index 282ed824eee..83bd4362da1 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections/Hashtable.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections/Hashtable.xml
@@ -778,10 +778,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Object" />
-that is a copy of the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A shallow copy of a collection copies only the elements of the collection, whether they are reference types or value types, but it does not copy the objects that the references refer to. The references in the new collection point to the same objects that the references in the original collection point to.</para>
@@ -793,6 +789,10 @@ that is a copy of the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a shallow copy of the <see cref="T:System.Collections.Hashtable" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A shallow copy of the <see cref="T:System.Collections.Hashtable" />.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -842,11 +842,6 @@ that is a copy of the current instance.</para>
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" />
-if the current instance contains <paramref name="key" />; otherwise, <see langword="false" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="key" /> is <see langword="null" />. </exception>
         <remarks>
@@ -860,6 +855,10 @@ if the current instance contains <paramref name="key" />; otherwise, <see langwo
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Collections.Hashtable" /> contains a specific key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Collections.Hashtable" /> contains an element with the specified key; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key to locate in the <see cref="T:System.Collections.Hashtable" />. </param>
       </Docs>
@@ -882,11 +881,6 @@ if the current instance contains <paramref name="key" />; otherwise, <see langwo
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if
- the current instance contains an entry with <paramref name="key" />; otherwise, <see langword="false" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="key" /> is <see langword="null" />. </exception>
         <remarks>
@@ -899,6 +893,10 @@ if the current instance contains <paramref name="key" />; otherwise, <see langwo
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Collections.Hashtable" /> contains a specific key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Collections.Hashtable" /> contains an element with the specified key; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key to locate in the <see cref="T:System.Collections.Hashtable" />. </param>
       </Docs>
@@ -921,12 +919,6 @@ if the current instance contains <paramref name="key" />; otherwise, <see langwo
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" />
-if the current instance contains an
-entry with <paramref name="value" />; otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The values of the elements of the <see cref="T:System.Collections.Hashtable" /> are compared to the specified value using the <see cref="M:System.Object.Equals(System.Object)" /> method.</para>
@@ -937,6 +929,10 @@ entry with <paramref name="value" />; otherwise, <see langword="false" />.</para
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Collections.Hashtable" /> contains a specific value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Collections.Hashtable" /> contains an element with the specified <paramref name="value" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to locate in the <see cref="T:System.Collections.Hashtable" />. The value can be null. </param>
       </Docs>
@@ -1060,10 +1056,6 @@ entry with <paramref name="value" />; otherwise, <see langword="false" />.</para
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Collections.IDictionaryEnumerator" /> for the current
-   instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>[Visual Basic, C#]</para>
@@ -1082,6 +1074,10 @@ entry with <paramref name="value" />; otherwise, <see langword="false" />.</para
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IDictionaryEnumerator" /> that iterates through the <see cref="T:System.Collections.Hashtable" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IDictionaryEnumerator" /> for the <see cref="T:System.Collections.Hashtable" />.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1102,9 +1098,6 @@ entry with <paramref name="value" />; otherwise, <see langword="false" />.</para
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the hash code for <paramref name="key" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="key" /> is <see langword="null" />. </exception>
         <remarks>
@@ -1116,6 +1109,10 @@ entry with <paramref name="value" />; otherwise, <see langword="false" />.</para
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for the specified key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for <paramref name="key" />.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> for which a hash code is to be returned. </param>
       </Docs>
@@ -1358,12 +1355,6 @@ entry with <paramref name="value" />; otherwise, <see langword="false" />.</para
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="item" /> and <paramref name="key" /> represent the
-   same value; otherwise,
-<see langword="false" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <para>
             <paramref name="item" /> is <see langword="null" />. </para>
@@ -1380,6 +1371,10 @@ entry with <paramref name="value" />; otherwise, <see langword="false" />.</para
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares a specific <see cref="T:System.Object" /> with a specific key in the <see cref="T:System.Collections.Hashtable" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="item" /> and <paramref name="key" /> are equal; otherwise, false.</para>
+        </returns>
         <param name="item">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to compare with <paramref name="key" />. </param>
         <param name="key">
@@ -1505,9 +1500,6 @@ entry with <paramref name="value" />; otherwise, <see langword="false" />.</para
         <Parameter Name="table" Type="System.Collections.Hashtable" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A synchronized (thread-safe) wrapper for <paramref name="table" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="table" /> is <see langword="null" />. </exception>
         <remarks>
@@ -1522,6 +1514,10 @@ entry with <paramref name="value" />; otherwise, <see langword="false" />.</para
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a synchronized (thread-safe) wrapper for the <see cref="T:System.Collections.Hashtable" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A synchronized (thread-safe) wrapper for the <see cref="T:System.Collections.Hashtable" />.</para>
+        </returns>
         <param name="table">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.Hashtable" /> to synchronize. </param>
       </Docs>
@@ -1574,7 +1570,6 @@ entry with <paramref name="value" />; otherwise, <see langword="false" />.</para
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>[Visual Basic, C#]</para>
@@ -1592,6 +1587,10 @@ entry with <paramref name="value" />; otherwise, <see langword="false" />.</para
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through a collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Values">
diff --git a/mcs/class/corlib/Documentation/en/System.Collections/IComparer.xml b/mcs/class/corlib/Documentation/en/System.Collections/IComparer.xml
index 5e7a797e65c..11368e7507c 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections/IComparer.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections/IComparer.xml
@@ -47,39 +47,58 @@
         <Parameter Name="y" Type="System.Object" />
       </Parameters>
       <Docs>
+        <remarks>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The preferred implementation is to use the <see cref="M:System.IComparable.CompareTo(System.Object)" /> method of one of the parameters.</para>
+          <para>Comparing null with any type is allowed and does not generate an exception when using <see cref="T:System.IComparable" />. When sorting, null is considered to be less than any other object.</para>
+        </remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Compares two objects and returns a value indicating whether one is less than, equal to, or greater than the other.</para>
+        </summary>
         <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of <paramref name="x" /> as compared to <paramref name="y" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative values of <paramref name="x" /> and <paramref name="y" />, as shown in the following table.</para>
           <list type="table">
             <listheader>
-              <term>Value</term>
-              <description>Condition</description>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Meaning </para>
+                </description>
+              </item>
             </listheader>
             <item>
-              <term> A negative number</term>
+              <term>
+                <para>Less than zero </para>
+              </term>
               <description>
-                <paramref name="x" /> &lt; <paramref name="y" />.</description>
+                <para>
+                  <paramref name="x" /> is less than <paramref name="y" />. </para>
+              </description>
             </item>
             <item>
-              <term> Zero</term>
+              <term>
+                <para>Zero </para>
+              </term>
               <description>
-                <paramref name="x" /> == <paramref name="y" />.</description>
+                <para>
+                  <paramref name="x" /> equals <paramref name="y" />. </para>
+              </description>
             </item>
             <item>
-              <term> A positive number</term>
+              <term>
+                <para>Greater than zero </para>
+              </term>
               <description>
-                <paramref name="x" /> &gt; <paramref name="y" />.</description>
+                <para>
+                  <paramref name="x" /> is greater than <paramref name="y" />. </para>
+              </description>
             </item>
           </list>
         </returns>
-        <remarks>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>The preferred implementation is to use the <see cref="M:System.IComparable.CompareTo(System.Object)" /> method of one of the parameters.</para>
-          <para>Comparing null with any type is allowed and does not generate an exception when using <see cref="T:System.IComparable" />. When sorting, null is considered to be less than any other object.</para>
-        </remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Compares two objects and returns a value indicating whether one is less than, equal to, or greater than the other.</para>
-        </summary>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare. </param>
         <param name="y">
diff --git a/mcs/class/corlib/Documentation/en/System.Collections/IDictionary.xml b/mcs/class/corlib/Documentation/en/System.Collections/IDictionary.xml
index 6c2f85b752b..6d73ad36a3b 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections/IDictionary.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections/IDictionary.xml
@@ -131,10 +131,6 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the <see cref="T:System.Collections.IDictionary" /> contains an entry with the key; otherwise, <see langword="false" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="key " />is <see langword="null" />.</exception>
         <remarks>
@@ -146,6 +142,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Collections.IDictionary" /> object contains an element with the specified key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Collections.IDictionary" /> contains an element with the key; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key to locate in the <see cref="T:System.Collections.IDictionary" /> object.</param>
       </Docs>
@@ -166,10 +166,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Collections.IDictionaryEnumerator" /> for the current
-   instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>[Visual Basic, C#]</para>
@@ -186,6 +182,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IDictionaryEnumerator" /> object for the <see cref="T:System.Collections.IDictionary" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IDictionaryEnumerator" /> object for the <see cref="T:System.Collections.IDictionary" /> object.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System.Collections/IEnumerable.xml b/mcs/class/corlib/Documentation/en/System.Collections/IEnumerable.xml
index 9d48294c21c..ae95a1b9a24 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections/IEnumerable.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections/IEnumerable.xml
@@ -53,10 +53,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Collections.IEnumerator" />
-that can be used for simple iteration over a collection.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The foreach statement of the C# language (For Each in Visual Basic) hides the complexity of the enumerators.  Therefore, using foreach is recommended, instead of directly manipulating the enumerator.</para>
@@ -72,6 +68,10 @@ that can be used for simple iteration over a collection.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through a collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> object that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System.Collections/IEnumerator.xml b/mcs/class/corlib/Documentation/en/System.Collections/IEnumerator.xml
index 2364a54c3dd..0ea0c94960b 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections/IEnumerator.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections/IEnumerator.xml
@@ -94,11 +94,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the current instance was successfully advanced to the next element;
-<see langword="false" /> if the current instance has passed the end of the collection.</para>
-        </returns>
         <exception cref="T:System.InvalidOperationException">
           <para>The collection was modified after the current instance was instantiated.</para>
         </exception>
@@ -112,6 +107,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the enumerator to the next element of the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System.Collections/IEqualityComparer.xml b/mcs/class/corlib/Documentation/en/System.Collections/IEqualityComparer.xml
index d0bb8bf94ae..c7ce02ef9e1 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections/IEqualityComparer.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections/IEqualityComparer.xml
@@ -43,7 +43,6 @@
         <Parameter Name="y" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -53,6 +52,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified objects are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified objects are equal; otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare.</param>
         <param name="y">
@@ -74,7 +77,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -84,6 +86,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash code for the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the specified object.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> for which a hash code is to be returned.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Collections/IHashCodeProvider.xml b/mcs/class/corlib/Documentation/en/System.Collections/IHashCodeProvider.xml
index 3520f31432d..6ea5c4b1db8 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections/IHashCodeProvider.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections/IHashCodeProvider.xml
@@ -49,9 +49,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the hash code for the specified <see cref="T:System.Object" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="obj " /> is <see langword="null" />.</exception>
         <remarks>
@@ -62,6 +59,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash code for the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the specified object.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> for which a hash code is to be returned. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Collections/IList.xml b/mcs/class/corlib/Documentation/en/System.Collections/IList.xml
index 3384080d977..d28f62171c2 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections/IList.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections/IList.xml
@@ -51,9 +51,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the index of the current instance into which the new element was inserted.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="behaviors">As described above.</block>
@@ -72,6 +69,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an item to the <see cref="T:System.Collections.IList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position into which the new element was inserted, or -1 to indicate that the item was not inserted into the collection.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to add to the <see cref="T:System.Collections.IList" />. </param>
       </Docs>
@@ -123,10 +124,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the <see cref="T:System.Object" /> is found in the current instance; otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Starting with the .NET Framework 2.0, this method uses the collection’s objects’ <see cref="M:System.Object.Equals(System.Object)" /> and <see cref="M:System.IComparable.CompareTo(System.Object)" /> methods on <paramref name="item" /> to determine whether item exists. In the earlier versions of the .NET Framework, this determination was made by using the <see cref="M:System.Object.Equals(System.Object)" /> and <see cref="M:System.IComparable.CompareTo(System.Object)" /> methods of the <paramref name="item" /> parameter on the objects in the collection.</para>
@@ -135,6 +132,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Collections.IList" /> contains a specific value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Object" /> is found in the <see cref="T:System.Collections.IList" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to locate in the <see cref="T:System.Collections.IList" />. </param>
       </Docs>
@@ -157,10 +158,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The index of <paramref name="value" /> if found
-   in the current instance; otherwise, -1.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Starting with the .NET Framework 2.0, this method uses the collection’s objects’ <see cref="M:System.Object.Equals(System.Object)" /> and <see cref="M:System.IComparable.CompareTo(System.Object)" /> methods on <paramref name="item" /> to determine whether item exists. In the earlier versions of the .NET Framework, this determination was made by using the <see cref="M:System.Object.Equals(System.Object)" /> and <see cref="M:System.IComparable.CompareTo(System.Object)" /> methods of the <paramref name="item" /> parameter on the objects in the collection.</para>
@@ -169,6 +166,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of a specific item in the <see cref="T:System.Collections.IList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of <paramref name="value" /> if found in the list; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to locate in the <see cref="T:System.Collections.IList" />. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Collections/IStructuralComparable.xml b/mcs/class/corlib/Documentation/en/System.Collections/IStructuralComparable.xml
index 4c885440cbd..3fbdc34c730 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections/IStructuralComparable.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections/IStructuralComparable.xml
@@ -39,7 +39,6 @@
         <Parameter Name="comparer" Type="System.Collections.IComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Collections.IStructuralComparable.CompareTo(System.Object,System.Collections.IComparer)" /> method supports custom structural comparison and sorting of array and tuple objects. The <see cref="M:System.Collections.IStructuralComparable.CompareTo(System.Object,System.Collections.IComparer)" /> method calls the <paramref name="comparer" /> object's <see cref="M:System.Collections.IComparer.Compare(System.Object,System.Object)" /> method to compare individual array elements or tuple components, starting with the first element or component. The individual calls to <see cref="M:System.Collections.IComparer.Compare(System.Object,System.Object)" /> end and the <see cref="M:System.Collections.IStructuralComparable.CompareTo(System.Object,System.Collections.IComparer)" /> method returns a value when one of the following conditions becomes true:</para>
@@ -59,6 +58,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current collection object precedes, occurs in the same position as, or follows another object in the sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that indicates the relationship of the current collection object to <paramref name="other" />, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>-1</para>
+              </term>
+              <description>
+                <para>The current instance precedes <paramref name="other" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>0</para>
+              </term>
+              <description>
+                <para>The current instance and <paramref name="other" /> are equal.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>1</para>
+              </term>
+              <description>
+                <para>The current instance follows <paramref name="other" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current instance.</param>
         <param name="comparer">
diff --git a/mcs/class/corlib/Documentation/en/System.Collections/IStructuralEquatable.xml b/mcs/class/corlib/Documentation/en/System.Collections/IStructuralEquatable.xml
index dc2cfe14b23..091d49995e5 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections/IStructuralEquatable.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections/IStructuralEquatable.xml
@@ -38,7 +38,6 @@
         <Parameter Name="comparer" Type="System.Collections.IEqualityComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Collections.IStructuralEquatable.Equals(System.Object,System.Collections.IEqualityComparer)" /> method supports custom structural comparison of array and tuple objects. This method in turn calls the <paramref name="comparer" /> object's <see cref="M:System.Collections.IEqualityComparer.Equals(System.Object,System.Object)" /> method to compare individual array elements or tuple components, starting with the first element or component. The individual calls to <see cref="M:System.Collections.IEqualityComparer.Equals(System.Object,System.Object)" /> end and the <see cref="M:System.Collections.IStructuralEquatable.Equals(System.Object,System.Collections.IEqualityComparer)" /> method returns a value either when a method call returns false or after all array elements or tuple components have been compared. </para>
@@ -47,6 +46,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether an object is structurally equal to the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two objects are equal; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current instance.</param>
         <param name="comparer">
@@ -67,7 +70,6 @@
         <Parameter Name="comparer" Type="System.Collections.IEqualityComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implement this method to return customized hash codes for collection objects that correspond to the customized comparison for structural equality provided by the <see cref="M:System.Collections.IStructuralEquatable.Equals(System.Object,System.Collections.IEqualityComparer)" /> method.</para>
@@ -76,6 +78,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash code for the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the current instance.</para>
+        </returns>
         <param name="comparer">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that computes the hash code of the current object.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Collections/Queue.xml b/mcs/class/corlib/Documentation/en/System.Collections/Queue.xml
index e4c8af4dfa8..82d64e177f4 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections/Queue.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections/Queue.xml
@@ -203,7 +203,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>A copy of the <see cref="T:System.Collections.Queue" /> as a <see cref="T:System.Object" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A shallow copy of a collection copies only the elements of the collection, whether they are reference types or value types, but it does not copy the objects that the references refer to. The references in the new collection point to the same objects that the references in the original collection point to.</para>
@@ -214,6 +213,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a shallow copy of the <see cref="T:System.Collections.Queue" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A shallow copy of the <see cref="T:System.Collections.Queue" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Contains">
@@ -232,7 +235,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>Returns true if found and false if not found.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method determines equality by calling <see cref="M:System.Object.Equals(System.Object)" />.</para>
@@ -243,6 +245,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether an element is in the <see cref="T:System.Collections.Queue" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is found in the <see cref="T:System.Collections.Queue" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the <see cref="T:System.Collections.Queue" />. The value can be null. </param>
       </Docs>
@@ -320,7 +326,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>The first <see cref="T:System.Object" /> in the <see cref="T:System.Collections.Queue" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is similar to the <see cref="M:System.Collections.Queue.Peek" /> method, but <see cref="M:System.Collections.Queue.Peek" /> does not modify the <see cref="T:System.Collections.Queue" />.</para>
@@ -331,6 +336,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes and returns the object at the beginning of the <see cref="T:System.Collections.Queue" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object that is removed from the beginning of the <see cref="T:System.Collections.Queue" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Enqueue">
@@ -377,7 +386,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IEnumerator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The foreach statement of the C# language (for each in Visual Basic) hides the complexity of the enumerators.  Therefore, using foreach is recommended, instead of directly manipulating the enumerator.</para>
@@ -394,6 +402,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the <see cref="T:System.Collections.Queue" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.Collections.Queue" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsSynchronized">
@@ -435,7 +447,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is similar to the <see cref="M:System.Collections.Queue.Dequeue" /> method, but <see cref="M:System.Collections.Queue.Peek" /> does not modify the <see cref="T:System.Collections.Queue" />.</para>
@@ -446,6 +457,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the object at the beginning of the <see cref="T:System.Collections.Queue" /> without removing it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object at the beginning of the <see cref="T:System.Collections.Queue" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Synchronized">
@@ -464,7 +479,6 @@
         <Parameter Name="queue" Type="System.Collections.Queue" />
       </Parameters>
       <Docs>
-        <returns>The thread-safe version of the <see cref="T:System.Collections.Queue" /> passed in.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To guarantee the thread safety of the <see cref="T:System.Collections.Queue" />, all operations must be done through this wrapper only.</para>
@@ -474,6 +488,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Collections.Queue" /> wrapper that is synchronized (thread safe).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.Queue" /> wrapper that is synchronized (thread safe).</para>
+        </returns>
         <param name="queue">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.Queue" /> to synchronize. </param>
       </Docs>
@@ -517,7 +535,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>Returns a <see cref="T:System.Array" /> with the same items as the <see cref="T:System.Collections.Queue" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Collections.Queue" /> is not modified. The order of the elements in the new array is the same as the order of the elements from the beginning of the <see cref="T:System.Collections.Queue" /> to its end.</para>
@@ -527,6 +544,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the <see cref="T:System.Collections.Queue" /> elements to a new array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new array containing elements copied from the <see cref="T:System.Collections.Queue" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TrimToSize">
diff --git a/mcs/class/corlib/Documentation/en/System.Collections/ReadOnlyCollectionBase.xml b/mcs/class/corlib/Documentation/en/System.Collections/ReadOnlyCollectionBase.xml
index 2c773d75e19..8dfa39ebc11 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections/ReadOnlyCollectionBase.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections/ReadOnlyCollectionBase.xml
@@ -91,7 +91,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IEnumerator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The foreach statement of the C# language (for each in Visual Basic) hides the complexity of the enumerators.  Therefore, using foreach is recommended, instead of directly manipulating the enumerator.</para>
@@ -108,6 +107,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the <see cref="T:System.Collections.ReadOnlyCollectionBase" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.Collections.ReadOnlyCollectionBase" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InnerList">
diff --git a/mcs/class/corlib/Documentation/en/System.Collections/SortedList.xml b/mcs/class/corlib/Documentation/en/System.Collections/SortedList.xml
index b34f15d71cf..da907a7e035 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections/SortedList.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections/SortedList.xml
@@ -341,7 +341,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A shallow copy of a collection copies only the elements of the collection, whether they are reference types or value types, but does not copy the objects that the references refer to. The references in the new collection point to the same objects that the references in the original collection point to.</para>
@@ -352,6 +351,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a shallow copy of a <see cref="T:System.Collections.SortedList" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A shallow copy of the <see cref="T:System.Collections.SortedList" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Contains">
@@ -370,7 +373,6 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The elements of a <see cref="T:System.Collections.SortedList" /> object are sorted by the keys either according to a specific <see cref="T:System.Collections.IComparer" /> implementation specified when the <see cref="T:System.Collections.SortedList" /> is created or according to the <see cref="T:System.IComparable" /> implementation provided by the keys themselves.</para>
@@ -383,6 +385,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a <see cref="T:System.Collections.SortedList" /> object contains a specific key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Collections.SortedList" /> object contains an element with the specified <paramref name="key" />; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key to locate in the <see cref="T:System.Collections.SortedList" /> object. </param>
       </Docs>
@@ -403,7 +409,6 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The elements of a <see cref="T:System.Collections.SortedList" /> object are sorted by the keys either according to a specific <see cref="T:System.Collections.IComparer" /> implementation specified when the <see cref="T:System.Collections.SortedList" /> is created or according to the <see cref="T:System.IComparable" /> implementation provided by the keys themselves.</para>
@@ -415,6 +420,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a <see cref="T:System.Collections.SortedList" /> object contains a specific key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Collections.SortedList" /> object contains an element with the specified <paramref name="key" />; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key to locate in the <see cref="T:System.Collections.SortedList" /> object.</param>
       </Docs>
@@ -435,7 +444,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The values of the elements of the <see cref="T:System.Collections.SortedList" /> object are compared to the specified value using the <see cref="M:System.Object.Equals(System.Object)" /> method.</para>
@@ -446,6 +454,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a <see cref="T:System.Collections.SortedList" /> object contains a specific value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Collections.SortedList" /> object contains an element with the specified <paramref name="value" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to locate in the <see cref="T:System.Collections.SortedList" /> object. The value can be null. </param>
       </Docs>
@@ -529,7 +541,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The index sequence is based on the sort sequence. When an element is added, it is inserted into <see cref="T:System.Collections.SortedList" /> in the correct sort order, and the indexing adjusts accordingly. When an element is removed, the indexing also adjusts accordingly. Therefore, the index of a specific key/value pair might change as elements are added or removed from the <see cref="T:System.Collections.SortedList" /> object.</para>
@@ -539,6 +550,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value at the specified index of a <see cref="T:System.Collections.SortedList" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value at the specified index of the <see cref="T:System.Collections.SortedList" /> object.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the value to get. </param>
       </Docs>
@@ -557,7 +572,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IDictionaryEnumerator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The foreach statement of the C# language (for each in Visual Basic) hides the complexity of the enumerators.  Therefore, using foreach is recommended, instead of directly manipulating the enumerator.</para>
@@ -574,6 +588,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IDictionaryEnumerator" /> object that iterates through a <see cref="T:System.Collections.SortedList" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IDictionaryEnumerator" /> object for the <see cref="T:System.Collections.SortedList" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetKey">
@@ -592,7 +610,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The index sequence is based on the sort sequence. When an element is added, it is inserted into <see cref="T:System.Collections.SortedList" /> in the correct sort order, and the indexing adjusts accordingly. When an element is removed, the indexing also adjusts accordingly. Therefore, the index of a specific key/value pair might change as elements are added or removed from the <see cref="T:System.Collections.SortedList" /> object.</para>
@@ -602,6 +619,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the key at the specified index of a <see cref="T:System.Collections.SortedList" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The key at the specified index of the <see cref="T:System.Collections.SortedList" /> object.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the key to get. </param>
       </Docs>
@@ -620,7 +641,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IList'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned <see cref="T:System.Collections.IList" /> object is a read-only view of the keys of the <see cref="T:System.Collections.SortedList" /> object. Modifications made to the underlying <see cref="T:System.Collections.SortedList" /> are immediately reflected in the <see cref="T:System.Collections.IList" />.</para>
@@ -632,6 +652,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the keys in a <see cref="T:System.Collections.SortedList" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IList" /> object containing the keys in the <see cref="T:System.Collections.SortedList" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetValueList">
@@ -648,7 +672,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IList'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned <see cref="T:System.Collections.IList" /> object is a read-only view of the values of the <see cref="T:System.Collections.SortedList" /> object. Modifications made to the underlying <see cref="T:System.Collections.SortedList" /> are immediately reflected in the <see cref="T:System.Collections.IList" />.</para>
@@ -660,6 +683,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the values in a <see cref="T:System.Collections.SortedList" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IList" /> object containing the values in the <see cref="T:System.Collections.SortedList" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IndexOfKey">
@@ -678,7 +705,6 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The elements of a <see cref="T:System.Collections.SortedList" /> object are sorted by the keys either according to a specific <see cref="T:System.Collections.IComparer" /> implementation specified when the <see cref="T:System.Collections.SortedList" /> is created, or according to the <see cref="T:System.IComparable" /> implementation provided by the keys themselves.</para>
@@ -690,6 +716,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the zero-based index of the specified key in a <see cref="T:System.Collections.SortedList" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the <paramref name="key" /> parameter, if <paramref name="key" /> is found in the <see cref="T:System.Collections.SortedList" /> object; otherwise, -1.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key to locate in the <see cref="T:System.Collections.SortedList" /> object. </param>
       </Docs>
@@ -710,7 +740,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The index sequence is based on the sort sequence. When an element is added, it is inserted into <see cref="T:System.Collections.SortedList" /> in the correct sort order, and the indexing adjusts accordingly. When an element is removed, the indexing also adjusts accordingly. Therefore, the index of a specific key/value pair might change as elements are added or removed from the <see cref="T:System.Collections.SortedList" /> object.</para>
@@ -722,6 +751,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the zero-based index of the first occurrence of the specified value in a <see cref="T:System.Collections.SortedList" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of the <paramref name="value" /> parameter, if <paramref name="value" /> is found in the <see cref="T:System.Collections.SortedList" /> object; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to locate in the <see cref="T:System.Collections.SortedList" /> object. The value can be null. </param>
       </Docs>
@@ -960,7 +993,6 @@
         <Parameter Name="list" Type="System.Collections.SortedList" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SortedList'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To guarantee the thread safety of a <see cref="T:System.Collections.SortedList" /> object, all operations must be done through this wrapper only.</para>
@@ -970,6 +1002,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a synchronized (thread-safe) wrapper for a <see cref="T:System.Collections.SortedList" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A synchronized (thread-safe) wrapper for the <see cref="T:System.Collections.SortedList" /> object.</para>
+        </returns>
         <param name="list">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.SortedList" /> object to synchronize. </param>
       </Docs>
@@ -1013,7 +1049,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>[Visual Basic, C#]</para>
@@ -1031,6 +1066,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IEnumerator" /> that iterates through the <see cref="T:System.Collections.SortedList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.Collections.SortedList" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TrimToSize">
diff --git a/mcs/class/corlib/Documentation/en/System.Collections/Stack.xml b/mcs/class/corlib/Documentation/en/System.Collections/Stack.xml
index fc1394dbdf2..d5988f5b09a 100644
--- a/mcs/class/corlib/Documentation/en/System.Collections/Stack.xml
+++ b/mcs/class/corlib/Documentation/en/System.Collections/Stack.xml
@@ -169,7 +169,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A shallow copy of a collection copies only the elements of the collection, whether they are reference types or value types, but it does not copy the objects that the references refer to. The references in the new collection point to the same objects that the references in the original collection point to.</para>
@@ -180,6 +179,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a shallow copy of the <see cref="T:System.Collections.Stack" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A shallow copy of the <see cref="T:System.Collections.Stack" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Contains">
@@ -198,7 +201,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method determines equality by calling <see cref="M:System.Object.Equals(System.Object)" />.</para>
@@ -209,6 +211,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether an element is in the <see cref="T:System.Collections.Stack" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if <paramref name="obj" /> is found in the <see cref="T:System.Collections.Stack" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to locate in the <see cref="T:System.Collections.Stack" />. The value can be null. </param>
       </Docs>
@@ -285,7 +291,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IEnumerator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>[Visual Basic, C#]</para>
@@ -303,6 +308,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.Collections.Stack" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.Collections.Stack" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsSynchronized">
@@ -347,7 +356,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is similar to the <see cref="M:System.Collections.Stack.Pop" /> method, but <see cref="M:System.Collections.Stack.Peek" /> does not modify the <see cref="T:System.Collections.Stack" />.</para>
@@ -358,6 +366,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the object at the top of the <see cref="T:System.Collections.Stack" /> without removing it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> at the top of the <see cref="T:System.Collections.Stack" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Pop">
@@ -374,7 +386,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is similar to the <see cref="M:System.Collections.Stack.Peek" /> method, but <see cref="M:System.Collections.Stack.Peek" /> does not modify the <see cref="T:System.Collections.Stack" />.</para>
@@ -386,6 +397,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes and returns the object at the top of the <see cref="T:System.Collections.Stack" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Object" /> removed from the top of the <see cref="T:System.Collections.Stack" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Push">
@@ -436,7 +451,6 @@
         <Parameter Name="stack" Type="System.Collections.Stack" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Stack'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To guarantee the thread safety of the <see cref="T:System.Collections.Stack" />, all operations must be done through this wrapper.</para>
@@ -449,6 +463,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a synchronized (thread safe) wrapper for the <see cref="T:System.Collections.Stack" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A synchronized wrapper around the <see cref="T:System.Collections.Stack" />.</para>
+        </returns>
         <param name="stack">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Collections.Stack" /> to synchronize. </param>
       </Docs>
@@ -495,7 +513,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The elements are copied onto the array in last-in-first-out (LIFO) order, similar to the order of the elements returned by a succession of calls to <see cref="M:System.Collections.Stack.Pop" />.</para>
@@ -505,6 +522,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the <see cref="T:System.Collections.Stack" /> to a new array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new array containing copies of the elements of the <see cref="T:System.Collections.Stack" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Configuration.Assemblies/AssemblyHash.xml b/mcs/class/corlib/Documentation/en/System.Configuration.Assemblies/AssemblyHash.xml
index 6d68c9ccf9b..3bf8cf8521a 100644
--- a/mcs/class/corlib/Documentation/en/System.Configuration.Assemblies/AssemblyHash.xml
+++ b/mcs/class/corlib/Documentation/en/System.Configuration.Assemblies/AssemblyHash.xml
@@ -147,12 +147,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clones this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An exact copy of this object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Empty">
@@ -200,12 +203,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash value.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SetValue">
diff --git a/mcs/class/corlib/Documentation/en/System.Deployment.Internal/InternalActivationContextHelper.xml b/mcs/class/corlib/Documentation/en/System.Deployment.Internal/InternalActivationContextHelper.xml
index e56c3c83092..77b2c0dac10 100644
--- a/mcs/class/corlib/Documentation/en/System.Deployment.Internal/InternalActivationContextHelper.xml
+++ b/mcs/class/corlib/Documentation/en/System.Deployment.Internal/InternalActivationContextHelper.xml
@@ -42,12 +42,15 @@
         <Parameter Name="appInfo" Type="System.ActivationContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the contents of the application manifest from an <see cref="T:System.ActivationContext" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The application manifest that is contained by the <see cref="T:System.ActivationContext" /> object.</para>
+        </returns>
         <param name="appInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />The object containing the manifest.</param>
       </Docs>
@@ -67,12 +70,15 @@
         <Parameter Name="appInfo" Type="System.ActivationContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the manifest of the last deployment component in an <see cref="T:System.ActivationContext" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The manifest of the last deployment component in the <see cref="T:System.ActivationContext" /> object.</para>
+        </returns>
         <param name="appInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />The object containing the manifest.</param>
       </Docs>
@@ -92,12 +98,15 @@
         <Parameter Name="appInfo" Type="System.ActivationContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a byte array containing the raw content of the application manifest..</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array containing the application manifest as raw data.</para>
+        </returns>
         <param name="appInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to get bytes from.</param>
       </Docs>
@@ -117,12 +126,15 @@
         <Parameter Name="appInfo" Type="System.ActivationContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the manifest of the first deployment component in an <see cref="T:System.ActivationContext" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The manifest of the first deployment component in the <see cref="T:System.ActivationContext" /> object.</para>
+        </returns>
         <param name="appInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />The object containing the manifest.</param>
       </Docs>
@@ -142,12 +154,15 @@
         <Parameter Name="appInfo" Type="System.ActivationContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a byte array containing the raw content of the deployment manifest.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array containing the deployment manifest as raw data.</para>
+        </returns>
         <param name="appInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to get bytes from.</param>
       </Docs>
@@ -167,12 +182,15 @@
         <Parameter Name="appInfo" Type="System.ActivationContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether this is the first time this <see cref="T:System.ActivationContext" /> object has been run.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ActivationContext" /> indicates it is running for the first time; otherwise, false.</para>
+        </returns>
         <param name="appInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to examine.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Deployment.Internal/InternalApplicationIdentityHelper.xml b/mcs/class/corlib/Documentation/en/System.Deployment.Internal/InternalApplicationIdentityHelper.xml
index 23ba60ebc70..16727869dd4 100644
--- a/mcs/class/corlib/Documentation/en/System.Deployment.Internal/InternalApplicationIdentityHelper.xml
+++ b/mcs/class/corlib/Documentation/en/System.Deployment.Internal/InternalApplicationIdentityHelper.xml
@@ -58,12 +58,15 @@
         <Parameter Name="id" Type="System.ApplicationIdentity" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <format type="text/html"><a href="e72f2550-bdec-4a20-a2f4-2e14847266c1">IDefinitionAppId Interface</a></format> representing the unique identifier of an <see cref="T:System.ApplicationIdentity" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The unique identifier held by the <see cref="T:System.ApplicationIdentity" /> object.</para>
+        </returns>
         <param name="id">
           <attribution license="cc4" from="Microsoft" modified="false" />The object from which to extract the identifier.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Diagnostics.Contracts.Internal/ContractHelper.xml b/mcs/class/corlib/Documentation/en/System.Diagnostics.Contracts.Internal/ContractHelper.xml
index 72f231e1b89..66c6820e22b 100644
--- a/mcs/class/corlib/Documentation/en/System.Diagnostics.Contracts.Internal/ContractHelper.xml
+++ b/mcs/class/corlib/Documentation/en/System.Diagnostics.Contracts.Internal/ContractHelper.xml
@@ -48,7 +48,6 @@
         <Parameter Name="innerException" Type="System.Exception" />
       </Parameters>
       <Docs>
-        <returns>The code contract failure message, if the failure has not been handled already. Null if the failure has been handled successfully.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The binary rewriter calls this method to notify listeners about a contract failure. The <see cref="M:System.Diagnostics.Contracts.Internal.ContractHelper.RaiseContractFailedEvent(System.Diagnostics.Contracts.ContractFailureKind,System.String,System.String,System.Exception)" /> method does not perform the failure behavior (an assert or throw) itself. If the failure is handled by the listeners, the method returns null. If the failure is not handled by the listeners, a localized failure message is returned.</para>
@@ -57,6 +56,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used by the binary rewriter to activate the default failure behavior.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A null reference (Nothing in Visual Basic) if the event was handled and should not trigger a failure; otherwise, returns the localized failure message.</para>
+        </returns>
         <param name="failureKind">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of failure.</param>
         <param name="userMessage">
diff --git a/mcs/class/corlib/Documentation/en/System.Diagnostics.Contracts/Contract.xml b/mcs/class/corlib/Documentation/en/System.Diagnostics.Contracts/Contract.xml
index a2530453d49..3b6be8037f1 100644
--- a/mcs/class/corlib/Documentation/en/System.Diagnostics.Contracts/Contract.xml
+++ b/mcs/class/corlib/Documentation/en/System.Diagnostics.Contracts/Contract.xml
@@ -461,7 +461,6 @@
         <Parameter Name="predicate" Type="System.Predicate&lt;System.Int32&gt;" />
       </Parameters>
       <Docs>
-        <returns>Whether at least one value in the range satisfies the predicate.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="toExclusive" /> parameter is one more than the last integer to facilitate using the length of a range of integers starting at 0. For example, it would be set to 5 for integers 0 through 4.</para>
@@ -470,6 +469,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a specified test is true for any integer within a range of integers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            true if <paramref name="predicate" /> returns true for any integer starting from <paramref name="fromInclusive" /> to <paramref name="toExclusive" /> - 1.</para>
+        </returns>
         <param name="fromInclusive">
           <attribution license="cc4" from="Microsoft" modified="false" />The first integer to pass to <paramref name="predicate" />.</param>
         <param name="toExclusive">
@@ -501,12 +505,16 @@
         <Parameter Name="predicate" Type="System.Predicate&lt;T&gt;" />
       </Parameters>
       <Docs>
-        <returns>Whether at least one element in the collection satisfies the predicate.</returns>
         <remarks>This method can be used within a contract condition to allow contracts to be applied to collections.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether an element within a collection of elements exists within a function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+                    true if and only if <paramref name="predicate" /> returns true for any element of type <paramref name="T" /> in <paramref name="collection" />.</para>
+        </returns>
         <param name="collection">
           <attribution license="cc4" from="Microsoft" modified="false" />The collection from which elements of type <paramref name="T" /> will be drawn to pass to <paramref name="predicate" />.</param>
         <param name="predicate">
@@ -536,7 +544,6 @@
         <Parameter Name="predicate" Type="System.Predicate&lt;System.Int32&gt;" />
       </Parameters>
       <Docs>
-        <returns>Whether all values in the range satisfy the predicate.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="toExclusive" /> parameter is one more than the last integer to facilitate using the length of a range of integers starting at 0. For example, it would be set to 5 for integers 0 through 4.</para>
@@ -545,6 +552,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a particular condition is valid for all integers in a specified range.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+                    true if <paramref name="predicate" /> returns true for all integers starting from <paramref name="fromInclusive" /> to <paramref name="toExclusive" /> - 1.</para>
+        </returns>
         <param name="fromInclusive">
           <attribution license="cc4" from="Microsoft" modified="false" />The first integer to pass to <paramref name="predicate" />.</param>
         <param name="toExclusive">
@@ -576,12 +588,16 @@
         <Parameter Name="predicate" Type="System.Predicate&lt;T&gt;" />
       </Parameters>
       <Docs>
-        <returns>Whether all elements in the collection satisfy the predicate.</returns>
         <remarks>This method can be used within a contract condition to allow contracts to be applied to collections.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether all the elements in a collection exist within a function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+                            true if and only if <paramref name="predicate" /> returns true for all elements of type <paramref name="T" /> in <paramref name="collection" />.</para>
+        </returns>
         <param name="collection">
           <attribution license="cc4" from="Microsoft" modified="false" />The collection from which elements of type <paramref name="T" /> will be drawn to pass to <paramref name="predicate" />.</param>
         <param name="predicate">
@@ -1139,7 +1155,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>The return value.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used only in the conditional expression for the <see cref="Overload:System.Diagnostics.Contracts.Contract.Ensures" /> contract.</para>
@@ -1148,6 +1163,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Represents the return value of a method or property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Return value of the enclosing method or property.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />Type of return value of the enclosing method or property.</typeparam>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolBinder.xml b/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolBinder.xml
index f7d6ac31ac5..86f5a1280c6 100644
--- a/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolBinder.xml
+++ b/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolBinder.xml
@@ -52,7 +52,6 @@
         <Parameter Name="searchPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ISymbolReader'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When given a metadata interface, a file name, and a search path, the <see cref="M:System.Diagnostics.SymbolStore.ISymbolBinder.GetReader(System.Int32,System.String,System.String)" /> method returns the <see cref="T:System.Diagnostics.SymbolStore.ISymbolReader" /> interface that reads the debugging symbols associated with the module.</para>
@@ -61,6 +60,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the interface of the symbol reader for the current file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Diagnostics.SymbolStore.ISymbolReader" /> interface that reads the debugging symbols.</para>
+        </returns>
         <param name="importer">
           <attribution license="cc4" from="Microsoft" modified="false" />The metadata import interface. </param>
         <param name="filename">
diff --git a/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolBinder1.xml b/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolBinder1.xml
index 49c3b77c29a..2900e4b5249 100644
--- a/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolBinder1.xml
+++ b/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolBinder1.xml
@@ -46,7 +46,6 @@
         <Parameter Name="searchPath" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -56,6 +55,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the interface of the symbol reader for the current file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Diagnostics.SymbolStore.ISymbolReader" /> interface that reads the debugging symbols.</para>
+        </returns>
         <param name="importer">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IntPtr" /> that refers to the metadata import interface. </param>
         <param name="filename">
diff --git a/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolDocument.xml b/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolDocument.xml
index 27b2c47bf9f..f455d408e88 100644
--- a/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolDocument.xml
+++ b/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolDocument.xml
@@ -89,12 +89,15 @@
         <Parameter Name="line" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the closest line that is a sequence point, given a line in the current document that might or might not be a sequence point.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The closest line that is a sequence point.</para>
+        </returns>
         <param name="line">
           <attribution license="cc4" from="Microsoft" modified="false" />The specified line in the document. </param>
       </Docs>
@@ -113,12 +116,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the checksum.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The checksum.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetSourceRange">
@@ -140,12 +146,15 @@
         <Parameter Name="endColumn" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the embedded document source for the specified range.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The document source for the specified range.</para>
+        </returns>
         <param name="startLine">
           <attribution license="cc4" from="Microsoft" modified="false" />The starting line in the current document. </param>
         <param name="startColumn">
diff --git a/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolMethod.xml b/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolMethod.xml
index 1c5dd4c9abd..d9a175f764c 100644
--- a/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolMethod.xml
+++ b/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolMethod.xml
@@ -44,12 +44,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ISymbolNamespace'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the namespace that the current method is defined within.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The namespace that the current method is defined within.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOffset">
@@ -70,7 +73,6 @@
         <Parameter Name="column" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The parameters are returned in the order that they are defined within the signature of the method.</para>
@@ -79,6 +81,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the Microsoft intermediate language (MSIL) offset within the method that corresponds to the specified position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The offset within the specified document.</para>
+        </returns>
         <param name="document">
           <attribution license="cc4" from="Microsoft" modified="false" />The document for which the offset is requested. </param>
         <param name="line">
@@ -101,7 +107,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ISymbolVariable []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The parameters are returned in the order that they are defined within the signature of the method.</para>
@@ -110,6 +115,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the parameters for the current method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The array of parameters for the current method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetRanges">
@@ -130,7 +139,6 @@
         <Parameter Name="column" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The array is an array of integers in the format {{start1, end1}, {start2, end2}...}. The number of range pairs is the length of the array divided by 2.</para>
@@ -139,6 +147,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of start and end offset pairs that correspond to the ranges of Microsoft intermediate language (MSIL) that a given position covers within this method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of start and end offset pairs.</para>
+        </returns>
         <param name="document">
           <attribution license="cc4" from="Microsoft" modified="false" />The document for which the offset is requested. </param>
         <param name="line">
@@ -163,7 +175,6 @@
         <Parameter Name="offset" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ISymbolScope'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the <see cref="M:System.Diagnostics.SymbolStore.ISymbolMethod.GetScope(System.Int32)" /> method to start local variable searches.</para>
@@ -172,6 +183,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the most enclosing lexical scope when given an offset within a method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The most enclosing lexical scope for the given byte offset within the method.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte offset within the method of the lexical scope. </param>
       </Docs>
@@ -239,7 +254,6 @@
         <Parameter Name="columns" Type="System.Int32[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The first array position is the start, and the second is the end.</para>
@@ -248,6 +262,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the start and end positions for the source of the current method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the positions were defined; otherwise, false.</para>
+        </returns>
         <param name="docs">
           <attribution license="cc4" from="Microsoft" modified="false" />The starting and ending source documents. </param>
         <param name="lines">
diff --git a/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolNamespace.xml b/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolNamespace.xml
index 1a52c611b47..0a797f6e691 100644
--- a/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolNamespace.xml
+++ b/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolNamespace.xml
@@ -43,12 +43,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ISymbolNamespace []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the child members of the current namespace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The child members of the current namespace.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetVariables">
@@ -65,12 +68,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ISymbolVariable []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all the variables defined at global scope within the current namespace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The variables defined at global scope within the current namespace.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Name">
diff --git a/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolReader.xml b/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolReader.xml
index d3a319d427f..760966d88a1 100644
--- a/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolReader.xml
+++ b/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolReader.xml
@@ -49,12 +49,15 @@
         <Parameter Name="documentType" Type="System.Guid" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ISymbolDocument'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a document specified by the language, vendor, and type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified document.</para>
+        </returns>
         <param name="url">
           <attribution license="cc4" from="Microsoft" modified="false" />The URL that identifies the document. </param>
         <param name="language">
@@ -79,12 +82,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ISymbolDocument []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of all documents defined in the symbol store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of all documents defined in the symbol store.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetGlobalVariables">
@@ -101,12 +107,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ISymbolVariable []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all global variables in the module.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of all variables in the module.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetMethod">
@@ -125,12 +134,15 @@
         <Parameter Name="method" Type="System.Diagnostics.SymbolStore.SymbolToken" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ISymbolMethod'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a symbol reader method object when given the identifier of a method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The symbol reader method object for the specified method identifier.</para>
+        </returns>
         <param name="method">
           <attribution license="cc4" from="Microsoft" modified="false" />The metadata token of the method. </param>
       </Docs>
@@ -152,12 +164,15 @@
         <Parameter Name="version" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ISymbolMethod'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a symbol reader method object when given the identifier of a method and its edit and continue version.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The symbol reader method object for the specified method identifier.</para>
+        </returns>
         <param name="method">
           <attribution license="cc4" from="Microsoft" modified="false" />The metadata token of the method. </param>
         <param name="version">
@@ -182,12 +197,15 @@
         <Parameter Name="column" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ISymbolMethod'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a symbol reader method object that contains a specified position in a document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The reader method object for the specified position in the document.</para>
+        </returns>
         <param name="document">
           <attribution license="cc4" from="Microsoft" modified="false" />The document in which the method is located. </param>
         <param name="line">
@@ -210,12 +228,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ISymbolNamespace []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the namespaces that are defined in the global scope within the current symbol store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The namespaces defined in the global scope within the current symbol store.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetSymAttribute">
@@ -235,7 +256,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This attribute is only associated with symbolic information and is not a metadata custom attribute.</para>
@@ -244,6 +264,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an attribute value when given the attribute name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the attribute.</para>
+        </returns>
         <param name="parent">
           <attribution license="cc4" from="Microsoft" modified="false" />The metadata token for the object for which the attribute is requested. </param>
         <param name="name">
@@ -266,12 +290,15 @@
         <Parameter Name="parent" Type="System.Diagnostics.SymbolStore.SymbolToken" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ISymbolVariable []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the variables that are not local when given the parent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of variables for the parent.</para>
+        </returns>
         <param name="parent">
           <attribution license="cc4" from="Microsoft" modified="false" />The metadata token for the type for which the variables are requested. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolScope.xml b/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolScope.xml
index 267d84e9f5e..5c32428a858 100644
--- a/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolScope.xml
+++ b/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolScope.xml
@@ -65,12 +65,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ISymbolScope []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the child lexical scopes of the current lexical scope.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The child lexical scopes that of the current lexical scope.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetLocals">
@@ -87,7 +90,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ISymbolVariable []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The local variables are returned in no particular order. If a local variable changes its address within the current scope, that variable is returned multiple times, each with a different offset range.</para>
@@ -96,6 +98,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the local variables within the current lexical scope.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The local variables within the current lexical scope.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetNamespaces">
@@ -112,12 +118,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ISymbolNamespace []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the namespaces that are used within the current scope.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The namespaces that are used within the current scope.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Method">
diff --git a/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolVariable.xml b/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolVariable.xml
index 339b48fd175..638dd97f7d0 100644
--- a/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolVariable.xml
+++ b/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolVariable.xml
@@ -182,12 +182,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the variable signature.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The variable signature as an opaque blob.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Name">
diff --git a/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolWriter.xml b/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolWriter.xml
index 9ce0a09a7e6..9130f91a4f5 100644
--- a/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolWriter.xml
+++ b/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/ISymbolWriter.xml
@@ -146,12 +146,15 @@
         <Parameter Name="documentType" Type="System.Guid" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ISymbolDocumentWriter'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a source document.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object that represents the document.</para>
+        </returns>
         <param name="url">
           <attribution license="cc4" from="Microsoft" modified="false" />The URL that identifies the document. </param>
         <param name="language">
@@ -503,7 +506,6 @@
         <Parameter Name="startOffset" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This scope becomes the new current scope and is pushed onto a stack of scopes. Scopes must form a hierarchy. Siblings are not allowed to overlap.</para>
@@ -513,6 +515,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a new lexical scope in the current method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An opaque scope identifier that can be used with <see cref="M:System.Diagnostics.SymbolStore.ISymbolWriter.SetScopeRange(System.Int32,System.Int32,System.Int32)" /> to define the start and end offsets of a scope at a later time. In this case, the offsets passed to <see cref="M:System.Diagnostics.SymbolStore.ISymbolWriter.OpenScope(System.Int32)" /> and <see cref="M:System.Diagnostics.SymbolStore.ISymbolWriter.CloseScope(System.Int32)" /> are ignored. A scope identifier is valid only in the current method.</para>
+        </returns>
         <param name="startOffset">
           <attribution license="cc4" from="Microsoft" modified="false" />The offset, in bytes, from the beginning of the method to the first instruction in the lexical scope. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/SymbolToken.xml b/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/SymbolToken.xml
index 72d2e224544..d9b6804a9aa 100644
--- a/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/SymbolToken.xml
+++ b/mcs/class/corlib/Documentation/en/System.Diagnostics.SymbolStore/SymbolToken.xml
@@ -65,13 +65,16 @@
         <Parameter Name="obj" Type="System.Diagnostics.SymbolStore.SymbolToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether <paramref name="obj" /> is equal to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is equal to this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Diagnostics.SymbolStore.SymbolToken" /> to check.</param>
       </Docs>
@@ -92,12 +95,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether <paramref name="obj" /> is an instance of <see cref="T:System.Diagnostics.SymbolStore.SymbolToken" /> and is equal to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is an instance of <see cref="T:System.Diagnostics.SymbolStore.SymbolToken" /> and is equal to this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to check. </param>
       </Docs>
@@ -116,12 +122,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates the hash code for the current token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the current token.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetToken">
@@ -138,12 +147,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the current token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current token.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="op_Equality">
@@ -162,12 +174,15 @@
         <Parameter Name="b" Type="System.Diagnostics.SymbolStore.SymbolToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether two <see cref="T:System.Diagnostics.SymbolStore.SymbolToken" /> objects are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> and <paramref name="b" /> are equal; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Diagnostics.SymbolStore.SymbolToken" /> structure.</param>
         <param name="b">
@@ -190,12 +205,15 @@
         <Parameter Name="b" Type="System.Diagnostics.SymbolStore.SymbolToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether two <see cref="T:System.Diagnostics.SymbolStore.SymbolToken" /> objects are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> and <paramref name="b" /> are not equal; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Diagnostics.SymbolStore.SymbolToken" /> structure.</param>
         <param name="b">
diff --git a/mcs/class/corlib/Documentation/en/System.Diagnostics.Tracing/EventSource.xml b/mcs/class/corlib/Documentation/en/System.Diagnostics.Tracing/EventSource.xml
index d4b62f5be5d..d9f8b8e899b 100644
--- a/mcs/class/corlib/Documentation/en/System.Diagnostics.Tracing/EventSource.xml
+++ b/mcs/class/corlib/Documentation/en/System.Diagnostics.Tracing/EventSource.xml
@@ -127,12 +127,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current event source is enabled.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current event source is enabled; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="WriteEvent">
diff --git a/mcs/class/corlib/Documentation/en/System.Diagnostics/Debugger.xml b/mcs/class/corlib/Documentation/en/System.Diagnostics/Debugger.xml
index e8d219fdba1..60453b48b1f 100644
--- a/mcs/class/corlib/Documentation/en/System.Diagnostics/Debugger.xml
+++ b/mcs/class/corlib/Documentation/en/System.Diagnostics/Debugger.xml
@@ -134,12 +134,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks to see if logging is enabled by an attached debugger.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a debugger is attached and logging is enabled; otherwise, false. The attached debugger is the registered managed debugger in the DbgManagedDebugger registry key. For more information on this key, see <format type="text/html"><a href="F91FC5F7-DE5A-4F23-B6AC-F450E63C662E">[&lt;topic://cpconenablingjit-attachdebugging&gt;]</a></format>.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Launch">
@@ -156,7 +159,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If a debugger is already attached, nothing happens.</para>
@@ -165,6 +167,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Launches and attaches a debugger to the process.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the startup is successful or if the debugger is already attached; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Log">
diff --git a/mcs/class/corlib/Documentation/en/System.Diagnostics/StackFrame.xml b/mcs/class/corlib/Documentation/en/System.Diagnostics/StackFrame.xml
index cee586757aa..2d610fb8329 100644
--- a/mcs/class/corlib/Documentation/en/System.Diagnostics/StackFrame.xml
+++ b/mcs/class/corlib/Documentation/en/System.Diagnostics/StackFrame.xml
@@ -198,12 +198,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>Only available if the debugging informations are available.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the column number in the file that contains the code that is executing. This information is typically extracted from the debugging symbols for the executable.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The file column number, or 0 (zero) if the file column number cannot be determined.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetFileLineNumber">
@@ -220,12 +223,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>Only available if the debugging informations are available.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the line number in the file that contains the code that is executing. This information is typically extracted from the debugging symbols for the executable.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The file line number, or 0 (zero) if the file line number cannot be determined.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetFileName">
@@ -242,12 +248,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>Only available if the debugging informations are available.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the file name that contains the code that is executing. This information is typically extracted from the debugging symbols for the executable.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The file name, or null if the file name cannot be determined.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetILOffset">
@@ -264,12 +273,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the offset from the start of the Microsoft intermediate language (MSIL) code for the method that is executing. This offset might be an approximation depending on whether or not the just-in-time (JIT) compiler is generating debugging code. The generation of this debugging information is controlled by the <see cref="T:System.Diagnostics.DebuggableAttribute" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The offset from the start of the MSIL code for the method that is executing.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetMethod">
@@ -286,7 +298,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Reflection.MethodBase'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method that is currently executing may be inherited from a base class, although it is called in a derived class. In this case, the <see cref="P:System.Reflection.MemberInfo.ReflectedType" /> property of the <see cref="T:System.Reflection.MethodBase" /> object that is returned by <see cref="M:System.Diagnostics.StackFrame.GetMethod" /> identifies the base class, not the derived class.  </para>
@@ -295,6 +306,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the method in which the frame is executing.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The method in which the frame is executing.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetNativeOffset">
@@ -311,12 +326,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the offset from the start of the native just-in-time (JIT)-compiled code for the method that is being executed. The generation of this debugging information is controlled by the <see cref="T:System.Diagnostics.DebuggableAttribute" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The offset from the start of the JIT-compiled code for the method that is being executed.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="OFFSET_UNKNOWN">
@@ -358,12 +376,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds a readable representation of the stack trace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A readable representation of the stack trace.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Diagnostics/StackTrace.xml b/mcs/class/corlib/Documentation/en/System.Diagnostics/StackTrace.xml
index 5ca9abc3826..bbebf361fbc 100644
--- a/mcs/class/corlib/Documentation/en/System.Diagnostics/StackTrace.xml
+++ b/mcs/class/corlib/Documentation/en/System.Diagnostics/StackTrace.xml
@@ -358,7 +358,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'StackFrame'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Stack frames are numbered starting at 0, which is the last stack frame pushed.</para>
@@ -367,6 +366,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the specified stack frame.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified stack frame.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the stack frame requested. </param>
       </Docs>
@@ -389,7 +392,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -401,6 +403,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a copy of all stack frames in the current stack trace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Diagnostics.StackFrame" /> representing the function calls in the stack trace.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="METHODS_TO_SKIP">
@@ -442,12 +448,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Builds a readable representation of the stack trace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A readable representation of the stack trace.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Globalization/Calendar.xml b/mcs/class/corlib/Documentation/en/System.Globalization/Calendar.xml
index 780d48edf16..e293a030c86 100644
--- a/mcs/class/corlib/Documentation/en/System.Globalization/Calendar.xml
+++ b/mcs/class/corlib/Documentation/en/System.Globalization/Calendar.xml
@@ -155,7 +155,6 @@
         <Parameter Name="days" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DateTime'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="days" /> value is added to the specified <see cref="T:System.DateTime" />. If <paramref name="days" /> is negative, the resulting <see cref="T:System.DateTime" /> is earlier than the specified <see cref="T:System.DateTime" />.</para>
@@ -167,6 +166,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is the specified number of days away from the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that results from adding the specified number of days to the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to which to add days. </param>
         <param name="days">
@@ -190,7 +193,6 @@
         <Parameter Name="hours" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DateTime'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="hours" /> value is added to the specified <see cref="T:System.DateTime" />. If <paramref name="hours" /> is negative, the resulting <see cref="T:System.DateTime" /> is earlier than the specified <see cref="T:System.DateTime" />.</para>
@@ -202,6 +204,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is the specified number of hours away from the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that results from adding the specified number of hours to the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to which to add hours. </param>
         <param name="hours">
@@ -225,7 +231,6 @@
         <Parameter Name="milliseconds" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DateTime'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="milliseconds" /> value is rounded to the nearest integer before it is added to the specified <see cref="T:System.DateTime" />. If <paramref name="milliseconds" /> is negative, the resulting <see cref="T:System.DateTime" /> is earlier than the specified <see cref="T:System.DateTime" />.</para>
@@ -237,6 +242,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is the specified number of milliseconds away from the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that results from adding the specified number of milliseconds to the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to add milliseconds to. </param>
         <param name="milliseconds">
@@ -260,7 +269,6 @@
         <Parameter Name="minutes" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DateTime'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="minutes" /> value is added to the specified <see cref="T:System.DateTime" />. If <paramref name="minutes" /> is negative, the resulting <see cref="T:System.DateTime" /> is earlier than the specified <see cref="T:System.DateTime" />.</para>
@@ -272,6 +280,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is the specified number of minutes away from the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that results from adding the specified number of minutes to the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to which to add minutes. </param>
         <param name="minutes">
@@ -295,7 +307,6 @@
         <Parameter Name="months" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DateTime'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="months" /> value is added to the specified <see cref="T:System.DateTime" />. If <paramref name="months" /> is negative, the resulting <see cref="T:System.DateTime" /> is earlier than the specified <see cref="T:System.DateTime" />.</para>
@@ -309,6 +320,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns a <see cref="T:System.DateTime" /> that is the specified number of months away from the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that results from adding the specified number of months to the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to which to add months. </param>
         <param name="months">
@@ -332,7 +347,6 @@
         <Parameter Name="seconds" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DateTime'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="seconds" /> value is added to the specified <see cref="T:System.DateTime" />. If <paramref name="seconds" /> is negative, the resulting <see cref="T:System.DateTime" /> is earlier than the specified <see cref="T:System.DateTime" />.</para>
@@ -344,6 +358,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is the specified number of seconds away from the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that results from adding the specified number of seconds to the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to which to add seconds. </param>
         <param name="seconds">
@@ -367,7 +385,6 @@
         <Parameter Name="weeks" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DateTime'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="weeks" /> value is added to the specified <see cref="T:System.DateTime" />. If <paramref name="weeks" /> is negative, the resulting <see cref="T:System.DateTime" /> is earlier than the specified <see cref="T:System.DateTime" />.</para>
@@ -380,6 +397,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is the specified number of weeks away from the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that results from adding the specified number of weeks to the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to which to add weeks. </param>
         <param name="weeks">
@@ -403,7 +424,6 @@
         <Parameter Name="years" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DateTime'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="years" /> value is added to the specified <see cref="T:System.DateTime" />. If <paramref name="years" /> is negative, the resulting <see cref="T:System.DateTime" /> is earlier than the specified <see cref="T:System.DateTime" />.</para>
@@ -417,6 +437,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns a <see cref="T:System.DateTime" /> that is the specified number of years away from the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that results from adding the specified number of years to the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to which to add years. </param>
         <param name="years">
@@ -467,7 +491,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -477,6 +500,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new object that is a copy of the current <see cref="T:System.Globalization.Calendar" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.Object" /> that is the memberwise clone of the current <see cref="T:System.Globalization.Calendar" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CurrentEra">
@@ -566,12 +593,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the day of the month in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A positive integer that represents the day of the month in the <paramref name="time" /> parameter.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -592,7 +622,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DayOfWeek'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.DayOfWeek" /> values are Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, and Saturday.</para>
@@ -601,6 +630,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the day of the week in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DayOfWeek" /> value that represents the day of the week in the <paramref name="time" /> parameter.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -621,7 +654,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The day of the year is defined as the number of days from the first day of the year. For example, in <see cref="T:System.Globalization.GregorianCalendar" />, <see cref="M:System.Globalization.Calendar.GetDayOfYear(System.DateTime)" /> for January 1 returns 1, and <see cref="M:System.Globalization.Calendar.GetDayOfYear(System.DateTime)" /> for December 31 returns 365 in a common year or 366 in a leap year.</para>
@@ -630,6 +662,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the day of the year in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A positive integer that represents the day of the year in the <paramref name="time" /> parameter.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -651,7 +687,6 @@
         <Parameter Name="month" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For example, in <see cref="T:System.Globalization.GregorianCalendar" />, <see cref="M:System.Globalization.Calendar.GetDaysInMonth(System.Int32,System.Int32)" /> for February returns 28 in a common year or 29 in a leap year.</para>
@@ -660,6 +695,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of days in the specified month and year of the current era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of days in the specified month in the specified year in the current era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -684,7 +723,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For example, in <see cref="T:System.Globalization.GregorianCalendar" />, <see cref="M:System.Globalization.Calendar.GetDaysInMonth(System.Int32,System.Int32)" /> for February returns 28 in a common year or 29 in a leap year.</para>
@@ -693,6 +731,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the number of days in the specified month, year, and era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of days in the specified month in the specified year in the specified era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -717,7 +759,6 @@
         <Parameter Name="year" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For example, in <see cref="T:System.Globalization.GregorianCalendar" />, <see cref="M:System.Globalization.Calendar.GetDaysInYear(System.Int32)" /> returns 365 for a common year or 366 for a leap year.</para>
@@ -726,6 +767,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of days in the specified year of the current era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of days in the specified year in the current era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
       </Docs>
@@ -747,7 +792,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For example, in <see cref="T:System.Globalization.GregorianCalendar" />, <see cref="M:System.Globalization.Calendar.GetDaysInYear(System.Int32)" /> returns 365 for a common year or 366 for a leap year.</para>
@@ -756,6 +800,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the number of days in the specified year and era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of days in the specified year in the specified era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -778,12 +826,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the era in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that represents the era in <paramref name="time" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -804,12 +855,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hours value in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 0 to 23 that represents the hour in <paramref name="time" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -834,7 +888,6 @@
         <Parameter Name="year" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -844,6 +897,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the leap month for a specified year.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A positive integer that indicates the leap month in the specified year.</para>
+          <para>-or-</para>
+          <para>Zero if this calendar does not support a leap month or if the <paramref name="year" /> parameter does not represent a leap year.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />A year.</param>
       </Docs>
@@ -869,7 +928,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -879,6 +937,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the leap month for a specified year and era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A positive integer that indicates the leap month in the specified year and era.</para>
+          <para>-or-</para>
+          <para>Zero if this calendar does not support a leap month or if the <paramref name="year" /> and <paramref name="era" /> parameters do not specify a leap year.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />A year.</param>
         <param name="era">
@@ -901,12 +965,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'double'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the milliseconds value in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A double-precision floating-point number from 0 to 999 that represents the milliseconds in the <paramref name="time" /> parameter.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -927,12 +994,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the minutes value in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 0 to 59 that represents the minutes in <paramref name="time" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -953,7 +1023,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For example, in <see cref="T:System.Globalization.HebrewCalendar" />, <see cref="M:System.Globalization.Calendar.GetMonth(System.DateTime)" /> for Tishrei returns 1, and <see cref="M:System.Globalization.Calendar.GetMonth(System.DateTime)" /> for Elul returns 12 in a common year or 13 in a leap year.</para>
@@ -962,6 +1031,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the month in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A positive integer that represents the month in <paramref name="time" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -982,7 +1055,6 @@
         <Parameter Name="year" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For example, in <see cref="T:System.Globalization.HebrewCalendar" />, <see cref="M:System.Globalization.Calendar.GetMonthsInYear(System.Int32)" /> returns 12 for a common year or 13 for a leap year.</para>
@@ -991,6 +1063,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of months in the specified year in the current era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of months in the specified year in the current era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
       </Docs>
@@ -1012,7 +1088,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For example, in <see cref="T:System.Globalization.HebrewCalendar" />, <see cref="M:System.Globalization.Calendar.GetMonthsInYear(System.Int32)" /> returns 12 for a common year or 13 for a leap year.</para>
@@ -1021,6 +1096,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the number of months in the specified year in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of months in the specified year in the specified era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -1043,12 +1122,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the seconds value in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 0 to 59 that represents the seconds in <paramref name="time" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -1071,7 +1153,6 @@
         <Parameter Name="firstDayOfWeek" Type="System.DayOfWeek" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to determine the number of weeks in the year by setting <paramref name="time" /> to the last day of the year.</para>
@@ -1452,6 +1533,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the week of the year that includes the date in the specified <see cref="T:System.DateTime" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A positive integer that represents the week of the year that includes the date in the <paramref name="time" /> parameter.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />A date and time value. </param>
         <param name="rule">
@@ -1476,12 +1561,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the year in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that represents the year in <paramref name="time" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -1504,7 +1592,6 @@
         <Parameter Name="day" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To make up for the difference between the calendar year and the actual time that the earth rotates around the sun or the actual time that the moon rotates around the earth, a leap year has a different number of days from a standard calendar year. Each <see cref="T:System.Globalization.Calendar" /> implementation defines leap years differently.</para>
@@ -1514,6 +1601,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified date in the current era is a leap day.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified day is a leap day; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -1541,7 +1632,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To make up for the difference between the calendar year and the actual time that the earth rotates around the sun or the actual time that the moon rotates around the earth, a leap year has a different number of days from a standard calendar year. Each <see cref="T:System.Globalization.Calendar" /> implementation defines leap years differently.</para>
@@ -1551,6 +1641,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, determines whether the specified date in the specified era is a leap day.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified day is a leap day; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -1578,7 +1672,6 @@
         <Parameter Name="month" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To make up for the difference between the calendar year and the actual time that the earth rotates around the sun or the actual time that the moon rotates around the earth, a leap year has a different number of days from a standard calendar year. Each <see cref="T:System.Globalization.Calendar" /> implementation defines leap years differently.</para>
@@ -1588,6 +1681,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified month in the specified year in the current era is a leap month.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified month is a leap month; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -1612,7 +1709,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To make up for the difference between the calendar year and the actual time that the earth rotates around the sun or the actual time that the moon rotates around the earth, a leap year has a different number of days from a standard calendar year. Each <see cref="T:System.Globalization.Calendar" /> implementation defines leap years differently.</para>
@@ -1622,6 +1718,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, determines whether the specified month in the specified year in the specified era is a leap month.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified month is a leap month; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -1646,7 +1746,6 @@
         <Parameter Name="year" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To make up for the difference between the calendar year and the actual time that the earth rotates around the sun or the actual time that the moon rotates around the earth, a leap year has a different number of days from a standard calendar year. Each <see cref="T:System.Globalization.Calendar" /> implementation defines leap years differently.</para>
@@ -1655,6 +1754,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified year in the current era is a leap year.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified year is a leap year; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
       </Docs>
@@ -1676,7 +1779,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To make up for the difference between the calendar year and the actual time that the earth rotates around the sun or the actual time that the moon rotates around the earth, a leap year has a different number of days from a standard calendar year. Each <see cref="T:System.Globalization.Calendar" /> implementation defines leap years differently.</para>
@@ -1685,6 +1787,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, determines whether the specified year in the specified era is a leap year.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified year is a leap year; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -1789,13 +1895,18 @@
         <Parameter Name="calendar" Type="System.Globalization.Calendar" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a read-only version of the specified <see cref="T:System.Globalization.Calendar" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Globalization.Calendar" /> object specified by the <paramref name="calendar" /> parameter, if <paramref name="calendar" /> is read-only.</para>
+          <para>-or-</para>
+          <para>A read-only memberwise clone of the <see cref="T:System.Globalization.Calendar" /> object specified by <paramref name="calendar" />, if <paramref name="calendar" /> is not read-only.</para>
+        </returns>
         <param name="calendar">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Globalization.Calendar" /> object.</param>
       </Docs>
@@ -1822,12 +1933,15 @@
         <Parameter Name="millisecond" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DateTime'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is set to the specified date and time in the current era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that is set to the specified date and time in the current era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -1867,7 +1981,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DateTime'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Globalization.Calendar.ToDateTime(System.Int32,System.Int32,System.Int32,System.Int32,System.Int32,System.Int32,System.Int32,System.Int32)" /> method is useful because it can convert any date in the current calendar to a Gregorian calendar date. The Gregorian date can subsequently be used, for example, to compare dates in different calendars or create an equivalent date in a particular calendar.</para>
@@ -1876,6 +1989,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns a <see cref="T:System.DateTime" /> that is set to the specified date and time in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that is set to the specified date and time in the current era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -1910,7 +2027,6 @@
         <Parameter Name="year" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -1923,6 +2039,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified year to a four-digit year by using the <see cref="P:System.Globalization.Calendar.TwoDigitYearMax" /> property to determine the appropriate century.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that contains the four-digit representation of <paramref name="year" />.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />A two-digit or four-digit integer that represents the year to convert. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Globalization/CharUnicodeInfo.xml b/mcs/class/corlib/Documentation/en/System.Globalization/CharUnicodeInfo.xml
index 80e520ee386..97f725423fd 100644
--- a/mcs/class/corlib/Documentation/en/System.Globalization/CharUnicodeInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.Globalization/CharUnicodeInfo.xml
@@ -59,7 +59,6 @@
         <Parameter Name="ch" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -70,6 +69,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the decimal digit value of the specified numeric character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The decimal digit value of the specified numeric character.</para>
+          <para>-or- </para>
+          <para>-1, if the specified character is not a decimal digit.</para>
+        </returns>
         <param name="ch">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character for which to get the decimal digit value. </param>
       </Docs>
@@ -90,7 +95,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -101,6 +105,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the decimal digit value of the numeric character at the specified index of the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The decimal digit value of the numeric character at the specified index of the specified string.</para>
+          <para>-or- </para>
+          <para>-1, if the character at the specified index of the specified string is not a decimal digit.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the Unicode character for which to get the decimal digit value. </param>
         <param name="index">
@@ -122,7 +132,6 @@
         <Parameter Name="ch" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -133,6 +142,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the digit value of the specified numeric character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The digit value of the specified numeric character.</para>
+          <para>-or- </para>
+          <para>-1, if the specified character is not a digit.</para>
+        </returns>
         <param name="ch">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character for which to get the digit value. </param>
       </Docs>
@@ -153,7 +168,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -164,6 +178,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the digit value of the numeric character at the specified index of the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The digit value of the numeric character at the specified index of the specified string.</para>
+          <para>-or- </para>
+          <para>-1, if the character at the specified index of the specified string is not a digit.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the Unicode character for which to get the digit value. </param>
         <param name="index">
@@ -185,7 +205,6 @@
         <Parameter Name="ch" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -197,6 +216,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the numeric value associated with the specified character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The numeric value associated with the specified character.</para>
+          <para>-or- </para>
+          <para>-1, if the specified character is not a numeric character.</para>
+        </returns>
         <param name="ch">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character for which to get the numeric value. </param>
       </Docs>
@@ -217,7 +242,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -229,6 +253,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the numeric value associated with the character at the specified index of the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The numeric value associated with the character at the specified index of the specified string.</para>
+          <para>-or- </para>
+          <para>-1, if the character at the specified index of the specified string is not a numeric character.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the Unicode character for which to get the numeric value. </param>
         <param name="index">
@@ -250,7 +280,6 @@
         <Parameter Name="ch" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -263,6 +292,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the Unicode category of the specified character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Globalization.UnicodeCategory" /> value indicating the category of the specified character.</para>
+        </returns>
         <param name="ch">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character for which to get the Unicode category. </param>
       </Docs>
@@ -283,7 +316,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -296,6 +328,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the Unicode category of the character at the specified index of the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Globalization.UnicodeCategory" /> value indicating the category of the character at the specified index of the specified string.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the Unicode character for which to get the Unicode category. </param>
         <param name="index">
diff --git a/mcs/class/corlib/Documentation/en/System.Globalization/ChineseLunisolarCalendar.xml b/mcs/class/corlib/Documentation/en/System.Globalization/ChineseLunisolarCalendar.xml
index c0117c88647..0426159e340 100644
--- a/mcs/class/corlib/Documentation/en/System.Globalization/ChineseLunisolarCalendar.xml
+++ b/mcs/class/corlib/Documentation/en/System.Globalization/ChineseLunisolarCalendar.xml
@@ -143,13 +143,16 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the era that corresponds to the specified <see cref="T:System.DateTime" /> type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that represents the era in the <paramref name="time" /> parameter.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> type to read. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Globalization/CompareInfo.xml b/mcs/class/corlib/Documentation/en/System.Globalization/CompareInfo.xml
index fc28ad6f6cc..814be77bbe6 100644
--- a/mcs/class/corlib/Documentation/en/System.Globalization/CompareInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.Globalization/CompareInfo.xml
@@ -65,7 +65,6 @@
         <Parameter Name="string2" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>By default, the comparison is performed by using <see cref="F:System.Globalization.CompareOptions.None" />. If a security decision depends on a string comparison or a case change, you should use the <see cref="P:System.Globalization.CultureInfo.InvariantCulture" /> property to ensure that the behavior is consistent regardless of the culture settings of the operating system.</para>
@@ -77,6 +76,48 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two strings. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer indicating the lexical relationship between the two comparands.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>zero </para>
+              </term>
+              <description>
+                <para>The two strings are equal. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>less than zero </para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="string1" /> is less than <paramref name="string2" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>greater than zero </para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="string1" /> is greater than <paramref name="string2" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="string1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first string to compare. </param>
         <param name="string2">
@@ -101,7 +142,6 @@
         <Parameter Name="options" Type="System.Globalization.CompareOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If a security decision depends on a string comparison or a case change, you should use the <see cref="P:System.Globalization.CultureInfo.InvariantCulture" /> property to ensure that the behavior is consistent regardless of the culture settings of the operating system.</para>
@@ -113,6 +153,48 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two strings using the specified <see cref="T:System.Globalization.CompareOptions" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer indicating the lexical relationship between the two comparands.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>zero </para>
+              </term>
+              <description>
+                <para>The two strings are equal. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>less than zero </para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="string1" /> is less than <paramref name="string2" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>greater than zero </para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="string1" /> is greater than <paramref name="string2" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="string1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first string to compare. </param>
         <param name="string2">
@@ -140,7 +222,6 @@
         <Parameter Name="offset2" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If a security decision depends on a string comparison or a case change, you should use the <see cref="P:System.Globalization.CultureInfo.InvariantCulture" /> property to ensure that the behavior is consistent regardless of the culture settings of the operating system.</para>
@@ -152,6 +233,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the end section of a string with the end section of another string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer indicating the lexical relationship between the two comparands.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>zero </para>
+              </term>
+              <description>
+                <para>The two strings are equal. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>less than zero </para>
+              </term>
+              <description>
+                <para>The specified section of <paramref name="string1" /> is less than the specified section of <paramref name="string2" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>greater than zero </para>
+              </term>
+              <description>
+                <para>The specified section of <paramref name="string1" /> is greater than the specified section of <paramref name="string2" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="string1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first string to compare. </param>
         <param name="offset1">
@@ -182,7 +303,6 @@
         <Parameter Name="options" Type="System.Globalization.CompareOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If a security decision depends on a string comparison or a case change, you should use the <see cref="P:System.Globalization.CultureInfo.InvariantCulture" /> property to ensure that the behavior is consistent regardless of the culture settings of the operating system.</para>
@@ -194,6 +314,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the end section of a string with the end section of another string using the specified <see cref="T:System.Globalization.CompareOptions" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer indicating the lexical relationship between the two comparands.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>zero </para>
+              </term>
+              <description>
+                <para>The two strings are equal. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>less than zero </para>
+              </term>
+              <description>
+                <para>The specified section of <paramref name="string1" /> is less than the specified section of <paramref name="string2" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>greater than zero </para>
+              </term>
+              <description>
+                <para>The specified section of <paramref name="string1" /> is greater than the specified section of <paramref name="string2" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="string1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first string to compare. </param>
         <param name="offset1">
@@ -227,7 +387,6 @@
         <Parameter Name="length2" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If a security decision depends on a string comparison or a case change, you should use the <see cref="P:System.Globalization.CultureInfo.InvariantCulture" /> property to ensure that the behavior is consistent regardless of the culture settings of the operating system.</para>
@@ -239,6 +398,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares a section of one string with a section of another string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer indicating the lexical relationship between the two comparands.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>zero </para>
+              </term>
+              <description>
+                <para>The two strings are equal. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>less than zero </para>
+              </term>
+              <description>
+                <para>The specified section of <paramref name="string1" /> is less than the specified section of <paramref name="string2" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>greater than zero </para>
+              </term>
+              <description>
+                <para>The specified section of <paramref name="string1" /> is greater than the specified section of <paramref name="string2" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="string1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first string to compare. </param>
         <param name="offset1">
@@ -275,7 +474,6 @@
         <Parameter Name="options" Type="System.Globalization.CompareOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If a security decision depends on a string comparison or a case change, you should use the <see cref="P:System.Globalization.CultureInfo.InvariantCulture" /> property to ensure that the behavior is consistent regardless of the culture settings of the operating system.</para>
@@ -287,6 +485,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares a section of one string with a section of another string using the specified <see cref="T:System.Globalization.CompareOptions" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer indicating the lexical relationship between the two comparands.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>zero </para>
+              </term>
+              <description>
+                <para>The two strings are equal. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>less than zero </para>
+              </term>
+              <description>
+                <para>The specified section of <paramref name="string1" /> is less than the specified section of <paramref name="string2" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>greater than zero </para>
+              </term>
+              <description>
+                <para>The specified section of <paramref name="string1" /> is greater than the specified section of <paramref name="string2" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="string1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first string to compare. </param>
         <param name="offset1">
@@ -319,7 +557,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Two <see cref="T:System.Globalization.CompareInfo" /> objects are equal if their <see cref="P:System.Globalization.CompareInfo.LCID" /> and <see cref="P:System.Globalization.CompareInfo.Name" /> properties are equal.</para>
@@ -330,6 +567,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified object is equal to the current <see cref="T:System.Globalization.CompareInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified object is equal to the current <see cref="T:System.Globalization.CompareInfo" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current <see cref="T:System.Globalization.CompareInfo" />. </param>
       </Docs>
@@ -366,12 +607,15 @@
         <Parameter Name="culture" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'CompareInfo'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new <see cref="T:System.Globalization.CompareInfo" /> object that is associated with the culture with the specified identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Globalization.CompareInfo" /> object associated with the culture with the specified identifier and using string comparison methods in the current <see cref="T:System.Reflection.Assembly" />.</para>
+        </returns>
         <param name="culture">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer representing the culture identifier. </param>
       </Docs>
@@ -392,12 +636,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'CompareInfo'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new <see cref="T:System.Globalization.CompareInfo" /> object that is associated with the culture with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Globalization.CompareInfo" /> object associated with the culture with the specified identifier and using string comparison methods in the current <see cref="T:System.Reflection.Assembly" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />A string representing the culture name. </param>
       </Docs>
@@ -419,7 +666,6 @@
         <Parameter Name="assembly" Type="System.Reflection.Assembly" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'CompareInfo'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -432,6 +678,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new <see cref="T:System.Globalization.CompareInfo" /> object that is associated with the specified culture and that uses string comparison methods in the specified <see cref="T:System.Reflection.Assembly" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Globalization.CompareInfo" /> object associated with the culture with the specified identifier and using string comparison methods in the current <see cref="T:System.Reflection.Assembly" />.</para>
+        </returns>
         <param name="culture">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer representing the culture identifier. </param>
         <param name="assembly">
@@ -455,7 +705,6 @@
         <Parameter Name="assembly" Type="System.Reflection.Assembly" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'CompareInfo'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -467,6 +716,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new <see cref="T:System.Globalization.CompareInfo" /> object that is associated with the specified culture and that uses string comparison methods in the specified <see cref="T:System.Reflection.Assembly" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Globalization.CompareInfo" /> object associated with the culture with the specified identifier and using string comparison methods in the current <see cref="T:System.Reflection.Assembly" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />A string representing the culture name. </param>
         <param name="assembly">
@@ -487,7 +740,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method overrides <see cref="M:System.Object.GetHashCode" />.</para>
@@ -497,6 +749,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for the current <see cref="T:System.Globalization.CompareInfo" /> for hashing algorithms and data structures, such as a hash table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.Globalization.CompareInfo" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetSortKey">
@@ -515,7 +771,6 @@
         <Parameter Name="source" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SortKey'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Each character in a string is given several categories of sort weights, including script, alphabetic, case, and diacritic weights. A sort key is the repository of these weights for a particular string. For example, a sort key might contain a string of alphabetic weights, followed by a string of case weights, and so on. The <see cref="Overload:System.Globalization.CompareInfo.GetSortKey" /> method is equivalent to the Windows API method LCMapString with the LCMAP_SORTKEY flag.</para>
@@ -524,6 +779,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the sort key for the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Globalization.SortKey" /> object that contains the sort key for the specified string.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string for which a <see cref="T:System.Globalization.SortKey" /> object is obtained. </param>
       </Docs>
@@ -545,7 +804,6 @@
         <Parameter Name="options" Type="System.Globalization.CompareOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SortKey'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Each character in a string is given several categories of sort weights, including script, alphabetic, case, and diacritic weights. A sort key is the repository of these weights for a particular string. For example, a sort key might contain a string of alphabetic weights, followed by a string of case weights, and so on. The <see cref="Overload:System.Globalization.CompareInfo.GetSortKey" /> method is equivalent to the Windows API method LCMapString with the LCMAP_SORTKEY flag.</para>
@@ -554,6 +812,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Globalization.SortKey" /> object for the specified string using the specified <see cref="T:System.Globalization.CompareOptions" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Globalization.SortKey" /> object that contains the sort key for the specified string.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string for which a <see cref="T:System.Globalization.SortKey" /> object is obtained. </param>
         <param name="options">
@@ -577,7 +839,6 @@
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method searches the source string from the beginning of the string to the end of the string.</para>
@@ -590,6 +851,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified character and returns the zero-based index of the first occurrence within the entire source string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="value" />, if found, within <paramref name="source" />; otherwise, -1. Returns 0 (zero) if <paramref name="value" /> is an ignorable character.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search. </param>
         <param name="value">
@@ -613,7 +878,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The source string is searched forward starting at the beginning of the string and ending at the end of the string.</para>
@@ -626,6 +890,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified substring and returns the zero-based index of the first occurrence within the entire source string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="value" />, if found, within <paramref name="source" />; otherwise, -1. Returns 0 (zero) if <paramref name="value" /> is an ignorable character.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search. </param>
         <param name="value">
@@ -650,7 +918,6 @@
         <Parameter Name="options" Type="System.Globalization.CompareOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The source string is searched forward starting at the beginning of the string and ending at the end of the string.</para>
@@ -664,6 +931,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified character and returns the zero-based index of the first occurrence within the entire source string using the specified <see cref="T:System.Globalization.CompareOptions" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="value" />, if found, within <paramref name="source" />, using the specified comparison options; otherwise, -1. Returns 0 (zero) if <paramref name="value" /> is an ignorable character.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search. </param>
         <param name="value">
@@ -690,7 +961,6 @@
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The source string is searched forward starting at <paramref name="startIndex" /> and ending at the end of the string.</para>
@@ -703,6 +973,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified character and returns the zero-based index of the first occurrence within the section of the source string that extends from the specified index to the end of the string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="value" />, if found, within the section of <paramref name="source" /> that extends from <paramref name="startIndex" /> to the end of <paramref name="source" />; otherwise, -1. Returns <paramref name="startIndex" /> if <paramref name="value" /> is an ignorable character.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search. </param>
         <param name="value">
@@ -729,7 +1003,6 @@
         <Parameter Name="options" Type="System.Globalization.CompareOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The source string is searched forward starting at the beginning of the string and ending at the end of the string.</para>
@@ -743,6 +1016,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified substring and returns the zero-based index of the first occurrence within the entire source string using the specified <see cref="T:System.Globalization.CompareOptions" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="value" />, if found, within <paramref name="source" />, using the specified comparison options; otherwise, -1. Returns 0 (zero) if <paramref name="value" /> is an ignorable character.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search. </param>
         <param name="value">
@@ -769,7 +1046,6 @@
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The source string is searched forward starting at <paramref name="startIndex" /> and ending at the end of the string.</para>
@@ -782,6 +1058,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified substring and returns the zero-based index of the first occurrence within the section of the source string that extends from the specified index to the end of the string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="value" />, if found, within the section of <paramref name="source" /> that extends from <paramref name="startIndex" /> to the end of <paramref name="source" />; otherwise, -1. Returns <paramref name="startIndex" /> if <paramref name="value" /> is an ignorable character.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search. </param>
         <param name="value">
@@ -809,7 +1089,6 @@
         <Parameter Name="options" Type="System.Globalization.CompareOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The source string is searched forward starting at <paramref name="startIndex" /> and ending at the end of the string.</para>
@@ -823,6 +1102,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified character and returns the zero-based index of the first occurrence within the section of the source string that extends from the specified index to the end of the string using the specified <see cref="T:System.Globalization.CompareOptions" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="value" />, if found, within the section of <paramref name="source" /> that extends from <paramref name="startIndex" /> to the end of <paramref name="source" />, using the specified comparison options; otherwise, -1. Returns <paramref name="startIndex" /> if <paramref name="value" /> is an ignorable character.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search. </param>
         <param name="value">
@@ -852,7 +1135,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The source string is searched forward starting at <paramref name="startIndex" /> and ending at <paramref name="startIndex" /> + <paramref name="count" /> - 1.</para>
@@ -865,6 +1147,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified character and returns the zero-based index of the first occurrence within the section of the source string that starts at the specified index and contains the specified number of elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="value" />, if found, within the section of <paramref name="source" /> that starts at <paramref name="startIndex" /> and contains the number of elements specified by <paramref name="count" />; otherwise, -1. Returns <paramref name="startIndex" /> if <paramref name="value" /> is an ignorable character.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search. </param>
         <param name="value">
@@ -894,7 +1180,6 @@
         <Parameter Name="options" Type="System.Globalization.CompareOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The source string is searched forward starting at <paramref name="startIndex" /> and ending at the end of the string.</para>
@@ -908,6 +1193,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified substring and returns the zero-based index of the first occurrence within the section of the source string that extends from the specified index to the end of the string using the specified <see cref="T:System.Globalization.CompareOptions" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="value" />, if found, within the section of <paramref name="source" /> that extends from <paramref name="startIndex" /> to the end of <paramref name="source" />, using the specified comparison options; otherwise, -1. Returns <paramref name="startIndex" /> if <paramref name="value" /> is an ignorable character.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search. </param>
         <param name="value">
@@ -937,7 +1226,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The source string is searched forward starting at <paramref name="startIndex" /> and ending at <paramref name="startIndex" /> + <paramref name="count" /> - 1.</para>
@@ -950,6 +1238,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified substring and returns the zero-based index of the first occurrence within the section of the source string that starts at the specified index and contains the specified number of elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="value" />, if found, within the section of <paramref name="source" /> that starts at <paramref name="startIndex" /> and contains the number of elements specified by <paramref name="count" />; otherwise, -1. Returns <paramref name="startIndex" /> if <paramref name="value" /> is an ignorable character.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search. </param>
         <param name="value">
@@ -980,7 +1272,6 @@
         <Parameter Name="options" Type="System.Globalization.CompareOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The source string is searched forward starting at <paramref name="startIndex" /> and ending at <paramref name="startIndex" /> + <paramref name="count" /> - 1.</para>
@@ -994,6 +1285,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified character and returns the zero-based index of the first occurrence within the section of the source string that starts at the specified index and contains the specified number of elements using the specified <see cref="T:System.Globalization.CompareOptions" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="value" />, if found, within the section of <paramref name="source" /> that starts at <paramref name="startIndex" /> and contains the number of elements specified by <paramref name="count" />, using the specified comparison options; otherwise, -1. Returns <paramref name="startIndex" /> if <paramref name="value" /> is an ignorable character.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search. </param>
         <param name="value">
@@ -1026,7 +1321,6 @@
         <Parameter Name="options" Type="System.Globalization.CompareOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The source string is searched forward starting at <paramref name="startIndex" /> and ending at <paramref name="startIndex" /> + <paramref name="count" /> - 1.</para>
@@ -1040,6 +1334,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified substring and returns the zero-based index of the first occurrence within the section of the source string that starts at the specified index and contains the specified number of elements using the specified <see cref="T:System.Globalization.CompareOptions" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of <paramref name="value" />, if found, within the section of <paramref name="source" /> that starts at <paramref name="startIndex" /> and contains the number of elements specified by <paramref name="count" />, using the specified comparison options; otherwise, -1. Returns <paramref name="startIndex" /> if <paramref name="value" /> is an ignorable character.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search. </param>
         <param name="value">
@@ -1069,7 +1367,6 @@
         <Parameter Name="prefix" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Every string starts and ends with an empty substring (""); therefore, if <paramref name="prefix" /> is an empty string, this method returns true.</para>
@@ -1081,6 +1378,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified source string starts with the specified prefix.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the length of <paramref name="prefix" /> is less than or equal to the length of <paramref name="source" /> and <paramref name="source" /> starts with <paramref name="prefix" />; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search in. </param>
         <param name="prefix">
@@ -1105,7 +1406,6 @@
         <Parameter Name="options" Type="System.Globalization.CompareOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Every string starts and ends with an empty substring (""); therefore, if <paramref name="prefix" /> is an empty string, this method returns true.</para>
@@ -1118,6 +1418,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified source string starts with the specified prefix using the specified <see cref="T:System.Globalization.CompareOptions" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the length of <paramref name="prefix" /> is less than or equal to the length of <paramref name="source" /> and <paramref name="source" /> starts with <paramref name="prefix" />; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search in. </param>
         <param name="prefix">
@@ -1146,7 +1450,6 @@
         <Parameter Name="ch" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1156,6 +1459,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a specified Unicode character is sortable.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="ch" /> parameter is sortable; otherwise, false.</para>
+        </returns>
         <param name="ch">
           <attribution license="cc4" from="Microsoft" modified="false" />A Unicode character.</param>
       </Docs>
@@ -1180,7 +1487,6 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1190,6 +1496,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a specified Unicode string is sortable.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="str" /> parameter is not an empty string ("") and all the Unicode characters in <paramref name="str" /> are sortable; otherwise, false.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />A string of zero or more Unicode characters.</param>
       </Docs>
@@ -1211,7 +1521,6 @@
         <Parameter Name="suffix" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Every string starts and ends with an empty substring (""); therefore, if <paramref name="suffix" /> is an empty string, this method returns true.</para>
@@ -1223,6 +1532,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified source string ends with the specified suffix.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the length of <paramref name="suffix" /> is less than or equal to the length of <paramref name="source" /> and <paramref name="source" /> ends with <paramref name="suffix" />; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search in. </param>
         <param name="suffix">
@@ -1247,7 +1560,6 @@
         <Parameter Name="options" Type="System.Globalization.CompareOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Every string starts and ends with an empty substring (""); therefore, if <paramref name="suffix" /> is an empty string, this method returns true.</para>
@@ -1260,6 +1572,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified source string ends with the specified suffix using the specified <see cref="T:System.Globalization.CompareOptions" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the length of <paramref name="suffix" /> is less than or equal to the length of <paramref name="source" /> and <paramref name="source" /> ends with <paramref name="suffix" />; otherwise, false.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search in. </param>
         <param name="suffix">
@@ -1285,7 +1601,6 @@
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The source string is searched backward starting at the end of the string and ending at the beginning of the string.</para>
@@ -1298,6 +1613,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified character and returns the zero-based index of the last occurrence within the entire source string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the last occurrence of <paramref name="value" />, if found, within <paramref name="source" />; otherwise, -1.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search. </param>
         <param name="value">
@@ -1321,7 +1640,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The source string is searched backward starting at the end of the string and ending at the beginning of the string.</para>
@@ -1334,6 +1652,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified substring and returns the zero-based index of the last occurrence within the entire source string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the last occurrence of <paramref name="value" />, if found, within <paramref name="source" />; otherwise, -1.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search. </param>
         <param name="value">
@@ -1358,7 +1680,6 @@
         <Parameter Name="options" Type="System.Globalization.CompareOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The source string is searched backward starting at the end of the string and ending at the beginning of the string.</para>
@@ -1372,6 +1693,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified character and returns the zero-based index of the last occurrence within the entire source string using the specified <see cref="T:System.Globalization.CompareOptions" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the last occurrence of <paramref name="value" />, if found, within <paramref name="source" />, using the specified comparison options; otherwise, -1.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search. </param>
         <param name="value">
@@ -1398,7 +1723,6 @@
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The source string is searched backward starting at <paramref name="startIndex" /> and ending at the beginning of the string.</para>
@@ -1411,6 +1735,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified character and returns the zero-based index of the last occurrence within the section of the source string that extends from the beginning of the string to the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the last occurrence of <paramref name="value" />, if found, within the section of <paramref name="source" /> that extends from the beginning of <paramref name="source" /> to <paramref name="startIndex" />; otherwise, -1. Returns <paramref name="startIndex" /> if <paramref name="value" /> is an ignorable character.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search. </param>
         <param name="value">
@@ -1437,7 +1765,6 @@
         <Parameter Name="options" Type="System.Globalization.CompareOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The source string is searched backward starting at the end of the string and ending at the beginning of the string.</para>
@@ -1451,6 +1778,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified substring and returns the zero-based index of the last occurrence within the entire source string using the specified <see cref="T:System.Globalization.CompareOptions" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the last occurrence of <paramref name="value" />, if found, within <paramref name="source" />, using the specified comparison options; otherwise, -1.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search. </param>
         <param name="value">
@@ -1477,7 +1808,6 @@
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The source string is searched backward starting at <paramref name="startIndex" /> and ending at the beginning of the string.</para>
@@ -1490,6 +1820,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified substring and returns the zero-based index of the last occurrence within the section of the source string that extends from the beginning of the string to the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the last occurrence of <paramref name="value" />, if found, within the section of <paramref name="source" /> that extends from the beginning of <paramref name="source" /> to <paramref name="startIndex" />; otherwise, -1. Returns <paramref name="startIndex" /> if <paramref name="value" /> is an ignorable character.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search. </param>
         <param name="value">
@@ -1517,7 +1851,6 @@
         <Parameter Name="options" Type="System.Globalization.CompareOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The source string is searched backward starting at <paramref name="startIndex" /> and ending at the beginning of the string.</para>
@@ -1531,6 +1864,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified character and returns the zero-based index of the last occurrence within the section of the source string that extends from the beginning of the string to the specified index using the specified <see cref="T:System.Globalization.CompareOptions" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the last occurrence of <paramref name="value" />, if found, within the section of <paramref name="source" /> that extends from the beginning of <paramref name="source" /> to <paramref name="startIndex" />, using the specified comparison options; otherwise, -1. Returns <paramref name="startIndex" /> if <paramref name="value" /> is an ignorable character.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search. </param>
         <param name="value">
@@ -1560,7 +1897,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The source string is searched backward starting at <paramref name="startIndex" /> and ending at <paramref name="startIndex" /> - <paramref name="count" /> + 1.</para>
@@ -1573,6 +1909,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified character and returns the zero-based index of the last occurrence within the section of the source string that contains the specified number of elements and ends at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the last occurrence of <paramref name="value" />, if found, within the section of <paramref name="source" /> that contains the number of elements specified by <paramref name="count" /> and that ends at <paramref name="startIndex" />; otherwise, -1. Returns <paramref name="startIndex" /> if <paramref name="value" /> is an ignorable character.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search. </param>
         <param name="value">
@@ -1602,7 +1942,6 @@
         <Parameter Name="options" Type="System.Globalization.CompareOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The source string is searched backward starting at <paramref name="startIndex" /> and ending at the beginning of the string.</para>
@@ -1616,6 +1955,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified substring and returns the zero-based index of the last occurrence within the section of the source string that extends from the beginning of the string to the specified index using the specified <see cref="T:System.Globalization.CompareOptions" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the last occurrence of <paramref name="value" />, if found, within the section of <paramref name="source" /> that extends from the beginning of <paramref name="source" /> to <paramref name="startIndex" />, using the specified comparison options; otherwise, -1. Returns <paramref name="startIndex" /> if <paramref name="value" /> is an ignorable character.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search. </param>
         <param name="value">
@@ -1645,7 +1988,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The source string is searched backward starting at <paramref name="startIndex" /> and ending at <paramref name="startIndex" /> - <paramref name="count" /> + 1.</para>
@@ -1658,6 +2000,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified substring and returns the zero-based index of the last occurrence within the section of the source string that contains the specified number of elements and ends at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the last occurrence of <paramref name="value" />, if found, within the section of <paramref name="source" /> that contains the number of elements specified by <paramref name="count" /> and that ends at <paramref name="startIndex" />; otherwise, -1. Returns <paramref name="startIndex" /> if <paramref name="value" /> is an ignorable character.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search. </param>
         <param name="value">
@@ -1688,7 +2034,6 @@
         <Parameter Name="options" Type="System.Globalization.CompareOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The source string is searched backward starting at <paramref name="startIndex" /> and ending at <paramref name="startIndex" /> - <paramref name="count" /> + 1.</para>
@@ -1702,6 +2047,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified character and returns the zero-based index of the last occurrence within the section of the source string that contains the specified number of elements and ends at the specified index using the specified <see cref="T:System.Globalization.CompareOptions" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the last occurrence of <paramref name="value" />, if found, within the section of <paramref name="source" /> that contains the number of elements specified by <paramref name="count" /> and that ends at <paramref name="startIndex" />, using the specified comparison options; otherwise, -1. Returns <paramref name="startIndex" /> if <paramref name="value" /> is an ignorable character.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search. </param>
         <param name="value">
@@ -1734,7 +2083,6 @@
         <Parameter Name="options" Type="System.Globalization.CompareOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The source string is searched backward starting at <paramref name="startIndex" /> and ending at <paramref name="startIndex" /> - <paramref name="count" /> + 1.</para>
@@ -1748,6 +2096,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified substring and returns the zero-based index of the last occurrence within the section of the source string that contains the specified number of elements and ends at the specified index using the specified <see cref="T:System.Globalization.CompareOptions" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the last occurrence of <paramref name="value" />, if found, within the section of <paramref name="source" /> that contains the number of elements specified by <paramref name="count" /> and that ends at <paramref name="startIndex" />, using the specified comparison options; otherwise, -1. Returns <paramref name="startIndex" /> if <paramref name="value" /> is an ignorable character. </para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search. </param>
         <param name="value">
@@ -1851,7 +2203,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method overrides the <see cref="M:System.Object.ToString" /> method. It returns a string that consists of the class name and the value of the instance <see cref="P:System.Globalization.CompareInfo.Name" /> property, separated by a hyphen. </para>
@@ -1860,6 +2211,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Globalization.CompareInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Globalization.CompareInfo" /> object.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Globalization/CultureInfo.xml b/mcs/class/corlib/Documentation/en/System.Globalization/CultureInfo.xml
index 6361e7550ff..6f9ded40f75 100644
--- a/mcs/class/corlib/Documentation/en/System.Globalization/CultureInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.Globalization/CultureInfo.xml
@@ -425,7 +425,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The clone is writable even if the original <see cref="T:System.Globalization.CultureInfo" /> is read-only. Therefore, the properties of the clone can be modified.</para>
@@ -436,6 +435,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the current <see cref="T:System.Globalization.CultureInfo" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current <see cref="T:System.Globalization.CultureInfo" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CompareInfo">
@@ -479,7 +482,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a list of predefined culture names, see the <see cref="http://go.microsoft.com/fwlink/?LinkId=200048">National Language Support (NLS) API Reference</see> at the Go Global Developer Center.</para>
@@ -491,6 +493,15 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Globalization.CultureInfo" /> that represents the specific culture that is associated with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Globalization.CultureInfo" /> object that represents:</para>
+          <para>The invariant culture, if <paramref name="name" /> is an empty string ("").</para>
+          <para>-or- </para>
+          <para>The specific culture associated with <paramref name="name" />, if <paramref name="name" /> is a neutral culture.</para>
+          <para>-or- </para>
+          <para>The culture specified by <paramref name="name" />, if <paramref name="name" /> is already a specific culture.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />A predefined <see cref="T:System.Globalization.CultureInfo" /> name or the name of an existing <see cref="T:System.Globalization.CultureInfo" /> object. <paramref name="name" /> is not case-sensitive.</param>
       </Docs>
@@ -755,7 +766,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method overrides <see cref="M:System.Object.Equals(System.Object)" />.</para>
@@ -765,6 +775,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified object is the same culture as the current <see cref="T:System.Globalization.CultureInfo" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is the same culture as the current <see cref="T:System.Globalization.CultureInfo" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current <see cref="T:System.Globalization.CultureInfo" />. </param>
       </Docs>
@@ -787,7 +801,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Languages such as Arabic, Hebrew, Urdu, and Syriac are based on bidirectional text. Windows applications, which have a graphical user interface, support bidirectional languages. However, console applications, which employ the text user interface of the operating system console, do not provide bidirectional support. Therefore, if you localize a console application to Arabic or Hebrew, your application displays unreadable text on the console screen. </para>
@@ -1727,6 +1740,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an alternate user interface culture suitable for console applications when the default graphic user interface culture is unsuitable.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An alternate culture that is used to read and display text on the console.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetCultureInfo">
@@ -1744,7 +1761,6 @@
         <Parameter Name="culture" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1755,6 +1771,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a cached, read-only instance of a culture by using the specified culture identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A read-only <see cref="T:System.Globalization.CultureInfo" /> object.</para>
+        </returns>
         <param name="culture">
           <attribution license="cc4" from="Microsoft" modified="false" />A locale identifier (LCID).</param>
       </Docs>
@@ -1774,7 +1794,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1787,6 +1806,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a cached, read-only instance of a culture using the specified culture name. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A read-only <see cref="T:System.Globalization.CultureInfo" /> object.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a culture. <paramref name="name" /> is not case-sensitive.</param>
       </Docs>
@@ -1807,7 +1830,6 @@
         <Parameter Name="altName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1819,6 +1841,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a cached, read-only instance of a culture. Parameters specify a culture that is initialized with the <see cref="T:System.Globalization.TextInfo" /> and <see cref="T:System.Globalization.CompareInfo" /> objects specified by another culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A read-only <see cref="T:System.Globalization.CultureInfo" /> object.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a culture. <paramref name="name" /> is not case-sensitive.</param>
         <param name="altName">
@@ -1840,7 +1866,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1855,6 +1880,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deprecated. Retrieves a read-only <see cref="T:System.Globalization.CultureInfo" /> object having linguistic characteristics that are identified by the specified RFC 4646 language tag.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A read-only <see cref="T:System.Globalization.CultureInfo" /> object.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a language as specified by the RFC 4646 standard.</param>
       </Docs>
@@ -1875,7 +1904,6 @@
         <Parameter Name="types" Type="System.Globalization.CultureTypes" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Globalization.CultureInfo.GetCultures(System.Globalization.CultureTypes)" /> method is most commonly called with the <paramref name="types" /> parameter set to the following values:  </para>
@@ -1902,6 +1930,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the list of supported cultures filtered by the specified <see cref="T:System.Globalization.CultureTypes" /> parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains the cultures specified by the <paramref name="types" /> parameter. The array of cultures is unsorted.</para>
+        </returns>
         <param name="types">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of the enumeration values that filter the cultures to retrieve. </param>
       </Docs>
@@ -1922,7 +1954,6 @@
         <Parameter Name="formatType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -1933,6 +1964,14 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an object that defines how to format the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the <see cref="P:System.Globalization.CultureInfo.NumberFormat" /> property, which is a <see cref="T:System.Globalization.NumberFormatInfo" /> containing the default number format information for the current <see cref="T:System.Globalization.CultureInfo" />, if <paramref name="formatType" /> is the <see cref="T:System.Type" /> object for the <see cref="T:System.Globalization.NumberFormatInfo" /> class.</para>
+          <para>-or- </para>
+          <para>The value of the <see cref="P:System.Globalization.CultureInfo.DateTimeFormat" /> property, which is a <see cref="T:System.Globalization.DateTimeFormatInfo" /> containing the default date and time format information for the current <see cref="T:System.Globalization.CultureInfo" />, if <paramref name="formatType" /> is the <see cref="T:System.Type" /> object for the <see cref="T:System.Globalization.DateTimeFormatInfo" /> class.</para>
+          <para>-or- </para>
+          <para>null, if <paramref name="formatType" /> is any other object.</para>
+        </returns>
         <param name="formatType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> for which to get a formatting object. This method only supports the <see cref="T:System.Globalization.NumberFormatInfo" /> and <see cref="T:System.Globalization.DateTimeFormatInfo" /> types. </param>
       </Docs>
@@ -1951,7 +1990,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method overrides <see cref="M:System.Object.GetHashCode" />.</para>
@@ -1961,6 +1999,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for the current <see cref="T:System.Globalization.CultureInfo" />, suitable for hashing algorithms and data structures, such as a hash table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.Globalization.CultureInfo" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IetfLanguageTag">
@@ -2304,7 +2346,6 @@
         <Parameter Name="ci" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This wrapper prevents any modifications to <paramref name="ci" />, or the objects returned by the <paramref name="ci" />.<see cref="P:System.Globalization.CultureInfo.DateTimeFormat" /> and <paramref name="ci" />.<see cref="P:System.Globalization.CultureInfo.NumberFormat" /> properties.</para>
@@ -2313,6 +2354,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a read-only wrapper around the specified <see cref="T:System.Globalization.CultureInfo" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A read-only <see cref="T:System.Globalization.CultureInfo" /> wrapper around <paramref name="ci" />.</para>
+        </returns>
         <param name="ci">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Globalization.CultureInfo" /> to wrap. </param>
       </Docs>
@@ -2409,7 +2454,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method overrides <see cref="M:System.Object.ToString" />. It returns a normalized version of the culture name that is passed to the <see cref="M:System.Globalization.CultureInfo.#ctor(System.String)" /> or <see cref="M:System.Globalization.CultureInfo.#ctor(System.String,System.Boolean)" /> constructor or to the <see cref="M:System.Globalization.CultureInfo.CreateSpecificCulture(System.String)" /> or <see cref="M:System.Globalization.CultureInfo.GetCultureInfo(System.String)" /> method. It normalizes the result string by converting characters in languagecode2 to lowercase and converting characters in country/regioncode2 to uppercase if necessary. </para>
@@ -2419,6 +2463,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string containing the name of the current <see cref="T:System.Globalization.CultureInfo" /> in the format languagecode2-country/regioncode2.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the name of the current <see cref="T:System.Globalization.CultureInfo" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TwoLetterISOLanguageName">
diff --git a/mcs/class/corlib/Documentation/en/System.Globalization/DateTimeFormatInfo.xml b/mcs/class/corlib/Documentation/en/System.Globalization/DateTimeFormatInfo.xml
index 01ccb77aa48..6249b803704 100644
--- a/mcs/class/corlib/Documentation/en/System.Globalization/DateTimeFormatInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.Globalization/DateTimeFormatInfo.xml
@@ -967,10 +967,6 @@ cultures with 12-month calendars the 13th element of the array is an empty strin
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Globalization.DateTimeFormatInfo" /> instance with property
-   values equal to the property values of the original <see cref="T:System.Globalization.DateTimeFormatInfo" /> instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The clone is writable even if the original <see cref="T:System.Globalization.DateTimeFormatInfo" /> object is read-only. Therefore, the properties of the clone can be modified with user-defined patterns.</para>
@@ -980,6 +976,10 @@ cultures with 12-month calendars the 13th element of the array is an empty strin
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a shallow copy of the <see cref="T:System.Globalization.DateTimeFormatInfo" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Globalization.DateTimeFormatInfo" /> object copied from the original <see cref="T:System.Globalization.DateTimeFormatInfo" />.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1163,7 +1163,6 @@ cultures with 12-month calendars the 13th element of the array is an empty strin
         <Parameter Name="dayofweek" Type="System.DayOfWeek" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For the default invariant <see cref="T:System.Globalization.DateTimeFormatInfo" /> object, this method returns a string from the <see cref="T:System.Globalization.GregorianCalendar" />: </para>
@@ -1241,6 +1240,10 @@ cultures with 12-month calendars the 13th element of the array is an empty strin
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the culture-specific abbreviated name of the specified day of the week based on the culture associated with the current <see cref="T:System.Globalization.DateTimeFormatInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The culture-specific abbreviated name of the day of the week represented by <paramref name="dayofweek" />.</para>
+        </returns>
         <param name="dayofweek">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.DayOfWeek" /> value. </param>
       </Docs>
@@ -1261,7 +1264,6 @@ cultures with 12-month calendars the 13th element of the array is an empty strin
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The era name is the name a calendar uses to refer to a period of time reckoned from a fixed point or event. For example, "A.D." or "C.E." is the current era in the Gregorian calendar.</para>
@@ -1272,6 +1274,12 @@ cultures with 12-month calendars the 13th element of the array is an empty strin
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the string containing the abbreviated name of the specified era, if an abbreviation exists.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the abbreviated name of the specified era, if an abbreviation exists.</para>
+          <para>-or- </para>
+          <para>A string containing the full name of the era, if an abbreviation does not exist.</para>
+        </returns>
         <param name="era">
           <attribution license="cc4" from="Microsoft" modified="false" />The integer representing the era. </param>
       </Docs>
@@ -1293,11 +1301,6 @@ cultures with 12-month calendars the 13th element of the array is an empty strin
         <Parameter Name="month" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing the abbreviated name of the month represented by
-<paramref name="month" />. For cultures with 12-month calendars, the empty string is
-   returned as the name of the 13th month.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="month" /> is less than 1 or greater than 13.</exception>
         <remarks>
@@ -1427,6 +1430,10 @@ cultures with 12-month calendars the 13th element of the array is an empty strin
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the culture-specific abbreviated name of the specified month based on the culture associated with the current <see cref="T:System.Globalization.DateTimeFormatInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The culture-specific abbreviated name of the month represented by <paramref name="month" />.</para>
+        </returns>
         <param name="month">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer from 1 through 13 representing the name of the month to retrieve. </param>
       </Docs>
@@ -1446,7 +1453,6 @@ cultures with 12-month calendars the 13th element of the array is an empty strin
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns an array that contains all custom format strings that correspond to standard format strings. See <format type="text/html"><a href="bb79761a-ca08-44ee-b142-b06b3e2fc22b">Standard Date and Time Format Strings</a></format> for a list of the standard format strings.</para>
@@ -1481,6 +1487,10 @@ cultures with 12-month calendars the 13th element of the array is an empty strin
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the standard patterns in which date and time values can be formatted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains the standard patterns in which date and time values can be formatted.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetAllDateTimePatterns">
@@ -1499,7 +1509,6 @@ cultures with 12-month calendars the 13th element of the array is an empty strin
         <Parameter Name="format" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns an array containing the custom format strings that correspond to a particular standard format string. See <format type="text/html"><a href="bb79761a-ca08-44ee-b142-b06b3e2fc22b">Standard Date and Time Format Strings</a></format> for a list of the standard format strings.</para>
@@ -1534,6 +1543,10 @@ cultures with 12-month calendars the 13th element of the array is an empty strin
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the patterns in which date and time values can be formatted using the specified standard format string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array containing the standard patterns in which date and time values can be formatted using the specified format string.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A standard format string. </param>
       </Docs>
@@ -1554,7 +1567,6 @@ cultures with 12-month calendars the 13th element of the array is an empty strin
         <Parameter Name="dayofweek" Type="System.DayOfWeek" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For the default invariant <see cref="T:System.Globalization.DateTimeFormatInfo" /> object, this method returns a string from the <see cref="T:System.Globalization.GregorianCalendar" /> object.</para>
@@ -1632,6 +1644,10 @@ cultures with 12-month calendars the 13th element of the array is an empty strin
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the culture-specific full name of the specified day of the week based on the culture associated with the current <see cref="T:System.Globalization.DateTimeFormatInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The culture-specific full name of the day of the week represented by <paramref name="dayofweek" />.</para>
+        </returns>
         <param name="dayofweek">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.DayOfWeek" /> value. </param>
       </Docs>
@@ -1653,9 +1669,6 @@ cultures with 12-month calendars the 13th element of the array is an empty strin
         <Parameter Name="eraName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> representing the era. If <paramref name="eraName" /> is invalid, returns -1.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="eraName" /> is a null reference.</exception>
         <remarks>
@@ -1671,6 +1684,10 @@ cultures with 12-month calendars the 13th element of the array is an empty strin
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the integer representing the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The integer representing the era, if <paramref name="eraName" /> is valid; otherwise, -1.</para>
+        </returns>
         <param name="eraName">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the era. </param>
       </Docs>
@@ -1693,9 +1710,6 @@ cultures with 12-month calendars the 13th element of the array is an empty strin
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing the name of the era.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="era" /> does not represent a valid era in calendar for the current thread.</exception>
         <remarks>
@@ -1707,6 +1721,10 @@ cultures with 12-month calendars the 13th element of the array is an empty strin
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the string containing the name of the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the name of the era.</para>
+        </returns>
         <param name="era">
           <attribution license="cc4" from="Microsoft" modified="false" />The integer representing the era. </param>
       </Docs>
@@ -1729,9 +1747,6 @@ cultures with 12-month calendars the 13th element of the array is an empty strin
         <Parameter Name="formatType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance, if <paramref name="formatType" /> is of type <see cref="T:System.Globalization.DateTimeFormatInfo" />; otherwise, a null reference.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The Format(String, IFormatProvider) method supported by the base data types invoke this method when the current <see cref="T:System.Globalization.DateTimeFormatInfo" /> object is passed as the <see cref="T:System.IFormatProvider" /> parameter. This method implements <see cref="M:System.IFormatProvider.GetFormat(System.Type)" />.</para>
@@ -1740,6 +1755,10 @@ cultures with 12-month calendars the 13th element of the array is an empty strin
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object of the specified type that provides a date and time  formatting service.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current  object, if <paramref name="formatType" /> is the same as the type of the current <see cref="T:System.Globalization.DateTimeFormatInfo" />; otherwise, null.</para>
+        </returns>
         <param name="formatType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the required formatting service. </param>
       </Docs>
@@ -1761,7 +1780,6 @@ cultures with 12-month calendars the 13th element of the array is an empty strin
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses the <see cref="M:System.IFormatProvider.GetFormat(System.Type)" /> method of <paramref name="formatProvider" /> using an <see cref="T:System.Globalization.DateTimeFormatInfo" /> object as the <paramref name="Type" /> parameter. If <paramref name="formatProvider" /> is null or if <see cref="M:System.IFormatProvider.GetFormat(System.Type)" /> returns null, this method returns <see cref="P:System.Globalization.DateTimeFormatInfo.CurrentInfo" />.</para>
@@ -1781,6 +1799,10 @@ cultures with 12-month calendars the 13th element of the array is an empty strin
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Globalization.DateTimeFormatInfo" /> object associated with the specified <see cref="T:System.IFormatProvider" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Globalization.DateTimeFormatInfo" /> object associated with <see cref="T:System.IFormatProvider" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IFormatProvider" /> that gets the <see cref="T:System.Globalization.DateTimeFormatInfo" /> object.</param>
       </Docs>
@@ -1802,11 +1824,6 @@ cultures with 12-month calendars the 13th element of the array is an empty strin
         <Parameter Name="month" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing the full name of the month represented by
-<paramref name="month" />. For cultures with 12-month calendars the empty string is
-   returned as the name of the 13th month.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="month" /> is less than 1 or greater than 13.</exception>
         <remarks>
@@ -1936,6 +1953,10 @@ cultures with 12-month calendars the 13th element of the array is an empty strin
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the culture-specific full name of the specified month based on the culture associated with the current <see cref="T:System.Globalization.DateTimeFormatInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The culture-specific full name of the month represented by <paramref name="month" />.</para>
+        </returns>
         <param name="month">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer from 1 through 13 representing the name of the month to retrieve. </param>
       </Docs>
@@ -1961,13 +1982,16 @@ cultures with 12-month calendars the 13th element of the array is an empty strin
         <Parameter Name="dayOfWeek" Type="System.DayOfWeek" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains the shortest abbreviated day name for a specified day of the week associated with the current <see cref="T:System.Globalization.DateTimeFormatInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The abbreviated name of the week that corresponds to the <paramref name="dayOfWeek" /> parameter.</para>
+        </returns>
         <param name="dayOfWeek">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.DayOfWeek" /> values.</param>
       </Docs>
@@ -2274,9 +2298,6 @@ cultures with 12-month calendars the 13th element of the array is an empty strin
         <Parameter Name="dtfi" Type="System.Globalization.DateTimeFormatInfo" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A read-only instance of <see cref="T:System.Globalization.DateTimeFormatInfo" /> that is a copy of <paramref name="dtfi" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="dtfi" /> is a null reference.</exception>
         <remarks>
@@ -2287,6 +2308,10 @@ cultures with 12-month calendars the 13th element of the array is an empty strin
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a read-only <see cref="T:System.Globalization.DateTimeFormatInfo" /> wrapper.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A read-only <see cref="T:System.Globalization.DateTimeFormatInfo" /> wrapper.</para>
+        </returns>
         <param name="dtfi">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Globalization.DateTimeFormatInfo" /> object to wrap. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Globalization/EastAsianLunisolarCalendar.xml b/mcs/class/corlib/Documentation/en/System.Globalization/EastAsianLunisolarCalendar.xml
index ff2de93320d..c5c9bafa560 100644
--- a/mcs/class/corlib/Documentation/en/System.Globalization/EastAsianLunisolarCalendar.xml
+++ b/mcs/class/corlib/Documentation/en/System.Globalization/EastAsianLunisolarCalendar.xml
@@ -52,7 +52,6 @@
         <Parameter Name="months" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -66,6 +65,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the date that is the specified number of months away from the specified date.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.DateTime" /> that results from adding the specified number of months to the <paramref name="time" /> parameter.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to which to add <paramref name="months" />. </param>
         <param name="months">
@@ -88,7 +91,6 @@
         <Parameter Name="years" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -102,6 +104,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the date that is the specified number of years away from the specified date.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.DateTime" /> that results from adding the specified number of years to the <paramref name="time" /> parameter.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to which to add <paramref name="years" />. </param>
         <param name="years">
@@ -144,13 +150,16 @@
         <Parameter Name="sexagenaryYear" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the celestial stem of the specified year in the sexagenary (60-year) cycle.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A number from 1 through 10.</para>
+        </returns>
         <param name="sexagenaryYear">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer from 1 through 60 that represents a year in the sexagenary cycle. </param>
       </Docs>
@@ -170,13 +179,16 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the day of the month in the specified date.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 through 31 that represents the day of the month specified in the <paramref name="time" /> parameter.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -196,13 +208,16 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the day of the week in the specified date.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.DayOfWeek" /> values that represents the day of the week specified in the <paramref name="time" /> parameter.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -222,7 +237,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -232,6 +246,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the day of the year in the specified date.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 through 354 in a common year, or 1 through 384 in a leap year, that represents the day of the year specified in the <paramref name="time" /> parameter.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -253,7 +271,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -263,6 +280,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of days in the specified month of the specified year and era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of days in the specified month of the specified year and era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -287,7 +308,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -297,6 +317,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of days in the specified year and era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of days in the specified year and era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -319,7 +343,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -329,6 +352,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the leap month for the specified year and era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A positive integer from 1 through 13 that indicates the leap month in the specified year and era.</para>
+          <para> -or-</para>
+          <para>Zero if this calendar does not support a leap month, or if the <paramref name="year" /> and <paramref name="era" /> parameters do not specify a leap year.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year.</param>
         <param name="era">
@@ -350,13 +379,16 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the month in the specified date.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 to 13 that represents the month specified in the <paramref name="time" /> parameter.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -377,13 +409,16 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of months in the specified year and era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of months in the specified year in the specified era. The return value is 12 months in a common year or 13 months in a leap year.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -405,13 +440,16 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the year in the sexagenary (60-year) cycle that corresponds to the specified date.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A number from 1 through 60 in the sexagenary cycle that corresponds to the <paramref name="date" /> parameter.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.DateTime" /> to read.</param>
       </Docs>
@@ -431,13 +469,16 @@
         <Parameter Name="sexagenaryYear" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the terrestrial branch of the specified year in the sexagenary (60-year) cycle.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 through 12.</para>
+        </returns>
         <param name="sexagenaryYear">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer from 1 through 60 that represents a year in the sexagenary cycle.</param>
       </Docs>
@@ -457,13 +498,16 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the year in the specified date.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that represents the year in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -486,13 +530,16 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified date in the specified era is a leap day.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified day is a leap day; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -520,13 +567,16 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified month in the specified year and era is a leap month.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="month" /> parameter is a leap month; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -551,13 +601,16 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified year in the specified era is a leap year.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified year is a leap year; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -586,7 +639,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -596,6 +648,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is set to the specified date, time, and era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DateTime" /> that is set to the specified date, time, and era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -629,7 +685,6 @@
         <Parameter Name="year" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -641,6 +696,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified year to a four-digit year.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that contains the four-digit representation of the <paramref name="year" /> parameter.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />A two-digit or four-digit integer that represents the year to convert. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Globalization/GregorianCalendar.xml b/mcs/class/corlib/Documentation/en/System.Globalization/GregorianCalendar.xml
index ece83d35e47..3f75470c042 100644
--- a/mcs/class/corlib/Documentation/en/System.Globalization/GregorianCalendar.xml
+++ b/mcs/class/corlib/Documentation/en/System.Globalization/GregorianCalendar.xml
@@ -106,7 +106,6 @@
         <Parameter Name="months" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The day part of the resulting <see cref="T:System.DateTime" /> is affected if the resulting day is not a valid day in the resulting month of the resulting year. It is changed to the last valid day in the resulting month of the resulting year. The year part of the resulting <see cref="T:System.DateTime" /> is affected if the resulting month is outside the year of the specified <see cref="T:System.DateTime" />. This implementation supports only the current era. Therefore, <see cref="T:System.ArgumentException" /> is thrown if the resulting year is outside the era of the specified <see cref="T:System.DateTime" />. The time-of-day part of the resulting <see cref="T:System.DateTime" /> remains the same as the specified <see cref="T:System.DateTime" />.</para>
@@ -119,6 +118,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is the specified number of months away from the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that results from adding the specified number of months to the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to which to add months. </param>
         <param name="months">
@@ -142,7 +145,6 @@
         <Parameter Name="years" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The day part of the resulting <see cref="T:System.DateTime" /> is affected if the resulting day is not a valid day in the resulting month of the resulting year. It is changed to the last valid day in the resulting month of the resulting year. The month part of the resulting <see cref="T:System.DateTime" /> remains the same as the specified <see cref="T:System.DateTime" />. This implementation supports only the current era. Therefore, <see cref="T:System.ArgumentException" /> is thrown if the resulting year is outside the era of the specified <see cref="T:System.DateTime" />. The time-of-day part of the resulting <see cref="T:System.DateTime" /> remains the same as the specified <see cref="T:System.DateTime" />.</para>
@@ -155,6 +157,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is the specified number of years away from the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that results from adding the specified number of years to the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to which to add years. </param>
         <param name="years">
@@ -275,12 +281,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the day of the month in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 to 31 that represents the day of the month in <paramref name="time" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -301,7 +310,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.DayOfWeek" /> values are Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, and Saturday.</para>
@@ -310,6 +318,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the day of the week in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DayOfWeek" /> value that represents the day of the week in <paramref name="time" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -330,7 +342,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The day of the year is defined as the number of days from the first day of the year. For example, <see cref="M:System.Globalization.GregorianCalendar.GetDayOfYear(System.DateTime)" /> for the first day of the first month returns 1, and <see cref="M:System.Globalization.GregorianCalendar.GetDayOfYear(System.DateTime)" /> for the last day of the last month returns the total number of days in that year, which is the same value returned by <see cref="M:System.Globalization.GregorianCalendar.GetDaysInYear(System.Int32,System.Int32)" />.</para>
@@ -339,6 +350,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the day of the year in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 to 366 that represents the day of the year in <paramref name="time" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -361,7 +376,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For example, this method returns 28 or 29 for February (<paramref name="month" /> = 2), depending on whether <paramref name="year" /> is a leap year.</para>
@@ -370,6 +384,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of days in the specified month in the specified year in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of days in the specified month in the specified year in the specified era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -395,7 +413,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For example, this method returns 365 or 366, depending on whether <paramref name="year" /> is a leap year.</para>
@@ -404,6 +421,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of days in the specified year in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of days in the specified year in the specified era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -426,7 +447,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The Gregorian calendar recognizes two eras: B.C. or B.C.E., and A.D. or C.E. This implementation of the <see cref="T:System.Globalization.GregorianCalendar" /> class recognizes only the current era (A.D. or C.E.).</para>
@@ -435,6 +455,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the era in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that represents the era in <paramref name="time" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -460,12 +484,15 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the leap month for a specified year and era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always 0 because the Gregorian calendar does not recognize leap months.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />A year.</param>
         <param name="era">
@@ -488,12 +515,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the month in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 to 12 that represents the month in <paramref name="time" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -515,12 +545,15 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of months in the specified year in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of months in the specified year in the specified era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -547,7 +580,6 @@
         <Parameter Name="firstDayOfWeek" Type="System.DayOfWeek" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to determine the number of weeks in the year by setting the <paramref name="time" /> parameter to the last day of the year.</para>
@@ -560,6 +592,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the week of the year that includes the date in the specified <see cref="T:System.DateTime" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 1-based integer that represents the week of the year that includes the date in the <paramref name="time" /> parameter.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> object to read. </param>
         <param name="rule">
@@ -584,12 +620,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the year in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that represents the year in <paramref name="time" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -613,7 +652,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A leap year in the Gregorian calendar is defined as a year that is evenly divisible by four, except if it is divisible by 100. However, years that are divisible by 400 are leap years. For example, the year 1900 was not a leap year, but the year 2000 was. A common year has 365 days and a leap year has 366 days.</para>
@@ -623,6 +661,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified date in the specified era is a leap day.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified day is a leap day; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -651,7 +693,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A leap year in the Gregorian calendar is defined as a year that is evenly divisible by four, except if it is divisible by 100. However, years that are divisible by 400 are leap years. For example, the year 1900 was not a leap year, but the year 2000 was. A common year has 365 days and a leap year has 366 days.</para>
@@ -661,6 +702,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified month in the specified year in the specified era is a leap month.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method always returns false, unless overridden by a derived class.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -686,7 +731,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A leap year in the Gregorian calendar is defined as a year that is evenly divisible by four, except if it is divisible by 100. However, years that are divisible by 400 are leap years. For example, the year 1900 was not a leap year, but the year 2000 was. A common year has 365 days and a leap year has 366 days.</para>
@@ -695,6 +739,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified year in the specified era is a leap year.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified year is a leap year; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -779,12 +827,15 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is set to the specified date and time in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that is set to the specified date and time in the current era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -819,7 +870,6 @@
         <Parameter Name="year" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -831,6 +881,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified year to a four-digit year by using the <see cref="P:System.Globalization.GregorianCalendar.TwoDigitYearMax" /> property to determine the appropriate century.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that contains the four-digit representation of <paramref name="year" />.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />A two-digit or four-digit integer that represents the year to convert. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Globalization/HebrewCalendar.xml b/mcs/class/corlib/Documentation/en/System.Globalization/HebrewCalendar.xml
index 57152ff590c..1b7a7b4cbb6 100644
--- a/mcs/class/corlib/Documentation/en/System.Globalization/HebrewCalendar.xml
+++ b/mcs/class/corlib/Documentation/en/System.Globalization/HebrewCalendar.xml
@@ -328,7 +328,6 @@
         <Parameter Name="months" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation of the <see cref="T:System.Globalization.HebrewCalendar" /> class recognizes only the Hebrew years 5343 to 5999 (1583 to 2239 in the Gregorian calendar).</para>
@@ -342,6 +341,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is the specified number of months away from the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that results from adding the specified number of months to the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to which to add <paramref name="months" />. </param>
         <param name="months">
@@ -365,7 +368,6 @@
         <Parameter Name="years" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation of the <see cref="T:System.Globalization.HebrewCalendar" /> class recognizes only the Hebrew years 5343 to 5999 (1583 to 2239 in the Gregorian calendar).</para>
@@ -381,6 +383,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is the specified number of years away from the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that results from adding the specified number of years to the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to which to add <paramref name="years" />. </param>
         <param name="years">
@@ -448,12 +454,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the day of the month in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 to 30 that represents the day of the month in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -474,7 +483,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.DayOfWeek" /> values are as follows: </para>
@@ -551,6 +559,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the day of the week in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DayOfWeek" /> value that represents the day of the week in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -571,7 +583,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The day of the year is defined as the number of days from the first day of the year. For example, <see cref="M:System.Globalization.HebrewCalendar.GetDayOfYear(System.DateTime)" /> for the first day of the first month returns 1, and <see cref="M:System.Globalization.HebrewCalendar.GetDayOfYear(System.DateTime)" /> for the last day of the last month returns the total number of days in that year, which is the same value returned by <see cref="M:System.Globalization.HebrewCalendar.GetDaysInYear(System.Int32,System.Int32)" />.</para>
@@ -581,6 +592,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the day of the year in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 to 385 that represents the day of the year in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -603,7 +618,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For example, this method returns 29 or 30 for Cheshvan, depending on the placement of Jewish holidays.</para>
@@ -613,6 +627,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of days in the specified month in the specified year in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of days in the specified month in the specified year in the specified era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -638,7 +656,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For example, this method returns an integer from 353 to 355 or from 383 to 385, depending on the placement of Jewish holidays and depending on whether <paramref name="year" /> is a leap year.</para>
@@ -648,6 +665,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of days in the specified year in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of days in the specified year in the specified era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -670,7 +691,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The Hebrew calendar recognizes two eras: B.C.E. (before the common era) and A.M. (Latin "Anno Mundi", which means "the year of the world"). This implementation of the <see cref="T:System.Globalization.HebrewCalendar" /> class recognizes only the current era (A.M.) and only the Hebrew years 5343 to 5999 (1583 to 2239 in the Gregorian calendar).</para>
@@ -679,6 +699,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the era in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that represents the era in the specified <see cref="T:System.DateTime" />. The return value is always <see cref="F:System.Globalization.HebrewCalendar.HebrewEra" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -699,7 +723,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In a calendar that supports the notion of a leap month, the leap month can occur either after a particular month or after any month in a year. For example, the <see cref="M:System.Globalization.EastAsianLunisolarCalendar.GetMonth(System.DateTime)" /> method returns a number between 1 and 13 that indicates the month associated with a specified date. If there is a leap month between the eighth and ninth months of the year, the <see cref="M:System.Globalization.EastAsianLunisolarCalendar.GetMonth(System.DateTime)" /> method returns 8 for the eighth month, 9 for the leap eighth month, and 10 for the ninth month.</para>
@@ -708,6 +731,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the leap month for a specified year and era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A positive integer that indicates the leap month in the specified year and era. The return value is 7 if the <paramref name="year" /> and <paramref name="era" /> parameters specify a leap year, or 0 if the year is not a leap year.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />A year.</param>
         <param name="era">
@@ -730,12 +757,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the month in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 to 13 that represents the month in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -757,7 +787,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation of the <see cref="T:System.Globalization.HebrewCalendar" /> class recognizes only the Hebrew years 5343 to 5999 (1583 to 2239 in the Gregorian calendar).</para>
@@ -766,6 +795,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of months in the specified year in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of months in the specified year in the specified era. The return value is either 12 in a common year, or 13 in a leap year.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -788,7 +821,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation of the <see cref="T:System.Globalization.HebrewCalendar" /> class recognizes only the Hebrew years 5343 to 5999 (1583 to 2239 in the Gregorian calendar).</para>
@@ -797,6 +829,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the year in the specified <see cref="T:System.DateTime" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that represents the year in the specified <see cref="T:System.DateTime" /> value.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -846,7 +882,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation of the <see cref="T:System.Globalization.HebrewCalendar" /> class recognizes only the Hebrew years 5343 to 5999 (1583 to 2239 in the Gregorian calendar).</para>
@@ -857,6 +892,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified date in the specified era is a leap day.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified day is a leap day; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -885,7 +924,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation of the <see cref="T:System.Globalization.HebrewCalendar" /> class recognizes only the Hebrew years 5343 to 5999 (1583 to 2239 in the Gregorian calendar).</para>
@@ -896,6 +934,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified month in the specified year in the specified era is a leap month.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified month is a leap month; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -921,7 +963,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation of the <see cref="T:System.Globalization.HebrewCalendar" /> class recognizes only the Hebrew years 5343 to 5999 (1583 to 2239 in the Gregorian calendar).</para>
@@ -931,6 +972,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified year in the specified era is a leap year.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified year is a leap year; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -1005,7 +1050,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Globalization.HebrewCalendar.ToDateTime(System.Int32,System.Int32,System.Int32,System.Int32,System.Int32,System.Int32,System.Int32,System.Int32)" /> method is useful because it can convert any date in the current calendar to a Gregorian calendar date. The Gregorian date can subsequently be used, for example, to compare dates in different calendars or create an equivalent date in a particular calendar.</para>
@@ -1015,6 +1059,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is set to the specified date and time in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that is set to the specified date and time in the current era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -1049,7 +1097,6 @@
         <Parameter Name="year" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Globalization.HebrewCalendar.ToFourDigitYear(System.Int32)" /> method uses the <paramref name="year" /> parameter, the <see cref="P:System.Globalization.HebrewCalendar.TwoDigitYearMax" /> property, and a year to calculate a 4-digit year. The century is determined by finding the sole occurrence of the <paramref name="year" /> parameter within that 100-year range. For example, if <see cref="P:System.Globalization.HebrewCalendar.TwoDigitYearMax" /> is set to 5729, the 100-year range is from 5630 to 5729. Therefore, a value of 30 is interpreted as 5630, while a value of 29 is interpreted as 5729.</para>
@@ -1061,6 +1108,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified year to a 4-digit year by using the <see cref="P:System.Globalization.HebrewCalendar.TwoDigitYearMax" /> property to determine the appropriate century.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If the <paramref name="year" /> parameter is a 2-digit year, the return value is the corresponding 4-digit year. If the <paramref name="year" /> parameter is a 4-digit year, the return value is the unchanged <paramref name="year" /> parameter.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />A 2-digit year from 0 through 99, or a 4-digit Hebrew calendar year from 5343 through 5999.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Globalization/HijriCalendar.xml b/mcs/class/corlib/Documentation/en/System.Globalization/HijriCalendar.xml
index 19b383bf13f..0beb6e90d88 100644
--- a/mcs/class/corlib/Documentation/en/System.Globalization/HijriCalendar.xml
+++ b/mcs/class/corlib/Documentation/en/System.Globalization/HijriCalendar.xml
@@ -261,7 +261,6 @@
         <Parameter Name="months" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The day part of the resulting <see cref="T:System.DateTime" /> is affected if the resulting day is not a valid day in the resulting month of the resulting year. It is changed to the last valid day in the resulting month of the resulting year. The year part of the resulting <see cref="T:System.DateTime" /> is affected if the resulting month is outside the year of the specified <see cref="T:System.DateTime" />. This implementation supports only the current era. Therefore, <see cref="T:System.ArgumentException" /> is thrown if the resulting year is outside the era of the specified <see cref="T:System.DateTime" />. The time-of-day part of the resulting <see cref="T:System.DateTime" /> remains the same as the specified <see cref="T:System.DateTime" />.</para>
@@ -274,6 +273,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is the specified number of months away from the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that results from adding the specified number of months to the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to add months to. </param>
         <param name="months">
@@ -297,7 +300,6 @@
         <Parameter Name="years" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The day part of the resulting <see cref="T:System.DateTime" /> is affected if the resulting day is not a valid day in the resulting month of the resulting year. It is changed to the last valid day in the resulting month of the resulting year. The month part of the resulting <see cref="T:System.DateTime" /> remains the same as the specified <see cref="T:System.DateTime" />. This implementation supports only the current era. Therefore, <see cref="T:System.ArgumentException" /> is thrown if the resulting year is outside the era of the specified <see cref="T:System.DateTime" />. The time-of-day part of the resulting <see cref="T:System.DateTime" /> remains the same as the specified <see cref="T:System.DateTime" />.</para>
@@ -310,6 +312,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is the specified number of years away from the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that results from adding the specified number of years to the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to add years to. </param>
         <param name="years">
@@ -404,12 +410,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the day of the month in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 to 30 that represents the day of the month in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -430,7 +439,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.DayOfWeek" /> values are as follows: </para>
@@ -507,6 +515,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the day of the week in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DayOfWeek" /> value that represents the day of the week in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -527,7 +539,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The day of the year is defined as the number of days from the first day of the year. For example, <see cref="M:System.Globalization.HijriCalendar.GetDayOfYear(System.DateTime)" /> for the first day of the first month returns 1, and <see cref="M:System.Globalization.HijriCalendar.GetDayOfYear(System.DateTime)" /> for the last day of the last month returns the total number of days in that year, which is the same value returned by <see cref="M:System.Globalization.HijriCalendar.GetDaysInYear(System.Int32,System.Int32)" />.</para>
@@ -536,6 +547,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the day of the year in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 to 355 that represents the day of the year in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -558,7 +573,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For example, this method returns 29 or 30 for Zulhijjah (<paramref name="month" /> = 12), depending on whether <paramref name="year" /> is a leap year.</para>
@@ -567,6 +581,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of days in the specified month of the specified year and era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of days in the specified month in the specified year in the specified era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -592,12 +610,15 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of days in the specified year and era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of days in the specified year and era. The number of days is 354 in a common year or 355 in a leap year.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -620,7 +641,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The Hijri calendar recognizes one era: A.H. (Latin "Anno Hegirae", which means "the year of the migration," in reference to the migration of Muhammad (PBUH) from Mecca).</para>
@@ -629,6 +649,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the era in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that represents the era in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -654,7 +678,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In a calendar that supports the notion of a leap month, the leap month can occur either after a particular month or after any month in a year. For example, the <see cref="M:System.Globalization.EastAsianLunisolarCalendar.GetMonth(System.DateTime)" /> method returns a number between 1 and 13 that indicates the month associated with a specified date. If there is a leap month between the eighth and ninth months of the year, the <see cref="M:System.Globalization.EastAsianLunisolarCalendar.GetMonth(System.DateTime)" /> method returns 8 for the eighth month, 9 for the leap eighth month, and 10 for the ninth month.</para>
@@ -663,6 +686,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the leap month for a specified year and era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always 0 because the <see cref="T:System.Globalization.HijriCalendar" /> type does not support the notion of a leap month.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />A year.</param>
         <param name="era">
@@ -685,12 +712,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the month in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 to 12 that represents the month in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -712,12 +742,15 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of months in the specified year and era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of months in the specified year and era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -740,12 +773,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the year in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that represents the year in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -818,7 +854,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In every 30-year cycle that ends with a year that is evenly divisible by 30, the 2nd, 5th, 7th, 10th, 13th, 16th, 18th, 21st, 24th, 26th, and 29th years are leap years. A common year has 354 days and a leap year has 355 days.</para>
@@ -828,6 +863,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified date is a leap day.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified day is a leap day; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -856,7 +895,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In every 30-year cycle that ends with a year that is evenly divisible by 30, the 2nd, 5th, 7th, 10th, 13th, 16th, 18th, 21st, 24th, 26th, and 29th years are leap years. A common year has 354 days and a leap year has 355 days.</para>
@@ -866,6 +904,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified month in the specified year and era is a leap month.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method always returns false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -891,7 +933,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In every 30-year cycle that ends with a year that is evenly divisible by 30, the 2nd, 5th, 7th, 10th, 13th, 16th, 18th, 21st, 24th, 26th, and 29th years are leap years. A common year has 354 days and a leap year has 355 days.</para>
@@ -900,6 +941,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified year in the specified era is a leap year.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified year is a leap year; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -987,12 +1032,15 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is set to the specified date, time, and era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that is set to the specified date and time in the current era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -1027,7 +1075,6 @@
         <Parameter Name="year" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -1039,6 +1086,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified year to a four-digit year by using the <see cref="P:System.Globalization.HijriCalendar.TwoDigitYearMax" /> property to determine the appropriate century.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that contains the four-digit representation of <paramref name="year" />.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />A two-digit or four-digit integer that represents the year to convert. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Globalization/IdnMapping.xml b/mcs/class/corlib/Documentation/en/System.Globalization/IdnMapping.xml
index 76b9d5cb16a..3b09528b9ef 100644
--- a/mcs/class/corlib/Documentation/en/System.Globalization/IdnMapping.xml
+++ b/mcs/class/corlib/Documentation/en/System.Globalization/IdnMapping.xml
@@ -104,13 +104,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a specified object and the current <see cref="T:System.Globalization.IdnMapping" /> object are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object specified by the <paramref name="obj" /> parameter is derived from <see cref="T:System.Globalization.IdnMapping" /> and its <see cref="P:System.Globalization.IdnMapping.AllowUnassigned" /> and <see cref="P:System.Globalization.IdnMapping.UseStd3AsciiRules" /> properties are equal; otherwise, false. </para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to the current object.</param>
       </Docs>
@@ -130,7 +133,6 @@
         <Parameter Name="unicode" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -157,6 +159,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes a string of domain name labels that consist of Unicode characters to a string of displayable Unicode characters in the US-ASCII character range. The string is formatted according to the IDNA standard.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The equivalent of the string specified by the <paramref name="unicode" /> parameter, consisting of displayable Unicode characters in the US-ASCII character range (U+0020 to U+007E) and formatted according to the IDNA standard.</para>
+        </returns>
         <param name="unicode">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert, which consists of one or more domain name labels delimited with label separators.</param>
       </Docs>
@@ -177,7 +183,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -204,6 +209,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes a substring of domain name labels that include Unicode characters outside the US-ASCII character range. The substring is converted to a string of displayable Unicode characters in the US-ASCII character range and is formatted according to the IDNA standard.  </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The equivalent of the substring specified by the <paramref name="unicode" /> and <paramref name="index" /> parameters, consisting of displayable Unicode characters in the US-ASCII character range (U+0020 to U+007E) and formatted according to the IDNA standard.</para>
+        </returns>
         <param name="unicode">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert, which consists of one or more domain name labels delimited with label separators.</param>
         <param name="index">
@@ -227,7 +236,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -253,6 +261,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes the specified number of characters in a  substring of domain name labels that include Unicode characters outside the US-ASCII character range. The substring is converted to a string of displayable Unicode characters in the US-ASCII character range and is formatted according to the IDNA standard. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The equivalent of the substring specified by the <paramref name="unicode" />, <paramref name="index" />, and <paramref name="count" /> parameters, consisting of displayable Unicode characters in the US-ASCII character range (U+0020 to U+007E) and formatted according to the IDNA standard.</para>
+        </returns>
         <param name="unicode">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert, which consists of one or more domain name labels delimited with label separators.</param>
         <param name="index">
@@ -274,7 +286,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -284,6 +295,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash code for this <see cref="T:System.Globalization.IdnMapping" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of four 32-bit signed constants derived from the properties of an <see cref="T:System.Globalization.IdnMapping" /> object.  The return value has no special meaning and is not suitable for use in a hash code algorithm.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetUnicode">
@@ -301,7 +316,6 @@
         <Parameter Name="ascii" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -311,6 +325,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes a string of one or more domain name labels, encoded according to the IDNA standard, to a string of Unicode characters. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The Unicode equivalent of the IDNA substring specified by the <paramref name="ascii" /> parameter.</para>
+        </returns>
         <param name="ascii">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to decode, which consists of one or more labels in the US-ASCII character range (U+0020 to U+007E) encoded according to the IDNA standard. </param>
       </Docs>
@@ -331,7 +349,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -341,6 +358,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes a substring of one or more domain name labels, encoded according to the IDNA standard, to a string of Unicode characters. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The Unicode equivalent of the IDNA substring specified by the <paramref name="ascii" /> and <paramref name="index" /> parameters.</para>
+        </returns>
         <param name="ascii">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to decode, which consists of one or more labels in the US-ASCII character range (U+0020 to U+007E) encoded according to the IDNA standard. </param>
         <param name="index">
@@ -364,7 +385,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -374,6 +394,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes a substring of a specified length that contains one or more domain name labels, encoded according to the IDNA standard, to a string of Unicode characters. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The Unicode equivalent of the IDNA substring specified by the <paramref name="ascii" />, <paramref name="index" />, and <paramref name="count" /> parameters.</para>
+        </returns>
         <param name="ascii">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to decode, which consists of one or more labels in the US-ASCII character range (U+0020 to U+007E) encoded according to the IDNA standard. </param>
         <param name="index">
diff --git a/mcs/class/corlib/Documentation/en/System.Globalization/JapaneseCalendar.xml b/mcs/class/corlib/Documentation/en/System.Globalization/JapaneseCalendar.xml
index cfb29b4d4f3..fa0fb784346 100644
--- a/mcs/class/corlib/Documentation/en/System.Globalization/JapaneseCalendar.xml
+++ b/mcs/class/corlib/Documentation/en/System.Globalization/JapaneseCalendar.xml
@@ -377,7 +377,6 @@
         <Parameter Name="months" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The day part of the resulting <see cref="T:System.DateTime" /> is affected if the resulting day is not a valid day in the resulting month of the resulting year. It is changed to the last valid day in the resulting month of the resulting year. The year part of the resulting <see cref="T:System.DateTime" /> is affected if the resulting month is outside the year of the specified <see cref="T:System.DateTime" />. The era part of the resulting <see cref="T:System.DateTime" /> is affected if the resulting year is outside the era of the specified <see cref="T:System.DateTime" />. The time-of-day part of the resulting <see cref="T:System.DateTime" /> remains the same as the specified <see cref="T:System.DateTime" />.</para>
@@ -390,6 +389,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is the specified number of months away from the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that results from adding the specified number of months to the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to which to add months. </param>
         <param name="months">
@@ -413,7 +416,6 @@
         <Parameter Name="years" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The day part of the resulting <see cref="T:System.DateTime" /> is affected if the resulting day is not a valid day in the resulting month of the resulting year. It is changed to the last valid day in the resulting month of the resulting year. The month part of the resulting <see cref="T:System.DateTime" /> remains the same as the specified <see cref="T:System.DateTime" />. The era part of the resulting <see cref="T:System.DateTime" /> is affected if the resulting year is outside the era of the specified <see cref="T:System.DateTime" />. The time-of-day part of the resulting <see cref="T:System.DateTime" /> remains the same as the specified <see cref="T:System.DateTime" />.</para>
@@ -426,6 +428,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is the specified number of years away from the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that results from adding the specified number of years to the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to which to add years. </param>
         <param name="years">
@@ -577,12 +583,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the day of the month in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 to 31 that represents the day of the month in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -603,7 +612,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.DayOfWeek" /> values are as follows: </para>
@@ -680,6 +688,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the day of the week in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DayOfWeek" /> value that represents the day of the week in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -700,7 +712,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The day of the year is defined as the number of days from the first day of the year. For example, <see cref="M:System.Globalization.JapaneseCalendar.GetDayOfYear(System.DateTime)" /> for the first day of the first month returns 1, and <see cref="M:System.Globalization.JapaneseCalendar.GetDayOfYear(System.DateTime)" /> for the last day of the last month returns the total number of days in that year, which is the same value as that returned by <see cref="M:System.Globalization.JapaneseCalendar.GetDaysInYear(System.Int32,System.Int32)" />.</para>
@@ -709,6 +720,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the day of the year in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 to 366 that represents the day of the year in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -731,7 +746,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For example, this method returns 28 or 29 for Nigatsu (February, <paramref name="month" /> = 2), depending on whether <paramref name="year" /> is a leap year.</para>
@@ -740,6 +754,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of days in the specified month in the specified year in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of days in the specified month in the specified year in the specified era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -765,7 +783,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For example, this method returns 365 or 366, depending on whether <paramref name="year" /> is a leap year.</para>
@@ -774,6 +791,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of days in the specified year in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of days in the specified year in the specified era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -796,7 +817,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The Japanese calendar recognizes one era for every emperor's reign. The current era is the Heisei era, which began in the Gregorian calendar year 1989. The era name is typically displayed before the year. For example, the Gregorian calendar year 2001 is the Japanese calendar year Heisei 13. Note that the first year of an era is called "Gannen." Therefore, the Gregorian calendar year 1989 was the Japanese calendar year Heisei Gannen.</para>
@@ -881,6 +901,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the era in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that represents the era in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -906,7 +930,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In a calendar that supports the notion of a leap month, the leap month can occur either after a particular month or after any month in a year. For example, the <see cref="M:System.Globalization.EastAsianLunisolarCalendar.GetMonth(System.DateTime)" /> method returns a number between 1 and 13 that indicates the month associated with a specified date. If there is a leap month between the eighth and ninth months of the year, the <see cref="M:System.Globalization.EastAsianLunisolarCalendar.GetMonth(System.DateTime)" /> method returns 8 for the eighth month, 9 for the leap eighth month, and 10 for the ninth month.</para>
@@ -915,6 +938,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the leap month for a specified year and era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value is always 0 because the <see cref="T:System.Globalization.JapaneseCalendar" /> type does not support the notion of a leap month.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />A year.</param>
         <param name="era">
@@ -937,12 +964,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the month in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 to 12 that represents the month in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -964,12 +994,15 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of months in the specified year in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value is always 12.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -998,7 +1031,6 @@
         <Parameter Name="firstDayOfWeek" Type="System.DayOfWeek" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to determine the number of weeks in the year by setting the <paramref name="time" /> parameter to the last day of the year.</para>
@@ -1011,6 +1043,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the week of the year that includes the date in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 1-based integer that represents the week of the year that includes the date in the <paramref name="time" /> parameter.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
         <param name="rule">
@@ -1035,12 +1071,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the year in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that represents the year in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -1064,7 +1103,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Leap years in the Japanese calendar correspond to the same leap years in the Gregorian calendar. A leap year in the Gregorian calendar is defined as a Gregorian year that is evenly divisible by four, except if it is divisible by 100. However, Gregorian years that are divisible by 400 are leap years. A common year has 365 days and a leap year has 366 days.</para>
@@ -1074,6 +1112,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified date in the specified era is a leap day.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if the specified day is a leap day; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -1102,7 +1144,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Leap years in the Japanese calendar correspond to the same leap years in the Gregorian calendar. A leap year in the Gregorian calendar is defined as a Gregorian year that is evenly divisible by four, except if it is divisible by 100. However, Gregorian years that are divisible by 400 are leap years. A common year has 365 days and a leap year has 366 days.</para>
@@ -1112,6 +1153,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified month in the specified year in the specified era is a leap month.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method always returns false, unless overridden by a derived class.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -1137,7 +1182,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Leap years in the Japanese calendar correspond to the same leap years in the Gregorian calendar. A leap year in the Gregorian calendar is defined as a Gregorian year that is evenly divisible by four, except if it is divisible by 100. However, Gregorian years that are divisible by 400 are leap years. A common year has 365 days and a leap year has 366 days.</para>
@@ -1146,6 +1190,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified year in the specified era is a leap year.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if the specified year is a leap year; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -1230,7 +1278,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Globalization.JapaneseCalendar.ToDateTime(System.Int32,System.Int32,System.Int32,System.Int32,System.Int32,System.Int32,System.Int32,System.Int32)" /> method is useful because it can convert any date in the current calendar to a Gregorian calendar date. The Gregorian date can subsequently be used, for example, to compare dates in different calendars or create an equivalent date in a particular calendar.</para>
@@ -1239,6 +1286,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is set to the specified date and time in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that is set to the specified date and time in the current era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -1273,7 +1324,6 @@
         <Parameter Name="year" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method implements <see cref="M:System.Globalization.Calendar.ToFourDigitYear(System.Int32)" />.</para>
@@ -1285,6 +1335,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified year to a four-digit year by using the <see cref="P:System.Globalization.JapaneseCalendar.TwoDigitYearMax" /> property to determine the appropriate century.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that contains the four-digit representation of <paramref name="year" />.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer (usually two digits) that represents the year to convert. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Globalization/JapaneseLunisolarCalendar.xml b/mcs/class/corlib/Documentation/en/System.Globalization/JapaneseLunisolarCalendar.xml
index 8fa552ad91b..d5acfa9a8ff 100644
--- a/mcs/class/corlib/Documentation/en/System.Globalization/JapaneseLunisolarCalendar.xml
+++ b/mcs/class/corlib/Documentation/en/System.Globalization/JapaneseLunisolarCalendar.xml
@@ -112,13 +112,16 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the era that corresponds to the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that represents the era specified in the <paramref name="time" /> parameter.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Globalization/JulianCalendar.xml b/mcs/class/corlib/Documentation/en/System.Globalization/JulianCalendar.xml
index f762d7fba10..bcdbeb2c420 100644
--- a/mcs/class/corlib/Documentation/en/System.Globalization/JulianCalendar.xml
+++ b/mcs/class/corlib/Documentation/en/System.Globalization/JulianCalendar.xml
@@ -75,7 +75,6 @@
         <Parameter Name="months" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The day part of the resulting <see cref="T:System.DateTime" /> is affected if the resulting day is not a valid day in the resulting month of the resulting year. It is changed to the last valid day in the resulting month of the resulting year. The year part of the resulting <see cref="T:System.DateTime" /> is affected if the resulting month is outside the year of the specified <see cref="T:System.DateTime" />. This implementation supports only the current era. Therefore, <see cref="T:System.ArgumentException" /> is thrown if the resulting year is outside the era of the specified <see cref="T:System.DateTime" />. The time-of-day part of the resulting <see cref="T:System.DateTime" /> remains the same as the specified <see cref="T:System.DateTime" />.</para>
@@ -88,6 +87,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is the specified number of months away from the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that results from adding the specified number of months to the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to which to add months. </param>
         <param name="months">
@@ -111,7 +114,6 @@
         <Parameter Name="years" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The day part of the resulting <see cref="T:System.DateTime" /> is affected if the resulting day is not a valid day in the resulting month of the resulting year. It is changed to the last valid day in the resulting month of the resulting year. The month part of the resulting <see cref="T:System.DateTime" /> remains the same as the specified <see cref="T:System.DateTime" />. This implementation supports only the current era. Therefore, <see cref="T:System.ArgumentException" /> is thrown if the resulting year is outside the era of the specified <see cref="T:System.DateTime" />. The time-of-day part of the resulting <see cref="T:System.DateTime" /> remains the same as the specified <see cref="T:System.DateTime" />.</para>
@@ -124,6 +126,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is the specified number of years away from the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that results from adding the specified number of years to the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to which to add years. </param>
         <param name="years">
@@ -196,12 +202,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the day of the month in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 to 31 that represents the day of the month in <paramref name="time" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -222,7 +231,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.DayOfWeek" /> values are Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, and Saturday.</para>
@@ -231,6 +239,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the day of the week in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DayOfWeek" /> value that represents the day of the week in <paramref name="time" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -251,7 +263,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The day of the year is defined as the number of days from the first day of the year. For example, <see cref="M:System.Globalization.JulianCalendar.GetDayOfYear(System.DateTime)" /> for the first day of the first month returns 1, and <see cref="M:System.Globalization.JulianCalendar.GetDayOfYear(System.DateTime)" /> for the last day of the last month returns the total number of days in that year. The total is the same value as that returned by <see cref="M:System.Globalization.JulianCalendar.GetDaysInYear(System.Int32,System.Int32)" />.</para>
@@ -260,6 +271,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the day of the year in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 to 366 that represents the day of the year in <paramref name="time" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -282,7 +297,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns 28 or 29 for February (<paramref name="month" /> = 2), depending on whether <paramref name="year" /> is a leap year.</para>
@@ -291,6 +305,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of days in the specified month in the specified year in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of days in the specified month in the specified year in the specified era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -316,7 +334,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns 365 or 366, depending on whether <paramref name="year" /> is a leap year.</para>
@@ -325,6 +342,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of days in the specified year in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of days in the specified year in the specified era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -347,7 +368,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Globalization.JulianCalendar" /> class recognizes only the current era.</para>
@@ -356,6 +376,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the era in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that represents the era in <paramref name="time" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -381,7 +405,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In a calendar that supports the notion of a leap month, the leap month can occur either after a particular month or after any month in a year. For example, the <see cref="M:System.Globalization.EastAsianLunisolarCalendar.GetMonth(System.DateTime)" /> method returns a number between 1 and 13 that indicates the month associated with a specified date. If there is a leap month between the eighth and ninth months of the year, the <see cref="M:System.Globalization.EastAsianLunisolarCalendar.GetMonth(System.DateTime)" /> method returns 8 for the eighth month, 9 for the leap eighth month, and 10 for the ninth month.</para>
@@ -390,6 +413,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the leap month for a specified year and era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A positive integer that indicates the leap month in the specified year and era. Alternatively, this method returns zero if the calendar does not support a leap month, or if <paramref name="year" /> and <paramref name="era" /> do not specify a leap year.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year.</param>
         <param name="era">
@@ -412,12 +439,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the month in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 to 12 that represents the month in <paramref name="time" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -439,12 +469,15 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of months in the specified year in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of months in the specified year in the specified era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -467,12 +500,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the year in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that represents the year in <paramref name="time" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -496,7 +532,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Unlike the Gregorian calendar, the Julian calendar defines a leap year as a year that is evenly divisible by four with no exceptions. Therefore, the calendar is inaccurate by one day every 128 years. For example, the year 1999 was not a leap year, but the year 2000 was. A common year has 365 days and a leap year has 366 days.</para>
@@ -506,6 +541,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified date in the specified era is a leap day.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified day is a leap day; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -534,7 +573,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Unlike the Gregorian calendar, the Julian calendar defines a leap year as a year that is evenly divisible by four with no exceptions. Therefore, the calendar is inaccurate by one day every 128 years. For example, the year 1999 was not a leap year, but the year 2000 was. A common year has 365 days and a leap year has 366 days.</para>
@@ -544,6 +582,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified month in the specified year in the specified era is a leap month.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method always returns false, unless overridden by a derived class.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -569,7 +611,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Unlike the Gregorian calendar, the Julian calendar defines a leap year as a year that is evenly divisible by four with no exceptions. Therefore, the calendar is inaccurate by one day every 128 years. For example, the year 1999 was not a leap year, but the year 2000 was. A common year has 365 days and a leap year has 366 days.</para>
@@ -578,6 +619,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified year in the specified era is a leap year.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified year is a leap year; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -684,12 +729,15 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is set to the specified date and time in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that is set to the specified date and time in the current era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -724,7 +772,6 @@
         <Parameter Name="year" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -736,6 +783,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified year to a four-digit year by using the <see cref="P:System.Globalization.JulianCalendar.TwoDigitYearMax" /> property to determine the appropriate century.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that contains the four-digit representation of <paramref name="year" />.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />A two-digit or four-digit integer that represents the year to convert. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Globalization/KoreanCalendar.xml b/mcs/class/corlib/Documentation/en/System.Globalization/KoreanCalendar.xml
index 88f62f81b6f..860f62d46ae 100644
--- a/mcs/class/corlib/Documentation/en/System.Globalization/KoreanCalendar.xml
+++ b/mcs/class/corlib/Documentation/en/System.Globalization/KoreanCalendar.xml
@@ -261,7 +261,6 @@
         <Parameter Name="months" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The day part of the resulting <see cref="T:System.DateTime" /> is affected if the resulting day is not a valid day in the resulting month of the resulting year. It is changed to the last valid day in the resulting month of the resulting year. The year part of the resulting <see cref="T:System.DateTime" /> is affected if the resulting month is outside the year of the specified <see cref="T:System.DateTime" />. This implementation supports only the current era. Therefore, <see cref="T:System.ArgumentException" /> is thrown if the resulting year is outside the era of the specified <see cref="T:System.DateTime" />. The time-of-day part of the resulting <see cref="T:System.DateTime" /> remains the same as the specified <see cref="T:System.DateTime" />.</para>
@@ -274,6 +273,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is the specified number of months away from the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that results from adding the specified number of months to the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to which to add months. </param>
         <param name="months">
@@ -297,7 +300,6 @@
         <Parameter Name="years" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The day part of the resulting <see cref="T:System.DateTime" /> is affected if the resulting day is not a valid day in the resulting month of the resulting year. It is changed to the last valid day in the resulting month of the resulting year. The month part of the resulting <see cref="T:System.DateTime" /> remains the same as the specified <see cref="T:System.DateTime" />. This implementation supports only the current era. Therefore, <see cref="T:System.ArgumentException" /> is thrown if the resulting year is outside the era of the specified <see cref="T:System.DateTime" />. The time-of-day part of the resulting <see cref="T:System.DateTime" /> remains the same as the specified <see cref="T:System.DateTime" />.</para>
@@ -310,6 +312,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is the specified number of years away from the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that results from adding the specified number of years to the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to which to add years. </param>
         <param name="years">
@@ -382,12 +388,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the day of the month in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 to 31 that represents the day of the month in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -408,7 +417,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.DayOfWeek" /> values are as follows: </para>
@@ -485,6 +493,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the day of the week in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DayOfWeek" /> value that represents the day of the week in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -505,7 +517,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The day of the year is defined as the number of days from the first day of the year. For example, <see cref="M:System.Globalization.KoreanCalendar.GetDayOfYear(System.DateTime)" /> for the first day of the first month returns 1, and <see cref="M:System.Globalization.KoreanCalendar.GetDayOfYear(System.DateTime)" /> for the last day of the last month returns the total number of days in that year. The total is the same value as that returned by <see cref="M:System.Globalization.KoreanCalendar.GetDaysInYear(System.Int32,System.Int32)" />.</para>
@@ -514,6 +525,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the day of the year in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 to 366 that represents the day of the year in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -536,7 +551,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For example, this method returns 28 or 29 for February (<paramref name="month" /> = 2), depending on whether <paramref name="year" /> is a leap year.</para>
@@ -545,6 +559,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of days in the specified month in the specified year in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of days in the specified month in the specified year in the specified era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -570,7 +588,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For example, this method returns 365 or 366, depending on whether <paramref name="year" /> is a leap year.</para>
@@ -579,6 +596,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of days in the specified year in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of days in the specified year in the specified era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -601,7 +622,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Globalization.KoreanCalendar" /> class recognizes only the current era.</para>
@@ -610,6 +630,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the era in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that represents the era in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -635,7 +659,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In a calendar that supports the notion of a leap month, the leap month can occur either after a particular month or after any month in a year. For example, the <see cref="M:System.Globalization.EastAsianLunisolarCalendar.GetMonth(System.DateTime)" /> method returns a number between 1 and 13 that indicates the month associated with a specified date. If there is a leap month between the eighth and ninth months of the year, the <see cref="M:System.Globalization.EastAsianLunisolarCalendar.GetMonth(System.DateTime)" /> method returns 8 for the eighth month, 9 for the leap eighth month, and 10 for the ninth month.</para>
@@ -644,6 +667,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the leap month for a specified year and era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value is always 0 because the <see cref="T:System.Globalization.KoreanCalendar" /> class does not support the notion of a leap month.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />A year.</param>
         <param name="era">
@@ -666,12 +693,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the month in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 to 12 that represents the month in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -693,12 +723,15 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of months in the specified year in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of months in the specified year in the specified era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -727,7 +760,6 @@
         <Parameter Name="firstDayOfWeek" Type="System.DayOfWeek" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to determine the number of weeks in the year by setting the <paramref name="time" /> parameter to the last day of the year.</para>
@@ -741,6 +773,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the week of the year that includes the date in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 1-based integer that represents the week of the year that includes the date in the <paramref name="time" /> parameter.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
         <param name="rule">
@@ -765,12 +801,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the year in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that represents the year in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -794,7 +833,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Leap years in the Korean calendar correspond to the same leap years in the Gregorian calendar. A leap year in the Gregorian calendar is defined as a Gregorian year that is evenly divisible by four, except if it is divisible by 100. However, Gregorian years that are divisible by 400 are leap years. A common year has 365 days and a leap year has 366 days.</para>
@@ -804,6 +842,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified date in the specified era is a leap day.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified day is a leap day; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -832,7 +874,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Leap years in the Korean calendar correspond to the same leap years in the Gregorian calendar. A leap year in the Gregorian calendar is defined as a Gregorian year that is evenly divisible by four, except if it is divisible by 100. However, Gregorian years that are divisible by 400 are leap years. A common year has 365 days and a leap year has 366 days.</para>
@@ -842,6 +883,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified month in the specified year in the specified era is a leap month.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method always returns false, unless overridden by a derived class.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -867,7 +912,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Leap years in the Korean calendar correspond to the same leap years in the Gregorian calendar. A leap year in the Gregorian calendar is defined as a Gregorian year that is evenly divisible by four, except if it is divisible by 100. However, Gregorian years that are divisible by 400 are leap years. A common year has 365 days and a leap year has 366 days.</para>
@@ -876,6 +920,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified year in the specified era is a leap year.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified year is a leap year; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -982,12 +1030,15 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is set to the specified date and time in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that is set to the specified date and time in the current era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -1022,7 +1073,6 @@
         <Parameter Name="year" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -1034,6 +1084,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified year to a four-digit year by using the <see cref="P:System.Globalization.KoreanCalendar.TwoDigitYearMax" /> property to determine the appropriate century.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that contains the four-digit representation of <paramref name="year" />.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />A two-digit or four-digit integer that represents the year to convert. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Globalization/KoreanLunisolarCalendar.xml b/mcs/class/corlib/Documentation/en/System.Globalization/KoreanLunisolarCalendar.xml
index 5404ab0305a..cea275fd567 100644
--- a/mcs/class/corlib/Documentation/en/System.Globalization/KoreanLunisolarCalendar.xml
+++ b/mcs/class/corlib/Documentation/en/System.Globalization/KoreanLunisolarCalendar.xml
@@ -109,13 +109,16 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the era that corresponds to the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that represents the era specified by the <paramref name="time" /> parameter. The return value for a <see cref="T:System.Globalization.KoreanLunisolarCalendar" /> object is always the <see cref="F:System.Globalization.KoreanLunisolarCalendar.GregorianEra" /> value.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Globalization/NumberFormatInfo.xml b/mcs/class/corlib/Documentation/en/System.Globalization/NumberFormatInfo.xml
index 345cd3d074a..fd9b2d989b6 100644
--- a/mcs/class/corlib/Documentation/en/System.Globalization/NumberFormatInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.Globalization/NumberFormatInfo.xml
@@ -684,10 +684,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Object" /> that is a copy of the current
-   instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The clone is writable even if the original <see cref="T:System.Globalization.NumberFormatInfo" /> object is read-only. Therefore, the properties of the clone can be modified with user-defined patterns.</para>
@@ -697,6 +693,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a shallow copy of the <see cref="T:System.Globalization.NumberFormatInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new object copied from the original <see cref="T:System.Globalization.NumberFormatInfo" /> object.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1293,9 +1293,6 @@ containing the currency symbol.</para>
         <Parameter Name="formatType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance, if <paramref name="formatType" /> is of type <see cref="T:System.Globalization.NumberFormatInfo" />; otherwise, a null reference.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The Format(String, IFormatProvider) methods supported by the base data types invoke this method when the current <see cref="T:System.Globalization.NumberFormatInfo" /> is passed as the <see cref="T:System.IFormatProvider" /> parameter. This method implements <see cref="M:System.IFormatProvider.GetFormat(System.Type)" />.</para>
@@ -1304,6 +1301,10 @@ containing the currency symbol.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an object of the specified type that provides a number formatting service.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current <see cref="T:System.Globalization.NumberFormatInfo" />, if <paramref name="formatType" /> is the same as the type of the current <see cref="T:System.Globalization.NumberFormatInfo" />; otherwise, null.</para>
+        </returns>
         <param name="formatType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the required formatting service. </param>
       </Docs>
@@ -1325,7 +1326,6 @@ containing the currency symbol.</para>
         <Parameter Name="formatProvider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses the <see cref="M:System.IFormatProvider.GetFormat(System.Type)" /> method of <paramref name="formatProvider" /> using <see cref="T:System.Globalization.NumberFormatInfo" /> as the Type parameter. If <paramref name="formatProvider" /> is null or if <see cref="M:System.IFormatProvider.GetFormat(System.Type)" /> returns null, this method returns <see cref="P:System.Globalization.NumberFormatInfo.CurrentInfo" />.</para>
@@ -1344,6 +1344,10 @@ containing the currency symbol.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Globalization.NumberFormatInfo" /> associated with the specified <see cref="T:System.IFormatProvider" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Globalization.NumberFormatInfo" /> associated with the specified <see cref="T:System.IFormatProvider" />.</para>
+        </returns>
         <param name="formatProvider">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IFormatProvider" /> used to get the <see cref="T:System.Globalization.NumberFormatInfo" />.</param>
       </Docs>
@@ -2388,10 +2392,6 @@ class Test {
         <Parameter Name="nfi" Type="System.Globalization.NumberFormatInfo" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Object" /> that is a copy of the current instance,
-   and cannot be altered.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="nfi" /> is a null reference.</exception>
         <remarks>
@@ -2403,6 +2403,10 @@ class Test {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a read-only <see cref="T:System.Globalization.NumberFormatInfo" /> wrapper.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A read-only <see cref="T:System.Globalization.NumberFormatInfo" /> wrapper around <paramref name="nfi" />.</para>
+        </returns>
         <param name="nfi">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Globalization.NumberFormatInfo" /> to wrap. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Globalization/PersianCalendar.xml b/mcs/class/corlib/Documentation/en/System.Globalization/PersianCalendar.xml
index c89842ffb7b..c451e001b5c 100644
--- a/mcs/class/corlib/Documentation/en/System.Globalization/PersianCalendar.xml
+++ b/mcs/class/corlib/Documentation/en/System.Globalization/PersianCalendar.xml
@@ -68,7 +68,6 @@
         <Parameter Name="months" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -79,6 +78,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> object that is offset the specified number of months from the specified <see cref="T:System.DateTime" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DateTime" /> object that represents the date yielded by adding the number of months specified by the <paramref name="months" /> parameter to the date specified by the <paramref name="time" /> parameter.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to which to add months. </param>
         <param name="months">
@@ -101,7 +104,6 @@
         <Parameter Name="years" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -112,6 +114,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> object that is offset the specified number of years from the specified <see cref="T:System.DateTime" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> object that results from adding the specified number of years to the specified <see cref="T:System.DateTime" /> object.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to which to add years. </param>
         <param name="years">
@@ -177,13 +183,16 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the day of the month in the specified <see cref="T:System.DateTime" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 through 31 that represents the day of the month in the specified <see cref="T:System.DateTime" /> object.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -203,13 +212,16 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the day of the week in the specified <see cref="T:System.DateTime" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DayOfWeek" /> value that represents the day of the week in the specified <see cref="T:System.DateTime" /> object.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -229,13 +241,16 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the day of the year in the specified <see cref="T:System.DateTime" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 through 366 that represents the day of the year in the specified <see cref="T:System.DateTime" /> object.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -257,13 +272,16 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of days in the specified month of the specified year and era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of days in the specified month of the specified year and era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer from 1 through 9378 that represents the year. </param>
         <param name="month">
@@ -288,13 +306,16 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of days in the specified year of the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of days in the specified year and era. The number of days is 365 in a common year or 366 in a leap year.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer from 1 through 9378 that represents the year. </param>
         <param name="era">
@@ -316,13 +337,16 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the era in the specified <see cref="T:System.DateTime" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always returns <see cref="F:System.Globalization.PersianCalendar.PersianEra" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -343,12 +367,15 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the leap month for a specified year and era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value is always 0.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer from 1 through 9378 that represents the year to convert. </param>
         <param name="era">
@@ -370,13 +397,16 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the month in the specified <see cref="T:System.DateTime" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 through 12 that represents the month in the specified <see cref="T:System.DateTime" /> object.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -397,13 +427,16 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of months in the specified year of the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns 10 if the <paramref name="year" /> parameter is 9378; otherwise, always returns 12.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer from 1 through 9378 that represents the year. </param>
         <param name="era">
@@ -425,13 +458,16 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the year in the specified <see cref="T:System.DateTime" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 through 9378 that represents the year in the specified <see cref="T:System.DateTime" />. </para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -454,7 +490,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -464,6 +499,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified date is a leap day.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified day is a leap day; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer from 1 through 9378 that represents the year. </param>
         <param name="month">
@@ -491,13 +530,16 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified month in the specified year and era is a leap month.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always returns false because the <see cref="T:System.Globalization.PersianCalendar" /> class does not support the notion of a leap month.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer from 1 through 9378 that represents the year. </param>
         <param name="month">
@@ -522,13 +564,16 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified year in the specified era is a leap year.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified year is a leap year; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer from 1 through 9378 that represents the year. </param>
         <param name="era">
@@ -627,7 +672,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -637,6 +681,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> object that is set to the specified date, time, and era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DateTime" /> object that is set to the specified date and time in the current era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer from 1 through 9378 that represents the year. </param>
         <param name="month">
@@ -670,7 +718,6 @@
         <Parameter Name="year" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -682,6 +729,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified year to a four-digit year representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that contains the four-digit representation of <paramref name="year" />.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer from 1 through 9378 that represents the year to convert. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Globalization/RegionInfo.xml b/mcs/class/corlib/Documentation/en/System.Globalization/RegionInfo.xml
index 3f39379fffd..918b6fdc5db 100644
--- a/mcs/class/corlib/Documentation/en/System.Globalization/RegionInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.Globalization/RegionInfo.xml
@@ -361,7 +361,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method overrides <see cref="M:System.Object.Equals(System.Object)" />.</para>
@@ -370,6 +369,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified object is the same instance as the current <see cref="T:System.Globalization.RegionInfo" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="value" /> parameter is a <see cref="T:System.Globalization.RegionInfo" /> object and its <see cref="P:System.Globalization.RegionInfo.Name" /> property is the same as the <see cref="P:System.Globalization.RegionInfo.Name" /> property of the current <see cref="T:System.Globalization.RegionInfo" /> object; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current <see cref="T:System.Globalization.RegionInfo" />. </param>
       </Docs>
@@ -418,7 +421,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method overrides <see cref="M:System.Object.GetHashCode" />.</para>
@@ -428,6 +430,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for the current <see cref="T:System.Globalization.RegionInfo" />, suitable for hashing algorithms and data structures, such as a hash table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.Globalization.RegionInfo" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsMetric">
@@ -1831,7 +1837,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1844,6 +1849,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string containing the culture name or ISO 3166 two-letter country/region codes specified for the current <see cref="T:System.Globalization.RegionInfo" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the culture name or ISO 3166 two-letter country/region codes defined for the current <see cref="T:System.Globalization.RegionInfo" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TwoLetterISORegionName">
diff --git a/mcs/class/corlib/Documentation/en/System.Globalization/SortKey.xml b/mcs/class/corlib/Documentation/en/System.Globalization/SortKey.xml
index d4fbb43e735..a3d1480f450 100644
--- a/mcs/class/corlib/Documentation/en/System.Globalization/SortKey.xml
+++ b/mcs/class/corlib/Documentation/en/System.Globalization/SortKey.xml
@@ -75,7 +75,6 @@
         <Parameter Name="sortkey2" Type="System.Globalization.SortKey" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Globalization.SortKey.Compare(System.Globalization.SortKey,System.Globalization.SortKey)" /> method compares the <see cref="P:System.Globalization.SortKey.KeyData" /> properties of the <paramref name="sortkey1" /> and <paramref name="sortkey2" /> parameters. The method yields the same results as the <see cref="M:System.Globalization.CompareInfo.Compare(System.String,System.String)" /> method. </para>
@@ -84,6 +83,49 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two sort keys.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relationship between <paramref name="sortkey1" /> and <paramref name="sortkey2" />.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="sortkey1" /> is less than <paramref name="sortkey2" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="sortkey1" /> is equal to <paramref name="sortkey2" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="sortkey1" /> is greater than <paramref name="sortkey2" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="sortkey1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first sort key to compare. </param>
         <param name="sortkey2">
@@ -106,7 +148,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Two <see cref="T:System.Globalization.SortKey" /> objects are considered equal if their <see cref="P:System.Globalization.SortKey.KeyData" /> properties are equal.</para>
@@ -116,6 +157,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified object is equal to the current <see cref="T:System.Globalization.SortKey" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="value" /> parameter is equal to the current <see cref="T:System.Globalization.SortKey" /> object; otherwise, false. </para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current <see cref="T:System.Globalization.SortKey" /> object. </param>
       </Docs>
@@ -134,7 +179,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method generates the same hash code for two objects that are equal according to the <see cref="M:System.Globalization.SortKey.Equals(System.Object)" /> method.</para>
@@ -144,6 +188,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for the current <see cref="T:System.Globalization.SortKey" /> object that is suitable for hashing algorithms and data structures such as a hash table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.Globalization.SortKey" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="KeyData">
@@ -202,7 +250,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is the concatenation of the string "SortKey - ", the culture identifier and compare options of the current <see cref="T:System.Globalization.SortKey" /> object, and the value of the <see cref="P:System.Globalization.SortKey.OriginalString" /> property.</para>
@@ -212,6 +259,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Globalization.SortKey" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Globalization.SortKey" /> object.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Globalization/StringInfo.xml b/mcs/class/corlib/Documentation/en/System.Globalization/StringInfo.xml
index ef1eebf4001..df95dea7cbd 100644
--- a/mcs/class/corlib/Documentation/en/System.Globalization/StringInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.Globalization/StringInfo.xml
@@ -113,12 +113,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the current <see cref="T:System.Globalization.StringInfo" /> object is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="value" /> parameter is a <see cref="T:System.Globalization.StringInfo" /> object and its <see cref="P:System.Globalization.StringInfo.String" /> property equals the <see cref="P:System.Globalization.StringInfo.String" /> property of this <see cref="T:System.Globalization.StringInfo" /> object; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object.</param>
       </Docs>
@@ -141,7 +144,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The behavior of <see cref="M:System.Globalization.StringInfo.GetHashCode" /> is dependent on its implementation, which might change from one version of the common language runtime to another. This might happen to improve the performance of <see cref="M:System.Globalization.StringInfo.GetHashCode" />. To make the behavior of <see cref="M:System.Globalization.StringInfo.GetHashCode" /> constant, the application should override the runtime implementation of <see cref="M:System.Globalization.StringInfo.GetHashCode" /> with an implementation known to never change.</para>
@@ -150,6 +152,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates a hash code for the value of the current <see cref="T:System.Globalization.StringInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code based on the string value of this <see cref="T:System.Globalization.StringInfo" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetNextTextElement">
@@ -168,7 +174,6 @@
         <Parameter Name="str" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The .NET Framework defines a text element as a unit of text that is displayed as a single character, that is, a grapheme. A text element can be a base character, a surrogate pair, or a combining character sequence. The <see cref="http://go.microsoft.com/fwlink/?linkid=37123">Unicode Standard</see> defines a surrogate pair as a coded character representation for a single abstract character that consists of a sequence of two code units, where the first unit of the pair is a high surrogate and the second is a low surrogate. The <see cref="http://go.microsoft.com/fwlink/?linkid=37123">Unicode Standard</see> defines a combining character sequence as a combination of a base character and one or more combining characters. A surrogate pair can represent a base character or a combining character.</para>
@@ -178,6 +183,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the first text element in a specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the first text element in the specified string.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The string from which to get the text element. </param>
       </Docs>
@@ -199,7 +208,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The .NET Framework defines a text element as a unit of text that is displayed as a single character, that is, a grapheme. A text element can be a base character, a surrogate pair, or a combining character sequence. The <see cref="http://go.microsoft.com/fwlink/?linkid=37123">Unicode Standard</see> defines a surrogate pair as a coded character representation for a single abstract character that consists of a sequence of two code units, where the first unit of the pair is a high surrogate and the second is a low surrogate. The Unicode Standard defines a combining character sequence as a combination of a base character and one or more combining characters. A surrogate pair can represent a base character or a combining character. </para>
@@ -209,6 +217,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the text element at the specified index of the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the text element at the specified index of the specified string.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The string from which to get the text element. </param>
         <param name="index">
@@ -231,7 +243,6 @@
         <Parameter Name="str" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TextElementEnumerator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The .NET Framework defines a text element as a unit of text that is displayed as a single character, that is, a grapheme. A text element can be a base character, a surrogate pair, or a combining character sequence. The <see cref="http://go.microsoft.com/fwlink/?linkid=37123">Unicode Standard</see> defines a surrogate pair as a coded character representation for a single abstract character that consists of a sequence of two code units, where the first unit of the pair is a high surrogate and the second is a low surrogate. The Unicode Standard defines a combining character sequence as a combination of a base character and one or more combining characters. A surrogate pair can represent a base character or a combining character. </para>
@@ -246,6 +257,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the text elements of the entire string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Globalization.TextElementEnumerator" /> for the entire string.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to iterate through. </param>
       </Docs>
@@ -267,7 +282,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TextElementEnumerator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The .NET Framework defines a text element as a unit of text that is displayed as a single character, that is, a grapheme. A text element can be a base character, a surrogate pair, or a combining character sequence. The <see cref="http://go.microsoft.com/fwlink/?linkid=37123">Unicode Standard</see> defines a surrogate pair as a coded character representation for a single abstract character that consists of a sequence of two code units, where the first unit of the pair is a high surrogate and the second is a low surrogate. The Unicode Standard defines a combining character sequence as a combination of a base character and one or more combining characters. A surrogate pair can represent a base character or a combining character. </para>
@@ -282,6 +296,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the text elements of the string, starting at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Globalization.TextElementEnumerator" /> for the string starting at <paramref name="index" />.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to iterate through. </param>
         <param name="index">
@@ -324,7 +342,6 @@
         <Parameter Name="str" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="http://go.microsoft.com/fwlink/?linkid=37123">Unicode Standard</see> defines a surrogate pair as a coded character representation for a single abstract character that consists of a sequence of two code units, where the first unit of the pair is a high surrogate and the second is a low surrogate. A high surrogate is a Unicode code point in the range U+D800 through U+DBFF and a low surrogate is a Unicode code point in the range U+DC00 through U+DFFF.</para>
@@ -342,6 +359,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the indexes of each base character, high surrogate, or control character within the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of integers that contains the zero-based indexes of each base character, high surrogate, or control character within the specified string.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search. </param>
       </Docs>
@@ -381,7 +402,6 @@
         <Parameter Name="startingTextElement" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Consider a string that consists of five text elements, indexed from 0 through 4. If the <paramref name="startingTextElement" /> parameter is 1, the  <see cref="M:System.Globalization.StringInfo.SubstringByTextElements(System.Int32)" /> method returns a substring that consists of the text elements for which the indexes are 1, 2, 3, and 4.</para>
@@ -390,6 +410,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a substring of text elements from the current <see cref="T:System.Globalization.StringInfo" /> object starting from a specified text element and continuing through the last text element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A substring of text elements in this <see cref="T:System.Globalization.StringInfo" /> object, starting from the text element index specified by the <paramref name="startingTextElement" /> parameter and continuing through the last text element in this object.</para>
+        </returns>
         <param name="startingTextElement">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of a text element in this <see cref="T:System.Globalization.StringInfo" /> object.</param>
       </Docs>
@@ -410,7 +434,6 @@
         <Parameter Name="lengthInTextElements" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Consider a string that consists of five text elements, indexed from 0 through 4. If the <paramref name="startingTextElement" /> parameter is 1 and the <paramref name="lengthInTextElements" /> parameter is 3, the <see cref="M:System.Globalization.StringInfo.SubstringByTextElements(System.Int32,System.Int32)" /> method returns a substring that consists of the text elements for which the indexes are 1, 2, and 3.</para>
@@ -419,6 +442,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a substring of text elements from the current <see cref="T:System.Globalization.StringInfo" /> object starting from a specified text element and continuing through the specified number of text elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A substring of text elements in this <see cref="T:System.Globalization.StringInfo" /> object. The substring consists of the number of text elements specified by the <paramref name="lengthInTextElements" /> parameter and starts from the text element index specified by the <paramref name="startingTextElement" /> parameter.</para>
+        </returns>
         <param name="startingTextElement">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of a text element in this <see cref="T:System.Globalization.StringInfo" /> object.</param>
         <param name="lengthInTextElements">
diff --git a/mcs/class/corlib/Documentation/en/System.Globalization/TaiwanCalendar.xml b/mcs/class/corlib/Documentation/en/System.Globalization/TaiwanCalendar.xml
index e2365bb7591..aafc957f81b 100644
--- a/mcs/class/corlib/Documentation/en/System.Globalization/TaiwanCalendar.xml
+++ b/mcs/class/corlib/Documentation/en/System.Globalization/TaiwanCalendar.xml
@@ -260,7 +260,6 @@
         <Parameter Name="months" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The day part of the resulting <see cref="T:System.DateTime" /> is affected if the resulting day is not a valid day in the resulting month of the resulting year. It is changed to the last valid day in the resulting month of the resulting year. The year part of the resulting <see cref="T:System.DateTime" /> is affected if the resulting month is outside the year of the specified <see cref="T:System.DateTime" />. This implementation supports only the current era. Therefore, <see cref="T:System.ArgumentException" /> is thrown if the resulting year is outside the era of the specified <see cref="T:System.DateTime" />. The time-of-day part of the resulting <see cref="T:System.DateTime" /> remains the same as the specified <see cref="T:System.DateTime" />.</para>
@@ -273,6 +272,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is the specified number of months away from the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that results from adding the specified number of months to the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to which to add months. </param>
         <param name="months">
@@ -296,7 +299,6 @@
         <Parameter Name="years" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The day part of the resulting <see cref="T:System.DateTime" /> is affected if the resulting day is not a valid day in the resulting month of the resulting year. It is changed to the last valid day in the resulting month of the resulting year. The month part of the resulting <see cref="T:System.DateTime" /> remains the same as the specified <see cref="T:System.DateTime" />. This implementation supports only the current era. Therefore, <see cref="T:System.ArgumentException" /> is thrown if the resulting year is outside the era of the specified <see cref="T:System.DateTime" />. The time-of-day part of the resulting <see cref="T:System.DateTime" /> remains the same as the specified <see cref="T:System.DateTime" />.</para>
@@ -309,6 +311,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is the specified number of years away from the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that results from adding the specified number of years to the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to which to add years. </param>
         <param name="years">
@@ -381,12 +387,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the day of the month in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 to 31 that represents the day of the month in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -407,7 +416,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.DayOfWeek" /> values are as follows:</para>
@@ -484,6 +492,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the day of the week in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DayOfWeek" /> value that represents the day of the week in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -504,7 +516,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The day of the year is defined as the number of days from the first day of the year. For example, <see cref="M:System.Globalization.TaiwanCalendar.GetDayOfYear(System.DateTime)" /> for the first day of the first month returns 1, and <see cref="M:System.Globalization.TaiwanCalendar.GetDayOfYear(System.DateTime)" /> for the last day of the last month returns the total number of days in that year. The total is the same as the value returned by <see cref="M:System.Globalization.TaiwanCalendar.GetDaysInYear(System.Int32,System.Int32)" />.</para>
@@ -513,6 +524,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the day of the year in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 to 366 that represents the day of the year in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -535,7 +550,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For example, this method returns 28 or 29 for February (<paramref name="month" /> = 2), depending on whether <paramref name="year" /> is a leap year.</para>
@@ -544,6 +558,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of days in the specified month in the specified year in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of days in the specified month in the specified year in the specified era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -569,7 +587,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For example, this method returns 365 or 366, depending on whether <paramref name="year" /> is a leap year.</para>
@@ -578,6 +595,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of days in the specified year in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of days in the specified year in the specified era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -600,7 +621,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Globalization.TaiwanCalendar" /> class recognizes only the current era.</para>
@@ -609,6 +629,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the era in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that represents the era in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -634,7 +658,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In a calendar that supports the notion of a leap month, the leap month can occur either after a particular month or after any month in a year. For example, the <see cref="M:System.Globalization.EastAsianLunisolarCalendar.GetMonth(System.DateTime)" /> method returns a number between 1 and 13 that indicates the month associated with a specified date. If there is a leap month between the eighth and ninth months of the year, the <see cref="M:System.Globalization.EastAsianLunisolarCalendar.GetMonth(System.DateTime)" /> method returns 8 for the eighth month, 9 for the leap eighth month, and 10 for the ninth month.</para>
@@ -643,6 +666,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the leap month for a specified year and era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value is always 0 because the <see cref="T:System.Globalization.TaiwanCalendar" /> class does not support the notion of a leap month.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />A year.</param>
         <param name="era">
@@ -665,12 +692,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the month in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 to 12 that represents the month in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -692,12 +722,15 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of months in the specified year in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of months in the specified year in the specified era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -726,7 +759,6 @@
         <Parameter Name="firstDayOfWeek" Type="System.DayOfWeek" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to determine the number of weeks in the year by setting the <paramref name="time" /> parameter to the last day of the year.</para>
@@ -739,6 +771,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the week of the year that includes the date in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A positive integer that represents the week of the year that includes the date in the <paramref name="time" /> parameter.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
         <param name="rule">
@@ -763,12 +799,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the year in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that represents the year in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -792,7 +831,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Leap years in the Taiwan calendar correspond to the same leap years in the Gregorian calendar. A leap year in the Gregorian calendar is defined as a Gregorian year that is evenly divisible by four, except if it is divisible by 100. However, Gregorian years that are divisible by 400 are leap years. A common year has 365 days and a leap year has 366 days.</para>
@@ -802,6 +840,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified date in the specified era is a leap day.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified day is a leap day; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -830,7 +872,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Leap years in the Taiwan calendar correspond to the same leap years in the Gregorian calendar. A leap year in the Gregorian calendar is defined as a Gregorian year that is evenly divisible by four, except if it is divisible by 100. However, Gregorian years that are divisible by 400 are leap years. A common year has 365 days and a leap year has 366 days.</para>
@@ -840,6 +881,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified month in the specified year in the specified era is a leap month.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method always returns false, unless overridden by a derived class.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -865,7 +910,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Leap years in the Taiwan calendar correspond to the same leap years in the Gregorian calendar. A leap year in the Gregorian calendar is defined as a Gregorian year that is evenly divisible by four, except if it is divisible by 100. However, Gregorian years that are divisible by 400 are leap years. A common year has 365 days and a leap year has 366 days.</para>
@@ -874,6 +918,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified year in the specified era is a leap year.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified year is a leap year; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -958,12 +1006,15 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is set to the specified date and time in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that is set to the specified date and time in the current era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -998,7 +1049,6 @@
         <Parameter Name="year" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method implements <see cref="M:System.Globalization.Calendar.ToFourDigitYear(System.Int32)" />.</para>
@@ -1010,6 +1060,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified year to a four-digit year by using the <see cref="P:System.Globalization.TaiwanCalendar.TwoDigitYearMax" /> property to determine the appropriate century.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that contains the four-digit representation of <paramref name="year" />.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />A two-digit or four-digit integer that represents the year to convert. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Globalization/TaiwanLunisolarCalendar.xml b/mcs/class/corlib/Documentation/en/System.Globalization/TaiwanLunisolarCalendar.xml
index 3a6fc8388be..91b62709ed9 100644
--- a/mcs/class/corlib/Documentation/en/System.Globalization/TaiwanLunisolarCalendar.xml
+++ b/mcs/class/corlib/Documentation/en/System.Globalization/TaiwanLunisolarCalendar.xml
@@ -112,13 +112,16 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the era that corresponds to the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that represents the era specified in the <paramref name="time" /> parameter.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Globalization/TextElementEnumerator.xml b/mcs/class/corlib/Documentation/en/System.Globalization/TextElementEnumerator.xml
index f8223de8a58..efe15717866 100644
--- a/mcs/class/corlib/Documentation/en/System.Globalization/TextElementEnumerator.xml
+++ b/mcs/class/corlib/Documentation/en/System.Globalization/TextElementEnumerator.xml
@@ -109,7 +109,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The .NET Framework defines a text element as a unit of text that is displayed as a single character, that is, a grapheme. A text element can be a base character, a surrogate pair, or a combining character sequence. The <see cref="http://go.microsoft.com/fwlink/?linkid=37123">Unicode Standard</see> defines a surrogate pair as a coded character representation for a single abstract character that consists of a sequence of two code units, where the first unit of the pair is a high surrogate and the second is a low surrogate. The Unicode Standard defines a combining character sequence as a combination of a base character and one or more combining characters. A surrogate pair can represent a base character or a combining character. </para>
@@ -119,6 +118,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the current text element in the string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new string containing the current text element in the string being read.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -136,7 +139,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The .NET Framework defines a text element as a unit of text that is displayed as a single character, that is, a grapheme. A text element can be a base character, a surrogate pair, or a combining character sequence. The <see cref="http://go.microsoft.com/fwlink/?linkid=37123">Unicode Standard</see> defines a surrogate pair as a coded character representation for a single abstract character that consists of a sequence of two code units, where the first unit of the pair is a high surrogate and the second is a low surrogate. The Unicode Standard defines a combining character sequence as a combination of a base character and one or more combining characters. A surrogate pair can represent a base character or a combining character. </para>
@@ -148,6 +150,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the enumerator to the next text element of the string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the enumerator was successfully advanced to the next text element; false if the enumerator has passed the end of the string.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System.Globalization/TextInfo.xml b/mcs/class/corlib/Documentation/en/System.Globalization/TextInfo.xml
index e145527903d..4ef1dfe90cf 100644
--- a/mcs/class/corlib/Documentation/en/System.Globalization/TextInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.Globalization/TextInfo.xml
@@ -81,7 +81,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -91,6 +90,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new object that is a copy of the current <see cref="T:System.Globalization.TextInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.Object" /> that is the memberwise clone of the current <see cref="T:System.Globalization.TextInfo" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CultureName">
@@ -161,7 +164,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method overrides <see cref="M:System.Object.Equals(System.Object)" />.</para>
@@ -170,6 +172,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified object represents the same writing system as the current <see cref="T:System.Globalization.TextInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> represents the same writing system as the current <see cref="T:System.Globalization.TextInfo" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current <see cref="T:System.Globalization.TextInfo" />. </param>
       </Docs>
@@ -188,7 +194,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method overrides <see cref="M:System.Object.GetHashCode" />.</para>
@@ -198,6 +203,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for the current <see cref="T:System.Globalization.TextInfo" />, suitable for hashing algorithms and data structures, such as a hash table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.Globalization.TextInfo" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsReadOnly">
@@ -377,13 +386,18 @@
         <Parameter Name="textInfo" Type="System.Globalization.TextInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a read-only version of the specified <see cref="T:System.Globalization.TextInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Globalization.TextInfo" /> object specified by the <paramref name="textInfo" /> parameter, if <paramref name="textInfo" /> is read-only.</para>
+          <para>-or-</para>
+          <para>A read-only memberwise clone of the <see cref="T:System.Globalization.TextInfo" /> object specified by <paramref name="textInfo" />, if <paramref name="textInfo" /> is not read-only.</para>
+        </returns>
         <param name="textInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Globalization.TextInfo" /> object.</param>
       </Docs>
@@ -429,7 +443,6 @@
         <Parameter Name="c" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'char'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Casing semantics depend on the culture in use. For the invariant culture, the casing semantics are not culture-sensitive. For a specific culture, the casing semantics are sensitive to that culture.</para>
@@ -440,6 +453,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified character to lowercase.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified character converted to lowercase.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to convert to lowercase. </param>
       </Docs>
@@ -460,7 +477,6 @@
         <Parameter Name="str" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned string might differ in length from the input string. For more information on casing, refer to the Unicode Technical Report #21 "Case Mappings," published by the Unicode Consortium (http://www.unicode.org). The current implementation preserves the length of the string. However, this behavior is not guaranteed and could change in future implementations.</para>
@@ -472,6 +488,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string to lowercase.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified string converted to lowercase.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert to lowercase. </param>
       </Docs>
@@ -490,7 +510,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method overrides <see cref="M:System.Object.ToString" />.</para>
@@ -499,6 +518,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current <see cref="T:System.Globalization.TextInfo" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Globalization.TextInfo" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToTitleCase">
@@ -517,7 +540,6 @@
         <Parameter Name="str" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generally, title casing converts the first character of a word to uppercase and the rest of the characters to lowercase. However, this method does not currently provide proper casing to convert a word that is entirely uppercase, such as an acronym. The following table shows the way the method renders several strings.</para>
@@ -588,6 +610,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string to title case (except for words that are entirely in uppercase, which are considered to be acronyms)..</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified string converted to title case.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert to title case. </param>
       </Docs>
@@ -608,7 +634,6 @@
         <Parameter Name="c" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'char'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Casing semantics depend on the culture in use. For the invariant culture, the casing semantics are not culture-sensitive. For a specific culture, the casing semantics are sensitive to that culture.</para>
@@ -619,6 +644,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified character to uppercase.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified character converted to uppercase.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to convert to uppercase. </param>
       </Docs>
@@ -639,7 +668,6 @@
         <Parameter Name="str" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned string might differ in length from the input string. For more information on casing, refer to the Unicode Technical Report #21 "Case Mappings," published by the Unicode Consortium (http://www.unicode.org). The current implementation preserves the length of the string. However, this behavior is not guaranteed and could change in future implementations.</para>
@@ -651,6 +679,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string to uppercase.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified string converted to uppercase.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert to uppercase. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Globalization/ThaiBuddhistCalendar.xml b/mcs/class/corlib/Documentation/en/System.Globalization/ThaiBuddhistCalendar.xml
index 3ecda1ad514..936fa7adb22 100644
--- a/mcs/class/corlib/Documentation/en/System.Globalization/ThaiBuddhistCalendar.xml
+++ b/mcs/class/corlib/Documentation/en/System.Globalization/ThaiBuddhistCalendar.xml
@@ -261,7 +261,6 @@
         <Parameter Name="months" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The day part of the resulting <see cref="T:System.DateTime" /> is affected if the resulting day is not a valid day in the resulting month of the resulting year. It is changed to the last valid day in the resulting month of the resulting year. The year part of the resulting <see cref="T:System.DateTime" /> is affected if the resulting month is outside the year of the specified <see cref="T:System.DateTime" />. This implementation supports only the current era. Therefore, <see cref="T:System.ArgumentException" /> is thrown if the resulting year is outside the era of the specified <see cref="T:System.DateTime" />. The time-of-day part of the resulting <see cref="T:System.DateTime" /> remains the same as the specified <see cref="T:System.DateTime" />.</para>
@@ -274,6 +273,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is the specified number of months away from the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that results from adding the specified number of months to the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to which to add months. </param>
         <param name="months">
@@ -297,7 +300,6 @@
         <Parameter Name="years" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The day part of the resulting <see cref="T:System.DateTime" /> is affected if the resulting day is not a valid day in the resulting month of the resulting year. It is changed to the last valid day in the resulting month of the resulting year. The month part of the resulting <see cref="T:System.DateTime" /> remains the same as the specified <see cref="T:System.DateTime" />. This implementation supports only the current era. Therefore, <see cref="T:System.ArgumentException" /> is thrown if the resulting year is outside the era of the specified <see cref="T:System.DateTime" />. The time-of-day part of the resulting <see cref="T:System.DateTime" /> remains the same as the specified <see cref="T:System.DateTime" />.</para>
@@ -310,6 +312,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is the specified number of years away from the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that results from adding the specified number of years to the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to which to add years. </param>
         <param name="years">
@@ -382,12 +388,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the day of the month in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 to 31 that represents the day of the month in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -408,7 +417,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.DayOfWeek" /> values are as follows: </para>
@@ -485,6 +493,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the day of the week in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DayOfWeek" /> value that represents the day of the week in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -505,7 +517,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The day of the year is defined as the number of days from the first day of the year. For example, <see cref="M:System.Globalization.ThaiBuddhistCalendar.GetDayOfYear(System.DateTime)" /> for the first day of the first month returns 1, and <see cref="M:System.Globalization.ThaiBuddhistCalendar.GetDayOfYear(System.DateTime)" /> for the last day of the last month returns the total number of days in that year. The total is the same as the value returned by <see cref="M:System.Globalization.ThaiBuddhistCalendar.GetDaysInYear(System.Int32,System.Int32)" />.</para>
@@ -514,6 +525,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the day of the year in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 to 366 that represents the day of the year in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -536,7 +551,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For example, this method returns 28 or 29 for February (<paramref name="month" /> = 2), depending on whether <paramref name="year" /> is a leap year.</para>
@@ -545,6 +559,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of days in the specified month in the specified year in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of days in the specified month in the specified year in the specified era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -570,7 +588,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For example, this method returns 365 or 366, depending on whether <paramref name="year" /> is a leap year.</para>
@@ -579,6 +596,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of days in the specified year in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of days in the specified year in the specified era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -601,7 +622,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Globalization.ThaiBuddhistCalendar" /> class recognizes only the current era.</para>
@@ -610,6 +630,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the era in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that represents the era in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -635,7 +659,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In a calendar that supports the notion of a leap month, the leap month can occur either after a particular month or after any month in a year. For example, the <see cref="M:System.Globalization.EastAsianLunisolarCalendar.GetMonth(System.DateTime)" /> method returns a number between 1 and 13 that indicates the month associated with a specified date. If there is a leap month between the eighth and ninth months of the year, the <see cref="M:System.Globalization.EastAsianLunisolarCalendar.GetMonth(System.DateTime)" /> method returns 8 for the eighth month, 9 for the leap eighth month, and 10 for the ninth month.</para>
@@ -644,6 +667,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the leap month for a specified year and era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value is always 0 because the <see cref="T:System.Globalization.ThaiBuddhistCalendar" /> class does not support the notion of a leap month.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />A year.</param>
         <param name="era">
@@ -666,12 +693,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the month in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 to 12 that represents the month in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -693,12 +723,15 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of months in the specified year in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of months in the specified year in the specified era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -727,7 +760,6 @@
         <Parameter Name="firstDayOfWeek" Type="System.DayOfWeek" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to determine the number of weeks in the year by setting the <paramref name="time" /> parameter to the last day of the year.</para>
@@ -741,6 +773,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the week of the year that includes the date in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 1-based positive integer that represents the week of the year that includes the date in the <paramref name="time" /> parameter.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
         <param name="rule">
@@ -765,12 +801,15 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the year in the specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that represents the year in the specified <see cref="T:System.DateTime" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> to read. </param>
       </Docs>
@@ -794,7 +833,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Leap years in the Thai Buddhist calendar correspond to the same leap years in the Gregorian calendar. A leap year in the Gregorian calendar is defined as a Gregorian year that is evenly divisible by four, except if it is divisible by 100. However, Gregorian years that are divisible by 400 are leap years. A common year has 365 days and a leap year has 366 days.</para>
@@ -804,6 +842,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified date in the specified era is a leap day.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified day is a leap day; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -832,7 +874,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Leap years in the Thai Buddhist calendar correspond to the same leap years in the Gregorian calendar. A leap year in the Gregorian calendar is defined as a Gregorian year that is evenly divisible by four, except if it is divisible by 100. However, Gregorian years that are divisible by 400 are leap years. A common year has 365 days and a leap year has 366 days.</para>
@@ -842,6 +883,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified month in the specified year in the specified era is a leap month.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method always returns false, unless overridden by a derived class.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -867,7 +912,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Leap years in the Thai Buddhist calendar correspond to the same leap years in the Gregorian calendar. A leap year in the Gregorian calendar is defined as a Gregorian year that is evenly divisible by four, except if it is divisible by 100. However, Gregorian years that are divisible by 400 are leap years. A common year has 365 days and a leap year has 366 days.</para>
@@ -876,6 +920,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified year in the specified era is a leap year.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified year is a leap year; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="era">
@@ -982,12 +1030,15 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is set to the specified date and time in the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that is set to the specified date and time in the current era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents the year. </param>
         <param name="month">
@@ -1022,7 +1073,6 @@
         <Parameter Name="year" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -1034,6 +1084,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified year to a four-digit year by using the <see cref="P:System.Globalization.ThaiBuddhistCalendar.TwoDigitYearMax" /> property to determine the appropriate century.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that contains the four-digit representation of <paramref name="year" />.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />A two-digit or four-digit integer that represents the year to convert. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Globalization/UmAlQuraCalendar.xml b/mcs/class/corlib/Documentation/en/System.Globalization/UmAlQuraCalendar.xml
index 0e822eb1301..2f579ed42db 100644
--- a/mcs/class/corlib/Documentation/en/System.Globalization/UmAlQuraCalendar.xml
+++ b/mcs/class/corlib/Documentation/en/System.Globalization/UmAlQuraCalendar.xml
@@ -66,7 +66,6 @@
         <Parameter Name="months" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -80,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates a date that is a specified number of months away from a specified initial date.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The date yielded by adding the number of months specified by the <paramref name="months" /> parameter to the date specified by the <paramref name="time" /> parameter.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The date to which to add months. The <see cref="T:System.Globalization.UmAlQuraCalendar" /> class supports only dates from 04/30/1900 00.00.00 (Gregorian date) through 11/16/2077 23:59:59 (Gregorian date).</param>
         <param name="months">
@@ -102,7 +105,6 @@
         <Parameter Name="years" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -116,6 +118,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates a date that is a specified number of years away from a specified initial date.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The date yielded by adding the number of years specified by the <paramref name="years" /> parameter to the date specified by the <paramref name="time" /> parameter.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The date to which to add years. The <see cref="T:System.Globalization.UmAlQuraCalendar" /> class supports only dates from 04/30/1900 00.00.00 (Gregorian date) through 11/16/2077 23:59:59 (Gregorian date).</param>
         <param name="years">
@@ -204,13 +210,16 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the day of the month on which a specified date occurs.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 through 30 that represents the day of the month specified by the <paramref name="time" /> parameter. </para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The date value to read. The <see cref="T:System.Globalization.UmAlQuraCalendar" /> class supports only dates from 04/30/1900 00.00.00 (Gregorian date) through 11/16/2077 23:59:59 (Gregorian date).</param>
       </Docs>
@@ -230,7 +239,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -308,6 +316,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the day of the week on which a specified date occurs.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DayOfWeek" /> value that represents the day of the week specified by the <paramref name="time" /> parameter.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The date value to read. The <see cref="T:System.Globalization.UmAlQuraCalendar" /> class supports only dates from 04/30/1900 00.00.00 (Gregorian date) through 11/16/2077 23:59:59 (Gregorian date).</param>
       </Docs>
@@ -327,7 +339,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -337,6 +348,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the day of the year on which a specified date occurs.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 through 355 that represents the day of the year specified by the <paramref name="time" /> parameter.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The date value to read. The <see cref="T:System.Globalization.UmAlQuraCalendar" /> class supports only dates from 04/30/1900 00.00.00 (Gregorian date) through 11/16/2077 23:59:59 (Gregorian date).</param>
       </Docs>
@@ -358,7 +373,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -368,6 +382,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of days in the specified month of the specified year and era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of days in the specified month in the specified year and era. The return value is 29 in a common year and 30 in a leap year.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />A year. </param>
         <param name="month">
@@ -392,13 +410,16 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of days in the specified year of the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of days in the specified year and era. The number of days is 354 in a common year or 355 in a leap year.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />A year. </param>
         <param name="era">
@@ -420,7 +441,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -430,6 +450,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the era in which a specified date occurs.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always returns the <see cref="F:System.Globalization.UmAlQuraCalendar.UmAlQuraEra" /> value.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The date value to read. </param>
       </Docs>
@@ -450,7 +474,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -460,6 +483,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the leap month for a specified year and era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always 0 because the <see cref="T:System.Globalization.UmAlQuraCalendar" /> class does not support leap months.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />A year.</param>
         <param name="era">
@@ -481,13 +508,16 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the month in which a specified date occurs.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer from 1 through 12 that represents the month in the date specified by the <paramref name="time" /> parameter.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The date value to read. The <see cref="T:System.Globalization.UmAlQuraCalendar" /> class supports only dates from 04/30/1900 00.00.00 (Gregorian date) through 11/16/2077 23:59:59 (Gregorian date).</param>
       </Docs>
@@ -508,13 +538,16 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of months in the specified year of the specified era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always 12.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />A year. </param>
         <param name="era">
@@ -536,13 +569,16 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the year of a date represented by a specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that represents the year specified by the <paramref name="time" /> parameter.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />The date value to read. The <see cref="T:System.Globalization.UmAlQuraCalendar" /> class supports only dates from 04/30/1900 00.00.00 (Gregorian date) through 11/16/2077 23:59:59 (Gregorian date).</param>
       </Docs>
@@ -565,7 +601,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -575,6 +610,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified date is a leap day.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified day is a leap day; otherwise, false. The return value is always false because the <see cref="T:System.Globalization.UmAlQuraCalendar" /> class does not support leap days.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />A year. </param>
         <param name="month">
@@ -602,7 +641,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -612,6 +650,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified month in the specified year and era is a leap month.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always false because the <see cref="T:System.Globalization.UmAlQuraCalendar" /> class does not support leap months.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />A year. </param>
         <param name="month">
@@ -636,7 +678,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -646,6 +687,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified year in the specified era is a leap year.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified year is a leap year; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />A year. </param>
         <param name="era">
@@ -721,7 +766,6 @@
         <Parameter Name="era" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -731,6 +775,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> that is set to the specified date, time, and era.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> that is set to the specified date and time in the current era.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />A year. </param>
         <param name="month">
@@ -764,7 +812,6 @@
         <Parameter Name="year" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -777,6 +824,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified year to a four-digit year by using the <see cref="P:System.Globalization.UmAlQuraCalendar.TwoDigitYearMax" /> property to determine the appropriate century.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If the <paramref name="year" /> parameter is a 2-digit year, the return value is the corresponding 4-digit year. If the <paramref name="year" /> parameter is a 4-digit year, the return value is the unchanged <paramref name="year" /> parameter.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />A 2-digit year from 0 through 99, or a 4-digit Um Al Qura calendar year from 1318 through 1450.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.IO.IsolatedStorage/INormalizeForIsolatedStorage.xml b/mcs/class/corlib/Documentation/en/System.IO.IsolatedStorage/INormalizeForIsolatedStorage.xml
index 849f30d3ee7..c3a785fdfcf 100644
--- a/mcs/class/corlib/Documentation/en/System.IO.IsolatedStorage/INormalizeForIsolatedStorage.xml
+++ b/mcs/class/corlib/Documentation/en/System.IO.IsolatedStorage/INormalizeForIsolatedStorage.xml
@@ -41,12 +41,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns a normalized copy of the object on which it is called.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A normalized object that represents the instance on which this method was called. This instance can be a string, stream, or any serializable object.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.IO.IsolatedStorage/IsolatedStorage.xml b/mcs/class/corlib/Documentation/en/System.IO.IsolatedStorage/IsolatedStorage.xml
index 340c8f397cb..f89f1a987d9 100644
--- a/mcs/class/corlib/Documentation/en/System.IO.IsolatedStorage/IsolatedStorage.xml
+++ b/mcs/class/corlib/Documentation/en/System.IO.IsolatedStorage/IsolatedStorage.xml
@@ -198,7 +198,6 @@
         <Parameter Name="ps" Type="System.Security.PermissionSet" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Security.Permissions.IsolatedStoragePermission'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You call this method on derived classes to determine what permission type governs their use, and to return the permission of the type that has been granted. Use this information to determine the allowable quota and any other derived class-specific isolated storage settings.</para>
@@ -207,6 +206,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented by a derived class, returns a permission that represents access to isolated storage from within a permission set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.Permissions.IsolatedStoragePermission" /> object.</para>
+        </returns>
         <param name="ps">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.PermissionSet" /> object that contains the set of permissions granted to code attempting to use isolated storage. </param>
       </Docs>
@@ -230,7 +233,6 @@
         <Parameter Name="newQuotaSize" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.IO.IsolatedStorage.IsolatedStorageFile.IncreaseQuotaTo(System.Int64)" /> method overrides this method.</para>
@@ -239,6 +241,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, prompts a user to approve a larger quota size, in bytes, for isolated storage.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>false in all cases.</para>
+        </returns>
         <param name="newQuotaSize">
           <attribution license="cc4" from="Microsoft" modified="false" />The requested new quota size, in bytes, for the user to approve.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.IO.IsolatedStorage/IsolatedStorageFile.xml b/mcs/class/corlib/Documentation/en/System.IO.IsolatedStorage/IsolatedStorageFile.xml
index 276a444cfa9..1b819e042cc 100644
--- a/mcs/class/corlib/Documentation/en/System.IO.IsolatedStorage/IsolatedStorageFile.xml
+++ b/mcs/class/corlib/Documentation/en/System.IO.IsolatedStorage/IsolatedStorageFile.xml
@@ -203,7 +203,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is equivalent to using the <see cref="M:System.IO.IsolatedStorage.IsolatedStorageFileStream.#ctor(System.String,System.IO.FileMode,System.IO.FileAccess,System.IO.FileShare,System.IO.IsolatedStorage.IsolatedStorageFile)" /> constructor.</para>
@@ -212,6 +211,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a file in the isolated store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new isolated storage file.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The relative path of the file to create.</param>
       </Docs>
@@ -327,12 +330,15 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified path refers to an existing directory in the isolated store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="path" /> refers to an existing directory in the isolated store and is not null; otherwise, false.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to test.</param>
       </Docs>
@@ -383,12 +389,15 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified path refers to an existing file in the isolated store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="path" /> refers to an existing file in the isolated store and is not null; otherwise, false.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path and file name to test.</param>
       </Docs>
@@ -430,7 +439,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the file described by path does not exist, this method returns 12:00 midnight, January 1, 1601 A.D. (C.E.) Coordinated Universal Time (UTC), adjusted to local time.</para>
@@ -439,6 +447,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the creation date and time of a specified file or directory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The creation date and time for the specified file or directory. This value is expressed in local time.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to the file or directory for which to obtain creation date and time information.</param>
       </Docs>
@@ -460,7 +472,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is equivalent to using the <see cref="M:System.IO.IsolatedStorage.IsolatedStorageFile.GetDirectoryNames(System.String)" /> method with "*" specified for the search pattern.</para>
@@ -469,6 +480,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Enumerates the directories at the root of an isolated store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of relative paths of directories at the root of the isolated store. A zero-length array specifies that there are no directories at the root.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetDirectoryNames">
@@ -487,7 +502,6 @@
         <Parameter Name="searchPattern" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Wildcard characters must only be in the final element of a <paramref name="searchPattern" />. For instance, "directory1/*etc*" is a valid search string, but "*etc*/directory" is not.</para>
@@ -499,6 +513,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Enumerates the directories in an isolated storage scope that match a given search pattern.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of the relative paths of directories in the isolated storage scope that match <paramref name="searchPattern" />. A zero-length array specifies that there are no directories that match.</para>
+        </returns>
         <param name="searchPattern">
           <attribution license="cc4" from="Microsoft" modified="false" />A search pattern. Both single-character ("?") and multi-character ("*") wildcards are supported. </param>
       </Docs>
@@ -519,7 +537,6 @@
         <Parameter Name="scope" Type="System.IO.IsolatedStorage.IsolatedStorageScope" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Collections.IEnumerator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <format type="text/html"><a href="0FCF279A-F241-48F0-8034-2E3D331F1FCB">[&lt;topic://cpconenumeratingstores&gt;]</a></format> example demonstrates the use of the <see cref="M:System.IO.IsolatedStorage.IsolatedStorageFile.GetEnumerator(System.IO.IsolatedStorage.IsolatedStorageScope)" /> method.</para>
@@ -528,6 +545,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the enumerator for the <see cref="T:System.IO.IsolatedStorage.IsolatedStorageFile" /> stores within an isolated storage scope.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Enumerator for the <see cref="T:System.IO.IsolatedStorage.IsolatedStorageFile" /> stores within the specified isolated storage scope.</para>
+        </returns>
         <param name="scope">
           <attribution license="cc4" from="Microsoft" modified="false" />Represents the <see cref="T:System.IO.IsolatedStorage.IsolatedStorageScope" /> for which to return isolated stores. User and User|Roaming are the only IsolatedStorageScope combinations supported. </param>
       </Docs>
@@ -549,7 +570,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is equivalent to using the <see cref="M:System.IO.IsolatedStorage.IsolatedStorageFile.GetFileNames(System.String)" /> method with "*" specified for the search pattern.</para>
@@ -558,6 +578,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Enumerates the file names at the root of an isolated store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of relative paths of files at the root of the isolated store.  A zero-length array specifies that there are no files at the root.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetFileNames">
@@ -576,7 +600,6 @@
         <Parameter Name="searchPattern" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="searchPattern" /> "Project\Data*.txt" will give all ".txt" files beginning with Data in the Project directory of the isolated storage scope. For complete description of search pattern strings, see <see cref="T:System.IO.Directory" />.</para>
@@ -587,6 +610,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the file names that match a search pattern.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of relative paths of files in the isolated storage scope that match <paramref name="searchPattern" />. A zero-length array specifies that there are no files that match.</para>
+        </returns>
         <param name="searchPattern">
           <attribution license="cc4" from="Microsoft" modified="false" />A search pattern. Both single-character ("?") and multi-character ("*") wildcards are supported. </param>
       </Docs>
@@ -610,7 +637,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the file described by <paramref name="path" /> does not exist, this method returns 12:00 midnight, January 1, 1601 A.D. (C.E.) Coordinated Universal Time (UTC), adjusted to local time.</para>
@@ -619,6 +645,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the date and time a specified file or directory was last accessed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The date and time that the specified file or directory was last accessed. This value is expressed in local time.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to the file or directory for which to obtain last access date and time information.</param>
       </Docs>
@@ -642,7 +672,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the file described by <paramref name="path" /> does not exist, this method returns 12:00 midnight, January 1, 1601 A.D. (C.E.) Coordinated Universal Time (UTC), adjusted to local time.</para>
@@ -651,6 +680,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the date and time a specified file or directory was last written to.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The date and time that the specified file or directory was last written to. This value is expressed in local time.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to the file or directory for which to obtain last write date and time information.</param>
       </Docs>
@@ -668,7 +701,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -681,6 +713,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains machine-scoped isolated storage corresponding to the calling code's application identity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object corresponding to the isolated storage scope based on the calling code's application identity.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetMachineStoreForAssembly">
@@ -696,7 +732,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -712,6 +747,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains machine-scoped isolated storage corresponding to the calling code's assembly identity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object corresponding to the isolated storage scope based on the calling code's assembly identity.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetMachineStoreForDomain">
@@ -727,7 +766,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -745,6 +783,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains machine-scoped isolated storage corresponding to the application domain identity and the assembly identity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object corresponding to the <see cref="T:System.IO.IsolatedStorage.IsolatedStorageScope" />, based on a combination of the application domain identity and the assembly identity.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetPermission">
@@ -763,7 +805,6 @@
         <Parameter Name="ps" Type="System.Security.PermissionSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called during a store's initialization to determine the isolated storage file permissions that are granted to an assembly. The <see cref="T:System.IO.IsolatedStorage.IsolatedStorage" /> base class uses these permissions to determine the quota.</para>
@@ -772,6 +813,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Security.Permissions.IsolatedStoragePermission" /> from within a given permission set that represents access to isolated storage.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the <see cref="T:System.IO.IsolatedStorage.IsolatedStorageFile" /> object in the supplied permission set. The value is null if there is no permission of type <see cref="T:System.Security.Permissions.IsolatedStorageFilePermission" /> in the supplied set.</para>
+        </returns>
         <param name="ps">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that contains the set of permissions granted to code that is attempting to use isolated storage. </param>
       </Docs>
@@ -792,7 +837,6 @@
         <Parameter Name="applicationIdentity" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -804,6 +848,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains isolated storage corresponding to the given application identity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the parameters.</para>
+        </returns>
         <param name="scope">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of the enumeration values. </param>
         <param name="applicationIdentity">
@@ -826,7 +874,6 @@
         <Parameter Name="applicationEvidenceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -838,6 +885,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains isolated storage corresponding to the isolation scope and the application identity object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the parameters.</para>
+        </returns>
         <param name="scope">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of the enumeration values. </param>
         <param name="applicationEvidenceType">
@@ -862,7 +913,6 @@
         <Parameter Name="assemblyIdentity" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IsolatedStorageFile'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This form of GetStore is most useful for administrative code that needs to open a store as if it were another assembly. The store is opened for the evidence provided and not for the currently executing assembly.</para>
@@ -874,6 +924,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains the isolated storage corresponding to the given application domain and assembly evidence objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the parameters.</para>
+        </returns>
         <param name="scope">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of the enumeration values. </param>
         <param name="domainIdentity">
@@ -900,7 +954,6 @@
         <Parameter Name="assemblyEvidenceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IsolatedStorageFile'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is the overload of <see cref="M:System.IO.IsolatedStorage.IsolatedStorageFile.GetStore(System.IO.IsolatedStorage.IsolatedStorageScope,System.Type,System.Type)" /> most likely to be called from application code.</para>
@@ -913,6 +966,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains isolated storage corresponding to the isolated storage scope given the application domain and assembly evidence types.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the parameters.</para>
+        </returns>
         <param name="scope">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of the enumeration values. </param>
         <param name="domainEvidenceType">
@@ -941,7 +998,6 @@
         <Parameter Name="assemblyEvidenceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IsolatedStorageFile'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -952,6 +1008,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains isolated storage corresponding to the given application domain and the assembly evidence objects and types.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the parameters.</para>
+        </returns>
         <param name="scope">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of the enumeration values. </param>
         <param name="domainEvidence">
@@ -977,7 +1037,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -991,6 +1050,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains user-scoped isolated storage corresponding to the calling code's application identity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object corresponding to the isolated storage scope based on the calling code's assembly identity.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetUserStoreForAssembly">
@@ -1007,7 +1070,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IsolatedStorageFile'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The same assembly within different applications always uses the same isolated store when using this method.</para>
@@ -1022,6 +1084,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains user-scoped isolated storage corresponding to the calling code's assembly identity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object corresponding to the isolated storage scope based on the calling code's assembly identity.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetUserStoreForDomain">
@@ -1038,7 +1104,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IsolatedStorageFile'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The same assembly code will use different isolated stores when used in the context of different applications.</para>
@@ -1055,6 +1120,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains user-scoped isolated storage corresponding to the application domain identity and assembly identity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object corresponding to the <see cref="T:System.IO.IsolatedStorage.IsolatedStorageScope" />, based on a combination of the application domain identity and the assembly identity.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetUserStoreForSite">
@@ -1074,7 +1143,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is supported only in Silverlight-based applications. </para>
@@ -1083,6 +1151,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains a user-scoped isolated store for use by applications in a virtual host domain.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The isolated storage file that corresponds to the isolated storage scope based on the calling code's application identity.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IncreaseQuotaTo">
@@ -1104,7 +1176,6 @@
         <Parameter Name="newQuotaSize" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.IO.IsolatedStorage.IsolatedStorageFile.IncreaseQuotaTo(System.Int64)" /> method enables an application to explicitly request a larger quota size in bytes. The new quota size must not be smaller than the current quota size, because only quota increases are allowed.</para>
@@ -1117,6 +1188,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Enables an application to explicitly request a larger quota size, in bytes. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the new quota is accepted; otherwise, false.</para>
+        </returns>
         <param name="newQuotaSize">
           <attribution license="cc4" from="Microsoft" modified="false" />The requested size, in bytes.</param>
       </Docs>
@@ -1270,7 +1345,6 @@
         <Parameter Name="mode" Type="System.IO.FileMode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is equivalent to using the <see cref="M:System.IO.IsolatedStorage.IsolatedStorageFileStream.#ctor(System.String,System.IO.FileMode,System.IO.IsolatedStorage.IsolatedStorageFile)" /> constructor.</para>
@@ -1279,6 +1353,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a file in the specified mode.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A file that is opened in the specified mode, with read/write access, and is unshared.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The relative path of the file within the isolated store.</param>
         <param name="mode">
@@ -1306,7 +1384,6 @@
         <Parameter Name="access" Type="System.IO.FileAccess" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is equivalent to using the <see cref="M:System.IO.IsolatedStorage.IsolatedStorageFileStream.#ctor(System.String,System.IO.FileMode,System.IO.FileAccess,System.IO.IsolatedStorage.IsolatedStorageFile)" /> constructor.</para>
@@ -1315,6 +1392,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a file in the specified mode with the specified read/write access.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A file that is opened in the specified mode and access, and is unshared.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The relative path of the file within the isolated store.</param>
         <param name="mode">
@@ -1345,7 +1426,6 @@
         <Parameter Name="share" Type="System.IO.FileShare" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is equivalent to using the <see cref="M:System.IO.IsolatedStorage.IsolatedStorageFileStream.#ctor(System.String,System.IO.FileMode,System.IO.FileAccess,System.IO.FileShare,System.IO.IsolatedStorage.IsolatedStorageFile)" /> constructor.</para>
@@ -1354,6 +1434,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a file in the specified mode, with the specified read/write access and sharing permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A file that is opened in the specified mode and access, and with the specified sharing options.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The relative path of the file within the isolated store.</param>
         <param name="mode">
diff --git a/mcs/class/corlib/Documentation/en/System.IO.IsolatedStorage/IsolatedStorageFileStream.xml b/mcs/class/corlib/Documentation/en/System.IO.IsolatedStorage/IsolatedStorageFileStream.xml
index 5ea9cc6b926..26268769272 100644
--- a/mcs/class/corlib/Documentation/en/System.IO.IsolatedStorage/IsolatedStorageFileStream.xml
+++ b/mcs/class/corlib/Documentation/en/System.IO.IsolatedStorage/IsolatedStorageFileStream.xml
@@ -362,7 +362,6 @@
         <Parameter Name="stateObject" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current position in the stream is updated when you issue the asynchronous read or write, not when the I/O operation completes.</para>
@@ -372,6 +371,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous read.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> object that represents the asynchronous read, which is possibly still pending. This <see cref="T:System.IAsyncResult" /> must be passed to this stream's <see cref="M:System.IO.IsolatedStorage.IsolatedStorageFileStream.EndRead(System.IAsyncResult)" /> method to determine how many bytes were read. This can be done either by the same code that called <see cref="M:System.IO.IsolatedStorage.IsolatedStorageFileStream.BeginRead(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)" /> or in a callback passed to <see cref="M:System.IO.IsolatedStorage.IsolatedStorageFileStream.BeginRead(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)" />.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer to read data into. </param>
         <param name="offset">
@@ -404,7 +407,6 @@
         <Parameter Name="stateObject" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If a <see cref="T:System.IO.IsolatedStorage.IsolatedStorageFileStream" /> object is writable, writing at the end of the stream expands the stream.</para>
@@ -415,6 +417,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous write.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that represents the asynchronous write, which is possibly still pending. This <see cref="T:System.IAsyncResult" /> must be passed to this stream's <see cref="M:System.IO.Stream.EndWrite(System.IAsyncResult)" /> method to ensure that the write is complete, then frees resources appropriately. This can be done either by the same code that called <see cref="M:System.IO.Stream.BeginWrite(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)" /> or in a callback passed to <see cref="M:System.IO.Stream.BeginWrite(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)" />.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer to write data to. </param>
         <param name="offset">
@@ -560,7 +566,6 @@
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -571,6 +576,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ends a pending asynchronous read request.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes read from the stream, between zero and the number of requested bytes. Streams will only return zero at the end of the stream. Otherwise, they will block until at least one byte is available.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />The pending asynchronous request. </param>
       </Docs>
@@ -783,7 +792,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -795,6 +803,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies bytes from the current buffered <see cref="T:System.IO.IsolatedStorage.IsolatedStorageFileStream" /> object to an array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The total number of bytes read into the <paramref name="buffer" />. This can be less than the number of bytes requested if that many bytes are not currently available, or zero if the end of the stream is reached.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer to read. </param>
         <param name="offset">
@@ -817,13 +829,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a single byte from the <see cref="T:System.IO.IsolatedStorage.IsolatedStorageFileStream" /> object in isolated storage.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 8-bit unsigned integer value read from the isolated storage file.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SafeFileHandle">
@@ -867,7 +882,6 @@
         <Parameter Name="origin" Type="System.IO.SeekOrigin" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -877,6 +891,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the current position of this <see cref="T:System.IO.IsolatedStorage.IsolatedStorageFileStream" /> object to the specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new position in the <see cref="T:System.IO.IsolatedStorage.IsolatedStorageFileStream" /> object.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />The new position of the <see cref="T:System.IO.IsolatedStorage.IsolatedStorageFileStream" /> object. </param>
         <param name="origin">
diff --git a/mcs/class/corlib/Documentation/en/System.IO/BinaryReader.xml b/mcs/class/corlib/Documentation/en/System.IO/BinaryReader.xml
index a7d0f5159e2..4ac10021d04 100644
--- a/mcs/class/corlib/Documentation/en/System.IO/BinaryReader.xml
+++ b/mcs/class/corlib/Documentation/en/System.IO/BinaryReader.xml
@@ -266,7 +266,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If surrogate characters can be expected in the stream use the <see cref="M:System.IO.BinaryReader.ReadChars(System.Int32)" /> method, then set the stream back to the original position.</para>
@@ -276,6 +275,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the next available character and does not advance the byte or character position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The next available character, or -1 if no more characters are available or the stream does not support seeking.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Read">
@@ -292,7 +295,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -303,6 +305,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads characters from the underlying stream and advances the current position of the stream in accordance with the Encoding used and the specific character being read from the stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The next character from the input stream, or -1 if no characters are currently available.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Read">
@@ -323,7 +329,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -334,6 +339,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the specified number of bytes from the stream, starting from a specified point in the byte array. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes read into <paramref name="buffer" />. This might be less than the number of bytes requested if that many bytes are not available, or it might be zero if the end of the stream is reached.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer to read data into. </param>
         <param name="index">
@@ -360,7 +369,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -371,6 +379,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the specified number of characters from the stream, starting from a specified point in the character array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The total number of characters read into the buffer. This might be less than the number of characters requested if that many characters are not currently available, or it might be zero if the end of the stream is reached.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer to read data into. </param>
         <param name="index">
@@ -393,7 +405,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -405,6 +416,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads in a 32-bit integer in compressed format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit integer in compressed format.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadBoolean">
@@ -421,7 +436,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -432,6 +446,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a Boolean value from the current stream and advances the current position of the stream by one byte.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the byte is nonzero; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadByte">
@@ -448,7 +466,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'byte'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -471,6 +488,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the next byte from the current stream and advances the current position of the stream by one byte.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The next byte read from the current stream.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadBytes">
@@ -489,7 +510,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>An array of bytes of the length of count.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -500,6 +520,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the specified number of bytes from the current stream into a byte array and advances the current position by that number of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array containing data read from the underlying stream. This might be less than the number of bytes requested if the end of the stream is reached.</para>
+        </returns>
         <param name="count">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of bytes to read. This value must be 0 or a non-negative number or an exception will occur.</param>
       </Docs>
@@ -518,7 +542,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'char'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <see cref="M:System.IO.BinaryReader.ReadChar" /> method attempts to read a surrogate character in the stream an exception will be raised and the position in the stream will advance. The position is restored to the original location before <see cref="M:System.IO.BinaryReader.ReadChar" /> was called if the stream is seekable; however, if the stream is unseekable, the position will not be corrected. If surrogate characters can be expected in the stream, use the <see cref="M:System.IO.BinaryReader.ReadChars(System.Int32)" /> method instead.</para>
@@ -540,6 +563,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the next character from the current stream and advances the current position of the stream in accordance with the Encoding used and the specific character being read from the stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A character read from the current stream.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadChars">
@@ -558,7 +585,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'char []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -569,6 +595,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the specified number of characters from the current stream, returns the data in a character array, and advances the current position in accordance with the Encoding used and the specific character being read from the stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A character array containing data read from the underlying stream. This might be less than the number of characters requested if the end of the stream is reached.</para>
+        </returns>
         <param name="count">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of characters to read. </param>
       </Docs>
@@ -587,7 +617,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'decimal'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -598,6 +627,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a decimal value from the current stream and advances the current position of the stream by sixteen bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decimal value read from the current stream.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadDouble">
@@ -614,7 +647,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'double'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -626,6 +658,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads an 8-byte floating point value from the current stream and advances the current position of the stream by eight bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-byte floating point value read from the current stream.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadInt16">
@@ -642,7 +678,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'short'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -654,6 +689,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a 2-byte signed integer from the current stream and advances the current position of the stream by two bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 2-byte signed integer read from the current stream.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadInt32">
@@ -670,7 +709,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -683,6 +721,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a 4-byte signed integer from the current stream and advances the current position of the stream by four bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 4-byte signed integer read from the current stream.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadInt64">
@@ -699,7 +741,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -711,6 +752,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads an 8-byte signed integer from the current stream and advances the current position of the stream by eight bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-byte signed integer read from the current stream.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadSByte">
@@ -732,7 +777,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'sbyte'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -743,6 +787,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a signed byte from this stream and advances the current position of the stream by one byte.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed byte read from the current stream.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadSingle">
@@ -759,7 +807,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'float'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -771,6 +818,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a 4-byte floating point value from the current stream and advances the current position of the stream by four bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 4-byte floating point value read from the current stream.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadString">
@@ -787,7 +838,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -798,6 +848,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a string from the current stream. The string is prefixed with the length, encoded as an integer seven bits at a time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string being read.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadUInt16">
@@ -819,7 +873,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ushort'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -831,6 +884,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a 2-byte unsigned integer from the current stream using little-endian encoding and advances the position of the stream by two bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 2-byte unsigned integer read from this stream.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadUInt32">
@@ -852,7 +909,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'uint'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -864,6 +920,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a 4-byte unsigned integer from the current stream and advances the position of the stream by four bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 4-byte unsigned integer read from this stream.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadUInt64">
@@ -885,7 +945,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ulong'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -897,6 +956,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads an 8-byte unsigned integer from the current stream and advances the position of the stream by eight bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-byte unsigned integer read from this stream.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.IDisposable.Dispose">
diff --git a/mcs/class/corlib/Documentation/en/System.IO/BinaryWriter.xml b/mcs/class/corlib/Documentation/en/System.IO/BinaryWriter.xml
index e06ca894fcb..c4e860cf187 100644
--- a/mcs/class/corlib/Documentation/en/System.IO/BinaryWriter.xml
+++ b/mcs/class/corlib/Documentation/en/System.IO/BinaryWriter.xml
@@ -323,7 +323,6 @@
         <Parameter Name="origin" Type="System.IO.SeekOrigin" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a list of common I/O tasks, see <format type="text/html"><a href="bf00c380-706a-4e38-b829-454a480629fc">Common I/O Tasks</a></format>.</para>
@@ -332,6 +331,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the position within the current stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position with the current stream.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />A byte offset relative to <paramref name="origin" />. </param>
         <param name="origin">
diff --git a/mcs/class/corlib/Documentation/en/System.IO/BufferedStream.xml b/mcs/class/corlib/Documentation/en/System.IO/BufferedStream.xml
index 11cc71a3480..a8a7ec15fa9 100644
--- a/mcs/class/corlib/Documentation/en/System.IO/BufferedStream.xml
+++ b/mcs/class/corlib/Documentation/en/System.IO/BufferedStream.xml
@@ -288,7 +288,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The Read method will return 0 only if the end of the stream is reached. In all other cases, Read always reads at least one byte from the stream before returning. By definition, if no data is available from the stream upon a call to Read, the Read method returns 0 (the end of the stream is reached automatically). An implementation is free to return fewer bytes than requested even if the end of the stream has not been reached.</para>
@@ -298,6 +297,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies bytes from the current buffered stream to an array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The total number of bytes read into <paramref name="array" />. This can be less than the number of bytes requested if that many bytes are not currently available, or 0 if the end of the stream has been reached before any data can be read.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer to which bytes are to be copied. </param>
         <param name="offset">
@@ -320,12 +323,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a byte from the underlying stream and returns the byte cast to an int, or returns -1 if reading from the end of the stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The byte cast to an int, or -1 if reading from the end of the stream.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Seek">
@@ -345,7 +351,6 @@
         <Parameter Name="origin" Type="System.IO.SeekOrigin" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="offset" /> is negative, the new position will precede the position specified by <paramref name="origin" /> by the number of bytes specified by <paramref name="offset" />. If <paramref name="offset" /> is 0, the new position will be the position specified by <paramref name="origin" />. If <paramref name="offset" /> is positive, the new position will follow the position specified by <paramref name="origin" /> by the number of bytes specified by <paramref name="offset" />.</para>
@@ -356,6 +361,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the position within the current buffered stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new position within the current buffered stream.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />A byte offset relative to <paramref name="origin" />. </param>
         <param name="origin">
diff --git a/mcs/class/corlib/Documentation/en/System.IO/Directory.xml b/mcs/class/corlib/Documentation/en/System.IO/Directory.xml
index b977c7f8494..6a36a2eb67e 100644
--- a/mcs/class/corlib/Documentation/en/System.IO/Directory.xml
+++ b/mcs/class/corlib/Documentation/en/System.IO/Directory.xml
@@ -85,7 +85,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>A <see cref="T:System.IO.DirectoryInfo" /> representing the created directory.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Any and all directories specified in <paramref name="path" /> are created, unless they already exist or unless some part of <paramref name="path" /> is invalid. If the directory already exists, this method does not create a new directory, but it returns a <see cref="T:System.IO.DirectoryInfo" /> object for the existing directory. </para>
@@ -98,6 +97,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates all directories and subdirectories in the specified path unless they already exist.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the directory at the specified path. This object is returned regardless of whether a directory at the specified path already exists.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The directory to create. </param>
       </Docs>
@@ -118,7 +121,6 @@
         <Parameter Name="directorySecurity" Type="System.Security.AccessControl.DirectorySecurity" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -132,6 +134,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates all the directories in the specified path, unless the already exist, applying the specified Windows security.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the directory at the specified path. This object is returned regardless of whether a directory at the specified path already exists.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The directory to create.</param>
         <param name="directorySecurity">
@@ -245,7 +251,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can specify relative or absolute path information in the <paramref name="path" /> parameter. Relative path information is interpreted as relative to the current working directory, which you can determine by using the <see cref="M:System.IO.Directory.GetCurrentDirectory" /> method. The returned directory names are prefixed with the value you provided in the <paramref name="path" /> parameter. For example, if you provide a relative path in the <paramref name="path" /> parameter, the returned directory names will contain a relative path.</para>
@@ -256,6 +261,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerable collection of directory names in a specified path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerable collection of the full names (including paths) for the directories in the directory specified by <paramref name="path" />.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The relative or absolute path to the directory to search. This string is not case-sensitive.</param>
       </Docs>
@@ -275,7 +284,6 @@
         <Parameter Name="searchPattern" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -319,6 +327,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerable collection of directory names that match a search pattern in a specified path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerable collection of the full names (including paths) for the directories in the directory specified by <paramref name="path" /> and that match the specified search pattern.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The relative or absolute path to the directory to search. This string is not case-sensitive.</param>
         <param name="searchPattern">
@@ -341,7 +353,6 @@
         <Parameter Name="searchOption" Type="System.IO.SearchOption" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -385,6 +396,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerable collection of directory names that match a search pattern in a specified path, and optionally searches subdirectories.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerable collection of the full names (including paths) for the directories in the directory specified by <paramref name="path" /> and that match the specified search pattern and option.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The relative or absolute path to the directory to search. This string is not case-sensitive.</param>
         <param name="searchPattern">
@@ -407,7 +422,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can specify relative path information with the <paramref name="path" /> parameter. Relative path information is interpreted as relative to the current working directory, which you can determine by using the <see cref="M:System.IO.Directory.GetCurrentDirectory" /> method. </para>
@@ -418,6 +432,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerable collection of file names in a specified path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerable collection of the full names (including paths) for the files in the directory specified by <paramref name="path" />.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The relative or absolute path to the directory to search. This string is not case-sensitive.</param>
       </Docs>
@@ -437,7 +455,6 @@
         <Parameter Name="searchPattern" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -481,6 +498,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerable collection of file names that match a search pattern in a specified path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerable collection of the full names (including paths) for the files in the directory specified by <paramref name="path" /> and that match the specified search pattern.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The relative or absolute path to the directory to search. This string is not case-sensitive.</param>
         <param name="searchPattern">
@@ -503,7 +524,6 @@
         <Parameter Name="searchOption" Type="System.IO.SearchOption" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -547,6 +567,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerable collection of file names that match a search pattern in a specified path, and optionally searches subdirectories.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerable collection of the full names (including paths) for the files in the directory specified by <paramref name="path" /> and that match the specified search pattern and option.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The relative or absolute path to the directory to search. This string is not case-sensitive.</param>
         <param name="searchPattern">
@@ -569,7 +593,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can specify relative path information with the <paramref name="path" /> parameter. Relative path information is interpreted as relative to the current working directory, which you can determine by using the <see cref="M:System.IO.Directory.GetCurrentDirectory" /> method.</para>
@@ -580,6 +603,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerable collection of file names and directory names in a specified path. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerable collection of file-system entries in the directory specified by <paramref name="path" />.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The relative or absolute path to the directory to search. This string is not case-sensitive.</param>
       </Docs>
@@ -599,7 +626,6 @@
         <Parameter Name="searchPattern" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -643,6 +669,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerable collection of file names and directory names that  match a search pattern in a specified path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerable collection of file-system entries in the directory specified by <paramref name="path" /> and that match the specified search pattern.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The relative or absolute path to the directory to search. This string is not case-sensitive. </param>
         <param name="searchPattern">
@@ -665,7 +695,6 @@
         <Parameter Name="searchOption" Type="System.IO.SearchOption" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -709,6 +738,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerable collection of file names and directory names that match a search pattern in a specified path, and optionally searches subdirectories.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerable collection of file-system entries in the directory specified by <paramref name="path" /> and that match the specified search pattern and option.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The relative or absolute path to the directory to search. This string is not case-sensitive.</param>
         <param name="searchPattern">
@@ -734,13 +767,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true " />if the caller
-   has the required permissions and <paramref name="path" /> contains the name of an existing directory; otherwise, <see langword="false" />. If <paramref name="path" /> is <see langword="null" />, a zero-length string, or contains the
-   name of
-   a file, returns <see langword="false" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="path " />is a zero-length string, contains only white space, or contains one or more implementation-defined invalid characters.</exception>
         <exception cref="T:System.IO.PathTooLongException">The length of <paramref name="path" /> or the absolute path information for <paramref name="path" /> exceeds the system-defined maximum length.</exception>
@@ -759,6 +785,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the given path refers to an existing directory on disk.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="path" /> refers to an existing directory; false if the directory does not exist or an error occurs when trying to determine if the specified file exists.</para>
+          <para>true if <paramref name="path" /> refers to an existing directory; otherwise, false.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to test. </param>
       </Docs>
@@ -779,7 +810,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -791,6 +821,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Security.AccessControl.DirectorySecurity" /> object that encapsulates the access control list (ACL) entries for a specified directory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that encapsulates the access control rules for the file described by the <paramref name="path" /> parameter.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to a directory containing a <see cref="T:System.Security.AccessControl.DirectorySecurity" /> object that describes the file's access control list (ACL) information.</param>
       </Docs>
@@ -811,7 +845,6 @@
         <Parameter Name="includeSections" Type="System.Security.AccessControl.AccessControlSections" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -823,6 +856,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Security.AccessControl.DirectorySecurity" /> object that encapsulates the specified type of access control list (ACL) entries for a specified directory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that encapsulates the access control rules for the file described by the <paramref name="path" /> parameter.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to a directory containing a <see cref="T:System.Security.AccessControl.DirectorySecurity" /> object that describes the file's access control list (ACL) information.</param>
         <param name="includeSections">
@@ -846,12 +883,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.DateTime" /> structure set to
-   the creation date and time for the specified directory. This value is expressed in local time.</para>
-          <para>Platforms that do not
-   support this feature return <see cref="F:System.DateTime.MinValue" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="path " />is a zero-length string, contains only white space, or contains one or more implementation-specific invalid characters.</exception>
         <exception cref="T:System.ArgumentNullException">
@@ -876,6 +907,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the creation date and time of a directory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that is set to the creation date and time for the specified directory. This value is expressed in local time.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path of the directory. </param>
       </Docs>
@@ -897,7 +932,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -910,6 +944,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the creation date and time, in Coordinated Universal Time (UTC) format, of a directory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that is set to the creation date and time for the specified directory. This value is expressed in UTC time.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path of the directory. </param>
       </Docs>
@@ -929,11 +967,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing the path of the current working directory.</para>
-          <para>Platforms that do not
-   support this feature return <see cref="F:System.String.Empty" />.</para>
-        </returns>
         <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
         <permission cref="T:System.Security.Permissions.FileIOPermission">Requires permission to access path information for the current directory. See <see cref="F:System.Security.Permissions.FileIOPermissionAccess.PathDiscovery" qualify="true" /></permission>
         <exception cref="T:System.UnauthorizedAccessException">The caller does not have the required permission.</exception>
@@ -946,6 +979,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the current working directory of the application.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the path of the current working directory, and does not end with a backslash (\).</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -966,10 +1003,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> array containing the names
-   of subdirectories in <paramref name="path" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="path " />is <see langword="null" />. </exception>
         <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
@@ -995,6 +1028,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the names of subdirectories (including their paths) in the specified directory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of the full names (including paths) of subdirectories in the specified path, or an empty array if no directories are found.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The relative or absolute path to the directory to search. This string is not case-sensitive.</param>
       </Docs>
@@ -1018,11 +1055,6 @@
         <Parameter Name="searchPattern" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see langword="String" /> array
-   containing the names of subdirectories of <paramref name="path" /> that match
-<paramref name="searchPattern" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="path " />or<paramref name=" searchPattern " />is <see langword="null" />. </exception>
         <exception cref="T:System.Security.SecurityException">The caller does not have permission to access the requested information.</exception>
@@ -1083,6 +1115,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the names of subdirectories (including their paths) that match the specified search pattern in the specified directory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of the full names (including paths) of the subdirectories that match the search pattern in the specified directory, or an empty array if no directories are found.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The relative or absolute path to the directory to search. This string is not case-sensitive.</param>
         <param name="searchPattern">
@@ -1107,7 +1143,6 @@
         <Parameter Name="searchOption" Type="System.IO.SearchOption" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1152,6 +1187,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the names of the subdirectories (including their paths) that match the specified search pattern in the specified directory, and optionally searches subdirectories.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of the full names (including paths) of the subdirectories that match the specified criteria, or an empty array if no directories are found.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The relative or absolute path to the directory to search. This string is not case-sensitive.</param>
         <param name="searchPattern">
@@ -1177,12 +1216,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing
-   the root information for the specified path.</para>
-          <para>Platforms that do not
-   support this feature return <see cref="F:System.String.Empty" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>
             <paramref name="path" /> is a zero-length string, contains only white space, or contains one or more implementation-specific invalid characters. </para>
@@ -1235,6 +1268,10 @@ class GetDirectoryTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the volume information, root information, or both for the specified path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the volume information, root information, or both for the specified path.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path of a file or directory. </param>
       </Docs>
@@ -1257,12 +1294,6 @@ class GetDirectoryTest {
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> array
-   containing the names of the files in the specified directory.</para>
-          <para>Platforms that do not support this feature
-   return <see langword="null" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <para>
             <paramref name="path " />is null.</para>
@@ -1292,6 +1323,10 @@ class GetDirectoryTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the names of files (including their paths) in the specified directory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of the full names (including paths) for the files in the specified directory, or an empty array if no files are found.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The relative or absolute path to the directory to search. This string is not case-sensitive.</param>
       </Docs>
@@ -1315,11 +1350,6 @@ class GetDirectoryTest {
         <Parameter Name="searchPattern" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" />
-array containing the names of files in the specified directory that match the
-specified search pattern.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="searchPattern " />or <paramref name="path" /> is <see langword="null" /> .</exception>
         <exception cref="T:System.ArgumentException">
@@ -1397,6 +1427,10 @@ specified search pattern.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the names of files (including their paths) that match the specified search pattern in the specified directory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of the full names (including paths) for the files in the specified directory that match the specified search pattern, or an empty array if no files are found.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The relative or absolute path to the directory to search. This string is not case-sensitive.</param>
         <param name="searchPattern">
@@ -1421,7 +1455,6 @@ specified search pattern.</para>
         <Parameter Name="searchOption" Type="System.IO.SearchOption" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1484,6 +1517,10 @@ specified search pattern.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the names of files (including their paths) that match the specified search pattern in the specified directory, using a value to determine whether to search subdirectories.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of the full names (including paths) for the files in the specified directory that match the specified search pattern and option, or an empty array if no files are found.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The relative or absolute path to the directory to search. This string is not case-sensitive.</param>
         <param name="searchPattern">
@@ -1509,9 +1546,6 @@ specified search pattern.</para>
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.String" /> array containing the names of file system entries in the specified directory.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="path" /> is <see langword="null" /> .</exception>
         <exception cref="T:System.ArgumentException">
@@ -1537,6 +1571,10 @@ specified search pattern.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the names of all files and subdirectories in a specified path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of the names of files and subdirectories in the specified directory, or an empty array if no files or subdirectories are found.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The relative or absolute path to the directory to search. This string is not case-sensitive.</param>
       </Docs>
@@ -1560,11 +1598,6 @@ specified search pattern.</para>
         <Parameter Name="searchPattern" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see langword="String" /> array
-   containing
-   file and directory names matching the specified search criteria.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="searchPattern " />or <paramref name="path" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -1638,6 +1671,10 @@ specified search pattern.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of file names and directory names that that match a search pattern in a specified path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of file names and directory names that match the specified search criteria, or an empty array if no files or directories are found.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The relative or absolute path to the directory to search. This string is not case-sensitive.</param>
         <param name="searchPattern">
@@ -1661,7 +1698,6 @@ specified search pattern.</para>
         <Parameter Name="searchOption" Type="System.IO.SearchOption" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The order of the returned file and directory names is not guaranteed; use the <see cref="Overload:System.Array.Sort" /> method if a specific sort order is required.</para>
@@ -1717,6 +1753,10 @@ specified search pattern.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of all the file names and directory names that match a search pattern in a specified path, and optionally searches subdirectories.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of file the file names and directory names that match the specified search criteria, or an empty array if no files or directories are found.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The relative or absolute path to the directory to search. This string is not case-sensitive.</param>
         <param name="searchPattern">
@@ -1742,12 +1782,6 @@ specified search pattern.</para>
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.DateTime" /> structure set to
-   the date and time the specified file or directory was last accessed. This value is expressed in local time.</para>
-          <para>Platforms that do not
-   support this feature return <see cref="F:System.DateTime.MinValue" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="path " />is a zero-length string, contains only white space, or contains one or more implementation-specific invalid characters.</exception>
         <exception cref="T:System.ArgumentNullException">
@@ -1772,6 +1806,10 @@ specified search pattern.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the date and time the specified file or directory was last accessed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that is set to the date and time the specified file or directory was last accessed. This value is expressed in local time.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The file or directory for which to obtain access date and time information. </param>
       </Docs>
@@ -1793,7 +1831,6 @@ specified search pattern.</para>
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1806,6 +1843,10 @@ specified search pattern.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the date and time, in Coordinated Universal Time (UTC) format, that the specified file or directory was last accessed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that is set to the date and time the specified file or directory was last accessed. This value is expressed in UTC time.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The file or directory for which to obtain access date and time information. </param>
       </Docs>
@@ -1827,12 +1868,6 @@ specified search pattern.</para>
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.DateTime" /> structure set to
-   the date and time the specified file or directory was last written to. This value is expressed in local time.</para>
-          <para>Platforms that do not
-   support this feature return <see cref="F:System.DateTime.MinValue" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="path " />is a zero-length string, contains only white space, or contains one or more implementation-specific invalid characters.</exception>
         <exception cref="T:System.ArgumentNullException">
@@ -1856,6 +1891,10 @@ specified search pattern.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the date and time the specified file or directory was last written to.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that is set to the date and time the specified file or directory was last written to. This value is expressed in local time.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The file or directory for which to obtain modification date and time information. </param>
       </Docs>
@@ -1877,7 +1916,6 @@ specified search pattern.</para>
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1890,6 +1928,10 @@ specified search pattern.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the date and time, in Coordinated Universal Time (UTC) format, that the specified file or directory was last written to.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that is set to the date and time the specified file or directory was last written to. This value is expressed in UTC time.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The file or directory for which to obtain modification date and time information. </param>
       </Docs>
@@ -1908,7 +1950,6 @@ specified search pattern.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>GetLogicalDrives returns all of the accessible drives on a particular machine, including the floppy drive and any optical drives.</para>
@@ -1918,6 +1959,10 @@ specified search pattern.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the names of the logical drives on this computer in the form "&lt;drive letter&gt;:\".</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The logical drives on this computer.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetParent">
@@ -1936,7 +1981,6 @@ specified search pattern.</para>
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="path" /> parameter is permitted to specify relative or absolute path information. Relative path information is interpreted as relative to the current working directory. To obtain the current working directory, see <see cref="M:System.IO.Directory.GetCurrentDirectory" />.</para>
@@ -1949,6 +1993,10 @@ specified search pattern.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the parent directory of the specified path, including both absolute and relative paths.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The parent directory, or null if <paramref name="path" /> is the root directory, including the root of a UNC server or share name.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path for which to retrieve the parent directory. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.IO/DirectoryInfo.xml b/mcs/class/corlib/Documentation/en/System.IO/DirectoryInfo.xml
index 598875d7be0..ac5d28a987a 100644
--- a/mcs/class/corlib/Documentation/en/System.IO/DirectoryInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.IO/DirectoryInfo.xml
@@ -153,7 +153,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DirectoryInfo'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Any and all directories specified in <paramref name="path" /> are created, unless some part of <paramref name="path" /> is invalid. The <paramref name="path" /> parameter specifies a directory path, not a file path. If the subdirectory already exists, this method does nothing.</para>
@@ -166,6 +165,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a subdirectory or subdirectories on the specified path. The specified path can be relative to this instance of the <see cref="T:System.IO.DirectoryInfo" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The last directory specified in <paramref name="path" />.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The specified path. This cannot be a different disk volume or Universal Naming Convention (UNC) name. </param>
       </Docs>
@@ -186,7 +189,6 @@
         <Parameter Name="directorySecurity" Type="System.Security.AccessControl.DirectorySecurity" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -200,6 +202,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a subdirectory or subdirectories on the specified path with the specified security. The specified path can be relative to this instance of the <see cref="T:System.IO.DirectoryInfo" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The last directory specified in <paramref name="path" />.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The specified path. This cannot be a different disk volume or Universal Naming Convention (UNC) name.</param>
         <param name="directorySecurity">
@@ -271,7 +277,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.IO.DirectoryInfo.EnumerateDirectories" /> and <see cref="M:System.IO.DirectoryInfo.GetDirectories" /> methods differ as follows: </para>
@@ -328,6 +333,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerable collection of directory information in the current directory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerable collection of directories in the current directory.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="EnumerateDirectories">
@@ -344,7 +353,6 @@
         <Parameter Name="searchPattern" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -432,6 +440,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerable collection of directory information that matches a specified search pattern.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerable collection of directories that matches <paramref name="searchPattern" />.</para>
+        </returns>
         <param name="searchPattern">
           <attribution license="cc4" from="Microsoft" modified="false" />The search string to match against the names of directories.  This parameter can contain a combination of valid literal path and wildcard (* and ?) characters (see Remarks), but doesn't support regular expressions. The default pattern is "*", which returns all files.</param>
       </Docs>
@@ -451,7 +463,6 @@
         <Parameter Name="searchOption" Type="System.IO.SearchOption" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -539,6 +550,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerable collection of directory information that matches a specified search pattern and search subdirectory option. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerable collection of directories that matches <paramref name="searchPattern" /> and <paramref name="searchOption" />.</para>
+        </returns>
         <param name="searchPattern">
           <attribution license="cc4" from="Microsoft" modified="false" />The search string to match against the names of directories.  This parameter can contain a combination of valid literal path and wildcard (* and ?) characters (see Remarks), but doesn't support regular expressions. The default pattern is "*", which returns all files.</param>
         <param name="searchOption">
@@ -557,7 +572,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.IO.DirectoryInfo.EnumerateFiles" /> and <see cref="M:System.IO.DirectoryInfo.GetFiles" /> methods differ as follows: </para>
@@ -619,6 +633,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerable collection of file information in the current directory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerable collection of the files in the current directory.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="EnumerateFiles">
@@ -635,7 +653,6 @@
         <Parameter Name="searchPattern" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -728,6 +745,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerable collection of file information that matches a search pattern.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerable collection of files that matches <paramref name="searchPattern" />.</para>
+        </returns>
         <param name="searchPattern">
           <attribution license="cc4" from="Microsoft" modified="false" />The search string to match against the names of files.  This parameter can contain a combination of valid literal path and wildcard (* and ?) characters (see Remarks), but doesn't support regular expressions. The default pattern is "*", which returns all files.</param>
       </Docs>
@@ -747,7 +768,6 @@
         <Parameter Name="searchOption" Type="System.IO.SearchOption" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -840,6 +860,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerable collection of file information that matches a specified search pattern and search subdirectory option.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerable collection of files that matches <paramref name="searchPattern" /> and <paramref name="searchOption" />.</para>
+        </returns>
         <param name="searchPattern">
           <attribution license="cc4" from="Microsoft" modified="false" />The search string to match against the names of files.  This parameter can contain a combination of valid literal path and wildcard (* and ?) characters (see Remarks), but doesn't support regular expressions. The default pattern is "*", which returns all files.</param>
         <param name="searchOption">
@@ -858,7 +882,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.IO.DirectoryInfo.EnumerateFileSystemInfos" /> and <see cref="M:System.IO.DirectoryInfo.GetFileSystemInfos" /> methods differ as follows: </para>
@@ -915,6 +938,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerable collection of file system information in the current directory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerable collection of file system information in the current directory. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="EnumerateFileSystemInfos">
@@ -931,7 +958,6 @@
         <Parameter Name="searchPattern" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -1019,6 +1045,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerable collection of file system information that matches a specified search pattern.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerable collection of file system information objects that matches <paramref name="searchPattern" />.</para>
+        </returns>
         <param name="searchPattern">
           <attribution license="cc4" from="Microsoft" modified="false" />The search string to match against the names of directories.  This parameter can contain a combination of valid literal path and wildcard (* and ?) characters (see Remarks), but doesn't support regular expressions. The default pattern is "*", which returns all files.</param>
       </Docs>
@@ -1038,7 +1068,6 @@
         <Parameter Name="searchOption" Type="System.IO.SearchOption" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -1126,6 +1155,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerable collection of file system information that matches a specified search pattern and search subdirectory option.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerable collection of file system information objects that matches <paramref name="searchPattern" /> and <paramref name="searchOption" />.</para>
+        </returns>
         <param name="searchPattern">
           <attribution license="cc4" from="Microsoft" modified="false" />The search string to match against the names of directories.  This parameter can contain a combination of valid literal path and wildcard (* and ?) characters (see Remarks), but doesn't support regular expressions. The default pattern is "*", which returns all files.</param>
         <param name="searchOption">
@@ -1169,7 +1202,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1181,6 +1213,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Security.AccessControl.DirectorySecurity" /> object that encapsulates the access control list (ACL) entries for the directory described by the current <see cref="T:System.IO.DirectoryInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.AccessControl.DirectorySecurity" /> object that encapsulates the access control rules for the directory.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetAccessControl">
@@ -1198,7 +1234,6 @@
         <Parameter Name="includeSections" Type="System.Security.AccessControl.AccessControlSections" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1209,6 +1244,72 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Security.AccessControl.DirectorySecurity" /> object that encapsulates the specified type of access control list (ACL) entries for the directory described by the current <see cref="T:System.IO.DirectoryInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.AccessControl.DirectorySecurity" /> object that encapsulates the access control rules for the file described by the <paramref name="path" /> parameter.</para>
+          <para>Exceptions</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Exception type</para>
+                </term>
+                <description>
+                  <para>Condition</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>
+                  <see cref="T:System.SystemException" /> </para>
+              </term>
+              <description>
+                <para>The directory could not be found or modified.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>
+                  <see cref="T:System.UnauthorizedAccessException" /> </para>
+              </term>
+              <description>
+                <para>The current process does not have access to open the directory.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>
+                  <see cref="T:System.IO.IOException" /> </para>
+              </term>
+              <description>
+                <para>An I/O error occurred while opening the directory.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>
+                  <see cref="T:System.PlatformNotSupportedException" /> </para>
+              </term>
+              <description>
+                <para>The current operating system is not Microsoft Windows 2000 or later.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>
+                  <see cref="T:System.UnauthorizedAccessException" /> </para>
+              </term>
+              <description>
+                <para>The directory is read-only.</para>
+                <para>-or- </para>
+                <para>This operation is not supported on the current platform.</para>
+                <para>-or- </para>
+                <para>The caller does not have the required permission.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="includeSections">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Security.AccessControl.AccessControlSections" /> values that specifies the type of access control list (ACL) information to receive.</param>
       </Docs>
@@ -1227,7 +1328,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'DirectoryInfo []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If there are no subdirectories, this method returns an empty array. This method is not recursive.</para>
@@ -1274,6 +1374,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the subdirectories of the current directory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.IO.DirectoryInfo" /> objects.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetDirectories">
@@ -1292,7 +1396,6 @@
         <Parameter Name="searchPattern" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DirectoryInfo []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -1369,6 +1472,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of directories in the current <see cref="T:System.IO.DirectoryInfo" /> matching the given search criteria.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type DirectoryInfo matching <paramref name="searchPattern" />.</para>
+        </returns>
         <param name="searchPattern">
           <attribution license="cc4" from="Microsoft" modified="false" />The search string to match against the names of directories.  This parameter can contain a combination of valid literal path and wildcard (* and ?) characters (see Remarks), but doesn't support regular expressions. The default pattern is "*", which returns all files.</param>
       </Docs>
@@ -1389,7 +1496,6 @@
         <Parameter Name="searchOption" Type="System.IO.SearchOption" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1468,6 +1574,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of directories in the current <see cref="T:System.IO.DirectoryInfo" /> matching the given search criteria and using a value to determine whether to search subdirectories.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type DirectoryInfo matching <paramref name="searchPattern" />.</para>
+        </returns>
         <param name="searchPattern">
           <attribution license="cc4" from="Microsoft" modified="false" />The search string to match against the names of directories.  This parameter can contain a combination of valid literal path and wildcard (* and ?) characters (see Remarks), but doesn't support regular expressions. The default pattern is "*", which returns all files.</param>
         <param name="searchOption">
@@ -1488,7 +1598,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'FileInfo []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.IO.DirectoryInfo.EnumerateFiles" /> and <see cref="M:System.IO.DirectoryInfo.GetFiles" /> methods differ as follows: </para>
@@ -1551,6 +1660,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a file list from the current directory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.IO.FileInfo" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetFiles">
@@ -1569,7 +1682,6 @@
         <Parameter Name="searchPattern" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'FileInfo []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -1699,6 +1811,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a file list from the current directory matching the given search pattern.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.IO.FileInfo" />.</para>
+        </returns>
         <param name="searchPattern">
           <attribution license="cc4" from="Microsoft" modified="false" />The search string to match against the names of files.  This parameter can contain a combination of valid literal path and wildcard (* and ?) characters (see Remarks), but doesn't support regular expressions. The default pattern is "*", which returns all files.</param>
       </Docs>
@@ -1719,7 +1835,6 @@
         <Parameter Name="searchOption" Type="System.IO.SearchOption" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1834,6 +1949,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a file list from the current directory matching the given search pattern and using a value to determine whether to search subdirectories.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.IO.FileInfo" />.</para>
+        </returns>
         <param name="searchPattern">
           <attribution license="cc4" from="Microsoft" modified="false" />The search string to match against the names of files.  This parameter can contain a combination of valid literal path and wildcard (* and ?) characters (see Remarks), but doesn't support regular expressions. The default pattern is "*", which returns all files.</param>
         <param name="searchOption">
@@ -1854,7 +1973,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'FileSystemInfo []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If there are no files or directories in the <see cref="T:System.IO.DirectoryInfo" />, this method returns an empty array. This method is not recursive.</para>
@@ -1902,6 +2020,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of strongly typed <see cref="T:System.IO.FileSystemInfo" /> entries representing all the files and subdirectories in a directory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of strongly typed <see cref="T:System.IO.FileSystemInfo" /> entries.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetFileSystemInfos">
@@ -1920,7 +2042,6 @@
         <Parameter Name="searchPattern" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'FileSystemInfo []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -2001,6 +2122,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of strongly typed <see cref="T:System.IO.FileSystemInfo" /> objects representing the files and subdirectories that match the specified search criteria.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of strongly typed FileSystemInfo objects matching the search criteria.</para>
+        </returns>
         <param name="searchPattern">
           <attribution license="cc4" from="Microsoft" modified="false" />The search string to match against the names of directories and files.  This parameter can contain a combination of valid literal path and wildcard (* and ?) characters (see Remarks), but doesn't support regular expressions. The default pattern is "*", which returns all files.</param>
       </Docs>
@@ -2020,7 +2145,6 @@
         <Parameter Name="searchOption" Type="System.IO.SearchOption" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -2098,6 +2222,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of <see cref="T:System.IO.FileSystemInfo" /> objects that represent the files and subdirectories matching the specified search criteria.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of file system entries that match the search criteria.</para>
+        </returns>
         <param name="searchPattern">
           <attribution license="cc4" from="Microsoft" modified="false" />The search string to match against the names of directories and filesa.  This parameter can contain a combination of valid literal path and wildcard (* and ?) characters (see Remarks), but doesn't support regular expressions. The default pattern is "*", which returns all files.</param>
         <param name="searchOption">
@@ -2270,12 +2398,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the original path that was passed by the user.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the original path that was passed by the user.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.IO/DriveInfo.xml b/mcs/class/corlib/Documentation/en/System.IO/DriveInfo.xml
index 15592626d98..dbb9dd41213 100644
--- a/mcs/class/corlib/Documentation/en/System.IO/DriveInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.IO/DriveInfo.xml
@@ -142,7 +142,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -152,6 +151,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the drive names of all logical drives on a computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.IO.DriveInfo" /> that represents the logical drives on a computer.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsReady">
@@ -270,7 +273,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -280,6 +282,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a drive name as a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the drive.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TotalFreeSpace">
diff --git a/mcs/class/corlib/Documentation/en/System.IO/File.xml b/mcs/class/corlib/Documentation/en/System.IO/File.xml
index 50e85948128..b195d1e9d47 100644
--- a/mcs/class/corlib/Documentation/en/System.IO/File.xml
+++ b/mcs/class/corlib/Documentation/en/System.IO/File.xml
@@ -249,10 +249,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.IO.StreamWriter" /> that appends UTF-8 encoded text to the
-   specified file.</para>
-        </returns>
         <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="path " />is a zero-length string, contains only white space, or contains one or more implementation-specific invalid characters.</exception>
@@ -278,6 +274,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.IO.StreamWriter" /> that appends UTF-8 encoded text to an existing file, or to a new file if the specified file does not exist.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A stream writer that appends UTF-8 encoded text to the specified file or to a new file.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to the file to append to. </param>
       </Docs>
@@ -417,9 +417,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.IO.FileStream" /> that provides read/write access to the specified file.</para>
-        </returns>
         <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
         <exception cref="T:System.ArgumentException">
           <para>
@@ -445,6 +442,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates or overwrites a file in the specified path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.FileStream" /> that provides read/write access to the file specified in <paramref name="path" />.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path and name of the file to create. </param>
       </Docs>
@@ -468,9 +469,6 @@
         <Parameter Name="bufferSize" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.IO.FileStream" /> that provides read/write access to the specified file.</para>
-        </returns>
         <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
         <exception cref="T:System.ArgumentException">
           <para>
@@ -495,6 +493,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates or overwrites the specified file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.FileStream" /> with the specified buffer size that provides read/write access to the file specified in <paramref name="path" />.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the file. </param>
         <param name="bufferSize">
@@ -519,7 +521,6 @@
         <Parameter Name="options" Type="System.IO.FileOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -532,6 +533,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates or overwrites the specified file, specifying a buffer size and a <see cref="T:System.IO.FileOptions" /> value that describes how to create or overwrite the file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new file with the specified buffer size.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the file. </param>
         <param name="bufferSize">
@@ -558,7 +563,6 @@
         <Parameter Name="fileSecurity" Type="System.Security.AccessControl.FileSecurity" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -571,6 +575,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates or overwrites the specified file with the specified buffer size, file options, and file security.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new file with the specified buffer size, file options, and file security.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the file. </param>
         <param name="bufferSize">
@@ -598,9 +606,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.IO.StreamWriter" /> that writes to the specified file using UTF-8 encoding.</para>
-        </returns>
         <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="path " />is a zero-length string, contains only white space, or contains one or more implementation-specific invalid characters.</exception>
@@ -623,6 +628,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates or opens a file for writing UTF-8 encoded text.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.StreamWriter" /> that writes to the specified file using UTF-8 encoding.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The file to be opened for writing. </param>
       </Docs>
@@ -749,12 +758,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true " />if the caller
-   has the required permissions and <paramref name="path" /> contains the name of an existing file; otherwise, <see langword="false" />. If <paramref name="path" /> is <see langword="null" /> or a
-   zero-length string, returns <see langword="false" />.</para>
-        </returns>
         <permission cref="T:System.Security.Permissions.FileIOPermission">Requires permission to read the specified file. See <see cref="F:System.Security.Permissions.FileIOPermissionAccess.Read" qualify="true" />.</permission>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -768,6 +771,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified file exists.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the caller has the required permissions and <paramref name="path" /> contains the name of an existing file; otherwise, false. This method also returns false if <paramref name="path" /> is null, an invalid path, or a zero-length string. If the caller does not have sufficient permissions to read the specified file, no exception is thrown and the method returns false regardless of the existence of <paramref name="path" />.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The file to check. </param>
       </Docs>
@@ -788,7 +795,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -800,6 +806,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Security.AccessControl.FileSecurity" /> object that encapsulates the access control list (ACL) entries for a specified file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.AccessControl.FileSecurity" /> object that encapsulates the access control rules for the file described by the <paramref name="path" /> parameter.     </para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to a file containing a <see cref="T:System.Security.AccessControl.FileSecurity" /> object that describes the file's access control list (ACL) information.</param>
       </Docs>
@@ -820,7 +830,6 @@
         <Parameter Name="includeSections" Type="System.Security.AccessControl.AccessControlSections" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -832,6 +841,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Security.AccessControl.FileSecurity" /> object that encapsulates the specified type of access control list (ACL) entries for a particular file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.AccessControl.FileSecurity" /> object that encapsulates the access control rules for the file described by the <paramref name="path" /> parameter.     </para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to a file containing a <see cref="T:System.Security.AccessControl.FileSecurity" /> object that describes the file's access control list (ACL) information.</param>
         <param name="includeSections">
@@ -854,7 +867,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="path" /> parameter is permitted to specify relative or absolute path information. Relative path information is interpreted as relative to the current working directory. To obtain the current working directory, see <see cref="M:System.IO.Directory.GetCurrentDirectory" />.</para>
@@ -864,6 +876,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.IO.FileAttributes" /> of the file on the path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IO.FileAttributes" /> of the file on the path.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to the file. </param>
       </Docs>
@@ -885,12 +901,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.DateTime" /> structure set
-   to the creation date and time for the specified file or directory. This value is expressed in local time.</para>
-          <para>Platforms that do not
-   support this feature return <see cref="F:System.DateTime.MinValue" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="path " />is a zero-length string, contains only white space, or contains one or more implementation-specific invalid characters.</exception>
         <exception cref="T:System.ArgumentNullException">
@@ -915,6 +925,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the creation date and time of the specified file or directory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DateTime" /> structure set to the creation date and time for the specified file or directory. This value is expressed in local time.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The file or directory for which to obtain creation date and time information. </param>
       </Docs>
@@ -936,7 +950,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -950,6 +963,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the creation date and time, in coordinated universal time (UTC), of the specified file or directory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DateTime" /> structure set to the creation date and time for the specified file or directory. This value is expressed in UTC time.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The file or directory for which to obtain creation date and time information. </param>
       </Docs>
@@ -971,12 +988,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.DateTime" /> structure set to
-   the date and time the specified file or directory was last accessed. This value is expressed in local time.</para>
-          <para>Platforms that do not
-   support this feature return <see cref="F:System.DateTime.MinValue" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="path " />is a zero-length string, contains only white space, or contains one or more implementation-specific invalid characters.</exception>
         <exception cref="T:System.ArgumentNullException">
@@ -1000,6 +1011,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the date and time the specified file or directory was last accessed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DateTime" /> structure set to the date and time that the specified file or directory was last accessed. This value is expressed in local time.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The file or directory for which to obtain access date and time information. </param>
       </Docs>
@@ -1021,7 +1036,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1035,6 +1049,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the date and time, in coordinated universal time (UTC), that the specified file or directory was last accessed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DateTime" /> structure set to the date and time that the specified file or directory was last accessed. This value is expressed in UTC time.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The file or directory for which to obtain access date and time information. </param>
       </Docs>
@@ -1056,12 +1074,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.DateTime" /> structure set to
-   the date and time the specified file or directory was last written to. This value is expressed in local time.</para>
-          <para>Platforms that do not
-   support this feature return <see cref="F:System.DateTime.MinValue" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="path " />is a zero-length string, contains only white space, or contains one or more implementation-specific invalid characters.</exception>
         <exception cref="T:System.ArgumentNullException">
@@ -1085,6 +1097,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the date and time the specified file or directory was last written to.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DateTime" /> structure set to the date and time that the specified file or directory was last written to. This value is expressed in local time.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The file or directory for which to obtain write date and time information. </param>
       </Docs>
@@ -1106,7 +1122,6 @@
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1120,6 +1135,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the date and time, in coordinated universal time (UTC), that the specified file or directory was last written to.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DateTime" /> structure set to the date and time that the specified file or directory was last written to. This value is expressed in UTC time.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The file or directory for which to obtain write date and time information. </param>
       </Docs>
@@ -1193,9 +1212,6 @@
         <Parameter Name="mode" Type="System.IO.FileMode" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.IO.FileStream" /> that provides read/write access to the specified file.</para>
-        </returns>
         <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
         <exception cref="T:System.ArgumentException">
           <para>
@@ -1223,6 +1239,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a <see cref="T:System.IO.FileStream" /> on the specified path with read/write access.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.FileStream" /> opened in the specified mode and path, with read/write access and not shared.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The file to open. </param>
         <param name="mode">
@@ -1249,10 +1269,6 @@
         <Parameter Name="access" Type="System.IO.FileAccess" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.IO.FileStream" />
-that provides access to the specified file.</para>
-        </returns>
         <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
         <exception cref="T:System.ArgumentException">
           <para>
@@ -1285,6 +1301,10 @@ that provides access to the specified file.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a <see cref="T:System.IO.FileStream" /> on the specified path, with the specified mode and access.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An unshared <see cref="T:System.IO.FileStream" /> that provides access to the specified file, with the specified mode and access.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The file to open. </param>
         <param name="mode">
@@ -1314,10 +1334,6 @@ that provides access to the specified file.</para>
         <Parameter Name="share" Type="System.IO.FileShare" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.IO.FileStream" />
-that provides access to the specified file.</para>
-        </returns>
         <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
         <exception cref="T:System.ArgumentException">
           <para>
@@ -1352,6 +1368,10 @@ that provides access to the specified file.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a <see cref="T:System.IO.FileStream" /> on the specified path, having the specified mode with read, write, or read/write access and the specified sharing option.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.FileStream" /> on the specified path, having the specified mode with read, write, or read/write access and the specified sharing option.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The file to open. </param>
         <param name="mode">
@@ -1380,9 +1400,6 @@ that provides access to the specified file.</para>
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A read-only <see cref="T:System.IO.FileStream" /> containing the contents of the specified file.</para>
-        </returns>
         <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="path " />is a zero-length string, contains only white space, or contains one or more implementation-specific invalid characters.</exception>
@@ -1404,6 +1421,10 @@ that provides access to the specified file.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens an existing file for reading.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A read-only <see cref="T:System.IO.FileStream" /> on the specified path.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The file to be opened for reading. </param>
       </Docs>
@@ -1426,10 +1447,6 @@ that provides access to the specified file.</para>
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.IO.StreamReader" /> containing the contents of the
-   specified file.</para>
-        </returns>
         <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="path " />is a zero-length string, contains only white space, or contains one or more implementation-specific invalid characters.</exception>
@@ -1451,6 +1468,10 @@ that provides access to the specified file.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens an existing UTF-8 encoded text file for reading.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.StreamReader" /> on the specified path.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The file to be opened for reading. </param>
       </Docs>
@@ -1473,10 +1494,6 @@ that provides access to the specified file.</para>
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A writable <see cref="T:System.IO.FileStream" /> that writes to the file specified by
-<paramref name="path" />.</para>
-        </returns>
         <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="path " />is a zero-length string, contains only white space, or contains one or more implementation-specific invalid characters.</exception>
@@ -1499,6 +1516,10 @@ that provides access to the specified file.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens an existing file or creates a new file for writing.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An unshared <see cref="T:System.IO.FileStream" /> object on the specified path with <see cref="F:System.IO.FileAccess.Write" /> access.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The file to be opened for writing. </param>
       </Docs>
@@ -1519,7 +1540,6 @@ that provides access to the specified file.</para>
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1529,6 +1549,10 @@ that provides access to the specified file.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a binary file, reads the contents of the file into a byte array, and then closes the file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array containing the contents of the file.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The file to open for reading. </param>
       </Docs>
@@ -1548,7 +1572,6 @@ that provides access to the specified file.</para>
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1559,6 +1582,10 @@ that provides access to the specified file.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a text file, reads all lines of the file, and then closes the file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string array containing all lines of the file.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The file to open for reading. </param>
       </Docs>
@@ -1579,7 +1606,6 @@ that provides access to the specified file.</para>
         <Parameter Name="encoding" Type="System.Text.Encoding" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1590,6 +1616,10 @@ that provides access to the specified file.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a file, reads all lines of the file with the specified encoding, and then closes the file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string array containing all lines of the file.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The file to open for reading. </param>
         <param name="encoding">
@@ -1611,7 +1641,6 @@ that provides access to the specified file.</para>
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1624,6 +1653,10 @@ that provides access to the specified file.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a text file, reads all lines of the file, and then closes the file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing all lines of the file.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The file to open for reading. </param>
       </Docs>
@@ -1644,7 +1677,6 @@ that provides access to the specified file.</para>
         <Parameter Name="encoding" Type="System.Text.Encoding" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1657,6 +1689,10 @@ that provides access to the specified file.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a file, reads all lines of the file with the specified encoding, and then closes the file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing all lines of the file.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The file to open for reading. </param>
         <param name="encoding">
@@ -1677,7 +1713,6 @@ that provides access to the specified file.</para>
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.IO.File.ReadLines(System.String)" /> and <see cref="M:System.IO.File.ReadAllLines(System.String)" /> methods differ as follows: When you use <see cref="M:System.IO.File.ReadLines(System.String)" />, you can start enumerating the collection of strings before the whole collection is returned; when you use <see cref="M:System.IO.File.ReadAllLines(System.String)" />, you must wait for the whole array of strings be returned before you can access the array. Therefore, when you are working with very large files, <see cref="M:System.IO.File.ReadLines(System.String)" /> can be more efficient. </para>
@@ -1699,6 +1734,10 @@ that provides access to the specified file.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the lines of a file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>All the lines of the file, or the lines that are the result of a query.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The file to read.</param>
       </Docs>
@@ -1718,7 +1757,6 @@ that provides access to the specified file.</para>
         <Parameter Name="encoding" Type="System.Text.Encoding" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to specify an encoding to use read the file.</para>
@@ -1741,6 +1779,10 @@ that provides access to the specified file.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Read the lines of a file that has a specified encoding.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>All the lines of the file, or the lines that are the result of a query.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The file to read.</param>
         <param name="encoding">
diff --git a/mcs/class/corlib/Documentation/en/System.IO/FileInfo.xml b/mcs/class/corlib/Documentation/en/System.IO/FileInfo.xml
index ea28dd71703..be583d3fd8a 100644
--- a/mcs/class/corlib/Documentation/en/System.IO/FileInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.IO/FileInfo.xml
@@ -152,12 +152,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'StreamWriter'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.IO.StreamWriter" /> that appends text to the file represented by this instance of the <see cref="T:System.IO.FileInfo" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new StreamWriter.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CopyTo">
@@ -176,7 +179,6 @@
         <Parameter Name="destFileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'FileInfo'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.IO.FileInfo.CopyTo(System.String,System.Boolean)" /> method to allow overwriting of an existing file.</para>
@@ -188,6 +190,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies an existing file to a new file, disallowing the overwriting of an existing file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new file with a fully qualified path.</para>
+        </returns>
         <param name="destFileName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the new file to copy to. </param>
       </Docs>
@@ -209,7 +215,6 @@
         <Parameter Name="overwrite" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'FileInfo'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to allow or prevent overwriting of an existing file. Use the <see cref="M:System.IO.FileInfo.CopyTo(System.String)" />  method to prevent overwriting of an existing file by default.</para>
@@ -221,6 +226,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies an existing file to a new file, allowing the overwriting of an existing file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new file, or an overwrite of an existing file if <paramref name="overwrite" /> is true. If the file exists and <paramref name="overwrite" /> is false, an <see cref="T:System.IO.IOException" /> is thrown.</para>
+        </returns>
         <param name="destFileName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the new file to copy to. </param>
         <param name="overwrite">
@@ -241,7 +250,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'FileStream'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>By default, full read/write access to new files is granted to all users.</para>
@@ -251,6 +259,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new file.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateText">
@@ -267,7 +279,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'StreamWriter'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>By default, full read/write access to new files is granted to all users.</para>
@@ -276,6 +287,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.IO.StreamWriter" /> that writes a new text file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new StreamWriter.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Decrypt">
@@ -451,7 +466,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -462,6 +476,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Security.AccessControl.FileSecurity" /> object that encapsulates the access control list (ACL) entries for the file described by the current <see cref="T:System.IO.FileInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.AccessControl.FileSecurity" /> object that encapsulates the access control rules for the current file.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetAccessControl">
@@ -479,7 +497,6 @@
         <Parameter Name="includeSections" Type="System.Security.AccessControl.AccessControlSections" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -490,6 +507,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Security.AccessControl.FileSecurity" /> object that encapsulates the specified type of access control list (ACL) entries for the file described by the current <see cref="T:System.IO.FileInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.AccessControl.FileSecurity" /> object that encapsulates the access control rules for the current file.     </para>
+        </returns>
         <param name="includeSections">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Security.AccessControl.AccessControlSections" /> values that specifies which group of access control entries to retrieve. </param>
       </Docs>
@@ -645,12 +666,15 @@
         <Parameter Name="mode" Type="System.IO.FileMode" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'FileStream'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a file in the specified mode.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A file opened in the specified mode, with read/write access and unshared.</para>
+        </returns>
         <param name="mode">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IO.FileMode" /> constant specifying the mode (for example, Open or Append) in which to open the file. </param>
       </Docs>
@@ -672,12 +696,15 @@
         <Parameter Name="access" Type="System.IO.FileAccess" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'FileStream'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a file in the specified mode with read, write, or read/write access.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.FileStream" /> object opened in the specified mode and access, and unshared.</para>
+        </returns>
         <param name="mode">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IO.FileMode" /> constant specifying the mode (for example, Open or Append) in which to open the file. </param>
         <param name="access">
@@ -702,12 +729,15 @@
         <Parameter Name="share" Type="System.IO.FileShare" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'FileStream'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens a file in the specified mode with read, write, or read/write access and the specified sharing option.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.FileStream" /> object opened with the specified mode, access, and sharing options.</para>
+        </returns>
         <param name="mode">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IO.FileMode" /> constant specifying the mode (for example, Open or Append) in which to open the file. </param>
         <param name="access">
@@ -730,7 +760,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'FileStream'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns a read-only <see cref="T:System.IO.FileStream" /> object with the <see cref="T:System.IO.FileShare" /> mode set to <see cref="F:System.IO.FileShare.Read" />.</para>
@@ -739,6 +768,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a read-only <see cref="T:System.IO.FileStream" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new read-only <see cref="T:System.IO.FileStream" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="OpenText">
@@ -755,12 +788,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'StreamReader'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.IO.StreamReader" /> with UTF8 encoding that reads from an existing text file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new StreamReader with UTF8 encoding.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="OpenWrite">
@@ -777,7 +813,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'FileStream'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.IO.FileInfo.OpenWrite" /> method opens a file if one already exists for the file path, or creates a new file if one does not exist. For an existing file, it does not append the new text to the existing text. Instead, it overwrites the existing characters with the new characters. If you overwrite a longer string (such as "This is a test of the OpenWrite method") with a shorter string (like "Second run"), the file will contain a mix of the strings ("Second runtest of the OpenWrite method").</para>
@@ -786,6 +821,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a write-only <see cref="T:System.IO.FileStream" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A write-only unshared <see cref="T:System.IO.FileStream" /> object for a new or existing file.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Replace">
@@ -809,7 +848,6 @@
         <Parameter Name="destinationBackupFileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -823,6 +861,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Replaces the contents of a specified file with the file described by the current <see cref="T:System.IO.FileInfo" /> object, deleting the original file, and creating a backup of the replaced file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.FileInfo" /> object that encapsulates information about the file described by the <paramref name="destFileName" /> parameter.</para>
+        </returns>
         <param name="destinationFileName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a file to replace with the current file.</param>
         <param name="destinationBackupFileName">
@@ -851,7 +893,6 @@
         <Parameter Name="ignoreMetadataErrors" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -865,6 +906,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Replaces the contents of a specified file with the file described by the current <see cref="T:System.IO.FileInfo" /> object, deleting the original file, and creating a backup of the replaced file.  Also specifies whether to ignore merge errors. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.FileInfo" /> object that encapsulates information about the file described by the <paramref name="destFileName" /> parameter.</para>
+        </returns>
         <param name="destinationFileName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a file to replace with the current file.</param>
         <param name="destinationBackupFileName">
@@ -939,7 +984,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The string returned by the <see cref="M:System.IO.FileInfo.ToString" /> method represents path that was passed to the constructor.  When you create a <see cref="T:System.IO.FileInfo" /> object using the constructors, the <see cref="M:System.IO.FileInfo.ToString" /> method returns the fully qualified path.  However, there are cases where the string returned by the <see cref="M:System.IO.FileInfo.ToString" /> method does not represent the fully qualified path.  For example, when you create a <see cref="T:System.IO.FileInfo" /> object using the <see cref="Overload:System.IO.DirectoryInfo.GetFiles" /> method, the <see cref="M:System.IO.FileInfo.ToString" /> method does not represent the fully qualified path.      </para>
@@ -948,6 +992,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the path as a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representing the path.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.IO/FileLoadException.xml b/mcs/class/corlib/Documentation/en/System.IO/FileLoadException.xml
index a96f229b7bb..05a87712881 100644
--- a/mcs/class/corlib/Documentation/en/System.IO/FileLoadException.xml
+++ b/mcs/class/corlib/Documentation/en/System.IO/FileLoadException.xml
@@ -410,10 +410,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> 
-representation of the current exception.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method overrides <see cref="M:System.Object.ToString" />.</para>
@@ -423,6 +419,10 @@ representation of the current exception.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the fully qualified name of the current exception, and possibly the error message, the name of the inner exception, and the stack trace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the fully qualified name of this exception, and possibly the error message, the name of the inner exception, and the stack trace, depending on which <see cref="T:System.IO.FileLoadException" /> constructor is used.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System.IO/FileNotFoundException.xml b/mcs/class/corlib/Documentation/en/System.IO/FileNotFoundException.xml
index 57d6d904e10..b2e126848c2 100644
--- a/mcs/class/corlib/Documentation/en/System.IO/FileNotFoundException.xml
+++ b/mcs/class/corlib/Documentation/en/System.IO/FileNotFoundException.xml
@@ -425,10 +425,6 @@ class FileNotFoundExample {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see langword="String" />
-representation of the current Exception. </para>
-        </returns>
         <example>
           <para>The following example causes a <see cref="T:System.IO.FileNotFoundException" /> exception and displays the result
    of calling <see langword="ToString" /> on that Exception.</para>
@@ -466,6 +462,10 @@ File name: "/Eccma/examples/FileTest.cs"
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the fully qualified name of this exception and possibly the error message, the name of the inner exception, and the stack trace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The fully qualified name of this exception and possibly the error message, the name of the inner exception, and the stack trace.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System.IO/FileStream.xml b/mcs/class/corlib/Documentation/en/System.IO/FileStream.xml
index 537ed8acd65..58f681f1766 100644
--- a/mcs/class/corlib/Documentation/en/System.IO/FileStream.xml
+++ b/mcs/class/corlib/Documentation/en/System.IO/FileStream.xml
@@ -914,9 +914,6 @@ class Directory {
         <Parameter Name="stateObject" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.IAsyncResult" /> that references the asynchronous read.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">The sum of <paramref name="offset and" /><paramref name="numBytes" /> is greater than the length of <paramref name="array" />.</exception>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="array" /> is <see langword="null" />.</exception>
@@ -943,6 +940,10 @@ class Directory {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous read operation. (Consider using <see cref="M:System.IO.FileStream.ReadAsync(System.Byte[],System.Int32,System.Int32,System.Threading.CancellationToken)" /> instead; see the Remarks section.)</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that references the asynchronous read.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer to read data into. </param>
         <param name="offset">
@@ -977,9 +978,6 @@ class Directory {
         <Parameter Name="stateObject" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.IAsyncResult" /> that references the asynchronous write.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">The sum of <paramref name="offset and " /><paramref name="numBytes" /> is greater than the length of <paramref name="array" />.</exception>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="array" /> is <see langword="null" />.</exception>
@@ -1003,6 +1001,10 @@ class Directory {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous write operation. (Consider using <see cref="M:System.IO.FileStream.WriteAsync(System.Byte[],System.Int32,System.Int32,System.Threading.CancellationToken)" /> instead; see the Remarks section.)</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that references the asynchronous write.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer containing data to write to the current stream.</param>
         <param name="offset">
@@ -1208,11 +1210,6 @@ the stream. To prevent data loss, always call <see langword="Close" /> on the hi
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Int32" /> containing the number of
-   bytes read from the stream. Returns 0 only if the end of the file has
-   been reached, otherwise, this method blocks until at least one byte is available.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="asyncResult" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -1232,6 +1229,10 @@ the stream. To prevent data loss, always call <see langword="Close" /> on the hi
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits for the pending asynchronous read operation to complete. (Consider using <see cref="M:System.IO.FileStream.ReadAsync(System.Byte[],System.Int32,System.Int32,System.Threading.CancellationToken)" /> instead; see the Remarks section.)</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes read from the stream, between 0 and the number of bytes you requested. Streams only return 0 at the end of the stream, otherwise, they should block until at least 1 byte is available.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />The reference to the pending asynchronous request to wait for. </param>
       </Docs>
@@ -1383,7 +1384,6 @@ the stream. To prevent data loss, always call <see langword="Close" /> on the hi
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When you call the <see cref="M:System.IO.FileStream.FlushAsync(System.Threading.CancellationToken)" /> method, the operating system I/O buffer is also flushed.</para>
@@ -1393,6 +1393,10 @@ the stream. To prevent data loss, always call <see langword="Close" /> on the hi
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously clears all buffers for this stream, causes any buffered data to be written to the underlying device, and monitors cancellation requests. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous flush operation. </para>
+        </returns>
         <param name="cancellationToken">
           <attribution license="cc4" from="Microsoft" modified="false" />The token to monitor for cancellation requests.</param>
       </Docs>
@@ -1410,7 +1414,6 @@ the stream. To prevent data loss, always call <see langword="Close" /> on the hi
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1422,6 +1425,10 @@ the stream. To prevent data loss, always call <see langword="Close" /> on the hi
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Security.AccessControl.FileSecurity" /> object that encapsulates the access control list (ACL) entries for the file described by the current <see cref="T:System.IO.FileStream" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that encapsulates the access control settings for the file described by the current <see cref="T:System.IO.FileStream" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Handle">
@@ -1632,10 +1639,6 @@ the stream. To prevent data loss, always call <see langword="Close" /> on the hi
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Int32" /> containing the total number of bytes
-   read into the buffer, or zero if the end of the stream is reached.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="array" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -1658,6 +1661,10 @@ the stream. To prevent data loss, always call <see langword="Close" /> on the hi
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a block of bytes from the stream and writes the data in a given buffer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The total number of bytes read into the buffer. This might be less than the number of bytes requested if that number of bytes are not currently available, or zero if the end of the stream is reached.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />When this method returns, contains the specified byte array with the values between <paramref name="offset" /> and (<paramref name="offset" /> + <paramref name="count" /> - 1<paramref name=")" /> replaced by the bytes read from the current source. </param>
         <param name="offset">
@@ -1684,7 +1691,6 @@ the stream. To prevent data loss, always call <see langword="Close" /> on the hi
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.IO.FileStream.ReadAsync(System.Byte[],System.Int32,System.Int32,System.Threading.CancellationToken)" /> method enables you to perform resource-intensive file operations without blocking the main thread. This performance consideration is particularly important in a win8_appname_long app or desktop_appname app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. The async methods are used in conjunction with the async and await keywords in Visual Basic and C#.</para>
@@ -1695,6 +1701,10 @@ the stream. To prevent data loss, always call <see langword="Close" /> on the hi
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously reads a sequence of bytes from the current stream, advances the position within the stream by the number of bytes read, and monitors cancellation requests.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous read operation. The value of the <paramref name="TResult" /> parameter contains the total number of bytes read into the buffer. The result value can be less than the number of bytes requested if the number of bytes currently available is less than the requested number, or it can be 0 (zero) if the end of the stream has been reached. </para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer to write the data into.</param>
         <param name="offset">
@@ -1720,10 +1730,6 @@ the stream. To prevent data loss, always call <see langword="Close" /> on the hi
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>The byte cast to a <see cref="T:System.Int32" />, or -1 if the end of
-   the stream has been reached.</para>
-        </returns>
         <exception cref="T:System.ObjectDisposedException">The current stream is closed.</exception>
         <exception cref="T:System.NotSupportedException">The current stream does not support reading.</exception>
         <remarks>
@@ -1737,6 +1743,10 @@ the stream. To prevent data loss, always call <see langword="Close" /> on the hi
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a byte from the file and advances the read position one byte.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The byte, cast to an <see cref="T:System.Int32" />, or -1 if the end of the stream has been reached.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1782,9 +1792,6 @@ the stream. To prevent data loss, always call <see langword="Close" /> on the hi
         <Parameter Name="origin" Type="System.IO.SeekOrigin" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int64" /> containing the new position in the stream.</para>
-        </returns>
         <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
         <exception cref="T:System.NotSupportedException">The stream does not support seeking.</exception>
         <exception cref="T:System.ArgumentException">Attempted seeking before the beginning of the stream or to more than one byte past the end of the stream.</exception>
@@ -1802,6 +1809,10 @@ the stream. To prevent data loss, always call <see langword="Close" /> on the hi
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the current position of this stream to the given value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new position in the stream.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />The point relative to <paramref name="origin" /> from which to begin seeking. </param>
         <param name="origin">
@@ -1981,7 +1992,6 @@ the stream. To prevent data loss, always call <see langword="Close" /> on the hi
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.IO.FileStream.WriteAsync(System.Byte[],System.Int32,System.Int32,System.Threading.CancellationToken)" /> method enables you to perform resource-intensive file operations without blocking the main thread. This performance consideration is particularly important in a win8_appname_long app or desktop_appname app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. The async methods are used in conjunction with the async and await keywords in Visual Basic and C#.</para>
@@ -1992,6 +2002,10 @@ the stream. To prevent data loss, always call <see langword="Close" /> on the hi
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously writes a sequence of bytes to the current stream, advances the current position within this stream by the number of bytes written, and monitors cancellation requests. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous write operation.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer to write data from. </param>
         <param name="offset">
diff --git a/mcs/class/corlib/Documentation/en/System.IO/MemoryStream.xml b/mcs/class/corlib/Documentation/en/System.IO/MemoryStream.xml
index 8b75c5c8b05..43337ac636c 100644
--- a/mcs/class/corlib/Documentation/en/System.IO/MemoryStream.xml
+++ b/mcs/class/corlib/Documentation/en/System.IO/MemoryStream.xml
@@ -467,12 +467,15 @@ be called successfully. </para>
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously reads all the bytes from the current stream and writes them to another stream, using a specified buffer size and cancellation token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous copy operation.</para>
+        </returns>
         <param name="destination">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream to which the contents of the current stream will be copied.</param>
         <param name="bufferSize">
@@ -550,7 +553,6 @@ be called successfully. </para>
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Because any data written to a <see cref="T:System.IO.MemoryStream" /> object is written into RAM, this method is redundant.</para>
@@ -561,6 +563,10 @@ be called successfully. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously clears all buffers for this stream, and monitors cancellation requests.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous flush operation.</para>
+        </returns>
         <param name="cancellationToken">
           <attribution license="cc4" from="Microsoft" modified="false" />The token to monitor for cancellation requests.</param>
       </Docs>
@@ -580,12 +586,6 @@ be called successfully. </para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Byte" /> array from which the current stream was created, or the
-   underlying array if a <see cref="T:System.Byte" />
-   array was not provided to the <see cref="T:System.IO.MemoryStream" />
-   constructor during construction of the current instance.</para>
-        </returns>
         <exception cref="T:System.UnauthorizedAccessException">The current instance was not created with a publicly visible buffer.</exception>
         <example>
           <para>The following example demonstrates that two calls to the <see cref="M:System.IO.MemoryStream.GetBuffer" />
@@ -639,6 +639,10 @@ public class MemoryStreamTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the array of unsigned bytes from which this stream was created.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The byte array from which this stream was created, or the underlying array if a byte array was not provided to the <see cref="T:System.IO.MemoryStream" /> constructor during construction of the current instance.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -726,11 +730,6 @@ public class MemoryStreamTest {
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Int32" /> that specifies the total number of bytes
-   written into the buffer, or zero if the end of the stream is
-   reached before any bytes are read.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="buffer" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -785,6 +784,10 @@ public class MemoryStreamTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a block of bytes from the current stream and writes the data to a buffer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The total number of bytes written into the buffer. This can be less than the number of bytes requested if that number of bytes are not currently available, or zero if the end of the stream is reached before any bytes are read.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />When this method returns, contains the specified byte array with the values between <paramref name="offset" /> and (<paramref name="offset" /> + <paramref name="count" /> - 1) replaced by the characters read from the current stream. </param>
         <param name="offset">
@@ -811,7 +814,6 @@ public class MemoryStreamTest {
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the operation is canceled before it completes, the returned task contains the <see cref="F:System.Threading.Tasks.TaskStatus.Canceled" /> value for the <see cref="P:System.Threading.Tasks.Task.Status" /> property.</para>
@@ -821,6 +823,10 @@ public class MemoryStreamTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously reads a sequence of bytes from the current stream, advances the position within the stream by the number of bytes read, and monitors cancellation requests.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous read operation. The value of the <paramref name="TResult" /> parameter contains the total number of bytes read into the buffer. The result value can be less than the number of bytes requested if the number of bytes currently available is less than the requested number, or it can be 0 (zero) if the end of the stream has been reached. </para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer to write the data into.</param>
         <param name="offset">
@@ -846,10 +852,6 @@ public class MemoryStreamTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> The byte cast to a <see cref="T:System.Int32" />, or -1 if the end of the stream has been reached.
-   </para>
-        </returns>
         <exception cref="T:System.ObjectDisposedException"> The current stream is closed.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -860,6 +862,10 @@ public class MemoryStreamTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a byte from the current stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The byte cast to a <see cref="T:System.Int32" />, or -1 if the end of the stream has been reached.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -881,10 +887,6 @@ public class MemoryStreamTest {
         <Parameter Name="loc" Type="System.IO.SeekOrigin" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int64" /> containing the new position within the stream, calculated by
-   combining the seek reference point and the offset.</para>
-        </returns>
         <exception cref="T:System.IO.IOException">Seeking is attempted before the beginning of  the stream.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="offset" /> is greater than the maximum length of <see cref="T:System.IO.MemoryStream" />.</exception>
@@ -901,6 +903,10 @@ public class MemoryStreamTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the position within the current stream to the specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new position within the stream, calculated by combining the initial reference point and the offset.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />The new position within the stream. This is relative to the <paramref name="loc" /> parameter, and can be positive or negative. </param>
         <param name="loc">
@@ -964,10 +970,6 @@ public class MemoryStreamTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A new <see cref="T:System.Byte" /> array.
-   </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method omits unused bytes in <see cref="T:System.IO.MemoryStream" /> from the array. To get the entire buffer, use the <see cref="M:System.IO.MemoryStream.GetBuffer" /> method.</para>
@@ -980,6 +982,10 @@ public class MemoryStreamTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes the stream contents to a byte array, regardless of the <see cref="P:System.IO.MemoryStream.Position" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new byte array.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1050,7 +1056,6 @@ public class MemoryStreamTest {
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the operation is canceled before it completes, the returned task contains the <see cref="F:System.Threading.Tasks.TaskStatus.Canceled" /> value for the <see cref="P:System.Threading.Tasks.Task.Status" /> property.</para>
@@ -1060,6 +1065,10 @@ public class MemoryStreamTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously writes a sequence of bytes to the current stream, advances the current position within this stream by the number of bytes written, and monitors cancellation requests.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous write operation.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer to write data from.</param>
         <param name="offset">
diff --git a/mcs/class/corlib/Documentation/en/System.IO/Path.xml b/mcs/class/corlib/Documentation/en/System.IO/Path.xml
index ae78a12cb01..cbf464fca5f 100644
--- a/mcs/class/corlib/Documentation/en/System.IO/Path.xml
+++ b/mcs/class/corlib/Documentation/en/System.IO/Path.xml
@@ -102,12 +102,6 @@
         <Parameter Name="extension" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" />
-containing the modified path information.</para>
-          <para>Platforms that do not support this feature
-   return <paramref name="path" /> unmodified.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="path" /> contains one or more implementation-specific invalid characters.</exception>
         <remarks>
@@ -125,6 +119,11 @@ containing the modified path information.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Changes the extension of a path string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modified path information.</para>
+          <para>On Windows-based desktop platforms, if <paramref name="path" /> is null or an empty string (""), the path information is returned unmodified. If <paramref name="extension" /> is null, the returned string contains the specified path with its extension removed. If <paramref name="path" /> has no extension, and <paramref name="extension" /> is not null, the returned path string contains <paramref name="extension" /> appended to the end of <paramref name="path" />.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path information to modify. The path cannot contain any of the characters defined in <see cref="M:System.IO.Path.GetInvalidPathChars" />. </param>
         <param name="extension">
@@ -152,7 +151,6 @@ containing the modified path information.</para>
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -165,6 +163,10 @@ containing the modified path information.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Combines an array of strings into a path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The combined paths.</para>
+        </returns>
         <param name="paths">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of parts of the path.</param>
       </Docs>
@@ -187,13 +189,6 @@ containing the modified path information.</para>
         <Parameter Name="path2" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.String" /> containing
-<paramref name="path1" /> followed by <paramref name="path2" />.
-   If one of the specified paths is a zero length string, this method returns the
-   other path. If <paramref name="path2" /> contains an absolute path, this method returns
-<paramref name="path2" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="path1" /> or <paramref name="path2" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -245,6 +240,10 @@ path2));
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Combines two strings into a path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The combined paths. If one of the specified paths is a zero-length string, this method returns the other path. If <paramref name="path2" /> contains an absolute path, this method returns <paramref name="path2" />.</para>
+        </returns>
         <param name="path1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first path to combine. </param>
         <param name="path2">
@@ -268,7 +267,6 @@ path2));
         <Parameter Name="path3" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -283,6 +281,10 @@ path2));
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Combines three strings into a path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The combined paths.</para>
+        </returns>
         <param name="path1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first path to combine. </param>
         <param name="path2">
@@ -308,7 +310,6 @@ path2));
         <Parameter Name="path4" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -323,6 +324,10 @@ path2));
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Combines four strings into a path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The combined paths.</para>
+        </returns>
         <param name="path1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first path to combine. </param>
         <param name="path2">
@@ -377,12 +382,6 @@ path2));
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing directory information for <paramref name="path" />, or
-<see langword="null" /> if <paramref name="path" /> denotes a root directory, is 
-   the empty string, or is <see langword="null." /> Returns <see cref="F:System.String.Empty" /> if path
-   does not contain directory information.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>
             <paramref name="path" /> contains one or more implementation-specific invalid characters.</para>
@@ -427,6 +426,10 @@ class GetDirectoryTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the directory information for the specified path string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Directory information for <paramref name="path" />, or null if <paramref name="path" /> denotes a root directory or is null. Returns <see cref="F:System.String.Empty" /> if <paramref name="path" /> does not contain directory information.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path of a file or directory. </param>
       </Docs>
@@ -449,17 +452,6 @@ class GetDirectoryTest {
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing the extension of <paramref name="path," /><see langword="null" /> ,
-or <see cref="F:System.String.Empty" />. If <paramref name="path" /> is
-<see langword="null" />, returns <see langword="null" />. If path does not have extension information, 
-returns <see cref="F:System.String.Empty" />.</para>
-          <para>The extension returned by this method includes the
-      implementation-specific extension separator character used to separate the extension
-      from the rest of the path.</para>
-          <para>Platforms that do not
-      support this feature return <paramref name="path" /> unmodified.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>
             <paramref name="path" /> contains one or more implementation-specific invalid characters.</para>
@@ -507,6 +499,10 @@ class GetDirectoryTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the extension of the specified path string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The extension of the specified path (including the period "."), or null, or <see cref="F:System.String.Empty" />. If <paramref name="path" /> is null, <see cref="M:System.IO.Path.GetExtension(System.String)" /> returns null. If <paramref name="path" /> does not have extension information, <see cref="M:System.IO.Path.GetExtension(System.String)" /> returns <see cref="F:System.String.Empty" />.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path string from which to get the extension. </param>
       </Docs>
@@ -529,14 +525,6 @@ class GetDirectoryTest {
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> consisting of the characters
-   after the last directory character in <paramref name="path" />. If the last character
-   of <paramref name="path" /> is a directory separator character, returns <see cref="F:System.String.Empty" />. If <paramref name="path" /> is <see langword="null" />, returns
-<see langword="null" />.</para>
-          <para>Platforms that do not support this feature
-   return <paramref name="path" /> unmodified.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="path" /> contains one or more implementation-specific invalid characters.</exception>
         <example>
@@ -578,6 +566,10 @@ class FileNameTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the file name and extension of the specified path string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The characters after the last directory character in <paramref name="path" />. If the last character of <paramref name="path" /> is a directory or volume separator character, this method returns <see cref="F:System.String.Empty" />. If <paramref name="path" /> is null, this method returns null.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path string from which to obtain the file name and extension. </param>
       </Docs>
@@ -600,13 +592,6 @@ class FileNameTest {
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> consisting of the
-   string returned by <see cref="M:System.IO.Path.GetFileName(System.String)" /> , minus
-   the implementation-specific extension separator character and extension. Platforms that do not support this feature
-   return <paramref name="path" />
-   unmodified.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="path" /> contains one or more implementation-specific invalid characters.</exception>
         <remarks>
@@ -618,6 +603,10 @@ class FileNameTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the file name of the specified path string without the extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string returned by <see cref="M:System.IO.Path.GetFileName(System.String)" />, minus the last period (.) and all characters following it.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path of the file. </param>
       </Docs>
@@ -640,9 +629,6 @@ class FileNameTest {
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.String" /> containing the fully qualified (absolute) location of <paramref name="path" /> .</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>
             <paramref name="path " />is a zero-length string, contains only white space, or contains one or more implementation-specific invalid characters.</para>
@@ -699,6 +685,10 @@ Path.GetFullPath(pathString));
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the absolute path for the specified path string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The fully qualified location of <paramref name="path" />, such as "C:\MyFile.txt".</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The file or directory for which to obtain absolute path information. </param>
       </Docs>
@@ -717,7 +707,6 @@ Path.GetFullPath(pathString));
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -727,6 +716,10 @@ Path.GetFullPath(pathString));
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array containing the characters that are not allowed in file names.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array containing the characters that are not allowed in file names.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetInvalidPathChars">
@@ -742,7 +735,6 @@ Path.GetFullPath(pathString));
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -752,6 +744,10 @@ Path.GetFullPath(pathString));
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array containing the characters that are not allowed in path names.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array containing the characters that are not allowed in path names.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetPathRoot">
@@ -771,14 +767,6 @@ Path.GetFullPath(pathString));
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing the root directory of <paramref name="path" />, or
-<see langword="null" /> if <paramref name="path" /> is 
-<see langword="null" /> . Returns <see cref="F:System.String.Empty" />
-   if the specified path does not contain root information. </para>
-          <para>Platforms that do not support this feature
-   return <paramref name="path" /> unmodified.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="path" /> contains one or more implementation-specific invalid characters or is equal to <see cref="F:System.String.Empty" /> . </exception>
         <example>
@@ -843,6 +831,10 @@ class GetPathRootTest
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the root directory information of the specified path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The root directory of <paramref name="path" />, such as "C:\", or null if <paramref name="path" /> is null, or an empty string if <paramref name="path" /> does not contain root directory information.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path from which to obtain root directory information. </param>
       </Docs>
@@ -861,7 +853,6 @@ class GetPathRootTest
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -871,6 +862,10 @@ class GetPathRootTest
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a random folder name or file name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A random folder name or file name.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetTempFileName">
@@ -888,12 +883,6 @@ class GetPathRootTest
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.String" /> containing the name of the temporary file.
-   </para>
-          <para>Platforms that do not support this feature
-   return <see cref="F:System.String.Empty" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates a temporary file with a .TMP file extension. The temporary file is created within the user’s temporary folder, which is the path returned by the <see cref="M:System.IO.Path.GetTempPath" /> method.</para>
@@ -905,6 +894,10 @@ class GetPathRootTest
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a uniquely named, zero-byte temporary file on disk and returns the full path of that file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The full path of the temporary file.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -923,13 +916,6 @@ class GetPathRootTest
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.String" /> containing the full directory name of a temporary
-   directory.</para>
-          <para>The information returned by this method is
-   implementation-specific. Platforms that do not support this feature return
-<see cref="F:System.String.Empty" />.</para>
-        </returns>
         <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
         <permission cref="T:System.Security.Permissions.EnvironmentPermission">Requires unrestricted access to environment variables. See <see cref="F:System.Security.Permissions.PermissionState.Unrestricted" />.</permission>
         <remarks>
@@ -954,6 +940,10 @@ class GetPathRootTest
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the path of the current user's temporary folder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The path to the temporary folder, ending with a backslash.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -974,13 +964,6 @@ class GetPathRootTest
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if 
-<paramref name="path" /> includes a file extension.</para>
-          <para>Platforms that do not support this feature
-   return <see langword="false" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="path" /> contains one or more implementation-specific invalid characters. </exception>
         <remarks>
@@ -992,6 +975,10 @@ class GetPathRootTest
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a path includes a file name extension.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the characters that follow the last directory separator (\\ or /) or volume separator (:) in the path include a period (.) followed by one or more characters; otherwise, false.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to search for an extension. </param>
       </Docs>
@@ -1045,14 +1032,6 @@ class GetPathRootTest
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if
-<paramref name="path" /> contains an absolute path; <see langword="false" /> 
-if <paramref name="path" /> contains relative path information.</para>
-          <para>Platforms that do not support this feature
-   return <see langword="false" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="path" /> contains one or more implementation-specific invalid characters.</exception>
         <remarks>
@@ -1065,6 +1044,10 @@ if <paramref name="path" /> contains relative path information.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified path string contains a root.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="path" /> contains a root; otherwise, false.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path to test. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.IO/Stream.xml b/mcs/class/corlib/Documentation/en/System.IO/Stream.xml
index a88b33560a8..41a3d0e6cc2 100644
--- a/mcs/class/corlib/Documentation/en/System.IO/Stream.xml
+++ b/mcs/class/corlib/Documentation/en/System.IO/Stream.xml
@@ -104,11 +104,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.IAsyncResult" /> that contains
-   information about the asynchronous read operation, which could still
-   be pending.</para>
-        </returns>
         <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
         <exception cref="T:System.NotSupportedException">The current <see cref="T:System.IO.Stream" /> does not support reading.</exception>
         <exception cref="T:System.ObjectDisposedException">The stream is closed.</exception>
@@ -126,6 +121,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous read operation. (Consider using <see cref="M:System.IO.Stream.ReadAsync(System.Byte[],System.Int32,System.Int32)" /> instead; see the Remarks section.)</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IAsyncResult" /> that represents the asynchronous read, which could still be pending.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer to read the data into. </param>
         <param name="offset">
@@ -160,10 +159,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.IAsyncResult" />
-that represents the asynchronous write, which could still be pending.</para>
-        </returns>
         <exception cref="T:System.NotSupportedException">The current <see cref="T:System.IO.Stream" /> does not support writing.</exception>
         <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
         <exception cref="T:System.ObjectDisposedException">The stream is closed.</exception>
@@ -181,6 +176,10 @@ that represents the asynchronous write, which could still be pending.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an asynchronous write operation. (Consider using <see cref="M:System.IO.Stream.WriteAsync(System.Byte[],System.Int32,System.Int32)" /> instead; see the Remarks section.)</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An IAsyncResult that represents the asynchronous write, which could still be pending.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer to write data from. </param>
         <param name="offset">
@@ -416,7 +415,6 @@ that represents the asynchronous write, which could still be pending.</para>
         <Parameter Name="destination" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.IO.Stream.CopyToAsync(System.IO.Stream)" /> method enables you to perform resource-intensive I/O operations without blocking the main thread. This performance consideration is particularly important in a win8_appname_long app or desktop_appname app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. The async methods are used in conjunction with the async and await keywords in Visual Basic and C#.</para>
@@ -426,6 +424,10 @@ that represents the asynchronous write, which could still be pending.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously reads the bytes from the current stream and writes them to another stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous copy operation.</para>
+        </returns>
         <param name="destination">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream to which the contents of the current stream will be copied.</param>
       </Docs>
@@ -445,7 +447,6 @@ that represents the asynchronous write, which could still be pending.</para>
         <Parameter Name="bufferSize" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.IO.Stream.CopyToAsync(System.IO.Stream,System.Int32)" /> method enables you to perform resource-intensive I/O operations without blocking the main thread. This performance consideration is particularly important in a win8_appname_long app or desktop_appname app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. The async methods are used in conjunction with the async and await keywords in Visual Basic and C#.</para>
@@ -456,6 +457,10 @@ that represents the asynchronous write, which could still be pending.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously reads the bytes from the current stream and writes them to another stream, using a specified buffer size.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous copy operation.</para>
+        </returns>
         <param name="destination">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream to which the contents of the current stream will be copied.</param>
         <param name="bufferSize">
@@ -478,7 +483,6 @@ that represents the asynchronous write, which could still be pending.</para>
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.IO.Stream.CopyToAsync(System.IO.Stream,System.Int32,System.Threading.CancellationToken)" /> method enables you to perform resource-intensive I/O operations without blocking the main thread. This performance consideration is particularly important in a win8_appname_long app or desktop_appname app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. The async methods are used in conjunction with the async and await keywords in Visual Basic and C#.</para>
@@ -490,6 +494,10 @@ that represents the asynchronous write, which could still be pending.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously reads the bytes from the current stream and writes them to another stream, using a specified buffer size and cancellation token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous copy operation.</para>
+        </returns>
         <param name="destination">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream to which the contents of the current stream will be copied.</param>
         <param name="bufferSize">
@@ -518,9 +526,6 @@ that represents the asynchronous write, which could still be pending.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A reference to the allocated <see cref="T:System.Threading.WaitHandle" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When called for the first time, the current method creates a WaitHandle object and returns it. On subsequent calls, CreateWaitHandle returns a reference to a new wait handle.</para>
@@ -530,6 +535,10 @@ that represents the asynchronous write, which could still be pending.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Allocates a <see cref="T:System.Threading.WaitHandle" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to the allocated WaitHandle.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -605,12 +614,6 @@ that represents the asynchronous write, which could still be pending.</para>
         <Parameter Name="asyncResult" Type="System.IAsyncResult" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Int32" /> that indicates the number of bytes read from the stream, 
-   between 0 and the number of bytes specified via the <see cref="M:System.IO.Stream.BeginRead(System.Byte[],System.Int32,System.Int32,System.AsyncCallback,System.Object)" /> parameter <paramref name="count" />. Streams only return
-0 at the end of the stream, otherwise, they block until at
-least 1 byte is available.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="asyncResult" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -626,6 +629,10 @@ least 1 byte is available.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits for the pending asynchronous read to complete. (Consider using <see cref="M:System.IO.Stream.ReadAsync(System.Byte[],System.Int32,System.Int32)" /> instead; see the Remarks section.)</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes read from the stream, between zero (0) and the number of bytes you requested. Streams return zero (0) only at the end of the stream, otherwise, they should block until at least one byte is available.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />The reference to the pending asynchronous request to finish. </param>
       </Docs>
@@ -707,7 +714,6 @@ least 1 byte is available.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If a derived class, such as <see cref="T:System.IO.Compression.DeflateStream" /> or <see cref="T:System.IO.Compression.GZipStream" />, does not flush the buffer in its implementation of the <see cref="M:System.IO.Stream.Flush" /> method, the <see cref="M:System.IO.Stream.FlushAsync" /> method will not flush the buffer.</para>
@@ -716,6 +722,10 @@ least 1 byte is available.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously clears all buffers for this stream and causes any buffered data to be written to the underlying device.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous flush operation.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="FlushAsync">
@@ -732,7 +742,6 @@ least 1 byte is available.</para>
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the operation is canceled before it completes, the returned task contains the <see cref="F:System.Threading.Tasks.TaskStatus.Canceled" /> value for the <see cref="P:System.Threading.Tasks.Task.Status" /> property. </para>
@@ -742,6 +751,10 @@ least 1 byte is available.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously clears all buffers for this stream, causes any buffered data to be written to the underlying device, and monitors cancellation requests.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous flush operation.</para>
+        </returns>
         <param name="cancellationToken">
           <attribution license="cc4" from="Microsoft" modified="false" />The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None" />.</param>
       </Docs>
@@ -888,11 +901,6 @@ seeking.</block>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Int32" /> that specifies the total number of bytes read into the
-   buffer, or zero if the end of the stream has been
-   reached before any data can be read.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">(<paramref name="offset" /> + <paramref name="count" /> - 1) is greater than the length of <paramref name="buffer" />.</exception>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="buffer" /> is <see langword="null" />.</exception>
@@ -911,6 +919,10 @@ seeking.</block>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, reads a sequence of bytes from the current stream and advances the position within the stream by the number of bytes read.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The total number of bytes read into the buffer. This can be less than the number of bytes requested if that many bytes are not currently available, or zero (0) if the end of the stream has been reached.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of bytes. When this method returns, the buffer contains the specified byte array with the values between <paramref name="offset" /> and (<paramref name="offset" /> + <paramref name="count" /> - 1) replaced by the bytes read from the current source. </param>
         <param name="offset">
@@ -936,7 +948,6 @@ seeking.</block>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.IO.Stream.ReadAsync(System.Byte[],System.Int32,System.Int32)" /> method enables you to perform resource-intensive I/O operations without blocking the main thread. This performance consideration is particularly important in a win8_appname_long app or desktop_appname app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. The async methods are used in conjunction with the async and await keywords in Visual Basic and C#.</para>
@@ -946,6 +957,10 @@ seeking.</block>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously reads a sequence of bytes from the current stream and advances the position within the stream by the number of bytes read.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous read operation. The value of the <paramref name="TResult" /> parameter contains the total number of bytes read into the buffer. The result value can be less than the number of bytes requested if the number of bytes currently available is less than the requested number, or it can be 0 (zero) if the end of the stream has been reached. </para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer to write the data into.</param>
         <param name="offset">
@@ -971,7 +986,6 @@ seeking.</block>
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.IO.Stream.ReadAsync(System.Byte[],System.Int32,System.Int32,System.Threading.CancellationToken)" /> method enables you to perform resource-intensive I/O operations without blocking the main thread. This performance consideration is particularly important in a win8_appname_long app or desktop_appname app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. The async methods are used in conjunction with the async and await keywords in Visual Basic and C#.</para>
@@ -983,6 +997,10 @@ seeking.</block>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously reads a sequence of bytes from the current stream, advances the position within the stream by the number of bytes read, and monitors cancellation requests.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous read operation. The value of the <paramref name="TResult" /> parameter contains the total number of bytes read into the buffer. The result value can be less than the number of bytes requested if the number of bytes currently available is less than the requested number, or it can be 0 (zero) if the end of the stream has been reached. </para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer to write the data into.</param>
         <param name="offset">
@@ -1008,10 +1026,6 @@ seeking.</block>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>The unsigned byte cast to a <see cref="T:System.Int32" /> , or -1 if at the end
-   of the stream.</para>
-        </returns>
         <exception cref="T:System.IO.IOException">An I/O error has occurred.</exception>
         <exception cref="T:System.NotSupportedException">The stream does not support reading.</exception>
         <exception cref="T:System.ObjectDisposedException">The stream is closed. </exception>
@@ -1024,6 +1038,10 @@ seeking.</block>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a byte from the stream and advances the position within the stream by one byte, or returns -1 if at the end of the stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The unsigned byte cast to an Int32, or -1 if at the end of the stream.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1071,9 +1089,6 @@ seeking.</block>
         <Parameter Name="origin" Type="System.IO.SeekOrigin" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int64" /> that specifies the new position within the current stream.</para>
-        </returns>
         <exception cref="T:System.NotSupportedException">The stream does not support seeking, such as if the stream is constructed from a pipe or console output.</exception>
         <exception cref="T:System.ObjectDisposedException">The stream is closed.</exception>
         <exception cref="T:System.IO.IOException">An I/O error has occurred.</exception>
@@ -1088,6 +1103,10 @@ seeking.</block>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, sets the position within the current stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new position within the current stream.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />A byte offset relative to the <paramref name="origin" /> parameter. </param>
         <param name="origin">
@@ -1145,7 +1164,6 @@ seeking.</block>
         <Parameter Name="stream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1155,6 +1173,10 @@ seeking.</block>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a thread-safe (synchronized) wrapper around the specified <see cref="T:System.IO.Stream" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A thread-safe <see cref="T:System.IO.Stream" /> object.</para>
+        </returns>
         <param name="stream">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.Stream" /> object to synchronize.</param>
       </Docs>
@@ -1235,7 +1257,6 @@ seeking.</block>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.IO.Stream.WriteAsync(System.Byte[],System.Int32,System.Int32)" /> method enables you to perform resource-intensive I/O operations without blocking the main thread. This performance consideration is particularly important in a win8_appname_long app or desktop_appname app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. The async methods are used in conjunction with the async and await keywords in Visual Basic and C#.</para>
@@ -1245,6 +1266,10 @@ seeking.</block>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous write operation.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer to write data from.</param>
         <param name="offset">
@@ -1270,7 +1295,6 @@ seeking.</block>
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.IO.Stream.WriteAsync(System.Byte[],System.Int32,System.Int32,System.Threading.CancellationToken)" /> method enables you to perform resource-intensive I/O operations without blocking the main thread. This performance consideration is particularly important in a win8_appname_long app or desktop_appname app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. The async methods are used in conjunction with the async and await keywords in Visual Basic and C#.</para>
@@ -1282,6 +1306,10 @@ seeking.</block>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously writes a sequence of bytes to the current stream, advances the current position within this stream by the number of bytes written, and monitors cancellation requests.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous write operation.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer to write data from.</param>
         <param name="offset">
diff --git a/mcs/class/corlib/Documentation/en/System.IO/StreamReader.xml b/mcs/class/corlib/Documentation/en/System.IO/StreamReader.xml
index edba2735fd3..f2c84027d99 100644
--- a/mcs/class/corlib/Documentation/en/System.IO/StreamReader.xml
+++ b/mcs/class/corlib/Documentation/en/System.IO/StreamReader.xml
@@ -737,11 +737,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> The next character from the character source
-      as a <see cref="T:System.Int32" /> , or -1 if at the end of the
-      stream.</para>
-        </returns>
         <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -753,6 +748,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the next available character but does not consume it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer representing the next character to be read, or -1 if there are no characters to be read or if the stream does not support seeking.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -771,11 +770,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>The next character from the character source represented
-      as a <see cref="T:System.Int32" /> , or -1 if at the end
-      of the stream.</para>
-        </returns>
         <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -787,6 +781,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the next character from the input stream and advances the character position by one character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The next character from the input stream represented as an <see cref="T:System.Int32" /> object, or -1 if no more characters are available.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -809,12 +807,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the number of characters that have been read, or zero if
-   there are no more characters left to read. Can be less than <paramref name="count" />
-   if the end
-   of the stream has been reached.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="buffer" /> .Length - <paramref name="index" /> &lt; <paramref name="count" /> .</exception>
         <exception cref="T:System.ArgumentNullException">
@@ -838,6 +830,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a specified maximum of characters from the current stream into a buffer, beginning at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of characters that have been read, or 0 if at the end of the stream and no data was read. The number will be less than or equal to the <paramref name="count" /> parameter, depending on whether the data is available within the stream.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />When this method returns, contains the specified character array with the values between <paramref name="index" /> and (<paramref name="index + count - 1" />) replaced by the characters read from the current source. </param>
         <param name="index">
@@ -863,7 +859,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The task completes after either the number of characters specified by the <paramref name="count" /> parameter are read or the end of the stream is reached.</para>
@@ -872,6 +867,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a specified maximum number of characters from the current stream asynchronously and writes the data to a buffer, beginning at the specified index. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous read operation. The value of the <paramref name="TResult" /> parameter contains the total number of bytes read into the buffer. The result value can be less than the number of bytes requested if the number of bytes currently available is less than the requested number, or it can be 0 (zero) if the end of the stream has been reached.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />When this method returns, contains the specified character array with the values between <paramref name="index" /> and (<paramref name="index" /> + <paramref name="count" /> - 1) replaced by the characters read from the current source.</param>
         <param name="index">
@@ -896,7 +895,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The position of the underlying stream is advanced by the number of characters that were read into <paramref name="buffer" />.</para>
@@ -906,6 +904,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a specified maximum number of characters from the current stream and writes the data to a buffer, beginning at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of characters that have been read. The number will be less than or equal to <paramref name="count" />, depending on whether all input characters have been read.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />When this method returns, contains the specified character array with the values between <paramref name="index" /> and (<paramref name="index + count - 1" />) replaced by the characters read from the current source.</param>
         <param name="index">
@@ -930,7 +932,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The task does not complete until either the number of characters specified by the <paramref name="count" /> parameter are read, or the end of the stream has been reached.</para>
@@ -939,6 +940,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a specified maximum number of characters from the current stream asynchronously and writes the data to a buffer, beginning at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous read operation. The value of the <paramref name="TResult" /> parameter contains the total number of bytes read into the buffer. The result value can be less than the number of bytes requested if the number of bytes currently available is less than the requested number, or it can be 0 (zero) if the end of the stream has been reached.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />When this method returns, contains the specified character array with the values between <paramref name="index" /> and (<paramref name="index" /> + <paramref name="count" /> - 1) replaced by the characters read from the current source.</param>
         <param name="index">
@@ -962,11 +967,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing the next line from the input stream, or
-<see langword="null" /> if the end of the input
-   stream is reached.</para>
-        </returns>
         <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
         <exception cref="T:System.OutOfMemoryException">There is insufficient memory to allocate a buffer for the returned string.</exception>
         <remarks>
@@ -980,6 +980,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a line of characters from the current stream and returns the data as a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The next line from the input stream, or null if the end of the input stream is reached.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -995,12 +999,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a line of characters asynchronously from the current stream and returns the data as a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous read operation. The value of the <paramref name="TResult" /> parameter contains the next line from the stream, or is null if all the characters have been read.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadToEnd">
@@ -1018,10 +1025,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the rest of the stream as a string, from the current
-   position to the end. If the current position is at the end of the stream, returns the empty string ("").</para>
-        </returns>
         <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
         <exception cref="T:System.OutOfMemoryException">There is insufficient memory to allocate a buffer for the returned string.</exception>
         <remarks>
@@ -1039,6 +1042,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads all characters from the current position to the end of the stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The rest of the stream as a string, from the current position to the end. If the current position is at the end of the stream, returns an empty string ("").</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1054,12 +1061,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads all characters from the current position to the end of the stream asynchronously and returns them as one string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous read operation. The value of the <paramref name="TResult" /> parameter contains a string with the characters from the current position to the end of the stream.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.IO/StreamWriter.xml b/mcs/class/corlib/Documentation/en/System.IO/StreamWriter.xml
index f5fe7e216b5..2e915755f76 100644
--- a/mcs/class/corlib/Documentation/en/System.IO/StreamWriter.xml
+++ b/mcs/class/corlib/Documentation/en/System.IO/StreamWriter.xml
@@ -631,12 +631,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clears all buffers for this stream asynchronously and causes any buffered data to be written to the underlying device.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous flush operation.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Null">
@@ -836,12 +839,15 @@
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes a character to the stream asynchronously.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous write operation.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to write to the stream.</param>
       </Docs>
@@ -860,12 +866,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes a string to the stream asynchronously.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous write operation.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to write to the stream. If <paramref name="value" /> is null, nothing is written.</param>
       </Docs>
@@ -886,12 +895,15 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes a subarray of characters to the stream asynchronously.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous write operation.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />A character array that contains the data to write.</param>
         <param name="index">
@@ -912,7 +924,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The line terminator is defined by the <see cref="P:System.IO.TextWriter.NewLine" /> property. </para>
@@ -921,6 +932,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes a line terminator asynchronously to the stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous write operation.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="WriteLineAsync">
@@ -937,7 +952,6 @@
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The line terminator is defined by the <see cref="P:System.IO.TextWriter.NewLine" /> property. </para>
@@ -946,6 +960,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes a character followed by a line terminator asynchronously to the stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous write operation.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to write to the stream.</param>
       </Docs>
@@ -964,7 +982,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The line terminator is defined by the <see cref="P:System.IO.TextWriter.NewLine" /> property. </para>
@@ -973,6 +990,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes a string followed by a line terminator asynchronously to the stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous write operation.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to write. If the value is null, only a line terminator is written. </param>
       </Docs>
@@ -993,7 +1014,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The line terminator is defined by the <see cref="P:System.IO.TextWriter.NewLine" /> property. </para>
@@ -1002,6 +1022,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes a subarray of characters followed by a line terminator asynchronously to the stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous write operation.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The character array to write data from.</param>
         <param name="index">
diff --git a/mcs/class/corlib/Documentation/en/System.IO/StringReader.xml b/mcs/class/corlib/Documentation/en/System.IO/StringReader.xml
index d6bc4625140..e8463db27b2 100644
--- a/mcs/class/corlib/Documentation/en/System.IO/StringReader.xml
+++ b/mcs/class/corlib/Documentation/en/System.IO/StringReader.xml
@@ -374,10 +374,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>The next character to be read as a <see cref="T:System.Int32" /> , or -1 if no more characters are
-   available.</para>
-        </returns>
         <exception cref="T:System.ObjectDisposedException">The current reader is closed.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -444,6 +440,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the next available character but does not consume it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer representing the next character to be read, or -1 if no more characters are available or the stream does not support seeking.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -462,11 +462,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>The next character from the underlying string as a 
-   <see cref="T:System.Int32" /> , or -1 if no more
-      characters are available.</para>
-        </returns>
         <exception cref="T:System.ObjectDisposedException">The current reader is closed.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -595,6 +590,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the next character from the input string and advances the character position by one character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The next character from the underlying string, or -1 if no more characters are available.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -617,10 +616,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Int32" /> containing the total number of characters read into the
-   buffer, or zero if the end of the underlying string has been reached.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="buffer " /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">(<paramref name="index" /> + <paramref name="count" /> ) &gt; <paramref name="buffer" /><see langword="." />Length.</exception>
@@ -761,6 +756,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a block of characters from the input string and advances the character position by <paramref name="count" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The total number of characters read into the buffer. This can be less than the number of characters requested if that many characters are not currently available, or zero if the end of the underlying string has been reached.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />When this method returns, contains the specified character array with the values between <paramref name="index" /> and (<paramref name="index" /> + <paramref name="count" /> - 1) replaced by the characters read from the current source. </param>
         <param name="index">
@@ -786,7 +785,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The task completes after either the number of characters specified by the <paramref name="count" /> parameter are read or the end of the string is reached. </para>
@@ -795,6 +793,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a specified maximum number of characters from the current string asynchronously and writes the data to a buffer, beginning at the specified index. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous read operation. The value of the <paramref name="TResult" /> parameter contains the total number of bytes read into the buffer. The result value can be less than the number of bytes requested if the number of bytes currently available is less than the requested number, or it can be 0 (zero) if the end of the string has been reached.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />When this method returns, contains the specified character array with the values between <paramref name="index" /> and (<paramref name="index" /> + <paramref name="count" /> - 1) replaced by the characters read from the current source.</param>
         <param name="index">
@@ -819,7 +821,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The task does not complete until either the number of characters specified by the <paramref name="count" /> parameter are read, or the end of the string has been reached.</para>
@@ -828,6 +829,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a specified maximum number of characters from the current string asynchronously and writes the data to a buffer, beginning at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous read operation. The value of the <paramref name="TResult" /> parameter contains the total number of bytes read into the buffer. The result value can be less than the number of bytes requested if the number of bytes currently available is less than the requested number, or it can be 0 (zero) if the end of the string has been reached.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />When this method returns, contains the specified character array with the values between <paramref name="index" /> and (<paramref name="index" /> + <paramref name="count" /> - 1) replaced by the characters read from the current source.</param>
         <param name="index">
@@ -851,13 +856,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.String" /> containing the next line from the underlying string, or
-<see langword="null " />
-if the end of
-the underlying string is reached.
-</para>
-        </returns>
         <exception cref="T:System.ObjectDisposedException">The current reader is closed.</exception>
         <exception cref="T:System.OutOfMemoryException">There is insufficient memory to allocate a buffer for the returned string.</exception>
         <remarks>
@@ -989,6 +987,10 @@ the underlying string is reached.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a line of characters from the current string and returns the data as a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The next line from the current string, or null if the end of the string is reached.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1004,12 +1006,15 @@ the underlying string is reached.
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a line of characters asynchronously from the current string and returns the data as a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous read operation. The value of the <paramref name="TResult" /> parameter contains the next line from the string reader, or is null if all the characters have been read.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadToEnd">
@@ -1027,10 +1032,6 @@ the underlying string is reached.
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.String" /> containing the content from the current position to the end of the underlying
-   string.</para>
-        </returns>
         <exception cref="T:System.ObjectDisposedException">The current reader is closed.</exception>
         <exception cref="T:System.OutOfMemoryException">There is insufficient memory to allocate a buffer for the returned string.</exception>
         <remarks>
@@ -1161,6 +1162,10 @@ the underlying string is reached.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads all characters from the current position to the end of the string and returns them as a single string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The content from the current position to the end of the underlying string.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1176,12 +1181,15 @@ the underlying string is reached.
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads all characters from the current position to the end of the string asynchronously and returns them as a single string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous read operation. The value of the <paramref name="TResult" /> parameter contains a string with the characters from the current position to the end of the string. </para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.IO/StringWriter.xml b/mcs/class/corlib/Documentation/en/System.IO/StringWriter.xml
index a456aa1090e..b6d4179422f 100644
--- a/mcs/class/corlib/Documentation/en/System.IO/StringWriter.xml
+++ b/mcs/class/corlib/Documentation/en/System.IO/StringWriter.xml
@@ -887,12 +887,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously clears all buffers for the current writer and causes any buffered data to be written to the underlying device. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous flush operation.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetStringBuilder">
@@ -910,10 +913,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> The underlying <see cref="T:System.Text.StringBuilder" />
-.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is either the StringBuilder that was passed to the constructor, or the StringBuilder that was automatically created.</para>
@@ -968,6 +967,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the underlying <see cref="T:System.Text.StringBuilder" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The underlying StringBuilder.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -986,11 +989,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> The <see cref="T:System.String" /> containing the characters written to the
-   current <see cref="T:System.IO.StringWriter" /> instance.
-   </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following table lists examples of other typical or related I/O tasks.</para>
@@ -1044,6 +1042,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string containing the characters written to the current StringWriter so far.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string containing the characters written to the current StringWriter.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1529,12 +1531,15 @@
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes a character to the string asynchronously.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous write operation.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to write to the string.</param>
       </Docs>
@@ -1553,12 +1558,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes a string to the current string asynchronously.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous write operation.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to write. If <paramref name="value" /> is null, nothing is written to the text stream.</param>
       </Docs>
@@ -1579,12 +1587,15 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes a subarray of characters to the string asynchronously.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous write operation.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The character array to write data from.</param>
         <param name="index">
@@ -1607,7 +1618,6 @@
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The line terminator is defined by the <see cref="P:System.IO.TextWriter.NewLine" /> property.</para>
@@ -1616,6 +1626,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes a character followed by a line terminator asynchronously to the string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous write operation.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to write to the string.</param>
       </Docs>
@@ -1634,7 +1648,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The line terminator is defined by the <see cref="P:System.IO.TextWriter.NewLine" /> property.</para>
@@ -1643,6 +1656,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes a string followed by a line terminator asynchronously to the current string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous write operation.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to write. If the value is null, only a line terminator is written.</param>
       </Docs>
@@ -1663,7 +1680,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The line terminator is defined by the <see cref="P:System.IO.TextWriter.NewLine" /> property.</para>
@@ -1672,6 +1688,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes a subarray of characters followed by a line terminator asynchronously to the string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous write operation.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The character array to write data from.</param>
         <param name="index">
diff --git a/mcs/class/corlib/Documentation/en/System.IO/TextReader.xml b/mcs/class/corlib/Documentation/en/System.IO/TextReader.xml
index b675fb22ff5..fd9caf63b76 100644
--- a/mcs/class/corlib/Documentation/en/System.IO/TextReader.xml
+++ b/mcs/class/corlib/Documentation/en/System.IO/TextReader.xml
@@ -206,10 +206,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>The next character to be read, or -1 if no more characters are
-      available.</para>
-        </returns>
         <exception cref="T:System.IO.IOException">An I/O error has occurred.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -221,6 +217,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the next character without changing the state of the reader or the character source. Returns the next available character without actually reading it from the reader.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer representing the next character to be read, or -1 if no more characters are available or the reader does not support seeking.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -239,11 +239,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>The next character from the character source represented
-      as a <see cref="T:System.Int32" /> , or -1 if at the end
-      of the stream.</para>
-        </returns>
         <exception cref="T:System.IO.IOException"> An I/O error occurred.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -253,6 +248,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the next character from the text reader and advances the character position by one character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The next character from the text reader, or -1 if no more characters are available. The default implementation returns -1.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -275,11 +274,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the number of characters that were read, or zero if there were no more
-   characters left to read. Can be less than <paramref name="count" /> if the end of the stream
-   has been reached. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="buffer " /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">(<paramref name="index" /> + <paramref name="count" /> ) &gt; <paramref name="buffer" /><see langword="." />Length.</exception>
@@ -301,6 +295,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a specified maximum number of characters from the current reader and writes the data to a buffer, beginning at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of characters that have been read. The number will be less than or equal to <paramref name="count" />, depending on whether the data is available within the reader. This method returns 0 (zero) if it is called when no more characters are left to read.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />When this method returns, contains the specified character array with the values between <paramref name="index" /> and (<paramref name="index" /> + <paramref name="count" /> - 1) replaced by the characters read from the current source. </param>
         <param name="index">
@@ -326,7 +324,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The task completes after either the number of characters specified by the <paramref name="count" /> parameter are read or the end of the file is reached. </para>
@@ -336,6 +333,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a specified maximum number of characters from the current text reader asynchronously and writes the data to a buffer, beginning at the specified index. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous read operation. The value of the <paramref name="TResult" /> parameter contains the total number of bytes read into the buffer. The result value can be less than the number of bytes requested if the number of bytes currently available is less than the requested number, or it can be 0 (zero) if the end of the text has been reached.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />When this method returns, contains the specified character array with the values between <paramref name="index" /> and (<paramref name="index" /> + <paramref name="count" /> - 1) replaced by the characters read from the current source.</param>
         <param name="index">
@@ -363,11 +364,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Int32" /> containing the number of characters that were read, or
-   zero if there were no more characters left to read. Can be
-   less than <paramref name="count" /> if the end of the stream has been reached.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="buffer " /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">(<paramref name="index" /> + <paramref name="count" /> - 1) &gt; <paramref name="buffer" /><see langword="." />Length.</exception>
@@ -389,6 +385,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a specified maximum number of characters from the current text reader and writes the data to a buffer, beginning at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of characters that have been read. The number will be less than or equal to <paramref name="count" />, depending on whether all input characters have been read.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />When this method returns, this parameter contains the specified character array with the values between <paramref name="index" /> and (<paramref name="index" /> + <paramref name="count" /> -1) replaced by the characters read from the current source. </param>
         <param name="index">
@@ -414,7 +414,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The task does not complete until either the number of characters specified by the <paramref name="count" /> parameter are read, or the end of the text has been reached. </para>
@@ -423,6 +422,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a specified maximum number of characters from the current text reader asynchronously and writes the data to a buffer, beginning at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous read operation. The value of the <paramref name="TResult" /> parameter contains the total number of bytes read into the buffer. The result value can be less than the number of bytes requested if the number of bytes currently available is less than the requested number, or it can be 0 (zero) if the end of the text has been reached.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />When this method returns, contains the specified character array with the values between <paramref name="index" /> and (<paramref name="index" /> + <paramref name="count" /> - 1) replaced by the characters read from the current source.</param>
         <param name="index">
@@ -446,12 +449,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing the next line from the input stream, or
-<see langword="null" /> if all lines have
-   been read. The returned string does not
-   contain the line terminating character.</para>
-        </returns>
         <exception cref="T:System.IO.IOException"> An I/O error occurred.</exception>
         <exception cref="T:System.OutOfMemoryException">
           <para>There is insufficient memory to allocate a buffer for the returned string.</para>
@@ -468,6 +465,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a line of characters from the text reader and returns the data as a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The next line from the reader, or null if all characters have been read.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -483,7 +484,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.IO.TextReader" /> class is an abstract class. Therefore, you do not instantiate it in your code. For an example of using the <see cref="M:System.IO.TextReader.ReadLineAsync" /> method, see the <see cref="M:System.IO.StreamReader.ReadLineAsync" /> method.</para>
@@ -492,6 +492,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a line of characters asynchronously and returns the data as a string. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous read operation. The value of the <paramref name="TResult" /> parameter contains the next line from the text reader, or is null if all of the characters have been read. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadToEnd">
@@ -509,11 +513,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A string containing all characters from the current
-      position to the end of the character
-      source.</para>
-        </returns>
         <exception cref="T:System.IO.IOException"> An I/O error occurred.</exception>
         <exception cref="T:System.OutOfMemoryException">There is insufficient memory to allocate a buffer for the returned string.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">The number of characters from the current position to the end of the underlying stream is larger than <see cref="F:System.Int32.MaxValue" qualify="true" />.</exception>
@@ -527,6 +526,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads all characters from the current position to the end of the text reader and returns them as one string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains all characters from the current position to the end of the text reader.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -542,7 +545,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.IO.TextReader" /> class is an abstract class. Therefore, you do not instantiate it in your code. For an example of using the <see cref="M:System.IO.TextReader.ReadToEndAsync" /> method, see the <see cref="M:System.IO.StreamReader.ReadToEndAsync" /> method.</para>
@@ -551,6 +553,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads all characters from the current position to the end of the text reader asynchronously and returns them as one string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous read operation. The value of the <paramref name="TResult" /> parameter contains a string with the characters from the current position to the end of the text reader. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Synchronized">
@@ -570,9 +576,6 @@
         <Parameter Name="reader" Type="System.IO.TextReader" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A thread-safe <see cref="T:System.IO.TextReader" /> .</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">The <paramref name="reader" /> parameter is <see langword="null" />.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -582,6 +585,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a thread-safe wrapper around the specified TextReader.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A thread-safe <see cref="T:System.IO.TextReader" />.</para>
+        </returns>
         <param name="reader">
           <attribution license="cc4" from="Microsoft" modified="false" />The TextReader to synchronize. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.IO/TextWriter.xml b/mcs/class/corlib/Documentation/en/System.IO/TextWriter.xml
index c9ce7d9c28b..d4ba8244ae8 100644
--- a/mcs/class/corlib/Documentation/en/System.IO/TextWriter.xml
+++ b/mcs/class/corlib/Documentation/en/System.IO/TextWriter.xml
@@ -275,12 +275,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously clears all buffers for the current writer and causes any buffered data to be written to the underlying device. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous flush operation. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="FormatProvider">
@@ -391,9 +394,6 @@
         <Parameter Name="writer" Type="System.IO.TextWriter" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A thread-safe <see cref="T:System.IO.TextWriter" /> .</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="writer" /> is <see langword="null" />.</exception>
         <remarks>
@@ -405,6 +405,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a thread-safe wrapper around the specified TextWriter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A thread-safe wrapper.</para>
+        </returns>
         <param name="writer">
           <attribution license="cc4" from="Microsoft" modified="false" />The TextWriter to synchronize. </param>
       </Docs>
@@ -1324,7 +1328,6 @@
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.IO.TextWriter" /> class is an abstract class. Therefore, you do not instantiate it in your code. For an example of using the <see cref="M:System.IO.TextWriter.WriteAsync(System.Char)" /> method, see the <see cref="M:System.IO.StreamWriter.WriteAsync(System.Char)" /> method.</para>
@@ -1333,6 +1336,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes a character to the text string or stream asynchronously.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous write operation.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to write to the text stream.</param>
       </Docs>
@@ -1351,12 +1358,15 @@
         <Parameter Name="buffer" Type="System.Char[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes a character array to the text string or stream asynchronously.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous write operation.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The character array to write to the text stream. If <paramref name="buffer" /> is null, nothing is written.</param>
       </Docs>
@@ -1375,7 +1385,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.IO.TextWriter" /> class is an abstract class. Therefore, you do not instantiate it in your code. For an example of using the <see cref="M:System.IO.TextWriter.WriteAsync(System.String)" />  method, see the <see cref="M:System.IO.StreamWriter.WriteAsync(System.String)" /> method.</para>
@@ -1384,6 +1393,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes a string to the text string or stream asynchronously.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous write operation. </para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to write. If <paramref name="value" /> is null, nothing is written to the text stream.</param>
       </Docs>
@@ -1404,7 +1417,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.IO.TextWriter" /> class is an abstract class. Therefore, you do not instantiate it in your code. For an example of using the <see cref="M:System.IO.TextWriter.WriteAsync(System.Char[],System.Int32,System.Int32)" />  method, see the <see cref="M:System.IO.StreamWriter.WriteAsync(System.Char[],System.Int32,System.Int32)" />  method.</para>
@@ -1413,6 +1425,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes a subarray of characters to the text string or stream asynchronously. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous write operation.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The character array to write data from. </param>
         <param name="index">
@@ -2355,7 +2371,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The line terminator is defined by the <see cref="F:System.IO.TextWriter.CoreNewLine" /> field. </para>
@@ -2364,6 +2379,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes a line terminator asynchronously to the text string or stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous write operation. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="WriteLineAsync">
@@ -2380,7 +2399,6 @@
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The line terminator is defined by the <see cref="F:System.IO.TextWriter.CoreNewLine" /> field. </para>
@@ -2390,6 +2408,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes a character followed by a line terminator asynchronously to the text string or stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous write operation.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to write to the text stream.</param>
       </Docs>
@@ -2408,7 +2430,6 @@
         <Parameter Name="buffer" Type="System.Char[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The line terminator is defined by the <see cref="F:System.IO.TextWriter.CoreNewLine" /> field. </para>
@@ -2417,6 +2438,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes an array of characters followed by a line terminator asynchronously to the text string or stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous write operation.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The character array to write to the text stream. If the character array is null, only the line terminator is written. </param>
       </Docs>
@@ -2435,7 +2460,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The line terminator is defined by the <see cref="F:System.IO.TextWriter.CoreNewLine" /> field.</para>
@@ -2445,6 +2469,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes a string followed by a line terminator asynchronously to the text string or stream. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous write operation.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to write. If the value is null, only a line terminator is written. </param>
       </Docs>
@@ -2465,7 +2493,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The line terminator is defined by the <see cref="F:System.IO.TextWriter.CoreNewLine" /> field.</para>
@@ -2475,6 +2502,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes a subarray of characters followed by a line terminator asynchronously to the text string or stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous write operation.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The character array to write data from. </param>
         <param name="index">
diff --git a/mcs/class/corlib/Documentation/en/System.IO/UnmanagedMemoryAccessor.xml b/mcs/class/corlib/Documentation/en/System.IO/UnmanagedMemoryAccessor.xml
index a187006d8e5..5c8d3130f0b 100644
--- a/mcs/class/corlib/Documentation/en/System.IO/UnmanagedMemoryAccessor.xml
+++ b/mcs/class/corlib/Documentation/en/System.IO/UnmanagedMemoryAccessor.xml
@@ -334,12 +334,15 @@
         <Parameter Name="position" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a Boolean value from the accessor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true or false.</para>
+        </returns>
         <param name="position">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of bytes into the accessor at which to begin reading. </param>
       </Docs>
@@ -358,12 +361,15 @@
         <Parameter Name="position" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a byte value from the accessor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value that was read.</para>
+        </returns>
         <param name="position">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of bytes into the accessor at which to begin reading.</param>
       </Docs>
@@ -382,12 +388,15 @@
         <Parameter Name="position" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a character from the accessor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value that was read.</para>
+        </returns>
         <param name="position">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of bytes into the accessor at which to begin reading.</param>
       </Docs>
@@ -406,12 +415,15 @@
         <Parameter Name="position" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a decimal value from the accessor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value that was read.</para>
+        </returns>
         <param name="position">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of bytes into the accessor at which to begin reading.</param>
       </Docs>
@@ -430,12 +442,15 @@
         <Parameter Name="position" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a double-precision floating-point value from the accessor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value that was read.</para>
+        </returns>
         <param name="position">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of bytes into the accessor at which to begin reading.</param>
       </Docs>
@@ -454,12 +469,15 @@
         <Parameter Name="position" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a 16-bit integer from the accessor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value that was read.</para>
+        </returns>
         <param name="position">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of bytes into the accessor at which to begin reading.</param>
       </Docs>
@@ -478,12 +496,15 @@
         <Parameter Name="position" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a 32-bit integer from the accessor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value that was read.</para>
+        </returns>
         <param name="position">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of bytes into the accessor at which to begin reading.</param>
       </Docs>
@@ -502,12 +523,15 @@
         <Parameter Name="position" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a 64-bit integer from the accessor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value that was read.</para>
+        </returns>
         <param name="position">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of bytes into the accessor at which to begin reading.</param>
       </Docs>
@@ -531,12 +555,15 @@
         <Parameter Name="position" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads an 8-bit signed integer from the accessor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value that was read.</para>
+        </returns>
         <param name="position">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of bytes into the accessor at which to begin reading.</param>
       </Docs>
@@ -555,12 +582,15 @@
         <Parameter Name="position" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a single-precision floating-point value from the accessor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value that was read.</para>
+        </returns>
         <param name="position">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of bytes into the accessor at which to begin reading.</param>
       </Docs>
@@ -584,12 +614,15 @@
         <Parameter Name="position" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads an unsigned 16-bit integer from the accessor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value that was read.</para>
+        </returns>
         <param name="position">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of bytes into the accessor at which to begin reading.</param>
       </Docs>
@@ -613,12 +646,15 @@
         <Parameter Name="position" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads an unsigned 32-bit integer from the accessor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value that was read.</para>
+        </returns>
         <param name="position">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of bytes into the accessor at which to begin reading.</param>
       </Docs>
@@ -642,12 +678,15 @@
         <Parameter Name="position" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads an unsigned 64-bit integer from the accessor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value that was read.</para>
+        </returns>
         <param name="position">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of bytes into the accessor at which to begin reading.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.IO/UnmanagedMemoryStream.xml b/mcs/class/corlib/Documentation/en/System.IO/UnmanagedMemoryStream.xml
index 2234d0687ac..57cbdda21f3 100644
--- a/mcs/class/corlib/Documentation/en/System.IO/UnmanagedMemoryStream.xml
+++ b/mcs/class/corlib/Documentation/en/System.IO/UnmanagedMemoryStream.xml
@@ -491,7 +491,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -502,6 +501,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the specified number of bytes into the specified array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The total number of bytes read into the buffer. This can be less than the number of bytes requested if that many bytes are not currently available, or zero (0) if the end of the stream has been reached.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />When this method returns, contains the specified byte array with the values between <paramref name="offset" /> and (<paramref name="offset" /> + <paramref name="count" /> - 1) replaced by the bytes read from the current source. This parameter is passed uninitialized.</param>
         <param name="offset">
@@ -523,7 +526,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -533,6 +535,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a byte from a stream and advances the position within the stream by one byte, or returns -1 if at the end of the stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The unsigned byte cast to an <see cref="T:System.Int32" /> object, or -1 if at the end of the stream.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Seek">
@@ -551,7 +557,6 @@
         <Parameter Name="loc" Type="System.IO.SeekOrigin" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -561,6 +566,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the current position of the current stream to the given value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new position in the stream.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />The point relative to <paramref name="origin" /> to begin seeking from. </param>
         <param name="loc">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/AssemblyBuilder.xml b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/AssemblyBuilder.xml
index 6dd370a5039..c9f4947bbba 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/AssemblyBuilder.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/AssemblyBuilder.xml
@@ -161,7 +161,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ModuleBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>It is an error to define multiple dynamic modules with the same name in an assembly.</para>
@@ -177,6 +176,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a named transient dynamic module in this assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.Emit.ModuleBuilder" /> representing the defined dynamic module.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the dynamic module. Must be less than 260 characters in length. </param>
       </Docs>
@@ -198,7 +201,6 @@
         <Parameter Name="emitSymbolInfo" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ModuleBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>It is an error to define multiple dynamic modules with the same name in an assembly.</para>
@@ -214,6 +216,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a named transient dynamic module in this assembly and specifies whether symbol information should be emitted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.Emit.ModuleBuilder" /> representing the defined dynamic module.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the dynamic module. Must be less than 260 characters in length. </param>
         <param name="emitSymbolInfo">
@@ -237,7 +243,6 @@
         <Parameter Name="fileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ModuleBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To define a persistable dynamic module, this assembly needs to be created with the <see cref="F:System.Reflection.Emit.AssemblyBuilderAccess.Save" /> or the <see cref="F:System.Reflection.Emit.AssemblyBuilderAccess.RunAndSave" /> attribute.</para>
@@ -254,6 +259,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a persistable dynamic module with the given name that will be saved to the specified file. No symbol information is emitted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.Emit.ModuleBuilder" /> object representing the defined dynamic module.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the dynamic module. Must be less than 260 characters in length. </param>
         <param name="fileName">
@@ -278,7 +287,6 @@
         <Parameter Name="emitSymbolInfo" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ModuleBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To define a persistable dynamic module, this assembly needs to be created with the <see cref="F:System.Reflection.Emit.AssemblyBuilderAccess.Save" /> or the <see cref="F:System.Reflection.Emit.AssemblyBuilderAccess.RunAndSave" /> attribute.</para>
@@ -295,6 +303,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a persistable dynamic module, specifying the module name, the name of the file to which the module will be saved, and whether symbol information should be emitted using the default symbol writer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.Emit.ModuleBuilder" /> object representing the defined dynamic module.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the dynamic module. Must be less than 260 characters in length. </param>
         <param name="fileName">
@@ -321,7 +333,6 @@
         <Parameter Name="fileName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Resources.IResourceWriter'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Fine grain resources can be added with the returned <see cref="T:System.Resources.ResourceWriter" /> by calling <see cref="M:System.Resources.ResourceWriter.AddResource(System.String,System.String)" />.</para>
@@ -336,6 +347,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a standalone managed resource for this assembly with the default public resource attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Resources.ResourceWriter" /> object for the specified resource.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The logical name of the resource. </param>
         <param name="description">
@@ -363,7 +378,6 @@
         <Parameter Name="attribute" Type="System.Reflection.ResourceAttributes" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Resources.IResourceWriter'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Fine-grain resources can be added with the returned <see cref="T:System.Resources.ResourceWriter" /> by calling <see cref="M:System.Resources.ResourceWriter.AddResource(System.String,System.String)" />.</para>
@@ -378,6 +392,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a standalone managed resource for this assembly. Attributes can be specified for the managed resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Resources.ResourceWriter" /> object for the specified resource.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The logical name of the resource. </param>
         <param name="description">
@@ -556,12 +574,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether this instance is equal to the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> equals the type and value of this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance, or null.</param>
       </Docs>
@@ -602,12 +623,15 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the custom attributes that have been applied to the current <see cref="T:System.Reflection.Emit.AssemblyBuilder" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains the custom attributes; the array is empty if there are no attributes.</para>
+        </returns>
         <param name="inherit">
           <attribution license="cc4" from="Microsoft" modified="false" />This argument is ignored for objects of this type.</param>
       </Docs>
@@ -627,12 +651,15 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the custom attributes that have been applied to the current <see cref="T:System.Reflection.Emit.AssemblyBuilder" />, and that derive from a specified attribute type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains the custom attributes that are derived at any level from <paramref name="attributeType" />; the array is empty if there are no such attributes.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The base type from which attributes derive.</param>
         <param name="inherit">
@@ -655,12 +682,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ModuleBuilder'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the dynamic module with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A ModuleBuilder object representing the requested dynamic module.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the requested dynamic module. </param>
       </Docs>
@@ -679,12 +709,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the exported types defined in this assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Type" /> containing the exported types defined in this assembly.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetFile">
@@ -703,7 +736,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -713,6 +745,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.IO.FileStream" /> for the specified file in the file table of the manifest of this assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.FileStream" /> for the specified file, or null, if the file is not found.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the specified file. </param>
       </Docs>
@@ -733,12 +769,15 @@
         <Parameter Name="getResourceModules" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the files in the file table of an assembly manifest, specifying whether to include resource modules.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.IO.FileStream" /> objects.</para>
+        </returns>
         <param name="getResourceModules">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include resource modules; otherwise, false. </param>
       </Docs>
@@ -755,12 +794,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetLoadedModules">
@@ -777,12 +819,15 @@
         <Parameter Name="getResourceModules" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the loaded modules that are part of this assembly, and optionally includes resource modules. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded modules that are part of this assembly.</para>
+        </returns>
         <param name="getResourceModules">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include resource modules; otherwise, false.</param>
       </Docs>
@@ -803,12 +848,16 @@
         <Parameter Name="resourceName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns information about how the given resource has been persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="T:System.Reflection.ManifestResourceInfo" /> populated with information about the resource's topology, or null if the resource is not found.</para>
+        </returns>
         <param name="resourceName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the resource. </param>
       </Docs>
@@ -827,12 +876,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads the specified manifest resource from this assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type String containing the names of all the resources.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetManifestResourceStream">
@@ -851,12 +903,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads the specified manifest resource from this assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> representing this manifest resource.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the manifest resource being requested. </param>
       </Docs>
@@ -878,7 +933,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned <see cref="T:System.IO.Stream" /> has its file pointer set to the beginning of the resource.</para>
@@ -887,6 +941,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads the specified manifest resource, scoped by the namespace of the specified type, from this assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> representing this manifest resource.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type whose namespace is used to scope the manifest resource name. </param>
         <param name="name">
@@ -907,12 +965,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the specified module in this assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The module being requested, or null if the module is not found.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the requested module.</param>
       </Docs>
@@ -931,12 +992,15 @@
         <Parameter Name="getResourceModules" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all the modules that are part of this assembly, and optionally includes resource modules.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The modules that are part of this assembly.</para>
+        </returns>
         <param name="getResourceModules">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include resource modules; otherwise, false.</param>
       </Docs>
@@ -955,12 +1019,15 @@
         <Parameter Name="copiedName" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Reflection.AssemblyName" /> that was specified when the current dynamic assembly was created, and sets the code base as specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the dynamic assembly.</para>
+        </returns>
         <param name="copiedName">
           <attribution license="cc4" from="Microsoft" modified="false" />true to set the code base to the location of the assembly after it is shadow-copied; false to set the code base to the original location.</param>
       </Docs>
@@ -977,7 +1044,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method does not return a complete list of referenced assemblies. For example, if you apply a custom attribute to the <see cref="T:System.Reflection.Emit.AssemblyBuilder" />, the assembly in which the attribute was defined is included in the list returned by this method. However, if you use a <see cref="T:System.Type" /> object to specify the type of a method parameter, that type is not included.</para>
@@ -987,6 +1053,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an incomplete list of <see cref="T:System.Reflection.AssemblyName" /> objects for the assemblies that are referenced by this <see cref="T:System.Reflection.Emit.AssemblyBuilder" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of assembly names for the referenced assemblies. This array is not a complete list.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetSatelliteAssembly">
@@ -1003,7 +1073,6 @@
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Satellite assemblies contain localized resources, as distinct from main application assemblies, which contain non-localizable executable code and resources for a single culture that serve as the default or neutral culture.</para>
@@ -1013,6 +1082,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the satellite assembly for the specified culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified satellite assembly.</para>
+        </returns>
         <param name="culture">
           <attribution license="cc4" from="Microsoft" modified="false" />The specified culture. </param>
       </Docs>
@@ -1032,7 +1105,6 @@
         <Parameter Name="version" Type="System.Version" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Satellite assemblies contain localized resources, as distinct from main application assemblies, which contain non-localizable executable code and resources for a single culture that serve as the default or neutral culture.</para>
@@ -1042,6 +1114,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the specified version of the satellite assembly for the specified culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified satellite assembly.</para>
+        </returns>
         <param name="culture">
           <attribution license="cc4" from="Microsoft" modified="false" />The specified culture. </param>
         <param name="version">
@@ -1064,7 +1140,6 @@
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A type cannot be found until it has been created by calling the <see cref="M:System.Reflection.Emit.TypeBuilder.CreateType" /> method.</para>
@@ -1073,6 +1148,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the specified type from the types that have been defined and created in the current <see cref="T:System.Reflection.Emit.AssemblyBuilder" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified type, or null if the type is not found or has not been created yet. </para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the type to search for.</param>
         <param name="throwOnError">
@@ -1140,12 +1219,15 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether one or more instances of the specified attribute type is applied to this member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if one or more instances of <paramref name="attributeType" /> is applied to this dynamic assembly; otherwise, false.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of attribute to test for.</param>
         <param name="inherit">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/ConstructorBuilder.xml b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/ConstructorBuilder.xml
index 4d206491b98..85a67ba79b7 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/ConstructorBuilder.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/ConstructorBuilder.xml
@@ -176,7 +176,6 @@
         <Parameter Name="strParamName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ParameterBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you specify 0 (zero) for <paramref name="iSequence" />, this method returns a <see cref="T:System.Reflection.Emit.ParameterBuilder" /> instead of throwing an exception. There is nothing useful that you can do with this <see cref="T:System.Reflection.Emit.ParameterBuilder" />. </para>
@@ -185,6 +184,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a parameter of this constructor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a ParameterBuilder object that represents the new parameter of this constructor.</para>
+        </returns>
         <param name="iSequence">
           <attribution license="cc4" from="Microsoft" modified="false" />The position of the parameter in the parameter list. Parameters are indexed beginning with the number 1 for the first parameter. </param>
         <param name="attributes">
@@ -209,7 +212,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="inherit" /> parameter is ignored because a class never inherits constructors from base classes.</para>
@@ -219,6 +221,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the custom attributes defined for this constructor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an array of objects representing all the custom attributes of the constructor represented by this <see cref="T:System.Reflection.Emit.ConstructorBuilder" /> instance.</para>
+        </returns>
         <param name="inherit">
           <attribution license="cc4" from="Microsoft" modified="false" />Controls inheritance of custom attributes from base classes. This parameter is ignored. </param>
       </Docs>
@@ -240,7 +246,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="inherit" /> parameter is ignored because a class never inherits constructors from base classes.</para>
@@ -250,6 +255,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the custom attributes identified by the given type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an array of type <see cref="T:System.Object" /> representing the attributes of this constructor.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The custom attribute type. </param>
         <param name="inherit">
@@ -270,7 +279,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ILGenerator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The runtime generates the code for default constructors. Therefore, if an attempt is made to obtain an ILGenerator, an exception will be thrown.</para>
@@ -279,6 +287,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <see cref="T:System.Reflection.Emit.ILGenerator" /> for this constructor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an <see cref="T:System.Reflection.Emit.ILGenerator" /> object for this constructor.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetILGenerator">
@@ -296,7 +308,6 @@
         <Parameter Name="streamSize" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -306,6 +317,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <see cref="T:System.Reflection.Emit.ILGenerator" /> object, with the specified MSIL stream size, that can be used to build a method body for this constructor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Reflection.Emit.ILGenerator" /> for this constructor.</para>
+        </returns>
         <param name="streamSize">
           <attribution license="cc4" from="Microsoft" modified="false" />The size of the MSIL stream, in bytes.</param>
       </Docs>
@@ -324,7 +339,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following code sample illustrates the use of GetMethodImplementationFlags.</para>
@@ -334,6 +348,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the method implementation flags for this constructor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The method implementation flags for this constructor.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetModule">
@@ -350,7 +368,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Reflection.Module'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following code sample illustrates the usage of GetModule.</para>
@@ -360,6 +377,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a reference to the module that contains this constructor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The module that contains this constructor.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetParameters">
@@ -376,7 +397,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This property is not supported until after the <see cref="M:System.Reflection.Emit.TypeBuilder.CreateType" /> method has been called. In the .NET Framework versions 1.0 and 1.1, <see cref="T:System.InvalidOperationException" /> is thrown. In the .NET Framework version 2.0, <see cref="T:System.NotSupportedException" /> is thrown. </para>
@@ -385,6 +405,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the parameters of this constructor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an array of <see cref="T:System.Reflection.ParameterInfo" /> objects that represent the parameters of this constructor.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetToken">
@@ -401,7 +425,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'MethodToken'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This code sample illustrates the use of GetToken.</para>
@@ -411,6 +434,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Reflection.Emit.MethodToken" /> that represents the token for this constructor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the <see cref="T:System.Reflection.Emit.MethodToken" /> of this constructor.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InitLocals">
@@ -455,7 +482,6 @@
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the constructor has no parameters, the value of the <paramref name="parameters" /> parameter should be null. Otherwise, the number, type, and order of elements in the <paramref name="parameters" /> array should be identical to the number, type, and order of parameters for the constructor reflected by this instance.</para>
@@ -468,6 +494,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes the constructor dynamically reflected by this instance on the given object, passing along the specified parameters, and under the constraints of the given binder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an <see cref="T:System.Object" /> that is the return value of the invoked constructor.</para>
+        </returns>
         <param name="invokeAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />This must be a bit flag from <see cref="T:System.Reflection.BindingFlags" />, such as InvokeMethod, NonPublic, and so on. </param>
         <param name="binder">
@@ -498,7 +528,6 @@
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The number, type, and order of elements in the parameters array should be identical to the number, type, and order of parameters for the constructor reflected by this instance.</para>
@@ -509,6 +538,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Dynamically invokes the constructor reflected by this instance with the specified arguments, under the constraints of the specified Binder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the class associated with the constructor.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object that needs to be reinitialized. </param>
         <param name="invokeAttr">
@@ -538,7 +571,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the metadata specification for details on how to format <paramref name="binaryAttribute" />.</para>
@@ -547,6 +579,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks if the specified custom attribute type is defined.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified custom attribute type is defined; otherwise, false.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />A custom attribute type. </param>
         <param name="inherit">
@@ -952,12 +988,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns this <see cref="T:System.Reflection.Emit.ConstructorBuilder" /> instance as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a <see cref="T:System.String" /> containing the name, attributes, and exceptions of this constructor, followed by the current Microsoft intermediate language (MSIL) stream.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/DynamicILInfo.xml b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/DynamicILInfo.xml
index 5e68b46c882..82472f4c454 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/DynamicILInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/DynamicILInfo.xml
@@ -71,7 +71,6 @@
         <Parameter Name="signature" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For information on signature blobs, see the Common Language Infrastructure (CLI) documentation, especially "Partition II: Metadata Definition and Semantics". The documentation is available online; see <see cref="http://go.microsoft.com/fwlink/?LinkID=99212">ECMA C# and Common Language Infrastructure Standards</see> on MSDN and <see cref="http://go.microsoft.com/fwlink/?LinkID=65552">Standard ECMA-335 - Common Language Infrastructure (CLI)</see> on the Ecma International Web site.</para>
@@ -80,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a token, valid in the scope of the current <see cref="T:System.Reflection.Emit.DynamicILInfo" />, representing the signature for the associated dynamic method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A token that can be embedded in the metadata and the MSIL stream for the associated dynamic method.</para>
+        </returns>
         <param name="signature">
           <attribution license="cc4" from="Microsoft" modified="false" />An array that contains the signature.</param>
       </Docs>
@@ -99,7 +102,6 @@
         <Parameter Name="method" Type="System.Reflection.Emit.DynamicMethod" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The token returned by this method overload allows you to call a dynamic method from the dynamic method associated with the current <see cref="T:System.Reflection.Emit.DynamicILInfo" /> object. To call the associated dynamic method recursively, pass the value of the <see cref="P:System.Reflection.Emit.DynamicILInfo.DynamicMethod" /> property.</para>
@@ -108,6 +110,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a token, valid in the scope of the current <see cref="T:System.Reflection.Emit.DynamicILInfo" />, representing a dynamic method to be called from the associated method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A token that can be embedded in the MSIL stream for the associated dynamic method, as the target of an MSIL instruction.</para>
+        </returns>
         <param name="method">
           <attribution license="cc4" from="Microsoft" modified="false" />The dynamic method to call.</param>
       </Docs>
@@ -127,7 +133,6 @@
         <Parameter Name="field" Type="System.RuntimeFieldHandle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You must obtain a token for any field that will be accessed by the dynamic method associated with the current <see cref="T:System.Reflection.Emit.DynamicILInfo" /> object. Use the <see cref="M:System.Type.GetField(System.String)" /> method to get a <see cref="T:System.Reflection.FieldInfo" /> for the field you want to access, then use the <see cref="P:System.Reflection.FieldInfo.FieldHandle" /> property to get the <see cref="T:System.RuntimeFieldHandle" />.</para>
@@ -136,6 +141,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a token, valid in the scope of the current <see cref="T:System.Reflection.Emit.DynamicILInfo" />, representing a field to be accessed from the associated dynamic method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A token that can be used as the operand of an MSIL instruction that accesses fields, in the scope of the current <see cref="T:System.Reflection.Emit.DynamicILInfo" /> object.</para>
+        </returns>
         <param name="field">
           <attribution license="cc4" from="Microsoft" modified="false" />The field to be accessed. </param>
       </Docs>
@@ -155,7 +164,6 @@
         <Parameter Name="method" Type="System.RuntimeMethodHandle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You must obtain a token for any method that will be accessed by the dynamic method associated with the current <see cref="T:System.Reflection.Emit.DynamicILInfo" /> object. Use the <see cref="Overload:System.Type.GetMethod" /> method to get a <see cref="T:System.Reflection.MethodInfo" /> for the method you want to access, and then use the <see cref="P:System.Reflection.MethodBase.MethodHandle" /> property to get the <see cref="T:System.RuntimeMethodHandle" />.</para>
@@ -167,6 +175,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a token, valid in the scope of the current <see cref="T:System.Reflection.Emit.DynamicILInfo" />, representing a method to be accessed from the associated dynamic method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A token that can be used as the operand of an MSIL instruction that accesses methods, such as <see cref="F:System.Reflection.Emit.OpCodes.Call" /> or <see cref="F:System.Reflection.Emit.OpCodes.Ldtoken" />, in the scope of the current <see cref="T:System.Reflection.Emit.DynamicILInfo" /> object.</para>
+        </returns>
         <param name="method">
           <attribution license="cc4" from="Microsoft" modified="false" />The method to be accessed.</param>
       </Docs>
@@ -186,7 +198,6 @@
         <Parameter Name="type" Type="System.RuntimeTypeHandle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The token returned by this method overload allows you to define a local variable type, and emit MSIL to create an instance of a type in the dynamic method associated with the current <see cref="T:System.Reflection.Emit.DynamicILInfo" /> object.</para>
@@ -196,6 +207,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a token, valid in the scope of the current <see cref="T:System.Reflection.Emit.DynamicILInfo" />, representing a type to be used in the associated dynamic method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A token that can be used as the operand of an MSIL instruction that requires a type, in the scope of the current <see cref="T:System.Reflection.Emit.DynamicILInfo" /> object.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to be used.</param>
       </Docs>
@@ -215,12 +230,15 @@
         <Parameter Name="literal" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a token, valid in the scope of the current <see cref="T:System.Reflection.Emit.DynamicILInfo" />, representing a string literal to be used in the associated dynamic method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A token that can be used as the operand of an MSIL instruction that requires a string, in the scope of the current <see cref="T:System.Reflection.Emit.DynamicILInfo" /> object.</para>
+        </returns>
         <param name="literal">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to be used.</param>
       </Docs>
@@ -240,7 +258,6 @@
         <Parameter Name="contextType" Type="System.RuntimeTypeHandle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You must obtain a token for any field that will be accessed by the dynamic method associated with the current <see cref="T:System.Reflection.Emit.DynamicILInfo" /> object. Use the <see cref="M:System.Type.GetField(System.String)" /> method to get a <see cref="T:System.Reflection.FieldInfo" /> for the field you want to access, and then use the <see cref="P:System.Reflection.FieldInfo.FieldHandle" /> property to get the <see cref="T:System.RuntimeFieldHandle" />.</para>
@@ -249,6 +266,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a token, valid in the scope of the current <see cref="T:System.Reflection.Emit.DynamicILInfo" />, representing a field to be accessed from the associated dynamic method; the field is on the specified generic type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A token that can be used as the operand of an MSIL instruction that accesses fields in the scope of the current <see cref="T:System.Reflection.Emit.DynamicILInfo" /> object.</para>
+        </returns>
         <param name="field">
           <attribution license="cc4" from="Microsoft" modified="false" />The field to be accessed.</param>
         <param name="contextType">
@@ -271,7 +292,6 @@
         <Parameter Name="contextType" Type="System.RuntimeTypeHandle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You must obtain a token for any method that will be called by the dynamic method associated with the current <see cref="T:System.Reflection.Emit.DynamicILInfo" /> object. Use the <see cref="M:System.Type.GetMethod(System.String)" /> method to get a <see cref="T:System.Reflection.MethodInfo" /> for the method you want to call, and then use the <see cref="P:System.Reflection.MethodBase.MethodHandle" /> property to get the <see cref="T:System.RuntimeMethodHandle" />.</para>
@@ -280,6 +300,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a token, valid in the scope of the current <see cref="T:System.Reflection.Emit.DynamicILInfo" />, representing a method on a generic type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A token that can be used as the operand of an MSIL instruction that accesses methods, such as <see cref="F:System.Reflection.Emit.OpCodes.Call" /> or <see cref="F:System.Reflection.Emit.OpCodes.Ldtoken" />, in the scope of the current <see cref="T:System.Reflection.Emit.DynamicILInfo" /> object.</para>
+        </returns>
         <param name="method">
           <attribution license="cc4" from="Microsoft" modified="false" />The method.</param>
         <param name="contextType">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/DynamicMethod.xml b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/DynamicMethod.xml
index 47675e7dbc1..e4a178bb511 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/DynamicMethod.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/DynamicMethod.xml
@@ -572,7 +572,6 @@
         <Parameter Name="delegateType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -583,6 +582,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Completes the dynamic method and creates a delegate that can be used to execute it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A delegate of the specified type, which can be used to execute the dynamic method.</para>
+        </returns>
         <param name="delegateType">
           <attribution license="cc4" from="Microsoft" modified="false" />A delegate type whose signature matches that of the dynamic method. </param>
       </Docs>
@@ -608,7 +611,6 @@
         <Parameter Name="target" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -621,6 +623,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Completes the dynamic method and creates a delegate that can be used to execute it, specifying the delegate type and an object the delegate is bound to.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A delegate of the specified type, which can be used to execute the dynamic method with the specified target object.</para>
+        </returns>
         <param name="delegateType">
           <attribution license="cc4" from="Microsoft" modified="false" />A delegate type whose signature matches that of the dynamic method, minus the first parameter.</param>
         <param name="target">
@@ -668,7 +674,6 @@
         <Parameter Name="parameterName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -679,6 +684,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a parameter of the dynamic method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always returns null. </para>
+        </returns>
         <param name="position">
           <attribution license="cc4" from="Microsoft" modified="false" />The position of the parameter in the parameter list. Parameters are indexed beginning with the number 1 for the first parameter. </param>
         <param name="attributes">
@@ -716,7 +725,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -726,6 +734,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the base implementation for the method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The base implementation of the method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetCustomAttributes">
@@ -743,7 +755,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -756,6 +767,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the custom attributes defined for the method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of objects representing all the custom attributes of the method.</para>
+        </returns>
         <param name="inherit">
           <attribution license="cc4" from="Microsoft" modified="false" />true to search the method's inheritance chain to find the custom attributes; false to check only the current method. </param>
       </Docs>
@@ -776,7 +791,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -789,6 +803,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the custom attributes of the specified type that have been applied to the method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of objects representing the attributes of the method that are of type <paramref name="attributeType" /> or derive from type <paramref name="attributeType" />.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> representing the type of custom attribute to return. </param>
         <param name="inherit">
@@ -808,7 +826,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Reflection.Emit.DynamicILInfo" /> class is provided to support unmanaged code generation. For more information, see <format type="text/html"><a href="0c5bb9de-0cf6-438d-ba47-134e6c775fb8">The Unmanaged Reflection API</a></format>.</para>
@@ -817,6 +834,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Reflection.Emit.DynamicILInfo" /> object that can be used to generate a method body from metadata tokens, scopes, and Microsoft intermediate language (MSIL) streams.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.Emit.DynamicILInfo" /> object that can be used to generate a method body from metadata tokens, scopes, and MSIL streams.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetILGenerator">
@@ -832,7 +853,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -845,6 +865,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Microsoft intermediate language (MSIL) generator for the method with a default MSIL stream size of 64 bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Reflection.Emit.ILGenerator" /> object for the method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetILGenerator">
@@ -862,7 +886,6 @@
         <Parameter Name="streamSize" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -875,6 +898,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Microsoft intermediate language (MSIL) generator for the method with the specified MSIL stream size.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Reflection.Emit.ILGenerator" /> object for the method, with the specified MSIL stream size.</para>
+        </returns>
         <param name="streamSize">
           <attribution license="cc4" from="Microsoft" modified="false" />The size of the MSIL stream, in bytes. </param>
       </Docs>
@@ -892,7 +919,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -902,6 +928,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the implementation flags for the method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A bitwise combination of <see cref="T:System.Reflection.MethodImplAttributes" /> values representing the implementation flags for the method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetParameters">
@@ -917,7 +947,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -927,6 +956,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the parameters of the dynamic method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.ParameterInfo" /> objects that represent the parameters of the dynamic method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InitLocals">
@@ -972,7 +1005,6 @@
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -993,6 +1025,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes the dynamic method using the specified parameters, under the constraints of the specified binder, with the specified culture information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Object" /> containing the return value of the invoked method.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored for dynamic methods, because they are static. Specify null. </param>
         <param name="invokeAttr">
@@ -1021,7 +1057,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1034,6 +1069,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified custom attribute type is defined.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified custom attribute type is defined; otherwise, false.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> representing the type of custom attribute to search for. </param>
         <param name="inherit">
@@ -1220,7 +1259,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1230,6 +1268,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the signature of the method, represented as a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representing the method signature.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/EnumBuilder.xml b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/EnumBuilder.xml
index 7501bc7e0da..9c6171cf58e 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/EnumBuilder.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/EnumBuilder.xml
@@ -128,12 +128,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Type'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Type" /> object for this enum.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object for this enum.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DeclaringType">
@@ -174,7 +177,6 @@
         <Parameter Name="literalValue" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'FieldBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The defined field will have the field attributes <see cref="F:System.Reflection.FieldAttributes.Public" />, <see cref="F:System.Reflection.FieldAttributes.Static" />, and <see cref="F:System.Reflection.FieldAttributes.Literal" /> set.</para>
@@ -186,6 +188,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines the named static field in an enumeration type with the specified constant value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The defined field.</para>
+        </returns>
         <param name="literalName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the static field. </param>
         <param name="literalValue">
@@ -286,7 +292,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As a workaround, to retrieve the constructor of a finished type, you can retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -295,6 +300,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of <see cref="T:System.Reflection.ConstructorInfo" /> objects representing the public and non-public constructors defined for this class, as specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an array of <see cref="T:System.Reflection.ConstructorInfo" /> objects representing the specified constructors defined for this class. If no constructors are defined, an empty array is returned.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />This must be a bit flag from <see cref="T:System.Reflection.BindingFlags" /> : InvokeMethod, NonPublic, and so on. </param>
       </Docs>
@@ -315,7 +324,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As a workaround, to retrieve the custom attributes of a finished type, retrieve the type using <see cref="M:System.Type.GetType" /> and call <see cref="M:System.Reflection.MemberInfo.GetCustomAttributes(System.Boolean)" /> on the returned <see cref="T:System.Type" />.</para>
@@ -326,6 +334,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the custom attributes defined for this constructor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an array of objects representing all the custom attributes of the constructor represented by this <see cref="T:System.Reflection.Emit.ConstructorBuilder" /> instance.</para>
+        </returns>
         <param name="inherit">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies whether to search this member's inheritance chain to find the attributes. </param>
       </Docs>
@@ -347,7 +359,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As a workaround, to retrieve the custom attributes of a finished type, retrieve the type using <see cref="M:System.Type.GetType" /> and call <see cref="M:System.Reflection.MemberInfo.GetCustomAttributes(System.Boolean)" /> on the returned <see cref="T:System.Type" />.</para>
@@ -358,6 +369,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the custom attributes identified by the given type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an array of objects representing the attributes of this constructor that are of <see cref="T:System.Type" /> <paramref name="attributeType" />.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The Type object to which the custom attributes are applied. </param>
         <param name="inherit">
@@ -378,12 +393,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.NotSupportedException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method is not supported. No value is returned.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetEnumUnderlyingType">
@@ -398,12 +416,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the underlying integer type of the current enumeration, which is set when the enumeration builder is defined.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The underlying type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetEvent">
@@ -423,7 +444,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As a workaround, to retrieve the event of a finished type, retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -432,6 +452,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the event with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an <see cref="T:System.Reflection.EventInfo" /> object representing the event declared or inherited by this type with the specified name. If there are no matches, null is returned.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the event to get. </param>
         <param name="bindingAttr">
@@ -452,7 +476,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As a workaround, to retrieve the events of a finished type, retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -461,6 +484,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the events for the public events declared or inherited by this type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an array of <see cref="T:System.Reflection.EventInfo" /> objects representing the public events declared or inherited by this type. An empty array is returned if there are no public events.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetEvents">
@@ -479,7 +506,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As a workaround, to retrieve the events of a finished type, retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type to retrieve the events.</para>
@@ -488,6 +514,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the public and non-public events that are declared by this type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an array of <see cref="T:System.Reflection.EventInfo" /> objects representing the public and non-public events declared or inherited by this type. An empty array is returned if there are no events, as specified.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />This must be a bit flag from <see cref="T:System.Reflection.BindingFlags" />, such as InvokeMethod, NonPublic, and so on. </param>
       </Docs>
@@ -509,7 +539,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As a workaround, to retrieve the field of a finished type, retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -518,6 +547,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the field specified by the given name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the <see cref="T:System.Reflection.FieldInfo" /> object representing the field declared or inherited by this type with the specified name and public or non-public modifier. If there are no matches, then null is returned.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the field to get. </param>
         <param name="bindingAttr">
@@ -540,7 +573,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As a workaround, to retrieve the field of a finished type, retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -550,6 +582,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the public and non-public fields that are declared by this type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an array of <see cref="T:System.Reflection.FieldInfo" /> objects representing the public and non-public fields declared or inherited by this type. An empty array is returned if there are no fields, as specified.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />This must be a bit flag from <see cref="T:System.Reflection.BindingFlags" />, such as InvokeMethod, NonPublic, and so on. </param>
       </Docs>
@@ -571,7 +607,6 @@
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As a workaround, to retrieve the interface of a finished type, retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -580,6 +615,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the interface implemented (directly or indirectly) by this type, with the specified fully-qualified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a <see cref="T:System.Type" /> object representing the implemented interface. Returns null if no interface matching name is found.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the interface. </param>
         <param name="ignoreCase">
@@ -607,7 +646,6 @@
         <Parameter Name="interfaceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As a workaround, to retrieve the interface mapping types of a finished type, retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -616,6 +654,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an interface mapping for the interface requested.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The requested interface mapping.</para>
+        </returns>
         <param name="interfaceType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the interface for which the interface mapping is to be retrieved. </param>
       </Docs>
@@ -634,7 +676,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As a workaround, to retrieve the interface of a finished type, retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -643,6 +684,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of all the interfaces implemented on this a class and its base classes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an array of <see cref="T:System.Type" /> objects representing the implemented interfaces. If none are defined, an empty array is returned.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetMember">
@@ -663,7 +708,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As a workaround, to retrieve the member of a finished type, retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -672,6 +716,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all members with the specified name, type, and binding that are declared or inherited by this type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an array of <see cref="T:System.Reflection.MemberInfo" /> objects representing the public and non-public members defined on this type if <paramref name="nonPublic" /> is used; otherwise, only the public members are returned.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the member. </param>
         <param name="type">
@@ -696,7 +744,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As a workaround, to retrieve the members of a finished type, retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -705,6 +752,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified members declared or inherited by this type,.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an array of <see cref="T:System.Reflection.MemberInfo" /> objects representing the public and non-public members declared or inherited by this type. An empty array is returned if there are no matching members.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />This must be a bit flag from <see cref="T:System.Reflection.BindingFlags" /> : InvokeMethod, NonPublic, and so on. </param>
       </Docs>
@@ -757,7 +808,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As a workaround, to retrieve the methods of a finished type, retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -766,6 +816,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the public and non-public methods declared or inherited by this type, as specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an array of <see cref="T:System.Reflection.MethodInfo" /> objects representing the public and non-public methods defined on this type if <paramref name="nonPublic" /> is used; otherwise, only the public methods are returned.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />This must be a bit flag from <see cref="T:System.Reflection.BindingFlags" />, such as InvokeMethod, NonPublic, and so on. </param>
       </Docs>
@@ -787,7 +841,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As a workaround, to retrieve the nested type of a finished type, retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -796,6 +849,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified nested type that is declared by this type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object representing the nested type that matches the specified requirements, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the name of the nested type to get. </param>
         <param name="bindingAttr">
@@ -818,7 +875,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As a workaround, to retrieve the nested types of a finished type, retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -827,6 +883,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the public and non-public nested types that are declared or inherited by this type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Type" /> objects representing all the types nested within the current <see cref="T:System.Type" /> that match the specified binding constraints.</para>
+          <para>An empty array of type <see cref="T:System.Type" />, if no types are nested within the current <see cref="T:System.Type" />, or if none of the nested types match the binding constraints.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />This must be a bit flag from <see cref="T:System.Reflection.BindingFlags" />, such as InvokeMethod, NonPublic, and so on. </param>
       </Docs>
@@ -847,7 +908,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As a workaround, to retrieve the properties of a finished type, retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -856,6 +916,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the public and non-public properties declared or inherited by this type, as specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an array of <see cref="T:System.Reflection.PropertyInfo" /> objects representing the public and non-public properties defined on this type if <paramref name="nonPublic" /> is used; otherwise, only the public properties are returned.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />This invocation attribute. This must be a bit flag from <see cref="T:System.Reflection.BindingFlags" /> : InvokeMethod, NonPublic, and so on. </param>
       </Docs>
@@ -955,7 +1019,6 @@
         <Parameter Name="namedParameters" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -964,6 +1027,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes the specified member. The method that is to be invoked must be accessible and provide the most specific match with the specified argument list, under the contraints of the specified binder and invocation attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the return value of the invoked member.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the member to invoke. This can be a constructor, method, property, or field. A suitable invocation attribute must be specified. Note that it is possible to invoke the default member of a class by passing an empty string as the name of the member. </param>
         <param name="invokeAttr">
@@ -1015,12 +1082,15 @@
         <Parameter Name="typeInfo" Type="System.Reflection.TypeInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether a specified <see cref="T:System.Reflection.TypeInfo" /> object can be assigned to this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="typeInfo" /> can be assigned to this object; otherwise, false.</para>
+        </returns>
         <param name="typeInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test.</param>
       </Docs>
@@ -1099,7 +1169,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>As a workaround, to check if a custom attribute is defined for a finished type, retrieve the type using <see cref="M:System.Type.GetType" /> and call <see cref="M:System.Reflection.MemberInfo.GetCustomAttributes(System.Boolean)" /> on the returned <see cref="T:System.Type" />.</para>
@@ -1108,6 +1177,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks if the specified custom attribute type is defined.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if one or more instance of <paramref name="attributeType" /> is defined on this member; otherwise, false.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The Type object to which the custom attributes are applied. </param>
         <param name="inherit">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/EventBuilder.xml b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/EventBuilder.xml
index cc5785a7ee9..6bc3226c034 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/EventBuilder.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/EventBuilder.xml
@@ -79,12 +79,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'EventToken'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the token for this event.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the EventToken for this event.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SetAddOnMethod">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/EventToken.xml b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/EventToken.xml
index 099cea48bc0..fc38f9c39a1 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/EventToken.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/EventToken.xml
@@ -64,12 +64,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks if the given object is an instance of EventToken and is equal to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if <paramref name="obj" /> is an instance of EventToken and equals the current instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be compared with this instance. </param>
       </Docs>
@@ -89,13 +92,16 @@
         <Parameter Name="obj" Type="System.Reflection.Emit.EventToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the current instance is equal to the specified <see cref="T:System.Reflection.Emit.EventToken" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of <paramref name="obj" /> is equal to the value of the current instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.EventToken" /> to compare to the current instance.</param>
       </Docs>
@@ -114,12 +120,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates the hash code for this event.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the hash code for this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="op_Equality">
@@ -138,12 +147,15 @@
         <Parameter Name="b" Type="System.Reflection.Emit.EventToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.Emit.EventToken" /> structures are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> is equal to <paramref name="b" />; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.EventToken" /> to compare to <paramref name="b" />.</param>
         <param name="b">
@@ -166,12 +178,15 @@
         <Parameter Name="b" Type="System.Reflection.Emit.EventToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.Emit.EventToken" /> structures are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> is not equal to <paramref name="b" />; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.EventToken" /> to compare to <paramref name="b" />.</param>
         <param name="b">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/FieldBuilder.xml b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/FieldBuilder.xml
index 0cf862834ea..19ff4901aa1 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/FieldBuilder.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/FieldBuilder.xml
@@ -147,12 +147,15 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the custom attributes defined for this field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Object" /> representing all the custom attributes of the constructor represented by this <see cref="T:System.Reflection.Emit.FieldBuilder" /> instance.</para>
+        </returns>
         <param name="inherit">
           <attribution license="cc4" from="Microsoft" modified="false" />Controls inheritance of custom attributes from base classes. </param>
       </Docs>
@@ -174,12 +177,15 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the custom attributes defined for this field identified by the given type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Object" /> representing all the custom attributes of the constructor represented by this <see cref="T:System.Reflection.Emit.FieldBuilder" /> instance.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The custom attribute type. </param>
         <param name="inherit">
@@ -200,12 +206,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'FieldToken'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the token representing this field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the <see cref="T:System.Reflection.Emit.FieldToken" /> object that represents the token for this field.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetValue">
@@ -224,7 +233,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the field is static, the <paramref name="obj" /> parameter is ignored. For non-static fields, <paramref name="obj" /> should be an instance of a class that inherits or declares the field.</para>
@@ -235,6 +243,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the value of the field supported by the given object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> containing the value of the field reflected by this instance.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object on which to access the field. </param>
       </Docs>
@@ -256,12 +268,15 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether an attribute having the specified type is defined on a field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if one or more instance of <paramref name="attributeType" /> is defined on this field; otherwise, false.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the attribute. </param>
         <param name="inherit">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/FieldToken.xml b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/FieldToken.xml
index 0c22d6912aa..4b3492a9e66 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/FieldToken.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/FieldToken.xml
@@ -64,12 +64,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if an object is an instance of FieldToken and is equal to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if <paramref name="obj" /> is an instance of FieldToken and is equal to this object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to this FieldToken. </param>
       </Docs>
@@ -89,13 +92,16 @@
         <Parameter Name="obj" Type="System.Reflection.Emit.FieldToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the current instance is equal to the specified <see cref="T:System.Reflection.Emit.FieldToken" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of <paramref name="obj" /> is equal to the value of the current instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.FieldToken" /> to compare to the current instance.</param>
       </Docs>
@@ -114,12 +120,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates the hash code for this field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the hash code for this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="op_Equality">
@@ -138,12 +147,15 @@
         <Parameter Name="b" Type="System.Reflection.Emit.FieldToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.Emit.FieldToken" /> structures are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> is equal to <paramref name="b" />; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.FieldToken" /> to compare to <paramref name="b" />.</param>
         <param name="b">
@@ -166,12 +178,15 @@
         <Parameter Name="b" Type="System.Reflection.Emit.FieldToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.Emit.FieldToken" /> structures are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> is not equal to <paramref name="b" />; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.FieldToken" /> to compare to <paramref name="b" />.</param>
         <param name="b">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/GenericTypeParameterBuilder.xml b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/GenericTypeParameterBuilder.xml
index 6b9c2ea2192..b0d52ccd49c 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/GenericTypeParameterBuilder.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/GenericTypeParameterBuilder.xml
@@ -196,12 +196,15 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether the given object is an instance of EventToken and is equal to the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if <paramref name="o" /> is an instance of EventToken and equals the current instance; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be compared with the current instance.</param>
       </Docs>
@@ -338,7 +341,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -348,6 +350,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Not supported for incomplete generic type parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Not supported for incomplete generic type parameters.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />Not supported.</param>
       </Docs>
@@ -367,7 +373,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -377,6 +382,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Not supported for incomplete generic type parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Not supported for incomplete generic type parameters.</para>
+        </returns>
         <param name="inherit">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies whether to search this member's inheritance chain to find the attributes.</param>
       </Docs>
@@ -397,7 +406,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -407,6 +415,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Not supported for incomplete generic type parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Not supported for incomplete generic type parameters.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of attribute to search for. Only attributes that are assignable to this type are returned.</param>
         <param name="inherit">
@@ -426,7 +438,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -436,6 +447,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Throws a <see cref="T:System.NotSupportedException" /> in all cases. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type referred to by the current array type, pointer type, or ByRef type; or null if the current type is not an array type, is not a pointer type, and is not passed by reference.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetEvent">
@@ -454,7 +469,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -464,6 +478,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Not supported for incomplete generic type parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Not supported for incomplete generic type parameters.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />Not supported.</param>
         <param name="bindingAttr">
@@ -483,7 +501,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is not supported for incomplete generic type parameters. Retrieve the type parameter from the completed generic type definition and then use reflection on the retrieved type.</para>
@@ -492,6 +509,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Not supported for incomplete generic type parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Not supported for incomplete generic type parameters.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetEvents">
@@ -509,7 +530,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -519,6 +539,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Not supported for incomplete generic type parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Not supported for incomplete generic type parameters.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />Not supported.</param>
       </Docs>
@@ -539,7 +563,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -549,6 +572,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Not supported for incomplete generic type parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Not supported for incomplete generic type parameters.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />Not supported.</param>
         <param name="bindingAttr">
@@ -570,7 +597,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -580,6 +606,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Not supported for incomplete generic type parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Not supported for incomplete generic type parameters.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />Not supported.</param>
       </Docs>
@@ -597,7 +627,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -607,6 +636,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Not valid for generic type parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Not valid for generic type parameters.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetGenericParameterConstraints">
@@ -641,7 +674,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -651,6 +683,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Not valid for generic type parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Not valid for generic type parameters.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -666,12 +702,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a 32-bit integer hash code for the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetInterface">
@@ -690,7 +729,6 @@
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -700,6 +738,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Not supported for incomplete generic type parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Not supported for incomplete generic type parameters.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the interface.</param>
         <param name="ignoreCase">
@@ -726,7 +768,6 @@
         <Parameter Name="interfaceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is not supported for incomplete generic type parameters. Retrieve the type parameter from the completed generic type definition and then use reflection on the retrieved type.</para>
@@ -735,6 +776,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Not supported for incomplete generic type parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Not supported for incomplete generic type parameters.</para>
+        </returns>
         <param name="interfaceType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> object that represents the interface type for which the mapping is to be retrieved.</param>
       </Docs>
@@ -752,7 +797,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -762,6 +806,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Not supported for incomplete generic type parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Not supported for incomplete generic type parameters.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetMember">
@@ -781,7 +829,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is not supported for incomplete generic type parameters. Retrieve the type parameter from the completed generic type definition and then use reflection on the retrieved type.</para>
@@ -790,6 +837,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Not supported for incomplete generic type parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Not supported for incomplete generic type parameters.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />Not supported.</param>
         <param name="type">
@@ -813,7 +864,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -823,6 +873,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Not supported for incomplete generic type parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Not supported for incomplete generic type parameters.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />Not supported.</param>
       </Docs>
@@ -874,7 +928,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -884,6 +937,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Not supported for incomplete generic type parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Not supported for incomplete generic type parameters.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />Not supported.</param>
       </Docs>
@@ -904,7 +961,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -914,6 +970,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Not supported for incomplete generic type parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Not supported for incomplete generic type parameters.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />Not supported.</param>
         <param name="bindingAttr">
@@ -935,7 +995,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -945,6 +1004,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Not supported for incomplete generic type parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Not supported for incomplete generic type parameters.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />Not supported.</param>
       </Docs>
@@ -964,7 +1027,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -974,6 +1036,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Not supported for incomplete generic type parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Not supported for incomplete generic type parameters.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />Not supported.</param>
       </Docs>
@@ -1075,7 +1141,6 @@
         <Parameter Name="namedParameters" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1085,6 +1150,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Not supported for incomplete generic type parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Not supported for incomplete generic type parameters.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />Not supported. </param>
         <param name="invokeAttr">
@@ -1137,7 +1206,6 @@
         <Parameter Name="c" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is not supported for incomplete generic type parameters. Retrieve the type parameter from the completed generic type definition and then use reflection on the retrieved type.</para>
@@ -1146,6 +1214,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Throws a <see cref="T:System.NotSupportedException" /> exception in all cases.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Throws a <see cref="T:System.NotSupportedException" /> exception in all cases.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test.</param>
       </Docs>
@@ -1204,7 +1276,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1214,6 +1285,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Not supported for incomplete generic type parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Not supported for incomplete generic type parameters.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />Not supported.</param>
         <param name="inherit">
@@ -1366,7 +1441,6 @@
         <Parameter Name="c" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1376,6 +1450,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Not supported for incomplete generic type parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Not supported for incomplete generic type parameters.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />Not supported.</param>
       </Docs>
@@ -1412,7 +1490,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Type.MakeArrayType" /> method provides a way to generate array types for parameter lists. </para>
@@ -1421,6 +1498,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the type of a one-dimensional array whose element type is the generic type parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object that represents the type of a one-dimensional array whose element type is the generic type parameter.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MakeArrayType">
@@ -1438,7 +1519,6 @@
         <Parameter Name="rank" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Type.MakeArrayType" /> method provides a way to generate array types for parameter lists.</para>
@@ -1447,6 +1527,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the type of an array whose element type is the generic type parameter, with the specified number of dimensions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object that represents the type of an array whose element type is the generic type parameter, with the specified number of dimensions.</para>
+        </returns>
         <param name="rank">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of dimensions for the array.</param>
       </Docs>
@@ -1464,7 +1548,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Reflection.Emit.GenericTypeParameterBuilder.MakeByRefType" /> method provides a way to generate ref types (ByRef in Visual Basic) for parameter lists.</para>
@@ -1473,6 +1556,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Type" /> object that represents the current generic type parameter when passed as a reference parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object that represents the current generic type parameter when passed as a reference parameter.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MakeGenericType">
@@ -1496,12 +1583,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Not valid for incomplete generic type parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method is invalid for incomplete generic type parameters.</para>
+        </returns>
         <param name="typeArguments">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type arguments.</param>
       </Docs>
@@ -1519,7 +1609,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Reflection.Emit.GenericTypeParameterBuilder.MakePointerType" /> method provides a way to generate pointer types for parameter lists.</para>
@@ -1528,6 +1617,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Type" /> object that represents a pointer to the current generic type parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object that represents a pointer to the current generic type parameter.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Module">
@@ -1782,13 +1875,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of the current generic type parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the name of the generic type parameter.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TypeHandle">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/ILGenerator.xml b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/ILGenerator.xml
index 803cb5b9f6f..20cdf7c1dc4 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/ILGenerator.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/ILGenerator.xml
@@ -112,7 +112,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>A label pointing to the end of the try block.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creating an exception block records some information, but does not actually emit any Microsoft intermediate language (MSIL) onto the stream.</para>
@@ -121,6 +120,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins an exception block for a non-filtered exception.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The label for the end of the block. This will leave you in the correct place to execute finally blocks or to finish the try.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="BeginFaultBlock">
@@ -209,7 +212,6 @@
         <Parameter Name="localType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'LocalBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The local variable is created in the current lexical scope; for example, if code is being emitted in a for loop (For loop in Visual Basic), the scope of the variable is the loop.</para>
@@ -219,6 +221,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Declares a local variable of the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The declared local variable.</para>
+        </returns>
         <param name="localType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> object that represents the type of the local variable. </param>
       </Docs>
@@ -239,7 +245,6 @@
         <Parameter Name="pinned" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -250,6 +255,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Declares a local variable of the specified type, optionally pinning the object referred to by the variable.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.Emit.LocalBuilder" /> object that represents the local variable.</para>
+        </returns>
         <param name="localType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> object that represents the type of the local variable.</param>
         <param name="pinned">
@@ -270,7 +279,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>The newly defined label.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To set the position of the label within the stream, you must call <see cref="M:System.Reflection.Emit.ILGenerator.MarkLabel(System.Reflection.Emit.Label)" />.</para>
@@ -280,6 +288,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Declares a new label.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a new label that can be used as a token for branching.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Emit">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/Label.xml b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/Label.xml
index 87780d3649a..a78fcaeeee9 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/Label.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/Label.xml
@@ -43,12 +43,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks if the given object is an instance of Label and is equal to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns true if <paramref name="obj" /> is an instance of Label and is equal to this object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this Label instance. </param>
       </Docs>
@@ -68,13 +71,16 @@
         <Parameter Name="obj" Type="System.Reflection.Emit.Label" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the current instance is equal to the specified <see cref="T:System.Reflection.Emit.Label" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of <paramref name="obj" /> is equal to the value of the current instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.Label" /> to compare to the current instance.</param>
       </Docs>
@@ -93,12 +99,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates a hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a hash code for this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="op_Equality">
@@ -117,13 +126,16 @@
         <Parameter Name="b" Type="System.Reflection.Emit.Label" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.Emit.Label" /> structures are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> is equal to <paramref name="b" />; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.Label" /> to compare to <paramref name="b" />.</param>
         <param name="b">
@@ -146,13 +158,16 @@
         <Parameter Name="b" Type="System.Reflection.Emit.Label" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.Emit.Label" /> structures are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> is not equal to <paramref name="b" />; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.Label" /> to compare to <paramref name="b" />.</param>
         <param name="b">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/MethodBuilder.xml b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/MethodBuilder.xml
index a37acb387af..9400b080ae5 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/MethodBuilder.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/MethodBuilder.xml
@@ -217,7 +217,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -230,6 +229,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the number of generic type parameters for the current method, specifies their names, and returns an array of <see cref="T:System.Reflection.Emit.GenericTypeParameterBuilder" /> objects that can be used to define their constraints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.Emit.GenericTypeParameterBuilder" /> objects representing the type parameters of the generic method.</para>
+        </returns>
         <param name="names">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of strings that represent the names of the generic type parameters.</param>
       </Docs>
@@ -252,7 +255,6 @@
         <Parameter Name="strParamName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ParameterBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Reflection.Emit.ParameterBuilder" /> object returned by this method can be used to set the default value for a parameter or to apply custom attributes. </para>
@@ -265,6 +267,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the parameter attributes and the name of a parameter of this method, or of the return value of this method. Returns a ParameterBuilder that can be used to apply custom attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a ParameterBuilder object that represents a parameter of this method or the return value of this method.</para>
+        </returns>
         <param name="position">
           <attribution license="cc4" from="Microsoft" modified="false" />The position of the parameter in the parameter list. Parameters are indexed beginning with the number 1 for the first parameter; the number 0 represents the return value of the method. </param>
         <param name="attributes">
@@ -289,7 +295,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Equality is determined by having the same name, attributes, and signature.</para>
@@ -298,6 +303,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the given object is equal to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is an instance of MethodBuilder and is equal to this object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this MethodBuilder instance. </param>
       </Docs>
@@ -316,7 +325,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This always returns the current MethodBuilder object.</para>
@@ -325,6 +333,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Return the base implementation for a method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The base implementation of this method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetCustomAttributes">
@@ -343,12 +355,15 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the custom attributes defined for this method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an array of objects representing all the custom attributes of this method.</para>
+        </returns>
         <param name="inherit">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies whether to search this member's inheritance chain to find the custom attributes. </param>
       </Docs>
@@ -370,12 +385,15 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the custom attributes identified by the given type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an array of objects representing the attributes of this method that are of type <paramref name="attributeType" />.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The custom attribute type. </param>
         <param name="inherit">
@@ -395,7 +413,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -406,6 +423,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of <see cref="T:System.Reflection.Emit.GenericTypeParameterBuilder" /> objects that represent the type parameters of the method, if it is generic.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.Emit.GenericTypeParameterBuilder" /> objects representing the type parameters, if the method is generic, or null if the method is not generic. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetGenericMethodDefinition">
@@ -421,7 +442,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -432,6 +452,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns this method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current instance of <see cref="T:System.Reflection.Emit.MethodBuilder" />. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -448,12 +472,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash code for this method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for this method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetILGenerator">
@@ -470,12 +497,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ILGenerator'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an ILGenerator for this method with a default Microsoft intermediate language (MSIL) stream size of 64 bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an ILGenerator object for this method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetILGenerator">
@@ -494,12 +524,15 @@
         <Parameter Name="size" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ILGenerator'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an ILGenerator for this method with the specified Microsoft intermediate language (MSIL) stream size.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an ILGenerator object for this method.</para>
+        </returns>
         <param name="size">
           <attribution license="cc4" from="Microsoft" modified="false" />The size of the MSIL stream, in bytes. </param>
       </Docs>
@@ -518,12 +551,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the implementation flags for the method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the implementation flags for the method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetModule">
@@ -540,12 +576,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Reflection.Module'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a reference to the module that contains this method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a reference to the module that contains this method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetParameters">
@@ -562,12 +601,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the parameters of this method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of ParameterInfo objects that represent the parameters of the method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetToken">
@@ -584,12 +626,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'MethodToken'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the MethodToken that represents the token for this method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the MethodToken of this method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InitLocals">
@@ -638,7 +683,6 @@
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the method is static, the <paramref name="obj" /> parameter is ignored. For non-static methods, <paramref name="obj" /> should be an instance of a class that inherits or declares the method and must be the same type as this class. If the method has no parameters, the value of <paramref name="parameters" /> should be null. Otherwise the number, type, and order of elements in the parameters array should be identical to the number, type, and order of parameters for the method reflected by this instance.</para>
@@ -650,6 +694,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Dynamically invokes the method reflected by this instance on the given object, passing along the specified parameters, and under the constraints of the given binder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an object containing the return value of the invoked method.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object on which to invoke the specified method. If the method is static, this parameter is ignored. </param>
         <param name="invokeAttr">
@@ -679,12 +727,15 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks if the specified custom attribute type is defined.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified custom attribute type is defined; otherwise, false.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The custom attribute type. </param>
         <param name="inherit">
@@ -760,7 +811,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -770,6 +820,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a generic method constructed from the current generic method definition using the specified generic type arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodInfo" /> representing the generic method constructed from the current generic method definition using the specified generic type arguments.</para>
+        </returns>
         <param name="typeArguments">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Type" /> objects that represent the type arguments for the generic method.</param>
       </Docs>
@@ -1360,12 +1414,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns this MethodBuilder instance as a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a string containing the name, attributes, method signature, exceptions, and local signature of this method followed by the current Microsoft intermediate language (MSIL) stream.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/MethodToken.xml b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/MethodToken.xml
index e903e0d3b7c..e563d046f81 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/MethodToken.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/MethodToken.xml
@@ -64,12 +64,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether the given object is equal to this MethodToken object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is an instance of MethodToken and is equal to this object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to this object. </param>
       </Docs>
@@ -89,13 +92,16 @@
         <Parameter Name="obj" Type="System.Reflection.Emit.MethodToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the current instance is equal to the specified <see cref="T:System.Reflection.Emit.MethodToken" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of <paramref name="obj" /> is equal to the value of the current instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.MethodToken" /> to compare to the current instance.</param>
       </Docs>
@@ -114,12 +120,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the generated hash code for this method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the hash code for this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="op_Equality">
@@ -138,12 +147,15 @@
         <Parameter Name="b" Type="System.Reflection.Emit.MethodToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.Emit.MethodToken" /> structures are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> is equal to <paramref name="b" />; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.MethodToken" /> to compare to <paramref name="b" />.</param>
         <param name="b">
@@ -166,12 +178,15 @@
         <Parameter Name="b" Type="System.Reflection.Emit.MethodToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.Emit.MethodToken" /> structures are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> is not equal to <paramref name="b" />; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.MethodToken" /> to compare to <paramref name="b" />.</param>
         <param name="b">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/ModuleBuilder.xml b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/ModuleBuilder.xml
index 0ee71f03643..cbd887143cb 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/ModuleBuilder.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/ModuleBuilder.xml
@@ -108,7 +108,6 @@
         <Parameter Name="documentType" Type="System.Guid" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Diagnostics.SymbolStore.ISymbolDocumentWriter'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -119,6 +118,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a document for source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The defined document.</para>
+        </returns>
         <param name="url">
           <attribution license="cc4" from="Microsoft" modified="false" />The URL for the document. </param>
         <param name="language">
@@ -147,7 +150,6 @@
         <Parameter Name="underlyingType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'EnumBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The defined enum is a derived class of <see cref="T:System.Enum" />. The <paramref name="value__" /> field has <see cref="F:System.Reflection.FieldAttributes.Private" /> and <see cref="F:System.Reflection.FieldAttributes.SpecialName" /> attributes set.</para>
@@ -163,6 +165,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines an enumeration type that is a value type with a single non-static field called <paramref name="value__" /> of the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The defined enumeration.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The full path of the enumeration type. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="visibility">
@@ -190,7 +196,6 @@
         <Parameter Name="parameterTypes" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MethodBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The global method that this method defines is not usable until you call <see cref="M:System.Reflection.Emit.ModuleBuilder.CreateGlobalFunctions" />.</para>
@@ -202,6 +207,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a global method with the specified name, attributes, return type, and parameter types.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The defined global method.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the method. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="attributes">
@@ -232,7 +241,6 @@
         <Parameter Name="parameterTypes" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MethodBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You cannot use the global method that this method defines until you call <see cref="M:System.Reflection.Emit.ModuleBuilder.CreateGlobalFunctions" />.</para>
@@ -244,6 +252,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a global method with the specified name, attributes, calling convention, return type, and parameter types.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The defined global method.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the method. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="attributes">
@@ -279,7 +291,6 @@
         <Parameter Name="optionalParameterTypeCustomModifiers" Type="System.Type[][]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -293,6 +304,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a global method with the specified name, attributes, calling convention, return type, custom modifiers for the return type, parameter types, and custom modifiers for the parameter types.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The defined global method.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the method. <paramref name="name" /> cannot contain embedded null characters. </param>
         <param name="attributes">
@@ -331,7 +346,6 @@
         <Parameter Name="attributes" Type="System.Reflection.FieldAttributes" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'FieldBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -345,6 +359,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines an initialized data field in the .sdata section of the portable executable (PE) file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A field to reference the data.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name used to refer to the data. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="data">
@@ -425,7 +443,6 @@
         <Parameter Name="nativeCharSet" Type="System.Runtime.InteropServices.CharSet" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MethodBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Some DLL import attributes (see the description of System.Runtime.InteropServices.DllImportAttribute) cannot be specified as arguments to this method. Such attributes should be set by emitting a custom attribute for the method. For example, the DLL import attribute PreserveSig is set by emitting a custom attribute.</para>
@@ -437,6 +454,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a PInvoke method with the specified name, the name of the DLL in which the method is defined, the attributes of the method, the calling convention of the method, the return type of the method, the types of the parameters of the method, and the PInvoke flags.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The defined PInvoke method.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the PInvoke method. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="dllName">
@@ -479,7 +500,6 @@
         <Parameter Name="nativeCharSet" Type="System.Runtime.InteropServices.CharSet" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MethodBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Some DLL import attributes (see the description of <see cref="T:System.Runtime.InteropServices.DllImportAttribute" />) cannot be specified as arguments to this method. Such attributes should be set by emitting a custom attribute for the method. For example, the DLL import attribute PreserveSig is set by emitting a custom attribute.</para>
@@ -491,6 +511,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a PInvoke method with the specified name, the name of the DLL in which the method is defined, the attributes of the method, the calling convention of the method, the return type of the method, the types of the parameters of the method, and the PInvoke flags.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The defined PInvoke method.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the PInvoke method. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="dllName">
@@ -528,7 +552,6 @@
         <Parameter Name="description" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Resources.IResourceWriter'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The caller must not call the ResourceWriter.Generate() and ResourceWriter.Close() methods, because these methods are called by ModuleBuilder.Save when the dynamic assembly is written to disk.</para>
@@ -541,6 +564,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines the named managed embedded resource to be stored in this module.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A resource writer for the defined resource.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the resource. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="description">
@@ -565,7 +592,6 @@
         <Parameter Name="attribute" Type="System.Reflection.ResourceAttributes" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Resources.IResourceWriter'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The caller must not call the ResourceWriter.Generate() and ResourceWriter.Close() methods, because these methods are called by ModuleBuilder.Save when the dynamic assembly is written to disk.</para>
@@ -578,6 +604,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines the named managed embedded resource with the given attributes that is to be stored in this module.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A resource writer for the defined resource.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the resource. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="description">
@@ -602,7 +632,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TypeBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Type names must be unique within an assembly. You cannot have two types with the same name in two different modules of an assembly.</para>
@@ -614,6 +643,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Constructs a TypeBuilder for a private type with the specified name in this module. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A private type with the specified name.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The full path of the type, including the namespace. <paramref name="name" /> cannot contain embedded nulls. </param>
       </Docs>
@@ -635,7 +668,6 @@
         <Parameter Name="attr" Type="System.Reflection.TypeAttributes" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TypeBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Type names must be unique within an assembly. You cannot have two types with the same name in two different modules of an assembly.</para>
@@ -647,6 +679,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Constructs a TypeBuilder given the type name and the type attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A TypeBuilder created with all of the requested attributes.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The full path of the type. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="attr">
@@ -671,7 +707,6 @@
         <Parameter Name="parent" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TypeBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Type names must be unique within an assembly. You cannot have two types with the same name in two different modules of an assembly.</para>
@@ -683,6 +718,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Constructs a TypeBuilder given type name, its attributes, and the type that the defined type extends.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A TypeBuilder created with all of the requested attributes.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The full path of the type. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="attr">
@@ -710,7 +749,6 @@
         <Parameter Name="typesize" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TypeBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Type names must be unique within an assembly. It is forbidden to have two types with the same name in two different modules of an assembly.</para>
@@ -722,6 +760,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Constructs a TypeBuilder given the type name, the attributes, the type that the defined type extends, and the total size of the type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A TypeBuilder object.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The full path of the type. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="attr">
@@ -751,7 +793,6 @@
         <Parameter Name="packsize" Type="System.Reflection.Emit.PackingSize" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TypeBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Type names must be unique within an assembly. You cannot have two types with the same name in two different modules of an assembly.</para>
@@ -763,6 +804,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Constructs a TypeBuilder given the type name, the attributes, the type that the defined type extends, and the packing size of the type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A TypeBuilder object.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The full path of the type. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="attr">
@@ -797,7 +842,6 @@
         <Parameter Name="interfaces" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TypeBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Type names must be unique within an assembly. You cannot have two types with the same name in two different modules of an assembly.</para>
@@ -809,6 +853,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Constructs a TypeBuilder given the type name, attributes, the type that the defined type extends, and the interfaces that the defined type implements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A TypeBuilder created with all of the requested attributes.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The full path of the type. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="attr">
@@ -839,7 +887,6 @@
         <Parameter Name="typesize" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TypeBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Type names must be unique within an assembly. You cannot have two types with the same name in two different modules of an assembly.</para>
@@ -851,6 +898,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Constructs a TypeBuilder given the type name, attributes, the type that the defined type extends, the packing size of the defined type, and the total size of the defined type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A TypeBuilder created with all of the requested attributes.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The full path of the type. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="attr">
@@ -881,7 +932,6 @@
         <Parameter Name="attributes" Type="System.Reflection.FieldAttributes" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'FieldBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -895,6 +945,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines an uninitialized data field in the .sdata section of the portable executable (PE) file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A field to reference the data.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name used to refer to the data. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="size">
@@ -979,12 +1033,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether this instance is equal to the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> equals the type and value of this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance, or null.</param>
       </Docs>
@@ -1036,7 +1093,6 @@
         <Parameter Name="parameterTypes" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.MethodInfo'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>GetArrayMethod is useful when you have an array of a type whose definition has not been completed and you want to access methods defined on <see cref="T:System.Array" />. For example, you might define a type and want to define a method that takes an array of the type as a parameter. In order to access the elements of the array, you will need to call methods of the <see cref="T:System.Array" /> class.</para>
@@ -1045,6 +1101,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the named method on an array class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The named method on an array class.</para>
+        </returns>
         <param name="arrayClass">
           <attribution license="cc4" from="Microsoft" modified="false" />An array class. </param>
         <param name="methodName">
@@ -1077,7 +1137,6 @@
         <Parameter Name="parameterTypes" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MethodToken'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is similar to <see cref="M:System.Reflection.Emit.ModuleBuilder.GetArrayMethod(System.Type,System.String,System.Reflection.CallingConventions,System.Type,System.Type[])" />, except that it returns the token of the array method instead of the method itself.</para>
@@ -1086,6 +1145,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the token for the named method on an array class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The token for the named method on an array class.</para>
+        </returns>
         <param name="arrayClass">
           <attribution license="cc4" from="Microsoft" modified="false" />The object for the array. </param>
         <param name="methodName">
@@ -1119,12 +1182,15 @@
         <Parameter Name="con" Type="System.Reflection.ConstructorInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MethodToken'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the token used to identify the specified constructor within this module.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The token used to identify the specified constructor within this module.</para>
+        </returns>
         <param name="con">
           <attribution license="cc4" from="Microsoft" modified="false" />The constructor to get a token for. </param>
       </Docs>
@@ -1143,12 +1209,15 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the custom attributes that have been applied to the current <see cref="T:System.Reflection.Emit.ModuleBuilder" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains the custom attributes; the array is empty if there are no attributes.</para>
+        </returns>
         <param name="inherit">
           <attribution license="cc4" from="Microsoft" modified="false" />This argument is ignored for objects of this type.</param>
       </Docs>
@@ -1168,12 +1237,15 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the custom attributes that have been applied to the current <see cref="T:System.Reflection.Emit.ModuleBuilder" />, and that derive from a specified attribute type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains the custom attributes that are derived, at any level, from <paramref name="attributeType" />; the array is empty if there are no such attributes.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The base type from which attributes derive.</param>
         <param name="inherit">
@@ -1195,7 +1267,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When you emit dynamic assemblies, fields in the .sdata region of the portable executable (PE) file are defined by using the <see cref="M:System.Reflection.Emit.ModuleBuilder.DefineInitializedData(System.String,System.Byte[],System.Reflection.FieldAttributes)" /> or <see cref="M:System.Reflection.Emit.ModuleBuilder.DefineUninitializedData(System.String,System.Int32,System.Reflection.FieldAttributes)" /> methods. </para>
@@ -1207,6 +1278,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a module-level field, defined in the .sdata region of the portable executable (PE) file, that has the specified name and binding attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A field that has the specified name and binding attributes, or null if the field does not exist.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The field name. </param>
         <param name="bindingAttr">
@@ -1227,7 +1302,6 @@
         <Parameter Name="bindingFlags" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When you emit dynamic assemblies, fields in the .sdata region of the portable executable (PE) file are defined by using the <see cref="M:System.Reflection.Emit.ModuleBuilder.DefineInitializedData(System.String,System.Byte[],System.Reflection.FieldAttributes)" /> or <see cref="M:System.Reflection.Emit.ModuleBuilder.DefineUninitializedData(System.String,System.Int32,System.Reflection.FieldAttributes)" /> methods. </para>
@@ -1239,6 +1313,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all fields defined in the .sdata region of the portable executable (PE) file that match the specified binding flags.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of fields that match the specified flags; the array is empty if no such fields exist.</para>
+        </returns>
         <param name="bindingFlags">
           <attribution license="cc4" from="Microsoft" modified="false" />A combination of the BindingFlags bit flags used to control the search.</param>
       </Docs>
@@ -1259,12 +1337,15 @@
         <Parameter Name="field" Type="System.Reflection.FieldInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'FieldToken'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the token used to identify the specified field within this module.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The token used to identify the specified field within this module.</para>
+        </returns>
         <param name="field">
           <attribution license="cc4" from="Microsoft" modified="false" />The field to get a token for. </param>
       </Docs>
@@ -1281,12 +1362,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetMethodImpl">
@@ -1308,7 +1392,6 @@
         <Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method provides the implementation for all overloads of the inherited <see cref="Overload:System.Reflection.Module.GetMethod" /> method. Use the inherited <see cref="Overload:System.Reflection.Module.GetMethod" /> method to get methods that have been declared at the module level. Module-level methods are defined in emitted code by using the <see cref="Overload:System.Reflection.Emit.ModuleBuilder.DefineGlobalMethod" /> method. </para>
@@ -1320,6 +1403,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the module-level method that matches the specified criteria.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A method that is defined at the module level, and matches the specified criteria; or null if such a method does not exist.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The method name. </param>
         <param name="bindingAttr">
@@ -1348,7 +1435,6 @@
         <Parameter Name="bindingFlags" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Module-level methods are defined in emitted code by using the <see cref="Overload:System.Reflection.Emit.ModuleBuilder.DefineGlobalMethod" /> method. </para>
@@ -1360,6 +1446,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the methods that have been defined at the module level for the current <see cref="T:System.Reflection.Emit.ModuleBuilder" />, and that match the specified binding flags.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains all the module-level methods that match <paramref name="bindingFlags" />.</para>
+        </returns>
         <param name="bindingFlags">
           <attribution license="cc4" from="Microsoft" modified="false" />A combination of BindingFlags bit flags used to control the search.</param>
       </Docs>
@@ -1380,12 +1470,15 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MethodToken'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the token used to identify the specified method within this module.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The token used to identify the specified method within this module.</para>
+        </returns>
         <param name="method">
           <attribution license="cc4" from="Microsoft" modified="false" />The method to get a token for. </param>
       </Docs>
@@ -1406,7 +1499,6 @@
         <Parameter Name="sigHelper" Type="System.Reflection.Emit.SignatureHelper" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SignatureToken'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method defines a metadata token for the signature described by <paramref name="sigHelper" />.</para>
@@ -1415,6 +1507,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a token for the signature that is defined by the specified <see cref="T:System.Reflection.Emit.SignatureHelper" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A token for the defined signature.</para>
+        </returns>
         <param name="sigHelper">
           <attribution license="cc4" from="Microsoft" modified="false" />The signature. </param>
       </Docs>
@@ -1436,12 +1532,15 @@
         <Parameter Name="sigLength" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SignatureToken'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a token for the signature that has the specified character array and signature length.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A token for the specified signature.</para>
+        </returns>
         <param name="sigBytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The signature binary large object (BLOB). </param>
         <param name="sigLength">
@@ -1464,7 +1563,6 @@
         <Parameter Name="str" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'StringToken'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="str" /> has already been defined, the existing token will be returned.</para>
@@ -1473,6 +1571,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the token of the given string in the module’s constant pool.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The token of the string in the constant pool.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to add to the module's constant pool. </param>
       </Docs>
@@ -1491,7 +1593,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Diagnostics.SymbolStore.ISymbolWriter'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1502,6 +1603,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the symbol writer associated with this dynamic module.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The symbol writer associated with this dynamic module.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetType">
@@ -1525,7 +1630,6 @@
         <Parameter Name="className" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Do not use this method to generate array types, pointer types, or byref types. Use the <see cref="M:System.Reflection.Emit.TypeBuilder.MakeArrayType" />, <see cref="M:System.Reflection.Emit.TypeBuilder.MakePointerType" />, and <see cref="M:System.Reflection.Emit.TypeBuilder.MakeByRefType" /> methods instead.</para>
@@ -1537,6 +1641,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the named type defined in the module.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The requested type, if the type is defined in this module; otherwise, null.</para>
+        </returns>
         <param name="className">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Type" /> to get. </param>
       </Docs>
@@ -1563,7 +1671,6 @@
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Do not use this method to generate array types, pointer types, or byref types. Use the <see cref="M:System.Reflection.Emit.TypeBuilder.MakeArrayType" />, <see cref="M:System.Reflection.Emit.TypeBuilder.MakePointerType" />, and <see cref="M:System.Reflection.Emit.TypeBuilder.MakeByRefType" /> methods instead.</para>
@@ -1575,6 +1682,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the named type defined in the module, optionally ignoring the case of the type name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The requested type, if the type is defined in this module; otherwise, null.</para>
+        </returns>
         <param name="className">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Type" /> to get. </param>
         <param name="ignoreCase">
@@ -1604,7 +1715,6 @@
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="throwOnError" /> parameter only affects what happens when the type is not found. It does not affect any other exceptions that might be thrown. In particular, if the type is found but cannot be loaded, <see cref="T:System.TypeLoadException" /> can be thrown even if <paramref name="throwOnError" /> is false.</para>
@@ -1617,6 +1727,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the named type defined in the module, optionally ignoring the case of the type name. Optionally throws an exception if the type is not found.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified type, if the type is declared in this module; otherwise, null.</para>
+        </returns>
         <param name="className">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Type" /> to get. </param>
         <param name="throwOnError">
@@ -1639,7 +1753,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>ReflectionTypeLoadException is a special class load exception. The ReflectionTypeLoadException.Types property contains the array of classes that were defined in the module and loaded. This array can contain some null values. The ReflectionTypeLoadException.LoaderExceptions property is an array of exceptions that represent the exceptions that were thrown by the class loader. The holes in the class array line up with the exceptions.</para>
@@ -1652,6 +1765,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the classes defined within this module.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains the types defined within the module that is reflected by this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetTypeToken">
@@ -1670,7 +1787,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TypeToken'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is useful for clients of the <see cref="T:System.Reflection.Emit.MethodRental" /> class who want to directly modify the body of a method.</para>
@@ -1679,6 +1795,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the token used to identify the type with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The token used to identify the type with the specified name within this module.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the class, including the namespace. </param>
       </Docs>
@@ -1699,7 +1819,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TypeToken'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tokens are used in Microsoft intermediate language (MSIL) instructions to identify objects. Tokens are relative to the module in which they are contained. For example, the token value for String is likely to be different from module to module. When GetTypeToken is invoked, a reference is added to the module. The reference becomes a permanent part of the module; multiple calls with the same argument have no additional effect.</para>
@@ -1708,6 +1827,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the token used to identify the specified type within this module.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The token used to identify the given type within this module.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type object that represents the class type. </param>
       </Docs>
@@ -1727,12 +1850,15 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the specified attribute type has been applied to this module.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if one or more instances of <paramref name="attributeType" /> have been applied to this module; otherwise, false.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of custom attribute to test for.</param>
         <param name="inherit">
@@ -1751,12 +1877,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the object is a resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object is a resource; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsTransient">
@@ -1773,12 +1902,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether this dynamic module is transient.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this dynamic module is transient; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MetadataToken">
@@ -1869,7 +2001,6 @@
         <Parameter Name="genericMethodArguments" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Type.GetGenericArguments" /> method on the type where <paramref name="metadataToken" /> is in scope to obtain an array of generic type arguments for <paramref name="genericTypeArguments" />. Use the <see cref="M:System.Reflection.MethodInfo.GetGenericArguments" /> method on the method where <paramref name="metadataToken" /> is in scope to obtain an array of generic type arguments for <paramref name="genericTypeArguments" />. It is always safe to provide these arguments, even when they are not needed.</para>
@@ -1882,6 +2013,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the field identified by the specified metadata token, in the context defined by the specified generic type parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.FieldInfo" /> object representing the field that is identified by the specified metadata token.</para>
+        </returns>
         <param name="metadataToken">
           <attribution license="cc4" from="Microsoft" modified="false" />A metadata token that identifies a field in the module.</param>
         <param name="genericTypeArguments">
@@ -1906,7 +2041,6 @@
         <Parameter Name="genericMethodArguments" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Type.GetGenericArguments" /> method on the type where <paramref name="metadataToken" /> is in scope to obtain an array of generic type arguments for <paramref name="genericTypeArguments" />. Use the <see cref="M:System.Reflection.MethodInfo.GetGenericArguments" /> method on the method where <paramref name="metadataToken" /> is in scope to obtain an array of generic type arguments for <paramref name="genericTypeArguments" />. It is always safe to provide these arguments, even when they are not needed.</para>
@@ -1919,6 +2053,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the type or member identified by the specified metadata token, in the context defined by the specified generic type parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MemberInfo" /> object representing the type or member that is identified by the specified metadata token.</para>
+        </returns>
         <param name="metadataToken">
           <attribution license="cc4" from="Microsoft" modified="false" />A metadata token that identifies a type or member in the module.</param>
         <param name="genericTypeArguments">
@@ -1943,7 +2081,6 @@
         <Parameter Name="genericMethodArguments" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Type.GetGenericArguments" /> method on the type where <paramref name="metadataToken" /> is in scope to obtain an array of generic type arguments for <paramref name="genericTypeArguments" />. Use the <see cref="M:System.Reflection.MethodInfo.GetGenericArguments" /> method on the method where <paramref name="metadataToken" /> is in scope to obtain an array of generic type arguments for <paramref name="genericMethodArguments" />. It is always safe to provide these arguments, even when they are not needed. </para>
@@ -1956,6 +2093,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the method or constructor identified by the specified metadata token, in the context defined by the specified generic type parameters. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodBase" /> object representing the method that is identified by the specified metadata token.</para>
+        </returns>
         <param name="metadataToken">
           <attribution license="cc4" from="Microsoft" modified="false" />A metadata token that identifies a method or constructor in the module.</param>
         <param name="genericTypeArguments">
@@ -1978,7 +2119,6 @@
         <Parameter Name="metadataToken" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1989,6 +2129,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the signature blob identified by a metadata token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of bytes representing the signature blob.</para>
+        </returns>
         <param name="metadataToken">
           <attribution license="cc4" from="Microsoft" modified="false" />A metadata token that identifies a signature in the module.</param>
       </Docs>
@@ -2007,7 +2151,6 @@
         <Parameter Name="metadataToken" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -2018,6 +2161,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the string identified by the specified metadata token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing a string value from the metadata string heap.</para>
+        </returns>
         <param name="metadataToken">
           <attribution license="cc4" from="Microsoft" modified="false" />A metadata token that identifies a string in the string heap of the module.</param>
       </Docs>
@@ -2038,7 +2185,6 @@
         <Parameter Name="genericMethodArguments" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Type.GetGenericArguments" /> method on the type where <paramref name="metadataToken" /> is in scope to obtain an array of generic type arguments for <paramref name="genericTypeArguments" />. Use the <see cref="M:System.Reflection.MethodInfo.GetGenericArguments" /> method on the method where <paramref name="metadataToken" /> is in scope to obtain an array of generic type arguments for <paramref name="genericTypeArguments" />. It is always safe to provide these arguments, even when they are not needed.</para>
@@ -2051,6 +2197,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the type identified by the specified metadata token, in the context defined by the specified generic type parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object representing the type that is identified by the specified metadata token.</para>
+        </returns>
         <param name="metadataToken">
           <attribution license="cc4" from="Microsoft" modified="false" />A metadata token that identifies a type in the module.</param>
         <param name="genericTypeArguments">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/OpCode.xml b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/OpCode.xml
index e39f8f03739..8e38819f80b 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/OpCode.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/OpCode.xml
@@ -43,12 +43,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether the given object is equal to this Opcode.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is an instance of Opcode and is equal to this object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to this object. </param>
       </Docs>
@@ -68,13 +71,16 @@
         <Parameter Name="obj" Type="System.Reflection.Emit.OpCode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the current instance is equal to the specified <see cref="T:System.Reflection.Emit.OpCode" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of <paramref name="obj" /> is equal to the value of the current instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.OpCode" /> to compare to the current instance.</param>
       </Docs>
@@ -114,12 +120,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the generated hash code for this Opcode.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the hash code for this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Name">
@@ -159,13 +168,16 @@
         <Parameter Name="b" Type="System.Reflection.Emit.OpCode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.Emit.OpCode" /> structures are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> is equal to <paramref name="b" />; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.OpCode" /> to compare to <paramref name="b" />.</param>
         <param name="b">
@@ -188,13 +200,16 @@
         <Parameter Name="b" Type="System.Reflection.Emit.OpCode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.Emit.OpCode" /> structures are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> is not equal to <paramref name="b" />; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.OpCode" /> to compare to <paramref name="b" />.</param>
         <param name="b">
@@ -320,12 +335,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns this Opcode as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a <see cref="T:System.String" /> containing the name of this Opcode.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/OpCodes.xml b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/OpCodes.xml
index cf139abd72f..fc2ea7c71fa 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/OpCodes.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/OpCodes.xml
@@ -16171,7 +16171,6 @@ callvirt m</code>
         <Parameter Name="inst" Type="System.Reflection.Emit.OpCode" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to find which MSIL opcodes are "short form", for use in optimized code.</para>
@@ -16195,6 +16194,10 @@ callvirt m</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns true or false if the supplied opcode takes a single byte argument.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True or false.</para>
+        </returns>
         <param name="inst">
           <attribution license="cc4" from="Microsoft" modified="false" />An instance of an Opcode object. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/ParameterBuilder.xml b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/ParameterBuilder.xml
index 7640e686c3b..e5beab6bbd1 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/ParameterBuilder.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/ParameterBuilder.xml
@@ -79,12 +79,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ParameterToken'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the token for this parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the token for this parameter.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsIn">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/ParameterToken.xml b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/ParameterToken.xml
index fff8f68338f..0a867ec601d 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/ParameterToken.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/ParameterToken.xml
@@ -64,12 +64,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks if the given object is an instance of ParameterToken and is equal to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is an instance of ParameterToken and equals the current instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to this object. </param>
       </Docs>
@@ -89,13 +92,16 @@
         <Parameter Name="obj" Type="System.Reflection.Emit.ParameterToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the current instance is equal to the specified <see cref="T:System.Reflection.Emit.ParameterToken" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of <paramref name="obj" /> is equal to the value of the current instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.ParameterToken" /> to compare to the current instance.</param>
       </Docs>
@@ -114,12 +120,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates the hash code for this parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the hash code for this parameter.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="op_Equality">
@@ -138,12 +147,15 @@
         <Parameter Name="b" Type="System.Reflection.Emit.ParameterToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.Emit.ParameterToken" /> structures are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> is equal to <paramref name="b" />; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.ParameterToken" /> to compare to <paramref name="b" />.</param>
         <param name="b">
@@ -166,12 +178,15 @@
         <Parameter Name="b" Type="System.Reflection.Emit.ParameterToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.Emit.ParameterToken" /> structures are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> is not equal to <paramref name="b" />; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.ParameterToken" /> to compare to <paramref name="b" />.</param>
         <param name="b">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/PropertyBuilder.xml b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/PropertyBuilder.xml
index e22c89368c7..f2e3a282dab 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/PropertyBuilder.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/PropertyBuilder.xml
@@ -171,7 +171,6 @@
         <Parameter Name="nonPublic" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To get the accessors of a property, reflect on the property's parent type using Type.GetType or Assembly.GetType, retrieve the Reflection property object from the type, and call PropertyInfo.GetAccessors.</para>
@@ -180,6 +179,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of the public and non-public get and set accessors on this property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type MethodInfo containing the matching public or non-public accessors, or an empty array if matching accessors do not exist on this property.</para>
+        </returns>
         <param name="nonPublic">
           <attribution license="cc4" from="Microsoft" modified="false" />Indicates whether non-public methods should be returned in the MethodInfo array. true if non-public methods are to be included; otherwise, false. </param>
       </Docs>
@@ -200,7 +203,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reflect on the property's parent type using Type.GetType or Assembly.GetType, retrieve the Reflection property object from the type, and call PropertyInfo.GetCustomAttributes.</para>
@@ -209,6 +211,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of all the custom attributes for this property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of all the custom attributes.</para>
+        </returns>
         <param name="inherit">
           <attribution license="cc4" from="Microsoft" modified="false" />If true, walks up this property's inheritance chain to find the custom attributes </param>
       </Docs>
@@ -230,7 +236,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reflect on the property's parent type using Type.GetType or Assembly.GetType, retrieve the Reflection property object from the type, and call PropertyInfo.GetCustomAttributes.</para>
@@ -239,6 +244,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of custom attributes identified by <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of custom attributes defined on this reflected member, or null if no attributes are defined on this member.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of custom attributes identified by type. </param>
         <param name="inherit">
@@ -261,7 +270,6 @@
         <Parameter Name="nonPublic" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To get the getter of a property, reflect on the property's parent type using Type.GetType or Assembly.GetType, retrieve the Reflection property object from the type, and call PropertyInfo.GetGetMethod.</para>
@@ -270,6 +278,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the public and non-public get accessor for this property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A MethodInfo object representing the get accessor for this property, if <paramref name="nonPublic" /> is true. Returns null if <paramref name="nonPublic" /> is false and the get accessor is non-public, or if <paramref name="nonPublic" /> is true but no get accessors exist.</para>
+        </returns>
         <param name="nonPublic">
           <attribution license="cc4" from="Microsoft" modified="false" />Indicates whether non-public get accessors should be returned. true if non-public methods are to be included; otherwise, false. </param>
       </Docs>
@@ -288,7 +300,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To get the index parameters of a property, reflect on the property's parent type using Type.GetType or Assembly.GetType, retrieve the Reflection property object from the type, and call PropertyInfo.GetIndexParameters.</para>
@@ -297,6 +308,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of all the index parameters for the property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type ParameterInfo containing the parameters for the indexes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetSetMethod">
@@ -315,7 +330,6 @@
         <Parameter Name="nonPublic" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To get the setter of a property, reflect on the property's parent type using Type.GetType or Assembly.GetType, retrieve the Reflection property object from the type, and call PropertyInfo.GetSetMethod.</para>
@@ -324,6 +338,42 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the set accessor for this property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>A <see cref="T:System.Reflection.MethodInfo" /> object representing the Set method for this property. </para>
+              </term>
+              <description>
+                <para>The set accessor is public.</para>
+                <para>
+                  <paramref name="nonPublic" /> is true and non-public methods can be returned. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>null </para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="nonPublic" /> is true, but the property is read-only.</para>
+                <para>
+                  <paramref name="nonPublic" /> is false and the set accessor is non-public. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="nonPublic">
           <attribution license="cc4" from="Microsoft" modified="false" />Indicates whether the accessor should be returned if it is non-public. true if non-public methods are to be included; otherwise, false. </param>
       </Docs>
@@ -345,7 +395,6 @@
         <Parameter Name="index" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To get the value of a property, reflect on the property's parent type using Type.GetType or Assembly.GetType, retrieve the Reflection property object from the type, and call PropertyInfo.GetValue.</para>
@@ -354,6 +403,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the indexed property by calling the property's getter method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the specified indexed property.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object whose property value will be returned. </param>
         <param name="index">
@@ -380,7 +433,6 @@
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To get the value of a property, reflect on the property's parent type using Type.GetType or Assembly.GetType, retrieve the Reflection property object from the type, and call PropertyInfo.GetValue.</para>
@@ -389,6 +441,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of a property having the specified binding, index, and CultureInfo.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The property value for <paramref name="obj" />.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object whose property value will be returned. </param>
         <param name="invokeAttr">
@@ -418,7 +474,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reflect on the property's parent type using Type.GetType or Assembly.GetType, retrieve the Reflection property object from the type, and call PropertyInfo.IsDefined.</para>
@@ -427,6 +482,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether one or more instance of <paramref name="attributeType" /> is defined on this property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if one or more instance of <paramref name="attributeType" /> is defined on this property; otherwise false.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The Type object to which the custom attributes are applied. </param>
         <param name="inherit">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/PropertyToken.xml b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/PropertyToken.xml
index 13e06841cfa..e73cb17da8f 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/PropertyToken.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/PropertyToken.xml
@@ -64,12 +64,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks if the given object is an instance of PropertyToken and is equal to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is an instance of PropertyToken and equals the current instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to this object. </param>
       </Docs>
@@ -89,13 +92,16 @@
         <Parameter Name="obj" Type="System.Reflection.Emit.PropertyToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the current instance is equal to the specified <see cref="T:System.Reflection.Emit.PropertyToken" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of <paramref name="obj" /> is equal to the value of the current instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.PropertyToken" /> to compare to the current instance.</param>
       </Docs>
@@ -114,12 +120,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates the hash code for this property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the hash code for this property.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="op_Equality">
@@ -138,12 +147,15 @@
         <Parameter Name="b" Type="System.Reflection.Emit.PropertyToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.Emit.PropertyToken" /> structures are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> is equal to <paramref name="b" />; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.PropertyToken" /> to compare to <paramref name="b" />.</param>
         <param name="b">
@@ -166,12 +178,15 @@
         <Parameter Name="b" Type="System.Reflection.Emit.PropertyToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.Emit.PropertyToken" /> structures are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> is not equal to <paramref name="b" />; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.PropertyToken" /> to compare to <paramref name="b" />.</param>
         <param name="b">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/SignatureHelper.xml b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/SignatureHelper.xml
index aabd92ffd6e..b64e55171cd 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/SignatureHelper.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/SignatureHelper.xml
@@ -205,12 +205,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks if this instance is equal to the given object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the given object is a SignatureHelper and represents the same signature; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object with which this instance should be compared. </param>
       </Docs>
@@ -231,12 +234,15 @@
         <Parameter Name="mod" Type="System.Reflection.Module" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SignatureHelper'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a signature helper for a field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The SignatureHelper object for a field.</para>
+        </returns>
         <param name="mod">
           <attribution license="cc4" from="Microsoft" modified="false" />The dynamic module that contains the field for which the SignatureHelper is requested. </param>
       </Docs>
@@ -255,7 +261,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The hash code is created from the name of this instance, so the return value is the same as if the GetHashCode method were called on the value of the Name property.</para>
@@ -264,6 +269,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the hash code based on the name.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetLocalVarSigHelper">
@@ -279,12 +288,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a signature helper for a local variable.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.Emit.SignatureHelper" /> for a local variable.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetLocalVarSigHelper">
@@ -303,12 +315,15 @@
         <Parameter Name="mod" Type="System.Reflection.Module" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SignatureHelper'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a signature helper for a local variable.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The SignatureHelper object for a local variable.</para>
+        </returns>
         <param name="mod">
           <attribution license="cc4" from="Microsoft" modified="false" />The dynamic module that contains the local variable for which the SignatureHelper is requested. </param>
       </Docs>
@@ -329,12 +344,15 @@
         <Parameter Name="returnType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a signature helper for a method given the method's calling convention and return type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The SignatureHelper object for a method.</para>
+        </returns>
         <param name="callingConvention">
           <attribution license="cc4" from="Microsoft" modified="false" />The calling convention of the method. </param>
         <param name="returnType">
@@ -357,12 +375,15 @@
         <Parameter Name="returnType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a signature helper for a method given the method's unmanaged calling convention and return type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The SignatureHelper object for a method.</para>
+        </returns>
         <param name="unmanagedCallingConvention">
           <attribution license="cc4" from="Microsoft" modified="false" />The unmanaged calling convention of the method. </param>
         <param name="returnType">
@@ -387,12 +408,15 @@
         <Parameter Name="returnType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SignatureHelper'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a signature helper for a method given the method's module, calling convention, and return type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The SignatureHelper object for a method.</para>
+        </returns>
         <param name="mod">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.ModuleBuilder" /> that contains the method for which the SignatureHelper is requested. </param>
         <param name="callingConvention">
@@ -419,12 +443,15 @@
         <Parameter Name="returnType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SignatureHelper'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a signature helper for a method given the method's module, unmanaged calling convention, and return type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The SignatureHelper object for a method.</para>
+        </returns>
         <param name="mod">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.ModuleBuilder" /> that contains the method for which the SignatureHelper is requested. </param>
         <param name="unmanagedCallConv">
@@ -451,7 +478,6 @@
         <Parameter Name="parameterTypes" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SignatureHelper'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload creates a signature with a standard calling convention.</para>
@@ -461,6 +487,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a signature helper for a method with a standard calling convention, given the method's module, return type, and argument types.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The SignatureHelper object for a method.</para>
+        </returns>
         <param name="mod">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.ModuleBuilder" /> that contains the method for which the SignatureHelper is requested. </param>
         <param name="returnType">
@@ -487,7 +517,6 @@
         <Parameter Name="parameterTypes" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SignatureHelper'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To create a signature helper for a property with optional or required custom modifiers, use the <see cref="M:System.Reflection.Emit.SignatureHelper.GetPropertySigHelper(System.Reflection.Module,System.Type,System.Type[],System.Type[],System.Type[],System.Type[][],System.Type[][])" /> method overload.</para>
@@ -496,6 +525,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a signature helper for a property, given the dynamic module that contains the property, the property type, and the property arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.Emit.SignatureHelper" /> object for a property.</para>
+        </returns>
         <param name="mod">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.ModuleBuilder" /> that contains the property for which the <see cref="T:System.Reflection.Emit.SignatureHelper" /> is requested.</param>
         <param name="returnType">
@@ -525,7 +558,6 @@
         <Parameter Name="optionalParameterTypeCustomModifiers" Type="System.Type[][]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="N:System.Runtime.CompilerServices" /> namespace for classes that represent custom modifiers.</para>
@@ -535,6 +567,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a signature helper for a property, given the dynamic module that contains the property, the property type, the property arguments, and custom modifiers for the return type and arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.Emit.SignatureHelper" /> object for a property.</para>
+        </returns>
         <param name="mod">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.ModuleBuilder" /> that contains the property for which the <see cref="T:System.Reflection.Emit.SignatureHelper" /> is requested.</param>
         <param name="returnType">
@@ -572,7 +608,6 @@
         <Parameter Name="optionalParameterTypeCustomModifiers" Type="System.Type[][]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="N:System.Runtime.CompilerServices" /> namespace for classes that represent custom modifiers.</para>
@@ -585,6 +620,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a signature helper for a property, given the dynamic module that contains the property, the calling convention, the property type, the property arguments, and custom modifiers for the return type and arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.Emit.SignatureHelper" /> object for a property.</para>
+        </returns>
         <param name="mod">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.ModuleBuilder" /> that contains the property for which the <see cref="T:System.Reflection.Emit.SignatureHelper" /> is requested.</param>
         <param name="callingConvention">
@@ -617,12 +656,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the end token to the signature and marks the signature as finished, so no further tokens can be added.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a byte array made up of the full signature.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Runtime.InteropServices._SignatureHelper.GetIDsOfNames">
@@ -758,12 +800,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representing the signature arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a string representing the arguments of this signature.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/SignatureToken.xml b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/SignatureToken.xml
index e67fb6d83a5..61574983b0d 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/SignatureToken.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/SignatureToken.xml
@@ -64,12 +64,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks if the given object is an instance of SignatureToken and is equal to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is an instance of SignatureToken and is equal to this object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this SignatureToken. </param>
       </Docs>
@@ -89,13 +92,16 @@
         <Parameter Name="obj" Type="System.Reflection.Emit.SignatureToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the current instance is equal to the specified <see cref="T:System.Reflection.Emit.SignatureToken" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of <paramref name="obj" /> is equal to the value of the current instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.SignatureToken" /> to compare to the current instance.</param>
       </Docs>
@@ -114,12 +120,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates the hash code for this signature.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the hash code for this signature.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="op_Equality">
@@ -138,12 +147,15 @@
         <Parameter Name="b" Type="System.Reflection.Emit.SignatureToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.Emit.SignatureToken" /> structures are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> is equal to <paramref name="b" />; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.SignatureToken" /> to compare to <paramref name="b" />.</param>
         <param name="b">
@@ -166,12 +178,15 @@
         <Parameter Name="b" Type="System.Reflection.Emit.SignatureToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.Emit.SignatureToken" /> structures are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> is not equal to <paramref name="b" />; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.SignatureToken" /> to compare to <paramref name="b" />.</param>
         <param name="b">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/StringToken.xml b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/StringToken.xml
index fd69b55abef..a94c8d8552a 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/StringToken.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/StringToken.xml
@@ -43,12 +43,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks if the given object is an instance of StringToken and is equal to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is an instance of StringToken and is equal to this object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this StringToken. </param>
       </Docs>
@@ -68,13 +71,16 @@
         <Parameter Name="obj" Type="System.Reflection.Emit.StringToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the current instance is equal to the specified <see cref="T:System.Reflection.Emit.StringToken" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of <paramref name="obj" /> is equal to the value of the current instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.StringToken" /> to compare to the current instance.</param>
       </Docs>
@@ -93,12 +99,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the underlying string token.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="op_Equality">
@@ -117,12 +126,15 @@
         <Parameter Name="b" Type="System.Reflection.Emit.StringToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.Emit.StringToken" /> structures are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> is equal to <paramref name="b" />; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.StringToken" /> to compare to <paramref name="b" />.</param>
         <param name="b">
@@ -145,12 +157,15 @@
         <Parameter Name="b" Type="System.Reflection.Emit.StringToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.Emit.StringToken" /> structures are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> is not equal to <paramref name="b" />; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.StringToken" /> to compare to <paramref name="b" />.</param>
         <param name="b">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/TypeBuilder.xml b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/TypeBuilder.xml
index 7e89d19c2ee..0d146de79bc 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/TypeBuilder.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/TypeBuilder.xml
@@ -208,7 +208,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Type'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If this type is a nested type, the <see cref="M:System.Reflection.Emit.TypeBuilder.CreateType" /> method must be called on the enclosing type before it is called on the nested type.</para>
@@ -220,6 +219,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Type" /> object for the class. After defining fields and methods on the class, CreateType is called in order to load its Type object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the new <see cref="T:System.Type" /> object for this class.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DeclaringMethod">
@@ -292,7 +295,6 @@
         <Parameter Name="parameterTypes" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ConstructorBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you do not define a constructor for your dynamic type, a default constructor is provided automatically, and it calls the default constructor of the base class.</para>
@@ -310,6 +312,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new constructor to the type, with the given attributes and signature.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The defined constructor.</para>
+        </returns>
         <param name="attributes">
           <attribution license="cc4" from="Microsoft" modified="false" />The attributes of the constructor. </param>
         <param name="callingConvention">
@@ -342,7 +348,6 @@
         <Parameter Name="optionalCustomModifiers" Type="System.Type[][]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -355,6 +360,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new constructor to the type, with the given attributes, signature, and custom modifiers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The defined constructor.</para>
+        </returns>
         <param name="attributes">
           <attribution license="cc4" from="Microsoft" modified="false" />The attributes of the constructor. </param>
         <param name="callingConvention">
@@ -388,7 +397,6 @@
         <Parameter Name="attributes" Type="System.Reflection.MethodAttributes" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ConstructorBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Because the default constructor is automatically defined, it is necessary to call this method only in the following situations: </para>
@@ -405,6 +413,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines the default constructor. The constructor defined here will simply call the default constructor of the parent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the constructor.</para>
+        </returns>
         <param name="attributes">
           <attribution license="cc4" from="Microsoft" modified="false" />A MethodAttributes object representing the attributes to be applied to the constructor. </param>
       </Docs>
@@ -427,12 +439,15 @@
         <Parameter Name="eventtype" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'EventBuilder'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new event to the type, with the given name, attributes and event type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The defined event.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the event. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="attributes">
@@ -459,12 +474,15 @@
         <Parameter Name="attributes" Type="System.Reflection.FieldAttributes" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'FieldBuilder'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new field to the type, with the given name, attributes, and field type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The defined field.</para>
+        </returns>
         <param name="fieldName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the field. <paramref name="fieldName" /> cannot contain embedded nulls. </param>
         <param name="type">
@@ -492,7 +510,6 @@
         <Parameter Name="attributes" Type="System.Reflection.FieldAttributes" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -502,6 +519,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new field to the type, with the given name, attributes, field type, and custom modifiers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The defined field.</para>
+        </returns>
         <param name="fieldName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the field. <paramref name="fieldName" /> cannot contain embedded nulls. </param>
         <param name="type">
@@ -535,7 +556,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -545,6 +565,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines the generic type parameters for the current type, specifying their number and their names, and returns an array of <see cref="T:System.Reflection.Emit.GenericTypeParameterBuilder" /> objects that can be used to set their constraints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.Emit.GenericTypeParameterBuilder" /> objects that can be used to define the constraints of the generic type parameters for the current type.</para>
+        </returns>
         <param name="names">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of names for the generic type parameters.</param>
       </Docs>
@@ -567,7 +591,6 @@
         <Parameter Name="attributes" Type="System.Reflection.FieldAttributes" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'FieldBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The field that you create with this method will be static, even if you do not include FieldAttributes.Static in the <paramref name="attributes" /> parameter.</para>
@@ -576,6 +599,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines initialized data field in the .sdata section of the portable executable (PE) file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A field to reference the data.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name used to refer to the data. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="data">
@@ -600,7 +627,6 @@
         <Parameter Name="attributes" Type="System.Reflection.MethodAttributes" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -611,6 +637,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new method to the type, with the specified name and method attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.Emit.MethodBuilder" /> representing the newly defined method.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the method. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="attributes">
@@ -634,7 +664,6 @@
         <Parameter Name="callingConvention" Type="System.Reflection.CallingConventions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -644,6 +673,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new method to the type, with the specified name, method attributes, and calling convention.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.Emit.MethodBuilder" /> representing the newly defined method.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the method. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="attributes">
@@ -671,12 +704,15 @@
         <Parameter Name="parameterTypes" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MethodBuilder'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new method to the type, with the specified name, method attributes, and method signature.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The defined method.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the method. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="attributes">
@@ -707,12 +743,15 @@
         <Parameter Name="parameterTypes" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MethodBuilder'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new method to the type, with the specified name, method attributes, calling convention, and method signature.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.Emit.MethodBuilder" /> representing the newly defined method.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the method. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="attributes">
@@ -748,7 +787,6 @@
         <Parameter Name="parameterTypeOptionalCustomModifiers" Type="System.Type[][]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -761,6 +799,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new method to the type, with the specified name, method attributes, calling convention, method signature, and custom modifiers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.Emit.MethodBuilder" /> object representing the newly added method.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the method. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="attributes">
@@ -836,7 +878,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TypeBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to create nested types even after the <see cref="M:System.Reflection.Emit.TypeBuilder.CreateType" /> method has been called on the enclosing type. </para>
@@ -848,6 +889,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a nested type, given its name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The defined nested type.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The short name of the type. <paramref name="name" /> cannot contain embedded nulls. </param>
       </Docs>
@@ -869,7 +914,6 @@
         <Parameter Name="attr" Type="System.Reflection.TypeAttributes" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TypeBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to create nested types even after the <see cref="M:System.Reflection.Emit.TypeBuilder.CreateType" /> method has been called on the enclosing type. </para>
@@ -881,6 +925,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a nested type, given its name and attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The defined nested type.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The short name of the type. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="attr">
@@ -905,7 +953,6 @@
         <Parameter Name="parent" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TypeBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to create nested types even after the <see cref="M:System.Reflection.Emit.TypeBuilder.CreateType" /> method has been called on the enclosing type. </para>
@@ -917,6 +964,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a nested type, given its name, attributes, and the type that it extends.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The defined nested type.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The short name of the type. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="attr">
@@ -944,7 +995,6 @@
         <Parameter Name="typeSize" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TypeBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to create nested types even after the <see cref="M:System.Reflection.Emit.TypeBuilder.CreateType" /> method has been called on the enclosing type. </para>
@@ -956,6 +1006,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a nested type, given its name, attributes, the total size of the type, and the type that it extends.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The defined nested type.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The short name of the type. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="attr">
@@ -985,7 +1039,6 @@
         <Parameter Name="packSize" Type="System.Reflection.Emit.PackingSize" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TypeBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to create nested types even after the <see cref="M:System.Reflection.Emit.TypeBuilder.CreateType" /> method has been called on the enclosing type. </para>
@@ -997,6 +1050,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a nested type, given its name, attributes, the type that it extends, and the packing size.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The defined nested type.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The short name of the type. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="attr">
@@ -1031,7 +1088,6 @@
         <Parameter Name="interfaces" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TypeBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to create nested types even after the <see cref="M:System.Reflection.Emit.TypeBuilder.CreateType" /> method has been called on the enclosing type. </para>
@@ -1043,6 +1099,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a nested type, given its name, attributes, the type that it extends, and the interfaces that it implements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The defined nested type.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The short name of the type. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="attr">
@@ -1076,7 +1136,6 @@
         <Parameter Name="nativeCharSet" Type="System.Runtime.InteropServices.CharSet" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MethodBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Some DLL import attributes (see the description of <see cref="T:System.Runtime.InteropServices.DllImportAttribute" />) cannot be specified as arguments to this method. For example, the DLL import attribute <see cref="F:System.Reflection.MethodImplAttributes.PreserveSig" /> must be added after the PInvoke method is created, if the method returns a value. The example shows how to do this.</para>
@@ -1085,6 +1144,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a PInvoke method given its name, the name of the DLL in which the method is defined, the attributes of the method, the calling convention of the method, the return type of the method, the types of the parameters of the method, and the PInvoke flags.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The defined PInvoke method.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the PInvoke method. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="dllName">
@@ -1127,7 +1190,6 @@
         <Parameter Name="nativeCharSet" Type="System.Runtime.InteropServices.CharSet" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MethodBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Some DLL import attributes (see the description of <see cref="T:System.Runtime.InteropServices.DllImportAttribute" />) cannot be specified as arguments to this method. For example, the DLL import attribute <see cref="F:System.Reflection.MethodImplAttributes.PreserveSig" /> must be added after the PInvoke method is created, if the method returns a value. The example shows how to do this.</para>
@@ -1136,6 +1198,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a PInvoke method given its name, the name of the DLL in which the method is defined, the name of the entry point, the attributes of the method, the calling convention of the method, the return type of the method, the types of the parameters of the method, and the PInvoke flags.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The defined PInvoke method.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the PInvoke method. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="dllName">
@@ -1183,7 +1249,6 @@
         <Parameter Name="nativeCharSet" Type="System.Runtime.InteropServices.CharSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1196,6 +1261,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a PInvoke method given its name, the name of the DLL in which the method is defined, the name of the entry point, the attributes of the method, the calling convention of the method, the return type of the method, the types of the parameters of the method, the PInvoke flags, and custom modifiers for the parameters and return type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.Emit.MethodBuilder" /> representing the defined PInvoke method.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the PInvoke method. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="dllName">
@@ -1243,12 +1312,15 @@
         <Parameter Name="parameterTypes" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyBuilder'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new property to the type, with the given name and property signature.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The defined property.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the property. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="attributes">
@@ -1277,12 +1349,15 @@
         <Parameter Name="parameterTypes" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new property to the type, with the given name, attributes, calling convention, and property signature.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The defined property.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the property. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="attributes">
@@ -1317,7 +1392,6 @@
         <Parameter Name="parameterTypeOptionalCustomModifiers" Type="System.Type[][]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1330,6 +1404,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new property to the type, with the given name, property signature, and custom modifiers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The defined property.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the property. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="attributes">
@@ -1371,7 +1449,6 @@
         <Parameter Name="parameterTypeOptionalCustomModifiers" Type="System.Type[][]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload is provided for designers of managed compilers.</para>
@@ -1384,6 +1461,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a new property to the type, with the given name, calling convention, property signature, and custom modifiers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The defined property.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the property. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="attributes">
@@ -1423,7 +1504,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ConstructorBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The initializer created is always public.</para>
@@ -1432,6 +1512,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines the initializer for this type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a type initializer.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DefineUninitializedData">
@@ -1452,7 +1536,6 @@
         <Parameter Name="attributes" Type="System.Reflection.FieldAttributes" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'FieldBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The field that you create with this method will be static, even if you do not include FieldAttributes.Static in the <paramref name="attributes" /> parameter.</para>
@@ -1461,6 +1544,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines an uninitialized data field in the .sdata section of the portable executable (PE) file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A field to reference the data.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name used to refer to the data. <paramref name="name" /> cannot contain embedded nulls. </param>
         <param name="size">
@@ -1580,7 +1667,6 @@
         <Parameter Name="constructor" Type="System.Reflection.ConstructorInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1591,6 +1677,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the constructor of the specified constructed generic type that corresponds to the specified constructor of the generic type definition. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.ConstructorInfo" /> object that represents the constructor of <paramref name="type" /> corresponding to <paramref name="constructor" />, which specifies a constructor belonging to the generic type definition of <paramref name="type" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The constructed generic type whose constructor is returned.</param>
         <param name="constructor">
@@ -1648,7 +1738,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -1657,6 +1746,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of <see cref="T:System.Reflection.ConstructorInfo" /> objects representing the public and non-public constructors defined for this class, as specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an array of <see cref="T:System.Reflection.ConstructorInfo" /> objects representing the specified constructors defined for this class. If no constructors are defined, an empty array is returned.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />This must be a bit flag from <see cref="T:System.Reflection.BindingFlags" /> as in InvokeMethod, NonPublic, and so on. </param>
       </Docs>
@@ -1677,12 +1770,15 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the custom attributes defined for this type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an array of objects representing all the custom attributes of this type.</para>
+        </returns>
         <param name="inherit">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies whether to search this member's inheritance chain to find the attributes. </param>
       </Docs>
@@ -1704,12 +1800,15 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the custom attributes of the current type that are assignable to a specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of custom attributes defined on the current type.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of attribute to search for. Only attributes that are assignable to this type are returned.</param>
         <param name="inherit">
@@ -1730,7 +1829,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -1739,6 +1837,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.NotSupportedException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method is not supported. No value is returned.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetEvent">
@@ -1758,7 +1860,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -1767,6 +1868,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the event with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Reflection.EventInfo" /> object representing the event declared or inherited by this type with the specified name, or null if there are no matches.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the event to search for. </param>
         <param name="bindingAttr">
@@ -1787,7 +1892,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -1796,6 +1900,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the public events declared or inherited by this type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an array of <see cref="T:System.Reflection.EventInfo" /> objects representing the public events declared or inherited by this type. An empty array is returned if there are no public events.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetEvents">
@@ -1814,7 +1922,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -1823,6 +1930,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the public and non-public events that are declared by this type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an array of <see cref="T:System.Reflection.EventInfo" /> objects representing the events declared or inherited by this type that match the specified binding flags. An empty array is returned if there are no matching events.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Reflection.BindingFlags" /> values that limits the search.</param>
       </Docs>
@@ -1844,7 +1955,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -1853,6 +1963,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the field specified by the given name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the <see cref="T:System.Reflection.FieldInfo" /> object representing the field declared or inherited by this type with the specified name and public or non-public modifier. If there are no matches then null is returned.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the field to get. </param>
         <param name="bindingAttr">
@@ -1875,7 +1989,6 @@
         <Parameter Name="field" Type="System.Reflection.FieldInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1886,6 +1999,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the field of the specified constructed generic type that corresponds to the specified field of the generic type definition. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.FieldInfo" /> object that represents the field of <paramref name="type" /> corresponding to <paramref name="field" />, which specifies a field belonging to the generic type definition of <paramref name="type" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The constructed generic type whose field is returned.</param>
         <param name="field">
@@ -1908,7 +2025,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Reflection.Emit.TypeBuilder.GetFields(System.Reflection.BindingFlags)" /> method does not return fields in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which fields are returned, because that order can vary.</para>
@@ -1918,6 +2034,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the public and non-public fields that are declared by this type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an array of <see cref="T:System.Reflection.FieldInfo" /> objects representing the public and non-public fields declared or inherited by this type. An empty array is returned if there are no fields, as specified.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />This must be a bit flag from <see cref="T:System.Reflection.BindingFlags" /> : InvokeMethod, NonPublic, and so on. </param>
       </Docs>
@@ -1935,7 +2055,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1947,6 +2066,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of <see cref="T:System.Type" /> objects representing the type arguments of a generic type or the type parameters of a generic type definition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Type" /> objects. The elements of the array represent the type arguments of a generic type or the type parameters of a generic type definition.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetGenericTypeDefinition">
@@ -1962,7 +2085,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1973,6 +2095,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Type" /> object that represents a generic type definition from which the current type can be obtained.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object representing a generic type definition from which the current type can be obtained.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetInterface">
@@ -1992,7 +2118,6 @@
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -2001,6 +2126,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the interface implemented (directly or indirectly) by this class with the fully qualified name matching the given interface name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a <see cref="T:System.Type" /> object representing the implemented interface. Returns null if no interface matching name is found.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the interface. </param>
         <param name="ignoreCase">
@@ -2028,7 +2157,6 @@
         <Parameter Name="interfaceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -2037,6 +2165,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an interface mapping for the requested interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the requested interface mapping.</para>
+        </returns>
         <param name="interfaceType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the interface for which the mapping is to be retrieved. </param>
       </Docs>
@@ -2055,12 +2187,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of all the interfaces implemented on this type and its base types.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an array of <see cref="T:System.Type" /> objects representing the implemented interfaces. If none are defined, an empty array is returned.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetMember">
@@ -2081,7 +2216,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -2090,6 +2224,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the public and non-public members declared or inherited by this type, as specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an array of <see cref="T:System.Reflection.MemberInfo" /> objects representing the public and non-public members defined on this type if <paramref name="nonPublic" /> is used; otherwise, only the public members are returned.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the member. </param>
         <param name="type">
@@ -2114,7 +2252,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -2123,6 +2260,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the members for the public and non-public members declared or inherited by this type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an array of <see cref="T:System.Reflection.MemberInfo" /> objects representing the public and non-public members declared or inherited by this type. An empty array is returned if there are no matching members.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />This must be a bit flag from <see cref="T:System.Reflection.BindingFlags" />, such as InvokeMethod, NonPublic, and so on. </param>
       </Docs>
@@ -2143,7 +2284,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2154,6 +2294,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the method of the specified constructed generic type that corresponds to the specified method of the generic type definition. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodInfo" /> object that represents the method of <paramref name="type" /> corresponding to <paramref name="method" />, which specifies a method belonging to the generic type definition of <paramref name="type" />.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The constructed generic type whose method is returned.</param>
         <param name="method">
@@ -2208,7 +2352,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -2217,6 +2360,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the public and non-public methods declared or inherited by this type, as specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an array of <see cref="T:System.Reflection.MethodInfo" /> objects representing the public and non-public methods defined on this type if <paramref name="nonPublic" /> is used; otherwise, only the public methods are returned.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />This must be a bit flag from <see cref="T:System.Reflection.BindingFlags" /> as in InvokeMethod, NonPublic, and so on. </param>
       </Docs>
@@ -2238,7 +2385,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -2248,6 +2394,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the public and non-public nested types that are declared by this type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object representing the nested type that matches the specified requirements, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the name of the nested type to get. </param>
         <param name="bindingAttr">
@@ -2270,7 +2420,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -2280,6 +2429,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the public and non-public nested types that are declared or inherited by this type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Type" /> objects representing all the types nested within the current <see cref="T:System.Type" /> that match the specified binding constraints.</para>
+          <para>An empty array of type <see cref="T:System.Type" />, if no types are nested within the current <see cref="T:System.Type" />, or if none of the nested types match the binding constraints.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />This must be a bit flag from <see cref="T:System.Reflection.BindingFlags" />, as in InvokeMethod, NonPublic, and so on. </param>
       </Docs>
@@ -2300,7 +2454,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -2309,6 +2462,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the public and non-public properties declared or inherited by this type, as specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an array of PropertyInfo objects representing the public and non-public properties defined on this type if <paramref name="nonPublic" /> is used; otherwise, only the public properties are returned.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />This invocation attribute. This must be a bit flag from <see cref="T:System.Reflection.BindingFlags" /> : InvokeMethod, NonPublic, and so on. </param>
       </Docs>
@@ -2411,7 +2568,6 @@
         <Parameter Name="namedParameters" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A method will be invoked if the number of parameters in the method declaration equals the number of arguments in the specified argument list, and the type of each argument can be converted by the binder to the type of the parameter.</para>
@@ -2425,6 +2581,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes the specified member. The method that is to be invoked must be accessible and provide the most specific match with the specified argument list, under the constraints of the specified binder and invocation attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the return value of the invoked member.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the member to invoke. This can be a constructor, method, property, or field. A suitable invocation attribute must be specified. Note that it is possible to invoke the default member of a class by passing an empty string as the name of the member. </param>
         <param name="invokeAttr">
@@ -2476,12 +2636,15 @@
         <Parameter Name="typeInfo" Type="System.Reflection.TypeInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether a specified <see cref="T:System.Reflection.TypeInfo" /> object can be assigned to this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="typeInfo" /> can be assigned to this object; otherwise, false.</para>
+        </returns>
         <param name="typeInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test.</param>
       </Docs>
@@ -2502,12 +2665,15 @@
         <Parameter Name="c" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether a specified <see cref="T:System.Type" /> can be assigned to this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="c" /> parameter and the current type represent the same type, or if the current type is in the inheritance hierarchy of <paramref name="c" />, or if the current type is an interface that <paramref name="c" /> supports. false if none of these conditions are valid, or if <paramref name="c" /> is null.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test. </param>
       </Docs>
@@ -2582,7 +2748,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2592,6 +2757,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current dynamic type has been created.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="M:System.Reflection.Emit.TypeBuilder.CreateType" /> method has been called; otherwise, false. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsDefined">
@@ -2611,7 +2780,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is not supported for incomplete generic type parameters. Retrieve the type using <see cref="M:System.Type.GetType" /> or <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> and use reflection on the retrieved type.</para>
@@ -2620,6 +2788,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a custom attribute is applied to the current type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if one or more instances of <paramref name="attributeType" />, or an attribute derived from <paramref name="attributeType" />, is defined on this type; otherwise, false.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of attribute to search for. Only attributes that are assignable to this type are returned. </param>
         <param name="inherit">
@@ -2762,12 +2934,15 @@
         <Parameter Name="c" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether this type is derived from a specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Read-only. Returns true if this type is the same as the type <paramref name="c" />, or is a subtype of type <paramref name="c" />; otherwise, false.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> that is to be checked. </param>
       </Docs>
@@ -2804,7 +2979,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Reflection.Emit.TypeBuilder.MakeArrayType" /> method provides a way to generate an array type with any possible element type, including generic types.</para>
@@ -2813,6 +2987,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Type" /> object that represents a one-dimensional array of the current type, with a lower bound of zero.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object representing a one-dimensional array type whose element type is the current type, with a lower bound of zero.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MakeArrayType">
@@ -2830,7 +3008,6 @@
         <Parameter Name="rank" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Reflection.Emit.TypeBuilder.MakeArrayType" /> method provides a way to generate an array type with any possible element type, including generic types.</para>
@@ -2839,6 +3016,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Type" /> object that represents an array of the current type, with the specified number of dimensions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object that represents a one-dimensional array of the current type.</para>
+        </returns>
         <param name="rank">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of dimensions for the array. </param>
       </Docs>
@@ -2856,7 +3037,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Reflection.Emit.TypeBuilder.MakeByRefType" /> method provides a way to generate ref types (ByRef in Visual Basic) for parameter lists.</para>
@@ -2868,6 +3048,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Type" /> object that represents the current type when passed as a ref parameter (ByRef in Visual Basic).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object that represents the current type when passed as a ref parameter (ByRef in Visual Basic).</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MakeGenericType">
@@ -2891,7 +3075,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method when your emitted code requires a type constructed from the current generic type definition. It is not necessary to call the <see cref="M:System.Reflection.Emit.TypeBuilder.CreateType" /> method before calling the <see cref="M:System.Reflection.Emit.TypeBuilder.MakeGenericType(System.Type[])" /> method on a <see cref="T:System.Reflection.Emit.TypeBuilder" /> that represents a generic type definition. If the current <see cref="T:System.Reflection.Emit.TypeBuilder" /> does not represent the definition of a generic type, an <see cref="T:System.InvalidOperationException" /> is thrown.</para>
@@ -2911,6 +3094,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Substitutes the elements of an array of types for the type parameters of the current generic type definition, and returns the resulting constructed type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> representing the constructed type formed by substituting the elements of <paramref name="typeArguments" /> for the type parameters of the current generic type. </para>
+        </returns>
         <param name="typeArguments">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of types to be substituted for the type parameters of the current generic type definition.</param>
       </Docs>
@@ -2928,7 +3115,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Reflection.Emit.TypeBuilder.MakePointerType" /> method provides a way to generate pointer types for parameter lists.</para>
@@ -2940,6 +3126,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Type" /> object that represents the type of an unmanaged pointer to the current type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object that represents the type of an unmanaged pointer to the current type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Module">
@@ -3300,12 +3490,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the type excluding the namespace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Read-only. The name of the type excluding the namespace.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TypeHandle">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/TypeToken.xml b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/TypeToken.xml
index 07662eab2ae..808bac7468b 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/TypeToken.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/TypeToken.xml
@@ -67,12 +67,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks if the given object is an instance of TypeToken and is equal to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is an instance of TypeToken and is equal to this object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this TypeToken. </param>
       </Docs>
@@ -92,13 +95,16 @@
         <Parameter Name="obj" Type="System.Reflection.Emit.TypeToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the current instance is equal to the specified <see cref="T:System.Reflection.Emit.TypeToken" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of <paramref name="obj" /> is equal to the value of the current instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.TypeToken" /> to compare to the current instance.</param>
       </Docs>
@@ -117,12 +123,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates the hash code for this type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the hash code for this type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="op_Equality">
@@ -141,12 +150,15 @@
         <Parameter Name="b" Type="System.Reflection.Emit.TypeToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.Emit.TypeToken" /> structures are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> is equal to <paramref name="b" />; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.TypeToken" /> to compare to <paramref name="b" />.</param>
         <param name="b">
@@ -169,12 +181,15 @@
         <Parameter Name="b" Type="System.Reflection.Emit.TypeToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.Emit.TypeToken" /> structures are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> is not equal to <paramref name="b" />; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.Emit.TypeToken" /> to compare to <paramref name="b" />.</param>
         <param name="b">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/UnmanagedMarshal.xml b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/UnmanagedMarshal.xml
index 70d818b8a96..7c663b18a22 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection.Emit/UnmanagedMarshal.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection.Emit/UnmanagedMarshal.xml
@@ -71,7 +71,6 @@
         <Parameter Name="elemCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'UnmanagedMarshal'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The DefineByValArray method is not a simple native marshal.</para>
@@ -82,6 +81,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Specifies a fixed-length array (ByValArray) to marshal to unmanaged code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Reflection.Emit.UnmanagedMarshal" /> object.</para>
+        </returns>
         <param name="elemCount">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of elements in the fixed-length array. </param>
       </Docs>
@@ -102,7 +105,6 @@
         <Parameter Name="elemCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'UnmanagedMarshal'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The DefineByValStr method is not a simple native marshal.</para>
@@ -113,6 +115,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Specifies a string in a fixed array buffer (ByValTStr) to marshal to unmanaged code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Reflection.Emit.UnmanagedMarshal" /> object.</para>
+        </returns>
         <param name="elemCount">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of elements in the fixed array buffer. </param>
       </Docs>
@@ -159,7 +165,6 @@
         <Parameter Name="elemType" Type="System.Runtime.InteropServices.UnmanagedType" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'UnmanagedMarshal'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The DefineLPArray method is not a simple native marshal.</para>
@@ -170,6 +175,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Specifies an LPArray to marshal to unmanaged code. The length of an LPArray is determined at runtime by the size of the actual marshaled array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Reflection.Emit.UnmanagedMarshal" /> object.</para>
+        </returns>
         <param name="elemType">
           <attribution license="cc4" from="Microsoft" modified="false" />The unmanaged type to which to marshal the array. </param>
       </Docs>
@@ -190,7 +199,6 @@
         <Parameter Name="elemType" Type="System.Runtime.InteropServices.UnmanagedType" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'UnmanagedMarshal'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The DefineSafeArray method is not a simple native marshal.</para>
@@ -201,6 +209,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Specifies a SafeArray to marshal to unmanaged code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Reflection.Emit.UnmanagedMarshal" /> object.</para>
+        </returns>
         <param name="elemType">
           <attribution license="cc4" from="Microsoft" modified="false" />The base type or the UnmanagedType of each element of the array. </param>
       </Docs>
@@ -221,7 +233,6 @@
         <Parameter Name="unmanagedType" Type="System.Runtime.InteropServices.UnmanagedType" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'UnmanagedMarshal'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Runtime.InteropServices.UnmanagedType" /> passed to this method must be a simple native type. None of the following values may be used: <see cref="F:System.Runtime.InteropServices.UnmanagedType.ByValTStr" />, <see cref="F:System.Runtime.InteropServices.UnmanagedType.SafeArray" />, <see cref="F:System.Runtime.InteropServices.UnmanagedType.ByValArray" />, <see cref="F:System.Runtime.InteropServices.UnmanagedType.LPArray" />, or <see cref="F:System.Runtime.InteropServices.UnmanagedType.CustomMarshaler" />.</para>
@@ -231,6 +242,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Specifies a given type that is to be marshaled to unmanaged code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Reflection.Emit.UnmanagedMarshal" /> object.</para>
+        </returns>
         <param name="unmanagedType">
           <attribution license="cc4" from="Microsoft" modified="false" />The unmanaged type to which the type is to be marshaled. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection/Assembly.xml b/mcs/class/corlib/Documentation/en/System.Reflection/Assembly.xml
index 7435a0dad01..90c22cea18b 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection/Assembly.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection/Assembly.xml
@@ -143,9 +143,6 @@
         <Parameter Name="typeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>An instance of <see langword="Object" /> representing the type, or <see langword="null" /> if <paramref name="typeName" /> is not found.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentException">
           <paramref name="typeName" /> is the empty string ("") or "\0anything".</exception>
@@ -155,6 +152,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Locates the specified type from this assembly and creates an instance of it using the system activator, using case-sensitive search.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the specified type created with the default constructor; or null if <paramref name="typeName" /> is not found. The type is resolved using the default binder, without specifying culture or activation attributes, and with <see cref="T:System.Reflection.BindingFlags" /> set to Public or Instance. </para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Type.FullName" /> of the type to locate. </param>
       </Docs>
@@ -177,12 +178,15 @@
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Locates the specified type from this assembly and creates an instance of it using the system activator, with optional case-sensitive search.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the specified type created with the default constructor; or null if <paramref name="typeName" /> is not found. The type is resolved using the default binder, without specifying culture or activation attributes, and with <see cref="T:System.Reflection.BindingFlags" /> set to Public or Instance.</para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Type.FullName" /> of the type to locate. </param>
         <param name="ignoreCase">
@@ -211,7 +215,6 @@
         <Parameter Name="activationAttributes" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="activationAttributes" /> parameter is related to client-activated objects; see <format type="text/html"><a href="4a791494-c18a-4711-a5c1-4ab0e49a8f1a">Client Activation</a></format>.</para>
@@ -220,6 +223,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Locates the specified type from this assembly and creates an instance of it using the system activator, with optional case-sensitive search and having the specified culture, arguments, and binding and activation attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the specified type, or null if <paramref name="typeName" /> is not found. The supplied arguments are used to resolve the type, and to bind the constructor that is used to create the instance.</para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Type.FullName" /> of the type to locate. </param>
         <param name="ignoreCase">
@@ -253,7 +260,6 @@
         <Parameter Name="typeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The format of the returned string is: </para>
@@ -265,6 +271,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the name of a type qualified by the display name of its assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The full name of the type qualified by the display name of the assembly.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The display name of an assembly. </param>
         <param name="typeName">
@@ -346,12 +356,15 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether this assembly and the specified object are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="o" /> is equal to this instance; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this instance. </param>
       </Docs>
@@ -489,7 +502,6 @@ public class AssemblyExample {
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In order to call this method, you must have a <see cref="T:System.Type" /> object, which means that the assembly in which the class is defined must already be loaded.</para>
@@ -498,6 +510,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the currently loaded assembly in which the specified class is defined.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The assembly in which the specified class is defined.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />An object representing a class in the assembly that will be returned. </param>
       </Docs>
@@ -516,7 +532,6 @@ public class AssemblyExample {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>Assembly of the method which invoked the calling method.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the method that calls the <see cref="M:System.Reflection.Assembly.GetCallingAssembly" /> method is expanded inline by the just-in-time (JIT) compiler, or if its caller is expanded inline, the assembly that is returned by <see cref="M:System.Reflection.Assembly.GetCallingAssembly" /> may differ unexpectedly. For example, consider the following methods and assemblies:</para>
@@ -538,6 +553,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Reflection.Assembly" /> of the method that invoked the currently executing method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The Assembly object of the method that invoked the currently executing method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetCustomAttributes">
@@ -556,7 +575,6 @@ public class AssemblyExample {
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method implements the corresponding <see cref="T:System.Reflection.ICustomAttributeProvider" /> interface method. Therefore, the <paramref name="inherit" /> parameter must be specified even though it is ignored.</para>
@@ -742,6 +760,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all the custom attributes for this assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains the custom attributes for this assembly.</para>
+        </returns>
         <param name="inherit">
           <attribution license="cc4" from="Microsoft" modified="false" />This argument is ignored for objects of type <see cref="T:System.Reflection.Assembly" />. </param>
       </Docs>
@@ -763,7 +785,6 @@ public class AssemblyExample {
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method implements the corresponding <see cref="T:System.Reflection.ICustomAttributeProvider" /> interface method. Therefore, the <paramref name="inherit" /> parameter must be specified even though it is ignored.</para>
@@ -949,6 +970,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the custom attributes for this assembly as specified by type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains the custom attributes for this assembly as specified by <paramref name="attributeType" />.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type for which the custom attributes are to be returned. </param>
         <param name="inherit">
@@ -967,7 +992,6 @@ public class AssemblyExample {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to examine the custom attributes of code in the reflection-only context, in cases where the custom attributes themselves are defined in code that is loaded into the reflection-only context. Methods like <see cref="Overload:System.Attribute.GetCustomAttributes" /> and <see cref="Overload:System.Reflection.Assembly.GetCustomAttributes" /> cannot be used in such cases, because they create instances of the attributes. Code in the reflection-only context cannot be executed. For more information and for example code, see the <see cref="T:System.Reflection.CustomAttributeData" /> class.</para>
@@ -976,6 +1000,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns information about the attributes that have been applied to the current <see cref="T:System.Reflection.Assembly" />, expressed as <see cref="T:System.Reflection.CustomAttributeData" /> objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A generic list of <see cref="T:System.Reflection.CustomAttributeData" /> objects representing data about the attributes that have been applied to the current assembly.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetEntryAssembly">
@@ -992,7 +1020,6 @@ public class AssemblyExample {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>The entry assembly.  If invoked from a secondary AppDomain, this call returns null.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Reflection.Assembly.GetEntryAssembly" /> method can return null when a managed assembly has been loaded from an unmanaged application. For example, if an unmanaged application creates an instance of a COM component written in C#, a call to the <see cref="M:System.Reflection.Assembly.GetEntryAssembly" /> method from the C# component returns null, because the entry point for the process was unmanaged code rather than a managed assembly.</para>
@@ -1001,6 +1028,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the process executable in the default application domain. In other application domains, this is the first executable that was executed by <see cref="M:System.AppDomain.ExecuteAssembly(System.String)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The assembly that is the process executable in the default application domain, or the first executable that was executed by <see cref="M:System.AppDomain.ExecuteAssembly(System.String)" />. Can return null when called from unmanaged code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetExecutingAssembly">
@@ -1017,7 +1048,6 @@ public class AssemblyExample {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To get the assembly that contains the method that called the currently executing code, use <see cref="M:System.Reflection.Assembly.GetCallingAssembly" />.</para>
@@ -1026,6 +1056,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the assembly that contains the code that is currently executing.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The assembly that contains the code that is currently executing. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetExportedTypes">
@@ -1042,7 +1076,6 @@ public class AssemblyExample {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The only types visible outside an assembly are public types and public types nested within other public types.</para>
@@ -1051,6 +1084,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the public types defined in this assembly that are visible outside the assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that represents the types defined in this assembly that are visible outside the assembly.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetFile">
@@ -1069,7 +1106,6 @@ public class AssemblyExample {
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method works on both public and private resource files.</para>
@@ -1079,6 +1115,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.IO.FileStream" /> for the specified file in the file table of the manifest of this assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A stream that contains the specified file, or null if the file is not found.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the specified file. Do not include the path to the file.</param>
       </Docs>
@@ -1097,7 +1137,6 @@ public class AssemblyExample {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method works on public and private resource files.</para>
@@ -1107,6 +1146,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the files in the file table of an assembly manifest.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of streams that contain the files.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetFiles">
@@ -1125,7 +1168,6 @@ public class AssemblyExample {
         <Parameter Name="getResourceModules" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method works on public and private resource files.</para>
@@ -1134,6 +1176,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the files in the file table of an assembly manifest, specifying whether to include resource modules.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of streams that contain the files.</para>
+        </returns>
         <param name="getResourceModules">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include resource modules; otherwise, false. </param>
       </Docs>
@@ -1150,12 +1196,15 @@ public class AssemblyExample {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetLoadedModules">
@@ -1172,12 +1221,15 @@ public class AssemblyExample {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all the loaded modules that are part of this assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of modules.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetLoadedModules">
@@ -1196,12 +1248,15 @@ public class AssemblyExample {
         <Parameter Name="getResourceModules" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all the loaded modules that are part of this assembly, specifying whether to include resource modules.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of modules.</para>
+        </returns>
         <param name="getResourceModules">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include resource modules; otherwise, false. </param>
       </Docs>
@@ -1222,7 +1277,6 @@ public class AssemblyExample {
         <Parameter Name="resourceName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resource information is returned only if the resource is visible to the caller, or the caller has <see cref="T:System.Security.Permissions.ReflectionPermission" />.</para>
@@ -1231,6 +1285,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns information about how the given resource has been persisted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is populated with information about the resource's topology, or null if the resource is not found.</para>
+        </returns>
         <param name="resourceName">
           <attribution license="cc4" from="Microsoft" modified="false" />The case-sensitive name of the resource. </param>
       </Docs>
@@ -1249,7 +1307,6 @@ public class AssemblyExample {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resource information is returned only if the resource is visible to the caller, or the caller has <see cref="T:System.Security.Permissions.ReflectionPermission" />.</para>
@@ -1258,6 +1315,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the names of all the resources in this assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains the names of all the resources.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetManifestResourceStream">
@@ -1276,7 +1337,6 @@ public class AssemblyExample {
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A manifest resource is a resource (such as an image file) that is embedded in the assembly at compile time. For more information about manifest resources, see <see cref="http://go.microsoft.com/fwlink/?LinkId=204554">Microsoft .NET Framework Resource Basics</see> in the MSDN Library.</para>
@@ -1290,6 +1350,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads the specified manifest resource from this assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The manifest resource; or null if no resources were specified during compilation or if the resource is not visible to the caller.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The case-sensitive name of the manifest resource being requested. </param>
       </Docs>
@@ -1311,7 +1375,6 @@ public class AssemblyExample {
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For example, if the full name specified for <paramref name="type" /> is "MyNameSpace.MyClasses" and <paramref name="name" /> is "Net", this method overload searches for a resource named "MyNameSpace.Net".</para>
@@ -1326,6 +1389,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads the specified manifest resource, scoped by the namespace of the specified type, from this assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The manifest resource; or null if no resources were specified during compilation or if the resource is not visible to the caller.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type whose namespace is used to scope the manifest resource name. </param>
         <param name="name">
@@ -1348,7 +1415,6 @@ public class AssemblyExample {
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method works on file names.</para>
@@ -1359,6 +1425,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the specified module in this assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The module being requested, or null if the module is not found.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the module being requested. </param>
       </Docs>
@@ -1377,7 +1447,6 @@ public class AssemblyExample {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method works on public and private resource files.</para>
@@ -1389,6 +1458,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all the modules that are part of this assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of modules.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetModules">
@@ -1407,7 +1480,6 @@ public class AssemblyExample {
         <Parameter Name="getResourceModules" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method works on public and private resource files.</para>
@@ -1419,6 +1491,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all the modules that are part of this assembly, specifying whether to include resource modules.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of modules.</para>
+        </returns>
         <param name="getResourceModules">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include resource modules; otherwise, false. </param>
       </Docs>
@@ -1437,12 +1513,15 @@ public class AssemblyExample {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <see cref="T:System.Reflection.AssemblyName" /> for this assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that contains the fully parsed display name for this assembly.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetName">
@@ -1461,12 +1540,15 @@ public class AssemblyExample {
         <Parameter Name="copiedName" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <see cref="T:System.Reflection.AssemblyName" /> for this assembly, setting the codebase as specified by <paramref name="copiedName" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that contains the fully parsed display name for this assembly.</para>
+        </returns>
         <param name="copiedName">
           <attribution license="cc4" from="Microsoft" modified="false" />true to set the <see cref="P:System.Reflection.Assembly.CodeBase" /> to the location of the assembly after it was shadow copied; false to set <see cref="P:System.Reflection.Assembly.CodeBase" /> to the original location. </param>
       </Docs>
@@ -1513,7 +1595,6 @@ public class AssemblyExample {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1524,6 +1605,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Reflection.AssemblyName" /> objects for all the assemblies referenced by this assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains the fully parsed display names of all the assemblies referenced by this assembly.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetSatelliteAssembly">
@@ -1542,7 +1627,6 @@ public class AssemblyExample {
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Satellite assemblies contain localized resources, as distinct from main application assemblies, which contain non-localizable executable code and resources for a single culture that serve as the default or neutral culture.</para>
@@ -1552,6 +1636,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the satellite assembly for the specified culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified satellite assembly.</para>
+        </returns>
         <param name="culture">
           <attribution license="cc4" from="Microsoft" modified="false" />The specified culture. </param>
       </Docs>
@@ -1573,7 +1661,6 @@ public class AssemblyExample {
         <Parameter Name="version" Type="System.Version" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Satellite assemblies contain localized resources, as distinct from main application assemblies, which contain non-localizable executable code and resources for a single culture that serve as the default or neutral culture.</para>
@@ -1584,6 +1671,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the specified version of the satellite assembly for the specified culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified satellite assembly.</para>
+        </returns>
         <param name="culture">
           <attribution license="cc4" from="Microsoft" modified="false" />The specified culture. </param>
         <param name="version">
@@ -1623,13 +1714,6 @@ public class AssemblyExample {
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A
-   <see cref="T:System.Type" /> object that
-      represents the specified type, or <see langword="null" /> if the specified
-   <see cref="T:System.Type" />
-   was not found.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="name" /> is equal to <see cref="F:System.String.Empty" /> or starts with the null character ('\0').</exception>
         <exception cref="T:System.ArgumentNullException">
@@ -1645,6 +1729,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Type" /> object with the specified name in the assembly instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the specified class, or null if the class is not found.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The full name of the type. </param>
       </Docs>
@@ -1667,7 +1755,6 @@ public class AssemblyExample {
         <Parameter Name="throwOnError" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method only searches the current assembly instance. The <paramref name="name" /> parameter includes the namespace but not the assembly. To search other assemblies for a type, use the <see cref="M:System.Type.GetType(System.String)" /> method overload, which can optionally include an assembly display name as part of the type name.</para>
@@ -1680,6 +1767,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Type" /> object with the specified name in the assembly instance and optionally throws an exception if the type is not found.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the specified class.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The full name of the type. </param>
         <param name="throwOnError">
@@ -1704,7 +1795,6 @@ public class AssemblyExample {
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method only searches the current assembly instance. The <paramref name="name" /> parameter includes the namespace but not the assembly. To search other assemblies for a type, use the <see cref="M:System.Type.GetType(System.String)" /> method overload, which can optionally include an assembly display name as part of the type name.</para>
@@ -1717,6 +1807,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Type" /> object with the specified name in the assembly instance, with the options of ignoring the case, and of throwing an exception if the type is not found.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the specified class.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The full name of the type. </param>
         <param name="throwOnError">
@@ -1740,11 +1834,6 @@ public class AssemblyExample {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>An array of type
-   <see cref="T:System.Type" /> containing
-      all of the types defined in the current assembly.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned array includes nested types.</para>
@@ -1757,6 +1846,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the types defined in this assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains all the types that are defined in this assembly.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1854,7 +1947,6 @@ public class AssemblyExample {
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1865,6 +1957,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether or not a specified attribute has been applied to the assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the attribute has been applied to the assembly; otherwise, false.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the attribute to be checked for this assembly. </param>
         <param name="inherit">
@@ -1929,7 +2025,6 @@ public class AssemblyExample {
         <Parameter Name="rawAssembly" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The trust level of an assembly that is loaded by using this method is the same as the trust level of the calling assembly. To load an assembly from a byte array with the trust level of the application domain, use the <see cref="M:System.Reflection.Assembly.Load(System.Byte[],System.Byte[],System.Security.SecurityContextSource)" /> method overload. For more information about the use of evidence with overloads of the <see cref="M:System.Reflection.Assembly.Load(System.Byte[],System.Byte[])" /> method that take byte arrays, see the <see cref="M:System.Reflection.Assembly.Load(System.Byte[],System.Byte[],System.Security.Policy.Evidence)" /> method overload. </para>
@@ -1940,6 +2035,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads the assembly with a common object file format (COFF)-based image containing an emitted assembly. The assembly is loaded into the application domain of the caller.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="rawAssembly">
           <attribution license="cc4" from="Microsoft" modified="false" />A byte array that is a COFF-based image containing an emitted assembly. </param>
       </Docs>
@@ -1960,7 +2059,6 @@ public class AssemblyExample {
         <Parameter Name="assemblyRef" Type="System.Reflection.AssemblyName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -1995,6 +2093,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads an assembly given its <see cref="T:System.Reflection.AssemblyName" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="assemblyRef">
           <attribution license="cc4" from="Microsoft" modified="false" />The object that describes the assembly to be loaded. </param>
       </Docs>
@@ -2016,10 +2118,6 @@ public class AssemblyExample {
         <Parameter Name="assemblyString" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The loaded <see cref="T:System.Reflection.Assembly" />
-.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="assemblyString" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -2055,6 +2153,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads an assembly given the long form of its name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="assemblyString">
           <attribution license="cc4" from="Microsoft" modified="false" />The long form of the assembly name. </param>
       </Docs>
@@ -2077,7 +2179,6 @@ public class AssemblyExample {
         <Parameter Name="rawSymbolStore" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The trust level of an assembly that is loaded by using this method is the same as the trust level of the calling assembly. To load an assembly from a byte array with the trust level of the application domain, use the <see cref="M:System.Reflection.Assembly.Load(System.Byte[],System.Byte[],System.Security.SecurityContextSource)" /> method overload. For more information about the use of evidence with overloads of the <see cref="M:System.Reflection.Assembly.Load(System.Byte[],System.Byte[])" /> method that take byte arrays, see the <see cref="M:System.Reflection.Assembly.Load(System.Byte[],System.Byte[],System.Security.Policy.Evidence)" /> method overload.</para>
@@ -2088,6 +2189,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads the assembly with a common object file format (COFF)-based image containing an emitted assembly, optionally including symbols for the assembly. The assembly is loaded into the application domain of the caller.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="rawAssembly">
           <attribution license="cc4" from="Microsoft" modified="false" />A byte array that is a COFF-based image containing an emitted assembly. </param>
         <param name="rawSymbolStore">
@@ -2116,7 +2221,6 @@ public class AssemblyExample {
         <Parameter Name="assemblySecurity" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -2152,6 +2256,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads an assembly given its <see cref="T:System.Reflection.AssemblyName" />. The assembly is loaded into the domain of the caller using the supplied evidence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="assemblyRef">
           <attribution license="cc4" from="Microsoft" modified="false" />The object that describes the assembly to be loaded. </param>
         <param name="assemblySecurity">
@@ -2180,7 +2288,6 @@ public class AssemblyExample {
         <Parameter Name="assemblySecurity" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -2211,6 +2318,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads an assembly given its display name, loading the assembly into the domain of the caller using the supplied evidence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="assemblyString">
           <attribution license="cc4" from="Microsoft" modified="false" />The display name of the assembly. </param>
         <param name="assemblySecurity">
@@ -2240,7 +2351,6 @@ public class AssemblyExample {
         <Parameter Name="securityEvidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The assembly is loaded into the domain of the caller using the supplied evidence. The raw bytes representing the symbols for the assembly are also loaded.</para>
@@ -2270,6 +2380,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads the assembly with a common object file format (COFF)-based image containing an emitted assembly, optionally including symbols and evidence for the assembly. The assembly is loaded into the application domain of the caller.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="rawAssembly">
           <attribution license="cc4" from="Microsoft" modified="false" />A byte array that is a COFF-based image containing an emitted assembly. </param>
         <param name="rawSymbolStore">
@@ -2294,7 +2408,6 @@ public class AssemblyExample {
         <Parameter Name="securityContextSource" Type="System.Security.SecurityContextSource" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The assembly is loaded into the application domain of the caller using the specified source for the security context. If <paramref name="rawSymbolStore" /> was specified, the raw bytes that represent the symbols for the assembly are also loaded.</para>
@@ -2303,6 +2416,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads the assembly with a common object file format (COFF)-based image containing an emitted assembly, optionally including symbols and specifying the source for the security context. The assembly is loaded into the application domain of the caller.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="rawAssembly">
           <attribution license="cc4" from="Microsoft" modified="false" />A byte array that is a COFF-based image containing an emitted assembly. </param>
         <param name="rawSymbolStore">
@@ -2327,7 +2444,6 @@ public class AssemblyExample {
         <Parameter Name="path" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Reflection.Assembly.LoadFile(System.String)" /> method to load and examine assemblies that have the same identity, but are located in different paths. <see cref="M:System.Reflection.Assembly.LoadFile(System.String)" /> does not load files into the <see cref="M:System.Reflection.Assembly.LoadFrom(System.String)" /> context, and does not resolve dependencies using the load path, as the <see cref="M:System.Reflection.Assembly.LoadFrom(System.String)" /> method does. <see cref="M:System.Reflection.Assembly.LoadFile(System.String)" /> is useful in this limited scenario because <see cref="M:System.Reflection.Assembly.LoadFrom(System.String)" /> cannot be used to load assemblies that have the same identities but different paths; it will load only the first such assembly.</para>
@@ -2336,6 +2452,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads the contents of an assembly file on the specified path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path of the file to load. </param>
       </Docs>
@@ -2362,7 +2482,6 @@ public class AssemblyExample {
         <Parameter Name="securityEvidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Reflection.Assembly.LoadFile(System.String)" /> method to load and examine assemblies that have the same identity, but are located in different paths. <see cref="M:System.Reflection.Assembly.LoadFile(System.String)" /> does not load files into the <see cref="M:System.Reflection.Assembly.LoadFrom(System.String)" /> context, and does not resolve dependencies using the load path, as the <see cref="M:System.Reflection.Assembly.LoadFrom(System.String)" /> method does. <see cref="M:System.Reflection.Assembly.LoadFile(System.String)" /> is useful in this limited scenario because <see cref="M:System.Reflection.Assembly.LoadFrom(System.String)" /> cannot be used to load assemblies that have the same identities but different paths; it will load only the first such assembly.</para>
@@ -2371,6 +2490,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads an assembly given its path, loading the assembly into the domain of the caller using the supplied evidence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The path of the assembly file. </param>
         <param name="securityEvidence">
@@ -2393,7 +2516,6 @@ public class AssemblyExample {
         <Parameter Name="assemblyFile" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="assemblyFile" /> parameter must refer to a URI without escape characters. This method supplies escape characters for all invalid characters in the URI.</para>
@@ -2445,6 +2567,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads an assembly given its file name or path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The name or path of the file that contains the manifest of the assembly. </param>
       </Docs>
@@ -2471,7 +2597,6 @@ public class AssemblyExample {
         <Parameter Name="securityEvidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="assemblyFile" /> parameter must refer to a URI without escape characters. This method supplies escape characters for all invalid characters in the URI.</para>
@@ -2541,6 +2666,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads an assembly given its file name or path and supplying security evidence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The name or path of the file that contains the manifest of the assembly. </param>
         <param name="securityEvidence">
@@ -2563,7 +2692,6 @@ public class AssemblyExample {
         <Parameter Name="hashAlgorithm" Type="System.Configuration.Assemblies.AssemblyHashAlgorithm" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="assemblyFile" /> parameter must refer to a URI without escape characters. This method supplies escape characters for all invalid characters in the URI.</para>
@@ -2613,6 +2741,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads an assembly given its file name or path, hash value, and hash algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The name or path of the file that contains the manifest of the assembly. </param>
         <param name="hashValue">
@@ -2645,7 +2777,6 @@ public class AssemblyExample {
         <Parameter Name="hashAlgorithm" Type="System.Configuration.Assemblies.AssemblyHashAlgorithm" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="assemblyFile" /> parameter must refer to a URI without escape characters. This method supplies escape characters for all invalid characters in the URI.</para>
@@ -2715,6 +2846,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads an assembly given its file name or path, security evidence, hash value, and hash algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The name or path of the file that contains the manifest of the assembly. </param>
         <param name="securityEvidence">
@@ -2742,12 +2877,15 @@ public class AssemblyExample {
         <Parameter Name="rawModule" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads the module, internal to this assembly, with a common object file format (COFF)-based image containing an emitted module, or a resource file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded module.</para>
+        </returns>
         <param name="moduleName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the module. This string must correspond to a file name in this assembly's manifest. </param>
         <param name="rawModule">
@@ -2772,12 +2910,15 @@ public class AssemblyExample {
         <Parameter Name="rawSymbolStore" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads the module, internal to this assembly, with a common object file format (COFF)-based image containing an emitted module, or a resource file. The raw bytes representing the symbols for the module are also loaded.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded module.</para>
+        </returns>
         <param name="moduleName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the module. This string must correspond to a file name in this assembly's manifest. </param>
         <param name="rawModule">
@@ -2807,7 +2948,6 @@ public class AssemblyExample {
         <Parameter Name="partialName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Applications that load assemblies with this method will be affected by upgrades of those assemblies. Therefore, do not use this method; redesign the application to use the <see cref="M:System.Reflection.Assembly.Load(System.String)" /> method overload or the <see cref="M:System.Reflection.Assembly.LoadFrom(System.String)" /> method overload.</para>
@@ -2817,6 +2957,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads an assembly from the application directory or from the global assembly cache using a partial name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly. If <paramref name="partialName" /> is not found, this method returns null.</para>
+        </returns>
         <param name="partialName">
           <attribution license="cc4" from="Microsoft" modified="false" />The display name of the assembly. </param>
       </Docs>
@@ -2843,7 +2987,6 @@ public class AssemblyExample {
         <Parameter Name="securityEvidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Evidence is the set of information that constitutes input to security policy decisions, such as what permissions can be granted to code.</para>
@@ -2854,6 +2997,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads an assembly from the application directory or from the global assembly cache using a partial name. The assembly is loaded into the domain of the caller using the supplied evidence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly. If <paramref name="partialName" /> is not found, this method returns null.</para>
+        </returns>
         <param name="partialName">
           <attribution license="cc4" from="Microsoft" modified="false" />The display name of the assembly. </param>
         <param name="securityEvidence">
@@ -2962,12 +3109,15 @@ public class AssemblyExample {
         <Parameter Name="right" Type="System.Reflection.Assembly" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.Assembly" /> objects are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is equal to <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly to compare to <paramref name="right" />. </param>
         <param name="right">
@@ -2989,12 +3139,15 @@ public class AssemblyExample {
         <Parameter Name="right" Type="System.Reflection.Assembly" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.Assembly" /> objects are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is not equal to <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly to compare to <paramref name="right" />.</param>
         <param name="right">
@@ -3068,7 +3221,6 @@ public class AssemblyExample {
         <Parameter Name="rawAssembly" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3079,6 +3231,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads the assembly from a common object file format (COFF)-based image containing an emitted assembly. The assembly is loaded into the reflection-only context of the caller's application domain.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="rawAssembly">
           <attribution license="cc4" from="Microsoft" modified="false" />A byte array that is a COFF-based image containing an emitted assembly.</param>
       </Docs>
@@ -3098,7 +3254,6 @@ public class AssemblyExample {
         <Parameter Name="assemblyString" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3114,6 +3269,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads an assembly into the reflection-only context, given its display name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="assemblyString">
           <attribution license="cc4" from="Microsoft" modified="false" />The display name of the assembly, as returned by the <see cref="P:System.Reflection.AssemblyName.FullName" /> property.</param>
       </Docs>
@@ -3133,7 +3292,6 @@ public class AssemblyExample {
         <Parameter Name="assemblyFile" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3147,6 +3305,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads an assembly into the reflection-only context, given its path.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The path of the file that contains the manifest of the assembly.</param>
       </Docs>
@@ -3186,12 +3348,15 @@ public class AssemblyExample {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the type of the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the <see cref="T:System.Reflection.Assembly" /> type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -3209,11 +3374,6 @@ public class AssemblyExample {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of
-   the current instance. The string takes into account the
-   current system culture.</para>
-        </returns>
         <remarks>
           <para> This method returns the <see cref="P:System.Reflection.Assembly.FullName" /> of the
    current assembly.</para>
@@ -3246,6 +3406,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the full name of the assembly, also known as the display name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The full name of the assembly, or the class name if the full name of the assembly cannot be determined.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -3263,7 +3427,6 @@ public class AssemblyExample {
         <Parameter Name="assemblyFile" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to load a local assembly that the operating system has flagged as having been loaded from the Web (for example, a temporary file that was downloaded from the Internet or intranet). Before the net_v40_long, such assemblies were automatically loaded into a sandboxed application domain. Starting with the net_v40_short, they are loaded with full trust. </para>
@@ -3277,6 +3440,10 @@ public class AssemblyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads an assembly into the load-from context, bypassing some security checks.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The name or path of the file that contains the manifest of the assembly.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection/AssemblyName.xml b/mcs/class/corlib/Documentation/en/System.Reflection/AssemblyName.xml
index f6a3239c246..7c918291497 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection/AssemblyName.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection/AssemblyName.xml
@@ -200,7 +200,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A new object is created, identical to the original.</para>
@@ -209,6 +208,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Makes a copy of this <see cref="T:System.Reflection.AssemblyName" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is a copy of this <see cref="T:System.Reflection.AssemblyName" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CodeBase">
@@ -394,7 +397,6 @@
         <Parameter Name="assemblyFile" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'AssemblyName'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This will only work if the file contains an assembly manifest. This method causes the file to be opened and closed, but the assembly is not added to this domain.</para>
@@ -403,6 +405,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Reflection.AssemblyName" /> for a given file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the given assembly file.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The path for the assembly whose <see cref="T:System.Reflection.AssemblyName" /> is to be returned. </param>
       </Docs>
@@ -449,12 +455,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the public key of the assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array that contains the public key of the assembly.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetPublicKeyToken">
@@ -471,12 +480,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the public key token, which is the last 8 bytes of the SHA-1 hash of the public key under which the application or assembly is signed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array that contains the public key token.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HashAlgorithm">
@@ -625,7 +637,6 @@
         <Parameter Name="definition" Type="System.Reflection.AssemblyName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The comparison depends only on the simple assembly name. It ignores version, culture, and public key token.  </para>
@@ -634,6 +645,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether two assembly names are the same. The comparison is based on the simple assembly names.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the simple assembly names are the same; otherwise, false.</para>
+        </returns>
         <param name="reference">
           <attribution license="cc4" from="Microsoft" modified="false" />The reference assembly name.</param>
         <param name="definition">
@@ -829,7 +844,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the description of <see cref="T:System.Reflection.AssemblyName" /> for the format of the returned string.</para>
@@ -838,6 +852,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the full name of the assembly, also known as the display name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The full name of the assembly, or the class name if the full name cannot be determined.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Version">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection/AssemblyNameProxy.xml b/mcs/class/corlib/Documentation/en/System.Reflection/AssemblyNameProxy.xml
index cf91b585215..f3e98fda86f 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection/AssemblyNameProxy.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection/AssemblyNameProxy.xml
@@ -62,7 +62,6 @@
         <Parameter Name="assemblyFile" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'AssemblyName'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This will only work if the file contains an assembly manifest. This method causes the file to be opened and closed.</para>
@@ -71,6 +70,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the AssemblyName for a given file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An AssemblyName object representing the given file.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly file for which to get the AssemblyName. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection/Binder.xml b/mcs/class/corlib/Documentation/en/System.Reflection/Binder.xml
index 8aaf97fbbbc..a64a98f29ee 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection/Binder.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection/Binder.xml
@@ -80,12 +80,6 @@
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Reflection.FieldInfo" /> 
-instance that reflects the field that matches the specified criteria. It is not
-required that this instance be contained in <paramref name="match" />. If a suitable field is not found,
-returns <see langword="null" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="bindingAttr" /> does not include <see cref="F:System.Reflection.BindingFlags.SetField" />, the default binder implementation provided by <see cref="P:System.Type.DefaultBinder" /> simply returns the first element of <paramref name="match" />. No selection is done. </para>
@@ -95,6 +89,10 @@ returns <see langword="null" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Selects a field from the given set of fields, based on the specified criteria.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The matching field. </para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Reflection.BindingFlags" /> values. </param>
         <param name="match">
@@ -192,11 +190,6 @@ returns <see langword="null" />
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A new object of the type specified by <paramref name="type       " />. The contents of
-      this object are equal to those of <paramref name="value" />
-      .</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reflection models the accessibility rules of the common type system. For example, if the caller is in the same assembly, the caller does not need special permissions for internal members. Otherwise, the caller needs <see cref="T:System.Security.Permissions.ReflectionPermission" />. This is consistent with lookup of members that are protected, private, and so on.</para>
@@ -323,6 +316,10 @@ returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Changes the type of the given Object to the given Type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that contains the given value as the new type. </para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to change into a new Type. </param>
         <param name="type">
@@ -420,14 +417,6 @@ returns <see langword="null" />
         <Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.MethodBase" />
-instance that reflects the method that
-is matched to the specified criteria. It is not required that this instance
-be contained in <paramref name="match" /> . If a suitable method is
-not found, returns <see langword="null" />
-.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method should return null if no method matches the criteria. This method controls the selection provided by the GetConstructor and GetMethod methods on Type.</para>
@@ -436,6 +425,10 @@ not found, returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Selects a method from the given set of methods, based on the argument type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The matching method, if found; otherwise, null.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Reflection.BindingFlags" /> values. </param>
         <param name="match">
@@ -468,13 +461,6 @@ not found, returns <see langword="null" />
         <Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Reflection.PropertyInfo" /> instance that reflects the property that
-   matches the specified criteria. It is not required that this instance be
-   contained in <paramref name="match" /> . If a
-   suitable property is not found, returns <see langword="null" />
-   .</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method controls the selection provided by the GetProperty method on Type.</para>
@@ -483,6 +469,10 @@ not found, returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Selects a property from the given set of properties, based on the specified criteria.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The matching property.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Reflection.BindingFlags" /> values. </param>
         <param name="match">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection/ConstructorInfo.xml b/mcs/class/corlib/Documentation/en/System.Reflection/ConstructorInfo.xml
index 35b1948df85..1f08fb36508 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection/ConstructorInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection/ConstructorInfo.xml
@@ -121,12 +121,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> equals the type and value of this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance, or null.</param>
       </Docs>
@@ -143,12 +146,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetType">
@@ -189,11 +195,6 @@
         <Parameter Name="parameters" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>An
-      instance of the class that declared the constructor reflected by the
-      current instance.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>The types of the elements of <paramref name="parameters" /> do not match the types of the parameters accepted by the constructor reflected by the current instance, under the constraints of the default binder.</para>
         </exception>
@@ -219,6 +220,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes the constructor reflected by the instance that has the specified parameters, providing default values for the parameters not commonly used.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the class associated with the constructor.</para>
+        </returns>
         <param name="parameters">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of values that matches the number, order and type (under the constraints of the default binder) of the parameters for this constructor. If this constructor takes no parameters, then use either an array with zero elements or null, as in Object[] parameters = new Object[0]. Any object in this array that is not explicitly initialized with a value will contain the default value for that object type. For reference-type elements, this value is null. For value-type elements, this value is 0, 0.0, or false, depending on the specific element type. </param>
       </Docs>
@@ -244,9 +249,6 @@
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>An instance of the class that declared the constructor reflected by the current instance.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">The types of the elements of <paramref name="parameters" /> do not match the types of the parameters accepted by the constructor reflected by the current instance, under the constraints of <paramref name="binder" />.</exception>
         <exception cref="T:System.MethodAccessException">The caller does not have the required permissions.</exception>
         <exception cref="T:System.Reflection.TargetInvocationException">The constructor reflected by the current instance threw an exception.</exception>
@@ -276,6 +278,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented in a derived class, invokes the constructor reflected by this ConstructorInfo with the specified arguments, under the constraints of the specified Binder.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the class associated with the constructor.</para>
+        </returns>
         <param name="invokeAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the BindingFlags values that specifies the type of binding. </param>
         <param name="binder">
@@ -332,12 +338,15 @@
         <Parameter Name="right" Type="System.Reflection.ConstructorInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.ConstructorInfo" /> objects are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is equal to <paramref name="right" />; otherwise false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Reflection.ConstructorInfo" /> to compare.</param>
         <param name="right">
@@ -359,12 +368,15 @@
         <Parameter Name="right" Type="System.Reflection.ConstructorInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.ConstructorInfo" /> objects are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is not equal to <paramref name="right" />; otherwise false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Reflection.ConstructorInfo" /> to compare.</param>
         <param name="right">
@@ -412,12 +424,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Type" /> object representing the <see cref="T:System.Reflection.ConstructorInfo" /> type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object representing the <see cref="T:System.Reflection.ConstructorInfo" /> type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Runtime.InteropServices._ConstructorInfo.GetTypeInfo">
@@ -530,7 +545,6 @@
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Reflection.ConstructorInfo" /> instance is cast to an <see cref="T:System.Runtime.InteropServices._ConstructorInfo" /> interface.</para>
@@ -539,6 +553,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MethodBase.Invoke(System.Object,System.Reflection.BindingFlags,System.Reflection.Binder,System.Object[],System.Globalization.CultureInfo)" /> method. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the type.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The instance that created this method.</param>
         <param name="invokeAttr">
@@ -568,7 +586,6 @@
         <Parameter Name="parameters" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Reflection.ConstructorInfo" /> instance is cast to an <see cref="T:System.Runtime.InteropServices._ConstructorInfo" /> interface.</para>
@@ -577,6 +594,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MethodBase.Invoke(System.Object,System.Object[])" /> method. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the type.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The instance that created this method.</param>
         <param name="parameters">
@@ -602,7 +623,6 @@
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Reflection.ConstructorInfo" /> instance is cast to an <see cref="T:System.Runtime.InteropServices._ConstructorInfo" /> interface.</para>
@@ -611,6 +631,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.ConstructorInfo.Invoke(System.Reflection.BindingFlags,System.Reflection.Binder,System.Object[],System.Globalization.CultureInfo)" /> method. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the type.</para>
+        </returns>
         <param name="invokeAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Reflection.BindingFlags" /> values that specifies the type of binding.</param>
         <param name="binder">
@@ -637,7 +661,6 @@
         <Parameter Name="parameters" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Reflection.ConstructorInfo" /> instance is cast to an <see cref="T:System.Runtime.InteropServices._ConstructorInfo" /> interface.</para>
@@ -646,6 +669,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.ConstructorInfo.Invoke(System.Object[])" /> method. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the type.</para>
+        </returns>
         <param name="parameters">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of objects used to match the number, order, and type of the parameters for this constructor, under the constraints of <paramref name="binder" />. If this constructor does not require parameters, pass an array with zero elements. Any object in this array that is not explicitly initialized with a value will contain the default value for that object type. For reference-type elements, this value is null. For value-type elements, this value is 0, 0.0, or false, depending on the specific element type.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection/CustomAttributeData.xml b/mcs/class/corlib/Documentation/en/System.Reflection/CustomAttributeData.xml
index 7dde8e2c77b..3f37cf0fdab 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection/CustomAttributeData.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection/CustomAttributeData.xml
@@ -159,12 +159,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is equal to the current instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance, or null.</param>
       </Docs>
@@ -184,7 +187,6 @@
         <Parameter Name="target" Type="System.Reflection.Assembly" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -194,6 +196,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a list of <see cref="T:System.Reflection.CustomAttributeData" /> objects representing data about the attributes that have been applied to the target assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A list of objects that represent data about the attributes that have been applied to the target assembly.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly whose custom attribute data is to be retrieved.</param>
       </Docs>
@@ -213,7 +219,6 @@
         <Parameter Name="target" Type="System.Reflection.MemberInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -223,6 +228,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a list of <see cref="T:System.Reflection.CustomAttributeData" /> objects representing data about the attributes that have been applied to the target member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A list of objects that represent data about the attributes that have been applied to the target member.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The member whose attribute data is to be retrieved.</param>
       </Docs>
@@ -242,13 +251,16 @@
         <Parameter Name="target" Type="System.Reflection.Module" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a list of <see cref="T:System.Reflection.CustomAttributeData" /> objects representing data about the attributes that have been applied to the target module.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A list of objects that represent data about the attributes that have been applied to the target module.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The module whose custom attribute data is to be retrieved.</param>
       </Docs>
@@ -268,7 +280,6 @@
         <Parameter Name="target" Type="System.Reflection.ParameterInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -278,6 +289,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a list of <see cref="T:System.Reflection.CustomAttributeData" /> objects representing data about the attributes that have been applied to the target parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A list of objects that represent data about the attributes that have been applied to the target parameter.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The parameter whose attribute data is to be retrieved.</param>
       </Docs>
@@ -339,7 +354,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -349,6 +363,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of the custom attribute.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string value that represents the custom attribute.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection/CustomAttributeExtensions.xml b/mcs/class/corlib/Documentation/en/System.Reflection/CustomAttributeExtensions.xml
index bf356f74e93..cfde4fa2e7c 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection/CustomAttributeExtensions.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection/CustomAttributeExtensions.xml
@@ -33,7 +33,6 @@
         <Parameter Name="attributeType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Reflection.CustomAttributeExtensions.GetCustomAttributes(System.Reflection.Assembly,System.Type)" /> extension method if you expect more than one value to be returned, or <see cref="T:System.Reflection.AmbiguousMatchException" /> will be thrown. </para>
@@ -42,6 +41,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a custom attribute of a specified type that is applied to a specified assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A custom attribute that matches <paramref name="attributeType" />, or null if no such attribute is found.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly to inspect.</param>
         <param name="attributeType">
@@ -63,7 +66,6 @@
         <Parameter Name="attributeType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Reflection.CustomAttributeExtensions.GetCustomAttributes(System.Reflection.Assembly,System.Type)" /> extension method if you expect more than one value to be returned, or <see cref="T:System.Reflection.AmbiguousMatchException" /> will be thrown. </para>
@@ -72,6 +74,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a custom attribute of a specified type that is applied to a specified member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A custom attribute that matches <paramref name="attributeType" />, or null if no such attribute is found.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The member to inspect.</param>
         <param name="attributeType">
@@ -93,7 +99,6 @@
         <Parameter Name="attributeType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Reflection.CustomAttributeExtensions.GetCustomAttributes(System.Reflection.Assembly,System.Type)" /> extension method if you expect more than one value to be returned, or <see cref="T:System.Reflection.AmbiguousMatchException" /> will be thrown. </para>
@@ -102,6 +107,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a custom attribute of a specified type that is applied to a specified module.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A custom attribute that matches <paramref name="attributeType" />, or null if no such attribute is found.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The module to inspect.</param>
         <param name="attributeType">
@@ -123,7 +132,6 @@
         <Parameter Name="attributeType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Reflection.CustomAttributeExtensions.GetCustomAttributes(System.Reflection.Assembly,System.Type)" /> extension method if you expect more than one value to be returned, or <see cref="T:System.Reflection.AmbiguousMatchException" /> will be thrown. </para>
@@ -132,6 +140,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a custom attribute of a specified type that is applied to a specified parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A custom attribute that matches <paramref name="attributeType" />, or null if no such attribute is found.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The parameter to inspect.</param>
         <param name="attributeType">
@@ -154,7 +166,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Reflection.CustomAttributeExtensions.GetCustomAttributes(System.Reflection.Assembly,System.Type)" /> extension method if you expect more than one value to be returned, or <see cref="T:System.Reflection.AmbiguousMatchException" /> will be thrown. </para>
@@ -163,6 +174,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a custom attribute of a specified type that is applied to a specified member, and optionally inspects the ancestors of that member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A custom attribute that matches <paramref name="attributeType" />, or null if no such attribute is found.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The member to inspect.</param>
         <param name="attributeType">
@@ -187,7 +202,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Reflection.CustomAttributeExtensions.GetCustomAttributes(System.Reflection.Assembly,System.Type)" /> extension method if you expect more than one value to be returned, or <see cref="T:System.Reflection.AmbiguousMatchException" /> will be thrown. </para>
@@ -196,6 +210,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a custom attribute of a specified type that is applied to a specified parameter, and optionally inspects the ancestors of that parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A custom attribute matching <paramref name="attributeType" />, or null if no such attribute is found.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The parameter to inspect.</param>
         <param name="attributeType">
@@ -225,7 +243,6 @@
         <Parameter Name="element" Type="System.Reflection.Assembly" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Reflection.CustomAttributeExtensions.GetCustomAttributes(System.Reflection.Assembly,System.Type)" /> extension method if you expect more than one value to be returned, or <see cref="T:System.Reflection.AmbiguousMatchException" /> will be thrown. </para>
@@ -234,6 +251,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a custom attribute of a specified type that is applied to a specified assembly. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A custom attribute that matches <paramref name="T" />, or null if no such attribute is found.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly to inspect.</param>
         <typeparam name="T">
@@ -261,7 +282,6 @@
         <Parameter Name="element" Type="System.Reflection.MemberInfo" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Reflection.CustomAttributeExtensions.GetCustomAttributes(System.Reflection.Assembly,System.Type)" /> extension method if you expect more than one value to be returned, or <see cref="T:System.Reflection.AmbiguousMatchException" /> will be thrown. </para>
@@ -270,6 +290,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a custom attribute of a specified type that is applied to a specified member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A custom attribute that matches <paramref name="T" />, or null if no such attribute is found.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The member to inspect.</param>
         <typeparam name="T">
@@ -297,7 +321,6 @@
         <Parameter Name="element" Type="System.Reflection.Module" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Reflection.CustomAttributeExtensions.GetCustomAttributes(System.Reflection.Assembly,System.Type)" /> extension method if you expect more than one value to be returned, or <see cref="T:System.Reflection.AmbiguousMatchException" /> will be thrown. </para>
@@ -306,6 +329,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a custom attribute of a specified type that is applied to a specified module.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A custom attribute that matches <paramref name="T" />, or null if no such attribute is found.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The module to inspect.</param>
         <typeparam name="T">
@@ -333,7 +360,6 @@
         <Parameter Name="element" Type="System.Reflection.ParameterInfo" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Reflection.CustomAttributeExtensions.GetCustomAttributes(System.Reflection.Assembly,System.Type)" /> extension method if you expect more than one value to be returned, or <see cref="T:System.Reflection.AmbiguousMatchException" /> will be thrown. </para>
@@ -342,6 +368,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a custom attribute of a specified type that is applied to a specified parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A custom attribute that matches <paramref name="T" />, or null if no such attribute is found.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The parameter to inspect.</param>
         <typeparam name="T">
@@ -370,7 +400,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Reflection.CustomAttributeExtensions.GetCustomAttributes(System.Reflection.Assembly,System.Type)" /> extension method if you expect more than one value to be returned, or <see cref="T:System.Reflection.AmbiguousMatchException" /> will be thrown. </para>
@@ -379,6 +408,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a custom attribute of a specified type that is applied to a specified member, and optionally inspects the ancestors of that member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A custom attribute that matches <paramref name="T" />, or null if no such attribute is found.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The member to inspect.</param>
         <param name="inherit">
@@ -409,7 +442,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Reflection.CustomAttributeExtensions.GetCustomAttributes(System.Reflection.Assembly,System.Type)" /> extension method if you expect more than one value to be returned, or <see cref="T:System.Reflection.AmbiguousMatchException" /> will be thrown. </para>
@@ -418,6 +450,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a custom attribute of a specified type that is applied to a specified parameter, and optionally inspects the ancestors of that parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A custom attribute that matches <paramref name="T" />, or null if no such attribute is found.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The parameter to inspect.</param>
         <param name="inherit">
@@ -440,12 +476,15 @@
         <Parameter Name="element" Type="System.Reflection.Assembly" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection of custom attributes that are applied to a specified assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of the custom attributes that are applied to <paramref name="element" />, or an empty collection if no such attributes exist. </para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly to inspect.</param>
       </Docs>
@@ -464,12 +503,15 @@
         <Parameter Name="element" Type="System.Reflection.MemberInfo" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection of custom attributes that are applied to a specified member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of the custom attributes that are applied to <paramref name="element" />, or an empty collection if no such attributes exist. </para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The member to inspect.</param>
       </Docs>
@@ -488,12 +530,15 @@
         <Parameter Name="element" Type="System.Reflection.Module" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection of custom attributes that are applied to a specified module.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of the custom attributes that are applied to <paramref name="element" />, or an empty collection if no such attributes exist. </para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The module to inspect.</param>
       </Docs>
@@ -512,12 +557,15 @@
         <Parameter Name="element" Type="System.Reflection.ParameterInfo" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection of custom attributes that are applied to a specified parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of the custom attributes that are applied to <paramref name="element" />, or an empty collection if no such attributes exist. </para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The parameter to inspect.</param>
       </Docs>
@@ -537,12 +585,15 @@
         <Parameter Name="attributeType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection of custom attributes of a specified type that are applied to a specified assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of the custom attributes that are applied to <paramref name="element" /> and that match <paramref name="attributeType" />, or an empty collection if no such attributes exist. </para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly to inspect.</param>
         <param name="attributeType">
@@ -564,12 +615,15 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection of custom attributes that are applied to a specified member, and optionally inspects the ancestors of that member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of the custom attributes that are applied to <paramref name="element" /> that match the specified criteria, or an empty collection if no such attributes exist. </para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The member to inspect.</param>
         <param name="inherit">
@@ -591,12 +645,15 @@
         <Parameter Name="attributeType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection of custom attributes of a specified type that are applied to a specified member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of the custom attributes that are applied to <paramref name="element" /> and that match <paramref name="attributeType" />, or an empty collection if no such attributes exist. </para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The member to inspect.</param>
         <param name="attributeType">
@@ -618,12 +675,15 @@
         <Parameter Name="attributeType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection of custom attributes of a specified type that are applied to a specified module.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of the custom attributes that are applied to <paramref name="element" /> and that match <paramref name="attributeType" />, or an empty collection if no such attributes exist.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The module to inspect.</param>
         <param name="attributeType">
@@ -645,12 +705,15 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection of custom attributes that are applied to a specified parameter, and optionally inspects the ancestors of that parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of the custom attributes that are applied to <paramref name="element" />, or an empty collection if no such attributes exist. </para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The parameter to inspect.</param>
         <param name="inherit">
@@ -672,12 +735,15 @@
         <Parameter Name="attributeType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection of custom attributes of a specified type that are applied to a specified parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of the custom attributes that are applied to <paramref name="element" /> and that match <paramref name="attributeType" />, or an empty collection if no such attributes exist. </para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The parameter to inspect.</param>
         <param name="attributeType">
@@ -700,12 +766,15 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection of custom attributes of a specified type that are applied to a specified member, and optionally inspects the ancestors of that member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of the custom attributes that are applied to <paramref name="element" /> and that match <paramref name="attributeType" />, or an empty collection if no such attributes exist.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The member to inspect.</param>
         <param name="attributeType">
@@ -730,12 +799,15 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection of custom attributes of a specified type that are applied to a specified parameter, and optionally inspects the ancestors of that parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of the custom attributes that are applied to <paramref name="element" /> and that match <paramref name="attributeType" />, or an empty collection if no such attributes exist. </para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The parameter to inspect.</param>
         <param name="attributeType">
@@ -765,12 +837,15 @@
         <Parameter Name="element" Type="System.Reflection.Assembly" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection of custom attributes of a specified type that are applied to a specified assembly. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of the custom attributes that are applied to <paramref name="element" /> and that match <paramref name="T" />, or an empty collection if no such attributes exist. </para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly to inspect.</param>
         <typeparam name="T">
@@ -798,12 +873,15 @@
         <Parameter Name="element" Type="System.Reflection.MemberInfo" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection of custom attributes of a specified type that are applied to a specified member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of the custom attributes that are applied to <paramref name="element" /> and that match <paramref name="T" />, or an empty collection if no such attributes exist. </para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The member to inspect.</param>
         <typeparam name="T">
@@ -831,12 +909,15 @@
         <Parameter Name="element" Type="System.Reflection.Module" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection of custom attributes of a specified type that are applied to a specified module.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of the custom attributes that are applied to <paramref name="element" /> and that match <paramref name="T" />, or an empty collection if no such attributes exist. </para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The module to inspect.</param>
         <typeparam name="T">
@@ -864,12 +945,15 @@
         <Parameter Name="element" Type="System.Reflection.ParameterInfo" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection of custom attributes of a specified type that are applied to a specified parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of the custom attributes that are applied to <paramref name="element" /> and that match <paramref name="T" />, or an empty collection if no such attributes exist. </para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The parameter to inspect.</param>
         <typeparam name="T">
@@ -898,12 +982,15 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection of custom attributes of a specified type that are applied to a specified member, and optionally inspects the ancestors of that member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of the custom attributes that are applied to <paramref name="element" /> and that match <paramref name="T" />, or an empty collection if no such attributes exist. </para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The member to inspect.</param>
         <param name="inherit">
@@ -934,12 +1021,15 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection of custom attributes of a specified type that are applied to a specified parameter, and optionally inspects the ancestors of that parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of the custom attributes that are applied to <paramref name="element" /> and that match <paramref name="T" />, or an empty collection if no such attributes exist. </para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The parameter to inspect.</param>
         <param name="inherit">
@@ -963,12 +1053,15 @@
         <Parameter Name="attributeType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether custom attributes of a specified type are applied to a specified assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if an attribute of the specified type is applied to <paramref name="element" />; otherwise, false.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly to inspect.</param>
         <param name="attributeType">
@@ -990,12 +1083,15 @@
         <Parameter Name="attributeType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether custom attributes of a specified type are applied to a specified member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if an attribute of the specified type is applied to <paramref name="element" />; otherwise, false.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The member to inspect.</param>
         <param name="attributeType">
@@ -1017,12 +1113,15 @@
         <Parameter Name="attributeType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether custom attributes of a specified type are applied to a specified module.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if an attribute of the specified type is applied to <paramref name="element" />; otherwise, false.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The module to inspect.</param>
         <param name="attributeType">
@@ -1044,12 +1143,15 @@
         <Parameter Name="attributeType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether custom attributes of a specified type are applied to a specified parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if an attribute of the specified type is applied to <paramref name="element" />; otherwise, false.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The parameter to inspect.</param>
         <param name="attributeType">
@@ -1072,12 +1174,15 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether custom attributes of a specified type are applied to a specified member, and, optionally, applied to its ancestors.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if an attribute of the specified type is applied to <paramref name="element" />; otherwise, false.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The member to inspect.</param>
         <param name="attributeType">
@@ -1102,12 +1207,15 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether custom attributes of a specified type are applied to a specified parameter, and, optionally, applied to its ancestors.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if an attribute of the specified type is applied to <paramref name="element" />; otherwise, false.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />The parameter to inspect.</param>
         <param name="attributeType">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection/CustomAttributeNamedArgument.xml b/mcs/class/corlib/Documentation/en/System.Reflection/CustomAttributeNamedArgument.xml
index 2e42057565e..5aa080a222b 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection/CustomAttributeNamedArgument.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection/CustomAttributeNamedArgument.xml
@@ -100,12 +100,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> equals the type and value of this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance, or null.</param>
       </Docs>
@@ -123,12 +126,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsField">
@@ -209,12 +215,15 @@
         <Parameter Name="right" Type="System.Reflection.CustomAttributeNamedArgument" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether two <see cref="T:System.Reflection.CustomAttributeNamedArgument" /> structures are equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two <see cref="T:System.Reflection.CustomAttributeNamedArgument" /> structures are equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The structure to the left of the equality operator.</param>
         <param name="right">
@@ -237,12 +246,15 @@
         <Parameter Name="right" Type="System.Reflection.CustomAttributeNamedArgument" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether two <see cref="T:System.Reflection.CustomAttributeNamedArgument" /> structures are different.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two <see cref="T:System.Reflection.CustomAttributeNamedArgument" /> structures are different; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The structure to the left of the inequality operator.</param>
         <param name="right">
@@ -262,13 +274,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that consists of the argument name, the equal sign, and a string representation of the argument value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that consists of the argument name, the equal sign, and a string representation of the argument value.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TypedValue">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection/CustomAttributeTypedArgument.xml b/mcs/class/corlib/Documentation/en/System.Reflection/CustomAttributeTypedArgument.xml
index 4abaab7a70c..0c626eecac4 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection/CustomAttributeTypedArgument.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection/CustomAttributeTypedArgument.xml
@@ -161,12 +161,15 @@
         <Parameter Name="right" Type="System.Reflection.CustomAttributeTypedArgument" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether two <see cref="T:System.Reflection.CustomAttributeTypedArgument" /> structures are equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two <see cref="T:System.Reflection.CustomAttributeTypedArgument" /> structures are equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.CustomAttributeTypedArgument" /> structure to the left of the equality operator.</param>
         <param name="right">
@@ -189,12 +192,15 @@
         <Parameter Name="right" Type="System.Reflection.CustomAttributeTypedArgument" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether two <see cref="T:System.Reflection.CustomAttributeTypedArgument" /> structures are different.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two <see cref="T:System.Reflection.CustomAttributeTypedArgument" /> structures are different; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.CustomAttributeTypedArgument" /> structure to the left of the inequality operator.</param>
         <param name="right">
@@ -214,13 +220,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string consisting of the argument name, the equal sign, and a string representation of the argument value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string consisting of the argument name, the equal sign, and a string representation of the argument value.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection/EventInfo.xml b/mcs/class/corlib/Documentation/en/System.Reflection/EventInfo.xml
index c47b27bd6b5..3c0fe3f650d 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection/EventInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection/EventInfo.xml
@@ -182,12 +182,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> equals the type and value of this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance, or null.</param>
       </Docs>
@@ -240,14 +243,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.MethodInfo" /> 
-instance that reflects
-the public method used to add an event handler delegate to an event
-source for the event reflected by the current instance, if found; otherwise,
-returns <see langword="null" />
-. </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>GetAddMethod initializes and adds the event subscribe method. The AddEventHandler method is used to add an event-handler delegate to the invocation list of an event source.</para>
@@ -256,6 +251,10 @@ returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the method used to add an event handler delegate to the event source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodInfo" /> object representing the method used to add an event handler delegate to the event source.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -276,14 +275,6 @@ returns <see langword="null" />
         <Parameter Name="nonPublic" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Reflection.MethodInfo" />
-instance that
-reflects the method used to add an event handler delegate to an event source
-for the event reflected by the current instance, if found; otherwise, returns
-<see langword="null" /> 
-.</para>
-        </returns>
         <exception cref="T:System.MethodAccessException">
           <paramref name="nonPublic" /> is <see langword="true" />, the method used to add an event handler delegate is non-public, and the caller does not have permission to reflect on non-public methods.</exception>
         <permission cref="T:System.Security.Permissions.ReflectionPermission">Requires permission to reflect non-public members of a type in loaded assemblies. See <see cref="F:System.Security.Permissions.ReflectionPermissionFlag.TypeInformation" />. </permission>
@@ -295,6 +286,10 @@ for the event reflected by the current instance, if found; otherwise, returns
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, retrieves the MethodInfo object for the <see cref="M:System.Reflection.EventInfo.AddEventHandler(System.Object,System.Delegate)" /> method of the event, specifying whether to return non-public methods.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodInfo" /> object representing the method used to add an event handler delegate to the event source.</para>
+        </returns>
         <param name="nonPublic">
           <attribution license="cc4" from="Microsoft" modified="false" />true if non-public methods can be returned; otherwise, false. </param>
       </Docs>
@@ -312,12 +307,15 @@ for the event reflected by the current instance, if found; otherwise, returns
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOtherMethods">
@@ -333,7 +331,6 @@ for the event reflected by the current instance, if found; otherwise, returns
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -358,6 +355,10 @@ for the event reflected by the current instance, if found; otherwise, returns
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the public methods that have been associated with an event in metadata using the .other directive.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.EventInfo" /> objects representing the public methods that have been associated with the event in metadata by using the .other directive. If there are no such public methods, an empty array is returned.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOtherMethods">
@@ -375,7 +376,6 @@ for the event reflected by the current instance, if found; otherwise, returns
         <Parameter Name="nonPublic" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -400,6 +400,10 @@ for the event reflected by the current instance, if found; otherwise, returns
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the methods that have been associated with the event in metadata using the .other directive, specifying whether to include non-public methods.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.EventInfo" /> objects representing methods that have been associated with an event in metadata by using the .other directive. If there are no methods matching the specification, an empty array is returned.</para>
+        </returns>
         <param name="nonPublic">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include non-public methods; otherwise, false.</param>
       </Docs>
@@ -419,11 +423,6 @@ for the event reflected by the current instance, if found; otherwise, returns
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.MethodInfo" /> instance that reflects the public method that
-   is called when the event reflected by the current instance is raised, if
-   found; otherwise, returns <see langword="null" /> . </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method usually returns null for events declared with the C# event keyword or the Visual Basic Event keyword. This is because the C# and Visual Basic compilers do not generate such a method by default.</para>
@@ -432,6 +431,10 @@ for the event reflected by the current instance, if found; otherwise, returns
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the method that is called when the event is raised.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The method that is called when the event is raised.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -452,13 +455,6 @@ for the event reflected by the current instance, if found; otherwise, returns
         <Parameter Name="nonPublic" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.MethodInfo" /> instance that reflects the method that is
-   called when the event reflected by the current instance is raised, if found;
-   otherwise, returns <see langword="null" />
-   
-   . </para>
-        </returns>
         <exception cref="T:System.MethodAccessException">
           <paramref name="nonPublic" /> is <see langword="true" />, the method used to raise the event is non-public, and the caller does not have permission to reflect on non-public methods.</exception>
         <permission cref="T:System.Security.Permissions.ReflectionPermission">Requires permission to reflect non-public members of a type in loaded assemblies. See <see cref="F:System.Security.Permissions.ReflectionPermissionFlag.TypeInformation" />. </permission>
@@ -470,6 +466,10 @@ for the event reflected by the current instance, if found; otherwise, returns
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the method that is called when the event is raised, specifying whether to return non-public methods.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A MethodInfo object that was called when the event was raised.</para>
+        </returns>
         <param name="nonPublic">
           <attribution license="cc4" from="Microsoft" modified="false" />true if non-public methods can be returned; otherwise, false. </param>
       </Docs>
@@ -490,13 +490,6 @@ for the event reflected by the current instance, if found; otherwise, returns
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.MethodInfo" />
-instance that reflects the public method used to remove an event handler
-delegate from the event reflected by the current instance, if found; otherwise,
-returns <see langword="null" />
-.</para>
-        </returns>
         <remarks>
           <para>This method is equivalent to <see cref="M:System.Reflection.EventInfo.GetRemoveMethod" />(<see langword="false" />).</para>
           <block subset="none" type="note">
@@ -512,6 +505,10 @@ returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the method used to remove an event handler delegate from the event source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodInfo" /> object representing the method used to remove an event handler delegate from the event source.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -532,13 +529,6 @@ returns <see langword="null" />
         <Parameter Name="nonPublic" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.MethodInfo" />
-instance that reflects the method used to remove an event handler delegate from
-the event reflected by the current instance, if found; otherwise, returns
-<see langword="null" /> 
-.</para>
-        </returns>
         <remarks>
           <block subset="none" type="note">
             <para>Typically, the method has the
@@ -558,6 +548,10 @@ the event reflected by the current instance, if found; otherwise, returns
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, retrieves the MethodInfo object for removing a method of the event, specifying whether to return non-public methods.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodInfo" /> object representing the method used to remove an event handler delegate from the event source.</para>
+        </returns>
         <param name="nonPublic">
           <attribution license="cc4" from="Microsoft" modified="false" />true if non-public methods can be returned; otherwise, false. </param>
       </Docs>
@@ -664,12 +658,15 @@ the event reflected by the current instance, if found; otherwise, returns
         <Parameter Name="right" Type="System.Reflection.EventInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.EventInfo" /> objects are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is equal to <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare.</param>
         <param name="right">
@@ -691,12 +688,15 @@ the event reflected by the current instance, if found; otherwise, returns
         <Parameter Name="right" Type="System.Reflection.EventInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.EventInfo" /> objects are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is not equal to <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare.</param>
         <param name="right">
@@ -831,12 +831,15 @@ the event reflected by the current instance, if found; otherwise, returns
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <unmanagedCodeEntityReference>T:System.Type</unmanagedCodeEntityReference> object representing the <see cref="T:System.Reflection.EventInfo" /> type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <unmanagedCodeEntityReference>T:System.Type</unmanagedCodeEntityReference> object representing the <see cref="T:System.Reflection.EventInfo" /> type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Runtime.InteropServices._EventInfo.GetTypeInfo">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection/ExceptionHandlingClause.xml b/mcs/class/corlib/Documentation/en/System.Reflection/ExceptionHandlingClause.xml
index eb868f0e6c2..6d225a15f10 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection/ExceptionHandlingClause.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection/ExceptionHandlingClause.xml
@@ -194,12 +194,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A string representation of the exception-handling clause.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that lists appropriate property values for the filter clause type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryLength">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection/FieldInfo.xml b/mcs/class/corlib/Documentation/en/System.Reflection/FieldInfo.xml
index 60545c15979..9288fb4fac6 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection/FieldInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection/FieldInfo.xml
@@ -162,12 +162,15 @@ class FieldAttributesExample
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> equals the type and value of this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance, or null.</param>
       </Docs>
@@ -244,7 +247,6 @@ class FieldAttributesExample
         <Parameter Name="handle" Type="System.RuntimeFieldHandle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Handles are valid only in the application domain in which they were obtained.</para>
@@ -253,6 +255,10 @@ class FieldAttributesExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Reflection.FieldInfo" /> for the field represented by the specified handle.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.FieldInfo" /> object representing the field specified by <paramref name="handle" />.</para>
+        </returns>
         <param name="handle">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.RuntimeFieldHandle" /> structure that contains the handle to the internal metadata representation of a field. </param>
       </Docs>
@@ -278,7 +284,6 @@ class FieldAttributesExample
         <Parameter Name="declaringType" Type="System.RuntimeTypeHandle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -291,6 +296,10 @@ class FieldAttributesExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Reflection.FieldInfo" /> for the field represented by the specified handle, for the specified generic type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.FieldInfo" /> object representing the field specified by <paramref name="handle" />, in the generic type specified by <paramref name="declaringType" />.</para>
+        </returns>
         <param name="handle">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.RuntimeFieldHandle" /> structure that contains the handle to the internal metadata representation of a field.</param>
         <param name="declaringType">
@@ -309,12 +318,15 @@ class FieldAttributesExample
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOptionalCustomModifiers">
@@ -330,7 +342,6 @@ class FieldAttributesExample
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -340,6 +351,10 @@ class FieldAttributesExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of types that identify the optional custom modifiers of the field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Type" /> objects that identify the optional custom modifiers of the current field, such as <see cref="T:System.Runtime.CompilerServices.IsConst" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetRawConstantValue">
@@ -355,7 +370,6 @@ class FieldAttributesExample
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -370,6 +384,10 @@ class FieldAttributesExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a literal value associated with the field by a compiler. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that contains the literal value associated with the field. If the literal value is a class type with an element value of zero, the return value is null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetRequiredCustomModifiers">
@@ -385,7 +403,6 @@ class FieldAttributesExample
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -395,6 +412,10 @@ class FieldAttributesExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an array of types that identify the required custom modifiers of the property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Type" /> objects that identify the required custom modifiers of the current property, such as <see cref="T:System.Runtime.CompilerServices.IsConst" /> or <see cref="T:System.Runtime.CompilerServices.IsImplicitlyDereferenced" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetType">
@@ -430,10 +451,6 @@ class FieldAttributesExample
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Object" /> that contains the
-   value of the field reflected by the current instance.</para>
-        </returns>
         <exception cref="T:System.NotSupportedException">A field is marked literal, but the field does not have one of the accepted literal types. <block subset="none" type="note">For information regarding the accepted literal types, see Partition II of the CLI Specification.</block></exception>
         <exception cref="T:System.FieldAccessException">The field reflected by the current instance is non-public, and the caller does not have permission to access non-public members.</exception>
         <exception cref="T:System.ArgumentException">The field reflected by the current instance is declared neither directly in <paramref name="obj" /> nor in any class from which <paramref name="obj" /> derives.</exception>
@@ -454,6 +471,10 @@ class FieldAttributesExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the value of a field supported by a given object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object containing the value of the field reflected by this instance.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object whose field value will be returned. </param>
       </Docs>
@@ -480,12 +501,15 @@ class FieldAttributesExample
         <Parameter Name="obj" Type="System.TypedReference" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of a field supported by a given object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An Object containing a field value.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.TypedReference" /> structure that encapsulates a managed pointer to a location and a runtime representation of the type that might be stored at that location. </param>
       </Docs>
@@ -1088,12 +1112,15 @@ class FieldAttributesExample
         <Parameter Name="right" Type="System.Reflection.FieldInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.FieldInfo" /> objects are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is equal to <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare.</param>
         <param name="right">
@@ -1115,12 +1142,15 @@ class FieldAttributesExample
         <Parameter Name="right" Type="System.Reflection.FieldInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.FieldInfo" /> objects are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is not equal to <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare.</param>
         <param name="right">
@@ -1325,12 +1355,15 @@ class FieldAttributesExample
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Type" /> object representing the <see cref="T:System.Reflection.FieldInfo" /> type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object representing the <see cref="T:System.Reflection.FieldInfo" /> type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Runtime.InteropServices._FieldInfo.GetTypeInfo">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection/ICustomAttributeProvider.xml b/mcs/class/corlib/Documentation/en/System.Reflection/ICustomAttributeProvider.xml
index 8e56e251cd3..9fd845dd969 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection/ICustomAttributeProvider.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection/ICustomAttributeProvider.xml
@@ -43,7 +43,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling <see cref="M:System.Reflection.ICustomAttributeProvider.GetCustomAttributes(System.Type,System.Boolean)" /> on <see cref="T:System.Reflection.PropertyInfo" /> or <see cref="T:System.Reflection.EventInfo" /> when the <paramref name="inherit" /> parameter of GetCustomAttributes is true does not walk the type hierarchy. Use <see cref="T:System.Attribute" /> to inherit custom attributes.</para>
@@ -53,6 +52,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of all of the custom attributes defined on this member, excluding named attributes, or an empty array if there are no custom attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of Objects representing custom attributes, or an empty array.</para>
+        </returns>
         <param name="inherit">
           <attribution license="cc4" from="Microsoft" modified="false" />When true, look up the hierarchy chain for the inherited custom attribute. </param>
       </Docs>
@@ -74,7 +77,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="attributeType" /> is a base class or interface, this method returns any implementation of that type.</para>
@@ -85,6 +87,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of custom attributes defined on this member, identified by type, or an empty array if there are no custom attributes of that type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of Objects representing custom attributes, or an empty array.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the custom attributes. </param>
         <param name="inherit">
@@ -108,12 +114,15 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether one or more instance of <paramref name="attributeType" /> is defined on this member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="attributeType" /> is defined on this member; false otherwise.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the custom attributes. </param>
         <param name="inherit">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection/IReflect.xml b/mcs/class/corlib/Documentation/en/System.Reflection/IReflect.xml
index c4b652e0857..55c975f792e 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection/IReflect.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection/IReflect.xml
@@ -47,12 +47,15 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'FieldInfo'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Reflection.FieldInfo" /> object that corresponds to the specified field and binding flag.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.FieldInfo" /> object containing the field information for the named object that meets the search constraints specified in <paramref name="bindingAttr" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the field to find. </param>
         <param name="bindingAttr">
@@ -75,7 +78,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'FieldInfo []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The match is based upon a name. Each field must have a unique name. The <see cref="F:System.Reflection.BindingFlags.NonPublic" /> flag specifies that non-public methods are included in the search. The <see cref="F:System.Reflection.BindingFlags.Public" /> flag specifies that public methods are included in the search.</para>
@@ -84,6 +86,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of <see cref="T:System.Reflection.FieldInfo" /> objects that correspond to all fields of the current class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.FieldInfo" /> objects containing all the field information for this reflection object that meets the search constraints specified in <paramref name="bindingAttr" />.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />The binding attributes used to control the search. </param>
       </Docs>
@@ -105,7 +111,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MemberInfo []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Reflection.IReflect.GetMember(System.String,System.Reflection.BindingFlags)" /> method retrieves an array of <see cref="T:System.Reflection.MemberInfo" /> objects by using the name and binding attribute that correspond to all public members or to all members that match a specified name. The case of the specified name is observed or ignored, as specified by <see cref="F:System.Reflection.BindingFlags.IgnoreCase" />.</para>
@@ -114,6 +119,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of <see cref="T:System.Reflection.MemberInfo" /> objects corresponding to all public members or to all members that match a specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.MemberInfo" /> objects matching the <paramref name="name" /> parameter.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the member to find. </param>
         <param name="bindingAttr">
@@ -136,7 +145,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MemberInfo []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method retrieves an array of <see cref="T:System.Reflection.MemberInfo" /> objects by using the binding attribute that corresponds either to all public members or to all members of the current class. It returns an array of all of the members defined for this object.</para>
@@ -145,6 +153,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of <see cref="T:System.Reflection.MemberInfo" /> objects that correspond either to all public members or to all members of the current class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.MemberInfo" /> objects containing all the member information for this reflection object.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />The binding attributes used to control the search. </param>
       </Docs>
@@ -166,12 +178,15 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MethodInfo'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a <see cref="T:System.Reflection.MethodInfo" /> object that corresponds to a specified method under specified search constraints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodInfo" /> object containing the method information, with the match being based on the method name and search constraints specified in <paramref name="bindingAttr" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the member to find. </param>
         <param name="bindingAttr">
@@ -198,7 +213,6 @@
         <Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MethodInfo'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is a match based on the method name, <see cref="T:System.Reflection.BindingFlags" /> enum member, the kind of type conversion specified by the <paramref name="binder" /> parameter, the overload, and the <see cref="T:System.Reflection.ParameterInfo" /> that describes the signature of the method.</para>
@@ -207,6 +221,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a <see cref="T:System.Reflection.MethodInfo" /> object corresponding to a specified method, using a <see cref="T:System.Type" /> array to choose from among overloaded methods.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The requested method that matches all the specified parameters.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the member to find. </param>
         <param name="bindingAttr">
@@ -235,7 +253,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MethodInfo []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The non-public attribute of <paramref name="bindingAttr" /> is indicated only if public methods are returned.</para>
@@ -244,6 +261,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of <see cref="T:System.Reflection.MethodInfo" /> objects with all public methods or all methods of the current class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.MethodInfo" /> objects containing all the methods defined for this reflection object that meet the search constraints specified in <paramref name="bindingAttr" />.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />The binding attributes used to control the search. </param>
       </Docs>
@@ -264,12 +285,15 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyInfo []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of <see cref="T:System.Reflection.PropertyInfo" /> objects corresponding to all public properties or to all properties of the current class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.PropertyInfo" /> objects for all the properties defined on the reflection object.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />The binding attribute used to control the search. </param>
       </Docs>
@@ -291,12 +315,15 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyInfo'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a <see cref="T:System.Reflection.PropertyInfo" /> object corresponding to a specified property under specified search constraints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.PropertyInfo" /> object for the located property that meets the search constraints specified in <paramref name="bindingAttr" />, or null if the property was not located.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the property to find. </param>
         <param name="bindingAttr">
@@ -324,7 +351,6 @@
         <Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PropertyInfo'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method retrieves a <see cref="T:System.Reflection.PropertyInfo" /> object corresponding to a specified property under specified search constraints. A type array is used to choose from among overloaded methods.</para>
@@ -333,6 +359,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a <see cref="T:System.Reflection.PropertyInfo" /> object that corresponds to a specified property with specified search constraints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.PropertyInfo" /> object for the located property, if a property with the specified name was located in this reflection object, or null if the property was not located.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the member to find. </param>
         <param name="bindingAttr">
@@ -370,7 +400,6 @@
         <Parameter Name="namedParameters" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method that is to be invoked must be accessible and provide the most specific match with the specified argument list, under the constraints of the specified binder and invocation attributes.</para>
@@ -385,6 +414,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes a specified member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified member.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the member to find. </param>
         <param name="invokeAttr">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection/IReflectableType.xml b/mcs/class/corlib/Documentation/en/System.Reflection/IReflectableType.xml
index c74fb5ad0d7..63755e11e16 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection/IReflectableType.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection/IReflectableType.xml
@@ -27,12 +27,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an object that represents this type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents this type.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection/IntrospectionExtensions.xml b/mcs/class/corlib/Documentation/en/System.Reflection/IntrospectionExtensions.xml
index 218cb949210..8cfe1ca98d5 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection/IntrospectionExtensions.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection/IntrospectionExtensions.xml
@@ -32,7 +32,6 @@
         <Parameter Name="type" Type="System.Type" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Getting a <see cref="T:System.Reflection.TypeInfo" /> object will always load the type.</para>
@@ -41,6 +40,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Reflection.TypeInfo" /> representation of the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted object.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to convert.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection/LocalVariableInfo.xml b/mcs/class/corlib/Documentation/en/System.Reflection/LocalVariableInfo.xml
index 2bf86d92ade..0c081ad8844 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection/LocalVariableInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection/LocalVariableInfo.xml
@@ -132,13 +132,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a user-readable string that describes the local variable.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that displays information about the local variable, including the type name, index, and pinned status.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection/MemberInfo.xml b/mcs/class/corlib/Documentation/en/System.Reflection/MemberInfo.xml
index 250c113ffd1..c2496cdbbbf 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection/MemberInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection/MemberInfo.xml
@@ -170,12 +170,15 @@ public class DeclaringTypeExample {
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> equals the type and value of this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance, or null.</param>
       </Docs>
@@ -196,7 +199,6 @@ public class DeclaringTypeExample {
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method ignores the <paramref name="inherit" /> parameter for properties and events. To search the inheritance chain for attributes on properties and events, use the appropriate overloads of the <see cref="M:System.Attribute.GetCustomAttributes(System.Reflection.Assembly)" /> method. </para>
@@ -208,6 +210,10 @@ public class DeclaringTypeExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns an array of all custom attributes applied to this member. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains all the custom attributes applied to this member, or an array with zero elements if no attributes are defined.</para>
+        </returns>
         <param name="inherit">
           <attribution license="cc4" from="Microsoft" modified="false" />true to search this member's inheritance chain to find the attributes; otherwise, false. This parameter is ignored for properties and events; see Remarks.</param>
       </Docs>
@@ -229,7 +235,6 @@ public class DeclaringTypeExample {
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method ignores the <paramref name="inherit" /> parameter for properties and events. To search the inheritance chain for attributes on properties and events, use the appropriate overloads of the <see cref="M:System.Attribute.GetCustomAttributes(System.Reflection.Assembly)" /> method. </para>
@@ -241,6 +246,10 @@ public class DeclaringTypeExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns an array of custom attributes applied to this member and identified by <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of custom attributes applied to this member, or an array with zero elements if no attributes assignable to <paramref name="attributeType" /> have been applied.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of attribute to search for. Only attributes that are assignable to this type are returned. </param>
         <param name="inherit">
@@ -259,7 +268,6 @@ public class DeclaringTypeExample {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to examine the custom attributes of code in the reflection-only context, in cases where the custom attributes themselves are defined in code that is loaded into the reflection-only context. Methods like <see cref="Overload:System.Attribute.GetCustomAttributes" /> and <see cref="Overload:System.Reflection.MemberInfo.GetCustomAttributes" /> cannot be used in such cases, because they create instances of the attributes. Code in the reflection-only context cannot be executed. For more information and for example code, see the <see cref="T:System.Reflection.CustomAttributeData" /> class.</para>
@@ -269,6 +277,10 @@ public class DeclaringTypeExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a list of <see cref="T:System.Reflection.CustomAttributeData" /> objects representing data about the attributes that have been applied to the target member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A generic list of <see cref="T:System.Reflection.CustomAttributeData" /> objects representing data about the attributes that have been applied to the target member.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -283,12 +295,15 @@ public class DeclaringTypeExample {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetType">
@@ -327,7 +342,6 @@ public class DeclaringTypeExample {
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method ignores the <paramref name="inherit" /> parameter for properties and events. To search the inheritance chain for attributes on properties and events, use the appropriate overloads of the <see cref="M:System.Attribute.IsDefined(System.Reflection.MemberInfo,System.Type,System.Boolean)" /> method. </para>
@@ -339,6 +353,10 @@ public class DeclaringTypeExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, indicates whether one or more attributes of the specified type or of its derived types is applied to this member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if one or more instances of <paramref name="attributeType" /> or any of its derived types is applied to this member; otherwise, false.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of custom attribute to search for. The search includes derived types. </param>
         <param name="inherit">
@@ -468,12 +486,15 @@ public class DeclaringTypeExample {
         <Parameter Name="right" Type="System.Reflection.MemberInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.MemberInfo" /> objects are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is equal to <paramref name="right" />; otherwise false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.MemberInfo" /> to compare to <paramref name="right" />.</param>
         <param name="right">
@@ -495,12 +516,15 @@ public class DeclaringTypeExample {
         <Parameter Name="right" Type="System.Reflection.MemberInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.MemberInfo" /> objects are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is not equal to <paramref name="right" />; otherwise false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.MemberInfo" /> to compare to <paramref name="right" />.</param>
         <param name="right">
@@ -579,12 +603,15 @@ obtained.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Type" /> object representing the <see cref="T:System.Reflection.MemberInfo" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object representing the <see cref="T:System.Reflection.MemberInfo" /> class.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Runtime.InteropServices._MemberInfo.GetTypeInfo">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection/MethodBase.xml b/mcs/class/corlib/Documentation/en/System.Reflection/MethodBase.xml
index 202c666f8c0..67830550e57 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection/MethodBase.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection/MethodBase.xml
@@ -231,12 +231,15 @@ class MethodAttributesExample
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> equals the type and value of this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance, or null.</param>
       </Docs>
@@ -255,7 +258,6 @@ class MethodAttributesExample
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the currently executing method is defined on a generic type, the <see cref="T:System.Reflection.MethodInfo" /> that is returned by <see cref="M:System.Reflection.MethodBase.GetCurrentMethod" /> is obtained from the generic type definition (that is, <see cref="P:System.Reflection.MethodInfo.ContainsGenericParameters" /> returns true). Therefore, it does not reflect the type arguments that were used when the method was called. For example, if a method M() is defined on a generic type C&lt;T&gt; (C(Of T) in Visual Basic), and <see cref="M:System.Reflection.MethodBase.GetCurrentMethod" /> is called from C&lt;string&gt;.M(), then <see cref="M:System.Reflection.MethodBase.GetCurrentMethod" /> returns C&lt;T&gt;.M() (C(Of T).M() in Visual Basic).</para>
@@ -265,6 +267,10 @@ class MethodAttributesExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a MethodBase object representing the currently executing method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A MethodBase object representing the currently executing method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetGenericArguments">
@@ -285,9 +291,6 @@ class MethodAttributesExample
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>An array of <see cref="T:System.Type" /> objects that represent the type arguments of a generic method or the type parameters of a generic method definition. Returns an empty array if the current method is not a generic method.</para>
-        </returns>
         <since version=".NET 2.0" />
         <exception cref="T:System.NotSupportedException">
           <para>Default behavior when not overridden in a derived class.</para>
@@ -313,6 +316,10 @@ class MethodAttributesExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of <see cref="T:System.Type" /> objects that represent the type arguments of a generic method or the type parameters of a generic method definition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Type" /> objects that represent the type arguments of a generic method or the type parameters of a generic method definition. Returns an empty array if the current method is not a generic method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -327,12 +334,15 @@ class MethodAttributesExample
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetMethodBody">
@@ -348,7 +358,6 @@ class MethodAttributesExample
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -358,6 +367,10 @@ class MethodAttributesExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, gets a <see cref="T:System.Reflection.MethodBody" /> object that provides access to the MSIL stream, local variables, and exceptions for the current method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodBody" /> object that provides access to the MSIL stream, local variables, and exceptions for the current method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetMethodFromHandle">
@@ -377,9 +390,6 @@ class MethodAttributesExample
         <Parameter Name="handle" Type="System.RuntimeMethodHandle" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.MethodBase" /> object containing information about the method.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Handles are valid only in the application domain in which they were obtained.</para>
@@ -388,6 +398,10 @@ class MethodAttributesExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets method information by using the method's internal metadata representation (handle).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A MethodBase containing information about the method.</para>
+        </returns>
         <param name="handle">
           <attribution license="cc4" from="Microsoft" modified="false" />The method's handle. </param>
       </Docs>
@@ -415,7 +429,6 @@ class MethodAttributesExample
         <Parameter Name="declaringType" Type="System.RuntimeTypeHandle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -426,6 +439,10 @@ class MethodAttributesExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Reflection.MethodBase" /> object for the constructor or method represented by the specified handle, for the specified generic type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodBase" /> object representing the method or constructor specified by <paramref name="handle" />, in the generic type specified by <paramref name="declaringType" />.</para>
+        </returns>
         <param name="handle">
           <attribution license="cc4" from="Microsoft" modified="false" />A handle to the internal metadata representation of a constructor or method.</param>
         <param name="declaringType">
@@ -446,12 +463,15 @@ class MethodAttributesExample
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the <see cref="T:System.Reflection.MethodImplAttributes" /> flags.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The MethodImplAttributes flags.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetParameters">
@@ -469,12 +489,6 @@ class MethodAttributesExample
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> An array of <see cref="T:System.Reflection.ParameterInfo" /> objects that
-   contain information that matches the signature of the method or constructor
-   reflected by the current
-   instance.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="behaviors">As described above.</block>
@@ -484,6 +498,10 @@ class MethodAttributesExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, gets the parameters of the specified method or constructor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type ParameterInfo containing information that matches the signature of the method (or constructor) reflected by this MethodBase instance.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -526,10 +544,6 @@ class MethodAttributesExample
         <Parameter Name="parameters" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Object" /> that contains the return
-   value of the invoked method, or a re-initialized object if a constructor was invoked.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">The types of the elements of <paramref name="parameters" /> do not match the types of the parameters accepted by the constructor or method reflected by the current instance, under the constraints of  the default binder.</exception>
         <exception cref="T:System.Reflection.TargetException">The constructor or method reflected by the current instance is non-static and <paramref name="obj" /> is <see langword="null" />, or is of a type that does not implement the member reflected by the current instance.</exception>
         <exception cref="T:System.Reflection.TargetInvocationException">The constructor or method reflected by the current instance threw an exception.</exception>
@@ -558,6 +572,13 @@ class MethodAttributesExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes the method or constructor represented by the current instance, using the specified parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object containing the return value of the invoked method, or null in the case of a constructor.</para>
+          <block subset="none" type="note">
+            <para>Elements of the <paramref name="parameters" /> array that represent parameters declared with the ref or out keyword may also be modified.</para>
+          </block>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object on which to invoke the method or constructor. If a method is static, this argument is ignored. If a constructor is static, this argument must be null or an instance of the class that defines the constructor. </param>
         <param name="parameters">
@@ -586,11 +607,6 @@ class MethodAttributesExample
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Object" /> that
-   contains the return value of the invoked method, or a re-initialized object if a
-   constructor was invoked.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">The types of the elements of <paramref name="parameters" /> do not match the types of the parameters accepted by the constructor or method reflected by the current instance, under the constraints of the default binder.</exception>
         <exception cref="T:System.Reflection.TargetException">The constructor or method reflected by the current instance is non-static, and <paramref name="obj" /> is <see langword="null" /> or is of a type that does not implement the member reflected by the current instance.</exception>
         <exception cref="T:System.Reflection.TargetInvocationException">The method reflected by the current instance threw an exception.</exception>
@@ -630,6 +646,13 @@ class MethodAttributesExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, invokes the reflected method or constructor with the given parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An Object containing the return value of the invoked method, or null in the case of a constructor, or null if the method's return type is void. Before calling the method or constructor, Invoke checks to see if the user has access permission and verifies that the parameters are valid.</para>
+          <block subset="none" type="note">
+            <para>Elements of the <paramref name="parameters" /> array that represent parameters declared with the ref or out keyword may also be modified.</para>
+          </block>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object on which to invoke the method or constructor. If a method is static, this argument is ignored. If a constructor is static, this argument must be null or an instance of the class that defines the constructor.</param>
         <param name="invokeAttr">
@@ -1315,12 +1338,15 @@ class MethodAttributesExample
         <Parameter Name="right" Type="System.Reflection.MethodBase" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.MethodBase" /> objects are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is equal to <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare.</param>
         <param name="right">
@@ -1342,12 +1368,15 @@ class MethodAttributesExample
         <Parameter Name="right" Type="System.Reflection.MethodBase" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.MethodBase" /> objects are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is not equal to <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare.</param>
         <param name="right">
@@ -1395,7 +1424,6 @@ class MethodAttributesExample
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Reflection.MethodBase" /> instance is cast to an <see cref="T:System.Runtime.InteropServices._MethodBase" /> interface.</para>
@@ -1404,6 +1432,10 @@ class MethodAttributesExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.Runtime.InteropServices._MethodBase.GetType" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>For a description of this member, see <see cref="M:System.Runtime.InteropServices._MethodBase.GetType" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Runtime.InteropServices._MethodBase.GetTypeInfo">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection/MethodBody.xml b/mcs/class/corlib/Documentation/en/System.Reflection/MethodBody.xml
index 3a86021dbed..1b2475ded9e 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection/MethodBody.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection/MethodBody.xml
@@ -92,7 +92,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -105,6 +104,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the MSIL for the method body, as an array of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Byte" /> that contains the MSIL for the method body. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InitLocals">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection/MethodInfo.xml b/mcs/class/corlib/Documentation/en/System.Reflection/MethodInfo.xml
index 0c53a454a8c..580bfd32516 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection/MethodInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection/MethodInfo.xml
@@ -106,12 +106,15 @@
         <Parameter Name="delegateType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a delegate of the specified type from this method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The delegate for this method.</para>
+        </returns>
         <param name="delegateType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the delegate to create.</param>
       </Docs>
@@ -131,12 +134,15 @@
         <Parameter Name="target" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a delegate of the specified type with the specified target from this method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The delegate for this method.</para>
+        </returns>
         <param name="delegateType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the delegate to create.</param>
         <param name="target">
@@ -157,12 +163,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> equals the type and value of this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance, or null.</param>
       </Docs>
@@ -182,11 +191,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Reflection.MethodInfo" /> instance that reflects the first definition
-   of the method reflected by the
-   current instance in the inheritance hierarchy of that method. </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>GetBaseDefinition returns the first definition of the specified method in the class hierarchy.</para>
@@ -209,6 +213,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the MethodInfo object for the method on the direct or indirect base class in which the method represented by this instance was first declared.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A MethodInfo object for the first implementation of this method.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -230,9 +238,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>An array of <see cref="T:System.Type" /> objects that represent the type arguments  of a generic method or the type parameters of a generic method definition. Returns an empty array if the current method is not a generic method.</para>
-        </returns>
         <since version=".NET 2.0" />
         <example>
           <para>The following code shows how to get the type arguments of a generic method and display them. (It is part of a larger example for the method <see cref="M: System.Reflection.MethodInfo.MakeGenericMethod" />.)</para>
@@ -288,6 +293,10 @@ if (mi.IsGenericMethod)
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of <see cref="T:System.Type" /> objects that represent the type arguments of a generic method or the type parameters of a generic method definition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Type" /> objects that represent the type arguments of a generic method or the type parameters of a generic method definition. Returns an empty array if the current method is not a generic method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetGenericMethodDefinition">
@@ -308,9 +317,6 @@ if (mi.IsGenericMethod)
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.MethodInfo" /> object representing a generic method definition from which the current method can be constructed.</para>
-        </returns>
         <since version=".NET 2.0" />
         <exception cref="T:System.InvalidOperationException">The current method is not a generic method. That is, <see cref="P:System.Reflection.MethodInfo.IsGenericMethod" /> returns <see langword="false" />. </exception>
         <example>
@@ -381,6 +387,10 @@ public:
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Reflection.MethodInfo" /> object that represents a generic method definition from which the current method can be constructed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodInfo" /> object representing a generic method definition from which the current method can be constructed.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -395,12 +405,15 @@ public:
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetType">
@@ -612,9 +625,6 @@ public:
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.MethodInfo" />  object that represents the constructed method formed by substituting the elements of <paramref name="typeArguments" /> for the type parameters of the current generic method definition.</para>
-        </returns>
         <since version=".NET 2.0" />
         <exception cref="T:System.ArgumentException">
           <para>The number of elements in <paramref name="typeArguments" /> is not the same as the number of type parameters of the current generic method definition.</para>
@@ -813,6 +823,10 @@ public:
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Substitutes the elements of an array of types for the type parameters of the current generic method definition, and returns a <see cref="T:System.Reflection.MethodInfo" /> object representing the resulting constructed method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodInfo" /> object that represents the constructed method formed by substituting the elements of <paramref name="typeArguments" /> for the type parameters of the current generic method definition.</para>
+        </returns>
         <param name="typeArguments">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of types to be substituted for the type parameters of the current generic method definition.</param>
       </Docs>
@@ -858,12 +872,15 @@ public:
         <Parameter Name="right" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.MethodInfo" /> objects are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is equal to <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare.</param>
         <param name="right">
@@ -885,12 +902,15 @@ public:
         <Parameter Name="right" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.MethodInfo" /> objects are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is not equal to <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare.</param>
         <param name="right">
@@ -1018,12 +1038,15 @@ public:
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides access to the <see cref="M:System.Object.GetType" /> method from COM.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object representing the <see cref="T:System.Reflection.MethodInfo" /> type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Runtime.InteropServices._MethodInfo.GetTypeInfo">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection/Module.xml b/mcs/class/corlib/Documentation/en/System.Reflection/Module.xml
index ab0f56f2cdc..6dd60a5c202 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection/Module.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection/Module.xml
@@ -132,12 +132,15 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether this module and the specified object are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="o" /> is equal to this instance; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this instance. </param>
       </Docs>
@@ -207,7 +210,6 @@
         <Parameter Name="filterCriteria" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -219,6 +221,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of classes accepted by the given filter and filter criteria.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type Type containing classes that were accepted by the filter.</para>
+        </returns>
         <param name="filter">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate used to filter the classes. </param>
         <param name="filterCriteria">
@@ -283,12 +289,15 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all custom attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type Object containing all custom attributes.</para>
+        </returns>
         <param name="inherit">
           <attribution license="cc4" from="Microsoft" modified="false" />This argument is ignored for objects of this type. </param>
       </Docs>
@@ -310,12 +319,15 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets custom attributes of the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type Object containing all custom attributes of the specified type.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of attribute to get. </param>
         <param name="inherit">
@@ -334,7 +346,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to examine the custom attributes of code in the reflection-only context, in cases where the custom attributes themselves are defined in code that is loaded into the reflection-only context. Methods such as <see cref="Overload:System.Attribute.GetCustomAttributes" /> and <see cref="Overload:System.Reflection.Module.GetCustomAttributes" /> cannot be used in such cases, because they create instances of the attributes. Code in the reflection-only context cannot be executed. For more information and example code, see the <see cref="T:System.Reflection.CustomAttributeData" /> class.</para>
@@ -343,6 +354,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a list of <see cref="T:System.Reflection.CustomAttributeData" /> objects for the current module, which can be used in the reflection-only context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A generic list of <see cref="T:System.Reflection.CustomAttributeData" /> objects representing data about the attributes that have been applied to the current module.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetField">
@@ -362,13 +377,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns a <see cref="T:System.Reflection.FieldInfo" /> instance that reflects the global public field that
-   has the name <paramref name="name" />, and is a member of the module
-   reflected by the current instance, if found; otherwise, returns
-<see langword="null" /> 
-.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note">A global public field is a static field
@@ -381,6 +389,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a field having the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A FieldInfo object having the specified name, or null if the field does not exist.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The field name. </param>
       </Docs>
@@ -404,12 +416,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns a <see cref="T:System.Reflection.FieldInfo" /> instance that reflects the global field that has the name
-<paramref name="name" /> and characteristics specified by <paramref name="bindingAttr" />, and is a member of the module reflected by 
-   the current instance, if found; otherwise, returns <see langword="null" />
-   .</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note">A global field is a field with a
@@ -422,6 +428,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a field having the specified name and binding attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A FieldInfo object having the specified name and binding attributes, or null if the field does not exist.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The field name. </param>
         <param name="bindingAttr">
@@ -444,11 +454,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> An array of <see cref="T:System.Reflection.FieldInfo" /> objects that reflect the global public fields that are
-      members of the module reflected by the current instance. If no global public fields are contained in the module reflected by the current instance, returns an array with
-      zero elements.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Reflection.Module.GetFields" /> method does not return fields in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which fields are returned, because that order can vary.</para>
@@ -457,6 +462,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the global fields defined on the module.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.FieldInfo" /> objects representing the global fields defined on the module; if there are no global fields, an empty array is returned.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -475,9 +484,6 @@
         <Parameter Name="bindingFlags" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> An      array <see cref="T:System.Reflection.FieldInfo" /> objects that reflect the global fields that have the specified binding attributes, and are members of the module reflected by the current instance. If no global fields are contained in the module reflected by the current instance, returns an array with zero elements.</para>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -487,6 +493,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the global fields defined on the module that match the specified binding flags.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Reflection.FieldInfo" /> representing the global fields defined on the module that match the specified binding flags; if no global fields match the binding flags, an empty array is returned.</para>
+        </returns>
         <param name="bindingFlags">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Reflection.BindingFlags" /> values that limit the search.</param>
       </Docs>
@@ -503,12 +513,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetMethod">
@@ -528,13 +541,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.MethodInfo" />
-instance that reflects the global public method that
-has the name <paramref name="name" />, and is a member of the module reflected by the
-current instance, if found; otherwise, returns <see langword="null" />
-.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note">A global public method
@@ -547,6 +553,10 @@ current instance, if found; otherwise, returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a method having the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A MethodInfo object having the specified name, or null if the method does not exist.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The method name. </param>
       </Docs>
@@ -570,13 +580,6 @@ current instance, if found; otherwise, returns <see langword="null" />
         <Parameter Name="types" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.MethodInfo" />
-instance that reflects the global public method that
-has the name <paramref name="name" /> and parameter types <paramref name="types" />, and is a member of the module reflected by the
-current instance, if found; otherwise, returns <see langword="null" />
-.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note">A global public method
@@ -596,6 +599,10 @@ current instance, if found; otherwise, returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a method having the specified name and parameter types.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A MethodInfo object in accordance with the specified criteria, or null if the method does not exist.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The method name. </param>
         <param name="types">
@@ -624,12 +631,15 @@ current instance, if found; otherwise, returns <see langword="null" />
         <Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a method having the specified name, binding information, calling convention, and parameter types and modifiers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A MethodInfo object in accordance with the specified criteria, or null if the method does not exist.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The method name. </param>
         <param name="bindingAttr">
@@ -665,12 +675,15 @@ current instance, if found; otherwise, returns <see langword="null" />
         <Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the method implementation in accordance with the specified criteria.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A MethodInfo object containing implementation information as specified, or null if the method does not exist.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The method name. </param>
         <param name="bindingAttr">
@@ -700,10 +713,6 @@ current instance, if found; otherwise, returns <see langword="null" />
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> An array of <see cref="T:System.Reflection.MethodInfo" /> objects that reflect the global public methods that are members of the module
-   reflected by the current instance.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note">A global public method
@@ -714,6 +723,10 @@ current instance, if found; otherwise, returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the global methods defined on the module.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.MethodInfo" /> objects representing all the global methods defined on the module; if there are no global methods, an empty array is returned.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -732,9 +745,6 @@ current instance, if found; otherwise, returns <see langword="null" />
         <Parameter Name="bindingFlags" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> An array of <see cref="T:System.Reflection.MethodInfo" /> objects that reflect the global methods that have characteristics specified by bindingAttr, and are members of the module reflected by the current instance, if found; otherwise, returns null.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note">A global method is a method with a module-level scope.</block>
@@ -745,6 +755,10 @@ current instance, if found; otherwise, returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the global methods defined on the module that match the specified binding flags.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Reflection.MethodInfo" /> representing the global methods defined on the module that match the specified binding flags; if no global methods match the binding flags, an empty array is returned.</para>
+        </returns>
         <param name="bindingFlags">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of <see cref="T:System.Reflection.BindingFlags" /> values that limit the search.</param>
       </Docs>
@@ -814,12 +828,15 @@ current instance, if found; otherwise, returns <see langword="null" />
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an X509Certificate object corresponding to the certificate included in the Authenticode signature of the assembly which this module belongs to. If the assembly has not been Authenticode signed, null is returned.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An X509Certificate object, or null if the assembly to which this module belongs has not been Authenticode signed.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetType">
@@ -843,7 +860,6 @@ current instance, if found; otherwise, returns <see langword="null" />
         <Parameter Name="className" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -855,6 +871,10 @@ current instance, if found; otherwise, returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified type, performing a case-sensitive search.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Type object representing the given type, if the type is in this module; otherwise, null.</para>
+        </returns>
         <param name="className">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the type to locate. The name must be fully qualified with the namespace. </param>
       </Docs>
@@ -881,7 +901,6 @@ current instance, if found; otherwise, returns <see langword="null" />
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -893,6 +912,10 @@ current instance, if found; otherwise, returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified type, searching the module with the specified case sensitivity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Type object representing the given type, if the type is in this module; otherwise, null.</para>
+        </returns>
         <param name="className">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the type to locate. The name must be fully qualified with the namespace. </param>
         <param name="ignoreCase">
@@ -922,7 +945,6 @@ current instance, if found; otherwise, returns <see langword="null" />
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="throwOnError" /> parameter affects only what happens when the type is not found. It does not affect any other exceptions that might be thrown. In particular, if the type is found but cannot be loaded, <see cref="T:System.TypeLoadException" /> can be thrown even if <paramref name="throwOnError" /> is false.</para>
@@ -935,6 +957,10 @@ current instance, if found; otherwise, returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified type, specifying whether to make a case-sensitive search of the module and whether to throw an exception if the type cannot be found.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object representing the specified type, if the type is declared in this module; otherwise, null.</para>
+        </returns>
         <param name="className">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the type to locate. The name must be fully qualified with the namespace. </param>
         <param name="throwOnError">
@@ -957,7 +983,6 @@ current instance, if found; otherwise, returns <see langword="null" />
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>ReflectionTypeLoadException is a special load exception. The ReflectionTypeLoadException.Types property contains the array of types that were defined in the module and were loaded. This array may contain some null values. The ReflectionTypeLoadException.LoaderExceptions property is an array of exceptions that represent the exceptions that were thrown by the loader. The holes in the class array line up with the exceptions.</para>
@@ -970,6 +995,10 @@ current instance, if found; otherwise, returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the types defined within this module.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type Type containing types defined within the module that is reflected by this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsDefined">
@@ -989,12 +1018,15 @@ current instance, if found; otherwise, returns <see langword="null" />
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the specified attribute type has been applied to this module.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if one or more instances of <paramref name="attributeType" /> have been applied to this module; otherwise, false.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of custom attribute to test for. </param>
         <param name="inherit">
@@ -1015,12 +1047,15 @@ current instance, if found; otherwise, returns <see langword="null" />
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the object is a resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object is a resource; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MDStreamVersion">
@@ -1175,12 +1210,15 @@ current instance, if found; otherwise, returns <see langword="null" />
         <Parameter Name="right" Type="System.Reflection.Module" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.Module" /> objects are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is equal to <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare. </param>
         <param name="right">
@@ -1202,12 +1240,15 @@ current instance, if found; otherwise, returns <see langword="null" />
         <Parameter Name="right" Type="System.Reflection.Module" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.Module" /> objects are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is not equal to <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare.</param>
         <param name="right">
@@ -1229,7 +1270,6 @@ current instance, if found; otherwise, returns <see langword="null" />
         <Parameter Name="metadataToken" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1243,6 +1283,10 @@ current instance, if found; otherwise, returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the field identified by the specified metadata token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.FieldInfo" /> object representing the field that is identified by the specified metadata token.</para>
+        </returns>
         <param name="metadataToken">
           <attribution license="cc4" from="Microsoft" modified="false" />A metadata token that identifies a field in the module.</param>
       </Docs>
@@ -1264,7 +1308,6 @@ current instance, if found; otherwise, returns <see langword="null" />
         <Parameter Name="genericMethodArguments" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Type.GetGenericArguments" /> method on the type where <paramref name="metadataToken" /> is in scope to obtain an array of generic type arguments for <paramref name="genericTypeArguments" />. Use the <see cref="M:System.Reflection.MethodInfo.GetGenericArguments" /> method on the method where <paramref name="metadataToken" /> is in scope to obtain an array of generic type arguments for <paramref name="genericTypeArguments" />. It is always safe to provide these arguments, even when they are not needed.</para>
@@ -1277,6 +1320,10 @@ current instance, if found; otherwise, returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the field identified by the specified metadata token, in the context defined by the specified generic type parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.FieldInfo" /> object representing the field that is identified by the specified metadata token.</para>
+        </returns>
         <param name="metadataToken">
           <attribution license="cc4" from="Microsoft" modified="false" />A metadata token that identifies a field in the module.</param>
         <param name="genericTypeArguments">
@@ -1300,7 +1347,6 @@ current instance, if found; otherwise, returns <see langword="null" />
         <Parameter Name="metadataToken" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1314,6 +1360,10 @@ current instance, if found; otherwise, returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the type or member identified by the specified metadata token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MemberInfo" /> object representing the type or member that is identified by the specified metadata token.</para>
+        </returns>
         <param name="metadataToken">
           <attribution license="cc4" from="Microsoft" modified="false" />A metadata token that identifies a type or member in the module.</param>
       </Docs>
@@ -1335,7 +1385,6 @@ current instance, if found; otherwise, returns <see langword="null" />
         <Parameter Name="genericMethodArguments" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Type.GetGenericArguments" /> method on the type where <paramref name="metadataToken" /> is in scope to obtain an array of generic type arguments for <paramref name="genericTypeArguments" />. Use the <see cref="M:System.Reflection.MethodInfo.GetGenericArguments" /> method on the method where <paramref name="metadataToken" /> is in scope to obtain an array of generic type arguments for <paramref name="genericTypeArguments" />. It is always safe to provide these arguments, even when they are not needed.</para>
@@ -1348,6 +1397,10 @@ current instance, if found; otherwise, returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the type or member identified by the specified metadata token, in the context defined by the specified generic type parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MemberInfo" /> object representing the type or member that is identified by the specified metadata token.</para>
+        </returns>
         <param name="metadataToken">
           <attribution license="cc4" from="Microsoft" modified="false" />A metadata token that identifies a type or member in the module.</param>
         <param name="genericTypeArguments">
@@ -1371,7 +1424,6 @@ current instance, if found; otherwise, returns <see langword="null" />
         <Parameter Name="metadataToken" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1384,6 +1436,10 @@ current instance, if found; otherwise, returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the method or constructor identified by the specified metadata token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodBase" /> object representing the method or constructor that is identified by the specified metadata token.</para>
+        </returns>
         <param name="metadataToken">
           <attribution license="cc4" from="Microsoft" modified="false" />A metadata token that identifies a method or constructor in the module.</param>
       </Docs>
@@ -1405,7 +1461,6 @@ current instance, if found; otherwise, returns <see langword="null" />
         <Parameter Name="genericMethodArguments" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Type.GetGenericArguments" /> method on the type where <paramref name="metadataToken" /> is in scope to obtain an array of generic type arguments for <paramref name="genericTypeArguments" />. Use the <see cref="M:System.Reflection.MethodInfo.GetGenericArguments" /> method on the method where <paramref name="metadataToken" /> is in scope to obtain an array of generic type arguments for <paramref name="genericMethodArguments" />. It is always safe to provide these arguments, even when they are not needed. </para>
@@ -1417,6 +1472,10 @@ current instance, if found; otherwise, returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the method or constructor identified by the specified metadata token, in the context defined by the specified generic type parameters. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodBase" /> object representing the method that is identified by the specified metadata token.</para>
+        </returns>
         <param name="metadataToken">
           <attribution license="cc4" from="Microsoft" modified="false" />A metadata token that identifies a method or constructor in the module.</param>
         <param name="genericTypeArguments">
@@ -1440,7 +1499,6 @@ current instance, if found; otherwise, returns <see langword="null" />
         <Parameter Name="metadataToken" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1452,6 +1510,10 @@ current instance, if found; otherwise, returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the signature blob identified by a metadata token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of bytes representing the signature blob.</para>
+        </returns>
         <param name="metadataToken">
           <attribution license="cc4" from="Microsoft" modified="false" />A metadata token that identifies a signature in the module.</param>
       </Docs>
@@ -1471,7 +1533,6 @@ current instance, if found; otherwise, returns <see langword="null" />
         <Parameter Name="metadataToken" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1483,6 +1544,10 @@ current instance, if found; otherwise, returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the string identified by the specified metadata token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing a string value from the metadata string heap.</para>
+        </returns>
         <param name="metadataToken">
           <attribution license="cc4" from="Microsoft" modified="false" />A metadata token that identifies a string in the string heap of the module. </param>
       </Docs>
@@ -1502,7 +1567,6 @@ current instance, if found; otherwise, returns <see langword="null" />
         <Parameter Name="metadataToken" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1515,6 +1579,10 @@ current instance, if found; otherwise, returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the type identified by the specified metadata token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object representing the type that is identified by the specified metadata token.</para>
+        </returns>
         <param name="metadataToken">
           <attribution license="cc4" from="Microsoft" modified="false" />A metadata token that identifies a type in the module.</param>
       </Docs>
@@ -1536,7 +1604,6 @@ current instance, if found; otherwise, returns <see langword="null" />
         <Parameter Name="genericMethodArguments" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Type.GetGenericArguments" /> method on the type where <paramref name="metadataToken" /> is in scope to obtain an array of generic type arguments for <paramref name="genericTypeArguments" />. Use the <see cref="M:System.Reflection.MethodInfo.GetGenericArguments" /> method on the method where <paramref name="metadataToken" /> is in scope to obtain an array of generic type arguments for <paramref name="genericTypeArguments" />. It is always safe to provide these arguments, even when they are not needed.</para>
@@ -1549,6 +1616,10 @@ current instance, if found; otherwise, returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the type identified by the specified metadata token, in the context defined by the specified generic type parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object representing the type that is identified by the specified metadata token.</para>
+        </returns>
         <param name="metadataToken">
           <attribution license="cc4" from="Microsoft" modified="false" />A metadata token that identifies a type in the module.</param>
         <param name="genericTypeArguments">
@@ -1715,10 +1786,6 @@ current instance, if found; otherwise, returns <see langword="null" />
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.String" /> representation of
-   the name of the module reflected by the current instance.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note">This method
@@ -1729,6 +1796,10 @@ current instance, if found; otherwise, returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the module.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A String representing the name of this module.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection/ParameterInfo.xml b/mcs/class/corlib/Documentation/en/System.Reflection/ParameterInfo.xml
index 1a202ebe2d2..c6cf06b9c53 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection/ParameterInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection/ParameterInfo.xml
@@ -238,7 +238,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method ignores the <paramref name="inherit" /> parameter. To search the inheritance chain for attributes on parameters, use the appropriate overloads of the <see cref="M:System.Attribute.GetCustomAttributes(System.Reflection.Assembly)" /> method. </para>
@@ -247,6 +246,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all the custom attributes defined on this parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains all the custom attributes applied to this parameter.</para>
+        </returns>
         <param name="inherit">
           <attribution license="cc4" from="Microsoft" modified="false" />This argument is ignored for objects of this type. See Remarks.</param>
       </Docs>
@@ -268,7 +271,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method ignores the <paramref name="inherit" /> parameter. To search the inheritance chain for attributes on parameters, use the appropriate overloads of the <see cref="M:System.Attribute.GetCustomAttributes(System.Reflection.Assembly)" /> method. </para>
@@ -277,6 +279,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the custom attributes of the specified type or its derived types that are applied to this parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains the custom attributes of the specified type or its derived types.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The custom attributes identified by type. </param>
         <param name="inherit">
@@ -295,7 +301,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to examine the custom attributes of code in the reflection-only context, in cases where the custom attributes themselves are defined in code that is loaded into the reflection-only context. Methods such as <see cref="Overload:System.Attribute.GetCustomAttributes" /> and <see cref="Overload:System.Reflection.ParameterInfo.GetCustomAttributes" /> cannot be used in such cases, because they create instances of the attributes. Code in the reflection-only context cannot be executed. For more information and example code, see the <see cref="T:System.Reflection.CustomAttributeData" /> class.</para>
@@ -304,6 +309,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a list of <see cref="T:System.Reflection.CustomAttributeData" /> objects for the current parameter, which can be used in the reflection-only context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A generic list of <see cref="T:System.Reflection.CustomAttributeData" /> objects representing data about the attributes that have been applied to the current parameter.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOptionalCustomModifiers">
@@ -319,7 +328,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -329,6 +337,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the optional custom modifiers of the parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Type" /> objects that identify the optional custom modifiers of the current parameter, such as <see cref="T:System.Runtime.CompilerServices.IsConst" /> or <see cref="T:System.Runtime.CompilerServices.IsImplicitlyDereferenced" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetRequiredCustomModifiers">
@@ -344,7 +356,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -354,6 +365,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the required custom modifiers of the parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Type" /> objects that identify the required custom modifiers of the current parameter, such as <see cref="T:System.Runtime.CompilerServices.IsConst" /> or <see cref="T:System.Runtime.CompilerServices.IsImplicitlyDereferenced" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HasDefaultValue">
@@ -392,7 +407,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method ignores the <paramref name="inherit" /> parameter. To search the inheritance chain for attributes on parameters, use the appropriate overloads of the <see cref="M:System.Attribute.IsDefined(System.Reflection.MemberInfo,System.Type,System.Boolean)" /> method. </para>
@@ -401,6 +415,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the custom attribute of the specified type or its derived types is applied to this parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if one or more instances of <paramref name="attributeType" /> or its derived types are applied to this parameter; otherwise, false.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The Type object to search for. </param>
         <param name="inherit">
@@ -909,12 +927,15 @@ instance.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the parameter type and name represented as a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the type and the name of the parameter.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection/Pointer.xml b/mcs/class/corlib/Documentation/en/System.Reflection/Pointer.xml
index f60da53511a..7e09312fd5a 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection/Pointer.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection/Pointer.xml
@@ -51,12 +51,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Boxes the supplied unmanaged memory pointer and the type associated with that pointer into a managed <see cref="T:System.Reflection.Pointer" /> wrapper object. The value and the type are saved so they can be accessed from the native code during an invocation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A pointer object.</para>
+        </returns>
         <param name="ptr">
           <attribution license="cc4" from="Microsoft" modified="false" />The supplied unmanaged memory pointer. </param>
         <param name="type">
@@ -107,12 +110,15 @@
         <Parameter Name="ptr" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Void*'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the stored pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method returns void.</para>
+        </returns>
         <param name="ptr">
           <attribution license="cc4" from="Microsoft" modified="false" />The stored pointer. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection/PropertyInfo.xml b/mcs/class/corlib/Documentation/en/System.Reflection/PropertyInfo.xml
index fa82d22345b..d1799eacdcf 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection/PropertyInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection/PropertyInfo.xml
@@ -192,12 +192,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> equals the type and value of this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance, or null.</param>
       </Docs>
@@ -217,13 +220,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>An array of <see cref="T:System.Reflection.MethodInfo" /> objects that reflect the public 
-<see langword="Get" />, <see langword="Set" />, and other 
-   accessors of
-   the property reflected by the current instance, if found; otherwise, returns
-   an array with zero elements.</para>
-        </returns>
         <remarks>
           <para>This method is equivalent to <see cref="M:System.Reflection.PropertyInfo.GetAccessors" />(<see langword="false" />).</para>
         </remarks>
@@ -231,6 +227,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array whose elements reflect the public get, set, and other accessors of the property reflected by the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.MethodInfo" /> objects that reflect the public get, set, and other accessors of the property reflected by the current instance, if found; otherwise, this method returns an array with zero (0) elements.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -251,17 +251,6 @@
         <Parameter Name="nonPublic" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>An array of <see cref="T:System.Reflection.MethodInfo" /> objects whose elements reflect the
-<see langword="Get" />, <see langword="Set" />, and other accessors of the property 
-   reflected by the current instance. If <paramref name="nonPublic" /> is
-<see langword="true" />, this array contains public and non-public 
-   accessors. If
-<paramref name="nonPublic" /> is <see langword="false" />, this array contains only public accessors. 
-   If no
-   accessors with the specified visibility are found, returns
-   an array with zero elements.</para>
-        </returns>
         <permission cref="T:System.Security.Permissions.ReflectionPermission">Requires permission to reflect non-public members of a type in loaded assemblies. See <see cref="F:System.Security.Permissions.ReflectionPermissionFlag.TypeInformation" />.</permission>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -271,6 +260,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array whose elements reflect the public and, if specified, non-public get, set, and other accessors of the property reflected by the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.MethodInfo" /> objects whose elements reflect the get, set, and other accessors of the property reflected by the current instance. If <paramref name="nonPublic" /> is true, this array contains public and non-public get, set, and other accessors. If <paramref name="nonPublic" /> is false, this array contains only public get, set, and other accessors. If no accessors with the specified visibility are found, this method returns an array with zero (0) elements.</para>
+        </returns>
         <param name="nonPublic">
           <attribution license="cc4" from="Microsoft" modified="false" />Indicates whether non-public methods should be returned in the MethodInfo array. true if non-public methods are to be included; otherwise, false. </param>
       </Docs>
@@ -289,7 +282,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -306,6 +298,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a literal value associated with the property by a compiler. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that contains the literal value associated with the property. If the literal value is a class type with an element value of zero, the return value is null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetGetMethod">
@@ -323,12 +319,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.MethodInfo" /> instance that reflects the public
-<see langword="Get" /> accessor for the property reflected by the current 
-   instance. Returns <see langword="null" /> if no public <see langword="Get" />
-   accessor exists.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is a convenience method that provides an implementation for the abstract GetGetMethod method with the <paramref name="nonPublic" /> parameter set to false.</para>
@@ -338,6 +328,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the public get accessor for this property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A MethodInfo object representing the public get accessor for this property, or null if the get accessor is non-public or does not exist.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -358,17 +352,6 @@
         <Parameter Name="nonPublic" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>If <paramref name="nonPublic" /> is <see langword="true" />, returns
-   a <see cref="T:System.Reflection.MethodInfo" /> instance that reflects the
-<see langword="Get" /> 
-accessor for the property reflected by the current instance if that accessor
-exists. If
-<paramref name="nonPublic " />is <see langword="false" /> and the <see langword="Get" /> accessor is non-public, or <paramref name="nonPublic" /> 
-is <see langword="true" /> but no <see langword="Get" /> accessor exists for the property reflected by
-the current instance, returns <see langword="null" />
-.</para>
-        </returns>
         <exception cref="T:System.MethodAccessException">
           <paramref name="nonPublic" /> is <see langword="true" />, the <see langword="Get" /> accessor for the property reflected by the current instance is non-public, and the caller does not have <see cref="T:System.Security.Permissions.ReflectionPermission" /> to reflect on non-public methods.</exception>
         <permission cref="T:System.Security.Permissions.ReflectionPermission">Requires permission to reflect non-public members of a type in loaded assemblies. See <see cref="F:System.Security.Permissions.ReflectionPermissionFlag.TypeInformation" />.</permission>
@@ -381,6 +364,10 @@ the current instance, returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the public or non-public get accessor for this property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A MethodInfo object representing the get accessor for this property, if <paramref name="nonPublic" /> is true. Returns null if <paramref name="nonPublic" /> is false and the get accessor is non-public, or if <paramref name="nonPublic" /> is true but no get accessors exist.</para>
+        </returns>
         <param name="nonPublic">
           <attribution license="cc4" from="Microsoft" modified="false" />Indicates whether a non-public get accessor should be returned. true if a non-public accessor is to be returned; otherwise, false. </param>
       </Docs>
@@ -398,12 +385,15 @@ the current instance, returns <see langword="null" />
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetIndexParameters">
@@ -421,13 +411,6 @@ the current instance, returns <see langword="null" />
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> An array
-      of <see cref="T:System.Reflection.ParameterInfo" /> objects that reflect the indexers
-      of the property reflected by the current instance. If no indexers exist for
-      the property reflected by the current instance,
-      returns an array with zero elements.</para>
-        </returns>
         <exception cref="T:System.MethodAccessException">The property reflected by the current instance is visible, but its <see langword="Get" /> and <see langword="Set" /> accessors are not, and the caller does not have <see cref="T:System.Security.Permissions.ReflectionPermission" />.</exception>
         <permission cref="T:System.Security.Permissions.ReflectionPermission">Requires permission to reflect non-public members of a type in loaded assemblies. See <see cref="F:System.Security.Permissions.ReflectionPermissionFlag.TypeInformation" />.</permission>
         <remarks>
@@ -439,6 +422,10 @@ the current instance, returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns an array of all the index parameters for the property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type ParameterInfo containing the parameters for the indexes. If the property is not indexed, the array has 0 (zero) elements.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -474,7 +461,6 @@ the current instance, returns <see langword="null" />
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -484,6 +470,10 @@ the current instance, returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of types representing the optional custom modifiers of the property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Type" /> objects that identify the optional custom modifiers of the current property, such as <see cref="T:System.Runtime.CompilerServices.IsConst" /> or <see cref="T:System.Runtime.CompilerServices.IsImplicitlyDereferenced" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetRawConstantValue">
@@ -499,7 +489,6 @@ the current instance, returns <see langword="null" />
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -514,6 +503,10 @@ the current instance, returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a literal value associated with the property by a compiler. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that contains the literal value associated with the property. If the literal value is a class type with an element value of zero, the return value is null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetRequiredCustomModifiers">
@@ -529,7 +522,6 @@ the current instance, returns <see langword="null" />
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -539,6 +531,10 @@ the current instance, returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of types representing the required custom modifiers of the property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Type" /> objects that identify the required custom modifiers of the current property, such as <see cref="T:System.Runtime.CompilerServices.IsConst" /> or <see cref="T:System.Runtime.CompilerServices.IsImplicitlyDereferenced" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetSetMethod">
@@ -556,12 +552,6 @@ the current instance, returns <see langword="null" />
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.MethodInfo" /> instance that reflects the public
-<see langword="Set" /> accessor for the property reflected by the current 
-   instance. Returns <see langword="null" /> if no public <see langword="Set" />
-   accessor exists.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is a convenience method that provides an implementation for the abstract GetSetMethod method with the <paramref name="nonPublic" /> parameter set to false.</para>
@@ -571,6 +561,10 @@ the current instance, returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the public set accessor for this property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The MethodInfo object representing the Set method for this property if the set accessor is public, or null if the set accessor is not public.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -591,15 +585,6 @@ the current instance, returns <see langword="null" />
         <Parameter Name="nonPublic" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>If <paramref name="nonPublic" /> is <see langword="true" />, returns a <see cref="T:System.Reflection.MethodInfo" />
-instance that reflects the <see langword="Set" /> accessor
-for the property reflected by the current instance if that accessor exists. If
-<paramref name="nonPublic " />is <see langword="false" /> and the <see langword="Set" /> accessor is non-public, or <paramref name="nonPublic" /> 
-is <see langword="true" />
-but no <see langword="Set" /> accessor exists for the property
-reflected by the current instance, returns <see langword="null" /> .</para>
-        </returns>
         <exception cref="T:System.MethodAccessException">
           <paramref name="nonPublic" /> is <see langword="true" />, the <see langword="Set" /> accessor for the property reflected by the current instance is non-public, and the caller does not have <see cref="T:System.Security.Permissions.ReflectionPermission" /> to reflect on non-public methods.</exception>
         <permission cref="T:System.Security.Permissions.ReflectionPermission">Requires permission to reflect non-public members of a type in loaded assemblies. See <see cref="F:System.Security.Permissions.ReflectionPermissionFlag.TypeInformation" />.</permission>
@@ -611,6 +596,46 @@ reflected by the current instance, returns <see langword="null" /> .</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the set accessor for this property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>A <see cref="T:System.Reflection.MethodInfo" /> object representing the Set method for this property. </para>
+              </term>
+              <description>
+                <para>The set accessor is public.</para>
+                <para>-or- </para>
+                <para>
+                  <paramref name="nonPublic" /> is true and the set accessor is non-public. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>null </para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="nonPublic" /> is true, but the property is read-only.</para>
+                <para>-or- </para>
+                <para>
+                  <paramref name="nonPublic" /> is false and the set accessor is non-public.</para>
+                <para>-or- </para>
+                <para>There is no set accessor. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="nonPublic">
           <attribution license="cc4" from="Microsoft" modified="false" />Indicates whether the accessor should be returned if it is non-public. true if a non-public accessor is to be returned; otherwise, false. </param>
       </Docs>
@@ -651,12 +676,15 @@ reflected by the current instance, returns <see langword="null" /> .</para>
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the property value of a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The property value of the specified object.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object whose property value will be returned.</param>
       </Docs>
@@ -684,9 +712,6 @@ reflected by the current instance, returns <see langword="null" /> .</para>
         <Parameter Name="index" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Object" /> that contains the property value for <paramref name="obj" /> .</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>
             <paramref name="index " />does not contain the exact type of arguments needed.</para>
@@ -718,6 +743,10 @@ Console.WriteLine("CurrCult: " +
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the property value of a specified object with optional index values for indexed properties.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The property value of the specified object.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object whose property value will be returned. </param>
         <param name="index">
@@ -746,10 +775,6 @@ Console.WriteLine("CurrCult: " +
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Object" /> that
-   contains the property value for <paramref name="obj" /> .</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>
             <paramref name="index " /> does not contain the exact type of arguments needed.</para>
@@ -786,6 +811,10 @@ Console.WriteLine("CurrCult: " +
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the property value of a specified object that has the specified binding, index, and culture-specific information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The property value of the specified object.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object whose property value will be returned. </param>
         <param name="invokeAttr">
@@ -866,12 +895,15 @@ Console.WriteLine("CurrCult: " +
         <Parameter Name="right" Type="System.Reflection.PropertyInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.PropertyInfo" /> objects are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is equal to <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare.</param>
         <param name="right">
@@ -893,12 +925,15 @@ Console.WriteLine("CurrCult: " +
         <Parameter Name="right" Type="System.Reflection.PropertyInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Reflection.PropertyInfo" /> objects are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is not equal to <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare.</param>
         <param name="right">
@@ -1149,12 +1184,15 @@ Console.WriteLine("CurrCult: " +
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Type" /> object representing the <see cref="T:System.Reflection.PropertyInfo" /> type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object representing the <see cref="T:System.Reflection.PropertyInfo" /> type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Runtime.InteropServices._PropertyInfo.GetTypeInfo">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection/ReflectionContext.xml b/mcs/class/corlib/Documentation/en/System.Reflection/ReflectionContext.xml
index d2f0a734992..429624b1f91 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection/ReflectionContext.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection/ReflectionContext.xml
@@ -51,12 +51,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the representation of the type of the specified object in this reflection context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the type of the specified object.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to represent.</param>
       </Docs>
@@ -75,12 +78,15 @@
         <Parameter Name="assembly" Type="System.Reflection.Assembly" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the representation, in this reflection context, of an assembly that is represented by an object from another reflection context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The representation of the assembly in this reflection context.</para>
+        </returns>
         <param name="assembly">
           <attribution license="cc4" from="Microsoft" modified="false" />The external representation of the assembly to represent in this context.</param>
       </Docs>
@@ -99,12 +105,15 @@
         <Parameter Name="type" Type="System.Reflection.TypeInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the representation, in this reflection context, of a type represented by an object from another reflection context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The representation of the type in this reflection context..</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The external representation of the type to represent in this context.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection/RuntimeReflectionExtensions.xml b/mcs/class/corlib/Documentation/en/System.Reflection/RuntimeReflectionExtensions.xml
index ba43f97bfef..4b5944c67ec 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection/RuntimeReflectionExtensions.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection/RuntimeReflectionExtensions.xml
@@ -32,12 +32,15 @@
         <Parameter Name="del" Type="System.Delegate" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an object that represents the method represented by the specified delegate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the method.</para>
+        </returns>
         <param name="del">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate to examine.</param>
       </Docs>
@@ -56,12 +59,15 @@
         <Parameter Name="method" Type="System.Reflection.MethodInfo" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an object that represents the specified method on the direct or indirect base class where the method was first declared.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the specified method's initial declaration on a base class.</para>
+        </returns>
         <param name="method">
           <attribution license="cc4" from="Microsoft" modified="false" />The method to retrieve information about.</param>
       </Docs>
@@ -81,12 +87,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an object that represents the specified event.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the specified event, or null if the event is not found.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type that contains the event.</param>
         <param name="name">
@@ -107,7 +116,6 @@
         <Parameter Name="type" Type="System.Type" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns all events defined on the specified type, including inherited, non-public, instance, and static events.</para>
@@ -116,6 +124,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection that represents all the events defined on a specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of events for the specified type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type that contains the events.</param>
       </Docs>
@@ -135,12 +147,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an object that represents a specified field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the specified field, or null if the field is not found.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type that contains the field.</param>
         <param name="name">
@@ -161,7 +176,6 @@
         <Parameter Name="type" Type="System.Type" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns all fields that are defined on the specified type, including inherited, non-public, instance, and static fields.</para>
@@ -170,6 +184,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection that represents all the fields defined on a specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of fields for the specified type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type that contains the fields.</param>
       </Docs>
@@ -189,12 +207,15 @@
         <Parameter Name="interfaceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an interface mapping for the specified type and the specified interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the interface mapping for the specified interface and type.</para>
+        </returns>
         <param name="typeInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to retrieve a mapping for.</param>
         <param name="interfaceType">
@@ -217,12 +238,15 @@
         <Parameter Name="parameters" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an object that represents a specified method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the specified method, or null if the method is not found.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type that contains the method.</param>
         <param name="name">
@@ -245,7 +269,6 @@
         <Parameter Name="type" Type="System.Type" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns all methods defined on the specified type, including inherited, non-public, instance, and static methods.</para>
@@ -254,6 +277,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection that represents all methods defined on a specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of methods for the specified type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type that contains the methods.</param>
       </Docs>
@@ -272,7 +299,6 @@
         <Parameter Name="type" Type="System.Type" RefType="this" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns all properties defined on the specified type, including inherited, non-public, instance, and static properties.</para>
@@ -281,6 +307,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a collection that represents all the properties defined on a specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection of properties for the specified type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type that contains the properties.</param>
       </Docs>
@@ -300,12 +330,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an object that represents a specified property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the specified property, or null if the property is not found.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type that contains the property.</param>
         <param name="name">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection/TypeDelegator.xml b/mcs/class/corlib/Documentation/en/System.Reflection/TypeDelegator.xml
index 278e4687e53..a425bcc8546 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection/TypeDelegator.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection/TypeDelegator.xml
@@ -192,7 +192,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to determine if the TypeDelegator is abstract, public, and so on.</para>
@@ -201,6 +200,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the attributes assigned to the TypeDelegator.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A TypeAttributes object representing the implementation attribute flags.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetConstructorImpl">
@@ -223,7 +226,6 @@
         <Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="callConvention" /> parameter indicates the calling convention for the entry point. If no calling convention is specified, a default <see cref="T:System.Reflection.CallingConventions" /> value of Standard is used.</para>
@@ -232,6 +234,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the constructor that implemented the TypeDelegator.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A ConstructorInfo object for the method that matches the specified criteria, or null if a match cannot be found.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitmask that affects the way in which the search is conducted. The value is a combination of zero or more bit flags from <see cref="T:System.Reflection.BindingFlags" />. </param>
         <param name="binder">
@@ -265,7 +271,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Class initializers are available only through GetMember, GetMembers, FindMembers, and GetConstructors.</para>
@@ -274,6 +279,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of <see cref="T:System.Reflection.ConstructorInfo" /> objects representing constructors defined for the type wrapped by the current <see cref="T:System.Reflection.TypeDelegator" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type ConstructorInfo containing the specified constructors defined for this class. If no constructors are defined, an empty array is returned. Depending on the value of a specified parameter, only public constructors or both public and non-public constructors will be returned.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitmask that affects the way in which the search is conducted. The value is a combination of zero or more bit flags from <see cref="T:System.Reflection.BindingFlags" />. </param>
       </Docs>
@@ -294,12 +303,15 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the custom attributes defined for this type, specifying whether to search the type's inheritance chain.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of objects containing all the custom attributes defined for this type.</para>
+        </returns>
         <param name="inherit">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies whether to search this type's inheritance chain to find the attributes. </param>
       </Docs>
@@ -321,12 +333,15 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of custom attributes identified by type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of objects containing the custom attributes defined in this type that match the <paramref name="attributeType" /> parameter, specifying whether to search the type's inheritance chain, or null if no custom attributes are defined on this type.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of custom attributes identified by type.</param>
         <param name="inherit">
@@ -347,12 +362,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Type" /> of the object encompassed or referred to by the current array, pointer or ByRef.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> of the object encompassed or referred to by the current array, pointer or ByRef, or null if the current <see cref="T:System.Type" /> is not an array, a pointer or a ByRef.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetEvent">
@@ -372,7 +390,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="bindingAttr" /> is <see cref="T:System.Reflection.BindingFlags" />.IgnoreCase, the case of the <paramref name="name" /> parameter is ignored.</para>
@@ -381,6 +398,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified event.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Reflection.EventInfo" /> object representing the event declared or inherited by this type with the specified name. This method returns null if no such event is found.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the event to get. </param>
         <param name="bindingAttr">
@@ -401,12 +422,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of <see cref="T:System.Reflection.EventInfo" /> objects representing all the public events declared or inherited by the current TypeDelegator.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an array of type EventInfo containing all the events declared or inherited by the current type. If there are no events, an empty array is returned.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetEvents">
@@ -425,12 +449,15 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the events specified in <paramref name="bindingAttr" /> that are declared or inherited by the current TypeDelegator.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type EventInfo containing the events specified in <paramref name="bindingAttr" />. If there are no events, an empty array is returned.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitmask that affects the way in which the search is conducted. The value is a combination of zero or more bit flags from <see cref="T:System.Reflection.BindingFlags" />. </param>
       </Docs>
@@ -452,7 +479,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use a <paramref name="bindingAttr" /> of <see cref="T:System.Reflection.BindingFlags" />.NonPublic to return all public and nonpublic fields. Use BindingFlags.IgnoreCase to ignore the case of the fields, as the search is case-sensitive by default.</para>
@@ -461,6 +487,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Reflection.FieldInfo" /> object representing the field with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A FieldInfo object representing the field declared or inherited by this TypeDelegator with the specified name. Returns null if no such field is found.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the field to find. </param>
         <param name="bindingAttr">
@@ -483,7 +513,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Reflection.TypeDelegator.GetFields(System.Reflection.BindingFlags)" /> method does not return fields in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which fields are returned, because that order can vary.</para>
@@ -493,6 +522,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of <see cref="T:System.Reflection.FieldInfo" /> objects representing the data fields defined for the type wrapped by the current <see cref="T:System.Reflection.TypeDelegator" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type FieldInfo containing the fields declared or inherited by the current TypeDelegator. An empty array is returned if there are no matched fields.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitmask that affects the way in which the search is conducted. The value is a combination of zero or more bit flags from <see cref="T:System.Reflection.BindingFlags" />. </param>
       </Docs>
@@ -514,12 +547,15 @@
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified interface implemented by the type wrapped by the current <see cref="T:System.Reflection.TypeDelegator" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Type object representing the interface implemented (directly or indirectly) by the current class with the fully qualified name matching the specified name. If no interface that matches name is found, null is returned.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The fully qualified name of the interface implemented by the current class. </param>
         <param name="ignoreCase">
@@ -547,7 +583,6 @@
         <Parameter Name="interfaceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The interface map denotes how an interface is mapped into the actual methods on a class that implements that interface.</para>
@@ -556,6 +591,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an interface mapping for the specified interface type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Reflection.InterfaceMapping" /> object representing the interface mapping for <paramref name="interfaceType" />.</para>
+        </returns>
         <param name="interfaceType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the interface to retrieve a mapping of. </param>
       </Docs>
@@ -574,12 +613,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the interfaces implemented on the current class and its base classes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type Type containing all the interfaces implemented on the current class and its base classes. If none are defined, an empty array is returned.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetMember">
@@ -600,7 +642,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="bindingAttr" /> is <see cref="T:System.Reflection.BindingFlags" />.NonPublic, all the members will be considered. If there are no matches, an empty array is returned.</para>
@@ -609,6 +650,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns members (properties, methods, constructors, fields, events, and nested types) specified by the given <paramref name="name" />, <paramref name="type" />, and <paramref name="bindingAttr" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type MemberInfo containing all the members of the current class and its base class meeting the specified criteria.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the member to get. </param>
         <param name="type">
@@ -633,7 +678,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="bindingAttr" /> is <see cref="T:System.Reflection.BindingFlags" />.NonPublic, all the members will be considered. If there are no matches, an empty array is returned.</para>
@@ -642,6 +686,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns members specified by <paramref name="bindingAttr" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type MemberInfo containing all the members of the current class and its base classes that meet the <paramref name="bindingAttr" /> filter.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitmask that affects the way in which the search is conducted. The value is a combination of zero or more bit flags from <see cref="T:System.Reflection.BindingFlags" />. </param>
       </Docs>
@@ -667,7 +715,6 @@
         <Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="callConvention" /> parameter indicates the calling convention for the entry point. If no <see cref="T:System.Reflection.CallingConventions" /> is specified, a default CallingConventions value of Standard is used.</para>
@@ -676,6 +723,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified method whose parameters match the specified argument types and modifiers, using the specified binding constraints and the specified calling convention.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A MethodInfoInfo object for the implementation method that matches the specified criteria, or null if a match cannot be found.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The method name. </param>
         <param name="bindingAttr">
@@ -706,12 +757,15 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of <see cref="T:System.Reflection.MethodInfo" /> objects representing specified methods of the type wrapped by the current <see cref="T:System.Reflection.TypeDelegator" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of MethodInfo objects representing the methods defined on this TypeDelegator.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitmask that affects the way in which the search is conducted. The value is a combination of zero or more bit flags from <see cref="T:System.Reflection.BindingFlags" />. </param>
       </Docs>
@@ -733,12 +787,15 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a nested type specified by <paramref name="name" /> and in <paramref name="bindingAttr" /> that are declared or inherited by the type represented by the current <see cref="T:System.Reflection.TypeDelegator" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Type object representing the nested type.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The nested type's name. </param>
         <param name="bindingAttr">
@@ -761,12 +818,15 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the nested types specified in <paramref name="bindingAttr" /> that are declared or inherited by the type wrapped by the current <see cref="T:System.Reflection.TypeDelegator" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type Type containing the nested types.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitmask that affects the way in which the search is conducted. The value is a combination of zero or more bit flags from <see cref="T:System.Reflection.BindingFlags" />. </param>
       </Docs>
@@ -787,12 +847,15 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of <see cref="T:System.Reflection.PropertyInfo" /> objects representing properties of the type wrapped by the current <see cref="T:System.Reflection.TypeDelegator" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of PropertyInfo objects representing properties defined on this TypeDelegator.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitmask that affects the way in which the search is conducted. The value is a combination of zero or more bit flags from <see cref="T:System.Reflection.BindingFlags" />. </param>
       </Docs>
@@ -818,12 +881,15 @@
         <Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, searches for the specified property whose parameters match the specified argument types and modifiers, using the specified binding constraints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.PropertyInfo" /> object for the property that matches the specified criteria, or null if a match cannot be found.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The property to get. </param>
         <param name="bindingAttr">
@@ -876,12 +942,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the current <see cref="T:System.Type" /> encompasses or refers to another type; that is, whether the current <see cref="T:System.Type" /> is an array, a pointer or a ByRef.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Type" /> is an array, a pointer or a ByRef; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InvokeMember">
@@ -907,7 +976,6 @@
         <Parameter Name="namedParameters" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A method will be invoked if both the following conditions are true: </para>
@@ -938,6 +1006,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes the specified member. The method that is to be invoked must be accessible and provide the most specific match with the specified argument list, under the constraints of the specified binder and invocation attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An Object representing the return value of the invoked member.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the member to invoke. This may be a constructor, method, property, or field. If an empty string ("") is passed, the default member is invoked. </param>
         <param name="invokeAttr">
@@ -970,12 +1042,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the <see cref="T:System.Type" /> is an array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Type" /> is an array; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsAssignableFrom">
@@ -992,12 +1067,15 @@
         <Parameter Name="typeInfo" Type="System.Reflection.TypeInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the specified type can be assigned to this type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified type can be assigned to this type; otherwise, false.</para>
+        </returns>
         <param name="typeInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to check.</param>
       </Docs>
@@ -1016,12 +1094,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the <see cref="T:System.Type" /> is passed by reference.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Type" /> is passed by reference; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsCOMObjectImpl">
@@ -1038,12 +1119,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the <see cref="T:System.Type" /> is a COM object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Type" /> is a COM object; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsConstructedGenericType">
@@ -1082,12 +1166,15 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a custom attribute identified by <paramref name="attributeType" /> is defined.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a custom attribute identified by <paramref name="attributeType" /> is defined; otherwise, false.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies whether to search this type's inheritance chain to find the attributes. </param>
         <param name="inherit">
@@ -1108,12 +1195,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the <see cref="T:System.Type" /> is a pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Type" /> is a pointer; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsPrimitiveImpl">
@@ -1130,12 +1220,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the <see cref="T:System.Type" /> is one of the primitive types.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Type" /> is one of the primitive types; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsValueTypeImpl">
@@ -1152,12 +1245,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the type is a value type; that is, not a class or an interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the type is a value type; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MetadataToken">
diff --git a/mcs/class/corlib/Documentation/en/System.Reflection/TypeInfo.xml b/mcs/class/corlib/Documentation/en/System.Reflection/TypeInfo.xml
index cd9467dce4c..db48b3c75e0 100644
--- a/mcs/class/corlib/Documentation/en/System.Reflection/TypeInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.Reflection/TypeInfo.xml
@@ -42,12 +42,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the current type as a <see cref="T:System.Type" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DeclaredConstructors">
@@ -234,12 +237,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that represents the specified public event declared by the current type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the specified event, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the event.</param>
       </Docs>
@@ -258,12 +264,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that represents the specified public field declared by the current type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the specified field, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the field.</param>
       </Docs>
@@ -282,12 +291,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that represents the specified public method declared by the current type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the specified method, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the method.</param>
       </Docs>
@@ -306,12 +318,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a collection that contains all public methods declared on the current type that match the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A collection that contains methods that match <paramref name="name" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The method name to search for.</param>
       </Docs>
@@ -330,12 +345,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that represents the specified public nested type declared by the current type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the specified nested type, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the nested type.</param>
       </Docs>
@@ -354,12 +372,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that represents the specified public property declared by the current type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the specified property, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the property.</param>
       </Docs>
@@ -397,12 +418,15 @@
         <Parameter Name="typeInfo" Type="System.Reflection.TypeInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the specified type can be assigned to the current type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified type can be assigned to this type; otherwise, false.</para>
+        </returns>
         <param name="typeInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to check.</param>
       </Docs>
@@ -419,7 +443,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Reflection.TypeInfo" /> instance is cast to an <see cref="T:System.Reflection.IReflectableType" /> interface.</para>
@@ -428,6 +451,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a representation of the current type as a <see cref="T:System.Reflection.TypeInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to the current type.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Resources/IResourceReader.xml b/mcs/class/corlib/Documentation/en/System.Resources/IResourceReader.xml
index 9407248837d..71c95ff5b9b 100644
--- a/mcs/class/corlib/Documentation/en/System.Resources/IResourceReader.xml
+++ b/mcs/class/corlib/Documentation/en/System.Resources/IResourceReader.xml
@@ -72,7 +72,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IDictionaryEnumerator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Because <see cref="T:System.Resources.IResourceReader" /> inherits the <see cref="T:System.Collections.IEnumerable" /> interface, it must also provide an implementation of the <see cref="M:System.Collections.IEnumerable.GetEnumerator" /> method, which returns an <see cref="T:System.Collections.IEnumerator" /> object that can be used to enumerate a collection. Typically, <see cref="M:System.Collections.IEnumerable.GetEnumerator" /> is implemented as an explicit interface implementation.</para>
@@ -81,6 +80,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a dictionary enumerator of the resources for this reader.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A dictionary enumerator for the resources for this reader.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Resources/ResourceManager.xml b/mcs/class/corlib/Documentation/en/System.Resources/ResourceManager.xml
index e4f6c272905..86b7fa5df53 100644
--- a/mcs/class/corlib/Documentation/en/System.Resources/ResourceManager.xml
+++ b/mcs/class/corlib/Documentation/en/System.Resources/ResourceManager.xml
@@ -591,7 +591,6 @@ al /out:ru-RU\Showdate.resources.dll /culture:ru-RU /embed:DateStrings.ru-RU.res
         <Parameter Name="usingResourceSet" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ResourceManager'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns a resource manager that retrieves resources from a .resources file that is not embedded in an assembly. You can use this <see cref="T:System.Resources.ResourceManager" /> object to load resources for an ASP.NET page or to test a <see cref="T:System.Resources.ResourceSet" /> implementation.  For an example that retrieves resources from a standalone .resources file, see the <format type="text/html"><a href="eca16922-1c46-4f68-aefe-e7a12283641f">Retrieving Resources in Desktop Apps</a></format> article.</para>
@@ -604,6 +603,10 @@ al /out:ru-RU\Showdate.resources.dll /culture:ru-RU /embed:DateStrings.ru-RU.res
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Resources.ResourceManager" /> object that searches a specific directory instead of an assembly manifest for resources.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of a resource manager that searches the specified directory instead of an assembly manifest for resources.</para>
+        </returns>
         <param name="baseName">
           <attribution license="cc4" from="Microsoft" modified="false" />The root name of the resources. For example, the root name for the resource file named "MyResource.en-US.resources" is "MyResource". </param>
         <param name="resourceDir">
@@ -653,12 +656,15 @@ al /out:ru-RU\Showdate.resources.dll /culture:ru-RU /embed:DateStrings.ru-RU.res
         <Parameter Name="a" Type="System.Reflection.Assembly" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Globalization.CultureInfo'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns culture-specific information for the main assembly's default resources by retrieving the value of the <see cref="T:System.Resources.NeutralResourcesLanguageAttribute" /> attribute on a specified assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The culture from the <see cref="T:System.Resources.NeutralResourcesLanguageAttribute" /> attribute, if found; otherwise, the invariant culture.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly for which to return culture-specific information. </param>
       </Docs>
@@ -679,7 +685,6 @@ al /out:ru-RU\Showdate.resources.dll /culture:ru-RU /embed:DateStrings.ru-RU.res
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Resources.ResourceManager.GetObject(System.String)" /> method is used to retrieve non-string resources. These include values that belong to primitive data types such as <see cref="T:System.Int32" /> or <see cref="T:System.Double" />, bitmaps (such as a <see cref="T:System.Drawing.Bitmap" /> object), or custom serialized objects. Typically, the returned object must be cast (in C#) or converted (in Visual Basic) to an object of the appropriate type. </para>
@@ -697,6 +702,10 @@ al /out:ru-RU\Showdate.resources.dll /culture:ru-RU /embed:DateStrings.ru-RU.res
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified non-string resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the resource localized for the caller's current culture settings. If an appropriate resource set exists but <paramref name="name" /> cannot be found, the method returns null. </para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the resource to get. </param>
       </Docs>
@@ -718,7 +727,6 @@ al /out:ru-RU\Showdate.resources.dll /culture:ru-RU /embed:DateStrings.ru-RU.res
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Resources.ResourceManager.GetObject(System.String,System.Globalization.CultureInfo)" /> method is used to retrieve non-string resources. These include values that belong to primitive data types such as <see cref="T:System.Int32" /> or <see cref="T:System.Double" />, bitmaps (such as a <see cref="T:System.Drawing.Bitmap" /> object), or custom serialized objects. Typically, the returned object must be cast (in C#) or converted (in Visual Basic) to an object of the appropriate type. </para>
@@ -736,6 +744,10 @@ al /out:ru-RU\Showdate.resources.dll /culture:ru-RU /embed:DateStrings.ru-RU.res
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value of the specified non-string resource localized for the specified culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the resource, localized for the specified culture. If an appropriate resource set exists but <paramref name="name" /> cannot be found, the method returns null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the resource to get. </param>
         <param name="culture">
@@ -758,7 +770,6 @@ al /out:ru-RU\Showdate.resources.dll /culture:ru-RU /embed:DateStrings.ru-RU.res
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Resources.ResourceManager.GetResourceFileName(System.Globalization.CultureInfo)" /> method is useful only if you write your own class that derives from the <see cref="T:System.Resources.ResourceManager" /> class.</para>
@@ -769,6 +780,10 @@ al /out:ru-RU\Showdate.resources.dll /culture:ru-RU /embed:DateStrings.ru-RU.res
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates the name of the resource file for the given <see cref="T:System.Globalization.CultureInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name that can be used for a resource file for the given <see cref="T:System.Globalization.CultureInfo" /> object.</para>
+        </returns>
         <param name="culture">
           <attribution license="cc4" from="Microsoft" modified="false" />The culture object for which a resource file name is constructed. </param>
       </Docs>
@@ -791,7 +806,6 @@ al /out:ru-RU\Showdate.resources.dll /culture:ru-RU /embed:DateStrings.ru-RU.res
         <Parameter Name="tryParents" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ResourceSet'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resource set that is returned represents the resources that are localized for the specified culture. If the resources have not been localized for that culture and <paramref name="tryParents" /> is true, <see cref="M:System.Resources.ResourceManager.GetResourceSet(System.Globalization.CultureInfo,System.Boolean,System.Boolean)" /> uses resource fallback rules to load an appropriate resource. If <paramref name="tryParents" /> is false and a culture-specific resource set cannot be found, the method returns null. For more information about resource fallback, see "The Resource Fallback Process" section in the <format type="text/html"><a href="b224d7c0-35f8-4e82-a705-dd76795e8d16">Packaging and Deploying Resources</a></format> article.</para>
@@ -800,6 +814,10 @@ al /out:ru-RU\Showdate.resources.dll /culture:ru-RU /embed:DateStrings.ru-RU.res
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the resource set for a particular culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The resource set for the specified culture.</para>
+        </returns>
         <param name="culture">
           <attribution license="cc4" from="Microsoft" modified="false" />The culture whose resources are to be retrieved. </param>
         <param name="createIfNotExists">
@@ -824,7 +842,6 @@ al /out:ru-RU\Showdate.resources.dll /culture:ru-RU /embed:DateStrings.ru-RU.res
         <Parameter Name="a" Type="System.Reflection.Assembly" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Version'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information about satellite assembly versioning, see the <see cref="T:System.Resources.SatelliteContractVersionAttribute" /> reference topic.</para>
@@ -833,6 +850,10 @@ al /out:ru-RU\Showdate.resources.dll /culture:ru-RU /embed:DateStrings.ru-RU.res
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the version specified by the <see cref="T:System.Resources.SatelliteContractVersionAttribute" /> attribute in the given assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The satellite contract version of the given assembly, or null if no version was found.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly to check for the <see cref="T:System.Resources.SatelliteContractVersionAttribute" /> attribute. </param>
       </Docs>
@@ -857,7 +878,6 @@ al /out:ru-RU\Showdate.resources.dll /culture:ru-RU /embed:DateStrings.ru-RU.res
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -869,6 +889,10 @@ al /out:ru-RU\Showdate.resources.dll /culture:ru-RU /embed:DateStrings.ru-RU.res
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an unmanaged memory stream object from the specified resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An unmanaged memory stream object that represents a resource .</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a resource.</param>
       </Docs>
@@ -894,7 +918,6 @@ al /out:ru-RU\Showdate.resources.dll /culture:ru-RU /embed:DateStrings.ru-RU.res
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -906,6 +929,10 @@ al /out:ru-RU\Showdate.resources.dll /culture:ru-RU /embed:DateStrings.ru-RU.res
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an unmanaged memory stream object from the specified resource, using the specified culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An unmanaged memory stream object that represents a resource.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a resource.</param>
         <param name="culture">
@@ -928,7 +955,6 @@ al /out:ru-RU\Showdate.resources.dll /culture:ru-RU /embed:DateStrings.ru-RU.res
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <format type="text/html">
@@ -951,6 +977,10 @@ al /out:ru-RU\Showdate.resources.dll /culture:ru-RU /embed:DateStrings.ru-RU.res
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the specified string resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the resource localized for the caller's current UI culture, or null if <paramref name="name" /> cannot be found in a resource set.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the resource to retrieve. </param>
       </Docs>
@@ -972,7 +1002,6 @@ al /out:ru-RU\Showdate.resources.dll /culture:ru-RU /embed:DateStrings.ru-RU.res
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <format type="text/html">
@@ -996,6 +1025,10 @@ al /out:ru-RU\Showdate.resources.dll /culture:ru-RU /embed:DateStrings.ru-RU.res
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the string resource localized for the specified culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the resource localized for the specified culture, or null if <paramref name="name" /> cannot be found in a resource set.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the resource to retrieve. </param>
         <param name="culture">
@@ -1072,12 +1105,15 @@ al /out:ru-RU\Showdate.resources.dll /culture:ru-RU /embed:DateStrings.ru-RU.res
         <Parameter Name="tryParents" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ResourceSet'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides the implementation for finding a resource set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified resource set.</para>
+        </returns>
         <param name="culture">
           <attribution license="cc4" from="Microsoft" modified="false" />The culture object to look for. </param>
         <param name="createIfNotExists">
diff --git a/mcs/class/corlib/Documentation/en/System.Resources/ResourceReader.xml b/mcs/class/corlib/Documentation/en/System.Resources/ResourceReader.xml
index a2a1fe907d6..272358b251c 100644
--- a/mcs/class/corlib/Documentation/en/System.Resources/ResourceReader.xml
+++ b/mcs/class/corlib/Documentation/en/System.Resources/ResourceReader.xml
@@ -293,7 +293,6 @@ Label15="Alternate Email Address:"</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IDictionaryEnumerator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Typically, you enumerate resources by calling the <see cref="M:System.Resources.ResourceReader.GetEnumerator" /> method and then repeatedly calling the <see cref="M:System.Collections.IEnumerator.MoveNext" /> method on the returned <see cref="T:System.Collections.IDictionaryEnumerator" /> object until the method returns false. The resource name is available from the <see cref="P:System.Collections.IDictionaryEnumerator.Key" /> property; its value from the <see cref="P:System.Collections.IDictionaryEnumerator.Value" /> property. The example illustrates how to enumerate resources in this way.</para>
@@ -327,6 +326,10 @@ Label15="Alternate Email Address:"</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator for this <see cref="T:System.Resources.ResourceReader" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator for this <see cref="T:System.Resources.ResourceReader" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetResourceData">
@@ -367,7 +370,6 @@ Label15="Alternate Email Address:"</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -377,6 +379,10 @@ Label15="Alternate Email Address:"</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator for this <see cref="T:System.Resources.ResourceReader" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator for this <see cref="T:System.Resources.ResourceReader" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.IDisposable.Dispose">
diff --git a/mcs/class/corlib/Documentation/en/System.Resources/ResourceSet.xml b/mcs/class/corlib/Documentation/en/System.Resources/ResourceSet.xml
index 08c7771a960..966515f6201 100644
--- a/mcs/class/corlib/Documentation/en/System.Resources/ResourceSet.xml
+++ b/mcs/class/corlib/Documentation/en/System.Resources/ResourceSet.xml
@@ -227,12 +227,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Type'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the preferred resource reader class for this kind of <see cref="T:System.Resources.ResourceSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the <see cref="T:System.Type" /> for the preferred resource reader for this kind of <see cref="T:System.Resources.ResourceSet" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetDefaultWriter">
@@ -249,12 +252,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Type'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the preferred resource writer class for this kind of <see cref="T:System.Resources.ResourceSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the <see cref="T:System.Type" /> for the preferred resource writer for this kind of <see cref="T:System.Resources.ResourceSet" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetEnumerator">
@@ -276,7 +282,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Enumerators only allow reading the data in the collection. Enumerators cannot be used to modify the underlying collection.</para>
@@ -292,6 +297,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IDictionaryEnumerator" /> that can iterate through the <see cref="T:System.Resources.ResourceSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IDictionaryEnumerator" /> for this <see cref="T:System.Resources.ResourceSet" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetObject">
@@ -310,7 +319,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The name of the resource object is case sensitive. For a case-insensitive search, use <see cref="M:System.Resources.ResourceSet.GetObject(System.String,System.Boolean)" />.</para>
@@ -319,6 +327,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for a resource object with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The requested resource.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />Case-sensitive name of the resource to search for. </param>
       </Docs>
@@ -340,7 +352,6 @@
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the value of the <paramref name="ignoreCase" /> parameter is true, a resource with the name "Resource" is equivalent to the resource with the name "resource". Note, however, that this method always performs case-insensitive string comparisons using <see cref="P:System.Globalization.CultureInfo.InvariantCulture" />. The advantage is that results of case-insensitive string comparisons performed by this method are the same on all computers regardless of culture. The disadvantage is that the results are not consistent with the casing rules of all cultures.</para>
@@ -350,6 +361,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for a resource object with the specified name in a case-insensitive manner, if requested.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The requested resource.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />Name of the resource to search for. </param>
         <param name="ignoreCase">
@@ -372,12 +387,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for a <see cref="T:System.String" /> resource with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of a resource, if the value is a <see cref="T:System.String" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />Name of the resource to search for. </param>
       </Docs>
@@ -399,7 +417,6 @@
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the value of the <paramref name="ignoreCase" /> parameter is true, a resource with the name "Resource" is equivalent to the resource with the name "resource". Note, however, that this method always performs case-insensitive string comparisons using <see cref="P:System.Globalization.CultureInfo.InvariantCulture" />. The advantage is that results of case-insensitive string comparisons performed by this method are the same on all computers regardless of culture. The disadvantage is that the results are not consistent with the casing rules of all cultures.</para>
@@ -409,6 +426,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for a <see cref="T:System.String" /> resource with the specified name in a case-insensitive manner, if requested.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of a resource, if the value is a <see cref="T:System.String" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />Name of the resource to search for. </param>
         <param name="ignoreCase">
@@ -471,12 +492,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IEnumerator" /> object to avoid a race condition with Dispose. This member is not intended to be used directly from your code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator for the current <see cref="T:System.Resources.ResourceSet" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Table">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/AsyncTaskMethodBuilder.xml b/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/AsyncTaskMethodBuilder.xml
index cb517e2f95f..4031fd3350b 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/AsyncTaskMethodBuilder.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/AsyncTaskMethodBuilder.xml
@@ -103,7 +103,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This type and its members are intended for use by the compiler.</para>
@@ -112,6 +111,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the <see cref="T:System.Runtime.CompilerServices.AsyncTaskMethodBuilder" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the builder.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SetException">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/AsyncTaskMethodBuilder`1.xml b/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/AsyncTaskMethodBuilder`1.xml
index 472db89c133..0d19aa8df98 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/AsyncTaskMethodBuilder`1.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/AsyncTaskMethodBuilder`1.xml
@@ -107,7 +107,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This type and its members are intended for use by the compiler.</para>
@@ -116,6 +115,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the <see cref="T:System.Runtime.CompilerServices.AsyncTaskMethodBuilder`1" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the builder.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SetException">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/AsyncVoidMethodBuilder.xml b/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/AsyncVoidMethodBuilder.xml
index cdad8081a68..127d72f0611 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/AsyncVoidMethodBuilder.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/AsyncVoidMethodBuilder.xml
@@ -103,7 +103,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This type and its members are intended for use by the compiler.</para>
@@ -112,6 +111,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the <see cref="T:System.Runtime.CompilerServices.AsyncVoidMethodBuilder" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the builder.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SetException">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/ConfiguredTaskAwaitable.xml b/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/ConfiguredTaskAwaitable.xml
index a7730ae03e4..0414b599d19 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/ConfiguredTaskAwaitable.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/ConfiguredTaskAwaitable.xml
@@ -33,7 +33,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is intended for compiler use; do not use it directly in your code. </para>
@@ -42,6 +41,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an awaiter for this awaitable object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The awaiter.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/ContractHelper.xml b/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/ContractHelper.xml
index 9c7bb9f62bf..1add6903155 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/ContractHelper.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/ContractHelper.xml
@@ -43,7 +43,6 @@
         <Parameter Name="innerException" Type="System.Exception" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The binary rewriter calls this method to notify listeners about a contract failure. The <see cref="M:System.Runtime.CompilerServices.ContractHelper.RaiseContractFailedEvent(System.Diagnostics.Contracts.ContractFailureKind,System.String,System.String,System.Exception)" /> method does not perform the failure behavior (an assert or throw) itself. If the failure is handled by the listeners, the method returns null. If the failure is not handled by the listeners, a localized failure message is returned.</para>
@@ -52,6 +51,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Used by the binary rewriter to activate the default failure behavior.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A null reference (Nothing in Visual Basic) if the event was handled and should not trigger a failure; otherwise, returns the localized failure message.</para>
+        </returns>
         <param name="failureKind">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the enumeration values that specifies the type of failure.</param>
         <param name="userMessage">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/RuntimeHelpers.xml b/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/RuntimeHelpers.xml
index 54118514602..d55e5928c6e 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/RuntimeHelpers.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/RuntimeHelpers.xml
@@ -82,7 +82,6 @@
         <Parameter Name="o2" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is used by compilers.</para>
@@ -91,6 +90,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> instances are considered equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="o1" /> parameter is the same instance as the <paramref name="o2" /> parameter, or if both are null, or if o1.Equals(o2) returns true; otherwise, false.</para>
+        </returns>
         <param name="o1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare. </param>
         <param name="o2">
@@ -138,7 +141,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Runtime.CompilerServices.RuntimeHelpers.GetHashCode(System.Object)" /> method always calls the <see cref="M:System.Object.GetHashCode" /> method non-virtually, even if the object's type has overridden the <see cref="M:System.Object.GetHashCode" /> method. Therefore, using <see cref="M:System.Runtime.CompilerServices.RuntimeHelpers.GetHashCode(System.Object)" /> might differ from calling GetHashCode directly on the object with the <see cref="M:System.Object.GetHashCode" /> method.</para>
@@ -175,6 +177,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for a particular object, and is suitable for use in algorithms and data structures that use hash codes, such as a hash table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the object identified by the <paramref name="o" /> parameter.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to retrieve the hash code for. </param>
       </Docs>
@@ -195,7 +201,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Boxing a value type creates an object and performs a shallow copy of the fields of the specified value type into the new object.</para>
@@ -216,6 +221,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Boxes a value type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A boxed copy of <paramref name="obj" /> if it is a value class; otherwise, <paramref name="obj" /> itself.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The value type to be boxed. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/TaskAwaiter`1.xml b/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/TaskAwaiter`1.xml
index 617fda91988..8d46e0947ed 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/TaskAwaiter`1.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/TaskAwaiter`1.xml
@@ -41,7 +41,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This type and its members are intended for use by the compiler.</para>
@@ -50,6 +49,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ends the wait for the completion of the asynchronous task.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of the completed task.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsCompleted">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/YieldAwaitable.xml b/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/YieldAwaitable.xml
index 0be5c164110..b6e5f0601a1 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/YieldAwaitable.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.CompilerServices/YieldAwaitable.xml
@@ -33,7 +33,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This type and its members are intended for use by the compiler.</para>
@@ -42,6 +41,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a <see cref="T:System.Runtime.CompilerServices.YieldAwaitable.YieldAwaiter" /> object  for this instance of the class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object that is used to monitor the completion of an asynchronous operation.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.ExceptionServices/ExceptionDispatchInfo.xml b/mcs/class/corlib/Documentation/en/System.Runtime.ExceptionServices/ExceptionDispatchInfo.xml
index fdb121de0f3..3ef48945410 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.ExceptionServices/ExceptionDispatchInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.ExceptionServices/ExceptionDispatchInfo.xml
@@ -37,7 +37,6 @@
         <Parameter Name="source" Type="System.Exception" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the <see cref="T:System.Runtime.ExceptionServices.ExceptionDispatchInfo" /> object that is returned by this method at another time and possibly on another thread to rethrow the specified exception, as if the exception had flowed from this point where it was captured to the point where it is rethrown. </para>
@@ -47,6 +46,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Runtime.ExceptionServices.ExceptionDispatchInfo" /> object that represents the specified exception at the current point in code. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the specified exception at the current point in code. </para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The exception whose state is captured, and which is represented by the returned object. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Hosting/ApplicationActivator.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Hosting/ApplicationActivator.xml
index 88ab5f9f76b..037e678bad9 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Hosting/ApplicationActivator.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Hosting/ApplicationActivator.xml
@@ -100,7 +100,6 @@
         <Parameter Name="activationContext" Type="System.ActivationContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -110,6 +109,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the application to be activated, using the specified activation context. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Runtime.Remoting.ObjectHandle" /> that is a wrapper for the return value of the application execution. The return value must be unwrapped to access the real object.  </para>
+        </returns>
         <param name="activationContext">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ActivationContext" /> that identifies the application to activate.</param>
       </Docs>
@@ -130,7 +133,6 @@
         <Parameter Name="activationCustomData" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -140,6 +142,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the application to be activated, using the specified activation context  and custom activation data.  </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Runtime.Remoting.ObjectHandle" /> that is a wrapper for the return value of the application execution. The return value must be unwrapped to access the real object.</para>
+        </returns>
         <param name="activationContext">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ActivationContext" /> that identifies the application to activate.</param>
         <param name="activationCustomData">
@@ -161,7 +167,6 @@
         <Parameter Name="adSetup" Type="System.AppDomainSetup" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -171,6 +176,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of an application using the specified <see cref="T:System.AppDomainSetup" />  object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Runtime.Remoting.ObjectHandle" /> that is a wrapper for the return value of the application execution. The return value must be unwrapped to access the real object. </para>
+        </returns>
         <param name="adSetup">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.AppDomainSetup" /> object whose <see cref="P:System.AppDomainSetup.ActivationArguments" /> property identifies the application to activate.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IBindCtx.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IBindCtx.xml
index b693b0a0d64..a1a03b21bd1 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IBindCtx.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IBindCtx.xml
@@ -241,7 +241,6 @@
         <Parameter Name="pszKey" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -251,6 +250,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Revokes the registration of the object currently found under the specified key in the internally maintained table of contextual object parameters, if that key is currently registered.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An S_OK HRESULT value if the specified key was successfully removed from the table; otherwise, an S_FALSE HRESULT value.</para>
+        </returns>
         <param name="pszKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The key to unregister. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IEnumConnectionPoints.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IEnumConnectionPoints.xml
index 61f7a4db2dc..4d489f0541c 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IEnumConnectionPoints.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IEnumConnectionPoints.xml
@@ -67,7 +67,6 @@
         <Parameter Name="pceltFetched" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -77,6 +76,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a specified number of items in the enumeration sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>S_OK if the <paramref name="pceltFetched" /> parameter equals the <paramref name="celt" /> parameter; otherwise, S_FALSE.</para>
+        </returns>
         <param name="celt">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of IConnectionPoint references to return in <paramref name="rgelt" />. </param>
         <param name="rgelt">
@@ -107,6 +110,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resets the enumeration sequence to the beginning.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An HRESULT with the value S_OK.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Skip">
@@ -124,7 +131,6 @@
         <Parameter Name="celt" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -134,6 +140,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Skips a specified number of items in the enumeration sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>S_OK if the number of elements skipped equals the <paramref name="celt" /> parameter; otherwise, S_FALSE.</para>
+        </returns>
         <param name="celt">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of elements to skip in the enumeration. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IEnumConnections.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IEnumConnections.xml
index 3b166712120..39fabfa8df3 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IEnumConnections.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IEnumConnections.xml
@@ -67,7 +67,6 @@
         <Parameter Name="pceltFetched" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -77,6 +76,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a specified number of items in the enumeration sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>S_OK if the <paramref name="pceltFetched" /> parameter equals the <paramref name="celt" /> parameter; otherwise, S_FALSE.</para>
+        </returns>
         <param name="celt">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of <see cref="T:System.Runtime.InteropServices.CONNECTDATA" /> structures to return in <paramref name="rgelt" />. </param>
         <param name="rgelt">
@@ -107,6 +110,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resets the enumeration sequence to the beginning.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An HRESULT with the value S_OK.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Skip">
@@ -124,7 +131,6 @@
         <Parameter Name="celt" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -134,6 +140,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Skips a specified number of items in the enumeration sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>S_OK if the number of elements skipped equals the <paramref name="celt" /> parameter; otherwise, S_FALSE.</para>
+        </returns>
         <param name="celt">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of elements to skip in the enumeration. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IEnumMoniker.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IEnumMoniker.xml
index 48fc6155d1e..1a28449a730 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IEnumMoniker.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IEnumMoniker.xml
@@ -67,7 +67,6 @@
         <Parameter Name="pceltFetched" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -77,6 +76,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a specified number of items in the enumeration sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>S_OK if the <paramref name="pceltFetched" /> parameter equals the <paramref name="celt" /> parameter; otherwise, S_FALSE.</para>
+        </returns>
         <param name="celt">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of monikers to return in <paramref name="rgelt" />. </param>
         <param name="rgelt">
@@ -107,6 +110,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resets the enumeration sequence to the beginning.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An HRESULT with the value S_OK.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Skip">
@@ -124,7 +131,6 @@
         <Parameter Name="celt" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -134,6 +140,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Skips a specified number of items in the enumeration sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>S_OK if the number of elements skipped equals the <paramref name="celt" /> parameter; otherwise, S_FALSE.</para>
+        </returns>
         <param name="celt">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of elements to skip in the enumeration. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IEnumString.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IEnumString.xml
index cccbe4e0eda..ce32c4cc3bd 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IEnumString.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IEnumString.xml
@@ -67,7 +67,6 @@
         <Parameter Name="pceltFetched" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -77,6 +76,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a specified number of items in the enumeration sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>S_OK if the <paramref name="pceltFetched" /> parameter equals the <paramref name="celt" /> parameter; otherwise, S_FALSE.</para>
+        </returns>
         <param name="celt">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of strings to return in <paramref name="rgelt" />. </param>
         <param name="rgelt">
@@ -107,6 +110,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resets the enumeration sequence to the beginning.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An HRESULT with the value S_OK.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Skip">
@@ -124,7 +131,6 @@
         <Parameter Name="celt" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -134,6 +140,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Skips a specified number of items in the enumeration sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>S_OK if the number of elements skipped equals the <paramref name="celt" /> parameter; otherwise, S_FALSE.</para>
+        </returns>
         <param name="celt">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of elements to skip in the enumeration. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IEnumVARIANT.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IEnumVARIANT.xml
index a729c893c34..a366295320a 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IEnumVARIANT.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IEnumVARIANT.xml
@@ -42,7 +42,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -52,6 +51,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new enumerator that contains the same enumeration state as the current one.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Runtime.InteropServices.ComTypes.IEnumVARIANT" />  reference to the newly created enumerator.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Next">
@@ -71,7 +74,6 @@
         <Parameter Name="pceltFetched" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -81,6 +83,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a specified number of items in the enumeration sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>S_OK if the <paramref name="pceltFetched" /> parameter equals the <paramref name="celt" /> parameter; otherwise, S_FALSE.</para>
+        </returns>
         <param name="celt">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of elements to return in <paramref name="rgelt" />. </param>
         <param name="rgVar">
@@ -102,7 +108,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -112,6 +117,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resets the enumeration sequence to the beginning.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An HRESULT with the value S_OK.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Skip">
@@ -129,7 +138,6 @@
         <Parameter Name="celt" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -139,6 +147,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Skips a specified number of items in the enumeration sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>S_OK if the number of elements skipped equals <paramref name="celt" /> parameter; otherwise, S_FALSE.</para>
+        </returns>
         <param name="celt">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of elements to skip in the enumeration. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IMoniker.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IMoniker.xml
index 6429745594a..6ffdc8857e1 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IMoniker.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IMoniker.xml
@@ -301,7 +301,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -311,6 +310,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks the object for changes since it was last saved.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An S_OK HRESULT value if the object has changed; otherwise, an S_FALSE HRESULT value.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsEqual">
@@ -328,7 +331,6 @@
         <Parameter Name="pmkOtherMoniker" Type="System.Runtime.InteropServices.ComTypes.IMoniker" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -338,6 +340,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current moniker with a specified moniker and indicates whether they are identical.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An S_OK HRESULT value if the monikers are identical; otherwise, an S_FALSE HRESULT value.  </para>
+        </returns>
         <param name="pmkOtherMoniker">
           <attribution license="cc4" from="Microsoft" modified="false" />A reference to the moniker to use for comparison. </param>
       </Docs>
@@ -359,7 +365,6 @@
         <Parameter Name="pmkNewlyRunning" Type="System.Runtime.InteropServices.ComTypes.IMoniker" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -369,6 +374,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the object that is identified by the current moniker is currently loaded and running.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An S_OK HRESULT value if the moniker is running; an S_FALSE HRESULT value if the moniker is not running; or an E_UNEXPECTED HRESULT value.</para>
+        </returns>
         <param name="pbc">
           <attribution license="cc4" from="Microsoft" modified="false" />A reference to the bind context to use in this binding operation. </param>
         <param name="pmkToLeft">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IPersistFile.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IPersistFile.xml
index 84eb9f4af51..c07aeafd596 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IPersistFile.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IPersistFile.xml
@@ -84,7 +84,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -94,6 +93,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks an object for changes since it was last saved to its current file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>S_OK if the file has changed since it was last saved; S_FALSE if the file has not changed since it was last saved.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Load">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IRunningObjectTable.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IRunningObjectTable.xml
index a4628b30e4b..19aae25ec32 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IRunningObjectTable.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/IRunningObjectTable.xml
@@ -114,7 +114,6 @@
         <Parameter Name="pmkObjectName" Type="System.Runtime.InteropServices.ComTypes.IMoniker" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -124,6 +123,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified moniker is currently registered in the Running Object Table (ROT).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An HRESULT value that indicates the success or failure of the operation.</para>
+        </returns>
         <param name="pmkObjectName">
           <attribution license="cc4" from="Microsoft" modified="false" />A reference to the moniker to search for in the Running Object Table (ROT). </param>
       </Docs>
@@ -168,7 +171,6 @@
         <Parameter Name="pmkObjectName" Type="System.Runtime.InteropServices.ComTypes.IMoniker" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>ROT references to <paramref name="punkObject" /> (weak and strong) determine object lifetime. For more information, see the documentation for the COM <see cref="http://go.microsoft.com/fwlink/?LinkId=163474">IRunningObjectTable::Register</see> method in the MSDN library. </para>
@@ -177,6 +179,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Registers that the supplied object has entered the running state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that can be used to identify this ROT entry in subsequent calls to <see cref="M:System.Runtime.InteropServices.ComTypes.IRunningObjectTable.Revoke(System.Int32)" /> or <see cref="M:System.Runtime.InteropServices.ComTypes.IRunningObjectTable.NoteChangeTime(System.Int32,System.Runtime.InteropServices.ComTypes.FILETIME@)" />.</para>
+        </returns>
         <param name="grfFlags">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies whether the Running Object Table's (ROT) reference to <paramref name="punkObject" /> is weak or strong, and controls access to the object through its entry in the ROT. </param>
         <param name="punkObject">
@@ -209,6 +215,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Unregisters the specified object from the Running Object Table (ROT).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An HRESULT value that indicates the success or failure of the operation.</para>
+        </returns>
         <param name="dwRegister">
           <attribution license="cc4" from="Microsoft" modified="false" />The Running Object Table (ROT) entry to revoke. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/ITypeInfo2.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/ITypeInfo2.xml
index 298a9e584a5..e87bc3860c7 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/ITypeInfo2.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/ITypeInfo2.xml
@@ -104,6 +104,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all custom data items for the library.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value obtained from the returned HRESULT is one of the following: </para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Meaning </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>S_OK </para>
+              </term>
+              <description>
+                <para>Success </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>E_OUTOFMEMORY </para>
+              </term>
+              <description>
+                <para>Out of memory. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>E_INVALIDARG </para>
+              </term>
+              <description>
+                <para>One or more of the arguments is invalid. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="pCustData">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to CUSTDATA, which holds all custom data items. </param>
       </Docs>
@@ -133,6 +173,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all custom data from the specified function.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value obtained from the returned HRESULT is one of the following: </para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Meaning </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>S_OK </para>
+              </term>
+              <description>
+                <para>Success </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>E_OUTOFMEMORY </para>
+              </term>
+              <description>
+                <para>Out of memory. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>E_INVALIDARG </para>
+              </term>
+              <description>
+                <para>One or more of the arguments is invalid. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the function to get the custom data for. </param>
         <param name="pCustData">
@@ -164,6 +244,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all custom data for the specified implementation type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value obtained from the returned HRESULT is one of the following: </para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Meaning </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>S_OK </para>
+              </term>
+              <description>
+                <para>Success </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>E_OUTOFMEMORY </para>
+              </term>
+              <description>
+                <para>Out of memory. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>E_INVALIDARG </para>
+              </term>
+              <description>
+                <para>One or more of the arguments is invalid. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the implementation type for the custom data. </param>
         <param name="pCustData">
@@ -196,6 +316,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all of the custom data for the specified function parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value obtained from the returned HRESULT is one of the following: </para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Meaning </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>S_OK </para>
+              </term>
+              <description>
+                <para>Success </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>E_OUTOFMEMORY </para>
+              </term>
+              <description>
+                <para>Out of memory. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>E_INVALIDARG </para>
+              </term>
+              <description>
+                <para>One or more of the arguments is invalid. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="indexFunc">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the function to get the custom data for. </param>
         <param name="indexParam">
@@ -229,6 +389,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the variable for the custom data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value obtained from the returned HRESULT is one of the following: </para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Meaning </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>S_OK </para>
+              </term>
+              <description>
+                <para>Success </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>E_OUTOFMEMORY </para>
+              </term>
+              <description>
+                <para>Out of memory. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>E_INVALIDARG </para>
+              </term>
+              <description>
+                <para>One or more of the arguments is invalid. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the variable to get the custom data for. </param>
         <param name="pCustData">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/ITypeLib.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/ITypeLib.xml
index decccfe6cd6..1cb921d8bac 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/ITypeLib.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/ITypeLib.xml
@@ -165,7 +165,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -175,6 +174,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of type descriptions in the type library.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of type descriptions in the type library.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetTypeInfoOfGuid">
@@ -239,7 +242,6 @@
         <Parameter Name="lHashVal" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -250,6 +252,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a passed-in string contains the name of a type or member described in the library.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="szNameBuf" /> was found in the type library; otherwise, false.</para>
+        </returns>
         <param name="szNameBuf">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to test. This is an in/out parameter.</param>
         <param name="lHashVal">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/ITypeLib2.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/ITypeLib2.xml
index bb17bdbd2ee..ca458f115b9 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/ITypeLib2.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.ComTypes/ITypeLib2.xml
@@ -85,6 +85,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all custom data items for the library.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value obtained from the returned HRESULT is one of the following: </para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Meaning </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>S_OK </para>
+              </term>
+              <description>
+                <para>Success. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>E_OUTOFMEMORY </para>
+              </term>
+              <description>
+                <para>Out of memory. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>E_INVALIDARG </para>
+              </term>
+              <description>
+                <para>One or more of the arguments is invalid. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="pCustData">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to CUSTDATA, which holds all custom data items. </param>
       </Docs>
@@ -270,7 +310,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For additional information about ITypeLib::GetTypeInfoCount, see the MSDN Library.</para>
@@ -279,6 +318,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of type descriptions in the type library.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of type descriptions in the type library.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetTypeInfoOfGuid">
@@ -341,7 +384,6 @@
         <Parameter Name="lHashVal" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For additional information about ITypeLib::IsName, see the MSDN Library.</para>
@@ -350,6 +392,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a passed-in string contains the name of a type or member described in the library.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="szNameBuf" /> was found in the type library; otherwise, false.</para>
+        </returns>
         <param name="szNameBuf">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to test. </param>
         <param name="lHashVal">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.Expando/IExpando.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.Expando/IExpando.xml
index f4a5e1a3fa1..6df390dedfd 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.Expando/IExpando.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.Expando/IExpando.xml
@@ -47,12 +47,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.FieldInfo'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the named field to the Reflection object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.FieldInfo" /> object representing the added field.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the field. </param>
       </Docs>
@@ -74,12 +77,15 @@
         <Parameter Name="method" Type="System.Delegate" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.MethodInfo'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the named method to the Reflection object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A MethodInfo object representing the added method.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the method. </param>
         <param name="method">
@@ -102,12 +108,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.PropertyInfo'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds the named property to the Reflection object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A PropertyInfo object representing the added property.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the property. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.WindowsRuntime/EventRegistrationToken.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.WindowsRuntime/EventRegistrationToken.xml
index 44dfd8b4221..b3f65880a81 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.WindowsRuntime/EventRegistrationToken.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.WindowsRuntime/EventRegistrationToken.xml
@@ -35,12 +35,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current object is equal to the specified object. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true  if the current object is equal to <paramref name="obj" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare.</param>
       </Docs>
@@ -57,12 +60,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for this instance. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="op_Equality">
@@ -80,12 +86,15 @@
         <Parameter Name="right" Type="System.Runtime.InteropServices.WindowsRuntime.EventRegistrationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Runtime.InteropServices.WindowsRuntime.EventRegistrationToken" /> instances are equal. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two objects are equal; otherwise, false. </para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first instance to compare. </param>
         <param name="right">
@@ -107,12 +116,15 @@
         <Parameter Name="right" Type="System.Runtime.InteropServices.WindowsRuntime.EventRegistrationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Runtime.InteropServices.WindowsRuntime.EventRegistrationToken" /> instances are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two instances are not equal; otherwise, false. </para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first instance to compare. </param>
         <param name="right">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.WindowsRuntime/IActivationFactory.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.WindowsRuntime/IActivationFactory.xml
index fa6d6943b72..d09ea80a981 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.WindowsRuntime/IActivationFactory.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.WindowsRuntime/IActivationFactory.xml
@@ -32,12 +32,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new instance of the wrt class that is created by the <see cref="T:System.Runtime.InteropServices.WindowsRuntime.IActivationFactory" /> interface. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new instance of the wrt class. </para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.WindowsRuntime/WindowsRuntimeMarshal.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.WindowsRuntime/WindowsRuntimeMarshal.xml
index 400e32c12c2..9328d78f641 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.WindowsRuntime/WindowsRuntimeMarshal.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.WindowsRuntime/WindowsRuntimeMarshal.xml
@@ -82,7 +82,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In addition to the exceptions in the Exceptions section, any <unmanagedCodeEntityReference>HRESULT</unmanagedCodeEntityReference> other than <unmanagedCodeEntityReference>S_OK</unmanagedCodeEntityReference> that is returned by the underlying factory method will be marshaled as an exception. </para>
@@ -91,6 +90,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that implements the activation factory interface for the specified wrt type. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that implements the activation factory interface. </para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The wrt type to get the activation factory interface for. </param>
       </Docs>
@@ -109,12 +112,15 @@
         <Parameter Name="ptr" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a managed string that contains a copy of the specified wrt <see cref="http://go.microsoft.com/fwlink/p/?LinkId=246451">HSTRING</see>. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A managed string that contains a copy of the <see cref="http://go.microsoft.com/fwlink/p/?LinkId=246451">HSTRING</see> if <paramref name="ptr" /> is not <see cref="F:System.IntPtr.Zero" />; otherwise, <see cref="F:System.String.Empty" />. </para>
+        </returns>
         <param name="ptr">
           <attribution license="cc4" from="Microsoft" modified="false" />An unmanaged pointer to the <see cref="http://go.microsoft.com/fwlink/p/?LinkId=246451">HSTRING</see> to copy. </param>
       </Docs>
@@ -181,7 +187,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Runtime.InteropServices.WindowsRuntime.WindowsRuntimeMarshal.FreeHString(System.IntPtr)" /> method to release the <see cref="http://go.microsoft.com/fwlink/p/?LinkId=246451">HSTRING</see> when you are done using it. </para>
@@ -190,6 +195,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Allocates a wrt <see cref="http://go.microsoft.com/fwlink/p/?LinkId=246451">HSTRING</see> and copies the specified managed string to it. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An unmanaged pointer to the new <see cref="http://go.microsoft.com/fwlink/p/?LinkId=246451">HSTRING</see>, or <see cref="F:System.IntPtr.Zero" /> if <paramref name="s" /> is <see cref="F:System.String.Empty" />. </para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The managed string to copy. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.WindowsRuntime/WindowsRuntimeMetadata.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.WindowsRuntime/WindowsRuntimeMetadata.xml
index 1cdd901effe..32083fbd8fe 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.WindowsRuntime/WindowsRuntimeMetadata.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices.WindowsRuntime/WindowsRuntimeMetadata.xml
@@ -82,7 +82,6 @@
         <Parameter Name="packageGraphFilePaths" Type="System.Collections.Generic.IEnumerable&lt;System.String&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method overload is equivalent to calling the <see cref="M:System.Runtime.InteropServices.WindowsRuntime.WindowsRuntimeMetadata.ResolveNamespace(System.String,System.String,System.Collections.Generic.IEnumerable{System.String})" /> method overload and specifying null for the <paramref name="windowsSdkFilePath" /> parameter. </para>
@@ -91,6 +90,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Locates the Windows Metadata files for the specified namespace, given the specified locations to search. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerable list of strings that represent the Windows Metadata files that define <paramref name="namespaceName" />. </para>
+        </returns>
         <param name="namespaceName">
           <attribution license="cc4" from="Microsoft" modified="false" />The namespace to resolve. </param>
         <param name="packageGraphFilePaths">
@@ -113,7 +116,6 @@
         <Parameter Name="packageGraphFilePaths" Type="System.Collections.Generic.IEnumerable&lt;System.String&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The path you specify for <paramref name="windowsSdkFilePath" /> is searched only for namespaces that begin with Windows. </para>
@@ -122,6 +124,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Locates the Windows Metadata files for the specified namespace, given the specified locations to search. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerable list of strings that represent the Windows Metadata files that define <paramref name="namespaceName" />. </para>
+        </returns>
         <param name="namespaceName">
           <attribution license="cc4" from="Microsoft" modified="false" />The namespace to resolve. </param>
         <param name="windowsSdkFilePath">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ArrayWithOffset.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ArrayWithOffset.xml
index 3ccc949ce1b..0148f5f02a5 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ArrayWithOffset.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ArrayWithOffset.xml
@@ -72,12 +72,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified object matches the current <see cref="T:System.Runtime.InteropServices.ArrayWithOffset" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object matches this <see cref="T:System.Runtime.InteropServices.ArrayWithOffset" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />Object to compare with this instance. </param>
       </Docs>
@@ -98,12 +101,15 @@
         <Parameter Name="obj" Type="System.Runtime.InteropServices.ArrayWithOffset" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified <see cref="T:System.Runtime.InteropServices.ArrayWithOffset" /> object matches the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Runtime.InteropServices.ArrayWithOffset" /> object matches the current instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Runtime.InteropServices.ArrayWithOffset" /> object to compare with this instance.</param>
       </Docs>
@@ -122,12 +128,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the managed array referenced by this <see cref="T:System.Runtime.InteropServices.ArrayWithOffset" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The managed array this instance references.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -144,12 +153,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash code for this value type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetOffset">
@@ -166,12 +178,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the offset provided when this <see cref="T:System.Runtime.InteropServices.ArrayWithOffset" /> was constructed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The offset for this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="op_Equality">
@@ -190,12 +205,15 @@
         <Parameter Name="b" Type="System.Runtime.InteropServices.ArrayWithOffset" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two specified <see cref="T:System.Runtime.InteropServices.ArrayWithOffset" /> objects have the same value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of <paramref name="a" /> is the same as the value of <paramref name="b" />; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Runtime.InteropServices.ArrayWithOffset" /> object to compare with the <paramref name="b" /> parameter. </param>
         <param name="b">
@@ -218,12 +236,15 @@
         <Parameter Name="b" Type="System.Runtime.InteropServices.ArrayWithOffset" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two specified <see cref="T:System.Runtime.InteropServices.ArrayWithOffset" /> objects no not have the same value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of <paramref name="a" /> is not the same as the value of <paramref name="b" />; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Runtime.InteropServices.ArrayWithOffset" /> object to compare with the <paramref name="b" /> parameter. </param>
         <param name="b">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/COMException.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/COMException.xml
index 995c8a4b22c..a12f27d16bc 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/COMException.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/COMException.xml
@@ -311,12 +311,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the contents of the exception to a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the <see cref="P:System.Exception.HResult" />, <see cref="P:System.Exception.Message" />, <see cref="P:System.Exception.InnerException" />, and <see cref="P:System.Exception.StackTrace" /> properties of the exception.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/CriticalHandle.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/CriticalHandle.xml
index cdabeb63cbb..882ee1958ce 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/CriticalHandle.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/CriticalHandle.xml
@@ -287,7 +287,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -300,6 +299,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, executes the code required to free the handle.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the handle is released successfully; otherwise, in the event of a catastrophic failure, false. In this case, it generates a <format type="text/html"><a href="44cd98ba-95e5-40a1-874d-e8e163612c51">ReleaseHandleFailed</a></format> Managed Debugging Assistant.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SetHandle">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/GCHandle.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/GCHandle.xml
index c6a043636f8..9aea3b7bb85 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/GCHandle.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/GCHandle.xml
@@ -49,10 +49,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.IntPtr" /> containing the address of the of the <see cref="F:System.Runtime.InteropServices.GCHandleType.Pinned" /> object as a
-<see cref="T:System.IntPtr" /> .</para>
-        </returns>
         <exception cref="T:System.InvalidOperationException">The handle type is not <see cref="F:System.Runtime.InteropServices.GCHandleType.Pinned" /> .</exception>
         <permission cref="T:System.Security.Permissions.SecurityPermission">
           <para>Requires permission to call unmanaged code. See <see cref="F:System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode" qualify="true" /> .</para>
@@ -65,6 +61,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the address of an object in a <see cref="F:System.Runtime.InteropServices.GCHandleType.Pinned" /> handle.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The address of the of the Pinned object as an <see cref="T:System.IntPtr" />.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -85,10 +85,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A new <see cref="T:System.Runtime.InteropServices.GCHandle" /> instance that protects the
-   object from garbage collection.</para>
-        </returns>
         <permission cref="T:System.Security.Permissions.SecurityPermission">
           <para>Requires permission to call unmanaged code. See <see cref="F:System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode" qualify="true" /> .</para>
         </permission>
@@ -101,6 +97,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Allocates a <see cref="F:System.Runtime.InteropServices.GCHandleType.Normal" /> handle for the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Runtime.InteropServices.GCHandle" /> that protects the object from garbage collection. This <see cref="T:System.Runtime.InteropServices.GCHandle" /> must be released with <see cref="M:System.Runtime.InteropServices.GCHandle.Free" /> when it is no longer needed.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object that uses the <see cref="T:System.Runtime.InteropServices.GCHandle" />. </param>
       </Docs>
@@ -124,10 +124,6 @@
         <Parameter Name="type" Type="System.Runtime.InteropServices.GCHandleType" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A new <see cref="T:System.Runtime.InteropServices.GCHandle" /> instance
-   that protects the object.</para>
-        </returns>
         <remarks>
           <para> If the <paramref name="value" /> parameter is
 <see langword="null" /> , this method returns a valid <see cref="T:System.Runtime.InteropServices.GCHandle" />. <block subset="none" type="note">The target of 
@@ -143,6 +139,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Allocates a handle of the specified type for the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Runtime.InteropServices.GCHandle" /> of the specified type. This <see cref="T:System.Runtime.InteropServices.GCHandle" /> must be released with <see cref="M:System.Runtime.InteropServices.GCHandle.Free" /> when it is no longer needed.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object that uses the <see cref="T:System.Runtime.InteropServices.GCHandle" />. </param>
         <param name="type">
@@ -165,7 +165,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -175,6 +174,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Runtime.InteropServices.GCHandle" /> object is equal to the current <see cref="T:System.Runtime.InteropServices.GCHandle" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Runtime.InteropServices.GCHandle" /> object is equal to the current <see cref="T:System.Runtime.InteropServices.GCHandle" /> object; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Runtime.InteropServices.GCHandle" /> object to compare with the current <see cref="T:System.Runtime.InteropServices.GCHandle" /> object.</param>
       </Docs>
@@ -224,13 +227,16 @@
         <Parameter Name="value" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new <see cref="T:System.Runtime.InteropServices.GCHandle" /> object created from a handle to a managed object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Runtime.InteropServices.GCHandle" /> object that corresponds to the value parameter.  </para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IntPtr" /> handle to a managed object to create a <see cref="T:System.Runtime.InteropServices.GCHandle" /> object from.</param>
       </Docs>
@@ -248,7 +254,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -258,6 +263,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an identifier for the current <see cref="T:System.Runtime.InteropServices.GCHandle" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An identifier for the current <see cref="T:System.Runtime.InteropServices.GCHandle" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsAllocated">
@@ -307,13 +316,16 @@
         <Parameter Name="b" Type="System.Runtime.InteropServices.GCHandle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether two <see cref="T:System.Runtime.InteropServices.GCHandle" /> objects are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="a" /> and <paramref name="b" /> parameters are equal; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Runtime.InteropServices.GCHandle" /> object to compare with the <paramref name="b" /> parameter. </param>
         <param name="b">
@@ -405,13 +417,16 @@ from its integer representation.</para>
         <Parameter Name="b" Type="System.Runtime.InteropServices.GCHandle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether two <see cref="T:System.Runtime.InteropServices.GCHandle" /> objects are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="a" /> and <paramref name="b" /> parameters are not equal; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Runtime.InteropServices.GCHandle" /> object to compare with the <paramref name="b" /> parameter. </param>
         <param name="b">
@@ -462,13 +477,16 @@ from its integer representation.</para>
         <Parameter Name="value" Type="System.Runtime.InteropServices.GCHandle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the internal integer representation of a <see cref="T:System.Runtime.InteropServices.GCHandle" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IntPtr" /> object that represents a <see cref="T:System.Runtime.InteropServices.GCHandle" /> object. </para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Runtime.InteropServices.GCHandle" /> object to retrieve an internal integer representation from.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/HandleRef.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/HandleRef.xml
index 8c05032f3b8..c3d2f4c9908 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/HandleRef.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/HandleRef.xml
@@ -116,13 +116,16 @@
         <Parameter Name="value" Type="System.Runtime.InteropServices.HandleRef" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the internal integer representation of a <see cref="T:System.Runtime.InteropServices.HandleRef" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.IntPtr" /> object that represents a <see cref="T:System.Runtime.InteropServices.HandleRef" /> object.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Runtime.InteropServices.HandleRef" /> object to retrieve an internal integer representation from.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ICustomAdapter.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ICustomAdapter.xml
index baa98f4e5ab..b81951d6b67 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ICustomAdapter.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ICustomAdapter.xml
@@ -41,12 +41,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides access to the underlying object wrapped by a custom marshaler.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object contained by the adapter object.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ICustomFactory.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ICustomFactory.xml
index 1af0327d15b..7cf645aea4b 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ICustomFactory.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ICustomFactory.xml
@@ -43,7 +43,6 @@
         <Parameter Name="serverType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MarshalByRefObject'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>CreateInstance is called by the common language runtime when a new object of the specified type needs to be created. Override this method to provide your own custom class factory.</para>
@@ -52,6 +51,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.MarshalByRefObject" /> associated with the specified type.</para>
+        </returns>
         <param name="serverType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to activate. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ICustomMarshaler.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ICustomMarshaler.xml
index 78fdd23ca23..3e560d0ca7a 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ICustomMarshaler.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ICustomMarshaler.xml
@@ -278,12 +278,15 @@ library UserLib {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the size of the native data to be marshaled.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The size, in bytes, of the native data.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MarshalManagedToNative">
@@ -302,12 +305,15 @@ library UserLib {
         <Parameter Name="ManagedObj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the managed data to unmanaged data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A pointer to the COM view of the managed object.</para>
+        </returns>
         <param name="ManagedObj">
           <attribution license="cc4" from="Microsoft" modified="false" />The managed object to be converted. </param>
       </Docs>
@@ -328,12 +334,15 @@ library UserLib {
         <Parameter Name="pNativeData" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the unmanaged data to managed data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the managed view of the COM data.</para>
+        </returns>
         <param name="pNativeData">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the unmanaged data to be wrapped. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/IRegistrationServices.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/IRegistrationServices.xml
index b517ae612de..090c4afb597 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/IRegistrationServices.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/IRegistrationServices.xml
@@ -44,12 +44,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Guid'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the GUID of the COM category that contains the managed classes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The GUID of the COM category that contains the managed classes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetProgIdForType">
@@ -68,12 +71,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the COM ProgID for a specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The ProgID for the specified type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type whose ProgID is being requested. </param>
       </Docs>
@@ -94,12 +100,15 @@
         <Parameter Name="assembly" Type="System.Reflection.Assembly" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Type []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a list of classes in an assembly that would be registered by a call to <see cref="M:System.Runtime.InteropServices.IRegistrationServices.RegisterAssembly(System.Reflection.Assembly,System.Runtime.InteropServices.AssemblyRegistrationFlags)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> array containing a list of classes in <paramref name="assembly" />.</para>
+        </returns>
         <param name="assembly">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly to search for classes. </param>
       </Docs>
@@ -121,7 +130,6 @@
         <Parameter Name="flags" Type="System.Runtime.InteropServices.AssemblyRegistrationFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>RegisterAssembly adds the appropriate registry entries for the types in the specified assembly. This method also calls any registration functions found in the assembly.</para>
@@ -131,6 +139,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Registers the classes in a managed assembly to enable creation from COM.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="assembly" /> contains types that were successfully registered; otherwise false if the assembly contains no eligible types.</para>
+        </returns>
         <param name="assembly">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly to be registered. </param>
         <param name="flags">
@@ -176,12 +188,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified type is a COM type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified type is a COM type; otherwise false.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to determine if it is a COM type. </param>
       </Docs>
@@ -202,12 +217,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified type requires registration.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the type must be registered for use from COM; otherwise false.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to check for COM registration requirements. </param>
       </Docs>
@@ -228,7 +246,6 @@
         <Parameter Name="assembly" Type="System.Reflection.Assembly" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>UnregisterAssembly removes the registry entries for the types in the specified assembly previously added by <see cref="M:System.Runtime.InteropServices.IRegistrationServices.RegisterAssembly(System.Reflection.Assembly,System.Runtime.InteropServices.AssemblyRegistrationFlags)" />. This method also calls any unregistration functions found in the assembly.</para>
@@ -237,6 +254,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Unregisters the classes in a managed assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="assembly" /> contains types that were successfully unregistered; otherwise false if the assembly contains no eligible types.</para>
+        </returns>
         <param name="assembly">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly to be unregistered. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ITypeLibConverter.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ITypeLibConverter.xml
index ce6c1d8912d..baead2ea5a8 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ITypeLibConverter.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ITypeLibConverter.xml
@@ -49,7 +49,6 @@
         <Parameter Name="notifySink" Type="System.Runtime.InteropServices.ITypeLibExporterNotifySink" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information on ITypeLib, please see its existing documentation in the MSDN library.</para>
@@ -58,6 +57,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an assembly to a COM type library.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that implements the ITypeLib interface.</para>
+        </returns>
         <param name="assembly">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly to convert. </param>
         <param name="typeLibName">
@@ -90,7 +93,6 @@
         <Parameter Name="unsafeInterfaces" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.Emit.AssemblyBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information on ITypeLib, please see its existing documentation in the MSDN library.</para>
@@ -99,6 +101,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a COM type library to an assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Reflection.Emit.AssemblyBuilder" /> object containing the converted type library.</para>
+        </returns>
         <param name="typeLib">
           <attribution license="cc4" from="Microsoft" modified="false" />The object that implements the ITypeLib interface. </param>
         <param name="asmFileName">
@@ -139,7 +145,6 @@
         <Parameter Name="asmVersion" Type="System.Version" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.Emit.AssemblyBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information on ITypeLib, please see its existing documentation in the MSDN library.</para>
@@ -148,6 +153,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a COM type library to an assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Reflection.Emit.AssemblyBuilder" /> object containing the converted type library.</para>
+        </returns>
         <param name="typeLib">
           <attribution license="cc4" from="Microsoft" modified="false" />The object that implements the ITypeLib interface. </param>
         <param name="asmFileName">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ITypeLibExporterNameProvider.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ITypeLibExporterNameProvider.xml
index 2003f682cb0..3557c03bf45 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ITypeLibExporterNameProvider.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ITypeLibExporterNameProvider.xml
@@ -47,7 +47,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Names in the array returned from this method must be unique. If a name appears twice in the array of names, even with different casing, the first occurance takes precedence.</para>
@@ -56,6 +55,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a list of names to control the casing of.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of strings, where each element contains the name of a type to control casing for.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ITypeLibExporterNotifySink.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ITypeLibExporterNotifySink.xml
index 1e58db76f47..053ff00d884 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ITypeLibExporterNotifySink.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ITypeLibExporterNotifySink.xml
@@ -83,7 +83,6 @@
         <Parameter Name="assembly" Type="System.Reflection.Assembly" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If a reference to another assembly is found during the conversion of an assembly, the caller is asked to return the correct type library (the object that implements ITypeLib interface) for that assembly.</para>
@@ -92,6 +91,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asks the user to resolve a reference to another assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type library for <paramref name="assembly" />.</para>
+        </returns>
         <param name="assembly">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly to resolve. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ITypeLibImporterNotifySink.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ITypeLibImporterNotifySink.xml
index 13ef465e598..8add11bf090 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ITypeLibImporterNotifySink.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/ITypeLibImporterNotifySink.xml
@@ -83,7 +83,6 @@
         <Parameter Name="typeLib" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.Assembly'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If a reference to another type library is found during the conversion of a type library, the caller is asked to return the correct assembly for that type library.</para>
@@ -92,6 +91,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asks the user to resolve a reference to another type library.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The assembly corresponding to <paramref name="typeLib" />.</para>
+        </returns>
         <param name="typeLib">
           <attribution license="cc4" from="Microsoft" modified="false" />The object implementing the ITypeLib interface that needs to be resolved. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/Marshal.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/Marshal.xml
index 1535539a2ad..dd40ae94400 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/Marshal.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/Marshal.xml
@@ -43,7 +43,6 @@
         <Parameter Name="pUnk" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The common language runtime manages the reference count of a COM object for you, making it unnecessary to use this method directly. In rare cases, such as testing a custom marshaler, you might find it necessary to manipulate an object's lifetime manually. After calling <see cref="M:System.Runtime.InteropServices.Marshal.AddRef(System.IntPtr)" />, you must decrement the reference count by using a method such as <see cref="M:System.Runtime.InteropServices.Marshal.Release(System.IntPtr)" />. Do not rely on the return value of <see cref="M:System.Runtime.InteropServices.Marshal.AddRef(System.IntPtr)" />, as it can sometimes be unstable.</para>
@@ -53,6 +52,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Increments the reference count on the specified interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new value of the reference count on the <paramref name="pUnk" /> parameter.</para>
+        </returns>
         <param name="pUnk">
           <attribution license="cc4" from="Microsoft" modified="false" />The interface reference count to increment.</param>
       </Docs>
@@ -73,7 +76,6 @@
         <Parameter Name="cb" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -83,6 +85,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Allocates a block of memory of specified size from the COM task memory allocator.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer representing the address of the block of memory allocated. This memory must be released with <see cref="M:System.Runtime.InteropServices.Marshal.FreeCoTaskMem(System.IntPtr)" />.</para>
+        </returns>
         <param name="cb">
           <attribution license="cc4" from="Microsoft" modified="false" />The size of the block of memory to be allocated.</param>
       </Docs>
@@ -108,7 +114,6 @@
         <Parameter Name="cb" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -119,6 +124,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Allocates memory from the unmanaged memory of the process by using the specified number of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A pointer to the newly allocated memory. This memory must be released using the <see cref="M:System.Runtime.InteropServices.Marshal.FreeHGlobal(System.IntPtr)" /> method.</para>
+        </returns>
         <param name="cb">
           <attribution license="cc4" from="Microsoft" modified="false" />The required number of bytes in memory.</param>
       </Docs>
@@ -144,7 +153,6 @@
         <Parameter Name="cb" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -155,6 +163,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Allocates memory from the unmanaged memory of the process by using the pointer to the specified number of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A pointer to the newly allocated memory. This memory must be released using the <see cref="M:System.Runtime.InteropServices.Marshal.FreeHGlobal(System.IntPtr)" /> method.</para>
+        </returns>
         <param name="cb">
           <attribution license="cc4" from="Microsoft" modified="false" />The required number of bytes in memory.</param>
       </Docs>
@@ -175,7 +187,6 @@
         <Parameter Name="monikerName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -185,6 +196,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an interface pointer identified by the specified moniker.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object containing a reference to the interface pointer identified by the <paramref name="monikerName" /> parameter. A moniker is a name, and in this case, the moniker is defined by an interface.</para>
+        </returns>
         <param name="monikerName">
           <attribution license="cc4" from="Microsoft" modified="false" />The moniker corresponding to the desired interface pointer.</param>
       </Docs>
@@ -829,7 +844,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -839,6 +853,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Aggregates a managed object with the specified COM object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The inner IUnknown pointer of the managed object.</para>
+        </returns>
         <param name="pOuter">
           <attribution license="cc4" from="Microsoft" modified="false" />The outer IUnknown pointer.</param>
         <param name="o">
@@ -888,7 +906,6 @@
         <Parameter Name="t" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -903,6 +920,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Wraps the specified COM object in an object of the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly wrapped object that is an instance of the desired type.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be wrapped. </param>
         <param name="t">
@@ -1023,7 +1044,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1035,6 +1055,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Releases all references to a <format type="text/html"><a href="7e542583-1e31-4e10-b523-8cf2f29cb4a4">Runtime Callable Wrapper</a></format> (RCW) by setting its reference count to 0.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new value of the reference count of the RCW associated with the <paramref name="o" /><legacyItalic> </legacyItalic>parameter, which is 0 (zero) if the release is successful.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The RCW to be released.</param>
       </Docs>
@@ -1150,7 +1174,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Guid'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the type has a GUID in the metadata, it is returned. Otherwise, a GUID is automatically generated. You can use this method to programmatically determine the COM GUID for any managed type, including COM-invisible types. Class interfaces are the only exception because they do not correspond to a managed type. <see cref="M:System.Runtime.InteropServices.Marshal.GenerateGuidForType(System.Type)" /> provides the same functionality as the <see cref="P:System.Type.GUID" /> property.</para>
@@ -1159,6 +1182,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the globally unique identifier (GUID) for the specified type, or generates a GUID using the algorithm used by the Type Library Exporter (Tlbexp.exe).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An identifier for the specified type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to generate a GUID for. </param>
       </Docs>
@@ -1179,7 +1206,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the type has a ProgID in the metadata, that ProgID is returned. Otherwise, a ProgID is generated based on the fully qualified name of the type.</para>
@@ -1188,6 +1214,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a programmatic identifier (ProgID) for the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The ProgID of the specified type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to get a ProgID for. </param>
       </Docs>
@@ -1208,7 +1238,6 @@
         <Parameter Name="progID" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -1223,6 +1252,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains a running instance of the specified object from the running object table (ROT).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object that was requested; otherwise null. You can cast this object to any COM interface that it supports.</para>
+        </returns>
         <param name="progID">
           <attribution license="cc4" from="Microsoft" modified="false" />The programmatic identifier (ProgID) of the object that was requested.</param>
       </Docs>
@@ -1244,7 +1277,6 @@
         <Parameter Name="T" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns an interface pointer that represents the requested interface on the specified object. It is particularly useful if you have an unmanaged method that expects to be passed an interface pointer. Calling an object with this method causes the reference count to increment on the interface pointer before the pointer is returned. Always use <see cref="M:System.Runtime.InteropServices.Marshal.Release(System.IntPtr)" /> to decrement the reference count once you have finished with the pointer. You must adhere to the rules defined by COM when using raw COM interface pointers.</para>
@@ -1257,6 +1289,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a pointer to an <see cref="http://go.microsoft.com/fwlink/?LinkId=148003">IUnknown</see> interface that represents the specified interface on the specified object. Custom query interface access is enabled by default.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The interface pointer that represents the specified interface for the object.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object that provides the interface. </param>
         <param name="T">
@@ -1305,7 +1341,6 @@
         <Parameter Name="t" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1315,6 +1350,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an interface pointer that represents the specified interface for an object, if the caller is in the same context as that object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The interface pointer specified by <paramref name="t" /> that represents the interface for the specified object, or null if the caller is not in the same context as the object.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object that provides the interface.</param>
         <param name="t">
@@ -1338,7 +1377,6 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>All COM objects wrapped in a <format type="text/html"><a href="7e542583-1e31-4e10-b523-8cf2f29cb4a4">Runtime Callable Wrapper</a></format> have an associated hash table, which <see cref="M:System.Runtime.InteropServices.Marshal.GetComObjectData(System.Object,System.Object)" /> retrieves. <see cref="M:System.Runtime.InteropServices.Marshal.SetComObjectData(System.Object,System.Object,System.Object)" /> adds data to the hash table. You should never have to call either method from your code.</para>
@@ -1347,6 +1385,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves data that is referenced by the specified key from the specified COM object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The data represented by the <paramref name="key" /> parameter in the internal hash table of the <paramref name="obj" /> parameter.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The COM object that contains the data that you want.</param>
         <param name="key">
@@ -1369,7 +1411,6 @@
         <Parameter Name="m" Type="System.Reflection.MemberInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The zero-based slot number returned by this method accounts for three <see cref="http://go.microsoft.com/fwlink/?LinkId=148003">IUnknown</see> and possibly four <format type="text/html"><a href="ebbff4bc-36b2-4861-9efa-ffa45e013eb5">IDispatch</a></format> methods, making the value of the first available slot either 3 or 7. <see cref="M:System.Runtime.InteropServices.Marshal.GetComSlotForMethodInfo(System.Reflection.MemberInfo)" /> provides the opposite functionality of <see cref="M:System.Runtime.InteropServices.Marshal.GetMethodInfoForComSlot(System.Type,System.Int32,System.Runtime.InteropServices.ComMemberType@)" />.</para>
@@ -1379,6 +1420,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the virtual function table (v-table or VTBL) slot for a specified <see cref="T:System.Reflection.MemberInfo" /> type when that type is exposed to COM.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The VTBL slot <paramref name="m" /> identifier when it is exposed to COM.</para>
+        </returns>
         <param name="m">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that represents an interface method.</param>
       </Docs>
@@ -1399,7 +1444,6 @@
         <Parameter Name="t" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1428,6 +1472,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an unmanaged function pointer to a delegate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A delegate instance that can be cast to the appropriate delegate type.</para>
+        </returns>
         <param name="ptr">
           <attribution license="cc4" from="Microsoft" modified="false" />The unmanaged function pointer to be converted.</param>
         <param name="t">
@@ -1451,7 +1499,6 @@
         <Parameter Name="ptr" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the <see cref="M:System.Runtime.InteropServices.Marshal.GetDelegateForFunctionPointer``1(System.IntPtr)" /> and <see cref="M:System.Runtime.InteropServices.Marshal.GetFunctionPointerForDelegate``1(``0)" /> methods to marshal delegates in both directions. </para>
@@ -1476,6 +1523,10 @@
           <para>[Supported in the .NET Framework 4.5.1 only] </para>
           <para>Converts an unmanaged function pointer to a delegate of a specified type. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A instance of the specified delegate type.</para>
+        </returns>
         <param name="ptr">
           <attribution license="cc4" from="Microsoft" modified="false" />The unmanaged function pointer to convert. </param>
         <typeparam name="TDelegate">
@@ -1498,7 +1549,6 @@
         <Parameter Name="t" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns the zero-based, v-table number for an interface or a class. When used on a class, the slot number returned refers to the class interface for the class. If the class interface is auto-dual, this method always returns -1 to indicate that the dispatch-only interface does not expose a v-table to managed clients. You can use <see cref="M:System.Runtime.InteropServices.Marshal.GetEndComSlot(System.Type)" /> and <see cref="M:System.Runtime.InteropServices.Marshal.GetStartComSlot(System.Type)" /> in conjunction with <see cref="M:System.Runtime.InteropServices.Marshal.GetMethodInfoForComSlot(System.Type,System.Int32,System.Runtime.InteropServices.ComMemberType@)" /> to pass slots within a specified range. For additional information, see <format type="text/html"><a href="733c0dd2-12e5-46e6-8de1-39d5b25df024">Introducing the Class Interface</a></format>.</para>
@@ -1507,6 +1557,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the last slot in the virtual function table (v-table or VTBL) of a type when exposed to COM.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The last VTBL slot of the interface when exposed to COM. If the <paramref name="t" /> parameter is a class, the returned VTBL slot is the last slot in the interface that is generated from the class.</para>
+        </returns>
         <param name="t">
           <attribution license="cc4" from="Microsoft" modified="false" />A type that represents an interface or class.</param>
       </Docs>
@@ -1525,7 +1579,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -1535,6 +1588,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a code that identifies the type of the exception that occurred.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type of the exception.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetExceptionForHR">
@@ -1552,7 +1609,6 @@
         <Parameter Name="errorCode" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1564,6 +1620,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified HRESULT error code to a corresponding <see cref="T:System.Exception" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the converted HRESULT.</para>
+        </returns>
         <param name="errorCode">
           <attribution license="cc4" from="Microsoft" modified="false" />The HRESULT to be converted.</param>
       </Docs>
@@ -1584,7 +1644,6 @@
         <Parameter Name="errorInfo" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1596,6 +1655,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified HRESULT error code to a corresponding <see cref="T:System.Exception" /> object, with additional error information passed in an <format type="text/html"><a href="4dda6909-2d9a-4727-ae0c-b5f90dcfa447">IErrorInfo</a></format> interface for the exception object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the converted HRESULT and information obtained from <paramref name="errorInfo" />.</para>
+        </returns>
         <param name="errorCode">
           <attribution license="cc4" from="Microsoft" modified="false" />The HRESULT to be converted.</param>
         <param name="errorInfo">
@@ -1621,7 +1684,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -1631,6 +1693,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a computer-independent description of an exception, and information about the state that existed for the thread when the exception occurred.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A pointer to an <see cref="http://go.microsoft.com/fwlink/?LinkId=148648">EXCEPTION_POINTERS</see> structure.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetFunctionPointerForDelegate">
@@ -1648,7 +1714,6 @@
         <Parameter Name="d" Type="System.Delegate" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1659,6 +1724,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a delegate into a function pointer that is callable from unmanaged code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that can be passed to unmanaged code, which, in turn, can use it to call the underlying managed delegate. </para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate to be passed to unmanaged code.</param>
       </Docs>
@@ -1703,7 +1772,6 @@
         <Parameter Name="m" Type="System.Reflection.Module" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When dynamic or in-memory, modules do not have an HINSTANCE.</para>
@@ -1712,6 +1780,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the instance handle (HINSTANCE) for the specified module.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The HINSTANCE for <paramref name="m" />; or -1 if the module does not have an HINSTANCE.</para>
+        </returns>
         <param name="m">
           <attribution license="cc4" from="Microsoft" modified="false" />The module whose HINSTANCE is desired.</param>
       </Docs>
@@ -1732,7 +1804,6 @@
         <Parameter Name="e" Type="System.Exception" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -1743,6 +1814,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified exception to an HRESULT.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The HRESULT mapped to the supplied exception.</para>
+        </returns>
         <param name="e">
           <attribution license="cc4" from="Microsoft" modified="false" />The exception to convert to an HRESULT.</param>
       </Docs>
@@ -1766,7 +1841,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The target function must have had the setLastError metadata flag set. For example, the SetLastError field of the <see cref="T:System.Runtime.InteropServices.DllImportAttribute" /> must be true. The process for setting this flag depends on the source language used: C# and C++ are false by default, but the Declare statement in Visual Basic is true.</para>
@@ -1775,6 +1849,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the HRESULT corresponding to the last error incurred by Win32 code executed using <see cref="T:System.Runtime.InteropServices.Marshal" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The HRESULT corresponding to the last Win32 error code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetIDispatchForObject">
@@ -1793,7 +1871,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In managed code, you seldom work directly with the IDispatch interface. However, <see cref="M:System.Runtime.InteropServices.Marshal.GetIDispatchForObject(System.Object)" /> is useful when calling a method that exposes a COM object parameter as an <see cref="T:System.IntPtr" /> type, or with custom marshaling. Calling an object with this method causes the reference count to increment on the interface pointer before the pointer is returned. Always use <see cref="M:System.Runtime.InteropServices.Marshal.Release(System.IntPtr)" /> to decrement the reference count once you have finished with the pointer.</para>
@@ -1803,6 +1880,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <format type="text/html"><a href="ebbff4bc-36b2-4861-9efa-ffa45e013eb5">IDispatch</a></format> interface from a managed object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The IDispatch pointer for the <paramref name="o" /> parameter.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object whose IDispatch interface is requested.</param>
       </Docs>
@@ -1822,7 +1903,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1832,6 +1912,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <format type="text/html"><a href="ebbff4bc-36b2-4861-9efa-ffa45e013eb5">IDispatch</a></format> interface pointer from a managed object, if the caller is in the same context as that object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The IDispatch interface pointer for the specified object, or null if the caller is not in the same context as the specified object.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object whose IDispatch interface is requested.</param>
       </Docs>
@@ -1852,7 +1936,6 @@
         <Parameter Name="t" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns a pointer to an ITypeInfo implementation that is based on the original type. Calling an object with <see cref="M:System.Runtime.InteropServices.Marshal.GetITypeInfoForType(System.Type)" /> causes the reference count to increment on the interface pointer before the pointer is returned. Always use <see cref="M:System.Runtime.InteropServices.Marshal.Release(System.IntPtr)" /> to decrement the reference count once you have finished with the pointer. You can apply the <see cref="T:System.Runtime.InteropServices.MarshalAsAttribute" /> to replace standard interop marshaling behavior with this custom marshaler.</para>
@@ -1861,6 +1944,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Runtime.InteropServices.ComTypes.ITypeInfo" /> interface from a managed type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A pointer to the ITypeInfo interface for the <paramref name="t" /> parameter.</para>
+        </returns>
         <param name="t">
           <attribution license="cc4" from="Microsoft" modified="false" />The type whose ITypeInfo interface is being requested.</param>
       </Docs>
@@ -1881,7 +1968,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In managed code, you seldom work directly with the IUnknown interface. However, <see cref="M:System.Runtime.InteropServices.Marshal.GetIUnknownForObject(System.Object)" /> is useful when calling a method that exposes a COM object parameter as an <see cref="T:System.IntPtr" /> type, or with custom marshaling. Calling an object with this method causes the reference count to increment on the interface pointer before the pointer is returned. Always use <see cref="M:System.Runtime.InteropServices.Marshal.Release(System.IntPtr)" /> to decrement the reference count once you have finished with the pointer. This method provides the opposite functionality of the <see cref="M:System.Runtime.InteropServices.Marshal.GetObjectForIUnknown(System.IntPtr)" /> method.</para>
@@ -1891,6 +1977,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="http://go.microsoft.com/fwlink/?LinkId=148003">IUnknown</see> interface from a managed object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The IUnknown pointer for the <paramref name="o" /> parameter.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object whose IUnknown interface is requested.</param>
       </Docs>
@@ -1910,7 +2000,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1920,6 +2009,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="http://go.microsoft.com/fwlink/?LinkId=148003">IUnknown</see> interface from a managed object, if the caller is in the same context as that object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The IUnknown pointer for the specified object, or null if the caller is not in the same context as the specified object.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object whose IUnknown interface is requested.</param>
       </Docs>
@@ -1943,7 +2036,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -1954,6 +2046,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the error code returned by the last unmanaged function that was called using platform invoke that has the <see cref="F:System.Runtime.InteropServices.DllImportAttribute.SetLastError" /> flag set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The last error code set by a call to the Win32 <see cref="http://go.microsoft.com/fwlink/?LinkId=148656">SetLastError</see> function.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetManagedThunkForUnmanagedMethodPtr">
@@ -1979,7 +2075,6 @@
         <Parameter Name="cbSignature" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -1989,6 +2084,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a pointer to a runtime-generated function that marshals a call from managed to unmanaged code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A pointer to the function that will marshal a call from the <paramref name="pfnMethodToWrap" /> parameter to unmanaged code.</para>
+        </returns>
         <param name="pfnMethodToWrap">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the method to marshal.</param>
         <param name="pbSignature">
@@ -2095,7 +2194,6 @@
         <Parameter Name="pUnk" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method wraps IUnknown in a managed object. This has the effect of incrementing the reference count of the COM component. The reference count will be decremented when the runtime performs garbage collection on the managed object that represents the COM object.</para>
@@ -2115,6 +2213,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an instance of a type that represents a COM object by a pointer to its <see cref="http://go.microsoft.com/fwlink/?LinkId=148003">IUnknown</see> interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the specified unmanaged COM object.</para>
+        </returns>
         <param name="pUnk">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the IUnknown interface. </param>
       </Docs>
@@ -2135,7 +2237,6 @@
         <Parameter Name="pSrcNativeVariant" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -2148,6 +2249,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a COM VARIANT to an object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that corresponds to the <paramref name="pSrcNativeVariant" /> parameter.</para>
+        </returns>
         <param name="pSrcNativeVariant">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to a COM VARIANT.</param>
       </Docs>
@@ -2169,7 +2274,6 @@
         <Parameter Name="pSrcNativeVariant" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -2182,6 +2286,10 @@
           <para>[Supported in the .NET Framework 4.5.1 only] </para>
           <para>Converts a COM VARIANT to an object of a specified type. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object of the specified type that corresponds to the <paramref name="pSrcNativeVariant" /> parameter. </para>
+        </returns>
         <param name="pSrcNativeVariant">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to a COM VARIANT. </param>
         <typeparam name="T">
@@ -2205,7 +2313,6 @@
         <Parameter Name="cVars" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -2216,6 +2323,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an array of COM <see cref="http://go.microsoft.com/fwlink/?LinkId=148670">VARIANTs</see> to an array of objects. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object array that corresponds to <paramref name="aSrcNativeVariant" />.</para>
+        </returns>
         <param name="aSrcNativeVariant">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first element of an array of COM VARIANTs.</param>
         <param name="cVars">
@@ -2240,7 +2351,6 @@
         <Parameter Name="cVars" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -2252,6 +2362,10 @@
           <para>[Supported in the .NET Framework 4.5.1 only] </para>
           <para>Converts an array of COM VARIANTs to an array of a specified type. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <paramref name="T" /> objects that corresponds to <paramref name="aSrcNativeVariant" />. </para>
+        </returns>
         <param name="aSrcNativeVariant">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first element of an array of COM VARIANTs. </param>
         <param name="cVars">
@@ -2276,7 +2390,6 @@
         <Parameter Name="t" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns the zero-based v-table number for an interface or a class. When used on a class, the slot number that is returned refers to the class interface for the class. If the class interface is auto-dispatch, this method always returns -1 to indicate that the dispatch-only interface does not expose a v-table to managed clients. You can use <see cref="M:System.Runtime.InteropServices.Marshal.GetStartComSlot(System.Type)" /> and <see cref="M:System.Runtime.InteropServices.Marshal.GetEndComSlot(System.Type)" /> in conjunction with <see cref="M:System.Runtime.InteropServices.Marshal.GetMethodInfoForComSlot(System.Type,System.Int32,System.Runtime.InteropServices.ComMemberType@)" /> to pass slots within a specified range. For additional information, see <format type="text/html"><a href="733c0dd2-12e5-46e6-8de1-39d5b25df024">Introducing the Class Interface</a></format>.</para>
@@ -2285,6 +2398,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the first slot in the virtual function table (v-table or VTBL) that contains user-defined methods.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first VTBL slot that contains user-defined methods. The first slot is 3 if the interface is based on <see cref="http://go.microsoft.com/fwlink/?LinkId=148003">IUnknown</see>, and 7 if the interface is based on <format type="text/html"><a href="ebbff4bc-36b2-4861-9efa-ffa45e013eb5">IDispatch</a></format>.</para>
+        </returns>
         <param name="t">
           <attribution license="cc4" from="Microsoft" modified="false" />A type that represents an interface.</param>
       </Docs>
@@ -2310,7 +2427,6 @@
         <Parameter Name="cookie" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Threading.Thread'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Fiber cookies are opaque tokens that are used by the host when alerting the common language runtime to its fiber-scheduling decisions. They consist of a stack and register context.</para>
@@ -2319,6 +2435,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a fiber cookie into the corresponding <see cref="T:System.Threading.Thread" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A thread that corresponds to the <paramref name="cookie" /> parameter.</para>
+        </returns>
         <param name="cookie">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer that represents a fiber cookie.</param>
       </Docs>
@@ -2340,7 +2460,6 @@
         <Parameter Name="t" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="t" /> parameter must be either a COM-imported type or a subtype of a COM-imported type. In addition, <paramref name="t" /> must be a type whose metadata was imported by the <format type="text/html"><a href="ec0a8d63-11b3-4acd-b398-da1e37e97382">Tlbimp.exe (Type Library Importer)</a></format> tool. This type must be a class and not an associated coclass interface, which carries the name of the COM class. For example, if Tlbimp.exe imports Myclass as a class called MyclassClass and as a coclass interface called Myclass, you must use MyclassClass (not Myclass) with this method. For additional information about imported classes and coclass interfaces, see <format type="text/html"><a href="CB1EE67D-8EF0-4E40-B2A5-13714B9F33C3">[&lt;topic://cpcontlbimptypeconversion&gt;]</a></format>.</para>
@@ -2350,6 +2469,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a managed object of a specified type that represents a COM object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the class corresponding to the <see cref="T:System.Type" /> object that represents the requested unmanaged COM object.</para>
+        </returns>
         <param name="pUnk">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the IUnknown interface of the unmanaged object.</param>
         <param name="t">
@@ -2372,7 +2495,6 @@
         <Parameter Name="piTypeInfo" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Type'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -2382,6 +2504,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an unmanaged <format type="text/html"><a href="f3356463-3373-4279-bae1-953378aa2680">ITypeInfo</a></format> object into a managed <see cref="T:System.Type" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A managed type that represents the unmanaged ITypeInfo object.</para>
+        </returns>
         <param name="piTypeInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />The ITypeInfo interface to marshal. </param>
       </Docs>
@@ -2401,7 +2527,6 @@
         <Parameter Name="typeInfo" Type="System.Runtime.InteropServices.ComTypes.ITypeInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2411,6 +2536,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the name of the type represented by an <format type="text/html"><a href="f3356463-3373-4279-bae1-953378aa2680">ITypeInfo</a></format> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the type that the <paramref name="typeInfo" /> parameter points to.</para>
+        </returns>
         <param name="typeInfo">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that represents an ITypeInfo pointer.</param>
       </Docs>
@@ -2436,7 +2565,6 @@
         <Parameter Name="pTI" Type="System.Runtime.InteropServices.UCOMITypeInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can also retrieve the name of the type represented by an ITypeInfo object by calling the <see cref="M:System.Runtime.InteropServices.UCOMITypeInfo.GetDocumentation(System.Int32,System.String@,System.String@,System.Int32@,System.String@)" /> method and passing -1 for its first parameter.</para>
@@ -2445,6 +2573,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the name of the type represented by an <format type="text/html"><a href="f3356463-3373-4279-bae1-953378aa2680">ITypeInfo</a></format> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the type that the <paramref name="pTI" /> parameter points to.</para>
+        </returns>
         <param name="pTI">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that represents an ITypeInfo pointer. </param>
       </Docs>
@@ -2464,7 +2596,6 @@
         <Parameter Name="typelib" Type="System.Runtime.InteropServices.ComTypes.ITypeLib" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2476,6 +2607,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the library identifier (LIBID) of a type library.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The LIBID of the specified type library.</para>
+        </returns>
         <param name="typelib">
           <attribution license="cc4" from="Microsoft" modified="false" />The type library whose LIBID is to be retrieved.</param>
       </Docs>
@@ -2501,7 +2636,6 @@
         <Parameter Name="pTLB" Type="System.Runtime.InteropServices.UCOMITypeLib" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Guid'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -2512,6 +2646,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the library identifier (LIBID) of a type library.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The LIBID of the type library that the <paramref name="pTLB" /> parameter points to.</para>
+        </returns>
         <param name="pTLB">
           <attribution license="cc4" from="Microsoft" modified="false" />The type library whose LIBID is to be retrieved. </param>
       </Docs>
@@ -2532,7 +2670,6 @@
         <Parameter Name="asm" Type="System.Reflection.Assembly" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Guid'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When assemblies are exported to type libraries, the type library is assigned a LIBID. You can set the LIBID explicitly by applying the <see cref="T:System.Runtime.InteropServices.GuidAttribute" /> at the assembly level, or it can be generated automatically. The <format type="text/html"><a href="ec0a8d63-11b3-4acd-b398-da1e37e97382">Tlbimp.exe (Type Library Importer)</a></format> tool calculates a LIBID value based on the identity of the assembly. <see cref="M:System.Runtime.InteropServices.Marshal.GetTypeLibGuid(System.Runtime.InteropServices.UCOMITypeLib)" /> returns the LIBID that is associated with the <see cref="T:System.Runtime.InteropServices.GuidAttribute" />, if the attribute is applied. Otherwise, <see cref="M:System.Runtime.InteropServices.Marshal.GetTypeLibGuidForAssembly(System.Reflection.Assembly)" /> returns the calculated value. Alternatively, you can use the <see cref="M:System.Runtime.InteropServices.Marshal.GetTypeLibGuid(System.Runtime.InteropServices.UCOMITypeLib)" /> method to extract the actual LIBID from an existing type library.</para>
@@ -2542,6 +2679,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the library identifier (LIBID) that is assigned to a type library when it was exported from the specified assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The LIBID that is assigned to a type library when it is exported from the specified assembly.</para>
+        </returns>
         <param name="asm">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly from which the type library was exported.</param>
       </Docs>
@@ -2561,13 +2702,16 @@
         <Parameter Name="typelib" Type="System.Runtime.InteropServices.ComTypes.ITypeLib" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the LCID of a type library.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The LCID of the type library that the <paramref name="typelib" /> parameter points to.</para>
+        </returns>
         <param name="typelib">
           <attribution license="cc4" from="Microsoft" modified="false" />The type library whose LCID is to be retrieved.</param>
       </Docs>
@@ -2593,12 +2737,15 @@
         <Parameter Name="pTLB" Type="System.Runtime.InteropServices.UCOMITypeLib" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the LCID of a type library.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The LCID of the type library that the <paramref name="pTLB" /> parameter points to.</para>
+        </returns>
         <param name="pTLB">
           <attribution license="cc4" from="Microsoft" modified="false" />The type library whose LCID is to be retrieved.</param>
       </Docs>
@@ -2618,7 +2765,6 @@
         <Parameter Name="typelib" Type="System.Runtime.InteropServices.ComTypes.ITypeLib" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2629,6 +2775,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the name of a type library.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the type library that the <paramref name="typelib" /> parameter points to.</para>
+        </returns>
         <param name="typelib">
           <attribution license="cc4" from="Microsoft" modified="false" />The type library whose name is to be retrieved.</param>
       </Docs>
@@ -2654,7 +2804,6 @@
         <Parameter Name="pTLB" Type="System.Runtime.InteropServices.UCOMITypeLib" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The name returned by this method is the identifier used with the library statement, such as ADODB for the Microsoft ADO type library. The name is not a file name.</para>
@@ -2664,6 +2813,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the name of a type library.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the type library that the <paramref name="pTLB" /> parameter points to.</para>
+        </returns>
         <param name="pTLB">
           <attribution license="cc4" from="Microsoft" modified="false" />The type library whose name is to be retrieved.</param>
       </Docs>
@@ -2708,7 +2861,6 @@
         <Parameter Name="unknown" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2718,6 +2870,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a unique <format type="text/html"><a href="7e542583-1e31-4e10-b523-8cf2f29cb4a4">Runtime Callable Wrapper</a></format> (RCW) object for a given <see cref="http://go.microsoft.com/fwlink/?LinkId=148003">IUnknown</see> interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A unique RCW for the specified IUnknown interface.</para>
+        </returns>
         <param name="unknown">
           <attribution license="cc4" from="Microsoft" modified="false" />A managed pointer to an IUnknown interface.</param>
       </Docs>
@@ -2745,7 +2901,6 @@
         <Parameter Name="cbSignature" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -2755,6 +2910,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a pointer to a runtime-generated function that marshals a call from unmanaged to managed code.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A pointer to a function that will marshal a call from <paramref name="pfnMethodToWrap" /> to managed code.</para>
+        </returns>
         <param name="pfnMethodToWrap">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the method to marshal.</param>
         <param name="pbSignature">
@@ -2779,7 +2938,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -2790,6 +2948,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a specified object represents a COM object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="o" /> parameter is a COM type; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to check.</param>
       </Docs>
@@ -2810,7 +2972,6 @@
         <Parameter Name="t" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -2820,6 +2981,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a type is visible to COM clients.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the type is visible to COM; otherwise, false.</para>
+        </returns>
         <param name="t">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to check for COM visibility.</param>
       </Docs>
@@ -2840,7 +3005,6 @@
         <Parameter Name="m" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Runtime.InteropServices.Marshal.NumParamBytes(System.Reflection.MethodInfo)" /> method returns the stack size (in bytes) needed to represent the parameters of a method signature in unmanaged memory.</para>
@@ -2850,6 +3014,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of bytes in unmanaged memory that are required to hold the parameters for the specified method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes required to represent the method parameters in unmanaged memory.</para>
+        </returns>
         <param name="m">
           <attribution license="cc4" from="Microsoft" modified="false" />The method to be checked.</param>
       </Docs>
@@ -2871,7 +3039,6 @@
         <Parameter Name="fieldName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -2884,6 +3051,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the field offset of the unmanaged form of the managed class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The offset, in bytes, for the <paramref name="fieldName" /> parameter within the specified class that is declared by platform invoke.</para>
+        </returns>
         <param name="t">
           <attribution license="cc4" from="Microsoft" modified="false" />A value type or formatted reference type that specifies the managed class. You must apply the <see cref="T:System.Runtime.InteropServices.StructLayoutAttribute" /> to the class.</param>
         <param name="fieldName">
@@ -2907,7 +3078,6 @@
         <Parameter Name="fieldName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -2921,6 +3091,10 @@
           <para>[Supported in the .NET Framework 4.5.1 only] </para>
           <para>Returns the field offset of the unmanaged form of a specified managed class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The offset, in bytes, for the <paramref name="fieldName" /> parameter within the specified class that is declared by platform invoke. </para>
+        </returns>
         <param name="fieldName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the field in the <paramref name="T" /> type. </param>
         <typeparam name="T">
@@ -3014,7 +3188,6 @@
         <Parameter Name="ptr" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -3024,6 +3197,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies all characters up to the first null character from an unmanaged ANSI string to a managed <see cref="T:System.String" />, and widens each ANSI character to Unicode.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A managed string that holds a copy of the unmanaged ANSI string. If <paramref name="ptr" /> is null, the method returns a null string.</para>
+        </returns>
         <param name="ptr">
           <attribution license="cc4" from="Microsoft" modified="false" />The address of the first character of the unmanaged string.</param>
       </Docs>
@@ -3045,7 +3222,6 @@
         <Parameter Name="len" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -3055,6 +3231,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Allocates a managed <see cref="T:System.String" />, copies a specified number of characters from an unmanaged ANSI string into it, and widens each ANSI character to Unicode.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A managed string that holds a copy of the native ANSI string if the value of the <paramref name="ptr" /> parameter is not null; otherwise, this method returns null.</para>
+        </returns>
         <param name="ptr">
           <attribution license="cc4" from="Microsoft" modified="false" />The address of the first character of the unmanaged string.</param>
         <param name="len">
@@ -3077,7 +3257,6 @@
         <Parameter Name="ptr" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the current platform is Unicode, each ANSI character is widened to a Unicode character and this method calls <see cref="M:System.Runtime.InteropServices.Marshal.PtrToStringUni(System.IntPtr,System.Int32)" />. Otherwise, this method calls <see cref="M:System.Runtime.InteropServices.Marshal.PtrToStringAnsi(System.IntPtr)" />.</para>
@@ -3088,6 +3267,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Allocates a managed <see cref="T:System.String" /> and copies all characters up to the first null character from a string stored in unmanaged memory into it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A managed string that holds a copy of the unmanaged string if the value of the <paramref name="ptr" /> parameter is not null; otherwise, this method returns null.</para>
+        </returns>
         <param name="ptr">
           <attribution license="cc4" from="Microsoft" modified="false" />For Unicode platforms, the address of the first Unicode character.</param>
       </Docs>
@@ -3109,7 +3292,6 @@
         <Parameter Name="len" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>On Unicode platforms, this method calls <see cref="M:System.Runtime.InteropServices.Marshal.PtrToStringUni(System.IntPtr,System.Int32)" />; on ANSI platforms, it calls <see cref="M:System.Runtime.InteropServices.Marshal.PtrToStringAnsi(System.IntPtr)" />. No transformations are done before these methods are called.</para>
@@ -3120,6 +3302,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Allocates a managed <see cref="T:System.String" /> and copies the specified number of characters from a string stored in unmanaged memory into it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A managed string that holds a copy of the native string if the value of the <paramref name="ptr" /> parameter is not null; otherwise, this method returns null.</para>
+        </returns>
         <param name="ptr">
           <attribution license="cc4" from="Microsoft" modified="false" />For Unicode platforms, the address of the first Unicode character.</param>
         <param name="len">
@@ -3142,7 +3328,6 @@
         <Parameter Name="ptr" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call this method only on strings that were allocated with the unmanaged <format type="text/html"><a href="9e0437a2-9b4a-4576-88b0-5cb9d08ca29b">SysAllocString</a></format> and <format type="text/html"><a href="f98bff39-bc5f-4a81-85d7-d5228e20fbc8">SysAllocStringLen</a></format> functions.</para>
@@ -3153,6 +3338,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Allocates a managed <see cref="T:System.String" /> and copies a <format type="text/html"><a href="1b2d7d2c-47af-4389-a6b6-b01b7e915228">BSTR</a></format> string stored in unmanaged memory into it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A managed string that holds a copy of the unmanaged string if the value of the <paramref name="ptr" /> parameter is not null; otherwise, this method returns null.</para>
+        </returns>
         <param name="ptr">
           <attribution license="cc4" from="Microsoft" modified="false" />The address of the first character of the unmanaged string.</param>
       </Docs>
@@ -3173,7 +3362,6 @@
         <Parameter Name="ptr" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -3183,6 +3371,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Allocates a managed <see cref="T:System.String" /> and copies all characters up to the first null character from an unmanaged Unicode string into it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A managed string that holds a copy of the unmanaged string if the value of the <paramref name="ptr" /> parameter is not null; otherwise, this method returns null.</para>
+        </returns>
         <param name="ptr">
           <attribution license="cc4" from="Microsoft" modified="false" />The address of the first character of the unmanaged string.</param>
       </Docs>
@@ -3204,7 +3396,6 @@
         <Parameter Name="len" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -3214,6 +3405,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Allocates a managed <see cref="T:System.String" /> and copies a specified number of characters from an unmanaged Unicode string into it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A managed string that holds a copy of the unmanaged string if the value of the <paramref name="ptr" /> parameter is not null; otherwise, this method returns null.</para>
+        </returns>
         <param name="ptr">
           <attribution license="cc4" from="Microsoft" modified="false" />The address of the first character of the unmanaged string.</param>
         <param name="len">
@@ -3279,7 +3474,6 @@
         <Parameter Name="structureType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -3289,6 +3483,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Marshals data from an unmanaged block of memory to a newly allocated managed object of the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A managed object containing the data pointed to by the <paramref name="ptr" /> parameter.</para>
+        </returns>
         <param name="ptr">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to an unmanaged block of memory.</param>
         <param name="structureType">
@@ -3312,7 +3510,6 @@
         <Parameter Name="ptr" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -3323,6 +3520,10 @@
           <para>[Supported in the .NET Framework 4.5.1 only] </para>
           <para>Marshals data from an unmanaged block of memory to a newly allocated managed object of the type specified by a generic type parameter. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A managed object that contains the data that the <paramref name="ptr" /> parameter points to. </para>
+        </returns>
         <param name="ptr">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to an unmanaged block of memory. </param>
         <typeparam name="T">
@@ -3396,7 +3597,6 @@
         <Parameter Name="ptr" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -3407,6 +3607,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a single byte from unmanaged memory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The byte read from unmanaged memory.</para>
+        </returns>
         <param name="ptr">
           <attribution license="cc4" from="Microsoft" modified="false" />The address in unmanaged memory from which to read.</param>
       </Docs>
@@ -3428,7 +3632,6 @@
         <Parameter Name="ofs" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -3439,6 +3642,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a single byte at a given offset (or index) from unmanaged memory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The byte read from unmanaged memory at the given offset.</para>
+        </returns>
         <param name="ptr">
           <attribution license="cc4" from="Microsoft" modified="false" />The base address in unmanaged memory from which to read.</param>
         <param name="ofs">
@@ -3467,7 +3674,6 @@
         <Parameter Name="ofs" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -3478,6 +3684,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a single byte at a given offset (or index) from unmanaged memory. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The byte read from unmanaged memory at the given offset.</para>
+        </returns>
         <param name="ptr">
           <attribution license="cc4" from="Microsoft" modified="false" />The base address in unmanaged memory of the source object.</param>
         <param name="ofs">
@@ -3500,7 +3710,6 @@
         <Parameter Name="ptr" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'short'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -3511,6 +3720,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a 16-bit signed integer from unmanaged memory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 16-bit signed integer read from unmanaged memory.</para>
+        </returns>
         <param name="ptr">
           <attribution license="cc4" from="Microsoft" modified="false" />The address in unmanaged memory from which to read.</param>
       </Docs>
@@ -3532,7 +3745,6 @@
         <Parameter Name="ofs" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'short'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -3543,6 +3755,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a 16-bit signed integer at a given offset from unmanaged memory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 16-bit signed integer read from unmanaged memory at the given offset.</para>
+        </returns>
         <param name="ptr">
           <attribution license="cc4" from="Microsoft" modified="false" />The base address in unmanaged memory from which to read.</param>
         <param name="ofs">
@@ -3571,7 +3787,6 @@
         <Parameter Name="ofs" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'short'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -3582,6 +3797,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a 16-bit signed integer at a given offset from unmanaged memory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 16-bit signed integer read from unmanaged memory at the given offset.</para>
+        </returns>
         <param name="ptr">
           <attribution license="cc4" from="Microsoft" modified="false" />The base address in unmanaged memory of the source object.</param>
         <param name="ofs">
@@ -3609,7 +3828,6 @@
         <Parameter Name="ptr" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -3620,6 +3838,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a 32-bit signed integer from unmanaged memory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 32-bit signed integer read from unmanaged memory.</para>
+        </returns>
         <param name="ptr">
           <attribution license="cc4" from="Microsoft" modified="false" />The address in unmanaged memory from which to read.</param>
       </Docs>
@@ -3646,7 +3868,6 @@
         <Parameter Name="ofs" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -3657,6 +3878,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a 32-bit signed integer at a given offset from unmanaged memory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 32-bit signed integer read from unmanaged memory.</para>
+        </returns>
         <param name="ptr">
           <attribution license="cc4" from="Microsoft" modified="false" />The base address in unmanaged memory from which to read.</param>
         <param name="ofs">
@@ -3688,7 +3913,6 @@
         <Parameter Name="ofs" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -3699,6 +3923,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a 32-bit signed integer at a given offset from unmanaged memory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 32-bit signed integer read from unmanaged memory at the given offset.</para>
+        </returns>
         <param name="ptr">
           <attribution license="cc4" from="Microsoft" modified="false" />The base address in unmanaged memory of the source object.</param>
         <param name="ofs">
@@ -3726,7 +3954,6 @@
         <Parameter Name="ptr" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -3737,6 +3964,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a 64-bit signed integer from unmanaged memory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 64-bit signed integer read from unmanaged memory.</para>
+        </returns>
         <param name="ptr">
           <attribution license="cc4" from="Microsoft" modified="false" />The address in unmanaged memory from which to read.</param>
       </Docs>
@@ -3758,7 +3989,6 @@
         <Parameter Name="ofs" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -3769,6 +3999,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a 64-bit signed integer at a given offset from unmanaged memory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 64-bit signed integer read from unmanaged memory at the given offset.</para>
+        </returns>
         <param name="ptr">
           <attribution license="cc4" from="Microsoft" modified="false" />The base address in unmanaged memory from which to read.</param>
         <param name="ofs">
@@ -3800,7 +4034,6 @@
         <Parameter Name="ofs" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -3811,6 +4044,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a 64-bit signed integer at a given offset from unmanaged memory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 64-bit signed integer read from unmanaged memory at the given offset.</para>
+        </returns>
         <param name="ptr">
           <attribution license="cc4" from="Microsoft" modified="false" />The base address in unmanaged memory of the source object.</param>
         <param name="ofs">
@@ -3838,7 +4075,6 @@
         <Parameter Name="ptr" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -3849,6 +4085,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a processor native-sized integer from unmanaged memory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The integer read from unmanaged memory. A 32 bit integer is returned on 32 bit machines and a 64 bit integer is returned on 64 bit machines.</para>
+        </returns>
         <param name="ptr">
           <attribution license="cc4" from="Microsoft" modified="false" />The address in unmanaged memory from which to read.</param>
       </Docs>
@@ -3875,7 +4115,6 @@
         <Parameter Name="ofs" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -3886,6 +4125,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a processor native sized integer at a given offset from unmanaged memory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The integer read from unmanaged memory at the given offset.</para>
+        </returns>
         <param name="ptr">
           <attribution license="cc4" from="Microsoft" modified="false" />The base address in unmanaged memory from which to read.</param>
         <param name="ofs">
@@ -3914,7 +4157,6 @@
         <Parameter Name="ofs" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -3925,6 +4167,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a processor native sized integer from unmanaged memory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The integer read from unmanaged memory at the given offset.</para>
+        </returns>
         <param name="ptr">
           <attribution license="cc4" from="Microsoft" modified="false" />The base address in unmanaged memory of the source object.</param>
         <param name="ofs">
@@ -3948,7 +4194,6 @@
         <Parameter Name="cb" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -3958,6 +4203,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resizes a block of memory previously allocated with <see cref="M:System.Runtime.InteropServices.Marshal.AllocCoTaskMem(System.Int32)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer representing the address of the reallocated block of memory. This memory must be released with <see cref="M:System.Runtime.InteropServices.Marshal.FreeCoTaskMem(System.IntPtr)" />.</para>
+        </returns>
         <param name="pv">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to memory allocated with <see cref="M:System.Runtime.InteropServices.Marshal.AllocCoTaskMem(System.Int32)" />.</param>
         <param name="cb">
@@ -3981,7 +4230,6 @@
         <Parameter Name="cb" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -3992,6 +4240,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resizes a block of memory previously allocated with <see cref="M:System.Runtime.InteropServices.Marshal.AllocHGlobal(System.IntPtr)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A pointer to the reallocated memory. This memory must be released using <see cref="M:System.Runtime.InteropServices.Marshal.FreeHGlobal(System.IntPtr)" />.</para>
+        </returns>
         <param name="pv">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to memory allocated with <see cref="M:System.Runtime.InteropServices.Marshal.AllocHGlobal(System.IntPtr)" />.</param>
         <param name="cb">
@@ -4019,7 +4271,6 @@
         <Parameter Name="pUnk" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The common language runtime manages the reference count of a COM object for you, making it unnecessary to use this method directly. Use this value only for testing purposes. In rare cases, such as testing a custom marshaler, you might find it necessary to manipulate an object's lifetime manually. Only programs that call <see cref="M:System.Runtime.InteropServices.Marshal.AddRef(System.IntPtr)" /> should call <see cref="M:System.Runtime.InteropServices.Marshal.Release(System.IntPtr)" />. Calling <see cref="M:System.Runtime.InteropServices.Marshal.Release(System.IntPtr)" /> after the reference count has reached zero causes undefined behavior.</para>
@@ -4029,6 +4280,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decrements the reference count on the specified interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new value of the reference count on the interface specified by the <paramref name="pUnk" /> parameter.</para>
+        </returns>
         <param name="pUnk">
           <attribution license="cc4" from="Microsoft" modified="false" />The interface to release.</param>
       </Docs>
@@ -4049,7 +4304,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is used to explicitly control the lifetime of a COM object used from managed code. You should use this method to free the underlying COM object that holds references to resources in a timely manner or when objects must be freed in a specific order.</para>
@@ -4065,6 +4319,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decrements the reference count of the specified <format type="text/html"><a href="7e542583-1e31-4e10-b523-8cf2f29cb4a4">Runtime Callable Wrapper</a></format> (RCW) associated with the specified COM object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new value of the reference count of the RCW associated with <paramref name="o" />. This value is typically zero since the RCW keeps just one reference to the wrapped COM object regardless of the number of managed clients calling it.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The COM object to release.</param>
       </Docs>
@@ -4110,7 +4368,6 @@
         <Parameter Name="s" Type="System.Security.SecureString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4120,6 +4377,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Allocates a <format type="text/html"><a href="1b2d7d2c-47af-4389-a6b6-b01b7e915228">BSTR</a></format> and copies the contents of a managed <see cref="T:System.Security.SecureString" /> object into it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The address, in unmanaged memory, where the <paramref name="s" /> parameter was copied to, or 0 if a null object was supplied.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The managed object to copy.</param>
       </Docs>
@@ -4139,7 +4400,6 @@
         <Parameter Name="s" Type="System.Security.SecureString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4149,6 +4409,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the contents of a managed <see cref="T:System.Security.SecureString" /> object to a block of memory allocated from the unmanaged COM task allocator.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The address, in unmanaged memory, where the <paramref name="s" /> parameter was copied to, or 0 if a null object was supplied.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The managed object to copy.</param>
       </Docs>
@@ -4168,7 +4432,6 @@
         <Parameter Name="s" Type="System.Security.SecureString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4178,6 +4441,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the contents of a managed <see cref="T:System.Security.SecureString" /> object to a block of memory allocated from the unmanaged COM task allocator.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The address, in unmanaged memory, where the <paramref name="s" /> parameter was copied to, or 0 if a null object was supplied.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The managed object to copy.</param>
       </Docs>
@@ -4197,7 +4464,6 @@
         <Parameter Name="s" Type="System.Security.SecureString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4207,6 +4473,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the contents of a managed <see cref="T:System.Security.SecureString" /> into unmanaged memory, converting into ANSI format as it copies.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The address, in unmanaged memory, to where the <paramref name="s" /> parameter was copied, or 0 if a null object was supplied.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The managed object to copy.</param>
       </Docs>
@@ -4226,7 +4496,6 @@
         <Parameter Name="s" Type="System.Security.SecureString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4236,6 +4505,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the contents of a managed <see cref="T:System.Security.SecureString" /> object into unmanaged memory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The address, in unmanaged memory, where <paramref name="s" /> was copied, or 0 if <paramref name="s" /> is a <see cref="T:System.Security.SecureString" /> object whose length is 0.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The managed object to copy.</param>
       </Docs>
@@ -4258,7 +4531,6 @@
         <Parameter Name="data" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>All COM objects wrapped in a <format type="text/html"><a href="7e542583-1e31-4e10-b523-8cf2f29cb4a4">Runtime Callable Wrapper</a></format> (RCW) have an associated hash table, to which <see cref="M:System.Runtime.InteropServices.Marshal.SetComObjectData(System.Object,System.Object,System.Object)" /> adds data. <see cref="M:System.Runtime.InteropServices.Marshal.GetComObjectData(System.Object,System.Object)" /> retrieves data from the hash table. You should never have to call either method from your code.</para>
@@ -4267,6 +4539,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets data referenced by the specified key in the specified COM object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the data was set successfully; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The COM object in which to store the data.</param>
         <param name="key">
@@ -4296,7 +4572,6 @@
         <Parameter Name="structure" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method accepts an instance of a structure, which can be a reference type or a boxed value type. The layout must be sequential or explicit.</para>
@@ -4307,6 +4582,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the unmanaged size of an object in bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The size of the specified object in unmanaged code.</para>
+        </returns>
         <param name="structure">
           <attribution license="cc4" from="Microsoft" modified="false" />The object whose size is to be returned.</param>
       </Docs>
@@ -4327,7 +4606,6 @@
         <Parameter Name="t" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use this method when you do not have a structure. The layout must be sequential or explicit.</para>
@@ -4337,6 +4615,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the size of an unmanaged type in bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The size of the specified type in unmanaged code.</para>
+        </returns>
         <param name="t">
           <attribution license="cc4" from="Microsoft" modified="false" />The type whose size is to be returned.</param>
       </Docs>
@@ -4356,7 +4638,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use this method when you do not have a structure. The layout must be sequential or explicit.</para>
@@ -4367,6 +4648,10 @@
           <para>[Supported in the .NET Framework 4.5.1 only] </para>
           <para>Returns the size of an unmanaged type in bytes. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The size, in bytes, of the type that is specified by the <paramref name="T" /> generic type parameter. </para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The type whose size is to be returned. </typeparam>
       </Docs>
@@ -4411,7 +4696,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -4421,6 +4705,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Allocates a <format type="text/html"><a href="1b2d7d2c-47af-4389-a6b6-b01b7e915228">BSTR</a></format> and copies the contents of a managed <see cref="T:System.String" /> into it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An unmanaged pointer to the BSTR, or 0 if <paramref name="s" /> is null.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The managed string to be copied.</param>
       </Docs>
@@ -4441,7 +4729,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -4451,6 +4738,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the contents of a managed <see cref="T:System.String" /> to a block of memory allocated from the unmanaged COM task allocator.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer representing a pointer to the block of memory allocated for the string, or 0 if <paramref name="s" /> is null.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A managed string to be copied.</param>
       </Docs>
@@ -4471,7 +4762,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -4482,6 +4772,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the contents of a managed <see cref="T:System.String" /> to a block of memory allocated from the unmanaged COM task allocator.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The allocated memory block, or 0 if <paramref name="s" /> is null.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A managed string to be copied.</param>
       </Docs>
@@ -4502,7 +4796,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -4512,6 +4805,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the contents of a managed <see cref="T:System.String" /> to a block of memory allocated from the unmanaged COM task allocator.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer representing a pointer to the block of memory allocated for the string, or 0 if s is null.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A managed string to be copied.</param>
       </Docs>
@@ -4532,7 +4829,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -4543,6 +4839,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the contents of a managed <see cref="T:System.String" /> into unmanaged memory, converting into ANSI format as it copies.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The address, in unmanaged memory, to where <paramref name="s" /> was copied, or 0 if <paramref name="s" /> is null.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A managed string to be copied.</param>
       </Docs>
@@ -4563,7 +4863,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -4574,6 +4873,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the contents of a managed <see cref="T:System.String" /> into unmanaged memory, converting into ANSI format if required.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The address, in unmanaged memory, to where the string was copied, or 0 if <paramref name="s" /> is null.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A managed string to be copied.</param>
       </Docs>
@@ -4594,7 +4897,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -4605,6 +4907,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the contents of a managed <see cref="T:System.String" /> into unmanaged memory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The address, in unmanaged memory, to where the <paramref name="s" /> was copied, or 0 if <paramref name="s" /> is null.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A managed string to be copied.</param>
       </Docs>
@@ -4830,7 +5136,6 @@ public static void ThrowExceptionForHR(int errorCode,IntPtr errorInfo)</code>
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The array must be pinned using a <see cref="T:System.Runtime.InteropServices.GCHandle" /> before it is passed to this method. For maximum performance, this method does not validate the array passed to it; this can result in unexpected behavior.</para>
@@ -4839,6 +5144,10 @@ public static void ThrowExceptionForHR(int errorCode,IntPtr errorInfo)</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the address of the element at the specified index inside the specified array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The address of <paramref name="index" /> inside <paramref name="arr" />.</para>
+        </returns>
         <param name="arr">
           <attribution license="cc4" from="Microsoft" modified="false" />The array that contains the desired element.</param>
         <param name="index">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/RegistrationServices.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/RegistrationServices.xml
index 3d652904444..dc508c93942 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/RegistrationServices.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/RegistrationServices.xml
@@ -93,12 +93,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Guid'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the GUID of the COM category that contains the managed classes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The GUID of the COM category that contains the managed classes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetProgIdForType">
@@ -117,12 +120,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the COM ProgID for the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The ProgID for the specified type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type corresponding to the ProgID that is being requested. </param>
       </Docs>
@@ -143,12 +149,15 @@
         <Parameter Name="assembly" Type="System.Reflection.Assembly" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Type []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a list of classes in an assembly that would be registered by a call to <see cref="M:System.Runtime.InteropServices.RegistrationServices.RegisterAssembly(System.Reflection.Assembly,System.Runtime.InteropServices.AssemblyRegistrationFlags)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> array containing a list of classes in <paramref name="assembly" />.</para>
+        </returns>
         <param name="assembly">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly to search for classes. </param>
       </Docs>
@@ -170,7 +179,6 @@
         <Parameter Name="flags" Type="System.Runtime.InteropServices.AssemblyRegistrationFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>RegisterAssembly adds the appropriate registry entries for the types in the specified assembly. This method also calls any registration functions found in the assembly.</para>
@@ -180,6 +188,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Registers the classes in a managed assembly to enable creation from COM.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="assembly" /> contains types that were successfully registered; otherwise false if the assembly contains no eligible types.</para>
+        </returns>
         <param name="assembly">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly to be registered. </param>
         <param name="flags">
@@ -231,7 +243,6 @@
         <Parameter Name="flags" Type="System.Runtime.InteropServices.RegistrationConnectionType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -243,6 +254,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Registers the specified type with COM using the specified execution context and connection type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that represents a cookie value.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> object to register for use from COM.</param>
         <param name="classContext">
@@ -267,12 +282,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a type is marked with the <see cref="T:System.Runtime.InteropServices.ComImportAttribute" />, or derives from a type marked with the <see cref="T:System.Runtime.InteropServices.ComImportAttribute" /> and shares the same GUID as the parent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a type is marked with the <see cref="T:System.Runtime.InteropServices.ComImportAttribute" />, or derives from a type marked with the <see cref="T:System.Runtime.InteropServices.ComImportAttribute" /> and shares the same GUID as the parent; otherwise false.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to check for being a COM type. </param>
       </Docs>
@@ -293,12 +311,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified type requires registration.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the type must be registered for use from COM; otherwise false.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to check for COM registration requirements. </param>
       </Docs>
@@ -319,7 +340,6 @@
         <Parameter Name="assembly" Type="System.Reflection.Assembly" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>UnregisterAssembly removes the registry entries for the types in the specified assembly previously added by <see cref="M:System.Runtime.InteropServices.RegistrationServices.RegisterAssembly(System.Reflection.Assembly,System.Runtime.InteropServices.AssemblyRegistrationFlags)" />. This method also calls any unregistration functions found in the assembly.</para>
@@ -328,6 +348,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Unregisters the classes in a managed assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="assembly" /> contains types that were successfully unregistered; otherwise false if the assembly contains no eligible types.</para>
+        </returns>
         <param name="assembly">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly to be unregistered. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/RuntimeEnvironment.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/RuntimeEnvironment.xml
index 73eee8e16ad..8bc6a818d4f 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/RuntimeEnvironment.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/RuntimeEnvironment.xml
@@ -62,12 +62,15 @@
         <Parameter Name="a" Type="System.Reflection.Assembly" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether the specified assembly is loaded in the global assembly cache.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the assembly is loaded in the global assembly cache; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly to test. </param>
       </Docs>
@@ -86,12 +89,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the directory where the common language runtime is installed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the path to the directory where the common language runtime is installed.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetSystemVersion">
@@ -113,12 +119,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the version number of the common language runtime that is running the current process.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the version number of the common language runtime.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SystemConfigurationFile">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/SEHException.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/SEHException.xml
index 81128163849..b15f036efaf 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/SEHException.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/SEHException.xml
@@ -286,7 +286,6 @@ End Try</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <see cref="M:System.Runtime.InteropServices.SEHException.CanResume" /> returns true, then a filtered exception handler can correct the problem that caused the exception, and the code will continue from the point at which the exception was thrown.</para>
@@ -295,6 +294,10 @@ End Try</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the exception can be recovered from, and whether the code can continue from the point at which the exception was thrown.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always false, because resumable exceptions are not implemented.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/SafeBuffer.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/SafeBuffer.xml
index 015ff415a93..c6d793ce08f 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/SafeBuffer.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/SafeBuffer.xml
@@ -235,12 +235,15 @@
         <Parameter Name="byteOffset" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a value type from memory at the specified offset.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value type that was read from memory.</para>
+        </returns>
         <param name="byteOffset">
           <attribution license="cc4" from="Microsoft" modified="false" />The location from which to read the value type. You may have to consider alignment issues.</param>
         <typeparam name="T">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/SafeHandle.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/SafeHandle.xml
index c20e494685c..56b8c63386b 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/SafeHandle.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/SafeHandle.xml
@@ -140,7 +140,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use this method to retrieve the actual handle value from an instance of the <see cref="T:System.Runtime.InteropServices.SafeHandle" /> derived class. This method is needed for backwards compatibility because many properties in the .NET Framework return IntPtr handle types. IntPtr handle types are platform-specific types used to represent a pointer or a handle.</para>
@@ -152,6 +151,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the <see cref="F:System.Runtime.InteropServices.SafeHandle.handle" /> field.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An IntPtr representing the value of the <see cref="F:System.Runtime.InteropServices.SafeHandle.handle" /> field. If the handle has been marked invalid with <see cref="M:System.Runtime.InteropServices.SafeHandle.SetHandleAsInvalid" />, this method still returns the original handle value, which can be a stale value.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DangerousRelease">
@@ -378,7 +381,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Runtime.InteropServices.SafeHandle.ReleaseHandle" /> method is guaranteed to be called only once and only if the handle is valid as defined by the <see cref="P:System.Runtime.InteropServices.SafeHandle.IsInvalid" /> property. Implement this method in your <see cref="T:System.Runtime.InteropServices.SafeHandle" /> derived classes to execute any code that is required to free the handle. Because one of the functions of <see cref="T:System.Runtime.InteropServices.SafeHandle" /> is to guarantee prevention of resource leaks, the code in your implementation of <see cref="M:System.Runtime.InteropServices.SafeHandle.ReleaseHandle" /> must never fail. The garbage collector calls <see cref="M:System.Runtime.InteropServices.SafeHandle.ReleaseHandle" /> after normal finalizers have been run for objects that were garbage collected at the same time. The garbage collector guarantees the resources to invoke this method and that the method will not be interrupted while it is in progress. This method will be prepared as a constrained execution region (CER) at instance construction time (along with all the methods in its statically determinable call graph). Although this prevents thread abort interrupts, you must still be careful not to introduce any fault paths in your overridden <see cref="M:System.Runtime.InteropServices.SafeHandle.ReleaseHandle" /> method. In particular, apply the <see cref="T:System.Runtime.ConstrainedExecution.ReliabilityContractAttribute" /> attribute to any methods you call from <see cref="M:System.Runtime.InteropServices.SafeHandle.ReleaseHandle" />. In most cases this code should be:</para>
@@ -390,6 +392,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, executes the code required to free the handle.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the handle is released successfully; otherwise, in the event of a catastrophic failure, false. In this case, it generates a <format type="text/html"><a href="44cd98ba-95e5-40a1-874d-e8e163612c51">ReleaseHandleFailed</a></format> Managed Debugging Assistant.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SetHandle">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/TypeLibConverter.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/TypeLibConverter.xml
index fdf475e1d16..d3ba97f506c 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/TypeLibConverter.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/TypeLibConverter.xml
@@ -75,7 +75,6 @@
         <Parameter Name="notifySink" Type="System.Runtime.InteropServices.ITypeLibExporterNotifySink" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information on ITypeLib, please see its existing documentation in the MSDN library.</para>
@@ -84,6 +83,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an assembly to a COM type library.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that implements the ITypeLib interface.</para>
+        </returns>
         <param name="assembly">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly to convert. </param>
         <param name="strTypeLibName">
@@ -116,7 +119,6 @@
         <Parameter Name="unsafeInterfaces" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.Emit.AssemblyBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you do not want to generate a strong name for your assembly, it is valid for <paramref name="publicKey" /> and <paramref name="keyPair" /> to be null, as long as <paramref name="flags" /> does not equal <see cref="F:System.Runtime.InteropServices.TypeLibImporterFlags.PrimaryInteropAssembly" />. Otherwise, at least one of these parameters must be specified. If <paramref name="publicKey" /> is null, the public key in <paramref name="keyPair" /> will be set in the target assembly's manifest metadata and a signature will be generated based on the contents of the assembly. If <paramref name="keyPair" /> is null, <paramref name="publicKey" /> will be set in the target assembly's manifest metadata and no signature will be generated. Specifying both parameters is not generally useful, and can result in an invalid signature.</para>
@@ -126,6 +128,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a COM type library to an assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Reflection.Emit.AssemblyBuilder" /> object containing the converted type library.</para>
+        </returns>
         <param name="typeLib">
           <attribution license="cc4" from="Microsoft" modified="false" />The object that implements the ITypeLib interface. </param>
         <param name="asmFileName">
@@ -166,7 +172,6 @@
         <Parameter Name="asmVersion" Type="System.Version" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.Emit.AssemblyBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you do not want to generate a strong name for your assembly, it is valid for <paramref name="publicKey" /> and <paramref name="keyPair" /> to be null, as long as <paramref name="flags" /> does not equal <see cref="F:System.Runtime.InteropServices.TypeLibImporterFlags.PrimaryInteropAssembly" />. Otherwise, atleast one of these parameters must be specified. If <paramref name="publicKey" /> is null, the public key in <paramref name="keyPair" /> will be set in the target assembly's manifest metadata and a signature will be generated based on the contents of the assembly. If <paramref name="keyPair" /> is null, <paramref name="publicKey" /> will be set in the target assembly's manifest metadata and no signature will be generated. Specifying both parameters is not generally useful, and can result in an invalid signature.</para>
@@ -176,6 +181,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a COM type library to an assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Reflection.Emit.AssemblyBuilder" /> object containing the converted type library.</para>
+        </returns>
         <param name="typeLib">
           <attribution license="cc4" from="Microsoft" modified="false" />The object that implements the ITypeLib interface. </param>
         <param name="asmFileName">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMIEnumConnectionPoints.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMIEnumConnectionPoints.xml
index dd8fe23bedd..f390143c4ea 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMIEnumConnectionPoints.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMIEnumConnectionPoints.xml
@@ -94,7 +94,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information about IEnumConnectionPoints::Reset, see the MSDN Library.</para>
@@ -103,6 +102,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resets the enumeration sequence to the beginning.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An HRESULT with the value S_OK.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Skip">
@@ -121,7 +124,6 @@
         <Parameter Name="celt" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information about IEnumConnectionPoints::Skip, see the MSDN Library.</para>
@@ -130,6 +132,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Skips over a specified number of items in the enumeration sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>S_OK if the number of elements skipped equals the <paramref name="celt" /> parameter; otherwise, S_FALSE.</para>
+        </returns>
         <param name="celt">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of elements to skip in the enumeration. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMIEnumConnections.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMIEnumConnections.xml
index 7910d7c58be..02741eebfdb 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMIEnumConnections.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMIEnumConnections.xml
@@ -102,6 +102,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resets the enumeration sequence to the beginning.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An HRESULT with the value S_OK.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Skip">
@@ -120,7 +124,6 @@
         <Parameter Name="celt" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information about IEnumConnections::Skip, see the MSDN Library.</para>
@@ -129,6 +132,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Skips over a specified number of items in the enumeration sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>S_OK if the number of elements skipped equals the <paramref name="celt" /> parameter; otherwise, S_FALSE.</para>
+        </returns>
         <param name="celt">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of elements to skip in the enumeration. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMIEnumMoniker.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMIEnumMoniker.xml
index c010333491a..2cc3ec2b9be 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMIEnumMoniker.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMIEnumMoniker.xml
@@ -94,7 +94,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information about IEnumMoniker::Reset, see the MSDN Library.</para>
@@ -103,6 +102,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resets the enumeration sequence to the beginning.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An HRESULT with the value S_OK.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Skip">
@@ -121,7 +124,6 @@
         <Parameter Name="celt" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information about IEnumMoniker::Skip, see the MSDN Library.</para>
@@ -130,6 +132,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Skips over a specified number of items in the enumeration sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>S_OK if the number of elements skipped equals the <paramref name="celt" /> parameter; otherwise, S_FALSE.</para>
+        </returns>
         <param name="celt">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of elements to skip in the enumeration. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMIEnumString.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMIEnumString.xml
index 68b2a37e11c..490ee713f46 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMIEnumString.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMIEnumString.xml
@@ -94,7 +94,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information about IEnumString::Reset, see the MSDN Library.</para>
@@ -103,6 +102,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resets the enumeration sequence to the beginning.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An HRESULT with the value S_OK.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Skip">
@@ -121,7 +124,6 @@
         <Parameter Name="celt" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information about IEnumString::Skip, see the MSDN Library.</para>
@@ -130,6 +132,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Skips over a specified number of items in the enumeration sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>S_OK if the number of elements skipped equals the <paramref name="celt" /> parameter; otherwise, S_FALSE.</para>
+        </returns>
         <param name="celt">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of elements to skip in the enumeration. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMIEnumVARIANT.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMIEnumVARIANT.xml
index 50deed3db54..3a9470e2618 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMIEnumVARIANT.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMIEnumVARIANT.xml
@@ -79,7 +79,6 @@
         <Parameter Name="pceltFetched" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information about IEnumVARIANT::Next, see the MSDN Library.</para>
@@ -88,6 +87,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a specified number of items in the enumeration sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>S_OK if the <paramref name="pceltFetched" /> parameter equals the <paramref name="celt" /> parameter; otherwise, S_FALSE.</para>
+        </returns>
         <param name="celt">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of elements to return in <paramref name="rgelt" />. </param>
         <param name="rgvar">
@@ -110,7 +113,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information about IEnumVARIANT::Reset, see the MSDN Library.</para>
@@ -119,6 +121,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resets the enumeration sequence to the beginning.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An HRESULT with the value S_OK.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Skip">
@@ -137,7 +143,6 @@
         <Parameter Name="celt" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information about IEnumVARIANT::Skip, see the MSDN Library.</para>
@@ -146,6 +151,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Skips over a specified number of items in the enumeration sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>S_OK if the number of elements skipped equals <paramref name="celt" /> parameter; otherwise, S_FALSE.</para>
+        </returns>
         <param name="celt">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of elements to skip in the enumeration. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMIMoniker.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMIMoniker.xml
index 76bbccea8e6..449899baf66 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMIMoniker.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMIMoniker.xml
@@ -306,7 +306,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information about IPersistStream::IsDirty, see the MSDN Library.</para>
@@ -315,6 +314,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks the object for changes since it was last saved.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An S_OK HRESULT value if the object has changed; otherwise, an S_FALSE HRESULT value.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsEqual">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMIPersistFile.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMIPersistFile.xml
index 30f87435fec..8095fb50014 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMIPersistFile.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMIPersistFile.xml
@@ -89,7 +89,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information, please see the existing documentation for IPersistFile::IsDirty in the MSDN library.</para>
@@ -98,6 +97,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks an object for changes since it was last saved to its current file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>S_OK if the file has changed since it was last saved; S_FALSE if the file has not changed since it was last saved.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Load">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMITypeLib.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMITypeLib.xml
index 81b84c57a93..50821af244f 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMITypeLib.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/UCOMITypeLib.xml
@@ -170,7 +170,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For additional information about ITypeLib::GetTypeInfoCount, see the MSDN Library.</para>
@@ -179,6 +178,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of type descriptions in the type library.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of type descriptions in the type library.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetTypeInfoOfGuid">
@@ -244,7 +247,6 @@
         <Parameter Name="lHashVal" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For additional information about ITypeLib::IsName, see the MSDN Library.</para>
@@ -253,6 +255,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a passed-in string contains the name of a type or member described in the library.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="szNameBuf" /> was found in the type library; otherwise false.</para>
+        </returns>
         <param name="szNameBuf">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to test. </param>
         <param name="lHashVal">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_Assembly.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_Assembly.xml
index dd69a4c2567..f7fe835c8cd 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_Assembly.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_Assembly.xml
@@ -80,7 +80,6 @@
         <Parameter Name="typeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -90,6 +89,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.CreateInstance(System.String)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Object" /> representing the type, with culture, arguments, binder, and activation attributes set to null, and <see cref="T:System.Reflection.BindingFlags" /> set to Public or Instance, or null if <paramref name="typeName" /> is not found.</para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Type.FullName" /> of the type to locate.</param>
       </Docs>
@@ -112,7 +115,6 @@
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -122,6 +124,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.CreateInstance(System.String,System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of <see cref="T:System.Object" /> representing the type, with culture, arguments, binder, and activation attributes set to null, and <see cref="T:System.Reflection.BindingFlags" /> set to Public or Instance, or null if <paramref name="typeName" /> is not found.</para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Type.FullName" /> of the type to locate. </param>
         <param name="ignoreCase">
@@ -151,7 +157,6 @@
         <Parameter Name="activationAttributes" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -161,6 +166,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.CreateInstance(System.String,System.Boolean,System.Reflection.BindingFlags,System.Reflection.Binder,System.Object[],System.Globalization.CultureInfo,System.Object[])" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of Object representing the type and matching the specified criteria, or null if <paramref name="typeName" /> is not found.</para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="P:System.Type.FullName" /> of the type to locate. </param>
         <param name="ignoreCase">
@@ -220,7 +229,6 @@
         <Parameter Name="other" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -230,6 +238,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.Equals(System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Object" />; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to compare with the current <see cref="T:System.Object" />.</param>
       </Docs>
@@ -329,7 +341,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -339,6 +350,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.GetCustomAttributes(System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type Object containing the custom attributes for this assembly.</para>
+        </returns>
         <param name="inherit">
           <attribution license="cc4" from="Microsoft" modified="false" />This argument is ignored for objects of type <see cref="T:System.Reflection.Assembly" />.</param>
       </Docs>
@@ -361,7 +376,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -371,6 +385,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.GetCustomAttributes(System.Type,System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Object" /> containing the custom attributes for this assembly as specified by <paramref name="attributeType" />.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> for which the custom attributes are to be returned. </param>
         <param name="inherit">
@@ -392,7 +410,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -402,6 +419,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.GetExportedTypes" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Type" /> objects that represent the types defined in this assembly that are visible outside the assembly.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -421,7 +442,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -431,6 +451,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.GetFile(System.String)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.FileStream" /> for the specified file, or null if the file is not found.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the specified file. Do not include the path to the file.</param>
       </Docs>
@@ -450,7 +474,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -460,6 +483,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.GetFiles" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.IO.FileStream" /> objects.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -479,7 +506,6 @@
         <Parameter Name="getResourceModules" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -489,6 +515,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.GetFiles(System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.IO.FileStream" /> objects.</para>
+        </returns>
         <param name="getResourceModules">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include resource modules; otherwise, false.</param>
       </Docs>
@@ -508,7 +538,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -518,6 +547,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.GetHashCode" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.Object" />.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -535,7 +568,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -545,6 +577,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.GetLoadedModules" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of modules.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -564,7 +600,6 @@
         <Parameter Name="getResourceModules" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -574,6 +609,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.GetLoadedModules(System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of modules.</para>
+        </returns>
         <param name="getResourceModules">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include resource modules; otherwise, false.</param>
       </Docs>
@@ -595,7 +634,6 @@
         <Parameter Name="resourceName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -605,6 +643,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.GetManifestResourceInfo(System.String)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.ManifestResourceInfo" /> object populated with information about the resource's topology, or null if the resource is not found.</para>
+        </returns>
         <param name="resourceName">
           <attribution license="cc4" from="Microsoft" modified="false" />The case-sensitive name of the resource.</param>
       </Docs>
@@ -624,7 +666,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -634,6 +675,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.GetManifestResourceNames" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type String containing the names of all the resources.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -653,7 +698,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -663,6 +707,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.GetManifestResourceStream(System.String)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> representing this manifest resource.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The case-sensitive name of the manifest resource being requested.</param>
       </Docs>
@@ -685,7 +733,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -695,6 +742,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.GetManifestResourceStream(System.Type,System.String)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.IO.Stream" /> representing this manifest resource.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type whose namespace is used to scope the manifest resource name. </param>
         <param name="name">
@@ -718,7 +769,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -728,6 +778,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.GetModule(System.String)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The module being requested, or null if the module is not found.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the module being requested.</param>
       </Docs>
@@ -747,7 +801,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -757,6 +810,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.GetModules" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of modules.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -776,7 +833,6 @@
         <Parameter Name="getResourceModules" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -786,6 +842,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.GetModules(System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of modules.</para>
+        </returns>
         <param name="getResourceModules">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include resource modules; otherwise, false.</param>
       </Docs>
@@ -805,7 +865,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -815,6 +874,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.GetName" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Reflection.AssemblyName" /> for this assembly.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -834,7 +897,6 @@
         <Parameter Name="copiedName" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -844,6 +906,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.GetName(System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Reflection.AssemblyName" /> for this assembly.</para>
+        </returns>
         <param name="copiedName">
           <attribution license="cc4" from="Microsoft" modified="false" />true to set the <see cref="P:System.Reflection.Assembly.CodeBase" /> to the location of the assembly after it was shadow copied; false to set <see cref="P:System.Reflection.Assembly.CodeBase" /> to the original location.</param>
       </Docs>
@@ -896,7 +962,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -906,6 +971,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.GetReferencedAssemblies" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Reflection.AssemblyName" /> containing all the assemblies referenced by this assembly.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -925,7 +994,6 @@
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -935,6 +1003,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.GetSatelliteAssembly(System.Globalization.CultureInfo)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified satellite assembly.</para>
+        </returns>
         <param name="culture">
           <attribution license="cc4" from="Microsoft" modified="false" />The specified culture.</param>
       </Docs>
@@ -957,7 +1029,6 @@
         <Parameter Name="version" Type="System.Version" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -967,6 +1038,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.GetSatelliteAssembly(System.Globalization.CultureInfo,System.Version)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified satellite assembly.</para>
+        </returns>
         <param name="culture">
           <attribution license="cc4" from="Microsoft" modified="false" />The specified culture. </param>
         <param name="version">
@@ -988,7 +1063,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -998,6 +1072,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.GetType" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -1017,7 +1095,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1027,6 +1104,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.GetType(System.String)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object that represents the specified class, or null if the class is not found.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The full name of the type.</param>
       </Docs>
@@ -1049,7 +1130,6 @@
         <Parameter Name="throwOnError" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1059,6 +1139,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.GetType(System.String,System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object that represents the specified class.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The full name of the type. </param>
         <param name="throwOnError">
@@ -1084,7 +1168,6 @@
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1094,6 +1177,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.GetType(System.String,System.Boolean,System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object that represents the specified class.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The full name of the type. </param>
         <param name="throwOnError">
@@ -1117,7 +1204,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1127,6 +1213,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.GetTypes" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Type" /> containing objects for all the types defined in this assembly.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -1173,7 +1263,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1183,6 +1272,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.IsDefined(System.Type,System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a custom attribute identified by the specified <see cref="T:System.Type" /> is defined; otherwise, false.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the custom attribute to be checked for this assembly. </param>
         <param name="inherit">
@@ -1207,7 +1300,6 @@
         <Parameter Name="rawModule" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1217,6 +1309,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.LoadModule(System.String,System.Byte[])" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded Module.</para>
+        </returns>
         <param name="moduleName">
           <attribution license="cc4" from="Microsoft" modified="false" />Name of the module. Must correspond to a file name in this assembly's manifest. </param>
         <param name="rawModule">
@@ -1242,7 +1338,6 @@
         <Parameter Name="rawSymbolStore" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1252,6 +1347,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.LoadModule(System.String,System.Byte[],System.Byte[])" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded module.</para>
+        </returns>
         <param name="moduleName">
           <attribution license="cc4" from="Microsoft" modified="false" />Name of the module. Must correspond to a file name in this assembly's manifest. </param>
         <param name="rawModule">
@@ -1326,7 +1425,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1336,6 +1434,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.ToString" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The full name of the assembly, or the class name if the full name of the assembly cannot be determined.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_ConstructorInfo.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_ConstructorInfo.xml
index ae047d17120..96f37cf12b6 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_ConstructorInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_ConstructorInfo.xml
@@ -133,7 +133,6 @@
         <Parameter Name="other" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -143,6 +142,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.Equals(System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Object" />; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to compare with the current <see cref="T:System.Object" />.</param>
       </Docs>
@@ -164,7 +167,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -174,6 +176,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MemberInfo.GetCustomAttributes(System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains all the custom attributes, or an array with zero elements if no attributes are defined.</para>
+        </returns>
         <param name="inherit">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies whether to search this member's inheritance chain to find the attributes.</param>
       </Docs>
@@ -196,7 +202,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -206,6 +211,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Emit.MethodBuilder.GetCustomAttributes(System.Type,System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of custom attributes applied to this member, or an array with zero (0) elements if no attributes have been applied.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of attribute to search for. Only attributes that are assignable to this type are returned. </param>
         <param name="inherit">
@@ -227,7 +236,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -237,6 +245,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.GetHashCode" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the current instance.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -284,7 +296,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -294,6 +305,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MethodBase.GetMethodImplementationFlags" /> member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Reflection.MethodImplAttributes" /> flags.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -311,7 +326,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -321,6 +335,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MethodBase.GetParameters" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Reflection.ParameterInfo" /> containing information that matches the signature of the method (or constructor) reflected by this instance.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -338,7 +356,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -348,6 +365,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.GetType" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -464,7 +485,6 @@
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -474,6 +494,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MethodBase.Invoke(System.Object,System.Reflection.BindingFlags,System.Reflection.Binder,System.Object[],System.Globalization.CultureInfo)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the class associated with the constructor.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The instance that created this method.</param>
         <param name="invokeAttr">
@@ -504,7 +528,6 @@
         <Parameter Name="parameters" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -514,6 +537,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MethodBase.Invoke(System.Object,System.Object[])" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the class associated with the constructor.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The instance that created this method. </param>
         <param name="parameters">
@@ -540,7 +567,6 @@
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -550,6 +576,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.ConstructorInfo.Invoke(System.Reflection.BindingFlags,System.Reflection.Binder,System.Object[],System.Globalization.CultureInfo)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the class associated with the constructor.</para>
+        </returns>
         <param name="invokeAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the BindingFlags values that specifies the type of binding. </param>
         <param name="binder">
@@ -577,7 +607,6 @@
         <Parameter Name="parameters" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -587,6 +616,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.ConstructorInfo.Invoke(System.Object[])" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the class associated with the constructor.</para>
+        </returns>
         <param name="parameters">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of values that matches the number, order, and type (under the constraints of the default binder) of the parameters for this constructor. If this constructor takes no parameters, then use either an array with zero elements or null, as in Object[] parameters = new Object[0]. Any object in this array that is not explicitly initialized with a value will contain the default value for that object type. For reference-type elements, this value is null. For value-type elements, this value is 0, 0.0, or false, depending on the specific element type.</param>
       </Docs>
@@ -687,7 +720,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -697,6 +729,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MemberInfo.IsDefined(System.Type,System.Boolean)" /> member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if one or more instances of <paramref name="attributeType" /> is applied to this member; otherwise false.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The Type object to which the custom attributes are applied. </param>
         <param name="inherit">
@@ -1082,7 +1118,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1091,6 +1126,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.ToString" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Object" />.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_EventInfo.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_EventInfo.xml
index 2fb4c8aa8dd..7c7ee9e0ecf 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_EventInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_EventInfo.xml
@@ -139,7 +139,6 @@
         <Parameter Name="other" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -149,6 +148,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.Equals(System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Object" />; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to compare with the current <see cref="T:System.Object" />.</param>
       </Docs>
@@ -194,7 +197,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -204,6 +206,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.EventInfo.GetAddMethod" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodInfo" /> object representing the method used to add an event-handler delegate to the event source.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -223,7 +229,6 @@
         <Parameter Name="nonPublic" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -233,6 +238,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.EventInfo.GetAddMethod(System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodInfo" /> object representing the method used to add an event-handler delegate to the event source.</para>
+        </returns>
         <param name="nonPublic">
           <attribution license="cc4" from="Microsoft" modified="false" />true to return non-public methods; otherwise, false.</param>
       </Docs>
@@ -254,7 +263,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -264,6 +272,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MemberInfo.GetCustomAttributes(System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains all the custom attributes, or an array with zero (0) elements if no attributes are defined.</para>
+        </returns>
         <param name="inherit">
           <attribution license="cc4" from="Microsoft" modified="false" />true to search a member's inheritance chain to find the attributes; otherwise, false.</param>
       </Docs>
@@ -286,7 +298,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -296,6 +307,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MemberInfo.GetCustomAttributes(System.Type,System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of custom attributes applied to this member, or an array with zero (0) elements if no attributes have been applied.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of attribute to search for. Only attributes that are assignable to this type are returned. </param>
         <param name="inherit">
@@ -317,7 +332,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -327,6 +341,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.GetHashCode" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the current instance.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -374,7 +392,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -384,6 +401,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.EventInfo.GetRaiseMethod" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The method that is called when the event is raised.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -403,7 +424,6 @@
         <Parameter Name="nonPublic" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -413,6 +433,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.EventInfo.GetRaiseMethod(System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Reflection.MethodInfo" /> object that was called when the event was raised.</para>
+        </returns>
         <param name="nonPublic">
           <attribution license="cc4" from="Microsoft" modified="false" />true to return non-public methods; otherwise, false.</param>
       </Docs>
@@ -432,7 +456,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -442,6 +465,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.EventInfo.GetRemoveMethod" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodInfo" /> object representing the method used to remove an event-handler delegate from the event source.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -461,7 +488,6 @@
         <Parameter Name="nonPublic" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -471,6 +497,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.EventInfo.GetRemoveMethod(System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodInfo" /> object representing the method used to remove an event-handler delegate from the event source.</para>
+        </returns>
         <param name="nonPublic">
           <attribution license="cc4" from="Microsoft" modified="false" />true to return non-public methods; otherwise, false.</param>
       </Docs>
@@ -490,7 +520,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -500,6 +529,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.GetType" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -613,7 +646,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -623,6 +655,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MemberInfo.IsDefined(System.Type,System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if one or more instance of the <paramref name="attributeType" /> parameter is applied to this member; otherwise, false.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The Type object to which the custom attributes are applied. </param>
         <param name="inherit">
@@ -807,7 +843,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -816,6 +851,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.ToString" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Object" />.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_Exception.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_Exception.xml
index d2096da2503..b3c9c2df565 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_Exception.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_Exception.xml
@@ -50,7 +50,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -61,6 +60,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.Equals(System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Object" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to compare with the current <see cref="T:System.Object" />.</param>
       </Docs>
@@ -78,7 +81,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -89,6 +91,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Exception.GetBaseException" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first exception thrown in a chain of exceptions. If the <see cref="P:System.Exception.InnerException" /> property of the current exception is a null reference (Nothing in Visual Basic), this property returns the current exception.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -104,7 +110,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -115,6 +120,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.GetHashCode" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetObjectData">
@@ -162,7 +171,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -173,6 +181,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Exception.GetType" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object that represents the exact runtime type of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HelpLink">
@@ -338,7 +350,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -349,6 +360,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Exception.ToString" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Exception" /> object.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_FieldInfo.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_FieldInfo.xml
index 773f50e57c7..5b8ece18ee1 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_FieldInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_FieldInfo.xml
@@ -106,7 +106,6 @@
         <Parameter Name="other" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -116,6 +115,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.Equals(System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Object" />; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to compare with the current <see cref="T:System.Object" />.</param>
       </Docs>
@@ -189,7 +192,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -199,6 +201,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MemberInfo.GetCustomAttributes(System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains all the custom attributes, or an array with zero elements if no attributes are defined.</para>
+        </returns>
         <param name="inherit">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies whether to search this member's inheritance chain to find the attributes.</param>
       </Docs>
@@ -221,7 +227,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -231,6 +236,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MemberInfo.GetCustomAttributes(System.Type,System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of custom attributes applied to this member, or an array with zero (0) elements if no attributes have been applied.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of attribute to search for. Only attributes that are assignable to this type are returned. </param>
         <param name="inherit">
@@ -252,7 +261,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -262,6 +270,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.GetHashCode" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the current instance.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -309,7 +321,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -319,6 +330,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.GetType" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -395,7 +410,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -405,6 +419,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.FieldInfo.GetValue(System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object containing the value of the field reflected by this instance.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object whose field value will be returned.</param>
       </Docs>
@@ -426,7 +444,6 @@
         <Parameter Name="obj" Type="System.TypedReference" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -436,6 +453,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.FieldInfo.GetValueDirect(System.TypedReference)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> containing a field value.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.TypedReference" /> structure that encapsulates a managed pointer to a location and a runtime representation of the type that might be stored at that location.</param>
       </Docs>
@@ -520,7 +541,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -530,6 +550,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MemberInfo.IsDefined(System.Type,System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if one or more instance of <paramref name="attributeType" /> is applied to this member; otherwise, false.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> object to which the custom attributes are applied. </param>
         <param name="inherit">
@@ -1023,7 +1047,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1032,6 +1055,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.ToString" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Object" />.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_MemberInfo.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_MemberInfo.xml
index 98e7a8cb417..2f6e59661a4 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_MemberInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_MemberInfo.xml
@@ -80,7 +80,6 @@
         <Parameter Name="other" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -90,6 +89,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.Equals(System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Object" />; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to compare with the current <see cref="T:System.Object" />.</param>
       </Docs>
@@ -111,7 +114,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -121,6 +123,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MemberInfo.GetCustomAttributes(System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains all the custom attributes, or an array with zero (0) elements if no attributes are defined.</para>
+        </returns>
         <param name="inherit">
           <attribution license="cc4" from="Microsoft" modified="false" />true to search this member's inheritance chain to find the attributes; otherwise, false.</param>
       </Docs>
@@ -143,7 +149,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -153,6 +158,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.GetCustomAttributes(System.Type,System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of custom attributes applied to this member, or an array with zero (0) elements if no attributes have been applied.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of attribute to search for. Only attributes that are assignable to this type are returned. </param>
         <param name="inherit">
@@ -174,7 +183,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -184,6 +192,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.GetHashCode" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the current instance.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -231,7 +243,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -241,6 +252,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetType" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -354,7 +369,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -364,6 +378,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MemberInfo.IsDefined(System.Type,System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if one or more instance of the <paramref name="attributeType" /> parameter is applied to this member; otherwise, false.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> object to which the custom attributes are applied. </param>
         <param name="inherit">
@@ -463,7 +481,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -472,6 +489,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.ToString" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Object" />.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_MethodBase.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_MethodBase.xml
index ffd59740463..e45f020185a 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_MethodBase.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_MethodBase.xml
@@ -132,7 +132,6 @@
         <Parameter Name="other" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -142,6 +141,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.Equals(System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Object" />; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to compare with the current <see cref="T:System.Object" />.</param>
       </Docs>
@@ -163,7 +166,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -173,6 +175,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MemberInfo.GetCustomAttributes(System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains all the custom attributes, or an array with zero (0) elements if no attributes are defined.</para>
+        </returns>
         <param name="inherit">
           <attribution license="cc4" from="Microsoft" modified="false" />true to search this member's inheritance chain to find the attributes; otherwise, false.</param>
       </Docs>
@@ -195,7 +201,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -205,6 +210,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MemberInfo.GetCustomAttributes(System.Type,System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of custom attributes applied to this member, or an array with zero (0) elements if no attributes have been applied.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of attribute to search for. Only attributes that are assignable to this type are returned. </param>
         <param name="inherit">
@@ -226,7 +235,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -236,6 +244,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.GetHashCode" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the current instance.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -283,7 +295,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -293,6 +304,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MethodBase.GetMethodImplementationFlags" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Reflection.MethodImplAttributes" /> values.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -310,7 +325,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -320,6 +334,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MethodBase.GetParameters" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Reflection.ParameterInfo" /> containing information that matches the signature of the method (or constructor) reflected by this instance.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -337,7 +355,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -347,6 +364,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetType" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -424,7 +445,6 @@
         <Parameter Name="parameters" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -434,6 +454,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MethodBase.Invoke(System.Object,System.Object[])" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the class associated with the constructor.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The instance that created this method. </param>
         <param name="parameters">
@@ -461,7 +485,6 @@
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -471,6 +494,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MethodBase.Invoke(System.Object,System.Reflection.BindingFlags,System.Reflection.Binder,System.Object[],System.Globalization.CultureInfo)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the class associated with the constructor.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The instance that created this method.</param>
         <param name="invokeAttr">
@@ -615,7 +642,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -625,6 +651,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MemberInfo.IsDefined(System.Type,System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if one or more instance of the <paramref name="attributeType" /> parameter is applied to this member; otherwise, false.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The Type object to which the custom attributes are applied. </param>
         <param name="inherit">
@@ -1010,7 +1040,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -1019,6 +1048,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.ToString" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Object" />.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_MethodInfo.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_MethodInfo.xml
index 553637865b2..1ef47a83a53 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_MethodInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_MethodInfo.xml
@@ -132,7 +132,6 @@
         <Parameter Name="other" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -142,6 +141,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.Equals(System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Object" />; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to compare with the current <see cref="T:System.Object" />.</param>
       </Docs>
@@ -161,7 +164,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -171,6 +173,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MethodInfo.GetBaseDefinition" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodInfo" /> object for the first implementation of this method.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -190,7 +196,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -200,6 +205,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MemberInfo.GetCustomAttributes(System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains all the custom attributes, or an array with zero (0) elements if no attributes are defined.</para>
+        </returns>
         <param name="inherit">
           <attribution license="cc4" from="Microsoft" modified="false" />true to search this member's inheritance chain to find the attributes; otherwise, false.</param>
       </Docs>
@@ -222,7 +231,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -232,6 +240,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MemberInfo.GetCustomAttributes(System.Type,System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of custom attributes applied to this member, or an array with zero (0) elements if no attributes have been applied.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of attribute to search for. Only attributes that are assignable to this type are returned. </param>
         <param name="inherit">
@@ -253,7 +265,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -263,6 +274,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.GetHashCode" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the current instance.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -310,7 +325,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -320,6 +334,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MethodBase.GetMethodImplementationFlags" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Reflection.MethodImplAttributes" /> values.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -337,7 +355,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -347,6 +364,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MethodBase.GetParameters" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Reflection.ParameterInfo" /> containing information that matches the signature of the method (or constructor) reflected by this instance.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -364,7 +385,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -374,6 +394,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetType" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -451,7 +475,6 @@
         <Parameter Name="parameters" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Reflection.MethodBase.Invoke(System.Object,System.Object[])" /> method invokes the method or constructor represented by this object, using the specified parameters.</para>
@@ -460,6 +483,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MethodBase.Invoke(System.Object,System.Object[])" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the class associated with the constructor.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The instance that created this method. </param>
         <param name="parameters">
@@ -487,7 +514,6 @@
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -497,6 +523,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MethodBase.Invoke(System.Object,System.Reflection.BindingFlags,System.Reflection.Binder,System.Object[],System.Globalization.CultureInfo)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the class associated with the constructor.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The instance that created this method.</param>
         <param name="invokeAttr">
@@ -641,7 +671,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -651,6 +680,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MemberInfo.IsDefined(System.Type,System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if one or more instance of the <paramref name="attributeType" /> parameter is applied to this member; otherwise, false.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The Type object to which the custom attributes are applied. </param>
         <param name="inherit">
@@ -1088,7 +1121,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -1097,6 +1129,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.ToString" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Object" />.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_PropertyInfo.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_PropertyInfo.xml
index 5780aee2973..3dfff9e36b0 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_PropertyInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_PropertyInfo.xml
@@ -158,7 +158,6 @@
         <Parameter Name="other" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -168,6 +167,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.Equals(System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Object" />; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to compare with the current <see cref="T:System.Object" />.</param>
       </Docs>
@@ -187,7 +190,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -197,6 +199,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.PropertyInfo.GetAccessors" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.MethodInfo" /> objects that reflect the public get, set, and other accessors of the property reflected by the current instance, if accessors are found; otherwise, this method returns an array with zero (0) elements.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -216,7 +222,6 @@
         <Parameter Name="nonPublic" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -226,6 +231,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.PropertyInfo.GetAccessors(System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.MethodInfo" /> objects whose elements reflect the get, set, and other accessors of the property reflected by the current instance. If the <paramref name="nonPublic" /> parameter is true, this array contains public and non-public get, set, and other accessors. If <paramref name="nonPublic" /> is false, this array contains only public get, set, and other accessors. If no accessors with the specified visibility are found, this method returns an array with zero (0) elements.</para>
+        </returns>
         <param name="nonPublic">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include non-public methods in the returned MethodInfo array; otherwise, false.</param>
       </Docs>
@@ -247,7 +256,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -257,6 +265,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MemberInfo.GetCustomAttributes(System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains all the custom attributes, or an array with zero elements if no attributes are defined.</para>
+        </returns>
         <param name="inherit">
           <attribution license="cc4" from="Microsoft" modified="false" />true to search this member's inheritance chain to find the attributes; otherwise false.</param>
       </Docs>
@@ -279,7 +291,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -289,6 +300,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MemberInfo.GetCustomAttributes(System.Type,System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of custom attributes applied to this member, or an array with zero (0) elements if no attributes have been applied.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of attribute to search for. Only attributes that are assignable to this type are returned. </param>
         <param name="inherit">
@@ -310,7 +325,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -320,6 +334,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.PropertyInfo.GetGetMethod" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodInfo" /> object representing the public get accessor for this property, or null if the get accessor is non-public or does not exist.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -339,7 +357,6 @@
         <Parameter Name="nonPublic" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -349,6 +366,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.PropertyInfo.GetGetMethod(System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodInfo" /> object representing the get accessor for this property, if the <paramref name="nonPublic" /> parameter is true. Or null if <paramref name="nonPublic" /> is false and the get accessor is non-public, or if <paramref name="nonPublic" /> is true but no get accessors exist.</para>
+        </returns>
         <param name="nonPublic">
           <attribution license="cc4" from="Microsoft" modified="false" />true to return a non-public get accessor; otherwise, false.</param>
       </Docs>
@@ -368,7 +389,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -378,6 +398,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.GetHashCode" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the current instance.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -425,7 +449,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -435,6 +458,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.PropertyInfo.GetIndexParameters" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Reflection.ParameterInfo" /> containing the parameters for the indexes.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -452,7 +479,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -462,6 +488,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.PropertyInfo.GetSetMethod" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Reflection.MethodInfo" /> object representing the Set method for this property if the set accessor is public, or null if the set accessor is not public.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -481,7 +511,6 @@
         <Parameter Name="nonPublic" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -491,6 +520,44 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.PropertyInfo.GetSetMethod(System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the values in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Meaning </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>A <see cref="T:System.Reflection.MethodInfo" /> object representing the Set method for this property. </para>
+              </term>
+              <description>
+                <para>The set accessor is public.</para>
+                <para>-or- </para>
+                <para>The <paramref name="nonPublic" /> parameter is true and the set accessor is non-public. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>null </para>
+              </term>
+              <description>
+                <para>The <paramref name="nonPublic" /> parameter is true, but the property is read-only.</para>
+                <para>-or- </para>
+                <para>The <paramref name="nonPublic" /> parameter is false and the set accessor is non-public.</para>
+                <para>-or- </para>
+                <para>There is no set accessor. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="nonPublic">
           <attribution license="cc4" from="Microsoft" modified="false" />true to return a non-public accessor; otherwise, false.</param>
       </Docs>
@@ -510,7 +577,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -520,6 +586,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.GetType" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -597,7 +667,6 @@
         <Parameter Name="index" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -607,6 +676,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.PropertyInfo.GetValue(System.Object,System.Object[])" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The property value for the <paramref name="obj" /> parameter.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object whose property value will be returned. </param>
         <param name="index">
@@ -634,7 +707,6 @@
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -644,6 +716,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.PropertyInfo.GetValue(System.Object,System.Reflection.BindingFlags,System.Reflection.Binder,System.Object[],System.Globalization.CultureInfo)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The property value for the <paramref name="obj" /> parameter.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object whose property value will be returned. </param>
         <param name="invokeAttr">
@@ -710,7 +786,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -720,6 +795,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MemberInfo.IsDefined(System.Type,System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if one or more instances of the <paramref name="attributeType" /> parameter are applied to this member; otherwise, false.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> object to which the custom attributes are applied. </param>
         <param name="inherit">
@@ -952,7 +1031,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code and should not be called from managed code.</para>
@@ -961,6 +1039,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Object.ToString" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current <see cref="T:System.Object" />.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_Type.xml b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_Type.xml
index 5106fb9e362..a45566669b9 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_Type.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.InteropServices/_Type.xml
@@ -184,7 +184,6 @@
         <Parameter Name="other" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -194,6 +193,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.Equals(System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the underlying system type of <paramref name="o" /> is the same as the underlying system type of the current <see cref="T:System.Type" />; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> whose underlying system type is to be compared with the underlying system type of the current <see cref="T:System.Type" />.</param>
       </Docs>
@@ -215,7 +218,6 @@
         <Parameter Name="o" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -225,6 +227,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.Equals(System.Type)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the underlying system type of <paramref name="o" /> is the same as the underlying system type of the current <see cref="T:System.Type" />; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> whose underlying system type is to be compared with the underlying system type of the current <see cref="T:System.Type" />.</param>
       </Docs>
@@ -247,7 +253,6 @@
         <Parameter Name="filterCriteria" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -257,6 +262,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.FindInterfaces(System.Reflection.TypeFilter,System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Type" /> objects representing a filtered list of the interfaces implemented or inherited by the current <see cref="T:System.Type" />.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Type" />, if no interfaces matching the filter are implemented or inherited by the current <see cref="T:System.Type" />.</para>
+        </returns>
         <param name="filter">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.TypeFilter" /> delegate that compares the interfaces against <paramref name="filterCriteria" />. </param>
         <param name="filterCriteria">
@@ -283,7 +294,6 @@
         <Parameter Name="filterCriteria" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -293,6 +303,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.FindMembers(System.Reflection.MemberTypes,System.Reflection.BindingFlags,System.Reflection.MemberFilter,System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A filtered array of <see cref="T:System.Reflection.MemberInfo" /> objects of the specified member type.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Reflection.MemberInfo" />, if the current <see cref="T:System.Type" /> does not have members of type <paramref name="memberType" /> that match the filter criteria.</para>
+        </returns>
         <param name="memberType">
           <attribution license="cc4" from="Microsoft" modified="false" />A MemberTypes object indicating the type of member to search for. </param>
         <param name="bindingAttr">
@@ -344,7 +360,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -354,6 +369,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetArrayRank" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Int32" /> containing the number of dimensions in the current <see cref="T:System.Type" />.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -373,7 +392,6 @@
         <Parameter Name="types" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -383,6 +401,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetConstructor(System.Type[])" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.ConstructorInfo" /> object representing the public instance constructor whose parameters match the types in the parameter type array, if found; otherwise, null.</para>
+        </returns>
         <param name="types">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Type" /> objects representing the number, order, and type of the parameters for the desired constructor.</param>
       </Docs>
@@ -407,7 +429,6 @@
         <Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -417,6 +438,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetConstructor(System.Reflection.BindingFlags,System.Reflection.Binder,System.Type[],System.Reflection.ParameterModifier[])" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.ConstructorInfo" /> object representing the constructor that matches the specified requirements, if found; otherwise, null.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitmask comprised of one or more <see cref="T:System.Reflection.BindingFlags" /> that specify how the search is conducted.</param>
         <param name="binder">
@@ -448,7 +473,6 @@
         <Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -458,6 +482,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetConstructor(System.Reflection.BindingFlags,System.Reflection.Binder,System.Reflection.CallingConventions,System.Type[],System.Reflection.ParameterModifier[])" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.ConstructorInfo" /> object representing the constructor that matches the specified requirements, if found; otherwise, null.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitmask comprised of one or more <see cref="T:System.Reflection.BindingFlags" /> that specify how the search is conducted.</param>
         <param name="binder">
@@ -485,7 +513,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -495,6 +522,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetConstructors" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.ConstructorInfo" /> objects representing all the public instance constructors defined for the current <see cref="T:System.Type" />, but not including the type initializer (static constructor). If no public instance constructors are defined for the current <see cref="T:System.Type" />, or if the current <see cref="T:System.Type" /> represents a type parameter of a generic type or method definition, an empty array of type <see cref="T:System.Reflection.ConstructorInfo" /> is returned.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -514,7 +545,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -524,6 +554,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetConstructors(System.Reflection.BindingFlags)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.ConstructorInfo" /> objects representing all constructors defined for the current <see cref="T:System.Type" /> that match the specified binding constraints, including the type initializer if it is defined. Returns an empty array of type <see cref="T:System.Reflection.ConstructorInfo" /> if no constructors are defined for the current <see cref="T:System.Type" />, if none of the defined constructors match the binding constraints, or if the current <see cref="T:System.Type" /> represents a type parameter of a generic type or method definition.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitmask comprised of one or more <see cref="T:System.Reflection.BindingFlags" /> that specify how the search is conducted.</param>
       </Docs>
@@ -545,7 +579,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -555,6 +588,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.Assembly.GetCustomAttributes(System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of custom attributes applied to this member, or an array with zero (0) elements if no attributes have been applied.</para>
+        </returns>
         <param name="inherit">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies whether to search this member's inheritance chain to find the attributes.</param>
       </Docs>
@@ -577,7 +614,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -587,6 +623,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MemberInfo.GetCustomAttributes(System.Type,System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of custom attributes applied to this member, or an array with zero (0) elements if no attributes have been applied.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of attribute to search for. Only attributes that are assignable to this type are returned. </param>
         <param name="inherit">
@@ -608,7 +648,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -618,6 +657,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetDefaultMembers" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.MemberInfo" /> objects representing all default members of the current <see cref="T:System.Type" />.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Reflection.MemberInfo" />, if the current <see cref="T:System.Type" /> does not have default members.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -635,7 +680,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -645,6 +689,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetElementType" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> of the object encompassed or referred to by the current array, pointer or reference type.</para>
+          <para>-or- </para>
+          <para>null if the current <see cref="T:System.Type" /> is not an array or a pointer, or is not passed by reference, or represents a generic type or a type parameter of a generic type or method definition.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -664,7 +714,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -674,6 +723,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetEvent(System.String)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.EventInfo" /> objects representing all events that are declared or inherited by the current <see cref="T:System.Type" /> that match the specified binding constraints.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Reflection.EventInfo" />, if the current <see cref="T:System.Type" /> does not have events, or if none of the events match the binding constraints.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitmask comprised of one or more <see cref="T:System.Reflection.BindingFlags" /> that specify how the search is conducted.</param>
       </Docs>
@@ -696,7 +751,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -706,6 +760,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetEvent(System.String,System.Reflection.BindingFlags)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Reflection.EventInfo" /> object representing the specified event that is declared or inherited by the current <see cref="T:System.Type" />, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the name of an event that is declared or inherited by the current <see cref="T:System.Type" />. </param>
         <param name="bindingAttr">
@@ -727,7 +785,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -737,6 +794,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetEvents" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.EventInfo" /> objects representing all the public events that are declared or inherited by the current <see cref="T:System.Type" />.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Reflection.EventInfo" />, if the current <see cref="T:System.Type" /> does not have public events.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -756,7 +819,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -766,6 +828,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetEvents(System.Reflection.BindingFlags)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.EventInfo" /> objects representing all events that are declared or inherited by the current <see cref="T:System.Type" /> that match the specified binding constraints.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Reflection.EventInfo" />, if the current <see cref="T:System.Type" /> does not have events, or if none of the events match the binding constraints.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitmask comprised of one or more <see cref="T:System.Reflection.BindingFlags" /> that specify how the search is conducted.</param>
       </Docs>
@@ -787,7 +855,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -797,6 +864,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetField(System.String)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.FieldInfo" /> object representing the public field with the specified name, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the name of the data field to get.</param>
       </Docs>
@@ -819,7 +890,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -829,6 +899,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetField(System.String,System.Reflection.BindingFlags)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.FieldInfo" /> object representing the field that matches the specified requirements, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the name of the data field to get. </param>
         <param name="bindingAttr">
@@ -850,7 +924,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -860,6 +933,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetFields" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.FieldInfo" /> objects representing all the public fields defined for the current <see cref="T:System.Type" />.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Reflection.FieldInfo" />, if no public fields are defined for the current <see cref="T:System.Type" />.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -879,7 +958,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -889,6 +967,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetFields(System.Reflection.BindingFlags)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.FieldInfo" /> objects representing all fields defined for the current <see cref="T:System.Type" /> that match the specified binding constraints.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Reflection.FieldInfo" />, if no fields are defined for the current <see cref="T:System.Type" />, or if none of the defined fields match the binding constraints.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitmask comprised of one or more <see cref="T:System.Reflection.BindingFlags" /> that specify how the search is conducted.</param>
       </Docs>
@@ -908,7 +992,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -918,6 +1001,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetHashCode" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Int32" /> containing the hash code for this instance.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -967,7 +1054,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -977,6 +1063,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetInterface(System.String)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object representing the interface with the specified name, implemented or inherited by the current <see cref="T:System.Type" />, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the name of the interface to get. For generic interfaces, this is the mangled name.</param>
       </Docs>
@@ -999,7 +1089,6 @@
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1009,6 +1098,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetInterface(System.String,System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object representing the interface with the specified name, implemented or inherited by the current <see cref="T:System.Type" />, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the name of the interface to get. For generic interfaces, this is the mangled name.</param>
         <param name="ignoreCase">
@@ -1032,7 +1125,6 @@
         <Parameter Name="interfaceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1042,6 +1134,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetInterfaceMap(System.Type)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Reflection.InterfaceMapping" /> object representing the interface mapping for <paramref name="interfaceType" />.</para>
+        </returns>
         <param name="interfaceType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the interface of which to retrieve a mapping.</param>
       </Docs>
@@ -1061,7 +1157,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1071,6 +1166,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetInterfaces" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Type" /> objects representing all the interfaces implemented or inherited by the current <see cref="T:System.Type" />.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Type" />, if no interfaces are implemented or inherited by the current <see cref="T:System.Type" />.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -1090,7 +1191,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1100,6 +1200,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetMember(System.String)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.MemberInfo" /> objects representing the public members with the specified name, if found; otherwise, an empty array.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the name of the public members to get.</param>
       </Docs>
@@ -1122,7 +1226,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1132,6 +1235,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetMember(System.String,System.Reflection.BindingFlags)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.MemberInfo" /> objects representing the public members with the specified name, if found; otherwise, an empty array.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the name of the members to get. </param>
         <param name="bindingAttr">
@@ -1157,7 +1264,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1167,6 +1273,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetMember(System.String,System.Reflection.MemberTypes,System.Reflection.BindingFlags)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.MemberInfo" /> objects representing the public members with the specified name, if found; otherwise, an empty array.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the name of the members to get. </param>
         <param name="type">
@@ -1190,7 +1300,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1200,6 +1309,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetMembers" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.MemberInfo" /> objects representing all the public members of the current <see cref="T:System.Type" />.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Reflection.MemberInfo" />, if the current <see cref="T:System.Type" /> does not have public members.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -1219,7 +1334,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1229,6 +1343,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetMembers(System.Reflection.BindingFlags)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.MemberInfo" /> objects representing all members defined for the current <see cref="T:System.Type" /> that match the specified binding constraints.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Reflection.MemberInfo" />, if no members are defined for the current <see cref="T:System.Type" />, or if none of the defined members match the binding constraints.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitmask comprised of one or more <see cref="T:System.Reflection.BindingFlags" /> that specify how the search is conducted.</param>
       </Docs>
@@ -1250,7 +1370,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1260,6 +1379,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetMethod(System.String)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodInfo" /> object representing the public method with the specified name, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the name of the public method to get.</param>
       </Docs>
@@ -1282,7 +1405,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1292,6 +1414,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetMethod(System.String,System.Reflection.BindingFlags)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodInfo" /> object representing the method that matches the specified requirements, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the name of the method to get. </param>
         <param name="bindingAttr">
@@ -1316,7 +1442,6 @@
         <Parameter Name="types" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1326,6 +1451,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetMethod(System.String,System.Type[])" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodInfo" /> object representing the public method whose parameters match the specified argument types, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the name of the public method to get. </param>
         <param name="types">
@@ -1351,7 +1480,6 @@
         <Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1361,6 +1489,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetMethod(System.String,System.Type[],System.Reflection.ParameterModifier[])" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodInfo" /> object representing the public method that matches the specified requirements, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the name of the public method to get. </param>
         <param name="types">
@@ -1390,7 +1522,6 @@
         <Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1400,6 +1531,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetMethod(System.String,System.Reflection.BindingFlags,System.Reflection.Binder,System.Type[],System.Reflection.ParameterModifier[])" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodInfo" /> object representing the method that matches the specified requirements, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the name of the method to get. </param>
         <param name="bindingAttr">
@@ -1434,7 +1569,6 @@
         <Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1444,6 +1578,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetMethod(System.String,System.Reflection.BindingFlags,System.Reflection.Binder,System.Reflection.CallingConventions,System.Type[],System.Reflection.ParameterModifier[])" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodInfo" /> object representing the method that matches the specified requirements, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the name of the method to get. </param>
         <param name="bindingAttr">
@@ -1473,7 +1611,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1483,6 +1620,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetMethods" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.MethodInfo" /> objects representing all the public methods defined for the current <see cref="T:System.Type" />.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Reflection.MethodInfo" />, if no public methods are defined for the current <see cref="T:System.Type" />.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -1502,7 +1645,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1512,6 +1654,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetMethods(System.Reflection.BindingFlags)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.MethodInfo" /> objects representing all methods defined for the current <see cref="T:System.Type" /> that match the specified binding constraints.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Reflection.MethodInfo" />, if no methods are defined for the current <see cref="T:System.Type" />, or if none of the defined methods match the binding constraints.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitmask comprised of one or more <see cref="T:System.Reflection.BindingFlags" /> that specify how the search is conducted.</param>
       </Docs>
@@ -1533,7 +1681,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1543,6 +1690,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetNestedType(System.String)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object representing the public nested type with the specified name, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the nested type to get.</param>
       </Docs>
@@ -1565,7 +1716,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1575,6 +1725,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetNestedType(System.String,System.Reflection.BindingFlags)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object representing the nested type that matches the specified requirements, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the nested type to get. </param>
         <param name="bindingAttr">
@@ -1596,7 +1750,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1606,6 +1759,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetNestedTypes" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Type" /> objects representing all the types nested within the current <see cref="T:System.Type" />.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Type" />, if no types are nested within the current <see cref="T:System.Type" />.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -1625,7 +1784,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1634,6 +1792,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetNestedTypes(System.Reflection.BindingFlags)" /> method, and searches for the types nested within the current <see cref="T:System.Type" />, using the specified binding constraints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Type" /> objects representing all the types nested within the current <see cref="T:System.Type" /> that match the specified binding constraints.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Type" />, if no types are nested within the current <see cref="T:System.Type" />, or if none of the nested types match the binding constraints.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitmask comprised of one or more <see cref="T:System.Reflection.BindingFlags" /> that specify how the search is conducted.</param>
       </Docs>
@@ -1653,7 +1817,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1663,6 +1826,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetProperties" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.PropertyInfo" /> objects representing all public properties of the current <see cref="T:System.Type" />.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Reflection.PropertyInfo" />, if the current <see cref="T:System.Type" /> does not have public properties.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -1682,7 +1851,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1692,6 +1860,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetProperties(System.Reflection.BindingFlags)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.PropertyInfo" /> objects representing all properties of the current <see cref="T:System.Type" /> that match the specified binding constraints.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Reflection.PropertyInfo" />, if the current <see cref="T:System.Type" /> does not have properties, or if none of the properties match the binding constraints.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitmask comprised of one or more <see cref="T:System.Reflection.BindingFlags" /> that specify how the search is conducted.</param>
       </Docs>
@@ -1713,7 +1887,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1723,6 +1896,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetProperty(System.String)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.PropertyInfo" /> object representing the public property with the specified name, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the name of the public property to get. </param>
       </Docs>
@@ -1745,7 +1922,6 @@
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1755,6 +1931,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetProperty(System.String,System.Reflection.BindingFlags)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.PropertyInfo" /> object representing the property that matches the specified requirements, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the name of the property to get. </param>
         <param name="bindingAttr">
@@ -1779,7 +1959,6 @@
         <Parameter Name="returnType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1789,6 +1968,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetProperty(System.String,System.Type)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.PropertyInfo" /> object representing the public property with the specified name, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the name of the public property to get. </param>
         <param name="returnType">
@@ -1813,7 +1996,6 @@
         <Parameter Name="types" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1823,6 +2005,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetProperty(System.String,System.Type[])" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.PropertyInfo" /> object representing the public property whose parameters match the specified argument types, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the name of the public property to get. </param>
         <param name="types">
@@ -1848,7 +2034,6 @@
         <Parameter Name="types" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1858,6 +2043,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetProperty(System.String,System.Type,System.Type[])" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.PropertyInfo" /> object representing the public property whose parameters match the specified argument types, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the name of the public property to get. </param>
         <param name="returnType">
@@ -1886,7 +2075,6 @@
         <Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1896,6 +2084,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetProperty(System.String,System.Type,System.Type[],System.Reflection.ParameterModifier[])" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.PropertyInfo" /> object representing the public property that matches the specified requirements, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the name of the public property to get. </param>
         <param name="returnType">
@@ -1928,7 +2120,6 @@
         <Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1938,6 +2129,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetProperty(System.String,System.Reflection.BindingFlags,System.Reflection.Binder,System.Type,System.Type[],System.Reflection.ParameterModifier[])" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.PropertyInfo" /> object representing the property that matches the specified requirements, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the name of the property to get. </param>
         <param name="bindingAttr">
@@ -1967,7 +2162,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -1977,6 +2171,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.GetType" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current <see cref="T:System.Type" />.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
@@ -2145,7 +2343,6 @@
         <Parameter Name="args" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -2155,6 +2352,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.InvokeMember(System.String,System.Reflection.BindingFlags,System.Reflection.Binder,System.Object,System.Object[])" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> representing the return value of the invoked member.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the name of the constructor, method, property, or field member to invoke.</param>
         <param name="invokeAttr">
@@ -2189,7 +2390,6 @@
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -2199,6 +2399,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.InvokeMember(System.String,System.Reflection.BindingFlags,System.Reflection.Binder,System.Object,System.Object[],System.Globalization.CultureInfo)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> representing the return value of the invoked member.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the name of the constructor, method, property, or field member to invoke.</param>
         <param name="invokeAttr">
@@ -2237,7 +2441,6 @@
         <Parameter Name="namedParameters" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -2247,6 +2450,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.InvokeMember(System.String,System.Reflection.BindingFlags,System.Reflection.Binder,System.Object,System.Object[],System.Reflection.ParameterModifier[],System.Globalization.CultureInfo,System.String[])" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> representing the return value of the invoked member.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the name of the constructor, method, property, or field member to invoke.</param>
         <param name="invokeAttr">
@@ -2360,7 +2567,6 @@
         <Parameter Name="c" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -2369,6 +2575,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.IsAssignableFrom(System.Type)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="c" /> and the current <see cref="T:System.Type" /> represent the same type, or if the current <see cref="T:System.Type" /> is in the inheritance hierarchy of <paramref name="c" />, or if the current <see cref="T:System.Type" /> is an interface that <paramref name="c" /> implements, or if <paramref name="c" /> is a generic type parameter and the current <see cref="T:System.Type" /> represents one of the constraints of <paramref name="c" />. false if none of these conditions are the case, or if <paramref name="c" /> is null.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> to compare with the current <see cref="T:System.Type" />.</param>
       </Docs>
@@ -2547,7 +2757,6 @@
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -2557,6 +2766,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Reflection.MemberInfo.IsDefined(System.Type,System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if one or more instance of <paramref name="attributeType" /> is applied to this member; otherwise, false.</para>
+        </returns>
         <param name="attributeType">
           <attribution license="cc4" from="Microsoft" modified="false" />The Type object to which the custom attributes are applied. </param>
         <param name="inherit">
@@ -2658,7 +2871,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -2668,6 +2880,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.IsInstanceOfType(System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current <see cref="T:System.Type" /> is in the inheritance hierarchy of the object represented by <paramref name="o" />, or if the current <see cref="T:System.Type" /> is an interface that <paramref name="o" /> supports. false if neither of these conditions is the case, or if <paramref name="o" /> is null, or if the current <see cref="T:System.Type" /> is an open generic type (that is, <see cref="P:System.Type.ContainsGenericParameters" /> returns true).</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current <see cref="T:System.Type" />.</param>
       </Docs>
@@ -3105,7 +3321,6 @@
         <Parameter Name="c" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -3115,6 +3330,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.IsSubclassOf(System.Type)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Type" /> represented by the <paramref name="c" /> parameter and the current <see cref="T:System.Type" /> represent classes, and the class represented by the current <see cref="T:System.Type" /> derives from the class represented by <paramref name="c" />; otherwise, false. This method also returns false if <paramref name="c" /> and the current <see cref="T:System.Type" /> represent the same class.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> to compare with the current <see cref="T:System.Type" />.</param>
       </Docs>
@@ -3316,7 +3535,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is for access to managed classes from unmanaged code, and should not be called from managed code.</para>
@@ -3326,6 +3544,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.Type.ToString" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> representing the name of the current <see cref="T:System.Type" />.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Activation/IActivator.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Activation/IActivator.xml
index 984e96cb42c..50bb06075dc 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Activation/IActivator.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Activation/IActivator.xml
@@ -44,12 +44,15 @@
         <Parameter Name="msg" Type="System.Runtime.Remoting.Activation.IConstructionCallMessage" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IConstructionReturnMessage'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the object that is specified in the provided <see cref="T:System.Runtime.Remoting.Activation.IConstructionCallMessage" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Status of the object activation contained in a <see cref="T:System.Runtime.Remoting.Activation.IConstructionReturnMessage" />.</para>
+        </returns>
         <param name="msg">
           <attribution license="cc4" from="Microsoft" modified="false" />The information about the object that is needed to activate it, stored in a <see cref="T:System.Runtime.Remoting.Activation.IConstructionCallMessage" />. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Activation/UrlAttribute.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Activation/UrlAttribute.xml
index 46a83f3ad82..c2c194c2f3e 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Activation/UrlAttribute.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Activation/UrlAttribute.xml
@@ -71,7 +71,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method overrides the default <see cref="M:System.Object.Equals(System.Object)" /> method.</para>
@@ -80,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks whether the specified object refers to the same URL as the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object is a <see cref="T:System.Runtime.Remoting.Activation.UrlAttribute" /> with the same value; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to the current <see cref="T:System.Runtime.Remoting.Activation.UrlAttribute" />. </param>
       </Docs>
@@ -98,12 +101,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash value for the current <see cref="T:System.Runtime.Remoting.Activation.UrlAttribute" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash value for the current <see cref="T:System.Runtime.Remoting.Activation.UrlAttribute" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetPropertiesForNewContext">
@@ -162,12 +168,15 @@
         <Parameter Name="msg" Type="System.Runtime.Remoting.Activation.IConstructionCallMessage" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Boolean value that indicates whether the specified <see cref="T:System.Runtime.Remoting.Contexts.Context" /> meets <see cref="T:System.Runtime.Remoting.Activation.UrlAttribute" />'s requirements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the passed-in context is acceptable; otherwise, false.</para>
+        </returns>
         <param name="ctx">
           <attribution license="cc4" from="Microsoft" modified="false" />The context to check against the current context attribute. </param>
         <param name="msg">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/BaseChannelObjectWithProperties.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/BaseChannelObjectWithProperties.xml
index 9e8b1b118df..8605ca7206b 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/BaseChannelObjectWithProperties.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/BaseChannelObjectWithProperties.xml
@@ -130,12 +130,15 @@
         <Parameter Name="key" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the channel object contains a property that is associated with the specified key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the channel object contains a property associated with the specified key; otherwise, false.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key of the property to look for. </param>
       </Docs>
@@ -203,12 +206,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IDictionaryEnumerator'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Collections.IDictionaryEnumerator" /> that enumerates over all the properties associated with the channel object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.IDictionaryEnumerator" /> that enumerates over all the properties associated with the channel object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsFixedSize">
@@ -416,12 +422,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Collections.IEnumerator" /> that enumerates over all the properties that are associated with the channel object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.IEnumerator" /> that enumerates over all the properties that are associated with the channel object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Values">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/ChannelServices.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/ChannelServices.xml
index 11a4ea3ff63..1f17c840840 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/ChannelServices.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/ChannelServices.xml
@@ -50,7 +50,6 @@
         <Parameter Name="replySink" Type="System.Runtime.Remoting.Messaging.IMessageSink" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.Messaging.IMessageCtrl'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current method returns immediately, whether the server processed the specified message or not.</para>
@@ -59,6 +58,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously dispatches the given message to the server-side chain(s) based on the URI embedded in the message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Messaging.IMessageCtrl" /> object used to control the asynchronously dispatched message.</para>
+        </returns>
         <param name="msg">
           <attribution license="cc4" from="Microsoft" modified="false" />The message to dispatch. </param>
         <param name="replySink">
@@ -82,12 +85,15 @@
         <Parameter Name="channel" Type="System.Runtime.Remoting.Channels.IChannelReceiver" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IServerChannelSink'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a channel sink chain for the specified channel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new channel sink chain for the specified channel.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />The first provider in the chain of sink providers that will create the channel sink chain. </param>
         <param name="channel">
@@ -136,12 +142,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IChannel'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a registered channel with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An interface to a registered channel, or null if the channel is not registered.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The channel name. </param>
       </Docs>
@@ -162,12 +171,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Collections.IDictionary'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Collections.IDictionary" /> of properties for a given proxy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An interface to the dictionary of properties, or null if no properties were found.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The proxy to retrieve properties for. </param>
       </Docs>
@@ -188,12 +200,15 @@
         <Parameter Name="obj" Type="System.MarshalByRefObject" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of all the URLs that can be used to reach the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of strings that contains the URLs that can be used to remotely identify the object, or null if none were found.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to retrieve the URL array for. </param>
       </Docs>
@@ -311,12 +326,15 @@
         <Parameter Name="msg" Type="System.Runtime.Remoting.Messaging.IMessage" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.Messaging.IMessage'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Synchronously dispatches the incoming message to the server-side chain(s) based on the URI embedded in the message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reply message is returned by the call to the server-side chain.</para>
+        </returns>
         <param name="msg">
           <attribution license="cc4" from="Microsoft" modified="false" />The message to dispatch. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/ClientChannelSinkStack.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/ClientChannelSinkStack.xml
index de8f9ed8528..22835adc8e8 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/ClientChannelSinkStack.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/ClientChannelSinkStack.xml
@@ -179,12 +179,15 @@
         <Parameter Name="sink" Type="System.Runtime.Remoting.Channels.IClientChannelSink" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Pops the information that is associated with all the sinks from the sink stack up to and including the specified sink.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Information generated on the request side and associated with the specified sink.</para>
+        </returns>
         <param name="sink">
           <attribution license="cc4" from="Microsoft" modified="false" />The sink to remove and return from the sink stack. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IChannelReceiver.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IChannelReceiver.xml
index 428c0110271..276f85d425c 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IChannelReceiver.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IChannelReceiver.xml
@@ -71,7 +71,6 @@
         <Parameter Name="objectURI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is used by the <see cref="M:System.Runtime.Remoting.Channels.ChannelServices.GetUrlsForObject(System.MarshalByRefObject)" /> method.</para>
@@ -80,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of all the URLs for a URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of the URLs.</para>
+        </returns>
         <param name="objectURI">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI for which URLs are required. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IClientChannelSink.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IClientChannelSink.xml
index 21cc1509f25..8ebfdd2e24b 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IClientChannelSink.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IClientChannelSink.xml
@@ -116,7 +116,6 @@
         <Parameter Name="headers" Type="System.Runtime.Remoting.Channels.ITransportHeaders" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IO.Stream'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Runtime.Remoting.Channels.IClientChannelSink.GetRequestStream(System.Runtime.Remoting.Messaging.IMessage,System.Runtime.Remoting.Channels.ITransportHeaders)" /> method is called by the formatter sink before it serializes the message.</para>
@@ -125,6 +124,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.IO.Stream" /> onto which the provided message is to be serialized.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IO.Stream" /> onto which the provided message is to be serialized.</para>
+        </returns>
         <param name="msg">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Runtime.Remoting.Messaging.IMethodCallMessage" /> containing details about the method call. </param>
         <param name="headers">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IClientChannelSinkProvider.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IClientChannelSinkProvider.xml
index ca3210cb293..3131efa00f8 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IClientChannelSinkProvider.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IClientChannelSinkProvider.xml
@@ -47,7 +47,6 @@
         <Parameter Name="remoteChannelData" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IClientChannelSink'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When the <see cref="M:System.Runtime.Remoting.Channels.IClientChannelSinkProvider.CreateSink(System.Runtime.Remoting.Channels.IChannelSender,System.String,System.Object)" /> method is called, it creates its own channel sink, forwards the <see cref="M:System.Runtime.Remoting.Channels.IClientChannelSinkProvider.CreateSink(System.Runtime.Remoting.Channels.IChannelSender,System.String,System.Object)" /> call to the next sink provider in the chain (if there is one), and ensures that the next sink and the current one are linked together.</para>
@@ -56,6 +55,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a sink chain.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first sink of the newly formed channel sink chain, or null, which indicates that this provider will not or cannot provide a connection for this endpoint.</para>
+        </returns>
         <param name="channel">
           <attribution license="cc4" from="Microsoft" modified="false" />Channel for which the current sink chain is being constructed. </param>
         <param name="url">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IClientChannelSinkStack.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IClientChannelSinkStack.xml
index a6fcfb5d55e..626d6fc073f 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IClientChannelSinkStack.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IClientChannelSinkStack.xml
@@ -49,12 +49,15 @@
         <Parameter Name="sink" Type="System.Runtime.Remoting.Channels.IClientChannelSink" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Pops the information associated with all the sinks from the sink stack up to and including the specified sink.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Information generated on the request side and associated with the specified sink.</para>
+        </returns>
         <param name="sink">
           <attribution license="cc4" from="Microsoft" modified="false" />The sink to remove and return from the sink stack. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IServerChannelSink.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IServerChannelSink.xml
index 089c4748be0..2a4736a7010 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IServerChannelSink.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IServerChannelSink.xml
@@ -90,7 +90,6 @@
         <Parameter Name="headers" Type="System.Runtime.Remoting.Channels.ITransportHeaders" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IO.Stream'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is called when a response stream needs to be created.</para>
@@ -99,6 +98,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.IO.Stream" /> onto which the provided response message is to be serialized.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IO.Stream" /> onto which the provided response message is to be serialized.</para>
+        </returns>
         <param name="sinkStack">
           <attribution license="cc4" from="Microsoft" modified="false" />A stack of sinks leading back to the server transport sink. </param>
         <param name="state">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IServerChannelSinkProvider.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IServerChannelSinkProvider.xml
index 105bc3fddd5..5e6764012fb 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IServerChannelSinkProvider.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IServerChannelSinkProvider.xml
@@ -46,12 +46,15 @@
         <Parameter Name="channel" Type="System.Runtime.Remoting.Channels.IChannelReceiver" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IServerChannelSink'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a sink chain.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first sink of the newly formed channel sink chain, or null, which indicates that this provider will not or cannot provide a connection for this endpoint.</para>
+        </returns>
         <param name="channel">
           <attribution license="cc4" from="Microsoft" modified="false" />The channel for which to create the channel sink chain. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IServerChannelSinkStack.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IServerChannelSinkStack.xml
index cbfb5a8915d..2a436661715 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IServerChannelSinkStack.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IServerChannelSinkStack.xml
@@ -44,12 +44,15 @@
         <Parameter Name="sink" Type="System.Runtime.Remoting.Channels.IServerChannelSink" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Pops the information associated with all the sinks from the sink stack up to and including the specified sink.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Information generated on the request side and associated with the specified sink.</para>
+        </returns>
         <param name="sink">
           <attribution license="cc4" from="Microsoft" modified="false" />The sink to remove and return from the sink stack. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IServerResponseChannelSinkStack.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IServerResponseChannelSinkStack.xml
index 163d9a7ef82..e80f291c6ba 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IServerResponseChannelSinkStack.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/IServerResponseChannelSinkStack.xml
@@ -75,12 +75,15 @@
         <Parameter Name="headers" Type="System.Runtime.Remoting.Channels.ITransportHeaders" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IO.Stream'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.IO.Stream" /> onto which the specified message is to be serialized.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IO.Stream" /> onto which the specified message is to be serialized.</para>
+        </returns>
         <param name="msg">
           <attribution license="cc4" from="Microsoft" modified="false" />The message to be serialized onto the requested stream. </param>
         <param name="headers">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/ITransportHeaders.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/ITransportHeaders.xml
index 9e8c1b3fb7c..bd1982b0689 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/ITransportHeaders.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/ITransportHeaders.xml
@@ -38,12 +38,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IEnumerator'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Collections.IEnumerator" /> that iterates over all entries in the <see cref="T:System.Runtime.Remoting.Channels.ITransportHeaders" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.IEnumerator" /> that iterates over all entries in the <see cref="T:System.Runtime.Remoting.Channels.ITransportHeaders" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Item">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/ServerChannelSinkStack.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/ServerChannelSinkStack.xml
index 92d919c20db..53bd108905a 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/ServerChannelSinkStack.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/ServerChannelSinkStack.xml
@@ -104,7 +104,6 @@
         <Parameter Name="headers" Type="System.Runtime.Remoting.Channels.ITransportHeaders" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IO.Stream'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns the stream returned by the <see cref="M:System.Runtime.Remoting.Channels.IServerChannelSink.GetResponseStream(System.Runtime.Remoting.Channels.IServerResponseChannelSinkStack,System.Object,System.Runtime.Remoting.Messaging.IMessage,System.Runtime.Remoting.Channels.ITransportHeaders)" /> called with the <paramref name="msg" /> and <paramref name="headers" /> parameters (<see cref="M:System.Runtime.Remoting.Channels.IServerChannelSink.GetResponseStream(System.Runtime.Remoting.Channels.IServerResponseChannelSinkStack,System.Object,System.Runtime.Remoting.Messaging.IMessage,System.Runtime.Remoting.Channels.ITransportHeaders)" /> (<paramref name="msg" />, <paramref name="headers" />)) on the top sink in the current sink stack. The top sink in the sink stack remains unchanged.</para>
@@ -113,6 +112,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.IO.Stream" /> onto which the specified message is to be serialized.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.IO.Stream" /> onto which the specified message is to be serialized.</para>
+        </returns>
         <param name="msg">
           <attribution license="cc4" from="Microsoft" modified="false" />The message to be serialized onto the requested stream. </param>
         <param name="headers">
@@ -135,12 +138,15 @@
         <Parameter Name="sink" Type="System.Runtime.Remoting.Channels.IServerChannelSink" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Pops the information associated with all the sinks from the sink stack up to and including the specified sink.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Information generated on the request side and associated with the specified sink.</para>
+        </returns>
         <param name="sink">
           <attribution license="cc4" from="Microsoft" modified="false" />The sink to remove and return from the sink stack. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/TransportHeaders.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/TransportHeaders.xml
index a9307cb9795..a21495fb097 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/TransportHeaders.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Channels/TransportHeaders.xml
@@ -68,12 +68,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IEnumerator'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator of the stored transport headers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator of the stored transport headers.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Item">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/Context.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/Context.xml
index 6eb4c4cca25..9b675548cbf 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/Context.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/Context.xml
@@ -66,7 +66,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'LocalDataStoreSlot'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The slot is allocated on all the contexts.</para>
@@ -75,6 +74,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Allocates an unnamed data slot.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A local data slot.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="AllocateNamedDataSlot">
@@ -93,7 +96,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'LocalDataStoreSlot'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The slot is allocated on all the contexts. Named data slots are public and can be manipulated by anyone.</para>
@@ -102,6 +104,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Allocates a named data slot.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A local data slot object.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The required name for the data slot. </param>
       </Docs>
@@ -292,12 +298,15 @@
         <Parameter Name="slot" Type="System.LocalDataStoreSlot" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the value from the specified slot on the current context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the data associated with <paramref name="slot" />. </para>
+        </returns>
         <param name="slot">
           <attribution license="cc4" from="Microsoft" modified="false" />The data slot that contains the data. </param>
       </Docs>
@@ -318,7 +327,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'LocalDataStoreSlot'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the name has not been used, a new slot is allocated. Named data slots are public and can be manipulated by anyone.</para>
@@ -327,6 +335,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Looks up a named data slot.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a local data slot.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The data slot name. </param>
       </Docs>
@@ -347,12 +359,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IContextProperty'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a specific context property, specified by name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified context property.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the property. </param>
       </Docs>
@@ -375,7 +390,6 @@
         <Parameter Name="ctx" Type="System.Runtime.Remoting.Contexts.Context" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Based on <paramref name="obj" /> and <paramref name="ctx" />, <paramref name="prop" /> is asked to contribute a sink that is placed at some location in the path of remoting calls. If multiple properties are registered, their sinks will be called in an arbitrary order that can change between calls.</para>
@@ -387,6 +401,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Registers a dynamic property implementing the <see cref="T:System.Runtime.Remoting.Contexts.IDynamicProperty" /> interface with the remoting service.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the property was successfully registered; otherwise, false.</para>
+        </returns>
         <param name="prop">
           <attribution license="cc4" from="Microsoft" modified="false" />The dynamic property to register. </param>
         <param name="obj">
@@ -465,12 +483,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.String" /> class representation of the current context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> class representation of the current context.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="UnregisterDynamicProperty">
@@ -491,12 +512,15 @@
         <Parameter Name="ctx" Type="System.Runtime.Remoting.Contexts.Context" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Unregisters a dynamic property implementing the <see cref="T:System.Runtime.Remoting.Contexts.IDynamicProperty" /> interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object was successfully unregistered; otherwise, false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the dynamic property to unregister. </param>
         <param name="obj">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/ContextAttribute.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/ContextAttribute.xml
index 4fede563c33..b7a90b5258b 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/ContextAttribute.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/ContextAttribute.xml
@@ -100,12 +100,15 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Boolean value indicating whether this instance is equal to the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="o" /> is not null and if the object names are equivalent; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this instance. </param>
       </Docs>
@@ -152,12 +155,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hashcode for this instance of <see cref="T:System.Runtime.Remoting.Contexts.ContextAttribute" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hashcode for this instance of <see cref="T:System.Runtime.Remoting.Contexts.ContextAttribute" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetPropertiesForNewContext">
@@ -205,12 +211,15 @@
         <Parameter Name="ctorMsg" Type="System.Runtime.Remoting.Activation.IConstructionCallMessage" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Boolean value indicating whether the context parameter meets the context attribute's requirements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the passed in context is okay; otherwise, false.</para>
+        </returns>
         <param name="ctx">
           <attribution license="cc4" from="Microsoft" modified="false" />The context in which to check. </param>
         <param name="ctorMsg">
@@ -233,7 +242,6 @@
         <Parameter Name="newCtx" Type="System.Runtime.Remoting.Contexts.Context" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Once all the context properties have been added to the new context, they are all queried as to whether they are okay in the new context. The context property could look at the other context properties in the <see cref="P:System.Runtime.Remoting.Contexts.Context.ContextProperties" /> property of the new context and determine whether it is compatible with these other context properties.</para>
@@ -245,6 +253,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Boolean value indicating whether the context property is compatible with the new context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the context property is okay with the new context; otherwise, false.</para>
+        </returns>
         <param name="newCtx">
           <attribution license="cc4" from="Microsoft" modified="false" />The new context in which the property has been created. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContextAttribute.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContextAttribute.xml
index 8192ac07e64..660bcc08df4 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContextAttribute.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContextAttribute.xml
@@ -72,12 +72,15 @@
         <Parameter Name="msg" Type="System.Runtime.Remoting.Activation.IConstructionCallMessage" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Boolean value indicating whether the specified context meets the context attribute's requirements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the passed in context is okay; otherwise, false.</para>
+        </returns>
         <param name="ctx">
           <attribution license="cc4" from="Microsoft" modified="false" />The context to check against the current context attribute. </param>
         <param name="msg">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContextProperty.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContextProperty.xml
index 96fc2ed02fe..76e994f881d 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContextProperty.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContextProperty.xml
@@ -71,7 +71,6 @@
         <Parameter Name="newCtx" Type="System.Runtime.Remoting.Contexts.Context" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Once all the context properties have been added to the new context, they are all queried as to whether they are okay in the new context. The context property could look at the other context properties from <paramref name="newCtx" /> and determine whether it is compatible with these other context properties. </para>
@@ -80,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Boolean value indicating whether the context property is compatible with the new context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the context property can coexist with the other context properties in the given context; otherwise, false.</para>
+        </returns>
         <param name="newCtx">
           <attribution license="cc4" from="Microsoft" modified="false" />The new context in which the <see cref="T:System.Runtime.Remoting.Contexts.ContextProperty" /> has been created. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContextPropertyActivator.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContextPropertyActivator.xml
index ea4be7d04eb..76c689887a4 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContextPropertyActivator.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContextPropertyActivator.xml
@@ -101,7 +101,6 @@
         <Parameter Name="msg" Type="System.Runtime.Remoting.Activation.IConstructionCallMessage" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current method is called on each server context property that implements the <see cref="T:System.Runtime.Remoting.Contexts.IContextPropertyActivator" /> interface when a construction request arrives at a server. This allows the context property to examine the contents of each <see cref="T:System.Runtime.Remoting.Activation.IConstructionCallMessage" />.</para>
@@ -110,6 +109,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called on each client context property that has this interface, when the construction request returns to the client from the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if successful; otherwise, false.</para>
+        </returns>
         <param name="msg">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Runtime.Remoting.Activation.IConstructionCallMessage" />. </param>
       </Docs>
@@ -130,7 +133,6 @@
         <Parameter Name="msg" Type="System.Runtime.Remoting.Activation.IConstructionReturnMessage" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The context property can examine the contents of the <see cref="T:System.Runtime.Remoting.Activation.IConstructionReturnMessage" />.</para>
@@ -139,6 +141,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Called on each client context property that has this interface, when the construction request returns to the client from the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if successful; otherwise, false.</para>
+        </returns>
         <param name="msg">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Runtime.Remoting.Activation.IConstructionReturnMessage" />. </param>
       </Docs>
@@ -159,12 +165,15 @@
         <Parameter Name="msg" Type="System.Runtime.Remoting.Activation.IConstructionCallMessage" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether it is all right to activate the object type indicated in the <paramref name="msg" /> parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Boolean value indicating whether the requested type can be activated.</para>
+        </returns>
         <param name="msg">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Runtime.Remoting.Activation.IConstructionCallMessage" />. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContributeClientContextSink.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContributeClientContextSink.xml
index 7d2015d0368..5ed653ba47e 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContributeClientContextSink.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContributeClientContextSink.xml
@@ -44,12 +44,15 @@
         <Parameter Name="nextSink" Type="System.Runtime.Remoting.Messaging.IMessageSink" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.Messaging.IMessageSink'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Takes the first sink in the chain of sinks composed so far, and then chains its message sink in front of the chain already formed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The composite sink chain.</para>
+        </returns>
         <param name="nextSink">
           <attribution license="cc4" from="Microsoft" modified="false" />The chain of sinks composed so far. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContributeDynamicSink.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContributeDynamicSink.xml
index cf197027713..565cbbf047e 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContributeDynamicSink.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContributeDynamicSink.xml
@@ -41,12 +41,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IDynamicMessageSink'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the message sink that will be notified of call start and finish events through the <see cref="T:System.Runtime.Remoting.Contexts.IDynamicMessageSink" /> interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A dynamic sink that exposes the <see cref="T:System.Runtime.Remoting.Contexts.IDynamicMessageSink" /> interface.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContributeEnvoySink.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContributeEnvoySink.xml
index 4c9669d4e97..1a76e52906f 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContributeEnvoySink.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContributeEnvoySink.xml
@@ -44,7 +44,6 @@
         <Parameter Name="nextSink" Type="System.Runtime.Remoting.Messaging.IMessageSink" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.Messaging.IMessageSink'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Runtime.Remoting.Contexts.IContributeEnvoySink.GetEnvoySink(System.MarshalByRefObject,System.Runtime.Remoting.Messaging.IMessageSink)" /> method is used as an optimization to create an envoy sink when the destination is a different context in the same application domain and is used by the Wrap operation.</para>
@@ -53,6 +52,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Takes the first sink in the chain of sinks composed so far, and then chains its message sink in front of the chain already formed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The composite sink chain.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The server object for which the chain is being created. </param>
         <param name="nextSink">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContributeObjectSink.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContributeObjectSink.xml
index d28ddd6a7a2..834d808046e 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContributeObjectSink.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContributeObjectSink.xml
@@ -45,12 +45,15 @@
         <Parameter Name="nextSink" Type="System.Runtime.Remoting.Messaging.IMessageSink" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.Messaging.IMessageSink'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Chains the message sink of the provided server object in front of the given sink chain.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The composite sink chain.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The server object which provides the message sink that is to be chained in front of the given chain. </param>
         <param name="nextSink">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContributeServerContextSink.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContributeServerContextSink.xml
index ccb1591133a..e852a25a2d3 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContributeServerContextSink.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/IContributeServerContextSink.xml
@@ -45,12 +45,15 @@
         <Parameter Name="nextSink" Type="System.Runtime.Remoting.Messaging.IMessageSink" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.Messaging.IMessageSink'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Takes the first sink in the chain of sinks composed so far, and then chains its message sink in front of the chain already formed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The composite sink chain.</para>
+        </returns>
         <param name="nextSink">
           <attribution license="cc4" from="Microsoft" modified="false" />The chain of sinks composed so far. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/SynchronizationAttribute.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/SynchronizationAttribute.xml
index f1ce96a0b93..36536d919ed 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/SynchronizationAttribute.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Contexts/SynchronizationAttribute.xml
@@ -162,7 +162,6 @@
         <Parameter Name="nextSink" Type="System.Runtime.Remoting.Messaging.IMessageSink" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.Messaging.IMessageSink'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current method is an implementation of <see cref="M:System.Runtime.Remoting.Contexts.IContributeClientContextSink.GetClientContextSink(System.Runtime.Remoting.Messaging.IMessageSink)" />.</para>
@@ -171,6 +170,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a CallOut sink and chains it in front of the provided chain of sinks at the context boundary on the client end of a remoting call.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The composite sink chain with the new CallOut sink.</para>
+        </returns>
         <param name="nextSink">
           <attribution license="cc4" from="Microsoft" modified="false" />The chain of sinks composed so far. </param>
       </Docs>
@@ -221,7 +224,6 @@
         <Parameter Name="nextSink" Type="System.Runtime.Remoting.Messaging.IMessageSink" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.Messaging.IMessageSink'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current method is an implementation of <see cref="M:System.Runtime.Remoting.Contexts.IContributeServerContextSink.GetServerContextSink(System.Runtime.Remoting.Messaging.IMessageSink)" />.</para>
@@ -230,6 +232,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a synchronized dispatch sink and chains it in front of the provided chain of sinks at the context boundary on the server end of a remoting call.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The composite sink chain with the new synchronized dispatch sink.</para>
+        </returns>
         <param name="nextSink">
           <attribution license="cc4" from="Microsoft" modified="false" />The chain of sinks composed so far. </param>
       </Docs>
@@ -256,12 +262,15 @@
         <Parameter Name="msg" Type="System.Runtime.Remoting.Activation.IConstructionCallMessage" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Boolean value indicating whether the context parameter meets the context attribute's requirements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the passed in context is OK; otherwise, false.</para>
+        </returns>
         <param name="ctx">
           <attribution license="cc4" from="Microsoft" modified="false" />The context to check. </param>
         <param name="msg">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Lifetime/ClientSponsor.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Lifetime/ClientSponsor.xml
index 99848686043..72285d7cf7f 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Lifetime/ClientSponsor.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Lifetime/ClientSponsor.xml
@@ -138,7 +138,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information, see <see cref="M:System.MarshalByRefObject.InitializeLifetimeService" />.</para>
@@ -147,6 +146,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of <see cref="T:System.Runtime.Remoting.Lifetime.ClientSponsor" />, providing a lease for the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Runtime.Remoting.Lifetime.ILease" /> for the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Register">
@@ -165,12 +168,15 @@
         <Parameter Name="obj" Type="System.MarshalByRefObject" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Registers the specified <see cref="T:System.MarshalByRefObject" /> for sponsorship.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if registration succeeded; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to register for sponsorship with the <see cref="T:System.Runtime.Remoting.Lifetime.ClientSponsor" />. </param>
       </Docs>
@@ -191,7 +197,6 @@
         <Parameter Name="lease" Type="System.Runtime.Remoting.Lifetime.ILease" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TimeSpan'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Runtime.Remoting.Lifetime.ISponsor.Renewal(System.Runtime.Remoting.Lifetime.ILease)" /> method is called by the distributed garbage collector to renew the lease for the specified object.</para>
@@ -200,6 +205,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Requests a sponsoring client to renew the lease for the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The additional lease time for the specified object.</para>
+        </returns>
         <param name="lease">
           <attribution license="cc4" from="Microsoft" modified="false" />The lifetime lease of the object that requires lease renewal. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Lifetime/ILease.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Lifetime/ILease.xml
index 327a4f12064..1f9f388c06c 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Lifetime/ILease.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Lifetime/ILease.xml
@@ -169,7 +169,6 @@
         <Parameter Name="renewalTime" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TimeSpan'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The lease time is set to the maximum of the <see cref="P:System.Runtime.Remoting.Lifetime.ILease.CurrentLeaseTime" /> or the current time plus the renewal time.</para>
@@ -178,6 +177,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Renews a lease for the specified time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new expiration time of the lease.</para>
+        </returns>
         <param name="renewalTime">
           <attribution license="cc4" from="Microsoft" modified="false" />The length of time to renew the lease by. </param>
       </Docs>
@@ -252,6 +255,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes a sponsor from the sponsor list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>After this method is called, the lease state changes to expired and the object is collected by the garbage collector.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The lease sponsor to unregister. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Lifetime/ISponsor.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Lifetime/ISponsor.xml
index 9e4d37b76c4..c0648217dd0 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Lifetime/ISponsor.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Lifetime/ISponsor.xml
@@ -43,7 +43,6 @@
         <Parameter Name="lease" Type="System.Runtime.Remoting.Lifetime.ILease" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TimeSpan'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Runtime.Remoting.Lifetime.ISponsor.Renewal(System.Runtime.Remoting.Lifetime.ILease)" /> method is called by the distributed garbage collector to renew the lease for the specified object.</para>
@@ -52,6 +51,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Requests a sponsoring client to renew the lease for the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The additional lease time for the specified object.</para>
+        </returns>
         <param name="lease">
           <attribution license="cc4" from="Microsoft" modified="false" />The lifetime lease of the object that requires lease renewal. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/AsyncResult.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/AsyncResult.xml
index f3ebf23f8b7..108d21bd84a 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/AsyncResult.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/AsyncResult.xml
@@ -80,7 +80,6 @@
         <Parameter Name="replySink" Type="System.Runtime.Remoting.Messaging.IMessageSink" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IMessageCtrl'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Runtime.Remoting.Messaging.AsyncResult.AsyncProcessMessage(System.Runtime.Remoting.Messaging.IMessage,System.Runtime.Remoting.Messaging.IMessageSink)" /> method of the <see cref="T:System.Runtime.Remoting.Messaging.IMessageSink" /> interface is not relevant to the <see cref="T:System.Runtime.Remoting.Messaging.AsyncResult" /> class. Implementation by <see cref="T:System.Runtime.Remoting.Messaging.AsyncResult" /> throws a <see cref="T:System.NotSupportedException" />. Instead, obtain an <see cref="T:System.Runtime.Remoting.Messaging.AsyncResult" /> by casting the <see cref="T:System.IAsyncResult" /> interface returned by an asynchronous call made using a delegate.</para>
@@ -89,6 +88,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implements the <see cref="T:System.Runtime.Remoting.Messaging.IMessageSink" /> interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>No value is returned.</para>
+        </returns>
         <param name="msg">
           <attribution license="cc4" from="Microsoft" modified="false" />The request <see cref="T:System.Runtime.Remoting.Messaging.IMessage" /> interface. </param>
         <param name="replySink">
@@ -207,7 +210,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IMessage'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Runtime.Remoting.Messaging.AsyncResult.GetReplyMessage" /> method can return an object after the <see cref="M:System.Runtime.Remoting.Messaging.AsyncResult.SyncProcessMessage(System.Runtime.Remoting.Messaging.IMessage)" /> method is called. The <see cref="T:System.Runtime.Remoting.Messaging.IMessage" /> return value can be cast to an <see cref="T:System.Runtime.Remoting.Messaging.IMethodReturnMessage" />.</para>
@@ -217,6 +219,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the response message for the asynchronous call.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A remoting message that should represent a response to a method call on a remote object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsCompleted">
@@ -311,7 +317,6 @@
         <Parameter Name="msg" Type="System.Runtime.Remoting.Messaging.IMessage" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IMessage'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Runtime.Remoting.Messaging.AsyncResult.SyncProcessMessage(System.Runtime.Remoting.Messaging.IMessage)" /> method implements the <see cref="T:System.Runtime.Remoting.Messaging.IMessageSink" /> interface. You do not need to call this method directly. It is intended for use by the remoting infrastructure of the .NET Framework.</para>
@@ -324,6 +329,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Synchronously processes a response message returned by a method call on a remote object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns null.</para>
+        </returns>
         <param name="msg">
           <attribution license="cc4" from="Microsoft" modified="false" />A response message to a method call on a remote object.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/CallContext.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/CallContext.xml
index 949db05cb5c..10e36a3b920 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/CallContext.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/CallContext.xml
@@ -79,12 +79,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an object with the specified name from the <see cref="T:System.Runtime.Remoting.Messaging.CallContext" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object in the call context associated with the specified name.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the item in the call context. </param>
       </Docs>
@@ -103,12 +106,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Header []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the headers that are sent along with the method call.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The headers that are sent along with the method call.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HostContext">
@@ -146,12 +152,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an object with the specified name from the logical call context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object in the logical call context associated with the specified name.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the item in the logical call context. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/IMessageSink.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/IMessageSink.xml
index d0f5c75db53..0660b639d3a 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/IMessageSink.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/IMessageSink.xml
@@ -47,7 +47,6 @@
         <Parameter Name="replySink" Type="System.Runtime.Remoting.Messaging.IMessageSink" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IMessageCtrl'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is invoked on the message sink by the remoting infrastructure or by a previous sink for asynchronous messages.</para>
@@ -56,6 +55,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously processes the given message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns an <see cref="T:System.Runtime.Remoting.Messaging.IMessageCtrl" /> interface that provides a way to control asynchronous messages after they have been dispatched.</para>
+        </returns>
         <param name="msg">
           <attribution license="cc4" from="Microsoft" modified="false" />The message to process. </param>
         <param name="replySink">
@@ -99,7 +102,6 @@
         <Parameter Name="msg" Type="System.Runtime.Remoting.Messaging.IMessage" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IMessage'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Runtime.Remoting.Messaging.IMessageSink.SyncProcessMessage(System.Runtime.Remoting.Messaging.IMessage)" /> method is invoked on the message sink by the remoting infrastructure or by a previous sink for synchronous messages.</para>
@@ -108,6 +110,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Synchronously processes the given message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reply message in response to the request.</para>
+        </returns>
         <param name="msg">
           <attribution license="cc4" from="Microsoft" modified="false" />The message to process. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/IMethodCallMessage.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/IMethodCallMessage.xml
index dd533599666..96711ecfe92 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/IMethodCallMessage.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/IMethodCallMessage.xml
@@ -47,12 +47,15 @@
         <Parameter Name="argNum" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified argument that is not marked as an out parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The requested argument that is not marked as an out parameter.</para>
+        </returns>
         <param name="argNum">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of the requested in argument. </param>
       </Docs>
@@ -73,12 +76,15 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the specified argument that is not marked as an out parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of a specific argument that is not marked as an out parameter.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of the requested in argument. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/IMethodMessage.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/IMethodMessage.xml
index 0e118acf88a..b65c3c34fc8 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/IMethodMessage.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/IMethodMessage.xml
@@ -92,12 +92,15 @@
         <Parameter Name="argNum" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a specific argument as an <see cref="T:System.Object" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The argument passed to the method.</para>
+        </returns>
         <param name="argNum">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of the requested argument. </param>
       </Docs>
@@ -118,12 +121,15 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the name of the argument passed to the method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the specified argument passed to the method, or null if the current method is not implemented.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of the requested argument. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/IMethodReturnMessage.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/IMethodReturnMessage.xml
index 8380bf94689..c86b5316c38 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/IMethodReturnMessage.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/IMethodReturnMessage.xml
@@ -68,12 +68,15 @@
         <Parameter Name="argNum" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified argument marked as a ref or an out parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified argument marked as a ref or an out parameter.</para>
+        </returns>
         <param name="argNum">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of the requested argument. </param>
       </Docs>
@@ -94,12 +97,15 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the specified argument marked as a ref or an out parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The argument name, or null if the current method is not implemented.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of the requested argument name. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/IRemotingFormatter.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/IRemotingFormatter.xml
index 3db5c33396b..d6e3e867b8a 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/IRemotingFormatter.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/IRemotingFormatter.xml
@@ -48,7 +48,6 @@
         <Parameter Name="handler" Type="System.Runtime.Remoting.Messaging.HeaderHandler" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -61,6 +60,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Begins the deserialization process of a remote procedure call (RPC).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The root of the deserialized object graph.</para>
+        </returns>
         <param name="serializationStream">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IO.Stream" /> from which the data is deserialized. </param>
         <param name="handler">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/LogicalCallContext.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/LogicalCallContext.xml
index 501c1ada8d6..961aa9f686b 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/LogicalCallContext.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/LogicalCallContext.xml
@@ -55,7 +55,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Runtime.Remoting.Messaging.LogicalCallContext.Clone" /> method produces a deep copy of the current <see cref="T:System.Runtime.Remoting.Messaging.LogicalCallContext" />.</para>
@@ -64,6 +63,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new object that is a copy of the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new object that is a copy of this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="FreeNamedDataSlot">
@@ -107,12 +110,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an object associated with the specified name from the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object in the logical call context associated with the specified name.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the item in the call context. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/MethodCall.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/MethodCall.xml
index de41567abe6..27aaa579407 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/MethodCall.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/MethodCall.xml
@@ -188,7 +188,6 @@
         <Parameter Name="argNum" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method belongs to a remote object.</para>
@@ -197,6 +196,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a method argument, as an object, at a specified index. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The method argument as an object.</para>
+        </returns>
         <param name="argNum">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the requested argument.</param>
       </Docs>
@@ -217,7 +220,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method belongs to a remote object.</para>
@@ -226,6 +228,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the name of a method argument at a specified index. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the method argument.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the requested argument.</param>
       </Docs>
@@ -246,7 +252,6 @@
         <Parameter Name="argNum" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method belongs to a remote object.</para>
@@ -255,6 +260,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a method argument at a specified index that is not marked as an out parameter. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The method argument that is not marked as an out parameter.</para>
+        </returns>
         <param name="argNum">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the requested argument.</param>
       </Docs>
@@ -275,7 +284,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method belongs to a remote object.</para>
@@ -284,6 +292,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the name of a method argument at a specified index that is not marked as an out parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the method argument that is not marked as an out parameter.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the requested argument. </param>
       </Docs>
@@ -359,7 +371,6 @@
         <Parameter Name="h" Type="System.Runtime.Remoting.Messaging.Header[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method belongs to a remote object. The value of the first header in the input array is the method name.</para>
@@ -368,6 +379,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes an internal serialization handler from an array of remoting headers that are applied to a method. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An internal serialization handler.</para>
+        </returns>
         <param name="h">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of remoting headers that contain key/value pairs. This array is used to initialize <see cref="T:System.Runtime.Remoting.Messaging.MethodCall" /> fields for headers that belong to the namespace "http://schemas.microsoft.com/clr/soap/messageProperties".</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/MethodCallMessageWrapper.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/MethodCallMessageWrapper.xml
index f3fc1576fdd..c1c73befc30 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/MethodCallMessageWrapper.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/MethodCallMessageWrapper.xml
@@ -126,7 +126,6 @@
         <Parameter Name="argNum" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method belongs to a remote object.</para>
@@ -135,6 +134,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a method argument, as an object, at a specified index. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The method argument as an object.</para>
+        </returns>
         <param name="argNum">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the requested argument.</param>
       </Docs>
@@ -155,7 +158,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method belongs to a remote object.</para>
@@ -164,6 +166,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the name of a method argument at a specified index. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the method argument.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the requested argument.</param>
       </Docs>
@@ -184,7 +190,6 @@
         <Parameter Name="argNum" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method belongs to a remote object.</para>
@@ -193,6 +198,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a method argument at a specified index that is not marked as an out parameter. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The method argument that is not marked as an out parameter.</para>
+        </returns>
         <param name="argNum">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the requested argument.</param>
       </Docs>
@@ -213,7 +222,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method belongs to a remote object.</para>
@@ -222,6 +230,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the name of a method argument at a specified index that is not marked as an out parameter. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the method argument that is not marked as an out parameter.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the requested argument.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/MethodResponse.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/MethodResponse.xml
index 686627b0698..142b7273505 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/MethodResponse.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/MethodResponse.xml
@@ -190,7 +190,6 @@
         <Parameter Name="argNum" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method belongs to a remote object.</para>
@@ -199,6 +198,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a method argument, as an object, at a specified index. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The method argument as an object.</para>
+        </returns>
         <param name="argNum">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the requested argument.</param>
       </Docs>
@@ -219,7 +222,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method belongs to a remote object.</para>
@@ -228,6 +230,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the name of a method argument at a specified index. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the method argument.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the requested argument.</param>
       </Docs>
@@ -279,7 +285,6 @@
         <Parameter Name="argNum" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method belongs to a remote object.</para>
@@ -288,6 +293,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified argument marked as a ref parameter or an out parameter. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified argument marked as a ref parameter or an out parameter.</para>
+        </returns>
         <param name="argNum">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the requested argument.</param>
       </Docs>
@@ -308,7 +317,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method belongs to a remote object.</para>
@@ -317,6 +325,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the specified argument marked as a ref parameter or an out parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The argument name, or null if the current method is not implemented.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the requested argument.</param>
       </Docs>
@@ -361,7 +373,6 @@
         <Parameter Name="h" Type="System.Runtime.Remoting.Messaging.Header[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method belongs to a remote object. The value of the first header in the input array is the method name.</para>
@@ -370,6 +381,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes an internal serialization handler from an array of remoting headers that are applied to a method. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An internal serialization handler.</para>
+        </returns>
         <param name="h">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of remoting headers that contain key/value pairs. This array is used to initialize <see cref="T:System.Runtime.Remoting.Messaging.MethodResponse" /> fields for headers that belong to the namespace "http://schemas.microsoft.com/clr/soap/messageProperties".</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/MethodReturnMessageWrapper.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/MethodReturnMessageWrapper.xml
index eb6c1426b11..44564e9b1ea 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/MethodReturnMessageWrapper.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/MethodReturnMessageWrapper.xml
@@ -149,7 +149,6 @@
         <Parameter Name="argNum" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method belongs to a remote object.</para>
@@ -158,6 +157,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a method argument, as an object, at a specified index. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The method argument as an object.</para>
+        </returns>
         <param name="argNum">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the requested argument.</param>
       </Docs>
@@ -178,7 +181,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method belongs to a remote object.</para>
@@ -187,6 +189,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the name of a method argument at a specified index. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the method argument.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the requested argument.</param>
       </Docs>
@@ -207,7 +213,6 @@
         <Parameter Name="argNum" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method belongs to a remote object.</para>
@@ -216,6 +221,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified argument marked as a ref parameter or an out parameter. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified argument marked as a ref parameter or an out parameter.</para>
+        </returns>
         <param name="argNum">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the requested argument.</param>
       </Docs>
@@ -236,7 +245,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method belongs to a remote object.</para>
@@ -245,6 +253,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the specified argument marked as a ref parameter or an out parameter. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The argument name, or null if the current method is not implemented.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The index of the requested argument.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/RemotingSurrogateSelector.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/RemotingSurrogateSelector.xml
index 641e28da848..973bcab16da 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/RemotingSurrogateSelector.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/RemotingSurrogateSelector.xml
@@ -120,12 +120,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Serialization.ISurrogateSelector'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the next <see cref="T:System.Runtime.Serialization.ISurrogateSelector" /> in the chain of surrogate selectors.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The next <see cref="T:System.Runtime.Serialization.ISurrogateSelector" /> in the chain of surrogate selectors.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetRootObject">
@@ -142,12 +145,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the object at the root of the object graph.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object at the root of the object graph.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetSurrogate">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/ReturnMessage.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/ReturnMessage.xml
index 9ff2bd40700..b9e8fd40d18 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/ReturnMessage.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Messaging/ReturnMessage.xml
@@ -179,12 +179,15 @@
         <Parameter Name="argNum" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a specified argument passed to the remote method during the method call.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An argument passed to the remote method during the method call.</para>
+        </returns>
         <param name="argNum">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the requested argument. </param>
       </Docs>
@@ -205,12 +208,15 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of a specified method argument.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of a specified method argument.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the requested argument name. </param>
       </Docs>
@@ -231,12 +237,15 @@
         <Parameter Name="argNum" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the object passed as an out or ref parameter during the remote method call.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object passed as an out or ref parameter during the remote method call.</para>
+        </returns>
         <param name="argNum">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the requested out or ref parameter. </param>
       </Docs>
@@ -257,12 +266,15 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of a specified out or ref parameter passed to the remote method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representing the name of the specified out or ref parameter, or null if the current method is not implemented.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index of the requested argument. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/ISoapXsd.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/ISoapXsd.xml
index 9ed08ebaf84..d39a636a688 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/ISoapXsd.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/ISoapXsd.xml
@@ -38,12 +38,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that indicates the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapAnyUri.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapAnyUri.xml
index a58a0be88a9..a1960de8833 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapAnyUri.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapAnyUri.xml
@@ -90,12 +90,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that indicates the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -114,12 +117,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SoapAnyUri'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapAnyUri" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapAnyUri" /> object that is obtained from <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> to convert. </param>
       </Docs>
@@ -138,12 +144,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapAnyUri.Value" /> as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that is obtained from <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapAnyUri.Value" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapBase64Binary.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapBase64Binary.xml
index 6ea0361b9a5..ff71c37e788 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapBase64Binary.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapBase64Binary.xml
@@ -90,12 +90,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that indicates the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -114,12 +117,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SoapBase64Binary'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapBase64Binary" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapBase64Binary" /> object that is obtained from <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The String to convert. </param>
       </Docs>
@@ -138,12 +144,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapBase64Binary.Value" /> as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that is obtained from <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapBase64Binary.Value" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapDate.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapDate.xml
index ab9222160dc..5c10b9be8d8 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapDate.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapDate.xml
@@ -119,12 +119,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that indicates the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -143,7 +146,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SoapDate'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapDate.Parse(System.String)" /> method is capable of parsing strings in various formats. The recognizable string formats are composed out of the following format patterns.</para>
@@ -211,6 +213,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapDate" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapDate" /> object that is obtained from <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> to convert. </param>
       </Docs>
@@ -253,12 +259,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapDate.Value" /> as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that is obtained from <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapDate.Value" /> in the format "yyyy-MM-dd" or "'-'yyyy-MM-dd" if <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapDate.Sign" /> is negative.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapDateTime.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapDateTime.xml
index 81556ace3c3..522920ffc78 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapDateTime.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapDateTime.xml
@@ -65,7 +65,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DateTime'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The Parse method is capable of parsing strings in various formats. The recognizable string formats are composed out of the following format patterns.</para>
@@ -177,6 +176,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.DateTime" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DateTime" /> object obtained from <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The String to convert. </param>
       </Docs>
@@ -197,12 +200,15 @@
         <Parameter Name="value" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified <see cref="T:System.DateTime" /> object as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> representation of <paramref name="value" /> in the format "yyyy-MM-dd'T'HH:mm:ss.fffffffzzz".</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.DateTime" /> object to convert. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapDay.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapDay.xml
index d89b8163352..acc53c12252 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapDay.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapDay.xml
@@ -90,12 +90,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that indicates the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -114,7 +117,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SoapDay'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapDay.Parse(System.String)" /> method is capable of parsing strings in various formats. The recognizable string formats are "---ddzzz" and "---dd", which are composed out of the following format patterns.</para>
@@ -160,6 +162,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapDay" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapDay" /> object that is obtained from <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> to convert. </param>
       </Docs>
@@ -178,12 +184,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapDay.Value" /> as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> obtained from <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapDay.Value" /> in the format "---dd".</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapDuration.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapDuration.xml
index f126ddb0a0f..5267b64ac28 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapDuration.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapDuration.xml
@@ -65,12 +65,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TimeSpan'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.TimeSpan" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.TimeSpan" /> object that is obtained from <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> to convert. </param>
       </Docs>
@@ -91,12 +94,15 @@
         <Parameter Name="timeSpan" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified <see cref="T:System.TimeSpan" /> object as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> representation of <paramref name="timeSpan" /> in the format "PxxYxxDTxxHxxMxx.xxxS" or "PxxYxxDTxxHxxMxxS". The "PxxYxxDTxxHxxMxx.xxxS" is used if <see cref="P:System.TimeSpan.Milliseconds" /> does not equal zero.</para>
+        </returns>
         <param name="timeSpan">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.TimeSpan" /> object to convert. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapEntities.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapEntities.xml
index fad4c394ee4..9ebed09e7f3 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapEntities.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapEntities.xml
@@ -87,12 +87,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that indicates the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -111,12 +114,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SoapEntities'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapEntities" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapEntities" /> object that is obtained from <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The String to convert. </param>
       </Docs>
@@ -135,12 +141,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapEntities.Value" /> as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that is obtained from <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapEntities.Value" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapEntity.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapEntity.xml
index e26162ecf3c..62da94d690b 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapEntity.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapEntity.xml
@@ -87,12 +87,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that indicates the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -111,12 +114,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SoapEntity'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapEntity" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapEntities" /> object that is obtained from <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The String to convert. </param>
       </Docs>
@@ -135,12 +141,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapEntity.Value" /> as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that is obtained from <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapEntity.Value" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapHexBinary.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapHexBinary.xml
index 3cfdacb2219..61ddf683ba9 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapHexBinary.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapHexBinary.xml
@@ -90,12 +90,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that indicates the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -114,12 +117,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SoapHexBinary'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapHexBinary" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapHexBinary" /> object that is obtained from <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The String to convert. </param>
       </Docs>
@@ -138,12 +144,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapHexBinary.Value" /> as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that is obtained from <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapHexBinary.Value" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapId.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapId.xml
index 178a20746fa..0d0b1a90983 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapId.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapId.xml
@@ -87,12 +87,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that indicates the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -111,12 +114,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SoapId'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapId" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapId" /> object that is obtained from <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The String to convert. </param>
       </Docs>
@@ -135,12 +141,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapId.Value" /> as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that is obtained from <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapId.Value" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapIdref.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapIdref.xml
index a2b8cce3998..232f718ddc6 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapIdref.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapIdref.xml
@@ -87,12 +87,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that indicates the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -111,12 +114,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SoapIdref'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapIdrefs" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> obtained from <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The String to convert. </param>
       </Docs>
@@ -135,12 +141,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapIdref.Value" /> as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that is obtained from <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapIdref.Value" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapIdrefs.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapIdrefs.xml
index e73347bf50f..5249a66488d 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapIdrefs.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapIdrefs.xml
@@ -87,12 +87,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that indicates the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -111,12 +114,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SoapIdrefs'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapIdrefs" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that is obtained from <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The String to convert. </param>
       </Docs>
@@ -135,12 +141,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapIdrefs.Value" /> as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that is obtained from <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapIdrefs.Value" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapInteger.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapInteger.xml
index c27d13eff66..c2630dbba7f 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapInteger.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapInteger.xml
@@ -90,12 +90,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that indicates the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -114,12 +117,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SoapInteger'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapInteger" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapInteger" /> object that is obtained from <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> to convert. </param>
       </Docs>
@@ -138,12 +144,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapInteger.Value" /> as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that is obtained from <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapInteger.Value" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapLanguage.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapLanguage.xml
index b1484150ee4..ba43a56c72d 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapLanguage.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapLanguage.xml
@@ -87,12 +87,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that indicates the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -111,12 +114,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SoapLanguage'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapLanguage" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapLanguage" /> object that is obtained from <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The String to convert. </param>
       </Docs>
@@ -135,12 +141,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapLanguage.Value" /> as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapLanguage" /> object that is obtained from <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapLanguage.Value" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapMonth.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapMonth.xml
index 095d52f2f17..73a2f2dac72 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapMonth.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapMonth.xml
@@ -90,12 +90,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that indicates the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -114,7 +117,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SoapMonth'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapMonth.Parse(System.String)" /> method is capable of parsing strings in various formats. The recognizable string formats are composed out of the following format patterns.</para>
@@ -160,6 +162,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapMonth" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapDay" /> object that is obtained from <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The String to convert. </param>
       </Docs>
@@ -178,12 +184,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapMonth.Value" /> as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that is obtained from <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapMonth.Value" /> in the format "--MM--".</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapMonthDay.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapMonthDay.xml
index f9d0c02e675..192951755bc 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapMonthDay.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapMonthDay.xml
@@ -90,12 +90,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that indicates the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -114,7 +117,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SoapMonthDay'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapMonthDay.Parse(System.String)" /> method is capable of parsing strings in various formats. The recognizable string formats are composed out of the format patterns shown in the following table.</para>
@@ -171,6 +173,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapMonthDay" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapMonthDay" /> object that is obtained from <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> to convert. </param>
       </Docs>
@@ -189,12 +195,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapMonthDay.Value" /> as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that is obtained from <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapMonthDay.Value" /> in the format "'--'MM'-'dd".</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapName.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapName.xml
index 265e3b7cc9c..e02bd1ee639 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapName.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapName.xml
@@ -87,12 +87,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that indicates the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -111,12 +114,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SoapName'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapName" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapName" /> object that is obtained from <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The String to convert. </param>
       </Docs>
@@ -135,12 +141,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapName.Value" /> as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that is obtained from <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapName.Value" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNcName.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNcName.xml
index b7735c0a87a..c74db22c1e6 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNcName.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNcName.xml
@@ -87,12 +87,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that indicates the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -111,12 +114,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SoapNcName'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNcName" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNcName" /> object that is obtained from <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The String to convert. </param>
       </Docs>
@@ -135,12 +141,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNcName.Value" /> as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that is obtained from <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNcName.Value" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNegativeInteger.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNegativeInteger.xml
index 3f1e8eda292..ce5bbc5d8bf 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNegativeInteger.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNegativeInteger.xml
@@ -90,12 +90,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that indicates the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -114,12 +117,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SoapNegativeInteger'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNegativeInteger" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNegativeInteger" /> object that is obtained from <paramref name="value" />. </para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> to convert. </param>
       </Docs>
@@ -138,12 +144,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNegativeInteger.Value" /> as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that is obtained from Value.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNmtoken.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNmtoken.xml
index 3eaf0c1f132..37dd8d6a212 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNmtoken.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNmtoken.xml
@@ -87,12 +87,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that indicates the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -111,12 +114,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SoapNmtoken'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNmtoken" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNmtoken" /> object that is obtained from <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The String to convert. </param>
       </Docs>
@@ -135,12 +141,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNmtoken.Value" /> as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that is obtained from <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNmtoken.Value" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNmtokens.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNmtokens.xml
index 43a68c887a5..cd3b94f6fbe 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNmtokens.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNmtokens.xml
@@ -87,12 +87,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that indicates the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -111,12 +114,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SoapNmtokens'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNmtokens" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNmtokens" /> object that is obtained from <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The String to convert. </param>
       </Docs>
@@ -135,12 +141,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNmtokens.Value" /> as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that is obtained from <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNmtokens.Value" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNonNegativeInteger.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNonNegativeInteger.xml
index a1bf257edc5..853745470df 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNonNegativeInteger.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNonNegativeInteger.xml
@@ -90,12 +90,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that indicates the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -114,12 +117,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SoapNonNegativeInteger'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNonNegativeInteger" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNonNegativeInteger" /> object that is obtained from <paramref name="value" />. </para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" />  to convert. </param>
       </Docs>
@@ -138,12 +144,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNonNegativeInteger.Value" /> as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that is obtained from <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNonNegativeInteger.Value" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNonPositiveInteger.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNonPositiveInteger.xml
index a6e59b5987b..03695160f6f 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNonPositiveInteger.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNonPositiveInteger.xml
@@ -90,12 +90,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that indicates the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -114,12 +117,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SoapNonPositiveInteger'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNonPositiveInteger" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNonPositiveInteger" /> object that is obtained from <paramref name="value" /> </para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The String to convert. </param>
       </Docs>
@@ -138,12 +144,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNonPositiveInteger.Value" /> as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that is obtained from Value.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNormalizedString.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNormalizedString.xml
index 6e766e54fe9..43e6fdc9173 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNormalizedString.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNormalizedString.xml
@@ -87,12 +87,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that indicates the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -111,12 +114,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SoapNormalizedString'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNormalizedString" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNormalizedString" /> object obtained from <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The String to convert. </param>
       </Docs>
@@ -135,12 +141,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNormalizedString.Value" /> as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that is obtained from <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNormalizedString.Value" /> in the format "&lt;![CDATA[" + <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNormalizedString.Value" /> + "]]&gt;".</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNotation.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNotation.xml
index feb5b2d48fa..0de002c50d5 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNotation.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapNotation.xml
@@ -87,12 +87,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that indicates the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -111,12 +114,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SoapNotation'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNotation" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNotation" /> object that is obtained from <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The String to convert. </param>
       </Docs>
@@ -135,12 +141,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNotation.Value" /> as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that is obtained from <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapNotation.Value" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapPositiveInteger.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapPositiveInteger.xml
index c319eead332..d1e84061ac6 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapPositiveInteger.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapPositiveInteger.xml
@@ -90,12 +90,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that indicates the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -114,12 +117,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SoapPositiveInteger'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapPositiveInteger" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapPositiveInteger" /> object that is obtained from <paramref name="value" />. </para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The String to convert. </param>
       </Docs>
@@ -138,12 +144,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapPositiveInteger.Value" /> as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that is obtained from <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapPositiveInteger.Value" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapQName.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapQName.xml
index 72fb719364a..4163a527ecf 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapQName.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapQName.xml
@@ -145,12 +145,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> indicating the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Key">
@@ -232,12 +235,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SoapQName'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapQName" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapQName" /> object that is obtained from <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> to convert. </param>
       </Docs>
@@ -256,12 +262,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the qualified name as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> in the format " <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapQName.Key" /> : <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapQName.Name" /> ". If <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapQName.Key" /> is not specified, this method returns <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapQName.Name" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="XsdType">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapTime.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapTime.xml
index 035f7510cf5..4a6309babe5 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapTime.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapTime.xml
@@ -90,12 +90,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that indicates the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -114,7 +117,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SoapTime'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapTime.Parse(System.String)" /> method is capable of parsing strings in the HH:mm:ss.fffzzz format. This is composed out of the following format patterns.</para>
@@ -194,6 +196,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapTime" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapTime" /> object that is obtained from <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> to convert. </param>
       </Docs>
@@ -212,12 +218,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapTime.Value" /> as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that is obtained from <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapTime.Value" /> in the format "HH:mm:ss.fffzzz".</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapToken.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapToken.xml
index 6b620e9b844..b5c9dda508c 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapToken.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapToken.xml
@@ -87,12 +87,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that indicates the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -111,12 +114,15 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SoapToken'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapToken" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapToken" /> object that is obtained from <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The String to convert. </param>
       </Docs>
@@ -135,12 +141,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapToken.Value" /> as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that is obtained from <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapToken.Value" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapYear.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapYear.xml
index 7c73bdfbee3..ce3e2f04e75 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapYear.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapYear.xml
@@ -116,12 +116,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that indicates the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -140,7 +143,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SoapYear'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapYear.Parse(System.String)" /> method is capable of parsing strings in various formats. The recognizable string formats are composed out of the following format patterns.</para>
@@ -186,6 +188,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapYear" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapYear" /> object that is obtained from <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> to convert. </param>
       </Docs>
@@ -225,12 +231,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapYear.Value" /> as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that is obtained from <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapYear.Value" /> in the format "yyyy" or "-yyyy" if <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapYear.Sign" /> is negative.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapYearMonth.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapYearMonth.xml
index cf662285d3d..a5b67dd8781 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapYearMonth.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata.W3cXsd2001/SoapYearMonth.xml
@@ -119,12 +119,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML Schema definition language (XSD) of the current SOAP type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that indicates the XSD of the current SOAP type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -143,7 +146,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SoapYearMonth'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapYearMonth.Parse(System.String)" /> method is capable of parsing strings in various formats. The recognizable string formats are composed out of the following format patterns.</para>
@@ -200,6 +202,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.String" /> into a <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapYearMonth" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapYearMonth" /> object that is obtained from <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> to convert </param>
       </Docs>
@@ -242,12 +248,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapYearMonth.Value" /> as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> that is obtained from <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapYearMonth.Value" /> in the format "yyyy-MM" or "'-'yyyy-MM" if <see cref="P:System.Runtime.Remoting.Metadata.W3cXsd2001.SoapYearMonth.Sign" /> is negative.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata/SoapFieldAttribute.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata/SoapFieldAttribute.xml
index 5d6c1d551db..92622d16f48 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata/SoapFieldAttribute.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Metadata/SoapFieldAttribute.xml
@@ -66,12 +66,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the current attribute contains interop XML element values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current attribute contains interop XML element values; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Order">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Proxies/ProxyAttribute.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Proxies/ProxyAttribute.xml
index 61388831c5d..3acfc53c4de 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Proxies/ProxyAttribute.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Proxies/ProxyAttribute.xml
@@ -75,12 +75,15 @@
         <Parameter Name="serverType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MarshalByRefObject'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates either an uninitialized <see cref="T:System.MarshalByRefObject" /> or a transparent proxy, depending on whether the specified type can exist in the current context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An uninitialized <see cref="T:System.MarshalByRefObject" /> or a transparent proxy.</para>
+        </returns>
         <param name="serverType">
           <attribution license="cc4" from="Microsoft" modified="false" />The object type to create an instance of. </param>
       </Docs>
@@ -104,7 +107,6 @@
         <Parameter Name="serverContext" Type="System.Runtime.Remoting.Contexts.Context" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'RealProxy'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -115,6 +117,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of a remoting proxy for a remote object described by the specified <see cref="T:System.Runtime.Remoting.ObjRef" />, and located on the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new instance of remoting proxy for the remote object that is described in the specified <see cref="T:System.Runtime.Remoting.ObjRef" />.</para>
+        </returns>
         <param name="objRef">
           <attribution license="cc4" from="Microsoft" modified="false" />The object reference to the remote object for which to create a proxy. </param>
         <param name="serverType">
@@ -177,12 +183,15 @@
         <Parameter Name="msg" Type="System.Runtime.Remoting.Activation.IConstructionCallMessage" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks the specified context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The specified context.</para>
+        </returns>
         <param name="ctx">
           <attribution license="cc4" from="Microsoft" modified="false" />The context to be verified.</param>
         <param name="msg">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Proxies/RealProxy.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Proxies/RealProxy.xml
index 186d5e765a2..c62f61ecbf2 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Proxies/RealProxy.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Proxies/RealProxy.xml
@@ -156,12 +156,15 @@
         <Parameter Name="requestedType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.ObjRef'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Runtime.Remoting.ObjRef" /> for the specified object type, and registers it with the remoting infrastructure as a client-activated object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.Runtime.Remoting.ObjRef" /> that is created for the specified type.</para>
+        </returns>
         <param name="requestedType">
           <attribution license="cc4" from="Microsoft" modified="false" />The object type that an <see cref="T:System.Runtime.Remoting.ObjRef" /> is created for. </param>
       </Docs>
@@ -180,12 +183,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'MarshalByRefObject'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Detaches the current proxy instance from the remote server object that it represents.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The detached server object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetCOMIUnknown">
@@ -204,7 +210,6 @@
         <Parameter Name="fIsMarshalled" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'IntPtr'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the proxy is requested for marshaling, then an IUnknown interface for the object represented by the current proxy instance is returned. If an IUnknown was previously cached by the <see cref="M:System.Runtime.Remoting.Proxies.RealProxy.SetCOMIUnknown(System.IntPtr)" /> method, then that instance is returned; otherwise, a new instance is returned.</para>
@@ -214,6 +219,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Requests an unmanaged reference to the object represented by the current proxy instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A pointer to a <format type="text/html"><a href="D04BE3B5-27B9-4F5B-8469-A44149FABF78">[&lt;topic://cpconcomcallablewrapper&gt;]</a></format> if the object reference is requested for communication with unmanaged objects in the current process through COM, or a pointer to a cached or newly generated IUnknown COM interface if the object reference is requested for marshaling to a remote location.</para>
+        </returns>
         <param name="fIsMarshalled">
           <attribution license="cc4" from="Microsoft" modified="false" />true if the object reference is requested for marshaling to a remote location; false if the object reference is requested for communication with unmanaged objects in the current process through COM. </param>
       </Docs>
@@ -260,12 +269,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Type'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Type" /> of the object that the current instance of <see cref="T:System.Runtime.Remoting.Proxies.RealProxy" /> represents.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> of the object that the current instance of <see cref="T:System.Runtime.Remoting.Proxies.RealProxy" /> represents.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetStubData">
@@ -284,7 +296,6 @@
         <Parameter Name="rp" Type="System.Runtime.Remoting.Proxies.RealProxy" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The stub data is used by custom proxy users to decide what to do with an incoming method call. For example, the stub data might be information about the server's context that you can use to determine whether to execute the call locally, or send it through the remoting infrastructure.</para>
@@ -293,6 +304,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves stub data that is stored for the specified proxy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Stub data for the specified proxy.</para>
+        </returns>
         <param name="rp">
           <attribution license="cc4" from="Microsoft" modified="false" />The proxy for which stub data is requested. </param>
       </Docs>
@@ -311,12 +326,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the transparent proxy for the current instance of <see cref="T:System.Runtime.Remoting.Proxies.RealProxy" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The transparent proxy for the current proxy instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetUnwrappedServer">
@@ -333,7 +351,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'MarshalByRefObject'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Runtime.Remoting.Proxies.RealProxy.GetUnwrappedServer" /> method is used in scenarios involving an external <see cref="T:System.Runtime.Remoting.Contexts.Context" /> in the same <see cref="T:System.AppDomain" />.</para>
@@ -342,6 +359,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the server object that is represented by the current proxy instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The server object that is represented by the current proxy instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InitializeServerObject">
@@ -365,7 +386,6 @@
         <Parameter Name="ctorMsg" Type="System.Runtime.Remoting.Activation.IConstructionCallMessage" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.Activation.IConstructionReturnMessage'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <paramref name="ctorMsg" /> parameter is null, then the <see cref="M:System.Runtime.Remoting.Proxies.RealProxy.InitializeServerObject(System.Runtime.Remoting.Activation.IConstructionCallMessage)" /> method calls the default constructor for the new instance of the remote object that is represented by the current <see cref="T:System.Runtime.Remoting.Proxies.RealProxy" />.</para>
@@ -374,6 +394,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of the object <see cref="T:System.Type" /> of the remote object that the current instance of <see cref="T:System.Runtime.Remoting.Proxies.RealProxy" /> represents with the specified <see cref="T:System.Runtime.Remoting.Activation.IConstructionCallMessage" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of the construction request.</para>
+        </returns>
         <param name="ctorMsg">
           <attribution license="cc4" from="Microsoft" modified="false" />A construction call message that contains the constructor parameters for the new instance of the remote object that is represented by the current <see cref="T:System.Runtime.Remoting.Proxies.RealProxy" />. Can be null. </param>
       </Docs>
@@ -394,7 +418,6 @@
         <Parameter Name="msg" Type="System.Runtime.Remoting.Messaging.IMessage" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.Messaging.IMessage'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When the transparent proxy that is backed by the <see cref="T:System.Runtime.Remoting.Proxies.RealProxy" /> is called, it delegates the calls to the <see cref="M:System.Runtime.Remoting.Proxies.RealProxy.Invoke(System.Runtime.Remoting.Messaging.IMessage)" /> method. The <see cref="M:System.Runtime.Remoting.Proxies.RealProxy.Invoke(System.Runtime.Remoting.Messaging.IMessage)" /> method transforms the message in the <paramref name="msg" /> parameter into a <see cref="T:System.Runtime.Remoting.Messaging.IMethodCallMessage" />, and sends it to the remote object that is represented by the current instance of <see cref="T:System.Runtime.Remoting.Proxies.RealProxy" />.</para>
@@ -404,6 +427,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, invokes the method that is specified in the provided <see cref="T:System.Runtime.Remoting.Messaging.IMessage" /> on the remote object that is represented by the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The message returned by the invoked method, containing the return value and any out or ref parameters.</para>
+        </returns>
         <param name="msg">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Runtime.Remoting.Messaging.IMessage" /> that contains a <see cref="T:System.Collections.IDictionary" /> of information about the method call. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Services/EnterpriseServicesHelper.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Services/EnterpriseServicesHelper.xml
index 12f939e6a37..489f3e8b79d 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Services/EnterpriseServicesHelper.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting.Services/EnterpriseServicesHelper.xml
@@ -73,12 +73,15 @@
         <Parameter Name="retObj" Type="System.MarshalByRefObject" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.Activation.IConstructionReturnMessage'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Constructs a <see cref="T:System.Runtime.Remoting.Messaging.ReturnMessage" /> from the specified <see cref="T:System.Runtime.Remoting.Activation.IConstructionCallMessage" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.Activation.IConstructionReturnMessage" /> returned from the construction call that is specified in the <paramref name="ctorMsg" /> parameter.</para>
+        </returns>
         <param name="ctorMsg">
           <attribution license="cc4" from="Microsoft" modified="false" />A construction call to the object from which the new <see cref="T:System.Runtime.Remoting.Messaging.ReturnMessage" /> instance is returning. </param>
         <param name="retObj">
@@ -134,7 +137,6 @@
         <Parameter Name="punk" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Runtime.Remoting.Services.EnterpriseServicesHelper.WrapIUnknownWithComObject(System.IntPtr)" /> method is similar to the <see cref="M:System.Runtime.InteropServices.Marshal.GetObjectForIUnknown(System.IntPtr)" /> method, but does not attempt to maintain the identity of the unmanaged object. For example, two calls with the same IUnknown to the current method return two different RCWs, but two calls to the <see cref="M:System.Runtime.InteropServices.Marshal.GetObjectForIUnknown(System.IntPtr)" /> method with the same IUnknown return the same RCW.</para>
@@ -143,6 +145,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Wraps the specified IUnknown COM interface with a <format type="text/html"><a href="7E542583-1E31-4E10-B523-8CF2F29CB4A4">[&lt;topic://cpconruntimecallablewrapper&gt;]</a></format> (RCW).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The RCW where the specified IUnknown is wrapped.</para>
+        </returns>
         <param name="punk">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the IUnknown COM interface to wrap. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/ActivatedClientTypeEntry.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/ActivatedClientTypeEntry.xml
index 087cc954d49..7df6b36e5ea 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/ActivatedClientTypeEntry.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/ActivatedClientTypeEntry.xml
@@ -174,12 +174,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the type name, assembly name, and application URL of the client-activated type as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type name, assembly name, and application URL of the client-activated type as a <see cref="T:System.String" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/ActivatedServiceTypeEntry.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/ActivatedServiceTypeEntry.xml
index b30773fadc4..9cb269cf0ca 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/ActivatedServiceTypeEntry.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/ActivatedServiceTypeEntry.xml
@@ -144,12 +144,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the type and assembly name of the client-activated service type as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type and assembly name of the client-activated service type as a <see cref="T:System.String" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/IObjectHandle.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/IObjectHandle.xml
index b274b1f8364..bc263a6b39b 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/IObjectHandle.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/IObjectHandle.xml
@@ -48,12 +48,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Unwraps the object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The unwrapped object.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/IRemotingTypeInfo.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/IRemotingTypeInfo.xml
index f1ccf3dacfc..1309cecd5a7 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/IRemotingTypeInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/IRemotingTypeInfo.xml
@@ -44,7 +44,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current method is called when an attempt is made to cast a proxy generated from a <see cref="T:System.Runtime.Remoting.ObjRef" />. This method takes into account the type information carried in the <see cref="T:System.Runtime.Remoting.ObjRef" />.</para>
@@ -53,6 +52,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks whether the proxy that represents the specified object type can be cast to the type represented by the <see cref="T:System.Runtime.Remoting.IRemotingTypeInfo" /> interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if cast will succeed; otherwise, false.</para>
+        </returns>
         <param name="fromType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to cast to. </param>
         <param name="o">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/InternalRemotingServices.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/InternalRemotingServices.xml
index 4550e832c92..a9f3066dac6 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/InternalRemotingServices.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/InternalRemotingServices.xml
@@ -98,7 +98,6 @@
         <Parameter Name="reflectionObject" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Metadata.SoapAttribute'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You do not need to call the static methods of the <see cref="T:System.Runtime.Remoting.InternalRemotingServices" /> class. </para>
@@ -109,6 +108,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an appropriate SOAP-related attribute for the specified class member or method parameter. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The SOAP-related attribute for the specified class member or method parameter.</para>
+        </returns>
         <param name="reflectionObject">
           <attribution license="cc4" from="Microsoft" modified="false" />A class member or method parameter.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/ObjRef.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/ObjRef.xml
index 9823a02cad8..35a0405341c 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/ObjRef.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/ObjRef.xml
@@ -221,7 +221,6 @@
         <Parameter Name="context" Type="System.Runtime.Serialization.StreamingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current method is called during the fix-up stage of deserialization.</para>
@@ -230,6 +229,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a reference to the remote object that the <see cref="T:System.Runtime.Remoting.ObjRef" /> describes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to the remote object that the <see cref="T:System.Runtime.Remoting.ObjRef" /> describes.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The context where the current object resides. </param>
       </Docs>
@@ -248,12 +251,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Boolean value that indicates whether the current <see cref="T:System.Runtime.Remoting.ObjRef" /> instance references an object located in the current <see cref="T:System.AppDomain" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Boolean value that indicates whether the current <see cref="T:System.Runtime.Remoting.ObjRef" /> instance references an object located in the current <see cref="T:System.AppDomain" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsFromThisProcess">
@@ -275,12 +281,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Boolean value that indicates whether the current <see cref="T:System.Runtime.Remoting.ObjRef" /> instance references an object located in the current process.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Boolean value that indicates whether the current <see cref="T:System.Runtime.Remoting.ObjRef" /> instance references an object located in the current process.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TypeInfo">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/ObjectHandle.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/ObjectHandle.xml
index c6aceda1685..2ed83200c80 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/ObjectHandle.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/ObjectHandle.xml
@@ -74,12 +74,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes the lifetime lease of the wrapped object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An initialized <see cref="T:System.Runtime.Remoting.Lifetime.ILease" /> that allows you to control the lifetime of the wrapped object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Unwrap">
@@ -96,12 +99,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the wrapped object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The wrapped object.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/RemotingConfiguration.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/RemotingConfiguration.xml
index c9c08392f64..46b39cc4bf0 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/RemotingConfiguration.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/RemotingConfiguration.xml
@@ -169,7 +169,6 @@
         <Parameter Name="isLocalRequest" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Complete exception information includes the exact server exception and the server stack trace. Filtered information includes a standard remoting exception but no server stack trace.</para>
@@ -320,6 +319,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the server channels in this application domain return filtered or complete exception information to local or remote callers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if only filtered exception information is returned to local or remote callers, as specified by the <paramref name="isLocalRequest" /> parameter; false if complete exception information is returned.</para>
+        </returns>
         <param name="isLocalRequest">
           <attribution license="cc4" from="Microsoft" modified="false" />true to specify local callers; false to specify remote callers. </param>
       </Docs>
@@ -358,7 +361,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ActivatedClientTypeEntry []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a detailed description of client-activated objects, see <format type="text/html"><a href="4A791494-C18A-4711-A5C1-4AB0E49A8F1A">[&lt;topic://cpconClientActivation&gt;]</a></format>.</para>
@@ -367,6 +369,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of object types registered on the client as types that will be activated remotely.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of object types registered on the client as types that will be activated remotely.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetRegisteredActivatedServiceTypes">
@@ -383,7 +389,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ActivatedServiceTypeEntry []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a detailed description of client-activated objects, see <format type="text/html"><a href="4A791494-C18A-4711-A5C1-4AB0E49A8F1A">[&lt;topic://cpconClientActivation&gt;]</a></format>.</para>
@@ -392,6 +397,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of object types registered on the service end that can be activated on request from a client.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of object types registered on the service end that can be activated on request from a client.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetRegisteredWellKnownClientTypes">
@@ -408,7 +417,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'WellKnownClientTypeEntry []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Well-known object types can be either single call or singleton. If an object type is single call, then a new instance of it is created each time a call from the client comes in. All calls to a singleton object are handled by one instance of that object.</para>
@@ -418,6 +426,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of object types registered on the client end as well-known types.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of object types registered on the client end as well-known types.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetRegisteredWellKnownServiceTypes">
@@ -434,7 +446,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'WellKnownServiceTypeEntry []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Well-known object types can be either single call or singleton. If an object type is single call, then a new instance of it is created each time a call from the client comes in. All calls to a singleton object are handled by one instance of that object.</para>
@@ -444,6 +455,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of object types registered on the service end as well-known types.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of object types registered on the service end as well-known types.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsActivationAllowed">
@@ -462,7 +477,6 @@
         <Parameter Name="svrType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current method is used at the server end to determine whether an activation of the object <see cref="T:System.Type" /> is explicitly allowed by the server.</para>
@@ -471,6 +485,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Boolean value that indicates whether the specified <see cref="T:System.Type" /> is allowed to be client activated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Type" /> is allowed to be client activated; otherwise, false.</para>
+        </returns>
         <param name="svrType">
           <attribution license="cc4" from="Microsoft" modified="false" />The object <see cref="T:System.Type" /> to check. </param>
       </Docs>
@@ -491,12 +509,15 @@
         <Parameter Name="svrType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ActivatedClientTypeEntry'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks whether the specified object <see cref="T:System.Type" /> is registered as a remotely activated client type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Runtime.Remoting.ActivatedClientTypeEntry" /> that corresponds to the specified object type.</para>
+        </returns>
         <param name="svrType">
           <attribution license="cc4" from="Microsoft" modified="false" />The object type to check. </param>
       </Docs>
@@ -518,12 +539,15 @@
         <Parameter Name="assemblyName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ActivatedClientTypeEntry'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks whether the object specified by its type name and assembly name is registered as a remotely activated client type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Runtime.Remoting.ActivatedClientTypeEntry" /> that corresponds to the specified object type.</para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The type name of the object to check. </param>
         <param name="assemblyName">
@@ -546,12 +570,15 @@
         <Parameter Name="svrType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'WellKnownClientTypeEntry'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks whether the specified object <see cref="T:System.Type" /> is registered as a well-known client type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Runtime.Remoting.WellKnownClientTypeEntry" /> that corresponds to the specified object type.</para>
+        </returns>
         <param name="svrType">
           <attribution license="cc4" from="Microsoft" modified="false" />The object <see cref="T:System.Type" /> to check. </param>
       </Docs>
@@ -573,12 +600,15 @@
         <Parameter Name="assemblyName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'WellKnownClientTypeEntry'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks whether the object specified by its type name and assembly name is registered as a well-known client type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Runtime.Remoting.WellKnownClientTypeEntry" /> that corresponds to the specified object type.</para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The type name of the object to check. </param>
         <param name="assemblyName">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/RemotingServices.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/RemotingServices.xml
index b2071457d1d..cce2f85971e 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/RemotingServices.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/RemotingServices.xml
@@ -52,7 +52,6 @@
         <Parameter Name="url" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned proxy object points to an endpoint served by the specified well-known object. No messages are sent over the network until a method is called on the proxy.</para>
@@ -61,6 +60,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a proxy for a well-known object, given the <see cref="T:System.Type" /> and URL.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A proxy to the remote object that points to an endpoint served by the specified well-known object.</para>
+        </returns>
         <param name="classToProxy">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of a well-known object on the server end to which you want to connect. </param>
         <param name="url">
@@ -90,7 +93,6 @@
         <Parameter Name="data" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned proxy object points to an endpoint served by the specified well-known object. No messages are sent over the network until a method is called on the proxy.</para>
@@ -100,6 +102,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a proxy for a well-known object, given the <see cref="T:System.Type" />, URL, and channel-specific data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A proxy that points to an endpoint that is served by the requested well-known object.</para>
+        </returns>
         <param name="classToProxy">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the well-known object to which you want to connect. </param>
         <param name="url">
@@ -124,12 +130,15 @@
         <Parameter Name="obj" Type="System.MarshalByRefObject" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Stops an object from receiving any further messages through the registered remoting channels.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object was disconnected from the registered remoting channels successfully; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />Object to disconnect from its channel. </param>
       </Docs>
@@ -151,7 +160,6 @@
         <Parameter Name="reqMsg" Type="System.Runtime.Remoting.Messaging.IMethodCallMessage" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Messaging.IMethodReturnMessage'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current method is used in special cases by the server to forward the specified method call to another, possibly remote, object. This method can be called only when the caller is in the appropriate context.</para>
@@ -160,6 +168,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Connects to the specified remote object, and executes the provided <see cref="T:System.Runtime.Remoting.Messaging.IMethodCallMessage" /> on it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The response of the remote method.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The remote object whose method you want to call. </param>
         <param name="reqMsg">
@@ -182,7 +194,6 @@
         <Parameter Name="obj" Type="System.MarshalByRefObject" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Messaging.IMessageSink'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Envoy sinks are sinks sent along with the <see cref="T:System.Runtime.Remoting.ObjRef" /> of an object that is used when returning messages to that object. The current method returns the envoy sinks that are used during communication between the proxy of the object and the object itself.</para>
@@ -191,6 +202,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a chain of envoy sinks that should be used when sending messages to the remote object represented by the specified proxy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A chain of envoy sinks associated with the specified proxy.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The proxy of the remote object that requested envoy sinks are associated with. </param>
       </Docs>
@@ -211,7 +226,6 @@
         <Parameter Name="obj" Type="System.MarshalByRefObject" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For the default lifetime service the returned object will be an object of type <see cref="T:System.Runtime.Remoting.Lifetime.ILease" />. If the <paramref name="obj" /> parameter is null, the method returns null.</para>
@@ -220,6 +234,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a lifetime service object that controls the lifetime policy of the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object that controls the lifetime of <paramref name="obj" />.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to obtain lifetime service for. </param>
       </Docs>
@@ -240,7 +258,6 @@
         <Parameter Name="msg" Type="System.Runtime.Remoting.Messaging.IMethodMessage" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.MethodBase'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This determines the method base from the <see cref="P:System.Runtime.Remoting.Messaging.IMethodMessage.TypeName" />, <see cref="P:System.Runtime.Remoting.Messaging.IMethodMessage.MethodName" />, and <see cref="P:System.Runtime.Remoting.Messaging.IMethodMessage.MethodSignature" /> properties of <see cref="T:System.Runtime.Remoting.Messaging.IMethodMessage" /> and is used by classes implementing the <see cref="T:System.Runtime.Remoting.Messaging.IMethodMessage" /> interface. Consumers of <see cref="T:System.Runtime.Remoting.Messaging.IMethodMessage" /> classes should reference the <see cref="P:System.Runtime.Remoting.Messaging.IMethodMessage.MethodBase" /> property.</para>
@@ -249,6 +266,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the method base from the given <see cref="T:System.Runtime.Remoting.Messaging.IMethodMessage" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The method base extracted from the <paramref name="msg" /> parameter.</para>
+        </returns>
         <param name="msg">
           <attribution license="cc4" from="Microsoft" modified="false" />The method message to extract the method base from. </param>
       </Docs>
@@ -300,12 +321,15 @@
         <Parameter Name="obj" Type="System.MarshalByRefObject" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the URI for the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The URI of the specified object if it has one, or null if the object has not yet been marshaled.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.MarshalByRefObject" /> for which a URI is requested. </param>
       </Docs>
@@ -326,7 +350,6 @@
         <Parameter Name="obj" Type="System.MarshalByRefObject" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ObjRef'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A <see cref="T:System.Runtime.Remoting.ObjRef" /> is a serializable representation of an object used to transfer an object reference across an application domain boundary. Creating a <see cref="T:System.Runtime.Remoting.ObjRef" /> for an object is known as marshaling. The <see cref="T:System.Runtime.Remoting.ObjRef" /> can be transferred through a channel into another application domain (possibly on another process or computer). Once in the other application domain, the <see cref="T:System.Runtime.Remoting.ObjRef" /> must be parsed to create a proxy for the object, generally connected to the real object. This operation is known as unmarshaling. During unmarshaling, the <see cref="T:System.Runtime.Remoting.ObjRef" /> is parsed to extract the method information of the remote object and both the transparent proxy and <see cref="T:System.Runtime.Remoting.Proxies.RealProxy" /> objects are created.</para>
@@ -336,6 +359,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Runtime.Remoting.ObjRef" /> that represents the remote object from the specified proxy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Remoting.ObjRef" /> that represents the remote object the specified proxy is connected to, or null if the object or proxy have not been marshaled.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />A proxy connected to the object you want to create a <see cref="T:System.Runtime.Remoting.ObjRef" /> for. </param>
       </Docs>
@@ -361,7 +388,6 @@
         <Parameter Name="proxy" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Proxies.RealProxy'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A client that uses an object across any kind of remoting boundary is actually using a transparent proxy for the object. The transparent proxy gives the impression that the actual object resides in the client's space. It achieves this by forwarding calls made on it to the real object using the remoting infrastructure.</para>
@@ -372,6 +398,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the real proxy backing the specified transparent proxy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The real proxy instance backing the transparent proxy.</para>
+        </returns>
         <param name="proxy">
           <attribution license="cc4" from="Microsoft" modified="false" />A transparent proxy. </param>
       </Docs>
@@ -392,7 +422,6 @@
         <Parameter Name="URI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Type'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Because remoting identifies endpoints using URIs, the <see cref="M:System.Runtime.Remoting.RemotingServices.GetServerTypeForUri(System.String)" /> method is very useful in the pluggable parts of the remoting infrastructure (for example, channel sinks, dynamic sinks, and context sinks) that use <see cref="T:System.Runtime.Remoting.Messaging.IMessage" /> objects, because the current method will return the associated type object from the URI.</para>
@@ -401,6 +430,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Type" /> of the object with the specified URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> of the object with the specified URI.</para>
+        </returns>
         <param name="URI">
           <attribution license="cc4" from="Microsoft" modified="false" />The URI of the object whose <see cref="T:System.Type" /> is requested. </param>
       </Docs>
@@ -421,7 +454,6 @@
         <Parameter Name="msg" Type="System.Runtime.Remoting.Messaging.IMethodMessage" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The same session ID might be returned for objects in the same application, but this method will never return the same session ID for two objects in different remote applications.</para>
@@ -431,6 +463,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a session ID for a message.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A session ID string that uniquely identifies the current session.</para>
+        </returns>
         <param name="msg">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Runtime.Remoting.Messaging.IMethodMessage" /> for which a session ID is requested. </param>
       </Docs>
@@ -451,12 +487,15 @@
         <Parameter Name="msg" Type="System.Runtime.Remoting.Messaging.IMethodMessage" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Boolean value that indicates whether the method in the given message is overloaded.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the method called in <paramref name="msg" /> is overloaded; otherwise, false.</para>
+        </returns>
         <param name="msg">
           <attribution license="cc4" from="Microsoft" modified="false" />The message that contains a call to the method in question. </param>
       </Docs>
@@ -477,7 +516,6 @@
         <Parameter Name="tp" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For information about application domains, see <format type="text/html"><a href="39E57D07-A740-4CD4-AE82-E119EA3856C1">Application Domains</a></format>.</para>
@@ -486,6 +524,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Boolean value that indicates whether the object specified by the given transparent proxy is contained in a different application domain than the object that called the current method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object is out of the current application domain; otherwise, false.</para>
+        </returns>
         <param name="tp">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to check. </param>
       </Docs>
@@ -506,7 +548,6 @@
         <Parameter Name="tp" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A context is an ordered sequence of properties that define an environment for the objects that reside inside it. Contexts are created during the activation process for objects that are configured to require certain automatic services such synchronization, transactions, just-in-time activation, security, and so on. Multiple objects can live inside a context.</para>
@@ -515,6 +556,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Boolean value that indicates whether the object represented by the given proxy is contained in a different context than the object that called the current method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the object is out of the current context; otherwise, false.</para>
+        </returns>
         <param name="tp">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to check. </param>
       </Docs>
@@ -535,7 +580,6 @@
         <Parameter Name="method" Type="System.Reflection.MethodBase" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When a one-way method is called, the client does not wait for the server to finish processing the message. The client method returns to the application with no knowledge of whether or not the server will successfully process the message. Methods are marked as one way using the <see cref="T:System.Runtime.Remoting.Messaging.OneWayAttribute" />.</para>
@@ -545,6 +589,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Boolean value that indicates whether the client that called the method specified in the given message is waiting for the server to finish processing the method before continuing execution.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the method is one way; otherwise, false.</para>
+        </returns>
         <param name="method">
           <attribution license="cc4" from="Microsoft" modified="false" />The method in question. </param>
       </Docs>
@@ -570,7 +618,6 @@
         <Parameter Name="proxy" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A client that uses an object across any kind of a remoting boundary is actually using a transparent proxy for the object. The transparent proxy gives the impression that the actual object resides in the client's space. It achieves this by forwarding calls made on it to the real object using the remoting infrastructure.</para>
@@ -581,6 +628,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Boolean value that indicates whether the given object is a transparent proxy or a real object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Boolean value that indicates whether the object specified in the <paramref name="proxy" /> parameter is a transparent proxy or a real object.</para>
+        </returns>
         <param name="proxy">
           <attribution license="cc4" from="Microsoft" modified="false" />The reference to the object to check. </param>
       </Docs>
@@ -637,7 +688,6 @@
         <Parameter Name="Obj" Type="System.MarshalByRefObject" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ObjRef'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A <see cref="T:System.Runtime.Remoting.ObjRef" /> is a serializable representation of an object used to transfer an object reference across an application domain boundary. Creating a <see cref="T:System.Runtime.Remoting.ObjRef" /> for an object is known as marshaling. The <see cref="T:System.Runtime.Remoting.ObjRef" /> can be transferred through a channel into another application domain (possibly on another process or computer). Once in the other application domain, the <see cref="T:System.Runtime.Remoting.ObjRef" /> must be parsed to create a proxy for the object, generally connected to the real object. This operation is known as unmarshaling. </para>
@@ -649,6 +699,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Takes a <see cref="T:System.MarshalByRefObject" />, registers it with the remoting infrastructure, and converts it into an instance of the <see cref="T:System.Runtime.Remoting.ObjRef" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the <see cref="T:System.Runtime.Remoting.ObjRef" /> class that represents the object specified in the <paramref name="Obj" /> parameter.</para>
+        </returns>
         <param name="Obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to convert. </param>
       </Docs>
@@ -670,7 +724,6 @@
         <Parameter Name="URI" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ObjRef'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A <see cref="T:System.Runtime.Remoting.ObjRef" /> is a serializable representation of an object used to transfer an object reference across an application domain boundary. Creating a <see cref="T:System.Runtime.Remoting.ObjRef" /> for an object is known as marshaling. The <see cref="T:System.Runtime.Remoting.ObjRef" /> can be transferred through a channel into another application domain (possibly on another process or computer). Once in the other application domain, the <see cref="T:System.Runtime.Remoting.ObjRef" /> must be parsed to create a proxy for the object, generally connected to the real object. This operation is known as unmarshaling. </para>
@@ -682,6 +735,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the given <see cref="T:System.MarshalByRefObject" /> into an instance of the <see cref="T:System.Runtime.Remoting.ObjRef" /> class with the specified URI.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the <see cref="T:System.Runtime.Remoting.ObjRef" /> class that represents the object specified in the <paramref name="Obj" /> parameter.</para>
+        </returns>
         <param name="Obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to convert. </param>
         <param name="URI">
@@ -706,7 +763,6 @@
         <Parameter Name="RequestedType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ObjRef'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A <see cref="T:System.Runtime.Remoting.ObjRef" /> is a serializable representation of an object used to transfer an object reference across an application domain boundary. Creating a <see cref="T:System.Runtime.Remoting.ObjRef" /> for an object is known as marshaling. The <see cref="T:System.Runtime.Remoting.ObjRef" /> can be transferred through a channel into another application domain (possibly on another process or computer). Once in the other application domain, the <see cref="T:System.Runtime.Remoting.ObjRef" /> must be parsed to create a proxy for the object, generally connected to the real object. This operation is known as unmarshaling. </para>
@@ -719,6 +775,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Takes a <see cref="T:System.MarshalByRefObject" /> and converts it into an instance of the <see cref="T:System.Runtime.Remoting.ObjRef" /> class with the specified URI, and the provided <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the <see cref="T:System.Runtime.Remoting.ObjRef" /> class that represents the object specified in the <paramref name="Obj" /> parameter.</para>
+        </returns>
         <param name="Obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to convert into a <see cref="T:System.Runtime.Remoting.ObjRef" />. </param>
         <param name="ObjURI">
@@ -776,7 +836,6 @@
         <Parameter Name="objectRef" Type="System.Runtime.Remoting.ObjRef" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A <see cref="T:System.Runtime.Remoting.ObjRef" /> is a serializable representation of an object used to transfer an object reference across an application domain boundary. Creating a <see cref="T:System.Runtime.Remoting.ObjRef" /> for an object is known as marshaling. The <see cref="T:System.Runtime.Remoting.ObjRef" /> can be transferred through a channel into another application domain (possibly on another process or computer). Once in the other application domain, the <see cref="T:System.Runtime.Remoting.ObjRef" /> must be parsed to create a proxy for the object, generally connected to the real object. This operation is known as unmarshaling. During unmarshaling, the <see cref="T:System.Runtime.Remoting.ObjRef" /> is parsed to extract the method information of the remote object and both the transparent proxy and <see cref="T:System.Runtime.Remoting.Proxies.RealProxy" /> objects are created. The content of the parsed <see cref="T:System.Runtime.Remoting.ObjRef" /> is added to the transparent proxy before the transparent proxy is registered with the common language runtime.</para>
@@ -786,6 +845,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Takes a <see cref="T:System.Runtime.Remoting.ObjRef" /> and creates a proxy object out of it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A proxy to the object that the given <see cref="T:System.Runtime.Remoting.ObjRef" /> represents.</para>
+        </returns>
         <param name="objectRef">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Runtime.Remoting.ObjRef" /> that represents the remote object for which the proxy is being created. </param>
       </Docs>
@@ -807,7 +870,6 @@
         <Parameter Name="fRefine" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A <see cref="T:System.Runtime.Remoting.ObjRef" /> is a serializable representation of an object used to transfer an object reference across an application domain boundary. Creating a <see cref="T:System.Runtime.Remoting.ObjRef" /> for an object is known as marshaling. The <see cref="T:System.Runtime.Remoting.ObjRef" /> can be transferred through a channel into another application domain (possibly on another process or computer). Once in the other application domain, the <see cref="T:System.Runtime.Remoting.ObjRef" /> must be parsed to create a proxy for the object, generally connected to the real object. This operation is known as unmarshaling. During unmarshaling, the <see cref="T:System.Runtime.Remoting.ObjRef" /> is parsed to extract the method information of the remote object and both the transparent proxy and <see cref="T:System.Runtime.Remoting.Proxies.RealProxy" /> objects are created. The content of the parsed <see cref="T:System.Runtime.Remoting.ObjRef" /> is added to the transparent proxy before the transparent proxy is registered with the common language runtime.</para>
@@ -818,6 +880,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Takes a <see cref="T:System.Runtime.Remoting.ObjRef" /> and creates a proxy object out of it, refining it to the type on the server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A proxy to the object that the given <see cref="T:System.Runtime.Remoting.ObjRef" /> represents.</para>
+        </returns>
         <param name="objectRef">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Runtime.Remoting.ObjRef" /> that represents the remote object for which the proxy is being created. </param>
         <param name="fRefine">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/SoapServices.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/SoapServices.xml
index 48e4de4f640..a211f3bddc8 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/SoapServices.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/SoapServices.xml
@@ -47,7 +47,6 @@
         <Parameter Name="assemblyName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current method is used by the .NET Framework and the SoapSuds tool to create an XML namespace name for a common language runtime object type.</para>
@@ -57,6 +56,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the common language runtime type namespace name from the provided namespace and assembly names.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The common language runtime type namespace name from the provided namespace and assembly names.</para>
+        </returns>
         <param name="typeNamespace">
           <attribution license="cc4" from="Microsoft" modified="false" />The namespace that is to be coded. </param>
         <param name="assemblyName">
@@ -164,7 +167,6 @@
         <Parameter Name="xmlNamespace" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Type'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current method returns values set up through <see cref="M:System.Runtime.Remoting.SoapServices.RegisterInteropXmlElement(System.String,System.String,System.Type)" /> and <see cref="M:System.Runtime.Remoting.SoapServices.PreLoad(System.Type)" />.</para>
@@ -173,6 +175,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the <see cref="T:System.Type" /> that should be used during deserialization of an unrecognized object type with the given XML element name and namespace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> of object associated with the specified XML element name and namespace.</para>
+        </returns>
         <param name="xmlElement">
           <attribution license="cc4" from="Microsoft" modified="false" />The XML element name of the unknown object type. </param>
         <param name="xmlNamespace">
@@ -196,7 +202,6 @@
         <Parameter Name="xmlTypeNamespace" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Type'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current method returns values set up through <see cref="M:System.Runtime.Remoting.SoapServices.RegisterInteropXmlType(System.String,System.String,System.Type)" /> and <see cref="M:System.Runtime.Remoting.SoapServices.PreLoad(System.Type)" />.</para>
@@ -205,6 +210,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the object <see cref="T:System.Type" /> that should be used during deserialization of an unrecognized object type with the given XML type name and namespace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> of object associated with the specified XML type name and namespace.</para>
+        </returns>
         <param name="xmlType">
           <attribution license="cc4" from="Microsoft" modified="false" />The XML type of the unknown object type. </param>
         <param name="xmlTypeNamespace">
@@ -227,7 +236,6 @@
         <Parameter Name="mb" Type="System.Reflection.MethodBase" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the given <see cref="T:System.Reflection.MethodBase" /> has not been registered with any SOAPAction value, the <see cref="M:System.Runtime.Remoting.SoapServices.GetSoapActionFromMethodBase(System.Reflection.MethodBase)" /> method returns the SOAPAction automatically cached with the <see cref="T:System.Reflection.MethodBase" />.</para>
@@ -236,6 +244,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the SOAPAction value associated with the method specified in the given <see cref="T:System.Reflection.MethodBase" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The SOAPAction value associated with the method specified in the given <see cref="T:System.Reflection.MethodBase" />.</para>
+        </returns>
         <param name="mb">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.MethodBase" /> that contains the method for which a SOAPAction is requested. </param>
       </Docs>
@@ -308,12 +320,15 @@
         <Parameter Name="mb" Type="System.Reflection.MethodBase" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the XML namespace used during remote calls of the method specified in the given <see cref="T:System.Reflection.MethodBase" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XML namespace used during remote calls of the specified method.</para>
+        </returns>
         <param name="mb">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.MethodBase" /> of the method for which the XML namespace was requested. </param>
       </Docs>
@@ -334,12 +349,15 @@
         <Parameter Name="mb" Type="System.Reflection.MethodBase" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the XML namespace used during the generation of responses to the remote call to the method specified in the given <see cref="T:System.Reflection.MethodBase" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XML namespace used during the generation of responses to a remote method call.</para>
+        </returns>
         <param name="mb">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Reflection.MethodBase" /> of the method for which the XML namespace was requested. </param>
       </Docs>
@@ -386,7 +404,6 @@
         <Parameter Name="namespaceString" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current method is used by the SoapSuds tool to determine whether an XML namespace represents a common language runtime type or a type from a non-common language runtime system.</para>
@@ -396,6 +413,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Boolean value that indicates whether the specified namespace is native to the common language runtime.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the given namespace is native to the common language runtime; otherwise, false.</para>
+        </returns>
         <param name="namespaceString">
           <attribution license="cc4" from="Microsoft" modified="false" />The namespace to check in the common language runtime. </param>
       </Docs>
@@ -417,12 +438,15 @@
         <Parameter Name="mb" Type="System.Reflection.MethodBase" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the specified SOAPAction is acceptable for a given <see cref="T:System.Reflection.MethodBase" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified SOAPAction is acceptable for a given <see cref="T:System.Reflection.MethodBase" />; otherwise, false.</para>
+        </returns>
         <param name="soapAction">
           <attribution license="cc4" from="Microsoft" modified="false" />The SOAPAction to check against the given <see cref="T:System.Reflection.MethodBase" />. </param>
         <param name="mb">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/WellKnownClientTypeEntry.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/WellKnownClientTypeEntry.xml
index 6651fb48213..c30cdb1119d 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/WellKnownClientTypeEntry.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/WellKnownClientTypeEntry.xml
@@ -169,7 +169,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <see cref="P:System.Runtime.Remoting.WellKnownClientTypeEntry.ApplicationUrl" /> is not null, it is returned at the end of the string.</para>
@@ -178,6 +177,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the full type name, assembly name, and object URL of the server-activated client type as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The full type name, assembly name, and object URL of the server-activated client type as a <see cref="T:System.String" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/WellKnownServiceTypeEntry.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/WellKnownServiceTypeEntry.xml
index a787c2d984e..eaee418dc13 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/WellKnownServiceTypeEntry.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Remoting/WellKnownServiceTypeEntry.xml
@@ -198,12 +198,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the type name, assembly name, object URI and the <see cref="T:System.Runtime.Remoting.WellKnownObjectMode" /> of the server-activated type as a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type name, assembly name, object URI, and the <see cref="T:System.Runtime.Remoting.WellKnownObjectMode" /> of the server-activated type as a <see cref="T:System.String" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization.Formatters.Binary/BinaryFormatter.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization.Formatters.Binary/BinaryFormatter.xml
index 723cfc652bc..2a2f8fc5bfa 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization.Formatters.Binary/BinaryFormatter.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization.Formatters.Binary/BinaryFormatter.xml
@@ -369,7 +369,6 @@
         <Parameter Name="serializationStream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For successful deserialization, the current position in the stream must be at the beginning of the object graph.</para>
@@ -381,6 +380,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes the specified stream into an object graph.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The top (root) of the object graph.</para>
+        </returns>
         <param name="serializationStream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream from which to deserialize the object graph. </param>
       </Docs>
@@ -402,7 +405,6 @@
         <Parameter Name="handler" Type="System.Runtime.Remoting.Messaging.HeaderHandler" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Headers are used only for specific remoting applications.</para>
@@ -415,6 +417,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes the specified stream into an object graph. The provided <see cref="T:System.Runtime.Remoting.Messaging.HeaderHandler" /> handles any headers in that stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The deserialized object or the top object (root) of the object graph.</para>
+        </returns>
         <param name="serializationStream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream from which to deserialize the object graph. </param>
         <param name="handler">
@@ -439,7 +445,6 @@
         <Parameter Name="methodCallMessage" Type="System.Runtime.Remoting.Messaging.IMethodCallMessage" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Details about the caller object are not sent to the remote object during the method call. Instead, these details are obtained from the original method call that is passed to the current method in the <paramref name="methodCallMessage" /> parameter.</para>
@@ -449,6 +454,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes a response to a remote method call from the provided <see cref="T:System.IO.Stream" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The deserialized response to the remote method call.</para>
+        </returns>
         <param name="serializationStream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream from which to deserialize the object graph. </param>
         <param name="handler">
@@ -611,7 +620,6 @@
         <Parameter Name="handler" Type="System.Runtime.Remoting.Messaging.HeaderHandler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Headers are used only for specific remoting applications.</para>
@@ -625,6 +633,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes the specified stream into an object graph. The provided <see cref="T:System.Runtime.Remoting.Messaging.HeaderHandler" /> handles any headers in that stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The deserialized object or the top object (root) of the object graph.</para>
+        </returns>
         <param name="serializationStream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream from which to deserialize the object graph. </param>
         <param name="handler">
@@ -654,7 +666,6 @@
         <Parameter Name="methodCallMessage" Type="System.Runtime.Remoting.Messaging.IMethodCallMessage" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Details about the caller object are not sent to the remote object during the method call. Instead, these details are obtained from the original method call that is passed to the current method in the <paramref name="methodCallMessage" /> parameter.</para>
@@ -668,6 +679,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes a response to a remote method call from the provided <see cref="T:System.IO.Stream" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The deserialized response to the remote method call.</para>
+        </returns>
         <param name="serializationStream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream from which to deserialize the object graph. </param>
         <param name="handler">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization.Formatters/InternalRM.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization.Formatters/InternalRM.xml
index 264abc2d0d4..6d4a1ab1cea 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization.Formatters/InternalRM.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization.Formatters/InternalRM.xml
@@ -97,13 +97,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks if SOAP tracing is enabled.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if tracing is enabled; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization.Formatters/InternalST.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization.Formatters/InternalST.xml
index 976204000d0..9660d4037ea 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization.Formatters/InternalST.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization.Formatters/InternalST.xml
@@ -81,13 +81,16 @@
         <Parameter Name="assemblyString" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads a specified assembly to debug.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Reflection.Assembly" /> to debug.</para>
+        </returns>
         <param name="assemblyString">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the assembly to load.</param>
       </Docs>
@@ -205,13 +208,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks if SOAP tracing is enabled.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true, if tracing is enabled; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/Formatter.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/Formatter.xml
index 07c38772cfa..9d482097f51 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/Formatter.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/Formatter.xml
@@ -124,12 +124,15 @@
         <Parameter Name="serializationStream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, deserializes the stream attached to the formatter when it was created, creating a graph of objects identical to the graph originally serialized into that stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The top object of the deserialized graph of objects.</para>
+        </returns>
         <param name="serializationStream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream to deserialize. </param>
       </Docs>
@@ -220,7 +223,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -230,6 +232,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Schedules an object for later serialization.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object ID assigned to the object.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to schedule for serialization. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/FormatterConverter.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/FormatterConverter.xml
index 1b637b39c38..841adab9dd1 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/FormatterConverter.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/FormatterConverter.xml
@@ -67,12 +67,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to the given <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" /> or null if the <paramref name="type" /> parameter is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to convert. </param>
         <param name="type">
@@ -96,12 +99,15 @@
         <Parameter Name="typeCode" Type="System.TypeCode" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to the given <see cref="T:System.TypeCode" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" />, or null if the <paramref name="type" /> parameter is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to convert. </param>
         <param name="typeCode">
@@ -124,7 +130,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses the invariant culture (see <see cref="P:System.Globalization.CultureInfo.InvariantCulture" />). To use the current culture or to specify a culture, use the <see cref="M:System.Convert.ToBoolean(System.Object)" /> method instead. For more information, see <see cref="T:System.Boolean" />, <see cref="T:System.Convert" />, and <see cref="T:System.ValueType" />.) </para>
@@ -133,6 +138,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to a <see cref="T:System.Boolean" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" /> or null if the <paramref name="type" /> parameter is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to convert. </param>
       </Docs>
@@ -153,7 +162,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses the invariant culture (see <see cref="P:System.Globalization.CultureInfo.InvariantCulture" />). To use the current culture or to specify a culture, use the <see cref="M:System.Convert.ToByte(System.Object)" /> method instead. For more information, see <see cref="T:System.Byte" />, <see cref="T:System.Convert" /> and <see cref="T:System.ValueType" />.</para>
@@ -162,6 +170,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to an 8-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" /> or null if the <paramref name="type" /> parameter is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to convert. </param>
       </Docs>
@@ -182,7 +194,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'char'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses the invariant culture (see <see cref="P:System.Globalization.CultureInfo.InvariantCulture" />). To use the current culture or to specify a culture, use the <see cref="M:System.Convert.ToChar(System.Object)" /> method instead. For more information, see <see cref="T:System.Char" />, <see cref="T:System.Convert" />, and <see cref="T:System.ValueType" />.</para>
@@ -191,6 +202,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to a Unicode character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" /> or null if the <paramref name="type" /> parameter is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to convert. </param>
       </Docs>
@@ -211,7 +226,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DateTime'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses the invariant culture (see <see cref="P:System.Globalization.CultureInfo.InvariantCulture" />). To use the current culture or to specify a culture, use the <see cref="M:System.Convert.ToDateTime(System.DateTime)" /> method instead. For more information, see <see cref="T:System.DateTime" />, <see cref="T:System.Convert" />, and <see cref="T:System.ValueType" />.</para>
@@ -220,6 +234,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to a <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" /> or null if the <paramref name="type" /> parameter is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to convert. </param>
       </Docs>
@@ -240,7 +258,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'decimal'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses the invariant culture (see <see cref="P:System.Globalization.CultureInfo.InvariantCulture" />). To use the current culture or to specify a culture, use the <see cref="M:System.Convert.ToDecimal(System.Object)" /> method instead. For more information, see <see cref="T:System.Decimal" />, <see cref="T:System.Convert" />, and <see cref="T:System.ValueType" />.</para>
@@ -249,6 +266,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to a <see cref="T:System.Decimal" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" /> or null if the <paramref name="type" /> parameter is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to convert. </param>
       </Docs>
@@ -269,7 +290,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'double'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses the invariant culture (see <see cref="P:System.Globalization.CultureInfo.InvariantCulture" />). To use the current culture or to specify a culture, use the <see cref="M:System.Convert.ToDouble(System.Object)" /> method instead. For more information, see <see cref="T:System.Double" />, <see cref="T:System.Convert" />, and <see cref="T:System.ValueType" />.</para>
@@ -278,6 +298,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to a double-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" /> or null if the <paramref name="type" /> parameter is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to convert. </param>
       </Docs>
@@ -298,7 +322,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'short'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses the invariant culture (see <see cref="P:System.Globalization.CultureInfo.InvariantCulture" />). To use the current culture or to specify a culture, use the <see cref="M:System.Convert.ToInt16(System.Object)" /> method instead. For more information, see <see cref="T:System.Int16" />, <see cref="T:System.Convert" />, and <see cref="T:System.ValueType" />.</para>
@@ -307,6 +330,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to a 16-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" /> or null if the <paramref name="type" /> parameter is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to convert. </param>
       </Docs>
@@ -327,7 +354,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses the invariant culture (see <see cref="P:System.Globalization.CultureInfo.InvariantCulture" />). To use the current culture or to specify a culture, use the <see cref="M:System.Convert.ToInt32(System.Object)" /> method instead. For more information, see <see cref="T:System.Int32" />, <see cref="T:System.Convert" />, and <see cref="T:System.ValueType" />.</para>
@@ -336,6 +362,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to a 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" /> or null if the <paramref name="type" /> parameter is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to convert. </param>
       </Docs>
@@ -356,7 +386,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses the invariant culture (see <see cref="P:System.Globalization.CultureInfo.InvariantCulture" />). To use the current culture or to specify a culture, use the <see cref="M:System.Convert.ToInt64(System.Object)" /> method instead. For more information, see <see cref="T:System.Int64" />, <see cref="T:System.Convert" />, and <see cref="T:System.ValueType" />.</para>
@@ -365,6 +394,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to a 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" /> or null if the <paramref name="type" /> parameter is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to convert. </param>
       </Docs>
@@ -390,7 +423,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'sbyte'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses the invariant culture (see <see cref="P:System.Globalization.CultureInfo.InvariantCulture" />). To use the current culture or to specify a culture, use the <see cref="M:System.Convert.ToSByte(System.Object)" /> method instead. For more information, see <see cref="T:System.SByte" />, <see cref="T:System.Convert" />, and <see cref="T:System.ValueType" />.</para>
@@ -399,6 +431,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to a <see cref="T:System.SByte" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" /> or null if the <paramref name="type" /> parameter is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to convert. </param>
       </Docs>
@@ -419,7 +455,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'float'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses the invariant culture (see <see cref="P:System.Globalization.CultureInfo.InvariantCulture" />). To use the current culture or to specify a culture, use the <see cref="M:System.Convert.ToSingle(System.Object)" /> method instead. For more information, see <see cref="T:System.Single" />, <see cref="T:System.Convert" />, and <see cref="T:System.ValueType" />.</para>
@@ -428,6 +463,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to a single-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" /> or null if the <paramref name="type" /> parameter is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to convert. </param>
       </Docs>
@@ -448,7 +487,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses the invariant culture (see <see cref="P:System.Globalization.CultureInfo.InvariantCulture" />). To use the current culture or to specify a culture, use the <see cref="M:System.Convert.ToString(System.Object)" /> method instead. For more information, see <see cref="T:System.String" />, <see cref="T:System.Convert" />, and <see cref="T:System.ValueType" />.</para>
@@ -457,6 +495,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object to a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" /> or null if the <paramref name="type" /> parameter is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to convert. </param>
       </Docs>
@@ -482,7 +524,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ushort'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses the invariant culture (see <see cref="P:System.Globalization.CultureInfo.InvariantCulture" />). To use the current culture or to specify a culture, use the <see cref="M:System.Convert.ToUInt16(System.Object)" /> method instead. For more information, see <see cref="T:System.UInt16" />, <see cref="T:System.Convert" />, and <see cref="T:System.ValueType" />.</para>
@@ -491,6 +532,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to a 16-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" /> or null if the <paramref name="type" /> parameter is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to convert. </param>
       </Docs>
@@ -516,7 +561,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'uint'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses the invariant culture (see <see cref="P:System.Globalization.CultureInfo.InvariantCulture" />). To use the current culture or to specify a culture, use the <see cref="M:System.Convert.ToUInt32(System.Object)" /> method instead. For more information, see <see cref="T:System.UInt32" />, <see cref="T:System.Convert" />, and <see cref="T:System.ValueType" />.</para>
@@ -525,6 +569,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to a 32-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" /> or null if the <paramref name="type" /> parameter is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to convert. </param>
       </Docs>
@@ -550,7 +598,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ulong'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses the invariant culture (see <see cref="P:System.Globalization.CultureInfo.InvariantCulture" />). To use the current culture or to specify a culture, use the <see cref="M:System.Convert.ToUInt64(System.Object)" /> method instead. For more information, see <see cref="T:System.UInt64" />, <see cref="T:System.Convert" />, and <see cref="T:System.ValueType" />.</para>
@@ -559,6 +606,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to a 64-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" /> or null if the <paramref name="type" /> parameter is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to convert. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/FormatterServices.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/FormatterServices.xml
index 43def423fdb..c675e8ad1c3 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/FormatterServices.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/FormatterServices.xml
@@ -76,7 +76,6 @@
         <Parameter Name="members" Type="System.Reflection.MemberInfo[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For each supplied member of the <paramref name="members" /> array the <see cref="M:System.Runtime.Serialization.FormatterServices.GetObjectData(System.Object,System.Reflection.MemberInfo[])" /> method extracts the value associated with the <paramref name="obj" /> object, and returns it. The length of the returned array is the same as the length of the <paramref name="members" /> array.</para>
@@ -85,6 +84,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Extracts the data from the specified object and returns it as an array of objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Object" /> that contains data stored in <paramref name="members" /> and associated with <paramref name="obj" />.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to write to the formatter. </param>
         <param name="members">
@@ -107,7 +110,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Because the new instance of the object is initialized to zero and no constructors are run, the object might not represent a state that is regarded as valid by that object. <see cref="M:System.Runtime.Serialization.FormatterServices.GetSafeUninitializedObject(System.Type)" /> should only be used for deserialization when the user intends to immediately populate all fields. It does not create an uninitialized string, since creating an empty instance of an immutable type serves no purpose.</para>
@@ -118,6 +120,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the specified object type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A zeroed object of the specified type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of object to create. </param>
       </Docs>
@@ -138,7 +144,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.MemberInfo []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generally, the serializable members of a class are the non-transient, non-static members such as fields and properties. To be included, properties must have both a getter and a setter. A class that implements the <see cref="T:System.Runtime.Serialization.ISerializable" /> interface or has a serialization surrogate does not have to serialize all these members, or can serialize additional members.</para>
@@ -147,6 +152,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all the serializable members for a class of the specified <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Reflection.MemberInfo" /> of the non-transient, non-static members.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type being serialized. </param>
       </Docs>
@@ -168,7 +177,6 @@
         <Parameter Name="context" Type="System.Runtime.Serialization.StreamingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.MemberInfo []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generally, the serializable members of a class are the non-transient, non-static members such as fields and properties. To be included, properties must have both a getter and a setter. A class that implements <see cref="T:System.Runtime.Serialization.ISerializable" /> or has a serialization surrogate does not have to serialize all these members, or can serialize additional members.</para>
@@ -178,6 +186,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all the serializable members for a class of the specified <see cref="T:System.Type" /> and in the provided <see cref="T:System.Runtime.Serialization.StreamingContext" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Reflection.MemberInfo" /> of the non-transient, non-static members.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type being serialized or cloned. </param>
         <param name="context">
@@ -203,12 +215,15 @@
         <Parameter Name="innerSurrogate" Type="System.Runtime.Serialization.ISerializationSurrogate" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a serialization surrogate for the specified <see cref="T:System.Runtime.Serialization.ISerializationSurrogate" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Runtime.Serialization.ISerializationSurrogate" /> for the specified <paramref name="innerSurrogate" />.</para>
+        </returns>
         <param name="innerSurrogate">
           <attribution license="cc4" from="Microsoft" modified="false" />The specified surrogate.</param>
       </Docs>
@@ -230,12 +245,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Type'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Looks up the <see cref="T:System.Type" /> of the specified object in the provided <see cref="T:System.Reflection.Assembly" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> of the named object.</para>
+        </returns>
         <param name="assem">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly where you want to look up the object. </param>
         <param name="name">
@@ -258,7 +276,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Because the new instance of the object is initialized to zero and no constructors are run, the object might not represent a state that is regarded as valid by that object. The current method should only be used for deserialization when the user intends to immediately populate all fields. It does not create an uninitialized string, since creating an empty instance of an immutable type serves no purpose.</para>
@@ -270,6 +287,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the specified object type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A zeroed object of the specified type.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of object to create. </param>
       </Docs>
@@ -292,7 +313,6 @@
         <Parameter Name="data" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If an element in <paramref name="data" /> is null, <see cref="M:System.Runtime.Serialization.FormatterServices.PopulateObjectMembers(System.Object,System.Reflection.MemberInfo[],System.Object[])" /> does not write anything to that field.</para>
@@ -301,6 +321,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Populates the specified object with values for each field drawn from the data array of objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly populated object.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to populate. </param>
         <param name="members">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/IFormatter.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/IFormatter.xml
index a280a2b4d82..18c884b29ac 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/IFormatter.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/IFormatter.xml
@@ -93,7 +93,6 @@
         <Parameter Name="serializationStream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Runtime.Serialization.IFormatter.Deserialize(System.IO.Stream)" /> method reads graph information from the stream and reconstructs a clone of the original graph. The topology of the graph is preserved.</para>
@@ -103,6 +102,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes the data on the provided stream and reconstitutes the graph of objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The top object of the deserialized graph.</para>
+        </returns>
         <param name="serializationStream">
           <attribution license="cc4" from="Microsoft" modified="false" />The stream that contains the data to deserialize. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/IFormatterConverter.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/IFormatterConverter.xml
index c5a869ce437..a3d2228d713 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/IFormatterConverter.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/IFormatterConverter.xml
@@ -44,12 +44,15 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to the given <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be converted. </param>
         <param name="type">
@@ -73,12 +76,15 @@
         <Parameter Name="typeCode" Type="System.TypeCode" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to the given <see cref="T:System.TypeCode" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be converted. </param>
         <param name="typeCode">
@@ -101,12 +107,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to a <see cref="T:System.Boolean" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be converted. </param>
       </Docs>
@@ -127,12 +136,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to an 8-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be converted. </param>
       </Docs>
@@ -153,12 +165,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'char'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to a Unicode character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be converted. </param>
       </Docs>
@@ -179,12 +194,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DateTime'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to a <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be converted. </param>
       </Docs>
@@ -205,12 +223,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'decimal'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to a <see cref="T:System.Decimal" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be converted. </param>
       </Docs>
@@ -231,12 +252,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'double'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to a double-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be converted. </param>
       </Docs>
@@ -257,12 +281,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'short'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to a 16-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be converted. </param>
       </Docs>
@@ -283,12 +310,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to a 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be converted. </param>
       </Docs>
@@ -309,12 +339,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to a 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be converted. </param>
       </Docs>
@@ -335,12 +368,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'sbyte'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to a <see cref="T:System.SByte" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be converted. </param>
       </Docs>
@@ -361,12 +397,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'float'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to a single-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be converted. </param>
       </Docs>
@@ -387,12 +426,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be converted. </param>
       </Docs>
@@ -413,12 +455,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ushort'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to a 16-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be converted. </param>
       </Docs>
@@ -439,12 +484,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'uint'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to a 32-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be converted. </param>
       </Docs>
@@ -465,12 +513,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ulong'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a value to a 64-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be converted. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/IObjectReference.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/IObjectReference.xml
index 5ecf3ce2b44..e39f1653cef 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/IObjectReference.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/IObjectReference.xml
@@ -40,7 +40,6 @@
         <Parameter Name="context" Type="System.Runtime.Serialization.StreamingContext" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is useful in a remoting situation where you serialize a proxy-creator object, not an actual object. When the proxy-creator object is deserialized, deserialization calls its <see cref="M:System.Runtime.Serialization.IObjectReference.GetRealObject(System.Runtime.Serialization.StreamingContext)" /> method. At this point, the proxy-creator object creates a new instance of the proxy object that refers back to the original actual object, perhaps on a remote computer. Finally, the proxy-creator object is discarded and reclaimed later by garbage collection.</para>
@@ -51,6 +50,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the real object that should be deserialized, rather than the object that the serialized stream specifies.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the actual object that is put into the graph.</para>
+        </returns>
         <param name="context">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Runtime.Serialization.StreamingContext" /> from which the current object is deserialized. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/ISerializationSurrogate.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/ISerializationSurrogate.xml
index 781187e81b0..716c01edbf8 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/ISerializationSurrogate.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/ISerializationSurrogate.xml
@@ -79,7 +79,6 @@
         <Parameter Name="selector" Type="System.Runtime.Serialization.ISurrogateSelector" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Runtime.Serialization.ISerializationSurrogate.SetObjectData(System.Object,System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext,System.Runtime.Serialization.ISurrogateSelector)" /> method is called during deserialization. With this method, you can take the empty <see cref="T:System.Object" /> <paramref name="obj" /> that has already been created, and enter <see cref="T:System.Runtime.Serialization.SerializationInfo" /> <paramref name="info" /> data into that object. Constructors are not invoked during deserialization of information and reconstruction of the object.</para>
@@ -89,6 +88,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Populates the object using the information in the <see cref="T:System.Runtime.Serialization.SerializationInfo" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The populated deserialized object.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to populate. </param>
         <param name="info">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/ISurrogateSelector.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/ISurrogateSelector.xml
index 59b2b7b64f5..2915c2d3194 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/ISurrogateSelector.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/ISurrogateSelector.xml
@@ -69,7 +69,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ISurrogateSelector'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is protected by a <see cref="F:System.Security.Permissions.SecurityAction.LinkDemand" /> for the <see cref="T:System.Security.Permissions.SecurityPermission" /> with the <see cref="F:System.Security.Permissions.SecurityPermissionFlag.SerializationFormatter" /> specified.</para>
@@ -78,6 +77,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the next surrogate selector in the chain.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The next surrogate selector in the chain or null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetSurrogate">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/ObjectManager.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/ObjectManager.xml
index 17ec8d384b5..c8302d06339 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/ObjectManager.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/ObjectManager.xml
@@ -97,7 +97,6 @@
         <Parameter Name="objectID" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An object can be registered and issued an object ID with a call to the <see cref="M:System.Runtime.Serialization.ObjectManager.RegisterObject(System.Object,System.Int64)" /> method.</para>
@@ -106,6 +105,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the object with the specified object ID.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object with the specified object ID if it has been previously stored or null if no such object has been registered.</para>
+        </returns>
         <param name="objectID">
           <attribution license="cc4" from="Microsoft" modified="false" />The ID of the requested object. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/SerializationBinder.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/SerializationBinder.xml
index e00a8b04023..2178e2e0323 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/SerializationBinder.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/SerializationBinder.xml
@@ -95,12 +95,15 @@
         <Parameter Name="typeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Type'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, controls the binding of a serialized object to a type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type of the object the formatter creates a new instance of.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies the <see cref="T:System.Reflection.Assembly" /> name of the serialized object. </param>
         <param name="typeName">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/SerializationInfo.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/SerializationInfo.xml
index 6dc349780a2..8b537467d6c 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/SerializationInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/SerializationInfo.xml
@@ -678,7 +678,6 @@ End Sub</code>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the value is a Boolean, or can be converted to one, that value is returned; otherwise, a <see cref="T:System.InvalidCastException" /> is thrown. All conversions are done by the <see cref="T:System.Runtime.Serialization.IFormatterConverter" /> associated with this <see cref="T:System.Runtime.Serialization.SerializationInfo" />.</para>
@@ -687,6 +686,10 @@ End Sub</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a Boolean value from the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The Boolean value associated with <paramref name="name" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name associated with the value to retrieve. </param>
       </Docs>
@@ -707,7 +710,6 @@ End Sub</code>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the value is an 8-bit unsigned integer, or can be converted to one, that value is returned; otherwise, a <see cref="T:System.InvalidCastException" /> is thrown. All conversions are done by the <see cref="T:System.Runtime.Serialization.IFormatterConverter" /> associated with this <see cref="T:System.Runtime.Serialization.SerializationInfo" />.</para>
@@ -716,6 +718,10 @@ End Sub</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an 8-bit unsigned integer value from the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 8-bit unsigned integer associated with <paramref name="name" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name associated with the value to retrieve. </param>
       </Docs>
@@ -736,7 +742,6 @@ End Sub</code>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'char'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the value is a Unicode character, or can be converted to one, that value is returned; otherwise, a <see cref="T:System.InvalidCastException" /> is thrown. All conversions are done by the <see cref="T:System.Runtime.Serialization.IFormatterConverter" /> associated with this <see cref="T:System.Runtime.Serialization.SerializationInfo" />.</para>
@@ -745,6 +750,10 @@ End Sub</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a Unicode character value from the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The Unicode character associated with <paramref name="name" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name associated with the value to retrieve.</param>
       </Docs>
@@ -765,7 +774,6 @@ End Sub</code>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DateTime'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the value is a <see cref="T:System.DateTime" />, or can be converted to a <see cref="T:System.DateTime" />, that value is returned; otherwise, a <see cref="T:System.InvalidCastException" /> is thrown. All conversions are done by the <see cref="T:System.Runtime.Serialization.IFormatterConverter" /> associated with this <see cref="T:System.Runtime.Serialization.SerializationInfo" />.</para>
@@ -774,6 +782,10 @@ End Sub</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a <see cref="T:System.DateTime" /> value from the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.DateTime" /> value associated with <paramref name="name" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name associated with the value to retrieve.  </param>
       </Docs>
@@ -794,7 +806,6 @@ End Sub</code>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'decimal'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the value is a decimal, or can be converted to a decimal, that value is returned; otherwise, a <see cref="T:System.InvalidCastException" /> is thrown. All conversions are done by the <see cref="T:System.Runtime.Serialization.IFormatterConverter" /> associated with this <see cref="T:System.Runtime.Serialization.SerializationInfo" />.</para>
@@ -803,6 +814,10 @@ End Sub</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a decimal value from the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decimal value from the <see cref="T:System.Runtime.Serialization.SerializationInfo" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name associated with the value to retrieve.  </param>
       </Docs>
@@ -823,7 +838,6 @@ End Sub</code>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'double'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the value is a double, or can be converted to a double, that value is returned; otherwise, a <see cref="T:System.InvalidCastException" /> is thrown. All conversions are done by the <see cref="T:System.Runtime.Serialization.IFormatterConverter" /> associated with this <see cref="T:System.Runtime.Serialization.SerializationInfo" />.</para>
@@ -832,6 +846,10 @@ End Sub</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a double-precision floating-point value from the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The double-precision floating-point value associated with <paramref name="name" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name associated with the value to retrieve.</param>
       </Docs>
@@ -850,7 +868,6 @@ End Sub</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SerializationInfoEnumerator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This function will most often be used by formatters that need to enumerate through the values before writing them out to the stream.</para>
@@ -859,6 +876,10 @@ End Sub</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Runtime.Serialization.SerializationInfoEnumerator" /> used to iterate through the name-value pairs in the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Runtime.Serialization.SerializationInfoEnumerator" /> for parsing the name-value pairs contained in the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> store.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetInt16">
@@ -877,7 +898,6 @@ End Sub</code>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'short'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the value is a 16-bit signed integer, or can be converted to one, that value is returned; otherwise, a <see cref="T:System.InvalidCastException" /> is thrown. All conversions are done by the <see cref="T:System.Runtime.Serialization.IFormatterConverter" /> associated with this <see cref="T:System.Runtime.Serialization.SerializationInfo" />.</para>
@@ -886,6 +906,10 @@ End Sub</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a 16-bit signed integer value from the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 16-bit signed integer associated with <paramref name="name" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name associated with the value to retrieve.</param>
       </Docs>
@@ -906,7 +930,6 @@ End Sub</code>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the value is a 32-bit signed integer, or can be converted to one, that value is returned; otherwise, a <see cref="T:System.InvalidCastException" /> is thrown. All conversions are done by the <see cref="T:System.Runtime.Serialization.IFormatterConverter" /> associated with this <see cref="T:System.Runtime.Serialization.SerializationInfo" />.</para>
@@ -915,6 +938,10 @@ End Sub</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a 32-bit signed integer value from the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 32-bit signed integer associated with <paramref name="name" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the value to retrieve. </param>
       </Docs>
@@ -935,7 +962,6 @@ End Sub</code>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the value is a 64-bit signed integer, or can be converted to one, that value is returned; otherwise, a <see cref="T:System.InvalidCastException" /> is thrown. All conversions are done by the <see cref="T:System.Runtime.Serialization.IFormatterConverter" /> associated with this <see cref="T:System.Runtime.Serialization.SerializationInfo" />.</para>
@@ -944,6 +970,10 @@ End Sub</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a 64-bit signed integer value from the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 64-bit signed integer associated with <paramref name="name" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name associated with the value to retrieve.</param>
       </Docs>
@@ -969,7 +999,6 @@ End Sub</code>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'sbyte'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the value is an Int8, or can be converted to an Int8, that value is returned; otherwise, a <see cref="T:System.InvalidCastException" /> is thrown. All conversions are done by the <see cref="T:System.Runtime.Serialization.IFormatterConverter" /> associated with this <see cref="T:System.Runtime.Serialization.SerializationInfo" />.</para>
@@ -978,6 +1007,10 @@ End Sub</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an 8-bit signed integer value from the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 8-bit signed integer associated with <paramref name="name" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name associated with the value to retrieve.</param>
       </Docs>
@@ -998,7 +1031,6 @@ End Sub</code>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'float'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the value is a single-precision floating-point number, or can be converted to one, that value is returned; otherwise, a <see cref="T:System.InvalidCastException" /> is thrown. All conversions are done by the <see cref="T:System.Runtime.Serialization.IFormatterConverter" /> associated with this <see cref="T:System.Runtime.Serialization.SerializationInfo" />.</para>
@@ -1007,6 +1039,10 @@ End Sub</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a single-precision floating-point value from the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The single-precision floating-point value associated with <paramref name="name" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the value to retrieve. </param>
       </Docs>
@@ -1027,7 +1063,6 @@ End Sub</code>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the value is a <see cref="T:System.String" />, or can be converted to a <see cref="T:System.String" />, that value is returned; otherwise, a <see cref="T:System.InvalidCastException" /> is thrown. All conversions are done by the <see cref="T:System.Runtime.Serialization.IFormatterConverter" /> associated with this <see cref="T:System.Runtime.Serialization.SerializationInfo" />.</para>
@@ -1036,6 +1071,10 @@ End Sub</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a <see cref="T:System.String" /> value from the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.String" /> associated with <paramref name="name" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name associated with the value to retrieve.</param>
       </Docs>
@@ -1061,7 +1100,6 @@ End Sub</code>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ushort'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the value is a 16-bit unsigned integer, or can be converted to one, that value is returned; otherwise, a <see cref="T:System.InvalidCastException" /> is thrown. All conversions are done by the <see cref="T:System.Runtime.Serialization.IFormatterConverter" /> associated with this <see cref="T:System.Runtime.Serialization.SerializationInfo" />.</para>
@@ -1070,6 +1108,10 @@ End Sub</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a 16-bit unsigned integer value from the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 16-bit unsigned integer associated with <paramref name="name" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name associated with the value to retrieve.</param>
       </Docs>
@@ -1095,7 +1137,6 @@ End Sub</code>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'uint'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the value is a 32-bit signed integer, or can be converted to one, that value is returned; otherwise, a <see cref="T:System.InvalidCastException" /> is thrown. All conversions are done by the <see cref="T:System.Runtime.Serialization.IFormatterConverter" /> associated with this <see cref="T:System.Runtime.Serialization.SerializationInfo" />.</para>
@@ -1104,6 +1145,10 @@ End Sub</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a 32-bit unsigned integer value from the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 32-bit unsigned integer associated with <paramref name="name" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name associated with the value to retrieve.</param>
       </Docs>
@@ -1129,7 +1174,6 @@ End Sub</code>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ulong'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the value is a 64-bit unsigned integer, or can be converted to one, that value is returned; otherwise, a <see cref="T:System.InvalidCastException" /> is thrown. All conversions are done by the <see cref="T:System.Runtime.Serialization.IFormatterConverter" /> associated with this <see cref="T:System.Runtime.Serialization.SerializationInfo" />.</para>
@@ -1138,6 +1182,10 @@ End Sub</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a 64-bit unsigned integer value from the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 64-bit unsigned integer associated with <paramref name="name" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name associated with the value to retrieve.</param>
       </Docs>
@@ -1159,7 +1207,6 @@ End Sub</code>
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the data stored in the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> is of the type requested (or one of its derived classes), that value is returned directly. Otherwise, <see cref="M:System.Runtime.Serialization.IFormatterConverter.Convert(System.Object,System.Type)" /> is called to convert it to the appropriate type.</para>
@@ -1169,6 +1216,10 @@ End Sub</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a value from the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> store.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object of the specified <see cref="T:System.Type" /> associated with <paramref name="name" />.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name associated with the value to retrieve.</param>
         <param name="type">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/SerializationInfoEnumerator.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/SerializationInfoEnumerator.xml
index 547bc9bfe0e..d3940f67ba0 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/SerializationInfoEnumerator.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/SerializationInfoEnumerator.xml
@@ -70,7 +70,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To initialize the enumerator, call <see cref="M:System.Runtime.Serialization.SerializationInfoEnumerator.MoveNext" /> and go through each item until you reach the last element.</para>
@@ -79,6 +78,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Updates the enumerator to the next item.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a new element is found; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Name">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/StreamingContext.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/StreamingContext.xml
index 2782c1eb5ff..2a4d6301cbf 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/StreamingContext.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/StreamingContext.xml
@@ -119,7 +119,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Two code groups are equivalent if they have the same <see cref="P:System.Runtime.Serialization.StreamingContext.Context" /> and <see cref="P:System.Runtime.Serialization.StreamingContext.State" />.</para>
@@ -128,6 +127,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two <see cref="T:System.Runtime.Serialization.StreamingContext" /> instances contain the same values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified object is an instance of <see cref="T:System.Runtime.Serialization.StreamingContext" /> and equals the value of the current instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with the current instance. </param>
       </Docs>
@@ -146,12 +149,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash code of this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Runtime.Serialization.StreamingContextStates" /> value that contains the source or destination of the serialization for this <see cref="T:System.Runtime.Serialization.StreamingContext" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="State">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/SurrogateSelector.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/SurrogateSelector.xml
index a6d8b33381d..a22f7b31e4f 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/SurrogateSelector.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Serialization/SurrogateSelector.xml
@@ -126,12 +126,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ISurrogateSelector'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the next selector on the chain of selectors.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The next <see cref="T:System.Runtime.Serialization.ISurrogateSelector" /> on the chain of selectors.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetSurrogate">
diff --git a/mcs/class/corlib/Documentation/en/System.Runtime.Versioning/VersioningHelper.xml b/mcs/class/corlib/Documentation/en/System.Runtime.Versioning/VersioningHelper.xml
index 50354f4bcf5..2b6b05013fb 100644
--- a/mcs/class/corlib/Documentation/en/System.Runtime.Versioning/VersioningHelper.xml
+++ b/mcs/class/corlib/Documentation/en/System.Runtime.Versioning/VersioningHelper.xml
@@ -40,7 +40,6 @@
         <Parameter Name="to" Type="System.Runtime.Versioning.ResourceScope" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -50,6 +49,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a version-safe name based on the specified resource name and the intended resource consumption source.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A version-safe name.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the resource.</param>
         <param name="from">
@@ -76,7 +79,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -86,6 +88,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a version-safe name based on the specified resource name, the intended resource consumption scope, and the type using the resource.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A version-safe name.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the resource.</param>
         <param name="from">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/AceEnumerator.xml b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/AceEnumerator.xml
index 1a09a0b04b4..2a5938e5415 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/AceEnumerator.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/AceEnumerator.xml
@@ -58,7 +58,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -70,6 +69,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Advances the enumerator to the next element of the <see cref="T:System.Security.AccessControl.GenericAce" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Reset">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/CommonAce.xml b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/CommonAce.xml
index fe048959bcc..34e630a1fc1 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/CommonAce.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/CommonAce.xml
@@ -136,13 +136,16 @@
         <Parameter Name="isCallback" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the maximum allowed length of an opaque data BLOB for callback access control entries (ACEs).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The allowed length of an opaque data BLOB.</para>
+        </returns>
         <param name="isCallback">
           <attribution license="cc4" from="Microsoft" modified="false" />true to specify that the <see cref="T:System.Security.AccessControl.CommonAce" /> object is a callback ACE type.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/CommonObjectSecurity.xml b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/CommonObjectSecurity.xml
index 011ca71b8b8..397c9bc252b 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/CommonObjectSecurity.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/CommonObjectSecurity.xml
@@ -116,13 +116,16 @@
         <Parameter Name="targetType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of the access rules associated with the specified security identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The collection of access rules associated with the specified <see cref="T:System.Security.Principal.SecurityIdentifier" /> object.</para>
+        </returns>
         <param name="includeExplicit">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include access rules explicitly set for the object.</param>
         <param name="includeInherited">
@@ -148,13 +151,16 @@
         <Parameter Name="targetType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of the audit rules associated with the specified security identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The collection of audit rules associated with the specified <see cref="T:System.Security.Principal.SecurityIdentifier" /> object.</para>
+        </returns>
         <param name="includeExplicit">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include audit rules explicitly set for the object.</param>
         <param name="includeInherited">
@@ -230,7 +236,6 @@
         <Parameter Name="rule" Type="System.Security.AccessControl.AccessRule" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -242,6 +247,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes access rules that contain the same security identifier and access mask as the specified access rule from the Discretionary Access Control List (DACL) associated with this <see cref="T:System.Security.AccessControl.CommonObjectSecurity" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the access rule was successfully removed; otherwise, false.</para>
+        </returns>
         <param name="rule">
           <attribution license="cc4" from="Microsoft" modified="false" />The access rule to remove.</param>
       </Docs>
@@ -317,7 +326,6 @@
         <Parameter Name="rule" Type="System.Security.AccessControl.AuditRule" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -328,6 +336,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes audit rules that contain the same security identifier and access mask as the specified audit rule from the System Access Control List (SACL) associated with this <see cref="T:System.Security.AccessControl.CommonObjectSecurity" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the audit rule was successfully removed; otherwise, false.</para>
+        </returns>
         <param name="rule">
           <attribution license="cc4" from="Microsoft" modified="false" />The audit rule to remove.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/CryptoKeySecurity.xml b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/CryptoKeySecurity.xml
index d4b726d2850..27b6a21284b 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/CryptoKeySecurity.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/CryptoKeySecurity.xml
@@ -101,13 +101,16 @@
         <Parameter Name="type" Type="System.Security.AccessControl.AccessControlType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of the <see cref="T:System.Security.AccessControl.AccessRule" /> class with the specified values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Security.AccessControl.AccessRule" /> object that this method creates.</para>
+        </returns>
         <param name="identityReference">
           <attribution license="cc4" from="Microsoft" modified="false" />The identity to which the access rule applies.  It must be an object that can be cast as a <see cref="T:System.Security.Principal.SecurityIdentifier" />.</param>
         <param name="accessMask">
@@ -219,13 +222,16 @@
         <Parameter Name="flags" Type="System.Security.AccessControl.AuditFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of the <see cref="T:System.Security.AccessControl.AuditRule" /> class with the specified values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Security.AccessControl.AuditRule" /> object that this method creates.</para>
+        </returns>
         <param name="identityReference">
           <attribution license="cc4" from="Microsoft" modified="false" />The identity to which the audit rule applies.  It must be an object that can be cast as a <see cref="T:System.Security.Principal.SecurityIdentifier" />.</param>
         <param name="accessMask">
@@ -276,7 +282,6 @@
         <Parameter Name="rule" Type="System.Security.AccessControl.CryptoKeyAccessRule" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -287,6 +292,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes access rules that contain the same security identifier and access mask as the specified access rule from the Discretionary Access Control List (DACL) associated with this <see cref="T:System.Security.AccessControl.CryptoKeySecurity" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the access rule was successfully removed; otherwise, false.</para>
+        </returns>
         <param name="rule">
           <attribution license="cc4" from="Microsoft" modified="false" />The access rule to remove.</param>
       </Docs>
@@ -356,7 +365,6 @@
         <Parameter Name="rule" Type="System.Security.AccessControl.CryptoKeyAuditRule" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -367,6 +375,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes audit rules that contain the same security identifier and access mask as the specified audit rule from the System Access Control List (SACL) associated with this <see cref="T:System.Security.AccessControl.CryptoKeySecurity" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the audit rule was successfully removed; otherwise, false.</para>
+        </returns>
         <param name="rule">
           <attribution license="cc4" from="Microsoft" modified="false" />The audit rule to remove.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/CustomAce.xml b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/CustomAce.xml
index 3a6eb53f37b..24d30040cd6 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/CustomAce.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/CustomAce.xml
@@ -116,13 +116,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the opaque data associated with this <see cref="T:System.Security.AccessControl.CustomAce" /> object. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of byte values that represents the opaque data associated with this <see cref="T:System.Security.AccessControl.CustomAce" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MaxOpaqueLength">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/DirectoryObjectSecurity.xml b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/DirectoryObjectSecurity.xml
index 41383cc8df2..3eea99fbaf1 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/DirectoryObjectSecurity.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/DirectoryObjectSecurity.xml
@@ -82,13 +82,16 @@
         <Parameter Name="inheritedObjectType" Type="System.Guid" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of the <see cref="T:System.Security.AccessControl.AccessRule" /> class with the specified values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Security.AccessControl.AccessRule" /> object that this method creates.</para>
+        </returns>
         <param name="identityReference">
           <attribution license="cc4" from="Microsoft" modified="false" />The identity to which the access rule applies.  It must be an object that can be cast as a <see cref="T:System.Security.Principal.SecurityIdentifier" />.</param>
         <param name="accessMask">
@@ -185,13 +188,16 @@
         <Parameter Name="inheritedObjectType" Type="System.Guid" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of the <see cref="T:System.Security.AccessControl.AuditRule" /> class with the specified values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Security.AccessControl.AuditRule" /> object that this method creates.</para>
+        </returns>
         <param name="identityReference">
           <attribution license="cc4" from="Microsoft" modified="false" />The identity to which the audit rule applies.  It must be an object that can be cast as a <see cref="T:System.Security.Principal.SecurityIdentifier" />.</param>
         <param name="accessMask">
@@ -227,13 +233,16 @@
         <Parameter Name="targetType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of the access rules associated with the specified security identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The collection of access rules associated with the specified <see cref="T:System.Security.Principal.SecurityIdentifier" /> object.</para>
+        </returns>
         <param name="includeExplicit">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include access rules explicitly set for the object.</param>
         <param name="includeInherited">
@@ -259,13 +268,16 @@
         <Parameter Name="targetType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of the audit rules associated with the specified security identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The collection of audit rules associated with the specified <see cref="T:System.Security.Principal.SecurityIdentifier" /> object.</para>
+        </returns>
         <param name="includeExplicit">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include audit rules explicitly set for the object.</param>
         <param name="includeInherited">
@@ -341,7 +353,6 @@
         <Parameter Name="rule" Type="System.Security.AccessControl.ObjectAccessRule" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -352,6 +363,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes access rules that contain the same security identifier and access mask as the specified access rule from the Discretionary Access Control List (DACL) associated with this <see cref="T:System.Security.AccessControl.DirectoryObjectSecurity" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the access rule was successfully removed; otherwise, false.</para>
+        </returns>
         <param name="rule">
           <attribution license="cc4" from="Microsoft" modified="false" />The access rule to remove.</param>
       </Docs>
@@ -421,7 +436,6 @@
         <Parameter Name="rule" Type="System.Security.AccessControl.ObjectAuditRule" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -432,6 +446,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes audit rules that contain the same security identifier and access mask as the specified audit rule from the System Access Control List (SACL) associated with this <see cref="T:System.Security.AccessControl.CommonObjectSecurity" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the audit rule was successfully removed; otherwise, false.</para>
+        </returns>
         <param name="rule">
           <attribution license="cc4" from="Microsoft" modified="false" />The audit rule to remove.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/DiscretionaryAcl.xml b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/DiscretionaryAcl.xml
index 25d09bf0b5e..30aa25d8000 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/DiscretionaryAcl.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/DiscretionaryAcl.xml
@@ -218,7 +218,6 @@
         <Parameter Name="propagationFlags" Type="System.Security.AccessControl.PropagationFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -228,6 +227,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the specified access control rule from the current <see cref="T:System.Security.AccessControl.DiscretionaryAcl" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this method successfully removes the specified access; otherwise, false.</para>
+        </returns>
         <param name="accessType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of access control (allow or deny) to remove.</param>
         <param name="sid">
@@ -262,7 +265,6 @@
         <Parameter Name="inheritedObjectType" Type="System.Guid" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -272,6 +274,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the specified access control rule from the current <see cref="T:System.Security.AccessControl.DiscretionaryAcl" /> object. Use this method for directory object Access Control Lists (ACLs) when specifying the object type or the inherited object type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this method successfully removes the specified access; otherwise, false.</para>
+        </returns>
         <param name="accessType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of access control (allow or deny) to remove.</param>
         <param name="sid">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/EventWaitHandleSecurity.xml b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/EventWaitHandleSecurity.xml
index 5fcc13b554f..afc5448f51c 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/EventWaitHandleSecurity.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/EventWaitHandleSecurity.xml
@@ -128,7 +128,6 @@
         <Parameter Name="type" Type="System.Security.AccessControl.AccessControlType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -141,6 +140,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new access control rule for the specified user, with the specified access rights, access control, and flags.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.AccessControl.EventWaitHandleAccessRule" /> object representing the specified rights for the specified user.</para>
+        </returns>
         <param name="identityReference">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Security.Principal.IdentityReference" /> that identifies the user or group the rule applies to.</param>
         <param name="accessMask">
@@ -255,7 +258,6 @@
         <Parameter Name="flags" Type="System.Security.AccessControl.AuditFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -268,6 +270,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new audit rule, specifying the user the rule applies to, the access rights to audit, and the outcome that triggers the audit rule.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.AccessControl.EventWaitHandleAuditRule" /> object representing the specified audit rule for the specified user. The return type of the method is the base class, <see cref="T:System.Security.AccessControl.AuditRule" />, but the return value can be cast safely to the derived class.</para>
+        </returns>
         <param name="identityReference">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Security.Principal.IdentityReference" /> that identifies the user or group the rule applies to.</param>
         <param name="accessMask">
@@ -321,7 +327,6 @@
         <Parameter Name="rule" Type="System.Security.AccessControl.EventWaitHandleAccessRule" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -334,6 +339,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for an access control rule with the same user and <see cref="T:System.Security.AccessControl.AccessControlType" /> (allow or deny) as the specified access rule, and with compatible inheritance and propagation flags; if such a rule is found, the rights contained in the specified access rule are removed from it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a compatible rule is found; otherwise, false.</para>
+        </returns>
         <param name="rule">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Security.AccessControl.EventWaitHandleAccessRule" /> that specifies the user and <see cref="T:System.Security.AccessControl.AccessControlType" /> to search for, and a set of inheritance and propagation flags that a matching rule, if found, must be compatible with. Specifies the rights to remove from the compatible rule, if found.</param>
       </Docs>
@@ -412,7 +421,6 @@
         <Parameter Name="rule" Type="System.Security.AccessControl.EventWaitHandleAuditRule" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -425,6 +433,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for an audit rule with the same user as the specified rule, and with compatible inheritance and propagation flags; if a compatible rule is found, the rights contained in the specified rule are removed from it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a compatible rule is found; otherwise, false.</para>
+        </returns>
         <param name="rule">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Security.AccessControl.EventWaitHandleAuditRule" /> that specifies the user to search for and a set of inheritance and propagation flags that a matching rule, if found, must be compatible with. Specifies the rights to remove from the compatible rule, if found.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/FileSystemSecurity.xml b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/FileSystemSecurity.xml
index 9adb4bd165d..1e49b3f11a8 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/FileSystemSecurity.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/FileSystemSecurity.xml
@@ -72,7 +72,6 @@
         <Parameter Name="type" Type="System.Security.AccessControl.AccessControlType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -83,6 +82,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of the <see cref="T:System.Security.AccessControl.FileSystemAccessRule" /> class that represents a new access control rule for the specified user, with the specified access rights, access control, and flags.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Security.AccessControl.FileSystemAccessRule" /> object that represents a new access control rule for the specified user, with the specified access rights, access control, and flags.</para>
+        </returns>
         <param name="identityReference">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Security.Principal.IdentityReference" /> object that represents a user account.</param>
         <param name="accessMask">
@@ -202,7 +205,6 @@
         <Parameter Name="flags" Type="System.Security.AccessControl.AuditFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -213,6 +215,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of the <see cref="T:System.Security.AccessControl.FileSystemAuditRule" /> class representing the specified audit rule for the specified user.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Security.AccessControl.FileSystemAuditRule" /> object representing the specified audit rule for the specified user.</para>
+        </returns>
         <param name="identityReference">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Security.Principal.IdentityReference" /> object that represents a user account.</param>
         <param name="accessMask">
@@ -266,7 +272,6 @@
         <Parameter Name="rule" Type="System.Security.AccessControl.FileSystemAccessRule" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -279,6 +284,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes all matching allow or deny access control list (ACL) permissions from the current file or directory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the access rule was removed; otherwise, false.</para>
+        </returns>
         <param name="rule">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Security.AccessControl.FileSystemAccessRule" /> object that represents an access control list (ACL) permission to remove from a file or directory.</param>
       </Docs>
@@ -360,7 +369,6 @@
         <Parameter Name="rule" Type="System.Security.AccessControl.FileSystemAuditRule" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -370,6 +378,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes all matching allow or deny audit rules from the current file or directory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the audit rule was removed; otherwise, false</para>
+        </returns>
         <param name="rule">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Security.AccessControl.FileSystemAuditRule" />  object that represents an audit rule to remove from a file or directory.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/GenericAce.xml b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/GenericAce.xml
index a4541a3b331..9b1042a3e3c 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/GenericAce.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/GenericAce.xml
@@ -123,13 +123,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a deep copy of this Access Control Entry (ACE).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Security.AccessControl.GenericAce" /> object that this method creates.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateFromBinaryForm">
@@ -148,13 +151,16 @@
         <Parameter Name="offset" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Security.AccessControl.GenericAce" /> object from the specified binary data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Security.AccessControl.GenericAce" /> object this method creates.</para>
+        </returns>
         <param name="binaryForm">
           <attribution license="cc4" from="Microsoft" modified="false" />The binary data from which to create the new <see cref="T:System.Security.AccessControl.GenericAce" /> object.</param>
         <param name="offset">
@@ -176,13 +182,16 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Security.AccessControl.GenericAce" /> object is equal to the current <see cref="T:System.Security.AccessControl.GenericAce" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Security.AccessControl.GenericAce" /> object is equal to the current <see cref="T:System.Security.AccessControl.GenericAce" /> object; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.AccessControl.GenericAce" /> object to compare to the current <see cref="T:System.Security.AccessControl.GenericAce" /> object.</param>
       </Docs>
@@ -228,13 +237,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for the <see cref="T:System.Security.AccessControl.GenericAce" /> class. The  <see cref="M:System.Security.AccessControl.GenericAce.GetHashCode" /> method is suitable for use in hashing algorithms and data structures like a hash table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.Security.AccessControl.GenericAce" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InheritanceFlags">
@@ -295,13 +307,16 @@
         <Parameter Name="right" Type="System.Security.AccessControl.GenericAce" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Security.AccessControl.GenericAce" /> objects are considered equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two <see cref="T:System.Security.AccessControl.GenericAce" /> objects are equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Security.AccessControl.GenericAce" /> object to compare.</param>
         <param name="right">
@@ -324,13 +339,16 @@
         <Parameter Name="right" Type="System.Security.AccessControl.GenericAce" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Security.AccessControl.GenericAce" /> objects are considered unequal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two <see cref="T:System.Security.AccessControl.GenericAce" /> objects are unequal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Security.AccessControl.GenericAce" /> object to compare.</param>
         <param name="right">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/GenericAcl.xml b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/GenericAcl.xml
index 0fe741e460a..81618d956db 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/GenericAcl.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/GenericAcl.xml
@@ -198,13 +198,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new instance of the <see cref="T:System.Security.AccessControl.AceEnumerator" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:Security.AccessControl.AceEnumerator" /> that this method returns.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsSynchronized">
@@ -354,13 +357,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new instance of the <see cref="T:System.Security.AccessControl.AceEnumerator" /> class cast as an instance of the <see cref="T:System.Collections.IEnumerator" /> interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Security.AccessControl.AceEnumerator" /> object, cast as an instance of the <see cref="T:System.Collections.IEnumerator" /> interface.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/GenericSecurityDescriptor.xml b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/GenericSecurityDescriptor.xml
index 850dfdf370e..15e96b1e85a 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/GenericSecurityDescriptor.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/GenericSecurityDescriptor.xml
@@ -123,13 +123,16 @@
         <Parameter Name="includeSections" Type="System.Security.AccessControl.AccessControlSections" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the Security Descriptor Definition Language (SDDL) representation of the specified sections of the security descriptor that this <see cref="T:System.Security.AccessControl.GenericSecurityDescriptor" /> object represents.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The SDDL representation of the specified sections of the security descriptor associated with this <see cref="T:System.Security.AccessControl.GenericSecurityDescriptor" /> object.</para>
+        </returns>
         <param name="includeSections">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies which sections (access rules, audit rules, primary group, owner) of the security descriptor to get.</param>
       </Docs>
@@ -168,13 +171,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a boolean value that specifies whether the security descriptor associated with this  <see cref="T:System.Security.AccessControl.GenericSecurityDescriptor" /> object can be converted to the Security Descriptor Definition Language (SDDL) format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the security descriptor associated with this  <see cref="T:System.Security.AccessControl.GenericSecurityDescriptor" /> object can be converted to the Security Descriptor Definition Language (SDDL) format; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Owner">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/MutexSecurity.xml b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/MutexSecurity.xml
index 51e143e1562..643ce7d4b02 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/MutexSecurity.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/MutexSecurity.xml
@@ -160,7 +160,6 @@
         <Parameter Name="type" Type="System.Security.AccessControl.AccessControlType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -173,6 +172,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new access control rule for the specified user, with the specified access rights, access control, and flags.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.AccessControl.MutexAccessRule" /> object representing the specified rights for the specified user.</para>
+        </returns>
         <param name="identityReference">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Security.Principal.IdentityReference" /> that identifies the user or group the rule applies to.</param>
         <param name="accessMask">
@@ -287,7 +290,6 @@
         <Parameter Name="flags" Type="System.Security.AccessControl.AuditFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -300,6 +302,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new audit rule, specifying the user the rule applies to, the access rights to audit, and the outcome that triggers the audit rule.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.AccessControl.MutexAuditRule" /> object representing the specified audit rule for the specified user. The return type of the method is the base class, <see cref="T:System.Security.AccessControl.AuditRule" />, but the return value can be cast safely to the derived class.</para>
+        </returns>
         <param name="identityReference">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Security.Principal.IdentityReference" /> that identifies the user or group the rule applies to.</param>
         <param name="accessMask">
@@ -353,7 +359,6 @@
         <Parameter Name="rule" Type="System.Security.AccessControl.MutexAccessRule" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -366,6 +371,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for an access control rule with the same user and <see cref="T:System.Security.AccessControl.AccessControlType" /> (allow or deny) as the specified rule, and with compatible inheritance and propagation flags; if such a rule is found, the rights contained in the specified access rule are removed from it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a compatible rule is found; otherwise false.</para>
+        </returns>
         <param name="rule">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Security.AccessControl.MutexAccessRule" /> that specifies the user and <see cref="T:System.Security.AccessControl.AccessControlType" /> to search for, and a set of inheritance and propagation flags that a matching rule, if found, must be compatible with. Specifies the rights to remove from the compatible rule, if found.</param>
       </Docs>
@@ -444,7 +453,6 @@
         <Parameter Name="rule" Type="System.Security.AccessControl.MutexAuditRule" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -457,6 +465,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for an audit control rule with the same user as the specified rule, and with compatible inheritance and propagation flags; if a compatible rule is found, the rights contained in the specified rule are removed from it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a compatible rule is found; otherwise, false.</para>
+        </returns>
         <param name="rule">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Security.AccessControl.MutexAuditRule" /> that specifies the user to search for, and a set of inheritance and propagation flags that a matching rule, if found, must be compatible with. Specifies the rights to remove from the compatible rule, if found.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/ObjectAce.xml b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/ObjectAce.xml
index 2139aead24e..d80457a15c1 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/ObjectAce.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/ObjectAce.xml
@@ -154,13 +154,16 @@
         <Parameter Name="isCallback" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the maximum allowed length, in bytes, of an opaque data BLOB for callback Access Control Entries (ACEs).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum allowed length, in bytes, of an opaque data BLOB for callback Access Control Entries (ACEs).</para>
+        </returns>
         <param name="isCallback">
           <attribution license="cc4" from="Microsoft" modified="false" />True if the <see cref="T:System.Security.AccessControl.ObjectAce" /> is a callback ACE type.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/ObjectSecurity.xml b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/ObjectSecurity.xml
index b51ddd5b8a3..7d32636b8b2 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/ObjectSecurity.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/ObjectSecurity.xml
@@ -86,13 +86,16 @@
         <Parameter Name="type" Type="System.Security.AccessControl.AccessControlType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of the <see cref="T:System.Security.AccessControl.AccessRule" /> class with the specified values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Security.AccessControl.AccessRule" /> object that this method creates.</para>
+        </returns>
         <param name="identityReference">
           <attribution license="cc4" from="Microsoft" modified="false" />The identity to which the access rule applies.  It must be an object that can be cast as a <see cref="T:System.Security.Principal.SecurityIdentifier" />.</param>
         <param name="accessMask">
@@ -253,13 +256,16 @@
         <Parameter Name="flags" Type="System.Security.AccessControl.AuditFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of the <see cref="T:System.Security.AccessControl.AuditRule" /> class with the specified values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Security.AccessControl.AuditRule" /> object that this method creates.</para>
+        </returns>
         <param name="identityReference">
           <attribution license="cc4" from="Microsoft" modified="false" />The identity to which the audit rule applies.  It must be an object that can be cast as a <see cref="T:System.Security.Principal.SecurityIdentifier" />.</param>
         <param name="accessMask">
@@ -331,13 +337,16 @@
         <Parameter Name="targetType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the primary group associated with the specified owner.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The primary group associated with the specified owner.</para>
+        </returns>
         <param name="targetType">
           <attribution license="cc4" from="Microsoft" modified="false" />The owner for which to get the primary group. </param>
       </Docs>
@@ -357,13 +366,16 @@
         <Parameter Name="targetType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the owner associated with the specified primary group.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The owner associated with the specified group.</para>
+        </returns>
         <param name="targetType">
           <attribution license="cc4" from="Microsoft" modified="false" />The primary group for which to get the owner.</param>
       </Docs>
@@ -381,7 +393,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -391,6 +402,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of byte values that represents the security descriptor information for this <see cref="T:System.Security.AccessControl.ObjectSecurity" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of byte values that represents the security descriptor for this <see cref="T:System.Security.AccessControl.ObjectSecurity" /> object. This method returns null if there is no security information in this <see cref="T:System.Security.AccessControl.ObjectSecurity" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetSecurityDescriptorSddlForm">
@@ -408,13 +423,16 @@
         <Parameter Name="includeSections" Type="System.Security.AccessControl.AccessControlSections" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the Security Descriptor Definition Language (SDDL) representation of the specified sections of the security descriptor associated with this <see cref="T:System.Security.AccessControl.ObjectSecurity" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The SDDL representation of the specified sections of the security descriptor associated with this <see cref="T:System.Security.AccessControl.ObjectSecurity" /> object.</para>
+        </returns>
         <param name="includeSections">
           <attribution license="cc4" from="Microsoft" modified="false" />Specifies which sections (access rules, audit rules, primary group, owner) of the security descriptor to get.</param>
       </Docs>
@@ -495,13 +513,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Boolean value that specifies whether the security descriptor associated with this  <see cref="T:System.Security.AccessControl.ObjectSecurity" /> object can be converted to the Security Descriptor Definition Language (SDDL) format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the security descriptor associated with this  <see cref="T:System.Security.AccessControl.ObjectSecurity" /> object can be converted to the Security Descriptor Definition Language (SDDL) format; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ModifyAccess">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/ObjectSecurity`1.xml b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/ObjectSecurity`1.xml
index 2631ee9fdba..78f4e3d3abe 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/ObjectSecurity`1.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/ObjectSecurity`1.xml
@@ -202,12 +202,15 @@
         <Parameter Name="type" Type="System.Security.AccessControl.AccessControlType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of the ObjectAccessRule class that represents a new access control rule for the associated security object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Represents a new access control rule for the specified user, with the specified access rights, access control, and flags.</para>
+        </returns>
         <param name="identityReference">
           <attribution license="cc4" from="Microsoft" modified="false" />Represents a user account.</param>
         <param name="accessMask">
@@ -298,12 +301,15 @@
         <Parameter Name="flags" Type="System.Security.AccessControl.AuditFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of the <see cref="T:System.Security.AccessControl.AuditRule" /> class representing the specified audit rule for the specified user.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the specified audit rule for the specified user.</para>
+        </returns>
         <param name="identityReference">
           <attribution license="cc4" from="Microsoft" modified="false" />Represents a user account. </param>
         <param name="accessMask">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/QualifiedAce.xml b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/QualifiedAce.xml
index 979928f2d52..68a3ef61c6c 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/QualifiedAce.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/QualifiedAce.xml
@@ -54,7 +54,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -64,6 +63,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the opaque callback data associated with this <see cref="T:System.Security.AccessControl.QualifiedAce" /> object. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of byte values that represents the opaque callback data associated with this <see cref="T:System.Security.AccessControl.QualifiedAce" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsCallback">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/RegistrySecurity.xml b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/RegistrySecurity.xml
index d7f2f702271..87d894fc620 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/RegistrySecurity.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/RegistrySecurity.xml
@@ -128,7 +128,6 @@
         <Parameter Name="type" Type="System.Security.AccessControl.AccessControlType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -141,6 +140,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new access control rule for the specified user, with the specified access rights, access control, and flags.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.AccessControl.RegistryAccessRule" /> object representing the specified rights for the specified user.</para>
+        </returns>
         <param name="identityReference">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Security.Principal.IdentityReference" /> that identifies the user or group the rule applies to.</param>
         <param name="accessMask">
@@ -259,7 +262,6 @@
         <Parameter Name="flags" Type="System.Security.AccessControl.AuditFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -272,6 +274,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new audit rule, specifying the user the rule applies to, the access rights to audit, the inheritance and propagation of the rule, and the outcome that triggers the rule.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.AccessControl.RegistryAuditRule" /> object representing the specified audit rule for the specified user, with the specified flags. The return type of the method is the base class, <see cref="T:System.Security.AccessControl.AuditRule" />, but the return value can be cast safely to the derived class.</para>
+        </returns>
         <param name="identityReference">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Security.Principal.IdentityReference" /> that identifies the user or group the rule applies to.</param>
         <param name="accessMask">
@@ -325,7 +331,6 @@
         <Parameter Name="rule" Type="System.Security.AccessControl.RegistryAccessRule" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -335,6 +340,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for an access control rule with the same user and <see cref="T:System.Security.AccessControl.AccessControlType" /> (allow or deny) as the specified access rule, and with compatible inheritance and propagation flags; if such a rule is found, the rights contained in the specified access rule are removed from it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a compatible rule is found; otherwise false.</para>
+        </returns>
         <param name="rule">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Security.AccessControl.RegistryAccessRule" /> that specifies the user and <see cref="T:System.Security.AccessControl.AccessControlType" /> to search for, and a set of inheritance and propagation flags that a matching rule, if found, must be compatible with. Specifies the rights to remove from the compatible rule, if found.</param>
       </Docs>
@@ -414,7 +423,6 @@
         <Parameter Name="rule" Type="System.Security.AccessControl.RegistryAuditRule" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -424,6 +432,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for an audit control rule with the same user as the specified rule, and with compatible inheritance and propagation flags; if a compatible rule is found, the rights contained in the specified rule are removed from it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a compatible rule is found; otherwise, false.</para>
+        </returns>
         <param name="rule">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Security.AccessControl.RegistryAuditRule" /> that specifies the user to search for, and a set of inheritance and propagation flags that a matching rule, if found, must be compatible with. Specifies the rights to remove from the compatible rule, if found.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/SystemAcl.xml b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/SystemAcl.xml
index bf32f032f74..d8eb435510c 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.AccessControl/SystemAcl.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.AccessControl/SystemAcl.xml
@@ -215,7 +215,6 @@
         <Parameter Name="propagationFlags" Type="System.Security.AccessControl.PropagationFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -225,6 +224,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the specified audit rule from the current <see cref="T:System.Security.AccessControl.SystemAcl" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this method successfully removes the specified audit rule; otherwise, false.</para>
+        </returns>
         <param name="auditFlags">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of audit rule to remove.</param>
         <param name="sid">
@@ -259,7 +262,6 @@
         <Parameter Name="inheritedObjectType" Type="System.Guid" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -269,6 +271,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the specified audit rule from the current <see cref="T:System.Security.AccessControl.SystemAcl" /> object. Use this method for directory object Access Control Lists (ACLs) when specifying the object type or the inherited object type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this method successfully removes the specified audit rule; otherwise, false.</para>
+        </returns>
         <param name="auditFlags">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of audit rule to remove.</param>
         <param name="sid">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography.X509Certificates/X509Certificate.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography.X509Certificates/X509Certificate.xml
index 69d5d9b9265..fce34766c24 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography.X509Certificates/X509Certificate.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography.X509Certificates/X509Certificate.xml
@@ -468,7 +468,6 @@
         <Parameter Name="filename" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'X509Certificate'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>ASN.1 DER is the only certificate format supported by this class. </para>
@@ -480,6 +479,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an X.509v3 certificate from the specified PKCS7 signed file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created X.509 certificate.</para>
+        </returns>
         <param name="filename">
           <attribution license="cc4" from="Microsoft" modified="false" />The path of the PKCS7 signed file from which to create the X.509 certificate. </param>
       </Docs>
@@ -500,7 +503,6 @@
         <Parameter Name="filename" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'X509Certificate'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>ASN.1 DER is the only certificate format supported by this class.</para>
@@ -509,6 +511,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an X.509v3 certificate from the specified signed file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created X.509 certificate.</para>
+        </returns>
         <param name="filename">
           <attribution license="cc4" from="Microsoft" modified="false" />The path of the signed file from which to create the X.509 certificate. </param>
       </Docs>
@@ -533,7 +539,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -543,6 +548,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate" /> objects for equality.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate" /> object is equal to the object specified by the <paramref name="other" /> parameter; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate" /> object to compare to the current object. </param>
       </Docs>
@@ -563,7 +572,6 @@
         <Parameter Name="other" Type="System.Security.Cryptography.X509Certificates.X509Certificate" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Two <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate" /> objects are considered equal if they have the same issuer and serial number.</para>
@@ -572,6 +580,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate" /> objects for equality.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate" /> object is equal to the object specified by the <paramref name="other" /> parameter; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate" /> object to compare to the current object.</param>
       </Docs>
@@ -596,7 +608,6 @@
         <Parameter Name="contentType" Type="System.Security.Cryptography.X509Certificates.X509ContentType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -606,6 +617,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Exports the current <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate" /> object to a byte array in a format described by one of the <see cref="T:System.Security.Cryptography.X509Certificates.X509ContentType" /> values. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of bytes that represents the current <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate" /> object.</para>
+        </returns>
         <param name="contentType">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Security.Cryptography.X509Certificates.X509ContentType" /> values that describes how to format the output data. </param>
       </Docs>
@@ -626,7 +641,6 @@
         <Parameter Name="password" Type="System.Security.SecureString" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -639,6 +653,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Exports the current <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate" /> object to a byte array using the specified format and a password.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array that represents the current <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate" /> object.</para>
+        </returns>
         <param name="contentType">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Security.Cryptography.X509Certificates.X509ContentType" /> values that describes how to format the output data.</param>
         <param name="password">
@@ -666,7 +684,6 @@
         <Parameter Name="password" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -679,6 +696,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Exports the current <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate" /> object to a byte array in a format described by one of the <see cref="T:System.Security.Cryptography.X509Certificates.X509ContentType" /> values, and using the specified password.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of bytes that represents the current <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate" /> object.</para>
+        </returns>
         <param name="contentType">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Security.Cryptography.X509Certificates.X509ContentType" /> values that describes how to format the output data.</param>
         <param name="password">
@@ -699,7 +720,6 @@
         <Parameter Name="date" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Some cultures cannot convert future dates into strings. If the expiration date of an X.509 certificate is beyond the range of the culture, <see cref="M:System.Security.Cryptography.X509Certificates.X509Certificate.FormatDate(System.DateTime)" /> falls back to a calendar that can express the date. If the <see cref="P:System.Globalization.CultureInfo.Calendar" /> value is <see cref="T:System.Globalization.UmAlQuraCalendar" />, the calendar is changed to the <see cref="T:System.Globalization.HijriCalendar" /> class; otherwise, it is changed to the <see cref="P:System.Globalization.CultureInfo.InvariantCulture" />.</para>
@@ -708,6 +728,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified date and time to a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the value of the <see cref="T:System.DateTime" /> object.</para>
+        </returns>
         <param name="date">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time to convert.</param>
       </Docs>
@@ -726,12 +750,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>Return the SHA1 hash of the complete certificate in a byte array.</returns>
         <remarks>This is similar to the thumbprint used in many certificate viewers.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash value for the X.509v3 certificate as an array of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash value for the X.509 certificate.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetCertHashString">
@@ -748,12 +775,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>Return the SHA1 hash of the complete certificate in a string. </returns>
         <remarks>This is similar to the thumbprint used in many certificate viewers.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the SHA1 hash value for the X.509v3 certificate as a hexadecimal string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hexadecimal string representation of the X.509 certificate hash value.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetEffectiveDateString">
@@ -770,7 +800,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The effective date is the date after which the X.509 certificate is considered valid.</para>
@@ -780,6 +809,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the effective date of this X.509v3 certificate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The effective date for this X.509 certificate.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetExpirationDateString">
@@ -796,7 +829,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The expiration date is the date after which the X.509 certificate is no longer considered valid.</para>
@@ -809,6 +841,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the expiration date of this X.509v3 certificate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The expiration date for this X.509 certificate.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetFormat">
@@ -825,7 +861,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>The string "X509".</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The format X.509 is always returned in this implementation.</para>
@@ -834,6 +869,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the format of this X.509v3 certificate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The format of this X.509 certificate.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -850,7 +889,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the X.509 certificate hash is an array of more than 4 bytes, any byte after the fourth byte is not seen in this integer representation.</para>
@@ -859,6 +897,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for the X.509v3 certificate as an integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the X.509 certificate as an integer.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetIssuerName">
@@ -880,12 +922,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the certification authority that issued the X.509v3 certificate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the certification authority that issued the X.509 certificate.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetKeyAlgorithm">
@@ -902,12 +947,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the key algorithm information for this X.509v3 certificate as a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The key algorithm information for this X.509 certificate as a string.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetKeyAlgorithmParameters">
@@ -924,12 +972,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the key algorithm parameters for the X.509v3 certificate as an array of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The key algorithm parameters for the X.509 certificate as an array of bytes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetKeyAlgorithmParametersString">
@@ -946,12 +997,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the key algorithm parameters for the X.509v3 certificate as a hexadecimal string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The key algorithm parameters for the X.509 certificate as a hexadecimal string.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetName">
@@ -973,12 +1027,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the principal to which the certificate was issued.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the principal to which the certificate was issued.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetPublicKey">
@@ -995,12 +1052,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the public key for the X.509v3 certificate as an array of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The public key for the X.509 certificate as an array of bytes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetPublicKeyString">
@@ -1017,12 +1077,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the public key for the X.509v3 certificate as a hexadecimal string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The public key for the X.509 certificate as a hexadecimal string.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetRawCertData">
@@ -1039,12 +1102,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the raw data for the entire X.509v3 certificate as an array of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array containing the X.509 certificate data.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetRawCertDataString">
@@ -1061,12 +1127,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the raw data for the entire X.509v3 certificate as a hexadecimal string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The X.509 certificate data as a hexadecimal string.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetSerialNumber">
@@ -1083,12 +1152,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the serial number of the X.509v3 certificate as an array of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The serial number of the X.509 certificate as an array of bytes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetSerialNumberString">
@@ -1105,12 +1177,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the serial number of the X.509v3 certificate as a hexadecimal string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The serial number of the X.509 certificate as a hexadecimal string.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Handle">
@@ -1498,12 +1573,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>The string "System.Security.Cryptography.X509Certificates.X509Certificate".</returns>
         <remarks>This is just a call to <see cref="M:System.Object.ToString()" />.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of the current <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the current <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -1522,15 +1600,15 @@
         <Parameter Name="fVerbose" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>If true, return most details from the X.509 certificate.</para>
-          <para>If false, return the string "System.Security.Cryptography.X509Certificates.X509Certificate".</para>
-        </returns>
         <remarks>Useful for debugging purpose only. The format of the string will change in future versions of the framework.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of the current <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate" /> object, with extra information, if specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the current <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate" /> object.</para>
+        </returns>
         <param name="fVerbose">
           <attribution license="cc4" from="Microsoft" modified="false" />true to produce the verbose form of the string representation; otherwise, false. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/Aes.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/Aes.xml
index 07b205eb9f5..5ddad7f385b 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/Aes.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/Aes.xml
@@ -51,12 +51,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a cryptographic object that is used to perform the symmetric algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A cryptographic object that is used to perform the symmetric algorithm.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Create">
@@ -73,7 +76,6 @@
         <Parameter Name="algorithmName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Possible <paramref name="algorithmName" /> values are: "AES", "AesCryptoServiceProvider", "System.Security.Cryptography.AesCryptoServiceProvider", "AesManaged", and "System.Security.Cryptography.AesManaged".</para>
@@ -82,6 +84,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a cryptographic object that specifies the implementation of AES to use to perform the symmetric algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A cryptographic object that is used to perform the symmetric algorithm.</para>
+        </returns>
         <param name="algorithmName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the specific implementation of AES to use.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/AsymmetricAlgorithm.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/AsymmetricAlgorithm.xml
index a7449a26fad..493c36eaa63 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/AsymmetricAlgorithm.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/AsymmetricAlgorithm.xml
@@ -129,12 +129,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'AsymmetricAlgorithm'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a default cryptographic object used to perform the asymmetric algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Security.Cryptography.RSACryptoServiceProvider" /> instance, unless the default settings have been changed with the <format type="text/html"><a href="03db52ef-010e-44ea-b6fd-b9c900ecad50">&lt;cryptoClass&gt; element</a></format>.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Create">
@@ -153,12 +156,15 @@
         <Parameter Name="algName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'AsymmetricAlgorithm'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the specified implementation of an asymmetric algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the specified asymmetric algorithm implementation.</para>
+        </returns>
         <param name="algName">
           <attribution license="cc4" from="Microsoft" modified="false" />The asymmetric algorithm implementation to use. The following table shows the valid values for the <paramref name="algName" /> parameter and the algorithms they map to.</param>
       </Docs>
@@ -421,12 +427,15 @@
         <Parameter Name="includePrivateParameters" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates and returns an XML string representation of the current <see cref="T:System.Security.Cryptography.AsymmetricAlgorithm" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML string encoding of the current <see cref="T:System.Security.Cryptography.AsymmetricAlgorithm" /> object.</para>
+        </returns>
         <param name="includePrivateParameters">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include private parameters; otherwise, false. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/AsymmetricKeyExchangeDeformatter.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/AsymmetricKeyExchangeDeformatter.xml
index 5a0ae170fd0..d556eaedf82 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/AsymmetricKeyExchangeDeformatter.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/AsymmetricKeyExchangeDeformatter.xml
@@ -73,7 +73,6 @@
         <Parameter Name="rgb" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You must specify a key before calling an implementation of this method.</para>
@@ -82,6 +81,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, extracts secret information from the encrypted key exchange data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The secret information derived from the key exchange data.</para>
+        </returns>
         <param name="rgb">
           <attribution license="cc4" from="Microsoft" modified="false" />The key exchange data within which the secret information is hidden. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/AsymmetricKeyExchangeFormatter.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/AsymmetricKeyExchangeFormatter.xml
index 0399daf5f50..245abb580ca 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/AsymmetricKeyExchangeFormatter.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/AsymmetricKeyExchangeFormatter.xml
@@ -73,7 +73,6 @@
         <Parameter Name="data" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This data can only be interpreted by the holder of the private key corresponding to the public key used to encrypt the data. This helps to ensure that only the intended recipient can access the secret information.</para>
@@ -82,6 +81,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates the encrypted key exchange data from the specified input data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The encrypted key exchange data to be sent to the intended recipient.</para>
+        </returns>
         <param name="data">
           <attribution license="cc4" from="Microsoft" modified="false" />The secret information to be passed in the key exchange. </param>
       </Docs>
@@ -103,7 +106,6 @@
         <Parameter Name="symAlgType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This data can only be interpreted by the holder of the private key corresponding to the public key used to encrypt the data. This helps to ensure that only the intended recipient can access the secret information.</para>
@@ -112,6 +114,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates the encrypted key exchange data from the specified input data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The encrypted key exchange data to be sent to the intended recipient.</para>
+        </returns>
         <param name="data">
           <attribution license="cc4" from="Microsoft" modified="false" />The secret information to be passed in the key exchange. </param>
         <param name="symAlgType">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/AsymmetricSignatureDeformatter.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/AsymmetricSignatureDeformatter.xml
index 32f276e7fc1..9a72243d586 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/AsymmetricSignatureDeformatter.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/AsymmetricSignatureDeformatter.xml
@@ -126,7 +126,6 @@
         <Parameter Name="rgbSignature" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You must specify a public key and a hash algorithm before calling this method.</para>
@@ -135,6 +134,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, verifies the signature for the specified data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="rgbSignature" /> matches the signature computed using the specified hash algorithm and key on <paramref name="rgbHash" />; otherwise, false.</para>
+        </returns>
         <param name="rgbHash">
           <attribution license="cc4" from="Microsoft" modified="false" />The data signed with <paramref name="rgbSignature" />. </param>
         <param name="rgbSignature">
@@ -158,7 +161,6 @@
         <Parameter Name="rgbSignature" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method sets the hash algorithm to be used before verifying the signature of the input hash algorithm value.</para>
@@ -167,6 +169,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies the signature from the specified hash value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the signature is valid for the hash; otherwise, false.</para>
+        </returns>
         <param name="hash">
           <attribution license="cc4" from="Microsoft" modified="false" />The hash algorithm to use to verify the signature. </param>
         <param name="rgbSignature">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/AsymmetricSignatureFormatter.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/AsymmetricSignatureFormatter.xml
index 38203df7c6c..238839a83b2 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/AsymmetricSignatureFormatter.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/AsymmetricSignatureFormatter.xml
@@ -69,7 +69,6 @@
         <Parameter Name="rgbHash" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You must specify a key and a hash algorithm before calling this method.</para>
@@ -78,6 +77,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates the signature for the specified data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The digital signature for the <paramref name="rgbHash" /> parameter.</para>
+        </returns>
         <param name="rgbHash">
           <attribution license="cc4" from="Microsoft" modified="false" />The data to be signed. </param>
       </Docs>
@@ -98,7 +101,6 @@
         <Parameter Name="hash" Type="System.Security.Cryptography.HashAlgorithm" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method sets the hash algorithm to be used, then returns the signature of the input hash algorithm value.</para>
@@ -107,6 +109,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the signature from the specified hash value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The signature for the specified hash value.</para>
+        </returns>
         <param name="hash">
           <attribution license="cc4" from="Microsoft" modified="false" />The hash algorithm to use to create the signature. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/CryptoAPITransform.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/CryptoAPITransform.xml
index 17e87ed82ad..b8f0d70971e 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/CryptoAPITransform.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/CryptoAPITransform.xml
@@ -270,12 +270,15 @@
         <Parameter Name="outputOffset" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the transformation for the specified region of the input byte array and copies the resulting transformation to the specified region of the output byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes written.</para>
+        </returns>
         <param name="inputBuffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The input on which to perform the operation on. </param>
         <param name="inputOffset">
@@ -306,12 +309,15 @@
         <Parameter Name="inputCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the transformation for the specified region of the specified byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The computed transformation.</para>
+        </returns>
         <param name="inputBuffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The input on which to perform the operation on. </param>
         <param name="inputOffset">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/CryptoConfig.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/CryptoConfig.xml
index 66e69f70c4e..c2d250228b0 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/CryptoConfig.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/CryptoConfig.xml
@@ -529,7 +529,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>An instance of the default implementation of the specified algorithm.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a list of simple names recognized by this class, see <see cref="T:System.Security.Cryptography.CryptoConfig" />.</para>
@@ -538,6 +537,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the specified cryptographic object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the specified cryptographic object.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The simple name of the cryptographic object of which to create an instance. </param>
       </Docs>
@@ -565,7 +568,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>An instance of the default implementation of the specified algorithm.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a list of simple names recognized by this class, see <see cref="T:System.Security.Cryptography.CryptoConfig" />.</para>
@@ -574,6 +576,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the specified cryptographic object with the specified arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the specified cryptographic object.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The simple name of the cryptographic object of which to create an instance. </param>
         <param name="args">
@@ -596,7 +602,6 @@
         <Parameter Name="str" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>A byte array containing the ASN.1 encoded OID.</returns>
         <remarks>
           <para>
 A <see cref="T:System.Security.Cryptography.CryptographicUnexpectedOperationException" /> will be thrown if the OID is invalid, like: 
@@ -609,6 +614,10 @@ A <see cref="T:System.OverflowException" /> will be thrown if a part of the OID
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes the specified object identifier (OID).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array containing the encoded OID.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The OID to encode. </param>
       </Docs>
@@ -629,7 +638,6 @@ A <see cref="T:System.OverflowException" /> will be thrown if a part of the OID
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>The OID string in dotted notation (e.g. "1.3.14.3.2.26") for the specified algorithm.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a list of simple names recognized by this class, see <see cref="T:System.Security.Cryptography.CryptoConfig" />.</para>
@@ -638,6 +646,10 @@ A <see cref="T:System.OverflowException" /> will be thrown if a part of the OID
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the object identifier (OID) of the algorithm corresponding to the specified simple name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The OID of the specified algorithm.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The simple name of the algorithm for which to get the OID. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/CryptoStream.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/CryptoStream.xml
index 1a1e9313366..4db05ae4188 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/CryptoStream.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/CryptoStream.xml
@@ -257,7 +257,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You must preface your call to <see cref="M:System.Security.Cryptography.CryptoStream.FlushAsync(System.Threading.CancellationToken)" /> with the await (C#) or Await (Visual Basic) operator to suspend execution of the method until the task is complete. For more information, see <format type="text/html"><a href="db854f91-ccef-4035-ae4d-0911fde808c7">Asynchronous Programming with Async and Await (C# and Visual Basic)</a></format>.</para>
@@ -267,6 +266,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Clears all buffers for the current stream asynchronously, causes any buffered data to be written to the underlying device, and monitors cancellation requests.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous flush operation.</para>
+        </returns>
         <param name="cancellationToken">
           <attribution license="cc4" from="Microsoft" modified="false" />The token to monitor for cancellation requests. The default value is <see cref="P:System.Threading.CancellationToken.None" />.</param>
       </Docs>
@@ -383,12 +386,15 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a sequence of bytes from the current stream and advances the position within the stream by the number of bytes read.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The total number of bytes read into the buffer. This can be less than the number of bytes requested if that many bytes are not currently available, or zero if the end of the stream has been reached.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of bytes. A maximum of <paramref name="count" /> bytes are read from the current stream and stored in <paramref name="buffer" />. </param>
         <param name="offset">
@@ -414,7 +420,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You must preface your call to <see cref="M:System.Security.Cryptography.CryptoStream.ReadAsync(System.Byte[],System.Int32,System.Int32,System.Threading.CancellationToken)" /> with the await (C#) or Await (Visual Basic) operator to suspend execution of the method until the task is complete. For more information, see <format type="text/html"><a href="db854f91-ccef-4035-ae4d-0911fde808c7">Asynchronous Programming with Async and Await (C# and Visual Basic)</a></format>.</para>
@@ -424,6 +429,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads a sequence of bytes from the current stream asynchronously, advances the position within the stream by the number of bytes read, and monitors cancellation requests.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous read operation. The value of the task object's <paramref name="TResult" /> parameter contains the total number of bytes read into the buffer. The result can be less than the number of bytes requested if the number of bytes currently available is less than the requested number, or it can be 0 (zero) if the end of the stream has been reached. </para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer to write the data into.</param>
         <param name="offset">
@@ -451,7 +460,6 @@
         <Parameter Name="origin" Type="System.IO.SeekOrigin" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method exists only to support inheritance from <see cref="T:System.IO.Stream" />, and cannot be used.</para>
@@ -460,6 +468,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the position within the current stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method is not supported.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />A byte offset relative to the <paramref name="origin" /> parameter. </param>
         <param name="origin">
@@ -542,7 +554,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You must preface your call to <see cref="M:System.Security.Cryptography.CryptoStream.WriteAsync(System.Byte[],System.Int32,System.Int32,System.Threading.CancellationToken)" /> with the await (C#) or Await (Visual Basic) operator to suspend execution of the method until the task is complete. For more information, see <format type="text/html"><a href="db854f91-ccef-4035-ae4d-0911fde808c7">Asynchronous Programming with Async and Await (C# and Visual Basic)</a></format>.</para>
@@ -552,6 +563,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Writes a sequence of bytes to the current stream asynchronously, advances the current position within the stream by the number of bytes written, and monitors cancellation requests.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the asynchronous write operation.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The buffer to write data from.</param>
         <param name="offset">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/CspParameters.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/CspParameters.xml
index 4a4e6751235..db2e18370ca 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/CspParameters.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/CspParameters.xml
@@ -63,6 +63,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of the <see cref="T:System.Security.Cryptography.CspParameters" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created instance of <see cref="T:System.Security.Cryptography.CspParameters" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/DES.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/DES.xml
index abfc58da83f..98d33bb2d69 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/DES.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/DES.xml
@@ -110,7 +110,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'DES'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the <see cref="T:System.Security.Cryptography.DES" /> object that can be used for encrypting and decrypting data.</para>
@@ -119,6 +118,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of a cryptographic object to perform the Data Encryption Standard (<see cref="T:System.Security.Cryptography.DES" />) algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A cryptographic object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Create">
@@ -137,12 +140,15 @@
         <Parameter Name="algName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DES'</returns>
         <remarks>New implementation can be added, or currents can be modified, by modifying the machine.config configuration file.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of a cryptographic object to perform the specified implementation of the Data Encryption Standard (<see cref="T:System.Security.Cryptography.DES" />) algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A cryptographic object.</para>
+        </returns>
         <param name="algName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the specific implementation of <see cref="T:System.Security.Cryptography.DES" /> to use. </param>
       </Docs>
@@ -163,7 +169,6 @@
         <Parameter Name="rgbKey" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>True if the key is a known semi-weak key, false otherwise.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Semi-weak keys are pairs of keys that result in ciphers that are easy to break. If text is encrypted with a semi-weak key, encrypting the resulting cipher with the partner of that semi-weak key returns the original text. There are six known semi-weak key pairs for the Data Encryption Standard (<see cref="T:System.Security.Cryptography.DES" />) algorithm; this method checks for those semi-weak keys.</para>
@@ -173,6 +178,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified key is semi-weak.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key is semi-weak; otherwise, false.</para>
+        </returns>
         <param name="rgbKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The secret key to test for semi-weakness. </param>
       </Docs>
@@ -193,7 +202,6 @@
         <Parameter Name="rgbKey" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>True if the key is a known weak key, false otherwise.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Weak keys are keys that result in ciphers that are easy to break. If text is encrypted with a weak key, encrypting the resulting cipher again with the same weak key returns the original text. There are four known weak keys for the Data Encryption Standard (<see cref="T:System.Security.Cryptography.DES" />) algorithm; this method checks for those weak keys.</para>
@@ -203,6 +211,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified key is weak.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key is weak; otherwise, false.</para>
+        </returns>
         <param name="rgbKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The secret key to test for weakness. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/DESCryptoServiceProvider.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/DESCryptoServiceProvider.xml
index edc2ea3ee73..484a992dc95 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/DESCryptoServiceProvider.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/DESCryptoServiceProvider.xml
@@ -80,7 +80,6 @@ DESCryptoServiceProvider des = new DESCryptoServiceProvider ();
         <Parameter Name="rgbIV" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Security.Cryptography.ICryptoTransform" /> that is ready to be used to decrypt data.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method decrypts an encrypted message that was created using the <see cref="M:System.Security.Cryptography.DESCryptoServiceProvider.CreateEncryptor(System.Byte[],System.Byte[])" /> overload with the same parameters.</para>
@@ -89,6 +88,10 @@ DESCryptoServiceProvider des = new DESCryptoServiceProvider ();
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric Data Encryption Standard (<see cref="T:System.Security.Cryptography.DES" />) decryptor object with the specified key (<see cref="P:System.Security.Cryptography.SymmetricAlgorithm.Key" />) and initialization vector (<see cref="P:System.Security.Cryptography.SymmetricAlgorithm.IV" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A symmetric <see cref="T:System.Security.Cryptography.DES" /> decryptor object.</para>
+        </returns>
         <param name="rgbKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The secret key to use for the symmetric algorithm. </param>
         <param name="rgbIV">
@@ -112,7 +115,6 @@ DESCryptoServiceProvider des = new DESCryptoServiceProvider ();
         <Parameter Name="rgbIV" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Security.Cryptography.ICryptoTransform" /> that is ready to be used to encrypt data.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Security.Cryptography.DESCryptoServiceProvider.CreateDecryptor(System.Byte[],System.Byte[])" /> overload with the same parameters to decrypt the result of this method.</para>
@@ -121,6 +123,10 @@ DESCryptoServiceProvider des = new DESCryptoServiceProvider ();
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric Data Encryption Standard (<see cref="T:System.Security.Cryptography.DES" />) encryptor object with the specified key (<see cref="P:System.Security.Cryptography.SymmetricAlgorithm.Key" />) and initialization vector (<see cref="P:System.Security.Cryptography.SymmetricAlgorithm.IV" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A symmetric <see cref="T:System.Security.Cryptography.DES" /> encryptor object.</para>
+        </returns>
         <param name="rgbKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The secret key to use for the symmetric algorithm. </param>
         <param name="rgbIV">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/DSA.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/DSA.xml
index 26661a88691..0b2391582f9 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/DSA.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/DSA.xml
@@ -66,12 +66,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'DSA'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the default cryptographic object used to perform the asymmetric algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A cryptographic object used to perform the asymmetric algorithm.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Create">
@@ -90,7 +93,6 @@
         <Parameter Name="algName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DSA'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For <see cref="T:System.Security.Cryptography.DSA" />, use the name System.Security.Cryptography.DSA.</para>
@@ -99,6 +101,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the specified cryptographic object used to perform the asymmetric algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A cryptographic object used to perform the asymmetric algorithm.</para>
+        </returns>
         <param name="algName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the specific implementation of <see cref="T:System.Security.Cryptography.DSA" /> to use. </param>
       </Docs>
@@ -119,12 +125,15 @@
         <Parameter Name="rgbHash" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>An array of 40 bytes containing the DSA signature of the specified hash.</returns>
         <remarks>A <see cref="T:System.Security.Cryptography.CryptographicException" /> will be thrown if the instance doesn't have a private key or if the parameter rgbHash isn't exactly 20 bytes long (like all SHA1 hashes are).</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates the <see cref="T:System.Security.Cryptography.DSA" /> signature for the specified data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The digital signature for the specified data.</para>
+        </returns>
         <param name="rgbHash">
           <attribution license="cc4" from="Microsoft" modified="false" />The data to be signed. </param>
       </Docs>
@@ -145,12 +154,15 @@
         <Parameter Name="includePrivateParameters" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>a DSAParameters structure contaning each parameters of the key.</returns>
         <remarks>You are responsable to zeroize the private key (<see cref="T:System.Security.Cryptography.DSAParameters" />.<see cref="M:System.Security.Cryptography.DSAParameters.X" />) if you export it from the instance.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, exports the <see cref="T:System.Security.Cryptography.DSAParameters" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The parameters for <see cref="T:System.Security.Cryptography.DSA" />.</para>
+        </returns>
         <param name="includePrivateParameters">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include private parameters; otherwise, false. </param>
       </Docs>
@@ -221,12 +233,15 @@
         <Parameter Name="includePrivateParameters" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>An XML string containing the representation of the DSA key.</returns>
         <remarks>The schema definition for DSA keys is detailled in section 4.4.2.1 of the "XML-Signature Syntax and Processing" available at http://www.w3.org/TR/xmldsig-core/</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an XML string representation of the current <see cref="T:System.Security.Cryptography.DSA" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML string encoding of the current <see cref="T:System.Security.Cryptography.DSA" /> object.</para>
+        </returns>
         <param name="includePrivateParameters">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include private parameters; otherwise, false. </param>
       </Docs>
@@ -248,12 +263,15 @@
         <Parameter Name="rgbSignature" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>True if the signature can be verified, false otherwise.</returns>
         <remarks>A <see cref="T:System.Security.Cryptography.CryptographicException" /> will be thrown if the parameter rgbHash isn't exactly 20 bytes long (like all SHA1 hashes are) or if the signature length isn't 40 bytes long (as all DSA signatures are).</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, verifies the <see cref="T:System.Security.Cryptography.DSA" /> signature for the specified data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="rgbSignature" /> matches the signature computed using the specified hash algorithm and key on <paramref name="rgbHash" />; otherwise, false.</para>
+        </returns>
         <param name="rgbHash">
           <attribution license="cc4" from="Microsoft" modified="false" />The hash of the data signed with <paramref name="rgbSignature" />. </param>
         <param name="rgbSignature">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/DSACryptoServiceProvider.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/DSACryptoServiceProvider.xml
index 26a2409915b..eb74feb6d93 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/DSACryptoServiceProvider.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/DSACryptoServiceProvider.xml
@@ -146,12 +146,15 @@
         <Parameter Name="rgbHash" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>An array of 40 bytes containing the DSA signature of the specified hash.</returns>
         <remarks>A <see cref="T:System.Security.Cryptography.CryptographicException" /> will be thrown if the instance doesn't have a private key or if the parameter rgbHash isn't exactly 20 bytes long (like all SHA1 hashes are).</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the <see cref="T:System.Security.Cryptography.DSA" /> signature for the specified data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The digital signature for the specified data.</para>
+        </returns>
         <param name="rgbHash">
           <attribution license="cc4" from="Microsoft" modified="false" />The data to be signed. </param>
       </Docs>
@@ -235,7 +238,6 @@
         <Parameter Name="includePrivateParameters" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -245,6 +247,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Exports a blob containing the key information associated with a <see cref="T:System.Security.Cryptography.DSACryptoServiceProvider" /> object.  </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array containing the key information associated with a <see cref="T:System.Security.Cryptography.DSACryptoServiceProvider" /> object.</para>
+        </returns>
         <param name="includePrivateParameters">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include the private key; otherwise, false.</param>
       </Docs>
@@ -265,7 +271,6 @@
         <Parameter Name="includePrivateParameters" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>a DSAParameters structure contaning each parameters of the key.</returns>
         <remarks>
           <para>A <see cref="T:System.Security.Cryptography.CryptographicException" /> is thrown if the private key is requested but not available. Sadly there is not way (before 2.0) to know if the private key is available without throwing an exception. Here is a safe way to test for the private key presence:</para>
           <example>
@@ -293,6 +298,10 @@ bool IsPrivateKeyAvailable (DSA dsa)
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Exports the <see cref="T:System.Security.Cryptography.DSAParameters" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The parameters for <see cref="T:System.Security.Cryptography.DSA" />.</para>
+        </returns>
         <param name="includePrivateParameters">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include private parameters; otherwise, false. </param>
       </Docs>
@@ -531,7 +540,6 @@ bool IsPrivateKeyAvailable (DSA dsa)
         <Parameter Name="buffer" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>The signature value of the processed buffer.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates a digital signature that is verified using the <see cref="M:System.Security.Cryptography.DSACryptoServiceProvider.VerifyData(System.Byte[],System.Byte[])" /> method.</para>
@@ -542,6 +550,10 @@ bool IsPrivateKeyAvailable (DSA dsa)
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the hash value of the specified byte array and signs the resulting hash value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Security.Cryptography.DSA" /> signature for the specified data.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The input data for which to compute the hash. </param>
       </Docs>
@@ -562,7 +574,6 @@ bool IsPrivateKeyAvailable (DSA dsa)
         <Parameter Name="inputStream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>The signature value of the processed stream.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -572,6 +583,10 @@ bool IsPrivateKeyAvailable (DSA dsa)
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the hash value of the specified input stream and signs the resulting hash value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Security.Cryptography.DSA" /> signature for the specified data.</para>
+        </returns>
         <param name="inputStream">
           <attribution license="cc4" from="Microsoft" modified="false" />The input data for which to compute the hash. </param>
       </Docs>
@@ -594,7 +609,6 @@ bool IsPrivateKeyAvailable (DSA dsa)
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>The signature value of the processed buffer.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates a digital signature that is verified using the <see cref="M:System.Security.Cryptography.DSACryptoServiceProvider.VerifyData(System.Byte[],System.Byte[])" /> method.</para>
@@ -605,6 +619,10 @@ bool IsPrivateKeyAvailable (DSA dsa)
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Signs a byte array from the specified start point to the specified end point.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Security.Cryptography.DSA" /> signature for the specified data.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The input data to sign. </param>
         <param name="offset">
@@ -630,7 +648,6 @@ bool IsPrivateKeyAvailable (DSA dsa)
         <Parameter Name="str" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>An array of 40 bytes containing the DSA signature of the specified hash.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates a digital signature that is verified using the <see cref="M:System.Security.Cryptography.DSACryptoServiceProvider.VerifyHash(System.Byte[],System.String,System.Byte[])" /> method.</para>
@@ -641,6 +658,10 @@ bool IsPrivateKeyAvailable (DSA dsa)
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the signature for the specified hash value by encrypting it with the private key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Security.Cryptography.DSA" /> signature for the specified hash value.</para>
+        </returns>
         <param name="rgbHash">
           <attribution license="cc4" from="Microsoft" modified="false" />The hash value of the data to be signed. </param>
         <param name="str">
@@ -688,7 +709,6 @@ bool IsPrivateKeyAvailable (DSA dsa)
         <Parameter Name="rgbSignature" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>True if the signature can be verified, false otherwise.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method verifies the <see cref="T:System.Security.Cryptography.DSA" /> digital signature produced by <see cref="M:System.Security.Cryptography.DSACryptoServiceProvider.SignData(System.IO.Stream)" />.</para>
@@ -699,6 +719,10 @@ bool IsPrivateKeyAvailable (DSA dsa)
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies the specified signature data by comparing it to the signature computed for the specified data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the signature verifies as valid; otherwise, false.</para>
+        </returns>
         <param name="rgbData">
           <attribution license="cc4" from="Microsoft" modified="false" />The data that was signed. </param>
         <param name="rgbSignature">
@@ -723,7 +747,6 @@ bool IsPrivateKeyAvailable (DSA dsa)
         <Parameter Name="rgbSignature" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>True if the signature can be verified, false otherwise. </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method verifies the <see cref="T:System.Security.Cryptography.DSA" /> digital signature produced by <see cref="M:System.Security.Cryptography.DSACryptoServiceProvider.SignHash(System.Byte[],System.String)" />.</para>
@@ -733,6 +756,10 @@ bool IsPrivateKeyAvailable (DSA dsa)
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies the specified signature data by comparing it to the signature computed for the specified hash value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the signature verifies as valid; otherwise, false.</para>
+        </returns>
         <param name="rgbHash">
           <attribution license="cc4" from="Microsoft" modified="false" />The hash value of the data to be signed. </param>
         <param name="str">
@@ -758,12 +785,15 @@ bool IsPrivateKeyAvailable (DSA dsa)
         <Parameter Name="rgbSignature" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>True if the signature can be verified, false otherwise. </returns>
         <remarks>A <see cref="T:System.Security.Cryptography.CryptographicException" /> will be thrown if the parameter rgbHash isn't exactly 20 bytes long (like all SHA1 hashes are) or if the signature length isn't 40 bytes long (as all DSA signatures are).</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies the <see cref="T:System.Security.Cryptography.DSA" /> signature for the specified data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="rgbSignature" /> matches the signature computed using the specified hash algorithm and key on <paramref name="rgbHash" />; otherwise, false.</para>
+        </returns>
         <param name="rgbHash">
           <attribution license="cc4" from="Microsoft" modified="false" />The data signed with <paramref name="rgbSignature" />. </param>
         <param name="rgbSignature">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/DSASignatureDeformatter.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/DSASignatureDeformatter.xml
index 3b33901c199..f038a94146e 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/DSASignatureDeformatter.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/DSASignatureDeformatter.xml
@@ -144,7 +144,6 @@ This class only support the <see cref="T:System.Security.Cryptography.SHA1" /> h
         <Parameter Name="rgbSignature" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>True if the signature match the specified hash (with the DSA public key), false otherwise.</returns>
         <remarks>
           <para>
 A <see cref="T:System.Security.Cryptography.CryptographicUnexpectedOperationException" /> will be thrown if a <see cref="T:System.Security.Cryptography.DSA" /> object instance hasn't been set in the constructor or by <see cref="M:System.Security.Cryptography.DSASignatureFormatter.SetKey" />.
@@ -160,6 +159,10 @@ The size of the signature, 40 bytes, isn't affected by the length of the public
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies the Digital Signature Algorithm (<see cref="T:System.Security.Cryptography.DSA" />) signature on the data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the signature is valid for the data; otherwise, false.</para>
+        </returns>
         <param name="rgbHash">
           <attribution license="cc4" from="Microsoft" modified="false" />The data signed with <paramref name="rgbSignature" />. </param>
         <param name="rgbSignature">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/DSASignatureFormatter.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/DSASignatureFormatter.xml
index f3ad4505185..be252486d9a 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/DSASignatureFormatter.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/DSASignatureFormatter.xml
@@ -89,7 +89,6 @@ f.SetKey (dsa);
         <Parameter Name="rgbHash" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>The signature is returned in a 40 bytes array.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The resulting signature data can be verified by using <see cref="M:System.Security.Cryptography.DSASignatureDeformatter.VerifySignature(System.Byte[],System.Byte[])" />.</para>
@@ -98,6 +97,10 @@ f.SetKey (dsa);
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the Digital Signature Algorithm (<see cref="T:System.Security.Cryptography.DSA" />) PKCS #1 signature for the specified data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The digital signature for the specified data.</para>
+        </returns>
         <param name="rgbHash">
           <attribution license="cc4" from="Microsoft" modified="false" />The data to be signed. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/DeriveBytes.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/DeriveBytes.xml
index 4df61ae18e8..c09b6c04618 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/DeriveBytes.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/DeriveBytes.xml
@@ -119,12 +119,15 @@
         <Parameter Name="cb" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>An array of bytes of the specified size.</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns pseudo-random key bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array filled with pseudo-random key bytes.</para>
+        </returns>
         <param name="cb">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of pseudo-random key bytes to generate. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/FromBase64Transform.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/FromBase64Transform.xml
index 88f6ed9f255..86b66731769 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/FromBase64Transform.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/FromBase64Transform.xml
@@ -309,12 +309,15 @@
         <Parameter Name="outputOffset" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified region of the input byte array from base 64 and copies the result to the specified region of the output byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes written.</para>
+        </returns>
         <param name="inputBuffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The input to compute from base 64. </param>
         <param name="inputOffset">
@@ -345,12 +348,15 @@
         <Parameter Name="inputCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified region of the specified byte array from base 64.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The computed conversion.</para>
+        </returns>
         <param name="inputBuffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The input to convert from base 64. </param>
         <param name="inputOffset">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/HMAC.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/HMAC.xml
index 629a88c0e38..1b5b948a94a 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/HMAC.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/HMAC.xml
@@ -85,7 +85,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -95,6 +94,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the default implementation of a Hash-based Message Authentication Code (HMAC).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new SHA-1 instance, unless the default settings have been changed by using the <format type="text/html"><a href="03db52ef-010e-44ea-b6fd-b9c900ecad50">&lt;cryptoClass&gt; element</a></format>.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Create">
@@ -112,7 +115,6 @@
         <Parameter Name="algorithmName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -122,6 +124,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the specified implementation of a Hash-based Message Authentication Code (HMAC).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the specified HMAC implementation.</para>
+        </returns>
         <param name="algorithmName">
           <attribution license="cc4" from="Microsoft" modified="false" />The HMAC implementation to use. The following table shows the valid values for the <paramref name="algorithmName" /> parameter and the algorithms they map to.</param>
       </Docs>
@@ -203,7 +209,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -213,6 +218,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, finalizes the hash computation after the last data is processed by the cryptographic stream object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The computed hash code in a byte array.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HashName">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/HashAlgorithm.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/HashAlgorithm.xml
index d5749efa340..33bea7a366d 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/HashAlgorithm.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/HashAlgorithm.xml
@@ -140,12 +140,15 @@
         <Parameter Name="buffer" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>The hash value of the processed buffer.</returns>
         <remarks>A copy of the return value is kept in the <see cref="P:System.Security.Cryptography.HashAlgorithm.Hash" /> property until the <see cref="M:System.Security.Cryptography.HashAlgorithm.Initialize" /> method is called.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the hash value for the specified byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The computed hash code.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The input to compute the hash code for. </param>
       </Docs>
@@ -166,12 +169,15 @@
         <Parameter Name="inputStream" Type="System.IO.Stream" />
       </Parameters>
       <Docs>
-        <returns>The hash value of the processed stream.</returns>
         <remarks>A copy of the return value is kept in the <see cref="P:System.Security.Cryptography.HashAlgorithm.Hash" /> property until the <see cref="M:System.Security.Cryptography.HashAlgorithm.Initialize" /> method is called.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the hash value for the specified <see cref="T:System.IO.Stream" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The computed hash code.</para>
+        </returns>
         <param name="inputStream">
           <attribution license="cc4" from="Microsoft" modified="false" />The input to compute the hash code for. </param>
       </Docs>
@@ -194,12 +200,15 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>The hash value of the processed buffer.</returns>
         <remarks>A copy of the return value is kept in the <see cref="P:System.Security.Cryptography.HashAlgorithm.Hash" /> property until the <see cref="M:System.Security.Cryptography.HashAlgorithm.Initialize" /> method is called.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the hash value for the specified region of the specified byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The computed hash code.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The input to compute the hash code for. </param>
         <param name="offset">
@@ -222,7 +231,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>An instance of the default HashAlgorithm implementation, <see cref="T:System.Security.Cryptography.SHA1CryptoServiceProvider" />.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>By default, this overload uses the <see cref="T:System.Security.Cryptography.SHA1CryptoServiceProvider" /> implementation of a hash algorithm. If you want to specify a different implementation, use the <see cref="M:System.Security.Cryptography.HashAlgorithm.Create(System.String)" /> overload, which lets you specify an algorithm name, instead. The cryptography configuration system defines the default implementation of <see cref="T:System.Security.Cryptography.HashAlgorithm" />. </para>
@@ -231,6 +239,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the default implementation of a hash algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Security.Cryptography.SHA1CryptoServiceProvider" /> instance, unless the default settings have been changed using the <format type="text/html"><a href="03db52ef-010e-44ea-b6fd-b9c900ecad50">&lt;cryptoClass&gt; Element</a></format>.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Create">
@@ -249,12 +261,15 @@
         <Parameter Name="hashName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>An instance of the specified HashAlgorithm or null if the name isn't a well known name or defined in machine.config. </returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the specified implementation of a hash algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the specified hash algorithm, or null if <paramref name="hashName" /> is not a valid hash algorithm.</para>
+        </returns>
         <param name="hashName">
           <attribution license="cc4" from="Microsoft" modified="false" />The hash algorithm implementation to use. The following table shows the valid values for the <paramref name="hashName" /> parameter and the algorithms they map to. </param>
       </Docs>
@@ -387,7 +402,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method finalizes any partial computation and returns the correct hash value for the data stream.</para>
@@ -396,6 +410,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, finalizes the hash computation after the last data is processed by the cryptographic stream object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The computed hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HashSize">
@@ -604,7 +622,6 @@
         <Parameter Name="outputOffset" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You must call the <see cref="M:System.Security.Cryptography.HashAlgorithm.TransformBlock(System.Byte[],System.Int32,System.Int32,System.Byte[],System.Int32)" /> method before calling the <see cref="M:System.Security.Cryptography.HashAlgorithm.TransformFinalBlock(System.Byte[],System.Int32,System.Int32)" /> method. You must call both methods before you retrieve the final hash value.</para>
@@ -615,6 +632,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the hash value for the specified region of the input byte array and copies the specified region of the input byte array to the specified region of the output byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes written.</para>
+        </returns>
         <param name="inputBuffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The input to compute the hash code for. </param>
         <param name="inputOffset">
@@ -645,7 +666,6 @@
         <Parameter Name="inputCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>Return a byte array containing the last processed block. </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You must call the <see cref="M:System.Security.Cryptography.HashAlgorithm.TransformFinalBlock(System.Byte[],System.Int32,System.Int32)" /> method after calling the <see cref="M:System.Security.Cryptography.HashAlgorithm.TransformBlock(System.Byte[],System.Int32,System.Int32,System.Byte[],System.Int32)" /> method but before you retrieve the final hash value. </para>
@@ -655,6 +675,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the hash value for the specified region of the specified byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that is a copy of the part of the input that is hashed.</para>
+        </returns>
         <param name="inputBuffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The input to compute the hash code for. </param>
         <param name="inputOffset">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/ICryptoTransform.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/ICryptoTransform.xml
index c5b26e2912a..29e89f2596b 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/ICryptoTransform.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/ICryptoTransform.xml
@@ -135,12 +135,15 @@
         <Parameter Name="outputOffset" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Transforms the specified region of the input byte array and copies the resulting transform to the specified region of the output byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes written.</para>
+        </returns>
         <param name="inputBuffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The input for which to compute the transform. </param>
         <param name="inputOffset">
@@ -171,7 +174,6 @@
         <Parameter Name="inputCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -181,6 +183,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Transforms the specified region of the specified byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The computed transform.</para>
+        </returns>
         <param name="inputBuffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The input for which to compute the transform. </param>
         <param name="inputOffset">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/ICspAsymmetricAlgorithm.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/ICspAsymmetricAlgorithm.xml
index 62ae7fc0fac..887bbbcc262 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/ICspAsymmetricAlgorithm.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/ICspAsymmetricAlgorithm.xml
@@ -64,7 +64,6 @@
         <Parameter Name="includePrivateParameters" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -74,6 +73,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Exports a blob that contains the key information associated with an <see cref="T:System.Security.Cryptography.AsymmetricAlgorithm" /> object.  </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array that contains the key information associated with an <see cref="T:System.Security.Cryptography.AsymmetricAlgorithm" /> object.</para>
+        </returns>
         <param name="includePrivateParameters">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include the private key; otherwise, false.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/KeySizes.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/KeySizes.xml
index f8a55963ada..8dde70b671f 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/KeySizes.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/KeySizes.xml
@@ -48,6 +48,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of the <see cref="T:System.Security.Cryptography.KeySizes" /> class with the specified key values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created instance of <see cref="T:System.Security.Cryptography.KeySizes" />.</para>
+        </returns>
         <param name="minSize">
           <attribution license="cc4" from="Microsoft" modified="false" />The minimum valid key size. </param>
         <param name="maxSize">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/KeyedHashAlgorithm.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/KeyedHashAlgorithm.xml
index 9d8119b0405..5f983e6e5ea 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/KeyedHashAlgorithm.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/KeyedHashAlgorithm.xml
@@ -69,7 +69,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'KeyedHashAlgorithm'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>By default, this overload uses the <see cref="T:System.Security.Cryptography.HMACSHA1" /> implementation of a keyed hash algorithm. If you want to specify a different implementation, use the <see cref="M:System.Security.Cryptography.KeyedHashAlgorithm.Create(System.String)" /> overload, which lets you specify an algorithm name, instead. The cryptography configuration system defines the default implementation of the <see cref="T:System.Security.Cryptography.KeyedHashAlgorithm" /> class.</para>
@@ -78,6 +77,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the default implementation of a keyed hash algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Security.Cryptography.HMACSHA1" /> instance, unless the default settings have been changed.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Create">
@@ -96,7 +99,6 @@
         <Parameter Name="algName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'KeyedHashAlgorithm'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method supports a number of algorithms, including MD5, SHA-1, SHA-256, and RIPEMD160. For a full list, see the supported values for the <paramref name="algName" /> parameter.</para>
@@ -105,6 +107,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the specified implementation of a keyed hash algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the specified keyed hash algorithm.</para>
+        </returns>
         <param name="algName">
           <attribution license="cc4" from="Microsoft" modified="false" />The keyed hash algorithm implementation to use. The following table shows the valid values for the <paramref name="algName" /> parameter and the algorithms they map to.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/MACTripleDES.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/MACTripleDES.xml
index 8810e01525d..5c3a28af14c 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/MACTripleDES.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/MACTripleDES.xml
@@ -202,7 +202,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can read this value only after all data is written, and you cannot write more data afterward. Create a new instance of <see cref="T:System.Security.Cryptography.MACTripleDES" /> for each separate segment of data to compute the MAC for that data.</para>
@@ -211,6 +210,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the computed Message Authentication Code (MAC) after all data is written to the object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The computed MAC.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Initialize">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/MD5.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/MD5.xml
index e98e7c7029a..0230dafb4d7 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/MD5.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/MD5.xml
@@ -72,12 +72,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'MD5'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the default implementation of the <see cref="T:System.Security.Cryptography.MD5" /> hash algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the <see cref="T:System.Security.Cryptography.MD5" /> hash algorithm.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Create">
@@ -96,7 +99,6 @@
         <Parameter Name="algName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'MD5'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Possible values for <paramref name="algName" /> are: System.Security.Cryptography.MD5, MD5, System.Security.Cryptography.MD5CryptoServiceProvider, and System.Security.Cryptography.MD5Managed.</para>
@@ -105,6 +107,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the specified implementation of the <see cref="T:System.Security.Cryptography.MD5" /> hash algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the specified implementation of <see cref="T:System.Security.Cryptography.MD5" />.</para>
+        </returns>
         <param name="algName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the specific implementation of <see cref="T:System.Security.Cryptography.MD5" /> to use. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/MD5CryptoServiceProvider.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/MD5CryptoServiceProvider.xml
index 7d99c4dedfb..4a82fb4d220 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/MD5CryptoServiceProvider.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/MD5CryptoServiceProvider.xml
@@ -150,12 +150,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the computed <see cref="T:System.Security.Cryptography.MD5CryptoServiceProvider" /> hash value as an array of bytes after all data has been written to the object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The computed hash value.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Initialize">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/MaskGenerationMethod.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/MaskGenerationMethod.xml
index f23a37c943c..5df7d0c350e 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/MaskGenerationMethod.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/MaskGenerationMethod.xml
@@ -72,12 +72,15 @@
         <Parameter Name="cbReturn" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>An array of byte containing the generated mask.</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, generates a mask with the specified length using the specified random seed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A randomly generated mask whose length is equal to the <paramref name="cbReturn" /> parameter.</para>
+        </returns>
         <param name="rgbSeed">
           <attribution license="cc4" from="Microsoft" modified="false" />The random seed to use to compute the mask. </param>
         <param name="cbReturn">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/PKCS1MaskGenerationMethod.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/PKCS1MaskGenerationMethod.xml
index 90e8b1b0c4a..e96a01b7a23 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/PKCS1MaskGenerationMethod.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/PKCS1MaskGenerationMethod.xml
@@ -69,7 +69,6 @@
         <Parameter Name="cbReturn" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>An array of byte containing the generated mask.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Masks are used in key exchange computation and generally are not used by applications.</para>
@@ -78,6 +77,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Generates and returns a mask from the specified random seed of the specified length.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A randomly generated mask whose length is equal to the <paramref name="cbReturn" /> parameter.</para>
+        </returns>
         <param name="rgbSeed">
           <attribution license="cc4" from="Microsoft" modified="false" />The random seed to use for computing the mask. </param>
         <param name="cbReturn">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/PasswordDeriveBytes.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/PasswordDeriveBytes.xml
index 01b85a042e6..fb3c724eb42 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/PasswordDeriveBytes.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/PasswordDeriveBytes.xml
@@ -336,7 +336,6 @@
         <Parameter Name="rgbIV" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>An array of the specified length contaning bytes derived of the secret password and other (possibly public) informations.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This function is a wrapper for the Crypto API function CryptDeriveKey(), and is intended to offer interoperability with applications using the Crypto API.</para>
@@ -346,6 +345,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Derives a cryptographic key from the <see cref="T:System.Security.Cryptography.PasswordDeriveBytes" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The derived key.</para>
+        </returns>
         <param name="algname">
           <attribution license="cc4" from="Microsoft" modified="false" />The algorithm name for which to derive the key. </param>
         <param name="alghashname">
@@ -420,7 +423,6 @@
         <Parameter Name="cb" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>An array of the specified length contaning bytes derived of the secret password and other (possibly public) informations.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can create any number of pseudo-random bytes. However, the strength of the byte sequence is limited by the number of bytes in the hash output.</para>
@@ -429,6 +431,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns pseudo-random key bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array filled with pseudo-random key bytes.</para>
+        </returns>
         <param name="cb">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of pseudo-random key bytes to generate. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RC2.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RC2.xml
index 96576c4c1e0..be1f9943464 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RC2.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RC2.xml
@@ -110,7 +110,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'RC2'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create an instance of the RC2 class that you can use to encrypt and decrypt data.</para>
@@ -119,6 +118,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of a cryptographic object to perform the <see cref="T:System.Security.Cryptography.RC2" /> algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of a cryptographic object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Create">
@@ -137,7 +140,6 @@
         <Parameter Name="AlgName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'RC2'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create an instance of the RC2 class that you can use to encrypt and decrypt data.</para>
@@ -146,6 +148,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of a cryptographic object to perform the specified implementation of the <see cref="T:System.Security.Cryptography.RC2" /> algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of a cryptographic object.</para>
+        </returns>
         <param name="AlgName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the specific implementation of <see cref="T:System.Security.Cryptography.RC2" /> to use. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RC2CryptoServiceProvider.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RC2CryptoServiceProvider.xml
index 65ee137eb3d..d93d4454f41 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RC2CryptoServiceProvider.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RC2CryptoServiceProvider.xml
@@ -72,7 +72,6 @@
         <Parameter Name="rgbIV" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Security.Cryptography.ICryptoTransform" /> that is ready to be used to decrypt data.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is used to decrypt an encrypted message created using the <see cref="M:System.Security.Cryptography.RC2CryptoServiceProvider.CreateEncryptor(System.Byte[],System.Byte[])" /> overload with the same parameters.</para>
@@ -81,6 +80,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric <see cref="T:System.Security.Cryptography.RC2" /> decryptor object with the specified key (<see cref="P:System.Security.Cryptography.SymmetricAlgorithm.Key" />)and initialization vector (<see cref="P:System.Security.Cryptography.SymmetricAlgorithm.IV" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A symmetric <see cref="T:System.Security.Cryptography.RC2" /> decryptor object.</para>
+        </returns>
         <param name="rgbKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The secret key to use for the symmetric algorithm. </param>
         <param name="rgbIV">
@@ -104,7 +107,6 @@
         <Parameter Name="rgbIV" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Security.Cryptography.ICryptoTransform" /> that is ready to be used to encrypt data.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Security.Cryptography.RC2CryptoServiceProvider.CreateDecryptor(System.Byte[],System.Byte[])" /> overload with the same parameters to decrypt the result of this method.</para>
@@ -113,6 +115,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric <see cref="T:System.Security.Cryptography.RC2" /> encryptor object with the specified key (<see cref="P:System.Security.Cryptography.SymmetricAlgorithm.Key" />) and initialization vector (<see cref="P:System.Security.Cryptography.SymmetricAlgorithm.IV" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A symmetric <see cref="T:System.Security.Cryptography.RC2" /> encryptor object.</para>
+        </returns>
         <param name="rgbKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The secret key to use for the symmetric algorithm. </param>
         <param name="rgbIV">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RIPEMD160.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RIPEMD160.xml
index e5d01ed7f1d..3165db15654 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RIPEMD160.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RIPEMD160.xml
@@ -67,7 +67,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -77,6 +76,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the default implementation of the <see cref="T:System.Security.Cryptography.RIPEMD160" /> hash algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the <see cref="T:System.Security.Cryptography.RIPEMD160" /> hash algorithm.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Create">
@@ -94,7 +97,6 @@
         <Parameter Name="hashName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -104,6 +106,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the specified implementation of the <see cref="T:System.Security.Cryptography.RIPEMD160" /> hash algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the specified implementation of <see cref="T:System.Security.Cryptography.RIPEMD160" />.</para>
+        </returns>
         <param name="hashName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the specific implementation of <see cref="T:System.Security.Cryptography.RIPEMD160" /> to use. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RIPEMD160Managed.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RIPEMD160Managed.xml
index ec3fe76ed10..5bbfa4095f9 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RIPEMD160Managed.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RIPEMD160Managed.xml
@@ -118,7 +118,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -128,6 +127,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, finalizes the hash computation after the last data is processed by the cryptographic stream object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The computed hash code in a byte array.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Initialize">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSA.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSA.xml
index 27468c24361..c4f71941281 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSA.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSA.xml
@@ -69,12 +69,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'RSA'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the default implementation of the <see cref="T:System.Security.Cryptography.RSA" /> algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the default implementation of <see cref="T:System.Security.Cryptography.RSA" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Create">
@@ -93,12 +96,15 @@
         <Parameter Name="algName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'RSA'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the specified implementation of <see cref="T:System.Security.Cryptography.RSA" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of the specified implementation of <see cref="T:System.Security.Cryptography.RSA" />.</para>
+        </returns>
         <param name="algName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the implementation of <see cref="T:System.Security.Cryptography.RSA" /> to use. </param>
       </Docs>
@@ -119,12 +125,15 @@
         <Parameter Name="rgb" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>An array of bytes containing the decrypted data. </returns>
         <remarks>Direct (raw) decryption (i.e. without padding) is discouraged due to high security risks.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, decrypts the input data using the private key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The resulting decryption of the <paramref name="rgb" /> parameter in plain text.</para>
+        </returns>
         <param name="rgb">
           <attribution license="cc4" from="Microsoft" modified="false" />The cipher text to be decrypted. </param>
       </Docs>
@@ -145,12 +154,15 @@
         <Parameter Name="rgb" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>An array of bytes containing the encrypted data.</returns>
         <remarks>Direct (raw) encryption (i.e. without padding) is discouraged due to high security risks.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, encrypts the input data using the public key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The resulting encryption of the <paramref name="rgb" /> parameter as cipher text.</para>
+        </returns>
         <param name="rgb">
           <attribution license="cc4" from="Microsoft" modified="false" />The plain text to be encrypted. </param>
       </Docs>
@@ -171,12 +183,15 @@
         <Parameter Name="includePrivateParameters" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>a RSAParameters structure contaning each parameters of the key.</returns>
         <remarks>You are responsable to zeroize the private key (<see cref="T:System.Security.Cryptography.RSAParameters" /> parameters <see cref="M:System.Security.Cryptography.RSAParameters.D" />, <see cref="M:System.Security.Cryptography.RSAParameters.P" />, <see cref="M:System.Security.Cryptography.RSAParameters.Q" />, <see cref="M:System.Security.Cryptography.RSAParameters.DP" />, <see cref="M:System.Security.Cryptography.RSAParameters.DQ" /> and <see cref="M:System.Security.Cryptography.RSAParameters.InverseQ" />) if you export it from the instance.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, exports the <see cref="T:System.Security.Cryptography.RSAParameters" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The parameters for <see cref="T:System.Security.Cryptography.DSA" />.</para>
+        </returns>
         <param name="includePrivateParameters">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include private parameters; otherwise, false. </param>
       </Docs>
@@ -254,7 +269,6 @@
         <Parameter Name="includePrivateParameters" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>An XML string containing the representation of the RSA key.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Security.Cryptography.RSA.ToXmlString(System.Boolean)" /> method creates an XML string that contains either the public and private key of the current <see cref="T:System.Security.Cryptography.RSA" /> object or contains only the public key of the current <see cref="T:System.Security.Cryptography.RSA" /> object.</para>
@@ -283,6 +297,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an XML string containing the key of the current <see cref="T:System.Security.Cryptography.RSA" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML string containing the key of the current <see cref="T:System.Security.Cryptography.RSA" /> object.</para>
+        </returns>
         <param name="includePrivateParameters">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include a public and private RSA key; false to include only the public key. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSACryptoServiceProvider.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSACryptoServiceProvider.xml
index d846c361a8b..a5e73276ca1 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSACryptoServiceProvider.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSACryptoServiceProvider.xml
@@ -202,7 +202,6 @@
         <Parameter Name="fOAEP" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>An array of bytes containing the decrypted data.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use <see cref="M:System.Security.Cryptography.RSACryptoServiceProvider.Encrypt(System.Byte[],System.Boolean)" /> to encrypt data for decryption with this method.</para>
@@ -211,6 +210,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decrypts data with the <see cref="T:System.Security.Cryptography.RSA" /> algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The decrypted data, which is the original plain text before encryption.</para>
+        </returns>
         <param name="rgb">
           <attribution license="cc4" from="Microsoft" modified="false" />The data to be decrypted. </param>
         <param name="fOAEP">
@@ -233,7 +236,6 @@
         <Parameter Name="rgb" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>An array of bytes containing the decrypted data. </returns>
         <remarks>
           <para>Note: This method is implemented in Mono but isn't supported in the Microsoft .NET framework. There are good reason for this:</para>
           <list type="bullet">
@@ -252,6 +254,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is not supported in the current version.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The decrypted data, which is the original plain text before encryption.</para>
+        </returns>
         <param name="rgb">
           <attribution license="cc4" from="Microsoft" modified="false" />The data to be decrypted. </param>
       </Docs>
@@ -302,7 +308,6 @@
         <Parameter Name="fOAEP" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>An array of bytes containing the encrypted data.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following table describes the padding supported by different versions of Microsoft Windows and the maximum length of <paramref name="rgb" /> allowed by the different combinations of operating systems and padding.</para>
@@ -360,6 +365,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encrypts data with the <see cref="T:System.Security.Cryptography.RSA" /> algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The encrypted data.</para>
+        </returns>
         <param name="rgb">
           <attribution license="cc4" from="Microsoft" modified="false" />The data to be encrypted. </param>
         <param name="fOAEP">
@@ -382,7 +391,6 @@
         <Parameter Name="rgb" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>An array of bytes containing the encrypted data.</returns>
         <remarks>
           <para>Note: This method is implemented in Mono but isn't supported in the Microsoft .NET framework. There are good reason for this:</para>
           <list type="bullet">
@@ -401,6 +409,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is not supported in the current version.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The encrypted data.</para>
+        </returns>
         <param name="rgb">
           <attribution license="cc4" from="Microsoft" modified="false" />The data to be encrypted. </param>
       </Docs>
@@ -425,7 +437,6 @@
         <Parameter Name="includePrivateParameters" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -435,6 +446,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Exports a blob containing the key information associated with an <see cref="T:System.Security.Cryptography.RSACryptoServiceProvider" /> object.  </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array containing the key information associated with an <see cref="T:System.Security.Cryptography.RSACryptoServiceProvider" /> object.</para>
+        </returns>
         <param name="includePrivateParameters">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include the private key; otherwise, false.</param>
       </Docs>
@@ -455,12 +470,15 @@
         <Parameter Name="includePrivateParameters" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>a RSAParameters structure contaning each parameters of the key.</returns>
         <remarks>You are responsable to zeroize the private key (<see cref="T:System.Security.Cryptography.RSAParameters" /> parameters <see cref="M:System.Security.Cryptography.RSAParameters.D" />, <see cref="M:System.Security.Cryptography.RSAParameters.P" />, <see cref="M:System.Security.Cryptography.RSAParameters.Q" />, <see cref="M:System.Security.Cryptography.RSAParameters.DP" />, <see cref="M:System.Security.Cryptography.RSAParameters.DQ" /> and <see cref="M:System.Security.Cryptography.RSAParameters.InverseQ" />) if you export it from the instance.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Exports the <see cref="T:System.Security.Cryptography.RSAParameters" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The parameters for <see cref="T:System.Security.Cryptography.RSA" />.</para>
+        </returns>
         <param name="includePrivateParameters">
           <attribution license="cc4" from="Microsoft" modified="false" />true to include private parameters; otherwise, false. </param>
       </Docs>
@@ -688,7 +706,6 @@
         <Parameter Name="halg" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>The signature value of the processed buffer.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates a digital signature that is verified using the <see cref="M:System.Security.Cryptography.RSACryptoServiceProvider.VerifyData(System.Byte[],System.Object,System.Byte[])" /> method.</para>
@@ -698,6 +715,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the hash value of the specified byte array using the specified hash algorithm, and signs the resulting hash value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Security.Cryptography.RSA" /> signature for the specified data.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The input data for which to compute the hash. </param>
         <param name="halg">
@@ -721,7 +742,6 @@
         <Parameter Name="halg" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>The signature value of the processed buffer.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="halg" /> parameter can accept a <see cref="T:System.String" />, a <see cref="T:System.Security.Cryptography.HashAlgorithm" />, or a <see cref="T:System.Type" />.</para>
@@ -730,6 +750,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the hash value of the specified input stream using the specified hash algorithm, and signs the resulting hash value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Security.Cryptography.RSA" /> signature for the specified data.</para>
+        </returns>
         <param name="inputStream">
           <attribution license="cc4" from="Microsoft" modified="false" />The input data for which to compute the hash. </param>
         <param name="halg">
@@ -755,7 +779,6 @@
         <Parameter Name="halg" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>The signature value of the processed buffer.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates a digital signature that is verified using the <see cref="M:System.Security.Cryptography.RSACryptoServiceProvider.VerifyData(System.Byte[],System.Object,System.Byte[])" /> method.</para>
@@ -774,6 +797,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the hash value of a subset of the specified byte array using the specified hash algorithm, and signs the resulting hash value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Security.Cryptography.RSA" /> signature for the specified data.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The input data for which to compute the hash. </param>
         <param name="offset">
@@ -801,7 +828,6 @@
         <Parameter Name="str" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>The signature value of the processed buffer.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates a digital signature that is verified using the <see cref="M:System.Security.Cryptography.RSACryptoServiceProvider.VerifyHash(System.Byte[],System.String,System.Byte[])" /> method.</para>
@@ -811,6 +837,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the signature for the specified hash value by encrypting it with the private key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Security.Cryptography.RSA" /> signature for the specified hash value.</para>
+        </returns>
         <param name="rgbHash">
           <attribution license="cc4" from="Microsoft" modified="false" />The hash value of the data to be signed. </param>
         <param name="str">
@@ -859,7 +889,6 @@
         <Parameter Name="signature" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>True if the signature can be verified, false otherwise.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method verifies the <see cref="T:System.Security.Cryptography.RSA" /> digital signature produced by the <see cref="M:System.Security.Cryptography.RSACryptoServiceProvider.SignData(System.IO.Stream,System.Object)" /> method. The signature is verified by obtaining the hash value from the signature using the public key it was signed with, and comparing that value to the hash value of the provided data.</para>
@@ -869,6 +898,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies that a digital signature is valid by determining the hash value in the signature using the provided public key and comparing it to the hash value of the provided data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the signature is valid; otherwise, false.</para>
+        </returns>
         <param name="buffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The data that was signed. </param>
         <param name="halg">
@@ -895,7 +928,6 @@
         <Parameter Name="rgbSignature" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>True if the signature can be verified, false otherwise.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method verifies the <see cref="T:System.Security.Cryptography.RSA" /> digital signature produced by the <see cref="M:System.Security.Cryptography.RSACryptoServiceProvider.SignHash(System.Byte[],System.String)" /> method. The signature is verified by obtaining the hash value from the signature using the public key it was signed with, and comparing that value to the hash value of the provided data.</para>
@@ -905,6 +937,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies that a digital signature is valid by determining the hash value in the signature using the provided public key and comparing it to the provided hash value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the signature is valid; otherwise, false.</para>
+        </returns>
         <param name="rgbHash">
           <attribution license="cc4" from="Microsoft" modified="false" />The hash value of the signed data. </param>
         <param name="str">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSAOAEPKeyExchangeDeformatter.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSAOAEPKeyExchangeDeformatter.xml
index 286d2d4ce9c..5ad9f1ed8c4 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSAOAEPKeyExchangeDeformatter.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSAOAEPKeyExchangeDeformatter.xml
@@ -95,7 +95,6 @@
         <Parameter Name="rgbData" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You must specify a key before calling this method.</para>
@@ -104,6 +103,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Extracts secret information from the encrypted key exchange data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The secret information derived from the key exchange data.</para>
+        </returns>
         <param name="rgbData">
           <attribution license="cc4" from="Microsoft" modified="false" />The key exchange data within which the secret information is hidden. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSAOAEPKeyExchangeFormatter.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSAOAEPKeyExchangeFormatter.xml
index 75209d024ea..93c61cd523e 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSAOAEPKeyExchangeFormatter.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSAOAEPKeyExchangeFormatter.xml
@@ -95,7 +95,6 @@
         <Parameter Name="rgbData" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This data can be interpreted only by the holder of the private key corresponding to the public key used to encrypt the data. This helps to ensure that only the intended recipient can access the secret information.</para>
@@ -104,6 +103,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the encrypted key exchange data from the specified input data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The encrypted key exchange data to be sent to the intended recipient.</para>
+        </returns>
         <param name="rgbData">
           <attribution license="cc4" from="Microsoft" modified="false" />The secret information to be passed in the key exchange. </param>
       </Docs>
@@ -125,7 +128,6 @@
         <Parameter Name="symAlgType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This data can be interpreted only by the holder of the private key corresponding to the public key used to encrypt the data. This helps to ensure that only the intended recipient can access the secret information.</para>
@@ -134,6 +136,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the encrypted key exchange data from the specified input data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The encrypted key exchange data to be sent to the intended recipient.</para>
+        </returns>
         <param name="rgbData">
           <attribution license="cc4" from="Microsoft" modified="false" />The secret information to be passed in the key exchange. </param>
         <param name="symAlgType">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSAPKCS1KeyExchangeDeformatter.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSAPKCS1KeyExchangeDeformatter.xml
index a31eeed100c..f626e6cc1f1 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSAPKCS1KeyExchangeDeformatter.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSAPKCS1KeyExchangeDeformatter.xml
@@ -95,7 +95,6 @@
         <Parameter Name="rgbIn" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You must specify a key before calling this method.</para>
@@ -104,6 +103,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Extracts secret information from the encrypted key exchange data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The secret information derived from the key exchange data.</para>
+        </returns>
         <param name="rgbIn">
           <attribution license="cc4" from="Microsoft" modified="false" />The key exchange data within which the secret information is hidden. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSAPKCS1KeyExchangeFormatter.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSAPKCS1KeyExchangeFormatter.xml
index b485d0d8346..2e1b0fa36f3 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSAPKCS1KeyExchangeFormatter.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSAPKCS1KeyExchangeFormatter.xml
@@ -95,7 +95,6 @@
         <Parameter Name="rgbData" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This data can be interpreted only by the holder of the private key corresponding to the public key used to encrypt the data. This helps to ensure that only the intended recipient can access the secret information.</para>
@@ -104,6 +103,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the encrypted key exchange data from the specified input data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The encrypted key exchange data to be sent to the intended recipient.</para>
+        </returns>
         <param name="rgbData">
           <attribution license="cc4" from="Microsoft" modified="false" />The secret information to be passed in the key exchange. </param>
       </Docs>
@@ -125,7 +128,6 @@
         <Parameter Name="symAlgType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This data can be interpreted only by the holder of the private key corresponding to the public key used to encrypt the data. This helps to ensure that only the intended recipient can access the secret information.</para>
@@ -134,6 +136,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the encrypted key exchange data from the specified input data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The encrypted key exchange data to be sent to the intended recipient.</para>
+        </returns>
         <param name="rgbData">
           <attribution license="cc4" from="Microsoft" modified="false" />The secret information to be passed in the key exchange. </param>
         <param name="symAlgType">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSAPKCS1SignatureDeformatter.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSAPKCS1SignatureDeformatter.xml
index 519d60c36dd..96f49db50ee 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSAPKCS1SignatureDeformatter.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSAPKCS1SignatureDeformatter.xml
@@ -152,7 +152,6 @@
         <Parameter Name="rgbSignature" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You must specify a key and a hash algorithm before calling this method.</para>
@@ -161,6 +160,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Verifies the <see cref="T:System.Security.Cryptography.RSA" /> PKCS#1 signature for the specified data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="rgbSignature" /> matches the signature computed using the specified hash algorithm and key on <paramref name="rgbHash" />; otherwise, false.</para>
+        </returns>
         <param name="rgbHash">
           <attribution license="cc4" from="Microsoft" modified="false" />The data signed with <paramref name="rgbSignature" />. </param>
         <param name="rgbSignature">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSAPKCS1SignatureFormatter.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSAPKCS1SignatureFormatter.xml
index 6fc40d37735..e52d6738b50 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSAPKCS1SignatureFormatter.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RSAPKCS1SignatureFormatter.xml
@@ -95,7 +95,6 @@
         <Parameter Name="rgbHash" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You must specify a key and a hash algorithm before calling this method.</para>
@@ -104,6 +103,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the <see cref="T:System.Security.Cryptography.RSA" /> PKCS #1 signature for the specified data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The digital signature for <paramref name="rgbHash" />.</para>
+        </returns>
         <param name="rgbHash">
           <attribution license="cc4" from="Microsoft" modified="false" />The data to be signed. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RandomNumberGenerator.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RandomNumberGenerator.xml
index b9db5366255..0205ee512e2 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RandomNumberGenerator.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RandomNumberGenerator.xml
@@ -72,12 +72,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'RandomNumberGenerator'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates an instance of the default implementation of a cryptographic random number generator that can be used to generate random data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of a cryptographic random number generator.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Create">
@@ -96,12 +99,15 @@
         <Parameter Name="rngName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'RandomNumberGenerator'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates an instance of the specified implementation of a cryptographic random number generator.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of a cryptographic random number generator.</para>
+        </returns>
         <param name="rngName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the random number generator implementation to use. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/Rfc2898DeriveBytes.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/Rfc2898DeriveBytes.xml
index 7436c320dc1..5b96ad316fd 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/Rfc2898DeriveBytes.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/Rfc2898DeriveBytes.xml
@@ -250,7 +250,6 @@
         <Parameter Name="cb" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -260,6 +259,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the pseudo-random key for this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array filled with pseudo-random key bytes.</para>
+        </returns>
         <param name="cb">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of pseudo-random key bytes to generate. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/Rijndael.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/Rijndael.xml
index f43b91ba6a2..6c15c8fcc2c 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/Rijndael.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/Rijndael.xml
@@ -108,7 +108,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Rijndael'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default implementation of <see cref="T:System.Security.Cryptography.Rijndael" /> is <see cref="T:System.Security.Cryptography.RijndaelManaged" />.</para>
@@ -117,6 +116,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a cryptographic object to perform the <see cref="T:System.Security.Cryptography.Rijndael" /> algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A cryptographic object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Create">
@@ -135,7 +138,6 @@
         <Parameter Name="algName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Rijndael'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Acceptable values for the <paramref name="algName" /> parameter are Rijndael and System.Security.Cryptography.RijndaelManaged.</para>
@@ -144,6 +146,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a cryptographic object to perform the specified implementation of the <see cref="T:System.Security.Cryptography.Rijndael" /> algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A cryptographic object.</para>
+        </returns>
         <param name="algName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the specific implementation of <see cref="T:System.Security.Cryptography.Rijndael" /> to create. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RijndaelManaged.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RijndaelManaged.xml
index 0df9e1d489d..b8e78945275 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RijndaelManaged.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RijndaelManaged.xml
@@ -67,7 +67,6 @@
         <Parameter Name="rgbIV" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Security.Cryptography.ICryptoTransform" /> that is ready to be used to decrypt data.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method decrypts an encrypted message created using the <see cref="M:System.Security.Cryptography.RijndaelManaged.CreateEncryptor(System.Byte[],System.Byte[])" /> overload with the same signature.</para>
@@ -77,6 +76,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric <see cref="T:System.Security.Cryptography.Rijndael" /> decryptor object with the specified <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.Key" /> and initialization vector (<see cref="P:System.Security.Cryptography.SymmetricAlgorithm.IV" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A symmetric <see cref="T:System.Security.Cryptography.Rijndael" /> decryptor object.</para>
+        </returns>
         <param name="rgbKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The secret key to be used for the symmetric algorithm. The key size must be 128, 192, or 256 bits.</param>
         <param name="rgbIV">
@@ -100,7 +103,6 @@
         <Parameter Name="rgbIV" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Security.Cryptography.ICryptoTransform" /> that is ready to be used to encrypt data.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Security.Cryptography.RijndaelManaged.CreateDecryptor(System.Byte[],System.Byte[])" /> overload with the same signature to decrypt the result of this method.</para>
@@ -110,6 +112,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric <see cref="T:System.Security.Cryptography.Rijndael" /> encryptor object with the specified <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.Key" /> and initialization vector (<see cref="P:System.Security.Cryptography.SymmetricAlgorithm.IV" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A symmetric <see cref="T:System.Security.Cryptography.Rijndael" /> encryptor object.</para>
+        </returns>
         <param name="rgbKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The secret key to be used for the symmetric algorithm. The key size must be 128, 192, or 256 bits.</param>
         <param name="rgbIV">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RijndaelManagedTransform.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RijndaelManagedTransform.xml
index d9011dab08c..5f969251a46 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RijndaelManagedTransform.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/RijndaelManagedTransform.xml
@@ -253,13 +253,16 @@
         <Parameter Name="outputOffset" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the transformation for the specified region of the input byte array and copies the resulting transformation to the specified region of the output byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes written.</para>
+        </returns>
         <param name="inputBuffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The input to perform the operation on. </param>
         <param name="inputOffset">
@@ -289,13 +292,16 @@
         <Parameter Name="inputCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the transformation for the specified region of the specified byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The computed transformation.</para>
+        </returns>
         <param name="inputBuffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The input to perform the operation on.</param>
         <param name="inputOffset">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA1.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA1.xml
index 31cf0ecc193..0e37a1c9dc7 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA1.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA1.xml
@@ -68,7 +68,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SHA1'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default implementation of <see cref="T:System.Security.Cryptography.SHA1" /> is <see cref="T:System.Security.Cryptography.SHA1CryptoServiceProvider" />.</para>
@@ -77,6 +76,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the default implementation of <see cref="T:System.Security.Cryptography.SHA1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.Security.Cryptography.SHA1" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Create">
@@ -95,12 +98,15 @@
         <Parameter Name="hashName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SHA1'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the specified implementation of <see cref="T:System.Security.Cryptography.SHA1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.Security.Cryptography.SHA1" /> using the specified implementation.</para>
+        </returns>
         <param name="hashName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the specific implementation of <see cref="T:System.Security.Cryptography.SHA1" /> to be used. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA1CryptoServiceProvider.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA1CryptoServiceProvider.xml
index 5c2a6dbf583..bf678dedade 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA1CryptoServiceProvider.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA1CryptoServiceProvider.xml
@@ -145,12 +145,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the computed <see cref="T:System.Security.Cryptography.SHA1" /> hash value after all data has been written to the object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The computed hash value.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Initialize">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA1Managed.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA1Managed.xml
index 319ce37fdf3..96edec8b75f 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA1Managed.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA1Managed.xml
@@ -97,12 +97,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the computed <see cref="T:System.Security.Cryptography.SHA1" /> hash value after all data has been written to the object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The computed hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Initialize">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA256.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA256.xml
index 2cf40fa81a4..2b293c2ba04 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA256.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA256.xml
@@ -69,12 +69,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SHA256'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the default implementation of <see cref="T:System.Security.Cryptography.SHA256" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.Security.Cryptography.SHA256" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Create">
@@ -93,12 +96,15 @@
         <Parameter Name="hashName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SHA256'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of a specified implementation of <see cref="T:System.Security.Cryptography.SHA256" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.Security.Cryptography.SHA256" /> using the specified implementation.</para>
+        </returns>
         <param name="hashName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the specific implementation of <see cref="T:System.Security.Cryptography.SHA256" /> to be used. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA256Managed.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA256Managed.xml
index e88d09a1b59..08916338b99 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA256Managed.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA256Managed.xml
@@ -108,7 +108,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is not called by application code. This method finalizes any partial computation and returns the correct hash value of the data stream.</para>
@@ -117,6 +116,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, finalizes the hash computation after the last data is processed by the cryptographic stream object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The computed hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Initialize">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA384.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA384.xml
index 4bf8fd66b9e..6352d47ac66 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA384.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA384.xml
@@ -68,12 +68,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SHA384'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the default implementation of <see cref="T:System.Security.Cryptography.SHA384" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.Security.Cryptography.SHA384" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Create">
@@ -92,12 +95,15 @@
         <Parameter Name="hashName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SHA384'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of a specified implementation of <see cref="T:System.Security.Cryptography.SHA384" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.Security.Cryptography.SHA384" /> using the specified implementation.</para>
+        </returns>
         <param name="hashName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the specific implementation of <see cref="T:System.Security.Cryptography.SHA384" /> to be used. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA384Managed.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA384Managed.xml
index a80eaa83344..f4b2e8cbd48 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA384Managed.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA384Managed.xml
@@ -108,7 +108,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is not called by application code. This method finalizes any partial computation and returns the correct hash value of the data stream.</para>
@@ -117,6 +116,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, finalizes the hash computation after the last data is processed by the cryptographic stream object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The computed hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Initialize">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA512.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA512.xml
index 9850cb3543b..20648e676ce 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA512.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA512.xml
@@ -69,12 +69,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SHA512'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the default implementation of <see cref="T:System.Security.Cryptography.SHA512" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.Security.Cryptography.SHA512" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Create">
@@ -93,7 +96,6 @@
         <Parameter Name="hashName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SHA512'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Possible values for <paramref name="hashName" /> are SHA512, System.Security.Cryptography.SHA51, System.Security.Cryptography.SHA512Managed, and System.Security.Cryptography.SHA512CryptoServiceProvider.</para>
@@ -102,6 +104,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of a specified implementation of <see cref="T:System.Security.Cryptography.SHA512" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new instance of <see cref="T:System.Security.Cryptography.SHA512" /> using the specified implementation.</para>
+        </returns>
         <param name="hashName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the specific implementation of <see cref="T:System.Security.Cryptography.SHA512" /> to be used. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA512Managed.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA512Managed.xml
index 8e88d8076e4..102f8262484 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA512Managed.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SHA512Managed.xml
@@ -105,7 +105,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is not called by application code. This method finalizes any partial computation and returns the correct hash value of the data stream.</para>
@@ -114,6 +113,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, finalizes the hash computation after the last data is processed by the cryptographic stream object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The computed hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Initialize">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SignatureDescription.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SignatureDescription.xml
index 0c625466af1..0d4cf3ac46c 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SignatureDescription.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SignatureDescription.xml
@@ -85,12 +85,15 @@
         <Parameter Name="key" Type="System.Security.Cryptography.AsymmetricAlgorithm" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'AsymmetricSignatureDeformatter'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Security.Cryptography.AsymmetricSignatureDeformatter" /> instance with the specified key using the <see cref="P:System.Security.Cryptography.SignatureDescription.DeformatterAlgorithm" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created <see cref="T:System.Security.Cryptography.AsymmetricSignatureDeformatter" /> instance.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key to use in the <see cref="T:System.Security.Cryptography.AsymmetricSignatureDeformatter" />. </param>
       </Docs>
@@ -109,12 +112,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'HashAlgorithm'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Security.Cryptography.HashAlgorithm" /> instance using the <see cref="P:System.Security.Cryptography.SignatureDescription.DigestAlgorithm" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created <see cref="T:System.Security.Cryptography.HashAlgorithm" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateFormatter">
@@ -133,12 +139,15 @@
         <Parameter Name="key" Type="System.Security.Cryptography.AsymmetricAlgorithm" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'AsymmetricSignatureFormatter'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.Security.Cryptography.AsymmetricSignatureFormatter" /> instance with the specified key using the <see cref="P:System.Security.Cryptography.SignatureDescription.FormatterAlgorithm" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created <see cref="T:System.Security.Cryptography.AsymmetricSignatureFormatter" /> instance.</para>
+        </returns>
         <param name="key">
           <attribution license="cc4" from="Microsoft" modified="false" />The key to use in the <see cref="T:System.Security.Cryptography.AsymmetricSignatureFormatter" />. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SymmetricAlgorithm.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SymmetricAlgorithm.xml
index 5f6329f4a0d..d303ad7bbae 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SymmetricAlgorithm.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/SymmetricAlgorithm.xml
@@ -148,12 +148,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SymmetricAlgorithm'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a default cryptographic object used to perform the symmetric algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A default cryptographic object used to perform the symmetric algorithm.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Create">
@@ -172,12 +175,15 @@
         <Parameter Name="algName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SymmetricAlgorithm'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the specified cryptographic object used to perform the symmetric algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A cryptographic object used to perform the symmetric algorithm.</para>
+        </returns>
         <param name="algName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the specific implementation of the <see cref="T:System.Security.Cryptography.SymmetricAlgorithm" /> class to use. </param>
       </Docs>
@@ -196,7 +202,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ICryptoTransform'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method decrypts an encrypted message created using the <see cref="M:System.Security.Cryptography.SymmetricAlgorithm.CreateEncryptor" /> overload with the same signature.</para>
@@ -205,6 +210,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric decryptor object with the current <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.Key" /> property and initialization vector (<see cref="P:System.Security.Cryptography.SymmetricAlgorithm.IV" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A symmetric decryptor object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateDecryptor">
@@ -224,7 +233,6 @@
         <Parameter Name="rgbIV" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ICryptoTransform'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method decrypts an encrypted message created using the <see cref="M:System.Security.Cryptography.SymmetricAlgorithm.CreateEncryptor" /> overload with the same parameters.</para>
@@ -233,6 +241,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates a symmetric decryptor object with the specified <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.Key" /> property and initialization vector (<see cref="P:System.Security.Cryptography.SymmetricAlgorithm.IV" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A symmetric decryptor object.</para>
+        </returns>
         <param name="rgbKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The secret key to use for the symmetric algorithm. </param>
         <param name="rgbIV">
@@ -253,7 +265,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'ICryptoTransform'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the current <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.Key" /> property is null, the <see cref="M:System.Security.Cryptography.SymmetricAlgorithm.GenerateKey" /> method is called to create a new random <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.Key" />. If the current <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.IV" /> property is null, the <see cref="M:System.Security.Cryptography.SymmetricAlgorithm.GenerateIV" /> method is called to create a new random <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.IV" />.</para>
@@ -263,6 +274,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric encryptor object with the current <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.Key" /> property and initialization vector (<see cref="P:System.Security.Cryptography.SymmetricAlgorithm.IV" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A symmetric encryptor object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateEncryptor">
@@ -282,7 +297,6 @@
         <Parameter Name="rgbIV" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ICryptoTransform'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Security.Cryptography.SymmetricAlgorithm.CreateDecryptor" /> overload with the same parameters to decrypt the result of this method.</para>
@@ -291,6 +305,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates a symmetric encryptor object with the specified <see cref="P:System.Security.Cryptography.SymmetricAlgorithm.Key" /> property and initialization vector (<see cref="P:System.Security.Cryptography.SymmetricAlgorithm.IV" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A symmetric encryptor object.</para>
+        </returns>
         <param name="rgbKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The secret key to use for the symmetric algorithm. </param>
         <param name="rgbIV">
@@ -845,12 +863,15 @@
         <Parameter Name="bitLength" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>True if the key length is valid for the algorithm, false otherwise.</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified key size is valid for the current algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified key size is valid for the current algorithm; otherwise, false.</para>
+        </returns>
         <param name="bitLength">
           <attribution license="cc4" from="Microsoft" modified="false" />The length, in bits, to check for a valid key size. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/ToBase64Transform.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/ToBase64Transform.xml
index 6ff0e5b4448..eae05cdd4e4 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/ToBase64Transform.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/ToBase64Transform.xml
@@ -289,7 +289,6 @@
         <Parameter Name="outputOffset" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Security.Cryptography.ToBase64Transform" /> class is a block algorithm that processes input blocks of 3 bytes and creates output blocks of 4 bytes.  The <see cref="M:System.Security.Cryptography.ToBase64Transform.TransformBlock(System.Byte[],System.Int32,System.Int32,System.Byte[],System.Int32)" /> method transforms an input block of 24 bits into 32 bits of character data.  You must maintain 3 byte input boundaries to 4 byte output boundaries in order to match the block transform.</para>
@@ -298,6 +297,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified region of the input byte array to base 64 and copies the result to the specified region of the output byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes written.</para>
+        </returns>
         <param name="inputBuffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The input to compute to base 64. </param>
         <param name="inputOffset">
@@ -328,12 +331,15 @@
         <Parameter Name="inputCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified region of the specified byte array to base 64.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The computed base 64 conversion.</para>
+        </returns>
         <param name="inputBuffer">
           <attribution license="cc4" from="Microsoft" modified="false" />The input to convert to base 64. </param>
         <param name="inputOffset">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/TripleDES.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/TripleDES.xml
index 03d8a874c67..4eb67aca714 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/TripleDES.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/TripleDES.xml
@@ -112,7 +112,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'TripleDES'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the <see cref="T:System.Security.Cryptography.TripleDES" /> class.</para>
@@ -121,6 +120,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of a cryptographic object to perform the <see cref="T:System.Security.Cryptography.TripleDES" /> algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of a cryptographic object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Create">
@@ -139,12 +142,15 @@
         <Parameter Name="str" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TripleDES'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of a cryptographic object to perform the specified implementation of the <see cref="T:System.Security.Cryptography.TripleDES" /> algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of a cryptographic object.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the specific implementation of <see cref="T:System.Security.Cryptography.TripleDES" /> to use. </param>
       </Docs>
@@ -165,7 +171,6 @@
         <Parameter Name="rgbKey" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Weak keys are keys that result in ciphers that are easy to break. If text is encrypted with a weak key, encrypting the resulting cipher again with the same weak key returns the original text. In 128-bit mode, if the first 64 bits are the same as the last 64 bits, the key is weak. In 192-bit mode, if the first 64 bits are the same as the second 64 bits or if the second 64 bits are the same as the last 64 bits, the key is weak.</para>
@@ -175,6 +180,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified key is weak.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the key is weak; otherwise, false.</para>
+        </returns>
         <param name="rgbKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The secret key to test for weakness. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/TripleDESCryptoServiceProvider.xml b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/TripleDESCryptoServiceProvider.xml
index 37c98ef1e5c..a009820d6ab 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Cryptography/TripleDESCryptoServiceProvider.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Cryptography/TripleDESCryptoServiceProvider.xml
@@ -70,7 +70,6 @@
         <Parameter Name="rgbIV" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Security.Cryptography.ICryptoTransform" /> that is ready to be used to decrypt data.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method decrypts an encrypted message created using the <see cref="M:System.Security.Cryptography.TripleDESCryptoServiceProvider.CreateEncryptor(System.Byte[],System.Byte[])" /> overload with the same parameters.</para>
@@ -79,6 +78,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric <see cref="T:System.Security.Cryptography.TripleDES" /> decryptor object with the specified key (<see cref="P:System.Security.Cryptography.SymmetricAlgorithm.Key" />) and initialization vector (<see cref="P:System.Security.Cryptography.SymmetricAlgorithm.IV" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A symmetric <see cref="T:System.Security.Cryptography.TripleDES" /> decryptor object.</para>
+        </returns>
         <param name="rgbKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The secret key to use for the symmetric algorithm. </param>
         <param name="rgbIV">
@@ -102,7 +105,6 @@
         <Parameter Name="rgbIV" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>a <see cref="T:System.Security.Cryptography.ICryptoTransform" /> that is ready to be used to encrypt data.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Security.Cryptography.TripleDESCryptoServiceProvider.CreateDecryptor(System.Byte[],System.Byte[])" /> overload with the same parameters to decrypt the result of this method.</para>
@@ -111,6 +113,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a symmetric <see cref="T:System.Security.Cryptography.TripleDES" /> encryptor object with the specified key (<see cref="P:System.Security.Cryptography.SymmetricAlgorithm.Key" />) and initialization vector (<see cref="P:System.Security.Cryptography.SymmetricAlgorithm.IV" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A symmetric <see cref="T:System.Security.Cryptography.TripleDES" /> encryptor object.</para>
+        </returns>
         <param name="rgbKey">
           <attribution license="cc4" from="Microsoft" modified="false" />The secret key to use for the symmetric algorithm. </param>
         <param name="rgbIV">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/EnvironmentPermission.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/EnvironmentPermission.xml
index 5ff660df8fe..ea94b7c93b5 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/EnvironmentPermission.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/EnvironmentPermission.xml
@@ -158,11 +158,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Security.Permissions.EnvironmentPermission" />
-containing the
-same values as the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A copy of a permission represents the same access to resources as the original permission.</para>
@@ -171,6 +166,10 @@ same values as the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an identical copy of the current permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current permission.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -232,7 +231,6 @@ same values as the current instance.</para>
         <Parameter Name="flag" Type="System.Security.Permissions.EnvironmentPermissionAccess" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to get the state of the current permission. To get both Read and Write access states requires two calls to this method.</para>
@@ -244,6 +242,10 @@ same values as the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all environment variables with the specified <see cref="T:System.Security.Permissions.EnvironmentPermissionAccess" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A list of environment variables (semicolon-separated) for the selected flag.</para>
+        </returns>
         <param name="flag">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Security.Permissions.EnvironmentPermissionAccess" /> values that represents a single type of environment variable access. </param>
       </Docs>
@@ -265,12 +267,6 @@ same values as the current instance.</para>
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Security.Permissions.EnvironmentPermission" /> instance that
- represents the intersection of the current instance and <paramref name="target" />. If the intersection is empty or <paramref name="target" />
- is <see langword="null" />, returns <see langword="null" />. If the current instance is unrestricted, returns a copy of <paramref name="target" />. If
-<paramref name="target" /> is unrestricted, returns a copy of the current instance.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="target" /> is not <see langword="null" /> and is not of type <see cref="T:System.Security.Permissions.EnvironmentPermission" />. </exception>
         <remarks>
@@ -281,6 +277,10 @@ same values as the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a permission that is the intersection of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the intersection of the current permission and the specified permission. This new permission is null if the intersection is empty.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to intersect with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
@@ -303,18 +303,6 @@ same values as the current instance.</para>
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the
-   current instance is a subset of <paramref name="target" />
-   ; otherwise,<see langword=" false" />. If the current instance is unrestricted, and <paramref name="target" /> is
-   not, returns <see langword="false" />. If <paramref name="target" /> is
-   unrestricted, returns <see langword="true" />. If
-<paramref name="target" /> is <see langword="null" /> and no environment variables are 
-   secured by the current instance, returns <see langword="true" />. If target is
-<see langword="null" />, and the current instance secures one or more environment 
-   variables, returns <see langword="false" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="target" /> is not <see langword="null" /> and is not of type <see cref="T:System.Security.Permissions.EnvironmentPermission" /> .</exception>
         <remarks>
@@ -325,6 +313,10 @@ same values as the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current permission is a subset of the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is a subset of the specified permission; otherwise, false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission that is to be tested for the subset relationship. This permission must be of the same type as the current permission. </param>
       </Docs>
@@ -344,7 +336,6 @@ same values as the current instance.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An unrestricted permission represents the union of all possible states of the permission.</para>
@@ -353,6 +344,10 @@ same values as the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the current permission is unrestricted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is unrestricted; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SetPathList">
@@ -420,9 +415,6 @@ same values as the current instance.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Security.SecurityElement" /> containing the XML encoding of the state of the current instance.</para>
-        </returns>
         <remarks>
           <block subset="none" type="note">
             <para>For the XML encoding for this class, see the <see cref="T:System.Security.Permissions.EnvironmentPermission" /> class
@@ -434,6 +426,10 @@ same values as the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the permission and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the permission, including any state information.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -454,17 +450,6 @@ same values as the current instance.</para>
         <Parameter Name="other" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Security.Permissions.EnvironmentPermission" /> instance that represents the union
- of the current instance and <paramref name="other" /> . If the current
- instance or <paramref name="other " /> is unrestricted, returns a
-<see cref="T:System.Security.Permissions.EnvironmentPermission" /> 
-instance that is unrestricted. If <paramref name="other" /> is <see langword="null" />,
-returns a copy of the current instance via the <see cref="M:System.Security.IPermission.Copy" /> method.
-If the current instance and <paramref name="other" /> do not specify any environment
-variables, returns <see langword="null" />
-.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="other " /> is not <see langword="null" /> and is not of type <see cref="T:System.Security.Permissions.EnvironmentPermission" /> .</exception>
         <remarks>
@@ -475,6 +460,10 @@ variables, returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a permission that is the union of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the union of the current permission and the specified permission.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to combine with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/EnvironmentPermissionAttribute.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/EnvironmentPermissionAttribute.xml
index b3df41bb008..23fd59d9321 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/EnvironmentPermissionAttribute.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/EnvironmentPermissionAttribute.xml
@@ -122,11 +122,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Security.Permissions.EnvironmentPermission" />
-object with the security information of the current
-instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method should only be called by the security system, never by application code.</para>
@@ -136,6 +131,10 @@ instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new <see cref="T:System.Security.Permissions.EnvironmentPermission" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.Permissions.EnvironmentPermission" /> that corresponds to this attribute.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/FileDialogPermission.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/FileDialogPermission.xml
index 1e1bab19157..b4d67ede6af 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/FileDialogPermission.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/FileDialogPermission.xml
@@ -121,7 +121,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A copy of the permission represents the same access to resources as the original permission.</para>
@@ -130,6 +129,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an identical copy of the current permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current permission.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="FromXml">
@@ -173,7 +176,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The intersection of two permissions is a permission that describes the set of operations they both describe in common. Only a demand that passes both original permissions will pass the intersection.</para>
@@ -182,6 +184,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a permission that is the intersection of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the intersection of the current permission and the specified permission. This new permission is null if the intersection is empty.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to intersect with the current permission. It must be the same type as the current permission. </param>
       </Docs>
@@ -202,7 +208,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current permission is a subset of the specified permission if the current permission specifies a set of operations that is wholly contained by the specified permission. For example, a permission for <see cref="F:System.Security.Permissions.FileDialogPermissionAccess.Open" /> access is a subset of a permission for <see cref="F:System.Security.Permissions.FileDialogPermissionAccess.OpenSave" /> access.</para>
@@ -211,6 +216,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current permission is a subset of the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is a subset of the specified permission; otherwise, false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission that is to be tested for the subset relationship. This permission must be the same type as the current permission. </param>
       </Docs>
@@ -229,7 +238,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An unrestricted permission represents access to all resources protected by the permission.</para>
@@ -238,6 +246,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the current permission is unrestricted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is unrestricted; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Security.Permissions.IBuiltInPermission.GetTokenIndex">
@@ -267,7 +279,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -278,6 +289,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a string representation of the current permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the current permission.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -297,13 +312,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the permission and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the permission, including state information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Union">
@@ -322,7 +340,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -332,6 +349,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a permission that is the union of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the union of the current permission and the specified permission.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to combine with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/FileDialogPermissionAttribute.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/FileDialogPermissionAttribute.xml
index d45019cbf2e..fa4a7c2240c 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/FileDialogPermissionAttribute.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/FileDialogPermissionAttribute.xml
@@ -71,7 +71,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method should only be called by the security system, never by application code.</para>
@@ -81,6 +80,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new <see cref="T:System.Security.Permissions.FileDialogPermission" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Permissions.FileDialogPermission" /> that corresponds to this attribute.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Open">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/FileIOPermission.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/FileIOPermission.xml
index 3c2be1c8100..106e2436607 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/FileIOPermission.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/FileIOPermission.xml
@@ -359,10 +359,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Security.Permissions.FileIOPermission" /> containing the
-   same values as the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A copy of the permission represents the same access to resources as the original permission.</para>
@@ -371,6 +367,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an identical copy of the current permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current permission.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -394,7 +394,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -404,6 +403,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Security.Permissions.FileIOPermission" /> object is equal to the current <see cref="T:System.Security.Permissions.FileIOPermission" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Security.Permissions.FileIOPermission" /> is equal to the current <see cref="T:System.Security.Permissions.FileIOPermission" /> object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Permissions.FileIOPermission" /> object to compare with the current <see cref="T:System.Security.Permissions.FileIOPermission" />. </param>
       </Docs>
@@ -468,7 +471,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -478,6 +480,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a hash code for the <see cref="T:System.Security.Permissions.FileIOPermission" /> object that is suitable for use in hashing algorithms and data structures such as a hash table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.Security.Permissions.FileIOPermission" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetPathList">
@@ -496,7 +502,6 @@
         <Parameter Name="access" Type="System.Security.Permissions.FileIOPermissionAccess" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to get the state of the current permission. To get the state of both Read and Write access, two calls to this method are required.</para>
@@ -508,6 +513,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets all files and directories with the specified <see cref="T:System.Security.Permissions.FileIOPermissionAccess" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array containing the paths of the files and directories to which access specified by the <paramref name="access" /> parameter is granted.</para>
+        </returns>
         <param name="access">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Security.Permissions.FileIOPermissionAccess" /> values that represents a single type of file access. </param>
       </Docs>
@@ -529,12 +538,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Security.Permissions.FileIOPermission" /> instance that
- represents the intersection of the current instance and <paramref name="target" />. If the intersection is empty or <paramref name="target" />
- is <see langword="null" />, returns <see langword="null" />. If the current instance is unrestricted, returns a copy of <paramref name="target" />. If
-<paramref name="target" /> is unrestricted, returns a copy of the current instance.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="target" /> is not <see langword="null" /> and is not of type <see cref="T:System.Security.Permissions.FileIOPermission" /> .</exception>
         <remarks>
@@ -545,6 +548,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a permission that is the intersection of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the intersection of the current permission and the specified permission. This new permission is null if the intersection is empty.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to intersect with the current permission. It must be the same type as the current permission. </param>
       </Docs>
@@ -567,18 +574,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the
- current instance is a subset of <paramref name="target" />
- ; otherwise,<see langword=" false" />. If the current instance is unrestricted, and <paramref name="target" /> is
- not, returns <see langword="false" />. If <paramref name="target" /> is
- unrestricted, returns <see langword="true" />. If
-<paramref name="target" /> is <see langword="null" /> and no files or directories are secured 
- by the current instance, returns <see langword="true" />. If target is
-<see langword="null" />, and the current instance secures one or more files or 
- directories, returns <see langword="false" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="target" /> is not <see langword="null" /> and is not of type <see cref="T:System.Security.Permissions.FileIOPermission" /> .</exception>
         <remarks>
@@ -589,6 +584,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current permission is a subset of the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is a subset of the specified permission; otherwise, false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission that is to be tested for the subset relationship. This permission must be the same type as the current permission. </param>
       </Docs>
@@ -608,7 +607,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An unrestricted permission represents access to all resources protected by the permission.</para>
@@ -617,6 +615,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the current permission is unrestricted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is unrestricted; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SetPathList">
@@ -720,9 +722,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Security.SecurityElement" /> containing the XML encoding of the state of the current instance.</para>
-        </returns>
         <remarks>
           <block subset="none" type="note">
             <para>For the XML encoding for this class, see the <see cref="T:System.Security.Permissions.FileIOPermission" /> class
@@ -734,6 +733,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the permission and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the permission, including any state information.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -754,17 +757,6 @@
         <Parameter Name="other" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Security.Permissions.FileIOPermission" /> instance that represents the union
- of the current instance and <paramref name="other" /> . If the current
- instance or <paramref name="other " /> is unrestricted, returns a
-<see cref="T:System.Security.Permissions.FileIOPermission" /> 
-instance that is unrestricted. If <paramref name="other" /> is <see langword="null" />,
-returns a copy of the current instance via the <see cref="M:System.Security.IPermission.Copy" /> method.
-If the current instance and <paramref name="other" /> do not specify any file or
-directory names, returns <see langword="null" />
-.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="other " /> is not <see langword="null" /> and is not of type <see cref="T:System.Security.Permissions.FileIOPermission" /> .</exception>
         <remarks>
@@ -775,6 +767,10 @@ directory names, returns <see langword="null" />
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a permission that is the union of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the union of the current permission and the specified permission.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to combine with the current permission. It must be the same type as the current permission. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/FileIOPermissionAttribute.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/FileIOPermissionAttribute.xml
index bd29ce1519b..fbeb785044d 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/FileIOPermissionAttribute.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/FileIOPermissionAttribute.xml
@@ -235,10 +235,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Security.Permissions.FileIOPermission" /> object with the security
-   information of the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method should be called only by the security system, never by application code.</para>
@@ -248,6 +244,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new <see cref="T:System.Security.Permissions.FileIOPermission" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Permissions.FileIOPermission" /> that corresponds to this attribute.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/GacIdentityPermission.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/GacIdentityPermission.xml
index df3bc68e3f9..2a6e0f6a75b 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/GacIdentityPermission.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/GacIdentityPermission.xml
@@ -97,7 +97,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -107,6 +106,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an identical copy of the current permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current permission.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="FromXml">
@@ -152,7 +155,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -163,6 +165,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a permission that is the intersection of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the intersection of the current permission and the specified permission. The new permission is null if the intersection is empty.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to intersect with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
@@ -182,7 +188,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -193,6 +198,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the current permission is a subset of the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is a subset of the specified permission; otherwise, false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission object to test for the subset relationship. The permission must be of the same type as the current permission. </param>
       </Docs>
@@ -229,7 +238,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -239,6 +247,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the permission and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.SecurityElement" /> that represents the XML encoding of the permission, including any state information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Union">
@@ -256,7 +268,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -267,6 +278,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a permission that is the union of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the union of the current permission and the specified permission.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to combine with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/GacIdentityPermissionAttribute.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/GacIdentityPermissionAttribute.xml
index bd3f167004d..5442398f151 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/GacIdentityPermissionAttribute.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/GacIdentityPermissionAttribute.xml
@@ -78,7 +78,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -89,6 +88,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Security.Permissions.GacIdentityPermission" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Permissions.GacIdentityPermission" /> that corresponds to this attribute.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/HostProtectionAttribute.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/HostProtectionAttribute.xml
index ef0f9517b25..2c38db1bed9 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/HostProtectionAttribute.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/HostProtectionAttribute.xml
@@ -113,7 +113,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -124,6 +123,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new host protection permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.IPermission" /> that corresponds to the current attribute.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ExternalProcessMgmt">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/IUnrestrictedPermission.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/IUnrestrictedPermission.xml
index 42310135380..ba29621502c 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/IUnrestrictedPermission.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/IUnrestrictedPermission.xml
@@ -41,12 +41,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether unrestricted access to the resource protected by the permission is allowed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if unrestricted use of the resource protected by the permission is allowed; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/IsolatedStorageFilePermission.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/IsolatedStorageFilePermission.xml
index 025a0334649..e37757f01d3 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/IsolatedStorageFilePermission.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/IsolatedStorageFilePermission.xml
@@ -78,7 +78,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A copy of a permission represents the same access to resources as the original permission.</para>
@@ -87,6 +86,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an identical copy of the current permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current permission.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Intersect">
@@ -105,7 +108,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The intersection of two permissions is a permission that describes the set of operations they both describe in common. Only a demand that passes both original permissions will pass the intersection.</para>
@@ -114,6 +116,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a permission that is the intersection of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the intersection of the current permission and the specified permission. This new permission is null if the intersection is empty.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to intersect with the current permission object. It must be of the same type as the current permission. </param>
       </Docs>
@@ -134,7 +140,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current permission is a subset of the specified permission if the current permission specifies a set of operations that is wholly contained by the specified permission. For example, a permission that represents access to C:\example.txt is a subset of a permission that represents access to C:\. If this method returns true, the current permission represents no more access to the protected resource than does the specified permission.</para>
@@ -143,6 +148,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current permission is a subset of the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is a subset of the specified permission; otherwise, false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission that is to be tested for the subset relationship. This permission must be of the same type as the current permission. </param>
       </Docs>
@@ -184,7 +193,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -194,6 +202,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the permission and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the permission, including any state information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Union">
@@ -212,7 +224,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The result of a call to <see cref="M:System.Security.Permissions.IsolatedStorageFilePermission.Union(System.Security.IPermission)" /> is a permission that represents all the operations represented by both the current permission and the specified permission. Any demand that passes either permission passes their union. </para>
@@ -221,6 +232,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a permission that is the union of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the union of the current permission and the specified permission.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to combine with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/IsolatedStorageFilePermissionAttribute.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/IsolatedStorageFilePermissionAttribute.xml
index b3044a0d555..5ddca036764 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/IsolatedStorageFilePermissionAttribute.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/IsolatedStorageFilePermissionAttribute.xml
@@ -71,7 +71,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method should only be called by the security system, never by application code.</para>
@@ -81,6 +80,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new <see cref="T:System.Security.Permissions.IsolatedStorageFilePermission" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.Permissions.IsolatedStorageFilePermission" /> that corresponds to this attribute.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/IsolatedStoragePermission.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/IsolatedStoragePermission.xml
index b8959301b8d..f44e867cc5c 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/IsolatedStoragePermission.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/IsolatedStoragePermission.xml
@@ -99,7 +99,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An unrestricted permission represents access to any and all resources protected by the permission.</para>
@@ -108,6 +107,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the current permission is unrestricted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is unrestricted; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToXml">
@@ -124,12 +127,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the permission and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the permission, including any state information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="UsageAllowed">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/KeyContainerPermission.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/KeyContainerPermission.xml
index ba5fa142cf1..b71fa6390f0 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/KeyContainerPermission.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/KeyContainerPermission.xml
@@ -144,7 +144,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -154,6 +153,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an identical copy of the current permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current permission.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Flags">
@@ -223,7 +226,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -233,6 +235,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a permission that is the intersection of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the intersection of the current permission and the specified permission. This new permission is null if the intersection is empty.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to intersect with the current permission. It must be the same type as the current permission. </param>
       </Docs>
@@ -252,7 +258,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -262,6 +267,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current permission is a subset of the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is a subset of the specified permission; otherwise, false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to test for the subset relationship. This permission must be the same type as the current permission. </param>
       </Docs>
@@ -279,7 +288,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -289,6 +297,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current permission is unrestricted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is unrestricted; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Security.Permissions.IBuiltInPermission.GetTokenIndex">
@@ -323,7 +335,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -333,6 +344,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the permission and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.SecurityElement" /> that contains an XML encoding of the permission, including state information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Union">
@@ -350,7 +365,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -360,6 +374,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a permission that is the union of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the union of the current permission and the specified permission.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to combine with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/KeyContainerPermissionAccessEntry.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/KeyContainerPermissionAccessEntry.xml
index 48084bec50c..285faaea0f4 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/KeyContainerPermissionAccessEntry.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/KeyContainerPermissionAccessEntry.xml
@@ -139,7 +139,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -149,6 +148,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Security.Permissions.KeyContainerPermissionAccessEntry" /> object is equal to the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Security.Permissions.KeyContainerPermissionAccessEntry" /> is equal to the current <see cref="T:System.Security.Permissions.KeyContainerPermissionAccessEntry" /> object; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Permissions.KeyContainerPermissionAccessEntry" /> object to compare with the currentinstance. </param>
       </Docs>
@@ -193,7 +196,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -203,6 +205,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a hash code for the current instance that is suitable for use in hashing algorithms and data structures such as a hash table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.Security.Permissions.KeyContainerPermissionAccessEntry" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="KeyContainerName">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/KeyContainerPermissionAccessEntryCollection.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/KeyContainerPermissionAccessEntryCollection.xml
index e602faa0f80..1b2417a2700 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/KeyContainerPermissionAccessEntryCollection.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/KeyContainerPermissionAccessEntryCollection.xml
@@ -48,7 +48,6 @@
         <Parameter Name="accessEntry" Type="System.Security.Permissions.KeyContainerPermissionAccessEntry" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -58,6 +57,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a <see cref="T:System.Security.Permissions.KeyContainerPermissionAccessEntry" /> object to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the new element was inserted.</para>
+        </returns>
         <param name="accessEntry">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Permissions.KeyContainerPermissionAccessEntry" /> object to add.</param>
       </Docs>
@@ -151,7 +154,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -167,6 +169,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Security.Permissions.KeyContainerPermissionAccessEntryEnumerator" /> object that can be used to iterate through the objects in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Permissions.KeyContainerPermissionAccessEntryEnumerator" /> object that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IndexOf">
@@ -184,7 +190,6 @@
         <Parameter Name="accessEntry" Type="System.Security.Permissions.KeyContainerPermissionAccessEntry" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -194,6 +199,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index in the collection of the specified <see cref="T:System.Security.Permissions.KeyContainerPermissionAccessEntry" /> object, if it exists in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified <see cref="T:System.Security.Permissions.KeyContainerPermissionAccessEntry" /> object in the collection, or –1 if no match is found.</para>
+        </returns>
         <param name="accessEntry">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Permissions.KeyContainerPermissionAccessEntry" /> object to locate.</param>
       </Docs>
@@ -338,13 +347,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Security.Permissions.KeyContainerPermissionAccessEntryEnumerator" /> object that can be used to iterate through the objects in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Permissions.KeyContainerPermissionAccessEntryEnumerator" /> object that can be used to iterate through the collection. </para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/KeyContainerPermissionAccessEntryEnumerator.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/KeyContainerPermissionAccessEntryEnumerator.xml
index 7777dc6a45e..2edc70dfb17 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/KeyContainerPermissionAccessEntryEnumerator.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/KeyContainerPermissionAccessEntryEnumerator.xml
@@ -76,7 +76,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -89,6 +88,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves to the next element in the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Reset">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/KeyContainerPermissionAttribute.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/KeyContainerPermissionAttribute.xml
index 40d91ce4c9d..0ee6a009a87 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/KeyContainerPermissionAttribute.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/KeyContainerPermissionAttribute.xml
@@ -67,7 +67,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -78,6 +77,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new <see cref="T:System.Security.Permissions.KeyContainerPermission" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Permissions.KeyContainerPermission" /> that corresponds to the attribute.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Flags">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/PermissionSetAttribute.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/PermissionSetAttribute.xml
index be5a718e778..4403183f8c9 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/PermissionSetAttribute.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/PermissionSetAttribute.xml
@@ -72,7 +72,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is not used; it is included only to support inheritance from <see cref="T:System.Security.Permissions.SecurityAttribute" />.</para>
@@ -81,6 +80,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is not used.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A null reference (nothing in Visual Basic) in all cases.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreatePermissionSet">
@@ -97,7 +100,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Security.PermissionSet'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method should be called only by the security system, never by application code.</para>
@@ -107,6 +109,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new permission set based on this permission set attribute object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission set.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="File">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/PrincipalPermission.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/PrincipalPermission.xml
index 0cfcdd30e3a..f06d8c46a43 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/PrincipalPermission.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/PrincipalPermission.xml
@@ -150,7 +150,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Security.IPermission'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A copy of the permission represents the same principal and identity as the original permission.</para>
@@ -159,6 +158,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an identical copy of the current permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current permission.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Demand">
@@ -210,7 +213,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -220,6 +222,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Security.Permissions.PrincipalPermission" /> object is equal to the current <see cref="T:System.Security.Permissions.PrincipalPermission" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Security.Permissions.PrincipalPermission" /> is equal to the current <see cref="T:System.Security.Permissions.PrincipalPermission" /> object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Permissions.PrincipalPermission" /> object to compare with the current <see cref="T:System.Security.Permissions.PrincipalPermission" />. </param>
       </Docs>
@@ -267,7 +273,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -277,6 +282,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a hash code for the <see cref="T:System.Security.Permissions.PrincipalPermission" /> object that is suitable for use in hashing algorithms and data structures such as a hash table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.Security.Permissions.PrincipalPermission" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Intersect">
@@ -295,7 +304,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Security.IPermission'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Because two users never intersect, this method is not useful for <see cref="T:System.Security.Permissions.PrincipalPermission" />. For example,</para>
@@ -308,6 +316,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a permission that is the intersection of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the intersection of the current permission and the specified permission. This new permission will be null if the intersection is empty.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to intersect with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
@@ -328,7 +340,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current permission is a subset of the specified permission if all demands that succeed for the current permission also succeed for the specified permission.</para>
@@ -337,6 +348,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current permission is a subset of the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is a subset of the specified permission; otherwise, false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission that is to be tested for the subset relationship. This permission must be of the same type as the current permission. </param>
       </Docs>
@@ -355,7 +370,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An unrestricted <see cref="T:System.Security.Permissions.PrincipalPermission" /> matches any principal.</para>
@@ -364,6 +378,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the current permission is unrestricted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is unrestricted; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Security.Permissions.IBuiltInPermission.GetTokenIndex">
@@ -399,12 +417,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a string representing the current permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A representation of the current permission.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToXml">
@@ -421,12 +442,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Security.SecurityElement'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the permission and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the permission, including any state information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Union">
@@ -445,7 +469,6 @@
         <Parameter Name="other" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Security.IPermission'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -457,6 +480,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a permission that is the union of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the union of the current permission and the specified permission.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to combine with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/PrincipalPermissionAttribute.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/PrincipalPermissionAttribute.xml
index 7a10eb1be08..e3c78b06b8b 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/PrincipalPermissionAttribute.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/PrincipalPermissionAttribute.xml
@@ -100,7 +100,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method should only be called by the security system, never by application code.</para>
@@ -110,6 +109,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new <see cref="T:System.Security.Permissions.PrincipalPermission" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Permissions.PrincipalPermission" /> that corresponds to this attribute.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Name">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/PublisherIdentityPermission.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/PublisherIdentityPermission.xml
index e47d29037f7..2965d6611ed 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/PublisherIdentityPermission.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/PublisherIdentityPermission.xml
@@ -132,7 +132,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A copy of a permission represents the same access to resources as the original permission.</para>
@@ -142,6 +141,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an identical copy of the current permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current permission.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="FromXml">
@@ -185,7 +188,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The intersection of two permissions is a permission that describes the set of operations they both describe in common. Only a demand that passes both original permissions will pass the intersection.</para>
@@ -196,6 +198,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a permission that is the intersection of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the intersection of the current permission and the specified permission. This new permission is null if the intersection is empty.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to intersect with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
@@ -216,7 +222,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current permission is a subset of the specified permission if the two permissions are equal. If this method returns true, the current permission represents the same access to the protected resource as the specified permission.</para>
@@ -227,6 +232,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current permission is a subset of the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is a subset of the specified permission; otherwise, false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission that is to be tested for the subset relationship. This permission must be of the same type as the current permission. </param>
       </Docs>
@@ -264,12 +273,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the permission and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the permission, including any state information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Union">
@@ -288,7 +300,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The result of a call to the <see cref="M:System.Security.Permissions.PublisherIdentityPermission.Union(System.Security.IPermission)" /> method is a permission that represents all the operations represented by both the current permission and the specified permission. Any demand that passes either permission passes their union.</para>
@@ -298,6 +309,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a permission that is the union of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the union of the current permission and the specified permission.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to combine with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/PublisherIdentityPermissionAttribute.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/PublisherIdentityPermissionAttribute.xml
index f7929c21e8b..4968aa41bb0 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/PublisherIdentityPermissionAttribute.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/PublisherIdentityPermissionAttribute.xml
@@ -103,7 +103,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method should be called only by the security system, never by application code.</para>
@@ -113,6 +112,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new instance of <see cref="T:System.Security.Permissions.PublisherIdentityPermission" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Permissions.PublisherIdentityPermission" /> that corresponds to this attribute.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SignedFile">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/ReflectionPermission.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/ReflectionPermission.xml
index bee98b79aa9..9a8163b6959 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/ReflectionPermission.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/ReflectionPermission.xml
@@ -110,9 +110,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Security.Permissions.ReflectionPermission" /> instance that contains the same values as the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A copy of a permission represents the same access to resources as the original permission.</para>
@@ -121,6 +118,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an identical copy of the current permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current permission.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -204,13 +205,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Security.Permissions.ReflectionPermission" /> instance that represents the intersection of the
-   current instance and <paramref name="target" />. If the intersection is empty, returns
-<see langword="null" />. If <paramref name="target" /> is
-<see langword="null" />, returns <see langword="null" /> 
-.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">The <paramref name="target" /> parameter is not <see langword="null" /> and is not an instance of <see cref="T:System.Security.Permissions.ReflectionPermission" /> . </exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -220,6 +214,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a permission that is the intersection of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the intersection of the current permission and the specified permission. This new permission is null if the intersection is empty.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to intersect with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
@@ -242,17 +240,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the current instance is a subset of <paramref name="target" /> ;
-   otherwise,<see langword=" false" />. If the current instance is unrestricted, and
-<paramref name="target" /> is not, returns <see langword="false" />. If <paramref name="target" /> is 
-   unrestricted, returns <see langword="true" />. If target is
-<see langword="null" /> and the access level of the current instance is <see cref="F:System.Security.Permissions.ReflectionPermissionFlag.NoFlags" />, returns <see langword="true" />. If 
-   target is <see langword="null" /> and the access level of the current
-   instance is any value other than <see cref="F:System.Security.Permissions.ReflectionPermissionFlag.NoFlags" />, returns
-<see langword="false" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">The <paramref name="target" /> parameter is not <see langword="null" /> and is not an instance of <see cref="T:System.Security.Permissions.ReflectionPermission" /> . </exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -262,6 +249,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current permission is a subset of the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is a subset of the specified permission; otherwise, false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission that is to be tested for the subset relationship. This permission must be of the same type as the current permission. </param>
       </Docs>
@@ -281,7 +272,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An unrestricted permission represents access to any and all resources protected by the permission.</para>
@@ -290,6 +280,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the current permission is unrestricted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is unrestricted; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Security.Permissions.IBuiltInPermission.GetTokenIndex">
@@ -326,10 +320,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Security.SecurityElement" /> containing the XML encoding of the state of the current
-   instance.</para>
-        </returns>
         <remarks>
           <block subset="none" type="note">
             <para>For the XML encoding for this class, see the <see cref="T:System.Security.Permissions.ReflectionPermission" /> class page.</para>
@@ -340,6 +330,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the permission and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the permission, including any state information.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -360,14 +354,6 @@
         <Parameter Name="other" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Security.Permissions.ReflectionPermission" /> 
-instance that represents the union of the current instance and <paramref name="other" />. If
-the current instance or <paramref name="other " />is unrestricted, returns a
-<see cref="T:System.Security.Permissions.ReflectionPermission" /> instance that is 
-unrestricted. If <paramref name="other" /> is <see langword="null" />, returns a copy of the
-current instance.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">The <paramref name="other " />parameter is not <see langword="null" /> and is not an instance of <see cref="T:System.Security.Permissions.ReflectionPermission" /> .</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -377,6 +363,10 @@ current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a permission that is the union of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the union of the current permission and the specified permission.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to combine with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/ReflectionPermissionAttribute.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/ReflectionPermissionAttribute.xml
index 3e4345b289e..7f45fa94cb8 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/ReflectionPermissionAttribute.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/ReflectionPermissionAttribute.xml
@@ -96,11 +96,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Security.Permissions.ReflectionPermission" /> object with the 
-   security information of the current
-   instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method should only be called by the security system, never by application code.</para>
@@ -110,6 +105,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new <see cref="T:System.Security.Permissions.ReflectionPermission" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Permissions.ReflectionPermission" /> that corresponds to this attribute.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/RegistryPermission.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/RegistryPermission.xml
index 87f86c9bc6e..b3c2306ca48 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/RegistryPermission.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/RegistryPermission.xml
@@ -216,7 +216,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A copy of a permission represents the same access to resources as the original permission.</para>
@@ -225,6 +224,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an identical copy of the current permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current permission.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="FromXml">
@@ -268,7 +271,6 @@
         <Parameter Name="access" Type="System.Security.Permissions.RegistryPermissionAccess" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to get the state of the current permission. You must call this method separately for each type of access.</para>
@@ -280,6 +282,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets paths for all registry variables with the specified <see cref="T:System.Security.Permissions.RegistryPermissionAccess" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A list of the registry variables (semicolon-separated) with the specified <see cref="T:System.Security.Permissions.RegistryPermissionAccess" />.</para>
+        </returns>
         <param name="access">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Security.Permissions.RegistryPermissionAccess" /> values that represents a single type of registry variable access. </param>
       </Docs>
@@ -300,7 +306,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The intersection of two permissions is a permission that describes the set of operations they both describe in common. Only a demand that passes both original permissions will pass the intersection.</para>
@@ -309,6 +314,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a permission that is the intersection of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the intersection of the current permission and the specified permission. This new permission is null if the intersection is empty.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to intersect with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
@@ -329,7 +338,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current permission is a subset of the specified permission if the current permission specifies a set of operations that is wholly contained by the specified permission. For example, a permission that represents access to C:\example.txt is a subset of a permission that represents access to C:\. If this method returns true, the current permission represents no more access to the protected resource than does the specified permission.</para>
@@ -338,6 +346,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current permission is a subset of the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is a subset of the specified permission; otherwise, false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission that is to be tested for the subset relationship. This permission must be of the same type as the current permission. </param>
       </Docs>
@@ -356,7 +368,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An unrestricted permission represents access to any and all resources protected by the permission.</para>
@@ -365,6 +376,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the current permission is unrestricted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is unrestricted; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SetPathList">
@@ -431,12 +446,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the permission and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the permission, including any state information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Union">
@@ -455,7 +473,6 @@
         <Parameter Name="other" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The result of a call to <see cref="M:System.Security.Permissions.RegistryPermission.Union(System.Security.IPermission)" /> is a permission that represents all the operations represented by both the current permission and the specified permission. Any demand that passes either permission passes their union.</para>
@@ -464,6 +481,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a permission that is the union of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the union of the current permission and the specified permission.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to combine with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/RegistryPermissionAttribute.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/RegistryPermissionAttribute.xml
index 53aa2607cd3..66976beabc1 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/RegistryPermissionAttribute.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/RegistryPermissionAttribute.xml
@@ -151,7 +151,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method should only be called by the security system, never by application code.</para>
@@ -161,6 +160,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new <see cref="T:System.Security.Permissions.RegistryPermission" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Permissions.RegistryPermission" /> that corresponds to this attribute.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Read">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/SecurityAttribute.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/SecurityAttribute.xml
index 01364f4dcb8..97a7f3e9b95 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/SecurityAttribute.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/SecurityAttribute.xml
@@ -101,9 +101,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Security.IPermission" /> object.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>At compile time, attributes convert security declarations to a serialized form in metadata. Declarative security data in metadata is created from the permission that this method returns that corresponds to this attribute.</para>
@@ -112,6 +109,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates a permission object that can then be serialized into binary form and persistently stored along with the <see cref="T:System.Security.Permissions.SecurityAction" /> in an assembly's metadata.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A serializable permission object.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/SecurityPermission.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/SecurityPermission.xml
index 6de9245db2a..08d07033c74 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/SecurityPermission.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/SecurityPermission.xml
@@ -111,10 +111,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A new <see cref="T:System.Security.Permissions.SecurityPermission" />
-instance containing the same values as the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A copy of a permission represents the same access to resources as the original permission.</para>
@@ -123,6 +119,10 @@ instance containing the same values as the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an identical copy of the current permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current permission.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -211,12 +211,6 @@ instance containing the same values as the current instance.</para>
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Security.Permissions.SecurityPermission" /> instance that represents the
- intersection of the current instance and <paramref name="target" />. If
- the intersection is empty, or <paramref name="target" />
- is <see langword="null" />, returns <see langword="null" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="target" /> is not <see langword="null" /> and is not of type <see cref="T:System.Security.Permissions.SecurityPermission" /> . </exception>
         <remarks>
@@ -227,6 +221,10 @@ instance containing the same values as the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a permission that is the intersection of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission object that represents the intersection of the current permission and the specified permission. This new permission is null if the intersection is empty.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to intersect with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
@@ -249,18 +247,6 @@ instance containing the same values as the current instance.</para>
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the current instance is a subset of <paramref name="target" /> ;
-   otherwise,<see langword=" false" />. If the current instance is unrestricted, and
-<paramref name="target" /> is not, returns <see langword="false" />. If <paramref name="target" /> is 
-   unrestricted, returns <see langword="true" />. If target is
-<see langword="null" /> and the current instance was initialized with
-<see cref="F:System.Security.Permissions.SecurityPermissionFlag.NoFlags" />, returns 
-<see langword="true" />. If target is <see langword="null" /> and the current instance was initialized with any value
-   other than <see langword="NoFlags" />, returns
-<see langword="false" /> .</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="target" /> is not <see langword="null" /> and is not of type <see cref="T:System.Security.Permissions.SecurityPermission" /> . </exception>
         <remarks>
@@ -271,6 +257,10 @@ instance containing the same values as the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current permission is a subset of the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is a subset of the specified permission; otherwise, false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission that is to be tested for the subset relationship. This permission must be of the same type as the current permission. </param>
       </Docs>
@@ -290,7 +280,6 @@ instance containing the same values as the current instance.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An unrestricted permission represents access to any and all resources protected by the permission.</para>
@@ -299,6 +288,10 @@ instance containing the same values as the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the current permission is unrestricted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is unrestricted; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Security.Permissions.IBuiltInPermission.GetTokenIndex">
@@ -335,10 +328,6 @@ instance containing the same values as the current instance.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Security.SecurityElement" /> containing an XML encoding of the state of the
- current instance.</para>
-        </returns>
         <remarks>
           <block subset="none" type="note">
             <para>For the XML encoding for this class, see
@@ -350,6 +339,10 @@ instance containing the same values as the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the permission and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the permission, including any state information.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -370,16 +363,6 @@ instance containing the same values as the current instance.</para>
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A new <see cref="T:System.Security.Permissions.SecurityPermission" />
-instance
-that represents the union of the current instance and <paramref name="target" />. If the current instance
-or <paramref name="target" /> is unrestricted, returns
-a <see cref="T:System.Security.Permissions.SecurityPermission" />
-instance that is unrestricted. If <paramref name="target " />is <see langword="null" />,
-returns a copy of the current instance using the <see cref="M:System.Security.IPermission.Copy" qualify="true" />
-method.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="target " /> is not <see langword="null" /> and is not of type <see cref="T:System.Security.Permissions.SecurityPermission" /> .</exception>
         <remarks>
@@ -390,6 +373,10 @@ method.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a permission that is the union of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the union of the current permission and the specified permission.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to combine with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/SecurityPermissionAttribute.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/SecurityPermissionAttribute.xml
index 2fe9b994dbf..7bed27f85c7 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/SecurityPermissionAttribute.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/SecurityPermissionAttribute.xml
@@ -269,10 +269,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Security.Permissions.SecurityPermission" /> object
-   with the security information of the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method should only be called by the security system, never by application code.</para>
@@ -282,6 +278,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new <see cref="T:System.Security.Permissions.SecurityPermission" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Permissions.SecurityPermission" /> that corresponds to this attribute.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/SiteIdentityPermission.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/SiteIdentityPermission.xml
index 0ca193e1f84..982b54f3136 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/SiteIdentityPermission.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/SiteIdentityPermission.xml
@@ -116,7 +116,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A copy of the permission represents the same access to resources or the same site identity as the original permission.</para>
@@ -125,6 +124,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an identical copy of the current permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current permission.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="FromXml">
@@ -168,7 +171,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The intersection of two permissions is a permission that describes the sites they both describe in common. Only a demand that passes both original permissions will pass the intersection. For example, the intersection of a permission that represents access to www.fourthcoffee.com and one that represents access to *.fourthcoffee.com is a permission that represents access to www.fourthcoffee.com.</para>
@@ -178,6 +180,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a permission that is the intersection of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the intersection of the current permission and the specified permission. This new permission is null if the intersection is empty.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to intersect with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
@@ -198,7 +204,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current permission is a subset of the specified permission if the current permission specifies a site that is wholly contained by the specified permission.</para>
@@ -322,6 +327,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current permission is a subset of the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is a subset of the specified permission; otherwise, false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission that is to be tested for the subset relationship. This permission must be of the same type as the current permission. </param>
       </Docs>
@@ -384,12 +393,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the permission and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the permission, including any state information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Union">
@@ -408,7 +420,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The result of a call to <see cref="M:System.Security.Permissions.SiteIdentityPermission.Union(System.Security.IPermission)" /> is a permission that represents all the sites represented by both the current permission and the specified permission. Any demand that passes either permission passes their union. For example, the union of a permission that represents access to www.fourthcoffee.com and one that represents access to *.fourthcoffee.com is a permission that represents access to *.fourthcoffee.com.</para>
@@ -418,6 +429,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a permission that is the union of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the union of the current permission and the specified permission.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to combine with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/SiteIdentityPermissionAttribute.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/SiteIdentityPermissionAttribute.xml
index 28258bf56ab..3988a483852 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/SiteIdentityPermissionAttribute.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/SiteIdentityPermissionAttribute.xml
@@ -78,7 +78,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method should only be called by the security system, never by application code.</para>
@@ -88,6 +87,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new instance of <see cref="T:System.Security.Permissions.SiteIdentityPermission" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Permissions.SiteIdentityPermission" /> that corresponds to this attribute.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Site">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/StrongNameIdentityPermission.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/StrongNameIdentityPermission.xml
index dfc17fd2729..2f38f1cdaa7 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/StrongNameIdentityPermission.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/StrongNameIdentityPermission.xml
@@ -121,7 +121,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A copy of a permission represents the same access to resources as the original permission.</para>
@@ -130,6 +129,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an identical copy of the current permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current permission.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="FromXml">
@@ -176,7 +179,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The intersection of two permissions is a permission that describes the set of operations they both describe in common. Only a demand that passes both original permissions will pass the intersection.</para>
@@ -186,6 +188,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a permission that is the intersection of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the intersection of the current permission and the specified permission, or null if the intersection is empty.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to intersect with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
@@ -206,7 +212,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current permission is a subset of the specified permission if the current permission specifies a set of operations that is wholly contained by the specified permission. For example, the other properties being equal, an identity with the <see cref="P:System.Security.Permissions.StrongNameIdentityPermission.Name" /> property containing the wildcard expression MyCompany.MyDepartment.* is identified as a subset of an identity with the <see cref="P:System.Security.Permissions.StrongNameIdentityPermission.Name" /> property MyCompany.MyDepartment.MyFile.</para>
@@ -215,6 +220,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current permission is a subset of the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is a subset of the specified permission; otherwise, false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission that is to be tested for the subset relationship. This permission must be of the same type as the current permission. </param>
       </Docs>
@@ -297,7 +306,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is not typically used by application code.</para>
@@ -306,6 +314,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the permission and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the permission, including any state information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Union">
@@ -324,7 +336,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The result of a call to <see cref="M:System.Security.Permissions.StrongNameIdentityPermission.Union(System.Security.IPermission)" /> is a permission that represents all the operations represented by both the current permission and the specified permission. Any demand that passes either permission passes their union.</para>
@@ -334,6 +345,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a permission that is the union of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the union of the current permission and the specified permission.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to combine with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/StrongNameIdentityPermissionAttribute.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/StrongNameIdentityPermissionAttribute.xml
index a98effd60c5..f8f8e1fc7a1 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/StrongNameIdentityPermissionAttribute.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/StrongNameIdentityPermissionAttribute.xml
@@ -76,7 +76,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method should be called only by the security system, never by application code.</para>
@@ -86,6 +85,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new <see cref="T:System.Security.Permissions.StrongNameIdentityPermission" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Permissions.StrongNameIdentityPermission" /> that corresponds to this attribute.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Name">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/StrongNamePublicKeyBlob.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/StrongNamePublicKeyBlob.xml
index 089387c3cd6..04a00caddb6 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/StrongNamePublicKeyBlob.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/StrongNamePublicKeyBlob.xml
@@ -70,12 +70,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets or sets a value indicating whether the current public key blob is equal to the specified public key blob.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the public key blob of the current object is equal to the public key blob of the <paramref name="obj" /> parameter; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object containing a public key blob. </param>
       </Docs>
@@ -94,7 +97,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Hash functions map binary strings of an arbitrary length to small binary strings of a fixed length, known as hash values.</para>
@@ -103,6 +105,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash code based on the public key.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code based on the public key.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -119,12 +125,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a string representation of the public key blob.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hexadecimal version of the public key blob.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/UIPermission.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/UIPermission.xml
index bb4dd634cf1..3107d3a05d4 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/UIPermission.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/UIPermission.xml
@@ -178,7 +178,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A copy of the permission represents the same access to resources as the original permission.</para>
@@ -187,6 +186,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an identical copy of the current permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current permission.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="FromXml">
@@ -230,7 +233,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The intersection of two permissions is a permission that describes the set of operations they both describe in common. Specifically, it represents the least permissive values of <see cref="T:System.Security.Permissions.UIPermissionWindow" /> and <see cref="T:System.Security.Permissions.UIPermissionClipboard" /> from those in the current permission and the specified permission.</para>
@@ -239,6 +241,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a permission that is the intersection of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the intersection of the current permission and the specified permission. This new permission is null if the intersection is empty.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to intersect with the current permission. It must be the same type as the current permission. </param>
       </Docs>
@@ -259,7 +265,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current permission is a subset of the specified permission if all demands that succeed for the current permission also succeed for the specified permission. That is, the specified permission contains at least the permissions contained in the subset. For <see cref="M:System.Security.Permissions.UIPermission.IsSubsetOf(System.Security.IPermission)" /> to return true, both the <see cref="T:System.Security.Permissions.UIPermissionWindow" /> and <see cref="T:System.Security.Permissions.UIPermissionClipboard" /> values of the current permission must be equal to or less permissive than the values of the specified permission.</para>
@@ -268,6 +273,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current permission is a subset of the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is a subset of the specified permission; otherwise, false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to test for the subset relationship. This permission must be the same type as the current permission. </param>
       </Docs>
@@ -286,7 +295,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An unrestricted permission represents access to any and all resources protected by the permission.</para>
@@ -295,6 +303,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the current permission is unrestricted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is unrestricted; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Security.Permissions.IBuiltInPermission.GetTokenIndex">
@@ -330,12 +342,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the permission and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the permission, including any state information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Union">
@@ -354,7 +369,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The result of a call to <see cref="M:System.Security.Permissions.UIPermission.Union(System.Security.IPermission)" /> is a permission that represents all the operations represented by the current permission as well as all the operations represented by the specified permission. Specifically, it represents the most permissive values of <see cref="T:System.Security.Permissions.UIPermissionWindow" /> and <see cref="T:System.Security.Permissions.UIPermissionClipboard" /> from those in the current permission and the specified permission.</para>
@@ -363,6 +377,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a permission that is the union of the permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the union of the current permission and the specified permission.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to combine with the current permission. It must be the same type as the current permission. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/UIPermissionAttribute.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/UIPermissionAttribute.xml
index 76a91863469..65283b8adcd 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/UIPermissionAttribute.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/UIPermissionAttribute.xml
@@ -92,7 +92,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method should only be called by the security system, never by application code.</para>
@@ -102,6 +101,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new <see cref="T:System.Security.Permissions.UIPermission" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Permissions.UIPermission" /> that corresponds to this attribute.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Window">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/UrlIdentityPermission.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/UrlIdentityPermission.xml
index d64eeed1cca..bf0931d6155 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/UrlIdentityPermission.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/UrlIdentityPermission.xml
@@ -121,7 +121,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A copy of a permission represents the same access to resources as the original permission. </para>
@@ -130,6 +129,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an identical copy of the current permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current permission.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="FromXml">
@@ -173,7 +176,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The intersection of two permissions is a permission that describes access to the URLs they both describe in common. Only a demand that passes both original permissions will pass the intersection. For example, the intersection of a permission that represents access to http://www.fourthcoffee.com/process/grind.htm and a permission that represents access to http://www.fourthcoffee.com/* is a permission that represents access to http://www.fourthcoffee.com/process/grind.htm.</para>
@@ -184,6 +186,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a permission that is the intersection of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the intersection of the current permission and the specified permission. This new permission is null if the intersection is empty.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to intersect with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
@@ -204,7 +210,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current permission is a subset of the specified permission if the current permission identifies access to a URL that is wholly contained by the specified permission. For example, a permission that represents access to http://www.fourthcoffee.com/process/grind.htm is a subset of a permission that represents access to http://www.fourthcoffee.com/*. If this method returns true, the current permission represents no more access to the protected resource than does the specified permission.</para>
@@ -215,6 +220,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current permission is a subset of the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is a subset of the specified permission; otherwise, false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission that is to be tested for the subset relationship. This permission must be of the same type as the current permission. </param>
       </Docs>
@@ -252,12 +261,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the permission and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the permission, including any state information. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Union">
@@ -276,7 +288,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The result of a call to the <see cref="M:System.Security.Permissions.UrlIdentityPermission.Union(System.Security.IPermission)" /> method is a permission that represents access to the URL as represented by the current permission, as well as access to the URL as represented by the specified permission.</para>
@@ -286,6 +297,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a permission that is the union of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the union of the current permission and the specified permission.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to combine with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/UrlIdentityPermissionAttribute.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/UrlIdentityPermissionAttribute.xml
index 0801aa8ae4e..19e696c0e80 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/UrlIdentityPermissionAttribute.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/UrlIdentityPermissionAttribute.xml
@@ -76,7 +76,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method should only be called by the security system, never by application code.</para>
@@ -86,6 +85,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new <see cref="T:System.Security.Permissions.UrlIdentityPermission" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Permissions.UrlIdentityPermission" /> that corresponds to this attribute.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Url">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/ZoneIdentityPermission.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/ZoneIdentityPermission.xml
index fcde9c19b3d..1c2f3a5631c 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/ZoneIdentityPermission.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/ZoneIdentityPermission.xml
@@ -122,7 +122,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A copy of a permission represents the same access to resources as the original permission.</para>
@@ -131,6 +130,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an identical copy of the current permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current permission.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="FromXml">
@@ -174,7 +177,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The intersection of two permissions is a permission that describes the set of operations they both describe in common. Only a demand that passes both original permissions will pass the intersection.</para>
@@ -184,6 +186,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a permission that is the intersection of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the intersection of the current permission and the specified permission. This new permission is null if the intersection is empty.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to intersect with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
@@ -204,7 +210,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current permission is a subset of the specified permission if the two permissions are equal or if the current permission represents the <see cref="F:System.Security.SecurityZone.NoZone" /> security zone.</para>
@@ -213,6 +218,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current permission is a subset of the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is a subset of the specified permission; otherwise, false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission that is to be tested for the subset relationship. This permission must be of the same type as the current permission. </param>
       </Docs>
@@ -271,12 +280,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the permission and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the permission, including any state information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Union">
@@ -295,7 +307,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The result of a call to <see cref="M:System.Security.Permissions.ZoneIdentityPermission.Union(System.Security.IPermission)" /> is a permission that represents the security zone represented by both the current permission and the specified permission. Any demand that passes either permission passes their union. The union of two identical <see cref="T:System.Security.Permissions.ZoneIdentityPermission" /> objects is the same permission. The union of a null permission and a <see cref="T:System.Security.Permissions.ZoneIdentityPermission" /> permission is the permission that is not null. </para>
@@ -305,6 +316,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a permission that is the union of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the union of the current permission and the specified permission.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to combine with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Permissions/ZoneIdentityPermissionAttribute.xml b/mcs/class/corlib/Documentation/en/System.Security.Permissions/ZoneIdentityPermissionAttribute.xml
index 77c1c57fb86..7073ce1254b 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Permissions/ZoneIdentityPermissionAttribute.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Permissions/ZoneIdentityPermissionAttribute.xml
@@ -75,7 +75,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method should only be called by the security system, never by application code.</para>
@@ -85,6 +84,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a new <see cref="T:System.Security.Permissions.ZoneIdentityPermission" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Permissions.ZoneIdentityPermission" /> that corresponds to this attribute.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Zone">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/AllMembershipCondition.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/AllMembershipCondition.xml
index 59e9b6ea32c..2af6fffa21d 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/AllMembershipCondition.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/AllMembershipCondition.xml
@@ -72,7 +72,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>All code is a match for <see cref="T:System.Security.Policy.AllMembershipCondition" />, so <see cref="M:System.Security.Policy.AllMembershipCondition.Check(System.Security.Policy.Evidence)" /> always returns true.</para>
@@ -81,6 +80,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified evidence satisfies the membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always true.</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The evidence set against which to make the test. </param>
       </Docs>
@@ -99,12 +102,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IMembershipCondition'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an equivalent copy of the membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new, identical copy of the current membership condition.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Equals">
@@ -123,12 +129,15 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified membership condition is an <see cref="T:System.Security.Policy.AllMembershipCondition" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified membership condition is an <see cref="T:System.Security.Policy.AllMembershipCondition" />; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to <see cref="T:System.Security.Policy.AllMembershipCondition" />. </param>
       </Docs>
@@ -200,12 +209,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash code for the current membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the current membership condition.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -222,12 +234,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a string representation of the membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A representation of the membership condition.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToXml">
@@ -244,12 +259,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Security.SecurityElement'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the security object and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the security object, including any state information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToXml">
@@ -268,12 +286,15 @@
         <Parameter Name="level" Type="System.Security.Policy.PolicyLevel" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Security.SecurityElement'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the security object and its current state with the specified <see cref="T:System.Security.Policy.PolicyLevel" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the security object, including any state information.</para>
+        </returns>
         <param name="level">
           <attribution license="cc4" from="Microsoft" modified="false" />The policy level context for resolving named permission set references. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/ApplicationDirectory.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/ApplicationDirectory.xml
index 50fb6dd7bcd..e489c741285 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/ApplicationDirectory.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/ApplicationDirectory.xml
@@ -74,12 +74,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new copy of the <see cref="T:System.Security.Policy.ApplicationDirectory" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new, identical copy of the <see cref="T:System.Security.Policy.ApplicationDirectory" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Directory">
@@ -119,7 +122,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The directory values of the two instances must match exactly. Equivalent noncanonical paths are not resolved. For example, C:\app and C:\temp\...\app are not equal directory values.</para>
@@ -128,6 +130,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether instances of the same type of an evidence object are equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two instances are equivalent; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />An object of same type as the current evidence object. </param>
       </Docs>
@@ -146,12 +152,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash code of the current application directory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code of the current application directory.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Security.Policy.IBuiltInEvidence.GetRequiredSize">
@@ -240,7 +249,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is useful during debugging to get an easy-to-read representation of the object.</para>
@@ -249,6 +257,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a string representation of the state of the <see cref="T:System.Security.Policy.ApplicationDirectory" /> evidence object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A representation of the state of the <see cref="T:System.Security.Policy.ApplicationDirectory" /> evidence object.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/ApplicationDirectoryMembershipCondition.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/ApplicationDirectoryMembershipCondition.xml
index 97aa3ea3028..5a577827b37 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/ApplicationDirectoryMembershipCondition.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/ApplicationDirectoryMembershipCondition.xml
@@ -80,7 +80,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="evidence" /> parameter must contain both <see cref="T:System.Security.Policy.ApplicationDirectory" /> evidence that specifies the application directory of the running application and <see cref="T:System.Security.Policy.Url" /> evidence that specifies the code base of the assembly. The code base specified by the <see cref="T:System.Security.Policy.Url" /> evidence must represent a path in the directory tree of the application directory specified by the <see cref="T:System.Security.Policy.ApplicationDirectory" /> evidence for this method to return true.</para>
@@ -89,6 +88,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the membership condition is satisfied by the specified evidence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified evidence satisfies the membership condition; otherwise, false.</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The evidence set against which to make the test. </param>
       </Docs>
@@ -107,12 +110,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IMembershipCondition'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an equivalent copy of the membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new, identical copy of the current membership condition.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Equals">
@@ -131,12 +137,15 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified membership condition is an <see cref="T:System.Security.Policy.ApplicationDirectoryMembershipCondition" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified membership condition is an <see cref="T:System.Security.Policy.ApplicationDirectoryMembershipCondition" />; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to <see cref="T:System.Security.Policy.ApplicationDirectoryMembershipCondition" />. </param>
       </Docs>
@@ -208,12 +217,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash code for the current membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the current membership condition.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -230,12 +242,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a string representation of the membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the state of the membership condition.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToXml">
@@ -252,12 +267,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Security.SecurityElement'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the security object and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the security object, including any state information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToXml">
@@ -276,12 +294,15 @@
         <Parameter Name="level" Type="System.Security.Policy.PolicyLevel" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Security.SecurityElement'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the security object and its current state with the specified <see cref="T:System.Security.Policy.PolicyLevel" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the security object, including any state information.</para>
+        </returns>
         <param name="level">
           <attribution license="cc4" from="Microsoft" modified="false" />The policy level context for resolving named permission set references. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/ApplicationSecurityManager.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/ApplicationSecurityManager.xml
index d252e4014a2..553a08818e3 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/ApplicationSecurityManager.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/ApplicationSecurityManager.xml
@@ -68,7 +68,6 @@
         <Parameter Name="context" Type="System.Security.Policy.TrustManagerContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -79,6 +78,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the user approves the specified application to execute with the requested permission set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true to execute the specified application; otherwise, false.</para>
+        </returns>
         <param name="activationContext">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ActivationContext" /> identifying the activation context for the application.</param>
         <param name="context">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/ApplicationTrust.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/ApplicationTrust.xml
index 24e88083004..50567022683 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/ApplicationTrust.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/ApplicationTrust.xml
@@ -286,7 +286,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -296,6 +295,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the <see cref="T:System.Security.Policy.ApplicationTrust" /> object and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the security object, including any state information.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/ApplicationTrustCollection.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/ApplicationTrustCollection.xml
index 6a345199a01..13b201371be 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/ApplicationTrustCollection.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/ApplicationTrustCollection.xml
@@ -48,7 +48,6 @@
         <Parameter Name="trust" Type="System.Security.Policy.ApplicationTrust" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -58,6 +57,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an element to the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index at which the new element was inserted.</para>
+        </returns>
         <param name="trust">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Policy.ApplicationTrust" /> object to add.</param>
       </Docs>
@@ -215,7 +218,6 @@
         <Parameter Name="versionMatch" Type="System.Security.Policy.ApplicationVersionMatch" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -225,6 +227,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the application trusts in the collection that match the specified application identity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.Policy.ApplicationTrustCollection" /> containing all matching <see cref="T:System.Security.Policy.ApplicationTrust" /> objects.</para>
+        </returns>
         <param name="applicationIdentity">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.ApplicationIdentity" /> object describing the application to find.</param>
         <param name="versionMatch">
@@ -244,7 +250,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -260,6 +265,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that can be used to iterate over the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.Policy.ApplicationTrustEnumerator" /> that can be used to iterate over the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsSynchronized">
@@ -509,13 +518,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> that can be used to iterate through the collection.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/ApplicationTrustEnumerator.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/ApplicationTrustEnumerator.xml
index 724d5da48c0..627849a66f7 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/ApplicationTrustEnumerator.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/ApplicationTrustEnumerator.xml
@@ -76,7 +76,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -89,6 +88,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Moves to the next element in the <see cref="T:System.Security.Policy.ApplicationTrustCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the enumerator was successfully advanced to the next element; false if the enumerator has passed the end of the collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Reset">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/CodeConnectAccess.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/CodeConnectAccess.xml
index 80b6927b400..ab85fcf92de 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/CodeConnectAccess.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/CodeConnectAccess.xml
@@ -98,7 +98,6 @@
         <Parameter Name="allowPort" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -108,6 +107,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Security.Policy.CodeConnectAccess" /> instance that represents access to the specified port using any scheme.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Policy.CodeConnectAccess" /> instance for the specified port.</para>
+        </returns>
         <param name="allowPort">
           <attribution license="cc4" from="Microsoft" modified="false" />The port represented by the returned instance.</param>
       </Docs>
@@ -127,7 +130,6 @@
         <Parameter Name="allowPort" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -137,6 +139,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Security.Policy.CodeConnectAccess" /> instance that represents access to the specified port using the code's scheme of origin.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Policy.CodeConnectAccess" /> instance for the specified port.</para>
+        </returns>
         <param name="allowPort">
           <attribution license="cc4" from="Microsoft" modified="false" />The port represented by the returned instance.</param>
       </Docs>
@@ -181,7 +187,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -191,6 +196,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether two <see cref="T:System.Security.Policy.CodeConnectAccess" /> objects represent the same scheme and port.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two objects represent the same scheme and port; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to the current <see cref="T:System.Security.Policy.CodeConnectAccess" /> object.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/CodeGroup.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/CodeGroup.xml
index 3bc34960ad1..d0e3d546d07 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/CodeGroup.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/CodeGroup.xml
@@ -151,7 +151,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'CodeGroup'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method makes a deep copy of the code group, so that copies of all objects the code group contains are also made.</para>
@@ -160,6 +159,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, makes a deep copy of the current code group.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An equivalent copy of the current code group, including its membership conditions and child code groups.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateXml">
@@ -232,7 +235,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Two code groups are equivalent if they have the same <see cref="P:System.Security.Policy.CodeGroup.Name" />, <see cref="P:System.Security.Policy.CodeGroup.Description" />, and <see cref="P:System.Security.Policy.CodeGroup.MembershipCondition" />.</para>
@@ -242,6 +244,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified code group is equivalent to the current code group.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified code group is equivalent to the current code group; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The code group to compare with the current code group. </param>
       </Docs>
@@ -263,7 +269,6 @@
         <Parameter Name="compareChildren" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Two code groups are equivalent if they have the same <see cref="P:System.Security.Policy.CodeGroup.Name" />, <see cref="P:System.Security.Policy.CodeGroup.Description" />, and <see cref="P:System.Security.Policy.CodeGroup.MembershipCondition" />.</para>
@@ -273,6 +278,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified code group is equivalent to the current code group, checking the child code groups as well, if specified.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified code group is equivalent to the current code group; otherwise, false.</para>
+        </returns>
         <param name="cg">
           <attribution license="cc4" from="Microsoft" modified="false" />The code group to compare with the current code group. </param>
         <param name="compareChildren">
@@ -349,12 +358,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash code of the current code group.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code of the current code group.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MembershipCondition">
@@ -549,7 +561,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PolicyStatement'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Given evidence for an assembly to be loaded, this method evaluates the code group by checking the membership condition against the specified evidence. If there is a match, this method returns a policy statement for the code group, including evaluation of child code groups.</para>
@@ -560,6 +571,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, resolves policy for the code group and its descendants for a set of evidence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A policy statement that consists of the permissions granted by the code group with optional attributes, or null if the code group does not apply (the membership condition does not match the specified evidence).</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The evidence for the assembly. </param>
       </Docs>
@@ -580,7 +595,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'CodeGroup'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method has the same evaluation characteristics as <see cref="M:System.Security.Policy.CodeGroup.Resolve(System.Security.Policy.Evidence)" />. The code group that is returned contains child code groups, which in turn can have child code groups as necessary to reflect the complete set of code groups that were matched by the evidence provided.</para>
@@ -589,6 +603,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, resolves matching code groups.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Policy.CodeGroup" /> that is the root of the tree of matching code groups.</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The evidence for the assembly. </param>
       </Docs>
@@ -607,12 +625,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Security.SecurityElement'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the security object and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the security object, including any state information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToXml">
@@ -631,7 +652,6 @@
         <Parameter Name="level" Type="System.Security.Policy.PolicyLevel" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Security.SecurityElement'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The policy level context is provided for resolution of named permission sets.</para>
@@ -640,6 +660,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the security object, its current state, and the policy level within which the code exists.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the security object, including any state information.</para>
+        </returns>
         <param name="level">
           <attribution license="cc4" from="Microsoft" modified="false" />The policy level within which the code group exists. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/Evidence.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/Evidence.xml
index ede297bc65a..079a49749b3 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/Evidence.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/Evidence.xml
@@ -320,12 +320,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IEnumerator'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Enumerates evidence provided by the assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator for evidence added by the <see cref="M:System.Security.Policy.Evidence.AddAssembly(System.Object)" /> method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetEnumerator">
@@ -347,12 +350,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IEnumerator'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Enumerates all evidence in the set, both that provided by the host and that provided by the assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator for evidence added by both the <see cref="M:System.Security.Policy.Evidence.AddHost(System.Object)" /> method and the <see cref="M:System.Security.Policy.Evidence.AddAssembly(System.Object)" /> method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -391,12 +397,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IEnumerator'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Enumerates evidence supplied by the host.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator for evidence added by the <see cref="M:System.Security.Policy.Evidence.AddHost(System.Object)" /> method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsReadOnly">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/EvidenceBase.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/EvidenceBase.xml
index 3d67099dace..f272c8e41c3 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/EvidenceBase.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/EvidenceBase.xml
@@ -55,7 +55,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The duplicate copy is a complete copy that includes all the evidence objects in the collection. </para>
@@ -64,6 +63,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new object that is a complete copy of the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A duplicate copy of this evidence object.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/FileCodeGroup.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/FileCodeGroup.xml
index 3ce0e1e0136..c2abcaf136b 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/FileCodeGroup.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/FileCodeGroup.xml
@@ -103,7 +103,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method makes a deep copy of the code group, so that copies of all objects the code group contains are also made.</para>
@@ -112,6 +111,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Makes a deep copy of the current code group.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An equivalent copy of the current code group, including its membership conditions and child code groups.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateXml">
@@ -153,12 +156,15 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified code group is equivalent to the current code group.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified code group is equivalent to the current code group; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The code group to compare with the current code group. </param>
       </Docs>
@@ -177,12 +183,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash code of the current code group.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code of the current code group.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MergeLogic">
@@ -266,7 +275,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Given evidence for an assembly to be loaded, this method evaluates the code group by first checking the membership condition against the specified evidence. If there is a match, this method returns a policy statement for the code group, including evaluation of child code groups.</para>
@@ -278,6 +286,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resolves policy for the code group and its descendants for a set of evidence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A policy statement consisting of the permissions granted by the code group with optional attributes, or null if the code group does not apply (the membership condition does not match the specified evidence).</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The evidence for the assembly. </param>
       </Docs>
@@ -298,7 +310,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Given evidence for an assembly to be loaded, this method evaluates the code group by first checking the membership condition against the specified evidence. If there is a match, this method returns a root code group. The code group that is returned contains child code groups, which in turn can have child code groups as necessary to reflect the complete set of code groups that were matched by the evidence provided.</para>
@@ -309,6 +320,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resolves matching code groups.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Policy.CodeGroup" /> that is the root of the tree of matching code groups.</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The evidence for the assembly. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/FirstMatchCodeGroup.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/FirstMatchCodeGroup.xml
index 613c67d3d83..4819d5b676d 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/FirstMatchCodeGroup.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/FirstMatchCodeGroup.xml
@@ -76,7 +76,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method makes a deep copy of the code group, meaning that copies of all objects it contains are made, as well.</para>
@@ -85,6 +84,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Makes a deep copy of the code group.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An equivalent copy of the code group, including its membership conditions and child code groups.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MergeLogic">
@@ -124,7 +127,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Given evidence for an assembly to be loaded, this method evaluates the code group by first checking the membership condition against the specified evidence. If there is a match, this method returns a policy statement for the code group, including evaluation of child code groups.</para>
@@ -137,6 +139,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resolves policy for the code group and its descendants for a set of evidence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A policy statement consisting of the permissions granted by the code group with optional attributes, or null if the code group does not apply (the membership condition does not match the specified evidence).</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The evidence for the assembly. </param>
       </Docs>
@@ -157,7 +163,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Given evidence for an assembly to be loaded, this method evaluates the code group by first checking the membership condition against the specified evidence. If there is a match, this method returns a root code group. The code group that is returned contains child code groups, which in turn can have child code groups as necessary to reflect the complete set of code groups that were matched by the evidence provided.</para>
@@ -167,6 +172,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resolves matching code groups.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Policy.CodeGroup" /> that is the root of the tree of matching code groups.</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The evidence for the assembly. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/GacInstalled.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/GacInstalled.xml
index 4615d02ba38..e30a1a1a623 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/GacInstalled.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/GacInstalled.xml
@@ -69,13 +69,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an equivalent copy of the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An equivalent copy of <see cref="T:System.Security.Policy.GacInstalled" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateIdentityPermission">
@@ -93,7 +96,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -103,6 +105,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new identity permission that corresponds to the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new identity permission that corresponds to the current object.</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Policy.Evidence" /> from which to construct the identity permission. </param>
       </Docs>
@@ -122,7 +128,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -133,6 +138,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the current object is equivalent to the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="o" /> is a <see cref="T:System.Security.Policy.GacInstalled" /> object; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current object. </param>
       </Docs>
@@ -150,7 +159,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -160,6 +168,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash code for the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Security.Policy.IBuiltInEvidence.GetRequiredSize">
@@ -247,7 +259,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -257,6 +268,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of the current  object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the current object.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/GacMembershipCondition.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/GacMembershipCondition.xml
index 8e51c5d0ee6..b9408015454 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/GacMembershipCondition.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/GacMembershipCondition.xml
@@ -71,7 +71,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -81,6 +80,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified evidence satisfies the membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified evidence satisfies the membership condition; otherwise, false.</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Policy.Evidence" /> against which to make the test. </param>
       </Docs>
@@ -98,7 +101,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -108,6 +110,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an equivalent copy of the membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Security.Policy.GacMembershipCondition" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Equals">
@@ -125,7 +131,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -135,6 +140,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the current object is equivalent to the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="o" /> is a <see cref="T:System.Security.Policy.GacMembershipCondition" />; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current object. </param>
       </Docs>
@@ -211,7 +220,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -221,6 +229,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a hash code for the current membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>0 (zero).</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -236,7 +248,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -246,6 +257,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of the membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the membership condition.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToXml">
@@ -261,7 +276,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -271,6 +285,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the security object and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.SecurityElement" /> that contains the XML encoding of the security object, including any state information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToXml">
@@ -288,7 +306,6 @@
         <Parameter Name="level" Type="System.Security.Policy.PolicyLevel" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -298,6 +315,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the security object and its current state, using the specified policy level context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.SecurityElement" /> that contains the XML encoding of the security object, including any state information.</para>
+        </returns>
         <param name="level">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Policy.PolicyLevel" /> context for resolving <see cref="T:System.Security.NamedPermissionSet" /> references. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/Hash.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/Hash.xml
index f1da8515c5f..ab115d86c67 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/Hash.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/Hash.xml
@@ -79,7 +79,6 @@
         <Parameter Name="md5" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -89,6 +88,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Security.Policy.Hash" /> object that contains an <see cref="T:System.Security.Cryptography.MD5" /> hash value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that contains the hash value provided by the <paramref name="md5" /> parameter.</para>
+        </returns>
         <param name="md5">
           <attribution license="cc4" from="Microsoft" modified="false" />A byte array that contains an <see cref="T:System.Security.Cryptography.MD5" /> hash value.</param>
       </Docs>
@@ -108,7 +111,6 @@
         <Parameter Name="sha1" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -118,6 +120,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Security.Policy.Hash" /> object that contains a <see cref="T:System.Security.Cryptography.SHA1" /> hash value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that contains the hash value provided by the <paramref name="sha1" /> parameter.</para>
+        </returns>
         <param name="sha1">
           <attribution license="cc4" from="Microsoft" modified="false" />A byte array that contains a <see cref="T:System.Security.Cryptography.SHA1" /> hash value.</param>
       </Docs>
@@ -138,7 +144,6 @@
         <Parameter Name="hashAlg" Type="System.Security.Cryptography.HashAlgorithm" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The assembly specified in the class constructor provides the bytes for computing the hash value. The <paramref name="hashAlg" /> parameter is an object derived from a specific <see cref="T:System.Security.Cryptography.HashAlgorithm" />. The returned hash value is of the type identified by <paramref name="hashAlg" />.</para>
@@ -147,6 +152,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the hash value for the assembly using the specified hash algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array that represents the hash value for the assembly.</para>
+        </returns>
         <param name="hashAlg">
           <attribution license="cc4" from="Microsoft" modified="false" />The hash algorithm to use to compute the hash value for the assembly. </param>
       </Docs>
@@ -316,7 +325,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is useful during debugging to get an easy-to-read representation of the object.</para>
@@ -325,6 +333,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of the current <see cref="T:System.Security.Policy.Hash" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A representation of the current <see cref="T:System.Security.Policy.Hash" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/HashMembershipCondition.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/HashMembershipCondition.xml
index 18c71e071fe..a1e2cf13202 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/HashMembershipCondition.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/HashMembershipCondition.xml
@@ -79,7 +79,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This membership condition tests only the <see cref="T:System.Security.Policy.Hash" /> evidence object. There should be no more than one <see cref="T:System.Security.Policy.Hash" /> object in the evidence.</para>
@@ -88,6 +87,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified evidence satisfies the membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified evidence satisfies the membership condition; otherwise, false.</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The evidence set against which to make the test. </param>
       </Docs>
@@ -106,12 +109,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IMembershipCondition'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an equivalent copy of the membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new, identical copy of the current membership condition.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Equals">
@@ -130,12 +136,15 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="P:System.Security.Policy.HashMembershipCondition.HashValue" /> and the <see cref="P:System.Security.Policy.HashMembershipCondition.HashAlgorithm" /> from the specified object are equivalent to the <see cref="P:System.Security.Policy.HashMembershipCondition.HashValue" /> and <see cref="P:System.Security.Policy.HashMembershipCondition.HashAlgorithm" /> contained in the current <see cref="T:System.Security.Policy.HashMembershipCondition" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="P:System.Security.Policy.HashMembershipCondition.HashValue" /> and <see cref="P:System.Security.Policy.HashMembershipCondition.HashAlgorithm" /> from the specified object is equivalent to the <see cref="P:System.Security.Policy.HashMembershipCondition.HashValue" /> and <see cref="P:System.Security.Policy.HashMembershipCondition.HashAlgorithm" /> contained in the current <see cref="T:System.Security.Policy.HashMembershipCondition" />; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to the current <see cref="T:System.Security.Policy.HashMembershipCondition" />. </param>
       </Docs>
@@ -207,12 +216,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash code for the current membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the current membership condition.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HashAlgorithm">
@@ -327,12 +339,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a string representation of the membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the state of the membership condition.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToXml">
@@ -349,12 +364,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Security.SecurityElement'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the security object and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the security object, including any state information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToXml">
@@ -373,12 +391,15 @@
         <Parameter Name="level" Type="System.Security.Policy.PolicyLevel" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Security.SecurityElement'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the security object and its current state with the specified <see cref="T:System.Security.Policy.PolicyLevel" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the security object, including any state information.</para>
+        </returns>
         <param name="level">
           <attribution license="cc4" from="Microsoft" modified="false" />The policy level context for resolving named permission set references. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/IApplicationTrustManager.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/IApplicationTrustManager.xml
index 47485b8fe29..8225c0f5ae8 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/IApplicationTrustManager.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/IApplicationTrustManager.xml
@@ -46,7 +46,6 @@
         <Parameter Name="context" Type="System.Security.Policy.TrustManagerContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -56,6 +55,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether an application should be executed and which set of permissions should be granted to it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that contains security decisions about the application.</para>
+        </returns>
         <param name="activationContext">
           <attribution license="cc4" from="Microsoft" modified="false" />The activation context for the application.</param>
         <param name="context">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/IIdentityPermissionFactory.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/IIdentityPermissionFactory.xml
index a742034d9f5..f0c1f3caa63 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/IIdentityPermissionFactory.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/IIdentityPermissionFactory.xml
@@ -43,12 +43,15 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Security.IPermission'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new identity permission for the specified evidence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new identity permission.</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The evidence from which to create the new identity permission. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/IMembershipCondition.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/IMembershipCondition.xml
index 7c21fea830f..f799f918c52 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/IMembershipCondition.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/IMembershipCondition.xml
@@ -47,12 +47,15 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified evidence satisfies the membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified evidence satisfies the membership condition; otherwise, false.</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The evidence set against which to make the test. </param>
       </Docs>
@@ -71,12 +74,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IMembershipCondition'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an equivalent copy of the membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new, identical copy of the current membership condition.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Equals">
@@ -95,12 +101,15 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Object" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Object" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to compare with the current <see cref="T:System.Object" />. </param>
       </Docs>
@@ -119,12 +128,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a string representation of the membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the state of the current membership condition.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/NetCodeGroup.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/NetCodeGroup.xml
index f0f4116653a..0faf2d9b0d2 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/NetCodeGroup.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/NetCodeGroup.xml
@@ -252,7 +252,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method makes a deep copy of the code group, meaning that copies of all objects the code group contains are also made.</para>
@@ -261,6 +260,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Makes a deep copy of the current code group.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An equivalent copy of the current code group, including its membership conditions and child code groups.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateXml">
@@ -301,7 +304,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -322,6 +324,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified code group is equivalent to the current code group.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified code group is equivalent to the current code group; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Policy.NetCodeGroup" /> object to compare with the current code group.</param>
       </Docs>
@@ -339,7 +345,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -349,6 +354,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the connection access information for the current code group.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Collections.DictionaryEntry" /> array containing connection access information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -512,7 +521,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Given evidence for an assembly to be loaded, this method evaluates the code group by first checking the membership condition against the specified evidence. If there is a match, this method returns a policy statement for the code group, including evaluation of child code groups.</para>
@@ -523,6 +531,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resolves policy for the code group and its descendants for a set of evidence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Policy.PolicyStatement" /> that consists of the permissions granted by the code group with optional attributes, or null if the code group does not apply (the membership condition does not match the specified evidence).</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Policy.Evidence" /> for the assembly. </param>
       </Docs>
@@ -543,7 +555,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Given evidence for an assembly to be loaded, this method evaluates the code group by first checking the membership condition against the specified evidence. If there is a match, this method returns a root code group. The code group that is returned may contain child code groups, which, in turn, may also have child code groups, so the return value reflects the complete set of code groups that were matched by the evidence provided.</para>
@@ -552,6 +563,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resolves matching code groups.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The complete set of code groups that were matched by the evidence.</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The evidence for the assembly. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/PermissionRequestEvidence.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/PermissionRequestEvidence.xml
index 379c2d43398..bb59424e808 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/PermissionRequestEvidence.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/PermissionRequestEvidence.xml
@@ -80,12 +80,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'PermissionRequestEvidence'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an equivalent copy of the current <see cref="T:System.Security.Policy.PermissionRequestEvidence" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An equivalent copy of the current <see cref="T:System.Security.Policy.PermissionRequestEvidence" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DeniedPermissions">
@@ -237,7 +240,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is useful during debugging to get an easy-to-read representation of the <see cref="T:System.Security.Policy.PermissionRequestEvidence" />.</para>
@@ -246,6 +248,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a string representation of the state of the <see cref="T:System.Security.Policy.PermissionRequestEvidence" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A representation of the state of the <see cref="T:System.Security.Policy.PermissionRequestEvidence" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/PolicyLevel.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/PolicyLevel.xml
index 355b16aba8c..63125d7c6eb 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/PolicyLevel.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/PolicyLevel.xml
@@ -160,12 +160,15 @@
         <Parameter Name="pSet" Type="System.Security.PermissionSet" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Security.NamedPermissionSet'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Replaces a <see cref="T:System.Security.NamedPermissionSet" /> in the current policy level with the specified <see cref="T:System.Security.PermissionSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the <see cref="T:System.Security.NamedPermissionSet" /> that was replaced.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Security.NamedPermissionSet" /> to replace. </param>
         <param name="pSet">
@@ -186,7 +189,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'PolicyLevel'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates a new <see cref="T:System.Security.Policy.PolicyLevel" /> with the <see cref="P:System.Security.Policy.PolicyLevel.Label" /> "AppDomain". The new <see cref="T:System.Security.Policy.PolicyLevel" /> will initially contain the same <see cref="T:System.Security.NamedPermissionSet" /> objects as in the default computer policy, and will have a single root code group that grants FullTrust to all code.</para>
@@ -195,6 +197,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new policy level for use at the application domain policy level.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created <see cref="T:System.Security.Policy.PolicyLevel" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="FromXml">
@@ -269,12 +275,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Security.NamedPermissionSet'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Security.NamedPermissionSet" /> in the current policy level with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Security.NamedPermissionSet" /> in the current policy level with the specified name, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Security.NamedPermissionSet" /> to find. </param>
       </Docs>
@@ -431,12 +440,15 @@
         <Parameter Name="permSet" Type="System.Security.NamedPermissionSet" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Security.NamedPermissionSet'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the specified <see cref="T:System.Security.NamedPermissionSet" /> from the current policy level.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Security.NamedPermissionSet" /> that was removed.</para>
+        </returns>
         <param name="permSet">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.NamedPermissionSet" /> to remove from the current policy level. </param>
       </Docs>
@@ -457,12 +469,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Security.NamedPermissionSet'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the <see cref="T:System.Security.NamedPermissionSet" /> with the specified name from the current policy level.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Security.NamedPermissionSet" /> that was removed.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the <see cref="T:System.Security.NamedPermissionSet" /> to remove. </param>
       </Docs>
@@ -507,7 +522,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PolicyStatement'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -518,6 +532,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resolves policy based on evidence for the policy level, and returns the resulting <see cref="T:System.Security.Policy.PolicyStatement" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The resulting <see cref="T:System.Security.Policy.PolicyStatement" />.</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Policy.Evidence" /> used to resolve the <see cref="T:System.Security.Policy.PolicyLevel" />. </param>
       </Docs>
@@ -538,7 +556,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'CodeGroup'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use this method to analyze the effect of the code groups in a policy level with respect to a certain set of evidence. For example, if the security policy is not granting an assembly the minimum code request permissions it needs, it can be difficult to tell by examination of the code groups exactly where the problem is.</para>
@@ -548,6 +565,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resolves policy at the policy level and returns the root of a code group tree that matches the evidence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Policy.CodeGroup" /> representing the root of a tree of code groups matching the specified evidence.</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Policy.Evidence" /> used to resolve policy. </param>
       </Docs>
@@ -611,12 +632,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Security.SecurityElement'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the security object and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the security object, including any state information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Type">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/PolicyStatement.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/PolicyStatement.xml
index cc05f56432d..23c49efe9ef 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/PolicyStatement.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/PolicyStatement.xml
@@ -146,12 +146,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'PolicyStatement'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an equivalent copy of the current policy statement.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new copy of the <see cref="T:System.Security.Policy.PolicyStatement" /> with <see cref="P:System.Security.Policy.PolicyStatement.PermissionSet" /> and <see cref="P:System.Security.Policy.PolicyStatement.Attributes" /> identical to those of the current <see cref="T:System.Security.Policy.PolicyStatement" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Equals">
@@ -174,7 +177,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -184,6 +186,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Security.Policy.PolicyStatement" /> object is equal to the current <see cref="T:System.Security.Policy.PolicyStatement" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Security.Policy.PolicyStatement" /> is equal to the current <see cref="T:System.Security.Policy.PolicyStatement" /> object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Policy.PolicyStatement" /> object to compare with the current <see cref="T:System.Security.Policy.PolicyStatement" />. </param>
       </Docs>
@@ -259,7 +265,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -269,6 +274,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a hash code for the <see cref="T:System.Security.Policy.PolicyStatement" /> object that is suitable for use in hashing algorithms and data structures such as a hash table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.Security.Policy.PolicyStatement" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="PermissionSet">
@@ -306,12 +315,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Security.SecurityElement'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the security object and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the security object, including any state information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToXml">
@@ -330,12 +342,15 @@
         <Parameter Name="level" Type="System.Security.Policy.PolicyLevel" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Security.SecurityElement'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the security object and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the security object, including any state information.</para>
+        </returns>
         <param name="level">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Policy.PolicyLevel" /> context for lookup of <see cref="T:System.Security.NamedPermissionSet" /> values. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/Publisher.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/Publisher.xml
index 8675edef23d..1019fb0e83e 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/Publisher.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/Publisher.xml
@@ -97,12 +97,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an equivalent copy of the <see cref="T:System.Security.Policy.Publisher" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new, identical copy of the <see cref="T:System.Security.Policy.Publisher" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateIdentityPermission">
@@ -121,12 +124,15 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Security.IPermission'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an identity permission that corresponds to the current instance of the <see cref="T:System.Security.Policy.Publisher" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Permissions.PublisherIdentityPermission" /> for the specified <see cref="T:System.Security.Policy.Publisher" />.</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Policy.Evidence" /> from which to construct the identity permission. </param>
       </Docs>
@@ -147,7 +153,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -157,6 +162,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current <see cref="T:System.Security.Policy.Publisher" /> to the specified object for equivalence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two instances of the <see cref="T:System.Security.Policy.Publisher" /> class are equal; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Policy.Publisher" /> to test for equivalence with the current object. </param>
       </Docs>
@@ -175,12 +184,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash code of the current <see cref="P:System.Security.Policy.Publisher.Certificate" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code of the current <see cref="P:System.Security.Policy.Publisher.Certificate" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Security.Policy.IBuiltInEvidence.GetRequiredSize">
@@ -269,12 +281,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of the current <see cref="T:System.Security.Policy.Publisher" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A representation of the current <see cref="T:System.Security.Policy.Publisher" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/PublisherMembershipCondition.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/PublisherMembershipCondition.xml
index 488169c82f6..206accea0d1 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/PublisherMembershipCondition.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/PublisherMembershipCondition.xml
@@ -101,7 +101,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This membership condition tests only <see cref="T:System.Security.Policy.Publisher" /> evidence.</para>
@@ -110,6 +109,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified evidence satisfies the membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified evidence satisfies the membership condition; otherwise, false.</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Policy.Evidence" /> against which to make the test. </param>
       </Docs>
@@ -128,12 +131,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IMembershipCondition'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an equivalent copy of the membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new, identical copy of the current membership condition.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Equals">
@@ -152,7 +158,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the two publisher certificates are equal, they represent the same <see cref="T:System.Security.Policy.Publisher" />.</para>
@@ -161,6 +166,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the publisher certificate from the specified object is equivalent to the publisher certificate contained in the current <see cref="T:System.Security.Policy.PublisherMembershipCondition" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the publisher certificate from the specified object is equivalent to the publisher certificate contained in the current <see cref="T:System.Security.Policy.PublisherMembershipCondition" />; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to the current <see cref="T:System.Security.Policy.PublisherMembershipCondition" />. </param>
       </Docs>
@@ -232,12 +241,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash code for the current membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the current membership condition.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -254,12 +266,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a string representation of the <see cref="T:System.Security.Policy.PublisherMembershipCondition" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A representation of the <see cref="T:System.Security.Policy.PublisherMembershipCondition" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToXml">
@@ -276,12 +291,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Security.SecurityElement'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the security object and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the security object, including any state information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToXml">
@@ -300,12 +318,15 @@
         <Parameter Name="level" Type="System.Security.Policy.PolicyLevel" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Security.SecurityElement'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the security object and its current state with the specified <see cref="T:System.Security.Policy.PolicyLevel" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the security object, including any state information.</para>
+        </returns>
         <param name="level">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Policy.PolicyLevel" /> context, which is used to resolve <see cref="T:System.Security.NamedPermissionSet" /> references. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/Site.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/Site.xml
index 0bdb73a7fe7..96349d149a3 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/Site.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/Site.xml
@@ -75,12 +75,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an equivalent copy of the <see cref="T:System.Security.Policy.Site" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new object that is identical to the current <see cref="T:System.Security.Policy.Site" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateFromUrl">
@@ -99,12 +102,15 @@
         <Parameter Name="url" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Site'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.Security.Policy.Site" /> object from the specified URL.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new site object.</para>
+        </returns>
         <param name="url">
           <attribution license="cc4" from="Microsoft" modified="false" />The URL from which to create the new <see cref="T:System.Security.Policy.Site" /> object. </param>
       </Docs>
@@ -125,12 +131,15 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Security.IPermission'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an identity permission that corresponds to the current <see cref="T:System.Security.Policy.Site" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A site identity permission for the current <see cref="T:System.Security.Policy.Site" /> object.</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The evidence from which to construct the identity permission. </param>
       </Docs>
@@ -151,7 +160,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -161,6 +169,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current <see cref="T:System.Security.Policy.Site" /> to the specified object for equivalence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two instances of the <see cref="T:System.Security.Policy.Site" /> class are equal; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test for equivalence with the current object. </param>
       </Docs>
@@ -179,12 +191,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code of the current website name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code of the current website name.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Name">
@@ -294,12 +309,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of the current <see cref="T:System.Security.Policy.Site" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A representation of the current site.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/SiteMembershipCondition.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/SiteMembershipCondition.xml
index 9506f6ac08e..8b5e07524bf 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/SiteMembershipCondition.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/SiteMembershipCondition.xml
@@ -80,7 +80,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This membership condition tests only <see cref="T:System.Security.Policy.Site" /> evidence.</para>
@@ -89,6 +88,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified evidence satisfies the membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified evidence satisfies the membership condition; otherwise, false.</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Policy.Evidence" /> against which to make the test. </param>
       </Docs>
@@ -107,12 +110,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IMembershipCondition'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an equivalent copy of the membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new, identical copy of the current membership condition.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Equals">
@@ -131,12 +137,15 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the site from the specified <see cref="T:System.Security.Policy.SiteMembershipCondition" /> object is equivalent to the site contained in the current <see cref="T:System.Security.Policy.SiteMembershipCondition" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the site from the specified <see cref="T:System.Security.Policy.SiteMembershipCondition" /> object is equivalent to the site contained in the current <see cref="T:System.Security.Policy.SiteMembershipCondition" />; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Policy.SiteMembershipCondition" /> object to compare to the current <see cref="T:System.Security.Policy.SiteMembershipCondition" />. </param>
       </Docs>
@@ -208,12 +217,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash code for the current membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the current membership condition.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Site">
@@ -254,12 +266,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a string representation of the membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the membership condition.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToXml">
@@ -276,12 +291,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Security.SecurityElement'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the security object and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the security object, including any state information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToXml">
@@ -300,12 +318,15 @@
         <Parameter Name="level" Type="System.Security.Policy.PolicyLevel" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Security.SecurityElement'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the security object and its current state with the specified <see cref="T:System.Security.Policy.PolicyLevel" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the security object, including any state information.</para>
+        </returns>
         <param name="level">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Policy.PolicyLevel" /> context, used to resolve <see cref="T:System.Security.NamedPermissionSet" /> references. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/StrongName.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/StrongName.xml
index 373f0986e9f..faba96d1669 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/StrongName.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/StrongName.xml
@@ -87,12 +87,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an equivalent copy of the current <see cref="T:System.Security.Policy.StrongName" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new, identical copy of the current <see cref="T:System.Security.Policy.StrongName" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateIdentityPermission">
@@ -111,7 +114,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Security.IPermission'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The identity permission for a strong name can be used to determine whether calling code is in a particular strong named code assembly.</para>
@@ -120,6 +122,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Security.Permissions.StrongNameIdentityPermission" /> that corresponds to the current <see cref="T:System.Security.Policy.StrongName" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Permissions.StrongNameIdentityPermission" /> for the specified <see cref="T:System.Security.Policy.StrongName" />.</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Policy.Evidence" /> from which to construct the <see cref="T:System.Security.Permissions.StrongNameIdentityPermission" />. </param>
       </Docs>
@@ -140,12 +146,15 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified strong name is equal to the current strong name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified strong name is equal to the current strong name; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The strong name to compare against the current strong name. </param>
       </Docs>
@@ -164,12 +173,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash code of the current <see cref="T:System.Security.Policy.StrongName" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code of the current <see cref="T:System.Security.Policy.StrongName" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Name">
@@ -304,7 +316,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is useful during debugging to get an easy-to-read representation of the object.</para>
@@ -313,6 +324,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a string representation of the current <see cref="T:System.Security.Policy.StrongName" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A representation of the current <see cref="T:System.Security.Policy.StrongName" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Version">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/StrongNameMembershipCondition.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/StrongNameMembershipCondition.xml
index 3b72a61f6db..dcb1505b0db 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/StrongNameMembershipCondition.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/StrongNameMembershipCondition.xml
@@ -86,7 +86,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This membership condition tests only the <see cref="T:System.Security.Policy.StrongName" /> evidence object.</para>
@@ -96,6 +95,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified evidence satisfies the membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified evidence satisfies the membership condition; otherwise, false.</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Policy.Evidence" /> against which to make the test. </param>
       </Docs>
@@ -114,12 +117,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IMembershipCondition'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an equivalent copy of the current <see cref="T:System.Security.Policy.StrongNameMembershipCondition" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new, identical copy of the current <see cref="T:System.Security.Policy.StrongNameMembershipCondition" /> </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Equals">
@@ -138,7 +144,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For two <see cref="T:System.Security.Policy.StrongName" /> classes to be equal, their name, version, and public key blob must match exactly.</para>
@@ -147,6 +152,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Security.Policy.StrongName" /> from the specified object is equivalent to the <see cref="T:System.Security.Policy.StrongName" /> contained in the current <see cref="T:System.Security.Policy.StrongNameMembershipCondition" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Security.Policy.StrongName" /> from the specified object is equivalent to the <see cref="T:System.Security.Policy.StrongName" /> contained in the current <see cref="T:System.Security.Policy.StrongNameMembershipCondition" />; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to the current <see cref="T:System.Security.Policy.StrongNameMembershipCondition" />. </param>
       </Docs>
@@ -218,12 +227,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for the current <see cref="T:System.Security.Policy.StrongNameMembershipCondition" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the current <see cref="T:System.Security.Policy.StrongNameMembershipCondition" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Name">
@@ -289,12 +301,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a string representation of the current <see cref="T:System.Security.Policy.StrongNameMembershipCondition" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A representation of the current <see cref="T:System.Security.Policy.StrongNameMembershipCondition" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToXml">
@@ -311,12 +326,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Security.SecurityElement'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the security object and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the security object, including any state information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToXml">
@@ -335,12 +353,15 @@
         <Parameter Name="level" Type="System.Security.Policy.PolicyLevel" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Security.SecurityElement'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the security object and its current state with the specified <see cref="T:System.Security.Policy.PolicyLevel" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the security object, including any state information.</para>
+        </returns>
         <param name="level">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Policy.PolicyLevel" /> context, which is used to resolve <see cref="T:System.Security.NamedPermissionSet" /> references. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/UnionCodeGroup.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/UnionCodeGroup.xml
index 04f2d6113d5..a3182ff6b27 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/UnionCodeGroup.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/UnionCodeGroup.xml
@@ -77,7 +77,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method makes a deep copy of the code group, so that copies of all objects the code group contains are also made.</para>
@@ -86,6 +85,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Makes a deep copy of the current code group.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An equivalent copy of the current code group, including its membership conditions and child code groups.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MergeLogic">
@@ -125,7 +128,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Given evidence for an assembly to be loaded, this method evaluates the code group by first checking the membership condition against the specified evidence. If there is a match, this method returns a policy statement for the code group, including evaluation of child code groups.</para>
@@ -137,6 +139,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resolves policy for the code group and its descendants for a set of evidence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A policy statement consisting of the permissions granted by the code group with optional attributes, or null if the code group does not apply (the membership condition does not match the specified evidence).</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The evidence for the assembly. </param>
       </Docs>
@@ -157,7 +163,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Given evidence for an assembly to be loaded, this method evaluates the code group by first checking the membership condition against the specified evidence. If there is a match, this method returns a root code group. The code group that is returned may contain child code groups, which, in turn, may also contain child code groups, so the return value reflects the complete set of code groups that were matched by the evidence provided.</para>
@@ -166,6 +171,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Resolves matching code groups.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The complete set of code groups that were matched by the evidence.</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The evidence for the assembly. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/Url.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/Url.xml
index ae3eabe20d4..406e7c20fa6 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/Url.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/Url.xml
@@ -76,12 +76,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new copy of the evidence object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new, identical copy of the evidence object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateIdentityPermission">
@@ -100,12 +103,15 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Security.IPermission'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an identity permission corresponding to the current instance of the <see cref="T:System.Security.Policy.Url" /> evidence class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Permissions.UrlIdentityPermission" /> for the specified <see cref="T:System.Security.Policy.Url" /> evidence.</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The evidence set from which to construct the identity permission. </param>
       </Docs>
@@ -126,12 +132,15 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current <see cref="T:System.Security.Policy.Url" /> evidence object to the specified object for equivalence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two <see cref="T:System.Security.Policy.Url" /> objects are equal; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Policy.Url" /> evidence object to test for equivalence with the current object. </param>
       </Docs>
@@ -150,12 +159,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash code of the current URL.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code of the current URL.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.Security.Policy.IBuiltInEvidence.GetRequiredSize">
@@ -244,12 +256,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of the current <see cref="T:System.Security.Policy.Url" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A representation of the current <see cref="T:System.Security.Policy.Url" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/UrlMembershipCondition.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/UrlMembershipCondition.xml
index 5a61777952d..dd595dd7ef1 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/UrlMembershipCondition.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/UrlMembershipCondition.xml
@@ -81,7 +81,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This membership condition tests only the <see cref="T:System.Security.Policy.Url" /> evidence object.</para>
@@ -90,6 +89,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified evidence satisfies the membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified evidence satisfies the membership condition; otherwise, false.</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The evidence set against which to make the test. </param>
       </Docs>
@@ -108,12 +111,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IMembershipCondition'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an equivalent copy of the membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new, identical copy of the current membership condition.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Equals">
@@ -132,12 +138,15 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the URL from the specified object is equivalent to the URL contained in the current <see cref="T:System.Security.Policy.UrlMembershipCondition" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the URL from the specified object is equivalent to the URL contained in the current <see cref="T:System.Security.Policy.UrlMembershipCondition" />; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to the current <see cref="T:System.Security.Policy.UrlMembershipCondition" />. </param>
       </Docs>
@@ -209,12 +218,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash code for the current membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the current membership condition.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -231,12 +243,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a string representation of the membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the state of the membership condition.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToXml">
@@ -253,12 +268,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Security.SecurityElement'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the security object and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the security object, including any state information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToXml">
@@ -277,12 +295,15 @@
         <Parameter Name="level" Type="System.Security.Policy.PolicyLevel" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Security.SecurityElement'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the security object and its current state with the specified <see cref="T:System.Security.Policy.PolicyLevel" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the security object, including any state information.</para>
+        </returns>
         <param name="level">
           <attribution license="cc4" from="Microsoft" modified="false" />The policy level context for resolving named permission set references. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/Zone.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/Zone.xml
index 9b75a1f53b7..628b1eefe28 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/Zone.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/Zone.xml
@@ -75,12 +75,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an equivalent copy of the evidence object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new, identical copy of the evidence object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateFromUrl">
@@ -99,7 +102,6 @@
         <Parameter Name="url" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Zone'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The zone determination for the specified URL is based on the zone mapping settings in Microsoft Internet Explorer and can therefore differ from computer to computer. The zone mapping settings are located on the Security tab of the Internet Options dialog launched from the Tools menu.</para>
@@ -108,6 +110,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new zone with the specified URL.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new zone with the specified URL.</para>
+        </returns>
         <param name="url">
           <attribution license="cc4" from="Microsoft" modified="false" />The URL from which to create the zone. </param>
       </Docs>
@@ -128,12 +134,15 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Security.IPermission'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an identity permission that corresponds to the current instance of the <see cref="T:System.Security.Policy.Zone" /> evidence class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Permissions.ZoneIdentityPermission" /> for the specified <see cref="T:System.Security.Policy.Zone" /> evidence.</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The evidence set from which to construct the identity permission. </param>
       </Docs>
@@ -154,7 +163,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -164,6 +172,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current <see cref="T:System.Security.Policy.Zone" /> evidence object to the specified object for equivalence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two <see cref="T:System.Security.Policy.Zone" /> objects are equal; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Policy.Zone" /> evidence object to test for equivalence with the current object. </param>
       </Docs>
@@ -182,12 +194,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash code of the current zone.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code of the current zone.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SecurityZone">
@@ -297,12 +312,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of the current <see cref="T:System.Security.Policy.Zone" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A representation of the current <see cref="T:System.Security.Policy.Zone" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Policy/ZoneMembershipCondition.xml b/mcs/class/corlib/Documentation/en/System.Security.Policy/ZoneMembershipCondition.xml
index ea8951a0bb5..3061256a8d1 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Policy/ZoneMembershipCondition.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Policy/ZoneMembershipCondition.xml
@@ -73,7 +73,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This membership condition tests only the <see cref="T:System.Security.Policy.Zone" /> evidence object.</para>
@@ -82,6 +81,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified evidence satisfies the membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified evidence satisfies the membership condition; otherwise, false.</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The evidence set against which to make the test. </param>
       </Docs>
@@ -100,12 +103,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'IMembershipCondition'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an equivalent copy of the membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new, identical copy of the current membership condition.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Equals">
@@ -124,12 +130,15 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the zone from the specified object is equivalent to the zone contained in the current <see cref="T:System.Security.Policy.ZoneMembershipCondition" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the zone from the specified object is equivalent to the zone contained in the current <see cref="T:System.Security.Policy.ZoneMembershipCondition" />; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to the current <see cref="T:System.Security.Policy.ZoneMembershipCondition" />. </param>
       </Docs>
@@ -201,12 +210,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash code for the current membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the current membership condition.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SecurityZone">
@@ -247,12 +259,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a string representation of the membership condition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the state of the membership condition.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToXml">
@@ -269,12 +284,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Security.SecurityElement'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the security object and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the security object, including any state information.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToXml">
@@ -293,12 +311,15 @@
         <Parameter Name="level" Type="System.Security.Policy.PolicyLevel" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Security.SecurityElement'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the security object and its current state with the specified <see cref="T:System.Security.Policy.PolicyLevel" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the security object, including any state information.</para>
+        </returns>
         <param name="level">
           <attribution license="cc4" from="Microsoft" modified="false" />The policy level context for resolving named permission set references. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Principal/GenericPrincipal.xml b/mcs/class/corlib/Documentation/en/System.Security.Principal/GenericPrincipal.xml
index 3ad9d7d3b95..014677ee59d 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Principal/GenericPrincipal.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Principal/GenericPrincipal.xml
@@ -97,12 +97,15 @@
         <Parameter Name="role" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>True if the identity is part of the specified role, false otherwise.</returns>
         <remarks>Roles are case sensitive.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current <see cref="T:System.Security.Principal.GenericPrincipal" /> belongs to the specified role.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current <see cref="T:System.Security.Principal.GenericPrincipal" /> is a member of the specified role; otherwise, false.</para>
+        </returns>
         <param name="role">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the role for which to check membership. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Principal/IPrincipal.xml b/mcs/class/corlib/Documentation/en/System.Security.Principal/IPrincipal.xml
index badf6bb185e..f7ffd0e5898 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Principal/IPrincipal.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Principal/IPrincipal.xml
@@ -65,12 +65,15 @@
         <Parameter Name="role" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>True if the current identity is a member of the specified role, false otherwise.</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current principal belongs to the specified role.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current principal is a member of the specified role; otherwise, false.</para>
+        </returns>
         <param name="role">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the role for which to check membership. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Principal/IdentityReference.xml b/mcs/class/corlib/Documentation/en/System.Security.Principal/IdentityReference.xml
index 7ba49e351b3..7c1ea6c7c27 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Principal/IdentityReference.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Principal/IdentityReference.xml
@@ -40,13 +40,16 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the specified object equals this instance of the <see cref="T:System.Security.Principal.IdentityReference" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="o" /> is an object with the same underlying type and value as this <see cref="T:System.Security.Principal.IdentityReference" /> instance; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this <see cref="T:System.Security.Principal.IdentityReference" /> instance, or a null reference.</param>
       </Docs>
@@ -64,13 +67,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for <see cref="T:System.Security.Principal.IdentityReference" />. <see cref="M:System.Security.Principal.IdentityReference.GetHashCode" /> is suitable for use in hashing algorithms and data structures like a hash table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for this <see cref="T:System.Security.Principal.IdentityReference" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsValidTargetType">
@@ -88,13 +94,16 @@
         <Parameter Name="targetType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the specified type is a valid translation type for the <see cref="T:System.Security.Principal.IdentityReference" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="targetType" /> is a valid translation type for the <see cref="T:System.Security.Principal.IdentityReference" /> class; otherwise, false.</para>
+        </returns>
         <param name="targetType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type being queried for validity to serve as a conversion from <see cref="T:System.Security.Principal.IdentityReference" />. The following target types are valid:</param>
       </Docs>
@@ -115,13 +124,16 @@
         <Parameter Name="right" Type="System.Security.Principal.IdentityReference" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Security.Principal.IdentityReference" /> objects to determine whether they are equal. They are considered equal if they have the same canonical name representation as the one returned by the <see cref="P:System.Security.Principal.IdentityReference.Value" /> property or if they are both null.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> and <paramref name="right" /> are equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The left <see cref="T:System.Security.Principal.IdentityReference" /> operand to use for the equality comparison. This parameter can be null.</param>
         <param name="right">
@@ -144,13 +156,16 @@
         <Parameter Name="right" Type="System.Security.Principal.IdentityReference" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Security.Principal.IdentityReference" /> objects to determine whether they are not equal. They are considered not equal if they have different canonical name representations than the one returned by the <see cref="P:System.Security.Principal.IdentityReference.Value" /> property or if one of the objects is null and the other is not.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> and <paramref name="right" /> are not equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The left <see cref="T:System.Security.Principal.IdentityReference" /> operand to use for the inequality comparison. This parameter can be null.</param>
         <param name="right">
@@ -170,13 +185,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the string representation of the identity represented by the <see cref="T:System.Security.Principal.IdentityReference" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The identity in string format.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Translate">
@@ -194,13 +212,16 @@
         <Parameter Name="targetType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Translates the account name represented by the <see cref="T:System.Security.Principal.IdentityReference" /> object into another <see cref="T:System.Security.Principal.IdentityReference" />-derived type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted identity.</para>
+        </returns>
         <param name="targetType">
           <attribution license="cc4" from="Microsoft" modified="false" />The target type for the conversion from <see cref="T:System.Security.Principal.IdentityReference" />. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Principal/IdentityReferenceCollection.xml b/mcs/class/corlib/Documentation/en/System.Security.Principal/IdentityReferenceCollection.xml
index 8ecfcb7b36e..dbf249daf6d 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Principal/IdentityReferenceCollection.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Principal/IdentityReferenceCollection.xml
@@ -133,13 +133,16 @@
         <Parameter Name="identity" Type="System.Security.Principal.IdentityReference" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the <see cref="T:System.Security.Principal.IdentityReferenceCollection" /> collection contains the specified <see cref="T:System.Security.Principal.IdentityReference" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the collection contains the specified object.</para>
+        </returns>
         <param name="identity">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Principal.IdentityReference" /> object to check for.</param>
       </Docs>
@@ -206,13 +209,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an enumerator that can be used to iterate through the <see cref="T:System.Security.Principal.IdentityReferenceCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator for the <see cref="T:System.Security.Principal.IdentityReferenceCollection" /> collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsReadOnly">
@@ -273,13 +279,16 @@
         <Parameter Name="identity" Type="System.Security.Principal.IdentityReference" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the specified <see cref="T:System.Security.Principal.IdentityReference" /> object from the collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified object was removed from the collection.</para>
+        </returns>
         <param name="identity">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.Principal.IdentityReference" /> object to remove.</param>
       </Docs>
@@ -297,13 +306,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an enumerator that can be used to iterate through the <see cref="T:System.Security.Principal.IdentityReferenceCollection" /> collection.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator for the <see cref="T:System.Security.Principal.IdentityReferenceCollection" /> collection.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Translate">
@@ -321,7 +333,6 @@
         <Parameter Name="targetType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -332,6 +343,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the objects in the collection to the specified type. Calling this method is the same as calling <see cref="M:System.Security.Principal.IdentityReferenceCollection.Translate(System.Type,System.Boolean)" /> with the second parameter set to false, which means that exceptions will not be thrown for items that fail conversion.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Principal.IdentityReferenceCollection" /> collection that represents the converted contents of the original collection.</para>
+        </returns>
         <param name="targetType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to which items in the collection are being converted.</param>
       </Docs>
@@ -352,7 +367,6 @@
         <Parameter Name="forceSuccess" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -363,6 +377,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the objects in the collection to the specified type and uses the specified fault tolerance to handle or ignore errors associated with a type not having a conversion mapping.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.Principal.IdentityReferenceCollection" /> collection that represents the converted contents of the original collection.</para>
+        </returns>
         <param name="targetType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to which items in the collection are being converted.</param>
         <param name="forceSuccess">
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Principal/NTAccount.xml b/mcs/class/corlib/Documentation/en/System.Security.Principal/NTAccount.xml
index f7705e12fbd..49aa146ff29 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Principal/NTAccount.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Principal/NTAccount.xml
@@ -93,13 +93,16 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether this <see cref="T:System.Security.Principal.NTAccount" /> object is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="o" /> is an object with the same underlying type and value as this <see cref="T:System.Security.Principal.NTAccount" /> object; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this <see cref="T:System.Security.Principal.NTAccount" /> object, or null.</param>
       </Docs>
@@ -117,13 +120,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for the current <see cref="T:System.Security.Principal.NTAccount" /> object. The <see cref="M:System.Security.Principal.NTAccount.GetHashCode" /> method is suitable for hashing algorithms and data structures like a hash table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash value for the current <see cref="T:System.Security.Principal.NTAccount" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsValidTargetType">
@@ -141,13 +147,16 @@
         <Parameter Name="targetType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the specified type is a valid translation type for the <see cref="T:System.Security.Principal.NTAccount" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="targetType" /> is a valid translation type for the <see cref="T:System.Security.Principal.NTAccount" /> class; otherwise false.</para>
+        </returns>
         <param name="targetType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type being queried for validity to serve as a conversion from <see cref="T:System.Security.Principal.NTAccount" />. The following target types are valid:</param>
       </Docs>
@@ -168,13 +177,16 @@
         <Parameter Name="right" Type="System.Security.Principal.NTAccount" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Security.Principal.NTAccount" /> objects to determine whether they are equal. They are considered equal if they have the same canonical name representation as the one returned by the <see cref="P:System.Security.Principal.NTAccount.Value" /> property or if they are both null. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> and <paramref name="right" /> are equal; otherwise false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The left operand to use for the equality comparison. This parameter can be null.</param>
         <param name="right">
@@ -197,13 +209,16 @@
         <Parameter Name="right" Type="System.Security.Principal.NTAccount" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Security.Principal.NTAccount" /> objects to determine whether they are not equal. They are considered not equal if they have different canonical name representations than the one returned by the <see cref="P:System.Security.Principal.NTAccount.Value" /> property or if one of the objects is null and the other is not.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> and <paramref name="right" /> are not equal; otherwise false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The left operand to use for the inequality comparison. This parameter can be null.</param>
         <param name="right">
@@ -223,13 +238,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the account name, in Domain<system>\</system>Account format, for the account represented by the <see cref="T:System.Security.Principal.NTAccount" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The account name, in Domain<system>\</system>Account format.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Translate">
@@ -247,13 +265,16 @@
         <Parameter Name="targetType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Translates the account name represented by the <see cref="T:System.Security.Principal.NTAccount" /> object into another <see cref="T:System.Security.Principal.IdentityReference" />-derived type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted identity.</para>
+        </returns>
         <param name="targetType">
           <attribution license="cc4" from="Microsoft" modified="false" />The target type for the conversion from <see cref="T:System.Security.Principal.NTAccount" />. The target type must be a type that is considered valid by the <see cref="M:System.Security.Principal.NTAccount.IsValidTargetType(System.Type)" /> method. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Principal/SecurityIdentifier.xml b/mcs/class/corlib/Documentation/en/System.Security.Principal/SecurityIdentifier.xml
index bc75da340a6..46ec264401b 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Principal/SecurityIdentifier.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Principal/SecurityIdentifier.xml
@@ -180,13 +180,52 @@
         <Parameter Name="sid" Type="System.Security.Principal.SecurityIdentifier" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current <see cref="T:System.Security.Principal.SecurityIdentifier" /> object with the specified <see cref="T:System.Security.Principal.SecurityIdentifier" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number indicating the relative values of this instance and <paramref name="sid" />.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than <paramref name="sid" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is equal to <paramref name="sid" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than <paramref name="sid" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="sid">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current object.</param>
       </Docs>
@@ -206,13 +245,16 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether this <see cref="T:System.Security.Principal.SecurityIdentifier" /> object is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="o" /> is an object with the same underlying type and value as this <see cref="T:System.Security.Principal.SecurityIdentifier" /> object; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this <see cref="T:System.Security.Principal.SecurityIdentifier" /> object, or null.</param>
       </Docs>
@@ -232,13 +274,16 @@
         <Parameter Name="sid" Type="System.Security.Principal.SecurityIdentifier" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified <see cref="T:System.Security.Principal.SecurityIdentifier" /> object is equal to the current <see cref="T:System.Security.Principal.SecurityIdentifier" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of <paramref name="sid" /> is equal to the value of the current <see cref="T:System.Security.Principal.SecurityIdentifier" /> object.</para>
+        </returns>
         <param name="sid">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current object.</param>
       </Docs>
@@ -284,13 +329,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for the current <see cref="T:System.Security.Principal.SecurityIdentifier" /> object. The <see cref="M:System.Security.Principal.SecurityIdentifier.GetHashCode" /> method is suitable for hashing algorithms and data structures like a hash table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash value for the current <see cref="T:System.Security.Principal.SecurityIdentifier" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsAccountSid">
@@ -306,13 +354,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the security identifier (SID) represented by this <see cref="T:System.Security.Principal.SecurityIdentifier" /> object is a valid Windows account SID.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the SID represented by this <see cref="T:System.Security.Principal.SecurityIdentifier" /> object is a valid Windows account SID; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsEqualDomainSid">
@@ -330,13 +381,16 @@
         <Parameter Name="sid" Type="System.Security.Principal.SecurityIdentifier" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the security identifier (SID) represented by this <see cref="T:System.Security.Principal.SecurityIdentifier" /> object is from the same domain as the specified SID.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the SID represented by this <see cref="T:System.Security.Principal.SecurityIdentifier" /> object is in the same domain as the <paramref name="sid" /> SID; otherwise, false.</para>
+        </returns>
         <param name="sid">
           <attribution license="cc4" from="Microsoft" modified="false" />The SID to compare with this <see cref="T:System.Security.Principal.SecurityIdentifier" /> object.</param>
       </Docs>
@@ -356,13 +410,16 @@
         <Parameter Name="targetType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the specified type is a valid translation type for the <see cref="T:System.Security.Principal.SecurityIdentifier" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="targetType" /> is a valid translation type for the <see cref="T:System.Security.Principal.SecurityIdentifier" /> class; otherwise, false.</para>
+        </returns>
         <param name="targetType">
           <attribution license="cc4" from="Microsoft" modified="false" />The type being queried for validity to serve as a conversion from <see cref="T:System.Security.Principal.SecurityIdentifier" />. The following target types are valid:</param>
       </Docs>
@@ -382,13 +439,16 @@
         <Parameter Name="type" Type="System.Security.Principal.WellKnownSidType" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the <see cref="T:System.Security.Principal.SecurityIdentifier" /> object matches the specified well known security identifier (SID) type. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="type" /> is the SID type for the <see cref="T:System.Security.Principal.SecurityIdentifier" /> object; otherwise, false.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />A value to compare with the <see cref="T:System.Security.Principal.SecurityIdentifier" /> object.</param>
       </Docs>
@@ -451,13 +511,16 @@
         <Parameter Name="right" Type="System.Security.Principal.SecurityIdentifier" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Security.Principal.SecurityIdentifier" /> objects to determine whether they are equal. They are considered equal if they have the same canonical representation as the one returned by the <see cref="P:System.Security.Principal.SecurityIdentifier.Value" /> property or if they are both null. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> and <paramref name="right" /> are equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The left operand to use for the equality comparison. This parameter can be null.</param>
         <param name="right">
@@ -480,13 +543,16 @@
         <Parameter Name="right" Type="System.Security.Principal.SecurityIdentifier" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Security.Principal.SecurityIdentifier" /> objects to determine whether they are not equal. They are considered not equal if they have different canonical name representations than the one returned by the <see cref="P:System.Security.Principal.SecurityIdentifier.Value" /> property or if one of the objects is null and the other is not.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> and <paramref name="right" /> are not equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The left operand to use for the inequality comparison. This parameter can be null.</param>
         <param name="right">
@@ -506,13 +572,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the security identifier (SID), in Security Descriptor Definition Language (SDDL) format, for the account represented by the <see cref="T:System.Security.Principal.SecurityIdentifier" /> object. An example of the SDDL format is S-1-5-9. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The SID, in SDDL format, for the account represented by the <see cref="T:System.Security.Principal.SecurityIdentifier" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Translate">
@@ -530,13 +599,16 @@
         <Parameter Name="targetType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Translates the account name represented by the <see cref="T:System.Security.Principal.SecurityIdentifier" /> object into another <see cref="T:System.Security.Principal.IdentityReference" />-derived type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted identity.</para>
+        </returns>
         <param name="targetType">
           <attribution license="cc4" from="Microsoft" modified="false" />The target type for the conversion from <see cref="T:System.Security.Principal.SecurityIdentifier" />. The target type must be a type that is considered valid by the <see cref="M:System.Security.Principal.SecurityIdentifier.IsValidTargetType(System.Type)" /> method.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Principal/WindowsIdentity.xml b/mcs/class/corlib/Documentation/en/System.Security.Principal/WindowsIdentity.xml
index ba07d4fcefb..18e8483ad61 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Principal/WindowsIdentity.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Principal/WindowsIdentity.xml
@@ -476,7 +476,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'WindowsIdentity'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This property returns an empty <see cref="T:System.Security.Principal.WindowsIdentity" /> object that enables you to treat operations as anonymous. The property value does not correspond to a Windows anonymous user and cannot be used for impersonation. Also, note that the identity returned by this property is not static; each call to <see cref="M:System.Security.Principal.WindowsIdentity.GetAnonymous" /> returns a different anonymous identity.</para>
@@ -486,6 +485,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Security.Principal.WindowsIdentity" /> object that you can use as a sentinel value in your code to represent an anonymous user. The property value does not represent the built-in anonymous identity used by the Windows operating system.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents an anonymous user.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetCurrent">
@@ -502,7 +505,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>a WindowsIdentity instance representing the current user.</returns>
         <remarks>
           <example>
             <code lang="C#">
@@ -516,6 +518,10 @@ Console.WriteLine ("\tToken:\t\t{0}", wi.Token);
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Security.Principal.WindowsIdentity" /> object that represents the current Windows user.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the current user.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetCurrent">
@@ -533,7 +539,6 @@ Console.WriteLine ("\tToken:\t\t{0}", wi.Token);
         <Parameter Name="ifImpersonating" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -543,6 +548,10 @@ Console.WriteLine ("\tToken:\t\t{0}", wi.Token);
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Security.Principal.WindowsIdentity" /> object that represents the Windows identity for either the thread or the process, depending on the value of the <paramref name="ifImpersonating" /> parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents a Windows user.</para>
+        </returns>
         <param name="ifImpersonating">
           <attribution license="cc4" from="Microsoft" modified="false" />true to return the <see cref="T:System.Security.Principal.WindowsIdentity" /> only if the thread is currently impersonating; false to return the <see cref="T:System.Security.Principal.WindowsIdentity" />   of the thread if it is impersonating or the <see cref="T:System.Security.Principal.WindowsIdentity" /> of the process if the thread is not currently impersonating.</param>
       </Docs>
@@ -562,7 +571,6 @@ Console.WriteLine ("\tToken:\t\t{0}", wi.Token);
         <Parameter Name="desiredAccess" Type="System.Security.Principal.TokenAccessLevels" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -572,6 +580,10 @@ Console.WriteLine ("\tToken:\t\t{0}", wi.Token);
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Security.Principal.WindowsIdentity" /> object that represents the current Windows user, using the specified desired token access level.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the current user.</para>
+        </returns>
         <param name="desiredAccess">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitwise combination of the enumeration values. </param>
       </Docs>
@@ -611,7 +623,6 @@ Console.WriteLine ("\tToken:\t\t{0}", wi.Token);
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'WindowsImpersonationContext'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>On Windows NT platforms, the current user must have sufficient rights to allow impersonation.</para>
@@ -620,6 +631,10 @@ Console.WriteLine ("\tToken:\t\t{0}", wi.Token);
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Impersonates the user represented by the <see cref="T:System.Security.Principal.WindowsIdentity" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the Windows user prior to impersonation; this can be used to revert to the original user's context.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Impersonate">
@@ -638,7 +653,6 @@ Console.WriteLine ("\tToken:\t\t{0}", wi.Token);
         <Parameter Name="userToken" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'WindowsImpersonationContext'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>On Windows NT platforms, the current user must have sufficient rights to allow impersonation.</para>
@@ -651,6 +665,10 @@ Console.WriteLine ("\tToken:\t\t{0}", wi.Token);
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Impersonates the user represented by the specified user token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the Windows user prior to impersonation; this object can be used to revert to the original user's context.</para>
+        </returns>
         <param name="userToken">
           <attribution license="cc4" from="Microsoft" modified="false" />The handle of a Windows account token. This token is usually retrieved through a call to unmanaged code, such as a call to the Win32 API LogonUser function. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security.Principal/WindowsPrincipal.xml b/mcs/class/corlib/Documentation/en/System.Security.Principal/WindowsPrincipal.xml
index 66db88b966c..58e2fd213f5 100644
--- a/mcs/class/corlib/Documentation/en/System.Security.Principal/WindowsPrincipal.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security.Principal/WindowsPrincipal.xml
@@ -94,7 +94,6 @@
         <Parameter Name="rid" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>True if the current identity is a member of the specified role, false otherwise.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When testing for newly created role information, such as a new user or a new group, it is important to log out and log in to force the propagation of role information within the domain. Not doing so can cause the <see cref="Overload:System.Security.Principal.WindowsPrincipal.IsInRole" /> test to return false. This method is not supported on Windows 98 or Windows Millennium Edition.</para>
@@ -250,6 +249,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current principal belongs to the Windows user group with the specified relative identifier (RID).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current principal is a member of the specified Windows user group, that is, in a particular role; otherwise, false.</para>
+        </returns>
         <param name="rid">
           <attribution license="cc4" from="Microsoft" modified="false" />The RID of the Windows user group in which to check for the principal’s membership status. </param>
       </Docs>
@@ -274,7 +277,6 @@
         <Parameter Name="sid" Type="System.Security.Principal.SecurityIdentifier" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -288,6 +290,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current principal belongs to the Windows user group with the specified security identifier (SID).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current principal is a member of the specified Windows user group; otherwise, false.</para>
+        </returns>
         <param name="sid">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Security.Principal.SecurityIdentifier" />  that uniquely identifies a Windows user group.</param>
       </Docs>
@@ -308,7 +314,6 @@
         <Parameter Name="role" Type="System.Security.Principal.WindowsBuiltInRole" />
       </Parameters>
       <Docs>
-        <returns>True if the current identity is a member of the specified role, false otherwise.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When testing for newly created role information, such as a new user or a new group, it is important to log out and log in to force the propagation of role information within the domain. Not doing so can cause the <see cref="Overload:System.Security.Principal.WindowsPrincipal.IsInRole" /> test to return false. This method is not supported on Windows 98 or Windows Millennium Edition.</para>
@@ -321,6 +326,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current principal belongs to the Windows user group with the specified <see cref="T:System.Security.Principal.WindowsBuiltInRole" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current principal is a member of the specified Windows user group; otherwise, false.</para>
+        </returns>
         <param name="role">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Security.Principal.WindowsBuiltInRole" /> values. </param>
       </Docs>
@@ -341,7 +350,6 @@
         <Parameter Name="role" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>True if the current identity is a member of the specified role, false otherwise.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When testing for newly created role information, such as a new user or a new group, it is important to log out and log in to force the propagation of role information within the domain. Not doing so can cause the <see cref="Overload:System.Security.Principal.WindowsPrincipal.IsInRole" /> test to return false. This method is not supported on Windows 98 or Windows Millennium Edition.</para>
@@ -412,6 +420,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current principal belongs to the Windows user group with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current principal is a member of the specified Windows user group; otherwise, false.</para>
+        </returns>
         <param name="role">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the Windows user group for which to check membership. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security/CodeAccessPermission.xml b/mcs/class/corlib/Documentation/en/System.Security/CodeAccessPermission.xml
index a14d5317e8f..2352decb388 100644
--- a/mcs/class/corlib/Documentation/en/System.Security/CodeAccessPermission.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security/CodeAccessPermission.xml
@@ -115,10 +115,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A new <see cref="T:System.Security.CodeAccessPermission" /> instance that is value
- equal to the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A copy of a permission object represents the same access to resources as the original permission object.</para>
@@ -127,6 +123,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented by a derived class, creates and returns an identical copy of the current permission object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current permission object.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -214,7 +214,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -224,6 +223,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Security.CodeAccessPermission" /> object is equal to the current <see cref="T:System.Security.CodeAccessPermission" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Security.CodeAccessPermission" /> object is equal to the current <see cref="T:System.Security.CodeAccessPermission" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.CodeAccessPermission" /> object to compare with the current <see cref="T:System.Security.CodeAccessPermission" />. </param>
       </Docs>
@@ -282,7 +285,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -292,6 +294,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a hash code for the <see cref="T:System.Security.CodeAccessPermission" /> object that is suitable for use in hashing algorithms and data structures such as a hash table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.Security.CodeAccessPermission" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Intersect">
@@ -311,12 +317,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A new <see cref="T:System.Security.CodeAccessPermission" /> instance
- that represents the intersection of the current instance and
-<paramref name="target" /> . If the intersection is empty or 
-<paramref name="target" /> is <see langword="null" />, returns <see langword="null" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="target" /> is not <see langword="null" /> and is not a <see cref="T:System.Security.CodeAccessPermission" /> object.</exception>
         <remarks>
@@ -327,6 +327,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented by a derived class, creates and returns a permission that is the intersection of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the intersection of the current permission and the specified permission. This new permission is null if the intersection is empty.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to intersect with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
@@ -349,15 +353,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the current instance is a
-   subset of <paramref name="target" />; otherwise, <see langword="false" />. If the current
-   instance is unrestricted, and <paramref name="target" /> is not, returns
-<see langword="false" />. If <paramref name="target" /> is unrestricted, returns 
-<see langword="true" /> .</para>
-          <see langword="" />
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="target" /> is not <see langword="null" /> and is not of type <see cref="T:System.Security.CodeAccessPermission" /> .</exception>
         <remarks>
@@ -390,6 +385,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When implemented by a derived class, determines whether the current permission is a subset of the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is a subset of the specified permission; otherwise, false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission that is to be tested for the subset relationship. This permission must be of the same type as the current permission. </param>
       </Docs>
@@ -537,10 +536,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.String" /> containing the XML 
- representation of the state of the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is useful in debugging when you need to display the permission as a string.</para>
@@ -549,6 +544,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a string representation of the current permission object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the current permission object.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -567,10 +566,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Security.SecurityElement" /> containing an XML encoding of the state of the
- current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Custom code that extends security objects needs to implement the <see cref="M:System.Security.CodeAccessPermission.ToXml" /> and <see cref="M:System.Security.CodeAccessPermission.FromXml(System.Security.SecurityElement)" /> methods to make the objects security-encodable.</para>
@@ -579,6 +574,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates an XML encoding of the security object and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the security object, including any state information.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -599,10 +598,6 @@
         <Parameter Name="other" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>If <paramref name="other" /> is <see langword="null" />, returns a copy of the current 
- instance using the <see cref="M:System.Security.IPermission.Copy" qualify="true" /> method.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="other" /> is not of type <see cref="T:System.Security.CodeAccessPermission" /> .</exception>
         <exception cref="T:System.NotSupportedException">
@@ -615,6 +610,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates a permission that is the union of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the union of the current permission and the specified permission.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to combine with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security/HostProtectionException.xml b/mcs/class/corlib/Documentation/en/System.Security/HostProtectionException.xml
index 7040175cdc0..466f8a950a0 100644
--- a/mcs/class/corlib/Documentation/en/System.Security/HostProtectionException.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security/HostProtectionException.xml
@@ -292,7 +292,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -302,6 +301,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of the current host protection exception.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the current <see cref="T:System.Security.HostProtectionException" />.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Security/HostSecurityManager.xml b/mcs/class/corlib/Documentation/en/System.Security/HostSecurityManager.xml
index 164a6c3928f..edd70566ae9 100644
--- a/mcs/class/corlib/Documentation/en/System.Security/HostSecurityManager.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security/HostSecurityManager.xml
@@ -63,7 +63,6 @@
         <Parameter Name="context" Type="System.Security.Policy.TrustManagerContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -74,6 +73,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether an application should be executed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that contains trust information about the application.</para>
+        </returns>
         <param name="applicationEvidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The evidence for the application to be activated.</param>
         <param name="activatorEvidence">
@@ -161,7 +164,6 @@
         <Parameter Name="inputEvidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -175,6 +177,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides the application domain evidence for an assembly being loaded.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The evidence to be used for the <see cref="T:System.AppDomain" />.</para>
+        </returns>
         <param name="inputEvidence">
           <attribution license="cc4" from="Microsoft" modified="false" />Additional evidence to add to the <see cref="T:System.AppDomain" /> evidence.</param>
       </Docs>
@@ -195,7 +201,6 @@
         <Parameter Name="inputEvidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -209,6 +214,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides the assembly evidence for an assembly being loaded.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The evidence to be used for the assembly.</para>
+        </returns>
         <param name="loadedAssembly">
           <attribution license="cc4" from="Microsoft" modified="false" />The loaded assembly. </param>
         <param name="inputEvidence">
@@ -230,7 +239,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -240,6 +248,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines what permissions to grant to code based on the specified evidence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The permission set that can be granted by the security system.</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The evidence set used to evaluate policy.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security/IPermission.xml b/mcs/class/corlib/Documentation/en/System.Security/IPermission.xml
index 40fba3d6066..577a7ee998b 100644
--- a/mcs/class/corlib/Documentation/en/System.Security/IPermission.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security/IPermission.xml
@@ -67,10 +67,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Security.IPermission" /> object of the same type and containing the same
- values as the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A copy of a permission represents the same access to resources as the original permission.</para>
@@ -79,6 +75,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an identical copy of the current permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current permission.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -130,12 +130,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A new <see cref="T:System.Security.IPermission" /> object that is the same type as
-   the current instance and represents the intersection of the
-   current instance and <paramref name="target" />. If the intersection is empty, or <paramref name="target" />
-   is <see langword="null" />, returns <see langword="null" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="target" /> is not <see langword="null" /> and is not of the same type as the current instance.</exception>
         <remarks>
@@ -161,6 +155,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a permission that is the intersection of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the intersection of the current permission and the specified permission. This new permission is null if the intersection is empty.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to intersect with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
@@ -183,18 +181,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the current instance is a subset of <paramref name="target" /> ;
-   otherwise,<see langword=" false" />. If the current instance is unrestricted, and
-<paramref name="target" /> is not, returns <see langword="false" />. If <paramref name="target" /> is 
-   unrestricted, returns <see langword="true" />. If target is
-<see langword="null" /> and the current instance does not secure any resources or 
-   operations, returns <see langword="true" />. If target is <see langword="null" />
-   and the current instance secures one or more resources or operations, returns
-<see langword="false" /> 
-.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="target" /> is not <see langword="null" /> and is not of the same type as the current instance. </exception>
         <remarks>
@@ -220,6 +206,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current permission is a subset of the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current permission is a subset of the specified permission; otherwise, false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission that is to be tested for the subset relationship. This permission must be of the same type as the current permission. </param>
       </Docs>
@@ -242,11 +232,6 @@
         <Parameter Name="target" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A new <see cref="T:System.Security.IPermission" /> object of the same type as the current
- instance that represents the
- union of the current instance and <paramref name="target" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="target" /> is not <see langword="null" /> and is not of the same type as the current instance. </exception>
         <remarks>
@@ -272,6 +257,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a permission that is the union of the current permission and the specified permission.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission that represents the union of the current permission and the specified permission.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission to combine with the current permission. It must be of the same type as the current permission. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security/ISecurityEncodable.xml b/mcs/class/corlib/Documentation/en/System.Security/ISecurityEncodable.xml
index 5700b9c02f4..284b42ac150 100644
--- a/mcs/class/corlib/Documentation/en/System.Security/ISecurityEncodable.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security/ISecurityEncodable.xml
@@ -72,7 +72,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'SecurityElement'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Custom code that extends security objects needs to implement the <see cref="M:System.Security.ISecurityEncodable.ToXml" /> and <see cref="M:System.Security.ISecurityEncodable.FromXml(System.Security.SecurityElement)" /> methods to make the objects security-encodable.</para>
@@ -81,6 +80,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the security object and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the security object, including any state information.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Security/ISecurityPolicyEncodable.xml b/mcs/class/corlib/Documentation/en/System.Security/ISecurityPolicyEncodable.xml
index 4fa1de62fbe..c0897f7bc97 100644
--- a/mcs/class/corlib/Documentation/en/System.Security/ISecurityPolicyEncodable.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security/ISecurityPolicyEncodable.xml
@@ -74,7 +74,6 @@
         <Parameter Name="level" Type="System.Security.Policy.PolicyLevel" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'SecurityElement'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The policy-level context is provided for resolution of named permission set references. For example, code groups use policy level to find named permission sets by name.</para>
@@ -84,6 +83,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the security object and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The root element of the XML representation of the policy object.</para>
+        </returns>
         <param name="level">
           <attribution license="cc4" from="Microsoft" modified="false" />The policy-level context to resolve named permission set references. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security/NamedPermissionSet.xml b/mcs/class/corlib/Documentation/en/System.Security/NamedPermissionSet.xml
index 0b68024fc2c..07c51069b60 100644
--- a/mcs/class/corlib/Documentation/en/System.Security/NamedPermissionSet.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security/NamedPermissionSet.xml
@@ -149,12 +149,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a permission set copy from a named permission set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A permission set that is a copy of the permissions in the named permission set.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Copy">
@@ -173,12 +176,15 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'NamedPermissionSet'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the named permission set with a different name but the same permissions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the named permission set with the new name.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name for the new named permission set. </param>
       </Docs>
@@ -227,7 +233,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -237,6 +242,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Security.NamedPermissionSet" /> object is equal to the current <see cref="T:System.Security.NamedPermissionSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Security.NamedPermissionSet" /> is equal to the current <see cref="T:System.Security.NamedPermissionSet" /> object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Security.NamedPermissionSet" /> object to compare with the current <see cref="T:System.Security.NamedPermissionSet" />. </param>
       </Docs>
@@ -287,7 +296,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -297,6 +305,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a hash code for the <see cref="T:System.Security.NamedPermissionSet" /> object that is suitable for use in hashing algorithms and data structures such as a hash table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.Security.NamedPermissionSet" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Name">
@@ -337,7 +349,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use <see cref="M:System.Security.NamedPermissionSet.FromXml(System.Security.SecurityElement)" /> to recreate the state represented by the returned element.</para>
@@ -346,6 +357,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML element description of the named permission set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XML representation of the named permission set.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Security/PermissionSet.xml b/mcs/class/corlib/Documentation/en/System.Security/PermissionSet.xml
index c23ac4f6883..4c5e005da4a 100644
--- a/mcs/class/corlib/Documentation/en/System.Security/PermissionSet.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security/PermissionSet.xml
@@ -126,12 +126,6 @@
         <Parameter Name="perm" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>If <paramref name="perm" /> is <see langword="null" />,
-   returns <see langword="null" /> . If a permission of the same type as
-<paramref name="perm" /> already exists in the current instance, the union of the existing 
-   permission and <paramref name="perm" /> is added to the current instance and is returned.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="perm" /> is not a <see cref="T:System.Security.IPermission" /> object.</exception>
         <remarks>
@@ -142,6 +136,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a specified permission to the <see cref="T:System.Security.PermissionSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The union of the permission added and any permission of the same type that already exists in the <see cref="T:System.Security.PermissionSet" />.</para>
+        </returns>
         <param name="perm">
           <attribution license="cc4" from="Microsoft" modified="false" />The permission to add. </param>
       </Docs>
@@ -196,12 +194,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the <see cref="T:System.Security.PermissionSet" /> contains permissions that are not derived from <see cref="T:System.Security.CodeAccessPermission" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Security.PermissionSet" /> contains permissions that are not derived from <see cref="T:System.Security.CodeAccessPermission" />; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ConvertPermissionSet">
@@ -222,7 +223,6 @@
         <Parameter Name="outFormat" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Do not use this method.</para>
@@ -231,6 +231,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an encoded <see cref="T:System.Security.PermissionSet" /> from one XML encoding format to another XML encoding format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An encrypted permission set with the specified output format.</para>
+        </returns>
         <param name="inFormat">
           <attribution license="cc4" from="Microsoft" modified="false" />A string representing one of the following encoding formats: ASCII, Unicode, or Binary. Possible values are "XMLASCII" or "XML", "XMLUNICODE", and "BINARY".</param>
         <param name="inData">
@@ -254,9 +258,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Security.PermissionSet" /> that is value equal to the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A copy of a <see cref="T:System.Security.PermissionSet" /> represents the same access to resources as the original object. Changes made to the copy do not affect the original permission set.</para>
@@ -265,6 +266,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the <see cref="T:System.Security.PermissionSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the <see cref="T:System.Security.PermissionSet" />.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -430,7 +435,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -441,6 +445,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Security.PermissionSet" /> or <see cref="T:System.Security.NamedPermissionSet" /> object is equal to the current <see cref="T:System.Security.PermissionSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified object is equal to the current <see cref="T:System.Security.PermissionSet" /> object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current <see cref="T:System.Security.PermissionSet" />. </param>
       </Docs>
@@ -515,11 +523,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Collections.IEnumerator" /> object
-   for the permissions of the
-   set.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the enumerator as an index to access individual permission objects in the set.</para>
@@ -528,6 +531,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator for the permissions of the set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator object for the permissions of the set.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -549,7 +556,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -559,6 +565,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a hash code for the <see cref="T:System.Security.PermissionSet" /> object that is suitable for use in hashing algorithms and data structures such as a hash table.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.Security.PermissionSet" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetPermission">
@@ -577,7 +587,6 @@
         <Parameter Name="permClass" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method returns null for an Unrestricted <see cref="T:System.Security.PermissionSet" />. Although an Unrestricted <see cref="T:System.Security.PermissionSet" /> effectively contains all permissions, it does not have any actual instances to return.</para>
@@ -586,6 +595,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a permission object of the specified type, if it exists in the set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the permission object of the type specified by the <paramref name="permClass" /> parameter contained in the <see cref="T:System.Security.PermissionSet" />, or null if none exists.</para>
+        </returns>
         <param name="permClass">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the desired permission object. </param>
       </Docs>
@@ -606,7 +619,6 @@
         <Parameter Name="other" Type="System.Security.PermissionSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The intersection of two permission sets is a permission set that describes the set of operations they both describe in common. Specifically, it represents the minimum permissions such that any demand that passes both permission sets also passes their intersection.</para>
@@ -616,6 +628,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a permission set that is the intersection of the current <see cref="T:System.Security.PermissionSet" /> and the specified <see cref="T:System.Security.PermissionSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission set that represents the intersection of the current <see cref="T:System.Security.PermissionSet" /> and the specified target. This object is null if the intersection is empty.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />A permission set to intersect with the current <see cref="T:System.Security.PermissionSet" />. </param>
       </Docs>
@@ -634,7 +650,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A <see cref="T:System.Security.PermissionSet" /> can be empty and yet contain instances of permissions if those permissions are in the fully-restricted state. Permissions are in a fully restricted state if their IsSubsetOf methods return true when null is passed as a parameter.</para>
@@ -643,6 +658,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the <see cref="T:System.Security.PermissionSet" /> is empty.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Security.PermissionSet" /> is empty; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsReadOnly">
@@ -686,11 +705,6 @@
         <Parameter Name="target" Type="System.Security.PermissionSet" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the current instance is a subset of <paramref name="target" />;
-   otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A <see cref="T:System.Security.PermissionSet" /> is a subset of the target <see cref="T:System.Security.PermissionSet" /> if all demands that succeed for the <see cref="T:System.Security.PermissionSet" /> also succeed for the target. That is, the target contains at least the permissions contained in the subset.</para>
@@ -699,6 +713,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current <see cref="T:System.Security.PermissionSet" /> is a subset of the specified <see cref="T:System.Security.PermissionSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current <see cref="T:System.Security.PermissionSet" /> is a subset of the <paramref name="target" /> parameter; otherwise, false.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The permission set to test for the subset relationship. This must be either a <see cref="T:System.Security.PermissionSet" /> or a <see cref="T:System.Security.NamedPermissionSet" />. </param>
       </Docs>
@@ -747,7 +765,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An Unrestricted <see cref="T:System.Security.PermissionSet" /> effectively contains all permissions that implement the <see cref="T:System.Security.Permissions.IUnrestrictedPermission" /> interface.</para>
@@ -756,6 +773,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the <see cref="T:System.Security.PermissionSet" /> is Unrestricted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Security.PermissionSet" /> is Unrestricted; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="PermitOnly">
@@ -806,7 +827,6 @@
         <Parameter Name="permClass" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -821,6 +841,10 @@ myPermSet.RemovePermission(typeof(FileIOPermission));</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes a permission of a certain type from the set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The permission removed from the set.</para>
+        </returns>
         <param name="permClass">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of permission to delete. </param>
       </Docs>
@@ -865,7 +889,6 @@ myPermSet.RemovePermission(typeof(FileIOPermission));</code>
         <Parameter Name="perm" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method removes any existing permission object of the same type from the <see cref="T:System.Security.PermissionSet" /> and replaces it with the <paramref name="perm" /> parameter. If a permission that implements <see cref="T:System.Security.Permissions.IUnrestrictedPermission" /> is set on a <see cref="T:System.Security.PermissionSet" /> that is <see cref="F:System.Security.Permissions.PermissionState.Unrestricted" />, the resulting <see cref="T:System.Security.PermissionSet" /> is no longer Unrestricted. </para>
@@ -874,6 +897,10 @@ myPermSet.RemovePermission(typeof(FileIOPermission));</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets a permission to the <see cref="T:System.Security.PermissionSet" />, replacing any existing permission of the same type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The set permission.</para>
+        </returns>
         <param name="perm">
           <attribution license="cc4" from="Microsoft" modified="false" />The permission to set. </param>
       </Docs>
@@ -945,10 +972,6 @@ myPermSet.RemovePermission(typeof(FileIOPermission));</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" />
-containing the XML representation of the state of the current instance.</para>
-        </returns>
         <example>
           <para>The following example displays the XML that encodes the 
       state of a <see cref="T:System.Security.PermissionSet" />
@@ -979,6 +1002,10 @@ public class PermissionSetToStringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of the <see cref="T:System.Security.PermissionSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A representation of the <see cref="T:System.Security.PermissionSet" />.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -997,10 +1024,6 @@ public class PermissionSetToStringExample {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Security.SecurityElement" /> containing an XML encoding of the state of the
-   current instance.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="behaviors">As described above.</block>
@@ -1018,6 +1041,10 @@ public class PermissionSetToStringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an XML encoding of the security object and its current state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An XML encoding of the security object, including any state information.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1038,12 +1065,6 @@ public class PermissionSetToStringExample {
         <Parameter Name="other" Type="System.Security.PermissionSet" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A new <see cref="T:System.Security.PermissionSet" /> instance that represents the
-   union of the current instance and <paramref name="other" />. If the current
-   instance or <paramref name="other" /> is unrestricted, returns a <see cref="T:System.Security.PermissionSet" />
-   instance that is unrestricted.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The result of a call to <see cref="M:System.Security.PermissionSet.Union(System.Security.PermissionSet)" /> is a <see cref="T:System.Security.PermissionSet" /> that represents all the operations represented by the current <see cref="T:System.Security.PermissionSet" /> as well as all the operations represented by the specified <see cref="T:System.Security.PermissionSet" />. If either set is Unrestricted, the union is Unrestricted as well.</para>
@@ -1052,6 +1073,10 @@ public class PermissionSetToStringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Security.PermissionSet" /> that is the union of the current <see cref="T:System.Security.PermissionSet" /> and the specified <see cref="T:System.Security.PermissionSet" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new permission set that represents the union of the current <see cref="T:System.Security.PermissionSet" /> and the specified <see cref="T:System.Security.PermissionSet" />.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The permission set to form the union with the current <see cref="T:System.Security.PermissionSet" />. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security/SecureString.xml b/mcs/class/corlib/Documentation/en/System.Security/SecureString.xml
index f9a210a57f6..1a24ef7c71d 100644
--- a/mcs/class/corlib/Documentation/en/System.Security/SecureString.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security/SecureString.xml
@@ -153,7 +153,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -163,6 +162,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the current secure string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A duplicate of this secure string.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Dispose">
@@ -240,7 +243,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -250,6 +252,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether this secure string is marked read-only.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this secure string is marked read-only; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Length">
diff --git a/mcs/class/corlib/Documentation/en/System.Security/SecurityContext.xml b/mcs/class/corlib/Documentation/en/System.Security/SecurityContext.xml
index 01ca316726e..c628f514e4e 100644
--- a/mcs/class/corlib/Documentation/en/System.Security/SecurityContext.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security/SecurityContext.xml
@@ -44,7 +44,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -54,6 +53,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Captures the security context for the current thread.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The security context for the current thread.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateCopy">
@@ -69,7 +72,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -79,6 +81,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the current security context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The security context for the current thread.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Dispose">
@@ -120,7 +126,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -130,6 +135,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the flow of the security context has been suppressed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the flow has been suppressed; otherwise, false. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsWindowsIdentityFlowSuppressed">
@@ -145,7 +154,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -155,6 +163,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the flow of the Windows identity portion of the current security context has been suppressed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the flow has been suppressed; otherwise, false. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="RestoreFlow">
@@ -228,7 +240,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -241,6 +252,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Suppresses the flow of the security context across asynchronous threads.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Threading.AsyncFlowControl" /> structure for restoring the flow.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SuppressFlowWindowsIdentity">
@@ -256,7 +271,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -270,6 +284,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Suppresses the flow of the Windows identity portion of the current security context across asynchronous threads.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure for restoring the flow.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Security/SecurityElement.xml b/mcs/class/corlib/Documentation/en/System.Security/SecurityElement.xml
index 9d7abc68341..67beaa58238 100644
--- a/mcs/class/corlib/Documentation/en/System.Security/SecurityElement.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security/SecurityElement.xml
@@ -179,7 +179,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>With XML as follows, Attribute("B") would return "456".</para>
@@ -189,6 +188,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds an attribute by name in an XML element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value associated with the named attribute, or null if no attribute with <paramref name="name" /> exists.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the attribute for which to search. </param>
       </Docs>
@@ -261,7 +264,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -271,6 +273,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an identical copy of the current <see cref="T:System.Security.SecurityElement" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current <see cref="T:System.Security.SecurityElement" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Equal">
@@ -289,7 +295,6 @@
         <Parameter Name="other" Type="System.Security.SecurityElement" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If there are child elements, comparison extends recursively to them.</para>
@@ -299,6 +304,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two XML element objects for equality.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the tag, attribute names and values, child elements, and text fields in the current XML element are identical to their counterparts in the <paramref name="other" /> parameter; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />An XML element object to which to compare the current XML element object. </param>
       </Docs>
@@ -319,7 +328,6 @@
         <Parameter Name="str" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to replace invalid characters in a string before using the string in a <see cref="T:System.Security.SecurityElement" />. If invalid characters are used in a <see cref="T:System.Security.SecurityElement" /> without being escaped, an <see cref="T:System.ArgumentException" /> is thrown.</para>
@@ -381,6 +389,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Replaces invalid XML characters in a string with their valid XML equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The input string with invalid characters replaced.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The string within which to escape invalid characters. </param>
       </Docs>
@@ -400,7 +412,6 @@
         <Parameter Name="xml" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -411,6 +422,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a security element from an XML-encoded string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.SecurityElement" /> created from the XML.</para>
+        </returns>
         <param name="xml">
           <attribution license="cc4" from="Microsoft" modified="false" />The XML-encoded string from which to create the security element.</param>
       </Docs>
@@ -431,7 +446,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to test an attribute before adding it to a security element.</para>
@@ -440,6 +454,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a string is a valid attribute name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="name" /> parameter is a valid XML attribute name; otherwise, false.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The attribute name to test for validity. </param>
       </Docs>
@@ -460,7 +478,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to test an attribute before adding it to a security element.</para>
@@ -469,6 +486,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a string is a valid attribute value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="value" /> parameter is a valid XML attribute value; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The attribute value to test for validity. </param>
       </Docs>
@@ -489,7 +510,6 @@
         <Parameter Name="tag" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This can be used to test a <see cref="P:System.Security.SecurityElement.Tag" /> before setting it.</para>
@@ -498,6 +518,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a string is a valid tag.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="tag" /> parameter is a valid XML tag; otherwise, false.</para>
+        </returns>
         <param name="tag">
           <attribution license="cc4" from="Microsoft" modified="false" />The tag to test for validity. </param>
       </Docs>
@@ -518,7 +542,6 @@
         <Parameter Name="text" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to test <see cref="P:System.Security.SecurityElement.Text" /> before setting it.</para>
@@ -527,6 +550,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a string is valid as text within an XML element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="text" /> parameter is a valid XML text element; otherwise, false.</para>
+        </returns>
         <param name="text">
           <attribution license="cc4" from="Microsoft" modified="false" />The text to test for validity. </param>
       </Docs>
@@ -547,7 +574,6 @@
         <Parameter Name="tag" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>With XML as follows, SearchForChildByTag("second") would return the child element &lt;second&gt;.</para>
@@ -558,6 +584,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds a child by its tag name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first child XML element with the specified tag value, or null if no child element with <paramref name="tag" /> exists.</para>
+        </returns>
         <param name="tag">
           <attribution license="cc4" from="Microsoft" modified="false" />The tag for which to search in child elements. </param>
       </Docs>
@@ -578,7 +608,6 @@
         <Parameter Name="tag" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is equivalent to the following:</para>
@@ -591,6 +620,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Finds a child by its tag name and returns the contained text.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The text contents of the first child element with the specified tag value.</para>
+        </returns>
         <param name="tag">
           <attribution license="cc4" from="Microsoft" modified="false" />The tag for which to search in child elements. </param>
       </Docs>
@@ -662,9 +695,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is useful in debugging to see the XML representation of the element.</para>
@@ -673,6 +703,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces a string representation of an XML element and its constituent attributes, child elements, and text.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The XML element and its contents.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System.Security/SecurityException.xml b/mcs/class/corlib/Documentation/en/System.Security/SecurityException.xml
index e487414d34e..76499c73bf4 100644
--- a/mcs/class/corlib/Documentation/en/System.Security/SecurityException.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security/SecurityException.xml
@@ -1163,7 +1163,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Security.SecurityException.ToString" /> method returns the full description of the <see cref="T:System.Security.SecurityException" />.</para>
@@ -1172,6 +1171,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a representation of the current <see cref="T:System.Security.SecurityException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the current <see cref="T:System.Security.SecurityException" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Url">
diff --git a/mcs/class/corlib/Documentation/en/System.Security/SecurityManager.xml b/mcs/class/corlib/Documentation/en/System.Security/SecurityManager.xml
index 7f4e486f5cf..d754e4569f8 100644
--- a/mcs/class/corlib/Documentation/en/System.Security/SecurityManager.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security/SecurityManager.xml
@@ -72,7 +72,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the <see cref="M:System.Security.SecurityManager.CurrentThreadRequiresSecurityContextCapture" /> method before you cache sensitive data that is obtained after successful security demands. </para>
@@ -87,6 +86,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current thread requires a security context capture if its security state has to be re-created at a later point in time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>false if the stack contains no partially trusted application domains, no partially trusted assemblies, and no currently active <see cref="M:System.Security.CodeAccessPermission.PermitOnly" /> or <see cref="M:System.Security.CodeAccessPermission.Deny" /> modifiers; true if the common language runtime cannot guarantee that the stack contains none of these. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetStandardSandbox">
@@ -103,7 +106,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -183,6 +185,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a permission set that is safe to grant to an application that has the provided evidence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A permission set that can be used as a grant set for the application that has the provided evidence.</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The host evidence to match to a permission set.</param>
       </Docs>
@@ -231,7 +237,6 @@
         <Parameter Name="perm" Type="System.Security.IPermission" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Granting of permissions is determined by policy and is different from a demand subject to overrides, such as an assert. Also, <see cref="M:System.Security.SecurityManager.IsGranted(System.Security.IPermission)" /> only tests the grant of the calling code assembly, independent of other callers on the stack.</para>
@@ -240,6 +245,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a permission is granted to the caller.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the permissions granted to the caller include the permission <paramref name="perm" />; otherwise, false.</para>
+        </returns>
         <param name="perm">
           <attribution license="cc4" from="Microsoft" modified="false" />The permission to test against the grant of the caller. </param>
       </Docs>
@@ -266,12 +275,15 @@
         <Parameter Name="type" Type="System.Security.PolicyLevelType" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Policy.PolicyLevel'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads a <see cref="T:System.Security.Policy.PolicyLevel" /> from the specified file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded policy level.</para>
+        </returns>
         <param name="path">
           <attribution license="cc4" from="Microsoft" modified="false" />The physical file path to a file containing the security policy information. </param>
         <param name="type">
@@ -300,12 +312,15 @@
         <Parameter Name="type" Type="System.Security.PolicyLevelType" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Policy.PolicyLevel'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads a <see cref="T:System.Security.Policy.PolicyLevel" /> from the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded policy level.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The XML representation of a security policy level in the same form in which it appears in a configuration file. </param>
         <param name="type">
@@ -331,7 +346,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Collections.IEnumerator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned enumerator provides successive <see cref="T:System.Security.Policy.PolicyLevel" /> objects that represent the policy at the respective (machine, user, enterprise, application domain) level of the hierarchy. These objects are the live policy objects; altering these objects can have unpredictable results.</para>
@@ -341,6 +355,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides an enumerator to access the security policy hierarchy by levels, such as computer policy and user policy.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator for <see cref="T:System.Security.Policy.PolicyLevel" /> objects that compose the security policy hierarchy.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ResolvePolicy">
@@ -364,7 +382,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'PermissionSet'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method invokes the security policy engine, providing it with evidence of the calling code's identity. The result is determined by the security policy.</para>
@@ -373,6 +390,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines what permissions to grant to code based on the specified evidence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The set of permissions that can be granted by the security system.</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The evidence set used to evaluate policy. </param>
       </Docs>
@@ -397,7 +418,6 @@
         <Parameter Name="evidences" Type="System.Security.Policy.Evidence[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -407,6 +427,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines what permissions to grant to code based on the specified evidence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The set of permissions that is appropriate for all of the provided evidence.</para>
+        </returns>
         <param name="evidences">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of evidence objects used to evaluate policy. </param>
       </Docs>
@@ -467,7 +491,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Collections.IEnumerator'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is useful in analyzing how a specified policy configuration works with specific kinds of evidence.</para>
@@ -477,6 +500,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a collection of code groups matching the specified evidence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumeration of the set of code groups matching the evidence.</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The evidence set against which the policy is evaluated. </param>
       </Docs>
@@ -501,7 +528,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -511,6 +537,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines which permissions to grant to code based on the specified evidence, excluding the policy for the <see cref="T:System.AppDomain" /> level.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The set of permissions that can be granted by the security system.</para>
+        </returns>
         <param name="evidence">
           <attribution license="cc4" from="Microsoft" modified="false" />The evidence set used to evaluate policy.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Security/SecurityState.xml b/mcs/class/corlib/Documentation/en/System.Security/SecurityState.xml
index e0b7d314b7c..ee60b2eed82 100644
--- a/mcs/class/corlib/Documentation/en/System.Security/SecurityState.xml
+++ b/mcs/class/corlib/Documentation/en/System.Security/SecurityState.xml
@@ -119,7 +119,6 @@ private bool PromptUser(string text)
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -130,6 +129,10 @@ private bool PromptUser(string text)
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value that indicates whether the state for this implementation of the <see cref="T:System.Security.SecurityState" /> class is available on the current host. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the state is available; otherwise, false. </para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Text/ASCIIEncoding.xml b/mcs/class/corlib/Documentation/en/System.Text/ASCIIEncoding.xml
index 43c71936119..895d5509636 100644
--- a/mcs/class/corlib/Documentation/en/System.Text/ASCIIEncoding.xml
+++ b/mcs/class/corlib/Documentation/en/System.Text/ASCIIEncoding.xml
@@ -97,11 +97,6 @@
         <Parameter Name="chars" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Int32" /> containing the number of bytes required to encode <paramref name="chars" /> as
-   ASCII-encoded characters.
-   </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="chars " />is <see langword="null" />. </exception>
         <remarks>
@@ -112,6 +107,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of bytes produced by encoding the characters in the specified <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes produced by encoding the specified characters.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the set of characters to encode.</param>
       </Docs>
@@ -141,7 +140,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -151,6 +149,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes produced by encoding the specified characters.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first character to encode.</param>
         <param name="count">
@@ -176,11 +178,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing
-   the number of bytes required to encode the range in <paramref name="chars" /> from<paramref name=" index" /> to <paramref name=" index " /> + <paramref name="count" /> -1 as ASCII-encoded
-   characters.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="chars " /> is <see langword="null" />. </exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -201,6 +198,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of bytes produced by encoding a set of characters from the specified character array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes produced by encoding the specified characters.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />The character array containing the set of characters to encode.</param>
         <param name="index">
@@ -236,7 +237,6 @@
         <Parameter Name="byteCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -252,6 +252,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes a set of characters starting at the specified character pointer into a sequence of bytes that are stored starting at the specified byte pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of bytes written at the location indicated by <paramref name="bytes" />.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first character to encode.</param>
         <param name="charCount">
@@ -283,11 +287,6 @@
         <Parameter Name="byteIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> whose value equals
-   the number of bytes encoded into <paramref name="bytes" /> as
-   ASCII-encoded characters. </para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>(<paramref name="bytes" />.Length - <paramref name="byteIndex" />) &lt; <paramref name="charCount" />.</para>
         </exception>
@@ -327,6 +326,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes a set of characters from the specified character array into the specified byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of bytes written into <paramref name="bytes" />.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />The character array containing the set of characters to encode.</param>
         <param name="charIndex">
@@ -361,11 +364,6 @@
         <Parameter Name="byteIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> whose
-   value equals the number of bytes encoded into <paramref name="bytes" /> as ASCII-encoded
-   characters.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>(<paramref name="bytes" />.Length - <paramref name="byteIndex" />) &lt; <paramref name="charCount" />.</para>
         </exception>
@@ -413,6 +411,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes a set of characters from the specified <see cref="T:System.String" /> into the specified byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of bytes written into <paramref name="bytes" />.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the set of characters to encode.</param>
         <param name="charIndex">
@@ -450,7 +452,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -460,6 +461,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of characters produced by decoding the specified sequence of bytes.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first byte to decode.</param>
         <param name="count">
@@ -485,18 +490,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Int32" /> whose value
-   equals the number of characters a call to <see cref="M:System.Text.ASCIIEncoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)" /> will produce if presented with the
-   specified range of <paramref name="bytes" />.</para>
-          <para>
-            <block subset="none" type="note">This value does not
-   take into account the state in which the current instance was left following the
-   last call to <see cref="M:System.Text.ASCIIEncoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)" />. This
-   contrasts with <see cref="M:System.Text.Decoder.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)" qualify="true" /> , which
-   maintains state information across calls.</block>
-          </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="bytes" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -516,6 +509,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of characters produced by decoding the specified sequence of bytes.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array containing the sequence of bytes to decode.</param>
         <param name="index">
@@ -551,7 +548,6 @@
         <Parameter Name="charCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -567,6 +563,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes a sequence of bytes starting at the specified byte pointer into a set of characters that are stored starting at the specified character pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of characters written at the location indicated by <paramref name="chars" />.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first byte to decode.</param>
         <param name="byteCount">
@@ -598,11 +598,6 @@
         <Parameter Name="charIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> whose
-   value equals the number of characters decoded into <paramref name="chars" /> as
-   ASCII-encoded characters. </para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>(<paramref name="chars" />.Length - <paramref name="charIndex" />) &lt; <paramref name="byteCount" />.</para>
         </exception>
@@ -642,6 +637,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes a sequence of bytes from the specified byte array into the specified character array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of characters written into <paramref name="chars" />.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array containing the sequence of bytes to decode.</param>
         <param name="byteIndex">
@@ -673,7 +672,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -683,6 +681,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains a decoder that converts an ASCII encoded sequence of bytes into a sequence of Unicode characters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Text.Decoder" /> that converts an ASCII encoded sequence of bytes into a sequence of Unicode characters.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetEncoder">
@@ -703,7 +705,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -713,6 +714,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains an encoder that converts a sequence of Unicode characters into an ASCII encoded sequence of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Text.Encoder" /> that converts a sequence of Unicode characters into an ASCII encoded sequence of bytes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetMaxByteCount">
@@ -732,11 +737,6 @@
         <Parameter Name="charCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" />
-containing the maximum number of bytes required to encode <paramref name="charCount" />
-characters as ASCII-encoded characters.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="charCount " />&lt; 0.</exception>
         <remarks>
@@ -755,6 +755,10 @@ characters as ASCII-encoded characters.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the maximum number of bytes produced by encoding the specified number of characters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum number of bytes produced by encoding the specified number of characters.</para>
+        </returns>
         <param name="charCount">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of characters to encode.</param>
       </Docs>
@@ -777,11 +781,6 @@ characters as ASCII-encoded characters.</para>
         <Parameter Name="byteCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" />
-containing the maximum number of characters that would be produced by
-decoding <paramref name="byteCount" /> bytes as ASCII-encoded characters. </para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="byteCount" /> &lt; 0.</exception>
         <remarks>
@@ -799,6 +798,10 @@ decoding <paramref name="byteCount" /> bytes as ASCII-encoded characters. </para
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the maximum number of characters produced by decoding the specified number of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum number of characters produced by decoding the specified number of bytes.</para>
+        </returns>
         <param name="byteCount">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of bytes to decode.</param>
       </Docs>
@@ -855,12 +858,6 @@ decoding <paramref name="byteCount" /> bytes as ASCII-encoded characters. </para
         <Parameter Name="byteCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> object containing
-   the decoded representation of the range in <paramref name="bytes" /> from
-<paramref name="byteIndex" /> to <paramref name="byteIndex" /> + <paramref name="byteCount" /> -1 as 
-   ASCII-encoded characters.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="bytes" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -887,6 +884,10 @@ decoding <paramref name="byteCount" /> bytes as ASCII-encoded characters. </para
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes a range of bytes from a byte array into a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the results of decoding the specified sequence of bytes.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array containing the sequence of bytes to decode.</param>
         <param name="byteIndex">
diff --git a/mcs/class/corlib/Documentation/en/System.Text/Decoder.xml b/mcs/class/corlib/Documentation/en/System.Text/Decoder.xml
index 21a63d00940..8d867d4e8dd 100644
--- a/mcs/class/corlib/Documentation/en/System.Text/Decoder.xml
+++ b/mcs/class/corlib/Documentation/en/System.Text/Decoder.xml
@@ -279,7 +279,6 @@ public class DecoderExample
         <Parameter Name="flush" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -291,6 +290,10 @@ public class DecoderExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer. A parameter indicates whether to clear the internal state of the decoder after the calculation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of characters produced by decoding the specified sequence of bytes and any bytes in the internal buffer.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first byte to decode. </param>
         <param name="count">
@@ -318,18 +321,6 @@ public class DecoderExample
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Int32" /> containing 
-   the number of characters the next call to <see cref="M:System.Text.Decoder.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)" /> will produce if presented with the
-   specified range of <paramref name="bytes" />
-   .</para>
-          <para>
-            <block subset="none" type="note">This value takes into account the state in which the current instance was
-   left following the last call to <see cref="M:System.Text.Decoder.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)" qualify="true" />. This
-   contrasts with <see cref="M:System.Text.Encoding.GetChars(System.Byte[])" qualify="true" />, which does not maintain state information
-   across subsequent calls.</block>
-          </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="bytes" /> is <see langword="null" /> . </exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -352,6 +343,10 @@ public class DecoderExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of characters produced by decoding the specified sequence of bytes and any bytes in the internal buffer.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array containing the sequence of bytes to decode. </param>
         <param name="index">
@@ -384,7 +379,6 @@ public class DecoderExample
         <Parameter Name="flush" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -396,6 +390,10 @@ public class DecoderExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, calculates the number of characters produced by decoding a sequence of bytes from the specified byte array. A parameter indicates whether to clear the internal state of the decoder after the calculation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of characters produced by decoding the specified sequence of bytes and any bytes in the internal buffer.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array containing the sequence of bytes to decode. </param>
         <param name="index">
@@ -433,7 +431,6 @@ public class DecoderExample
         <Parameter Name="flush" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -446,6 +443,10 @@ public class DecoderExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, decodes a sequence of bytes starting at the specified byte pointer and any bytes in the internal buffer into a set of characters that are stored starting at the specified character pointer. A parameter indicates whether to clear the internal state of the decoder after the conversion.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of characters written at the location indicated by the <paramref name="chars" /> parameter.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first byte to decode. </param>
         <param name="byteCount">
@@ -479,12 +480,6 @@ public class DecoderExample
         <Parameter Name="charIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Int32" /> containing
-   the number of characters decoded into <paramref name="chars" /> for a
-   particular encoding.
-   </para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>
             <paramref name="chars" /> does not contain sufficient space to store the decoded characters.</para>
@@ -523,6 +518,10 @@ public class DecoderExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, decodes a sequence of bytes from the specified byte array and any bytes in the internal buffer into the specified character array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of characters written into <paramref name="chars" />.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array containing the sequence of bytes to decode. </param>
         <param name="byteIndex">
@@ -556,7 +555,6 @@ public class DecoderExample
         <Parameter Name="flush" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -569,6 +567,10 @@ public class DecoderExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, decodes a sequence of bytes from the specified byte array and any bytes in the internal buffer into the specified character array. A parameter indicates whether to clear the internal state of the decoder after the conversion.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of characters written into the <paramref name="chars" /> parameter.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array containing the sequence of bytes to decode. </param>
         <param name="byteIndex">
diff --git a/mcs/class/corlib/Documentation/en/System.Text/DecoderExceptionFallback.xml b/mcs/class/corlib/Documentation/en/System.Text/DecoderExceptionFallback.xml
index fe91d56d0ff..3ccb328701a 100644
--- a/mcs/class/corlib/Documentation/en/System.Text/DecoderExceptionFallback.xml
+++ b/mcs/class/corlib/Documentation/en/System.Text/DecoderExceptionFallback.xml
@@ -57,13 +57,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of the <see cref="T:System.Text.DecoderExceptionFallback" /> class. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Text.DecoderFallbackBuffer" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Equals">
@@ -81,13 +84,16 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the current <see cref="T:System.Text.DecoderExceptionFallback" /> object and a specified object are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is not null and is a <see cref="T:System.Text.DecoderExceptionFallback" /> object; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that derives from the <see cref="T:System.Text.DecoderExceptionFallback" /> class.</param>
       </Docs>
@@ -105,7 +111,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -115,6 +120,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value is always the same arbitrary value, and has no special significance. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MaxCharCount">
diff --git a/mcs/class/corlib/Documentation/en/System.Text/DecoderExceptionFallbackBuffer.xml b/mcs/class/corlib/Documentation/en/System.Text/DecoderExceptionFallbackBuffer.xml
index 58ff82347b0..179ef5f5fa4 100644
--- a/mcs/class/corlib/Documentation/en/System.Text/DecoderExceptionFallbackBuffer.xml
+++ b/mcs/class/corlib/Documentation/en/System.Text/DecoderExceptionFallbackBuffer.xml
@@ -58,7 +58,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -68,6 +67,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Throws <see cref="T:System.Text.DecoderFallbackException" /> when the input byte sequence cannot be decoded. The nominal return value is not used. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>None. No value is returned because the <see cref="M:System.Text.DecoderExceptionFallbackBuffer.Fallback(System.Byte[],System.Int32)" /> method always throws an exception. </para>
+          <para>The nominal return value is true. A return value is defined, although it is unchanging, because this method implements an abstract method.</para>
+        </returns>
         <param name="bytesUnknown">
           <attribution license="cc4" from="Microsoft" modified="false" />An input array of bytes.</param>
         <param name="index">
@@ -87,7 +91,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -97,6 +100,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the next character in the exception data buffer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value is always the Unicode character NULL (U+0000). </para>
+          <para>A return value is defined, although it is unchanging, because this method implements an abstract method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MovePrevious">
@@ -112,7 +120,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -122,6 +129,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Causes the next call to <see cref="M:System.Text.DecoderExceptionFallbackBuffer.GetNextChar" /> to access the exception data buffer character position that is prior to the current position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value is always false. </para>
+          <para>A return value is defined, although it is unchanging, because this method implements an abstract method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Remaining">
diff --git a/mcs/class/corlib/Documentation/en/System.Text/DecoderFallback.xml b/mcs/class/corlib/Documentation/en/System.Text/DecoderFallback.xml
index 0db39775fac..af7fab06268 100644
--- a/mcs/class/corlib/Documentation/en/System.Text/DecoderFallback.xml
+++ b/mcs/class/corlib/Documentation/en/System.Text/DecoderFallback.xml
@@ -79,7 +79,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -90,6 +89,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, initializes a new instance of the <see cref="T:System.Text.DecoderFallbackBuffer" /> class. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that provides a fallback buffer for a decoder.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ExceptionFallback">
diff --git a/mcs/class/corlib/Documentation/en/System.Text/DecoderFallbackBuffer.xml b/mcs/class/corlib/Documentation/en/System.Text/DecoderFallbackBuffer.xml
index 204ee41c83f..ccda2390b91 100644
--- a/mcs/class/corlib/Documentation/en/System.Text/DecoderFallbackBuffer.xml
+++ b/mcs/class/corlib/Documentation/en/System.Text/DecoderFallbackBuffer.xml
@@ -93,7 +93,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -103,6 +102,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, prepares the fallback buffer to handle the specified input byte sequence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the fallback buffer can process <paramref name="bytesUnknown" />; false if the fallback buffer ignores <paramref name="bytesUnknown" />.</para>
+        </returns>
         <param name="bytesUnknown">
           <attribution license="cc4" from="Microsoft" modified="false" />An input array of bytes.</param>
         <param name="index">
@@ -122,7 +125,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -133,6 +135,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, retrieves the next character in the fallback buffer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The next character in the fallback buffer.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MovePrevious">
@@ -148,7 +154,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -158,6 +163,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, causes the next call to the <see cref="M:System.Text.DecoderFallbackBuffer.GetNextChar" /> method to access the data buffer character position that is prior to the current character position. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="M:System.Text.DecoderFallbackBuffer.MovePrevious" /> operation was successful; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Remaining">
diff --git a/mcs/class/corlib/Documentation/en/System.Text/DecoderReplacementFallback.xml b/mcs/class/corlib/Documentation/en/System.Text/DecoderReplacementFallback.xml
index 7c328c5f7de..1e6fe576809 100644
--- a/mcs/class/corlib/Documentation/en/System.Text/DecoderReplacementFallback.xml
+++ b/mcs/class/corlib/Documentation/en/System.Text/DecoderReplacementFallback.xml
@@ -83,13 +83,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Text.DecoderFallbackBuffer" /> object that is initialized with the replacement string of this <see cref="T:System.Text.DecoderReplacementFallback" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Text.DecoderFallbackBuffer" /> object that specifies a string to use instead of the original decoding operation input.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DefaultString">
@@ -128,13 +131,16 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the value of a specified object is equal to the <see cref="T:System.Text.DecoderReplacementFallback" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is a <see cref="T:System.Text.DecoderReplacementFallback" /> object having a <see cref="P:System.Text.DecoderReplacementFallback.DefaultString" /> property that is equal to the <see cref="P:System.Text.DecoderReplacementFallback.DefaultString" /> property of the current <see cref="T:System.Text.DecoderReplacementFallback" /> object; otherwise, false. </para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Text.DecoderReplacementFallback" /> object.</param>
       </Docs>
@@ -152,7 +158,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -162,6 +167,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the hash code for the value of the <see cref="T:System.Text.DecoderReplacementFallback" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code of the value of the object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MaxCharCount">
diff --git a/mcs/class/corlib/Documentation/en/System.Text/DecoderReplacementFallbackBuffer.xml b/mcs/class/corlib/Documentation/en/System.Text/DecoderReplacementFallbackBuffer.xml
index e17e1236b21..dcc655aa2d5 100644
--- a/mcs/class/corlib/Documentation/en/System.Text/DecoderReplacementFallbackBuffer.xml
+++ b/mcs/class/corlib/Documentation/en/System.Text/DecoderReplacementFallbackBuffer.xml
@@ -62,7 +62,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -72,6 +71,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Prepares the replacement fallback buffer to use the current replacement string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the replacement string is not empty; false if the replacement string is empty.</para>
+        </returns>
         <param name="bytesUnknown">
           <attribution license="cc4" from="Microsoft" modified="false" />An input byte sequence. This parameter is ignored unless an exception is thrown.</param>
         <param name="index">
@@ -91,7 +94,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -101,6 +103,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the next character in the replacement fallback buffer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The next character in the replacement fallback buffer.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MovePrevious">
@@ -116,13 +122,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Causes the next call to <see cref="M:System.Text.DecoderReplacementFallbackBuffer.GetNextChar" /> to access the character position in the replacement fallback buffer prior to the current character position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="M:System.Text.DecoderReplacementFallbackBuffer.MovePrevious" /> operation was successful; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Remaining">
diff --git a/mcs/class/corlib/Documentation/en/System.Text/Encoder.xml b/mcs/class/corlib/Documentation/en/System.Text/Encoder.xml
index 97a114a11d4..b3886da9837 100644
--- a/mcs/class/corlib/Documentation/en/System.Text/Encoder.xml
+++ b/mcs/class/corlib/Documentation/en/System.Text/Encoder.xml
@@ -282,7 +282,6 @@ public class EncoderExample
         <Parameter Name="flush" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -294,6 +293,10 @@ public class EncoderExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer. A parameter indicates whether to clear the internal state of the encoder after the calculation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes produced by encoding the specified characters and any characters in the internal buffer.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first character to encode. </param>
         <param name="count">
@@ -322,19 +325,6 @@ public class EncoderExample
         <Parameter Name="flush" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the
-   number of bytes required to encode the range in <paramref name="chars" /> from
-<paramref name="index" /> to 
-<paramref name=" index" />
-+ <paramref name="count" /> -1 for a particular encoding.</para>
-          <para>
-            <block subset="none" type="note">This value takes
-   into account the state in which the current instance was left following the last
-   call to <see cref="M:System.Text.Encoder.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32,System.Boolean)" />
-   .</block>
-          </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="chars " /> is <see langword="null" />. </exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -359,6 +349,10 @@ public class EncoderExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, calculates the number of bytes produced by encoding a set of characters from the specified character array. A parameter indicates whether to clear the internal state of the encoder after the calculation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes produced by encoding the specified characters and any characters in the internal buffer.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />The character array containing the set of characters to encode. </param>
         <param name="index">
@@ -397,7 +391,6 @@ public class EncoderExample
         <Parameter Name="flush" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -410,6 +403,10 @@ public class EncoderExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, encodes a set of characters starting at the specified character pointer and any characters in the internal buffer into a sequence of bytes that are stored starting at the specified byte pointer. A parameter indicates whether to clear the internal state of the encoder after the conversion.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of bytes written at the location indicated by the <paramref name="bytes" /> parameter.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first character to encode. </param>
         <param name="charCount">
@@ -444,11 +441,6 @@ public class EncoderExample
         <Parameter Name="flush" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Int32" /> containing the number of bytes encoded into <paramref name="bytes" /> for a
-   particular encoding.
-   </para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>
             <paramref name="bytes" /> does not contain sufficient space to store the encoded characters.</para>
@@ -486,6 +478,10 @@ public class EncoderExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, encodes a set of characters from the specified character array and any characters in the internal buffer into the specified byte array. A parameter indicates whether to clear the internal state of the encoder after the conversion.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of bytes written into <paramref name="bytes" />.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />The character array containing the set of characters to encode. </param>
         <param name="charIndex">
diff --git a/mcs/class/corlib/Documentation/en/System.Text/EncoderExceptionFallback.xml b/mcs/class/corlib/Documentation/en/System.Text/EncoderExceptionFallback.xml
index cf41954657f..bdcca996bdc 100644
--- a/mcs/class/corlib/Documentation/en/System.Text/EncoderExceptionFallback.xml
+++ b/mcs/class/corlib/Documentation/en/System.Text/EncoderExceptionFallback.xml
@@ -57,13 +57,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of the <see cref="T:System.Text.EncoderExceptionFallback" /> class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Text.EncoderFallbackBuffer" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Equals">
@@ -81,13 +84,16 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the current <see cref="T:System.Text.EncoderExceptionFallback" /> object and a specified object are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is not null (Nothing in Visual Basic .NET) and is a <see cref="T:System.Text.EncoderExceptionFallback" /> object; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that derives from the <see cref="T:System.Text.EncoderExceptionFallback" /> class.</param>
       </Docs>
@@ -105,7 +111,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -115,6 +120,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value is always the same arbitrary value, and has no special significance. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MaxCharCount">
diff --git a/mcs/class/corlib/Documentation/en/System.Text/EncoderExceptionFallbackBuffer.xml b/mcs/class/corlib/Documentation/en/System.Text/EncoderExceptionFallbackBuffer.xml
index 0153b77f1cd..b6486e394b6 100644
--- a/mcs/class/corlib/Documentation/en/System.Text/EncoderExceptionFallbackBuffer.xml
+++ b/mcs/class/corlib/Documentation/en/System.Text/EncoderExceptionFallbackBuffer.xml
@@ -58,7 +58,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -68,6 +67,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Throws an exception because the input character cannot be encoded. Parameters specify the value and index position of the character that cannot be converted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>None. No value is returned because the <see cref="M:System.Text.EncoderExceptionFallbackBuffer.Fallback(System.Char,System.Int32)" /> method always throws an exception. </para>
+        </returns>
         <param name="charUnknown">
           <attribution license="cc4" from="Microsoft" modified="false" />An input character.</param>
         <param name="index">
@@ -91,7 +94,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -101,6 +103,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Throws an exception because the input character cannot be encoded. Parameters specify the value and index position of the surrogate pair in the input, and the nominal return value is not used.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>None. No value is returned because the <see cref="M:System.Text.EncoderExceptionFallbackBuffer.Fallback(System.Char,System.Char,System.Int32)" /> method always throws an exception. </para>
+        </returns>
         <param name="charUnknownHigh">
           <attribution license="cc4" from="Microsoft" modified="false" />The high surrogate of the input pair.</param>
         <param name="charUnknownLow">
@@ -122,7 +128,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -132,6 +137,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the next character in the exception fallback buffer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value is always the Unicode character, NULL (U+0000). </para>
+          <para>A return value is defined, although it is unchanging, because this method implements an abstract method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MovePrevious">
@@ -147,7 +157,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -157,6 +166,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Causes the next call to the <see cref="M:System.Text.EncoderExceptionFallbackBuffer.GetNextChar" /> method to access the exception data buffer character position that is prior to the current position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value is always false.</para>
+          <para>A return value is defined, although it is unchanging, because this method implements an abstract method.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Remaining">
diff --git a/mcs/class/corlib/Documentation/en/System.Text/EncoderFallback.xml b/mcs/class/corlib/Documentation/en/System.Text/EncoderFallback.xml
index 92d4bd00779..b0fa7f3d458 100644
--- a/mcs/class/corlib/Documentation/en/System.Text/EncoderFallback.xml
+++ b/mcs/class/corlib/Documentation/en/System.Text/EncoderFallback.xml
@@ -79,7 +79,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -90,6 +89,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, initializes a new instance of the <see cref="T:System.Text.EncoderFallbackBuffer" /> class. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that provides a fallback buffer for an encoder.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ExceptionFallback">
diff --git a/mcs/class/corlib/Documentation/en/System.Text/EncoderFallbackBuffer.xml b/mcs/class/corlib/Documentation/en/System.Text/EncoderFallbackBuffer.xml
index 6db5d113b61..b4b015b9fc0 100644
--- a/mcs/class/corlib/Documentation/en/System.Text/EncoderFallbackBuffer.xml
+++ b/mcs/class/corlib/Documentation/en/System.Text/EncoderFallbackBuffer.xml
@@ -93,7 +93,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -103,6 +102,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, prepares the fallback buffer to handle the specified input character. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the fallback buffer can process <paramref name="charUnknown" />; false if the fallback buffer ignores <paramref name="charUnknown" />.</para>
+        </returns>
         <param name="charUnknown">
           <attribution license="cc4" from="Microsoft" modified="false" />An input character.</param>
         <param name="index">
@@ -126,7 +129,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -136,6 +138,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, prepares the fallback buffer to handle the specified surrogate pair.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the fallback buffer can process <paramref name="charUnknownHigh" /> and <paramref name="charUnknownLow" />; false if the fallback buffer ignores the surrogate pair.</para>
+        </returns>
         <param name="charUnknownHigh">
           <attribution license="cc4" from="Microsoft" modified="false" />The high surrogate of the input pair.</param>
         <param name="charUnknownLow">
@@ -157,7 +163,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -168,6 +173,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, retrieves the next character in the fallback buffer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The next character in the fallback buffer.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MovePrevious">
@@ -183,7 +192,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -193,6 +201,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, causes the next call to the <see cref="M:System.Text.EncoderFallbackBuffer.GetNextChar" /> method to access the data buffer character position that is prior to the current character position. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="M:System.Text.EncoderFallbackBuffer.MovePrevious" /> operation was successful; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Remaining">
diff --git a/mcs/class/corlib/Documentation/en/System.Text/EncoderFallbackException.xml b/mcs/class/corlib/Documentation/en/System.Text/EncoderFallbackException.xml
index 2c50348203b..aac1f00622d 100644
--- a/mcs/class/corlib/Documentation/en/System.Text/EncoderFallbackException.xml
+++ b/mcs/class/corlib/Documentation/en/System.Text/EncoderFallbackException.xml
@@ -194,13 +194,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the input that caused the exception is a surrogate pair.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the input was a surrogate pair; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Text/EncoderReplacementFallback.xml b/mcs/class/corlib/Documentation/en/System.Text/EncoderReplacementFallback.xml
index 9594a2cf404..e29b0c610f0 100644
--- a/mcs/class/corlib/Documentation/en/System.Text/EncoderReplacementFallback.xml
+++ b/mcs/class/corlib/Documentation/en/System.Text/EncoderReplacementFallback.xml
@@ -86,13 +86,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Text.EncoderFallbackBuffer" /> object that is initialized with the replacement string of this <see cref="T:System.Text.EncoderReplacementFallback" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Text.EncoderFallbackBuffer" /> object equal to this <see cref="T:System.Text.EncoderReplacementFallback" /> object. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="DefaultString">
@@ -131,7 +134,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -141,6 +143,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the value of a specified object is equal to the <see cref="T:System.Text.EncoderReplacementFallback" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="value" /> parameter specifies an <see cref="T:System.Text.EncoderReplacementFallback" /> object and the replacement string of that object is equal to the replacement string of this <see cref="T:System.Text.EncoderReplacementFallback" /> object; otherwise, false. </para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Text.EncoderReplacementFallback" /> object.</param>
       </Docs>
@@ -158,7 +164,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -168,6 +173,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the hash code for the value of the <see cref="T:System.Text.EncoderReplacementFallback" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code of the value of the object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MaxCharCount">
diff --git a/mcs/class/corlib/Documentation/en/System.Text/EncoderReplacementFallbackBuffer.xml b/mcs/class/corlib/Documentation/en/System.Text/EncoderReplacementFallbackBuffer.xml
index 78e385a5f6c..8ea78c80858 100644
--- a/mcs/class/corlib/Documentation/en/System.Text/EncoderReplacementFallbackBuffer.xml
+++ b/mcs/class/corlib/Documentation/en/System.Text/EncoderReplacementFallbackBuffer.xml
@@ -62,7 +62,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -72,6 +71,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Prepares the replacement fallback buffer to use the current replacement string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the replacement string is not empty; false if the replacement string is empty.</para>
+        </returns>
         <param name="charUnknown">
           <attribution license="cc4" from="Microsoft" modified="false" />An input character. This parameter is ignored in this operation unless an exception is thrown.</param>
         <param name="index">
@@ -95,7 +98,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -105,6 +107,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a replacement string can be used when an input surrogate pair cannot be encoded, or whether the surrogate pair can be ignored. Parameters specify the surrogate pair and the index position of the pair in the input.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the replacement string is not empty; false if the replacement string is empty.</para>
+        </returns>
         <param name="charUnknownHigh">
           <attribution license="cc4" from="Microsoft" modified="false" />The high surrogate of the input pair.</param>
         <param name="charUnknownLow">
@@ -126,7 +132,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -136,6 +141,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the next character in the replacement fallback buffer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The next Unicode character in the replacement fallback buffer that the application can encode.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MovePrevious">
@@ -151,13 +160,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Causes the next call to the <see cref="M:System.Text.EncoderReplacementFallbackBuffer.GetNextChar" /> method to access the character position in the replacement fallback buffer prior to the current character position. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="M:System.Text.EncoderReplacementFallbackBuffer.MovePrevious" /> operation was successful; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Remaining">
diff --git a/mcs/class/corlib/Documentation/en/System.Text/Encoding.xml b/mcs/class/corlib/Documentation/en/System.Text/Encoding.xml
index 7402fd55ffe..777c48509b9 100644
--- a/mcs/class/corlib/Documentation/en/System.Text/Encoding.xml
+++ b/mcs/class/corlib/Documentation/en/System.Text/Encoding.xml
@@ -2237,7 +2237,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2248,6 +2247,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates a shallow copy of the current <see cref="T:System.Text.Encoding" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of the current <see cref="T:System.Text.Encoding" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CodePage">
@@ -2290,11 +2293,6 @@
         <Parameter Name="bytes" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Byte" /> array containing the result
-   of the conversion.
-   </para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="srcEncoding" />, <paramref name="dstEncoding" /> or <paramref name="bytes" /> is <see langword="null" />. </exception>
@@ -2302,6 +2300,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an entire byte array from one encoding to another.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Byte" /> containing the results of converting <paramref name="bytes" /> from <paramref name="srcEncoding" /> to <paramref name="dstEncoding" />.</para>
+        </returns>
         <param name="srcEncoding">
           <attribution license="cc4" from="Microsoft" modified="false" />The encoding format of <paramref name="bytes" />. </param>
         <param name="dstEncoding">
@@ -2332,10 +2334,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Byte" /> array
-   containing the result of the conversion. </para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">
           <para>
@@ -2347,6 +2345,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a range of bytes in a byte array from one encoding to another.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of type <see cref="T:System.Byte" /> containing the result of converting a range of bytes in <paramref name="bytes" /> from <paramref name="srcEncoding" /> to <paramref name="dstEncoding" />.</para>
+        </returns>
         <param name="srcEncoding">
           <attribution license="cc4" from="Microsoft" modified="false" />The encoding of the source array, <paramref name="bytes" />. </param>
         <param name="dstEncoding">
@@ -2513,12 +2515,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> represents the same type and value as
-   the current instance. If <paramref name="obj" /> is a null reference or is not an
-   instance of <see cref="T:System.Text.Encoding" />, returns <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Two instances of <see cref="T:System.Text.Encoding" /> are considered equal if they correspond to the same code page and their EncoderFallback and DecoderFallback objects are equal. In particular, derived code pages all have a code page of 0 and their fallbacks are normally null (Nothing in Visual Basic .NET). Thus they are all considered equal to one another. One consequence is that when <see cref="M:System.Text.Encoding.Equals(System.Object)" /> is used to populate a hash table, all derived encodings compare equal and fall into the same hash table slot.</para>
@@ -2527,6 +2523,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is equal to the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is an instance of <see cref="T:System.Text.Encoding" /> and is equal to the current instance; otherwise, false. </para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to compare with the current instance. </param>
       </Docs>
@@ -2549,11 +2549,6 @@
         <Parameter Name="chars" Type="System.Char[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Int32" /> containing the number of bytes needed to encode
-<paramref name="chars" />.
-   </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="chars " />is <see langword="null" />. </exception>
         <remarks>
@@ -2583,6 +2578,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, calculates the number of bytes produced by encoding all the characters in the specified character array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes produced by encoding all the characters in the specified character array.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />The character array containing the characters to encode. </param>
       </Docs>
@@ -2605,9 +2604,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the number of bytes needed to encode <paramref name="s" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s " /> is <see langword="null" />.</exception>
         <remarks>
@@ -2637,6 +2633,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, calculates the number of bytes produced by encoding the characters in the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes produced by encoding the specified characters.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the set of characters to encode. </param>
       </Docs>
@@ -2666,7 +2666,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2695,6 +2694,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes produced by encoding the specified characters.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first character to encode. </param>
         <param name="count">
@@ -2720,12 +2723,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Int32" /> containing the number of bytes required to encode the range
-   in <paramref name="chars" /> from <paramref name="index" /> to <paramref name="index" /> +
-<paramref name="count" /> - 1.
-   </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="chars " />is <see langword="null" /> . </exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -2764,6 +2761,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, calculates the number of bytes produced by encoding a set of characters from the specified character array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes produced by encoding the specified characters.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />The character array containing the set of characters to encode. </param>
         <param name="index">
@@ -2790,10 +2791,6 @@
         <Parameter Name="chars" Type="System.Char[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Byte" /> array containing
-   the encoded representation of <paramref name="chars" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="chars" /> is <see langword="null" />. </exception>
         <remarks>
@@ -2823,6 +2820,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, encodes all the characters in the specified character array into a sequence of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array containing the results of encoding the specified set of characters.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />The character array containing the characters to encode. </param>
       </Docs>
@@ -2845,10 +2846,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Byte" /> array
-   containing the encoded representation of <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is <see langword="null" />. </exception>
         <remarks>
@@ -2878,6 +2875,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, encodes all the characters in the specified string into a sequence of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array containing the results of encoding the specified set of characters.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the characters to encode. </param>
       </Docs>
@@ -2902,11 +2903,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Byte" /> array containing
-   the encoded representation of the range in <paramref name="chars" />
-   from <paramref name="index" /> to <paramref name="index" /> + <paramref name="count" /> - 1.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="chars" /> is <see langword="null" />. </exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -2938,6 +2934,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, encodes a set of characters from the specified character array into a sequence of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array containing the results of encoding the specified set of characters.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />The character array containing the set of characters to encode. </param>
         <param name="index">
@@ -2973,7 +2973,6 @@
         <Parameter Name="byteCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3003,6 +3002,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, encodes a set of characters starting at the specified character pointer into a sequence of bytes that are stored starting at the specified byte pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of bytes written at the location indicated by the <paramref name="bytes" /> parameter.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first character to encode. </param>
         <param name="charCount">
@@ -3034,10 +3037,6 @@
         <Parameter Name="byteIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> The number of bytes encoded into <paramref name="bytes" /> .
-   </para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>
             <paramref name="bytes" /> does not contain sufficient space to store the encoded characters.</para>
@@ -3092,6 +3091,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, encodes a set of characters from the specified character array into the specified byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of bytes written into <paramref name="bytes" />.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />The character array containing the set of characters to encode. </param>
         <param name="charIndex">
@@ -3126,9 +3129,6 @@
         <Parameter Name="byteIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the number of bytes encoded into <paramref name="bytes" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>
             <paramref name="bytes" /> does not contain sufficient space to store the encoded characters.</para>
@@ -3191,6 +3191,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, encodes a set of characters from the specified string into the specified byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of bytes written into <paramref name="bytes" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the set of characters to encode. </param>
         <param name="charIndex">
@@ -3221,11 +3225,6 @@
         <Parameter Name="bytes" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Int32" /> containing the number of characters produced by decoding
-<paramref name="bytes" />.
-   </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="bytes" /> is <see langword="null" />. </exception>
         <remarks>
@@ -3255,6 +3254,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, calculates the number of characters produced by decoding all the bytes in the specified byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of characters produced by decoding the specified sequence of bytes.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array containing the sequence of bytes to decode. </param>
       </Docs>
@@ -3284,7 +3287,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3313,6 +3315,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of characters produced by decoding the specified sequence of bytes.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first byte to decode. </param>
         <param name="count">
@@ -3338,10 +3344,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the number of characters the next call to <see cref="M:System.Text.Decoder.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)" /> will produce if presented with the 
-   specified range of <paramref name="bytes" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="bytes" /> is <see langword="null" />. </exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -3373,6 +3375,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of characters produced by decoding the specified sequence of bytes.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array containing the sequence of bytes to decode. </param>
         <param name="index">
@@ -3399,12 +3405,6 @@
         <Parameter Name="bytes" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Char" /> array produced by
- decoding <paramref name="bytes" />
- 
- .</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="bytes" /> is <see langword="null" />. </exception>
         <remarks>
@@ -3437,6 +3437,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, decodes all the bytes in the specified byte array into a set of characters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A character array containing the results of decoding the specified sequence of bytes.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array containing the sequence of bytes to decode. </param>
       </Docs>
@@ -3461,12 +3465,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Char" /> array containing the
-   decoded representation of the range in <paramref name="bytes " />between <paramref name="index " />to
-<paramref name="index " />+ <paramref name="count" />
-.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="bytes " />is <see langword="null" /> . </exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -3501,6 +3499,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, decodes a sequence of bytes from the specified byte array into a set of characters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A character array containing the results of decoding the specified sequence of bytes.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array containing the sequence of bytes to decode. </param>
         <param name="index">
@@ -3536,7 +3538,6 @@
         <Parameter Name="charCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3569,6 +3570,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, decodes a sequence of bytes starting at the specified byte pointer into a set of characters that are stored starting at the specified character pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of characters written at the location indicated by the <paramref name="chars" /> parameter.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first byte to decode. </param>
         <param name="byteCount">
@@ -3600,10 +3605,6 @@
         <Parameter Name="charIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> The number of characters stored in <paramref name="chars" />.
-   </para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>
             <paramref name="chars" /> does not contain sufficient space to store the decoded characters.</para>
@@ -3662,6 +3663,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, decodes a sequence of bytes from the specified byte array into the specified character array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of characters written into <paramref name="chars" />.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array containing the sequence of bytes to decode. </param>
         <param name="byteIndex">
@@ -3690,11 +3695,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Text.Decoder" /> for
-   the current
-   instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.Decoder.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)" /> method converts sequential blocks of bytes into sequential blocks of characters, in a manner similar to the <see cref="M:System.Text.Encoding.GetChars(System.Byte[])" /> method of this class. However, a <see cref="T:System.Text.Decoder" /> maintains state information between calls so it correctly decodes byte sequences that span blocks. The <see cref="T:System.Text.Decoder" /> also preserves trailing bytes at the end of data blocks and uses the trailing bytes in the next decoding operation. Therefore, <see cref="M:System.Text.Encoding.GetDecoder" /> and <see cref="M:System.Text.Encoding.GetEncoder" /> are useful for network transmission and file operations, because those operations often deal with blocks of data instead of a complete data stream.</para>
@@ -3703,6 +3703,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, obtains a decoder that converts an encoded sequence of bytes into a sequence of characters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Text.Decoder" /> that converts an encoded sequence of bytes into a sequence of characters.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -3721,11 +3725,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Text.Encoder" /> for
-   the current
-   encoding.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.Encoder.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32,System.Boolean)" /> method converts sequential blocks of characters into sequential blocks of bytes, in a manner similar to the <see cref="M:System.Text.Encoding.GetBytes(System.Char[])" /> method of this class. However, a <see cref="T:System.Text.Encoder" /> maintains state information between calls so it correctly encodes character sequences that span blocks. The <see cref="T:System.Text.Encoder" /> also preserves trailing characters at the end of data blocks and uses the trailing characters in the next encoding operation. For example, a data block might end with an unmatched high surrogate, and the matching low surrogate might be in the next data block. Therefore, <see cref="M:System.Text.Encoding.GetDecoder" /> and <see cref="M:System.Text.Encoding.GetEncoder" /> are useful for network transmission and file operations, because those operations often deal with blocks of data instead of a complete data stream.</para>
@@ -3734,6 +3733,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, obtains an encoder that converts a sequence of Unicode characters into an encoded sequence of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Text.Encoder" /> that converts a sequence of Unicode characters into an encoded sequence of bytes.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -3753,7 +3756,6 @@
         <Parameter Name="codepage" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The fallback handler depends on the encoding type of <paramref name="codepage" />. If <paramref name="codepage" /> is a code page or double-byte character set (DBCS) encoding, a best-fit fallback handler is used. Otherwise, a replacement fallback handler is used. These fallback handlers may not be appropriate for your application. To specify the fallback handler used by the encoding specified by <paramref name="codepage" />, you can call the <see cref="M:System.Text.Encoding.GetEncoding(System.Int32,System.Text.EncoderFallback,System.Text.DecoderFallback)" /> overload.</para>
@@ -3772,6 +3774,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the encoding associated with the specified code page identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The encoding that is associated with the specified code page.</para>
+        </returns>
         <param name="codepage">
           <attribution license="cc4" from="Microsoft" modified="false" />The code page identifier of the preferred encoding. Possible values are listed in the Code Page column of the table that appears in the <see cref="T:System.Text.Encoding" /> class topic.</param>
       </Docs>
@@ -3792,7 +3798,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The fallback handler depends on the encoding type of <paramref name="name" />. If <paramref name="name" /> is a code page or double-byte character set (DBCS) encoding, a best-fit fallback handler is used. Otherwise, a replacement fallback handler is used. These fallback handlers may not be appropriate for your application. To specify the fallback handler used by the encoding specified by <paramref name="name" />, you can call the <see cref="M:System.Text.Encoding.GetEncoding(System.String,System.Text.EncoderFallback,System.Text.DecoderFallback)" /> overload.</para>
@@ -3808,6 +3813,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the encoding associated with the specified code page name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The encoding  associated with the specified code page.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The code page name of the preferred encoding. Any value returned by the <see cref="P:System.Text.Encoding.WebName" /> property is valid. Possible values are listed in the Name column of the table that appears in the <see cref="T:System.Text.Encoding" /> class topic.</param>
       </Docs>
@@ -3829,7 +3838,6 @@
         <Parameter Name="decoderFallback" Type="System.Text.DecoderFallback" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3849,6 +3857,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the encoding associated with the specified code page identifier. Parameters specify an error handler for characters that cannot be encoded and byte sequences that cannot be decoded.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The encoding that is associated with the specified code page.</para>
+        </returns>
         <param name="codepage">
           <attribution license="cc4" from="Microsoft" modified="false" />The code page identifier of the preferred encoding. Possible values are listed in the Code Page column of the table that appears in the <see cref="T:System.Text.Encoding" /> class topic.</param>
         <param name="encoderFallback">
@@ -3874,7 +3886,6 @@
         <Parameter Name="decoderFallback" Type="System.Text.DecoderFallback" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3890,6 +3901,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the encoding associated with the specified code page name. Parameters specify an error handler for characters that cannot be encoded and byte sequences that cannot be decoded.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The encoding that is associated with the specified code page.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The code page name of the preferred encoding. Any value returned by the <see cref="P:System.Text.Encoding.WebName" /> property is valid. Possible values are listed in the Name column of the table that appears in the <see cref="T:System.Text.Encoding" /> class topic.</param>
         <param name="encoderFallback">
@@ -3911,7 +3926,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3926,6 +3940,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array that contains all encodings.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains all encodings.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -3943,9 +3961,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the hash code for the current instance.</para>
-        </returns>
         <remarks>
           <para>The algorithm used to
       generate the hash code is unspecified.</para>
@@ -3957,6 +3972,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the current instance.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -3977,11 +3996,6 @@
         <Parameter Name="charCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Int32" /> containing the maximum number of bytes required to encode
-<paramref name="charCount" />
-characters.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="charCount" /> parameter actually specifies the number of <see cref="T:System.Char" /> objects that represent the Unicode characters to encode, because the .NET Framework internally uses UTF-16 to represent Unicode characters. Consequently, most Unicode characters can be represented by one <see cref="T:System.Char" /> object, but a Unicode character represented by a surrogate pair, for example, requires two <see cref="T:System.Char" /> objects.</para>
@@ -3999,6 +4013,10 @@ characters.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, calculates the maximum number of bytes produced by encoding the specified number of characters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum number of bytes produced by encoding the specified number of characters.</para>
+        </returns>
         <param name="charCount">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of characters to encode. </param>
       </Docs>
@@ -4021,12 +4039,6 @@ characters.</para>
         <Parameter Name="byteCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Int32" /> containing the maximum number of characters that would be produced
-   by decoding <paramref name="byteCount" />
-   bytes.
-   </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To calculate the exact array size required by <see cref="M:System.Text.Encoding.GetChars(System.Byte[])" /> to store the resulting characters, the application should use <see cref="M:System.Text.Encoding.GetCharCount(System.Byte[])" />. To calculate the maximum array size, it should use <see cref="M:System.Text.Encoding.GetMaxCharCount(System.Int32)" />. The <see cref="M:System.Text.Encoding.GetCharCount(System.Byte[])" /> method generally allows allocation of less memory, while the <see cref="M:System.Text.Encoding.GetMaxCharCount(System.Int32)" /> method generally executes faster.</para>
@@ -4045,6 +4057,10 @@ characters.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, calculates the maximum number of characters produced by decoding the specified number of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum number of characters produced by decoding the specified number of bytes.</para>
+        </returns>
         <param name="byteCount">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of bytes to decode. </param>
       </Docs>
@@ -4065,10 +4081,6 @@ characters.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Byte" />
-array that identifies the encoding used on a stream. </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Optionally, the <see cref="T:System.Text.Encoding" /> object provides a preamble that is an array of bytes that can be prefixed to the sequence of bytes resulting from the encoding process. If the preamble contains a byte order mark (in Unicode, code point U+FEFF), it helps the decoder determine the byte order and the transformation format or UTF. </para>
@@ -4102,6 +4114,12 @@ array that identifies the encoding used on a stream. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns a sequence of bytes that specifies the encoding used.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array containing a sequence of bytes that specifies the encoding used.</para>
+          <para>-or- </para>
+          <para>A byte array of length zero, if a preamble is not required.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -4122,9 +4140,6 @@ array that identifies the encoding used on a stream. </para>
         <Parameter Name="bytes" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.String" /> containing the decoded representation of <paramref name="bytes" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="bytes" /> is <see langword="null" />. </exception>
         <remarks>
@@ -4137,6 +4152,10 @@ array that identifies the encoding used on a stream. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, decodes all the bytes in the specified byte array into a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the results of decoding the specified sequence of bytes.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array containing the sequence of bytes to decode. </param>
       </Docs>
@@ -4161,11 +4180,6 @@ array that identifies the encoding used on a stream. </para>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.String" /> containing the decoded representation of the range
-   of <paramref name="bytes" /> from <paramref name="index" /> to <paramref name="index" /> + <paramref name="count" />.
-   </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="bytes " /> is <see langword="null" />. </exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -4179,6 +4193,10 @@ array that identifies the encoding used on a stream. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, decodes a sequence of bytes from the specified byte array into a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the results of decoding the specified sequence of bytes.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array containing the sequence of bytes to decode. </param>
         <param name="index">
@@ -4232,7 +4250,6 @@ array that identifies the encoding used on a stream. </para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4242,6 +4259,10 @@ array that identifies the encoding used on a stream. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the current encoding is always normalized, using the default normalization form.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current <see cref="T:System.Text.Encoding" /> is always normalized; otherwise, false. The default is false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsAlwaysNormalized">
@@ -4264,7 +4285,6 @@ array that identifies the encoding used on a stream. </para>
         <Parameter Name="form" Type="System.Text.NormalizationForm" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4274,6 +4294,10 @@ array that identifies the encoding used on a stream. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, gets a value indicating whether the current encoding is always normalized, using the specified normalization form.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current <see cref="T:System.Text.Encoding" /> object is always normalized using the specified <see cref="T:System.Text.NormalizationForm" /> value; otherwise, false. The default is false.</para>
+        </returns>
         <param name="form">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.Text.NormalizationForm" /> values. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Text/EncodingInfo.xml b/mcs/class/corlib/Documentation/en/System.Text/EncodingInfo.xml
index d48f42e4f02..d843527c161 100644
--- a/mcs/class/corlib/Documentation/en/System.Text/EncodingInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System.Text/EncodingInfo.xml
@@ -87,7 +87,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -97,6 +96,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified object is equal to the current <see cref="T:System.Text.EncodingInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is a <see cref="T:System.Text.EncodingInfo" /> object and is equal to the current <see cref="T:System.Text.EncodingInfo" /> object; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare to the current <see cref="T:System.Text.EncodingInfo" /> object.</param>
       </Docs>
@@ -114,13 +117,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Text.Encoding" /> object that corresponds to the current <see cref="T:System.Text.EncodingInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Text.Encoding" /> object that corresponds to the current <see cref="T:System.Text.EncodingInfo" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -136,7 +142,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -146,6 +151,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for the current <see cref="T:System.Text.EncodingInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Name">
diff --git a/mcs/class/corlib/Documentation/en/System.Text/StringBuilder.xml b/mcs/class/corlib/Documentation/en/System.Text/StringBuilder.xml
index b61f48470ff..0a29c61041d 100644
--- a/mcs/class/corlib/Documentation/en/System.Text/StringBuilder.xml
+++ b/mcs/class/corlib/Documentation/en/System.Text/StringBuilder.xml
@@ -701,11 +701,6 @@
         <Parameter Name="value" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> The current instance after the operation has
-      occurred.
-      </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.StringBuilder.Append(System.Boolean)" /> method modifies the existing instance of this class; it does not return a new class instance. Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a <see cref="T:System.Text.StringBuilder" /> object, as the following example illustrates.</para>
@@ -716,6 +711,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the string representation of a specified Boolean value to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the append operation has completed.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Boolean value to append. </param>
       </Docs>
@@ -738,9 +737,6 @@
         <Parameter Name="value" Type="System.Byte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after the operation has occurred.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.StringBuilder.Append(System.Byte)" /> method modifies the existing instance of this class; it does not return a new class instance. Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a <see cref="T:System.Text.StringBuilder" /> object, as the following example illustrates.</para>
@@ -752,6 +748,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the string representation of a specified 8-bit unsigned integer to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the append operation has completed.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to append. </param>
       </Docs>
@@ -774,9 +774,6 @@
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after the operation has occurred.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.StringBuilder.Append(System.Char)" /> method modifies the existing instance of this class; it does not return a new class instance. Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a <see cref="T:System.Text.StringBuilder" /> object, as the following example illustrates.</para>
@@ -787,6 +784,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the string representation of a specified Unicode character to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the append operation has completed.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to append. </param>
       </Docs>
@@ -809,9 +810,6 @@
         <Parameter Name="value" Type="System.Char[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after the operation has occurred.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method appends all the characters in the specified array to the current instance in the same order as they appear in <paramref name="value" />. If <paramref name="value" /> is null, no changes are made.</para>
@@ -823,6 +821,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the string representation of the Unicode characters in a specified array to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the append operation has completed.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of characters to append. </param>
       </Docs>
@@ -845,11 +847,6 @@
         <Parameter Name="value" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> The current instance after the operation has
-      occurred.
-      </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.StringBuilder.Append(System.Decimal)" /> method modifies the existing instance of this class; it does not return a new class instance. Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a <see cref="T:System.Text.StringBuilder" /> object, as the following example illustrates.</para>
@@ -861,6 +858,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the string representation of a specified decimal number to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the append operation has completed.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to append. </param>
       </Docs>
@@ -884,9 +885,6 @@
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after the operation has occurred.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.StringBuilder.Append(System.Double)" /> method modifies the existing instance of this class; it does not return a new class instance. Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a <see cref="T:System.Text.StringBuilder" /> object, as the following example illustrates.</para>
@@ -898,6 +896,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the string representation of a specified double-precision floating-point number to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the append operation has completed.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to append. </param>
       </Docs>
@@ -921,10 +923,6 @@
         <Parameter Name="value" Type="System.Int16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> The current instance after the operation has occurred.
-      </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.StringBuilder.Append(System.Int16)" /> method modifies the existing instance of this class; it does not return a new class instance. Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a <see cref="T:System.Text.StringBuilder" /> object, as the following example illustrates.</para>
@@ -936,6 +934,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the string representation of a specified 16-bit signed integer to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the append operation has completed.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to append. </param>
       </Docs>
@@ -958,9 +960,6 @@
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after the operation has occurred.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.StringBuilder.Append(System.Int32)" /> method modifies the existing instance of this class; it does not return a new class instance. Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a <see cref="T:System.Text.StringBuilder" /> object, as the following example illustrates.</para>
@@ -972,6 +971,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the string representation of a specified 32-bit signed integer to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the append operation has completed.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to append. </param>
       </Docs>
@@ -994,9 +997,6 @@
         <Parameter Name="value" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after the operation has occurred.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.StringBuilder.Append(System.Int64)" /> method modifies the existing instance of this class; it does not return a new class instance. Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a <see cref="T:System.Text.StringBuilder" /> object, as the following example illustrates.</para>
@@ -1008,6 +1008,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the string representation of a specified 64-bit signed integer to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the append operation has completed.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to append. </param>
       </Docs>
@@ -1030,9 +1034,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after the operation has occurred.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.StringBuilder.Append(System.Object)" /> method modifies the existing instance of this class; it does not return a new class instance. Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a <see cref="T:System.Text.StringBuilder" /> object, as the following example illustrates. It defines a Dog class, creates a Dog object, and makes three calls to the <see cref="M:System.Text.StringBuilder.Append(System.Boolean)" /> method to create a string that contains the dog's name and breed.</para>
@@ -1044,6 +1045,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the string representation of a specified object to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the append operation has completed.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to append. </param>
       </Docs>
@@ -1071,9 +1076,6 @@
         <Parameter Name="value" Type="System.SByte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after the operation has occurred.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.StringBuilder.Append(System.SByte)" /> method modifies the existing instance of this class; it does not return a new class instance. Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a <see cref="T:System.Text.StringBuilder" /> object, as the following example illustrates.</para>
@@ -1085,6 +1087,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the string representation of a specified 8-bit signed integer to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the append operation has completed.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to append. </param>
       </Docs>
@@ -1107,9 +1113,6 @@
         <Parameter Name="value" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after the operation has occurred.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.StringBuilder.Append(System.Single)" /> method modifies the existing instance of this class; it does not return a new class instance. Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a <see cref="T:System.Text.StringBuilder" /> object, as the following example illustrates.</para>
@@ -1121,6 +1124,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the string representation of a specified single-precision floating-point number to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the append operation has completed.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to append. </param>
       </Docs>
@@ -1144,9 +1151,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after the operation has occurred.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.StringBuilder.Append(System.String)" /> method modifies the existing instance of this class; it does not return a new class instance. Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a <see cref="T:System.Text.StringBuilder" /> object, as the following example illustrates.</para>
@@ -1158,6 +1162,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends a copy of the specified string to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the append operation has completed.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to append. </param>
       </Docs>
@@ -1185,9 +1193,6 @@
         <Parameter Name="value" Type="System.UInt16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after the operation has occurred.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.StringBuilder.Append(System.UInt16)" /> method modifies the existing instance of this class; it does not return a new class instance. Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a <see cref="T:System.Text.StringBuilder" /> object, as the following example illustrates.</para>
@@ -1199,6 +1204,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the string representation of a specified 16-bit unsigned integer to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the append operation has completed.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to append. </param>
       </Docs>
@@ -1226,9 +1235,6 @@
         <Parameter Name="value" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after the operation has occurred.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.StringBuilder.Append(System.UInt32)" /> method modifies the existing instance of this class; it does not return a new class instance. Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a <see cref="T:System.Text.StringBuilder" /> object, as the following example illustrates.</para>
@@ -1240,6 +1246,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the string representation of a specified 32-bit unsigned integer to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the append operation has completed.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to append. </param>
       </Docs>
@@ -1267,9 +1277,6 @@
         <Parameter Name="value" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after the operation has occurred.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.StringBuilder.Append(System.UInt64)" /> method modifies the existing instance of this class; it does not return a new class instance. Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a <see cref="T:System.Text.StringBuilder" /> object, as the following example illustrates.</para>
@@ -1281,6 +1288,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the string representation of a specified 64-bit unsigned integer to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the append operation has completed.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to append. </param>
       </Docs>
@@ -1304,9 +1315,6 @@
         <Parameter Name="repeatCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after the operation has occurred.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="repeatCount" /> is less than zero.</exception>
         <remarks>
@@ -1319,6 +1327,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends a specified number of copies of the string representation of a Unicode character to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the append operation has completed.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to append. </param>
         <param name="repeatCount">
@@ -1345,9 +1357,6 @@
         <Parameter Name="charCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after the operation has occurred.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference, and <paramref name="startIndex" /> and <paramref name="charCount" /> are not both zero.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -1367,6 +1376,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the string representation of a specified subarray of Unicode characters to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the append operation has completed.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A character array. </param>
         <param name="startIndex">
@@ -1395,9 +1408,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after the operation has occurred.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference, and <paramref name="startIndex" /> and <paramref name="count" /> are not both zero.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -1417,6 +1427,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends a copy of a specified substring to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the append operation has completed.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string that contains the substring to append. </param>
         <param name="startIndex">
@@ -1444,9 +1458,6 @@
         <Parameter Name="arg0" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after the operation has occurred.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="format" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -1521,6 +1532,10 @@ public class StringBuilderTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the string returned by processing a composite format string, which contains zero or more format items, to this instance. Each format item is replaced by the string representation of a single argument.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance with <paramref name="format" /> appended. Each format item in <paramref name="format" /> is replaced by the string representation of <paramref name="arg0" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A composite format string (see Remarks). </param>
         <param name="arg0">
@@ -1552,10 +1567,6 @@ public class StringBuilderTest {
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>
-          <para> The current instance after
-      operation has occurred.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="format" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -1634,6 +1645,10 @@ public class StringBuilderTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the string returned by processing a composite format string, which contains zero or more format items, to this instance. Each format item is replaced by the string representation of a corresponding argument in a parameter array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance with <paramref name="format" /> appended. Each format item in <paramref name="format" /> is replaced by the string representation of the corresponding object argument.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A composite format string (see Remarks). </param>
         <param name="args">
@@ -1666,9 +1681,6 @@ public class StringBuilderTest {
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after the operation has occurred.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="format" /> or <paramref name="args" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -1764,6 +1776,10 @@ public class StringBuilderTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the string returned by processing a composite format string, which contains zero or more format items, to this instance. Each format item is replaced by the string representation of a corresponding argument in a parameter array using a specified format provider.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the append operation has completed. After the append operation, this instance contains any data that existed before the operation, suffixed by a copy of <paramref name="format" /> where any format specification is replaced by the string representation of the corresponding object argument. </para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information. </param>
         <param name="format">
@@ -1792,9 +1808,6 @@ public class StringBuilderTest {
         <Parameter Name="arg1" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after the operation has occurred.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="format" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -1870,6 +1883,10 @@ public class StringBuilderTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the string returned by processing a composite format string, which contains zero or more format items, to this instance. Each format item is replaced by the string representation of either of two arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance with <paramref name="format" /> appended. Each format item in <paramref name="format" /> is replaced by the string representation of the corresponding object argument.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A composite format string (see Remarks). </param>
         <param name="arg0">
@@ -1899,9 +1916,6 @@ public class StringBuilderTest {
         <Parameter Name="arg2" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after the operation has occurred.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="format" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -1978,6 +1992,10 @@ public class StringBuilderTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the string returned by processing a composite format string, which contains zero or more format items, to this instance. Each format item is replaced by the string representation of either of three arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance with <paramref name="format" /> appended. Each format item in <paramref name="format" /> is replaced by the string representation of the corresponding object argument.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A composite format string (see Remarks). </param>
         <param name="arg0">
@@ -2007,7 +2025,6 @@ public class StringBuilderTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2018,6 +2035,10 @@ public class StringBuilderTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends the default line terminator to the end of the current <see cref="T:System.Text.StringBuilder" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the append operation has completed.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="AppendLine">
@@ -2040,7 +2061,6 @@ public class StringBuilderTest {
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2051,6 +2071,10 @@ public class StringBuilderTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Appends a copy of the specified string followed by the default line terminator to the end of the current <see cref="T:System.Text.StringBuilder" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the append operation has completed.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to append. </param>
       </Docs>
@@ -2143,7 +2167,6 @@ public class StringBuilderTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -2154,6 +2177,10 @@ public class StringBuilderTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes all characters from the current <see cref="T:System.Text.StringBuilder" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose <see cref="P:System.Text.StringBuilder.Length" /> is 0 (zero).</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CopyTo">
@@ -2216,10 +2243,6 @@ public class StringBuilderTest {
         <Parameter Name="capacity" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> equal to the
-   new <see cref="P:System.Text.StringBuilder.Capacity" /> of the current instance.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="capacity" /> is less zero. </exception>
         <remarks>
@@ -2230,6 +2253,10 @@ public class StringBuilderTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Ensures that the capacity of this instance of <see cref="T:System.Text.StringBuilder" /> is at least the specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new capacity of this instance.</para>
+        </returns>
         <param name="capacity">
           <attribution license="cc4" from="Microsoft" modified="false" />The minimum capacity to ensure. </param>
       </Docs>
@@ -2252,16 +2279,15 @@ public class StringBuilderTest {
         <Parameter Name="sb" Type="System.Text.StringBuilder" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the current instance and <paramref name="sb" /> have the same 
- value; otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this instance and <paramref name="sb" /> have equal string, <see cref="P:System.Text.StringBuilder.Capacity" />, and <see cref="P:System.Text.StringBuilder.MaxCapacity" /> values; otherwise, false.</para>
+        </returns>
         <param name="sb">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance, or null. </param>
       </Docs>
@@ -2285,10 +2311,6 @@ public class StringBuilderTest {
         <Parameter Name="value" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> The current instance after insertion has occurred.
-      </para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="index" /> is greater than the length of the current instance</para>
@@ -2305,6 +2327,10 @@ public class StringBuilderTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts the string representation of a Boolean value into this instance at the specified character position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the insert operation has completed.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The position in this instance where insertion begins. </param>
         <param name="value">
@@ -2330,9 +2356,6 @@ public class StringBuilderTest {
         <Parameter Name="value" Type="System.Byte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after insertion has occurred.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="index" /> is greater than the length of the current instance</para>
@@ -2349,6 +2372,10 @@ public class StringBuilderTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts the string representation of a specified 8-bit unsigned integer into this instance at the specified character position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the insert operation has completed.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The position in this instance where insertion begins. </param>
         <param name="value">
@@ -2374,9 +2401,6 @@ public class StringBuilderTest {
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after insertion has occurred.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="index" /> is greater than the length of the current instance</para>
@@ -2393,6 +2417,10 @@ public class StringBuilderTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts the string representation of a specified Unicode character into this instance at the specified character position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the insert operation has completed.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The position in this instance where insertion begins. </param>
         <param name="value">
@@ -2418,10 +2446,6 @@ public class StringBuilderTest {
         <Parameter Name="value" Type="System.Char[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> The current instance after insertion has occurred.
-      </para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="index" /> is greater than the length of the current instance </para>
@@ -2438,6 +2462,10 @@ public class StringBuilderTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts the string representation of a specified array of Unicode characters into this instance at the specified character position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the insert operation has completed.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The position in this instance where insertion begins. </param>
         <param name="value">
@@ -2463,9 +2491,6 @@ public class StringBuilderTest {
         <Parameter Name="value" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after insertion has occurred.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="index" /> is greater than the length of the current instance</para>
@@ -2482,6 +2507,10 @@ public class StringBuilderTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts the string representation of a decimal number into this instance at the specified character position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the insert operation has completed.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The position in this instance where insertion begins. </param>
         <param name="value">
@@ -2508,9 +2537,6 @@ public class StringBuilderTest {
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after insertion has occurred.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="index" /> is greater than the length of the current instance</para>
@@ -2527,6 +2553,10 @@ public class StringBuilderTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts the string representation of a double-precision floating-point number into this instance at the specified character position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the insert operation has completed.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The position in this instance where insertion begins. </param>
         <param name="value">
@@ -2553,10 +2583,6 @@ public class StringBuilderTest {
         <Parameter Name="value" Type="System.Int16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> The current instance after insertion has occurred.
-      </para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="index" /> is greater than the length of the current instance</para>
@@ -2573,6 +2599,10 @@ public class StringBuilderTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts the string representation of a specified 16-bit signed integer into this instance at the specified character position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the insert operation has completed.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The position in this instance where insertion begins. </param>
         <param name="value">
@@ -2598,9 +2628,6 @@ public class StringBuilderTest {
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after insertion has occurred.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="index" /> is greater than the length of the current instance</para>
@@ -2617,6 +2644,10 @@ public class StringBuilderTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts the string representation of a specified 32-bit signed integer into this instance at the specified character position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the insert operation has completed.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The position in this instance where insertion begins. </param>
         <param name="value">
@@ -2642,9 +2673,6 @@ public class StringBuilderTest {
         <Parameter Name="value" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after insertion has occurred.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="index" /> is greater than the length of the current instance </para>
@@ -2661,6 +2689,10 @@ public class StringBuilderTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts the string representation of a 64-bit signed integer into this instance at the specified character position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the insert operation has completed.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The position in this instance where insertion begins. </param>
         <param name="value">
@@ -2686,9 +2718,6 @@ public class StringBuilderTest {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after insertion has occurred.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="index" /> is greater than the length of the current instance</para>
@@ -2706,6 +2735,10 @@ public class StringBuilderTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts the string representation of an object into this instance at the specified character position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the insert operation has completed.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The position in this instance where insertion begins. </param>
         <param name="value">
@@ -2736,9 +2769,6 @@ public class StringBuilderTest {
         <Parameter Name="value" Type="System.SByte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after insertion has occurred.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="index" /> is greater than the length of the current instance</para>
@@ -2755,6 +2785,10 @@ public class StringBuilderTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts the string representation of a specified 8-bit signed integer into this instance at the specified character position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the insert operation has completed.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The position in this instance where insertion begins. </param>
         <param name="value">
@@ -2780,9 +2814,6 @@ public class StringBuilderTest {
         <Parameter Name="value" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after insertion has occurred.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="index" /> is greater than the length of the current instance</para>
@@ -2799,6 +2830,10 @@ public class StringBuilderTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts the string representation of a single-precision floating point number into this instance at the specified character position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the insert operation has completed.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The position in this instance where insertion begins. </param>
         <param name="value">
@@ -2825,9 +2860,6 @@ public class StringBuilderTest {
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after insertion has occurred.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="index" /> is greater than the length of the current instance </para>
@@ -2844,6 +2876,10 @@ public class StringBuilderTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts a string into this instance at the specified character position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the insert operation has completed.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The position in this instance where insertion begins. </param>
         <param name="value">
@@ -2874,9 +2910,6 @@ public class StringBuilderTest {
         <Parameter Name="value" Type="System.UInt16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after insertion has occurred.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="index" /> is greater than the length of the current instance</para>
@@ -2893,6 +2926,10 @@ public class StringBuilderTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts the string representation of a 16-bit unsigned integer into this instance at the specified character position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the insert operation has completed.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The position in this instance where insertion begins. </param>
         <param name="value">
@@ -2923,9 +2960,6 @@ public class StringBuilderTest {
         <Parameter Name="value" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after insertion has occurred.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="index" /> is greater than the length of the current instance</para>
@@ -2942,6 +2976,10 @@ public class StringBuilderTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts the string representation of a 32-bit unsigned integer into this instance at the specified character position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the insert operation has completed.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The position in this instance where insertion begins. </param>
         <param name="value">
@@ -2972,9 +3010,6 @@ public class StringBuilderTest {
         <Parameter Name="value" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after insertion has occurred.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="index" /> is greater than the length of the current instance</para>
@@ -2991,6 +3026,10 @@ public class StringBuilderTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts the string representation of a 64-bit unsigned integer into this instance at the specified character position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the insert operation has completed.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The position in this instance where insertion begins. </param>
         <param name="value">
@@ -3017,10 +3056,6 @@ public class StringBuilderTest {
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> The current instance after insertion has occurred.
-      </para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="index" /> is greater than the length of the current instance </para>
@@ -3040,6 +3075,10 @@ public class StringBuilderTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts one or more copies of a specified string into this instance at the specified character position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after insertion has completed.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The position in this instance where insertion begins. </param>
         <param name="value">
@@ -3069,9 +3108,6 @@ public class StringBuilderTest {
         <Parameter Name="charCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after insertion has occurred.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference, and <paramref name="startIndex" /> and <paramref name="charCount" /> are not both zero.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -3089,6 +3125,10 @@ public class StringBuilderTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Inserts the string representation of a specified subarray of Unicode characters into this instance at the specified character position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the insert operation has completed.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />The position in this instance where insertion begins. </param>
         <param name="value">
@@ -3175,10 +3215,6 @@ public class StringBuilderTest {
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> The current instance after removal has occurred.
-      </para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="startIndex" /> or <paramref name="length" /> is less than zero </para>
@@ -3217,6 +3253,10 @@ public class StringBuilderTest  {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the specified range of characters from this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance after the excise operation has completed.</para>
+        </returns>
         <param name="startIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based position in this instance where removal begins. </param>
         <param name="length">
@@ -3242,9 +3282,6 @@ public class StringBuilderTest  {
         <Parameter Name="newChar" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after substitution has occurred.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method performs an ordinal, case-sensitive comparison to identify occurrences of <paramref name="oldChar" /> in the current instance. The size of the current <see cref="T:System.Text.StringBuilder" /> instance is unchanged after the replacement. </para>
@@ -3253,6 +3290,10 @@ public class StringBuilderTest  {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Replaces all occurrences of a specified character in this instance with another specified character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance with <paramref name="oldChar" /> replaced by <paramref name="newChar" />.</para>
+        </returns>
         <param name="oldChar">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to replace. </param>
         <param name="newChar">
@@ -3278,11 +3319,6 @@ public class StringBuilderTest  {
         <Parameter Name="newValue" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> The current instance after substitution has
-      occurred.
-      </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="oldValue" /> is a null reference.</exception>
         <exception cref="T:System.ArgumentException">The length of <paramref name="oldvalue" /> is zero.</exception>
@@ -3294,6 +3330,10 @@ public class StringBuilderTest  {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Replaces all occurrences of a specified string in this instance with another specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance with all instances of <paramref name="oldValue" /> replaced by <paramref name="newValue" />.</para>
+        </returns>
         <param name="oldValue">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to replace. </param>
         <param name="newValue">
@@ -3321,9 +3361,6 @@ public class StringBuilderTest  {
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after substitution has occurred.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>The sum of <paramref name="startIndex" /> and <paramref name="count" /> is larger than the length of the current instance </para>
           <para>-or-</para>
@@ -3338,6 +3375,10 @@ public class StringBuilderTest  {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Replaces, within a substring of this instance, all occurrences of a specified character with another specified character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance with <paramref name="oldChar" /> replaced by <paramref name="newChar" /> in the range from <paramref name="startIndex" /> to <paramref name="startIndex" /> + <paramref name="count" /> -1.</para>
+        </returns>
         <param name="oldChar">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to replace. </param>
         <param name="newChar">
@@ -3369,9 +3410,6 @@ public class StringBuilderTest  {
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance after substitution has occurred.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <para>
             <paramref name="oldValue" /> is a null reference.</para>
@@ -3391,6 +3429,10 @@ public class StringBuilderTest  {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Replaces, within a substring of this instance, all occurrences of a specified string with another specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to this instance with all instances of <paramref name="oldValue" /> replaced by <paramref name="newValue" /> in the range from <paramref name="startIndex" /> to <paramref name="startIndex" /> + <paramref name="count" /> - 1.</para>
+        </returns>
         <param name="oldValue">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to replace. </param>
         <param name="newValue">
@@ -3449,9 +3491,6 @@ public class StringBuilderTest  {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representing the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You must call the <see cref="M:System.Text.StringBuilder.ToString" /> method to convert the <see cref="T:System.Text.StringBuilder" /> object to a <see cref="T:System.String" /> object before you can pass the string represented by the <see cref="T:System.Text.StringBuilder" /> object to a method that has a <see cref="T:System.String" /> parameter or display it in the user interface.</para>
@@ -3460,6 +3499,10 @@ public class StringBuilderTest  {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string whose value is the same as this instance.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -3481,9 +3524,6 @@ public class StringBuilderTest  {
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.String" /> representing the characters in the specified range.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="startIndex" /> or <paramref name="length" /> is less than zero. </para>
@@ -3498,6 +3538,10 @@ public class StringBuilderTest  {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of a substring of this instance to a <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string whose value is the same as the specified substring of this instance.</para>
+        </returns>
         <param name="startIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The starting position of the substring in this instance. </param>
         <param name="length">
diff --git a/mcs/class/corlib/Documentation/en/System.Text/UTF32Encoding.xml b/mcs/class/corlib/Documentation/en/System.Text/UTF32Encoding.xml
index eff3f2abecd..0aa7d69f42a 100644
--- a/mcs/class/corlib/Documentation/en/System.Text/UTF32Encoding.xml
+++ b/mcs/class/corlib/Documentation/en/System.Text/UTF32Encoding.xml
@@ -147,7 +147,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -168,6 +167,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Text.UTF32Encoding" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is an instance of <see cref="T:System.Text.UTF32Encoding" /> and is equal to the current object; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to compare with the current object. </param>
       </Docs>
@@ -187,7 +190,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -201,6 +203,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of bytes produced by encoding the characters in the specified <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes produced by encoding the specified characters.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the set of characters to encode. </param>
       </Docs>
@@ -226,7 +232,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -240,6 +245,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes produced by encoding the specified characters.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first character to encode. </param>
         <param name="count">
@@ -263,7 +272,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -277,6 +285,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of bytes produced by encoding a set of characters from the specified character array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes produced by encoding the specified characters.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />The character array containing the set of characters to encode. </param>
         <param name="index">
@@ -308,7 +320,6 @@
         <Parameter Name="byteCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -323,6 +334,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes a set of characters starting at the specified character pointer into a sequence of bytes that are stored starting at the specified byte pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of bytes written at the location indicated by the <paramref name="bytes" /> parameter.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first character to encode. </param>
         <param name="charCount">
@@ -352,7 +367,6 @@
         <Parameter Name="byteIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -367,6 +381,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes a set of characters from the specified character array into the specified byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of bytes written into <paramref name="bytes" />.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />The character array containing the set of characters to encode. </param>
         <param name="charIndex">
@@ -398,7 +416,6 @@
         <Parameter Name="byteIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -413,6 +430,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes a set of characters from the specified <see cref="T:System.String" /> into the specified byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of bytes written into <paramref name="bytes" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the set of characters to encode. </param>
         <param name="charIndex">
@@ -446,7 +467,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -457,6 +477,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of characters produced by decoding the specified sequence of bytes.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first byte to decode. </param>
         <param name="count">
@@ -480,7 +504,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -491,6 +514,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of characters produced by decoding the specified sequence of bytes.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array containing the sequence of bytes to decode. </param>
         <param name="index">
@@ -522,7 +549,6 @@
         <Parameter Name="charCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -534,6 +560,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes a sequence of bytes starting at the specified byte pointer into a set of characters that are stored starting at the specified character pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of characters written at the location indicated by <paramref name="chars" />.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first byte to decode. </param>
         <param name="byteCount">
@@ -563,7 +593,6 @@
         <Parameter Name="charIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -575,6 +604,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes a sequence of bytes from the specified byte array into the specified character array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of characters written into <paramref name="chars" />.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array containing the sequence of bytes to decode. </param>
         <param name="byteIndex">
@@ -600,7 +633,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -611,6 +643,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains a decoder that converts a UTF-32 encoded sequence of bytes into a sequence of Unicode characters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Text.Decoder" /> that converts a UTF-32 encoded sequence of bytes into a sequence of Unicode characters.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetEncoder">
@@ -626,7 +662,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -637,6 +672,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains an encoder that converts a sequence of Unicode characters into a UTF-32 encoded sequence of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Text.Encoder" /> that converts a sequence of Unicode characters into a UTF-32 encoded sequence of bytes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -652,13 +691,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the current <see cref="T:System.Text.UTF32Encoding" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetMaxByteCount">
@@ -676,7 +718,6 @@
         <Parameter Name="charCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -693,6 +734,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the maximum number of bytes produced by encoding the specified number of characters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum number of bytes produced by encoding the specified number of characters.</para>
+        </returns>
         <param name="charCount">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of characters to encode. </param>
       </Docs>
@@ -712,7 +757,6 @@
         <Parameter Name="byteCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -730,6 +774,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the maximum number of characters produced by decoding the specified number of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum number of characters produced by decoding the specified number of bytes.</para>
+        </returns>
         <param name="byteCount">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of bytes to decode. </param>
       </Docs>
@@ -747,7 +795,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -772,6 +819,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Unicode byte order mark encoded in UTF-32 format, if the constructor for this instance requests a byte order mark.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array containing the Unicode byte order mark, if the constructor for this instance requests a byte order mark. Otherwise, this method returns a byte array of length zero.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetString">
@@ -791,7 +842,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -802,6 +852,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes a range of bytes from a byte array into a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the results of decoding the specified sequence of bytes.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array containing the sequence of bytes to decode. </param>
         <param name="index">
diff --git a/mcs/class/corlib/Documentation/en/System.Text/UTF7Encoding.xml b/mcs/class/corlib/Documentation/en/System.Text/UTF7Encoding.xml
index f1fbd6978ee..a4a71db3bca 100644
--- a/mcs/class/corlib/Documentation/en/System.Text/UTF7Encoding.xml
+++ b/mcs/class/corlib/Documentation/en/System.Text/UTF7Encoding.xml
@@ -120,7 +120,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -130,6 +129,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified object is equal to the current <see cref="T:System.Text.UTF7Encoding" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is a <see cref="T:System.Text.UTF7Encoding" /> object and is equal to the current <see cref="T:System.Text.UTF7Encoding" /> object; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare to the current <see cref="T:System.Text.UTF7Encoding" /> object.</param>
       </Docs>
@@ -154,7 +157,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -164,6 +166,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of bytes produced by encoding the characters in the specified <see cref="T:System.String" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes produced by encoding the specified characters.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> object containing the set of characters to encode. </param>
       </Docs>
@@ -192,7 +198,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -202,6 +207,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes produced by encoding the specified characters.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first character to encode. </param>
         <param name="count">
@@ -226,7 +235,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To calculate the exact array size required by <see cref="M:System.Text.UTF7Encoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)" /> to store the resulting bytes, the application uses <see cref="M:System.Text.UTF7Encoding.GetByteCount(System.Char[],System.Int32,System.Int32)" />. To calculate the maximum array size, the application should use <see cref="M:System.Text.UTF7Encoding.GetMaxByteCount(System.Int32)" />. The <see cref="M:System.Text.UTF7Encoding.GetByteCount(System.Char[],System.Int32,System.Int32)" /> method generally allows allocation of less memory, while the <see cref="M:System.Text.UTF7Encoding.GetMaxByteCount(System.Int32)" /> method generally executes faster.</para>
@@ -235,6 +243,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of bytes produced by encoding a set of characters from the specified character array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes produced by encoding the specified characters.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />The character array containing the set of characters to encode. </param>
         <param name="index">
@@ -269,7 +281,6 @@
         <Parameter Name="byteCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -284,6 +295,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes a set of characters starting at the specified character pointer into a sequence of bytes that are stored starting at the specified byte pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of bytes written at the location indicated by <paramref name="bytes" />.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first character to encode. </param>
         <param name="charCount">
@@ -314,7 +329,6 @@
         <Parameter Name="byteIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To calculate the exact array size required by <see cref="M:System.Text.UTF7Encoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)" /> to store the resulting bytes, the application uses <see cref="M:System.Text.UTF7Encoding.GetByteCount(System.Char[],System.Int32,System.Int32)" />. To calculate the maximum array size, the application should use <see cref="M:System.Text.UTF7Encoding.GetMaxByteCount(System.Int32)" />. The <see cref="M:System.Text.UTF7Encoding.GetByteCount(System.Char[],System.Int32,System.Int32)" /> method generally allows allocation of less memory, while the <see cref="M:System.Text.UTF7Encoding.GetMaxByteCount(System.Int32)" /> method generally executes faster.</para>
@@ -328,6 +342,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes a set of characters from the specified character array into the specified byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of bytes written into <paramref name="bytes" />.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />The character array containing the set of characters to encode. </param>
         <param name="charIndex">
@@ -364,7 +382,6 @@
         <Parameter Name="byteIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -379,6 +396,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes a set of characters from the specified <see cref="T:System.String" /> into the specified byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of bytes written into <paramref name="bytes" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the set of characters to encode. </param>
         <param name="charIndex">
@@ -415,7 +436,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -425,6 +445,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of characters produced by decoding the specified sequence of bytes.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first byte to decode. </param>
         <param name="count">
@@ -449,7 +473,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To calculate the exact array size required by <see cref="M:System.Text.UTF7Encoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)" /> to store the resulting characters, use <see cref="M:System.Text.UTF7Encoding.GetCharCount(System.Byte[],System.Int32,System.Int32)" />. To calculate the maximum array size, the application should use <see cref="M:System.Text.UTF7Encoding.GetMaxCharCount(System.Int32)" />. The <see cref="M:System.Text.UTF7Encoding.GetCharCount(System.Byte[],System.Int32,System.Int32)" /> method generally allows allocation of less memory, while the <see cref="M:System.Text.UTF7Encoding.GetMaxCharCount(System.Int32)" /> method generally executes faster.</para>
@@ -458,6 +481,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of characters produced by decoding the specified sequence of bytes.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array containing the sequence of bytes to decode. </param>
         <param name="index">
@@ -492,7 +519,6 @@
         <Parameter Name="charCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -507,6 +533,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes a sequence of bytes starting at the specified byte pointer into a set of characters that are stored starting at the specified character pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of characters written at the location indicated by <paramref name="chars" />.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first byte to decode. </param>
         <param name="byteCount">
@@ -537,7 +567,6 @@
         <Parameter Name="charIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To calculate the exact array size required by <see cref="M:System.Text.UTF7Encoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)" /> to store the resulting characters, use <see cref="M:System.Text.UTF7Encoding.GetCharCount(System.Byte[],System.Int32,System.Int32)" />. To calculate the maximum array size, the application should use <see cref="M:System.Text.UTF7Encoding.GetMaxCharCount(System.Int32)" />. The <see cref="M:System.Text.UTF7Encoding.GetCharCount(System.Byte[],System.Int32,System.Int32)" /> method generally allows allocation of less memory, while the <see cref="M:System.Text.UTF7Encoding.GetMaxCharCount(System.Int32)" /> method generally executes faster.</para>
@@ -551,6 +580,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes a sequence of bytes from the specified byte array into the specified character array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of characters written into <paramref name="chars" />.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array containing the sequence of bytes to decode. </param>
         <param name="byteIndex">
@@ -577,7 +610,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.Decoder.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)" /> method converts sequential blocks of bytes into sequential blocks of characters, in a manner similar to the <see cref="M:System.Text.UTF7Encoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)" /> method of this class. However, a <see cref="T:System.Text.Decoder" /> maintains state information between calls so it can correctly decode byte sequences that span blocks. The <see cref="T:System.Text.Decoder" /> also preserves trailing bytes at the end of data blocks and uses the trailing bytes in the next decoding operation. Therefore, <see cref="M:System.Text.UTF7Encoding.GetDecoder" /> and <see cref="M:System.Text.UTF7Encoding.GetEncoder" /> are useful for network transmission and file operations, because those operations often deal with blocks of data instead of a complete data stream.</para>
@@ -586,6 +618,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains a decoder that converts a UTF-7 encoded sequence of bytes into a sequence of Unicode characters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Text.Decoder" /> that converts a UTF-7 encoded sequence of bytes into a sequence of Unicode characters.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetEncoder">
@@ -602,7 +638,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.Decoder.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)" /> method converts sequential blocks of bytes into sequential blocks of characters, in a manner similar to the <see cref="M:System.Text.UTF7Encoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)" /> method. However, a <see cref="T:System.Text.Decoder" /> maintains state information between calls so it can correctly decode byte sequences that span blocks. The <see cref="T:System.Text.Decoder" /> also preserves trailing bytes at the end of data blocks and uses the trailing bytes in the next decoding operation. Therefore, <see cref="M:System.Text.UTF7Encoding.GetDecoder" /> and <see cref="M:System.Text.UTF7Encoding.GetEncoder" /> are useful for network transmission and file operations, because those operations often deal with blocks of data instead of a complete data stream.</para>
@@ -611,6 +646,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains an encoder that converts a sequence of Unicode characters into a UTF-7 encoded sequence of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Text.Encoder" /> that converts a sequence of Unicode characters into a UTF-7 encoded sequence of bytes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -631,7 +670,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -641,6 +679,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for the current <see cref="T:System.Text.UTF7Encoding" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetMaxByteCount">
@@ -659,7 +701,6 @@
         <Parameter Name="charCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To calculate the exact array size required by <see cref="M:System.Text.UTF7Encoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)" /> to store the resulting bytes, the application uses <see cref="M:System.Text.UTF7Encoding.GetByteCount(System.Char[],System.Int32,System.Int32)" />. To calculate the maximum array size, the application should use <see cref="M:System.Text.UTF7Encoding.GetMaxByteCount(System.Int32)" />. The <see cref="M:System.Text.UTF7Encoding.GetByteCount(System.Char[],System.Int32,System.Int32)" /> method generally allows allocation of less memory, while the <see cref="M:System.Text.UTF7Encoding.GetMaxByteCount(System.Int32)" /> method generally executes faster.</para>
@@ -676,6 +717,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the maximum number of bytes produced by encoding the specified number of characters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum number of bytes produced by encoding the specified number of characters.</para>
+        </returns>
         <param name="charCount">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of characters to encode. </param>
       </Docs>
@@ -696,7 +741,6 @@
         <Parameter Name="byteCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To calculate the exact array size required by <see cref="M:System.Text.UTF7Encoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)" /> to store the resulting characters, the application uses <see cref="M:System.Text.UTF7Encoding.GetCharCount(System.Byte[],System.Int32,System.Int32)" />. To calculate the maximum array size, the application should use <see cref="M:System.Text.UTF7Encoding.GetMaxCharCount(System.Int32)" />. The <see cref="M:System.Text.UTF7Encoding.GetCharCount(System.Byte[],System.Int32,System.Int32)" /> method generally allows allocation of less memory, while the <see cref="M:System.Text.UTF7Encoding.GetMaxCharCount(System.Int32)" /> method generally executes faster.</para>
@@ -713,6 +757,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the maximum number of characters produced by decoding the specified number of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum number of characters produced by decoding the specified number of bytes.</para>
+        </returns>
         <param name="byteCount">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of bytes to decode. </param>
       </Docs>
@@ -739,7 +787,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -753,6 +800,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes a range of bytes from a byte array into a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the results of decoding the specified sequence of bytes.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array containing the sequence of bytes to decode. </param>
         <param name="index">
diff --git a/mcs/class/corlib/Documentation/en/System.Text/UTF8Encoding.xml b/mcs/class/corlib/Documentation/en/System.Text/UTF8Encoding.xml
index 0daf1fde96e..ad6e3f95a87 100644
--- a/mcs/class/corlib/Documentation/en/System.Text/UTF8Encoding.xml
+++ b/mcs/class/corlib/Documentation/en/System.Text/UTF8Encoding.xml
@@ -156,11 +156,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if value is a <see cref="T:System.Text.UTF8Encoding" /> and represents the same type and value as the 
-   current instance; otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Two <see cref="T:System.Text.UTF8Encoding" /> objects are considered equal if all of the following conditions are true: </para>
@@ -180,6 +175,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Text.UTF8Encoding" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is an instance of <see cref="T:System.Text.UTF8Encoding" /> and is equal to the current object; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to compare with the current instance. </param>
       </Docs>
@@ -202,9 +201,6 @@
         <Parameter Name="chars" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> that specifies the number of bytes necessary to encode <paramref name="chars" /> as a <see cref="T:System.Text.UTF8Encoding" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="chars " />is <see langword="null" />. </exception>
         <exception cref="T:System.ArgumentException">
@@ -225,6 +221,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of bytes produced by encoding the characters in the specified <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes produced by encoding the specified characters.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the set of characters to encode. </param>
       </Docs>
@@ -254,7 +254,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -268,6 +267,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes produced by encoding the specified characters.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first character to encode. </param>
         <param name="count">
@@ -293,10 +296,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the number of bytes necessary to encode the range in <paramref name="chars" /> from
-<paramref name="index" /> to <paramref name="index" /> + <paramref name="count" /> - 1 as a <see cref="T:System.Text.UTF8Encoding" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="chars " /> is <see langword="null" /> . </exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -323,6 +322,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of bytes produced by encoding a set of characters from the specified character array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes produced by encoding the specified characters.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />The character array containing the set of characters to encode. </param>
         <param name="index">
@@ -343,10 +346,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Byte" /> array
-   containing the values encoded from <paramref name="s" /> as a <see cref="T:System.Text.UTF8Encoding" />.</para>
-        </returns>
         <remarks>
           <para>If error-checking is turned off and an invalid surrogate
       sequence is detected, the invalid characters are ignored and are not encoded
@@ -365,6 +364,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes the characters in a specified <see cref="T:System.String" /> object into a sequence of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array that contains the encoded characters in the string specified by the <paramref name="s" /> parameter.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The character string to encode.</param>
       </Docs>
@@ -399,7 +402,6 @@
         <Parameter Name="byteCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -414,6 +416,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes a set of characters starting at the specified character pointer into a sequence of bytes that are stored starting at the specified byte pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of bytes written at the location indicated by <paramref name="bytes" />.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first character to encode. </param>
         <param name="charCount">
@@ -445,9 +451,6 @@
         <Parameter Name="byteIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> that indicates the number of bytes encoded into <paramref name="bytes" /> as a <see cref="T:System.Text.UTF8Encoding" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>
             <paramref name="bytes" /> does not contain sufficient space to store the encoded characters.</para>
@@ -478,6 +481,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes a set of characters from the specified character array into the specified byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of bytes written into <paramref name="bytes" />.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />The character array containing the set of characters to encode. </param>
         <param name="charIndex">
@@ -512,9 +519,6 @@
         <Parameter Name="byteIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> that indicates the number of bytes encoded into <paramref name="bytes" /> as a <see cref="T:System.Text.UTF8Encoding" /> . </para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>
             <paramref name="bytes" /> does not contain sufficient space to store the encoded characters.</para>
@@ -555,6 +559,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes a set of characters from the specified <see cref="T:System.String" /> into the specified byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of bytes written into <paramref name="bytes" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the set of characters to encode. </param>
         <param name="charIndex">
@@ -592,7 +600,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -603,6 +610,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of characters produced by decoding the specified sequence of bytes.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first byte to decode. </param>
         <param name="count">
@@ -628,10 +639,6 @@
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> that indicates the number of characters produced by decoding the range in <paramref name="bytes " />from
-<paramref name="index " />to <paramref name="index " />+ <paramref name="count" /> - 1 as a <see cref="T:System.Text.UTF8Encoding" /> . </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="bytes " /> is <see langword="null" />. </exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -653,6 +660,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of characters produced by decoding the specified sequence of bytes.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array containing the sequence of bytes to decode. </param>
         <param name="index">
@@ -688,7 +699,6 @@
         <Parameter Name="charCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -700,6 +710,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes a sequence of bytes starting at the specified byte pointer into a set of characters that are stored starting at the specified character pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of characters written at the location indicated by <paramref name="chars" />.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first byte to decode. </param>
         <param name="byteCount">
@@ -731,9 +745,6 @@
         <Parameter Name="charIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The number of characters decoded into <paramref name="chars" /> as a <see cref="T:System.Text.UTF8Encoding" /> . </para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>
             <paramref name="chars" /> does not contain sufficient space to store the decoded characters.</para>
@@ -763,6 +774,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes a sequence of bytes from the specified byte array into the specified character array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of characters written into <paramref name="chars" />.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array containing the sequence of bytes to decode. </param>
         <param name="byteIndex">
@@ -791,9 +806,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Text.Decoder" /> for the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.Decoder.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)" /> method converts sequential blocks of bytes into sequential blocks of characters, in a manner similar to the <see cref="M:System.Text.UTF8Encoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)" /> method of this class. However, a <see cref="T:System.Text.Decoder" /> maintains state information between calls so it can correctly decode byte sequences that span blocks. The <see cref="T:System.Text.Decoder" /> also preserves trailing bytes at the end of data blocks and uses the trailing bytes in the next decoding operation. Therefore, <see cref="M:System.Text.UTF8Encoding.GetDecoder" /> and <see cref="M:System.Text.UTF8Encoding.GetEncoder" /> are useful for network transmission and file operations, because those operations often deal with blocks of data instead of a complete data stream.</para>
@@ -803,6 +815,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains a decoder that converts a UTF-8 encoded sequence of bytes into a sequence of Unicode characters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Text.Decoder" /> that converts a UTF-8 encoded sequence of bytes into a sequence of Unicode characters.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -821,9 +837,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Text.Encoder" /> for the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.Encoder.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32,System.Boolean)" /> method converts sequential blocks of characters into sequential blocks of bytes, in a manner similar to the <see cref="M:System.Text.UTF8Encoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)" /> method. However, a <see cref="T:System.Text.Encoder" /> maintains state information between calls so it can correctly encode character sequences that span blocks. The <see cref="T:System.Text.Encoder" /> also preserves trailing characters at the end of data blocks and uses the trailing characters in the next encoding operation. For example, a data block might end with an unmatched high surrogate, and the matching low surrogate might be in the next data block. Therefore, <see cref="M:System.Text.UTF8Encoding.GetDecoder" /> and <see cref="M:System.Text.UTF8Encoding.GetEncoder" /> are useful for network transmission and file operations, because those operations often deal with blocks of data instead of a complete data stream.</para>
@@ -833,6 +846,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains an encoder that converts a sequence of Unicode characters into a UTF-8 encoded sequence of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Text.Encoder" /> that converts a sequence of Unicode characters into a UTF-8 encoded sequence of bytes.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -851,10 +868,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" />
-value containing a hash code for the current instance</para>
-        </returns>
         <remarks>
           <para>The algorithm used to generate the hash code is
       unspecified.</para>
@@ -866,6 +879,10 @@ value containing a hash code for the current instance</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the current instance.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -886,9 +903,6 @@ value containing a hash code for the current instance</para>
         <Parameter Name="charCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> that specifies the maximum number of bytes required to encode <paramref name="charCount" /> characters as a <see cref="T:System.Text.UTF8Encoding" /> . </para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="charCount" /> &lt; 0.</para>
@@ -909,6 +923,10 @@ value containing a hash code for the current instance</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the maximum number of bytes produced by encoding the specified number of characters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum number of bytes produced by encoding the specified number of characters.</para>
+        </returns>
         <param name="charCount">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of characters to encode. </param>
       </Docs>
@@ -931,9 +949,6 @@ value containing a hash code for the current instance</para>
         <Parameter Name="byteCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> that specifies the maximum number of characters produced by decoding <paramref name="byteCount" /> bytes as a <see cref="T:System.Text.UTF8Encoding" /> . </para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="byteCount" /> &lt; 0.</para>
@@ -954,6 +969,10 @@ value containing a hash code for the current instance</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the maximum number of characters produced by decoding the specified number of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum number of characters produced by decoding the specified number of bytes.</para>
+        </returns>
         <param name="byteCount">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of bytes to decode. </param>
       </Docs>
@@ -974,10 +993,6 @@ value containing a hash code for the current instance</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Byte" /> array
-   containing the UTF-8 encoding preamble.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Optionally, the <see cref="T:System.Text.UTF8Encoding" /> object provides a preamble, which is an array of bytes that can be prefixed to the sequence of bytes resulting from the encoding process. If the preamble contains a byte order mark (code point U+FEFF), it helps the decoder determine the byte order and the transformation format or UTF. The Unicode byte order mark (BOM) is serialized as EF BB BF (in hexadecimal).</para>
@@ -993,6 +1008,10 @@ value containing a hash code for the current instance</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Unicode byte order mark encoded in UTF-8 format, if the constructor for this instance requests a byte order mark.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array containing the Unicode byte order mark, if the constructor for this instance requests a byte order mark. Otherwise, this method returns a byte array of length zero.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1018,7 +1037,6 @@ value containing a hash code for the current instance</para>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1029,6 +1047,10 @@ value containing a hash code for the current instance</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes a range of bytes from a byte array into a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing the results of decoding the specified sequence of bytes.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array containing the sequence of bytes to decode. </param>
         <param name="index">
diff --git a/mcs/class/corlib/Documentation/en/System.Text/UnicodeEncoding.xml b/mcs/class/corlib/Documentation/en/System.Text/UnicodeEncoding.xml
index 2742ba47d83..95a459116fd 100644
--- a/mcs/class/corlib/Documentation/en/System.Text/UnicodeEncoding.xml
+++ b/mcs/class/corlib/Documentation/en/System.Text/UnicodeEncoding.xml
@@ -202,12 +202,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="value" /> represents the same type and value as the
-   current instance. If <paramref name="value" /> is a null reference or is not an
-   instance of <see cref="T:System.Text.UnicodeEncoding" />, returns <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Two <see cref="T:System.Text.UnicodeEncoding" /> objects are considered equal if all of the following conditions are true: </para>
@@ -227,6 +221,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Text.UnicodeEncoding" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is an instance of <see cref="T:System.Text.UnicodeEncoding" /> and is equal to the current object; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to compare with the current object. </param>
       </Docs>
@@ -249,11 +247,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" />
-containing the number of bytes needed to encode <paramref name="s" /> as Unicode-encoded
-characters. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is <see langword="null" />.</exception>
         <remarks>
@@ -268,6 +261,10 @@ characters. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of bytes produced by encoding the characters in the specified <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes produced by encoding the specified characters.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the set of characters to encode. </param>
       </Docs>
@@ -297,7 +294,6 @@ characters. </para>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -311,6 +307,10 @@ characters. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes produced by encoding the specified characters.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first character to encode. </param>
         <param name="count">
@@ -336,12 +336,6 @@ characters. </para>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> whose
-   value equals the number of bytes required to encode the range in <paramref name="chars" />
-   from <paramref name="index" /> to <paramref name="index" /> + <paramref name="count" /> - 1 as Unicode-encoded
-   characters.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="chars " /> is <see langword="null" /> . </exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -366,6 +360,10 @@ characters. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of bytes produced by encoding a set of characters from the specified character array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes produced by encoding the specified characters.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />The character array containing the set of characters to encode. </param>
         <param name="index">
@@ -433,7 +431,6 @@ characters. </para>
         <Parameter Name="byteCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -448,6 +445,10 @@ characters. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes a set of characters starting at the specified character pointer into a sequence of bytes that are stored starting at the specified byte pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of bytes written at the location indicated by the <paramref name="bytes" /> parameter.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first character to encode. </param>
         <param name="charCount">
@@ -479,11 +480,6 @@ characters. </para>
         <Parameter Name="byteIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" />
-containing the number of bytes encoded into <paramref name="bytes" /> as Unicode-encoded
-characters. </para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>
             <paramref name="bytes" /> does not contain sufficient space to store the encoded characters.</para>
@@ -524,6 +520,10 @@ characters. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes a set of characters from the specified character array into the specified byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of bytes written into <paramref name="bytes" />.</para>
+        </returns>
         <param name="chars">
           <attribution license="cc4" from="Microsoft" modified="false" />The character array containing the set of characters to encode. </param>
         <param name="charIndex">
@@ -558,11 +558,6 @@ characters. </para>
         <Parameter Name="byteIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> whose
-   value equals the number of bytes encoded into <paramref name="bytes" /> as Unicode-encoded
-   characters. </para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>
             <paramref name="bytes" /> does not contain sufficient space to store the encoded characters.</para>
@@ -603,6 +598,10 @@ characters. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Encodes a set of characters from the specified <see cref="T:System.String" /> into the specified byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of bytes written into <paramref name="bytes" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.String" /> containing the set of characters to encode. </param>
         <param name="charIndex">
@@ -640,7 +639,6 @@ characters. </para>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -651,6 +649,10 @@ characters. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of characters produced by decoding the specified sequence of bytes.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first byte to decode. </param>
         <param name="count">
@@ -676,11 +678,6 @@ characters. </para>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" />
-whose value equals the number of characters a call to <see cref="M:System.Text.UnicodeEncoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)" /> will produce if presented with the
-specified range of <paramref name="bytes" /> as Unicode-encoded characters.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="bytes " /> is <see langword="null" />. </exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -702,6 +699,10 @@ specified range of <paramref name="bytes" /> as Unicode-encoded characters.</par
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of characters produced by decoding the specified sequence of bytes.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array containing the sequence of bytes to decode. </param>
         <param name="index">
@@ -737,7 +738,6 @@ specified range of <paramref name="bytes" /> as Unicode-encoded characters.</par
         <Parameter Name="charCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -749,6 +749,10 @@ specified range of <paramref name="bytes" /> as Unicode-encoded characters.</par
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes a sequence of bytes starting at the specified byte pointer into a set of characters that are stored starting at the specified character pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of characters written at the location indicated by the <paramref name="chars" /> parameter.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />A pointer to the first byte to decode. </param>
         <param name="byteCount">
@@ -780,11 +784,6 @@ specified range of <paramref name="bytes" /> as Unicode-encoded characters.</par
         <Parameter Name="charIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" />
-containing the number of characters decoded into <paramref name="chars" /> as
-Unicode-encoded characters. </para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>
             <paramref name="chars" /> does not contain sufficient space to store the decoded characters.</para>
@@ -822,6 +821,10 @@ Unicode-encoded characters. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes a sequence of bytes from the specified byte array into the specified character array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The actual number of characters written into <paramref name="chars" />.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array containing the sequence of bytes to decode. </param>
         <param name="byteIndex">
@@ -850,11 +853,6 @@ Unicode-encoded characters. </para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Text.Decoder" /> object for
-   the current
-   instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.Decoder.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)" /> method converts sequential blocks of bytes into sequential blocks of characters, in a manner similar to the <see cref="M:System.Text.UnicodeEncoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)" />. However, a <see cref="T:System.Text.Decoder" /> maintains state information between calls so it can correctly decode byte sequences that span blocks. The <see cref="T:System.Text.Decoder" /> also preserves trailing bytes at the end of data blocks and uses the trailing bytes in the next decoding operation. Therefore, <see cref="M:System.Text.UnicodeEncoding.GetDecoder" /> and <see cref="M:System.Text.UnicodeEncoding.GetEncoder" /> are useful for network transmission and file operations, because those operations often deal with blocks of data instead of a complete data stream.</para>
@@ -864,6 +862,10 @@ Unicode-encoded characters. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains a decoder that converts a UTF-16 encoded sequence of bytes into a sequence of Unicode characters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Text.Decoder" /> that converts a UTF-16 encoded sequence of bytes into a sequence of Unicode characters.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -886,7 +888,6 @@ Unicode-encoded characters. </para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Text.Encoder.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32,System.Boolean)" /> method converts sequential blocks of characters into sequential blocks of bytes in a manner similar to the <see cref="M:System.Text.UnicodeEncoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)" /> method of this class. However, a <see cref="T:System.Text.Encoder" /> object maintains state information between calls so that it can correctly encode character sequences that span blocks. The <see cref="T:System.Text.Encoder" /> object also preserves trailing characters at the end of data blocks and uses the trailing characters in the next encoding operation. For example, a data block might end with an unmatched high surrogate, and the matching low surrogate might be in the next data block. Therefore, <see cref="M:System.Text.UnicodeEncoding.GetDecoder" /> and <see cref="M:System.Text.UnicodeEncoding.GetEncoder" /> are useful for network transmission and file operations, because those operations often deal with blocks of data instead of a complete data stream.</para>
@@ -896,6 +897,10 @@ Unicode-encoded characters. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains an encoder that converts a sequence of Unicode characters into a UTF-16 encoded sequence of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Text.Encoder" /> object that converts a sequence of Unicode characters into a UTF-16 encoded sequence of bytes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -913,10 +918,6 @@ Unicode-encoded characters. </para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" />
-containing the hash code for the current instance.</para>
-        </returns>
         <remarks>
           <para>The algorithm used to generate the hash code is
       unspecified.</para>
@@ -928,6 +929,10 @@ containing the hash code for the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the current <see cref="T:System.Text.UnicodeEncoding" /> object.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -948,11 +953,6 @@ containing the hash code for the current instance.</para>
         <Parameter Name="charCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" />
-containing the maximum number of bytes required to encode <paramref name="charCount" />
-characters as Unicode-encoded characters.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="charCount" /> &lt; 0.</para>
@@ -973,6 +973,10 @@ characters as Unicode-encoded characters.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the maximum number of bytes produced by encoding the specified number of characters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum number of bytes produced by encoding the specified number of characters.</para>
+        </returns>
         <param name="charCount">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of characters to encode. </param>
       </Docs>
@@ -995,11 +999,6 @@ characters as Unicode-encoded characters.</para>
         <Parameter Name="byteCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" />
-containing the maximum number of characters that would be produced by
-decoding <paramref name="byteCount" /> bytes as Unicode-encoded characters. </para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="byteCount" /> &lt; 0.</para>
@@ -1020,6 +1019,10 @@ decoding <paramref name="byteCount" /> bytes as Unicode-encoded characters. </pa
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the maximum number of characters produced by decoding the specified number of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The maximum number of characters produced by decoding the specified number of bytes.</para>
+        </returns>
         <param name="byteCount">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of bytes to decode. </param>
       </Docs>
@@ -1040,10 +1043,6 @@ decoding <paramref name="byteCount" /> bytes as Unicode-encoded characters. </pa
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Byte" /> array that identifies the <see cref="T:System.Text.Encoding" />
-implementation used to create a <see cref="T:System.IO.Stream" /> . </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Optionally, the <see cref="T:System.Text.UnicodeEncoding" /> object provides a preamble that is an array of bytes that can be prefixed to the sequence of bytes resulting from the encoding process. If the preamble contains a byte order mark (in Unicode, code point U+FEFF), it helps the decoder determine the byte order and the transformation format or UTF. </para>
@@ -1067,6 +1066,10 @@ implementation used to create a <see cref="T:System.IO.Stream" /> . </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Unicode byte order mark encoded in UTF-16 format, if the constructor for this instance requests a byte order mark.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte array containing the Unicode byte order mark, if the constructor for this instance requests a byte order mark. Otherwise, this method returns a byte array of length zero.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1093,7 +1096,6 @@ implementation used to create a <see cref="T:System.IO.Stream" /> . </para>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>With error detection, an invalid sequence causes this method to throw a <see cref="T:System.ArgumentException" />. Without error detection, invalid sequences are ignored, and no exception is thrown.</para>
@@ -1103,6 +1105,10 @@ implementation used to create a <see cref="T:System.IO.Stream" /> . </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decodes a range of bytes from a byte array into a string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> object containing the results of decoding the specified sequence of bytes.</para>
+        </returns>
         <param name="bytes">
           <attribution license="cc4" from="Microsoft" modified="false" />The byte array containing the sequence of bytes to decode. </param>
         <param name="index">
diff --git a/mcs/class/corlib/Documentation/en/System.Threading.Tasks/Parallel.xml b/mcs/class/corlib/Documentation/en/System.Threading.Tasks/Parallel.xml
index 366290c072e..7b9bcceacf1 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading.Tasks/Parallel.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading.Tasks/Parallel.xml
@@ -37,7 +37,6 @@
         <Parameter Name="body" Type="System.Action&lt;System.Int32,System.Threading.Tasks.ParallelLoopState&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="body" /> delegate is invoked once for each value in the iteration range (<paramref name="fromInclusive" />, <paramref name="toExclusive" />). It is provided with the following parameters: the iteration count (<see cref="T:System.Int32" />), and a <see cref="T:System.Threading.Tasks.ParallelLoopState" /> instance that may be used to break out of the loop prematurely.</para>
@@ -51,6 +50,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a for (For in Visual Basic) loop in which iterations may run in parallel and the state of the loop can be monitored and manipulated. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A  structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="fromInclusive">
           <attribution license="cc4" from="Microsoft" modified="false" />The start index, inclusive.</param>
         <param name="toExclusive">
@@ -75,7 +78,6 @@
         <Parameter Name="body" Type="System.Action&lt;System.Int32&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="body" /> delegate is invoked once for each value in the iteration range (<paramref name="fromInclusive" />, <paramref name="toExclusive" />). It is provided with the iteration count (<see cref="T:System.Int32" />) as a parameter.</para>
@@ -85,6 +87,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a for (For in Visual Basic) loop in which iterations may run in parallel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="fromInclusive">
           <attribution license="cc4" from="Microsoft" modified="false" />The start index, inclusive.</param>
         <param name="toExclusive">
@@ -109,7 +115,6 @@
         <Parameter Name="body" Type="System.Action&lt;System.Int64,System.Threading.Tasks.ParallelLoopState&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="body" /> delegate is invoked once for each value in the iteration range (<paramref name="fromInclusive" />, <paramref name="toExclusive" />). It is provided with the following parameters: the iteration count (<see cref="T:System.Int64" />), and a <see cref="T:System.Threading.Tasks.ParallelLoopState" /> instance that may be used to break out of the loop prematurely.</para>
@@ -123,6 +128,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a for (For in Visual Basic) loop with 64-bit indexes in which iterations may run in parallel and the state of the loop can be monitored and manipulated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Threading.Tasks.ParallelLoopResult" /> structure that contains information on what portion of the loop completed.</para>
+        </returns>
         <param name="fromInclusive">
           <attribution license="cc4" from="Microsoft" modified="false" />The start index, inclusive.</param>
         <param name="toExclusive">
@@ -147,7 +156,6 @@
         <Parameter Name="body" Type="System.Action&lt;System.Int64&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="body" /> delegate is invoked once for each value in the iteration range (<paramref name="fromInclusive" />, <paramref name="toExclusive" />). It is provided with the iteration count (<see cref="T:System.Int64" />) as a parameter.</para>
@@ -157,6 +165,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a for (For in Visual Basic) loop with 64-bit indexes in which iterations may run in parallel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="fromInclusive">
           <attribution license="cc4" from="Microsoft" modified="false" />The start index, inclusive.</param>
         <param name="toExclusive">
@@ -182,7 +194,6 @@
         <Parameter Name="body" Type="System.Action&lt;System.Int32,System.Threading.Tasks.ParallelLoopState&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="body" /> delegate is invoked once for each value in the iteration range (<paramref name="fromInclusive" />, <paramref name="toExclusive" />). It is provided with the following parameters: the iteration count (<see cref="T:System.Int32" />), and a <see cref="T:System.Threading.Tasks.ParallelLoopState" /> instance that may be used to break out of the loop prematurely.</para>
@@ -192,6 +203,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a for (For in Visual Basic) loop in which iterations may run in parallel, loop options can be configured, and the state of the loop can be monitored and manipulated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="fromInclusive">
           <attribution license="cc4" from="Microsoft" modified="false" />The start index, inclusive.</param>
         <param name="toExclusive">
@@ -219,7 +234,6 @@
         <Parameter Name="body" Type="System.Action&lt;System.Int32&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="body" /> delegate is invoked once for each value in the iteration range (<paramref name="fromInclusive" />, <paramref name="toExclusive" />). It is provided with the iteration count (<see cref="T:System.Int32" />) as a parameter.</para>
@@ -229,6 +243,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a for (For in Visual Basic) loop in which iterations may run in parallel and loop options can be configured.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A  structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="fromInclusive">
           <attribution license="cc4" from="Microsoft" modified="false" />The start index, inclusive.</param>
         <param name="toExclusive">
@@ -256,7 +274,6 @@
         <Parameter Name="body" Type="System.Action&lt;System.Int64,System.Threading.Tasks.ParallelLoopState&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="body" /> delegate is invoked once for each value in the iteration range (<paramref name="fromInclusive" />, <paramref name="toExclusive" />). It is provided with the following parameters: the iteration count (<see cref="T:System.Int64" />), and a <see cref="T:System.Threading.Tasks.ParallelLoopState" /> instance that may be used to break out of the loop prematurely.</para>
@@ -266,6 +283,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a for (For in Visual Basic)  loop with 64-bit indexes in which iterations may run in parallel, loop options can be configured, and the state of the loop can be monitored and manipulated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="fromInclusive">
           <attribution license="cc4" from="Microsoft" modified="false" />The start index, inclusive.</param>
         <param name="toExclusive">
@@ -293,7 +314,6 @@
         <Parameter Name="body" Type="System.Action&lt;System.Int64&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Supports 64-bit indexes. The <paramref name="body" /> delegate is invoked once for each value in the iteration range (<paramref name="fromInclusive" />, <paramref name="toExclusive" />). It is provided with the iteration count (<see cref="T:System.Int64" />) as a parameter.</para>
@@ -303,6 +323,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a for  (For in Visual Basic) loop with 64-bit indexes in which iterations may run in parallel and loop options can be configured.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="fromInclusive">
           <attribution license="cc4" from="Microsoft" modified="false" />The start index, inclusive.</param>
         <param name="toExclusive">
@@ -334,7 +358,6 @@
         <Parameter Name="localFinally" Type="System.Action&lt;TLocal&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="body" /> delegate is invoked once for each value in the iteration range (<paramref name="fromInclusive" />, <paramref name="toExclusive" />). It is provided with the following parameters: the iteration count (<see cref="T:System.Int32" />), a <see cref="T:System.Threading.Tasks.ParallelLoopState" /> instance that may be used to break out of the loop prematurely, and some local state that may be shared amongst iterations that execute on the same thread.</para>
@@ -347,6 +370,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a for (For in Visual Basic) loop with thread-local data in which iterations may run in parallel, and the state of the loop can be monitored and manipulated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A  structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="fromInclusive">
           <attribution license="cc4" from="Microsoft" modified="false" />The start index, inclusive.</param>
         <param name="toExclusive">
@@ -382,7 +409,6 @@
         <Parameter Name="localFinally" Type="System.Action&lt;TLocal&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="body" /> delegate is invoked once for each value in the iteration range (<paramref name="fromInclusive" />, <paramref name="toExclusive" />). It is provided with the following parameters: the iteration count (<see cref="T:System.Int64" />), a <see cref="T:System.Threading.Tasks.ParallelLoopState" /> instance that may be used to break out of the loop prematurely, and some local state that may be shared amongst iterations that execute on the same task.</para>
@@ -395,6 +421,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a for (For in Visual Basic)  loop with 64-bit indexes and thread-local data in which iterations may run in parallel, and the state of the loop can be monitored and manipulated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="fromInclusive">
           <attribution license="cc4" from="Microsoft" modified="false" />The start index, inclusive.</param>
         <param name="toExclusive">
@@ -431,7 +461,6 @@
         <Parameter Name="localFinally" Type="System.Action&lt;TLocal&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="body" /> delegate is invoked once for each value in the iteration range (<paramref name="fromInclusive" />, <paramref name="toExclusive" />). It is provided with the following parameters: the iteration count (<see cref="T:System.Int32" />), a <see cref="T:System.Threading.Tasks.ParallelLoopState" /> instance that may be used to break out of the loop prematurely, and some local state that may be shared amongst iterations that execute on the same task.</para>
@@ -443,6 +472,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a for (For in Visual Basic)  loop with thread-local data in which iterations may run in parallel, loop options can be configured, and the state of the loop can be monitored and manipulated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="fromInclusive">
           <attribution license="cc4" from="Microsoft" modified="false" />The start index, inclusive.</param>
         <param name="toExclusive">
@@ -481,7 +514,6 @@
         <Parameter Name="localFinally" Type="System.Action&lt;TLocal&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="body" /> delegate is invoked once for each value in the iteration range (<paramref name="fromInclusive" />, <paramref name="toExclusive" />). It is provided with the following parameters: the iteration count (<see cref="T:System.Int64" />), a <see cref="T:System.Threading.Tasks.ParallelLoopState" /> instance that may be used to break out of the loop prematurely, and some local state that may be shared amongst iterations that execute on the same thread.</para>
@@ -493,6 +525,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a for (For in Visual Basic) loop with 64-bit indexes and thread-local data in which iterations may run in parallel, loop options can be configured, and the state of the loop can be monitored and manipulated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="fromInclusive">
           <attribution license="cc4" from="Microsoft" modified="false" />The start index, inclusive.</param>
         <param name="toExclusive">
@@ -527,7 +563,6 @@
         <Parameter Name="body" Type="System.Action&lt;TSource,System.Threading.Tasks.ParallelLoopState,System.Int64&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload is provided for scenarios where you want to override the default partitioning scheme. For example, small loop bodies might benefit from partitioning the range. The <see cref="M:System.Threading.Tasks.Parallel.ForEach``1(System.Collections.Concurrent.Partitioner{``0},System.Action{``0})" /> method expects custom partitioners to support dynamic partitioning. For more information, see <format type="text/html"><a href="96153688-9a01-47c4-8430-909cee9a2887">Custom Partitioners for PLINQ and TPL</a></format> and <format type="text/html"><a href="c875ad12-a161-43e6-ad1c-3d6927c536a7">How to: Implement Dynamic Partitions</a></format>.</para>
@@ -536,6 +571,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a foreach (For Each in Visual Basic) operation on a <see cref="T:System.Collections.Concurrent.OrderablePartitioner`1" /> in which iterations may run in parallel and the state of the loop can be monitored and manipulated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The orderable partitioner that contains the original data source.</param>
         <param name="body">
@@ -562,7 +601,6 @@
         <Parameter Name="body" Type="System.Action&lt;TSource,System.Threading.Tasks.ParallelLoopState&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload is provided for scenarios where you want to override the default partitioning scheme. For example, small loop bodies might benefit from partitioning the range. The <see cref="M:System.Threading.Tasks.Parallel.ForEach``1(System.Collections.Concurrent.Partitioner{``0},System.Action{``0})" /> method expects custom partitioners to support dynamic partitioning. For more information, see <format type="text/html"><a href="96153688-9a01-47c4-8430-909cee9a2887">Custom Partitioners for PLINQ and TPL</a></format> and <format type="text/html"><a href="c875ad12-a161-43e6-ad1c-3d6927c536a7">How to: Implement Dynamic Partitions</a></format>.</para>
@@ -571,6 +609,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a foreach (For Each in Visual Basic) operation on a <see cref="T:System.Collections.Concurrent.Partitioner" /> in which iterations may run in parallel, and the state of the loop can be monitored and manipulated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The partitioner that contains the original data source.</param>
         <param name="body">
@@ -597,7 +639,6 @@
         <Parameter Name="body" Type="System.Action&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload is provided for scenarios where you want to override the default partitioning scheme. For example, small loop bodies might benefit from partitioning the range. The <see cref="M:System.Threading.Tasks.Parallel.ForEach``1(System.Collections.Concurrent.Partitioner{``0},System.Action{``0})" /> method expects custom partitioners to support dynamic partitioning. For more information, see <format type="text/html"><a href="96153688-9a01-47c4-8430-909cee9a2887">Custom Partitioners for PLINQ and TPL</a></format> and <format type="text/html"><a href="c875ad12-a161-43e6-ad1c-3d6927c536a7">How to: Implement Dynamic Partitions</a></format>.</para>
@@ -606,6 +647,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a foreach (For Each in Visual Basic) operation on a <see cref="T:System.Collections.Concurrent.Partitioner" /> in which iterations may run in parallel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The partitioner that contains the original data source.</param>
         <param name="body">
@@ -632,7 +677,6 @@
         <Parameter Name="body" Type="System.Action&lt;TSource,System.Threading.Tasks.ParallelLoopState,System.Int64&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="body" /> delegate is invoked once for each element in the <paramref name="source" /> enumerable. It is provided with the following parameters: the current element, a <see cref="T:System.Threading.Tasks.ParallelLoopState" /> instance that may be used to break out of the loop prematurely, and the current element's index (<see cref="T:System.Int64" />).</para>
@@ -641,6 +685,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a foreach (For Each in Visual Basic) operation with 64-bit indexes on an <see cref="T:System.Collections.IEnumerable" /> in which iterations may run in parallel, and the state of the loop can be monitored and manipulated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An enumerable data source.</param>
         <param name="body">
@@ -667,7 +715,6 @@
         <Parameter Name="body" Type="System.Action&lt;TSource,System.Threading.Tasks.ParallelLoopState&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="body" /> delegate is invoked once for each element in the <paramref name="source" /> enumerable. It is provided with the following parameters: the current element, and a <see cref="T:System.Threading.Tasks.ParallelLoopState" /> instance that may be used to break out of the loop prematurely.</para>
@@ -676,6 +723,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a foreach (For Each in Visual Basic) operation on an <see cref="T:System.Collections.IEnumerable" /> in which iterations may run in parallel, and the state of the loop can be monitored and manipulated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An enumerable data source.</param>
         <param name="body">
@@ -702,7 +753,6 @@
         <Parameter Name="body" Type="System.Action&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="body" /> delegate is invoked once for each element in the <paramref name="source" /> enumerable. It is provided with the current element as a parameter.</para>
@@ -711,6 +761,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a foreach (For Each in Visual Basic) operation on an <see cref="T:System.Collections.IEnumerable" /> in which iterations may run in parallel.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An enumerable data source.</param>
         <param name="body">
@@ -738,7 +792,6 @@
         <Parameter Name="body" Type="System.Action&lt;TSource,System.Threading.Tasks.ParallelLoopState,System.Int64&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload is provided for scenarios where you want to override the default partitioning scheme. For example, small loop bodies might benefit from partitioning the range. The <see cref="M:System.Threading.Tasks.Parallel.ForEach``1(System.Collections.Concurrent.Partitioner{``0},System.Action{``0})" />method expects custom partitioners to support dynamic partitioning. For more information, see <format type="text/html"><a href="96153688-9a01-47c4-8430-909cee9a2887">Custom Partitioners for PLINQ and TPL</a></format> and <format type="text/html"><a href="c875ad12-a161-43e6-ad1c-3d6927c536a7">How to: Implement Dynamic Partitions</a></format>.</para>
@@ -747,6 +800,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a foreach (For Each in Visual Basic) operation on a <see cref="T:System.Collections.Concurrent.OrderablePartitioner`1" /> in which iterations may run in parallel, loop options can be configured, and the state of the loop can be monitored and manipulated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The orderable partitioner that contains the original data source.</param>
         <param name="parallelOptions">
@@ -776,7 +833,6 @@
         <Parameter Name="body" Type="System.Action&lt;TSource,System.Threading.Tasks.ParallelLoopState&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload is provided for scenarios where you want to override the default partitioning scheme. For example, small loop bodies might benefit from partitioning the range. The <see cref="M:System.Threading.Tasks.Parallel.ForEach``1(System.Collections.Concurrent.Partitioner{``0},System.Action{``0})" /> method expects custom partitioners to support dynamic partitioning. For more information, see <format type="text/html"><a href="96153688-9a01-47c4-8430-909cee9a2887">Custom Partitioners for PLINQ and TPL</a></format> and <format type="text/html"><a href="c875ad12-a161-43e6-ad1c-3d6927c536a7">How to: Implement Dynamic Partitions</a></format>.</para>
@@ -785,6 +841,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a foreach (For Each in Visual Basic) operation on a <see cref="T:System.Collections.Concurrent.Partitioner" /> in which iterations may run in parallel, loop options can be configured, and the state of the loop can be monitored and manipulated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A  structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The partitioner that contains the original data source.</param>
         <param name="parallelOptions">
@@ -814,7 +874,6 @@
         <Parameter Name="body" Type="System.Action&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload is provided for scenarios where you want to override the default partitioning scheme. For example, small loop bodies might benefit from partitioning the range. The <see cref="M:System.Threading.Tasks.Parallel.ForEach``1(System.Collections.Concurrent.Partitioner{``0},System.Action{``0})" /> method expects custom partitioners to support dynamic partitioning. For more information, see <format type="text/html"><a href="96153688-9a01-47c4-8430-909cee9a2887">Custom Partitioners for PLINQ and TPL</a></format> and <format type="text/html"><a href="c875ad12-a161-43e6-ad1c-3d6927c536a7">How to: Implement Dynamic Partitions</a></format>.</para>
@@ -823,6 +882,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a foreach (For Each in Visual Basic) operation on a <see cref="T:System.Collections.Concurrent.Partitioner" /> in which iterations may run in parallel and loop options can be configured.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The partitioner that contains the original data source.</param>
         <param name="parallelOptions">
@@ -852,7 +915,6 @@
         <Parameter Name="body" Type="System.Action&lt;TSource,System.Threading.Tasks.ParallelLoopState,System.Int64&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="body" /> delegate is invoked once for each element in the <paramref name="source" /> enumerable. It is provided with the following parameters: the current element, a <see cref="T:System.Threading.Tasks.ParallelLoopState" /> instance that may be used to break out of the loop prematurely, and the current element's index (<see cref="T:System.Int64" />).</para>
@@ -861,6 +923,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a foreach (For Each in Visual Basic) operation with 64-bit indexes on an <see cref="T:System.Collections.IEnumerable" /> in which iterations may run in parallel, loop options can be configured, and the state of the loop can be monitored and manipulated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An enumerable data source.</param>
         <param name="parallelOptions">
@@ -890,7 +956,6 @@
         <Parameter Name="body" Type="System.Action&lt;TSource,System.Threading.Tasks.ParallelLoopState&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="body" /> delegate is invoked once for each element in the <paramref name="source" /> enumerable. It is provided with the following parameters: the current element, and a <see cref="T:System.Threading.Tasks.ParallelLoopState" /> instance that may be used to break out of the loop prematurely.</para>
@@ -899,6 +964,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a foreach (For Each in Visual Basic) operation on an <see cref="T:System.Collections.IEnumerable" /> in which iterations may run in parallel, loop options can be configured, and the state of the loop can be monitored and manipulated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An enumerable data source.</param>
         <param name="parallelOptions">
@@ -928,7 +997,6 @@
         <Parameter Name="body" Type="System.Action&lt;TSource&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="body" /> delegate is invoked once for each element in the <paramref name="source" /> enumerable. It is provided with the current element as a parameter.</para>
@@ -937,6 +1005,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a foreach (For Each in Visual Basic) operation on an <see cref="T:System.Collections.IEnumerable" /> in which iterations may run in parallel and loop options can be configured.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An enumerable data source.</param>
         <param name="parallelOptions">
@@ -968,7 +1040,6 @@
         <Parameter Name="localFinally" Type="System.Action&lt;TLocal&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload is provided for scenarios where you want to override the default partitioning scheme. For example, small loop bodies might benefit from partitioning the range. The <see cref="M:System.Threading.Tasks.Parallel.ForEach``1(System.Collections.Concurrent.Partitioner{``0},System.Action{``0})" /> method expects custom partitioners to support dynamic partitioning. For more information, see <format type="text/html"><a href="96153688-9a01-47c4-8430-909cee9a2887">Custom Partitioners for PLINQ and TPL</a></format> and <format type="text/html"><a href="c875ad12-a161-43e6-ad1c-3d6927c536a7">How to: Implement Dynamic Partitions</a></format>.</para>
@@ -979,6 +1050,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a foreach (For Each in Visual Basic) operation with thread-local data on a <see cref="T:System.Collections.Concurrent.OrderablePartitioner`1" /> in which iterations may run in parallel, loop options can be configured, and the state of the loop can be monitored and manipulated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The orderable partitioner that contains the original data source.</param>
         <param name="localInit">
@@ -1014,7 +1089,6 @@
         <Parameter Name="localFinally" Type="System.Action&lt;TLocal&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload is provided for scenarios where you want to override the default partitioning scheme. For example, small loop bodies might benefit from partitioning the range. The <see cref="M:System.Threading.Tasks.Parallel.ForEach``2(System.Collections.Concurrent.Partitioner{``0},System.Func{``1},System.Func{``0,System.Threading.Tasks.ParallelLoopState,``1,``1},System.Action{``1})" /> method expects custom partitioners to support dynamic partitioning. For more information, see <format type="text/html"><a href="96153688-9a01-47c4-8430-909cee9a2887">Custom Partitioners for PLINQ and TPL</a></format> and <format type="text/html"><a href="c875ad12-a161-43e6-ad1c-3d6927c536a7">How to: Implement Dynamic Partitions</a></format>.</para>
@@ -1025,6 +1099,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a foreach (For Each in Visual Basic) operation with thread-local data on a <see cref="T:System.Collections.Concurrent.Partitioner" /> in which iterations may run in parallel and the state of the loop can be monitored and manipulated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The partitioner that contains the original data source.</param>
         <param name="localInit">
@@ -1060,7 +1138,6 @@
         <Parameter Name="localFinally" Type="System.Action&lt;TLocal&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para> The <paramref name="body" /> delegate is invoked once for each element in the <paramref name="source" /> enumerable. It is provided with the following parameters: the current element, a <see cref="T:System.Threading.Tasks.ParallelLoopState" /> instance that may be used to break out of the loop prematurely, the current element's index (<see cref="T:System.Int64" />), and some local state that may be shared amongst iterations that execute on the same thread.</para>
@@ -1071,6 +1148,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a foreach (For Each in Visual Basic) operation with thread-local data on an <see cref="T:System.Collections.IEnumerable" /> in which iterations may run in parallel and the state of the loop can be monitored and manipulated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An enumerable data source.</param>
         <param name="localInit">
@@ -1106,7 +1187,6 @@
         <Parameter Name="localFinally" Type="System.Action&lt;TLocal&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para> The <paramref name="body" /> delegate is invoked once for each element in the <paramref name="source" /> enumerable. It is provided with the following parameters: the current element, a <see cref="T:System.Threading.Tasks.ParallelLoopState" /> instance that may be used to break out of the loop prematurely, and some local state that may be shared amongst iterations that execute on the same thread.</para>
@@ -1117,6 +1197,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a foreach (For Each in Visual Basic) operation with thread-local data on an <see cref="T:System.Collections.IEnumerable" /> in which iterations may run in parallel, and the state of the loop can be monitored and manipulated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An enumerable data source.</param>
         <param name="localInit">
@@ -1153,7 +1237,6 @@
         <Parameter Name="localFinally" Type="System.Action&lt;TLocal&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload is provided for scenarios where you want to override the default partitioning scheme. For example, small loop bodies might benefit from partitioning the range. The <see cref="M:System.Threading.Tasks.Parallel.ForEach``2(System.Collections.Concurrent.OrderablePartitioner{``0},System.Threading.Tasks.ParallelOptions,System.Func{``1},System.Func{``0,System.Threading.Tasks.ParallelLoopState,System.Int64,``1,``1},System.Action{``1})" /> method expects custom partitioners to support dynamic partitioning. For more information, see <format type="text/html"><a href="96153688-9a01-47c4-8430-909cee9a2887">Custom Partitioners for PLINQ and TPL</a></format> and <format type="text/html"><a href="c875ad12-a161-43e6-ad1c-3d6927c536a7">How to: Implement Dynamic Partitions</a></format>.</para>
@@ -1164,6 +1247,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a foreach (For Each in Visual Basic) operation with 64-bit indexes and  with thread-local data on a <see cref="T:System.Collections.Concurrent.OrderablePartitioner`1" /> in which iterations may run in parallel , loop options can be configured, and the state of the loop can be monitored and manipulated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The orderable partitioner that contains the original data source.</param>
         <param name="parallelOptions">
@@ -1202,7 +1289,6 @@
         <Parameter Name="localFinally" Type="System.Action&lt;TLocal&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This overload is provided for scenarios where you want to override the default partitioning scheme. For example, small loop bodies might benefit from partitioning the range. The <see cref="M:System.Threading.Tasks.Parallel.ForEach``2(System.Collections.Concurrent.Partitioner{``0},System.Threading.Tasks.ParallelOptions,System.Func{``1},System.Func{``0,System.Threading.Tasks.ParallelLoopState,``1,``1},System.Action{``1})" /> method expects custom partitioners to support dynamic partitioning. This overload is provided for scenarios with small loop bodies that might benefit from static range partitioning. Partitioners must support dynamic partitions.  For more information, see <format type="text/html"><a href="96153688-9a01-47c4-8430-909cee9a2887">Custom Partitioners for PLINQ and TPL</a></format> and <format type="text/html"><a href="c875ad12-a161-43e6-ad1c-3d6927c536a7">How to: Implement Dynamic Partitions</a></format>.</para>
@@ -1213,6 +1299,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a foreach (For Each in Visual Basic) operation  with thread-local data on a <see cref="T:System.Collections.Concurrent.Partitioner" /> in which iterations may run in parallel, loop options can be configured, and the state of the loop can be monitored and manipulated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The partitioner that contains the original data source.</param>
         <param name="parallelOptions">
@@ -1251,7 +1341,6 @@
         <Parameter Name="localFinally" Type="System.Action&lt;TLocal&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="body" /> delegate is invoked once for each element in the <paramref name="source" /> enumerable. It is provided with the following parameters: the current element, a <see cref="T:System.Threading.Tasks.ParallelLoopState" /> instance that may be used to break out of the loop prematurely, the current element's index (<see cref="T:System.Int64" />), and some local state that may be shared amongst iterations that execute on the same thread.</para>
@@ -1262,6 +1351,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a foreach (For Each in Visual Basic) operation with thread-local data and 64-bit indexes on an <see cref="T:System.Collections.IEnumerable" /> in which iterations may run in parallel, loop options can be configured, and the state of the loop can be monitored and manipulated.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An enumerable data source.</param>
         <param name="parallelOptions">
@@ -1300,7 +1393,6 @@
         <Parameter Name="localFinally" Type="System.Action&lt;TLocal&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para> The <paramref name="body" /> delegate is invoked once for each element in the <paramref name="source" /> enumerable. It is provided with the following parameters: the current element, a <see cref="T:System.Threading.Tasks.ParallelLoopState" /> instance that may be used to break out of the loop prematurely, and some local state that may be shared amongst iterations that execute on the same thread.</para>
@@ -1311,6 +1403,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes a foreach (For Each in Visual Basic) operation with thread-local data on an <see cref="T:System.Collections.IEnumerable" /> in which iterations may run in parallel, loop options can be configured, and the state of the loop can be monitored and manipulated..</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that contains information about which portion of the loop completed.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />An enumerable data source.</param>
         <param name="parallelOptions">
diff --git a/mcs/class/corlib/Documentation/en/System.Threading.Tasks/Task.xml b/mcs/class/corlib/Documentation/en/System.Threading.Tasks/Task.xml
index e2cf9524157..f2c62bd7225 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading.Tasks/Task.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading.Tasks/Task.xml
@@ -307,12 +307,15 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="continueOnCapturedContext" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Configures an awaiter used to await this <see cref="T:System.Threading.Tasks.Task" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object used to await this task.</para>
+        </returns>
         <param name="continueOnCapturedContext">
           <attribution license="cc4" from="Microsoft" modified="false" />true to attempt to marshal the continuation back to the original context captured; otherwise, false.</param>
       </Docs>
@@ -331,7 +334,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="continuationAction" Type="System.Action&lt;System.Threading.Tasks.Task&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned <see cref="T:System.Threading.Tasks.Task" /> will not be scheduled for execution until the current task has completed, whether it completes due to running to completion successfully, faulting due to an unhandled exception, or exiting out early due to being canceled.</para>
@@ -340,6 +342,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation that executes asynchronously when the target <see cref="T:System.Threading.Tasks.Task" /> completes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new continuation <see cref="T:System.Threading.Tasks.Task" />.</para>
+        </returns>
         <param name="continuationAction">
           <attribution license="cc4" from="Microsoft" modified="false" />An action to run when the <see cref="T:System.Threading.Tasks.Task" /> completes. When run, the delegate will be passed the completed task as an argument.</param>
       </Docs>
@@ -359,7 +365,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned <see cref="T:System.Threading.Tasks.Task" /> will not be scheduled for execution until the current task has completed, whether it completes due to running to completion successfully, faulting due to an unhandled exception, or exiting out early due to being canceled.</para>
@@ -368,6 +373,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation that executes when the target <see cref="T:System.Threading.Tasks.Task" /> completes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new continuation <see cref="T:System.Threading.Tasks.Task" />.</para>
+        </returns>
         <param name="continuationAction">
           <attribution license="cc4" from="Microsoft" modified="false" />An action to run when the <see cref="T:System.Threading.Tasks.Task" /> completes. When run, the delegate will be passed the completed task as and the caller-supplied state object as arguments.</param>
         <param name="state">
@@ -389,7 +398,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned <see cref="T:System.Threading.Tasks.Task" /> will not be scheduled for execution until the current task has completed, whether it completes due to running to completion successfully, faulting due to an unhandled exception, or exiting out early due to being canceled.</para>
@@ -398,6 +406,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation that executes asynchronously when the target <see cref="T:System.Threading.Tasks.Task" /> completes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new continuation <see cref="T:System.Threading.Tasks.Task" />.</para>
+        </returns>
         <param name="continuationAction">
           <attribution license="cc4" from="Microsoft" modified="false" />An action to run when the <see cref="T:System.Threading.Tasks.Task" /> completes. When run, the delegate will be passed the completed task as an argument.</param>
         <param name="cancellationToken">
@@ -419,7 +431,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="continuationOptions" Type="System.Threading.Tasks.TaskContinuationOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned <see cref="T:System.Threading.Tasks.Task" /> will not be scheduled for execution until the current task has completed. If the continuation criteria specified through the <paramref name="continuationOptions" /> parameter are not met, the continuation task will be canceled instead of scheduled.</para>
@@ -428,6 +439,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation that executes according to the specified <see cref="T:System.Threading.Tasks.TaskContinuationOptions" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new continuation <see cref="T:System.Threading.Tasks.Task" />.</para>
+        </returns>
         <param name="continuationAction">
           <attribution license="cc4" from="Microsoft" modified="false" />An action to run according to the specified <paramref name="continuationOptions" />. When run, the delegate will be passed the completed task as an argument.</param>
         <param name="continuationOptions">
@@ -449,7 +464,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="scheduler" Type="System.Threading.Tasks.TaskScheduler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned <see cref="T:System.Threading.Tasks.Task" /> will not be scheduled for execution until the current task has completed, whether it completes due to running to completion successfully, faulting due to an unhandled exception, or exiting out early due to being canceled.</para>
@@ -458,6 +472,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation that executes asynchronously when the target <see cref="T:System.Threading.Tasks.Task" /> completes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new continuation <see cref="T:System.Threading.Tasks.Task" />.</para>
+        </returns>
         <param name="continuationAction">
           <attribution license="cc4" from="Microsoft" modified="false" />An action to run when the <see cref="T:System.Threading.Tasks.Task" /> completes. When run, the delegate will be passed the completed task as an argument.</param>
         <param name="scheduler">
@@ -480,7 +498,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned <see cref="T:System.Threading.Tasks.Task" /> will not be scheduled for execution until the current task has  completed, whether it completes due to running to completion successfully, faulting due to an  unhandled exception, or exiting out early due to being canceled.</para>
@@ -489,6 +506,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation that executes when the target <see cref="T:System.Threading.Tasks.Task" /> completes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new continuation <see cref="T:System.Threading.Tasks.Task" />.</para>
+        </returns>
         <param name="continuationAction">
           <attribution license="cc4" from="Microsoft" modified="false" />An action to run when the <see cref="T:System.Threading.Tasks.Task" /> completes. When run, the delegate will be passed the completed task and the caller-supplied state object as arguments.</param>
         <param name="state">
@@ -513,7 +534,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="continuationOptions" Type="System.Threading.Tasks.TaskContinuationOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned <see cref="T:System.Threading.Tasks.Task" /> will not be scheduled for execution until the current task has completed. If the continuation criteria specified through the <paramref name="continuationOptions" /> parameter are not met, the continuation task will be canceled instead of scheduled.</para>
@@ -522,6 +542,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation that executes when the target <see cref="T:System.Threading.Tasks.Task" /> completes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new continuation <see cref="T:System.Threading.Tasks.Task" />.</para>
+        </returns>
         <param name="continuationAction">
           <attribution license="cc4" from="Microsoft" modified="false" />An action to run when the <see cref="T:System.Threading.Tasks.Task" /> completes. When run, the delegate will be  passed the completed task and the caller-supplied state object as arguments.</param>
         <param name="state">
@@ -546,7 +570,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="scheduler" Type="System.Threading.Tasks.TaskScheduler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned <see cref="T:System.Threading.Tasks.Task" /> will not be scheduled for execution until the current task has  completed, whether it completes due to running to completion successfully, faulting due to an  unhandled exception, or exiting out early due to being canceled.</para>
@@ -555,6 +578,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation that executes when the target <see cref="T:System.Threading.Tasks.Task" /> completes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new continuation <see cref="T:System.Threading.Tasks.Task" />.</para>
+        </returns>
         <param name="continuationAction">
           <attribution license="cc4" from="Microsoft" modified="false" />An action to run when the <see cref="T:System.Threading.Tasks.Task" /> completes.  When run, the delegate will be  passed the completed task and the caller-supplied state object as arguments.</param>
         <param name="state">
@@ -580,7 +607,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="scheduler" Type="System.Threading.Tasks.TaskScheduler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned <see cref="T:System.Threading.Tasks.Task" /> will not be scheduled for execution until the current task has completed. If the criteria specified through the <paramref name="continuationOptions" /> parameter are not met, the continuation task will be canceled instead of scheduled.</para>
@@ -589,6 +615,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation that executes according to the specified <see cref="T:System.Threading.Tasks.TaskContinuationOptions" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new continuation <see cref="T:System.Threading.Tasks.Task" />.</para>
+        </returns>
         <param name="continuationAction">
           <attribution license="cc4" from="Microsoft" modified="false" />An action to run according to the specified <paramref name="continuationOptions" />. When run, the delegate will be passed the completed task as an argument.</param>
         <param name="cancellationToken">
@@ -617,7 +647,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="scheduler" Type="System.Threading.Tasks.TaskScheduler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned <see cref="T:System.Threading.Tasks.Task" /> will not be scheduled for execution until the current task has  completed. If the criteria specified through the <paramref name="continuationOptions" /> parameter  are not met, the continuation task will be canceled instead of scheduled.</para>
@@ -626,6 +655,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation that executes when the target <see cref="T:System.Threading.Tasks.Task" /> completes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new continuation <see cref="T:System.Threading.Tasks.Task" />.</para>
+        </returns>
         <param name="continuationAction">
           <attribution license="cc4" from="Microsoft" modified="false" />An action to run when the <see cref="T:System.Threading.Tasks.Task" /> completes. When run, the delegate will be  passed the completed task and the caller-supplied state object as arguments.</param>
         <param name="state">
@@ -655,7 +688,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="continuationFunction" Type="System.Func&lt;System.Threading.Tasks.Task,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned <see cref="T:System.Threading.Tasks.Task`1" /> will not be scheduled for execution until the current task has completed, whether it completes due to running to completion successfully, faulting due to an unhandled exception, or exiting out early due to being canceled.</para>
@@ -664,6 +696,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation that executes asynchronously when the target <see cref="T:System.Threading.Tasks.Task" /> completes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new continuation <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="continuationFunction">
           <attribution license="cc4" from="Microsoft" modified="false" />A function to run when the <see cref="T:System.Threading.Tasks.Task" /> completes. When run, the delegate will be passed the completed task as an argument.</param>
         <typeparam name="TResult">
@@ -688,7 +724,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned <see cref="T:System.Threading.Tasks.Task`1" /> will not be scheduled for execution until the current task has  completed, whether it completes due to running to completion successfully, faulting due to an  unhandled exception, or exiting out early due to being canceled.</para>
@@ -697,6 +732,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation that executes when the target <see cref="T:System.Threading.Tasks.Task" /> completes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new continuation <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="continuationFunction">
           <attribution license="cc4" from="Microsoft" modified="false" />A function to run when the <see cref="T:System.Threading.Tasks.Task" /> completes. When run, the delegate will be  passed the completed task and the caller-supplied state object as arguments.</param>
         <param name="state">
@@ -723,7 +762,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned <see cref="T:System.Threading.Tasks.Task`1" /> will not be scheduled for execution until the current task has completed, whether it completes due to running to completion successfully, faulting due to an unhandled exception, or exiting out early due to being canceled.</para>
@@ -732,6 +770,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation that executes asynchronously when the target <see cref="T:System.Threading.Tasks.Task" /> completes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new continuation <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="continuationFunction">
           <attribution license="cc4" from="Microsoft" modified="false" />A function to run when the <see cref="T:System.Threading.Tasks.Task" /> completes. When run, the delegate will be passed the completed task as an argument.</param>
         <param name="cancellationToken">
@@ -758,7 +800,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="continuationOptions" Type="System.Threading.Tasks.TaskContinuationOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned <see cref="T:System.Threading.Tasks.Task`1" /> will not be scheduled for execution until the current task has completed. If the continuation criteria specified through the <paramref name="continuationOptions" /> parameter are not met, the continuation task will be canceled instead of scheduled.</para>
@@ -767,6 +808,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation that executes according to the condition specified in <paramref name="continuationOptions" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new continuation <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="continuationFunction">
           <attribution license="cc4" from="Microsoft" modified="false" />A function to run according to the condition specified in <paramref name="continuationOptions" />. When run, the delegate will be passed the completed task as an argument.</param>
         <param name="continuationOptions">
@@ -793,7 +838,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="scheduler" Type="System.Threading.Tasks.TaskScheduler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned <see cref="T:System.Threading.Tasks.Task`1" /> will not be scheduled for execution until the current task has completed, whether it completes due to running to completion successfully, faulting due to an unhandled exception, or exiting out early due to being canceled.</para>
@@ -802,6 +846,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation that executes asynchronously when the target <see cref="T:System.Threading.Tasks.Task" /> completes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new continuation <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="continuationFunction">
           <attribution license="cc4" from="Microsoft" modified="false" />A function to run when the <see cref="T:System.Threading.Tasks.Task" /> completes. When run, the delegate will be passed the completed task as an argument.</param>
         <param name="scheduler">
@@ -829,7 +877,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned <see cref="T:System.Threading.Tasks.Task`1" /> will not be scheduled for execution until the current task has  completed, whether it completes due to running to completion successfully, faulting due to an  unhandled exception, or exiting out early due to being canceled.</para>
@@ -838,6 +885,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation that executes when the target <see cref="T:System.Threading.Tasks.Task" /> completes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new continuation <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="continuationFunction">
           <attribution license="cc4" from="Microsoft" modified="false" />A function to run when the <see cref="T:System.Threading.Tasks.Task" /> completes. When run, the delegate will be  passed the completed task and the caller-supplied state object as arguments.</param>
         <param name="state">
@@ -867,7 +918,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="continuationOptions" Type="System.Threading.Tasks.TaskContinuationOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned <see cref="T:System.Threading.Tasks.Task`1" /> will not be scheduled for execution until the current task has completed. If the continuation criteria specified through the <paramref name="continuationOptions" /> parameter are not met, the continuation task will be canceled instead of scheduled.</para>
@@ -876,6 +926,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation that executes when the target <see cref="T:System.Threading.Tasks.Task" /> completes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new continuation <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="continuationFunction">
           <attribution license="cc4" from="Microsoft" modified="false" />A function to run when the <see cref="T:System.Threading.Tasks.Task" /> completes. When run, the delegate will be  passed the completed task and the caller-supplied state object as arguments.</param>
         <param name="state">
@@ -905,7 +959,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="scheduler" Type="System.Threading.Tasks.TaskScheduler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned <see cref="T:System.Threading.Tasks.Task`1" /> will not be scheduled for execution until the current task has  completed, whether it completes due to running to completion successfully, faulting due to an  unhandled exception, or exiting out early due to being canceled.</para>
@@ -914,6 +967,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation that executes when the target <see cref="T:System.Threading.Tasks.Task" /> completes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new continuation <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="continuationFunction">
           <attribution license="cc4" from="Microsoft" modified="false" />A function to run when the <see cref="T:System.Threading.Tasks.Task" /> completes.  When run, the delegate will be  passed the completed task and the caller-supplied state object as arguments.</param>
         <param name="state">
@@ -944,7 +1001,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="scheduler" Type="System.Threading.Tasks.TaskScheduler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned <see cref="T:System.Threading.Tasks.Task`1" /> will not be scheduled for execution until the current task has completed. If the criteria specified through the <paramref name="continuationOptions" /> parameter are not met, the continuation task will be canceled instead of scheduled.</para>
@@ -953,6 +1009,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation that executes according to the condition specified in <paramref name="continuationOptions" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new continuation <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="continuationFunction">
           <attribution license="cc4" from="Microsoft" modified="false" />A function to run according to the specified <paramref name="continuationOptions." /> When run, the delegate will be passed the completed task as an argument.</param>
         <param name="cancellationToken">
@@ -986,7 +1046,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="scheduler" Type="System.Threading.Tasks.TaskScheduler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned <see cref="T:System.Threading.Tasks.Task`1" /> will not be scheduled for execution until the current task has  completed. If the criteria specified through the <paramref name="continuationOptions" /> parameter  are not met, the continuation task will be canceled instead of scheduled.</para>
@@ -995,6 +1054,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation that executes when the target <see cref="T:System.Threading.Tasks.Task" /> completes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new continuation <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="continuationFunction">
           <attribution license="cc4" from="Microsoft" modified="false" />A function to run when the <see cref="T:System.Threading.Tasks.Task" /> completes. When run, the delegate will be  passed the completed task and the caller-supplied state object as arguments.</param>
         <param name="state">
@@ -1061,7 +1124,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="millisecondsDelay" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>After the specified time delay, the task is completed in RanToCompletion state.</para>
@@ -1070,6 +1132,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a task that will complete after a time delay.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the time delay</para>
+        </returns>
         <param name="millisecondsDelay">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of milliseconds to wait before completing the returned task</param>
       </Docs>
@@ -1088,7 +1154,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="delay" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>After the specified time delay, the task is completed in <see cref="F:System.Threading.Tasks.TaskStatus.RanToCompletion" /> state.</para>
@@ -1097,6 +1162,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a task that will complete after a time delay.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the time delay</para>
+        </returns>
         <param name="delay">
           <attribution license="cc4" from="Microsoft" modified="false" />The time span to wait before completing the returned task</param>
       </Docs>
@@ -1116,7 +1185,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the cancellation token is signaled before the specified time delay, then the task is completed in  Canceled state.  Otherwise, the task is completed in RanToCompletion state once the specified time  delay has expired.</para>
@@ -1125,6 +1193,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a task that will complete after a time delay.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the time delay</para>
+        </returns>
         <param name="millisecondsDelay">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of milliseconds to wait before completing the returned task</param>
         <param name="cancellationToken">
@@ -1146,7 +1218,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the cancellation token is signaled before the specified time delay, then the task is completed in <see cref="F:System.Threading.Tasks.TaskStatus.Canceled" /> state.  Otherwise, the task is completed in <see cref="F:System.Threading.Tasks.TaskStatus.RanToCompletion" /> state once the specified time delay has expired.</para>
@@ -1155,6 +1226,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a task that will complete after a time delay.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the time delay</para>
+        </returns>
         <param name="delay">
           <attribution license="cc4" from="Microsoft" modified="false" />The time span to wait before completing the returned task</param>
         <param name="cancellationToken">
@@ -1286,7 +1361,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is intended for compiler user rather than use directly in code.</para>
@@ -1295,6 +1369,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an awaiter used to await this <see cref="T:System.Threading.Tasks.Task" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An awaiter instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Id">
@@ -1400,7 +1478,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="action" Type="System.Action" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Threading.Tasks.Task.Run(System.Action)" /> method is a simpler alternative to the <see cref="M:System.Threading.Tasks.TaskFactory.StartNew(System.Action)" /> method. It creates a task with the following default values: </para>
@@ -1420,6 +1497,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Queues the specified work to run on the ThreadPool and returns a task handle for that work.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the work queued to execute in the ThreadPool.</para>
+        </returns>
         <param name="action">
           <attribution license="cc4" from="Microsoft" modified="false" />The work to execute asynchronously</param>
       </Docs>
@@ -1438,12 +1519,15 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="function" Type="System.Func&lt;System.Threading.Tasks.Task&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Queues the specified work to run on the ThreadPool and returns a proxy for the  task returned by <paramref name="function" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents a proxy for the task returned by <paramref name="function" />.</para>
+        </returns>
         <param name="function">
           <attribution license="cc4" from="Microsoft" modified="false" />The work to execute asynchronously</param>
       </Docs>
@@ -1463,7 +1547,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Threading.Tasks.Task.Run(System.Action,System.Threading.CancellationToken)" /> method is a simpler alternative to the <see cref="M:System.Threading.Tasks.TaskFactory.StartNew(System.Action,System.Threading.CancellationToken)" />  method. It creates a task with the following default values: </para>
@@ -1480,6 +1563,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Queues the specified work to run on the ThreadPool and returns a task handle for that work.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the work queued to execute in the ThreadPool.</para>
+        </returns>
         <param name="action">
           <attribution license="cc4" from="Microsoft" modified="false" />The work to execute asynchronously</param>
         <param name="cancellationToken">
@@ -1501,12 +1588,15 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Queues the specified work to run on the ThreadPool and returns a proxy for the  task returned by <paramref name="function" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents a proxy for the task returned by <paramref name="function" />.</para>
+        </returns>
         <param name="function">
           <attribution license="cc4" from="Microsoft" modified="false" />The work to execute asynchronously</param>
         <param name="cancellationToken">
@@ -1530,12 +1620,15 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="function" Type="System.Func&lt;System.Threading.Tasks.Task&lt;TResult&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Queues the specified work to run on the ThreadPool and returns a proxy for the  Task(TResult) returned by <paramref name="function" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Task(TResult) that represents a proxy for the Task(TResult) returned by <paramref name="function" />.</para>
+        </returns>
         <param name="function">
           <attribution license="cc4" from="Microsoft" modified="false" />The work to execute asynchronously</param>
         <typeparam name="TResult">
@@ -1559,7 +1652,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="function" Type="System.Func&lt;TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Threading.Tasks.Task.Run``1(System.Func{``0})" /> method is a simpler alternative to the <see cref="M:System.Threading.Tasks.TaskFactory.StartNew(System.Action)" /> method. It creates a task with the following default values: </para>
@@ -1579,6 +1671,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Queues the specified work to run on the ThreadPool and returns a Task(TResult) handle for that work.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Task(TResult) that represents the work queued to execute in the ThreadPool.</para>
+        </returns>
         <param name="function">
           <attribution license="cc4" from="Microsoft" modified="false" />The work to execute asynchronously</param>
         <typeparam name="TResult">
@@ -1603,12 +1699,15 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Queues the specified work to run on the ThreadPool and returns a proxy for the  Task(TResult) returned by <paramref name="function" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Task(TResult) that represents a proxy for the Task(TResult) returned by <paramref name="function" />.</para>
+        </returns>
         <param name="function">
           <attribution license="cc4" from="Microsoft" modified="false" />The work to execute asynchronously</param>
         <param name="cancellationToken">
@@ -1635,7 +1734,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Threading.Tasks.Task.Run``1(System.Func{``0},System.Threading.CancellationToken)" /> method is a simpler alternative to the <see cref="M:System.Threading.Tasks.TaskFactory.StartNew(System.Action)" /> method. It creates a task with the following default values: </para>
@@ -1652,6 +1750,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Queues the specified work to run on the thread pool and returns a Task(TResult) handle for that work.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Task(TResult) that represents the work queued to execute in the ThreadPool.</para>
+        </returns>
         <param name="function">
           <attribution license="cc4" from="Microsoft" modified="false" />The work to execute asynchronously</param>
         <param name="cancellationToken">
@@ -1860,12 +1962,15 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="millisecondsTimeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits for the <see cref="T:System.Threading.Tasks.Task" /> to complete execution within a specified number of milliseconds.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Threading.Tasks.Task" /> completed execution within the allotted time; otherwise, false.</para>
+        </returns>
         <param name="millisecondsTimeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of milliseconds to wait, or <see cref="F:System.Threading.Timeout.Infinite" /> (-1) to wait indefinitely.</param>
       </Docs>
@@ -1907,12 +2012,15 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits for the <see cref="T:System.Threading.Tasks.Task" /> to complete execution within a specified time interval.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Threading.Tasks.Task" /> completed execution within the allotted time; otherwise, false.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.TimeSpan" /> that represents the number of milliseconds to wait, or a <see cref="T:System.TimeSpan" /> that represents -1 milliseconds to wait indefinitely.</param>
       </Docs>
@@ -1932,12 +2040,15 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits for the cancellable <see cref="T:System.Threading.Tasks.Task" /> to complete execution.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Threading.Tasks.Task" /> completed execution within the allotted time; otherwise, false.</para>
+        </returns>
         <param name="millisecondsTimeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of milliseconds to wait, or <see cref="F:System.Threading.Timeout.Infinite" /> (-1) to wait indefinitely.</param>
         <param name="cancellationToken">
@@ -1988,12 +2099,15 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="millisecondsTimeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits for all of the provided <see cref="T:System.Threading.Tasks.Task" /> objects to complete execution within a specified number of milliseconds.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if all of the <see cref="T:System.Threading.Tasks.Task" /> instances completed execution within the allotted time; otherwise, false.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Threading.Tasks.Task" /> instances on which to wait.</param>
         <param name="millisecondsTimeout">
@@ -2044,7 +2158,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="cancellationToken" /> argument is used to cancel the wait operation. If it is canceled, the Wait returns false (False in Visual Basic). Cancellation of the tasks is a distinct operation, and is signaled by the AggregateException as noted above.</para>
@@ -2053,6 +2166,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits for all of the provided cancellable <see cref="T:System.Threading.Tasks.Task" /> objects to complete execution within a specified time interval.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if all of the <see cref="T:System.Threading.Tasks.Task" /> instances completed execution within the allotted time; otherwise, false.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Threading.Tasks.Task" /> instances on which to wait.</param>
         <param name="timeout">
@@ -2075,7 +2192,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="cancellationToken" /> argument is used to cancel the wait operation. If it is canceled, the Wait returns false (False in Visual Basic). Cancellation of the tasks is a distinct operation, and is signaled by the AggregateException as noted above.</para>
@@ -2084,6 +2200,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits for all of the provided cancellable <see cref="T:System.Threading.Tasks.Task" /> objects to complete execution within a specified number of milliseconds.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if all of the <see cref="T:System.Threading.Tasks.Task" /> instances completed execution within the allotted time; otherwise, false.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Threading.Tasks.Task" /> instances on which to wait.</param>
         <param name="millisecondsTimeout">
@@ -2112,12 +2232,15 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits for any of the provided <see cref="T:System.Threading.Tasks.Task" /> objects to complete execution.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the completed task in the <paramref name="tasks" /> array argument.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Threading.Tasks.Task" /> instances on which to wait.</param>
       </Docs>
@@ -2137,12 +2260,15 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="millisecondsTimeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits for any of the provided <see cref="T:System.Threading.Tasks.Task" /> objects to complete execution within a specified number of milliseconds.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the completed task in the <paramref name="tasks" /> array argument, or -1 if the timeout occurred.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Threading.Tasks.Task" /> instances on which to wait.</param>
         <param name="millisecondsTimeout">
@@ -2164,12 +2290,15 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits for any of the provided cancellable <see cref="T:System.Threading.Tasks.Task" /> objects to complete execution.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the completed task in the <paramref name="tasks" /> array argument.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Threading.Tasks.Task" /> instances on which to wait.</param>
         <param name="cancellationToken">
@@ -2191,12 +2320,15 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits for any of the provided <see cref="T:System.Threading.Tasks.Task" /> objects to complete execution within a specified time interval.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the completed task in the <paramref name="tasks" /> array argument, or -1 if the timeout occurred.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Threading.Tasks.Task" /> instances on which to wait.</param>
         <param name="timeout">
@@ -2219,12 +2351,15 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits for any of the provided cancellable <see cref="T:System.Threading.Tasks.Task" /> objects to complete execution within a specified number of milliseconds.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the completed task in the <paramref name="tasks" /> array argument, or -1 if the timeout occurred.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Threading.Tasks.Task" /> instances on which to wait.</param>
         <param name="millisecondsTimeout">
@@ -2247,7 +2382,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="tasks" Type="System.Collections.Generic.IEnumerable&lt;System.Threading.Tasks.Task&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If any of the supplied tasks completes in a faulted state, the returned task will also complete in a Faulted state,   where its exceptions will contain the aggregation of the set of unwrapped exceptions from each of the supplied tasks.</para>
@@ -2259,6 +2393,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a task that will complete when all of the supplied tasks have completed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the completion of all of the supplied tasks.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The tasks to wait on for completion.</param>
       </Docs>
@@ -2283,7 +2421,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If any of the supplied tasks completes in a faulted state, the returned task will also complete in a Faulted state,   where its exceptions will contain the aggregation of the set of unwrapped exceptions from each of the supplied tasks.  </para>
@@ -2295,6 +2432,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a task that will complete when all of the supplied tasks have completed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the completion of all of the supplied tasks.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The tasks to wait on for completion.</param>
       </Docs>
@@ -2316,7 +2457,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="tasks" Type="System.Collections.Generic.IEnumerable&lt;System.Threading.Tasks.Task&lt;TResult&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If any of the supplied tasks completes in a faulted state, the returned task will also complete in a Faulted state,   where its exceptions will contain the aggregation of the set of unwrapped exceptions from each of the supplied tasks.</para>
@@ -2328,6 +2468,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a task that will complete when all of the supplied tasks have completed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the completion of all of the supplied tasks.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The tasks to wait on for completion.</param>
         <typeparam name="TResult">
@@ -2357,7 +2501,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If any of the supplied tasks completes in a faulted state, the returned task will also complete in a Faulted state,   where its exceptions will contain the aggregation of the set of unwrapped exceptions from each of the supplied tasks.  </para>
@@ -2369,6 +2512,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a task that will complete when all of the supplied tasks have completed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the completion of all of the supplied tasks.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The tasks to wait on for completion.</param>
         <typeparam name="TResult">
@@ -2389,7 +2536,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="tasks" Type="System.Collections.Generic.IEnumerable&lt;System.Threading.Tasks.Task&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned task will complete when any of the supplied tasks has completed.  The returned task will always end in the RanToCompletion state  with its Result set to the first task to complete.  This is true even if the first task to complete ended in the Canceled or Faulted state.</para>
@@ -2398,6 +2544,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a task that will complete when any of the supplied tasks have completed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the completion of one of the supplied tasks.  The return task's Result is the task that completed.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The tasks to wait on for completion.</param>
       </Docs>
@@ -2422,7 +2572,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned task will complete when any of the supplied tasks has completed.  The returned task will always end in the RanToCompletion state   with its Result set to the first task to complete.  This is true even if the first task to complete ended in the Canceled or Faulted state.</para>
@@ -2431,6 +2580,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a task that will complete when any of the supplied tasks have completed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the completion of one of the supplied tasks.  The return task's Result is the task that completed.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The tasks to wait on for completion.</param>
       </Docs>
@@ -2452,7 +2605,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         <Parameter Name="tasks" Type="System.Collections.Generic.IEnumerable&lt;System.Threading.Tasks.Task&lt;TResult&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned task will complete when any of the supplied tasks has completed.  The returned task will always end in the RanToCompletion state with its Result set to the first task to complete. This is true even if the first task to complete ended in the Canceled or Faulted state.</para>
@@ -2461,6 +2613,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a task that will complete when any of the supplied tasks have completed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the completion of one of the supplied tasks.  The return task's Result is the task that completed.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The tasks to wait on for completion.</param>
         <typeparam name="TResult">
@@ -2490,7 +2646,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The returned task will complete when any of the supplied tasks has completed.  The returned task will always end in the RanToCompletion state with its Result set to the first task to complete. This is true even if the first task to complete ended in the Canceled or Faulted state.</para>
@@ -2499,6 +2654,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a task that will complete when any of the supplied tasks have completed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that represents the completion of one of the supplied tasks.  The return task's Result is the task that completed.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The tasks to wait on for completion.</param>
         <typeparam name="TResult">
@@ -2517,7 +2676,6 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use await Task.Yield(); in an asynchronous method to force the method to complete asynchronously. If there is a current synchronization context (<see cref="T:System.Threading.SynchronizationContext" /> object), this will post the remainder of the method’s execution back to that context. However, the context will decide how to prioritize this work relative to other work that may be pending. The synchronization context that is present on a UI thread in most UI environments will often prioritize work posted to the context higher than input and rendering work. For this reason, do not rely on await Task.Yield(); to keep a UI responsive.  For more information, see the entry <see cref="http://blogs.msdn.com/b/pfxteam/archive/2008/07/23/8768673.aspx">Useful Abstractions Enabled with ContinueWith</see> in the Parallel Programming with .NET blog.</para>
@@ -2526,6 +2684,10 @@ var t = Task.Factory.StartNew(() =&gt; DoAction());
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an awaitable task that asynchronously yields back to the current context when awaited.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A context that, when awaited, will asynchronously transition back into the current context at the time of the await. If the current <see cref="T:System.Threading.SynchronizationContext" /> is non-null, it is treated as the current context. Otherwise, the task scheduler that is associated with the currently executing task is treated as the current context. </para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Threading.Tasks/TaskCompletionSource`1.xml b/mcs/class/corlib/Documentation/en/System.Threading.Tasks/TaskCompletionSource`1.xml
index dbd3e9e54bf..ae38ac840f4 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading.Tasks/TaskCompletionSource`1.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading.Tasks/TaskCompletionSource`1.xml
@@ -227,7 +227,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will return false if the <see cref="T:System.Threading.Tasks.Task`1" /> is already in one of the three final states: <see cref="F:System.Threading.Tasks.TaskStatus.RanToCompletion" />, <see cref="F:System.Threading.Tasks.TaskStatus.Faulted" />, or <see cref="F:System.Threading.Tasks.TaskStatus.Canceled" />. </para>
@@ -237,6 +236,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to transition the underlying <see cref="T:System.Threading.Tasks.Task`1" /> into the <see cref="F:System.Threading.Tasks.TaskStatus.Canceled" /> state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True if the operation was successful; false if the operation was unsuccessful or the object has already been disposed.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TrySetException">
@@ -253,7 +256,6 @@
         <Parameter Name="exceptions" Type="System.Collections.Generic.IEnumerable&lt;System.Exception&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will return false if the <see cref="T:System.Threading.Tasks.Task`1" /> is already in one of the three final states: <see cref="F:System.Threading.Tasks.TaskStatus.RanToCompletion" />, <see cref="F:System.Threading.Tasks.TaskStatus.Faulted" />, or <see cref="F:System.Threading.Tasks.TaskStatus.Canceled" />.</para>
@@ -262,6 +264,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to transition the underlying <see cref="T:System.Threading.Tasks.Task`1" /> into the <see cref="F:System.Threading.Tasks.TaskStatus.Faulted" /> state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True if the operation was successful; otherwise, false.</para>
+        </returns>
         <param name="exceptions">
           <attribution license="cc4" from="Microsoft" modified="false" />The collection of exceptions to bind to this <see cref="T:System.Threading.Tasks.Task`1" />.</param>
       </Docs>
@@ -280,7 +286,6 @@
         <Parameter Name="exception" Type="System.Exception" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation will return false if the <see cref="T:System.Threading.Tasks.Task`1" /> is already in one of the three final states: <see cref="F:System.Threading.Tasks.TaskStatus.RanToCompletion" />, <see cref="F:System.Threading.Tasks.TaskStatus.Faulted" />, or <see cref="F:System.Threading.Tasks.TaskStatus.Canceled" />.</para>
@@ -289,6 +294,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to transition the underlying <see cref="T:System.Threading.Tasks.Task`1" /> into the <see cref="F:System.Threading.Tasks.TaskStatus.Faulted" /> state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True if the operation was successful; otherwise, false.</para>
+        </returns>
         <param name="exception">
           <attribution license="cc4" from="Microsoft" modified="false" />The exception to bind to this <see cref="T:System.Threading.Tasks.Task`1" />.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Threading.Tasks/TaskFactory.xml b/mcs/class/corlib/Documentation/en/System.Threading.Tasks/TaskFactory.xml
index e6c834be38d..952714cda97 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading.Tasks/TaskFactory.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading.Tasks/TaskFactory.xml
@@ -203,7 +203,6 @@
         <Parameter Name="continuationAction" Type="System.Action&lt;System.Threading.Tasks.Task[]&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Threading.Tasks.TaskFactory.ContinueWhenAll(System.Threading.Tasks.Task[],System.Action{System.Threading.Tasks.Task[]})" /> method executes the <paramref name="continuationAction" /> delegate when all tasks in the <paramref name="tasks" /> array have completed, regardless of their completion status. </para>
@@ -213,6 +212,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation task that starts when a set of specified tasks has completed. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation task.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue.</param>
         <param name="continuationAction">
@@ -235,7 +238,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Threading.Tasks.TaskFactory.ContinueWhenAll(System.Threading.Tasks.Task[],System.Action{System.Threading.Tasks.Task[]},System.Threading.CancellationToken)" /> method executes the <paramref name="continuationAction" /> delegate when all tasks in the <paramref name="tasks" /> array have completed, regardless of their completion status. </para>
@@ -244,6 +246,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation task that starts when a set of specified tasks has completed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation task.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue.</param>
         <param name="continuationAction">
@@ -268,12 +274,15 @@
         <Parameter Name="continuationOptions" Type="System.Threading.Tasks.TaskContinuationOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation task that starts when a set of specified tasks has completed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation task.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue.</param>
         <param name="continuationAction">
@@ -300,12 +309,15 @@
         <Parameter Name="scheduler" Type="System.Threading.Tasks.TaskScheduler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation task that starts when a set of specified tasks has completed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation task.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue.</param>
         <param name="continuationAction">
@@ -336,12 +348,15 @@
         <Parameter Name="continuationAction" Type="System.Action&lt;System.Threading.Tasks.Task&lt;TAntecedentResult&gt;[]&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation task that starts when a set of specified tasks has completed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation task.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue.</param>
         <param name="continuationAction">
@@ -369,12 +384,15 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation task that starts when a set of specified tasks has completed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation task.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue.</param>
         <param name="continuationAction">
@@ -404,12 +422,15 @@
         <Parameter Name="continuationOptions" Type="System.Threading.Tasks.TaskContinuationOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation task that starts when a set of specified tasks has completed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation task.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue.</param>
         <param name="continuationAction">
@@ -441,12 +462,15 @@
         <Parameter Name="scheduler" Type="System.Threading.Tasks.TaskScheduler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation task that starts when a set of specified tasks has completed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation task.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue.</param>
         <param name="continuationAction">
@@ -479,12 +503,15 @@
         <Parameter Name="continuationFunction" Type="System.Func&lt;System.Threading.Tasks.Task[],TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation task that starts when a set of specified tasks has completed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation task.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue.</param>
         <param name="continuationFunction">
@@ -512,12 +539,15 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation task that starts when a set of specified tasks has completed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation task.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue.</param>
         <param name="continuationFunction">
@@ -547,12 +577,15 @@
         <Parameter Name="continuationOptions" Type="System.Threading.Tasks.TaskContinuationOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation task that starts when a set of specified tasks has completed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation task.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue.</param>
         <param name="continuationFunction">
@@ -584,12 +617,15 @@
         <Parameter Name="scheduler" Type="System.Threading.Tasks.TaskScheduler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation task that starts when a set of specified tasks has completed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation task.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue.</param>
         <param name="continuationFunction">
@@ -623,12 +659,15 @@
         <Parameter Name="continuationFunction" Type="System.Func&lt;System.Threading.Tasks.Task&lt;TAntecedentResult&gt;[],TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation task that starts when a set of specified tasks has completed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation task.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue.</param>
         <param name="continuationFunction">
@@ -659,12 +698,15 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation task that starts when a set of specified tasks has completed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation task.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue.</param>
         <param name="continuationFunction">
@@ -697,12 +739,15 @@
         <Parameter Name="continuationOptions" Type="System.Threading.Tasks.TaskContinuationOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation task that starts when a set of specified tasks has completed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation task.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue.</param>
         <param name="continuationFunction">
@@ -737,12 +782,15 @@
         <Parameter Name="scheduler" Type="System.Threading.Tasks.TaskScheduler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation task that starts when a set of specified tasks has completed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation task.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue.</param>
         <param name="continuationFunction">
@@ -774,12 +822,15 @@
         <Parameter Name="continuationAction" Type="System.Action&lt;System.Threading.Tasks.Task&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation <see cref="T:System.Threading.Tasks.Task" /> that will be started upon the completion of any Task in the provided set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation <see cref="T:System.Threading.Tasks.Task" />.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue when one task completes.</param>
         <param name="continuationAction">
@@ -802,12 +853,15 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation <see cref="T:System.Threading.Tasks.Task" /> that will be started upon the completion of any Task in the provided set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation <see cref="T:System.Threading.Tasks.Task" />.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue when one task completes.</param>
         <param name="continuationAction">
@@ -832,7 +886,6 @@
         <Parameter Name="continuationOptions" Type="System.Threading.Tasks.TaskContinuationOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The NotOn* and OnlyOn* <see cref="T:System.Threading.Tasks.TaskContinuationOptions" />, which constrain for which <see cref="T:System.Threading.Tasks.TaskStatus" /> states a continuation will be executed, are illegal with ContinueWhenAny.</para>
@@ -841,6 +894,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation <see cref="T:System.Threading.Tasks.Task" /> that will be started upon the completion of any Task in the provided set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation <see cref="T:System.Threading.Tasks.Task" />.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue when one task completes.</param>
         <param name="continuationAction">
@@ -867,12 +924,15 @@
         <Parameter Name="scheduler" Type="System.Threading.Tasks.TaskScheduler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation <see cref="T:System.Threading.Tasks.Task" /> that will be started upon the completion of any Task in the provided set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation <see cref="T:System.Threading.Tasks.Task" />.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue when one task completes.</param>
         <param name="continuationAction">
@@ -903,12 +963,15 @@
         <Parameter Name="continuationAction" Type="System.Action&lt;System.Threading.Tasks.Task&lt;TAntecedentResult&gt;&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation <see cref="T:System.Threading.Tasks.Task" /> that will be started upon the completion of any Task in the provided set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation <see cref="T:System.Threading.Tasks.Task" />.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue when one task completes.</param>
         <param name="continuationAction">
@@ -936,12 +999,15 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation <see cref="T:System.Threading.Tasks.Task" /> that will be started upon the completion of any Task in the provided set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation <see cref="T:System.Threading.Tasks.Task" />.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue when one task completes.</param>
         <param name="continuationAction">
@@ -971,7 +1037,6 @@
         <Parameter Name="continuationOptions" Type="System.Threading.Tasks.TaskContinuationOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The NotOn* and OnlyOn* <see cref="T:System.Threading.Tasks.TaskContinuationOptions" />, which constrain for which <see cref="T:System.Threading.Tasks.TaskStatus" /> states a continuation will be executed, are illegal with ContinueWhenAny.</para>
@@ -980,6 +1045,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation <see cref="T:System.Threading.Tasks.Task" /> that will be started upon the completion of any Task in the provided set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation <see cref="T:System.Threading.Tasks.Task" />.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue when one task completes.</param>
         <param name="continuationAction">
@@ -1011,7 +1080,6 @@
         <Parameter Name="scheduler" Type="System.Threading.Tasks.TaskScheduler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The NotOn* and OnlyOn* <see cref="T:System.Threading.Tasks.TaskContinuationOptions" />, which constrain for which <see cref="T:System.Threading.Tasks.TaskStatus" /> states a continuation will be executed, are illegal with ContinueWhenAny.</para>
@@ -1020,6 +1088,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation <see cref="T:System.Threading.Tasks.Task" /> that will be started upon the completion of any Task in the provided set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation <see cref="T:System.Threading.Tasks.Task" />.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue when one task completes.</param>
         <param name="continuationAction">
@@ -1052,12 +1124,15 @@
         <Parameter Name="continuationFunction" Type="System.Func&lt;System.Threading.Tasks.Task,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation <see cref="T:System.Threading.Tasks.Task`1" /> that will be started upon the completion of any Task in the provided set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue when one task completes.</param>
         <param name="continuationFunction">
@@ -1085,12 +1160,15 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation <see cref="T:System.Threading.Tasks.Task`1" /> that will be started upon the completion of any Task in the provided set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue when one task completes.</param>
         <param name="continuationFunction">
@@ -1120,7 +1198,6 @@
         <Parameter Name="continuationOptions" Type="System.Threading.Tasks.TaskContinuationOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The NotOn* and OnlyOn* <see cref="T:System.Threading.Tasks.TaskContinuationOptions" />, which constrain for which <see cref="T:System.Threading.Tasks.TaskStatus" /> states a continuation will be executed, are illegal with ContinueWhenAny.</para>
@@ -1129,6 +1206,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation <see cref="T:System.Threading.Tasks.Task`1" /> that will be started upon the completion of any Task in the provided set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue when one task completes.</param>
         <param name="continuationFunction">
@@ -1160,7 +1241,6 @@
         <Parameter Name="scheduler" Type="System.Threading.Tasks.TaskScheduler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The NotOn* and OnlyOn* <see cref="T:System.Threading.Tasks.TaskContinuationOptions" />, which constrain for which <see cref="T:System.Threading.Tasks.TaskStatus" /> states a continuation will be executed, are illegal with ContinueWhenAny.</para>
@@ -1169,6 +1249,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation <see cref="T:System.Threading.Tasks.Task`1" /> that will be started upon the completion of any Task in the provided set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue when one task completes.</param>
         <param name="continuationFunction">
@@ -1202,12 +1286,15 @@
         <Parameter Name="continuationFunction" Type="System.Func&lt;System.Threading.Tasks.Task&lt;TAntecedentResult&gt;,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation <see cref="T:System.Threading.Tasks.Task`1" /> that will be started upon the completion of any Task in the provided set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue when one task completes.</param>
         <param name="continuationFunction">
@@ -1238,12 +1325,15 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation <see cref="T:System.Threading.Tasks.Task`1" /> that will be started upon the completion of any Task in the provided set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue when one task completes.</param>
         <param name="continuationFunction">
@@ -1276,7 +1366,6 @@
         <Parameter Name="continuationOptions" Type="System.Threading.Tasks.TaskContinuationOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The NotOn* and OnlyOn* <see cref="T:System.Threading.Tasks.TaskContinuationOptions" />, which constrain for which <see cref="T:System.Threading.Tasks.TaskStatus" /> states a continuation will be executed, are illegal with ContinueWhenAny.</para>
@@ -1285,6 +1374,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation <see cref="T:System.Threading.Tasks.Task`1" /> that will be started upon the completion of any Task in the provided set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue when one task completes.</param>
         <param name="continuationFunction">
@@ -1319,7 +1412,6 @@
         <Parameter Name="scheduler" Type="System.Threading.Tasks.TaskScheduler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The NotOn* and OnlyOn* <see cref="T:System.Threading.Tasks.TaskContinuationOptions" />, which constrain for which <see cref="T:System.Threading.Tasks.TaskStatus" /> states a continuation will be executed, are illegal with ContinueWhenAny.</para>
@@ -1328,6 +1420,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a continuation <see cref="T:System.Threading.Tasks.Task`1" /> that will be started upon the completion of any Task in the provided set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The new continuation <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="tasks">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of tasks from which to continue when one task completes.</param>
         <param name="continuationFunction">
@@ -1381,7 +1477,6 @@
         <Parameter Name="endMethod" Type="System.Action&lt;System.IAsyncResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1392,6 +1487,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Threading.Tasks.Task" /> that executes an end method action when a specified <see cref="T:System.IAsyncResult" /> completes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Threading.Tasks.Task" /> that represents the asynchronous operation.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />The IAsyncResult whose completion should trigger the processing of the <paramref name="endMethod" />.</param>
         <param name="endMethod">
@@ -1414,7 +1513,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="beginMethod" /> delegate is started on the thread that <see cref="Overload:System.Threading.Tasks.TaskFactory.FromAsync" /> is running on.  This method throws any exceptions thrown by the <paramref name="beginMethod" />.</para>
@@ -1423,6 +1521,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Threading.Tasks.Task" /> that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Threading.Tasks.Task" /> that represents the asynchronous operation.</para>
+        </returns>
         <param name="beginMethod">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate that begins the asynchronous operation.</param>
         <param name="endMethod">
@@ -1447,7 +1549,6 @@
         <Parameter Name="creationOptions" Type="System.Threading.Tasks.TaskCreationOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1458,6 +1559,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Threading.Tasks.Task" /> that executes an end method action when a specified <see cref="T:System.IAsyncResult" /> completes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Threading.Tasks.Task" /> that represents the asynchronous operation.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />The IAsyncResult whose completion should trigger the processing of the <paramref name="endMethod" />.</param>
         <param name="endMethod">
@@ -1483,7 +1588,6 @@
         <Parameter Name="creationOptions" Type="System.Threading.Tasks.TaskCreationOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="beginMethod" /> delegate is started on the thread that <see cref="Overload:System.Threading.Tasks.TaskFactory.FromAsync" /> is running on. This method throws any exceptions thrown by the <paramref name="beginMethod" />. The <see cref="T:System.Threading.Tasks.TaskCreationOptions" /> values <see cref="F:System.Threading.Tasks.TaskCreationOptions.PreferFairness" />, <see cref="F:System.Threading.Tasks.TaskCreationOptions.LongRunning" /> and <see cref="F:System.Threading.Tasks.TaskCreationOptions.AttachedToParent" /> are all mutually exclusive. In the FromAsync methods, either LongRunning or AttachedToParent by themselves will cause an <see cref="T:System.ArgumentOutOfRangeException" /> to be thrown.</para>
@@ -1492,6 +1596,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Threading.Tasks.Task" /> that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Threading.Tasks.Task" /> that represents the asynchronous operation.</para>
+        </returns>
         <param name="beginMethod">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate that begins the asynchronous operation.</param>
         <param name="endMethod">
@@ -1519,7 +1627,6 @@
         <Parameter Name="scheduler" Type="System.Threading.Tasks.TaskScheduler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1530,6 +1637,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Threading.Tasks.Task" /> that executes an end method action when a specified <see cref="T:System.IAsyncResult" /> completes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Threading.Tasks.Task" /> that represents the asynchronous operation.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />The IAsyncResult whose completion should trigger the processing of the <paramref name="endMethod" />.</param>
         <param name="endMethod">
@@ -1560,7 +1671,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="beginMethod" /> delegate is started on the thread that <see cref="Overload:System.Threading.Tasks.TaskFactory.FromAsync" /> is running on. This method throws any exceptions thrown by the <paramref name="beginMethod" />.</para>
@@ -1569,6 +1679,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Threading.Tasks.Task" /> that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Threading.Tasks.Task" /> that represents the asynchronous operation.</para>
+        </returns>
         <param name="beginMethod">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate that begins the asynchronous operation.</param>
         <param name="endMethod">
@@ -1602,7 +1716,6 @@
         <Parameter Name="creationOptions" Type="System.Threading.Tasks.TaskCreationOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="beginMethod" /> delegate is started on the thread that <see cref="Overload:System.Threading.Tasks.TaskFactory.FromAsync" /> is running on. This method throws any exceptions thrown by the <paramref name="beginMethod" />.</para>
@@ -1611,6 +1724,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Threading.Tasks.Task" /> that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Threading.Tasks.Task" /> that represents the asynchronous operation.</para>
+        </returns>
         <param name="beginMethod">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate that begins the asynchronous operation.</param>
         <param name="endMethod">
@@ -1643,7 +1760,6 @@
         <Parameter Name="endMethod" Type="System.Func&lt;System.IAsyncResult,TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1654,6 +1770,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Threading.Tasks.Task`1" /> that executes an end method function when a specified <see cref="T:System.IAsyncResult" /> completes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Threading.Tasks.Task`1" /> that represents the asynchronous operation.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />The IAsyncResult whose completion should trigger the processing of the <paramref name="endMethod" />.</param>
         <param name="endMethod">
@@ -1681,7 +1801,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method throws any exceptions thrown by the <paramref name="beginMethod" />.</para>
@@ -1690,6 +1809,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Threading.Tasks.Task`1" /> that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Threading.Tasks.Task`1" /> that represents the asynchronous operation.</para>
+        </returns>
         <param name="beginMethod">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate that begins the asynchronous operation.</param>
         <param name="endMethod">
@@ -1719,7 +1842,6 @@
         <Parameter Name="creationOptions" Type="System.Threading.Tasks.TaskCreationOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1730,6 +1852,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Threading.Tasks.Task`1" /> that executes an end method function when a specified <see cref="T:System.IAsyncResult" /> completes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Threading.Tasks.Task`1" /> that represents the asynchronous operation.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />The IAsyncResult whose completion should trigger the processing of the <paramref name="endMethod" />.</param>
         <param name="endMethod">
@@ -1760,7 +1886,6 @@
         <Parameter Name="creationOptions" Type="System.Threading.Tasks.TaskCreationOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method throws any exceptions thrown by the <paramref name="beginMethod" />.</para>
@@ -1769,6 +1894,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Threading.Tasks.Task`1" /> that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Threading.Tasks.Task`1" /> that represents the asynchronous operation.</para>
+        </returns>
         <param name="beginMethod">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate that begins the asynchronous operation.</param>
         <param name="endMethod">
@@ -1801,7 +1930,6 @@
         <Parameter Name="scheduler" Type="System.Threading.Tasks.TaskScheduler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1812,6 +1940,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Threading.Tasks.Task`1" /> that executes an end method function when a specified <see cref="T:System.IAsyncResult" /> completes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Threading.Tasks.Task`1" /> that represents the asynchronous operation.</para>
+        </returns>
         <param name="asyncResult">
           <attribution license="cc4" from="Microsoft" modified="false" />The IAsyncResult whose completion should trigger the processing of the <paramref name="endMethod" />.</param>
         <param name="endMethod">
@@ -1846,7 +1978,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="beginMethod" /> delegate is started on the thread that <see cref="Overload:System.Threading.Tasks.TaskFactory.FromAsync" /> is running on. This method throws any exceptions thrown by the <paramref name="beginMethod" />.</para>
@@ -1855,6 +1986,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Threading.Tasks.Task" /> that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Threading.Tasks.Task" /> that represents the asynchronous operation.</para>
+        </returns>
         <param name="beginMethod">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate that begins the asynchronous operation.</param>
         <param name="endMethod">
@@ -1894,7 +2029,6 @@
         <Parameter Name="creationOptions" Type="System.Threading.Tasks.TaskCreationOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="beginMethod" /> delegate is started on the thread that <see cref="Overload:System.Threading.Tasks.TaskFactory.FromAsync" /> is running on. This method throws any exceptions thrown by the <paramref name="beginMethod" />.</para>
@@ -1903,6 +2037,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Threading.Tasks.Task" /> that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Threading.Tasks.Task" /> that represents the asynchronous operation.</para>
+        </returns>
         <param name="beginMethod">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate that begins the asynchronous operation.</param>
         <param name="endMethod">
@@ -1942,7 +2080,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="beginMethod" /> delegate is started on the thread that <see cref="Overload:System.Threading.Tasks.TaskFactory.FromAsync" /> is running on. This method throws any exceptions thrown by the <paramref name="beginMethod" />.</para>
@@ -1951,6 +2088,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Threading.Tasks.Task`1" /> that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Threading.Tasks.Task`1" /> that represents the asynchronous operation.</para>
+        </returns>
         <param name="beginMethod">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate that begins the asynchronous operation.</param>
         <param name="endMethod">
@@ -1987,7 +2128,6 @@
         <Parameter Name="creationOptions" Type="System.Threading.Tasks.TaskCreationOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="beginMethod" /> delegate is started on the thread that <see cref="Overload:System.Threading.Tasks.TaskFactory.FromAsync" /> is running on. This method throws any exceptions thrown by the <paramref name="beginMethod" />.</para>
@@ -1996,6 +2136,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Threading.Tasks.Task`1" /> that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Threading.Tasks.Task`1" /> that represents the asynchronous operation.</para>
+        </returns>
         <param name="beginMethod">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate that begins the asynchronous operation.</param>
         <param name="endMethod">
@@ -2036,7 +2180,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="beginMethod" /> delegate is started on the thread that <see cref="Overload:System.Threading.Tasks.TaskFactory.FromAsync" /> is running on. This method throws any exceptions thrown by the <paramref name="beginMethod" />.</para>
@@ -2045,6 +2188,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Threading.Tasks.Task" /> that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Threading.Tasks.Task" /> that represents the asynchronous operation.</para>
+        </returns>
         <param name="beginMethod">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate that begins the asynchronous operation.</param>
         <param name="endMethod">
@@ -2090,7 +2237,6 @@
         <Parameter Name="creationOptions" Type="System.Threading.Tasks.TaskCreationOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="beginMethod" /> delegate is started on the thread that <see cref="Overload:System.Threading.Tasks.TaskFactory.FromAsync" /> is running on. This method throws any exceptions thrown by the <paramref name="beginMethod" />.</para>
@@ -2099,6 +2245,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Threading.Tasks.Task" /> that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Threading.Tasks.Task" /> that represents the asynchronous operation.</para>
+        </returns>
         <param name="beginMethod">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate that begins the asynchronous operation.</param>
         <param name="endMethod">
@@ -2144,7 +2294,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="beginMethod" /> delegate is started on the thread that <see cref="Overload:System.Threading.Tasks.TaskFactory.FromAsync" /> is running on. This method throws any exceptions thrown by the <paramref name="beginMethod" />.</para>
@@ -2153,6 +2302,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Threading.Tasks.Task`1" /> that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Threading.Tasks.Task`1" /> that represents the asynchronous operation.</para>
+        </returns>
         <param name="beginMethod">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate that begins the asynchronous operation.</param>
         <param name="endMethod">
@@ -2195,7 +2348,6 @@
         <Parameter Name="creationOptions" Type="System.Threading.Tasks.TaskCreationOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="beginMethod" /> delegate is started on the thread that <see cref="Overload:System.Threading.Tasks.TaskFactory.FromAsync" /> is running on. This method throws any exceptions thrown by the <paramref name="beginMethod" />.</para>
@@ -2204,6 +2356,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Threading.Tasks.Task`1" /> that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Threading.Tasks.Task`1" /> that represents the asynchronous operation.</para>
+        </returns>
         <param name="beginMethod">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate that begins the asynchronous operation.</param>
         <param name="endMethod">
@@ -2249,7 +2405,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="beginMethod" /> delegate is started on the thread that <see cref="Overload:System.Threading.Tasks.TaskFactory.FromAsync" /> is running on. This method throws any exceptions thrown by the <paramref name="beginMethod" />.</para>
@@ -2258,6 +2413,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Threading.Tasks.Task`1" /> that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Threading.Tasks.Task`1" /> that represents the asynchronous operation.</para>
+        </returns>
         <param name="beginMethod">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate that begins the asynchronous operation.</param>
         <param name="endMethod">
@@ -2306,7 +2465,6 @@
         <Parameter Name="creationOptions" Type="System.Threading.Tasks.TaskCreationOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="beginMethod" /> delegate is started on the thread that <see cref="Overload:System.Threading.Tasks.TaskFactory.FromAsync" /> is running on. This method throws any exceptions thrown by the <paramref name="beginMethod" />.</para>
@@ -2315,6 +2473,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Threading.Tasks.Task`1" /> that represents a pair of begin and end methods that conform to the Asynchronous Programming Model pattern.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The created <see cref="T:System.Threading.Tasks.Task`1" /> that represents the asynchronous operation.</para>
+        </returns>
         <param name="beginMethod">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate that begins the asynchronous operation.</param>
         <param name="endMethod">
@@ -2376,7 +2538,6 @@
         <Parameter Name="action" Type="System.Action" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling <see cref="M:System.Threading.Tasks.TaskFactory.StartNew(System.Action)" /> is functionally equivalent to creating a task by using one of its constructors, and then calling the <see cref="M:System.Threading.Tasks.Task.Start" /> method to schedule the task for execution. Starting with the net_v45, you can use the <see cref="Overload:System.Threading.Tasks.Task.Run" /> method with an <see cref="System.Action" /> object as  a quick way to call <see cref="Overload:System.Threading.Tasks.TaskFactory.StartNew" /> with default parameters. For more information and code examples, see <see cref="http://blogs.msdn.com/b/pfxteam/archive/2011/10/24/10229468.aspx">Task.Run vs Task.Factory.StartNew</see> in the Parallel Programming with .NET blog. </para>
@@ -2385,6 +2546,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and starts a task.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The started task.</para>
+        </returns>
         <param name="action">
           <attribution license="cc4" from="Microsoft" modified="false" />The action delegate to execute asynchronously.</param>
       </Docs>
@@ -2404,7 +2569,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling StartNew is functionally equivalent to creating a Task using one of its constructors and then calling <see cref="M:System.Threading.Tasks.Task.Start" /> to schedule it for execution. Starting with the net_v45, you can use the <see cref="Overload:System.Threading.Tasks.Task.Run" /> method with an <see cref="System.Action" /> object as  a quick way to call <see cref="Overload:System.Threading.Tasks.TaskFactory.StartNew" /> with default parameters. For more information and code examples, see <see cref="http://blogs.msdn.com/b/pfxteam/archive/2011/10/24/10229468.aspx">Task.Run vs Task.Factory.StartNew</see> in the Parallel Programming with .NET blog. </para>
@@ -2413,6 +2577,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and starts a <see cref="T:System.Threading.Tasks.Task" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The started <see cref="T:System.Threading.Tasks.Task" />.</para>
+        </returns>
         <param name="action">
           <attribution license="cc4" from="Microsoft" modified="false" />The action delegate to execute asynchronously.</param>
         <param name="cancellationToken">
@@ -2434,7 +2602,6 @@
         <Parameter Name="creationOptions" Type="System.Threading.Tasks.TaskCreationOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling StartNew is functionally equivalent to creating a Task using one of its constructors and then calling <see cref="M:System.Threading.Tasks.Task.Start" /> to schedule it for execution.</para>
@@ -2444,6 +2611,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and starts a <see cref="T:System.Threading.Tasks.Task" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The started <see cref="T:System.Threading.Tasks.Task" />.</para>
+        </returns>
         <param name="action">
           <attribution license="cc4" from="Microsoft" modified="false" />The action delegate to execute asynchronously.</param>
         <param name="creationOptions">
@@ -2465,7 +2636,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling StartNew is functionally equivalent to creating a Task using one of its constructors and then calling <see cref="M:System.Threading.Tasks.Task.Start" /> to schedule it for execution.</para>
@@ -2475,6 +2645,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and starts a <see cref="T:System.Threading.Tasks.Task" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The started <see cref="T:System.Threading.Tasks.Task" />.</para>
+        </returns>
         <param name="action">
           <attribution license="cc4" from="Microsoft" modified="false" />The action delegate to execute asynchronously.</param>
         <param name="state">
@@ -2497,7 +2671,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling StartNew is functionally equivalent to creating a Task using one of its constructors and then calling <see cref="M:System.Threading.Tasks.Task.Start" /> to schedule it for execution.</para>
@@ -2507,6 +2680,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and starts a <see cref="T:System.Threading.Tasks.Task" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The started <see cref="T:System.Threading.Tasks.Task" />.</para>
+        </returns>
         <param name="action">
           <attribution license="cc4" from="Microsoft" modified="false" />The action delegate to execute asynchronously.</param>
         <param name="state">
@@ -2531,7 +2708,6 @@
         <Parameter Name="creationOptions" Type="System.Threading.Tasks.TaskCreationOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling StartNew is functionally equivalent to creating a Task using one of its constructors and then calling <see cref="M:System.Threading.Tasks.Task.Start" /> to schedule it for execution.</para>
@@ -2541,6 +2717,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and starts a <see cref="T:System.Threading.Tasks.Task" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The started <see cref="T:System.Threading.Tasks.Task" />.</para>
+        </returns>
         <param name="action">
           <attribution license="cc4" from="Microsoft" modified="false" />The action delegate to execute asynchronously.</param>
         <param name="state">
@@ -2566,7 +2746,6 @@
         <Parameter Name="scheduler" Type="System.Threading.Tasks.TaskScheduler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling StartNew is functionally equivalent to creating a Task using one of its constructors and then calling <see cref="M:System.Threading.Tasks.Task.Start" /> to schedule it for execution.</para>
@@ -2576,6 +2755,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and starts a <see cref="T:System.Threading.Tasks.Task" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The started <see cref="T:System.Threading.Tasks.Task" />.</para>
+        </returns>
         <param name="action">
           <attribution license="cc4" from="Microsoft" modified="false" />The action delegate to execute asynchronously.</param>
         <param name="cancellationToken">
@@ -2604,7 +2787,6 @@
         <Parameter Name="scheduler" Type="System.Threading.Tasks.TaskScheduler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling StartNew is functionally equivalent to creating a Task using one of its constructors and then calling <see cref="M:System.Threading.Tasks.Task.Start" /> to schedule it for execution.</para>
@@ -2614,6 +2796,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and starts a <see cref="T:System.Threading.Tasks.Task" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The started <see cref="T:System.Threading.Tasks.Task" />.</para>
+        </returns>
         <param name="action">
           <attribution license="cc4" from="Microsoft" modified="false" />The action delegate to execute asynchronously.</param>
         <param name="state">
@@ -2643,7 +2829,6 @@
         <Parameter Name="function" Type="System.Func&lt;TResult&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling StartNew is functionally equivalent to creating a <see cref="T:System.Threading.Tasks.Task`1" /> using one of its constructors and then calling <see cref="M:System.Threading.Tasks.Task.Start" /> to schedule it for execution.</para>
@@ -2653,6 +2838,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and starts a <see cref="T:System.Threading.Tasks.Task`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The started <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="function">
           <attribution license="cc4" from="Microsoft" modified="false" />A function delegate that returns the future result to be available through the <see cref="T:System.Threading.Tasks.Task`1" />.</param>
         <typeparam name="TResult">
@@ -2677,7 +2866,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling StartNew is functionally equivalent to creating a <see cref="T:System.Threading.Tasks.Task`1" /> using one of its constructors and then calling <see cref="M:System.Threading.Tasks.Task.Start" /> to schedule it for execution.</para>
@@ -2687,6 +2875,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and starts a <see cref="T:System.Threading.Tasks.Task`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The started <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="function">
           <attribution license="cc4" from="Microsoft" modified="false" />A function delegate that returns the future result to be available through the <see cref="T:System.Threading.Tasks.Task`1" />.</param>
         <param name="state">
@@ -2713,7 +2905,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling StartNew is functionally equivalent to creating a <see cref="T:System.Threading.Tasks.Task`1" /> using one of its constructors and then calling <see cref="M:System.Threading.Tasks.Task.Start" /> to schedule it for execution.</para>
@@ -2723,6 +2914,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and starts a <see cref="T:System.Threading.Tasks.Task`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The started <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="function">
           <attribution license="cc4" from="Microsoft" modified="false" />A function delegate that returns the future result to be available through the <see cref="T:System.Threading.Tasks.Task`1" />.</param>
         <param name="cancellationToken">
@@ -2749,7 +2944,6 @@
         <Parameter Name="creationOptions" Type="System.Threading.Tasks.TaskCreationOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling StartNew is functionally equivalent to creating a <see cref="T:System.Threading.Tasks.Task`1" /> using one of its constructors and then calling <see cref="M:System.Threading.Tasks.Task.Start" /> to schedule it for execution.</para>
@@ -2759,6 +2953,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and starts a <see cref="T:System.Threading.Tasks.Task`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The started <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="function">
           <attribution license="cc4" from="Microsoft" modified="false" />A function delegate that returns the future result to be available through the <see cref="T:System.Threading.Tasks.Task`1" />.</param>
         <param name="creationOptions">
@@ -2786,7 +2984,6 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling StartNew is functionally equivalent to creating a <see cref="T:System.Threading.Tasks.Task`1" /> using one of its constructors and then calling <see cref="M:System.Threading.Tasks.Task.Start" /> to schedule it for execution.</para>
@@ -2796,6 +2993,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and starts a <see cref="T:System.Threading.Tasks.Task`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The started <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="function">
           <attribution license="cc4" from="Microsoft" modified="false" />A function delegate that returns the future result to be available through the <see cref="T:System.Threading.Tasks.Task`1" />.</param>
         <param name="state">
@@ -2825,7 +3026,6 @@
         <Parameter Name="creationOptions" Type="System.Threading.Tasks.TaskCreationOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling StartNew is functionally equivalent to creating a <see cref="T:System.Threading.Tasks.Task`1" /> using one of its constructors and then calling <see cref="M:System.Threading.Tasks.Task.Start" /> to schedule it for execution.</para>
@@ -2835,6 +3035,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and starts a <see cref="T:System.Threading.Tasks.Task`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The started <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="function">
           <attribution license="cc4" from="Microsoft" modified="false" />A function delegate that returns the future result to be available through the <see cref="T:System.Threading.Tasks.Task`1" />.</param>
         <param name="state">
@@ -2865,7 +3069,6 @@
         <Parameter Name="scheduler" Type="System.Threading.Tasks.TaskScheduler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling StartNew is functionally equivalent to creating a <see cref="T:System.Threading.Tasks.Task`1" /> using one of its constructors and then calling <see cref="M:System.Threading.Tasks.Task.Start" /> to schedule it for execution.</para>
@@ -2875,6 +3078,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and starts a <see cref="T:System.Threading.Tasks.Task`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The started <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="function">
           <attribution license="cc4" from="Microsoft" modified="false" />A function delegate that returns the future result to be available through the <see cref="T:System.Threading.Tasks.Task`1" />.</param>
         <param name="cancellationToken">
@@ -2908,7 +3115,6 @@
         <Parameter Name="scheduler" Type="System.Threading.Tasks.TaskScheduler" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling StartNew is functionally equivalent to creating a <see cref="T:System.Threading.Tasks.Task`1" /> using one of its constructors and then calling <see cref="M:System.Threading.Tasks.Task.Start" /> to schedule it for execution.</para>
@@ -2918,6 +3124,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and starts a <see cref="T:System.Threading.Tasks.Task`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The started <see cref="T:System.Threading.Tasks.Task`1" />.</para>
+        </returns>
         <param name="function">
           <attribution license="cc4" from="Microsoft" modified="false" />A function delegate that returns the future result to be available through the <see cref="T:System.Threading.Tasks.Task`1" />.</param>
         <param name="state">
diff --git a/mcs/class/corlib/Documentation/en/System.Threading.Tasks/TaskScheduler.xml b/mcs/class/corlib/Documentation/en/System.Threading.Tasks/TaskScheduler.xml
index 4f273b69f9a..286dc4f4aaa 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading.Tasks/TaskScheduler.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading.Tasks/TaskScheduler.xml
@@ -105,7 +105,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>All <see cref="T:System.Threading.Tasks.Task" /> instances queued to the returned scheduler will be executed through a call to the <see cref="M:System.Threading.SynchronizationContext.Post(System.Threading.SendOrPostCallback,System.Object)" /> method on that context.</para>
@@ -115,6 +114,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Threading.Tasks.TaskScheduler" /> associated with the current <see cref="T:System.Threading.SynchronizationContext" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Threading.Tasks.TaskScheduler" /> associated with the current <see cref="T:System.Threading.SynchronizationContext" />, as determined by <see cref="P:System.Threading.SynchronizationContext.Current" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetScheduledTasks">
@@ -129,7 +132,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A class derived from <see cref="T:System.Threading.Tasks.TaskScheduler" /> implements this method in order to support integration with debuggers. This method will only be invoked by the .NET Framework when the debugger requests access to the data. The enumerable returned will be traversed by debugging utilities to access the tasks currently queued to this scheduler, enabling the debugger to provide a representation of this information in the user interface.</para>
@@ -158,6 +160,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For debugger support only, generates an enumerable of <see cref="T:System.Threading.Tasks.Task" /> instances currently queued to the scheduler waiting to be executed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerable that allows a debugger to traverse the tasks currently queued to this scheduler.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Id">
@@ -247,7 +253,6 @@
         <Parameter Name="task" Type="System.Threading.Tasks.Task" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information, see <format type="text/html"><a href="638f8ea5-21db-47a2-a934-86e1e961bf65">Task Schedulers</a></format>.</para>
@@ -257,6 +262,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to dequeue a <see cref="T:System.Threading.Tasks.Task" /> that was previously queued to this scheduler.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Boolean denoting whether the <paramref name="task" /> argument was successfully dequeued.</para>
+        </returns>
         <param name="task">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Threading.Tasks.Task" /> to be dequeued.</param>
       </Docs>
@@ -275,7 +284,6 @@
         <Parameter Name="task" Type="System.Threading.Tasks.Task" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para> Scheduler implementations are provided with <see cref="T:System.Threading.Tasks.Task" /> instances to be executed through either the <see cref="M:System.Threading.Tasks.TaskScheduler.QueueTask(System.Threading.Tasks.Task)" /> method or the <see cref="M:System.Threading.Tasks.TaskScheduler.TryExecuteTaskInline(System.Threading.Tasks.Task,System.Boolean)" /> method. When the scheduler deems it appropriate to run the provided task, <see cref="M:System.Threading.Tasks.TaskScheduler.TryExecuteTask(System.Threading.Tasks.Task)" /> should be used to do so. TryExecuteTask handles all aspects of executing a task, including action invocation, exception handling, state management, and lifecycle control.</para>
@@ -286,6 +294,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to execute the provided <see cref="T:System.Threading.Tasks.Task" /> on this scheduler.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Boolean that is true if <paramref name="task" /> was successfully executed, false if it was not. A common reason for execution failure is that the task had previously been executed or is in the process of being executed by another thread.</para>
+        </returns>
         <param name="task">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Threading.Tasks.Task" /> object to be executed.</param>
       </Docs>
@@ -305,7 +317,6 @@
         <Parameter Name="taskWasPreviouslyQueued" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A class derived from <see cref="T:System.Threading.Tasks.TaskScheduler" /> implements this function to support inline execution of a task on a thread that initiates a wait on that task object. Inline execution is optional, and the request may be rejected by returning false. However, the more tasks that can be inlined, the better the scheduler will scale. In fact, a scheduler that inlines too little may be prone to deadlocks. A proper implementation should ensure that a request executing under the policies guaranteed by the scheduler can successfully inline. For example, if a scheduler uses a dedicated thread to execute tasks, any inlining requests from that thread should succeed.</para>
@@ -317,6 +328,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the provided <see cref="T:System.Threading.Tasks.Task" /> can be executed synchronously in this call, and if it can, executes it.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Boolean value indicating whether the task was executed inline.</para>
+        </returns>
         <param name="task">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Threading.Tasks.Task" /> to be executed.</param>
         <param name="taskWasPreviouslyQueued">
diff --git a/mcs/class/corlib/Documentation/en/System.Threading.Tasks/Task`1.xml b/mcs/class/corlib/Documentation/en/System.Threading.Tasks/Task`1.xml
index af00cd48b8a..1cbfb6f49c4 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading.Tasks/Task`1.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading.Tasks/Task`1.xml
@@ -207,12 +207,15 @@ Dim t = Task(Of Integer).Factory.StartNew(Function() GenerateResult()) </code>
         <Parameter Name="continueOnCapturedContext" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Configures an awaiter used to await this <see cref="T:System.Threading.Tasks.Task`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object used to await this task.</para>
+        </returns>
         <param name="continueOnCapturedContext">
           <attribution license="cc4" from="Microsoft" modified="false" />true to attempt to marshal the continuation back to the original context captured; otherwise, false.</param>
       </Docs>
@@ -759,7 +762,6 @@ Dim t = Task(Of Integer).Factory.StartNew(Function() GenerateResult()) </code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is intended for compiler user rather than use directly in code.</para>
@@ -768,6 +770,10 @@ Dim t = Task(Of Integer).Factory.StartNew(Function() GenerateResult()) </code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an awaiter used to await this <see cref="T:System.Threading.Tasks.Task`1" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An awaiter instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Result">
diff --git a/mcs/class/corlib/Documentation/en/System.Threading/AsyncFlowControl.xml b/mcs/class/corlib/Documentation/en/System.Threading/AsyncFlowControl.xml
index 153f741d696..b1f6f669eb2 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading/AsyncFlowControl.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading/AsyncFlowControl.xml
@@ -68,13 +68,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified object is equal to the current <see cref="T:System.Threading.AsyncFlowControl" /> structure. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is an <see cref="T:System.Threading.AsyncFlowControl" /> structure and is equal to the current <see cref="T:System.Threading.AsyncFlowControl" /> structure; otherwise, false. </para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with the current structure.</param>
       </Docs>
@@ -94,13 +97,16 @@
         <Parameter Name="obj" Type="System.Threading.AsyncFlowControl" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Threading.AsyncFlowControl" /> structure is equal to the current <see cref="T:System.Threading.AsyncFlowControl" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is equal to the current <see cref="T:System.Threading.AsyncFlowControl" /> structure; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Threading.AsyncFlowControl" /> structure to compare with the current structure.</param>
       </Docs>
@@ -118,13 +124,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a hash code for the current <see cref="T:System.Threading.AsyncFlowControl" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.Threading.AsyncFlowControl" /> structure.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="op_Equality">
@@ -143,12 +152,15 @@
         <Parameter Name="b" Type="System.Threading.AsyncFlowControl" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Threading.AsyncFlowControl" /> structures to determine whether they are equal. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two structures are equal; otherwise, false. </para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Threading.AsyncFlowControl" /> structure.</param>
         <param name="b">
@@ -171,12 +183,15 @@
         <Parameter Name="b" Type="System.Threading.AsyncFlowControl" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.Threading.AsyncFlowControl" /> structures to determine whether they are not equal. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the structures are not equal; otherwise, false. </para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Threading.AsyncFlowControl" /> structure.</param>
         <param name="b">
diff --git a/mcs/class/corlib/Documentation/en/System.Threading/AutoResetEvent.xml b/mcs/class/corlib/Documentation/en/System.Threading/AutoResetEvent.xml
index c3e70efa497..4a8ec398260 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading/AutoResetEvent.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading/AutoResetEvent.xml
@@ -76,7 +76,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -87,6 +86,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the state of the event to nonsignaled, which causes threads to block.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the operation succeeds; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -100,7 +103,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -115,6 +117,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the state of the event to signaled, which allows at most one waiting thread to proceed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the operation succeeds; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/corlib/Documentation/en/System.Threading/CancellationToken.xml b/mcs/class/corlib/Documentation/en/System.Threading/CancellationToken.xml
index cb924c149df..f628f0d4dce 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading/CancellationToken.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading/CancellationToken.xml
@@ -86,12 +86,15 @@
         <Parameter Name="other" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current <see cref="T:System.Threading.CancellationToken" /> instance is equal to the specified <see cref="T:System.Object" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True if <paramref name="other" /> is a <see cref="T:System.Threading.CancellationToken" /> and if the two instances are equal; otherwise, false. Two tokens are equal if they are associated with the same <see cref="T:System.Threading.CancellationTokenSource" /> or if they were both constructed from public CancellationToken constructors and their <see cref="P:System.Threading.CancellationToken.IsCancellationRequested" /> values are equal.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The other object to which to compare this instance.</param>
       </Docs>
@@ -110,12 +113,15 @@
         <Parameter Name="other" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current <see cref="T:System.Threading.CancellationToken" /> instance is equal to the specified token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True if the instances are equal; otherwise, false. Two tokens are equal if they are associated with the same <see cref="T:System.Threading.CancellationTokenSource" /> or if they were both constructed from public CancellationToken constructors and their <see cref="P:System.Threading.CancellationToken.IsCancellationRequested" /> values are equal.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The other <see cref="T:System.Threading.CancellationToken" /> to which to compare this instance.</param>
       </Docs>
@@ -132,12 +138,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for a <see cref="T:System.Threading.CancellationToken" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.Threading.CancellationToken" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsCancellationRequested">
@@ -202,12 +211,15 @@
         <Parameter Name="right" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two <see cref="T:System.Threading.CancellationToken" /> instances are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True if the instances are equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first instance.</param>
         <param name="right">
@@ -229,12 +241,15 @@
         <Parameter Name="right" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two <see cref="T:System.Threading.CancellationToken" /> instances are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True if the instances are not equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first instance.</param>
         <param name="right">
@@ -255,7 +270,6 @@
         <Parameter Name="callback" Type="System.Action" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para> If this token is already in the canceled state, the delegate will be run immediately and synchronously. Any exception the delegate generates will be propagated out of this method call.</para>
@@ -266,6 +280,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Registers a delegate that will be called when this <see cref="T:System.Threading.CancellationToken" /> is canceled.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Threading.CancellationTokenRegistration" /> instance that can be used to deregister the callback.</para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate to be executed when the <see cref="T:System.Threading.CancellationToken" /> is canceled.</param>
       </Docs>
@@ -285,7 +303,6 @@
         <Parameter Name="useSynchronizationContext" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para> If this token is already in the canceled state, the delegate will be run immediately and synchronously. Any exception the delegate generates will be propogated out of this method call.</para>
@@ -296,6 +313,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Registers a delegate that will be called when this <see cref="T:System.Threading.CancellationToken" /> is canceled.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Threading.CancellationTokenRegistration" /> instance that can be used to deregister the callback.</para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate to be executed when the <see cref="T:System.Threading.CancellationToken" /> is canceled.</param>
         <param name="useSynchronizationContext">
@@ -317,7 +338,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para> If this token is already in the canceled state, the delegate will be run immediately and synchronously. Any exception the delegate generates will be propogated out of this method call.</para>
@@ -328,6 +348,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Registers a delegate that will be called when this <see cref="T:System.Threading.CancellationToken" /> is canceled.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Threading.CancellationTokenRegistration" /> instance that can be used to deregister the callback.</para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate to be executed when the <see cref="T:System.Threading.CancellationToken" /> is canceled.</param>
         <param name="state">
@@ -350,7 +374,6 @@
         <Parameter Name="useSynchronizationContext" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para> If this token is already in the canceled state, the delegate will be run immediately and synchronously. Any exception the delegate generates will be propogated out of this method call.</para>
@@ -361,6 +384,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Registers a delegate that will be called when this <see cref="T:System.Threading.CancellationToken" /> is canceled.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Threading.CancellationTokenRegistration" /> instance that can be used to deregister the callback.</para>
+        </returns>
         <param name="callback">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate to be executed when the <see cref="T:System.Threading.CancellationToken" /> is canceled.</param>
         <param name="state">
diff --git a/mcs/class/corlib/Documentation/en/System.Threading/CancellationTokenRegistration.xml b/mcs/class/corlib/Documentation/en/System.Threading/CancellationTokenRegistration.xml
index 3d110664b4b..e628b8b75a5 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading/CancellationTokenRegistration.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading/CancellationTokenRegistration.xml
@@ -68,12 +68,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current <see cref="T:System.Threading.CancellationTokenRegistration" /> instance is equal to the specified <see cref="T:System.Threading.CancellationTokenRegistration" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True, if both this and <paramref name="obj" /> are equal. False, otherwise.</para>
+          <para>Two <see cref="T:System.Threading.CancellationTokenRegistration" /> instances are equal if they both refer to the output of a single call to the same Register method of a <see cref="T:System.Threading.CancellationToken" />.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The other object to which to compare this instance.</param>
       </Docs>
@@ -92,12 +96,16 @@
         <Parameter Name="other" Type="System.Threading.CancellationTokenRegistration" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current <see cref="T:System.Threading.CancellationTokenRegistration" /> instance is equal to the specified <see cref="T:System.Threading.CancellationTokenRegistration" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True, if both this and <paramref name="other" /> are equal. False, otherwise.</para>
+          <para> Two <see cref="T:System.Threading.CancellationTokenRegistration" /> instances are equal if they both refer to the output of a single call to the same Register method of a <see cref="T:System.Threading.CancellationToken" />.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The other <see cref="T:System.Threading.CancellationTokenRegistration" /> to which to compare this instance.</param>
       </Docs>
@@ -114,12 +122,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as a hash function for a <see cref="T:System.Threading.CancellationTokenRegistration" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.Threading.CancellationTokenRegistration" /> instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="op_Equality">
@@ -137,12 +148,15 @@
         <Parameter Name="right" Type="System.Threading.CancellationTokenRegistration" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two <see cref="T:System.Threading.CancellationTokenRegistration" /> instances are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True if the instances are equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first instance.</param>
         <param name="right">
@@ -164,12 +178,15 @@
         <Parameter Name="right" Type="System.Threading.CancellationTokenRegistration" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two <see cref="T:System.Threading.CancellationTokenRegistration" /> instances are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True if the instances are not equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first instance.</param>
         <param name="right">
diff --git a/mcs/class/corlib/Documentation/en/System.Threading/CancellationTokenSource.xml b/mcs/class/corlib/Documentation/en/System.Threading/CancellationTokenSource.xml
index 539a3fc786f..59fb2241968 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading/CancellationTokenSource.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading/CancellationTokenSource.xml
@@ -218,12 +218,15 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Threading.CancellationTokenSource" /> that will be in the canceled state when any of the source tokens in the specified array are in the canceled state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Threading.CancellationTokenSource" /> that is linked to the source tokens.</para>
+        </returns>
         <param name="tokens">
           <attribution license="cc4" from="Microsoft" modified="false" />An array that contains the cancellation token instances to observe.</param>
       </Docs>
@@ -243,12 +246,15 @@
         <Parameter Name="token2" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.Threading.CancellationTokenSource" /> that will be in the canceled state when any of the source tokens are in the canceled state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Threading.CancellationTokenSource" /> that is linked to the source tokens.</para>
+        </returns>
         <param name="token1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first cancellation token to observe.</param>
         <param name="token2">
diff --git a/mcs/class/corlib/Documentation/en/System.Threading/CompressedStack.xml b/mcs/class/corlib/Documentation/en/System.Threading/CompressedStack.xml
index 4a3a4536c9e..13e1c0d0e37 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading/CompressedStack.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading/CompressedStack.xml
@@ -42,7 +42,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -53,6 +52,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Captures the compressed stack from the current thread.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Threading.CompressedStack" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateCopy">
@@ -73,7 +76,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -83,6 +85,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the current compressed stack.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Threading.CompressedStack" /> object representing the current compressed stack.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetCompressedStack">
@@ -104,7 +110,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If security is enabled, the current compressed stack is returned. If security is disabled, <see cref="M:System.Threading.CompressedStack.GetCompressedStack" /> returns an empty <see cref="T:System.Threading.CompressedStack" /> object.</para>
@@ -119,6 +124,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the compressed stack for the current thread.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Threading.CompressedStack" /> for the current thread.</para>
+        </returns>
       </Docs>
       <AssemblyVersion>2.0.0.0</AssemblyVersion>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System.Threading/CountdownEvent.xml b/mcs/class/corlib/Documentation/en/System.Threading/CountdownEvent.xml
index c391a731d05..e96fe79927f 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading/CountdownEvent.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading/CountdownEvent.xml
@@ -261,12 +261,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Registers a signal with the <see cref="T:System.Threading.CountdownEvent" />, decrementing the value of <see cref="P:System.Threading.CountdownEvent.CurrentCount" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the signal caused the count to reach zero and the event was set; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Signal">
@@ -283,12 +286,15 @@
         <Parameter Name="signalCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Registers multiple signals with the <see cref="T:System.Threading.CountdownEvent" />, decrementing the value of <see cref="P:System.Threading.CountdownEvent.CurrentCount" /> by the specified amount.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the signals caused the count to reach zero and the event was set; otherwise, false.</para>
+        </returns>
         <param name="signalCount">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of signals to register.</param>
       </Docs>
@@ -305,12 +311,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to increment <see cref="P:System.Threading.CountdownEvent.CurrentCount" /> by one.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the increment succeeded; otherwise, false. If <see cref="P:System.Threading.CountdownEvent.CurrentCount" /> is already at zero, this method will return false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryAddCount">
@@ -327,12 +336,15 @@
         <Parameter Name="signalCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to increment <see cref="P:System.Threading.CountdownEvent.CurrentCount" /> by a specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the increment succeeded; otherwise, false. If <see cref="P:System.Threading.CountdownEvent.CurrentCount" /> is already at zero this will return false.</para>
+        </returns>
         <param name="signalCount">
           <attribution license="cc4" from="Microsoft" modified="false" />The value by which to increase <see cref="P:System.Threading.CountdownEvent.CurrentCount" />.</param>
       </Docs>
@@ -373,12 +385,15 @@
         <Parameter Name="millisecondsTimeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Blocks the current thread until the <see cref="T:System.Threading.CountdownEvent" /> is set, using a 32-bit signed integer to measure the timeout.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Threading.CountdownEvent" /> was set; otherwise, false.</para>
+        </returns>
         <param name="millisecondsTimeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of milliseconds to wait, or <see cref="F:System.Threading.Timeout.Infinite" />(-1) to wait indefinitely.</param>
       </Docs>
@@ -423,12 +438,15 @@
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Blocks the current thread until the <see cref="T:System.Threading.CountdownEvent" /> is set, using a <see cref="T:System.TimeSpan" /> to measure the timeout.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Threading.CountdownEvent" /> was set; otherwise, false.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.TimeSpan" /> that represents the number of milliseconds to wait, or a <see cref="T:System.TimeSpan" /> that represents -1 milliseconds to wait indefinitely.</param>
       </Docs>
@@ -448,12 +466,15 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Blocks the current thread until the <see cref="T:System.Threading.CountdownEvent" /> is set, using a 32-bit signed integer to measure the timeout, while observing a <see cref="T:System.Threading.CancellationToken" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Threading.CountdownEvent" /> was set; otherwise, false.</para>
+        </returns>
         <param name="millisecondsTimeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of milliseconds to wait, or <see cref="F:System.Threading.Timeout.Infinite" />(-1) to wait indefinitely.</param>
         <param name="cancellationToken">
@@ -475,12 +496,15 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Blocks the current thread until the <see cref="T:System.Threading.CountdownEvent" /> is set, using a <see cref="T:System.TimeSpan" /> to measure the timeout, while observing a <see cref="T:System.Threading.CancellationToken" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Threading.CountdownEvent" /> was set; otherwise, false.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.TimeSpan" /> that represents the number of milliseconds to wait, or a <see cref="T:System.TimeSpan" /> that represents -1 milliseconds to wait indefinitely.</param>
         <param name="cancellationToken">
diff --git a/mcs/class/corlib/Documentation/en/System.Threading/EventWaitHandle.xml b/mcs/class/corlib/Documentation/en/System.Threading/EventWaitHandle.xml
index 344486fcef3..185ce1111c2 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading/EventWaitHandle.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading/EventWaitHandle.xml
@@ -164,7 +164,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -175,6 +174,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets an <see cref="T:System.Security.AccessControl.EventWaitHandleSecurity" /> object that represents the access control security for the named system event represented by the current <see cref="T:System.Threading.EventWaitHandle" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Security.AccessControl.EventWaitHandleSecurity" /> object that represents the access control security for the named system event.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="OpenExisting">
@@ -192,7 +195,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -205,6 +207,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens the specified named synchronization event, if it already exists.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An  object that represents the named system event.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the system synchronization event to open.</param>
       </Docs>
@@ -225,7 +231,6 @@
         <Parameter Name="rights" Type="System.Security.AccessControl.EventWaitHandleRights" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -237,6 +242,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens the specified named synchronization event, if it already exists, with the desired security access.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the named system event.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the system synchronization event to open.</param>
         <param name="rights">
@@ -256,13 +265,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the state of the event to nonsignaled, causing threads to block.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the operation succeeds; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Set">
@@ -278,7 +290,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -292,6 +303,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the state of the event to signaled, allowing one or more waiting threads to proceed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the operation succeeds; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="SetAccessControl">
diff --git a/mcs/class/corlib/Documentation/en/System.Threading/ExecutionContext.xml b/mcs/class/corlib/Documentation/en/System.Threading/ExecutionContext.xml
index 2ec951695f2..406c7b3052f 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading/ExecutionContext.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading/ExecutionContext.xml
@@ -47,7 +47,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -57,6 +56,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Captures the execution context from the current thread.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Threading.ExecutionContext" /> object representing the execution context for the current thread.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="CreateCopy">
@@ -72,7 +75,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -82,6 +84,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the current execution context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Threading.ExecutionContext" /> object representing the current execution context.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Dispose">
@@ -156,7 +162,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -166,6 +171,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the flow of the execution context is currently suppressed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the flow is suppressed; otherwise, false. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="RestoreFlow">
@@ -241,7 +250,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -253,6 +261,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Suppresses the flow of the execution context across asynchronous threads.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Threading.AsyncFlowControl" /> structure for restoring the flow.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Threading/HostExecutionContext.xml b/mcs/class/corlib/Documentation/en/System.Threading/HostExecutionContext.xml
index 9564368c109..b9aee4dea86 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading/HostExecutionContext.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading/HostExecutionContext.xml
@@ -82,7 +82,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -92,6 +91,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the current host execution context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Threading.HostExecutionContext" /> object representing the host context for the current thread.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="State">
diff --git a/mcs/class/corlib/Documentation/en/System.Threading/HostExecutionContextManager.xml b/mcs/class/corlib/Documentation/en/System.Threading/HostExecutionContextManager.xml
index c7a2998782e..1385a6817c9 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading/HostExecutionContextManager.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading/HostExecutionContextManager.xml
@@ -54,7 +54,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -64,6 +63,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Captures the host execution context from the current thread.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Threading.HostExecutionContext" /> object representing the host execution context of the current thread.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Revert">
@@ -115,7 +118,6 @@
         <Parameter Name="hostExecutionContext" Type="System.Threading.HostExecutionContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -126,6 +128,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the current host execution context to the specified host execution context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object for restoring the <see cref="T:System.Threading.HostExecutionContext" /> to its previous state.</para>
+        </returns>
         <param name="hostExecutionContext">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Threading.HostExecutionContext" /> to be set.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Threading/LockCookie.xml b/mcs/class/corlib/Documentation/en/System.Threading/LockCookie.xml
index 9a5b110b04a..0b6d7397c45 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading/LockCookie.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading/LockCookie.xml
@@ -42,13 +42,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a specified object is a <see cref="T:System.Threading.LockCookie" /> and is equal to the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of <paramref name="obj" /> is equal to the value of the current instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to the current instance.</param>
       </Docs>
@@ -68,13 +71,16 @@
         <Parameter Name="obj" Type="System.Threading.LockCookie" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the current instance is equal to the specified <see cref="T:System.Threading.LockCookie" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is equal to the value of the current instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Threading.LockCookie" /> to compare to the current instance.</param>
       </Docs>
@@ -92,13 +98,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="op_Equality">
@@ -117,12 +126,15 @@
         <Parameter Name="b" Type="System.Threading.LockCookie" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Threading.LockCookie" /> structures are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> is equal to <paramref name="b" />; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Threading.LockCookie" /> to compare to <paramref name="b" />.</param>
         <param name="b">
@@ -145,12 +157,15 @@
         <Parameter Name="b" Type="System.Threading.LockCookie" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Threading.LockCookie" /> structures are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> is not equal to <paramref name="b" />; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Threading.LockCookie" /> to compare to <paramref name="b" />.</param>
         <param name="b">
diff --git a/mcs/class/corlib/Documentation/en/System.Threading/ManualResetEvent.xml b/mcs/class/corlib/Documentation/en/System.Threading/ManualResetEvent.xml
index 129fe2dce69..35c192332db 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading/ManualResetEvent.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading/ManualResetEvent.xml
@@ -76,7 +76,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -87,6 +86,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the state of the event to nonsignaled, which causes threads to block.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the operation succeeds; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
@@ -100,7 +103,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -112,6 +114,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the state of the event to signaled, which allows one or more waiting threads to proceed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the operation succeeds; otherwise, false.</para>
+        </returns>
       </Docs>
       <AssemblyInfo>
         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
diff --git a/mcs/class/corlib/Documentation/en/System.Threading/ManualResetEventSlim.xml b/mcs/class/corlib/Documentation/en/System.Threading/ManualResetEventSlim.xml
index 3b8371fa4ea..1b840ad0484 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading/ManualResetEventSlim.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading/ManualResetEventSlim.xml
@@ -257,12 +257,15 @@
         <Parameter Name="millisecondsTimeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Blocks the current thread until the current <see cref="T:System.Threading.ManualResetEventSlim" /> is set, using a 32-bit signed integer to measure the time interval.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Threading.ManualResetEventSlim" /> was set; otherwise, false.</para>
+        </returns>
         <param name="millisecondsTimeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of milliseconds to wait, or <see cref="F:System.Threading.Timeout.Infinite" />(-1) to wait indefinitely.</param>
       </Docs>
@@ -307,12 +310,15 @@
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Blocks the current thread until the current <see cref="T:System.Threading.ManualResetEventSlim" /> is set, using a <see cref="T:System.TimeSpan" /> to measure the time interval.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Threading.ManualResetEventSlim" /> was set; otherwise, false.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.TimeSpan" /> that represents the number of milliseconds to wait, or a <see cref="T:System.TimeSpan" /> that represents -1 milliseconds to wait indefinitely.</param>
       </Docs>
@@ -332,12 +338,15 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Blocks the current thread until the current <see cref="T:System.Threading.ManualResetEventSlim" /> is set, using a 32-bit signed integer to measure the time interval, while observing a <see cref="T:System.Threading.CancellationToken" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Threading.ManualResetEventSlim" /> was set; otherwise, false.</para>
+        </returns>
         <param name="millisecondsTimeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of milliseconds to wait, or <see cref="F:System.Threading.Timeout.Infinite" />(-1) to wait indefinitely.</param>
         <param name="cancellationToken">
@@ -359,12 +368,15 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Blocks the current thread until the current <see cref="T:System.Threading.ManualResetEventSlim" /> is set, using a <see cref="T:System.TimeSpan" /> to measure the time interval, while observing a <see cref="T:System.Threading.CancellationToken" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Threading.ManualResetEventSlim" /> was set; otherwise, false.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.TimeSpan" /> that represents the number of milliseconds to wait, or a <see cref="T:System.TimeSpan" /> that represents -1 milliseconds to wait indefinitely.</param>
         <param name="cancellationToken">
diff --git a/mcs/class/corlib/Documentation/en/System.Threading/Monitor.xml b/mcs/class/corlib/Documentation/en/System.Threading/Monitor.xml
index e0b1f3566ec..9cdae064618 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading/Monitor.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading/Monitor.xml
@@ -225,7 +225,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method works only for locks that are acquired by using the methods of the <see cref="T:System.Threading.Monitor" /> class, or by using the C# lock statement or the Visual Basic SyncLock statement, which are implemented with <see cref="T:System.Threading.Monitor" />. </para>
@@ -235,6 +234,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current thread holds the lock on the specified object. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current thread holds the lock on <paramref name="obj" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to test. </param>
       </Docs>
@@ -333,11 +336,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true " /> if the current thread acquired
-   the lock; otherwise, <see langword="false" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="obj " />is <see langword="null" />.</exception>
         <remarks>
@@ -352,6 +350,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts to acquire an exclusive lock on the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current thread acquires the lock; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object on which to acquire the lock. </param>
       </Docs>
@@ -396,10 +398,6 @@
         <Parameter Name="millisecondsTimeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true " />if the current thread acquired the lock; otherwise, <see langword="false" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="obj " />is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -417,6 +415,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts, for the specified number of milliseconds, to acquire an exclusive lock on the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current thread acquires the lock; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object on which to acquire the lock. </param>
         <param name="millisecondsTimeout">
@@ -442,10 +444,6 @@
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true " />if the current thread acquires the lock; otherwise, <see langword="false" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="obj " />is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">The value of <paramref name="timeout " />in milliseconds is negative and is not equal to <see cref="F:System.Threading.Timeout.Infinite" /> , or is greater than <see cref="F:System.Int32.MaxValue" /> .</exception>
@@ -462,6 +460,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Attempts, for the specified amount of time, to acquire an exclusive lock on the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current thread acquires the lock; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object on which to acquire the lock. </param>
         <param name="timeout">
@@ -532,12 +534,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true " /> if the
-   call returned because the caller reacquired the lock for the specified object.
-   This method does not return if the lock is not reacquired. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="obj " />is <see langword="null" />.</exception>
         <exception cref="T:System.Threading.SynchronizationLockException">The calling thread does not own the lock for the specified object.</exception>
@@ -555,6 +551,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Releases the lock on an object and blocks the current thread until it reacquires the lock.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the call returned because the caller reacquired the lock for the specified object. This method does not return if the lock is not reacquired.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object on which to wait. </param>
       </Docs>
@@ -578,11 +578,6 @@
         <Parameter Name="millisecondsTimeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the lock was reacquired before the specified time elapsed; otherwise,
-<see langword="false" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="obj " />is <see langword="null" />.</exception>
         <exception cref="T:System.Threading.SynchronizationLockException">The calling thread does not own the lock for the specified object.</exception>
@@ -607,6 +602,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Releases the lock on an object and blocks the current thread until it reacquires the lock. If the specified time-out interval elapses, the thread enters the ready queue.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the lock was reacquired before the specified time elapsed; false if the lock was reacquired after the specified time elapsed. The method does not return until the lock is reacquired.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object on which to wait. </param>
         <param name="millisecondsTimeout">
@@ -632,11 +631,6 @@
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the lock was reacquired before
-   the specified time elapsed; otherwise, <see langword="false" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="obj " />is <see langword="null" />.</exception>
         <exception cref="T:System.Threading.SynchronizationLockException">The calling thread does not own the lock for the specified object.</exception>
@@ -661,6 +655,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Releases the lock on an object and blocks the current thread until it reacquires the lock. If the specified time-out interval elapses, the thread enters the ready queue.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the lock was reacquired before the specified time elapsed; false if the lock was reacquired after the specified time elapsed. The method does not return until the lock is reacquired.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object on which to wait. </param>
         <param name="timeout">
@@ -686,7 +684,6 @@
         <Parameter Name="exitContext" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method does not return until it reacquires an exclusive lock on the <paramref name="obj" /> parameter.</para>
@@ -713,6 +710,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Releases the lock on an object and blocks the current thread until it reacquires the lock. If the specified time-out interval elapses, the thread enters the ready queue. This method also specifies whether the synchronization domain for the context (if in a synchronized context) is exited before the wait and reacquired afterward.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the lock was reacquired before the specified time elapsed; false if the lock was reacquired after the specified time elapsed. The method does not return until the lock is reacquired.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object on which to wait. </param>
         <param name="millisecondsTimeout">
@@ -739,7 +740,6 @@
         <Parameter Name="exitContext" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method does not return until it reacquires an exclusive lock on the <paramref name="obj" /> parameter.</para>
@@ -766,6 +766,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Releases the lock on an object and blocks the current thread until it reacquires the lock. If the specified time-out interval elapses, the thread enters the ready queue. Optionally exits the synchronization domain for the synchronized context before the wait and reacquires the domain afterward.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the lock was reacquired before the specified time elapsed; false if the lock was reacquired after the specified time elapsed. The method does not return until the lock is reacquired.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object on which to wait. </param>
         <param name="timeout">
diff --git a/mcs/class/corlib/Documentation/en/System.Threading/Mutex.xml b/mcs/class/corlib/Documentation/en/System.Threading/Mutex.xml
index 3783066b752..ef58c3d72db 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading/Mutex.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading/Mutex.xml
@@ -208,7 +208,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -219,6 +218,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a <see cref="T:System.Security.AccessControl.MutexSecurity" /> object that represents the access control security for the named mutex.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Security.AccessControl.MutexSecurity" /> object that represents the access control security for the named mutex.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="OpenExisting">
@@ -236,7 +239,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -250,6 +252,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens the specified named mutex, if it already exists.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the named system mutex.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the system mutex to open.</param>
       </Docs>
@@ -270,7 +276,6 @@
         <Parameter Name="rights" Type="System.Security.AccessControl.MutexRights" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -283,6 +288,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Opens the specified named mutex, if it already exists, with the desired security access.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the named system mutex.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the system mutex to open.</param>
         <param name="rights">
diff --git a/mcs/class/corlib/Documentation/en/System.Threading/Overlapped.xml b/mcs/class/corlib/Documentation/en/System.Threading/Overlapped.xml
index ec77503a2f9..855e3f37714 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading/Overlapped.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading/Overlapped.xml
@@ -305,7 +305,6 @@
         <Parameter Name="iocb" Type="System.Threading.IOCompletionCallback" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'NativeOverlapped*'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The unmanaged pointer returned by this method can be passed to the operating system in overlapped I/O operations. The <see cref="T:System.Threading.NativeOverlapped" /> structure is fixed in physical memory until <see cref="M:System.Threading.Overlapped.Unpack(System.Threading.NativeOverlapped*)" /> is called. </para>
@@ -317,6 +316,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Packs the current instance into a <see cref="T:System.Threading.NativeOverlapped" /> structure, specifying the delegate to be invoked when the asynchronous I/O operation is complete.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An unmanaged pointer to a <see cref="T:System.Threading.NativeOverlapped" /> structure. </para>
+        </returns>
         <param name="iocb">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Threading.IOCompletionCallback" /> delegate that represents the callback method invoked when the asynchronous I/O operation completes.</param>
       </Docs>
@@ -345,7 +348,6 @@
         <Parameter Name="userData" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -359,6 +361,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Packs the current instance into a <see cref="T:System.Threading.NativeOverlapped" /> structure, specifying a delegate that is invoked when the asynchronous I/O operation is complete and a managed object that serves as a buffer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An unmanaged pointer to a <see cref="T:System.Threading.NativeOverlapped" /> structure. </para>
+        </returns>
         <param name="iocb">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Threading.IOCompletionCallback" /> delegate that represents the callback method invoked when the asynchronous I/O operation completes.</param>
         <param name="userData">
@@ -386,7 +392,6 @@
         <Parameter Name="nativeOverlappedPtr" Type="System.Threading.NativeOverlapped*" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Overlapped'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Threading.NativeOverlapped" /> structure is not freed from physical memory until you call the <see cref="M:System.Threading.Overlapped.Free(System.Threading.NativeOverlapped*)" /> method.</para>
@@ -395,6 +400,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Unpacks the specified unmanaged <see cref="T:System.Threading.NativeOverlapped" /> structure into a managed <see cref="T:System.Threading.Overlapped" /> object. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Threading.Overlapped" /> object containing the information unpacked from the native structure.</para>
+        </returns>
         <param name="nativeOverlappedPtr">
           <attribution license="cc4" from="Microsoft" modified="false" />An unmanaged pointer to a <see cref="T:System.Threading.NativeOverlapped" /> structure.</param>
       </Docs>
@@ -423,7 +432,6 @@
         <Parameter Name="iocb" Type="System.Threading.IOCompletionCallback" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'NativeOverlapped*'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The unmanaged pointer returned by this method can be passed to the operating system in overlapped I/O operations. The <see cref="T:System.Threading.NativeOverlapped" /> structure is fixed in physical memory until <see cref="M:System.Threading.Overlapped.Unpack(System.Threading.NativeOverlapped*)" /> is called. </para>
@@ -436,6 +444,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Packs the current instance into a <see cref="T:System.Threading.NativeOverlapped" /> structure specifying the delegate to invoke when the asynchronous I/O operation is complete. Does not propagate the calling stack.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An unmanaged pointer to a <see cref="T:System.Threading.NativeOverlapped" /> structure. </para>
+        </returns>
         <param name="iocb">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Threading.IOCompletionCallback" /> delegate that represents the callback method invoked when the asynchronous I/O operation completes.</param>
       </Docs>
@@ -464,7 +476,6 @@
         <Parameter Name="userData" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -479,6 +490,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Packs the current instance into a <see cref="T:System.Threading.NativeOverlapped" /> structure, specifying the delegate to invoke when the asynchronous I/O operation is complete and the managed object that serves as a buffer. Does not propagate the calling stack.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An unmanaged pointer to a <see cref="T:System.Threading.NativeOverlapped" /> structure. </para>
+        </returns>
         <param name="iocb">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Threading.IOCompletionCallback" /> delegate that represents the callback method invoked when the asynchronous I/O operation completes.</param>
         <param name="userData">
diff --git a/mcs/class/corlib/Documentation/en/System.Threading/ReaderWriterLock.xml b/mcs/class/corlib/Documentation/en/System.Threading/ReaderWriterLock.xml
index 308de2c9a6f..38a6ce54699 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading/ReaderWriterLock.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading/ReaderWriterLock.xml
@@ -257,7 +257,6 @@
         <Parameter Name="seqNum" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use <see cref="P:System.Threading.ReaderWriterLock.WriterSeqNum" /> and AnyWritersSince to improve application performance. For example, a thread might cache the information it obtains while holding a reader lock. After releasing and later reacquiring the lock, the thread can use AnyWritersSince to determine whether other threads have written to the resource in the interim; if not, the cached information can be used. This technique is useful where reading the information protected by the lock is expensive; for example, running a database query.</para>
@@ -267,6 +266,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the writer lock has been granted to any thread since the sequence number was obtained.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the writer lock has been granted to any thread since the sequence number was obtained; otherwise, false.</para>
+        </returns>
         <param name="seqNum">
           <attribution license="cc4" from="Microsoft" modified="false" />The sequence number. </param>
       </Docs>
@@ -375,7 +378,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'LockCookie'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -385,6 +387,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Releases the lock, regardless of the number of times the thread acquired the lock.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Threading.LockCookie" /> value representing the released lock.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReleaseReaderLock">
@@ -490,7 +496,6 @@
         <Parameter Name="millisecondsTimeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'LockCookie'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When a thread calls UpgradeToWriterLock the reader lock is released, regardless of the lock count, and the thread goes to the end of the queue for the writer lock. Thus, other threads might write to the resource before the thread that requested the upgrade is granted the writer lock.</para>
@@ -505,6 +510,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Upgrades a reader lock to the writer lock, using an Int32 value for the time-out.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Threading.LockCookie" /> value.</para>
+        </returns>
         <param name="millisecondsTimeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The time-out in milliseconds. </param>
       </Docs>
@@ -525,7 +534,6 @@
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'LockCookie'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When a thread calls UpgradeToWriterLock the reader lock is released, regardless of the lock count, and the thread goes to the end of the queue for the writer lock. Thus, other threads might write to the resource before the thread that requested the upgrade is granted the writer lock.</para>
@@ -540,6 +548,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Upgrades a reader lock to the writer lock, using a TimeSpan value for the time-out.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Threading.LockCookie" /> value.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The TimeSpan specifying the time-out period. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Threading/RegisteredWaitHandle.xml b/mcs/class/corlib/Documentation/en/System.Threading/RegisteredWaitHandle.xml
index 70eb574f0b5..5530117165a 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading/RegisteredWaitHandle.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading/RegisteredWaitHandle.xml
@@ -63,7 +63,6 @@
         <Parameter Name="waitObject" Type="System.Threading.WaitHandle" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="waitObject" /> is specified, it is signaled only if the <see cref="T:System.Threading.RegisteredWaitHandle" /> is successfully unregistered. If a callback method is in progress when <see cref="M:System.Threading.RegisteredWaitHandle.Unregister(System.Threading.WaitHandle)" /> executes, <paramref name="waitObject" /> is not signaled until the callback method completes. In particular, if a callback method executes <see cref="M:System.Threading.RegisteredWaitHandle.Unregister(System.Threading.WaitHandle)" />, <paramref name="waitObject" /> is not signaled until that callback method completes.</para>
@@ -72,6 +71,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Cancels a registered wait operation issued by the <see cref="M:System.Threading.ThreadPool.RegisterWaitForSingleObject(System.Threading.WaitHandle,System.Threading.WaitOrTimerCallback,System.Object,System.UInt32,System.Boolean)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the function succeeds; otherwise, false.</para>
+        </returns>
         <param name="waitObject">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Threading.WaitHandle" /> to be signaled. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Threading/SemaphoreSlim.xml b/mcs/class/corlib/Documentation/en/System.Threading/SemaphoreSlim.xml
index c778d5a385e..c5a64038989 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading/SemaphoreSlim.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading/SemaphoreSlim.xml
@@ -178,12 +178,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Exits the <see cref="T:System.Threading.SemaphoreSlim" /> once.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The previous count of the <see cref="T:System.Threading.SemaphoreSlim" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Release">
@@ -200,12 +203,15 @@
         <Parameter Name="releaseCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Exits the <see cref="T:System.Threading.SemaphoreSlim" /> a specified number of times.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The previous count of the <see cref="T:System.Threading.SemaphoreSlim" />.</para>
+        </returns>
         <param name="releaseCount">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of times to exit the semaphore.</param>
       </Docs>
@@ -243,12 +249,15 @@
         <Parameter Name="millisecondsTimeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Blocks the current thread until it can enter the <see cref="T:System.Threading.SemaphoreSlim" />, using a 32-bit signed integer that specifies the timeout.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current thread successfully entered the <see cref="T:System.Threading.SemaphoreSlim" />; otherwise, false.</para>
+        </returns>
         <param name="millisecondsTimeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of milliseconds to wait, or <see cref="F:System.Threading.Timeout.Infinite" />(-1) to wait indefinitely.</param>
       </Docs>
@@ -290,12 +299,15 @@
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Blocks the current thread until it can enter the <see cref="T:System.Threading.SemaphoreSlim" />, using a <see cref="T:System.TimeSpan" /> to specify the timeout.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current thread successfully entered the <see cref="T:System.Threading.SemaphoreSlim" />; otherwise, false.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.TimeSpan" /> that represents the number of milliseconds to wait, or a <see cref="T:System.TimeSpan" /> that represents -1 milliseconds to wait indefinitely.</param>
       </Docs>
@@ -315,12 +327,15 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Blocks the current thread until it can enter the <see cref="T:System.Threading.SemaphoreSlim" />, using a 32-bit signed integer that specifies the timeout, while observing a <see cref="T:System.Threading.CancellationToken" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current thread successfully entered the <see cref="T:System.Threading.SemaphoreSlim" />; otherwise, false.</para>
+        </returns>
         <param name="millisecondsTimeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of milliseconds to wait, or <see cref="F:System.Threading.Timeout.Infinite" />(-1) to wait indefinitely.</param>
         <param name="cancellationToken">
@@ -342,12 +357,15 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Blocks the current thread until it can enter the <see cref="T:System.Threading.SemaphoreSlim" />, using a <see cref="T:System.TimeSpan" /> that specifies the timeout, while observing a <see cref="T:System.Threading.CancellationToken" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current thread successfully entered the <see cref="T:System.Threading.SemaphoreSlim" />; otherwise, false.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.TimeSpan" /> that represents the number of milliseconds to wait, or a <see cref="T:System.TimeSpan" /> that represents -1 milliseconds to wait indefinitely.</param>
         <param name="cancellationToken">
@@ -366,12 +384,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously waits to enter the <see cref="T:System.Threading.SemaphoreSlim" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that will complete when the semaphore has been entered.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="WaitAsync">
@@ -388,12 +409,15 @@
         <Parameter Name="millisecondsTimeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously waits to enter the <see cref="T:System.Threading.SemaphoreSlim" />, using a 32-bit signed integer to measure the time interval.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that will complete with a result of true if the current thread successfully entered the <see cref="T:System.Threading.SemaphoreSlim" />, otherwise with a result of false.</para>
+        </returns>
         <param name="millisecondsTimeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of milliseconds to wait, or <see cref="F:System.Threading.Timeout.Infinite" /> (-1) to wait indefinitely.</param>
       </Docs>
@@ -412,12 +436,15 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously waits to enter the <see cref="T:System.Threading.SemaphoreSlim" />, while observing a <see cref="T:System.Threading.CancellationToken" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that will complete when the semaphore has been entered.</para>
+        </returns>
         <param name="cancellationToken">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Threading.CancellationToken" /> token to observe.</param>
       </Docs>
@@ -436,12 +463,15 @@
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously waits to enter the <see cref="T:System.Threading.SemaphoreSlim" />, using a <see cref="T:System.TimeSpan" /> to measure the time interval.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that will complete with a result of true if the current thread successfully entered the <see cref="T:System.Threading.SemaphoreSlim" />, otherwise with a result of false.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.TimeSpan" /> that represents the number of milliseconds to wait, or a <see cref="T:System.TimeSpan" /> that represents -1 milliseconds to wait indefinitely.</param>
       </Docs>
@@ -461,12 +491,15 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously waits to enter the <see cref="T:System.Threading.SemaphoreSlim" />, using a 32-bit signed integer to measure the time interval, while observing a <see cref="T:System.Threading.CancellationToken" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that will complete with a result of true if the current thread successfully entered the <see cref="T:System.Threading.SemaphoreSlim" />, otherwise with a result of false.</para>
+        </returns>
         <param name="millisecondsTimeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of milliseconds to wait, or <see cref="F:System.Threading.Timeout.Infinite" /> (-1) to wait indefinitely.</param>
         <param name="cancellationToken">
@@ -488,12 +521,15 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Asynchronously waits to enter the <see cref="T:System.Threading.SemaphoreSlim" />, using a <see cref="T:System.TimeSpan" /> to measure the time interval, while observing a <see cref="T:System.Threading.CancellationToken" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A task that will complete with a result of true if the current thread successfully entered the <see cref="T:System.Threading.SemaphoreSlim" />, otherwise with a result of false.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.TimeSpan" /> that represents the number of milliseconds to wait, or a <see cref="T:System.TimeSpan" /> that represents -1 milliseconds to wait indefinitely.</param>
         <param name="cancellationToken">
diff --git a/mcs/class/corlib/Documentation/en/System.Threading/SpinWait.xml b/mcs/class/corlib/Documentation/en/System.Threading/SpinWait.xml
index 195897dc3ac..4d3e4f4b9ba 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading/SpinWait.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading/SpinWait.xml
@@ -147,12 +147,15 @@
         <Parameter Name="millisecondsTimeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Spins until the specified condition is satisfied or until the specified timeout is expired.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True if the condition is satisfied within the timeout; otherwise, false</para>
+        </returns>
         <param name="condition">
           <attribution license="cc4" from="Microsoft" modified="false" />A delegate to be executed over and over until it returns true.</param>
         <param name="millisecondsTimeout">
@@ -174,12 +177,15 @@
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Spins until the specified condition is satisfied or until the specified timeout is expired.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>True if the condition is satisfied within the timeout; otherwise, false</para>
+        </returns>
         <param name="condition">
           <attribution license="cc4" from="Microsoft" modified="false" />A delegate to be executed over and over until it returns true.</param>
         <param name="timeout">
diff --git a/mcs/class/corlib/Documentation/en/System.Threading/SynchronizationContext.xml b/mcs/class/corlib/Documentation/en/System.Threading/SynchronizationContext.xml
index 4c2061de81a..cecb38c7588 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading/SynchronizationContext.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading/SynchronizationContext.xml
@@ -60,7 +60,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -70,6 +69,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, creates a copy of the synchronization context.  </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Threading.SynchronizationContext" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Current">
@@ -109,13 +112,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if wait notification is required.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if wait notification is required; otherwise, false. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="OperationCompleted">
@@ -299,7 +305,6 @@
         <Parameter Name="millisecondsTimeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -309,6 +314,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits for any or all the elements in the specified array to receive a signal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The array index of the object that satisfied the wait.</para>
+        </returns>
         <param name="waitHandles">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.IntPtr" /> that contains the native operating system handles.</param>
         <param name="waitAll">
@@ -345,7 +354,6 @@
         <Parameter Name="millisecondsTimeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -356,6 +364,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Helper function that waits for any or all the elements in the specified array to receive a signal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The array index of the object that satisfied the wait.</para>
+        </returns>
         <param name="waitHandles">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type <see cref="T:System.IntPtr" /> that contains the native operating system handles.</param>
         <param name="waitAll">
diff --git a/mcs/class/corlib/Documentation/en/System.Threading/Thread.xml b/mcs/class/corlib/Documentation/en/System.Threading/Thread.xml
index f115d8bb295..05f87b25c60 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading/Thread.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading/Thread.xml
@@ -307,7 +307,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -320,6 +319,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Allocates an unnamed data slot on all the threads. For better performance, use fields that are marked with the <see cref="T:System.ThreadStaticAttribute" /> attribute instead.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The allocated named data slot on all threads.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="AllocateNamedDataSlot">
@@ -338,7 +341,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -355,6 +357,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Allocates a named data slot on all threads. For better performance, use fields that are marked with the <see cref="T:System.ThreadStaticAttribute" /> attribute instead.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The allocated named data slot on all threads.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the data slot to be allocated. </param>
       </Docs>
@@ -754,7 +760,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -764,6 +769,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Threading.ApartmentState" /> value indicating the apartment state.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the <see cref="T:System.Threading.ApartmentState" /> values indicating the apartment state of the managed thread. The default is <see cref="F:System.Threading.ApartmentState.Unknown" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetCompressedStack">
@@ -785,7 +794,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is no longer supported.</para>
@@ -794,6 +802,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Threading.CompressedStack" /> object that can be used to capture the stack for the current thread. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>None. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetData">
@@ -812,7 +824,6 @@
         <Parameter Name="slot" Type="System.LocalDataStoreSlot" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -828,6 +839,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the value from the specified slot on the current thread, within the current thread's current domain. For better performance, use fields that are marked with the <see cref="T:System.ThreadStaticAttribute" /> attribute instead.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The retrieved value.</para>
+        </returns>
         <param name="slot">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.LocalDataStoreSlot" /> from which to get the value. </param>
       </Docs>
@@ -847,14 +862,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.AppDomain" /> object that represents the current application domain.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the current domain in which the current thread is running.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.AppDomain" /> representing the current application domain of the running thread.</para>
+        </returns>
       </Docs>
       <Excluded>1</Excluded>
       <ExcludedLibrary>RuntimeInfrastructure</ExcludedLibrary>
@@ -873,12 +889,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a unique application domain identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer uniquely identifying the application domain.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -899,7 +918,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -909,6 +927,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash code for the current thread.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer hash code value.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetNamedDataSlot">
@@ -927,7 +949,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -940,6 +961,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Looks up a named data slot. For better performance, use fields that are marked with the <see cref="T:System.ThreadStaticAttribute" /> attribute instead.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.LocalDataStoreSlot" /> allocated for this thread.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the local data slot. </param>
       </Docs>
@@ -1103,12 +1128,6 @@ if this thread has been started, and has not terminated; otherwise,
         <Parameter Name="millisecondsTimeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true " />if the thread has terminated; <see langword="false " /> if the
-   thread has not terminated after <paramref name="millisecondsTimeout" />
-   has elapsed.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">The value of <paramref name="millisecondsTimeout" /> is negative and is not equal to <see cref="F:System.Threading.Timeout.Infinite" /> .</exception>
         <exception cref="T:System.Threading.ThreadStateException">The caller attempted to join a thread that is in the <see cref="F:System.Threading.ThreadState.Unstarted" /> state. </exception>
         <remarks>
@@ -1121,6 +1140,10 @@ if this thread has been started, and has not terminated; otherwise,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Blocks the calling thread until a thread terminates or the specified time elapses, while continuing to perform standard COM and SendMessage pumping.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the thread has terminated; false if the thread has not terminated after the amount of time specified by the <paramref name="millisecondsTimeout" /> parameter has elapsed.</para>
+        </returns>
         <param name="millisecondsTimeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of milliseconds to wait for the thread to terminate. </param>
       </Docs>
@@ -1143,13 +1166,6 @@ if this thread has been started, and has not terminated; otherwise,
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true " />if the thread has terminated;
-<see langword="false " /> if the thread has not terminated after the amount 
-   of time specified by <paramref name="timeout" />
-   has elapsed.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">The value of <paramref name="timeout" /> is negative and is not equal to <see cref="F:System.Threading.Timeout.Infinite" /> milliseconds, or is greater than <see cref="F:System.Int32.MaxValue" qualify="true" /> milliseconds.</exception>
         <exception cref="T:System.Threading.ThreadStateException">The caller attempted to join a thread that is in the <see cref="F:System.Threading.ThreadState.Unstarted" /> state. </exception>
         <remarks>
@@ -1162,6 +1178,10 @@ if this thread has been started, and has not terminated; otherwise,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Blocks the calling thread until a thread terminates or the specified time elapses, while continuing to perform standard COM and SendMessage pumping.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the thread terminated; false if the thread has not terminated after the amount of time specified by the <paramref name="timeout" /> parameter has elapsed.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.TimeSpan" /> set to the amount of time to wait for the thread to terminate. </param>
       </Docs>
@@ -1885,7 +1905,6 @@ class ThreadTest{
         <Parameter Name="state" Type="System.Threading.ApartmentState" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1899,6 +1918,10 @@ class ThreadTest{
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the apartment state of a thread before it is started.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the apartment state is set; otherwise, false.</para>
+        </returns>
         <param name="state">
           <attribution license="cc4" from="Microsoft" modified="false" />The new apartment state.</param>
       </Docs>
@@ -2736,7 +2759,6 @@ class ThreadTest{
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If this method succeeds, the rest of the thread's current time slice is yielded. The operating system schedules the calling thread for another time slice, according to its priority and the status of other threads that are available to run. </para>
@@ -2747,6 +2769,10 @@ class ThreadTest{
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Causes the calling thread to yield execution to another thread that is ready to run on the current processor. The operating system selects the thread to yield to.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the operating system switched execution to another thread; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System.Threading/ThreadLocal`1.xml b/mcs/class/corlib/Documentation/en/System.Threading/ThreadLocal`1.xml
index bf3517bbc13..b1e9486a1b0 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading/ThreadLocal`1.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading/ThreadLocal`1.xml
@@ -206,7 +206,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method forces initialization for the current thread, as is the case with accessing <see cref="P:System.Threading.ThreadLocal`1.Value" /> directly.</para>
@@ -215,6 +214,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a string representation of this instance for the current thread.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of calling <see cref="M:System.Object.ToString" /> on the <see cref="P:System.Threading.ThreadLocal`1.Value" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System.Threading/ThreadPool.xml b/mcs/class/corlib/Documentation/en/System.Threading/ThreadPool.xml
index c66e91e713f..56a7d1e4c20 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading/ThreadPool.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading/ThreadPool.xml
@@ -77,12 +77,15 @@
         <Parameter Name="osHandle" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Binds an operating system handle to the <see cref="T:System.Threading.ThreadPool" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the handle is bound; otherwise, false.</para>
+        </returns>
         <param name="osHandle">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IntPtr" /> that holds the handle. The handle must have been opened for overlapped I/O on the unmanaged side. </param>
       </Docs>
@@ -102,7 +105,6 @@
         <Parameter Name="osHandle" Type="System.Runtime.InteropServices.SafeHandle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -112,6 +114,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Binds an operating system handle to the <see cref="T:System.Threading.ThreadPool" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the handle is bound; otherwise, false.</para>
+        </returns>
         <param name="osHandle">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Runtime.InteropServices.SafeHandle" />  that holds the operating system handle. The handle must have been opened for overlapped I/O on the unmanaged side.</param>
       </Docs>
@@ -201,7 +207,6 @@
         <Parameter Name="callBack" Type="System.Threading.WaitCallback" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can place data required by the queued method in the instance fields of the class in which the method is defined, or you can use the <see cref="M:System.Threading.ThreadPool.QueueUserWorkItem(System.Threading.WaitCallback,System.Object)" /> overload that accepts an object containing the necessary data.</para>
@@ -217,6 +222,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Queues a method for execution. The method executes when a thread pool thread becomes available.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the method is successfully queued; <see cref="T:System.NotSupportedException" /> is thrown if the work item could not be queued.</para>
+        </returns>
         <param name="callBack">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Threading.WaitCallback" /> that represents the method to be executed. </param>
       </Docs>
@@ -238,7 +247,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the callback method requires complex data, you can define a class to contain the data.</para>
@@ -254,6 +262,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Queues a method for execution, and specifies an object containing data to be used by the method. The method executes when a thread pool thread becomes available.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the method is successfully queued; <see cref="T:System.NotSupportedException" /> is thrown if the work item could not be queued.</para>
+        </returns>
         <param name="callBack">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Threading.WaitCallback" /> representing the method to execute. </param>
         <param name="state">
@@ -280,7 +292,6 @@
         <Parameter Name="executeOnlyOnce" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'RegisteredWaitHandle'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When you are finished using the <see cref="T:System.Threading.RegisteredWaitHandle" /> that is returned by this method, call its <see cref="M:System.Threading.RegisteredWaitHandle.Unregister(System.Threading.WaitHandle)" /> method to release references to the wait handle. We recommend that you always call the <see cref="M:System.Threading.RegisteredWaitHandle.Unregister(System.Threading.WaitHandle)" /> method, even if you specify true for <paramref name="executeOnlyOnce" />. Garbage collection works more efficiently if you call the <see cref="M:System.Threading.RegisteredWaitHandle.Unregister(System.Threading.WaitHandle)" /> method instead of depending on the registered wait handle's finalizer.</para>
@@ -309,6 +320,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Registers a delegate to wait for a <see cref="T:System.Threading.WaitHandle" />, specifying a 32-bit signed integer for the time-out in milliseconds.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Threading.RegisteredWaitHandle" /> that encapsulates the native handle.</para>
+        </returns>
         <param name="waitObject">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Threading.WaitHandle" /> to register. Use a <see cref="T:System.Threading.WaitHandle" /> other than <see cref="T:System.Threading.Mutex" />.</param>
         <param name="callBack">
@@ -341,7 +356,6 @@
         <Parameter Name="executeOnlyOnce" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'RegisteredWaitHandle'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When you are finished using the <see cref="T:System.Threading.RegisteredWaitHandle" /> that is returned by this method, call its <see cref="M:System.Threading.RegisteredWaitHandle.Unregister(System.Threading.WaitHandle)" /> method to release references to the wait handle. We recommend that you always call the <see cref="M:System.Threading.RegisteredWaitHandle.Unregister(System.Threading.WaitHandle)" /> method, even if you specify true for <paramref name="executeOnlyOnce" />. Garbage collection works more efficiently if you call the <see cref="M:System.Threading.RegisteredWaitHandle.Unregister(System.Threading.WaitHandle)" /> method instead of depending on the registered wait handle's finalizer.</para>
@@ -370,6 +384,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Registers a delegate to wait for a <see cref="T:System.Threading.WaitHandle" />, specifying a 64-bit signed integer for the time-out in milliseconds.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Threading.RegisteredWaitHandle" /> that encapsulates the native handle.</para>
+        </returns>
         <param name="waitObject">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Threading.WaitHandle" /> to register. Use a <see cref="T:System.Threading.WaitHandle" /> other than <see cref="T:System.Threading.Mutex" />.</param>
         <param name="callBack">
@@ -402,7 +420,6 @@
         <Parameter Name="executeOnlyOnce" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'RegisteredWaitHandle'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When you are finished using the <see cref="T:System.Threading.RegisteredWaitHandle" /> that is returned by this method, call its <see cref="M:System.Threading.RegisteredWaitHandle.Unregister(System.Threading.WaitHandle)" /> method to release references to the wait handle. We recommend that you always call the <see cref="M:System.Threading.RegisteredWaitHandle.Unregister(System.Threading.WaitHandle)" /> method, even if you specify true for <paramref name="executeOnlyOnce" />. Garbage collection works more efficiently if you call the <see cref="M:System.Threading.RegisteredWaitHandle.Unregister(System.Threading.WaitHandle)" /> method instead of depending on the registered wait handle's finalizer.</para>
@@ -431,6 +448,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Registers a delegate to wait for a <see cref="T:System.Threading.WaitHandle" />, specifying a <see cref="T:System.TimeSpan" /> value for the time-out.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Threading.RegisteredWaitHandle" /> that encapsulates the native handle.</para>
+        </returns>
         <param name="waitObject">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Threading.WaitHandle" /> to register. Use a <see cref="T:System.Threading.WaitHandle" /> other than <see cref="T:System.Threading.Mutex" />.</param>
         <param name="callBack">
@@ -468,7 +489,6 @@
         <Parameter Name="executeOnlyOnce" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'RegisteredWaitHandle'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When you are finished using the <see cref="T:System.Threading.RegisteredWaitHandle" /> that is returned by this method, call its <see cref="M:System.Threading.RegisteredWaitHandle.Unregister(System.Threading.WaitHandle)" /> method to release references to the wait handle. We recommend that you always call the <see cref="M:System.Threading.RegisteredWaitHandle.Unregister(System.Threading.WaitHandle)" /> method, even if you specify true for <paramref name="executeOnlyOnce" />. Garbage collection works more efficiently if you call the <see cref="M:System.Threading.RegisteredWaitHandle.Unregister(System.Threading.WaitHandle)" /> method instead of depending on the registered wait handle's finalizer.</para>
@@ -497,6 +517,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Registers a delegate to wait for a <see cref="T:System.Threading.WaitHandle" />, specifying a 32-bit unsigned integer for the time-out in milliseconds.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Threading.RegisteredWaitHandle" /> that can be used to cancel the registered wait operation.</para>
+        </returns>
         <param name="waitObject">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Threading.WaitHandle" /> to register. Use a <see cref="T:System.Threading.WaitHandle" /> other than <see cref="T:System.Threading.Mutex" />.</param>
         <param name="callBack">
@@ -525,7 +549,6 @@
         <Parameter Name="completionPortThreads" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -538,6 +561,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the number of requests to the thread pool that can be active concurrently. All requests above that number remain queued until thread pool threads become available.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the change is successful; otherwise, false.</para>
+        </returns>
         <param name="workerThreads">
           <attribution license="cc4" from="Microsoft" modified="false" />The maximum number of worker threads in the thread pool. </param>
         <param name="completionPortThreads">
@@ -561,7 +588,6 @@
         <Parameter Name="completionPortThreads" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The thread pool provides new worker threads or I/O completion threads on demand until it reaches the minimum for each category. When the minimum is reached, the thread pool can create additional threads in that category or wait until some tasks complete. Beginning with the net_v40_short, the thread pool creates and destroys threads in order to optimize throughput, which is defined as the number of tasks that complete per unit of time. Too few threads might not make optimal use of available resources, whereas too many threads could increase resource contention. </para>
@@ -575,6 +601,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Sets the minimum number of threads the thread pool creates on demand, as new requests are made, before switching to an algorithm for managing thread creation and destruction.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the change is successful; otherwise, false.</para>
+        </returns>
         <param name="workerThreads">
           <attribution license="cc4" from="Microsoft" modified="false" />The minimum number of worker threads that the thread pool creates on demand. </param>
         <param name="completionPortThreads">
@@ -601,7 +631,6 @@
         <Parameter Name="overlapped" Type="System.Threading.NativeOverlapped*" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -614,6 +643,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Queues an overlapped I/O operation for execution.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the operation was successfully queued to an I/O completion port; otherwise, false.</para>
+        </returns>
         <param name="overlapped">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Threading.NativeOverlapped" /> structure to queue.</param>
       </Docs>
@@ -635,7 +668,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Unlike the <see cref="M:System.Threading.ThreadPool.QueueUserWorkItem(System.Threading.WaitCallback,System.Object)" /> method, <see cref="M:System.Threading.ThreadPool.UnsafeQueueUserWorkItem(System.Threading.WaitCallback,System.Object)" /> does not propagate the calling stack to the worker thread. This allows code to lose the calling stack and thereby to elevate its security privileges.</para>
@@ -647,6 +679,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Queues the specified delegate to the thread pool, but does not propagate the calling stack to the worker thread.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the method succeeds; <see cref="T:System.OutOfMemoryException" /> is thrown if the work item could not be queued.</para>
+        </returns>
         <param name="callBack">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Threading.WaitCallback" /> that represents the delegate to invoke when a thread in the thread pool picks up the work item. </param>
         <param name="state">
@@ -673,7 +709,6 @@
         <Parameter Name="executeOnlyOnce" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Unlike the <see cref="M:System.Threading.ThreadPool.RegisterWaitForSingleObject(System.Threading.WaitHandle,System.Threading.WaitOrTimerCallback,System.Object,System.UInt32,System.Boolean)" /> method, <see cref="M:System.Threading.ThreadPool.UnsafeRegisterWaitForSingleObject(System.Threading.WaitHandle,System.Threading.WaitOrTimerCallback,System.Object,System.Int32,System.Boolean)" /> does not propagate the calling stack to the worker thread. This allows code to lose the calling stack and thereby to elevate its security privileges.</para>
@@ -687,6 +722,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Registers a delegate to wait for a <see cref="T:System.Threading.WaitHandle" />, using a 32-bit signed integer for the time-out in milliseconds. This method does not propagate the calling stack to the worker thread.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Threading.RegisteredWaitHandle" /> object that can be used to cancel the registered wait operation.</para>
+        </returns>
         <param name="waitObject">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Threading.WaitHandle" /> to register. Use a <see cref="T:System.Threading.WaitHandle" /> other than <see cref="T:System.Threading.Mutex" />.</param>
         <param name="callBack">
@@ -719,7 +758,6 @@
         <Parameter Name="executeOnlyOnce" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Unlike the <see cref="M:System.Threading.ThreadPool.RegisterWaitForSingleObject(System.Threading.WaitHandle,System.Threading.WaitOrTimerCallback,System.Object,System.UInt32,System.Boolean)" /> method, <see cref="M:System.Threading.ThreadPool.UnsafeRegisterWaitForSingleObject(System.Threading.WaitHandle,System.Threading.WaitOrTimerCallback,System.Object,System.Int64,System.Boolean)" /> does not propagate the calling stack to the worker thread. This allows code to lose the calling stack and thereby to elevate its security privileges.</para>
@@ -733,6 +771,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Registers a delegate to wait for a <see cref="T:System.Threading.WaitHandle" />, specifying a 64-bit signed integer for the time-out in milliseconds. This method does not propagate the calling stack to the worker thread.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Threading.RegisteredWaitHandle" /> object that can be used to cancel the registered wait operation.</para>
+        </returns>
         <param name="waitObject">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Threading.WaitHandle" /> to register. Use a <see cref="T:System.Threading.WaitHandle" /> other than <see cref="T:System.Threading.Mutex" />.</param>
         <param name="callBack">
@@ -765,7 +807,6 @@
         <Parameter Name="executeOnlyOnce" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Unlike the <see cref="M:System.Threading.ThreadPool.RegisterWaitForSingleObject(System.Threading.WaitHandle,System.Threading.WaitOrTimerCallback,System.Object,System.UInt32,System.Boolean)" /> method, <see cref="M:System.Threading.ThreadPool.UnsafeRegisterWaitForSingleObject(System.Threading.WaitHandle,System.Threading.WaitOrTimerCallback,System.Object,System.TimeSpan,System.Boolean)" /> does not propagate the calling stack to the worker thread. This allows code to lose the calling stack and thereby to elevate its security privileges.</para>
@@ -779,6 +820,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Registers a delegate to wait for a <see cref="T:System.Threading.WaitHandle" />, specifying a <see cref="T:System.TimeSpan" /> value for the time-out. This method does not propagate the calling stack to the worker thread.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Threading.RegisteredWaitHandle" /> object that can be used to cancel the registered wait operation.</para>
+        </returns>
         <param name="waitObject">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Threading.WaitHandle" /> to register. Use a <see cref="T:System.Threading.WaitHandle" /> other than <see cref="T:System.Threading.Mutex" />.</param>
         <param name="callBack">
@@ -816,7 +861,6 @@
         <Parameter Name="executeOnlyOnce" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Unlike the <see cref="M:System.Threading.ThreadPool.RegisterWaitForSingleObject(System.Threading.WaitHandle,System.Threading.WaitOrTimerCallback,System.Object,System.UInt32,System.Boolean)" /> method, <see cref="M:System.Threading.ThreadPool.UnsafeRegisterWaitForSingleObject(System.Threading.WaitHandle,System.Threading.WaitOrTimerCallback,System.Object,System.UInt32,System.Boolean)" /> does not propagate the calling stack to the worker thread. This allows code to lose the calling stack and thereby to elevate its security privileges.</para>
@@ -830,6 +874,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Registers a delegate to wait for a <see cref="T:System.Threading.WaitHandle" />, specifying a 32-bit unsigned integer for the time-out in milliseconds. This method does not propagate the calling stack to the worker thread.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Threading.RegisteredWaitHandle" /> object that can be used to cancel the registered wait operation.</para>
+        </returns>
         <param name="waitObject">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Threading.WaitHandle" /> to register. Use a <see cref="T:System.Threading.WaitHandle" /> other than <see cref="T:System.Threading.Mutex" />.</param>
         <param name="callBack">
diff --git a/mcs/class/corlib/Documentation/en/System.Threading/Timer.xml b/mcs/class/corlib/Documentation/en/System.Threading/Timer.xml
index 14b43466bc8..fb7baf0c64a 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading/Timer.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading/Timer.xml
@@ -339,11 +339,6 @@ class App {
         <Parameter Name="period" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true " />
-if the current instance has not been disposed; otherwise, <see langword="false" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="dueTime" /> or <paramref name="period" /> is negative and is not equal to <see cref="F:System.Threading.Timeout.Infinite" /> .</exception>
         <remarks>
@@ -356,6 +351,10 @@ if the current instance has not been disposed; otherwise, <see langword="false"
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Changes the start time and the interval between method invocations for a timer, using 32-bit signed integers to measure time intervals.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the timer was successfully updated; otherwise, false.</para>
+        </returns>
         <param name="dueTime">
           <attribution license="cc4" from="Microsoft" modified="false" />The amount of time to delay before the invoking the callback method specified when the <see cref="T:System.Threading.Timer" /> was constructed, in milliseconds. Specify <see cref="F:System.Threading.Timeout.Infinite" /> to prevent the timer from restarting. Specify zero (0) to restart the timer immediately. </param>
         <param name="period">
@@ -380,7 +379,6 @@ if the current instance has not been disposed; otherwise, <see langword="false"
         <Parameter Name="period" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The callback method is invoked once after <paramref name="dueTime" /> elapses, and thereafter each time the time interval specified by <paramref name="period" /> elapses.</para>
@@ -391,6 +389,10 @@ if the current instance has not been disposed; otherwise, <see langword="false"
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Changes the start time and the interval between method invocations for a timer, using 64-bit signed integers to measure time intervals.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the timer was successfully updated; otherwise, false.</para>
+        </returns>
         <param name="dueTime">
           <attribution license="cc4" from="Microsoft" modified="false" />The amount of time to delay before the invoking the callback method specified when the <see cref="T:System.Threading.Timer" /> was constructed, in milliseconds. Specify <see cref="F:System.Threading.Timeout.Infinite" /> to prevent the timer from restarting. Specify zero (0) to restart the timer immediately. </param>
         <param name="period">
@@ -415,12 +417,6 @@ if the current instance has not been disposed; otherwise, <see langword="false"
         <Parameter Name="period" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true " /> if the current instance has
-   not been disposed; otherwise, <see langword="false" />.
-   </para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="dueTime" /> or <paramref name="period" /> is negative and is not equal to <see cref="F:System.Threading.Timeout.Infinite" /> .</exception>
         <remarks>
@@ -433,6 +429,10 @@ if the current instance has not been disposed; otherwise, <see langword="false"
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Changes the start time and the interval between method invocations for a timer, using <see cref="T:System.TimeSpan" /> values to measure time intervals.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the timer was successfully updated; otherwise, false.</para>
+        </returns>
         <param name="dueTime">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.TimeSpan" /> representing the amount of time to delay before invoking the callback method specified when the <see cref="T:System.Threading.Timer" /> was constructed. Specify negative one (-1) milliseconds to prevent the timer from restarting. Specify zero (0) to restart the timer immediately. </param>
         <param name="period">
@@ -462,7 +462,6 @@ if the current instance has not been disposed; otherwise, <see langword="false"
         <Parameter Name="period" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The callback method is invoked once after <paramref name="dueTime" /> elapses, and thereafter each time the time interval specified by <paramref name="period" /> elapses.</para>
@@ -473,6 +472,10 @@ if the current instance has not been disposed; otherwise, <see langword="false"
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Changes the start time and the interval between method invocations for a timer, using 32-bit unsigned integers to measure time intervals.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the timer was successfully updated; otherwise, false.</para>
+        </returns>
         <param name="dueTime">
           <attribution license="cc4" from="Microsoft" modified="false" />The amount of time to delay before the invoking the callback method specified when the <see cref="T:System.Threading.Timer" /> was constructed, in milliseconds. Specify <see cref="F:System.Threading.Timeout.Infinite" /> to prevent the timer from restarting. Specify zero (0) to restart the timer immediately. </param>
         <param name="period">
@@ -525,12 +528,6 @@ if the current instance has not been disposed; otherwise, <see langword="false"
         <Parameter Name="notifyObject" Type="System.Threading.WaitHandle" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true " />if the call succeeds;
-   otherwise, <see langword="false" />.
-   </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="notifyObject" /> is <see langword="null" />.</exception>
         <remarks>
@@ -545,6 +542,10 @@ if the current instance has not been disposed; otherwise, <see langword="false"
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Releases all resources used by the current instance of <see cref="T:System.Threading.Timer" /> and signals when the timer has been disposed of.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the function succeeds; otherwise, false.</para>
+        </returns>
         <param name="notifyObject">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Threading.WaitHandle" /> to be signaled when the Timer has been disposed of. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System.Threading/WaitHandle.xml b/mcs/class/corlib/Documentation/en/System.Threading/WaitHandle.xml
index fa1165153d5..0a1bccf12f4 100644
--- a/mcs/class/corlib/Documentation/en/System.Threading/WaitHandle.xml
+++ b/mcs/class/corlib/Documentation/en/System.Threading/WaitHandle.xml
@@ -278,7 +278,6 @@
         <Parameter Name="toWaitOn" Type="System.Threading.WaitHandle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -288,6 +287,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Signals one <see cref="T:System.Threading.WaitHandle" /> and waits on another.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if both the signal and the wait complete successfully; if the wait does not complete, the method does not return.</para>
+        </returns>
         <param name="toSignal">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Threading.WaitHandle" /> to signal.</param>
         <param name="toWaitOn">
@@ -312,7 +315,6 @@
         <Parameter Name="exitContext" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -329,6 +331,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Signals one <see cref="T:System.Threading.WaitHandle" /> and waits on another, specifying a time-out interval as a 32-bit signed integer and specifying whether to exit the synchronization domain for the context before entering the wait.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if both the signal and the wait completed successfully, or false if the signal completed but the wait timed out.</para>
+        </returns>
         <param name="toSignal">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Threading.WaitHandle" /> to signal.</param>
         <param name="toWaitOn">
@@ -357,7 +363,6 @@
         <Parameter Name="exitContext" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -375,6 +380,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Signals one <see cref="T:System.Threading.WaitHandle" /> and waits on another, specifying the time-out interval as a <see cref="T:System.TimeSpan" /> and specifying whether to exit the synchronization domain for the context before entering the wait.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if both the signal and the wait completed successfully, or false if the signal completed but the wait timed out.</para>
+        </returns>
         <param name="toSignal">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Threading.WaitHandle" /> to signal.</param>
         <param name="toWaitOn">
@@ -424,13 +433,6 @@
         <Parameter Name="waitHandles" Type="System.Threading.WaitHandle[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns <see langword="true" /> when
-   every element in <paramref name="waitHandles" /> has received a
-   signal. If the current
-   thread receives a request to abort before the signals are received, this method
-   returns <see langword="false" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="waitHandles " />is <see langword="null" /> or one or more elements in the <paramref name="waitHandles " /> array is <see langword="null" />.</exception>
         <exception cref="T:System.DuplicateWaitObjectException">
@@ -450,6 +452,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits for all the elements in the specified array to receive a signal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true when every element in <paramref name="waitHandles" /> has received a signal; otherwise the method never returns.</para>
+        </returns>
         <param name="waitHandles">
           <attribution license="cc4" from="Microsoft" modified="false" />A WaitHandle array containing the objects for which the current instance will wait. This array cannot contain multiple references to the same object. </param>
       </Docs>
@@ -471,7 +477,6 @@
         <Parameter Name="millisecondsTimeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="millisecondsTimeout" /> is zero, the method does not block. It tests the state of the wait handles and returns immediately. </para>
@@ -485,6 +490,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits for all the elements in the specified array to receive a signal, using an <see cref="T:System.Int32" /> value to specify the time interval.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true when every element in <paramref name="waitHandles" /> has received a signal; otherwise, false.</para>
+        </returns>
         <param name="waitHandles">
           <attribution license="cc4" from="Microsoft" modified="false" />A WaitHandle array containing the objects for which the current instance will wait. This array cannot contain multiple references to the same object (duplicates). </param>
         <param name="millisecondsTimeout">
@@ -507,7 +516,6 @@
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="timeout" /> is zero, the method does not block. It tests the state of the wait handles and returns immediately. </para>
@@ -522,6 +530,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits for all the elements in the specified array to receive a signal, using a <see cref="T:System.TimeSpan" /> value to specify the time interval.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true when every element in <paramref name="waitHandles" /> has received a signal; otherwise, false.</para>
+        </returns>
         <param name="waitHandles">
           <attribution license="cc4" from="Microsoft" modified="false" />A WaitHandle array containing the objects for which the current instance will wait. This array cannot contain multiple references to the same object. </param>
         <param name="timeout">
@@ -546,7 +558,6 @@
         <Parameter Name="exitContext" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="millisecondsTimeout" /> is zero, the method does not block. It tests the state of the wait handles and returns immediately. </para>
@@ -567,6 +578,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits for all the elements in the specified array to receive a signal, using an <see cref="T:System.Int32" /> value to specify the time interval and specifying whether to exit the synchronization domain before the wait.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true when every element in <paramref name="waitHandles" /> has received a signal; otherwise, false.</para>
+        </returns>
         <param name="waitHandles">
           <attribution license="cc4" from="Microsoft" modified="false" />A WaitHandle array containing the objects for which the current instance will wait. This array cannot contain multiple references to the same object (duplicates). </param>
         <param name="millisecondsTimeout">
@@ -593,7 +608,6 @@
         <Parameter Name="exitContext" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="timeout" /> is zero, the method does not block. It tests the state of the wait handles and returns immediately. </para>
@@ -615,6 +629,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits for all the elements in the specified array to receive a signal, using a <see cref="T:System.TimeSpan" /> value to specify the time interval, and specifying whether to exit the synchronization domain before the wait.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true when every element in <paramref name="waitHandles" /> has received a signal; otherwise false.</para>
+        </returns>
         <param name="waitHandles">
           <attribution license="cc4" from="Microsoft" modified="false" />A WaitHandle array containing the objects for which the current instance will wait. This array cannot contain multiple references to the same object. </param>
         <param name="timeout">
@@ -645,10 +663,6 @@
         <Parameter Name="waitHandles" Type="System.Threading.WaitHandle[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns a <see cref="T:System.Int32" /> set to the index of
-   the element in <paramref name="waitHandles" /> that received a signal.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="waitHandles " />is <see langword="null" /> or one or more elements in the <paramref name="waitHandles " /> array is <see langword="null" />.</exception>
         <exception cref="T:System.DuplicateWaitObjectException">
@@ -669,6 +683,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits for any of the elements in the specified array to receive a signal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The array index of the object that satisfied the wait.</para>
+        </returns>
         <param name="waitHandles">
           <attribution license="cc4" from="Microsoft" modified="false" />A WaitHandle array containing the objects for which the current instance will wait. </param>
       </Docs>
@@ -695,7 +713,6 @@
         <Parameter Name="millisecondsTimeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="millisecondsTimeout" /> is zero, the method does not block. It tests the state of the wait handles and returns immediately. </para>
@@ -707,6 +724,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits for any of the elements in the specified array to receive a signal, using a 32-bit signed integer to specify the time interval.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The array index of the object that satisfied the wait, or <see cref="F:System.Threading.WaitHandle.WaitTimeout" /> if no object satisfied the wait and a time interval equivalent to <paramref name="millisecondsTimeout" /> has passed.</para>
+        </returns>
         <param name="waitHandles">
           <attribution license="cc4" from="Microsoft" modified="false" />A WaitHandle array containing the objects for which the current instance will wait. </param>
         <param name="millisecondsTimeout">
@@ -734,7 +755,6 @@
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="timeout" /> is zero, the method does not block. It tests the state of the wait handles and returns immediately. </para>
@@ -747,6 +767,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits for any of the elements in the specified array to receive a signal, using a <see cref="T:System.TimeSpan" /> to specify the time interval.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The array index of the object that satisfied the wait, or <see cref="F:System.Threading.WaitHandle.WaitTimeout" /> if no object satisfied the wait and a time interval equivalent to <paramref name="timeout" /> has passed.</para>
+        </returns>
         <param name="waitHandles">
           <attribution license="cc4" from="Microsoft" modified="false" />A WaitHandle array containing the objects for which the current instance will wait. </param>
         <param name="timeout">
@@ -776,7 +800,6 @@
         <Parameter Name="exitContext" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="millisecondsTimeout" /> is zero, the method does not block. It tests the state of the wait handles and returns immediately. </para>
@@ -798,6 +821,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits for any of the elements in the specified array to receive a signal, using a 32-bit signed integer to specify the time interval, and specifying whether to exit the synchronization domain before the wait.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The array index of the object that satisfied the wait, or <see cref="F:System.Threading.WaitHandle.WaitTimeout" /> if no object satisfied the wait and a time interval equivalent to <paramref name="millisecondsTimeout" /> has passed.</para>
+        </returns>
         <param name="waitHandles">
           <attribution license="cc4" from="Microsoft" modified="false" />A WaitHandle array containing the objects for which the current instance will wait. </param>
         <param name="millisecondsTimeout">
@@ -829,7 +856,6 @@
         <Parameter Name="exitContext" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="timeout" /> is zero, the method does not block. It tests the state of the wait handles and returns immediately. </para>
@@ -852,6 +878,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Waits for any of the elements in the specified array to receive a signal, using a <see cref="T:System.TimeSpan" /> to specify the time interval and specifying whether to exit the synchronization domain before the wait.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The array index of the object that satisfied the wait, or <see cref="F:System.Threading.WaitHandle.WaitTimeout" /> if no object satisfied the wait and a time interval equivalent to <paramref name="timeout" /> has passed.</para>
+        </returns>
         <param name="waitHandles">
           <attribution license="cc4" from="Microsoft" modified="false" />A WaitHandle array containing the objects for which the current instance will wait. </param>
         <param name="timeout">
@@ -875,11 +905,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>Returns <see langword="true" />
-when the
-current instance receives a signal.</para>
-        </returns>
         <exception cref="T:System.ObjectDisposedException">The current instance has already been disposed.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -893,6 +918,10 @@ current instance receives a signal.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Blocks the current thread until the current <see cref="T:System.Threading.WaitHandle" /> receives a signal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current instance receives a signal. If the current instance is never signaled, <see cref="M:System.Threading.WaitHandle.WaitOne(System.Int32,System.Boolean)" /> never returns.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -911,7 +940,6 @@ current instance receives a signal.</para>
         <Parameter Name="millisecondsTimeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="millisecondsTimeout" /> is zero, the method does not block. It tests the state of the wait handle and returns immediately. </para>
@@ -923,6 +951,10 @@ current instance receives a signal.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Blocks the current thread until the current <see cref="T:System.Threading.WaitHandle" /> receives a signal, using a 32-bit signed integer to specify the time interval.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current instance receives a signal; otherwise, false.</para>
+        </returns>
         <param name="millisecondsTimeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of milliseconds to wait, or <see cref="F:System.Threading.Timeout.Infinite" /> (-1) to wait indefinitely. </param>
       </Docs>
@@ -942,7 +974,6 @@ current instance receives a signal.</para>
         <Parameter Name="timeout" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="timeout" /> is zero, the method does not block. It tests the state of the wait handle and returns immediately. </para>
@@ -955,6 +986,10 @@ current instance receives a signal.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Blocks the current thread until the current instance receives a signal, using a <see cref="T:System.TimeSpan" /> to specify the time interval.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current instance receives a signal; otherwise, false.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.TimeSpan" /> that represents the number of milliseconds to wait, or a <see cref="T:System.TimeSpan" /> that represents -1 milliseconds to wait indefinitely. </param>
       </Docs>
@@ -976,7 +1011,6 @@ current instance receives a signal.</para>
         <Parameter Name="exitContext" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="millisecondsTimeout" /> is zero, the method does not block. It tests the state of the wait handle and returns immediately. </para>
@@ -995,6 +1029,10 @@ current instance receives a signal.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Blocks the current thread until the current <see cref="T:System.Threading.WaitHandle" /> receives a signal, using a 32-bit signed integer to specify the time interval and specifying whether to exit the synchronization domain before the wait.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current instance receives a signal; otherwise, false.</para>
+        </returns>
         <param name="millisecondsTimeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of milliseconds to wait, or <see cref="F:System.Threading.Timeout.Infinite" /> (-1) to wait indefinitely. </param>
         <param name="exitContext">
@@ -1018,7 +1056,6 @@ current instance receives a signal.</para>
         <Parameter Name="exitContext" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="timeout" /> is zero, the method does not block. It tests the state of the wait handle and returns immediately. </para>
@@ -1038,6 +1075,10 @@ current instance receives a signal.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Blocks the current thread until the current instance receives a signal, using a <see cref="T:System.TimeSpan" /> to specify the time interval and specifying whether to exit the synchronization domain before the wait.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current instance receives a signal; otherwise, false.</para>
+        </returns>
         <param name="timeout">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.TimeSpan" /> that represents the number of milliseconds to wait, or a <see cref="T:System.TimeSpan" /> that represents -1 milliseconds to wait indefinitely. </param>
         <param name="exitContext">
diff --git a/mcs/class/corlib/Documentation/en/System/ActivationContext.xml b/mcs/class/corlib/Documentation/en/System/ActivationContext.xml
index d6d2a812904..41db1cf06ff 100644
--- a/mcs/class/corlib/Documentation/en/System/ActivationContext.xml
+++ b/mcs/class/corlib/Documentation/en/System/ActivationContext.xml
@@ -50,7 +50,6 @@
         <Parameter Name="identity" Type="System.ApplicationIdentity" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -60,6 +59,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of the <see cref="T:System.ActivationContext" /> class using the specified application identity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object with the specified application identity.</para>
+        </returns>
         <param name="identity">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that identifies an application.</param>
       </Docs>
@@ -80,7 +83,6 @@
         <Parameter Name="manifestPaths" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -90,6 +92,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of the <see cref="T:System.ActivationContext" /> class using the specified application identity and array of manifest paths.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object with the specified application identity and array of manifest paths.</para>
+        </returns>
         <param name="identity">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that identifies an application.</param>
         <param name="manifestPaths">
diff --git a/mcs/class/corlib/Documentation/en/System/Activator.xml b/mcs/class/corlib/Documentation/en/System/Activator.xml
index b7eaac6aa7e..a5768abb2d8 100644
--- a/mcs/class/corlib/Documentation/en/System/Activator.xml
+++ b/mcs/class/corlib/Documentation/en/System/Activator.xml
@@ -64,7 +64,6 @@
         <Parameter Name="typeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.ObjectHandle'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Runtime.Remoting.ObjectHandle.Unwrap" /> method to unwrap the return value.</para>
@@ -79,6 +78,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the COM object whose name is specified, using the named assembly file and the constructor that best matches the specified parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A handle that must be unwrapped to access the newly created instance.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a file that contains an assembly where the type named <paramref name="typeName" /> is sought. </param>
         <param name="typeName">
@@ -104,7 +107,6 @@
         <Parameter Name="hashAlgorithm" Type="System.Configuration.Assemblies.AssemblyHashAlgorithm" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Runtime.Remoting.ObjectHandle.Unwrap" /> method to unwrap the return value.</para>
@@ -119,6 +121,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the COM object whose name is specified, using the named assembly file and the default constructor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A handle that must be unwrapped to access the newly created instance.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a file that contains an assembly where the type named <paramref name="typeName" /> is sought. </param>
         <param name="typeName">
@@ -144,7 +150,6 @@
         <Parameter Name="activationContext" Type="System.ActivationContext" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Runtime.Remoting.ObjectHandle.Unwrap" /> method to unwrap the return value.</para>
@@ -154,6 +159,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the type designated by the specified <see cref="T:System.ActivationContext" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A handle that must be unwrapped to access the newly created object.</para>
+        </returns>
         <param name="activationContext">
           <attribution license="cc4" from="Microsoft" modified="false" />An activation context object that specifies the object to create.</param>
       </Docs>
@@ -174,7 +183,6 @@
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>An instance of the relevant <see cref="T:System.Type" /></returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The constructor to be invoked must be accessible.</para>
@@ -187,6 +195,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the specified type using that type's default constructor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to the newly created object.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of object to create. </param>
       </Docs>
@@ -207,7 +219,6 @@
         <Parameter Name="activationCustomData" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Runtime.Remoting.ObjectHandle.Unwrap" /> method to unwrap the return value.</para>
@@ -217,6 +228,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the type that is designated by the specified <see cref="T:System.ActivationContext" /> object and activated with the specified custom activation data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A handle that must be unwrapped to access the newly created object.</para>
+        </returns>
         <param name="activationContext">
           <attribution license="cc4" from="Microsoft" modified="false" />An activation context object that specifies the object to create.</param>
         <param name="activationCustomData">
@@ -240,7 +255,6 @@
         <Parameter Name="typeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.ObjectHandle'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use <see cref="M:System.Runtime.Remoting.ObjectHandle.Unwrap" /> to unwrap the return value.</para>
@@ -264,6 +278,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the type whose name is specified, using the named assembly and default constructor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A handle that must be unwrapped to access the newly created instance.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the assembly where the type named <paramref name="typeName" /> is sought. For more information, see the Remarks section. If <paramref name="assemblyName" /> is null, the executing assembly is searched. </param>
         <param name="typeName">
@@ -287,7 +305,6 @@
         <Parameter Name="nonPublic" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -299,6 +316,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the specified type using that type's default constructor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to the newly created object.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of object to create. </param>
         <param name="nonPublic">
@@ -328,7 +349,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>The created instance of the <see cref="T:System.Type" />.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The constructor to be invoked must be accessible and must provide the most specific match with the specified argument list.</para>
@@ -341,6 +361,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the specified type using the constructor that best matches the specified parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to the newly created object.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of object to create. </param>
         <param name="args">
@@ -364,7 +388,6 @@
         <Parameter Name="typeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use <see cref="M:System.Activator.CreateInstance(System.AppDomain,System.String,System.String)" /> when a host needs to execute code in an application domain that has restricted security permissions.</para>
@@ -377,6 +400,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the type whose name is specified in the specified remote domain, using the named assembly and default constructor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A handle that must be unwrapped to access the newly created instance.</para>
+        </returns>
         <param name="domain">
           <attribution license="cc4" from="Microsoft" modified="false" />The remote domain where the type named <paramref name="typeName" /> is created.</param>
         <param name="assemblyName">
@@ -403,7 +430,6 @@
         <Parameter Name="activationAttributes" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.ObjectHandle'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use <see cref="M:System.Runtime.Remoting.ObjectHandle.Unwrap" /> to unwrap the return value.</para>
@@ -417,6 +443,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the type whose name is specified, using the named assembly and default constructor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A handle that must be unwrapped to access the newly created instance.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the assembly where the type named <paramref name="typeName" /> is sought. If <paramref name="assemblyName" /> is null, the executing assembly is searched. </param>
         <param name="typeName">
@@ -443,7 +473,6 @@
         <Parameter Name="activationAttributes" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The constructor to be invoked must be accessible and must provide the most specific match with the specified argument list.</para>
@@ -457,6 +486,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the specified type using the constructor that best matches the specified parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to the newly created object.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of object to create. </param>
         <param name="args">
@@ -485,7 +518,6 @@
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The constructor to be invoked must provide the most specific match with the specified argument list under the constraints of the specified binder and binding attributes.</para>
@@ -498,6 +530,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the specified type using the constructor that best matches the specified parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to the newly created object.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of object to create. </param>
         <param name="bindingAttr">
@@ -531,7 +567,6 @@
         <Parameter Name="activationAttributes" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The constructor to be invoked must provide the most specific match with the specified argument list under the constraints of the specified binder and binding attributes.</para>
@@ -545,6 +580,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the specified type using the constructor that best matches the specified parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to the newly created object.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of object to create. </param>
         <param name="bindingAttr">
@@ -580,7 +619,6 @@
         <Parameter Name="activationAttributes" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use <see cref="M:System.Runtime.Remoting.ObjectHandle.Unwrap" /> to unwrap the return value.</para>
@@ -594,6 +632,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the type whose name is specified, using the named assembly and the constructor that best matches the specified parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A handle that must be unwrapped to access the newly created instance.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the assembly where the type named <paramref name="typeName" /> is sought. If <paramref name="assemblyName" /> is null, the executing assembly is searched. </param>
         <param name="typeName">
@@ -634,7 +676,6 @@
         <Parameter Name="activationAttributes" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use <see cref="M:System.Activator.CreateInstance(System.AppDomain,System.String,System.String,System.Boolean,System.Reflection.BindingFlags,System.Reflection.Binder,System.Object[],System.Globalization.CultureInfo,System.Object[],System.Security.Policy.Evidence)" /> when a host needs to execute code in an application domain that has restricted security permissions.</para>
@@ -648,6 +689,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the type whose name is specified in the specified remote domain, using the named assembly and the constructor that best matches the specified parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A handle that must be unwrapped to access the newly created instance.</para>
+        </returns>
         <param name="domain">
           <attribution license="cc4" from="Microsoft" modified="false" />The domain where the type named <paramref name="typeName" /> is created.</param>
         <param name="assemblyName">
@@ -697,7 +742,6 @@
         <Parameter Name="securityInfo" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.ObjectHandle'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use <see cref="M:System.Runtime.Remoting.ObjectHandle.Unwrap" /> to unwrap the return value.</para>
@@ -711,6 +755,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the type whose name is specified, using the named assembly and the constructor that best matches the specified parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A handle that must be unwrapped to access the newly created instance.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the assembly where the type named <paramref name="typeName" /> is sought. If <paramref name="assemblyName" /> is null, the executing assembly is searched. </param>
         <param name="typeName">
@@ -760,7 +808,6 @@
         <Parameter Name="securityAttributes" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use <see cref="M:System.Activator.CreateInstance(System.AppDomain,System.String,System.String,System.Boolean,System.Reflection.BindingFlags,System.Reflection.Binder,System.Object[],System.Globalization.CultureInfo,System.Object[],System.Security.Policy.Evidence)" /> when a host needs to execute code in an application domain that has restricted security permissions.</para>
@@ -773,6 +820,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the type whose name is specified in the specified remote domain, using the named assembly and the constructor that best matches the specified parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A handle that must be unwrapped to access the newly created instance.</para>
+        </returns>
         <param name="domain">
           <attribution license="cc4" from="Microsoft" modified="false" />The domain where the type named <paramref name="typeName" /> is created.</param>
         <param name="assemblyName">
@@ -811,7 +862,6 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -824,6 +874,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the type designated by the specified generic type parameter, using the parameterless constructor .</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to the newly created object.</para>
+        </returns>
         <typeparam name="T">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to create.</typeparam>
       </Docs>
@@ -845,7 +899,6 @@
         <Parameter Name="typeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.ObjectHandle'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Runtime.Remoting.ObjectHandle.Unwrap" /> method to unwrap the return value.</para>
@@ -855,6 +908,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the type whose name is specified, using the named assembly file and default constructor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A handle that must be unwrapped to access the newly created instance.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a file that contains an assembly where the type named <paramref name="typeName" /> is sought. </param>
         <param name="typeName">
@@ -878,7 +935,6 @@
         <Parameter Name="typeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use <see cref="M:System.Activator.CreateInstanceFrom(System.AppDomain,System.String,System.String)" /> when a host needs to execute code in an application domain that has restricted security permissions.</para>
@@ -892,6 +948,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the type whose name is specified in the specified remote domain, using the named assembly file and default constructor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A handle that must be unwrapped to access the newly created instance.</para>
+        </returns>
         <param name="domain">
           <attribution license="cc4" from="Microsoft" modified="false" />The remote domain where the type named <paramref name="typeName" /> is created.</param>
         <param name="assemblyFile">
@@ -918,7 +978,6 @@
         <Parameter Name="activationAttributes" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.ObjectHandle'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Runtime.Remoting.ObjectHandle.Unwrap" /> method to unwrap the return value.</para>
@@ -929,6 +988,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the type whose name is specified, using the named assembly file and default constructor.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A handle that must be unwrapped to access the newly created instance.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a file that contains an assembly where the type named <paramref name="typeName" /> is sought. </param>
         <param name="typeName">
@@ -958,7 +1021,6 @@
         <Parameter Name="activationAttributes" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Runtime.Remoting.ObjectHandle.Unwrap" /> method to unwrap the return value.</para>
@@ -969,6 +1031,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the type whose name is specified, using the named assembly file and the constructor that best matches the specified parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A handle that must be unwrapped to access the newly created instance.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a file that contains an assembly where the type named <paramref name="typeName" /> is sought. </param>
         <param name="typeName">
@@ -1009,7 +1075,6 @@
         <Parameter Name="activationAttributes" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use <see cref="M:System.Activator.CreateInstanceFrom(System.AppDomain,System.String,System.String,System.Boolean,System.Reflection.BindingFlags,System.Reflection.Binder,System.Object[],System.Globalization.CultureInfo,System.Object[],System.Security.Policy.Evidence)" /> when a host needs to execute code in an application domain that has restricted security permissions.</para>
@@ -1021,6 +1086,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the type whose name is specified in the specified remote domain, using the named assembly file and the constructor that best matches the specified parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A handle that must be unwrapped to access the newly created instance.</para>
+        </returns>
         <param name="domain">
           <attribution license="cc4" from="Microsoft" modified="false" />The remote domain where the type named <paramref name="typeName" /> is created.</param>
         <param name="assemblyFile">
@@ -1070,7 +1139,6 @@
         <Parameter Name="securityInfo" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.ObjectHandle'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Runtime.Remoting.ObjectHandle.Unwrap" /> method to unwrap the return value.</para>
@@ -1081,6 +1149,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the type whose name is specified, using the named assembly file and the constructor that best matches the specified parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A handle that must be unwrapped to access the newly created instance.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a file that contains an assembly where the type named <paramref name="typeName" /> is sought. </param>
         <param name="typeName">
@@ -1130,7 +1202,6 @@
         <Parameter Name="securityAttributes" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use <see cref="M:System.Activator.CreateInstanceFrom(System.AppDomain,System.String,System.String,System.Boolean,System.Reflection.BindingFlags,System.Reflection.Binder,System.Object[],System.Globalization.CultureInfo,System.Object[],System.Security.Policy.Evidence)" /> when a host needs to execute code in an application domain that has restricted security permissions.</para>
@@ -1145,6 +1216,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an instance of the type whose name is specified in the specified remote domain, using the named assembly file and the constructor that best matches the specified parameters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A handle that must be unwrapped to access the newly created instance.</para>
+        </returns>
         <param name="domain">
           <attribution license="cc4" from="Microsoft" modified="false" />The remote domain where the type named <paramref name="typeName" /> is created.</param>
         <param name="assemblyFile">
@@ -1184,7 +1259,6 @@
         <Parameter Name="url" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call the proxy to send messages to the remote object. No messages are sent over the network until a method is called on the proxy.</para>
@@ -1193,6 +1267,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a proxy for the well-known object indicated by the specified type and URL.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A proxy that points to an endpoint served by the requested well-known object.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the well-known object to which you want to connect. </param>
         <param name="url">
@@ -1217,7 +1295,6 @@
         <Parameter Name="state" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Call the proxy to send messages to the remote object. No messages are sent over the network until a method is called on the proxy.</para>
@@ -1227,6 +1304,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a proxy for the well-known object indicated by the specified type, URL, and channel data.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A proxy that points to an endpoint served by the requested well-known object.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type of the well-known object to which you want to connect. </param>
         <param name="url">
diff --git a/mcs/class/corlib/Documentation/en/System/AggregateException.xml b/mcs/class/corlib/Documentation/en/System/AggregateException.xml
index edb6784bc09..bbf0f7cba11 100644
--- a/mcs/class/corlib/Documentation/en/System/AggregateException.xml
+++ b/mcs/class/corlib/Documentation/en/System/AggregateException.xml
@@ -329,7 +329,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If any inner exceptions are themselves instances of <see cref="T:System.AggregateException" />, this method will recursively flatten all of them. The inner exceptions returned in the new <see cref="T:System.AggregateException" /> will be the union of all of the the inner exceptions from exception tree rooted at the provided <see cref="T:System.AggregateException" /> instance.</para>
@@ -338,6 +337,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Flattens an <see cref="T:System.AggregateException" /> instances into a single, new instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new, flattened <see cref="T:System.AggregateException" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetBaseException">
@@ -352,12 +355,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.AggregateException" /> that is the root cause of this exception.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the <see cref="T:System.AggregateException" /> that is the root cause of this exception.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetObjectData">
@@ -446,12 +452,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a string representation of the current <see cref="T:System.AggregateException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the current exception.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System/AppDomain.xml b/mcs/class/corlib/Documentation/en/System/AppDomain.xml
index 023e89084c9..659afa30d01 100644
--- a/mcs/class/corlib/Documentation/en/System/AppDomain.xml
+++ b/mcs/class/corlib/Documentation/en/System/AppDomain.xml
@@ -178,7 +178,6 @@
         <Parameter Name="assemblyName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -188,6 +187,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the assembly display name after policy has been applied.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the assembly display name after policy has been applied.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly display name, in the form provided by the <see cref="P:System.Reflection.Assembly.FullName" /> property.</param>
       </Docs>
@@ -354,7 +357,6 @@
         <Parameter Name="typeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create objects remotely without having to load the type locally.</para>
@@ -365,6 +367,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of a specified COM type. Parameters specify the name of a file that contains an assembly containing the type and the name of the type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is a wrapper for the new instance specified by <paramref name="typeName" />. The return value needs to be unwrapped to access the real object.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a file containing an assembly that defines the requested type. </param>
         <param name="typeName">
@@ -390,7 +396,6 @@
         <Parameter Name="hashAlgorithm" Type="System.Configuration.Assemblies.AssemblyHashAlgorithm" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to create objects remotely without having to load the type locally.</para>
@@ -401,6 +406,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of a specified COM type. Parameters specify the name of a file that contains an assembly containing the type and the name of the type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is a wrapper for the new instance specified by <paramref name="typeName" />. The return value needs to be unwrapped to access the real object.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a file containing an assembly that defines the requested type. </param>
         <param name="typeName">
@@ -428,10 +437,6 @@
         <Parameter Name="friendlyName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.AppDomain" /> representing the newly created application domain.
-   </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="friendlyName" /> is <see langword="null" /> .</exception>
         <remarks>
@@ -443,6 +448,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new application domain with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created application domain.</para>
+        </returns>
         <param name="friendlyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The friendly name of the domain. </param>
       </Docs>
@@ -465,7 +474,6 @@
         <Parameter Name="securityInfo" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method overload uses the <see cref="T:System.AppDomainSetup" /> information from the default application domain.</para>
@@ -478,6 +486,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new application domain with the given name using the supplied evidence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created application domain.</para>
+        </returns>
         <param name="friendlyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The friendly name of the domain. This friendly name can be displayed in user interfaces to identify the domain. For more information, see <see cref="P:System.AppDomain.FriendlyName" />. </param>
         <param name="securityInfo">
@@ -502,7 +514,6 @@
         <Parameter Name="info" Type="System.AppDomainSetup" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="info" /> is not supplied, this method overload uses the <see cref="T:System.AppDomainSetup" /> information from the default application domain.</para>
@@ -515,6 +526,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new application domain using the specified name, evidence, and application domain setup information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created application domain.</para>
+        </returns>
         <param name="friendlyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The friendly name of the domain. This friendly name can be displayed in user interfaces to identify the domain. For more information, see <see cref="P:System.AppDomain.FriendlyName" />. </param>
         <param name="securityInfo">
@@ -548,7 +563,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You must set the <see cref="P:System.AppDomainSetup.ApplicationBase" /> property of the <see cref="T:System.AppDomainSetup" /> object that you supply for <paramref name="info" />. Otherwise, an exception is thrown. </para>
@@ -559,6 +573,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new application domain using the specified name, evidence, application domain setup information, default permission set, and array of fully trusted assemblies.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created application domain.</para>
+        </returns>
         <param name="friendlyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The friendly name of the domain. This friendly name can be displayed in user interfaces to identify the domain. For more information, see the description of <see cref="P:System.AppDomain.FriendlyName" />.</param>
         <param name="securityInfo">
@@ -591,7 +609,6 @@
         <Parameter Name="shadowCopyFiles" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="securityInfo" /> is not supplied, the evidence from the current application domain is used.</para>
@@ -604,6 +621,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new application domain with the given name, using evidence, application base path, relative search path, and a parameter that specifies whether a shadow copy of an assembly is to be loaded into the application domain.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created application domain.</para>
+        </returns>
         <param name="friendlyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The friendly name of the domain. This friendly name can be displayed in user interfaces to identify the domain. For more information, see <see cref="P:System.AppDomain.FriendlyName" />. </param>
         <param name="securityInfo">
@@ -637,7 +658,6 @@
         <Parameter Name="adInitArgs" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -652,6 +672,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new application domain with the given name, using evidence, application base path, relative search path, and a parameter that specifies whether a shadow copy of an assembly is to be loaded into the application domain. Specifies a callback method that is invoked when the application domain is initialized, and an array of string arguments to pass the callback method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The newly created application domain.</para>
+        </returns>
         <param name="friendlyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The friendly name of the domain. This friendly name can be displayed in user interfaces to identify the domain. For more information, see <see cref="P:System.AppDomain.FriendlyName" />. </param>
         <param name="securityInfo">
@@ -685,7 +709,6 @@
         <Parameter Name="typeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method calls the default constructor for <paramref name="typeName" />.</para>
@@ -696,6 +719,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the specified type defined in the specified assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is a wrapper for the new instance specified by <paramref name="typeName" />. The return value needs to be unwrapped to access the real object.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The display name of the assembly. See <see cref="P:System.Reflection.Assembly.FullName" />.</param>
         <param name="typeName">
@@ -720,7 +747,6 @@
         <Parameter Name="activationAttributes" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method calls the default constructor for <paramref name="typeName" />.</para>
@@ -732,6 +758,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the specified type defined in the specified assembly. A parameter specifies an array of activation attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is a wrapper for the new instance specified by <paramref name="typeName" />. The return value needs to be unwrapped to access the real object.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The display name of the assembly. See <see cref="P:System.Reflection.Assembly.FullName" />.</param>
         <param name="typeName">
@@ -761,7 +791,6 @@
         <Parameter Name="activationAttributes" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See <see cref="T:System.Reflection.AssemblyName" /> for the format of <paramref name="assemblyName" />.</para>
@@ -772,6 +801,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the specified type defined in the specified assembly. Parameters specify a binder, binding flags, constructor arguments, culture-specific information used to interpret arguments, and optional activation attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is a wrapper for the new instance specified by <paramref name="typeName" />. The return value needs to be unwrapped to access the real object.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The display name of the assembly. See <see cref="P:System.Reflection.Assembly.FullName" />.</param>
         <param name="typeName">
@@ -819,7 +852,6 @@
         <Parameter Name="securityAttributes" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See <see cref="T:System.Reflection.AssemblyName" /> for the format of <paramref name="assemblyName" />.</para>
@@ -830,6 +862,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the specified type defined in the specified assembly. Parameters specify a binder, binding flags, constructor arguments, culture-specific information used to interpret arguments, activation attributes, and authorization to create the type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is a wrapper for the new instance specified by <paramref name="typeName" />. The return value needs to be unwrapped to access the real object.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The display name of the assembly. See <see cref="P:System.Reflection.Assembly.FullName" />.</param>
         <param name="typeName">
@@ -867,7 +903,6 @@
         <Parameter Name="typeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is a convenience method that combines <see cref="M:System.AppDomain.CreateInstance(System.String,System.String)" /> and <see cref="M:System.Runtime.Remoting.ObjectHandle.Unwrap" />. This method calls the default constructor for <paramref name="typeName" />.</para>
@@ -880,6 +915,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the specified type. Parameters specify the assembly where the type is defined, and the name of the type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the object specified by <paramref name="typeName" />.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The display name of the assembly. See <see cref="P:System.Reflection.Assembly.FullName" />.</param>
         <param name="typeName">
@@ -904,7 +943,6 @@
         <Parameter Name="activationAttributes" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is a convenience method that combines <see cref="M:System.AppDomain.CreateInstance(System.String,System.String)" /> and <see cref="M:System.Runtime.Remoting.ObjectHandle.Unwrap" />. This method calls the default constructor for <paramref name="typeName" />.</para>
@@ -918,6 +956,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the specified type. Parameters specify the assembly where the type is defined, the name of the type, and an array of activation attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the object specified by <paramref name="typeName" />.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The display name of the assembly. See <see cref="P:System.Reflection.Assembly.FullName" />.</param>
         <param name="typeName">
@@ -947,7 +989,6 @@
         <Parameter Name="activationAttributes" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is a convenience method that combines <see cref="M:System.AppDomain.CreateInstance(System.String,System.String)" /> and <see cref="M:System.Runtime.Remoting.ObjectHandle.Unwrap" />. </para>
@@ -961,6 +1002,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the specified type defined in the specified assembly, specifying whether the case of the type name is ignored; the binding attributes and the binder that are used to select the type to be created; the arguments of the constructor; the culture; and the activation attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the object specified by <paramref name="typeName" />.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The display name of the assembly. See <see cref="P:System.Reflection.Assembly.FullName" />.</param>
         <param name="typeName">
@@ -1008,7 +1053,6 @@
         <Parameter Name="securityAttributes" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is a convenience method that combines <see cref="M:System.AppDomain.CreateInstance(System.String,System.String)" /> and <see cref="M:System.Runtime.Remoting.ObjectHandle.Unwrap" />. </para>
@@ -1022,6 +1066,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the specified type. Parameters specify the name of the type, and how it is found and created.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the object specified by <paramref name="typeName" />.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The display name of the assembly. See <see cref="P:System.Reflection.Assembly.FullName" />.</param>
         <param name="typeName">
@@ -1059,7 +1107,6 @@
         <Parameter Name="typeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default constructor for <paramref name="typeName" /> is invoked.</para>
@@ -1078,6 +1125,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the specified type defined in the specified assembly file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is a wrapper for the new instance, or null if <paramref name="typeName" /> is not found. The return value needs to be unwrapped to access the real object.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The name, including the path, of a file that contains an assembly that defines the requested type. The assembly is loaded using the <see cref="M:System.Reflection.Assembly.LoadFrom(System.String)" />  method.</param>
         <param name="typeName">
@@ -1102,7 +1153,6 @@
         <Parameter Name="activationAttributes" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default constructor for <paramref name="typeName" /> is invoked.</para>
@@ -1122,6 +1172,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the specified type defined in the specified assembly file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is a wrapper for the new instance, or null if <paramref name="typeName" /> is not found. The return value needs to be unwrapped to access the real object.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The name, including the path, of a file that contains an assembly that defines the requested type. The assembly is loaded using the <see cref="M:System.Reflection.Assembly.LoadFrom(System.String)" />  method. </param>
         <param name="typeName">
@@ -1151,7 +1205,6 @@
         <Parameter Name="activationAttributes" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information, see the <see cref="M:System.Activator.CreateInstanceFrom(System.String,System.String)" /> method.</para>
@@ -1170,6 +1223,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the specified type defined in the specified assembly file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is a wrapper for the new instance, or null if <paramref name="typeName" /> is not found. The return value needs to be unwrapped to access the real object.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The name, including the path, of a file that contains an assembly that defines the requested type. The assembly is loaded using the <see cref="M:System.Reflection.Assembly.LoadFrom(System.String)" />  method.</param>
         <param name="typeName">
@@ -1217,7 +1274,6 @@
         <Parameter Name="securityAttributes" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information about this method, see the <see cref="M:System.Activator.CreateInstanceFrom(System.String,System.String)" /> method.</para>
@@ -1236,6 +1292,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the specified type defined in the specified assembly file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is a wrapper for the new instance, or null if <paramref name="typeName" /> is not found. The return value needs to be unwrapped to access the real object.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The name, including the path, of a file that contains an assembly that defines the requested type. The assembly is loaded using the <see cref="M:System.Reflection.Assembly.LoadFrom(System.String)" />  method.</param>
         <param name="typeName">
@@ -1273,7 +1333,6 @@
         <Parameter Name="typeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is a convenience method that combines <see cref="M:System.AppDomain.CreateInstanceFrom(System.String,System.String)" /> and <see cref="M:System.Runtime.Remoting.ObjectHandle.Unwrap" />. This method calls the default constructor for <paramref name="typeName" />.</para>
@@ -1283,6 +1342,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the specified type defined in the specified assembly file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The requested object, or null if <paramref name="typeName" /> is not found.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The file name and path of the assembly that defines the requested type. </param>
         <param name="typeName">
@@ -1307,7 +1370,6 @@
         <Parameter Name="activationAttributes" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is a convenience method that combines <see cref="M:System.AppDomain.CreateInstanceFrom(System.String,System.String)" /> and <see cref="M:System.Runtime.Remoting.ObjectHandle.Unwrap" />. This method calls the default constructor for <paramref name="typeName" />.</para>
@@ -1318,6 +1380,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the specified type defined in the specified assembly file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The requested object, or null if <paramref name="typeName" /> is not found.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The file name and path of the assembly that defines the requested type. </param>
         <param name="typeName">
@@ -1347,7 +1413,6 @@
         <Parameter Name="activationAttributes" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is a convenience method that combines <see cref="M:System.AppDomain.CreateInstanceFrom(System.String,System.String)" /> and <see cref="M:System.Runtime.Remoting.ObjectHandle.Unwrap" />. </para>
@@ -1358,6 +1423,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the specified type defined in the specified assembly file, specifying whether the case of the type name is ignored; the binding attributes and the binder that are used to select the type to be created; the arguments of the constructor; the culture; and the activation attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The requested object, or null if <paramref name="typeName" /> is not found.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The file name and path of the assembly that defines the requested type. </param>
         <param name="typeName">
@@ -1405,7 +1474,6 @@
         <Parameter Name="securityAttributes" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is a convenience method that combines <see cref="M:System.AppDomain.CreateInstanceFrom(System.String,System.String)" /> and <see cref="M:System.Runtime.Remoting.ObjectHandle.Unwrap" />.</para>
@@ -1416,6 +1484,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of the specified type defined in the specified assembly file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The requested object, or null if <paramref name="typeName" /> is not found.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The file name and path of the assembly that defines the requested type. </param>
         <param name="typeName">
@@ -1474,7 +1546,6 @@
         <Parameter Name="access" Type="System.Reflection.Emit.AssemblyBuilderAccess" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method should only be used to define a dynamic assembly in the current application domain. For more information, see the <see cref="M:System.AppDomain.Load(System.Reflection.AssemblyName)" /> method overload. </para>
@@ -1486,6 +1557,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a dynamic assembly with the specified name and access mode.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A dynamic assembly with the specified name and access mode.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique identity of the dynamic assembly. </param>
         <param name="access">
@@ -1509,7 +1584,6 @@
         <Parameter Name="assemblyAttributes" Type="System.Collections.Generic.IEnumerable&lt;System.Reflection.Emit.CustomAttributeBuilder&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method overload to specify attributes that do not work correctly unless they are applied when a dynamic assembly is created. For example, security attributes such as <see cref="T:System.Security.SecurityTransparentAttribute" /> and <see cref="T:System.Security.SecurityCriticalAttribute" /> do not work correctly if they are added after a dynamic assembly has been created. </para>
@@ -1520,6 +1594,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a dynamic assembly with the specified name, access mode, and custom attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A dynamic assembly with the specified name and features.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique identity of the dynamic assembly. </param>
         <param name="access">
@@ -1551,7 +1629,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Only fully trusted callers can supply their <paramref name="evidence" /> when defining a dynamic <see cref="T:System.Reflection.Assembly" />. The runtime will map the <see cref="T:System.Security.Policy.Evidence" /> through the security policy to determine the granted permissions. Partially trusted callers must supply a null <paramref name="evidence" />. If <paramref name="evidence" /> is null, the runtime copies the permission sets, that is, the current grant and deny sets, from the caller's <see cref="T:System.Reflection.Assembly" /> to the dynamic <see cref="T:System.Reflection.Assembly" /> being defined and marks policy as resolved.</para>
@@ -1565,6 +1642,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a dynamic assembly using the specified name, access mode, and evidence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A dynamic assembly with the specified name and features.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique identity of the dynamic assembly. </param>
         <param name="access">
@@ -1591,7 +1672,6 @@
         <Parameter Name="dir" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method should only be used to define a dynamic assembly in the current application domain. For more information, see the <see cref="M:System.AppDomain.Load(System.Reflection.AssemblyName)" /> method overload.</para>
@@ -1603,6 +1683,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a dynamic assembly using the specified name, access mode, and storage directory.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A dynamic assembly with the specified name and features.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique identity of the dynamic assembly. </param>
         <param name="access">
@@ -1628,7 +1712,6 @@
         <Parameter Name="securityContextSource" Type="System.Security.SecurityContextSource" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method overload to specify attributes that do not work correctly unless they are applied when a dynamic assembly is created. For example, security attributes such as <see cref="T:System.Security.SecurityTransparentAttribute" /> and <see cref="T:System.Security.SecurityCriticalAttribute" /> do not work correctly if they are added after a dynamic assembly has been created. </para>
@@ -1638,6 +1721,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a dynamic assembly with the specified name, access mode, and custom attributes, and using the specified source for its security context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A dynamic assembly with the specified name and features.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique identity of the dynamic assembly. </param>
         <param name="access">
@@ -1672,7 +1759,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Only fully trusted callers can supply their <paramref name="evidence" /> when defining a dynamic <see cref="T:System.Reflection.Assembly" />. The runtime will map the <see cref="T:System.Security.Policy.Evidence" /> through the security policy to determine the granted permissions. Partially trusted callers must supply a null <paramref name="evidence" />. If <paramref name="evidence" /> is null, the runtime copies the permission sets, that is, the current grant and deny sets, from the caller's <see cref="T:System.Reflection.Assembly" /> to the dynamic <see cref="T:System.Reflection.Assembly" /> being defined and marks policy as resolved.</para>
@@ -1686,6 +1772,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a dynamic assembly using the specified name, access mode, storage directory, and evidence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A dynamic assembly with the specified name and features.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique identity of the dynamic assembly. </param>
         <param name="access">
@@ -1721,7 +1811,6 @@
         <Parameter Name="refusedPermissions" Type="System.Security.PermissionSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The permission requests specified for <paramref name="requiredPermissions" />, <paramref name="optionalPermissions" />, and <paramref name="refusedPermissions" /> are not used unless the dynamic assembly has been saved and reloaded into memory. To specify permission requests for a transient assembly that is never saved to disk, use an overload of the <see cref="Overload:System.AppDomain.DefineDynamicAssembly" /> method that specifies evidence as well as requested permissions, and supply an <see cref="T:System.Security.Policy.Evidence" /> object.</para>
@@ -1737,6 +1826,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a dynamic assembly using the specified name, access mode, and permission requests.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A dynamic assembly with the specified name and features.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique identity of the dynamic assembly. </param>
         <param name="access">
@@ -1767,7 +1860,6 @@
         <Parameter Name="assemblyAttributes" Type="System.Collections.Generic.IEnumerable&lt;System.Reflection.Emit.CustomAttributeBuilder&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method overload to specify attributes that do not work correctly unless they are applied when a dynamic assembly is created. For example, security attributes such as <see cref="T:System.Security.SecurityTransparentAttribute" /> and <see cref="T:System.Security.SecurityCriticalAttribute" /> do not work correctly if they are added after a dynamic assembly has been created. </para>
@@ -1777,6 +1869,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a dynamic assembly using the specified name, access mode, storage directory, and synchronization option.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A dynamic assembly with the specified name and features.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique identity of the dynamic assembly. </param>
         <param name="access">
@@ -1815,7 +1911,6 @@
         <Parameter Name="refusedPermissions" Type="System.Security.PermissionSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The permission requests specified for <paramref name="requiredPermissions" />, <paramref name="optionalPermissions" />, and <paramref name="refusedPermissions" /> are used only if <paramref name="evidence" /> is also supplied, or if the dynamic assembly is saved and reloaded into memory.</para>
@@ -1833,6 +1928,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a dynamic assembly using the specified name, access mode, evidence, and permission requests.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A dynamic assembly with the specified name and features.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique identity of the dynamic assembly. </param>
         <param name="access">
@@ -1873,7 +1972,6 @@
         <Parameter Name="refusedPermissions" Type="System.Security.PermissionSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The permission requests specified for <paramref name="requiredPermissions" />, <paramref name="optionalPermissions" />, and <paramref name="refusedPermissions" /> are not used unless the dynamic assembly has been saved and reloaded into memory. To specify permission requests for a transient assembly that is never saved to disk, use an overload of the <see cref="Overload:System.AppDomain.DefineDynamicAssembly" /> method that specifies evidence as well as requested permissions, and supply an <see cref="T:System.Security.Policy.Evidence" /> object.</para>
@@ -1889,6 +1987,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a dynamic assembly using the specified name, access mode, storage directory, and permission requests.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A dynamic assembly with the specified name and features.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique identity of the dynamic assembly. </param>
         <param name="access">
@@ -1930,7 +2032,6 @@
         <Parameter Name="refusedPermissions" Type="System.Security.PermissionSet" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The permission requests specified for <paramref name="requiredPermissions" />, <paramref name="optionalPermissions" />, and <paramref name="refusedPermissions" /> are used only if <paramref name="evidence" /> is also supplied, or if the dynamic assembly is saved and reloaded into memory.</para>
@@ -1948,6 +2049,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a dynamic assembly using the specified name, access mode, storage directory, evidence, and permission requests.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A dynamic assembly with the specified name and features.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique identity of the dynamic assembly. </param>
         <param name="access">
@@ -1992,7 +2097,6 @@
         <Parameter Name="isSynchronized" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The permission requests specified for <paramref name="requiredPermissions" />, <paramref name="optionalPermissions" />, and <paramref name="refusedPermissions" /> are used only if <paramref name="evidence" /> is also supplied, or if the dynamic assembly is saved and reloaded into memory.</para>
@@ -2010,6 +2114,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a dynamic assembly using the specified name, access mode, storage directory, evidence, permission requests, and synchronization option.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A dynamic assembly with the specified name and features.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique identity of the dynamic assembly. </param>
         <param name="access">
@@ -2056,7 +2164,6 @@
         <Parameter Name="assemblyAttributes" Type="System.Collections.Generic.IEnumerable&lt;System.Reflection.Emit.CustomAttributeBuilder&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method overload to specify attributes that do not work correctly unless they are applied when a dynamic assembly is created. For example, security attributes such as <see cref="T:System.Security.SecurityTransparentAttribute" /> and <see cref="T:System.Security.SecurityCriticalAttribute" /> do not work correctly if they are added after a dynamic assembly has been created. </para>
@@ -2076,6 +2183,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Defines a dynamic assembly with the specified name, access mode, storage directory, evidence, permission requests, synchronization option, and custom attributes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A dynamic assembly with the specified name and features.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique identity of the dynamic assembly. </param>
         <param name="access">
@@ -2243,7 +2354,6 @@
         <Parameter Name="assemblyFile" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The assembly begins executing at the entry point specified in the .NET Framework header.</para>
@@ -2255,6 +2365,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the assembly contained in the specified file.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value returned by the entry point of the assembly.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the file that contains the assembly to execute. </param>
       </Docs>
@@ -2281,7 +2395,6 @@
         <Parameter Name="assemblySecurity" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The assembly begins executing at the entry point specified in the .NET Framework header.</para>
@@ -2292,6 +2405,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the assembly contained in the specified file, using the specified evidence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value returned by the entry point of the assembly.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the file that contains the assembly to execute. </param>
         <param name="assemblySecurity">
@@ -2313,7 +2430,6 @@
         <Parameter Name="args" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The assembly begins executing at the entry point specified in the .NET Framework header.</para>
@@ -2324,6 +2440,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the assembly contained in the specified file, using the specified arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value that is returned by the entry point of the assembly.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the file that contains the assembly to execute.</param>
         <param name="args">
@@ -2353,7 +2473,6 @@
         <Parameter Name="args" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The assembly begins executing at the entry point specified in the .NET Framework header.</para>
@@ -2364,6 +2483,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the assembly contained in the specified file, using the specified evidence and arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value returned by the entry point of the assembly.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the file that contains the assembly to execute. </param>
         <param name="assemblySecurity">
@@ -2389,7 +2512,6 @@
         <Parameter Name="hashAlgorithm" Type="System.Configuration.Assemblies.AssemblyHashAlgorithm" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The assembly begins executing at the entry point specified in the .NET Framework header.</para>
@@ -2400,6 +2522,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the assembly contained in the specified file, using the specified arguments, hash value, and hash algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value that is returned by the entry point of the assembly.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the file that contains the assembly to execute.</param>
         <param name="args">
@@ -2435,7 +2561,6 @@
         <Parameter Name="hashAlgorithm" Type="System.Configuration.Assemblies.AssemblyHashAlgorithm" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The assembly begins executing at the entry point specified in the .NET Framework header.</para>
@@ -2446,6 +2571,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the assembly contained in the specified file, using the specified evidence, arguments, hash value, and hash algorithm.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value returned by the entry point of the assembly.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the file that contains the assembly to execute. </param>
         <param name="assemblySecurity">
@@ -2473,7 +2602,6 @@
         <Parameter Name="assemblyName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2486,6 +2614,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes an assembly given its display name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value returned by the entry point of the assembly.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The display name of the assembly. See <see cref="P:System.Reflection.Assembly.FullName" />.</param>
       </Docs>
@@ -2511,7 +2643,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.AppDomain.ExecuteAssemblyByName" /> method provides similar functionality to the <see cref="Overload:System.AppDomain.ExecuteAssembly" /> method, but specifies the assembly by display name or <see cref="T:System.Reflection.AssemblyName" /> rather than by file location. Therefore, <see cref="Overload:System.AppDomain.ExecuteAssemblyByName" /> loads assemblies with the <see cref="Overload:System.Reflection.Assembly.Load" /> method rather than with the <see cref="Overload:System.Reflection.Assembly.LoadFile" /> method. </para>
@@ -2522,6 +2653,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the assembly given an <see cref="T:System.Reflection.AssemblyName" />, using the specified arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value that is returned by the entry point of the assembly.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Reflection.AssemblyName" /> object representing the name of the assembly.</param>
         <param name="args">
@@ -2549,7 +2684,6 @@
         <Parameter Name="assemblySecurity" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2564,6 +2698,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes an assembly given its display name, using the specified evidence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value returned by the entry point of the assembly.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The display name of the assembly. See <see cref="P:System.Reflection.Assembly.FullName" />.</param>
         <param name="assemblySecurity">
@@ -2591,7 +2729,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="Overload:System.AppDomain.ExecuteAssemblyByName" /> method provides similar functionality to the <see cref="Overload:System.AppDomain.ExecuteAssembly" /> method, but specifies the assembly by display name or <see cref="T:System.Reflection.AssemblyName" /> rather than by file location. Therefore, <see cref="Overload:System.AppDomain.ExecuteAssemblyByName" /> loads assemblies with the <see cref="Overload:System.Reflection.Assembly.Load" /> method rather than with the <see cref="Overload:System.Reflection.Assembly.LoadFile" /> method. </para>
@@ -2602,6 +2739,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the assembly given its display name, using the specified arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value that is returned by the entry point of the assembly.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The display name of the assembly. See <see cref="P:System.Reflection.Assembly.FullName" />.</param>
         <param name="args">
@@ -2636,7 +2777,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2651,6 +2791,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the assembly given an <see cref="T:System.Reflection.AssemblyName" />, using the specified evidence and arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value returned by the entry point of the assembly.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Reflection.AssemblyName" /> object representing the name of the assembly. </param>
         <param name="assemblySecurity">
@@ -2687,7 +2831,6 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2702,6 +2845,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Executes the assembly given its display name, using the specified evidence and arguments.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value returned by the entry point of the assembly.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The display name of the assembly. See <see cref="P:System.Reflection.Assembly.FullName" />.</param>
         <param name="assemblySecurity">
@@ -2753,12 +2900,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the assemblies that have been loaded into the execution context of this application domain.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of assemblies in this application domain.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetCurrentThreadId">
@@ -2780,7 +2930,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="P:System.Threading.Thread.ManagedThreadId" /> property, which is stable even when the .NET Framework is hosted by an environment that supports fibers (that is, lightweight threads).</para>
@@ -2789,6 +2938,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the current thread identifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer that is the identifier of the current thread.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetData">
@@ -2807,7 +2960,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to retrieve the value of an entry in an internal cache of name-data pairs that describe properties of this instance of <see cref="T:System.AppDomain" />.</para>
@@ -2950,6 +3102,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value stored in the current application domain for the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the <paramref name="name" /> property, or null if the property does not exist.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a predefined application domain property, or the name of an application domain property you have defined.</param>
       </Docs>
@@ -2968,12 +3124,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the type of the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Id">
@@ -3016,12 +3175,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gives the <see cref="T:System.AppDomain" /> an infinite lifetime by preventing a lease from being created.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsCompatibilitySwitchSet">
@@ -3038,7 +3200,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method tests whether the current application domain reverses breaking changes that were introduced in the net_v40_long. The following table provides examples of compatibility switches that can be set to restore the behavior of earlier versions of the .NET Framework.</para>
@@ -3092,6 +3253,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a nullable Boolean value that indicates whether any compatibility switches are set, and if so, whether the specified compatibility switch is set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A null reference (Nothing in Visual Basic) if no compatibility switches are set; otherwise, a Boolean value that indicates whether the compatibility switch that is specified by <paramref name="value" /> is set.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The compatibility switch to test.</param>
       </Docs>
@@ -3109,7 +3274,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3119,6 +3283,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the application domain is the default application domain for the process.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current <see cref="T:System.AppDomain" /> object represents the default application domain for the process; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsFinalizingForUnload">
@@ -3135,7 +3303,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The finalization method for an object provides you an opportunity to perform any necessary cleanup operations before the object is garbage collected. After finalization, the object is accessible but in an invalid state and therefore unusable. Eventually, garbage collection completes and reclaims the object.</para>
@@ -3153,6 +3320,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether this application domain is unloading, and the objects it contains are being finalized by the common language runtime.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this application domain is unloading and the common language runtime has started invoking finalizers; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsFullyTrusted">
@@ -3217,7 +3388,6 @@
         <Parameter Name="rawAssembly" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Beginning with the net_v40_long, the trust level of an assembly that is loaded by using this method is the same as the trust level of the application domain. </para>
@@ -3228,6 +3398,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads the <see cref="T:System.Reflection.Assembly" /> with a common object file format (COFF) based image containing an emitted <see cref="T:System.Reflection.Assembly" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="rawAssembly">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type byte that is a COFF-based image containing an emitted assembly. </param>
       </Docs>
@@ -3248,7 +3422,6 @@
         <Parameter Name="assemblyRef" Type="System.Reflection.AssemblyName" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method should be used only to load an assembly into the current application domain. This method is provided as a convenience for interoperability callers who cannot call the static <see cref="M:System.Reflection.Assembly.Load(System.String)" /> method. To load assemblies into other application domains, use a method such as <see cref="M:System.AppDomain.CreateInstanceAndUnwrap(System.String,System.String)" />.</para>
@@ -3265,6 +3438,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads an <see cref="T:System.Reflection.Assembly" /> given its <see cref="T:System.Reflection.AssemblyName" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="assemblyRef">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that describes the assembly to load. </param>
       </Docs>
@@ -3285,7 +3462,6 @@
         <Parameter Name="assemblyString" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method should be used only to load an assembly into the current application domain. This method is provided as a convenience for interoperability callers who cannot call the static <see cref="M:System.Reflection.Assembly.Load(System.String)" /> method. To load assemblies into other application domains, use a method such as <see cref="M:System.AppDomain.CreateInstanceAndUnwrap(System.String,System.String)" />.</para>
@@ -3295,6 +3471,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads an <see cref="T:System.Reflection.Assembly" /> given its display name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="assemblyString">
           <attribution license="cc4" from="Microsoft" modified="false" />The display name of the assembly. See <see cref="P:System.Reflection.Assembly.FullName" />.</param>
       </Docs>
@@ -3316,7 +3496,6 @@
         <Parameter Name="rawSymbolStore" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Beginning with the net_v40_long, the trust level of an assembly that is loaded by using this method is the same as the trust level of the application domain. </para>
@@ -3327,6 +3506,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads the <see cref="T:System.Reflection.Assembly" /> with a common object file format (COFF) based image containing an emitted <see cref="T:System.Reflection.Assembly" />. The raw bytes representing the symbols for the <see cref="T:System.Reflection.Assembly" /> are also loaded.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="rawAssembly">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type byte that is a COFF-based image containing an emitted assembly. </param>
         <param name="rawSymbolStore">
@@ -3355,7 +3538,6 @@
         <Parameter Name="assemblySecurity" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method should be used only to load an assembly into the current application domain. This method is provided as a convenience for interoperability callers who cannot call the static <see cref="M:System.Reflection.Assembly.Load(System.String)" /> method. To load assemblies into other application domains, use a method such as <see cref="M:System.AppDomain.CreateInstanceAndUnwrap(System.String,System.String)" />.</para>
@@ -3365,6 +3547,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads an <see cref="T:System.Reflection.Assembly" /> given its <see cref="T:System.Reflection.AssemblyName" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="assemblyRef">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that describes the assembly to load. </param>
         <param name="assemblySecurity">
@@ -3393,7 +3579,6 @@
         <Parameter Name="assemblySecurity" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method should be used only to load an assembly into the current application domain. This method is provided as a convenience for interoperability callers who cannot call the static <see cref="M:System.Reflection.Assembly.Load(System.String)" /> method. To load assemblies into other application domains, use a method such as <see cref="M:System.AppDomain.CreateInstanceAndUnwrap(System.String,System.String)" />.</para>
@@ -3403,6 +3588,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads an <see cref="T:System.Reflection.Assembly" /> given its display name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="assemblyString">
           <attribution license="cc4" from="Microsoft" modified="false" />The display name of the assembly. See <see cref="P:System.Reflection.Assembly.FullName" />.</param>
         <param name="assemblySecurity">
@@ -3432,7 +3621,6 @@
         <Parameter Name="securityEvidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Beginning with the net_v40_long, the trust level of an assembly that is loaded by using this method is the same as the trust level of the application domain. </para>
@@ -3443,6 +3631,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Loads the <see cref="T:System.Reflection.Assembly" /> with a common object file format (COFF) based image containing an emitted <see cref="T:System.Reflection.Assembly" />. The raw bytes representing the symbols for the <see cref="T:System.Reflection.Assembly" /> are also loaded.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="rawAssembly">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type byte that is a COFF-based image containing an emitted assembly. </param>
         <param name="rawSymbolStore">
@@ -3656,7 +3848,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3666,6 +3857,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the assemblies that have been loaded into the reflection-only context of the application domain.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.Assembly" /> objects that represent the assemblies loaded into the reflection-only context of the application domain.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="RelativeSearchPath">
@@ -4187,11 +4382,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing
- information about the current <see cref="T:System.AppDomain" />
- instance.</para>
-        </returns>
         <remarks>
           <para> The string returned by this method includes the friendly name of the
  application domain.
@@ -4206,6 +4396,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains a string representation that includes the friendly name of the application domain and any context policies.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string formed by concatenating the literal string "Name:", the friendly name of the application domain, and either string representations of the context policies or the string "There are no context policies." </para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System/AppDomainManager.xml b/mcs/class/corlib/Documentation/en/System/AppDomainManager.xml
index d9a03f72835..5854d679a62 100644
--- a/mcs/class/corlib/Documentation/en/System/AppDomainManager.xml
+++ b/mcs/class/corlib/Documentation/en/System/AppDomainManager.xml
@@ -106,7 +106,6 @@
         <Parameter Name="state" Type="System.Security.SecurityState" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default implementation of this method returns false.</para>
@@ -116,6 +115,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified operation is allowed in the application domain.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the host allows the operation specified by <paramref name="state" /> to be performed in the application domain; otherwise, false.</para>
+        </returns>
         <param name="state">
           <attribution license="cc4" from="Microsoft" modified="false" />A subclass of <see cref="T:System.Security.SecurityState" /> that identifies the operation whose security status is requested.</param>
       </Docs>
@@ -137,7 +140,6 @@
         <Parameter Name="appDomainInfo" Type="System.AppDomainSetup" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -148,6 +150,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new or existing application domain.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new or existing application domain.</para>
+        </returns>
         <param name="friendlyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The friendly name of the domain. </param>
         <param name="securityInfo">
@@ -173,7 +179,6 @@
         <Parameter Name="appDomainInfo" Type="System.AppDomainSetup" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -184,6 +189,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides a helper method to create an application domain.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A newly created application domain.</para>
+        </returns>
         <param name="friendlyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The friendly name of the domain. </param>
         <param name="securityInfo">
diff --git a/mcs/class/corlib/Documentation/en/System/AppDomainSetup.xml b/mcs/class/corlib/Documentation/en/System/AppDomainSetup.xml
index 5d40da9a584..ffc6c8af1e3 100644
--- a/mcs/class/corlib/Documentation/en/System/AppDomainSetup.xml
+++ b/mcs/class/corlib/Documentation/en/System/AppDomainSetup.xml
@@ -457,7 +457,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.AppDomainSetup.SetConfigurationBytes(System.Byte[])" /> method provides a way to override the configuration information of an application that creates a new application domain. The configuration file information in <paramref name="value" /> overrides the configuration file information for the application. For example, when the Example.exe application creates a new application domain, it can override the configuration information originally obtained from Example.exe.config file.</para>
@@ -471,6 +470,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the XML configuration information set by the <see cref="M:System.AppDomainSetup.SetConfigurationBytes(System.Byte[])" /> method, which overrides the application's XML configuration information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains the XML configuration information that was set by the <see cref="M:System.AppDomainSetup.SetConfigurationBytes(System.Byte[])" /> method, or null if the <see cref="M:System.AppDomainSetup.SetConfigurationBytes(System.Byte[])" /> method has not been called.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="LicenseFile">
diff --git a/mcs/class/corlib/Documentation/en/System/ApplicationId.xml b/mcs/class/corlib/Documentation/en/System/ApplicationId.xml
index 04acdb49bef..c051e68d98a 100644
--- a/mcs/class/corlib/Documentation/en/System/ApplicationId.xml
+++ b/mcs/class/corlib/Documentation/en/System/ApplicationId.xml
@@ -80,7 +80,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -90,6 +89,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns an identical copy of the current application identity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.ApplicationId" /> object that represents an exact copy of the original.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Culture">
@@ -132,7 +135,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -142,6 +144,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.ApplicationId" /> object is equivalent to the current <see cref="T:System.ApplicationId" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.ApplicationId" /> object is equivalent to the current <see cref="T:System.ApplicationId" />; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ApplicationId" /> object to compare to the current <see cref="T:System.ApplicationId" />. </param>
       </Docs>
@@ -159,7 +165,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -169,6 +174,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the hash code for the current application identity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the current application identity.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Name">
@@ -258,7 +267,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -268,6 +276,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a string representation of the application identity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the application identity.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Version">
diff --git a/mcs/class/corlib/Documentation/en/System/ApplicationIdentity.xml b/mcs/class/corlib/Documentation/en/System/ApplicationIdentity.xml
index e7ba2c713dc..8c9dbe7338a 100644
--- a/mcs/class/corlib/Documentation/en/System/ApplicationIdentity.xml
+++ b/mcs/class/corlib/Documentation/en/System/ApplicationIdentity.xml
@@ -164,7 +164,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -174,6 +173,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the full name of the manifest-activated application.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The full name of the manifest-activated application.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System/ArgIterator.xml b/mcs/class/corlib/Documentation/en/System/ArgIterator.xml
index fb7bcac3121..9c5313dec33 100644
--- a/mcs/class/corlib/Documentation/en/System/ArgIterator.xml
+++ b/mcs/class/corlib/Documentation/en/System/ArgIterator.xml
@@ -127,12 +127,15 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is not supported, and always throws <see cref="T:System.NotSupportedException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This comparison is not supported. No value is returned.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to be compared to this instance. </param>
       </Docs>
@@ -151,12 +154,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code of this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetNextArg">
@@ -178,7 +184,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>Returns the next argument as a <see cref="T:System.TypedReference" />.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The iterator is automatically advanced to the next argument.</para>
@@ -187,6 +192,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the next argument in a variable-length argument list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The next argument as a <see cref="T:System.TypedReference" /> object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetNextArg">
@@ -210,7 +219,6 @@
         <Parameter Name="rth" Type="System.RuntimeTypeHandle" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TypedReference'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The iterator is automatically advanced to the next argument.</para>
@@ -219,6 +227,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the next argument in a variable-length argument list that has a specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The next argument as a <see cref="T:System.TypedReference" /> object.</para>
+        </returns>
         <param name="rth">
           <attribution license="cc4" from="Microsoft" modified="false" />A runtime type handle that identifies the type of the argument to retrieve. </param>
       </Docs>
@@ -237,7 +249,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'RuntimeTypeHandle'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method does not advance the iterator to the next argument.</para>
@@ -248,6 +259,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the type of the next argument.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type of the next argument.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetRemainingCount">
@@ -264,12 +279,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>The count of arguments remaining to be processed.</returns>
         <remarks />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of arguments remaining in the argument list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of remaining arguments.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System/Array.xml b/mcs/class/corlib/Documentation/en/System/Array.xml
index e58b4c61bca..d6b7dc2899e 100644
--- a/mcs/class/corlib/Documentation/en/System/Array.xml
+++ b/mcs/class/corlib/Documentation/en/System/Array.xml
@@ -120,42 +120,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> with one of the following values based on the result of the search
-   operation.</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description> Description</description>
-            </listheader>
-            <item>
-              <term> The index of <paramref name="value" /> in the
-      array.</term>
-              <description>
-                <paramref name="value" /> was found.</description>
-            </item>
-            <item>
-              <term> The bitwise complement of the index of the first element that is larger than
-   <paramref name="value" />.</term>
-              <description>
-                <paramref name="value" /> was not found and the value of at least one element of
-<paramref name="array" /> was greater than <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> The bitwise complement of (<paramref name="array" />.GetLowerBound(0) +
-<paramref name="array" />.Length).</term>
-              <description>
-                <paramref name="value" /> was not found, and <paramref name="value" /> was greater than the
-value of all array elements.</description>
-            </item>
-          </list>
-          <para>
-            <block subset="none" type="note"> If <paramref name="value" />
-is not found, the caller can take the bitwise complement of the return value to
-determine the index where value would be found in <paramref name="array" /> if it is sorted
-already.</block>
-          </para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>Both <paramref name="value" /> and at least one element of <paramref name="array" /> do not implement the <see cref="T:System.IComparable" /> interface. </para>
           <para>-or-</para>
@@ -193,6 +157,10 @@ already.</block>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches an entire one-dimensional sorted array for a specific element, using the <see cref="T:System.IComparable" /> interface implemented by each element of the array and by the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified <paramref name="value" /> in the specified <paramref name="array" />, if <paramref name="value" /> is found. If <paramref name="value" /> is not found and <paramref name="value" /> is less than one or more elements in <paramref name="array" />, a negative number which is the bitwise complement of the index of the first element that is larger than <paramref name="value" />. If <paramref name="value" /> is not found and <paramref name="value" /> is greater than any of the elements in <paramref name="array" />, a negative number which is the bitwise complement of (the index of the last element plus 1).</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The sorted one-dimensional <see cref="T:System.Array" /> to search.</param>
         <param name="value">
@@ -224,42 +192,6 @@ already.</block>
         <Parameter Name="comparer" Type="System.Collections.IComparer" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> with one of the following values based on the result of the search
-   operation.</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> The index of <paramref name="value" /> in the
-      array.</term>
-              <description>
-                <paramref name="value" /> was found.</description>
-            </item>
-            <item>
-              <term> The bitwise complement of the index of the first element that is larger than
-   <paramref name="value" />.</term>
-              <description>
-                <paramref name="value" /> was not found, and at least one array element was
-   greater than <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> The bitwise complement of (<paramref name="array" />.GetLowerBound(0) +
-<paramref name="array" />.Length).</term>
-              <description>
-                <paramref name="value" /> was not found, and <paramref name="value" /> was greater than all
-array elements.</description>
-            </item>
-          </list>
-          <para>
-            <block subset="none" type="note"> If <paramref name="value" />
-is not found, the caller can take the bitwise complement of the return value to
-determine the index where value would be found in <paramref name="array" /> if it is
-already sorted.</block>
-          </para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>
             <paramref name="comparer" /> is <see langword="null" />, and both <paramref name="value" /> and at least one element of <paramref name="array" /> do not implement the <see cref="T:System.IComparable" /> interface.</para>
@@ -299,6 +231,10 @@ already sorted.</block>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches an entire one-dimensional sorted array for a value using the specified <see cref="T:System.Collections.IComparer" /> interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified <paramref name="value" /> in the specified <paramref name="array" />, if <paramref name="value" /> is found. If <paramref name="value" /> is not found and <paramref name="value" /> is less than one or more elements in <paramref name="array" />, a negative number which is the bitwise complement of the index of the first element that is larger than <paramref name="value" />. If <paramref name="value" /> is not found and <paramref name="value" /> is greater than any of the elements in <paramref name="array" />, a negative number which is the bitwise complement of (the index of the last element plus 1).</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The sorted one-dimensional <see cref="T:System.Array" /> to search.</param>
         <param name="value">
@@ -333,44 +269,6 @@ already sorted.</block>
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> with one of the following values based on the result of the search
-   operation.</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> The index of <paramref name="value" /> in the
-      array.</term>
-              <description>
-                <paramref name="value" /> was found.</description>
-            </item>
-            <item>
-              <term> The bitwise complement of the index of the first element that is larger than
-   <paramref name="value" />.</term>
-              <description>
-                <paramref name="value" /> was not found, and at least one array element in the
-   range of <paramref name="index" /> to <paramref name="index" /> + <paramref name="length" /> - 1 was greater
-   than <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> The bitwise complement of (<paramref name="index" /> + <paramref name="length" />).</term>
-              <description>
-                <paramref name="value" /> was not found, and <paramref name="value" /> was greater than all
-array elements in the range of <paramref name="index" /> to <paramref name="index" /> +
-<paramref name="length" />- 1.</description>
-            </item>
-          </list>
-          <para>
-            <block subset="none" type="note"> If <paramref name="value" />
-is not found, the caller can take the bitwise complement of the return value to
-determine the index of the array where <paramref name="value" /> would be found in the
-range of <paramref name="index" /> to <paramref name="index" /> + <paramref name=" length" /> - 1 if <paramref name="array" />
-is already sorted.</block>
-          </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="array" /> is <see langword="null" /> .</exception>
         <exception cref="T:System.RankException">
@@ -411,6 +309,10 @@ is already sorted.</block>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches a range of elements in a one-dimensional sorted array for a value, using the <see cref="T:System.IComparable" /> interface implemented by each element of the array and by the specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified <paramref name="value" /> in the specified <paramref name="array" />, if <paramref name="value" /> is found. If <paramref name="value" /> is not found and <paramref name="value" /> is less than one or more elements in <paramref name="array" />, a negative number which is the bitwise complement of the index of the first element that is larger than <paramref name="value" />. If <paramref name="value" /> is not found and <paramref name="value" /> is greater than any of the elements in <paramref name="array" />, a negative number which is the bitwise complement of (the index of the last element plus 1).</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The sorted one-dimensional <see cref="T:System.Array" /> to search.</param>
         <param name="index">
@@ -448,44 +350,6 @@ is already sorted.</block>
         <Parameter Name="comparer" Type="System.Collections.IComparer" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> with one of the following values based on the result of the search
-   operation.</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> The index of <paramref name="value" /> in the
-      array.</term>
-              <description>
-                <paramref name="value" /> was found.</description>
-            </item>
-            <item>
-              <term> The bitwise complement of the index of the first element that is larger than
-   <paramref name="value" />.</term>
-              <description>
-                <paramref name="value" /> was not found, and at least one array element in the
-   range of <paramref name="index" /> to <paramref name="index" /> + <paramref name="length" /> - 1 was greater
-   than <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> The bitwise complement of (<paramref name="index" /> + <paramref name="length" />).</term>
-              <description>
-                <paramref name="value" /> was not found, and <paramref name="value" /> was greater than all
-array elements in the range of <paramref name="index" /> to <paramref name="index" /> +
-<paramref name="length" />- 1.</description>
-            </item>
-          </list>
-          <para>
-            <block subset="none" type="note"> If <paramref name="value" /> is
-not found, the caller can take the bitwise complement of the return value to
-determine the index of <paramref name="array" /> where <paramref name="value" /> would be found in the
-range of <paramref name="index" /> to <paramref name="index" /> + <paramref name="length" /> - 1 if <paramref name="array" /> is
-already sorted.</block>
-          </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="array" /> is <see langword="null" />.</exception>
         <exception cref="T:System.RankException">
@@ -574,6 +438,10 @@ class BinarySearchExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches a range of elements in a one-dimensional sorted array for a value, using the specified <see cref="T:System.Collections.IComparer" /> interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified <paramref name="value" /> in the specified <paramref name="array" />, if <paramref name="value" /> is found. If <paramref name="value" /> is not found and <paramref name="value" /> is less than one or more elements in <paramref name="array" />, a negative number which is the bitwise complement of the index of the first element that is larger than <paramref name="value" />. If <paramref name="value" /> is not found and <paramref name="value" /> is greater than any of the elements in <paramref name="array" />, a negative number which is the bitwise complement of (the index of the last element plus 1).</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The sorted one-dimensional <see cref="T:System.Array" /> to search.</param>
         <param name="index">
@@ -682,30 +550,6 @@ class BinarySearchExample {
         <Parameter Name="comparer" Type="System.Collections.Generic.IComparer&lt;T&gt;" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>One of the following values based on the result of the search operation:</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term>A non-negative index of <paramref name="value" /> in the array.</term>
-              <description>
-                <paramref name="value" /> was found.</description>
-            </item>
-            <item>
-              <term>A negative value, which is the bitwise complement of the index of the first element that is larger than   <paramref name="value" />.</term>
-              <description>
-                <paramref name="value" /> was not found and the value of at least one element of array was greater than <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term>A negative value, which is the bitwise complement of one more than the index of the final element.</term>
-              <description>
-                <paramref name="value" /> was not found, and  <paramref name="value" /> was greater than the value of all array elements.</description>
-            </item>
-          </list>
-        </returns>
         <since version=".NET 2.0" />
         <exception cref="T:System.ArgumentNullException">
           <paramref name="array" /> is <see langword="null" /> .</exception>
@@ -734,6 +578,10 @@ class BinarySearchExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches an entire one-dimensional sorted array for a value using the specified <see cref="T:System.Collections.Generic.IComparer`1" /> generic interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified <paramref name="value" /> in the specified <paramref name="array" />, if <paramref name="value" /> is found. If <paramref name="value" /> is not found and <paramref name="value" /> is less than one or more elements in <paramref name="array" />, a negative number which is the bitwise complement of the index of the first element that is larger than <paramref name="value" />. If <paramref name="value" /> is not found and <paramref name="value" /> is greater than any of the elements in <paramref name="array" />, a negative number which is the bitwise complement of (the index of the last element plus 1).</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The sorted one-dimensional, zero-based <see cref="T:System.Array" /> to search.  </param>
         <param name="value">
@@ -856,30 +704,6 @@ class BinarySearchExample {
         <Parameter Name="comparer" Type="System.Collections.Generic.IComparer&lt;T&gt;" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>One of the following values based on the result of the search operation:</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term>A non-negative index of <paramref name="value" /> in the array.</term>
-              <description>
-                <paramref name="value" /> was found.</description>
-            </item>
-            <item>
-              <term>A negative value, which is the bitwise complement of the index of the first element that is larger than   <paramref name="value" />.</term>
-              <description>
-                <paramref name="value" /> was not found and the value of at least one element of array was greater than <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term>A negative value, which is the bitwise complement of one more than the index of the final element.</term>
-              <description>
-                <paramref name="value" /> was not found, and  <paramref name="value" /> was greater than the value of all array elements.</description>
-            </item>
-          </list>
-        </returns>
         <since version=".NET 2.0" />
         <exception cref="T:System.ArgumentException">
           <para>
@@ -916,6 +740,10 @@ class BinarySearchExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches a range of elements in a one-dimensional sorted array for a value, using the specified <see cref="T:System.Collections.Generic.IComparer`1" /> generic interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the specified <paramref name="value" /> in the specified <paramref name="array" />, if <paramref name="value" /> is found. If <paramref name="value" /> is not found and <paramref name="value" /> is less than one or more elements in <paramref name="array" />, a negative number which is the bitwise complement of the index of the first element that is larger than <paramref name="value" />. If <paramref name="value" /> is not found and <paramref name="value" /> is greater than any of the elements in <paramref name="array" />, a negative number which is the bitwise complement of (the index of the last element plus 1).</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The sorted one-dimensional, zero-based <see cref="T:System.Array" /> to search. </param>
         <param name="index">
@@ -1049,10 +877,6 @@ class BinarySearchExample {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Object" /> that is a copy of
-   the current instance.</para>
-        </returns>
         <example>
           <para>This example demonstrates the <see cref="M:System.Array.Clone" /> method.</para>
           <code lang="C#">using System;
@@ -1102,6 +926,10 @@ public class ArrayCloneExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a shallow copy of the <see cref="T:System.Array" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A shallow copy of the <see cref="T:System.Array" />.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1177,9 +1005,6 @@ public class ArrayCloneExample {
         <Parameter Name="converter" Type="System.Converter&lt;TInput,TOutput&gt;" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new array of the target type containing the converted elements from <paramref name="array" />.</para>
-        </returns>
         <since version=".NET 2.0" />
         <exception cref="T:System.ArgumentNullException">
           <paramref name="array" /> is <see langword="null" /> or <paramref name="converter" /> is <see langword="null" />.</exception>
@@ -1193,6 +1018,10 @@ public class ArrayCloneExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an array of one type to an array of another type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of the target type containing the converted elements from the source array.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The one-dimensional, zero-based <see cref="T:System.Array" /> to convert to a target type.</param>
         <param name="converter">
@@ -1800,10 +1629,6 @@ public class ArrayCopyToExample
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A zero-based, one-dimensional <see cref="T:System.Array" /> object containing <paramref name="length" /> elements of type
-<paramref name="elementType" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="elementType" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -1847,6 +1672,10 @@ public class ArrayCreateInstanceExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a one-dimensional <see cref="T:System.Array" /> of the specified <see cref="T:System.Type" /> and length, with zero-based indexing.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new one-dimensional <see cref="T:System.Array" /> of the specified <see cref="T:System.Type" /> with the specified length, using zero-based indexing.</para>
+        </returns>
         <param name="elementType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the <see cref="T:System.Array" /> to create.</param>
         <param name="length">
@@ -1878,12 +1707,6 @@ public class ArrayCreateInstanceExample
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new zero-based, multidimensional <see cref="T:System.Array" /> instance of the
-   specified <see cref="T:System.Type" /> with the specified length for
-   each dimension. The <see cref="P:System.Array.Rank" /> of the new instance is equal to
-<paramref name="lengths" />.Length.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <para>
             <paramref name="elementType" /> or <paramref name="lengths" /> is <see langword="null" />.</para>
@@ -1959,6 +1782,10 @@ public class CreateMultiDimArrayExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a multidimensional <see cref="T:System.Array" /> of the specified <see cref="T:System.Type" /> and dimension lengths, with zero-based indexing. The dimension lengths are specified in an array of 32-bit integers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new multidimensional <see cref="T:System.Array" /> of the specified <see cref="T:System.Type" /> with the specified length for each dimension, using zero-based indexing.</para>
+        </returns>
         <param name="elementType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the <see cref="T:System.Array" /> to create.</param>
         <param name="lengths">
@@ -1990,7 +1817,6 @@ public class CreateMultiDimArrayExample
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Unlike most classes, <see cref="T:System.Array" /> provides the <see cref="Overload:System.Array.CreateInstance" /> method, instead of public constructors, to allow for late bound access.</para>
@@ -2002,6 +1828,10 @@ public class CreateMultiDimArrayExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a multidimensional <see cref="T:System.Array" /> of the specified <see cref="T:System.Type" /> and dimension lengths, with zero-based indexing. The dimension lengths are specified in an array of 64-bit integers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new multidimensional <see cref="T:System.Array" /> of the specified <see cref="T:System.Type" /> with the specified length for each dimension, using zero-based indexing.</para>
+        </returns>
         <param name="elementType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the <see cref="T:System.Array" /> to create.</param>
         <param name="lengths">
@@ -2027,11 +1857,6 @@ public class CreateMultiDimArrayExample
         <Parameter Name="length2" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new zero-indexed, two-dimensional <see cref="T:System.Array" /> instance of <paramref name="elementType" /> objects with the size
-<paramref name="length1" /> for the first dimension and <paramref name="length2" /> 
-for the second.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="elementType" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -2093,6 +1918,10 @@ public class Create2DArrayExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a two-dimensional <see cref="T:System.Array" /> of the specified <see cref="T:System.Type" /> and dimension lengths, with zero-based indexing.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new two-dimensional <see cref="T:System.Array" /> of the specified <see cref="T:System.Type" /> with the specified length for each dimension, using zero-based indexing.</para>
+        </returns>
         <param name="elementType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the <see cref="T:System.Array" /> to create.</param>
         <param name="length1">
@@ -2122,10 +1951,6 @@ public class Create2DArrayExample
         <Parameter Name="lowerBounds" Type="System.Int32[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new multidimensional <see cref="T:System.Array" /> whose element type is the specified <see cref="T:System.Type" /> and with
-   the specified length and lower bound for each dimension.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <para>
             <paramref name="elementType" />, <paramref name="lengths" />, or <paramref name="lowerBounds" /> is <see langword="null" />. </para>
@@ -2210,6 +2035,10 @@ public class MultiDimNonZeroBoundExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a multidimensional <see cref="T:System.Array" /> of the specified <see cref="T:System.Type" /> and dimension lengths, with the specified lower bounds.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new multidimensional <see cref="T:System.Array" /> of the specified <see cref="T:System.Type" /> with the specified length and lower bound for each dimension.</para>
+        </returns>
         <param name="elementType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the <see cref="T:System.Array" /> to create.</param>
         <param name="lengths">
@@ -2240,11 +2069,6 @@ public class MultiDimNonZeroBoundExample
         <Parameter Name="length3" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new zero-based, three-dimensional <see cref="T:System.Array" /> instance of <paramref name="elementType" /> objects with the size
-<paramref name="length1" /> for the first dimension, <paramref name="length2" /> for the second, and 
-<paramref name="length3" /> for the third.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="elementType" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -2320,6 +2144,10 @@ public class Create3DArrayExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a three-dimensional <see cref="T:System.Array" /> of the specified <see cref="T:System.Type" /> and dimension lengths, with zero-based indexing.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new three-dimensional <see cref="T:System.Array" /> of the specified <see cref="T:System.Type" /> with the specified length for each dimension, using zero-based indexing.</para>
+        </returns>
         <param name="elementType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the <see cref="T:System.Array" /> to create.</param>
         <param name="length1">
@@ -2351,10 +2179,6 @@ public class Create3DArrayExample
         <Parameter Name="match" Type="System.Predicate&lt;T&gt;" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" />, if the array contains one or more elements that match the conditions defined by the specified predicate; otherwise, <see langword="false" />.</para>
-        </returns>
         <since version=".NET 2.0" />
         <exception cref="T:System.ArgumentNullException">
           <paramref name="array" />  or <paramref name="match" /> is <see langword="null" />.</exception>
@@ -2367,6 +2191,10 @@ public class Create3DArrayExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified array contains elements that match the conditions defined by the specified predicate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="array" /> contains one or more elements that match the conditions defined by the specified predicate; otherwise, false.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The one-dimensional, zero-based <see cref="T:System.Array" /> to search.</param>
         <param name="match">
@@ -2394,9 +2222,6 @@ public class Create3DArrayExample
         <Parameter Name="match" Type="System.Predicate&lt;T&gt;" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The first element that matches the conditions defined by the specified predicate, if found; otherwise, the default value for type <paramref name="T" />.</para>
-        </returns>
         <since version=".NET 2.0" />
         <exception cref="T:System.ArgumentNullException">
           <paramref name="array" />  or <paramref name="match" /> is <see langword="null" />.</exception>
@@ -2409,6 +2234,10 @@ public class Create3DArrayExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for an element that matches the conditions defined by the specified predicate, and returns the first occurrence within the entire <see cref="T:System.Array" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first element that matches the conditions defined by the specified predicate, if found; otherwise, the default value for type <paramref name="T" />.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The one-dimensional, zero-based array to search.</param>
         <param name="match">
@@ -2436,9 +2265,6 @@ public class Create3DArrayExample
         <Parameter Name="match" Type="System.Predicate&lt;T&gt;" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>An array containing all the elements that match the conditions defined by the specified predicate, if found; otherwise, an empty array.</para>
-        </returns>
         <since version=".NET 2.0" />
         <exception cref="T:System.ArgumentNullException">
           <paramref name="array" />  or <paramref name="match" /> is <see langword="null" />.</exception>
@@ -2451,6 +2277,10 @@ public class Create3DArrayExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves all the elements that match the conditions defined by the specified predicate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Array" /> containing all the elements that match the conditions defined by the specified predicate, if found; otherwise, an empty <see cref="T:System.Array" />.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The one-dimensional, zero-based <see cref="T:System.Array" /> to search.</param>
         <param name="match">
@@ -2478,9 +2308,6 @@ public class Create3DArrayExample
         <Parameter Name="match" Type="System.Predicate&lt;T&gt;" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The zero-based index of the first occurrence of an element that matches the conditions defined by <paramref name="match" />, if found; otherwise, -1.</para>
-        </returns>
         <since version=".NET 2.0" />
         <exception cref="T:System.ArgumentNullException">
           <paramref name="array" />  or <paramref name="match" /> is <see langword="null" />.</exception>
@@ -2494,6 +2321,10 @@ public class Create3DArrayExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for an element that matches the conditions defined by the specified predicate, and returns the zero-based index of the first occurrence within the entire <see cref="T:System.Array" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of an element that matches the conditions defined by <paramref name="match" />, if found; otherwise, –1.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The one-dimensional, zero-based <see cref="T:System.Array" /> to search.</param>
         <param name="match">
@@ -2522,9 +2353,6 @@ public class Create3DArrayExample
         <Parameter Name="match" Type="System.Predicate&lt;T&gt;" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The zero-based index of the first occurrence of an element that matches the conditions defined by <paramref name="match" />, if found; otherwise, -1.</para>
-        </returns>
         <since version=".NET 2.0" />
         <exception cref="T:System.ArgumentNullException">
           <paramref name="array" />  or <paramref name="match" /> is <see langword="null" />.</exception>
@@ -2540,6 +2368,10 @@ public class Create3DArrayExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for an element that matches the conditions defined by the specified predicate, and returns the zero-based index of the first occurrence within the range of elements in the <see cref="T:System.Array" /> that extends from the specified index to the last element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of an element that matches the conditions defined by <paramref name="match" />, if found; otherwise, –1.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The one-dimensional, zero-based <see cref="T:System.Array" /> to search.</param>
         <param name="startIndex">
@@ -2571,9 +2403,6 @@ public class Create3DArrayExample
         <Parameter Name="match" Type="System.Predicate&lt;T&gt;" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The zero-based index of the first occurrence of an element that matches the conditions defined by <paramref name="match" />, if found; otherwise, -1.</para>
-        </returns>
         <since version=".NET 2.0" />
         <exception cref="T:System.ArgumentNullException">
           <paramref name="array" />  or <paramref name="match" /> is <see langword="null" />.</exception>
@@ -2597,6 +2426,10 @@ public class Create3DArrayExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for an element that matches the conditions defined by the specified predicate, and returns the zero-based index of the first occurrence within the range of elements in the <see cref="T:System.Array" /> that starts at the specified index and contains the specified number of elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the first occurrence of an element that matches the conditions defined by <paramref name="match" />, if found; otherwise, –1.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The one-dimensional, zero-based <see cref="T:System.Array" /> to search.</param>
         <param name="startIndex">
@@ -2628,9 +2461,6 @@ public class Create3DArrayExample
         <Parameter Name="match" Type="System.Predicate&lt;T&gt;" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The last element that matches the conditions defined by the specified predicate, if found; otherwise, the default value for type <paramref name="T" />.</para>
-        </returns>
         <since version=".NET 2.0" />
         <exception cref="T:System.ArgumentNullException">
           <paramref name="array" />  or <paramref name="match" /> is <see langword="null" />.</exception>
@@ -2643,6 +2473,10 @@ public class Create3DArrayExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for an element that matches the conditions defined by the specified predicate, and returns the last occurrence within the entire <see cref="T:System.Array" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The last element that matches the conditions defined by the specified predicate, if found; otherwise, the default value for type <paramref name="T" />.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The one-dimensional, zero-based <see cref="T:System.Array" /> to search.</param>
         <param name="match">
@@ -2670,9 +2504,6 @@ public class Create3DArrayExample
         <Parameter Name="match" Type="System.Predicate&lt;T&gt;" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The zero-based index of the first occurrence of an element that matches the conditions defined by <paramref name="match" />, if found; otherwise, -1.</para>
-        </returns>
         <since version=".NET 2.0" />
         <exception cref="T:System.ArgumentNullException">
           <paramref name="array" />  or <paramref name="match" /> is <see langword="null" />.</exception>
@@ -2686,6 +2517,10 @@ public class Create3DArrayExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for an element that matches the conditions defined by the specified predicate, and returns the zero-based index of the last occurrence within the entire <see cref="T:System.Array" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the last occurrence of an element that matches the conditions defined by <paramref name="match" />, if found; otherwise, –1.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The one-dimensional, zero-based <see cref="T:System.Array" /> to search.</param>
         <param name="match">
@@ -2714,9 +2549,6 @@ public class Create3DArrayExample
         <Parameter Name="match" Type="System.Predicate&lt;T&gt;" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The zero-based index of the first occurrence of an element that matches the conditions defined by <paramref name="match" />, if found; otherwise, -1.</para>
-        </returns>
         <since version=".NET 2.0" />
         <exception cref="T:System.ArgumentNullException">
           <paramref name="array" />  or <paramref name="match" /> is <see langword="null" />.</exception>
@@ -2732,6 +2564,10 @@ public class Create3DArrayExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for an element that matches the conditions defined by the specified predicate, and returns the zero-based index of the last occurrence within the range of elements in the <see cref="T:System.Array" /> that extends from the first element to the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the last occurrence of an element that matches the conditions defined by <paramref name="match" />, if found; otherwise, –1.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The one-dimensional, zero-based <see cref="T:System.Array" /> to search.</param>
         <param name="startIndex">
@@ -2763,9 +2599,6 @@ public class Create3DArrayExample
         <Parameter Name="match" Type="System.Predicate&lt;T&gt;" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The zero-based index of the first occurrence of an element that matches the conditions defined by <paramref name="match" />, if found; otherwise, -1.</para>
-        </returns>
         <since version=".NET 2.0" />
         <exception cref="T:System.ArgumentNullException">
           <paramref name="array" />  or <paramref name="match" /> is <see langword="null" />.</exception>
@@ -2789,6 +2622,10 @@ public class Create3DArrayExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for an element that matches the conditions defined by the specified predicate, and returns the zero-based index of the last occurrence within the range of elements in the <see cref="T:System.Array" /> that contains the specified number of elements and ends at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index of the last occurrence of an element that matches the conditions defined by <paramref name="match" />, if found; otherwise, –1.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The one-dimensional, zero-based <see cref="T:System.Array" /> to search.</param>
         <param name="startIndex">
@@ -2855,9 +2692,6 @@ public class Create3DArrayExample
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Collections.IEnumerator" /> for the current instance.</para>
-        </returns>
         <example>
           <para>This example demonstrates the <see cref="M:System.Array.GetEnumerator" /> method.</para>
           <code lang="C#">using System;
@@ -2894,6 +2728,10 @@ public class ArrayGetEnumerator {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.Array" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Collections.IEnumerator" /> for the <see cref="T:System.Array" />.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -2913,9 +2751,6 @@ public class ArrayGetEnumerator {
         <Parameter Name="dimension" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The number of elements in the specified dimension of the array.</para>
-        </returns>
         <exception cref="T:System.IndexOutOfRangeException">
           <para>
             <paramref name="dimension" /> is less than zero.</para>
@@ -2932,6 +2767,10 @@ public class ArrayGetEnumerator {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a 32-bit integer that represents the number of elements in the specified dimension of the <see cref="T:System.Array" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit integer that represents the number of elements in the specified dimension.</para>
+        </returns>
         <param name="dimension">
           <attribution license="cc4" from="Microsoft" modified="false" />A zero-based dimension of the <see cref="T:System.Array" /> whose length needs to be determined.</param>
       </Docs>
@@ -2957,7 +2796,6 @@ public class ArrayGetEnumerator {
         <Parameter Name="dimension" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An example of <see cref="M:System.Array.GetLongLength(System.Int32)" /> is GetLongLength(0), which returns the number of elements in the first dimension of the <see cref="T:System.Array" />.</para>
@@ -2967,6 +2805,10 @@ public class ArrayGetEnumerator {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a 64-bit integer that represents the number of elements in the specified dimension of the <see cref="T:System.Array" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit integer that represents the number of elements in the specified dimension.</para>
+        </returns>
         <param name="dimension">
           <attribution license="cc4" from="Microsoft" modified="false" />A zero-based dimension of the <see cref="T:System.Array" /> whose length needs to be determined.</param>
       </Docs>
@@ -2993,10 +2835,6 @@ public class ArrayGetEnumerator {
         <Parameter Name="dimension" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> that contains the lower bound of the specified dimension in the
-   current instance.</para>
-        </returns>
         <exception cref="T:System.IndexOutOfRangeException">
           <para>
             <paramref name="dimension" /> &lt; 0.</para>
@@ -3015,6 +2853,10 @@ public class ArrayGetEnumerator {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the first element of the specified dimension in the array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the first element of the specified dimension in the array.</para>
+        </returns>
         <param name="dimension">
           <attribution license="cc4" from="Microsoft" modified="false" />A zero-based dimension of the array whose starting index needs to be determined.</param>
       </Docs>
@@ -3043,10 +2885,6 @@ public class ArrayGetEnumerator {
         <Parameter Name="dimension" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> that contains the upper bound of the specified dimension in the
-   current instance.</para>
-        </returns>
         <exception cref="T:System.IndexOutOfRangeException">
           <para>
             <paramref name="dimension" /> &lt; 0.</para>
@@ -3063,6 +2901,10 @@ public class ArrayGetEnumerator {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the index of the last element of the specified dimension in the array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the last element of the specified dimension in the array, or -1 if the specified dimension is empty. </para>
+        </returns>
         <param name="dimension">
           <attribution license="cc4" from="Microsoft" modified="false" />A zero-based dimension of the array whose upper bound needs to be determined.</param>
       </Docs>
@@ -3086,10 +2928,6 @@ public class ArrayGetEnumerator {
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Object" /> that contains the value at the specified position in the current
-   instance.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">The current instance has more than one dimension.</exception>
         <exception cref="T:System.IndexOutOfRangeException">
           <para>
@@ -3122,6 +2960,10 @@ public class ArrayGetValueExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value at the specified position in the one-dimensional <see cref="T:System.Array" />. The index is specified as a 32-bit integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value at the specified position in the one-dimensional <see cref="T:System.Array" />.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />A 32-bit integer that represents the position of the <see cref="T:System.Array" /> element to get.</param>
       </Docs>
@@ -3150,10 +2992,6 @@ public class ArrayGetValueExample {
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Object" /> that contains the value at the specified position in the
-   current instance.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="indices" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">The number of dimensions in the current instance is not equal to the number of elements in <paramref name="indices" />.</exception>
@@ -3170,6 +3008,10 @@ public class ArrayGetValueExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value at the specified position in the multidimensional <see cref="T:System.Array" />. The indexes are specified as an array of 32-bit integers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value at the specified position in the multidimensional <see cref="T:System.Array" />.</para>
+        </returns>
         <param name="indices">
           <attribution license="cc4" from="Microsoft" modified="false" />A one-dimensional array of 32-bit integers that represent the indexes specifying the position of the <see cref="T:System.Array" /> element to get.</param>
       </Docs>
@@ -3197,7 +3039,6 @@ public class ArrayGetValueExample {
         <Parameter Name="index" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Array.GetLowerBound(System.Int32)" /> and <see cref="M:System.Array.GetUpperBound(System.Int32)" /> methods can determine whether the value of <paramref name="index" /> is out of bounds.</para>
@@ -3207,6 +3048,10 @@ public class ArrayGetValueExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value at the specified position in the one-dimensional <see cref="T:System.Array" />. The index is specified as a 64-bit integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value at the specified position in the one-dimensional <see cref="T:System.Array" />.</para>
+        </returns>
         <param name="index">
           <attribution license="cc4" from="Microsoft" modified="false" />A 64-bit integer that represents the position of the <see cref="T:System.Array" /> element to get.</param>
       </Docs>
@@ -3238,7 +3083,6 @@ public class ArrayGetValueExample {
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The number of elements in <paramref name="indices" /> must equal the number of dimensions in the <see cref="T:System.Array" />. All elements in the <paramref name="indices" /> array must collectively specify the position of the desired element in the multidimensional <see cref="T:System.Array" />.</para>
@@ -3249,6 +3093,10 @@ public class ArrayGetValueExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value at the specified position in the multidimensional <see cref="T:System.Array" />. The indexes are specified as an array of 64-bit integers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value at the specified position in the multidimensional <see cref="T:System.Array" />.</para>
+        </returns>
         <param name="indices">
           <attribution license="cc4" from="Microsoft" modified="false" />A one-dimensional array of 64-bit integers that represent the indexes specifying the position of the <see cref="T:System.Array" /> element to get.</param>
       </Docs>
@@ -3271,10 +3119,6 @@ public class ArrayGetValueExample {
         <Parameter Name="index2" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Object" /> that contains the value at the specified position in the current 
-   instance.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">The current instance does not have exactly two dimensions.</exception>
         <exception cref="T:System.IndexOutOfRangeException">At least one of <paramref name="index1" /> or <paramref name="index2" /> is outside the range of valid indexes for the corresponding dimension of the current instance.</exception>
         <remarks>
@@ -3286,6 +3130,10 @@ public class ArrayGetValueExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value at the specified position in the two-dimensional <see cref="T:System.Array" />. The indexes are specified as 32-bit integers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value at the specified position in the two-dimensional <see cref="T:System.Array" />.</para>
+        </returns>
         <param name="index1">
           <attribution license="cc4" from="Microsoft" modified="false" />A 32-bit integer that represents the first-dimension index of the <see cref="T:System.Array" /> element to get.</param>
         <param name="index2">
@@ -3316,7 +3164,6 @@ public class ArrayGetValueExample {
         <Parameter Name="index2" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Array.GetLowerBound(System.Int32)" /> and <see cref="M:System.Array.GetUpperBound(System.Int32)" /> methods can determine whether any of the indexes is out of bounds.</para>
@@ -3326,6 +3173,10 @@ public class ArrayGetValueExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value at the specified position in the two-dimensional <see cref="T:System.Array" />. The indexes are specified as 64-bit integers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value at the specified position in the two-dimensional <see cref="T:System.Array" />.</para>
+        </returns>
         <param name="index1">
           <attribution license="cc4" from="Microsoft" modified="false" />A 64-bit integer that represents the first-dimension index of the <see cref="T:System.Array" /> element to get.</param>
         <param name="index2">
@@ -3351,10 +3202,6 @@ public class ArrayGetValueExample {
         <Parameter Name="index3" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Object" /> that contains the value at the specified position in the 
-   current instance.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">The current instance does not have exactly three dimensions.</exception>
         <exception cref="T:System.IndexOutOfRangeException">
           <para>At least one of<paramref name="index1" /> or <paramref name="index2" /> or <paramref name="index3" /> is outside the range of valid indexes for the corresponding dimension of the current instance.</para>
@@ -3368,6 +3215,10 @@ public class ArrayGetValueExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value at the specified position in the three-dimensional <see cref="T:System.Array" />. The indexes are specified as 32-bit integers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value at the specified position in the three-dimensional <see cref="T:System.Array" />.</para>
+        </returns>
         <param name="index1">
           <attribution license="cc4" from="Microsoft" modified="false" />A 32-bit integer that represents the first-dimension index of the <see cref="T:System.Array" /> element to get.</param>
         <param name="index2">
@@ -3401,7 +3252,6 @@ public class ArrayGetValueExample {
         <Parameter Name="index3" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Array.GetLowerBound(System.Int32)" /> and <see cref="M:System.Array.GetUpperBound(System.Int32)" /> methods can determine whether any of the indexes is out of bounds.</para>
@@ -3411,6 +3261,10 @@ public class ArrayGetValueExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the value at the specified position in the three-dimensional <see cref="T:System.Array" />. The indexes are specified as 64-bit integers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value at the specified position in the three-dimensional <see cref="T:System.Array" />.</para>
+        </returns>
         <param name="index1">
           <attribution license="cc4" from="Microsoft" modified="false" />A 64-bit integer that represents the first-dimension index of the <see cref="T:System.Array" /> element to get.</param>
         <param name="index2">
@@ -3442,11 +3296,6 @@ public class ArrayGetValueExample {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the index of the first occurrence of <paramref name="value" /> in
-<paramref name="array" />, if found; otherwise, <paramref name="array" />.GetLowerBound(0) - 1. <block subset="none" type="note"> For a vector, if <paramref name="value" /> is not 
-   found, the return value will be -1. This provides the caller with a standard code for a failed search.</block></para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="array" /> is <see langword="null" />.</exception>
         <exception cref="T:System.RankException">
@@ -3485,6 +3334,10 @@ public class ArrayIndexOfExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified object and returns the index of the first occurrence within the entire one-dimensional <see cref="T:System.Array" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the first occurrence of <paramref name="value" /> within the entire <paramref name="array" />, if found; otherwise, the lower bound of the array minus 1.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The one-dimensional <see cref="T:System.Array" /> to search.</param>
         <param name="value">
@@ -3516,14 +3369,6 @@ public class ArrayIndexOfExample {
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the index of the first occurrence of <paramref name="value" /> in
-<paramref name="array" />, within the range <paramref name="startIndex" /> through the last element of 
-<paramref name="array" />, if found; otherwise, 
-<paramref name="array" />.GetLowerBound(0) - 1. 
-<block subset="none" type="note"> For a vector, if <paramref name="value" /> is not 
-   found, the return value will be -1. This provides the caller with a standard code for the failed search.</block></para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <para>
             <paramref name="array" /> is <see langword="null" />. </para>
@@ -3547,6 +3392,10 @@ public class ArrayIndexOfExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified object and returns the index of the first occurrence within the range of elements in the one-dimensional <see cref="T:System.Array" /> that extends from the specified index to the last element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the first occurrence of <paramref name="value" /> within the range of elements in <paramref name="array" /> that extends from <paramref name="startIndex" /> to the last element, if found; otherwise, the lower bound of the array minus 1.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The one-dimensional <see cref="T:System.Array" /> to search.</param>
         <param name="value">
@@ -3581,14 +3430,6 @@ public class ArrayIndexOfExample {
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the index of the first occurrence of <paramref name="value" /> in
-<paramref name="array" />, within the range <paramref name="startIndex" /> through <paramref name="startIndex" /> 
-+ <paramref name="count" />- 1, if found; otherwise,
-<paramref name="array" />.GetLowerBound(0) - 1.
-<block subset="none" type="note"> For a vector, if <paramref name="value" /> is not 
-found, the return value will be -1. This provides the caller with a standard code for the failed search.</block></para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <para>
             <paramref name="array" /> is <see langword="null" />.</para>
@@ -3618,6 +3459,10 @@ found, the return value will be -1. This provides the caller with a standard cod
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified object and returns the index of the first occurrence within the range of elements in the one-dimensional <see cref="T:System.Array" /> that starts at the specified index and contains the specified number of elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the first occurrence of <paramref name="value" /> within the range of elements in <paramref name="array" /> that starts at <paramref name="startIndex" /> and contains the number of elements specified in <paramref name="count" />, if found; otherwise, the lower bound of the array minus 1.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The one-dimensional <see cref="T:System.Array" /> to search.</param>
         <param name="value">
@@ -3918,13 +3763,6 @@ found, the return value will be -1. This provides the caller with a standard cod
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the index of the last occurrence in <paramref name="array" /> of
-<paramref name="value" />, if found; otherwise, 
-<paramref name="array" />.GetLowerBound(0) - 1. 
-<block subset="none" type="note"> For a vector, if <paramref name="value" /> is not 
-   found, the return value will be -1. This provides the caller with a standard code for the failed search.</block></para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="array" /> is <see langword="null" /> . </exception>
         <exception cref="T:System.RankException">
@@ -3966,6 +3804,10 @@ public class ArrayLastIndexOfExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified object and returns the index of the last occurrence within the entire one-dimensional <see cref="T:System.Array" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the last occurrence of <paramref name="value" /> within the entire <paramref name="array" />, if found; otherwise, the lower bound of the array minus 1.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The one-dimensional <see cref="T:System.Array" /> to search.</param>
         <param name="value">
@@ -3997,13 +3839,6 @@ public class ArrayLastIndexOfExample {
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the index of the last occurrence of <paramref name="value" /> in the range
-<paramref name="startIndex" /> through the lower bound of <paramref name="array" />, if found; otherwise, 
-<paramref name="array" />.GetLowerBound(0) - 1. <block subset="none" type="note"> For a vector, if <paramref name="value" /> is not found, the return value will
-   be -1. This provides the caller with a standard code for the failed
-   search.</block></para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <para>
             <paramref name="array" /> is <see langword="null" />.</para>
@@ -4026,6 +3861,10 @@ public class ArrayLastIndexOfExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified object and returns the index of the last occurrence within the range of elements in the one-dimensional <see cref="T:System.Array" /> that extends from the first element to the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the last occurrence of <paramref name="value" /> within the range of elements in <paramref name="array" /> that extends from the first element to <paramref name="startIndex" />, if found; otherwise, the lower bound of the array minus 1.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The one-dimensional <see cref="T:System.Array" /> to search.</param>
         <param name="value">
@@ -4060,14 +3899,6 @@ public class ArrayLastIndexOfExample {
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the index of the last occurrence of <paramref name="value" /> in 
-<paramref name="array" />, within the range <paramref name="startIndex" /> through 
-<paramref name="startIndex" /> - <paramref name="count" /> + 1, if found; otherwise, 
-<paramref name="array" />.GetLowerBound(0) - 1. 
-<block subset="none" type="note"> For a vector, if <paramref name="value" /> is not 
-   found, the return value will be -1. This provides the caller with a standard code for the failed search.</block></para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <para>
             <paramref name="array" /> is <see langword="null" />.</para>
@@ -4096,6 +3927,10 @@ public class ArrayLastIndexOfExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified object and returns the index of the last occurrence within the range of elements in the one-dimensional <see cref="T:System.Array" /> that contains the specified number of elements and ends at the specified index.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of the last occurrence of <paramref name="value" /> within the range of elements in <paramref name="array" /> that contains the number of elements specified in <paramref name="count" /> and ends at <paramref name="startIndex" />, if found; otherwise, the lower bound of the array minus 1.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The one-dimensional <see cref="T:System.Array" /> to search.</param>
         <param name="value">
@@ -6252,7 +6087,6 @@ public class ArraySortExample {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Array" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -6261,6 +6095,10 @@ public class ArraySortExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an item to <see cref="T:System.Collections.IList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The position into which the new element was inserted, or -1 to indicate that the item was not inserted into the collection.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be added to the <see cref="T:System.Collections.IList" />.</param>
       </Docs>
@@ -6305,7 +6143,6 @@ public class ArraySortExample {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Array" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -6314,6 +6151,10 @@ public class ArraySortExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether an element is in the <see cref="T:System.Collections.IList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is found in the <see cref="T:System.Collections.IList" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to locate in the current list. The element to locate can be null for reference types.</param>
       </Docs>
@@ -6339,7 +6180,6 @@ public class ArraySortExample {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Array" /> instance is cast to an <see cref="T:System.Collections.IList" /> interface.</para>
@@ -6348,6 +6188,10 @@ public class ArraySortExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines the index of a specific item in the <see cref="T:System.Collections.IList" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index of value if found in the list; otherwise, -1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to locate in the current list.</param>
       </Docs>
@@ -6477,7 +6321,6 @@ public class ArraySortExample {
         <Parameter Name="comparer" Type="System.Collections.IComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Array" /> instance is cast to an <see cref="T:System.Collections.IStructuralComparable" /> interface.</para>
@@ -6486,6 +6329,46 @@ public class ArraySortExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current collection object precedes, occurs in the same position as, or follows another object in the sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that indicates the relationship of the current collection object to other, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>-1</para>
+              </term>
+              <description>
+                <para>The current instance precedes <paramref name="other" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>0</para>
+              </term>
+              <description>
+                <para>The current instance and <paramref name="other" /> are equal.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>1</para>
+              </term>
+              <description>
+                <para>The current instance follows <paramref name="other" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current instance.</param>
         <param name="comparer">
@@ -6507,7 +6390,6 @@ public class ArraySortExample {
         <Parameter Name="comparer" Type="System.Collections.IEqualityComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Array" /> instance is cast to an <see cref="T:System.Collections.IStructuralEquatable" /> interface.</para>
@@ -6516,6 +6398,10 @@ public class ArraySortExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether an object is equal to the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two objects are equal; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current instance.</param>
         <param name="comparer">
@@ -6536,7 +6422,6 @@ public class ArraySortExample {
         <Parameter Name="comparer" Type="System.Collections.IEqualityComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Array" /> instance is cast to an <see cref="T:System.Collections.IStructuralEquatable" /> interface.</para>
@@ -6545,6 +6430,10 @@ public class ArraySortExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash code for the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for the current instance.</para>
+        </returns>
         <param name="comparer">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that computes the hash code of the current object.</param>
       </Docs>
@@ -6568,10 +6457,6 @@ public class ArraySortExample {
         <Parameter Name="match" Type="System.Predicate&lt;T&gt;" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" />, if every element in <paramref name="array" /> matches the specified predicate; otherwise, <see langword="false" />.</para>
-        </returns>
         <since version=".NET 2.0" />
         <exception cref="T:System.ArgumentNullException">
           <paramref name="array" />  or <paramref name="match" /> is <see langword="null" />.</exception>
@@ -6584,6 +6469,10 @@ public class ArraySortExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether every element in the array matches the conditions defined by the specified predicate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if every element in <paramref name="array" /> matches the conditions defined by the specified predicate; otherwise, false. If there are no elements in the array, the return value is true.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />The one-dimensional, zero-based <see cref="T:System.Array" /> to check against the conditions.</param>
         <param name="match">
diff --git a/mcs/class/corlib/Documentation/en/System/ArraySegment`1.xml b/mcs/class/corlib/Documentation/en/System/ArraySegment`1.xml
index 5c5302185c1..98515301022 100644
--- a/mcs/class/corlib/Documentation/en/System/ArraySegment`1.xml
+++ b/mcs/class/corlib/Documentation/en/System/ArraySegment`1.xml
@@ -181,7 +181,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -202,6 +201,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified object is equal to the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified object is a <see cref="T:System.ArraySegment`1" /> structure and is equal to the current instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be compared with the current instance.</param>
       </Docs>
@@ -219,13 +222,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Offset">
@@ -538,7 +544,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.ArraySegment`1" /> instance is cast to an <see cref="T:System.Collections.IEnumerable" /> interface.</para>
@@ -547,6 +552,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through an array segment.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator that can be used to iterate through the array segment.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System/Attribute.xml b/mcs/class/corlib/Documentation/en/System/Attribute.xml
index 39ede5faa4c..76160348aba 100644
--- a/mcs/class/corlib/Documentation/en/System/Attribute.xml
+++ b/mcs/class/corlib/Documentation/en/System/Attribute.xml
@@ -171,11 +171,6 @@ class AuthorInfo
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" /> where <see langword="true" /> indicates <paramref name="obj" />
-represents the same type and value as the current instance. If <paramref name="obj" /> is a null reference or is not an instance of
-<see cref="T:System.Attribute" />, returns <see langword="false" />.</para>
-        </returns>
         <remarks>
           <block subset="none" type="note">
             <para>This method overrides <see cref="M:System.Object.Equals(System.Object)" qualify="true" />.</para>
@@ -187,6 +182,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> equals the type and value of this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Object" /> to compare with this instance or null. </param>
       </Docs>
@@ -210,11 +209,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="attributeType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> The single instance of <see cref="T:System.Attribute" /> of type <paramref name="attributeType" /> that is applied to <paramref name="element." /> Returns <see langword="null " /> if the
-   specified attribute was not found.
-   </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="element" /> or <paramref name="attributeType" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -231,6 +225,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a custom attribute applied to a specified assembly. Parameters specify the assembly and the type of the custom attribute to search for.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to the single custom attribute of type <paramref name="attributeType" /> that is applied to <paramref name="element" />, or null if there is no such attribute.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.Assembly" /> class that describes a reusable collection of modules. </param>
         <param name="attributeType">
@@ -258,11 +256,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="attributeType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> The single instance of <see cref="T:System.Attribute" /> of type <paramref name="attributeType" /> that is applied to <paramref name="element." /> Returns <see langword="null " /> if the
-   specified attribute was not found.
-   </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="element" /> or <paramref name="attributeType" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -281,6 +274,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a custom attribute applied to a member of a type. Parameters specify the member, and the type of the custom attribute to search for.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to the single custom attribute of type <paramref name="attributeType" /> that is applied to <paramref name="element" />, or null if there is no such attribute.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.MemberInfo" /> class that describes a constructor, event, field, method, or property member of a class. </param>
         <param name="attributeType">
@@ -307,11 +304,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="attributeType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> The single instance of <see cref="T:System.Attribute" /> of type <paramref name="attributeType" /> that is applied to <paramref name="element." /> Returns <see langword="null " /> if the
-   specified attribute was not found.
-   </para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note">If multiple instances of <paramref name="attributeType" /> can be
@@ -327,6 +319,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a custom attribute applied to a module. Parameters specify the module, and the type of the custom attribute to search for.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to the single custom attribute of type <paramref name="attributeType" /> that is applied to <paramref name="element" />, or null if there is no such attribute.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.Module" /> class that describes a portable executable file. </param>
         <param name="attributeType">
@@ -353,11 +349,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="attributeType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> The single instance of <see cref="T:System.Attribute" /> of type <paramref name="attributeType" /> that is applied to <paramref name="element." /> Returns <see langword="null " /> if the
-   specified attribute was not found.
-   </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="element" /> or <paramref name="attributeType" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -371,6 +362,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a custom attribute applied to a method parameter. Parameters specify the method parameter, and the type of the custom attribute to search for.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to the single custom attribute of type <paramref name="attributeType" /> that is applied to <paramref name="element" />, or null if there is no such attribute.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.ParameterInfo" /> class that describes a parameter of a member of a class. </param>
         <param name="attributeType">
@@ -397,7 +392,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -408,6 +402,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a custom attribute applied to an assembly. Parameters specify the assembly, the type of the custom attribute to search for, and an ignored search option.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to the single custom attribute of type <paramref name="attributeType" /> that is applied to <paramref name="element" />, or null if there is no such attribute.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.Assembly" /> class that describes a reusable collection of modules. </param>
         <param name="attributeType">
@@ -434,7 +432,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -445,6 +442,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a custom attribute applied to a member of a type. Parameters specify the member, the type of the custom attribute to search for, and whether to search ancestors of the member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to the single custom attribute of type <paramref name="attributeType" /> that is applied to <paramref name="element" />, or null if there is no such attribute.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.MemberInfo" /> class that describes a constructor, event, field, method, or property member of a class. </param>
         <param name="attributeType">
@@ -471,12 +472,15 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a custom attribute applied to a module. Parameters specify the module, the type of the custom attribute to search for, and an ignored search option.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to the single custom attribute of type <paramref name="attributeType" /> that is applied to <paramref name="element" />, or null if there is no such attribute.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.Module" /> class that describes a portable executable file. </param>
         <param name="attributeType">
@@ -503,7 +507,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="element" /> represents a parameter in a method of a derived type, the return value includes the inheritable custom attributes applied to the same parameter in the overridden base methods.</para>
@@ -512,6 +515,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a custom attribute applied to a method parameter. Parameters specify the method parameter, the type of the custom attribute to search for, and whether to search ancestors of the method parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to the single custom attribute of type <paramref name="attributeType" /> that is applied to <paramref name="element" />, or null if there is no such attribute.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.ParameterInfo" /> class that describes a parameter of a member of a class. </param>
         <param name="attributeType">
@@ -537,15 +544,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="element" Type="System.Reflection.Assembly" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Attribute" /> array containing
-   all custom attributes that are applied to <paramref name="element." />
-   The
-   array includes any inherited custom attributes. Returns
-   an empty array if no custom attributes were found in the metadata for
-<paramref name="element" /> 
-.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="element" /> is <see langword="null" />.</exception>
         <remarks>
@@ -558,6 +556,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of the custom attributes applied to an assembly. A parameter specifies the assembly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Attribute" /> array that contains the custom attributes applied to <paramref name="element" />, or an empty array if no such custom attributes exist.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.Assembly" /> class that describes a reusable collection of modules. </param>
       </Docs>
@@ -582,14 +584,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="element" Type="System.Reflection.MemberInfo" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Attribute" /> array containing
-   all custom attributes that are applied to <paramref name="element." /> The array includes custom attributes that are inherited by
-<paramref name="element" />, if any. Returns 
-   an empty array if no custom attributes were found in the metadata for
-<paramref name="element" /> 
-.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="element" /> is <see langword="null" />.</exception>
         <exception cref="T:System.NotSupportedException">
@@ -605,6 +599,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of the custom attributes applied to a member of a type. A parameter specifies the member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Attribute" /> array that contains the custom attributes applied to <paramref name="element" />, or an empty array if no such custom attributes exist.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.MemberInfo" /> class that describes a constructor, event, field, method, or property member of a class. </param>
       </Docs>
@@ -628,14 +626,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="element" Type="System.Reflection.Module" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Attribute" /> array containing
-   all custom attributes that are applied to <paramref name="element." />
-   The array includes any inherited custom attributes. Returns
-   an empty array if no custom attributes were found in the metadata for
-<paramref name="element" /> 
-.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="element" /> is <see langword="null" />.</exception>
@@ -643,6 +633,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of the custom attributes applied to a module. A parameter specifies the module.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Attribute" /> array that contains the custom attributes applied to <paramref name="element" />, or an empty array if no such custom attributes exist.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.Module" /> class that describes a portable executable file. </param>
       </Docs>
@@ -666,14 +660,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="element" Type="System.Reflection.ParameterInfo" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Attribute" /> array containing
-   all custom attributes that are applied to <paramref name="element." /> The array includes any inherited custom
-   attributes. Returns
-   an empty array if no custom attributes were found in the metadata for
-<paramref name="element" /> 
-.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="element" /> is <see langword="null" />.</exception>
         <remarks>
@@ -684,6 +670,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of the custom attributes applied to a method parameter. A parameter specifies the method parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Attribute" /> array that contains the custom attributes applied to <paramref name="element" />, or an empty array if no such custom attributes exist.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.ParameterInfo" /> class that describes a parameter of a member of a class. </param>
       </Docs>
@@ -707,7 +697,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -718,6 +707,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of the custom attributes applied to an assembly. Parameters specify the assembly, and an ignored search option.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Attribute" /> array that contains the custom attributes applied to <paramref name="element" />, or an empty array if no such custom attributes exist.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.Assembly" /> class that describes a reusable collection of modules. </param>
         <param name="inherit">
@@ -742,12 +735,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="attributeType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> An array of type <paramref name="attributeType" /> containing the instances that are applied to <paramref name="element." /> The array includes any inherited instances 
-   of <paramref name="attributeType" />. Returns an empty array if the
-   specified attribute was not found.
-   </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="element" /> or <paramref name="type" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -762,6 +749,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of the custom attributes applied to an assembly. Parameters specify the assembly, and the type of the custom attribute to search for.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Attribute" /> array that contains the custom attributes of type <paramref name="attributeType" /> applied to <paramref name="element" />, or an empty array if no such custom attributes exist.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.Assembly" /> class that describes a reusable collection of modules. </param>
         <param name="attributeType">
@@ -788,7 +779,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value contains the custom attributes for ancestors of <paramref name="element" /> if <paramref name="inherit" /> is true.</para>
@@ -800,6 +790,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of the custom attributes applied to a member of a type. Parameters specify the member, the type of the custom attribute to search for, and whether to search ancestors of the member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Attribute" /> array that contains the custom attributes applied to <paramref name="element" />, or an empty array if no such custom attributes exist.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.MemberInfo" /> class that describes a constructor, event, field, method, or property member of a class. </param>
         <param name="inherit">
@@ -824,13 +818,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> An array of type <paramref name="type" /> containing the instances that are applied to <paramref name="element." /> The array includes instances
-   of <paramref name="type" /> that are inherited by
-<paramref name="element" />, if any. Returns an empty array if the
-   specified attribute was not found.
-   </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="element" /> or <paramref name="type" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -848,6 +835,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of the custom attributes applied to a member of a type. Parameters specify the member, and the type of the custom attribute to search for.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Attribute" /> array that contains the custom attributes of type <paramref name="type" /> applied to <paramref name="element" />, or an empty array if no such custom attributes exist.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.MemberInfo" /> class that describes a constructor, event, field, method, or property member of a class. </param>
         <param name="type">
@@ -873,7 +864,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value contains the custom attributes for ancestors of <paramref name="element" /> if <paramref name="inherit" /> is true.</para>
@@ -882,6 +872,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of the custom attributes applied to a module. Parameters specify the module, and an ignored search option.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Attribute" /> array that contains the custom attributes applied to <paramref name="element" />, or an empty array if no such custom attributes exist.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.Module" /> class that describes a portable executable file. </param>
         <param name="inherit">
@@ -906,12 +900,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="attributeType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> An array of type <paramref name="attributeType" /> containing the instances that are applied to <paramref name="element." /> The array includes any inherited instances
-   of <paramref name="attributeType" />. Returns an empty array if the
-   specified attribute was not found.
-   </para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="element" /> or <paramref name="type" /> is <see langword="null" />.</exception>
@@ -921,6 +909,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of the custom attributes applied to a module. Parameters specify the module, and the type of the custom attribute to search for.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Attribute" /> array that contains the custom attributes of type <paramref name="attributeType" /> applied to <paramref name="element" />, or an empty array if no such custom attributes exist.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.Module" /> class that describes a portable executable file. </param>
         <param name="attributeType">
@@ -946,7 +938,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="element" /> represents a parameter in a method of a derived type, the return value includes the inheritable custom attributes applied to the same parameter in the overridden base methods.</para>
@@ -955,6 +946,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of the custom attributes applied to a method parameter. Parameters specify the method parameter, and whether to search ancestors of the method parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Attribute" /> array that contains the custom attributes applied to <paramref name="element" />, or an empty array if no such custom attributes exist.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.ParameterInfo" /> class that describes a parameter of a member of a class. </param>
         <param name="inherit">
@@ -979,12 +974,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="attributeType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> An array of type <paramref name="attributeType" /> containing the instances that are applied to <paramref name="element." /> The array includes any inherited instances
-   of <paramref name="attributeType" />. Returns an empty array if the
-   specified attribute was not found.
-   </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="element" /> or <paramref name="attributeType" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -997,6 +986,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of the custom attributes applied to a method parameter. Parameters specify the method parameter, and the type of the custom attribute to search for.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Attribute" /> array that contains the custom attributes of type <paramref name="attributeType" /> applied to <paramref name="element" />, or an empty array if no such custom attributes exist.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.ParameterInfo" /> class that describes a parameter of a member of a class. </param>
         <param name="attributeType">
@@ -1023,7 +1016,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1034,6 +1026,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of the custom attributes applied to an assembly. Parameters specify the assembly, the type of the custom attribute to search for, and an ignored search option.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Attribute" /> array that contains the custom attributes of type <paramref name="attributeType" /> applied to <paramref name="element" />, or an empty array if no such custom attributes exist.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.Assembly" /> class that describes a reusable collection of modules. </param>
         <param name="attributeType">
@@ -1060,7 +1056,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value contains the custom attributes for ancestors of <paramref name="element" /> if <paramref name="inherit" /> is true.</para>
@@ -1072,6 +1067,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of the custom attributes applied to a member of a type. Parameters specify the member, the type of the custom attribute to search for, and whether to search ancestors of the member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Attribute" /> array that contains the custom attributes of type <paramref name="type" /> applied to <paramref name="element" />, or an empty array if no such custom attributes exist.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.MemberInfo" /> class that describes a constructor, event, field, method, or property member of a class. </param>
         <param name="type">
@@ -1098,7 +1097,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value contains the custom attributes for ancestors of <paramref name="element" /> if <paramref name="inherit" /> is true.</para>
@@ -1107,6 +1105,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of the custom attributes applied to a module. Parameters specify the module, the type of the custom attribute to search for, and an ignored search option.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Attribute" /> array that contains the custom attributes of type <paramref name="attributeType" /> applied to <paramref name="element" />, or an empty array if no such custom attributes exist.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.Module" /> class that describes a portable executable file. </param>
         <param name="attributeType">
@@ -1133,7 +1135,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="element" /> represents a parameter in a method of a derived type, the return value includes the inheritable custom attributes applied to the same parameter in the overridden base methods.</para>
@@ -1142,6 +1143,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of the custom attributes applied to a method parameter. Parameters specify the method parameter, the type of the custom attribute to search for, and whether to search ancestors of the method parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Attribute" /> array that contains the custom attributes of type <paramref name="attributeType" /> applied to <paramref name="element" />, or an empty array if no such custom attributes exist.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.ParameterInfo" /> class that describes a parameter of a member of a class. </param>
         <param name="attributeType">
@@ -1165,9 +1170,6 @@ represents the same type and value as the current instance. If <paramref name="o
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the hash code for the current instance.</para>
-        </returns>
         <remarks>
           <para>
       The algorithm used to generate the hash code is
@@ -1183,6 +1185,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1200,7 +1206,6 @@ represents the same type and value as the current instance. If <paramref name="o
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The default implementation of this class returns false, and must be implemented in the derived class to be useful to that class.</para>
@@ -1210,6 +1215,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this instance is the default attribute for the class; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsDefined">
@@ -1230,12 +1239,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="attributeType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if a custom attribute of type 
-<paramref name="attributeType" /> is applied to <paramref name="element" />; otherwise, 
-<see langword="false" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="element" /> or <paramref name="attributeType" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -1250,6 +1253,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether any custom attributes are applied to an assembly. Parameters specify the assembly, and the type of the custom attribute to search for.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a custom attribute of type <paramref name="attributeType" /> is applied to <paramref name="element" />; otherwise, false.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.Assembly" /> class that describes a reusable collection of modules. </param>
         <param name="attributeType">
@@ -1277,12 +1284,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="attributeType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if a custom attribute of type
-<paramref name="attributeType" /> is applied to <paramref name="element" /> either directly or through inheritance; otherwise, 
-<see langword="false" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="element" /> or <paramref name="attributeType" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -1300,6 +1301,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether any custom attributes are applied to a member of a type. Parameters specify the member, and the type of the custom attribute to search for.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a custom attribute of type <paramref name="attributeType" /> is applied to <paramref name="element" />; otherwise, false.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.MemberInfo" /> class that describes a constructor, event, field, method, type, or property member of a class. </param>
         <param name="attributeType">
@@ -1326,12 +1331,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="attributeType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if a custom attribute of type
-<paramref name="attributeType" /> is applied to <paramref name="element" /> 
-; otherwise, <see langword="false" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="element" /> or <paramref name="attributeType" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -1344,6 +1343,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether any custom attributes of a specified type are applied to a module. Parameters specify the module, and the type of the custom attribute to search for.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a custom attribute of type <paramref name="attributeType" /> is applied to <paramref name="element" />; otherwise, false.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.Module" /> class that describes a portable executable file. </param>
         <param name="attributeType">
@@ -1370,12 +1373,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="attributeType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if a custom attribute of type
-<paramref name="attributeType" /> is applied to <paramref name="element" /> either directly or through 
-   inheritance; otherwise, <see langword="false" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="element" /> or <paramref name="attributeType" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -1388,6 +1385,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether any custom attributes are applied to a method parameter. Parameters specify the method parameter, and the type of the custom attribute to search for.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a custom attribute of type <paramref name="attributeType" /> is applied to <paramref name="element" />; otherwise, false.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.ParameterInfo" /> class that describes a parameter of a member of a class. </param>
         <param name="attributeType">
@@ -1414,7 +1415,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1425,6 +1425,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether any custom attributes are applied to an assembly. Parameters specify the assembly, the type of the custom attribute to search for, and an ignored search option.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a custom attribute of type <paramref name="attributeType" /> is applied to <paramref name="element" />; otherwise, false.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.Assembly" /> class that describes a reusable collection of modules. </param>
         <param name="attributeType">
@@ -1451,7 +1455,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -1462,6 +1465,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether any custom attributes are applied to a member of a type. Parameters specify the member, the type of the custom attribute to search for, and whether to search ancestors of the member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a custom attribute of type <paramref name="attributeType" /> is applied to <paramref name="element" />; otherwise, false.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.MemberInfo" /> class that describes a constructor, event, field, method, type, or property member of a class. </param>
         <param name="attributeType">
@@ -1488,7 +1495,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method ignores the <paramref name="inherit" /> parameter and does not search the ancestors of <paramref name="element" /> for custom attributes.</para>
@@ -1497,6 +1503,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether any custom attributes are applied to a module. Parameters specify the module, the type of the custom attribute to search for, and an ignored search option. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a custom attribute of type <paramref name="attributeType" /> is applied to <paramref name="element" />; otherwise, false.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.Module" /> class that describes a portable executable file. </param>
         <param name="attributeType">
@@ -1523,12 +1533,15 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="inherit" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether any custom attributes are applied to a method parameter. Parameters specify the method parameter, the type of the custom attribute to search for, and whether to search ancestors of the method parameter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a custom attribute of type <paramref name="attributeType" /> is applied to <paramref name="element" />; otherwise, false.</para>
+        </returns>
         <param name="element">
           <attribution license="cc4" from="Microsoft" modified="false" />An object derived from the <see cref="T:System.Reflection.ParameterInfo" /> class that describes a parameter of a member of a class. </param>
         <param name="attributeType">
@@ -1553,7 +1566,6 @@ represents the same type and value as the current instance. If <paramref name="o
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method determines if one <see cref="T:System.Attribute" /> equals another. Its default implementation is the same as <see cref="M:System.Attribute.Equals(System.Object)" />, which performs a value and reference comparison. Override this method to implement support for attribute values, such as flags or bit fields, that consist of components that are meaningful in themselves.</para>
@@ -1563,6 +1575,10 @@ represents the same type and value as the current instance. If <paramref name="o
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this instance equals <paramref name="obj" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Object" /> to compare with this instance of <see cref="T:System.Attribute" />. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System/BadImageFormatException.xml b/mcs/class/corlib/Documentation/en/System/BadImageFormatException.xml
index 285ca58867b..9d134352a14 100644
--- a/mcs/class/corlib/Documentation/en/System/BadImageFormatException.xml
+++ b/mcs/class/corlib/Documentation/en/System/BadImageFormatException.xml
@@ -548,10 +548,6 @@ public class BadImageExample {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" />
-representation of the current exception.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The string representation returned by this method includes the name of the exception, the value of the <see cref="P:System.BadImageFormatException.Message" /> property, the result of calling ToString on the inner exception, the value of the <see cref="P:System.BadImageFormatException.FileName" /> property, and the result of calling <see cref="P:System.Environment.StackTrace" />. If any of these members is a null reference (Nothing in Visual Basic), its value is not included in the returned string.</para>
@@ -560,6 +556,10 @@ representation of the current exception.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the fully qualified name of this exception and possibly the error message, the name of the inner exception, and the stack trace.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the fully qualified name of this exception and possibly the error message, the name of the inner exception, and the stack trace.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System/BitConverter.xml b/mcs/class/corlib/Documentation/en/System/BitConverter.xml
index f216a829612..c56a339c827 100644
--- a/mcs/class/corlib/Documentation/en/System/BitConverter.xml
+++ b/mcs/class/corlib/Documentation/en/System/BitConverter.xml
@@ -268,7 +268,6 @@
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The order of bits in the integer returned by the <see cref="M:System.BitConverter.DoubleToInt64Bits(System.Double)" /> method depends on whether the computer architecture is little-endian or big-endian.</para>
@@ -277,6 +276,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified double-precision floating point number to a 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit signed integer whose value is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The number to convert. </param>
       </Docs>
@@ -297,12 +300,15 @@
         <Parameter Name="value" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>The binary representation of the value as an <see cref="T:System.Array" /> of bytes</returns>
         <remarks>Returns 1 byte (true: 1, false: 0)</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified Boolean value as an array of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of bytes with length 1.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A Boolean value. </param>
       </Docs>
@@ -323,7 +329,6 @@
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>The binary representation of the value as an <see cref="T:System.Array" /> of bytes</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The order of bytes in the array returned by the <see cref="M:System.BitConverter.GetBytes(System.Boolean)" /> method depends on whether the computer architecture is little-endian or big-endian.</para>
@@ -332,6 +337,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified Unicode character value as an array of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of bytes with length 2.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A character to convert. </param>
       </Docs>
@@ -352,7 +361,6 @@
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>The binary representation of the value as an <see cref="T:System.Array" /> of bytes</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The order of bytes in the array returned by the <see cref="M:System.BitConverter.GetBytes(System.Boolean)" /> method depends on whether the computer architecture is little-endian or big-endian.</para>
@@ -361,6 +369,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified double-precision floating point value as an array of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of bytes with length 8.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The number to convert. </param>
       </Docs>
@@ -381,7 +393,6 @@
         <Parameter Name="value" Type="System.Int16" />
       </Parameters>
       <Docs>
-        <returns>The binary representation of the value as an <see cref="T:System.Array" /> of bytes</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The order of bytes in the array returned by the <see cref="M:System.BitConverter.GetBytes(System.Boolean)" /> method depends on whether the computer architecture is little-endian or big-endian.</para>
@@ -390,6 +401,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified 16-bit signed integer value as an array of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of bytes with length 2.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The number to convert. </param>
       </Docs>
@@ -410,7 +425,6 @@
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>The binary representation of the value as an <see cref="T:System.Array" /> of bytes</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The order of bytes in the array returned by the <see cref="M:System.BitConverter.GetBytes(System.Boolean)" /> method depends on whether the computer architecture is little-endian or big-endian.</para>
@@ -419,6 +433,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified 32-bit signed integer value as an array of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of bytes with length 4.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The number to convert. </param>
       </Docs>
@@ -439,7 +457,6 @@
         <Parameter Name="value" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>The binary representation of the value as an <see cref="T:System.Array" /> of bytes</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The order of bytes in the array returned by the <see cref="M:System.BitConverter.GetBytes(System.Boolean)" /> method depends on whether the computer architecture is little-endian or big-endian.</para>
@@ -448,6 +465,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified 64-bit signed integer value as an array of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of bytes with length 8.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The number to convert. </param>
       </Docs>
@@ -468,7 +489,6 @@
         <Parameter Name="value" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>The binary representation of the value as an <see cref="T:System.Array" /> of bytes</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The order of bytes in the array returned by the <see cref="M:System.BitConverter.GetBytes(System.Boolean)" /> method depends on whether the computer architecture is little-endian or big-endian.</para>
@@ -477,6 +497,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified single-precision floating point value as an array of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of bytes with length 4.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The number to convert. </param>
       </Docs>
@@ -502,8 +526,6 @@
         <Parameter Name="value" Type="System.UInt16" />
       </Parameters>
       <Docs>
-        <returns>The binary representation of the value as an <see cref="T:System.Array" /> of bytes
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The order of bytes in the array returned by the <see cref="M:System.BitConverter.GetBytes(System.Boolean)" /> method depends on whether the computer architecture is little-endian or big-endian.</para>
@@ -512,6 +534,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified 16-bit unsigned integer value as an array of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of bytes with length 2.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The number to convert. </param>
       </Docs>
@@ -537,7 +563,6 @@
         <Parameter Name="value" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <returns>The binary representation of the value as an <see cref="T:System.Array" /> of bytes</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The order of bytes in the array returned by the <see cref="M:System.BitConverter.GetBytes(System.Boolean)" /> method depends on whether the computer architecture is little-endian or big-endian.</para>
@@ -546,6 +571,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified 32-bit unsigned integer value as an array of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of bytes with length 4.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The number to convert. </param>
       </Docs>
@@ -571,7 +600,6 @@
         <Parameter Name="value" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>The binary representation of the value as an <see cref="T:System.Array" /> of bytes</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The order of bytes in the array returned by the <see cref="M:System.BitConverter.GetBytes(System.Boolean)" /> method depends on whether the computer architecture is little-endian or big-endian.</para>
@@ -580,6 +608,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified 64-bit unsigned integer value as an array of bytes.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of bytes with length 8.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The number to convert. </param>
       </Docs>
@@ -600,7 +632,6 @@
         <Parameter Name="value" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'double'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Typically, <paramref name="value" /> is an integer that is returned by the <see cref="M:System.BitConverter.DoubleToInt64Bits(System.Double)" /> method.</para>
@@ -609,6 +640,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified 64-bit signed integer to a double-precision floating point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A double-precision floating point number whose value is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The number to convert. </param>
       </Docs>
@@ -655,12 +690,15 @@
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Boolean value converted from one byte at a specified position in a byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the byte at <paramref name="startIndex" /> in <paramref name="value" /> is nonzero; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of bytes. </param>
         <param name="startIndex">
@@ -684,7 +722,6 @@
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'char'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.BitConverter.ToChar(System.Byte[],System.Int32)" /> method converts the bytes from index <paramref name="startIndex" /> to <paramref name="startIndex" /> + 1 to a <see cref="T:System.Char" /> value. The order of bytes in the array must reflect the endianness of the computer system's architecture; for more information, see the Remarks section of the <see cref="T:System.BitConverter" /> class topic. </para>
@@ -693,6 +730,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a Unicode character converted from two bytes at a specified position in a byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A character formed by two bytes beginning at <paramref name="startIndex" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An array. </param>
         <param name="startIndex">
@@ -716,7 +757,6 @@
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'double'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.BitConverter.ToDouble(System.Byte[],System.Int32)" /> method converts the bytes from index <paramref name="startIndex" /> to <paramref name="startIndex" /> + 7 to a <see cref="T:System.Double" /> value. The order of bytes in the array must reflect the endianness of the computer system's architecture; for more information, see the Remarks section of the <see cref="T:System.BitConverter" /> class topic. </para>
@@ -725,6 +765,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a double-precision floating point number converted from eight bytes at a specified position in a byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A double precision floating point number formed by eight bytes beginning at <paramref name="startIndex" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of bytes. </param>
         <param name="startIndex">
@@ -748,7 +792,6 @@
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'short'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.BitConverter.ToInt16(System.Byte[],System.Int32)" /> method converts the bytes from index <paramref name="startIndex" /> to <paramref name="startIndex" /> + 1 to an <see cref="T:System.Int16" /> value. The order of bytes in the array must reflect the endianness of the computer system's architecture; for more information, see the Remarks section of the <see cref="T:System.BitConverter" /> class topic. </para>
@@ -757,6 +800,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a 16-bit signed integer converted from two bytes at a specified position in a byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit signed integer formed by two bytes beginning at <paramref name="startIndex" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of bytes. </param>
         <param name="startIndex">
@@ -780,7 +827,6 @@
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.BitConverter.ToInt32(System.Byte[],System.Int32)" /> method converts the bytes from index <paramref name="startIndex" /> to <paramref name="startIndex" /> + 3 to an <see cref="T:System.Int32" /> value. The order of bytes in the array must reflect the endianness of the computer system's architecture; for more information, see the Remarks section of <see cref="T:System.BitConverter" />.</para>
@@ -789,6 +835,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a 32-bit signed integer converted from four bytes at a specified position in a byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer formed by four bytes beginning at <paramref name="startIndex" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of bytes. </param>
         <param name="startIndex">
@@ -812,7 +862,6 @@
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.BitConverter.ToInt64(System.Byte[],System.Int32)" /> method converts the bytes from index <paramref name="startIndex" /> to <paramref name="startIndex" /> + 7 to a <see cref="T:System.Int64" /> value. The order of bytes in the array must reflect the endianness of the computer system's architecture; for more information, see the Remarks section of the <see cref="T:System.BitConverter" /> class topic. </para>
@@ -821,6 +870,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a 64-bit signed integer converted from eight bytes at a specified position in a byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit signed integer formed by eight bytes beginning at <paramref name="startIndex" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of bytes. </param>
         <param name="startIndex">
@@ -844,7 +897,6 @@
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'float'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.BitConverter.ToSingle(System.Byte[],System.Int32)" /> method converts the bytes from index <paramref name="startIndex" /> to <paramref name="startIndex" /> + 3 to a <see cref="T:System.Single" /> value. The order of bytes in the array must reflect the endianness of the computer system's architecture; for more information, see the Remarks section of <see cref="T:System.BitConverter" />. </para>
@@ -853,6 +905,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a single-precision floating point number converted from four bytes at a specified position in a byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A single-precision floating point number formed by four bytes beginning at <paramref name="startIndex" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of bytes. </param>
         <param name="startIndex">
@@ -875,7 +931,6 @@
         <Parameter Name="value" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>All the elements of <paramref name="value" /> are converted. The order of hexadecimal strings returned by the <see cref="M:System.BitConverter.ToString(System.Byte[])" /> method depends on whether the computer architecture is little-endian or big-endian.</para>
@@ -884,6 +939,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of each element of a specified array of bytes to its equivalent hexadecimal string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string of hexadecimal pairs separated by hyphens, where each pair represents the corresponding element in <paramref name="value" />; for example, "7F-2C-4A-00".</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of bytes. </param>
       </Docs>
@@ -905,7 +964,6 @@
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The elements from array position <paramref name="startIndex" /> to the end of the array are converted. The order of hexadecimal strings returned by the <see cref="M:System.BitConverter.ToString(System.Byte[])" /> method depends on whether the computer architecture is little-endian or big-endian.</para>
@@ -914,6 +972,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of each element of a specified subarray of bytes to its equivalent hexadecimal string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string of hexadecimal pairs separated by hyphens, where each pair represents the corresponding element in a subarray of <paramref name="value" />; for example, "7F-2C-4A-00".</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of bytes. </param>
         <param name="startIndex">
@@ -938,7 +1000,6 @@
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="length" /> elements from array position <paramref name="startIndex" /> are converted. If <paramref name="length" /> equals zero, the method returns <see cref="F:System.String.Empty" />.</para>
@@ -948,6 +1009,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of each element of a specified subarray of bytes to its equivalent hexadecimal string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string of hexadecimal pairs separated by hyphens, where each pair represents the corresponding element in a subarray of <paramref name="value" />; for example, "7F-2C-4A-00".</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of bytes. </param>
         <param name="startIndex">
@@ -978,7 +1043,6 @@
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ushort'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.BitConverter.ToUInt16(System.Byte[],System.Int32)" /> method converts the bytes from index <paramref name="startIndex" /> to <paramref name="startIndex" /> + 1 to a <see cref="T:System.UInt16" /> value. The order of bytes in the array must reflect the endianness of the computer system's architecture; for more information, see the Remarks section of the <see cref="T:System.BitConverter" /> class topic. </para>
@@ -987,6 +1051,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a 16-bit unsigned integer converted from two bytes at a specified position in a byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit unsigned integer formed by two bytes beginning at <paramref name="startIndex" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of bytes. </param>
         <param name="startIndex">
@@ -1015,7 +1083,6 @@
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'uint'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.BitConverter.ToUInt32(System.Byte[],System.Int32)" /> method converts the bytes from index <paramref name="startIndex" /> to <paramref name="startIndex" /> + 3 to a <see cref="T:System.UInt32" /> value. The order of bytes in the array must reflect the endianness of the computer system's architecture; for more information, see the Remarks section of the <see cref="T:System.BitConverter" /> class topic. </para>
@@ -1024,6 +1091,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a 32-bit unsigned integer converted from four bytes at a specified position in a byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit unsigned integer formed by four bytes beginning at <paramref name="startIndex" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of bytes. </param>
         <param name="startIndex">
@@ -1052,7 +1123,6 @@
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ulong'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.BitConverter.ToUInt64(System.Byte[],System.Int32)" /> method converts the bytes from index <paramref name="startIndex" /> to <paramref name="startIndex" /> + 7 to a <see cref="T:System.UInt64" /> value. The order of bytes in the array must reflect the endianness of the computer system's architecture; for more information, see the Remarks section of the <see cref="T:System.BitConverter" /> class topic. </para>
@@ -1061,6 +1131,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a 64-bit unsigned integer converted from eight bytes at a specified position in a byte array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit unsigned integer formed by the eight bytes beginning at <paramref name="startIndex" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of bytes. </param>
         <param name="startIndex">
diff --git a/mcs/class/corlib/Documentation/en/System/Boolean.xml b/mcs/class/corlib/Documentation/en/System/Boolean.xml
index 7beba971205..cb817f460b6 100644
--- a/mcs/class/corlib/Documentation/en/System/Boolean.xml
+++ b/mcs/class/corlib/Documentation/en/System/Boolean.xml
@@ -176,31 +176,6 @@
         <Parameter Name="value" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="value" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Condition</description>
-            </listheader>
-            <item>
-              <term> A negative number</term>
-              <description>Current instance is <see langword="false" /> and
-<paramref name="value" /> is <see langword="true" />.</description>
-            </item>
-            <item>
-              <term> Zero</term>
-              <description>Current instance == <paramref name="value" />
-.</description>
-            </item>
-            <item>
-              <term> Any
-      positive number</term>
-              <description>Current instance is <see langword="true" /> and
-<paramref name="value" /> is <see langword="false" />.</description>
-            </item>
-          </list>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -213,6 +188,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this instance to a specified <see cref="T:System.Boolean" /> object and returns an integer that indicates their relationship to one another.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative values of this instance and <paramref name="value" />.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is false and <paramref name="value" /> is true. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance and <paramref name="value" /> are equal (either both are true or both are false). </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is true and <paramref name="value" /> is false. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Boolean" /> object to compare to this instance. </param>
       </Docs>
@@ -234,32 +249,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="obj" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Condition</description>
-            </listheader>
-            <item>
-              <term> A negative number</term>
-              <description>Current instance is <see langword="false" /> and
-<paramref name="obj" /> is <see langword="true" />.</description>
-            </item>
-            <item>
-              <term> Zero</term>
-              <description>Current instance == <paramref name="obj" />
-.</description>
-            </item>
-            <item>
-              <term> Any
-      positive number</term>
-              <description>Current instance is <see langword="true" /> and
-<paramref name="obj" /> is <see langword="false" />, or <paramref name="obj" /> is a null 
-   reference.</description>
-            </item>
-          </list>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="obj" /> is not a <see cref="T:System.Boolean" /> and is not a null reference.</exception>
         <remarks>
@@ -272,6 +261,49 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this instance to a specified object and returns an integer that indicates their relationship to one another.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative order of this instance and <paramref name="obj" />.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is false and <paramref name="obj" /> is true. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance and <paramref name="obj" /> are equal (either both are true or both are false). </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is true and <paramref name="obj" /> is false.</para>
+                <para>-or- </para>
+                <para>
+                  <paramref name="obj" /> is null. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare to this instance, or null. </param>
       </Docs>
@@ -292,14 +324,6 @@
         <Parameter Name="obj" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> has the same value as
-   the current instance; otherwise,  <see langword="false" />.</para>
-          <para>
-            <block subset="none" type="note">This method is implemented to support the <see cref="T:System.IEquatable&lt;Boolean&gt;" /> interface.</block>
-          </para>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -309,6 +333,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified <see cref="T:System.Boolean" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> has the same value as this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Boolean" /> value to compare to this instance.</param>
       </Docs>
@@ -330,13 +358,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> is a <see cref="T:System.Boolean" /> with the same value as
-   the current instance. If <paramref name="obj" /> is a null reference or is not an instance
-   of <see cref="T:System.Boolean" />,
-   returns <see langword="false" />.</para>
-        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare to this instance. </param>
         <remarks>
@@ -347,6 +368,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is a <see cref="T:System.Boolean" /> and has the same value as this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare to this instance. </param>
       </Docs>
@@ -394,10 +419,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> value containing a hash code for the current
-   instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.Boolean" /> class implements true as the integer, one, and false as the integer, zero. However, a particular programming language might represent true and false with other values.</para>
@@ -406,6 +427,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.Boolean" />.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -423,12 +448,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>Returns TypeCode.Boolean from <see cref="T:System.TypeCode" /> enumeration.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.TypeCode" /> for value type <see cref="T:System.Boolean" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The enumerated constant, <see cref="F:System.TypeCode.Boolean" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Parse">
@@ -448,11 +476,6 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="value" /> is equivalent to
-<see cref="F:System.Boolean.TrueString" />; otherwise, <see langword="false" /> .</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -482,6 +505,10 @@ public class BoolParse {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a logical value to its <see cref="T:System.Boolean" /> equivalent, or throws an exception if the string is not equal to the value of <see cref="F:System.Boolean.TrueString" /> or <see cref="F:System.Boolean.FalseString" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is equal to the value of the <see cref="F:System.Boolean.TrueString" /> field; false if <paramref name="value" /> is equal to the value of the <see cref="F:System.Boolean.FalseString" /> field.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string containing the value to convert. </param>
       </Docs>
@@ -503,7 +530,6 @@ public class BoolParse {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Boolean" /> instance is cast to an <see cref="T:System.IConvertible" /> interface.</para>
@@ -512,6 +538,10 @@ public class BoolParse {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToBoolean(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true or false.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -532,7 +562,6 @@ public class BoolParse {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Boolean" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToByte(System.Boolean)" /> method. </para>
@@ -541,6 +570,10 @@ public class BoolParse {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToByte(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>1 if the value of this instance is true; otherwise, 0. </para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -561,12 +594,15 @@ public class BoolParse {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to use this method throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -587,12 +623,15 @@ public class BoolParse {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to use this method throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -613,7 +652,6 @@ public class BoolParse {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Boolean" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToDecimal(System.Boolean)" /> method.</para>
@@ -622,6 +660,10 @@ public class BoolParse {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToDecimal(System.IFormatProvider)" />..</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>1 if this instance is true; otherwise, 0.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -642,7 +684,6 @@ public class BoolParse {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Boolean" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToDouble(System.Boolean)" /> method.</para>
@@ -651,6 +692,10 @@ public class BoolParse {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToDouble(System.IFormatProvider)" />..</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>1 if this instance is true; otherwise, 0.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -671,7 +716,6 @@ public class BoolParse {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Boolean" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt16(System.Boolean)" /> method.</para>
@@ -680,6 +724,10 @@ public class BoolParse {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt16(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>1 if this instance is true; otherwise, 0.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -700,7 +748,6 @@ public class BoolParse {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Boolean" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt32(System.Boolean)" /> method.</para>
@@ -709,6 +756,10 @@ public class BoolParse {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt32(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>1 if this instance is true; otherwise, 0.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -729,7 +780,6 @@ public class BoolParse {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Boolean" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt64(System.Boolean)" /> method.</para>
@@ -738,6 +788,10 @@ public class BoolParse {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt64(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>1 if this instance is true; otherwise, 0.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -758,7 +812,6 @@ public class BoolParse {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Boolean" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToSByte(System.Boolean)" /> method.</para>
@@ -767,6 +820,10 @@ public class BoolParse {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToSByte(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>1 if this instance is true; otherwise, 0.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -787,7 +844,6 @@ public class BoolParse {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Boolean" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToSingle(System.Boolean)" /> method.</para>
@@ -796,6 +852,10 @@ public class BoolParse {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToSingle(System.IFormatProvider)" />..</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>1 if this instance is true; otherwise, 0.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -818,7 +878,6 @@ public class BoolParse {
       </Parameters>
       <Docs>
         <param name="targetType">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Boolean" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ChangeType(System.Object,System.Type,System.IFormatProvider)" /> method.</para>
@@ -827,6 +886,10 @@ public class BoolParse {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToType(System.Type,System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object of the specified type, with a value that is equivalent to the value of this Boolean object.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> implementation that supplies culture-specific information about the format of the returned value.</param>
       </Docs>
@@ -847,7 +910,6 @@ public class BoolParse {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Boolean" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt16(System.Boolean)" /> method.</para>
@@ -856,6 +918,10 @@ public class BoolParse {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt16(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>1 if this instance is true; otherwise, 0.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -876,7 +942,6 @@ public class BoolParse {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Boolean" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt32(System.Boolean)" /> method.</para>
@@ -885,6 +950,10 @@ public class BoolParse {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt32(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>1 if this instance is true; otherwise, 0.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -905,7 +974,6 @@ public class BoolParse {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Boolean" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt64(System.Boolean)" /> method.</para>
@@ -914,6 +982,10 @@ public class BoolParse {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt64(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>1 if this instance is true; otherwise, 0.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -933,11 +1005,6 @@ public class BoolParse {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>
-            <see cref="F:System.Boolean.FalseString" /> if the value of the current instance is
-<see langword="false" />; otherwise, <see cref="F:System.Boolean.TrueString" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns the constants "True" or "False". Note that XML is case-sensitive, and that the XML specification recognizes "true" and "false" as the valid set of Boolean values. If the <see cref="T:System.String" /> object returned by the <see cref="M:System.Boolean.ToString" /> method is to be written to an XML file, its <see cref="M:System.String.ToLower" /> method should be called first to convert it to lowercase.  </para>
@@ -946,6 +1013,11 @@ public class BoolParse {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to its equivalent string representation (either "True" or "False").</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="F:System.Boolean.TrueString" /> if the value of this instance is true, or <see cref="F:System.Boolean.FalseString" /> if the value of this instance is false.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -966,13 +1038,6 @@ public class BoolParse {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see cref="F:System.Boolean.TrueString" /> if the
-   value of this instance is <see langword="true" />, or
-<see cref="F:System.Boolean.FalseString" /> if the value of this instance is 
-<see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="provider" /> parameter is reserved. It does not participate in the execution of this method. This means that the <see cref="M:System.Boolean.ToString(System.IFormatProvider)" /> method, unlike most methods with a <paramref name="provider" /> parameter, does not reflect culture-specific settings. </para>
@@ -983,6 +1048,11 @@ public class BoolParse {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to its equivalent string representation (either "True" or "False").</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <see cref="F:System.Boolean.TrueString" /> if the value of this instance is true, or <see cref="F:System.Boolean.FalseString" /> if the value of this instance is false.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />(Reserved) An <see cref="T:System.IFormatProvider" /> object. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System/Buffer.xml b/mcs/class/corlib/Documentation/en/System/Buffer.xml
index d007b47c6c8..aaff127fe77 100644
--- a/mcs/class/corlib/Documentation/en/System/Buffer.xml
+++ b/mcs/class/corlib/Documentation/en/System/Buffer.xml
@@ -96,12 +96,15 @@
         <Parameter Name="array" Type="System.Array" />
       </Parameters>
       <Docs>
-        <returns>The length in bytes.</returns>
         <remarks />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of bytes in the specified array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of bytes in the array.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />An array. </param>
       </Docs>
@@ -123,7 +126,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>The single byte read from array at index.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The GetByte method gets a particular byte out of the array. The array must be an array of primitives.</para>
@@ -132,6 +134,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the byte at a specified location in a specified array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the <paramref name="index" /> byte in the array.</para>
+        </returns>
         <param name="array">
           <attribution license="cc4" from="Microsoft" modified="false" />An array. </param>
         <param name="index">
diff --git a/mcs/class/corlib/Documentation/en/System/Byte.xml b/mcs/class/corlib/Documentation/en/System/Byte.xml
index fbd49fdd24d..edafbedd581 100644
--- a/mcs/class/corlib/Documentation/en/System/Byte.xml
+++ b/mcs/class/corlib/Documentation/en/System/Byte.xml
@@ -110,27 +110,6 @@
         <Parameter Name="value" Type="System.Byte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="value" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> A negative number</term>
-              <description>Current instance &lt; <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> Zero</term>
-              <description>Current instance == <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> A positive number</term>
-              <description>Current instance &gt; <paramref name="value" />.</description>
-            </item>
-          </list>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -143,6 +122,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this instance to a specified 8-bit unsigned integer and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative order of this instance and <paramref name="value" />.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is equal to <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than <paramref name="value" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An 8-bit unsigned integer to compare. </param>
       </Docs>
@@ -164,28 +183,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="value" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> A negative number</term>
-              <description>Current instance &lt; <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> Zero</term>
-              <description>Current instance == <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> A positive number</term>
-              <description>Current instance &gt; <paramref name="value" />, or
-<paramref name="value" /> is a null reference.</description>
-            </item>
-          </list>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="value" /> is not a <see cref="T:System.Byte" /> and is not a null reference.</exception>
         <remarks>
@@ -199,6 +196,49 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this instance to a specified object and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative order of this instance and <paramref name="value" />.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is equal to <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than <paramref name="value" />.</para>
+                <para>-or- </para>
+                <para>
+                  <paramref name="value" /> is null. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare, or null. </param>
       </Docs>
@@ -219,11 +259,6 @@
         <Parameter Name="obj" Type="System.Byte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> represents the 
- same value as the current instance; otherwise, <see langword="false" />.</para>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -233,6 +268,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance and a specified <see cref="T:System.Byte" /> object represent the same value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is equal to this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare to this instance.</param>
       </Docs>
@@ -254,12 +293,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> represents the 
- same type and value as the current instance. If <paramref name="obj" /> is a null reference
- or is not an instance of <see cref="T:System.Byte" />, returns <see langword="false" />.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note"> This method 
@@ -272,6 +305,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is an instance of <see cref="T:System.Byte" /> and equals the value of this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance, or null. </param>
       </Docs>
@@ -292,9 +329,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the hash code for the current instance.</para>
-        </returns>
         <remarks>
           <para> The algorithm used to
       generate the hash code is unspecified.</para>
@@ -307,6 +341,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.Byte" />.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -324,12 +362,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.TypeCode" /> for value type <see cref="T:System.Byte" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The enumerated constant, <see cref="F:System.TypeCode.Byte" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MaxValue">
@@ -403,9 +444,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Byte" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s " />is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -476,6 +514,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number to its <see cref="T:System.Byte" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte value that is equivalent to the number contained in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a number to convert. The string is interpreted using the <see cref="F:System.Globalization.NumberStyles.Integer" /> style. </param>
       </Docs>
@@ -499,10 +541,6 @@ public static void Main() {
         <Parameter Name="style" Type="System.Globalization.NumberStyles" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Byte" /> value obtained from <paramref name="s" />
-.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s " />is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -716,6 +754,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified style to its <see cref="T:System.Byte" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte value that is equivalent to the number contained in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a number to convert. The string is interpreted using the style specified by <paramref name="style" />. </param>
         <param name="style">
@@ -741,10 +783,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Byte" /> value obtained from <paramref name="s" />
-.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s " />is a null reference.</exception>
         <exception cref="T:System.OverflowException">
@@ -803,6 +841,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified culture-specific format to its <see cref="T:System.Byte" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte value that is equivalent to the number contained in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a number to convert. The string is interpreted using the <see cref="F:System.Globalization.NumberStyles.Integer" /> style. </param>
         <param name="provider">
@@ -829,10 +871,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Byte" /> value obtained from <paramref name="s" />
-.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s " />is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -1048,6 +1086,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified style and culture-specific format to its <see cref="T:System.Byte" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A byte value that is equivalent to the number contained in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a number to convert. The string is interpreted using the style specified by <paramref name="style" />. </param>
         <param name="style">
@@ -1073,7 +1115,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Byte" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToBoolean(System.Byte)" /> method.</para>
@@ -1082,6 +1123,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToBoolean(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of the current instance is not zero; otherwise, false.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1102,7 +1147,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Byte" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. </para>
@@ -1111,6 +1155,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToByte(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, unchanged.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1131,7 +1179,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Byte" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToChar(System.Byte)" /> method.</para>
@@ -1140,6 +1187,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToChar(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Char" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1160,12 +1211,15 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to use this method throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1186,7 +1240,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Byte" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToDecimal(System.Byte)" /> method.</para>
@@ -1195,6 +1248,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToDecimal(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Decimal" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1215,7 +1272,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Byte" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToDouble(System.Byte)" /> method.</para>
@@ -1224,6 +1280,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToDouble(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Double" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1244,7 +1304,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Byte" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt16(System.Byte)" /> method.</para>
@@ -1253,6 +1312,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt16(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.Int16" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1273,7 +1336,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Byte" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt32(System.Byte)" /> method.</para>
@@ -1282,6 +1344,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt32(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.Int32" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1302,7 +1368,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Byte" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt64(System.Byte)" /> method.</para>
@@ -1311,6 +1376,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt64(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.Int64" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1331,7 +1400,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Byte" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToSByte(System.Byte)" /> method.</para>
@@ -1340,6 +1408,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToSByte(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.SByte" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1360,7 +1432,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Byte" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToSingle(System.Byte)" /> method.</para>
@@ -1369,6 +1440,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToSingle(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Single" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1391,7 +1466,6 @@ public static void Main() {
       </Parameters>
       <Docs>
         <param name="targetType">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Byte" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the static (Shared in Visual Basic) <see cref="M:System.Convert.ChangeType(System.Object,System.Type,System.IFormatProvider)" /> method instead.</para>
@@ -1400,6 +1474,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToType(System.Type,System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to <paramref name="type" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> implementation that supplies information about the format of the returned value.</param>
       </Docs>
@@ -1420,7 +1498,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Byte" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt16(System.Byte)" /> method.</para>
@@ -1429,6 +1506,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt16(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.UInt16" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1449,7 +1530,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Byte" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt32(System.Byte)" /> method.</para>
@@ -1458,6 +1538,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt32(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.UInt32" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1478,7 +1562,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Byte" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt64(System.Byte)" /> method.</para>
@@ -1487,6 +1570,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt64(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.UInt64" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1506,11 +1593,6 @@ public static void Main() {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current
-   instance formatted using the general format specifier ("G"). The string takes into account the current
-   system culture.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is formatted with the general numeric format specifier ("G") and the <see cref="T:System.Globalization.NumberFormatInfo" /> object for the thread current culture. To define the formatting of the <see cref="T:System.Byte" /> value's string representation, call the <see cref="M:System.Byte.ToString(System.String)" /> method. To define both the format specifiers and culture used to create the string representation of a <see cref="T:System.Byte" /> value, call the <see cref="M:System.Byte.ToString(System.String,System.IFormatProvider)" /> method.</para>
@@ -1529,6 +1611,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current <see cref="T:System.Byte" /> object to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this object, which consists of a sequence of digits that range from 0 to 9 with no leading zeroes.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1549,11 +1635,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted using
-   the general format specifier, ("G"). The string takes into account the
-   information in the <see cref="T:System.Globalization.NumberFormatInfo" /> instance supplied by <paramref name="provider" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is formatted with the general numeric format specifier ("G").</para>
@@ -1584,6 +1665,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of the current <see cref="T:System.Byte" /> object to its equivalent string representation using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this object in the format specified by the <paramref name="provider" /> parameter.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information.</param>
       </Docs>
@@ -1606,11 +1691,6 @@ public static void Main() {
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted as
-   specified by <paramref name="format" />. The string takes into account the current system
-   culture.</para>
-        </returns>
         <exception cref="T:System.FormatException">
           <paramref name="format" /> is invalid.</exception>
         <example>
@@ -1657,6 +1737,10 @@ public class ByteToStringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current <see cref="T:System.Byte" /> object to its equivalent string representation using the specified format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the current <see cref="T:System.Byte" /> object, formatted as specified by the <paramref name="format" /> parameter.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A numeric format string.</param>
       </Docs>
@@ -1680,11 +1764,6 @@ public class ByteToStringExample {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted as
-   specified by <paramref name="format" />. The string takes into account the information in
-   the <see cref="T:System.Globalization.NumberFormatInfo" /> instance supplied by <paramref name="provider" />.</para>
-        </returns>
         <exception cref="T:System.FormatException">
           <paramref name="format" /> is invalid.</exception>
         <param name="format">
@@ -1722,6 +1801,10 @@ public class ByteToStringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current <see cref="T:System.Byte" /> object to its equivalent string representation using the specified format and culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the current <see cref="T:System.Byte" /> object, formatted as specified by the <paramref name="format" /> and <paramref name="provider" /> parameters.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A standard or custom numeric format string.</param>
         <param name="provider">
diff --git a/mcs/class/corlib/Documentation/en/System/Char.xml b/mcs/class/corlib/Documentation/en/System/Char.xml
index c6abb4bd0fd..c577dcbfd95 100644
--- a/mcs/class/corlib/Documentation/en/System/Char.xml
+++ b/mcs/class/corlib/Documentation/en/System/Char.xml
@@ -196,27 +196,6 @@
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="value" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> A negative number</term>
-              <description>Current instance &lt; <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> Zero</term>
-              <description>Current instance == <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> A positive number</term>
-              <description>Current instance &gt; <paramref name="value" />.</description>
-            </item>
-          </list>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -230,6 +209,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this instance to a specified <see cref="T:System.Char" /> object and indicates whether this instance precedes, follows, or appears in the same position in the sort order as the specified <see cref="T:System.Char" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number indicating the position of this instance in the sort order in relation to the <paramref name="value" /> parameter.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance precedes <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance has the same position in the sort order as <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance follows <paramref name="value" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Char" /> object to compare. </param>
       </Docs>
@@ -251,42 +270,61 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="value" /> is not a <see cref="T:System.Char" /> and is not a null reference.</exception>
+        <remarks>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="M:System.Char.CompareTo(System.Object)" /> method implements the <see cref="T:System.IComparable" /> interface. </para>
+          <para>The <paramref name="value" /> parameter must be null or an instance of <see cref="T:System.Char" />; otherwise, an exception is thrown.</para>
+          <para>The comparison performed by this method is based on the encoded values of this instance and <paramref name="value" />, not necessarily their lexicographical characteristics. Any instance of <see cref="T:System.Char" />, regardless of its value, is considered greater than null.</para>
+        </remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Compares this instance to a specified object and indicates whether this instance precedes, follows, or appears in the same position in the sort order as the specified <see cref="T:System.Object" />.</para>
+        </summary>
         <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="value" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number indicating the position of this instance in the sort order in relation to the <paramref name="value" /> parameter.</para>
           <list type="table">
             <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
             </listheader>
             <item>
-              <term> A negative number</term>
-              <description>Current instance &lt; <paramref name="value" />.</description>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance precedes <paramref name="value" />. </para>
+              </description>
             </item>
             <item>
-              <term> Zero</term>
-              <description>Current instance == <paramref name="value" />.</description>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance has the same position in the sort order as <paramref name="value" />. </para>
+              </description>
             </item>
             <item>
-              <term> A positive number</term>
+              <term>
+                <para>Greater than zero </para>
+              </term>
               <description>
-                <para>Current instance &gt; <paramref name="value" />, or
-<paramref name="value" /> is a null reference.</para>
+                <para>This instance follows <paramref name="value" />.</para>
+                <para>-or- </para>
+                <para>
+                  <paramref name="value" /> is null. </para>
               </description>
             </item>
           </list>
         </returns>
-        <exception cref="T:System.ArgumentException">
-          <paramref name="value" /> is not a <see cref="T:System.Char" /> and is not a null reference.</exception>
-        <remarks>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>The <see cref="M:System.Char.CompareTo(System.Object)" /> method implements the <see cref="T:System.IComparable" /> interface. </para>
-          <para>The <paramref name="value" /> parameter must be null or an instance of <see cref="T:System.Char" />; otherwise, an exception is thrown.</para>
-          <para>The comparison performed by this method is based on the encoded values of this instance and <paramref name="value" />, not necessarily their lexicographical characteristics. Any instance of <see cref="T:System.Char" />, regardless of its value, is considered greater than null.</para>
-        </remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Compares this instance to a specified object and indicates whether this instance precedes, follows, or appears in the same position in the sort order as the specified <see cref="T:System.Object" />.</para>
-        </summary>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare this instance to, or null. </param>
       </Docs>
@@ -307,7 +345,6 @@
         <Parameter Name="utf32" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -318,6 +355,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified Unicode code point into a UTF-16 encoded string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string consisting of one <see cref="T:System.Char" /> object or a surrogate pair of <see cref="T:System.Char" /> objects equivalent to the code point specified by the <paramref name="utf32" /> parameter.</para>
+        </returns>
         <param name="utf32">
           <attribution license="cc4" from="Microsoft" modified="false" />A 21-bit Unicode code point. </param>
       </Docs>
@@ -338,7 +379,6 @@
         <Parameter Name="lowSurrogate" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -349,6 +389,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of a UTF-16 encoded surrogate pair into a Unicode code point.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 21-bit Unicode code point represented by the <paramref name="highSurrogate" /> and <paramref name="lowSurrogate" /> parameters.</para>
+        </returns>
         <param name="highSurrogate">
           <attribution license="cc4" from="Microsoft" modified="false" />A high surrogate code unit (that is, a code unit ranging from U+D800 through U+DBFF). </param>
         <param name="lowSurrogate">
@@ -371,7 +415,6 @@
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -381,6 +424,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of a UTF-16 encoded character or surrogate pair at a specified position in a string into a Unicode code point.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 21-bit Unicode code point represented by the character or surrogate pair at the position in the <paramref name="s" /> parameter specified by the <paramref name="index" /> parameter.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a character or surrogate pair. </param>
         <param name="index">
@@ -402,11 +449,6 @@
         <Parameter Name="obj" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> represents the 
- same value as the current instance; otherwise, <see langword="false" />.</para>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -416,6 +458,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether this instance is equal to the specified <see cref="T:System.Char" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="obj" /> parameter equals the value of this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare to this instance. </param>
       </Docs>
@@ -437,12 +483,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> represents the 
- same type and value as the current instance. If <paramref name="obj" /> is a null reference
- or is not an instance of <see cref="T:System.Char" />, returns <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The comparison performed by this method is based on the encoded values of this instance and <paramref name="obj" />, not necessarily their lexicographical characteristics.</para>
@@ -451,6 +491,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is an instance of <see cref="T:System.Char" /> and equals the value of this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance or null. </param>
       </Docs>
@@ -471,9 +515,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> value containing a hash code for the current instance.</para>
-        </returns>
         <remarks>
           <para> The algorithm used to
       generate the hash code is unspecified.</para>
@@ -486,6 +527,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -506,11 +551,6 @@
         <Parameter Name="c" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Double" /> representing the numeric value associated with
-<paramref name="c" /> if and only if <paramref name="c" /> has an associated numeric value;
-   otherwise, -1.0.</para>
-        </returns>
         <example>
           <para>The following example demonstrates the <see cref="M:System.Char.GetNumericValue(System.Char)" /> 
 method.</para>
@@ -547,6 +587,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified numeric Unicode character to a double-precision floating point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The numeric value of <paramref name="c" /> if that character represents a number; otherwise, -1.0.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to convert. </param>
       </Docs>
@@ -571,12 +615,6 @@ public static void Main() {
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Double" /> representing the numeric value associated with the
-<see cref="T:System.Char" /> at position 
-<paramref name="index" /> in <paramref name="s" /> if and only if that <see cref="T:System.Char" />
-has an associated numeric value; otherwise, -1.0.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s " />is a null reference.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">The value of <paramref name="index" /> is less than zero, or greater than or equal to the length of <paramref name="s" />.</exception>
@@ -594,6 +632,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric Unicode character at the specified position in a specified string to a double-precision floating point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The numeric value of the character at position <paramref name="index" /> in <paramref name="s" /> if that character represents a number; otherwise, -1.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" />. </param>
         <param name="index">
@@ -616,12 +658,15 @@ has an associated numeric value; otherwise, -1.0.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.TypeCode" /> for value type <see cref="T:System.Char" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The enumerated constant, <see cref="F:System.TypeCode.Char" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetUnicodeCategory">
@@ -641,9 +686,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="c" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Globalization.UnicodeCategory" /> of <paramref name="c" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Char.GetUnicodeCategory(System.Char)" /> method does not always return the same <see cref="T:System.Globalization.UnicodeCategory" /> value as the <see cref="M:System.Globalization.CharUnicodeInfo.GetUnicodeCategory(System.Char)" /> method when it is passed a particular character as a parameter. The <see cref="M:System.Globalization.CharUnicodeInfo.GetUnicodeCategory(System.Char)" /> method is designed to reflect the current version of the Unicode standard. In contrast, although the <see cref="M:System.Char.GetUnicodeCategory(System.Char)" /> method usually reflects the current version of the Unicode standard, it may return a character's category based on a previous version of the standard or it may return a category that differs from the current standard in order to preserve backward compatibility. As a result, we recommend that you use the <see cref="M:System.Globalization.CharUnicodeInfo.GetUnicodeCategory(System.Char)" /> method instead of <see cref="M:System.Char.GetUnicodeCategory(System.Char)" />.</para>
@@ -652,6 +694,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Categorizes a specified Unicode character into a group identified by one of the <see cref="T:System.Globalization.UnicodeCategory" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Globalization.UnicodeCategory" /> value that identifies the group that contains <paramref name="c" />.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to categorize. </param>
       </Docs>
@@ -675,9 +721,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Globalization.UnicodeCategory" /> of the <see cref="T:System.Char" /> at position index in <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s " />is a null reference.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">The value of <paramref name="index" /> is less than zero, or greater than or equal to the length of <paramref name="s" />.</exception>
@@ -690,6 +733,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Categorizes the character at the specified position in a specified string into a group identified by one of the <see cref="T:System.Globalization.UnicodeCategory" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Globalization.UnicodeCategory" /> enumerated constant that identifies the group that contains the character at position <paramref name="index" /> in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.String" />. </param>
         <param name="index">
@@ -714,11 +761,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="c" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>true if <paramref name="c" /> is a member of the following category
-   in <see cref="T:System.Globalization.UnicodeCategory" />: <see cref="F:System.Globalization.UnicodeCategory.Control" />; otherwise,
-<see langword="false" />. </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Control characters are formatting and other non-printing characters, such as ACK, BEL, CR, FF, LF, and VT. T The Unicode standard assigns code points from \U0000 to \U001F, \U007F, and from \U0080 to \U009F to control characters. According to the Unicode standard, these values are to be interpreted as control characters unless their use is otherwise defined by an application. Valid control characters are members of the <see cref="F:System.Globalization.UnicodeCategory.Control" /> category. </para>
@@ -727,6 +769,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified Unicode character is categorized as a control character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="c" /> is a control character; otherwise, false.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to evaluate. </param>
       </Docs>
@@ -750,12 +796,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the character at position
-<paramref name="index" /> in <paramref name="s" /> is a member of the following category in <see cref="T:System.Globalization.UnicodeCategory" />: <see cref="F:System.Globalization.UnicodeCategory.Control" />; otherwise, 
-<see langword="false" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s " />is a null reference.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">The value of <paramref name="index" /> is less than zero, or greater than or equal to the length of <paramref name="s" />.</exception>
@@ -770,6 +810,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the character at the specified position in a specified string is categorized as a control character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character at position <paramref name="index" /> in <paramref name="s" /> is a control character; otherwise, false.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string. </param>
         <param name="index">
@@ -794,11 +838,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="c" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="c" /> is a member of the
-   following category in <see cref="T:System.Globalization.UnicodeCategory" />: <see cref="F:System.Globalization.UnicodeCategory.DecimalDigitNumber" />; otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method determines whether a <see cref="T:System.Char" /> is a radix-10 digit. This contrasts with <see cref="M:System.Char.IsNumber(System.Char)" />, which determines whether a Char is of any numeric Unicode category. Numbers include characters such as fractions, subscripts, superscripts, Roman numerals, currency numerators, encircled numbers, and script-specific digits.</para>
@@ -808,6 +847,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified Unicode character is categorized as a decimal digit.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="c" /> is a decimal digit; otherwise, false.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to evaluate. </param>
       </Docs>
@@ -831,12 +874,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the character at position
-<paramref name="index" /> in <paramref name="s" /> is a member of the following category in <see cref="T:System.Globalization.UnicodeCategory" />: <see cref="F:System.Globalization.UnicodeCategory.DecimalDigitNumber" />; otherwise, 
-<see langword="false" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s " />is a null reference.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">The value of <paramref name="index" /> is less than zero, or greater than or equal to the length of <paramref name="s" />.</exception>
@@ -852,6 +889,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the character at the specified position in a specified string is categorized as a decimal digit.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character at position <paramref name="index" /> in <paramref name="s" /> is a decimal digit; otherwise, false.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string. </param>
         <param name="index">
@@ -874,7 +915,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="c" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -884,6 +924,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified <see cref="T:System.Char" /> object is a high surrogate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the numeric value of the <paramref name="c" /> parameter ranges from U+D800 through U+DBFF; otherwise, false.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to evaluate. </param>
       </Docs>
@@ -904,7 +948,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -915,6 +958,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the <see cref="T:System.Char" /> object at the specified position in a string is a high surrogate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the numeric value of the specified character in the <paramref name="s" /> parameter ranges from U+D800 through U+DBFF; otherwise, false.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string. </param>
         <param name="index">
@@ -938,12 +985,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="c" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="c" /> is a member of one
-   of the following categories in <see cref="T:System.Globalization.UnicodeCategory" />: <see cref="F:System.Globalization.UnicodeCategory.UppercaseLetter" />, <see cref="F:System.Globalization.UnicodeCategory.LowercaseLetter" />, <see cref="F:System.Globalization.UnicodeCategory.TitlecaseLetter" />, <see cref="F:System.Globalization.UnicodeCategory.ModifierLetter" />, or <see cref="F:System.Globalization.UnicodeCategory.OtherLetter" />; otherwise,
-<see langword="false" />. </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method determines whether a <see cref="T:System.Char" /> is a member of any category of Unicode letter. Unicode letters include the following:</para>
@@ -969,6 +1010,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified Unicode character is categorized as a Unicode letter. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="c" /> is a letter; otherwise, false.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to evaluate. </param>
       </Docs>
@@ -992,12 +1037,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the character at position
-<paramref name="index" /> in <paramref name="s" /> is a member of one of the following categories in 
-<see cref="T:System.Globalization.UnicodeCategory" />: <see cref="F:System.Globalization.UnicodeCategory.UppercaseLetter" />, <see cref="F:System.Globalization.UnicodeCategory.LowercaseLetter" />, <see cref="F:System.Globalization.UnicodeCategory.TitlecaseLetter" />, <see cref="F:System.Globalization.UnicodeCategory.ModifierLetter" />, or <see cref="F:System.Globalization.UnicodeCategory.OtherLetter" />; otherwise, <see langword="false" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s " />is a null reference.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">The value of <paramref name="index" /> is less than zero, or greater than or equal to the length of <paramref name="s" />.</exception>
@@ -1029,6 +1068,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the character at the specified position in a specified string is categorized as a Unicode letter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character at position <paramref name="index" /> in <paramref name="s" /> is a letter; otherwise, false.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string. </param>
         <param name="index">
@@ -1053,11 +1096,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="c" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="c" /> is a member of one
-   of the following categories in <see cref="T:System.Globalization.UnicodeCategory" />: <see cref="F:System.Globalization.UnicodeCategory.UppercaseLetter" />, <see cref="F:System.Globalization.UnicodeCategory.LowercaseLetter" />, <see cref="F:System.Globalization.UnicodeCategory.TitlecaseLetter" />, <see cref="F:System.Globalization.UnicodeCategory.ModifierLetter" />, <see cref="F:System.Globalization.UnicodeCategory.OtherLetter" />, or <see cref="F:System.Globalization.UnicodeCategory.DecimalDigitNumber" />; otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Valid letters and decimal digits are members of the following categories in <see cref="T:System.Globalization.UnicodeCategory" />: UppercaseLetter, LowercaseLetter, TitlecaseLetter, ModifierLetter, OtherLetter, or DecimalDigitNumber.</para>
@@ -1066,6 +1104,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified Unicode character is categorized as a letter or a decimal digit.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="c" /> is a letter or a decimal digit; otherwise, false.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to evaluate. </param>
       </Docs>
@@ -1089,16 +1131,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the character at position
-<paramref name="index" /> in <paramref name="s" /> is a member of one of the following categories in 
-<see cref="T:System.Globalization.UnicodeCategory" />: <see cref="F:System.Globalization.UnicodeCategory.UppercaseLetter" />, <see cref="F:System.Globalization.UnicodeCategory.LowercaseLetter" />, <see cref="F:System.Globalization.UnicodeCategory.TitlecaseLetter" />, <see cref="F:System.Globalization.UnicodeCategory.ModifierLetter" />, <see cref="F:System.Globalization.UnicodeCategory.OtherLetter" />, or <see cref="F:System.Globalization.UnicodeCategory.DecimalDigitNumber" />; otherwise, 
-<see langword="false" />. </para>
-          <para>
-            <see langword="" />
-          </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s " />is a null reference.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">The value of <paramref name="index" /> is less than zero, or greater than or equal to the length of <paramref name="s" />.</exception>
@@ -1113,6 +1145,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the character at the specified position in a specified string is categorized as a letter or a decimal digit.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character at position <paramref name="index" /> in <paramref name="s" /> is a letter or a decimal digit; otherwise, false.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string. </param>
         <param name="index">
@@ -1137,12 +1173,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="c" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="c" /> is a member of the
-   following category in <see cref="T:System.Globalization.UnicodeCategory" />: <see cref="F:System.Globalization.UnicodeCategory.LowercaseLetter" />; otherwise, <see langword="false" />.
-   </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Valid lowercase letters are members of the following category in <see cref="T:System.Globalization.UnicodeCategory" />: LowercaseLetter.</para>
@@ -1151,6 +1181,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified Unicode character is categorized as a lowercase letter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="c" /> is a lowercase letter; otherwise, false.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to evaluate. </param>
       </Docs>
@@ -1174,13 +1208,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the character at position
-<paramref name="index" /> in <paramref name="s" /> is a member of the following category 
-   in <see cref="T:System.Globalization.UnicodeCategory" />:<see cref="F:System.Globalization.UnicodeCategory.LowercaseLetter" />;
-   otherwise, <see langword="false" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s " />is a null reference.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">The value of <paramref name="index" /> is less than zero, or greater than or equal to the length of <paramref name="s" />.</exception>
@@ -1195,6 +1222,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the character at the specified position in a specified string is categorized as a lowercase letter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character at position <paramref name="index" /> in <paramref name="s" /> is a lowercase letter; otherwise, false.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string. </param>
         <param name="index">
@@ -1217,7 +1248,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="c" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1227,6 +1257,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified <see cref="T:System.Char" /> object is a low surrogate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the numeric value of the <paramref name="c" /> parameter ranges from U+DC00 through U+DFFF; otherwise, false.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to evaluate. </param>
       </Docs>
@@ -1247,7 +1281,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1258,6 +1291,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the <see cref="T:System.Char" /> object at the specified position in a string is a low surrogate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the numeric value of the specified character in the <paramref name="s" /> parameter ranges from U+DC00 through U+DFFF; otherwise, false.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string. </param>
         <param name="index">
@@ -1281,12 +1318,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="c" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="c" /> is a member of one
-   of the following categories in <see cref="T:System.Globalization.UnicodeCategory" />: <see cref="F:System.Globalization.UnicodeCategory.DecimalDigitNumber" />, <see cref="F:System.Globalization.UnicodeCategory.LetterNumber" />, or <see cref="F:System.Globalization.UnicodeCategory.OtherNumber" />; otherwise,
-<see langword="false" />. </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method determines whether a <see cref="T:System.Char" /> is of any numeric Unicode category. In addition to including digits, numbers include characters, fractions, subscripts, superscripts, Roman numerals, currency numerators, and encircled numbers. This method contrasts with the <see cref="M:System.Char.IsDigit(System.Char)" /> method, which determines whether a <see cref="T:System.Char" /> is a radix-10 digit.</para>
@@ -1298,6 +1329,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified Unicode character is categorized as a number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="c" /> is a number; otherwise, false.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to evaluate. </param>
       </Docs>
@@ -1321,13 +1356,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the
-   character at position <paramref name="index" /> in <paramref name="s" /> is a member of one of the
-   following categories in <see cref="T:System.Globalization.UnicodeCategory" />: <see cref="F:System.Globalization.UnicodeCategory.DecimalDigitNumber" />, <see cref="F:System.Globalization.UnicodeCategory.LetterNumber" />, or <see cref="F:System.Globalization.UnicodeCategory.OtherNumber" />; otherwise, <see langword="false" />
-   . </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s " />is a null reference.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">The value of <paramref name="index" /> is less than zero, or greater than or equal to the length of <paramref name="s" />.</exception>
@@ -1345,6 +1373,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the character at the specified position in a specified string is categorized as a number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character at position <paramref name="index" /> in <paramref name="s" /> is a number; otherwise, false.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string. </param>
         <param name="index">
@@ -1369,12 +1401,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="c" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="c" /> is a member of one
-   of the following categories in <see cref="T:System.Globalization.UnicodeCategory" />: <see cref="F:System.Globalization.UnicodeCategory.ConnectorPunctuation" />, <see cref="F:System.Globalization.UnicodeCategory.DashPunctuation" />, <see cref="F:System.Globalization.UnicodeCategory.OpenPunctuation" />, <see cref="F:System.Globalization.UnicodeCategory.ClosePunctuation" />, <see cref="F:System.Globalization.UnicodeCategory.InitialQuotePunctuation" />, <see cref="F:System.Globalization.UnicodeCategory.FinalQuotePunctuation" />, or <see cref="F:System.Globalization.UnicodeCategory.OtherPunctuation" />;
-   otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Valid punctuation marks are members of the following categories in <see cref="T:System.Globalization.UnicodeCategory" />: ConnectorPunctuation, DashPunctuation, OpenPunctuation, ClosePunctuation, InititalQuotePunctuation, FinalQuotePunctuation, or OtherPunctuation. They include characters with the Unicode code points listed in the following table. </para>
@@ -1721,6 +1747,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified Unicode character is categorized as a punctuation mark.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="c" /> is a punctuation mark; otherwise, false.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to evaluate. </param>
       </Docs>
@@ -1744,14 +1774,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the character at position
-<paramref name="index" /> in <paramref name="s" /> is a
-   member of one of the following categories in <see cref="T:System.Globalization.UnicodeCategory" />: <see cref="F:System.Globalization.UnicodeCategory.ConnectorPunctuation" />, <see cref="F:System.Globalization.UnicodeCategory.DashPunctuation" />, <see cref="F:System.Globalization.UnicodeCategory.OpenPunctuation" />, <see cref="F:System.Globalization.UnicodeCategory.ClosePunctuation" />, <see cref="F:System.Globalization.UnicodeCategory.InitialQuotePunctuation" />, <see cref="F:System.Globalization.UnicodeCategory.FinalQuotePunctuation" />, or <see cref="F:System.Globalization.UnicodeCategory.OtherPunctuation" />;
-   otherwise, <see langword="false" />.
-   </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s " />is a null reference.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">The value of <paramref name="index" /> is less than zero, or greater than or equal to the length of <paramref name="s" />.</exception>
@@ -2104,6 +2126,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the character at the specified position in a specified string is categorized as a punctuation mark.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character at position <paramref name="index" /> in <paramref name="s" /> is a punctuation mark; otherwise, false.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string. </param>
         <param name="index">
@@ -2128,12 +2154,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="c" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="c" /> is a member of one
-   of the following categories in <see cref="T:System.Globalization.UnicodeCategory" />: <see cref="F:System.Globalization.UnicodeCategory.SpaceSeparator" />, <see cref="F:System.Globalization.UnicodeCategory.LineSeparator" />, or <see cref="F:System.Globalization.UnicodeCategory.ParagraphSeparator" />;
-   otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The Unicode standard recognizes three subcategories of separators: </para>
@@ -2156,6 +2176,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified Unicode character is categorized as a separator character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="c" /> is a separator character; otherwise, false.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to evaluate. </param>
       </Docs>
@@ -2179,13 +2203,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the character at position
-<paramref name="index" /> in <paramref name="s" /> is a member of one of the following categories in 
-<see cref="T:System.Globalization.UnicodeCategory" />: <see cref="F:System.Globalization.UnicodeCategory.SpaceSeparator" />, <see cref="F:System.Globalization.UnicodeCategory.LineSeparator" />, or <see cref="F:System.Globalization.UnicodeCategory.ParagraphSeparator" />; 
-   otherwise, <see langword="false" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s " />is a null reference.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">The value of <paramref name="index" /> is less than zero, or greater than or equal to the length of <paramref name="s" />.</exception>
@@ -2214,6 +2231,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the character at the specified position in a specified string is categorized as a separator character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character at position <paramref name="index" /> in <paramref name="s" /> is a separator character; otherwise, false.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string. </param>
         <param name="index">
@@ -2238,12 +2259,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="c" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="c" /> is a member of the
-   following category in <see cref="T:System.Globalization.UnicodeCategory" />: <see cref="F:System.Globalization.UnicodeCategory.Surrogate" />; otherwise,
-<see langword="false" />. </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A surrogate is a <see cref="T:System.Char" /> object with a UTF-16 code unit in the range from U+D800 to U+DFFF. Each character with a code unit in this range belongs to the <see cref="F:System.Globalization.UnicodeCategory.Surrogate" /> category. The individual surrogate code unit has no interpretation of its own, but has meaning only when used as part of a surrogate pair. For more information about surrogate pairs, see the Unicode Standard at the <see cref="http://go.microsoft.com/fwlink/?linkid=37123">Unicode home page</see>.</para>
@@ -2252,6 +2267,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified character has a surrogate code unit.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="c" /> is either a high surrogate or a low surrogate; otherwise, false.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to evaluate. </param>
       </Docs>
@@ -2275,12 +2294,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the character at position
-<paramref name="index" /> in <paramref name="s" /> is a member of the following category in <see cref="T:System.Globalization.UnicodeCategory" />: <see cref="F:System.Globalization.UnicodeCategory.Surrogate" />; otherwise, 
-<see langword="false" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s " />is a null reference.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">The value of <paramref name="index" /> is less than zero, or greater than or equal to the length of <paramref name="s" />.</exception>
@@ -2295,6 +2308,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the character at the specified position in a specified string has a surrogate code unit.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character at position <paramref name="index" /> in <paramref name="s" /> is a either a high surrogate or a low surrogate; otherwise, false.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string. </param>
         <param name="index">
@@ -2318,7 +2335,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="lowSurrogate" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2328,6 +2344,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the two specified <see cref="T:System.Char" /> objects form a surrogate pair.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the numeric value of the <paramref name="highSurrogate" /> parameter ranges from U+D800 through U+DBFF, and the numeric value of the <paramref name="lowSurrogate" /> parameter ranges from U+DC00 through U+DFFF; otherwise, false.</para>
+        </returns>
         <param name="highSurrogate">
           <attribution license="cc4" from="Microsoft" modified="false" />The character to evaluate as the high surrogate of a surrogate pair. </param>
         <param name="lowSurrogate">
@@ -2350,7 +2370,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2360,6 +2379,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two adjacent <see cref="T:System.Char" /> objects at a specified position in a string form a surrogate pair.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="s" /> parameter includes adjacent characters at positions <paramref name="index" /> and <paramref name="index" /> + 1, and the numeric value of the character at position <paramref name="index" /> ranges from U+D800 through U+DBFF, and the numeric value of the character at position <paramref name="index" />+1 ranges from U+DC00 through U+DFFF; otherwise, false.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string. </param>
         <param name="index">
@@ -2383,12 +2406,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="c" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="c" /> is a member of one
-   of the following categories in <see cref="T:System.Globalization.UnicodeCategory" />: <see cref="F:System.Globalization.UnicodeCategory.MathSymbol" />, <see cref="F:System.Globalization.UnicodeCategory.CurrencySymbol" />, <see cref="F:System.Globalization.UnicodeCategory.ModifierSymbol" />, or <see cref="F:System.Globalization.UnicodeCategory.OtherSymbol" />; otherwise, <see langword="false" />.
-   </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Valid symbols are members of the following categories in <see cref="T:System.Globalization.UnicodeCategory" />: MathSymbol, CurrencySymbol, ModifierSymbol, and OtherSymbol.</para>
@@ -2424,6 +2441,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified Unicode character is categorized as a symbol character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="c" /> is a symbol character; otherwise, false.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to evaluate. </param>
       </Docs>
@@ -2447,13 +2468,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the character at position
-<paramref name="index" /> in <paramref name="s" /> is a member of one of the following categories in 
-<see cref="T:System.Globalization.UnicodeCategory" />: <see cref="F:System.Globalization.UnicodeCategory.MathSymbol" />, <see cref="F:System.Globalization.UnicodeCategory.CurrencySymbol" />, <see cref="F:System.Globalization.UnicodeCategory.ModifierSymbol" />, or <see cref="F:System.Globalization.UnicodeCategory.OtherSymbol" />; otherwise, <see langword="false" />.
-   </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s " />is a null reference.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">The value of <paramref name="index" /> is less than zero, or greater than or equal to the length of <paramref name="s" />.</exception>
@@ -2495,6 +2509,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the character at the specified position in a specified string is categorized as a symbol character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character at position <paramref name="index" /> in <paramref name="s" /> is a symbol character; otherwise, false.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string. </param>
         <param name="index">
@@ -2519,13 +2537,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="c" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="c" /> is a member of the
-   following category in <see cref="T:System.Globalization.UnicodeCategory" />: <see cref="F:System.Globalization.UnicodeCategory.UppercaseLetter" />;
-   otherwise, <see langword="false" />.
-   </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Valid uppercase letters are members of the following category in <see cref="T:System.Globalization.UnicodeCategory" />: UppercaseLetter.</para>
@@ -2534,6 +2545,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified Unicode character is categorized as an uppercase letter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="c" /> is an uppercase letter; otherwise, false.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to evaluate. </param>
       </Docs>
@@ -2557,12 +2572,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the character at position
-<paramref name="index" /> in <paramref name="s" /> is a member of the following category in <see cref="T:System.Globalization.UnicodeCategory" />: <see cref="F:System.Globalization.UnicodeCategory.UppercaseLetter" />; otherwise, 
-<see langword="false" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s " />is a null reference.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">The value of <paramref name="index" /> is less than zero, or greater than or equal to the length of <paramref name="s" />.</exception>
@@ -2577,6 +2586,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the character at the specified position in a specified string is categorized as an uppercase letter.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character at position <paramref name="index" /> in <paramref name="s" /> is an uppercase letter; otherwise, false.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string. </param>
         <param name="index">
@@ -2601,15 +2614,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="c" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="c" /> either has a code
-   point of 0x0009, 0x000a, 0x000b, 0x000c, 0x000d, 0x0085, 0x2028, or 0x2029; or
-   is a member of the following category in <see cref="T:System.Globalization.UnicodeCategory" />:
-<see cref="F:System.Globalization.UnicodeCategory.SpaceSeparator" />; otherwise,
-<see langword="false" />.
-   </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>White space characters are the following Unicode characters:</para>
@@ -2632,6 +2636,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified Unicode character is categorized as white space.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="c" /> is white space; otherwise, false.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to evaluate. </param>
       </Docs>
@@ -2655,15 +2663,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="index" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the character at position
-<paramref name="index" /> in <paramref name="s" /> either has a code point of 0x0009, 0x000a, 0x000b, 
-   0x000c, 0x000d, 0x0085, 0x2028, or 0x2029; or is a member of the following
-   category in <see cref="T:System.Globalization.UnicodeCategory" />:
-<see cref="F:System.Globalization.UnicodeCategory.SpaceSeparator" />;
-   otherwise, <see langword="false" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <para>
             <paramref name="s " />is a null reference.</para>
@@ -2694,6 +2693,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the character at the specified position in a specified string is categorized as white space.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the character at position <paramref name="index" /> in <paramref name="s" /> is white space; otherwise, false.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string. </param>
         <param name="index">
@@ -2772,9 +2775,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> The <see cref="T:System.Char" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s " />is a null reference.</exception>
@@ -2784,6 +2784,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified string to its equivalent Unicode character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Unicode character equivalent to the sole character in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a single character, or null. </param>
       </Docs>
@@ -2805,12 +2809,15 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Note   This conversion is not supported. Attempting to do so throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2831,7 +2838,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Char" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToByte(System.Char)" /> method instead. </para>
@@ -2840,6 +2846,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToByte(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value of the current <see cref="T:System.Char" /> object.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2860,7 +2870,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Char" /> instance is cast to an <see cref="T:System.IConvertible" /> interface.</para>
@@ -2869,6 +2878,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToChar(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current <see cref="T:System.Char" /> object unchanged.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2889,12 +2902,15 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Note   This conversion is not supported. Attempting to do so throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>No value is returned.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2915,12 +2931,15 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Note   This conversion is not supported. Attempting to do so throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>No value is returned.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2941,12 +2960,15 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Note   This conversion is not supported. Attempting to do so throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>No value is returned.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2967,7 +2989,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Char" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt16(System.Char)" /> method instead.</para>
@@ -2976,6 +2997,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para> For a description of this member, see <see cref="M:System.IConvertible.ToInt16(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value of the current <see cref="T:System.Char" /> object.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2996,7 +3021,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Char" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt32(System.Char)" /> method instead.</para>
@@ -3005,6 +3029,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt32(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value of the current <see cref="T:System.Char" /> object.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -3025,7 +3053,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Char" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt64(System.Char)" /> method instead.</para>
@@ -3034,6 +3061,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para> For a description of this member, see <see cref="M:System.IConvertible.ToInt64(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value of the current <see cref="T:System.Char" /> object.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -3054,7 +3085,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Char" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToSByte(System.Char)" /> method instead.</para>
@@ -3063,6 +3093,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para> For a description of this member, see <see cref="M:System.IConvertible.ToSByte(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value of the current <see cref="T:System.Char" /> object.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -3083,12 +3117,15 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Note   This conversion is not supported. Attempting to do so throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>No value is returned.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -3111,7 +3148,6 @@ has an associated numeric value; otherwise, -1.0.</para>
       </Parameters>
       <Docs>
         <param name="targetType">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Char" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ChangeType(System.Object,System.Type,System.IFormatProvider)" /> method instead.</para>
@@ -3120,6 +3156,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToType(System.Type,System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object of the specified type.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> object. </param>
       </Docs>
@@ -3140,7 +3180,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Char" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt16(System.Char)" /> method instead.</para>
@@ -3149,6 +3188,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt16(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value of the current <see cref="T:System.Char" /> object.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> object. (Specify null because the <paramref name="provider" /> parameter is ignored.)</param>
       </Docs>
@@ -3169,7 +3212,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Char" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt32(System.Char)" /> method instead.</para>
@@ -3178,6 +3220,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt32(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value of the current <see cref="T:System.Char" /> object.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> object. (Specify null because the <paramref name="provider" /> parameter is ignored.)</param>
       </Docs>
@@ -3198,7 +3244,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Char" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt64(System.Char)" /> method instead.</para>
@@ -3207,6 +3252,10 @@ has an associated numeric value; otherwise, -1.0.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt64(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value of the current <see cref="T:System.Char" /> object.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> object. (Specify null because the <paramref name="provider" /> parameter is ignored.)</param>
       </Docs>
@@ -3228,11 +3277,6 @@ has an associated numeric value; otherwise, -1.0.</para>
         <Parameter Name="c" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The lowercase equivalent of <paramref name="c" />, or the value of
-<paramref name="c" /> if and only if <paramref name="c" /> is already lowercase or does not have a 
-   lowercase equivalent.</para>
-        </returns>
         <example>
           <para>The following example demonstrates the <see cref="M:System.Char.ToLower(System.Char,System.Globalization.CultureInfo)" /> method.</para>
           <code lang="C#">using System;
@@ -3262,6 +3306,10 @@ public class CharToLower {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of a Unicode character to its lowercase equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The lowercase equivalent of <paramref name="c" />, or the unchanged value of <paramref name="c" />, if <paramref name="c" /> is already lowercase or not alphabetic.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to convert. </param>
       </Docs>
@@ -3284,7 +3332,6 @@ public class CharToLower {
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use <see cref="M:System.String.ToLower" /> to convert a string to lowercase.</para>
@@ -3293,6 +3340,10 @@ public class CharToLower {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of a specified Unicode character to its lowercase equivalent using specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The lowercase equivalent of <paramref name="c" />, modified according to <paramref name="culture" />, or the unchanged value of <paramref name="c" />, if <paramref name="c" /> is already lowercase or not alphabetic.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to convert. </param>
         <param name="culture">
@@ -3314,7 +3365,6 @@ public class CharToLower {
         <Parameter Name="c" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3325,6 +3375,10 @@ public class CharToLower {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of a Unicode character to its lowercase equivalent using the casing rules of the invariant culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The lowercase equivalent of the <paramref name="c" /> parameter, or the unchanged value of <paramref name="c" />, if <paramref name="c" /> is already lowercase or not alphabetic.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to convert. </param>
       </Docs>
@@ -3344,10 +3398,6 @@ public class CharToLower {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" />
-representation of the current instance.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note"> This method
@@ -3358,6 +3408,10 @@ representation of the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -3377,12 +3431,15 @@ representation of the current instance.</para>
         <Parameter Name="c" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified Unicode character to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of <paramref name="c" />.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to convert. </param>
       </Docs>
@@ -3404,10 +3461,6 @@ representation of the current instance.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.String" /> representation of the value of this instance as
-   specified by <paramref name="provider" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="provider" /> parameter is ignored; it does not participate in this operation.</para>
@@ -3416,6 +3469,10 @@ representation of the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to its equivalent string representation using the specified culture-specific format information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance as specified by <paramref name="provider" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />(Reserved) An object that supplies culture-specific formatting information. </param>
       </Docs>
@@ -3438,11 +3495,6 @@ representation of the current instance.</para>
         <Parameter Name="c" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The uppercase equivalent of <paramref name="c" />, or the value of <paramref name="c" /> if and
-   only if <paramref name="c" /> is already uppercase or does not have an uppercase
-   equivalent.</para>
-        </returns>
         <example>
           <para>The following example demonstrates the <see cref="M:System.Char.ToUpper(System.Char,System.Globalization.CultureInfo)" /> method.</para>
           <code lang="C#">using System;
@@ -3473,6 +3525,10 @@ public class CharToUpper {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of a Unicode character to its uppercase equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The uppercase equivalent of <paramref name="c" />, or the unchanged value of <paramref name="c" /> if <paramref name="c" /> is already uppercase, has no uppercase equivalent, or is not alphabetic.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to convert. </param>
       </Docs>
@@ -3495,7 +3551,6 @@ public class CharToUpper {
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use <see cref="M:System.String.ToUpper" /> to convert a string to uppercase.</para>
@@ -3504,6 +3559,10 @@ public class CharToUpper {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of a specified Unicode character to its uppercase equivalent using specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The uppercase equivalent of <paramref name="c" />, modified according to <paramref name="culture" />, or the unchanged value of <paramref name="c" /> if <paramref name="c" /> is already uppercase, has no uppercase equivalent, or is not alphabetic.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to convert. </param>
         <param name="culture">
@@ -3525,7 +3584,6 @@ public class CharToUpper {
         <Parameter Name="c" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3536,6 +3594,10 @@ public class CharToUpper {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of a Unicode character to its uppercase equivalent using the casing rules of the invariant culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The uppercase equivalent of the <paramref name="c" /> parameter, or the unchanged value of <paramref name="c" />, if <paramref name="c" /> is already uppercase or not alphabetic.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to convert. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System/CharEnumerator.xml b/mcs/class/corlib/Documentation/en/System/CharEnumerator.xml
index d8d0228787a..0b39b3feae7 100644
--- a/mcs/class/corlib/Documentation/en/System/CharEnumerator.xml
+++ b/mcs/class/corlib/Documentation/en/System/CharEnumerator.xml
@@ -60,9 +60,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Object" /> with the same state as the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is a copy of this instance of <see cref="T:System.CharEnumerator" /> and its current state. This is useful for saving your state while iterating through a <see cref="T:System.String" /> object.</para>
@@ -76,6 +73,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a copy of the current <see cref="T:System.CharEnumerator" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> that is a copy of the current <see cref="T:System.CharEnumerator" /> object.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -156,11 +157,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the enumerator was successfully
-   advanced to the next element; otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="T:System.CharEnumerator" /> class maintains an internal index to the enumerated string, and the <see cref="M:System.CharEnumerator.MoveNext" /> method increments the index by one. Call <see cref="M:System.CharEnumerator.MoveNext" /> after calling <see cref="M:System.String.GetEnumerator" /> or <see cref="M:System.CharEnumerator.Reset" /> to increment the current character position to the first character in the enumerated string. Check that the return value is true to determine that the current character position is valid.</para>
@@ -171,6 +167,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Increments the internal index of the current <see cref="T:System.CharEnumerator" /> object to the next character of the enumerated string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the index is successfully incremented and within the enumerated string; otherwise, false.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System/Console.xml b/mcs/class/corlib/Documentation/en/System/Console.xml
index 2f7c940de72..b4d0eb35312 100644
--- a/mcs/class/corlib/Documentation/en/System/Console.xml
+++ b/mcs/class/corlib/Documentation/en/System/Console.xml
@@ -867,9 +867,6 @@ public class ConsoleTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A new synchronized <see cref="T:System.IO.Stream" /> object that writes to the console.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to reacquire the standard error stream after it has been changed by the <see cref="M:System.Console.SetError(System.IO.TextWriter)" /> method.</para>
@@ -878,6 +875,10 @@ public class ConsoleTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Acquires the standard error stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The standard error stream.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -898,9 +899,6 @@ public class ConsoleTest {
         <Parameter Name="bufferSize" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A new synchronized <see cref="T:System.IO.Stream" /> object that writes to the console.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to reacquire the standard error stream after it has been changed by the <see cref="M:System.Console.SetError(System.IO.TextWriter)" /> method.</para>
@@ -909,6 +907,10 @@ public class ConsoleTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Acquires the standard error stream, which is set to a specified buffer size.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The standard error stream.</para>
+        </returns>
         <param name="bufferSize">
           <attribution license="cc4" from="Microsoft" modified="false" />The internal stream buffer size. </param>
       </Docs>
@@ -929,9 +931,6 @@ public class ConsoleTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A new synchronized <see cref="T:System.IO.Stream" /> object that reads from the console.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to reacquire the standard input stream after it has been changed by the <see cref="M:System.Console.SetIn(System.IO.TextReader)" /> method.</para>
@@ -940,6 +939,10 @@ public class ConsoleTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Acquires the standard input stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The standard input stream.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -960,9 +963,6 @@ public class ConsoleTest {
         <Parameter Name="bufferSize" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new synchronized <see cref="T:System.IO.Stream" /> object that reads from the console.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to reacquire the standard output stream after it has been changed by the <see cref="M:System.Console.SetIn(System.IO.TextReader)" /> method.</para>
@@ -971,6 +971,10 @@ public class ConsoleTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Acquires the standard input stream, which is set to a specified buffer size.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The standard input stream.</para>
+        </returns>
         <param name="bufferSize">
           <attribution license="cc4" from="Microsoft" modified="false" />The internal stream buffer size. </param>
       </Docs>
@@ -991,9 +995,6 @@ public class ConsoleTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A new synchronized <see cref="T:System.IO.Stream" /> object that writes to the console.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to reacquire the standard output stream after it has been changed by the <see cref="M:System.Console.SetOut(System.IO.TextWriter)" /> method.</para>
@@ -1002,6 +1003,10 @@ public class ConsoleTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Acquires the standard output stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The standard output stream.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1022,9 +1027,6 @@ public class ConsoleTest {
         <Parameter Name="bufferSize" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new synchronized <see cref="T:System.IO.Stream" /> object that writes to the console.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be used to reacquire the standard output stream after it has been changed by the <see cref="M:System.Console.SetOut(System.IO.TextWriter)" /> method.</para>
@@ -1033,6 +1035,10 @@ public class ConsoleTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Acquires the standard output stream, which is set to a specified buffer size.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The standard output stream.</para>
+        </returns>
         <param name="bufferSize">
           <attribution license="cc4" from="Microsoft" modified="false" />The internal stream buffer size. </param>
       </Docs>
@@ -1108,13 +1114,6 @@ public class ConsoleTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>The next character from the character source represented
-      as a <see cref="T:System.Int32" />
-      , or -1 if at the
-      end of the
-      stream.</para>
-        </returns>
         <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1126,6 +1125,10 @@ public class ConsoleTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the next character from the standard input stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The next character from the input stream, or negative one (-1) if there are currently no more characters to be read.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1142,7 +1145,6 @@ public class ConsoleTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1154,6 +1156,10 @@ public class ConsoleTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains the next character or function key pressed by the user. The pressed key is displayed in the console window.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ConsoleKeyInfo" /> object that describes the <see cref="T:System.ConsoleKey" /> constant and Unicode character, if any, that correspond to the pressed console key. The <see cref="T:System.ConsoleKeyInfo" /> object also describes, in a bitwise combination of <see cref="T:System.ConsoleModifiers" /> values, whether one or more Shift, Alt, or Ctrl modifier keys was pressed simultaneously with the console key.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ReadKey">
@@ -1171,7 +1177,6 @@ public class ConsoleTest {
         <Parameter Name="intercept" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1184,6 +1189,10 @@ public class ConsoleTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains the next character or function key pressed by the user. The pressed key is optionally displayed in the console window.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ConsoleKeyInfo" /> object that describes the <see cref="T:System.ConsoleKey" /> constant and Unicode character, if any, that correspond to the pressed console key. The <see cref="T:System.ConsoleKeyInfo" /> object also describes, in a bitwise combination of <see cref="T:System.ConsoleModifiers" /> values, whether one or more Shift, Alt, or Ctrl modifier keys was pressed simultaneously with the console key.</para>
+        </returns>
         <param name="intercept">
           <attribution license="cc4" from="Microsoft" modified="false" />Determines whether to display the pressed key in the console window. true to not display the pressed key; otherwise, false. </param>
       </Docs>
@@ -1203,12 +1212,6 @@ public class ConsoleTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.String" /> containing the next line from the input stream, or
-<see langword="null" />
-if the end of the input stream has already been reached.
-</para>
-        </returns>
         <exception cref="T:System.IO.IOException">An I/O error occurred. </exception>
         <exception cref="T:System.OutOfMemoryException">There is insufficient memory to allocate a buffer for the returned string.</exception>
         <remarks>
@@ -1223,6 +1226,10 @@ if the end of the input stream has already been reached.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reads the next line of characters from the standard input stream.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The next line of characters from the input stream, or null if no more lines are available.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System/ConsoleKeyInfo.xml b/mcs/class/corlib/Documentation/en/System/ConsoleKeyInfo.xml
index 50dab762c4b..de971324a03 100644
--- a/mcs/class/corlib/Documentation/en/System/ConsoleKeyInfo.xml
+++ b/mcs/class/corlib/Documentation/en/System/ConsoleKeyInfo.xml
@@ -77,7 +77,6 @@
         <Parameter Name="obj" Type="System.ConsoleKeyInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -88,6 +87,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified <see cref="T:System.ConsoleKeyInfo" /> object is equal to the current <see cref="T:System.ConsoleKeyInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is equal to the current <see cref="T:System.ConsoleKeyInfo" /> object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare to the current <see cref="T:System.ConsoleKeyInfo" /> object.</param>
       </Docs>
@@ -107,7 +110,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -117,6 +119,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a value indicating whether the specified object is equal to the current <see cref="T:System.ConsoleKeyInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is a <see cref="T:System.ConsoleKeyInfo" /> object and is equal to the current <see cref="T:System.ConsoleKeyInfo" /> object; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare to the current <see cref="T:System.ConsoleKeyInfo" /> object.</param>
       </Docs>
@@ -134,7 +140,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -144,6 +149,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for the current <see cref="T:System.ConsoleKeyInfo" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Key">
@@ -228,7 +237,6 @@
         <Parameter Name="b" Type="System.ConsoleKeyInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Two <see cref="T:System.ConsoleKeyInfo" /> objects are equal if their corresponding <see cref="P:System.ConsoleKeyInfo.KeyChar" />, <see cref="P:System.ConsoleKeyInfo.Key" />, and <see cref="P:System.ConsoleKeyInfo.Modifiers" /> properties are equal.</para>
@@ -237,6 +245,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified <see cref="T:System.ConsoleKeyInfo" /> objects are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> is equal to <paramref name="b" />; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare.</param>
         <param name="b">
@@ -259,7 +271,6 @@
         <Parameter Name="b" Type="System.ConsoleKeyInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Two <see cref="T:System.ConsoleKeyInfo" /> objects are equal if their corresponding <see cref="P:System.ConsoleKeyInfo.KeyChar" />, <see cref="P:System.ConsoleKeyInfo.Key" />, and <see cref="P:System.ConsoleKeyInfo.Modifiers" /> properties are equal.</para>
@@ -268,6 +279,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified <see cref="T:System.ConsoleKeyInfo" /> objects are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> is not equal to <paramref name="b" />; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare.</param>
         <param name="b">
diff --git a/mcs/class/corlib/Documentation/en/System/Convert.xml b/mcs/class/corlib/Documentation/en/System/Convert.xml
index 861ea25b80a..58c00e44199 100644
--- a/mcs/class/corlib/Documentation/en/System/Convert.xml
+++ b/mcs/class/corlib/Documentation/en/System/Convert.xml
@@ -133,7 +133,6 @@
         <Parameter Name="conversionType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -144,6 +143,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object of the specified type and whose value is equivalent to the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose type is <paramref name="conversionType" /> and whose value is equivalent to <paramref name="value" />.</para>
+          <para>-or-</para>
+          <para>A null reference (Nothing in Visual Basic), if <paramref name="value" /> is null and <paramref name="conversionType" /> is not a value type. </para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface. </param>
         <param name="conversionType">
@@ -167,7 +172,6 @@
         <Parameter Name="typeCode" Type="System.TypeCode" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -178,6 +182,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object of the specified type whose value is equivalent to the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose underlying type is <paramref name="typeCode" /> and whose value is equivalent to <paramref name="value" />.</para>
+          <para>-or-</para>
+          <para>A null reference (Nothing in Visual Basic), if <paramref name="value" /> is null and <paramref name="typeCode" /> is <see cref="F:System.TypeCode.Empty" />, <see cref="F:System.TypeCode.String" />, or <see cref="F:System.TypeCode.Object" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface. </param>
         <param name="typeCode">
@@ -202,7 +212,6 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -222,6 +231,15 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object of the specified type whose value is equivalent to the specified object. A parameter supplies culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose type is <paramref name="conversionType" /> and whose value is equivalent to <paramref name="value" />.</para>
+          <para>-or- </para>
+          <para>
+            <paramref name="value" />, if the <see cref="T:System.Type" /> of <paramref name="value" /> and <paramref name="conversionType" /> are equal.</para>
+          <para>-or- </para>
+          <para>A null reference (Nothing in Visual Basic), if <paramref name="value" /> is null and <paramref name="conversionType" /> is not a value type.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface. </param>
         <param name="conversionType">
@@ -248,7 +266,6 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -269,6 +286,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object of the specified type whose value is equivalent to the specified object. A parameter supplies culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose underlying type is <paramref name="typeCode" /> and whose value is equivalent to <paramref name="value" />.</para>
+          <para>-or- </para>
+          <para>A null reference (Nothing in Visual Basic), if <paramref name="value" /> is null and <paramref name="typeCode" /> is <see cref="F:System.TypeCode.Empty" />, <see cref="F:System.TypeCode.String" />, or <see cref="F:System.TypeCode.Object" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface. </param>
         <param name="typeCode">
@@ -319,7 +342,6 @@
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -334,6 +356,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a subset of a Unicode character array, which encodes binary data as base-64 digits, to an equivalent 8-bit unsigned integer array. Parameters specify the subset in the input array and the number of elements to convert.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of 8-bit unsigned integers equivalent to <paramref name="length" /> elements at position <paramref name="offset" /> in <paramref name="inArray" />.</para>
+        </returns>
         <param name="inArray">
           <attribution license="cc4" from="Microsoft" modified="false" />A Unicode character array. </param>
         <param name="offset">
@@ -358,7 +384,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -373,6 +398,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string, which encodes binary data as base-64 digits, to an equivalent 8-bit unsigned integer array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of 8-bit unsigned integers that is equivalent to <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to convert. </param>
       </Docs>
@@ -393,12 +422,15 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.TypeCode" /> for the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.TypeCode" /> for <paramref name="value" />, or <see cref="F:System.TypeCode.Empty" /> if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface. </param>
       </Docs>
@@ -419,7 +451,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Convert.IsDBNull(System.Object)" /> method tests whether the <paramref name="value" /> parameter is equal to <see cref="F:System.DBNull.Value" />. It is equivalent to the following code:</para>
@@ -433,6 +464,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an indication whether the specified object is of type <see cref="T:System.DBNull" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is of type <see cref="T:System.DBNull" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object. </param>
       </Docs>
@@ -457,7 +492,6 @@
         <Parameter Name="offsetOut" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The subset of <paramref name="length" /> elements of <paramref name="inArray" /> starting at position <paramref name="offsetIn" />, are taken as a numeric value and converted to a subset of elements in <paramref name="outArray" /> starting at position <paramref name="offsetOut" />. The return value indicates the number of converted elements in <paramref name="outArray" />. The subset of <paramref name="outArray" /> consists of base-64 digits.</para>
@@ -471,6 +505,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a subset of an 8-bit unsigned integer array to an equivalent subset of a Unicode character array encoded with base-64 digits. Parameters specify the subsets as offsets in the input and output arrays, and the number of elements in the input array to convert.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer containing the number of bytes in <paramref name="outArray" />.</para>
+        </returns>
         <param name="inArray">
           <attribution license="cc4" from="Microsoft" modified="false" />An input array of 8-bit unsigned integers. </param>
         <param name="offsetIn">
@@ -508,7 +546,6 @@
         <Parameter Name="options" Type="System.Base64FormattingOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -524,6 +561,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a subset of an 8-bit unsigned integer array to an equivalent subset of a Unicode character array encoded with base-64 digits. Parameters specify the subsets as offsets in the input and output arrays, the number of elements in the input array to convert, and whether line breaks are inserted in the output array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer containing the number of bytes in <paramref name="outArray" />.</para>
+        </returns>
         <param name="inArray">
           <attribution license="cc4" from="Microsoft" modified="false" />An input array of 8-bit unsigned integers. </param>
         <param name="offsetIn">
@@ -555,7 +596,6 @@
         <Parameter Name="inArray" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The elements of <paramref name="inArray" /> are taken as a numeric value and converted to a string representation that is encoded with base-64 digits.</para>
@@ -568,6 +608,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an array of 8-bit unsigned integers to its equivalent string representation that is encoded with base-64 digits.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation, in base 64, of the contents of <paramref name="inArray" />.</para>
+        </returns>
         <param name="inArray">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of 8-bit unsigned integers. </param>
       </Docs>
@@ -593,7 +637,6 @@
         <Parameter Name="options" Type="System.Base64FormattingOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -608,6 +651,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts an array of 8-bit unsigned integers to its equivalent string representation that is encoded with base-64 digits. A parameter specifies whether to insert line breaks in the return value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation in base 64 of the elements in <paramref name="inArray" />.</para>
+        </returns>
         <param name="inArray">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of 8-bit unsigned integers. </param>
         <param name="options">
@@ -633,7 +680,6 @@
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The elements of <paramref name="inArray" /> are taken as a numeric value and converted to a string representation in base 64.</para>
@@ -647,6 +693,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a subset of an array of 8-bit unsigned integers to its equivalent string representation that is encoded with base-64 digits. Parameters specify the subset as an offset in the input array, and the number of elements in the array to convert.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation in base 64 of <paramref name="length" /> elements of <paramref name="inArray" />, starting at position <paramref name="offset" />.</para>
+        </returns>
         <param name="inArray">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of 8-bit unsigned integers. </param>
         <param name="offset">
@@ -678,7 +728,6 @@
         <Parameter Name="options" Type="System.Base64FormattingOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -694,6 +743,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts a subset of an array of 8-bit unsigned integers to its equivalent string representation that is encoded with base-64 digits. Parameters specify the subset as an offset in the input array, the number of elements in the array to convert, and whether to insert line breaks in the return value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation in base 64 of <paramref name="length" /> elements of <paramref name="inArray" />, starting at position <paramref name="offset" />.</para>
+        </returns>
         <param name="inArray">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of 8-bit unsigned integers. </param>
         <param name="offset">
@@ -722,10 +775,6 @@
         <Parameter Name="value" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> is returned unchanged.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note"> This method is provided for
@@ -736,6 +785,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified Boolean value; no actual conversion is performed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" /> is returned unchanged.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Boolean value to return. </param>
       </Docs>
@@ -758,11 +812,6 @@
         <Parameter Name="value" Type="System.Byte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="value" /> is non-zero;
-<see langword="false" /> if <paramref name="value" /> is zero.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <example>
           <para>The following example demonstrates converting <see cref="T:System.Byte" /> values to <see cref="T:System.Boolean" /> values.</para>
@@ -788,6 +837,10 @@ class ConvertBoolTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 8-bit unsigned integer to an equivalent Boolean value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is not zero; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit unsigned integer to convert. </param>
       </Docs>
@@ -809,12 +862,15 @@ class ConvertBoolTest {
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to convert. </param>
       </Docs>
@@ -835,12 +891,15 @@ class ConvertBoolTest {
         <Parameter Name="value" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time value to convert. </param>
       </Docs>
@@ -862,11 +921,6 @@ class ConvertBoolTest {
         <Parameter Name="value" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="value" /> is non-zero;
-<see langword="false" /> if <paramref name="value" /> is zero.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <example>
           <para>The following example demonstrates converting <see cref="T:System.Decimal" /> values 
@@ -897,6 +951,10 @@ class ConvertBoolTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified decimal number to an equivalent Boolean value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is not zero; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The number to convert. </param>
       </Docs>
@@ -920,11 +978,6 @@ class ConvertBoolTest {
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="value" /> is non-zero;
-<see langword="false" /> if <paramref name="value" /> is zero.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <example>
           <para>The following example demonstrates converting <see cref="T:System.Double" /> values 
@@ -955,6 +1008,10 @@ class ConvertBoolTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified double-precision floating-point number to an equivalent Boolean value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is not zero; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The double-precision floating-point number to convert. </param>
       </Docs>
@@ -978,11 +1035,6 @@ class ConvertBoolTest {
         <Parameter Name="value" Type="System.Int16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="value" /> is non-zero;
-<see langword="false" /> if <paramref name="value" /> is zero. </para>
-        </returns>
         <remarks>To be added.</remarks>
         <example>
           <para>The following example demonstrates converting <see cref="T:System.Byte" /> values to <see cref="T:System.Boolean" /> values.</para>
@@ -1012,6 +1064,10 @@ class ConvertBoolTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 16-bit signed integer to an equivalent Boolean value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is not zero; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit signed integer to convert. </param>
       </Docs>
@@ -1034,11 +1090,6 @@ class ConvertBoolTest {
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="value" /> is non-zero;
-<see langword="false" /> if <paramref name="value" /> is zero. </para>
-        </returns>
         <remarks>To be added.</remarks>
         <example>
           <para>The following example demonstrates converting <see cref="T:System.Int32" /> values 
@@ -1069,6 +1120,10 @@ class ConvertBoolTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 32-bit signed integer to an equivalent Boolean value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is not zero; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit signed integer to convert. </param>
       </Docs>
@@ -1091,11 +1146,6 @@ class ConvertBoolTest {
         <Parameter Name="value" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="value" /> is non-zero;
-<see langword="false" /> if <paramref name="value" /> is zero. </para>
-        </returns>
         <remarks>To be added.</remarks>
         <example>
           <para>The following example demonstrates converting <see cref="T:System.Int64" /> values 
@@ -1126,6 +1176,10 @@ class ConvertBoolTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 64-bit signed integer to an equivalent Boolean value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is not zero; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit signed integer to convert. </param>
       </Docs>
@@ -1147,12 +1201,15 @@ class ConvertBoolTest {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of a specified object to an equivalent Boolean value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true or false, which reflects the value returned by invoking the <see cref="M:System.IConvertible.ToBoolean(System.IFormatProvider)" /> method for the underlying type of <paramref name="value" />. If <paramref name="value" /> is null, the method returns false. </para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface, or null. </param>
       </Docs>
@@ -1179,11 +1236,6 @@ class ConvertBoolTest {
         <Parameter Name="value" Type="System.SByte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="value" /> is non-zero;
-<see langword="false" /> if <paramref name="value" /> is zero.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use
    <see cref="M:System.Convert.ToBoolean(System.Object)" />(<see cref="T:System.Int16" />).</para>
@@ -1216,6 +1268,10 @@ class ConvertBoolTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 8-bit signed integer to an equivalent Boolean value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is not zero; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit signed integer to convert. </param>
       </Docs>
@@ -1238,11 +1294,6 @@ class ConvertBoolTest {
         <Parameter Name="value" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="value" /> is non-zero;
-<see langword="false" /> if <paramref name="value" /> is zero.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <example>
           <para>The following example demonstrates converting <see cref="T:System.Single" /> values 
@@ -1273,6 +1324,10 @@ class ConvertBoolTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified single-precision floating-point number to an equivalent Boolean value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is not zero; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The single-precision floating-point number to convert. </param>
       </Docs>
@@ -1296,11 +1351,6 @@ class ConvertBoolTest {
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="value" /> equals <see cref="F:System.Boolean.TrueString" />;
-<see langword="false" /> if <paramref name="value" /> equals <see cref="F:System.Boolean.FalseString" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -1342,6 +1392,10 @@ Unhandled Exception: System.FormatException: String was not recognized as a vali
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a logical value to its Boolean equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> equals <see cref="F:System.Boolean.TrueString" />, or false if <paramref name="value" /> equals <see cref="F:System.Boolean.FalseString" /> or null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the value of either <see cref="F:System.Boolean.TrueString" /> or <see cref="F:System.Boolean.FalseString" />. </param>
       </Docs>
@@ -1369,11 +1423,6 @@ Unhandled Exception: System.FormatException: String was not recognized as a vali
         <Parameter Name="value" Type="System.UInt16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="value" /> is non-zero;
-<see langword="false" /> if <paramref name="value" /> is zero. </para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use
    <see cref="M:System.Convert.ToBoolean(System.Object)" />(<see cref="T:System.Int32" />).</para>
@@ -1403,6 +1452,10 @@ class ConvertBoolTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 16-bit unsigned integer to an equivalent Boolean value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is not zero; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit unsigned integer to convert. </param>
       </Docs>
@@ -1430,11 +1483,6 @@ class ConvertBoolTest {
         <Parameter Name="value" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="value" /> is non-zero;
-<see langword="false" /> if <paramref name="value" /> is zero. </para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use
    <see cref="M:System.Convert.ToBoolean(System.Object)" />(<see cref="T:System.Int64" />).</para>
@@ -1464,6 +1512,10 @@ class ConvertBoolTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 32-bit unsigned integer to an equivalent Boolean value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is not zero; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit unsigned integer to convert. </param>
       </Docs>
@@ -1491,11 +1543,6 @@ class ConvertBoolTest {
         <Parameter Name="value" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="value" /> is non-zero;
-<see langword="false" /> if <paramref name="value" /> is zero. </para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use
    <see cref="M:System.Convert.ToBoolean(System.Object)" />(<see cref="T:System.Decimal" />).</para>
@@ -1525,6 +1572,10 @@ class ConvertBoolTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 64-bit unsigned integer to an equivalent Boolean value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is not zero; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit unsigned integer to convert. </param>
       </Docs>
@@ -1547,7 +1598,6 @@ class ConvertBoolTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -1557,6 +1607,10 @@ class ConvertBoolTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified object to an equivalent Boolean value, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true or false, which reflects the value returned by invoking the <see cref="M:System.IConvertible.ToBoolean(System.IFormatProvider)" /> method for the underlying type of <paramref name="value" />. If <paramref name="value" /> is null, the method returns false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface, or null. </param>
         <param name="provider">
@@ -1580,7 +1634,6 @@ class ConvertBoolTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If you prefer not to handle an exception if the conversion fails, you can call the <see cref="M:System.Boolean.TryParse(System.String,System.Boolean@)" /> method instead. It returns a <see cref="T:System.Boolean" /> value that indicates whether the conversion succeeded or failed.</para>
@@ -1589,6 +1642,10 @@ class ConvertBoolTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a logical value to its Boolean equivalent, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> equals <see cref="F:System.Boolean.TrueString" />, or false if <paramref name="value" /> equals <see cref="F:System.Boolean.FalseString" /> or null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the value of either <see cref="F:System.Boolean.TrueString" /> or <see cref="F:System.Boolean.FalseString" />. </param>
         <param name="provider">
@@ -1612,16 +1669,15 @@ class ConvertBoolTest {
         <Parameter Name="value" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> If <paramref name="value" /> equals <see langword="true" />, returns
- 1; if <paramref name="value" /> equals <see langword="false" /> , returns 0.
- </para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified Boolean value to the equivalent 8-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number 1 if <paramref name="value" /> is true; otherwise, 0.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Boolean value to convert. </param>
       </Docs>
@@ -1644,10 +1700,6 @@ class ConvertBoolTest {
         <Parameter Name="value" Type="System.Byte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> is returned unchanged.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note"> This method is
@@ -1658,6 +1710,11 @@ class ConvertBoolTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified 8-bit unsigned integer; no actual conversion is performed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" /> is returned unchanged.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit unsigned integer to return. </param>
       </Docs>
@@ -1680,10 +1737,6 @@ class ConvertBoolTest {
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Byte" />.</para>
-        </returns>
         <exception cref="T:System.OverflowException">The numeric value of <paramref name="value" /> is greater than <see cref="F:System.Byte.MaxValue" />.</exception>
         <example>
           <para>The following example demonstrates converting <see cref="T:System.Char" /> values 
@@ -1718,6 +1771,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified Unicode character to the equivalent 8-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to convert. </param>
       </Docs>
@@ -1739,12 +1796,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time value to convert. </param>
       </Docs>
@@ -1766,10 +1826,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Byte" /> , rounded to the nearest integer. </para>
-        </returns>
         <exception cref="T:System.OverflowException">
           <paramref name="value" /> is greater than <see cref="F:System.Byte.MaxValue" /> or less than <see cref="F:System.Byte.MinValue" />.</exception>
         <example>
@@ -1816,6 +1872,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified decimal number to an equivalent 8-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" />, rounded to the nearest 8-bit unsigned integer. If <paramref name="value" /> is halfway between two whole numbers, the even number is returned; that is, 4.5 is converted to 4, and 5.5 is converted to 6.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The number to convert. </param>
       </Docs>
@@ -1839,10 +1900,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Byte" /> , rounded to the nearest integer. </para>
-        </returns>
         <remarks>
           <para>Prior to the conversion, if <paramref name="value" /> is halfway
    between two numbers, it is rounded to the number that has an even digit in the
@@ -1890,6 +1947,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified double-precision floating-point number to an equivalent 8-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" />, rounded to the nearest 8-bit unsigned integer. If <paramref name="value" /> is halfway between two whole numbers, the even number is returned; that is, 4.5 is converted to 4, and 5.5 is converted to 6.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The double-precision floating-point number to convert. </param>
       </Docs>
@@ -1913,10 +1975,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Byte" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.OverflowException">
           <paramref name="value" /> is greater than <see cref="F:System.Byte.MaxValue" /> or less than <see cref="F:System.Byte.MinValue" />.</exception>
@@ -1924,6 +1982,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 16-bit signed integer to an equivalent 8-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit signed integer to convert. </param>
       </Docs>
@@ -1946,10 +2008,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Byte" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.OverflowException">
           <paramref name="value" /> is greater than <see cref="F:System.Byte.MaxValue" /> or less than <see cref="F:System.Byte.MinValue" />. </exception>
@@ -1957,6 +2015,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 32-bit signed integer to an equivalent 8-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit signed integer to convert. </param>
       </Docs>
@@ -1979,10 +2041,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Byte" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.OverflowException">
           <paramref name="value" /> is greater than <see cref="F:System.Byte.MaxValue" /> or less than <see cref="F:System.Byte.MinValue" />. </exception>
@@ -1990,6 +2048,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 64-bit signed integer to an equivalent 8-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit signed integer to convert. </param>
       </Docs>
@@ -2011,7 +2073,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="value" /> is not null, this method wraps a call to the <see cref="M:System.IConvertible.ToByte(System.IFormatProvider)" /> implementation of the underlying type of <paramref name="value" />.</para>
@@ -2020,6 +2081,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified object to an 8-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit unsigned integer that is equivalent to <paramref name="value" />, or zero if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface, or null. </param>
       </Docs>
@@ -2046,10 +2111,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.SByte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Byte" />.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToByte(System.Object)" />(<see cref="T:System.Int16" />).</para>
@@ -2060,6 +2121,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 8-bit signed integer to an equivalent 8-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit signed integer to be converted. </param>
       </Docs>
@@ -2082,10 +2147,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Byte" /> , rounded to the nearest integer. </para>
-        </returns>
         <remarks>
           <para>Prior to the conversion, if <paramref name="value" /> is halfway between two whole
    numbers, it is rounded to the nearest even integer. For example, 4.5 is rounded
@@ -2132,6 +2193,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified single-precision floating-point number to an equivalent 8-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" />, rounded to the nearest 8-bit unsigned integer. If <paramref name="value" /> is halfway between two whole numbers, the even number is returned; that is, 4.5 is converted to 4, and 5.5 is converted to 6.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A single-precision floating-point number. </param>
       </Docs>
@@ -2155,10 +2221,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Byte" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference. </exception>
         <exception cref="T:System.FormatException">
@@ -2205,6 +2267,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a number to an equivalent 8-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit unsigned integer that is equivalent to <paramref name="value" />, or zero if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the number to convert. </param>
       </Docs>
@@ -2232,10 +2298,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Byte" />.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use
    <see cref="M:System.Convert.ToByte(System.Object)" />(<see cref="T:System.Int32" />).</para>
@@ -2271,6 +2333,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 16-bit unsigned integer to an equivalent 8-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit unsigned integer to convert. </param>
       </Docs>
@@ -2298,10 +2364,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Byte" />.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use
    <see cref="M:System.Convert.ToByte(System.Object)" />(<see cref="T:System.Int64" />).</para>
@@ -2312,6 +2374,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 32-bit unsigned integer to an equivalent 8-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit unsigned integer to convert. </param>
       </Docs>
@@ -2339,10 +2405,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Byte" />.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use
    <see cref="M:System.Convert.ToByte(System.Object)" />(<see cref="T:System.Decimal" />).</para>
@@ -2378,6 +2440,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 64-bit unsigned integer to an equivalent 8-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit unsigned integer to convert. </param>
       </Docs>
@@ -2400,7 +2466,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -2410,6 +2475,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified object to an 8-bit unsigned integer, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit unsigned integer that is equivalent to <paramref name="value" />, or zero if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface. </param>
         <param name="provider">
@@ -2434,10 +2503,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Byte" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference. </exception>
         <exception cref="T:System.FormatException">
@@ -2453,6 +2518,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a number to an equivalent 8-bit unsigned integer, using specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit unsigned integer that is equivalent to <paramref name="value" />, or zero if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the number to convert. </param>
         <param name="provider">
@@ -2477,7 +2546,6 @@ class ConvertByteTest {
         <Parameter Name="fromBase" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="fromBase" /> is 16, you can prefix the number specified by the <paramref name="value" /> parameter with "0x" or "0X".</para>
@@ -2490,6 +2558,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified base to an equivalent 8-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit unsigned integer that is equivalent to the number in <paramref name="value" />, or 0 (zero) if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the number to convert. </param>
         <param name="fromBase">
@@ -2512,12 +2584,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Boolean value to convert. </param>
       </Docs>
@@ -2539,15 +2614,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Byte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Char" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 8-bit unsigned integer to its equivalent Unicode character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Unicode character that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit unsigned integer to convert. </param>
       </Docs>
@@ -2570,10 +2645,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> is returned unchanged.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note"> This method is 
@@ -2584,6 +2655,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified Unicode character value; no actual conversion is performed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" /> is returned unchanged.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to return. </param>
       </Docs>
@@ -2605,12 +2681,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time value to convert. </param>
       </Docs>
@@ -2631,12 +2710,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The decimal number to convert. </param>
       </Docs>
@@ -2657,12 +2739,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The double-precision floating-point number to convert. </param>
       </Docs>
@@ -2684,10 +2769,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Char" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.OverflowException">
           <paramref name="value" /> is less than <see cref="F:System.Char.MinValue" />. </exception>
@@ -2695,6 +2776,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 16-bit signed integer to its equivalent Unicode character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Unicode character that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit signed integer to convert. </param>
       </Docs>
@@ -2717,10 +2802,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Char" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.OverflowException">
           <paramref name="value" /> is greater than <see cref="F:System.Char.MaxValue" /> or less than <see cref="F:System.Char.MinValue" />. </exception>
@@ -2728,6 +2809,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 32-bit signed integer to its equivalent Unicode character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Unicode character that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit signed integer to convert. </param>
       </Docs>
@@ -2750,10 +2835,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Char" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.OverflowException">
           <paramref name="value" /> is greater than <see cref="F:System.Char.MaxValue" /> or less than <see cref="F:System.Char.MinValue" />. </exception>
@@ -2761,6 +2842,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 64-bit signed integer to its equivalent Unicode character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Unicode character that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit signed integer to convert. </param>
       </Docs>
@@ -2782,7 +2867,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="value" /> is not null, this method wraps a call to the <see cref="M:System.IConvertible.ToChar(System.IFormatProvider)" /> implementation of the underlying type of <paramref name="value" />.</para>
@@ -2791,6 +2875,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified object to a Unicode character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Unicode character that is equivalent to value, or <see cref="F:System.Char.MinValue" /> if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface. </param>
       </Docs>
@@ -2817,10 +2905,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.SByte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Char" />.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToChar(System.Object)" />(<see cref="T:System.Int16" />).</para>
@@ -2830,6 +2914,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 8-bit signed integer to its equivalent Unicode character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Unicode character that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit signed integer to convert. </param>
       </Docs>
@@ -2851,12 +2939,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The single-precision floating-point number to convert. </param>
       </Docs>
@@ -2878,10 +2969,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Char" />. </para>
-        </returns>
         <exception cref="T:System.FormatException">
           <paramref name="value" /> does not contain exactly one character. </exception>
         <remarks>
@@ -2894,6 +2981,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the first character of a specified string to a Unicode character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Unicode character that is equivalent to the first and only character in <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string of length 1. </param>
       </Docs>
@@ -2921,10 +3012,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Char" />.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToChar(System.Object)" />(<see cref="T:System.Int32" />).</para>
@@ -2933,6 +3020,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 16-bit unsigned integer to its equivalent Unicode character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Unicode character that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit unsigned integer to convert. </param>
       </Docs>
@@ -2960,10 +3051,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Char" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.OverflowException">
           <paramref name="value" /> is greater than <see cref="F:System.Char.MaxValue" />. </exception>
@@ -2971,6 +3058,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 32-bit unsigned integer to its equivalent Unicode character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Unicode character that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit unsigned integer to convert. </param>
       </Docs>
@@ -2998,10 +3089,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Char" />.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use
    <see cref="M:System.Convert.ToChar(System.Object)" />(<see cref="T:System.Int64" />).</para>
@@ -3012,6 +3099,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 64-bit unsigned integer to its equivalent Unicode character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Unicode character that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit unsigned integer to convert. </param>
       </Docs>
@@ -3034,7 +3125,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is the result of invoking the <see cref="M:System.IConvertible.ToChar(System.IFormatProvider)" /> method of the underlying type of <paramref name="value" />.</para>
@@ -3045,6 +3135,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified object to its equivalent Unicode character, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Unicode character that is equivalent to <paramref name="value" />, or <see cref="F:System.Char.MinValue" /> if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface. </param>
         <param name="provider">
@@ -3068,7 +3162,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -3079,6 +3172,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the first character of a specified string to a Unicode character, using specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Unicode character that is equivalent to the first and only character in <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string of length 1 or null. </param>
         <param name="provider">
@@ -3101,12 +3198,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Boolean value to convert. </param>
       </Docs>
@@ -3127,12 +3227,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Byte" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit unsigned integer to convert. </param>
       </Docs>
@@ -3153,12 +3256,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to convert. </param>
       </Docs>
@@ -3180,10 +3286,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> is returned unchanged.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note"> This method is 
@@ -3194,6 +3296,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified <see cref="T:System.DateTime" /> object; no actual conversion is performed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" /> is returned unchanged.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A date and time value. </param>
       </Docs>
@@ -3215,12 +3322,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The number to convert. </param>
       </Docs>
@@ -3241,12 +3351,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The double-precision floating-point value to convert. </param>
       </Docs>
@@ -3267,12 +3380,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int16" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit signed integer to convert. </param>
       </Docs>
@@ -3293,12 +3409,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit signed integer to convert. </param>
       </Docs>
@@ -3319,12 +3438,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit signed integer to convert. </param>
       </Docs>
@@ -3345,7 +3467,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For the conversion to succeed, the runtime type of the <paramref name="value" /> parameter must be either a <see cref="T:System.DateTime" /> or a <see cref="T:System.String" />, or <paramref name="value" /> must be null. Otherwise, the method throws an <see cref="T:System.InvalidCastException" />. In addition, if <paramref name="value" /> is a string, it must contain a valid representation of a date and time value in the current culture or a <see cref="T:System.FormatException" /> is thrown.  </para>
@@ -3355,6 +3476,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified object to a <see cref="T:System.DateTime" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The date and time equivalent of the value of <paramref name="value" />, or a date and time equivalent of <see cref="F:System.DateTime.MinValue" /> if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface, or null. </param>
       </Docs>
@@ -3380,12 +3505,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.SByte" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit signed integer to convert. </param>
       </Docs>
@@ -3406,12 +3534,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The single-precision floating-point value to convert. </param>
       </Docs>
@@ -3433,10 +3564,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.DateTime" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="value" /> is a null reference. </exception>
         <exception cref="T:System.FormatException">
@@ -3451,6 +3578,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a date and time to an equivalent date and time value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The date and time equivalent of the value of <paramref name="value" />, or the date and time equivalent of <see cref="F:System.DateTime.MinValue" /> if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string representation of a date and time.</param>
       </Docs>
@@ -3477,12 +3608,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt16" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit unsigned integer to convert. </param>
       </Docs>
@@ -3508,12 +3642,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit unsigned integer to convert. </param>
       </Docs>
@@ -3539,12 +3676,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit unsigned integer to convert. </param>
       </Docs>
@@ -3566,7 +3706,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is the result of invoking the <see cref="M:System.IConvertible.ToDateTime(System.IFormatProvider)" /> method of the underlying type of <paramref name="value" />.</para>
@@ -3577,6 +3716,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified object to a <see cref="T:System.DateTime" /> object, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The date and time equivalent of the value of <paramref name="value" />, or the date and time equivalent of <see cref="F:System.DateTime.MinValue" /> if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface. </param>
         <param name="provider">
@@ -3601,10 +3744,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.DateTime" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="value" /> is a null reference. </exception>
         <exception cref="T:System.FormatException">
@@ -3620,6 +3759,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a number to an equivalent date and time, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The date and time equivalent of the value of <paramref name="value" />, or the date and time equivalent of <see cref="F:System.DateTime.MinValue" /> if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a date and time to convert. </param>
         <param name="provider">
@@ -3644,16 +3787,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> If <paramref name="value" /> is <see langword="true" /> returns 1; if
-<paramref name="value" /> is <see langword="false" /> returns 0.
-   </para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified Boolean value to the equivalent decimal number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number 1 if <paramref name="value" /> is true; otherwise, 0.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Boolean value to convert. </param>
       </Docs>
@@ -3677,15 +3819,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Byte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Decimal" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 8-bit unsigned integer to the equivalent decimal number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The decimal number that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit unsigned integer to convert. </param>
       </Docs>
@@ -3708,12 +3850,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to convert. </param>
       </Docs>
@@ -3734,12 +3879,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time value to convert. </param>
       </Docs>
@@ -3761,10 +3909,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> is returned unchanged.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note"> This method is 
@@ -3775,6 +3919,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified decimal number; no actual conversion is performed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" /> is returned unchanged.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A decimal number. </param>
       </Docs>
@@ -3798,11 +3947,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Decimal" />. The <see cref="T:System.Decimal" /> contains 15 significant digits and is
-   rounded using banker's rounding. </para>
-        </returns>
         <exception cref="T:System.OverflowException">The numeric value of <paramref name="value" /> is greater than <see cref="F:System.Decimal.MaxValue" /> or less than <see cref="F:System.Decimal.MinValue" />.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3813,6 +3957,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified double-precision floating-point number to an equivalent decimal number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decimal number that is equivalent to <paramref name="value" />. </para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The double-precision floating-point number to convert. </param>
       </Docs>
@@ -3836,15 +3984,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Decimal" />. </para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 16-bit signed integer to an equivalent decimal number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decimal number that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit signed integer to convert. </param>
       </Docs>
@@ -3868,15 +4016,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Decimal" />. </para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 32-bit signed integer to an equivalent decimal number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decimal number that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit signed integer to convert. </param>
       </Docs>
@@ -3900,15 +4048,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Decimal" />. </para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 64-bit signed integer to an equivalent decimal number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decimal number that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit signed integer to convert. </param>
       </Docs>
@@ -3931,7 +4079,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is the result of invoking the <see cref="M:System.IConvertible.ToDecimal(System.IFormatProvider)" /> method of the underlying type of <paramref name="value" />.</para>
@@ -3940,6 +4087,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified object to an equivalent decimal number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decimal number that is equivalent to <paramref name="value" />, or 0 (zero) if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface, or null. </param>
       </Docs>
@@ -3966,10 +4117,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.SByte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Decimal" />.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToDecimal(System.Object)" />(<see cref="T:System.Int16" />).</para>
@@ -3978,6 +4125,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 8-bit signed integer to the equivalent decimal number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decimal number that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit signed integer to convert. </param>
       </Docs>
@@ -4001,11 +4152,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Decimal" />. The <see cref="T:System.Decimal" /> contains 7 significant digits and is
-   rounded using banker's rounding. </para>
-        </returns>
         <exception cref="T:System.OverflowException">The numeric value of <paramref name="value" /> is greater than <see cref="F:System.Decimal.MaxValue" /> or less than <see cref="F:System.Decimal.MinValue" />.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4016,6 +4162,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified single-precision floating-point number to the equivalent decimal number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decimal number that is equivalent to <paramref name="value" />. </para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The single-precision floating-point number to convert. </param>
       </Docs>
@@ -4039,10 +4189,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Decimal" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="value" /> is a null reference. </exception>
         <exception cref="T:System.FormatException">
@@ -4057,6 +4203,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a number to an equivalent decimal number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decimal number that is equivalent to the number in <paramref name="value" />, or 0 (zero) if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a number to convert. </param>
       </Docs>
@@ -4085,10 +4235,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Decimal" />.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToDecimal(System.Object)" />(<see cref="T:System.Int32" />).</para>
@@ -4097,6 +4243,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 16-bit unsigned integer to an equivalent decimal number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The decimal number that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit unsigned integer to convert. </param>
       </Docs>
@@ -4125,10 +4275,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Decimal" />. </para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToDecimal(System.Object)" />(<see cref="T:System.Int64" />).</para>
@@ -4137,6 +4283,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 32-bit unsigned integer to an equivalent decimal number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decimal number that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit unsigned integer to convert. </param>
       </Docs>
@@ -4165,10 +4315,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Decimal" />. </para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToDecimal(System.Object)" />(<see cref="T:System.Decimal" />).</para>
@@ -4177,6 +4323,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 64-bit unsigned integer to an equivalent decimal number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decimal number that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit unsigned integer to convert. </param>
       </Docs>
@@ -4200,7 +4350,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is the result of invoking the <see cref="M:System.IConvertible.ToDecimal(System.IFormatProvider)" /> method of the underlying type of <paramref name="value" />.</para>
@@ -4211,6 +4360,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified object to an equivalent decimal number, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decimal number that is equivalent to <paramref name="value" />, or 0 (zero) if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface. </param>
         <param name="provider">
@@ -4235,10 +4388,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Decimal" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="value" /> is a null reference. </exception>
         <exception cref="T:System.FormatException">
@@ -4255,6 +4404,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a number to an equivalent decimal number, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decimal number that is equivalent to the number in <paramref name="value" />, or 0 (zero) if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a number to convert. </param>
         <param name="provider">
@@ -4280,16 +4433,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> If <paramref name="value" /> is <see langword="true" /> returns 1; if 
-<paramref name="value" /> is <see langword="false" /> returns 0.
- </para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified Boolean value to the equivalent double-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number 1 if <paramref name="value" /> is true; otherwise, 0.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Boolean value to convert. </param>
       </Docs>
@@ -4313,15 +4465,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Byte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Double" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 8-bit unsigned integer to the equivalent double-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The double-precision floating-point number that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit unsigned integer to convert. </param>
       </Docs>
@@ -4344,12 +4496,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to convert. </param>
       </Docs>
@@ -4370,12 +4525,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time value to convert. </param>
       </Docs>
@@ -4397,16 +4555,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Double" />. <paramref name="value" /> is rounded using 
- banker's rounding. </para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified decimal number to an equivalent double-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A double-precision floating-point number that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The decimal number to convert. </param>
       </Docs>
@@ -4430,10 +4587,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> is returned unchanged.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note"> This method is
@@ -4444,6 +4597,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified double-precision floating-point number; no actual conversion is performed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" /> is returned unchanged.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The double-precision floating-point number to return. </param>
       </Docs>
@@ -4467,15 +4625,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Double" />. </para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 16-bit signed integer to an equivalent double-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A double-precision floating-point number equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit signed integer to convert. </param>
       </Docs>
@@ -4499,15 +4657,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Double" />. </para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 32-bit signed integer to an equivalent double-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A double-precision floating-point number that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit signed integer to convert. </param>
       </Docs>
@@ -4531,15 +4689,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value " />as a <see cref="T:System.Double" />. </para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 64-bit signed integer to an equivalent double-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A double-precision floating-point number that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit signed integer to convert. </param>
       </Docs>
@@ -4562,7 +4720,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="value" /> is not null, this method wraps a call to the <see cref="M:System.IConvertible.ToDouble(System.IFormatProvider)" /> implementation of the underlying type of <paramref name="value" />.</para>
@@ -4571,6 +4728,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified object to a double-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A double-precision floating-point number that is equivalent to <paramref name="value" />, or zero if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface, or null. </param>
       </Docs>
@@ -4597,10 +4758,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.SByte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Double" />.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToDouble(System.Object)" />(<see cref="T:System.Int16" />).</para>
@@ -4609,6 +4766,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 8-bit signed integer to the equivalent double-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 8-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit signed integer to convert. </param>
       </Docs>
@@ -4632,15 +4793,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Double" />. </para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified single-precision floating-point number to an equivalent double-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A double-precision floating-point number that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The single-precision floating-point number. </param>
       </Docs>
@@ -4664,10 +4825,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Double" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference. </exception>
         <exception cref="T:System.FormatException">
@@ -4682,6 +4839,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a number to an equivalent double-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A double-precision floating-point number that is equivalent to the number in <paramref name="value" />, or 0 (zero) if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the number to convert. </param>
       </Docs>
@@ -4710,10 +4871,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Double" />.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToDouble(System.Object)" />(<see cref="T:System.Int32" />).</para>
@@ -4722,6 +4879,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 16-bit unsigned integer to the equivalent double-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A double-precision floating-point number that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit unsigned integer to convert. </param>
       </Docs>
@@ -4750,10 +4911,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Double" />. </para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToDouble(System.Object)" />(<see cref="T:System.Int64" />).</para>
@@ -4762,6 +4919,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 32-bit unsigned integer to an equivalent double-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A double-precision floating-point number that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit unsigned integer to convert. </param>
       </Docs>
@@ -4790,10 +4951,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Double" />. </para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToDouble(System.Object)" />(<see cref="T:System.Decimal" />).</para>
@@ -4802,6 +4959,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 64-bit unsigned integer to an equivalent double-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A double-precision floating-point number that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit unsigned integer to convert. </param>
       </Docs>
@@ -4825,7 +4986,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is the result of invoking the <see cref="M:System.IConvertible.ToDouble(System.IFormatProvider)" /> method of the underlying type of <paramref name="value" />.</para>
@@ -4837,6 +4997,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified object to an double-precision floating-point number, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A double-precision floating-point number that is equivalent to <paramref name="value" />, or zero if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface. </param>
         <param name="provider">
@@ -4861,10 +5025,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Double" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="value" /> is a null reference. </exception>
         <exception cref="T:System.FormatException">
@@ -4881,6 +5041,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a number to an equivalent double-precision floating-point number, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A double-precision floating-point number that is equivalent to the number in <paramref name="value" />, or 0 (zero) if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the number to convert. </param>
         <param name="provider">
@@ -4906,16 +5070,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> If <paramref name="value" /> is <see langword="true" /> returns 1; if
-<paramref name="value" /> is <see langword="false" /> returns 0.
-   </para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified Boolean value to the equivalent 16-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number 1 if <paramref name="value" /> is true; otherwise, 0.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Boolean value to convert. </param>
       </Docs>
@@ -4938,15 +5101,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Byte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 16-bit signed integer. </para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 8-bit unsigned integer to the equivalent 16-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit unsigned integer to convert. </param>
       </Docs>
@@ -4969,16 +5132,16 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 16-bit signed integer.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.OverflowException">The numeric value of <paramref name="value" /> is greater than <see cref="F:System.Int16.MaxValue" />. </exception>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified Unicode character to the equivalent 16-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit signed integer that is equivalent to <paramref name="value" />. </para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to convert. </param>
       </Docs>
@@ -5000,12 +5163,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time value to convert. </param>
       </Docs>
@@ -5027,10 +5193,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 16-bit signed integer. <paramref name="value" /> is rounded prior to conversion. </para>
-        </returns>
         <remarks>
           <para>Prior to the conversion, if <paramref name="value" /> is halfway
    between two whole numbers, it is rounded to the nearest even integer. For
@@ -5042,6 +5204,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified decimal number to an equivalent 16-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" />, rounded to the nearest 16-bit signed integer. If <paramref name="value" /> is halfway between two whole numbers, the even number is returned; that is, 4.5 is converted to 4, and 5.5 is converted to 6.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The decimal number to convert. </param>
       </Docs>
@@ -5065,10 +5232,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 16-bit signed integer. <paramref name="value" /> is rounded prior to conversion. </para>
-        </returns>
         <remarks>
           <para>Prior to the conversion, if <paramref name="value" /> is halfway
    between two whole numbers, it is rounded to the nearest even integer. For
@@ -5080,6 +5243,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified double-precision floating-point number to an equivalent 16-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" />, rounded to the nearest 16-bit signed integer. If <paramref name="value" /> is halfway between two whole numbers, the even number is returned; that is, 4.5 is converted to 4, and 5.5 is converted to 6.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The double-precision floating-point number to convert. </param>
       </Docs>
@@ -5103,10 +5271,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> is returned unchanged.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note"> This method is
@@ -5117,6 +5281,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified 16-bit signed integer; no actual conversion is performed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" /> is returned unchanged.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit signed integer to return. </param>
       </Docs>
@@ -5139,10 +5308,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 16-bit signed integer.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.OverflowException">
           <paramref name="value" /> is greater than <see cref="F:System.Int16.MaxValue" /> or less than <see cref="F:System.Int16.MinValue" />. </exception>
@@ -5150,6 +5315,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 32-bit signed integer to an equivalent 16-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 16-bit signed integer equivalent of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit signed integer to convert. </param>
       </Docs>
@@ -5172,16 +5341,16 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 16-bit signed integer. </para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.OverflowException">value is greater than <see cref="F:System.Int16.MaxValue" /> or less than <see cref="F:System.Int16.MinValue" />. </exception>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 64-bit signed integer to an equivalent 16-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit signed integer to convert. </param>
       </Docs>
@@ -5203,7 +5372,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="value" /> is not null, this method wraps a call to the <see cref="M:System.IConvertible.ToInt16(System.IFormatProvider)" /> implementation of the underlying type of <paramref name="value" />.</para>
@@ -5212,6 +5380,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified object to a 16-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit signed integer that is equivalent to <paramref name="value" />, or zero if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface, or null. </param>
       </Docs>
@@ -5238,10 +5410,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.SByte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 16-bit signed integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt16(System.Object)" />(<see cref="T:System.Int16" />).</para>
@@ -5250,6 +5418,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 8-bit signed integer to the equivalent 16-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 8-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit signed integer to convert. </param>
       </Docs>
@@ -5272,10 +5444,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 16-bit signed integer. <paramref name="value" /> is rounded prior to conversion. </para>
-        </returns>
         <remarks>
           <para>Prior to the conversion, if <paramref name="value" /> is halfway
    between two whole numbers, it is rounded to the nearest even integer. For
@@ -5287,6 +5455,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified single-precision floating-point number to an equivalent 16-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" />, rounded to the nearest 16-bit signed integer. If <paramref name="value" /> is halfway between two whole numbers, the even number is returned; that is, 4.5 is converted to 4, and 5.5 is converted to 6.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The single-precision floating-point number to convert. </param>
       </Docs>
@@ -5310,11 +5483,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 16-bit signed
-   integer. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference. </exception>
         <exception cref="T:System.FormatException">
@@ -5329,6 +5497,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a number to an equivalent 16-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit signed integer that is equivalent to the number in <paramref name="value" />, or 0 (zero) if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the number to convert. </param>
       </Docs>
@@ -5356,10 +5528,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 16-bit signed integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt16(System.Object)" />(<see cref="T:System.Int32" />).</para>
@@ -5370,6 +5538,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 16-bit unsigned integer to the equivalent 16-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit unsigned integer to convert. </param>
       </Docs>
@@ -5397,10 +5569,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 16-bit signed integer. </para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt16(System.Object)" />(<see cref="T:System.Int64" />).</para>
@@ -5411,6 +5579,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 32-bit unsigned integer to an equivalent 16-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit unsigned integer to convert. </param>
       </Docs>
@@ -5438,11 +5610,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 16-bit signed integer.
-   </para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt16(System.Object)" />(<see cref="T:System.Decimal" />).</para>
@@ -5453,6 +5620,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 64-bit unsigned integer to an equivalent 16-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit unsigned integer to convert. </param>
       </Docs>
@@ -5475,7 +5646,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -5486,6 +5656,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified object to a 16-bit signed integer, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit signed integer that is equivalent to <paramref name="value" />, or zero if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface. </param>
         <param name="provider">
@@ -5510,10 +5684,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 16-bit signed integer. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference. </exception>
         <exception cref="T:System.FormatException">
@@ -5529,6 +5699,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a number to an equivalent 16-bit signed integer, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit signed integer that is equivalent to the number in <paramref name="value" />, or 0 (zero) if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the number to convert. </param>
         <param name="provider">
@@ -5553,7 +5727,6 @@ class ConvertByteTest {
         <Parameter Name="fromBase" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="fromBase" /> is 16, you can prefix the number specified by the <paramref name="value" /> parameter with "0x" or "0X".</para>
@@ -5566,6 +5739,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified base to an equivalent 16-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit signed integer that is equivalent to the number in <paramref name="value" />, or 0 (zero) if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the number to convert. </param>
         <param name="fromBase">
@@ -5589,16 +5766,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> If <paramref name="value" /> is <see langword="true" /> returns 1; if
-<paramref name="value" /> is <see langword="false" /> returns 0.
-   </para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified Boolean value to the equivalent 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number 1 if <paramref name="value" /> is true; otherwise, 0.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Boolean value to convert. </param>
       </Docs>
@@ -5621,15 +5797,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Byte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 32-bit signed integer. </para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 8-bit unsigned integer to the equivalent 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit unsigned integer to convert. </param>
       </Docs>
@@ -5652,10 +5828,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 32-bit signed integer.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A 32-bit signed integer that represents the UTF-16 encoded code point of the <paramref name="value" /> parameter.</para>
@@ -5664,6 +5836,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified Unicode character to the equivalent 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to convert. </param>
       </Docs>
@@ -5685,12 +5861,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time value to convert.</param>
       </Docs>
@@ -5712,11 +5891,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 32-bit signed integer.
-<paramref name="value" /> is rounded prior to conversion. </para>
-        </returns>
         <remarks>
           <para>Prior to the conversion, if <paramref name="value" /> is halfway
    between two whole numbers, it is rounded to the nearest even integer. For
@@ -5728,6 +5902,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified decimal number to an equivalent 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" />, rounded to the nearest 32-bit signed integer. If <paramref name="value" /> is halfway between two whole numbers, the even number is returned; that is, 4.5 is converted to 4, and 5.5 is converted to 6.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The decimal number to convert. </param>
       </Docs>
@@ -5751,11 +5930,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 32-bit signed integer.
-<paramref name="value" /> is rounded prior to conversion. </para>
-        </returns>
         <remarks>
           <para>Prior to the conversion, if <paramref name="value" /> is halfway
    between two whole numbers, it is rounded to the nearest even integer. For
@@ -5767,6 +5941,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified double-precision floating-point number to an equivalent 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" />, rounded to the nearest 32-bit signed integer. If <paramref name="value" /> is halfway between two whole numbers, the even number is returned; that is, 4.5 is converted to 4, and 5.5 is converted to 6.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The double-precision floating-point number to convert. </param>
       </Docs>
@@ -5790,16 +5969,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 32-bit signed
-   integer.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 16-bit signed integer to an equivalent 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit signed integer to convert. </param>
       </Docs>
@@ -5822,10 +6000,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> is returned unchanged.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note"> This method is
@@ -5836,6 +6010,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified 32-bit signed integer; no actual conversion is performed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" /> is returned unchanged.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit signed integer to return. </param>
       </Docs>
@@ -5858,11 +6037,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 32-bit signed integer.
-   </para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.OverflowException">
           <paramref name="value" /> is greater than <see cref="F:System.Int32.MaxValue" /> or less than <see cref="F:System.Int32.MinValue" />. </exception>
@@ -5870,6 +6044,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 64-bit signed integer to an equivalent 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit signed integer to convert. </param>
       </Docs>
@@ -5891,7 +6069,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="value" /> is not null, this method wraps a call to the <see cref="M:System.IConvertible.ToInt32(System.IFormatProvider)" /> implementation of the underlying type of <paramref name="value" />.</para>
@@ -5900,6 +6077,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified object to a 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer equivalent to <paramref name="value" />, or zero if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface, or null. </param>
       </Docs>
@@ -5926,10 +6107,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.SByte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 32-bit signed integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt32(System.Object)" />(<see cref="T:System.Int16" />).</para>
@@ -5938,6 +6115,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 8-bit signed integer to the equivalent 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 8-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit signed integer to convert. </param>
       </Docs>
@@ -5960,11 +6141,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 32-bit signed integer.
-<paramref name="value" /> is rounded prior to conversion. </para>
-        </returns>
         <remarks>
           <para>Prior to the conversion, if <paramref name="value" /> is halfway
    between two whole numbers, it is rounded to the nearest even integer. For
@@ -5976,6 +6152,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified single-precision floating-point number to an equivalent 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" />, rounded to the nearest 32-bit signed integer. If <paramref name="value" /> is halfway between two whole numbers, the even number is returned; that is, 4.5 is converted to 4, and 5.5 is converted to 6.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The single-precision floating-point number to convert. </param>
       </Docs>
@@ -5999,10 +6180,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 32-bit signed integer. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference. </exception>
         <exception cref="T:System.FormatException">
@@ -6017,6 +6194,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a number to an equivalent 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer that is equivalent to the number in <paramref name="value" />, or 0 (zero) if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the number to convert. </param>
       </Docs>
@@ -6044,10 +6225,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 32-bit signed integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt32(System.Object)" />(<see cref="T:System.Int32" />).</para>
@@ -6056,6 +6233,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 16-bit unsigned integer to the equivalent 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit unsigned integer to convert. </param>
       </Docs>
@@ -6083,10 +6264,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 32-bit signed integer. </para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt32(System.Object)" />(<see cref="T:System.Int64" />).</para>
@@ -6097,6 +6274,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 32-bit unsigned integer to an equivalent 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit unsigned integer to convert. </param>
       </Docs>
@@ -6124,10 +6305,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 32-bit signed integer. </para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt32(System.Object)" />(<see cref="T:System.Decimal" />).</para>
@@ -6138,6 +6315,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 64-bit unsigned integer to an equivalent 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit unsigned integer to convert. </param>
       </Docs>
@@ -6160,7 +6341,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is the result of invoking the <see cref="M:System.IConvertible.ToInt32(System.IFormatProvider)" /> method of the underlying type of <paramref name="value" />.</para>
@@ -6172,6 +6352,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified object to a 32-bit signed integer, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer that is equivalent to <paramref name="value" />, or zero if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface. </param>
         <param name="provider">
@@ -6196,10 +6380,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 32-bit signed integer. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference. </exception>
         <exception cref="T:System.FormatException">
@@ -6216,6 +6396,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a number to an equivalent 32-bit signed integer, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer that is equivalent to the number in <paramref name="value" />, or 0 (zero) if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the number to convert. </param>
         <param name="provider">
@@ -6240,7 +6424,6 @@ class ConvertByteTest {
         <Parameter Name="fromBase" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="fromBase" /> is 16, you can prefix the number specified by the <paramref name="value" /> parameter with "0x" or "0X".</para>
@@ -6254,6 +6437,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified base to an equivalent 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer that is equivalent to the number in <paramref name="value" />, or 0 (zero) if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the number to convert. </param>
         <param name="fromBase">
@@ -6277,16 +6464,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> If <paramref name="value" /> is <see langword="true" /> returns 1; if
-<paramref name="value" /> is <see langword="false" /> returns 0.
-   </para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified Boolean value to the equivalent 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number 1 if <paramref name="value" /> is true; otherwise, 0.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Boolean value to convert. </param>
       </Docs>
@@ -6309,15 +6495,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Byte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 64-bit signed integer.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 8-bit unsigned integer to the equivalent 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit unsigned integer to convert. </param>
       </Docs>
@@ -6340,15 +6526,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 64-bit signed integer.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified Unicode character to the equivalent 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to convert. </param>
       </Docs>
@@ -6370,12 +6556,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time value to convert. </param>
       </Docs>
@@ -6397,11 +6586,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 64-bit signed integer.
-<paramref name="value" /> is rounded prior to conversion. </para>
-        </returns>
         <remarks>
           <para>Prior to the conversion, if <paramref name="value" /> is halfway
    between two whole numbers, it is rounded to the nearest even integer. For
@@ -6413,6 +6597,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified decimal number to an equivalent 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" />, rounded to the nearest 64-bit signed integer. If <paramref name="value" /> is halfway between two whole numbers, the even number is returned; that is, 4.5 is converted to 4, and 5.5 is converted to 6.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The decimal number to convert. </param>
       </Docs>
@@ -6436,11 +6625,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 64-bit signed integer.
-<paramref name="value" /> is rounded prior to conversion. </para>
-        </returns>
         <remarks>
           <para>Prior to the conversion, if <paramref name="value" /> is halfway
    between two whole numbers, it is rounded to the nearest even integer. For
@@ -6452,6 +6636,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified double-precision floating-point number to an equivalent 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" />, rounded to the nearest 64-bit signed integer. If <paramref name="value" /> is halfway between two whole numbers, the even number is returned; that is, 4.5 is converted to 4, and 5.5 is converted to 6.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The double-precision floating-point number to convert. </param>
       </Docs>
@@ -6475,16 +6664,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 64-bit signed integer.
-   </para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 16-bit signed integer to an equivalent 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit signed integer to convert. </param>
       </Docs>
@@ -6507,15 +6695,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 64-bit signed integer. </para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 32-bit signed integer to an equivalent 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit signed integer to convert. </param>
       </Docs>
@@ -6538,10 +6726,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> is returned unchanged.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note"> This method is
@@ -6552,6 +6736,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified 64-bit signed integer; no actual conversion is performed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" /> is returned unchanged.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A 64-bit signed integer. </param>
       </Docs>
@@ -6573,7 +6762,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="value" /> is not null, this method wraps a call to the <see cref="M:System.IConvertible.ToInt64(System.IFormatProvider)" /> implementation of the underlying type of <paramref name="value" />.</para>
@@ -6582,6 +6770,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified object to a 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit signed integer that is equivalent to <paramref name="value" />, or zero if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface, or null. </param>
       </Docs>
@@ -6608,10 +6800,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.SByte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 64-bit signed integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt64(System.Object)" />(<see cref="T:System.Int16" />).</para>
@@ -6620,6 +6808,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 8-bit signed integer to the equivalent 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit signed integer to convert. </param>
       </Docs>
@@ -6642,11 +6834,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 64-bit signed integer.
-<paramref name="value" /> is rounded prior to conversion. </para>
-        </returns>
         <remarks>
           <para>Prior to the conversion, if <paramref name="value" /> is halfway
    between two whole numbers, it is rounded to the nearest even integer. For
@@ -6658,6 +6845,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified single-precision floating-point number to an equivalent 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" />, rounded to the nearest 64-bit signed integer. If <paramref name="value" /> is halfway between two whole numbers, the even number is returned; that is, 4.5 is converted to 4, and 5.5 is converted to 6.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The single-precision floating-point number to convert. </param>
       </Docs>
@@ -6681,11 +6873,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 64-bit signed
-   integer. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference. </exception>
         <exception cref="T:System.FormatException">
@@ -6700,6 +6887,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a number to an equivalent 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit signed integer that is equivalent to the number in <paramref name="value" />, or 0 (zero) if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a number to convert. </param>
       </Docs>
@@ -6727,10 +6918,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 64-bit signed integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt64(System.Object)" />(<see cref="T:System.Int32" />).</para>
@@ -6739,6 +6926,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 16-bit unsigned integer to the equivalent 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit unsigned integer to convert. </param>
       </Docs>
@@ -6766,10 +6957,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 64-bit signed integer. </para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt64(System.Object)" />(<see cref="T:System.Int64" />).</para>
@@ -6778,6 +6965,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 32-bit unsigned integer to an equivalent 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit unsigned integer to convert. </param>
       </Docs>
@@ -6805,10 +6996,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 64-bit signed integer. </para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt64(System.Object)" />(<see cref="T:System.Decimal" />).</para>
@@ -6819,6 +7006,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 64-bit unsigned integer to an equivalent 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit unsigned integer to convert. </param>
       </Docs>
@@ -6841,7 +7032,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is the result of invoking the <see cref="M:System.IConvertible.ToInt64(System.IFormatProvider)" /> method of the underlying type of <paramref name="value" />.</para>
@@ -6853,6 +7043,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified object to a 64-bit signed integer, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit signed integer that is equivalent to <paramref name="value" />, or zero if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface. </param>
         <param name="provider">
@@ -6877,10 +7071,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 64-bit signed integer. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference. </exception>
         <exception cref="T:System.FormatException">
@@ -6897,6 +7087,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a number to an equivalent 64-bit signed integer, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit signed integer that is equivalent to the number in <paramref name="value" />, or 0 (zero) if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the number to convert. </param>
         <param name="provider">
@@ -6921,7 +7115,6 @@ class ConvertByteTest {
         <Parameter Name="fromBase" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="fromBase" /> is 16, you can prefix the number specified by the <paramref name="value" /> parameter with "0x" or "0X".</para>
@@ -6937,6 +7130,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified base to an equivalent 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit signed integer that is equivalent to the number in <paramref name="value" />, or 0 (zero) if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the number to convert. </param>
         <param name="fromBase">
@@ -6965,10 +7162,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> If <paramref name="value" /> is true <see langword="returns" /> 1; if
-<paramref name="value" /> is <see langword="false" /> returns 0. </para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt16(System.Object)" />(<see cref="T:System.Boolean" />).</para>
@@ -6977,6 +7170,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified Boolean value to the equivalent 8-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number 1 if <paramref name="value" /> is true; otherwise, 0.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Boolean value to convert. </param>
       </Docs>
@@ -7004,10 +7201,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Byte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.SByte" />.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt16(System.Object)" />(<see cref="T:System.Byte" />). </para>
@@ -7018,6 +7211,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 8-bit unsigned integer to the equivalent 8-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit unsigned integer to convert. </param>
       </Docs>
@@ -7045,10 +7242,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.SByte" />.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt16(System.Object)" />(<see cref="T:System.Char" />).</para>
@@ -7058,6 +7251,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified Unicode character to the equivalent 8-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to convert. </param>
       </Docs>
@@ -7084,12 +7281,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time value to convert. </param>
       </Docs>
@@ -7116,10 +7316,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.SByte" /> , rounded to the nearest integer. </para>
-        </returns>
         <remarks>
           <para>Prior to the conversion, if <paramref name="value" /> is halfway
    between two whole numbers, it is rounded to the nearest even integer. For
@@ -7133,6 +7329,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified decimal number to an equivalent 8-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" />, rounded to the nearest 8-bit signed integer. If <paramref name="value" /> is halfway between two whole numbers, the even number is returned; that is, 4.5 is converted to 4, and 5.5 is converted to 6.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The decimal number to convert. </param>
       </Docs>
@@ -7161,10 +7362,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value " />as a <see cref="T:System.SByte" /> , rounded to the nearest integer. </para>
-        </returns>
         <remarks>
           <para>Prior to the conversion, if <paramref name="value" /> is halfway
    between two whole numbers, it is rounded to the nearest even integer. For
@@ -7178,6 +7375,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified double-precision floating-point number to an equivalent 8-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" />, rounded to the nearest 8-bit signed integer. If <paramref name="value" /> is halfway between two whole numbers, the even number is returned; that is, 4.5 is converted to 4, and 5.5 is converted to 6.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The double-precision floating-point number to convert. </param>
       </Docs>
@@ -7206,10 +7408,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.SByte" />.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt16(System.Object)" />(<see cref="T:System.Int16" />). </para>
@@ -7220,6 +7418,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 16-bit signed integer to the equivalent 8-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit signed integer to convert. </param>
       </Docs>
@@ -7247,10 +7449,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.SByte" />. </para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant 
       alternative, use <see cref="M:System.Convert.ToInt16(System.Object)" />(<see cref="T:System.Int32" />).</para>
@@ -7261,6 +7459,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 32-bit signed integer to an equivalent 8-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit signed integer to convert. </param>
       </Docs>
@@ -7288,11 +7490,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.SByte" />.
-   </para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt16(System.Object)" />(<see cref="T:System.Int64" />). </para>
@@ -7303,6 +7500,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 64-bit signed integer to an equivalent 8-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit signed integer to convert. </param>
       </Docs>
@@ -7329,7 +7530,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is the result of invoking the <see cref="M:System.IConvertible.ToSByte(System.IFormatProvider)" /> method of the underlying type of <paramref name="value" />.</para>
@@ -7338,6 +7538,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified object to an 8-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit signed integer that is equivalent to <paramref name="value" />, or zero if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface, or null. </param>
       </Docs>
@@ -7364,10 +7568,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.SByte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> is returned unchanged.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use
    <see cref="M:System.Convert.ToInt16(System.Object)" />(<see cref="T:System.Int16" />).</para>
@@ -7380,6 +7580,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified 8-bit signed integer; no actual conversion is performed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" /> is returned unchanged.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit signed integer to return. </param>
       </Docs>
@@ -7407,10 +7612,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.SByte" /> , rounded to the nearest integer. </para>
-        </returns>
         <remarks>
           <para>Prior to the conversion, if <paramref name="value" /> is halfway
    between two whole numbers, it is rounded to the nearest even integer. For
@@ -7424,6 +7625,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified single-precision floating-point number to an equivalent 8-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" />, rounded to the nearest 8-bit signed integer. If <paramref name="value" /> is halfway between two whole numbers, the even number is returned; that is, 4.5 is converted to 4, and 5.5 is converted to 6.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The single-precision floating-point number to convert. </param>
       </Docs>
@@ -7452,10 +7658,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.SByte" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference. </exception>
         <exception cref="T:System.FormatException">
@@ -7470,6 +7672,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a number to an equivalent 8-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit signed integer that is equivalent to the number in <paramref name="value" />, or 0 (zero) if value is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the number to convert. </param>
       </Docs>
@@ -7497,10 +7703,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.SByte" />.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt16(System.Object)" />(<see cref="T:System.Int32" />). </para>
@@ -7511,6 +7713,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 16-bit unsigned integer to the equivalent 8-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit unsigned integer to convert. </param>
       </Docs>
@@ -7538,10 +7744,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.SByte" />. </para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt16(System.Object)" />(<see cref="T:System.Int64" />).</para>
@@ -7552,6 +7754,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 32-bit unsigned integer to an equivalent 8-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit unsigned integer to convert. </param>
       </Docs>
@@ -7579,10 +7785,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.SByte" />. </para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt16(System.Object)" />(<see cref="T:System.Decimal" />).</para>
@@ -7593,6 +7795,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 64-bit unsigned integer to an equivalent 8-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit unsigned integer to convert. </param>
       </Docs>
@@ -7620,7 +7826,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -7631,6 +7836,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified object to an 8-bit signed integer, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit signed integer that is equivalent to <paramref name="value" />, or zero if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface. </param>
         <param name="provider">
@@ -7660,10 +7869,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.SByte" />. </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -7674,6 +7879,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a number to an equivalent 8-bit signed integer, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the number to convert. </param>
         <param name="provider">
@@ -7703,7 +7912,6 @@ class ConvertByteTest {
         <Parameter Name="fromBase" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="fromBase" /> is 16, you can prefix the number specified by the <paramref name="value" /> parameter with "0x" or "0X".</para>
@@ -7716,6 +7924,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified base to an equivalent 8-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit signed integer that is equivalent to the number in <paramref name="value" />, or 0 (zero) if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the number to convert. </param>
         <param name="fromBase">
@@ -7739,16 +7951,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> If <paramref name="value" /> is <see langword="true" /> returns 1; if 
-<paramref name="value" /> is <see langword="false" /> returns 0.
- </para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified Boolean value to the equivalent single-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number 1 if <paramref name="value" /> is true; otherwise, 0.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Boolean value to convert. </param>
       </Docs>
@@ -7772,15 +7983,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Byte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Single" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 8-bit unsigned integer to the equivalent single-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A single-precision floating-point number that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit unsigned integer to convert. </param>
       </Docs>
@@ -7803,12 +8014,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to convert. </param>
       </Docs>
@@ -7829,12 +8043,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time value to convert. </param>
       </Docs>
@@ -7856,16 +8073,17 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Single" />. <paramref name="value" /> is rounded using 
- banker's rounding. </para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified decimal number to an equivalent single-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A single-precision floating-point number that is equivalent to <paramref name="value" />.</para>
+          <para>
+            <paramref name="value" /> is rounded using rounding to nearest. For example, when rounded to two decimals, the value 2.345 becomes 2.34 and the value 2.355 becomes 2.36.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The decimal number to convert. </param>
       </Docs>
@@ -7889,10 +8107,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Single" />. </para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.OverflowException">
           <paramref name="value" /> is greater than <see cref="F:System.Single.MaxValue" /> or less than <see cref="F:System.Single.MinValue" />.</exception>
@@ -7900,6 +8114,12 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified double-precision floating-point number to an equivalent single-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A single-precision floating-point number that is equivalent to <paramref name="value" />.</para>
+          <para>
+            <paramref name="value" /> is rounded using rounding to nearest. For example, when rounded to two decimals, the value 2.345 becomes 2.34 and the value 2.355 becomes 2.36.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The double-precision floating-point number to convert. </param>
       </Docs>
@@ -7923,15 +8143,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Single" />. </para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 16-bit signed integer to an equivalent single-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A single-precision floating-point number that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit signed integer to convert. </param>
       </Docs>
@@ -7955,15 +8175,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Single" />. </para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 32-bit signed integer to an equivalent single-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A single-precision floating-point number that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit signed integer to convert. </param>
       </Docs>
@@ -7987,15 +8207,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Single" />. </para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 64-bit signed integer to an equivalent single-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A single-precision floating-point number that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit signed integer to convert. </param>
       </Docs>
@@ -8018,7 +8238,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is the result of invoking the <see cref="M:System.IConvertible.ToSingle(System.IFormatProvider)" /> method of the underlying type of <paramref name="value" />.</para>
@@ -8027,6 +8246,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified object to a single-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A single-precision floating-point number that is equivalent to <paramref name="value" />, or zero if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface, or null. </param>
       </Docs>
@@ -8053,10 +8276,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.SByte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Single" />.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToSingle(System.Object)" />(<see cref="T:System.Int16" />).</para>
@@ -8065,6 +8284,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 8-bit signed integer to the equivalent single-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit signed integer to convert. </param>
       </Docs>
@@ -8088,10 +8311,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Single" /> .</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note"> This method is
@@ -8102,6 +8321,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified single-precision floating-point number; no actual conversion is performed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" /> is returned unchanged.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The single-precision floating-point number to return. </param>
       </Docs>
@@ -8125,10 +8349,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Single" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference. </exception>
         <exception cref="T:System.FormatException">
@@ -8143,6 +8363,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a number to an equivalent single-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A single-precision floating-point number that is equivalent to the number in <paramref name="value" />, or 0 (zero) if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the number to convert. </param>
       </Docs>
@@ -8171,10 +8395,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Single" />.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToSingle(System.Object)" />(<see cref="T:System.Int32" />).</para>
@@ -8183,6 +8403,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 16-bit unsigned integer to the equivalent single-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A single-precision floating-point number that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit unsigned integer to convert. </param>
       </Docs>
@@ -8211,10 +8435,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Single" />. </para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToSingle(System.Object)" />(<see cref="T:System.Int64" />).</para>
@@ -8223,6 +8443,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 32-bit unsigned integer to an equivalent single-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A single-precision floating-point number that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit unsigned integer to convert. </param>
       </Docs>
@@ -8251,11 +8475,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Single" />.
-   </para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToSingle(System.Object)" />(<see cref="T:System.Decimal" />).</para>
@@ -8264,6 +8483,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 64-bit unsigned integer to an equivalent single-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A single-precision floating-point number that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit unsigned integer to convert. </param>
       </Docs>
@@ -8287,7 +8510,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is the result of invoking the <see cref="M:System.IConvertible.ToSingle(System.IFormatProvider)" /> method of the underlying type of <paramref name="value" />.</para>
@@ -8299,6 +8521,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified object to an single-precision floating-point number, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A single-precision floating-point number that is equivalent to <paramref name="value" />, or zero if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface. </param>
         <param name="provider">
@@ -8323,10 +8549,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.Single" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference. </exception>
         <exception cref="T:System.FormatException">
@@ -8343,6 +8565,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a number to an equivalent single-precision floating-point number, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A single-precision floating-point number that is equivalent to the number in <paramref name="value" />, or 0 (zero) if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the number to convert. </param>
         <param name="provider">
@@ -8368,10 +8594,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns the value returned by 
-   <paramref name="value" /> .ToString().</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation is identical to <see cref="M:System.Boolean.ToString" />. It returns <see cref="F:System.Boolean.TrueString" /> for true values and <see cref="F:System.Boolean.FalseString" /> for false values.</para>
@@ -8380,6 +8602,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified Boolean value to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Boolean value to convert. </param>
       </Docs>
@@ -8402,10 +8628,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Byte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns the value returned by
-      <paramref name="value" />.ToString().</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation is identical to <see cref="M:System.Byte.ToString" />.</para>
@@ -8414,6 +8636,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 8-bit unsigned integer to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit unsigned integer to convert. </param>
       </Docs>
@@ -8436,10 +8662,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a <see cref="T:System.String" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation is identical to <see cref="M:System.Char.ToString" />.</para>
@@ -8448,6 +8670,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified Unicode character to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to convert. </param>
       </Docs>
@@ -8470,10 +8696,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns the value returned by 
- <paramref name="value" />.ToString().</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation is identical to <see cref="M:System.DateTime.ToString" />. It uses the formatting conventions of the current culture and the "G" format specifier to convert a <see cref="T:System.DateTime" /> value to its string representation.</para>
@@ -8482,6 +8704,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified <see cref="T:System.DateTime" /> to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time value to convert. </param>
       </Docs>
@@ -8504,10 +8730,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns the value returned by 
- <paramref name="value" />.ToString().</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation is identical to <see cref="M:System.Decimal.ToString" />.</para>
@@ -8516,6 +8738,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified decimal number to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The decimal number to convert. </param>
       </Docs>
@@ -8539,10 +8765,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns the value returned by 
- <paramref name="value" />.ToString().</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation is identical to <see cref="M:System.Double.ToString" />.</para>
@@ -8551,6 +8773,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified double-precision floating-point number to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The double-precision floating-point number to convert. </param>
       </Docs>
@@ -8574,10 +8800,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns the value returned by
-   <paramref name="value" />.ToString().</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation is identical to <see cref="M:System.Int16.ToString" />.</para>
@@ -8586,6 +8808,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 16-bit signed integer to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit signed integer to convert. </param>
       </Docs>
@@ -8608,10 +8834,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns the value returned by
-   <paramref name="value" />.ToString().</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation is identical to <see cref="M:System.Int32.ToString" />.</para>
@@ -8620,6 +8842,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 32-bit signed integer to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit signed integer to convert. </param>
       </Docs>
@@ -8642,10 +8868,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns the value returned by
-   <paramref name="value" />.ToString().</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation is identical to <see cref="M:System.Int64.ToString" />.</para>
@@ -8654,6 +8876,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 64-bit signed integer to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit signed integer to convert. </param>
       </Docs>
@@ -8675,7 +8901,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To convert <paramref name="value" /> to its string representation, the method tries to call the <see cref="M:System.IConvertible.ToString(System.IFormatProvider)" /> implementation of <paramref name="value" />. If <paramref name="value" /> does not implement the <see cref="T:System.IConvertible" /> interface, the method tries to call the <see cref="M:System.IFormattable.ToString(System.String,System.IFormatProvider)" /> implementation of <paramref name="value" />. If value does not implement the <see cref="T:System.IFormattable" /> interface, the method calls the ToString method of the underlying type of <paramref name="value" />.</para>
@@ -8684,6 +8909,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified object to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />, or <see cref="F:System.String.Empty" /> if value is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies the value to convert, or null. </param>
       </Docs>
@@ -8710,10 +8939,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.SByte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns the value returned by
-   <paramref name="value" />.ToString().</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation is identical to <see cref="M:System.SByte.ToString" />.</para>
@@ -8722,6 +8947,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 8-bit signed integer to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit signed integer to convert. </param>
       </Docs>
@@ -8744,10 +8973,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns the value returned by 
- <paramref name="value" />.ToString().</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation is identical to <see cref="M:System.Single.ToString" />.</para>
@@ -8756,6 +8981,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified single-precision floating-point number to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The single-precision floating-point number to convert. </param>
       </Docs>
@@ -8779,10 +9008,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> is returned unchanged.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note"> This method is 
@@ -8793,6 +9018,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified string instance; no actual conversion is performed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" /> is returned unchanged.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to return. </param>
       </Docs>
@@ -8820,10 +9050,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns the value returned by
-   <paramref name="value" />.ToString().</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation is identical to <see cref="M:System.UInt16.ToString" />.</para>
@@ -8832,6 +9058,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 16-bit unsigned integer to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit unsigned integer to convert. </param>
       </Docs>
@@ -8859,10 +9089,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns the value returned by
-   <paramref name="value" />.ToString().</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation is identical to <see cref="M:System.UInt32.ToString" />.</para>
@@ -8871,6 +9097,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 32-bit unsigned integer to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit unsigned integer to convert. </param>
       </Docs>
@@ -8898,10 +9128,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns the value returned by
-   <paramref name="value" />.ToString().</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation is identical to <see cref="M:System.UInt64.ToString" />.</para>
@@ -8910,6 +9136,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 64-bit unsigned integer to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit unsigned integer to convert. </param>
       </Docs>
@@ -8932,7 +9162,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation is identical to <see cref="M:System.Boolean.ToString" />. It returns <see cref="F:System.Boolean.TrueString" /> for true values and <see cref="F:System.Boolean.FalseString" /> for false values.</para>
@@ -8941,6 +9170,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified Boolean value to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Boolean value to convert. </param>
         <param name="provider">
@@ -8965,10 +9198,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns the value returned by
-   <paramref name="value" />.ToString(<paramref name="provider" />).</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation is identical to <see cref="M:System.Byte.ToString" />.</para>
@@ -8977,6 +9206,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 8-bit unsigned integer to its equivalent string representation, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit unsigned integer to convert. </param>
         <param name="provider">
@@ -9001,7 +9234,6 @@ class ConvertByteTest {
         <Parameter Name="toBase" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="toBase" /> does not equal 10, the string that is returned by the <see cref="M:System.Convert.ToString(System.Byte,System.Int32)" /> method represents <paramref name="value" /> by its magnitude only. If the method is called to create a string that will later be converted back to a number, a corresponding method that assumes a magnitude-only numeric representation should be called to perform the conversion. Such methods include <see cref="M:System.Convert.ToByte(System.String,System.Int32)" /> or <see cref="M:System.Byte.Parse(System.String,System.Globalization.NumberStyles)" />.</para>
@@ -9010,6 +9242,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of an 8-bit unsigned integer to its equivalent string representation in a specified base.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" /> in base <paramref name="toBase" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit unsigned integer to convert. </param>
         <param name="toBase">
@@ -9033,7 +9269,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation is identical to <see cref="M:System.Char.ToString" />.</para>
@@ -9042,6 +9277,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified Unicode character to its equivalent string representation, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to convert. </param>
         <param name="provider">
@@ -9066,10 +9305,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns the value returned by
-   <paramref name="value" />.ToString(<paramref name="provider" />).</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation is identical to <see cref="M:System.DateTime.ToString(System.IFormatProvider)" />.</para>
@@ -9078,6 +9313,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified <see cref="T:System.DateTime" /> to its equivalent string representation, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time value to convert. </param>
         <param name="provider">
@@ -9103,10 +9342,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns the value returned by
-   <paramref name="value" />.ToString(<paramref name="provider" />).</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation is identical to <see cref="M:System.Decimal.ToString(System.IFormatProvider)" />.</para>
@@ -9115,6 +9350,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified decimal number to its equivalent string representation, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The decimal number to convert. </param>
         <param name="provider">
@@ -9141,10 +9380,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns the value returned by
-   <paramref name="value" />.ToString(<paramref name="provider" />).</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation is identical to <see cref="M:System.Double.ToString(System.IFormatProvider)" /> </para>
@@ -9153,6 +9388,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified double-precision floating-point number to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The double-precision floating-point number to convert. </param>
         <param name="provider">
@@ -9179,10 +9418,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns the value returned by
-   <paramref name="value" />.ToString(<paramref name="provider" />).</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation is identical to <see cref="M:System.Int16.ToString(System.IFormatProvider)" />.</para>
@@ -9191,6 +9426,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 16-bit signed integer to its equivalent string representation, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit signed integer to convert. </param>
         <param name="provider">
@@ -9215,7 +9454,6 @@ class ConvertByteTest {
         <Parameter Name="toBase" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="value" /> is positive and <paramref name="toBase" /> is 2, 8, or 16, the returned string uses sign-and-magnitude representation. If <paramref name="value" /> is negative and <paramref name="toBase" /> is 2, 8, or 16, the returned string uses two's complement representation. This means that the high-order bit of the high-order byte (bit 15) is interpreted as the sign bit. If the <see cref="M:System.Convert.ToString(System.Int16,System.Int32)" /> method is called to create a string that will later be converted back to a number, a corresponding method that assumes a similar numeric representation should be called to perform the conversion. Such methods include <see cref="M:System.Convert.ToInt16(System.String,System.Int32)" /> and <see cref="M:System.Int16.Parse(System.String,System.Globalization.NumberStyles)" />.</para>
@@ -9224,6 +9462,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of a 16-bit signed integer to its equivalent string representation in a specified base.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" /> in base <paramref name="toBase" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit signed integer to convert. </param>
         <param name="toBase">
@@ -9248,10 +9490,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns the value returned by
-   <paramref name="value" />.ToString(<paramref name="provider" />).</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation is identical to <see cref="M:System.Int32.ToString(System.IFormatProvider)" />.</para>
@@ -9260,6 +9498,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 32-bit signed integer to its equivalent string representation, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit signed integer to convert. </param>
         <param name="provider">
@@ -9284,7 +9526,6 @@ class ConvertByteTest {
         <Parameter Name="toBase" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="value" /> is positive and <paramref name="toBase" /> is 2, 8, or 16, the returned string uses sign-and-magnitude representation. If <paramref name="value" /> is negative and <paramref name="toBase" /> is 2, 8, or 16, the returned string uses two's complement representation. This means that the high-order bit of the highest-order byte (bit 31) is interpreted as the sign bit. If the <see cref="M:System.Convert.ToString(System.Int32,System.Int32)" /> method is called to create a string that will later be converted back to a number, a corresponding method that assumes a similar numeric representation should be called to perform the conversion. Such methods include <see cref="M:System.Convert.ToInt32(System.String,System.Int32)" /> and <see cref="M:System.Int32.Parse(System.String,System.Globalization.NumberStyles)" />.</para>
@@ -9293,6 +9534,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of a 32-bit signed integer to its equivalent string representation in a specified base.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" /> in base <paramref name="toBase" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit signed integer to convert. </param>
         <param name="toBase">
@@ -9317,10 +9562,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns the value returned by
-   <paramref name="value" />.ToString(<paramref name="provider" />).</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation is identical to <see cref="M:System.Int64.ToString(System.IFormatProvider)" />.</para>
@@ -9329,6 +9570,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 64-bit signed integer to its equivalent string representation, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit signed integer to convert. </param>
         <param name="provider">
@@ -9353,7 +9598,6 @@ class ConvertByteTest {
         <Parameter Name="toBase" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="value" /> is positive and <paramref name="toBase" /> is not 10, the returned string uses sign-and-magnitude representation. If <paramref name="value" /> is negative and <paramref name="toBase" /> is not 10, the returned string uses two's complement representation. This means that the high-order bit of the highest-order byte (bit 63) is interpreted as the sign bit. If the <see cref="M:System.Convert.ToString(System.Int64,System.Int32)" /> method is called to create a string that will later be converted back to a number, a corresponding method that assumes a similar numeric representation should be called to perform the conversion. Such methods include <see cref="M:System.Convert.ToInt64(System.String,System.Int32)" /> and <see cref="M:System.Int64.Parse(System.String,System.Globalization.NumberStyles)" />.</para>
@@ -9362,6 +9606,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of a 64-bit signed integer to its equivalent string representation in a specified base.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" /> in base <paramref name="toBase" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit signed integer to convert. </param>
         <param name="toBase">
@@ -9385,7 +9633,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <paramref name="value" /> parameter implements the <see cref="T:System.IConvertible" /> interface, the method calls the <see cref="M:System.IConvertible.ToString(System.IFormatProvider)" /> implementation of <paramref name="value" />. Otherwise, if the <paramref name="value" /> parameter implements the <see cref="T:System.IFormattable" /> interface, the method calls its <see cref="M:System.IFormattable.ToString(System.String,System.IFormatProvider)" /> implementation. If <paramref name="value" /> implements neither interface, the method calls the <paramref name="value" /> parameter's ToString() method, and the <paramref name="provider" /> parameter is ignored.</para>
@@ -9395,6 +9642,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified object to its equivalent string representation using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />, or <see cref="F:System.String.Empty" /> if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies the value to convert, or null. </param>
         <param name="provider">
@@ -9424,10 +9675,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns the value returned by
-   <paramref name="value" />.ToString(<paramref name="provider" />).</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation is identical to <see cref="M:System.SByte.ToString(System.IFormatProvider)" />.</para>
@@ -9436,6 +9683,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 8-bit signed integer to its equivalent string representation, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit signed integer to convert. </param>
         <param name="provider">
@@ -9461,10 +9712,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns the value returned by
-   <paramref name="value" />.ToString(<paramref name="provider" />).</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation is identical to <see cref="M:System.Single.ToString(System.IFormatProvider)" />.</para>
@@ -9473,6 +9720,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified single-precision floating-point number to its equivalent string representation, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The single-precision floating-point number to convert. </param>
         <param name="provider">
@@ -9498,12 +9749,16 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified string instance; no actual conversion is performed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" /> is returned unchanged.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to return. </param>
         <param name="provider">
@@ -9533,10 +9788,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns the value returned by
-   <paramref name="value" />.ToString(<paramref name="provider" />).</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation is identical to <see cref="M:System.UInt16.ToString(System.IFormatProvider)" />.</para>
@@ -9545,6 +9796,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 16-bit unsigned integer to its equivalent string representation, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit unsigned integer to convert. </param>
         <param name="provider">
@@ -9575,10 +9830,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns the value returned by
-   <paramref name="value" />.ToString(<paramref name="provider" />).</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation is identical to <see cref="M:System.UInt32.ToString(System.IFormatProvider)" />.</para>
@@ -9587,6 +9838,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 32-bit unsigned integer to its equivalent string representation, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit unsigned integer to convert. </param>
         <param name="provider">
@@ -9617,10 +9872,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns the value returned by
-   <paramref name="value" />.ToString(<paramref name="provider" />).</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This implementation is identical to <see cref="M:System.UInt64.ToString(System.IFormatProvider)" />.</para>
@@ -9629,6 +9880,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 64-bit unsigned integer to its equivalent string representation, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit unsigned integer to convert. </param>
         <param name="provider">
@@ -9658,10 +9913,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> If <paramref name="value" /> is <see langword="true" /> returns 1; if
-<paramref name="value" /> is <see langword="false" /> returns 0. </para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt32(System.Object)" />(<see cref="T:System.Boolean" />).</para>
@@ -9670,6 +9921,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified Boolean value to the equivalent 16-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number 1 if <paramref name="value" /> is true; otherwise, 0.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Boolean value to convert. </param>
       </Docs>
@@ -9697,10 +9952,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Byte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 16-bit unsigned integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt32(System.Object)" />(<see cref="T:System.Byte" />).</para>
@@ -9709,6 +9960,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 8-bit unsigned integer to the equivalent 16-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit unsigned integer to convert. </param>
       </Docs>
@@ -9736,10 +9991,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 16-bit unsigned integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt32(System.Object)" />(<see cref="T:System.Char" />).</para>
@@ -9748,6 +9999,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified Unicode character to the equivalent 16-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The 16-bit unsigned integer equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to convert. </param>
       </Docs>
@@ -9774,12 +10029,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time value to convert. </param>
       </Docs>
@@ -9806,11 +10064,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 16-bit unsigned integer.
-<paramref name="value" /> is rounded prior to conversion. </para>
-        </returns>
         <remarks>
           <para>Prior to the conversion, if <paramref name="value" /> is halfway
    between two whole numbers, it is rounded to the nearest even integer. For
@@ -9824,6 +10077,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified decimal number to an equivalent 16-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" />, rounded to the nearest 16-bit unsigned integer. If <paramref name="value" /> is halfway between two whole numbers, the even number is returned; that is, 4.5 is converted to 4, and 5.5 is converted to 6.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The decimal number to convert. </param>
       </Docs>
@@ -9852,11 +10110,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 16-bit unsigned integer.
-<paramref name="value" /> is rounded prior to conversion. </para>
-        </returns>
         <remarks>
           <para>Prior to the conversion, if <paramref name="value " />is halfway
    between two whole numbers, it is rounded to the nearest even integer. For
@@ -9870,6 +10123,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified double-precision floating-point number to an equivalent 16-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" />, rounded to the nearest 16-bit unsigned integer. If <paramref name="value" /> is halfway between two whole numbers, the even number is returned; that is, 4.5 is converted to 4, and 5.5 is converted to 6.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The double-precision floating-point number to convert. </param>
       </Docs>
@@ -9898,10 +10156,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 16-bit unsigned integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt32(System.Object)" />(<see cref="T:System.Int16" />).</para>
@@ -9912,6 +10166,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 16-bit signed integer to the equivalent 16-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit signed integer to convert. </param>
       </Docs>
@@ -9939,9 +10197,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> value as a 16-bit unsigned integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant 
       alternative, use <see cref="M:System.Convert.ToInt32(System.Object)" />(<see cref="T:System.Int32" />).</para>
@@ -9952,6 +10207,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 32-bit signed integer to an equivalent 16-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit signed integer to convert. </param>
       </Docs>
@@ -9979,11 +10238,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 16-bit unsigned
-   integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt32(System.Object)" />(<see cref="T:System.Int64" />).</para>
@@ -9994,6 +10248,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 64-bit signed integer to an equivalent 16-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit signed integer to convert. </param>
       </Docs>
@@ -10020,7 +10278,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is the result of invoking the <see cref="M:System.IConvertible.ToUInt16(System.IFormatProvider)" /> method of the underlying type of <paramref name="value" />.</para>
@@ -10029,6 +10286,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified object to a 16-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit unsigned integer that is equivalent to <paramref name="value" />, or zero if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface, or null. </param>
       </Docs>
@@ -10055,10 +10316,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.SByte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value " />as a 16-bit unsigned integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt32(System.Object)" />(<see cref="T:System.Int16" />).</para>
@@ -10069,6 +10326,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 8-bit signed integer to the equivalent 16-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit signed integer to convert. </param>
       </Docs>
@@ -10096,11 +10357,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 16-bit unsigned integer.
-<paramref name="value" /> is rounded prior to conversion. </para>
-        </returns>
         <remarks>
           <para>Prior to the conversion, if <paramref name="value" /> is halfway
    between two whole numbers, it is rounded to the nearest even integer. For
@@ -10114,6 +10370,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified single-precision floating-point number to an equivalent 16-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" />, rounded to the nearest 16-bit unsigned integer. If <paramref name="value" /> is halfway between two whole numbers, the even number is returned; that is, 4.5 is converted to 4, and 5.5 is converted to 6.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The single-precision floating-point number to convert. </param>
       </Docs>
@@ -10142,11 +10403,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 16-bit unsigned
-   integer. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference. </exception>
         <exception cref="T:System.FormatException">
@@ -10161,6 +10417,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a number to an equivalent 16-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit unsigned integer that is equivalent to the number in <paramref name="value" />, or 0 (zero) if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the number to convert. </param>
       </Docs>
@@ -10188,10 +10448,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> is returned unchanged.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note"> This method is
@@ -10204,6 +10460,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified 16-bit unsigned integer; no actual conversion is performed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" /> is returned unchanged.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit unsigned integer to return. </param>
       </Docs>
@@ -10231,11 +10492,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 16-bit unsigned
-   integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt32(System.Object)" />(<see cref="T:System.Int64" />).</para>
@@ -10246,6 +10502,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 32-bit unsigned integer to an equivalent 16-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit unsigned integer to convert. </param>
       </Docs>
@@ -10273,11 +10533,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 16-bit unsigned
-   integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt32(System.Object)" />(<see cref="T:System.Decimal" />).</para>
@@ -10288,6 +10543,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 64-bit unsigned integer to an equivalent 16-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit unsigned integer to convert. </param>
       </Docs>
@@ -10315,7 +10574,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is the result of invoking the <see cref="M:System.IConvertible.ToUInt16(System.IFormatProvider)" /> method of the underlying type of <paramref name="value" />.</para>
@@ -10327,6 +10585,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified object to a 16-bit unsigned integer, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit unsigned integer that is equivalent to <paramref name="value" />, or zero if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface. </param>
         <param name="provider">
@@ -10356,11 +10618,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 16-bit unsigned
-   integer. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference. </exception>
         <exception cref="T:System.FormatException">
@@ -10377,6 +10634,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a number to an equivalent 16-bit unsigned integer, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit unsigned integer that is equivalent to the number in <paramref name="value" />, or 0 (zero) if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the number to convert. </param>
         <param name="provider">
@@ -10406,7 +10667,6 @@ class ConvertByteTest {
         <Parameter Name="fromBase" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="fromBase" /> is 16, you can prefix the number specified by the <paramref name="value" /> parameter with "0x" or "0X".</para>
@@ -10419,6 +10679,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified base to an equivalent 16-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit unsigned integer that is equivalent to the number in <paramref name="value" />, or 0 (zero) if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the number to convert. </param>
         <param name="fromBase">
@@ -10447,11 +10711,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> If <paramref name="value" /> is <see langword="true" /> returns 1; if
-<paramref name="value" /> is <see langword="false" /> returns 0.
-   </para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt64(System.Object)" />(<see cref="T:System.Boolean" />).</para>
@@ -10460,6 +10719,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified Boolean value to the equivalent 32-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number 1 if <paramref name="value" /> is true; otherwise, 0.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Boolean value to convert. </param>
       </Docs>
@@ -10487,10 +10750,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Byte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 32-bit unsigned integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt64(System.Object)" />(<see cref="T:System.Byte" />).</para>
@@ -10499,6 +10758,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 8-bit unsigned integer to the equivalent 32-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit unsigned integer to convert. </param>
       </Docs>
@@ -10526,10 +10789,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 32-bit unsigned integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt64(System.Object)" />(<see cref="T:System.Char" />).</para>
@@ -10538,6 +10797,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified Unicode character to the equivalent 32-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to convert. </param>
       </Docs>
@@ -10564,12 +10827,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time value to convert. </param>
       </Docs>
@@ -10596,11 +10862,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 32-bit unsigned integer.
-<paramref name="value" /> is rounded prior to conversion. </para>
-        </returns>
         <remarks>
           <para>Prior to the conversion, if <paramref name="value" /> is halfway
    between two whole numbers, it is rounded to the nearest even integer. For
@@ -10614,6 +10875,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified decimal number to an equivalent 32-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" />, rounded to the nearest 32-bit unsigned integer. If <paramref name="value" /> is halfway between two whole numbers, the even number is returned; that is, 4.5 is converted to 4, and 5.5 is converted to 6.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The decimal number to convert. </param>
       </Docs>
@@ -10642,11 +10908,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 32-bit unsigned integer.
-<paramref name="value" /> is rounded prior to conversion. </para>
-        </returns>
         <remarks>
           <para>Prior to the conversion, if <paramref name="value" /> is halfway
    between two whole numbers, it is rounded to the nearest even integer. For
@@ -10660,6 +10921,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified double-precision floating-point number to an equivalent 32-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" />, rounded to the nearest 32-bit unsigned integer. If <paramref name="value" /> is halfway between two whole numbers, the even number is returned; that is, 4.5 is converted to 4, and 5.5 is converted to 6.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The double-precision floating-point number to convert. </param>
       </Docs>
@@ -10688,10 +10954,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 32-bit unsigned integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt64(System.Object)" />(<see cref="T:System.Int16" />).</para>
@@ -10702,6 +10964,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 16-bit signed integer to the equivalent 32-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit signed integer to convert. </param>
       </Docs>
@@ -10729,10 +10995,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 32-bit unsigned integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt64(System.Object)" />(<see cref="T:System.Int32" />).</para>
@@ -10743,6 +11005,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 32-bit signed integer to an equivalent 32-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit signed integer to convert. </param>
       </Docs>
@@ -10770,11 +11036,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 32-bit unsigned
-   integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt64(System.Object)" />(<see cref="T:System.Int64" />).</para>
@@ -10785,6 +11046,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 64-bit signed integer to an equivalent 32-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit signed integer to convert. </param>
       </Docs>
@@ -10811,7 +11076,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is the result of invoking the <see cref="M:System.IConvertible.ToUInt32(System.IFormatProvider)" /> method of the underlying type of <paramref name="value" />.</para>
@@ -10820,6 +11084,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified object to a 32-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit unsigned integer that is equivalent to <paramref name="value" />, or 0 (zero) if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface, or null. </param>
       </Docs>
@@ -10846,10 +11114,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.SByte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 32-bit unsigned integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt64(System.Object)" />(<see cref="T:System.Int16" />).</para>
@@ -10860,6 +11124,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 8-bit signed integer to the equivalent 32-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit signed integer to convert. </param>
       </Docs>
@@ -10887,11 +11155,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 32-bit unsigned integer.
-<paramref name="value" /> is rounded prior to conversion. </para>
-        </returns>
         <remarks>
           <para>Prior to the conversion, if <paramref name="value" /> is halfway
    between two whole numbers, it is rounded to the nearest even integer. For
@@ -10905,6 +11168,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified single-precision floating-point number to an equivalent 32-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" />, rounded to the nearest 32-bit unsigned integer. If <paramref name="value" /> is halfway between two whole numbers, the even number is returned; that is, 4.5 is converted to 4, and 5.5 is converted to 6.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The single-precision floating-point number to convert. </param>
       </Docs>
@@ -10933,11 +11201,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 32-bit unsigned
-   integer. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference. </exception>
         <exception cref="T:System.FormatException">
@@ -10952,6 +11215,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a number to an equivalent 32-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit unsigned integer that is equivalent to the number in <paramref name="value" />, or 0 (zero) if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the number to convert. </param>
       </Docs>
@@ -10979,10 +11246,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 32-bit unsigned integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt64(System.Object)" />(<see cref="T:System.Int32" />).</para>
@@ -10991,6 +11254,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 16-bit unsigned integer to the equivalent 32-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit unsigned integer to convert. </param>
       </Docs>
@@ -11018,10 +11285,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> is returned unchanged.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note"> This method is
@@ -11034,6 +11297,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified 32-bit unsigned integer; no actual conversion is performed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" /> is returned unchanged.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit unsigned integer to return. </param>
       </Docs>
@@ -11061,11 +11329,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 32-bit unsigned
-   integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToInt64(System.Object)" />(<see cref="T:System.Decimal" />).</para>
@@ -11076,6 +11339,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 64-bit unsigned integer to an equivalent 32-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit unsigned integer to convert. </param>
       </Docs>
@@ -11103,7 +11370,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is the result of invoking the <see cref="M:System.IConvertible.ToUInt32(System.IFormatProvider)" /> method of the underlying type of <paramref name="value" />.</para>
@@ -11115,6 +11381,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified object to a 32-bit unsigned integer, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit unsigned integer that is equivalent to <paramref name="value" />, or zero if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface. </param>
         <param name="provider">
@@ -11144,11 +11414,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as an 32-bit unsigned
-   integer. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference. </exception>
         <exception cref="T:System.FormatException">
@@ -11165,6 +11430,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a number to an equivalent 32-bit unsigned integer, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit unsigned integer that is equivalent to the number in <paramref name="value" />, or 0 (zero) if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the number to convert. </param>
         <param name="provider">
@@ -11194,7 +11463,6 @@ class ConvertByteTest {
         <Parameter Name="fromBase" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="fromBase" /> is 16, you can prefix the number specified by the <paramref name="value" /> parameter with "0x" or "0X".</para>
@@ -11207,6 +11475,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified base to an equivalent 32-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit unsigned integer that is equivalent to the number in <paramref name="value" />, or 0 (zero) if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the number to convert. </param>
         <param name="fromBase">
@@ -11235,10 +11507,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> If <paramref name="value" /> is <see langword="true" /> returns 1; if
-<paramref name="value" /> is <see langword="false" /> returns 0. </para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToDecimal(System.Object)" />(<see cref="T:System.Boolean" />).</para>
@@ -11247,6 +11515,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified Boolean value to the equivalent 64-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number 1 if <paramref name="value" /> is true; otherwise, 0.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Boolean value to convert. </param>
       </Docs>
@@ -11274,10 +11546,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Byte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 64-bit unsigned integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToDecimal(System.Object)" />(<see cref="T:System.Byte" />).</para>
@@ -11286,6 +11554,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 8-bit unsigned integer to the equivalent 64-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit signed integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit unsigned integer to convert. </param>
       </Docs>
@@ -11313,10 +11585,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 64-bit unsigned integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToDecimal(System.Object)" />(<see cref="T:System.Char" />).</para>
@@ -11325,6 +11593,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified Unicode character to the equivalent 64-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to convert. </param>
       </Docs>
@@ -11351,12 +11623,15 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method always throws <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time value to convert. </param>
       </Docs>
@@ -11383,11 +11658,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 64-bit unsigned integer.
-<paramref name="value" /> is rounded prior to conversion. </para>
-        </returns>
         <remarks>
           <para>Prior to the conversion, if <paramref name="value" /> is halfway
    between two whole numbers, it is rounded to the nearest even integer. For
@@ -11401,6 +11671,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified decimal number to an equivalent 64-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" />, rounded to the nearest 64-bit unsigned integer. If <paramref name="value" /> is halfway between two whole numbers, the even number is returned; that is, 4.5 is converted to 4, and 5.5 is converted to 6.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The decimal number to convert. </param>
       </Docs>
@@ -11429,11 +11704,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 64-bit unsigned integer.
-<paramref name="value" /> is rounded prior to conversion. </para>
-        </returns>
         <remarks>
           <para>Prior to the conversion, if <paramref name="value" /> is halfway
    between two whole numbers, it is rounded to the nearest even integer. For
@@ -11447,6 +11717,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified double-precision floating-point number to an equivalent 64-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" />, rounded to the nearest 64-bit unsigned integer. If <paramref name="value" /> is halfway between two whole numbers, the even number is returned; that is, 4.5 is converted to 4, and 5.5 is converted to 6.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The double-precision floating-point number to convert. </param>
       </Docs>
@@ -11475,10 +11750,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 64-bit unsigned integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToDecimal(System.Object)" />(<see cref="T:System.Int16" />).</para>
@@ -11489,6 +11760,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 16-bit signed integer to the equivalent 64-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit signed integer to convert. </param>
       </Docs>
@@ -11516,10 +11791,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 64-bit unsigned integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToDecimal(System.Object)" />(<see cref="T:System.Int32" />).</para>
@@ -11530,6 +11801,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 32-bit signed integer to an equivalent 64-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit signed integer to convert. </param>
       </Docs>
@@ -11557,11 +11832,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 64-bit unsigned
-   integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToDecimal(System.Object)" />(<see cref="T:System.Int64" />).</para>
@@ -11572,6 +11842,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 64-bit signed integer to an equivalent 64-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit signed integer to convert. </param>
       </Docs>
@@ -11598,7 +11872,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is the result of invoking the <see cref="M:System.IConvertible.ToUInt64(System.IFormatProvider)" /> method of the underlying type of <paramref name="value" />.</para>
@@ -11607,6 +11880,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified object to a 64-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit unsigned integer that is equivalent to <paramref name="value" />, or zero if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface, or null. </param>
       </Docs>
@@ -11633,10 +11910,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.SByte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 64-bit unsigned integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToDecimal(System.Object)" />(<see cref="T:System.Int16" />).</para>
@@ -11646,6 +11919,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 8-bit signed integer to the equivalent 64-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 8-bit signed integer to convert. </param>
       </Docs>
@@ -11673,11 +11950,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 64-bit unsigned integer.
-<paramref name="value" /> is rounded prior to conversion. </para>
-        </returns>
         <remarks>
           <para>Prior to the conversion, if <paramref name="value" /> is halfway
    between two whole numbers, it is rounded to the nearest even integer. For
@@ -11691,6 +11963,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified single-precision floating-point number to an equivalent 64-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" />, rounded to the nearest 64-bit unsigned integer. If <paramref name="value" /> is halfway between two whole numbers, the even number is returned; that is, 4.5 is converted to 4, and 5.5 is converted to 6.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The single-precision floating-point number to convert. </param>
       </Docs>
@@ -11719,11 +11996,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 64-bit unsigned
-   integer. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is null reference. </exception>
         <exception cref="T:System.FormatException">
@@ -11738,6 +12010,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a number to an equivalent 64-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit signed integer that is equivalent to the number in <paramref name="value" />, or 0 (zero) if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the number to convert. </param>
       </Docs>
@@ -11765,10 +12041,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 64-bit unsigned integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToDecimal(System.Object)" />(<see cref="T:System.Int32" />).</para>
@@ -11777,6 +12049,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 16-bit unsigned integer to the equivalent 64-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 16-bit unsigned integer to convert. </param>
       </Docs>
@@ -11804,10 +12080,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 64-bit unsigned integer.</para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.Convert.ToDecimal(System.Object)" />(<see cref="T:System.Int64" />).</para>
@@ -11816,6 +12088,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified 32-bit unsigned integer to an equivalent 64-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit unsigned integer that is equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 32-bit unsigned integer to convert. </param>
       </Docs>
@@ -11843,10 +12119,6 @@ class ConvertByteTest {
         <Parameter Name="value" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> is returned unchanged.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note"> This method is
@@ -11859,6 +12131,11 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified 64-bit unsigned integer; no actual conversion is performed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            <paramref name="value" /> is returned unchanged.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The 64-bit unsigned integer to return. </param>
       </Docs>
@@ -11886,7 +12163,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is the result of invoking the <see cref="M:System.IConvertible.ToUInt64(System.IFormatProvider)" /> method of the underlying type of <paramref name="value" />.</para>
@@ -11898,6 +12174,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified object to a 64-bit unsigned integer, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit unsigned integer that is equivalent to <paramref name="value" />, or zero if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IConvertible" /> interface. </param>
         <param name="provider">
@@ -11927,11 +12207,6 @@ class ConvertByteTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <paramref name="value" /> as a 64-bit unsigned
-   integer. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference. </exception>
         <exception cref="T:System.FormatException">
@@ -11948,6 +12223,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a number to an equivalent 64-bit unsigned integer, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit unsigned integer that is equivalent to the number in <paramref name="value" />, or 0 (zero) if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the number to convert. </param>
         <param name="provider">
@@ -11977,7 +12256,6 @@ class ConvertByteTest {
         <Parameter Name="fromBase" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="fromBase" /> is 16, you can prefix the number specified by the <paramref name="value" /> parameter with "0x" or "0X".</para>
@@ -11990,6 +12268,10 @@ class ConvertByteTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified base to an equivalent 64-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit unsigned integer that is equivalent to the number in <paramref name="value" />, or 0 (zero) if <paramref name="value" /> is null.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the number to convert. </param>
         <param name="fromBase">
diff --git a/mcs/class/corlib/Documentation/en/System/DBNull.xml b/mcs/class/corlib/Documentation/en/System/DBNull.xml
index a47edebf956..014c2e35bae 100644
--- a/mcs/class/corlib/Documentation/en/System/DBNull.xml
+++ b/mcs/class/corlib/Documentation/en/System/DBNull.xml
@@ -81,12 +81,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'TypeCode'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.TypeCode" /> value for <see cref="T:System.DBNull" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.TypeCode" /> value for <see cref="T:System.DBNull" />, which is <see cref="F:System.TypeCode.DBNull" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.IConvertible.ToBoolean">
@@ -105,12 +108,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to make this conversion throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>None. The return value for this member is not used.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface. (This parameter is not used; specify null.)</param>
       </Docs>
@@ -131,12 +137,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to make this conversion throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>None. The return value for this member is not used.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface. (This parameter is not used; specify null.)</param>
       </Docs>
@@ -157,12 +166,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to make this conversion throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>None. The return value for this member is not used.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface. (This parameter is not used; specify null.)</param>
       </Docs>
@@ -183,12 +195,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to make this conversion throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>None. The return value for this member is not used.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface. (This parameter is not used; specify null.)</param>
       </Docs>
@@ -209,12 +224,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to make this conversion throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>None. The return value for this member is not used.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface. (This parameter is not used; specify null.)</param>
       </Docs>
@@ -235,12 +253,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to make this conversion throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>None. The return value for this member is not used.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface. (This parameter is not used; specify null.)</param>
       </Docs>
@@ -261,12 +282,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to make this conversion throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>None. The return value for this member is not used.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface. (This parameter is not used; specify null.)</param>
       </Docs>
@@ -287,12 +311,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to make this conversion throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>None. The return value for this member is not used.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface. (This parameter is not used; specify null.)</param>
       </Docs>
@@ -313,12 +340,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to make this conversion throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>None. The return value for this member is not used.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface. (This parameter is not used; specify null.)</param>
       </Docs>
@@ -339,12 +369,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to make this conversion throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>None. The return value for this member is not used.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface. (This parameter is not used; specify null.)</param>
       </Docs>
@@ -365,12 +398,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to make this conversion throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>None. The return value for this member is not used.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface. (This parameter is not used; specify null.)</param>
       </Docs>
@@ -393,7 +429,6 @@
       </Parameters>
       <Docs>
         <param name="targetType">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Three conversions are supported: If the <paramref name="type" /> parameter specifies <see cref="T:System.Object" /> or <see cref="T:System.DBNull" />, the return value is the current <see cref="T:System.DBNull" /> object itself. If the <paramref name="type" /> parameter specifies <see cref="T:System.String" />, the return value is the string returned by the <see cref="M:System.DBNull.ToString" /> method.</para>
@@ -402,6 +437,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the current <see cref="T:System.DBNull" /> object to the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The boxed equivalent of the current <see cref="T:System.DBNull" /> object, if that conversion is supported; otherwise, an exception is thrown and no value is returned. </para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface and is used to augment the conversion. If null is specified, format information is obtained from the current culture. </param>
       </Docs>
@@ -422,12 +461,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to make this conversion throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>None. The return value for this member is not used.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface. (This parameter is not used; specify null.)</param>
       </Docs>
@@ -448,12 +490,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to make this conversion throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>None. The return value for this member is not used.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface. (This parameter is not used; specify null.)</param>
       </Docs>
@@ -474,12 +519,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to make this conversion throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>None. The return value for this member is not used.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface. (This parameter is not used; specify null.)</param>
       </Docs>
@@ -498,12 +546,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an empty string (<see cref="F:System.String.Empty" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An empty string (<see cref="F:System.String.Empty" />).</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -522,12 +573,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an empty string using the specified <see cref="T:System.IFormatProvider" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An empty string (<see cref="F:System.String.Empty" />).</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.IFormatProvider" /> to be used to format the return value.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System/DateTime.xml b/mcs/class/corlib/Documentation/en/System/DateTime.xml
index f0371defae5..e6d87535299 100644
--- a/mcs/class/corlib/Documentation/en/System/DateTime.xml
+++ b/mcs/class/corlib/Documentation/en/System/DateTime.xml
@@ -673,10 +673,6 @@
         <Parameter Name="value" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.DateTime" /> instance set to the sum of the date and time of the
-   current instance and the time interval represented by <paramref name="value" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">The resulting <see cref="T:System.DateTime" /> is less than <see cref="F:System.DateTime.MinValue" /> or greater than <see cref="F:System.DateTime.MaxValue" />.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -688,6 +684,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new <see cref="T:System.DateTime" /> that adds the value of the specified <see cref="T:System.TimeSpan" /> to the value of this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose value is the sum of the date and time represented by this instance and the time interval represented by <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A positive or negative time interval. </param>
       </Docs>
@@ -710,11 +710,6 @@
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.DateTime" /> instance set to the sum of the date and time represented
-   by the current instance and the number of days represented by
-<paramref name="value" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">The resulting <see cref="T:System.DateTime" /> is less than <see cref="F:System.DateTime.MinValue" /> or greater than <see cref="F:System.DateTime.MaxValue" />.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -726,6 +721,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new <see cref="T:System.DateTime" /> that adds the specified number of days to the value of this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose value is the sum of the date and time represented by this instance and the number of days represented by <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A number of whole and fractional days. The <paramref name="value" /> parameter can be negative or positive. </param>
       </Docs>
@@ -749,11 +748,6 @@
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.DateTime" /> instance set to the sum of the date and time represented
-   by the current instance and the number of hours represented by
-<paramref name="value" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">The resulting <see cref="T:System.DateTime" /> is less than <see cref="F:System.DateTime.MinValue" /> or greater than <see cref="F:System.DateTime.MaxValue" />.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -766,6 +760,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new <see cref="T:System.DateTime" /> that adds the specified number of hours to the value of this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose value is the sum of the date and time represented by this instance and the number of hours represented by <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A number of whole and fractional hours. The <paramref name="value" /> parameter can be negative or positive. </param>
       </Docs>
@@ -789,11 +787,6 @@
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.DateTime" /> instance set to the sum of the date and time represented
-   by the current instance and the number of milliseconds represented by
-<paramref name="value" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">The resulting <see cref="T:System.DateTime" /> is less than <see cref="F:System.DateTime.MinValue" /> or greater than <see cref="F:System.DateTime.MaxValue" />.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -805,6 +798,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new <see cref="T:System.DateTime" /> that adds the specified number of milliseconds to the value of this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose value is the sum of the date and time represented by this instance and the number of milliseconds represented by <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A number of whole and fractional milliseconds. The <paramref name="value" /> parameter can be negative or positive. Note that this value is rounded to the nearest integer.</param>
       </Docs>
@@ -828,11 +825,6 @@
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.DateTime" /> instance set to the sum of the date and time represented
-   by the current instance and the number of minutes represented by
-<paramref name="value" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">The resulting <see cref="T:System.DateTime" /> is less than <see cref="F:System.DateTime.MinValue" /> or greater than <see cref="F:System.DateTime.MaxValue" />.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -844,6 +836,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new <see cref="T:System.DateTime" /> that adds the specified number of minutes to the value of this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose value is the sum of the date and time represented by this instance and the number of minutes represented by <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A number of whole and fractional minutes. The <paramref name="value" /> parameter can be negative or positive. </param>
       </Docs>
@@ -867,10 +863,6 @@
         <Parameter Name="months" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.DateTime" /> instance set to the sum of the date and time represented
-   by the current instance and <paramref name="months" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>The resulting <see cref="T:System.DateTime" /> is less than <see cref="F:System.DateTime.MinValue" /> or greater than <see cref="F:System.DateTime.MaxValue" />.</para>
           <para>-or-</para>
@@ -885,6 +877,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new <see cref="T:System.DateTime" /> that adds the specified number of months to the value of this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose value is the sum of the date and time represented by this instance and <paramref name="months" />.</para>
+        </returns>
         <param name="months">
           <attribution license="cc4" from="Microsoft" modified="false" />A number of months. The <paramref name="months" /> parameter can be negative or positive. </param>
       </Docs>
@@ -907,11 +903,6 @@
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.DateTime" /> instance set to the sum of the date and time represented
-   by the current instance and the number of seconds represented by
-<paramref name="value" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">The resulting <see cref="T:System.DateTime" /> is less than <see cref="F:System.DateTime.MinValue" /> or greater than <see cref="F:System.DateTime.MaxValue" />.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -923,6 +914,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new <see cref="T:System.DateTime" /> that adds the specified number of seconds to the value of this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose value is the sum of the date and time represented by this instance and the number of seconds represented by <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A number of whole and fractional seconds. The <paramref name="value" /> parameter can be negative or positive. </param>
       </Docs>
@@ -946,10 +941,6 @@
         <Parameter Name="value" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.DateTime" /> instance set to the sum of the date and time represented
-   by the current instance and the time represented by <paramref name="value" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">The resulting <see cref="T:System.DateTime" /> is less than <see cref="F:System.DateTime.MinValue" /> or greater than <see cref="F:System.DateTime.MaxValue" />.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -959,6 +950,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new <see cref="T:System.DateTime" /> that adds the specified number of ticks to the value of this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose value is the sum of the date and time represented by this instance and the time represented by <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A number of 100-nanosecond ticks. The <paramref name="value" /> parameter can be positive or negative. </param>
       </Docs>
@@ -981,11 +976,6 @@
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.DateTime" /> instance set to the sum of the date and time represented
-   by the current instance and the number of years represented by
-<paramref name="value" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">The resulting <see cref="T:System.DateTime" /> is less than <see cref="F:System.DateTime.MinValue" /> or greater than <see cref="F:System.DateTime.MaxValue" />.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1007,6 +997,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new <see cref="T:System.DateTime" /> that adds the specified number of years to the value of this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose value is the sum of the date and time represented by this instance and the number of years represented by <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A number of years. The <paramref name="value" /> parameter can be negative or positive. </param>
       </Docs>
@@ -1030,44 +1024,57 @@
         <Parameter Name="t2" Type="System.DateTime" />
       </Parameters>
       <Docs>
+        <remarks>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Before comparing <see cref="T:System.DateTime" /> objects, ensure that the objects represent times in the same time zone.</para>
+        </remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Compares two instances of <see cref="T:System.DateTime" /> and returns an integer that indicates whether the first instance is earlier than, the same as, or later than the second instance.</para>
+        </summary>
         <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the two specified instances of <see cref="T:System.DateTime" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number indicating the relative values of <paramref name="t1" /> and <paramref name="t2" />.</para>
           <list type="table">
             <listheader>
-              <term>Value Type</term>
-              <description>Condition</description>
+              <item>
+                <term>
+                  <para>Value Type </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
             </listheader>
             <item>
-              <term> Any
-         negative
-         number</term>
+              <term>
+                <para>Less than zero </para>
+              </term>
               <description>
-                <paramref name="t1" /> &lt; <paramref name="t2" />.</description>
+                <para>
+                  <paramref name="t1" /> is earlier than <paramref name="t2" />. </para>
+              </description>
             </item>
             <item>
-              <term> Zero</term>
+              <term>
+                <para>Zero </para>
+              </term>
               <description>
-                <paramref name="t1" /> == <paramref name="t2" />.</description>
+                <para>
+                  <paramref name="t1" /> is the same as <paramref name="t2" />. </para>
+              </description>
             </item>
             <item>
-              <term> Any
-      positive
-      number</term>
+              <term>
+                <para>Greater than zero </para>
+              </term>
               <description>
-                <paramref name="t1" /> &gt;
-<paramref name="t2" />
-.</description>
+                <para>
+                  <paramref name="t1" /> is later than <paramref name="t2" />. </para>
+              </description>
             </item>
           </list>
         </returns>
-        <remarks>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Before comparing <see cref="T:System.DateTime" /> objects, ensure that the objects represent times in the same time zone.</para>
-        </remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Compares two instances of <see cref="T:System.DateTime" /> and returns an integer that indicates whether the first instance is earlier than, the same as, or later than the second instance.</para>
-        </summary>
         <param name="t1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare. </param>
         <param name="t2">
@@ -1090,37 +1097,56 @@
         <Parameter Name="value" Type="System.DateTime" />
       </Parameters>
       <Docs>
+        <since version=".NET 2.0" />
+        <remarks>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method implements the <see cref="T:System.IComparable`1" /> interface and performs slightly better than the <see cref="M:System.DateTime.CompareTo(System.Object)" /> method overload because it does not have to convert the <paramref name="value" /> parameter to an object.</para>
+          <para>Before comparing <see cref="T:System.DateTime" /> objects, make sure that the objects represent times in the same time zone. You can do this by comparing the values of their <see cref="P:System.DateTime.Kind" /> properties.</para>
+        </remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Compares the value of this instance to a specified <see cref="T:System.DateTime" /> value and returns an integer that indicates whether this instance is earlier than, the same as, or later than the specified <see cref="T:System.DateTime" /> value.</para>
+        </summary>
         <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="value" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number indicating the relative values of this instance and the <paramref name="value" /> parameter.</para>
           <list type="table">
             <listheader>
-              <term>Value</term>
-              <description>Description</description>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
             </listheader>
             <item>
-              <term> A negative number</term>
-              <description>Current instance &lt; <paramref name="value" />.</description>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is earlier than <paramref name="value" />. </para>
+              </description>
             </item>
             <item>
-              <term> Zero</term>
-              <description>Current instance == <paramref name="value" />.</description>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is the same as <paramref name="value" />. </para>
+              </description>
             </item>
             <item>
-              <term> A positive number</term>
-              <description>Current instance &gt; <paramref name="value" />.</description>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is later than <paramref name="value" />. </para>
+              </description>
             </item>
           </list>
         </returns>
-        <since version=".NET 2.0" />
-        <remarks>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>This method implements the <see cref="T:System.IComparable`1" /> interface and performs slightly better than the <see cref="M:System.DateTime.CompareTo(System.Object)" /> method overload because it does not have to convert the <paramref name="value" /> parameter to an object.</para>
-          <para>Before comparing <see cref="T:System.DateTime" /> objects, make sure that the objects represent times in the same time zone. You can do this by comparing the values of their <see cref="P:System.DateTime.Kind" /> properties.</para>
-        </remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Compares the value of this instance to a specified <see cref="T:System.DateTime" /> value and returns an integer that indicates whether this instance is earlier than, the same as, or later than the specified <see cref="T:System.DateTime" /> value.</para>
-        </summary>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to the current instance. </param>
       </Docs>
@@ -1142,39 +1168,57 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="value" /> is not a <see cref="T:System.DateTime" /> and is not a null reference.</exception>
+        <remarks>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Before comparing <see cref="T:System.DateTime" /> objects, make sure that the objects represent times in the same time zone. You can do this by comparing the values of their <see cref="P:System.DateTime.Kind" /> properties.</para>
+          <para>Any instance of <see cref="T:System.DateTime" />, regardless of its value, is considered greater than null.</para>
+        </remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Compares the value of this instance to a specified object that contains a specified <see cref="T:System.DateTime" /> value, and returns an integer that indicates whether this instance is earlier than, the same as, or later than the specified <see cref="T:System.DateTime" /> value.</para>
+        </summary>
         <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="value" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number indicating the relative values of this instance and <paramref name="value" />.</para>
           <list type="table">
             <listheader>
-              <term>Value</term>
-              <description>Description</description>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
             </listheader>
             <item>
-              <term> A negative number</term>
-              <description>Current instance &lt; <paramref name="value" />.</description>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is earlier than <paramref name="value" />. </para>
+              </description>
             </item>
             <item>
-              <term> Zero</term>
-              <description>Current instance == <paramref name="value" />.</description>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is the same as <paramref name="value" />. </para>
+              </description>
             </item>
             <item>
-              <term> A positive number</term>
-              <description>Current instance &gt; <paramref name="value" />, or value is a
-   null reference.</description>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is later than <paramref name="value" />, or <paramref name="value" /> is null. </para>
+              </description>
             </item>
           </list>
         </returns>
-        <exception cref="T:System.ArgumentException">
-          <paramref name="value" /> is not a <see cref="T:System.DateTime" /> and is not a null reference.</exception>
-        <remarks>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Before comparing <see cref="T:System.DateTime" /> objects, make sure that the objects represent times in the same time zone. You can do this by comparing the values of their <see cref="P:System.DateTime.Kind" /> properties.</para>
-          <para>Any instance of <see cref="T:System.DateTime" />, regardless of its value, is considered greater than null.</para>
-        </remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Compares the value of this instance to a specified object that contains a specified <see cref="T:System.DateTime" /> value, and returns an integer that indicates whether this instance is earlier than, the same as, or later than the specified <see cref="T:System.DateTime" /> value.</para>
-        </summary>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A boxed object to compare, or null. </param>
       </Docs>
@@ -1315,11 +1359,6 @@
         <Parameter Name="month" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> set to the number of days in the specified month for the
-   specified year. If the specified month is February, the return value is 28 or 29
-   depending upon whether the specified year is a leap year.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="month" /> is less than 1 or greater than 12.</exception>
         <remarks>
@@ -1330,6 +1369,11 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of days in the specified month and year.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of days in <paramref name="month" /> for the specified <paramref name="year" />.</para>
+          <para>For example, if <paramref name="month" /> equals 2 for February, the return value is 28 or 29 depending upon whether <paramref name="year" /> is a leap year.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />The year. </param>
         <param name="month">
@@ -1352,10 +1396,6 @@
         <Parameter Name="value" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="value" /> is equal to the current instance; otherwise, <see langword="false" />.</para>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1366,6 +1406,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the value of this instance is equal to the value of the specified <see cref="T:System.DateTime" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="value" /> parameter equals the value of this instance; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to this instance. </param>
       </Docs>
@@ -1387,13 +1431,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="value" /> is a specified
-<see cref="T:System.DateTime" /> 
-instance is equal to the current instance; otherwise,
-<see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The current instance and <paramref name="value" /> are equal if their <see cref="P:System.DateTime.Ticks" /> property values are equal. Their <see cref="P:System.DateTime.Kind" /> property values are not considered in the test for equality.</para>
@@ -1402,6 +1439,10 @@ instance is equal to the current instance; otherwise,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is an instance of <see cref="T:System.DateTime" /> and equals the value of this instance; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to this instance. </param>
       </Docs>
@@ -1425,12 +1466,6 @@ instance is equal to the current instance; otherwise,
         <Parameter Name="t2" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the two
-<see cref="T:System.DateTime" /> values are
-   equal; otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -1440,6 +1475,10 @@ instance is equal to the current instance; otherwise,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether two <see cref="T:System.DateTime" /> instances  have the same date and time value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two values are equal; otherwise, false.</para>
+        </returns>
         <param name="t1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare. </param>
         <param name="t2">
@@ -1462,7 +1501,6 @@ instance is equal to the current instance; otherwise,
         <Parameter Name="dateData" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1495,6 +1533,10 @@ instance is equal to the current instance; otherwise,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Deserializes a 64-bit binary value and recreates an original serialized <see cref="T:System.DateTime" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is equivalent to the <see cref="T:System.DateTime" /> object that was serialized by the <see cref="M:System.DateTime.ToBinary" /> method.</para>
+        </returns>
         <param name="dateData">
           <attribution license="cc4" from="Microsoft" modified="false" />A 64-bit signed integer that encodes the <see cref="P:System.DateTime.Kind" /> property in a 2-bit field and the <see cref="P:System.DateTime.Ticks" /> property in a 62-bit field. </param>
       </Docs>
@@ -1515,7 +1557,6 @@ instance is equal to the current instance; otherwise,
         <Parameter Name="fileTime" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A Windows file time is a 64-bit value that represents the number of 100-nanosecond intervals that have elapsed since 12:00 midnight, January 1, 1601 A.D. (C.E.) Coordinated Universal Time (UTC). Windows uses a file time to record when an application creates, accesses, or writes to a file. </para>
@@ -1526,6 +1567,10 @@ instance is equal to the current instance; otherwise,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified Windows file time to an equivalent local time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the local time equivalent of the date and time represented by the <paramref name="fileTime" /> parameter.</para>
+        </returns>
         <param name="fileTime">
           <attribution license="cc4" from="Microsoft" modified="false" />A Windows file time expressed in ticks. </param>
       </Docs>
@@ -1546,7 +1591,6 @@ instance is equal to the current instance; otherwise,
         <Parameter Name="fileTime" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A Windows file time is a 64-bit value that represents the number of 100-nanosecond intervals that have elapsed since 12:00 midnight, January 1, 1601 A.D. (C.E.) Coordinated Universal Time (UTC). Windows uses a file time to record when an application creates, accesses, or writes to a file. </para>
@@ -1557,6 +1601,10 @@ instance is equal to the current instance; otherwise,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified Windows file time to an equivalent UTC time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the UTC time equivalent of the date and time represented by the <paramref name="fileTime" /> parameter.</para>
+        </returns>
         <param name="fileTime">
           <attribution license="cc4" from="Microsoft" modified="false" />A Windows file time expressed in ticks. </param>
       </Docs>
@@ -1577,7 +1625,6 @@ instance is equal to the current instance; otherwise,
         <Parameter Name="d" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="d" /> parameter is a double-precision floating-point number that represents a date as the number of days before or after the base date, midnight, 30 December 1899. The sign and integral part of <paramref name="d" /> encode the date as a positive or negative day displacement from 30 December 1899, and the absolute value of the fractional part of <paramref name="d" /> encodes the time of day as a fraction of a day displacement from midnight. <paramref name="d" /> must be a value between negative 657435.0 through positive 2958465.99999999.</para>
@@ -1588,6 +1635,10 @@ instance is equal to the current instance; otherwise,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.DateTime" /> equivalent to the specified OLE Automation Date.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the same date and time as <paramref name="d" />.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />An OLE Automation Date value. </param>
       </Docs>
@@ -1606,7 +1657,6 @@ instance is equal to the current instance; otherwise,
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The string array returned by the <see cref="M:System.DateTime.GetDateTimeFormats" /> method is equivalent to combining the string arrays returned by separate calls to the <see cref="M:System.DateTime.GetDateTimeFormats(System.Char)" /> method with the "d", "D", "f", "F", "g", "G", "m", "o", "r", "s", "t", "T", "u", "U", and "y" standard format strings. For more information about standard format specifiers, see <format type="text/html"><a href="bb79761a-ca08-44ee-b142-b06b3e2fc22b">Standard Date and Time Format Strings</a></format>.</para>
@@ -1619,6 +1669,10 @@ instance is equal to the current instance; otherwise,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to all the string representations supported by the standard date and time format specifiers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string array where each element is the representation of the value of this instance formatted with one of the standard date and time format specifiers.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetDateTimeFormats">
@@ -1637,7 +1691,6 @@ instance is equal to the current instance; otherwise,
         <Parameter Name="format" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="format" /> parameter can be any of the standard date and time format specifiers. These include d, D, f, F, g, G, M (or m), O (or o), R (or r), s, t, T, u, U, and Y (or y). For more information, see <format type="text/html"><a href="bb79761a-ca08-44ee-b142-b06b3e2fc22b">Standard Date and Time Format Strings</a></format>.</para>
@@ -1650,6 +1703,10 @@ instance is equal to the current instance; otherwise,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to all the string representations supported by the specified standard date and time format specifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string array where each element is the representation of the value of this instance formatted with the <paramref name="format" /> standard date and time format specifier.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A standard date and time format string (see Remarks). </param>
       </Docs>
@@ -1670,7 +1727,6 @@ instance is equal to the current instance; otherwise,
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The string array returned by the <see cref="M:System.DateTime.GetDateTimeFormats(System.IFormatProvider)" /> method is equivalent to combining the string arrays returned by separate calls to the <see cref="M:System.DateTime.GetDateTimeFormats(System.Char,System.IFormatProvider)" /> method with the "d", "D", "f", "F", "g", "G", "m", "o", "r", "s", "t", "T", "u", "U", and "y" standard format strings. For more information about standard format specifiers, see <format type="text/html"><a href="bb79761a-ca08-44ee-b142-b06b3e2fc22b">Standard Date and Time Format Strings</a></format>.</para>
@@ -1683,6 +1739,10 @@ instance is equal to the current instance; otherwise,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to all the string representations supported by the standard date and time format specifiers and the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string array where each element is the representation of the value of this instance formatted with one of the standard date and time format specifiers.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information about this instance. </param>
       </Docs>
@@ -1704,7 +1764,6 @@ instance is equal to the current instance; otherwise,
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The format parameter can be any of the standard date and time format specifiers. These include d, D, f, F, g, G, M (or m), O (or o), R (or r), s, t, T, u, U, and Y (or y). For more information, see <format type="text/html"><a href="bb79761a-ca08-44ee-b142-b06b3e2fc22b">Standard Date and Time Format Strings</a></format>.</para>
@@ -1717,6 +1776,10 @@ instance is equal to the current instance; otherwise,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to all the string representations supported by the specified standard date and time format specifier and culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string array where each element is the representation of the value of this instance formatted with one of the standard date and time format specifiers.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A date and time format string (see Remarks). </param>
         <param name="provider">
@@ -1738,10 +1801,6 @@ instance is equal to the current instance; otherwise,
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the hash code
-   for this instance.</para>
-        </returns>
         <remarks>
           <para> The algorithm used to
       generate the hash code is unspecified.</para>
@@ -1754,6 +1813,10 @@ instance is equal to the current instance; otherwise,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1771,12 +1834,15 @@ instance is equal to the current instance; otherwise,
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.TypeCode" /> for value type <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The enumerated constant, <see cref="F:System.TypeCode.DateTime" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Hour">
@@ -1823,7 +1889,6 @@ instance is equal to the current instance; otherwise,
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1835,6 +1900,10 @@ instance is equal to the current instance; otherwise,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether this instance of <see cref="T:System.DateTime" /> is within the daylight saving time range for the current time zone.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of the <see cref="P:System.DateTime.Kind" /> property is <see cref="F:System.DateTimeKind.Local" /> or <see cref="F:System.DateTimeKind.Unspecified" /> and the value of this instance of <see cref="T:System.DateTime" /> is within the daylight saving time range for the local time zone; false if <see cref="P:System.DateTime.Kind" /> is <see cref="F:System.DateTimeKind.Utc" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsLeapYear">
@@ -1854,11 +1923,6 @@ instance is equal to the current instance; otherwise,
         <Parameter Name="year" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the specified year is a leap
-   year; otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -1870,6 +1934,10 @@ instance is equal to the current instance; otherwise,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an indication whether the specified year is a leap year.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="year" /> is a leap year; otherwise, false.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />A 4-digit year. </param>
       </Docs>
@@ -2130,10 +2198,6 @@ instance is equal to the current instance; otherwise,
         <Parameter Name="t" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.DateTime" /> instance that is the sum of the values of <paramref name="d" /> and
-<paramref name="t" /> .</para>
-        </returns>
         <remarks>
           <para>The returned value is equivalent to
    <see langword="DateTime" />( <paramref name="d" />.Ticks + <paramref name="t" />.Ticks ).</para>
@@ -2144,6 +2208,10 @@ instance is equal to the current instance; otherwise,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a specified time interval to a specified date and time, yielding a new date and time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is the sum of the values of <paramref name="d" /> and <paramref name="t" />.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time value to add. </param>
         <param name="t">
@@ -2169,13 +2237,6 @@ instance is equal to the current instance; otherwise,
         <Parameter Name="d2" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if
-<paramref name="d1" />.Ticks value is equal to the 
-<paramref name="d2" />.Ticks value; otherwise, 
-<see langword="false" />. </para>
-        </returns>
         <altmember cref="M:System.DateTime.Equals(System.Object)" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2185,6 +2246,10 @@ instance is equal to the current instance; otherwise,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two specified instances of <see cref="T:System.DateTime" /> are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="d1" /> and <paramref name="d2" /> represent the same date and time; otherwise, false.</para>
+        </returns>
         <param name="d1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare. </param>
         <param name="d2">
@@ -2210,12 +2275,6 @@ instance is equal to the current instance; otherwise,
         <Parameter Name="t2" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if
-<paramref name="t1" />.Ticks value is greater than the 
-<paramref name="t2" />.Ticks value; otherwise, <see langword="false" />.</para>
-        </returns>
         <altmember cref="M:System.DateTime.Compare(System.DateTime,System.DateTime)" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2225,6 +2284,10 @@ instance is equal to the current instance; otherwise,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether one specified <see cref="T:System.DateTime" /> is later than another specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="t1" /> is later than <paramref name="t2" />; otherwise, false.</para>
+        </returns>
         <param name="t1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare. </param>
         <param name="t2">
@@ -2250,12 +2313,6 @@ instance is equal to the current instance; otherwise,
         <Parameter Name="t2" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if
-<paramref name="t1" />.Ticks value is greater than or equal to 
-<paramref name="t2" />.Ticks value; otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.DateTime.op_GreaterThanOrEqual(System.DateTime,System.DateTime)" /> operator determines the relationship between two <see cref="T:System.DateTime" /> values by comparing their number of ticks. Before comparing <see cref="T:System.DateTime" /> objects, make sure that the objects represent times in the same time zone. You can do this by comparing the values of their <see cref="P:System.DateTime.Kind" /> property. </para>
@@ -2264,6 +2321,10 @@ instance is equal to the current instance; otherwise,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether one specified <see cref="T:System.DateTime" /> represents a date and time that is the same as or later than another specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="t1" /> is the same as or later than <paramref name="t2" />; otherwise, false.</para>
+        </returns>
         <param name="t1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare. </param>
         <param name="t2">
@@ -2289,13 +2350,6 @@ instance is equal to the current instance; otherwise,
         <Parameter Name="d2" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if
-<paramref name="d1" />.Ticks value is not equal to 
-<paramref name="d2" />.Ticks value; otherwise, <see langword="false" />.
-   </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.DateTime.op_Inequality(System.DateTime,System.DateTime)" /> operator determines whether two <see cref="T:System.DateTime" /> values are not equal by comparing their number of ticks. Before comparing <see cref="T:System.DateTime" /> objects, make sure that the objects represent times in the same time zone. You can do this by comparing the values of their <see cref="P:System.DateTime.Kind" /> property. </para>
@@ -2304,6 +2358,10 @@ instance is equal to the current instance; otherwise,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two specified instances of <see cref="T:System.DateTime" /> are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="d1" /> and <paramref name="d2" /> do not represent the same date and time; otherwise, false.</para>
+        </returns>
         <param name="d1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare. </param>
         <param name="d2">
@@ -2329,12 +2387,6 @@ instance is equal to the current instance; otherwise,
         <Parameter Name="t2" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if
-<paramref name="t1" />.Ticks value is less than 
-<paramref name="t2" />.Ticks value; otherwise, <see langword="false" />.</para>
-        </returns>
         <altmember cref="M:System.DateTime.Compare(System.DateTime,System.DateTime)" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2344,6 +2396,10 @@ instance is equal to the current instance; otherwise,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether one specified <see cref="T:System.DateTime" /> is earlier than another specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="t1" /> is earlier than <paramref name="t2" />; otherwise, false.</para>
+        </returns>
         <param name="t1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare. </param>
         <param name="t2">
@@ -2369,12 +2425,6 @@ instance is equal to the current instance; otherwise,
         <Parameter Name="t2" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if
-<paramref name="t1" />.Ticks value is less than or equal to 
-<paramref name="t2" />.Ticks value; otherwise, <see langword="false" />.</para>
-        </returns>
         <altmember cref="M:System.DateTime.Compare(System.DateTime,System.DateTime)" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2384,6 +2434,10 @@ instance is equal to the current instance; otherwise,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether one specified <see cref="T:System.DateTime" /> represents a date and time that is the same as or earlier than another specified <see cref="T:System.DateTime" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="t1" /> is the same as or later than <paramref name="t2" />; otherwise, false.</para>
+        </returns>
         <param name="t1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare. </param>
         <param name="t2">
@@ -2409,10 +2463,6 @@ instance is equal to the current instance; otherwise,
         <Parameter Name="d2" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.TimeSpan" /> that is the time interval between <paramref name="d1" /> and
-<paramref name="d2" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">The resulting date and time is less than <see cref="F:System.DateTime.MinValue" /> or greater than <see cref="F:System.DateTime.MaxValue" />.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2425,6 +2475,10 @@ instance is equal to the current instance; otherwise,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts a specified date and time from another specified date and time and returns a time interval.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The time interval between <paramref name="d1" /> and <paramref name="d2" />; that is, <paramref name="d1" /> minus <paramref name="d2" />.</para>
+        </returns>
         <param name="d1">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time value to subtract from (the minuend). </param>
         <param name="d2">
@@ -2450,11 +2504,6 @@ instance is equal to the current instance; otherwise,
         <Parameter Name="t" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.DateTime" /> whose value is the value of <paramref name="d" /> minus the value
-   of <paramref name="t" />
-   .</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">The resulting date and time is less than <see cref="F:System.DateTime.MinValue" /> or greater than <see cref="F:System.DateTime.MaxValue" />.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2464,6 +2513,10 @@ instance is equal to the current instance; otherwise,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts a specified time interval from a specified date and time and returns a new date and time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose value is the value of <paramref name="d" /> minus the value of <paramref name="t" />.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time value to subtract from. </param>
         <param name="t">
@@ -2488,9 +2541,6 @@ instance is equal to the current instance; otherwise,
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> The <see cref="T:System.DateTime" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -2505,6 +2555,10 @@ instance is equal to the current instance; otherwise,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a date and time to its <see cref="T:System.DateTime" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is equivalent to the date and time contained in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a date and time to convert. </param>
       </Docs>
@@ -2528,9 +2582,6 @@ instance is equal to the current instance; otherwise,
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.DateTime" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -2545,6 +2596,10 @@ instance is equal to the current instance; otherwise,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a date and time to its <see cref="T:System.DateTime" /> equivalent by using culture-specific format information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is equivalent to the date and time contained in <paramref name="s" /> as specified by <paramref name="provider" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a date and time to convert. </param>
         <param name="provider">
@@ -2571,9 +2626,6 @@ instance is equal to the current instance; otherwise,
         <Parameter Name="styles" Type="System.Globalization.DateTimeStyles" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.DateTime" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -2590,6 +2642,10 @@ instance is equal to the current instance; otherwise,
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a date and time to its <see cref="T:System.DateTime" /> equivalent by using culture-specific format information and formatting style.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is equivalent to the date and time contained in <paramref name="s" />, as specified by <paramref name="provider" /> and <paramref name="styles" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a date and time to convert. </param>
         <param name="provider">
@@ -2618,10 +2674,6 @@ instance is equal to the current instance; otherwise,
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.DateTime" /> equivalent to the date and time contained in
-<paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s " />or <paramref name="format" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -2677,6 +2729,10 @@ public class DateTimeTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a date and time to its <see cref="T:System.DateTime" /> equivalent using the specified format and culture-specific format information. The format of the string representation must match the specified format exactly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is equivalent to the date and time contained in <paramref name="s" />, as specified by <paramref name="format" /> and <paramref name="provider" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a date and time to convert. </param>
         <param name="format">
@@ -2706,10 +2762,6 @@ public class DateTimeTest {
         <Parameter Name="style" Type="System.Globalization.DateTimeStyles" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.DateTime" /> equivalent to the date and time contained in
-<paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s " />or <paramref name="format" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -2880,6 +2932,10 @@ public class DateTimeTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a date and time to its <see cref="T:System.DateTime" /> equivalent using the specified format, culture-specific format information, and style. The format of the string representation must match the specified format exactly or an exception is thrown.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is equivalent to the date and time contained in <paramref name="s" />, as specified by <paramref name="format" />, <paramref name="provider" />, and <paramref name="style" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string containing a date and time to convert. </param>
         <param name="format">
@@ -2911,10 +2967,6 @@ public class DateTimeTest {
         <Parameter Name="style" Type="System.Globalization.DateTimeStyles" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.DateTime" /> equivalent to the date and time contained in
-<paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s " />or <paramref name="formats" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -3083,6 +3135,10 @@ public class DateTimeTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a date and time to its <see cref="T:System.DateTime" /> equivalent using the specified array of formats, culture-specific format information, and style. The format of the string representation must match at least one of the specified formats exactly or an exception is thrown.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is equivalent to the date and time contained in <paramref name="s" />, as specified by <paramref name="formats" />, <paramref name="provider" />, and <paramref name="style" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a date and time to convert. </param>
         <param name="formats">
@@ -3138,7 +3194,6 @@ public class DateTimeTest {
         <Parameter Name="kind" Type="System.DateTimeKind" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3152,6 +3207,10 @@ public class DateTimeTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new <see cref="T:System.DateTime" /> object that has the same number of ticks as the specified <see cref="T:System.DateTime" />, but is designated as either local time, Coordinated Universal Time (UTC), or neither, as indicated by the specified <see cref="T:System.DateTimeKind" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new object that has the same number of ticks as the object represented by the <paramref name="value" /> parameter and the <see cref="T:System.DateTimeKind" /> value specified by the <paramref name="kind" /> parameter. </para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A date and time. </param>
         <param name="kind">
@@ -3175,11 +3234,6 @@ public class DateTimeTest {
         <Parameter Name="value" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.TimeSpan" /> interval equal to
-   the date and time represented by the current instance minus the date and time
-   represented by the specified <see cref="T:System.DateTime" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the date and time of the current instance is earlier than <paramref name="value" />, the method returns a <see cref="T:System.TimeSpan" /> object that represents a negative time span. That is, the value of all of its non-zero properties (such as <see cref="P:System.TimeSpan.Days" /> or <see cref="P:System.TimeSpan.Ticks" />) is negative.</para>
@@ -3192,6 +3246,10 @@ public class DateTimeTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts the specified date and time from this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A time interval that is equal to the date and time represented by this instance minus the date and time represented by <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time value to subtract. </param>
       </Docs>
@@ -3214,10 +3272,6 @@ public class DateTimeTest {
         <Parameter Name="value" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.DateTime" /> instance equal to the date and time represented by the
-   current instance minus the time interval of the specified <see cref="T:System.TimeSpan" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">The resulting date and time is less than <see cref="F:System.DateTime.MinValue" /> or greater than <see cref="F:System.DateTime.MaxValue" />.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3263,6 +3317,10 @@ public class DateTimeTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts the specified duration from this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is equal to the date and time represented by this instance minus the time interval represented by <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The time interval to subtract. </param>
       </Docs>
@@ -3284,12 +3342,15 @@ public class DateTimeTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to use this method throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value for this member is not used.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface. (This parameter is not used; specify null.)</param>
       </Docs>
@@ -3310,12 +3371,15 @@ public class DateTimeTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to use this method throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value for this member is not used.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface. (This parameter is not used; specify null.)</param>
       </Docs>
@@ -3336,12 +3400,15 @@ public class DateTimeTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to use this method throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value for this member is not used.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface. (This parameter is not used; specify null.)</param>
       </Docs>
@@ -3362,12 +3429,15 @@ public class DateTimeTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the current <see cref="T:System.DateTime" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current object.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface. (This parameter is not used; specify null.)</param>
       </Docs>
@@ -3388,12 +3458,15 @@ public class DateTimeTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to use this method throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value for this member is not used.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface. (This parameter is not used; specify null.)</param>
       </Docs>
@@ -3414,12 +3487,15 @@ public class DateTimeTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to use this method throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value for this member is not used.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface. (This parameter is not used; specify null.)</param>
       </Docs>
@@ -3440,12 +3516,15 @@ public class DateTimeTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to use this method throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value for this member is not used.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface. (This parameter is not used; specify null.)</param>
       </Docs>
@@ -3466,12 +3545,15 @@ public class DateTimeTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to use this method throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value for this member is not used.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface. (This parameter is not used; specify null.)</param>
       </Docs>
@@ -3492,12 +3574,15 @@ public class DateTimeTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to use this method throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value for this member is not used.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface. (This parameter is not used; specify null.)</param>
       </Docs>
@@ -3518,12 +3603,15 @@ public class DateTimeTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to use this method throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value for this member is not used.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface. (This parameter is not used; specify null.)</param>
       </Docs>
@@ -3544,12 +3632,15 @@ public class DateTimeTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to use this method throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value for this member is not used.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface. (This parameter is not used; specify null.)</param>
       </Docs>
@@ -3572,12 +3663,15 @@ public class DateTimeTest {
       </Parameters>
       <Docs>
         <param name="targetType">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the current <see cref="T:System.DateTime" /> object to an object of a specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object of the type specified by the <paramref name="type" /> parameter, with a value equivalent to the current <see cref="T:System.DateTime" /> object.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface. (This parameter is not used; specify null.)</param>
       </Docs>
@@ -3598,12 +3692,15 @@ public class DateTimeTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to use this method throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value for this member is not used.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface. (This parameter is not used; specify null.)</param>
       </Docs>
@@ -3624,12 +3721,15 @@ public class DateTimeTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to use this method throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value for this member is not used.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface. (This parameter is not used; specify null.)</param>
       </Docs>
@@ -3650,12 +3750,15 @@ public class DateTimeTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to use this method throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The return value for this member is not used.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that implements the <see cref="T:System.IFormatProvider" /> interface. (This parameter is not used; specify null.)</param>
       </Docs>
@@ -3765,7 +3868,6 @@ public class DateTimeTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3798,6 +3900,10 @@ public class DateTimeTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serializes the current <see cref="T:System.DateTime" /> object to a 64-bit binary value that subsequently can be used to recreate the <see cref="T:System.DateTime" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit signed integer that encodes the <see cref="P:System.DateTime.Kind" /> and <see cref="P:System.DateTime.Ticks" /> properties. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Today">
@@ -3845,7 +3951,6 @@ public class DateTimeTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A Windows file time is a 64-bit value that represents the number of 100-nanosecond intervals that have elapsed since 12:00 midnight, January 1, 1601 A.D. (C.E.) Coordinated Universal Time (UTC). Windows uses a file time to record when an application creates, accesses, or writes to a file. </para>
@@ -3855,6 +3960,10 @@ public class DateTimeTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current <see cref="T:System.DateTime" /> object to a Windows file time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current <see cref="T:System.DateTime" /> object expressed as a Windows file time.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToFileTimeUtc">
@@ -3871,7 +3980,6 @@ public class DateTimeTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A Windows file time is a 64-bit value that represents the number of 100-nanosecond intervals that have elapsed since 12:00 midnight, January 1, 1601 A.D. (C.E.) Coordinated Universal Time (UTC). Windows uses a file time to record when an application creates, accesses, or writes to a file. </para>
@@ -3881,6 +3989,10 @@ public class DateTimeTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current <see cref="T:System.DateTime" /> object to a Windows file time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current <see cref="T:System.DateTime" /> object expressed as a Windows file time.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToLocalTime">
@@ -3898,14 +4010,6 @@ public class DateTimeTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>An instance of <see cref="T:System.DateTime" /> equivalent of the time value in the
-   current instance, adjusted to the local time zone and daylight saving time. If
-   the result is too large or too small to be represented as a <see cref="T:System.DateTime" /> , this
-   method returns a <see cref="T:System.DateTime" /> set to <see cref="F:System.DateTime.MaxValue" /> or <see cref="F:System.DateTime.MinValue" />
-   
-   .</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The local time is equal to the Coordinated Universal Time (UTC) time plus the UTC offset. For more information about the UTC offset, see <see cref="M:System.TimeZone.GetUtcOffset(System.DateTime)" />. The conversion also takes into account the daylight saving time rule that applies to the time represented by the current <see cref="T:System.DateTime" /> object. </para>
@@ -3964,6 +4068,10 @@ public class DateTimeTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current <see cref="T:System.DateTime" /> object to local time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose <see cref="P:System.DateTime.Kind" /> property is <see cref="F:System.DateTimeKind.Local" />, and whose value is the local time equivalent to the value of the current <see cref="T:System.DateTime" /> object, or <see cref="F:System.DateTime.MaxValue" /> if the converted value is too large to be represented by a <see cref="T:System.DateTime" /> object, or <see cref="F:System.DateTime.MinValue" /> if the converted value is too small to be represented as a <see cref="T:System.DateTime" /> object.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -3982,12 +4090,6 @@ public class DateTimeTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing the same value as a <see cref="T:System.String" /> returned by
-<see cref="M:System.DateTime.ToString" /> ("D", 
-<see langword="null" />
-).</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The value of the current <see cref="T:System.DateTime" /> object is formatted using the pattern defined by the <see cref="P:System.Globalization.DateTimeFormatInfo.LongDatePattern" /> property associated with the current thread culture. The return value is identical to the value returned by specifying the "D" <format type="text/html"><a href="bb79761a-ca08-44ee-b142-b06b3e2fc22b">standard DateTime format string</a></format> with the <see cref="M:System.DateTime.ToString(System.String)" /> method. </para>
@@ -4000,6 +4102,10 @@ public class DateTimeTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current <see cref="T:System.DateTime" /> object to its equivalent long date string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the long date string representation of the current <see cref="T:System.DateTime" /> object.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -4018,12 +4124,6 @@ public class DateTimeTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing the same value as a <see cref="T:System.String" /> returned by
-<see cref="M:System.DateTime.ToString" /> ("T", 
-<see langword="null" /> 
-).</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The value of the current <see cref="T:System.DateTime" /> object is formatted using the pattern defined by the <see cref="P:System.Globalization.DateTimeFormatInfo.LongTimePattern" /> property associated with the current thread culture. The return value is identical to the value returned by specifying the "T" <format type="text/html"><a href="bb79761a-ca08-44ee-b142-b06b3e2fc22b">standard date and time format string</a></format> with the <see cref="M:System.DateTime.ToString(System.String)" /> method. </para>
@@ -4036,6 +4136,10 @@ public class DateTimeTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current <see cref="T:System.DateTime" /> object to its equivalent long time string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the long time string representation of the current <see cref="T:System.DateTime" /> object.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -4053,7 +4157,6 @@ public class DateTimeTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An OLE Automation date is implemented as a floating-point number whose integral component is the number of days before or after midnight, 30 December 1899, and whose fractional component represents the time on that day divided by 24. For example, midnight, 31 December 1899 is represented by 1.0; 6 A.M., 1 January 1900 is represented by 2.25; midnight, 29 December 1899 is represented by -1.0; and 6 A.M., 29 December 1899 is represented by -1.25.</para>
@@ -4065,6 +4168,10 @@ public class DateTimeTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to the equivalent OLE Automation date.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A double-precision floating-point number that contains an OLE Automation date equivalent to the value of this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToShortDateString">
@@ -4082,12 +4189,6 @@ public class DateTimeTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing the same value as a <see cref="T:System.String" /> returned by
-<see cref="M:System.DateTime.ToString" /> ("d", 
-<see langword="null" />
-).</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The value of the current <see cref="T:System.DateTime" /> object is formatted using the pattern defined by the <see cref="P:System.Globalization.DateTimeFormatInfo.ShortDatePattern" /> property associated with the current thread culture. The return value is identical to the value returned by specifying the "d" <format type="text/html"><a href="bb79761a-ca08-44ee-b142-b06b3e2fc22b">standard DateTime format string</a></format> with the <see cref="M:System.DateTime.ToString(System.String)" /> method.</para>
@@ -4100,6 +4201,10 @@ public class DateTimeTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current <see cref="T:System.DateTime" /> object to its equivalent short date string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the short date string representation of the current <see cref="T:System.DateTime" /> object.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -4118,12 +4223,6 @@ public class DateTimeTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing the same value as a <see cref="T:System.String" /> returned by
-<see cref="M:System.DateTime.ToString" /> ("t", 
-<see langword="null" /> 
-).</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The value of the current <see cref="T:System.DateTime" /> object is formatted using the pattern defined by the <see cref="P:System.Globalization.DateTimeFormatInfo.ShortTimePattern" /> property associated with the current thread culture. The return value is identical to the value returned by specifying the "t" <format type="text/html"><a href="bb79761a-ca08-44ee-b142-b06b3e2fc22b">standard DateTime format string</a></format> with the <see cref="M:System.DateTime.ToString(System.String)" /> method.</para>
@@ -4136,6 +4235,10 @@ public class DateTimeTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current <see cref="T:System.DateTime" /> object to its equivalent short time string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that contains the short time string representation of the current <see cref="T:System.DateTime" /> object.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -4154,11 +4257,6 @@ public class DateTimeTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted using
-   the general format specifier, ("G"). The string takes
-   into account the current system culture.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The value of the current <see cref="T:System.DateTime" /> object is formatted using the general date and time format specifier ('G'). To format it using a specific date and time format specifier, call the <see cref="M:System.DateTime.ToString(System.String)" /> method. To format it using the general date and time format specifier ('G') for a specific culture, call the <see cref="M:System.DateTime.ToString(System.IFormatProvider)" /> method. To format it using a specific date and time format specifier and the conventions of a specific culture, call the <see cref="M:System.DateTime.ToString(System.String,System.IFormatProvider)" /> method. </para>
@@ -4168,6 +4266,10 @@ public class DateTimeTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current <see cref="T:System.DateTime" /> object to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the value of the current <see cref="T:System.DateTime" /> object.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -4188,12 +4290,6 @@ public class DateTimeTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted using
-   the general format specifier, ("G"). The string takes into account the
-   formatting information in the <see cref="T:System.Globalization.DateTimeFormatInfo" /> instance supplied by
-<paramref name="provider" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The value of the current <see cref="T:System.DateTime" /> object is formatted using the general date and time format specifier ('G'), which formats output using the short date pattern and the long time pattern. </para>
@@ -4215,6 +4311,10 @@ public class DateTimeTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current <see cref="T:System.DateTime" /> object to its equivalent string representation using the specified culture-specific format information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of value of the current <see cref="T:System.DateTime" /> object as specified by <paramref name="provider" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information. </param>
       </Docs>
@@ -4237,11 +4337,6 @@ public class DateTimeTest {
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted as
-   specified by <paramref name="format" />. The string takes into account the current system
-   culture.</para>
-        </returns>
         <exception cref="T:System.FormatException">
           <para>The length of the <paramref name="format" /> string is 1, and it is not one of the format specifier characters defined for <see cref="T:System.Globalization.DateTimeFormatInfo" />.</para>
           <para>-or-</para>
@@ -4256,6 +4351,10 @@ public class DateTimeTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current <see cref="T:System.DateTime" /> object to its equivalent string representation using the specified format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of value of the current <see cref="T:System.DateTime" /> object as specified by <paramref name="format" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A standard or custom date and time format string (see Remarks). </param>
       </Docs>
@@ -4279,11 +4378,6 @@ public class DateTimeTest {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted as
-   specified by <paramref name="format" />. The string takes into account the information in
-   the <see cref="T:System.Globalization.DateTimeFormatInfo" /> supplied by <paramref name="provider" />.</para>
-        </returns>
         <exception cref="T:System.FormatException">
           <para>The length of the <paramref name="format" /> string is 1, and it is not one of the format specifier characters defined for <see cref="T:System.Globalization.DateTimeFormatInfo" />.</para>
           <para>-or-</para>
@@ -4310,6 +4404,10 @@ public class DateTimeTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current <see cref="T:System.DateTime" /> object to its equivalent string representation using the specified format and culture-specific format information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of value of the current <see cref="T:System.DateTime" /> object as specified by <paramref name="format" /> and <paramref name="provider" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A standard or custom date and time format string. </param>
         <param name="provider">
@@ -4332,12 +4430,6 @@ public class DateTimeTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>The UTC <see cref="T:System.DateTime" /> equivalent of the current <see cref="T:System.DateTime" /> value. If the
-   result is too large or too small to be represented as a <see cref="T:System.DateTime" />, the current
-   function returns a <see cref="T:System.DateTime" /> set to <see cref="F:System.DateTime.MaxValue" /> or <see cref="F:System.DateTime.MinValue" />
-   .</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The Coordinated Universal Time (UTC) is equal to the local time minus the UTC offset. For more information about the UTC offset, see <see cref="M:System.TimeZone.GetUtcOffset(System.DateTime)" />. The conversion also takes into account the daylight saving time rule that applies to the time represented by the current <see cref="T:System.DateTime" /> object. </para>
@@ -4396,6 +4488,10 @@ public class DateTimeTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current <see cref="T:System.DateTime" /> object to Coordinated Universal Time (UTC).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose <see cref="P:System.DateTime.Kind" /> property is <see cref="F:System.DateTimeKind.Utc" />, and whose value is the UTC equivalent to the value of the current <see cref="T:System.DateTime" /> object, or <see cref="F:System.DateTime.MaxValue" /> if the converted value is too large to be represented by a <see cref="T:System.DateTime" /> object, or <see cref="F:System.DateTime.MinValue" /> if the converted value is too small to be represented by a <see cref="T:System.DateTime" /> object.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System/DateTimeOffset.xml b/mcs/class/corlib/Documentation/en/System/DateTimeOffset.xml
index 3e01e5cedb6..56356391375 100644
--- a/mcs/class/corlib/Documentation/en/System/DateTimeOffset.xml
+++ b/mcs/class/corlib/Documentation/en/System/DateTimeOffset.xml
@@ -320,7 +320,6 @@
         <Parameter Name="timeSpan" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the <see cref="M:System.DateTimeOffset.Add(System.TimeSpan)" /> method to add more than one kind of time interval (days, hours, minutes, seconds, or milliseconds) in a single operation. This method's behavior is identical to the addition operator. The <see cref="T:System.DateTimeOffset" /> structure also supports specialized addition methods (such as <see cref="M:System.DateTimeOffset.AddDays(System.Double)" />, <see cref="M:System.DateTimeOffset.AddHours(System.Double)" />, and <see cref="M:System.DateTimeOffset.AddMinutes(System.Double)" />) for each time interval.</para>
@@ -335,6 +334,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a specified time interval to a <see cref="T:System.DateTimeOffset" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose value is the sum of the date and time represented by the current <see cref="T:System.DateTimeOffset" /> object and the time interval represented by <paramref name="timeSpan" />.</para>
+        </returns>
         <param name="timeSpan">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.TimeSpan" /> object that represents a positive or a negative time interval.</param>
       </Docs>
@@ -354,7 +357,6 @@
         <Parameter Name="days" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The fractional part of the <paramref name="days" /> parameter is the fractional part of a day. For example, 4.5 is equivalent to 4 days, 12 hours, 0 minutes, 0 seconds, 0 milliseconds. The <paramref name="days" /> parameter is rounded to the nearest millisecond.</para>
@@ -368,6 +370,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a specified number of whole and fractional days to the current <see cref="T:System.DateTimeOffset" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose value is the sum of the date and time represented by the current <see cref="T:System.DateTimeOffset" /> object and the number of days represented by <paramref name="days" />.</para>
+        </returns>
         <param name="days">
           <attribution license="cc4" from="Microsoft" modified="false" />A number of whole and fractional days. The number can be negative or positive.</param>
       </Docs>
@@ -387,7 +393,6 @@
         <Parameter Name="hours" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The fractional part of the <paramref name="hours" /> parameter is the fractional part of an hour. For example, 4.5 is equivalent to 4 hours, 30 minutes, 0 seconds, 0 milliseconds. The <paramref name="hours" /> parameter is rounded to the nearest millisecond.</para>
@@ -401,6 +406,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a specified number of whole and fractional hours to the current <see cref="T:System.DateTimeOffset" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose value is the sum of the date and time represented by the current <see cref="T:System.DateTimeOffset" /> object and the number of hours represented by <paramref name="hours" />.</para>
+        </returns>
         <param name="hours">
           <attribution license="cc4" from="Microsoft" modified="false" />A number of whole and fractional hours. The number can be negative or positive.</param>
       </Docs>
@@ -420,7 +429,6 @@
         <Parameter Name="milliseconds" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The fractional part of the <paramref name="milliseconds" /> parameter is the fractional part of a millisecond. For example, 4.5 is equivalent to 4 milliseconds and 5000 ticks, where one millisecond equals 10,000 ticks. However, <paramref name="milliseconds" /> is rounded to the nearest millisecond; all values of .5 or greater are rounded up.</para>
@@ -433,6 +441,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a specified number of milliseconds to the current <see cref="T:System.DateTimeOffset" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose value is the sum of the date and time represented by the current <see cref="T:System.DateTimeOffset" /> object and the number of whole milliseconds represented by <paramref name="milliseconds" />.</para>
+        </returns>
         <param name="milliseconds">
           <attribution license="cc4" from="Microsoft" modified="false" />A number of whole and fractional milliseconds. The number can be negative or positive.   </param>
       </Docs>
@@ -452,7 +464,6 @@
         <Parameter Name="minutes" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The fractional part of the <paramref name="minutes" /> parameter is the fractional part of a minute. For example, 4.5 is equivalent to 4 minutes, 30 seconds, 0 milliseconds. The <paramref name="minutes" /> parameter is rounded to the nearest millisecond.</para>
@@ -466,6 +477,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a specified number of whole and fractional minutes to the current <see cref="T:System.DateTimeOffset" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose value is the sum of the date and time represented by the current <see cref="T:System.DateTimeOffset" /> object and the number of minutes represented by <paramref name="minutes" />.</para>
+        </returns>
         <param name="minutes">
           <attribution license="cc4" from="Microsoft" modified="false" />A number of whole and fractional minutes. The number can be negative or positive.   </param>
       </Docs>
@@ -485,7 +500,6 @@
         <Parameter Name="months" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Unlike most of the other methods that add a single time interval unit (such as minutes or days) to a date and time value, <see cref="M:System.DateTimeOffset.AddMonths(System.Int32)" /> does not enable you to add fractional parts of a month. To add a time that consists of other time units in addition to months to a <see cref="T:System.DateTimeOffset" /> object, use the <see cref="M:System.DateTimeOffset.Add(System.TimeSpan)" /> method.</para>
@@ -497,6 +511,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a specified number of months to the current <see cref="T:System.DateTimeOffset" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose value is the sum of the date and time represented by the current <see cref="T:System.DateTimeOffset" /> object and the number of months represented by <paramref name="months" />.</para>
+        </returns>
         <param name="months">
           <attribution license="cc4" from="Microsoft" modified="false" />A number of whole months. The number can be negative or positive.</param>
       </Docs>
@@ -516,7 +534,6 @@
         <Parameter Name="seconds" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The fractional part of the <paramref name="seconds" /> parameter is the fractional part of a second. The value of fractional parts of a second are shown in the following table.</para>
@@ -566,6 +583,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a specified number of whole and fractional seconds to the current <see cref="T:System.DateTimeOffset" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose value is the sum of the date and time represented by the current <see cref="T:System.DateTimeOffset" /> object and the number of seconds represented by <paramref name="seconds" />.</para>
+        </returns>
         <param name="seconds">
           <attribution license="cc4" from="Microsoft" modified="false" />A number of whole and fractional seconds. The number can be negative or positive.</param>
       </Docs>
@@ -585,7 +606,6 @@
         <Parameter Name="ticks" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A tick represents 100 nanoseconds, or one-ten millionth of a second. Because a tick is a very small and precise time interval, any larger time unit can be expressed as a number of ticks without a loss of precision.</para>
@@ -675,6 +695,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a specified number of ticks to the current <see cref="T:System.DateTimeOffset" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose value is the sum of the date and time represented by the current <see cref="T:System.DateTimeOffset" /> object and the number of ticks represented by <paramref name="ticks" />.</para>
+        </returns>
         <param name="ticks">
           <attribution license="cc4" from="Microsoft" modified="false" />A number of 100-nanosecond ticks. The number can be negative or positive.</param>
       </Docs>
@@ -694,7 +718,6 @@
         <Parameter Name="years" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Unlike most of the other methods that add a single time interval unit (such as minutes or days) to a date and time value, <see cref="M:System.DateTimeOffset.AddYears(System.Int32)" /> does not enable you to add fractional parts of a year. To add a time that consists of other time units in addition to years to a <see cref="T:System.DateTimeOffset" /> object, use the <see cref="M:System.DateTimeOffset.Add(System.TimeSpan)" /> method.</para>
@@ -706,6 +729,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a specified number of years to the <see cref="T:System.DateTimeOffset" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose value is the sum of the date and time represented by the current <see cref="T:System.DateTimeOffset" /> object and the number of years represented by <paramref name="years" />.</para>
+        </returns>
         <param name="years">
           <attribution license="cc4" from="Microsoft" modified="false" />A number of years. The number can be negative or positive.</param>
       </Docs>
@@ -726,7 +753,6 @@
         <Parameter Name="second" Type="System.DateTimeOffset" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In performing the comparison, the method converts both the <paramref name="first" /> and the <paramref name="second" /> parameters to Coordinated Universal Time (UTC) before it performs the comparison. The method is equivalent to the following:</para>
@@ -737,6 +763,49 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two <see cref="T:System.DateTimeOffset" /> objects and indicates whether the first is earlier than the second, equal to the second, or later than the second.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates whether the value of the <paramref name="first" /> parameter is earlier than, later than, or the same time as the value of the <paramref name="second" /> parameter, as the following table shows.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value</para>
+                </term>
+                <description>
+                  <para>Meaning</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero</para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="first" /> is earlier than <paramref name="second" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="first" /> is equal to <paramref name="second" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero</para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="first" /> is later than <paramref name="second" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare.</param>
         <param name="second">
@@ -758,7 +827,6 @@
         <Parameter Name="other" Type="System.DateTimeOffset" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method compares <see cref="T:System.DateTimeOffset" /> objects by comparing their <see cref="P:System.DateTimeOffset.UtcDateTime" /> values; that is, it determines whether the two objects represent a single point in time, and indicates whether the current object is earlier than, later than, or the same as the <paramref name="other" /> parameter. </para>
@@ -767,6 +835,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current <see cref="T:System.DateTimeOffset" /> object to a specified <see cref="T:System.DateTimeOffset" /> object and indicates whether the current object is earlier than, the same as, or later than the second <see cref="T:System.DateTimeOffset" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relationship between the current <see cref="T:System.DateTimeOffset" /> object and <paramref name="other" />, as the following table shows.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero</para>
+              </term>
+              <description>
+                <para>The current <see cref="T:System.DateTimeOffset" /> object is earlier than <paramref name="other" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>The current <see cref="T:System.DateTimeOffset" /> object is the same as <paramref name="other" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero.</para>
+              </term>
+              <description>
+                <para>The current <see cref="T:System.DateTimeOffset" /> object is later than <paramref name="other" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with the current <see cref="T:System.DateTimeOffset" /> object.</param>
       </Docs>
@@ -907,7 +1015,6 @@
         <Parameter Name="other" Type="System.DateTimeOffset" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Before it performs the comparison, this method converts the values of both <see cref="T:System.DateTimeOffset" /> objects to Coordinated Universal Time (UTC). The method is equivalent to the following:</para>
@@ -920,6 +1027,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current <see cref="T:System.DateTimeOffset" /> object represents the same point in time as a specified <see cref="T:System.DateTimeOffset" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if both <see cref="T:System.DateTimeOffset" /> objects have the same <see cref="P:System.DateTimeOffset.UtcDateTime" /> value; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare to the current <see cref="T:System.DateTimeOffset" /> object.   </param>
       </Docs>
@@ -939,7 +1050,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Before it performs the comparison, this method converts the values of both the current <see cref="T:System.DateTimeOffset" /> object and the <paramref name="obj" /> parameter to Coordinated Universal Time (UTC). The method is equivalent to the following:</para>
@@ -951,6 +1061,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether a <see cref="T:System.DateTimeOffset" /> object represents the same point in time as a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="obj" /> parameter is a <see cref="T:System.DateTimeOffset" /> object and represents the same point in time as the current <see cref="T:System.DateTimeOffset" /> object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to the current <see cref="T:System.DateTimeOffset" /> object.</param>
       </Docs>
@@ -971,7 +1085,6 @@
         <Parameter Name="second" Type="System.DateTimeOffset" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Before it performs the comparison, this method converts both <see cref="T:System.DateTimeOffset" /> objects to Coordinated Universal Time (UTC). The method is equivalent to the following:</para>
@@ -982,6 +1095,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two specified <see cref="T:System.DateTimeOffset" /> objects represent the same point in time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the two <see cref="T:System.DateTimeOffset" /> objects have the same <see cref="P:System.DateTimeOffset.UtcDateTime" /> value; otherwise, false.</para>
+        </returns>
         <param name="first">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare.</param>
         <param name="second">
@@ -1003,7 +1120,6 @@
         <Parameter Name="other" Type="System.DateTimeOffset" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Because multiple time zones share a single offset, a return value of true does not guarantee that the current and the <paramref name="other" /> object represent times in the same time zone. </para>
@@ -1013,6 +1129,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the current <see cref="T:System.DateTimeOffset" /> object represents the same time and has the same offset as a specified <see cref="T:System.DateTimeOffset" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current <see cref="T:System.DateTimeOffset" /> object and <paramref name="other" /> have the same date and time value and the same <see cref="P:System.DateTimeOffset.Offset" /> value; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to the current <see cref="T:System.DateTimeOffset" /> object. </param>
       </Docs>
@@ -1032,7 +1152,6 @@
         <Parameter Name="fileTime" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A Windows file time is a 64-bit value that represents the number of 100-nanosecond intervals that have elapsed since 12:00 midnight, January 1, 1601 A.D. (C.E.) Coordinated Universal Time (UTC). Windows uses a file time to record when an application creates, accesses, or writes to a file. </para>
@@ -1043,6 +1162,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified Windows file time to an equivalent local time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the date and time of <paramref name="fileTime" /> with the offset set to the local time offset.</para>
+        </returns>
         <param name="fileTime">
           <attribution license="cc4" from="Microsoft" modified="false" />A Windows file time, expressed in ticks.</param>
       </Docs>
@@ -1060,12 +1183,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for the current <see cref="T:System.DateTimeOffset" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Hour">
@@ -1309,7 +1435,6 @@
         <Parameter Name="timeSpan" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.DateTimeOffset.op_Addition(System.DateTimeOffset,System.TimeSpan)" /> method defines the addition operation for <see cref="T:System.DateTimeOffset" /> values. It enables code such as the following:</para>
@@ -1320,6 +1445,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds a specified time interval to a <see cref="T:System.DateTimeOffset" /> object that has a specified date and time, and yields a <see cref="T:System.DateTimeOffset" /> object that has new a date and time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose value is the sum of the values of <paramref name="dateTimeTz" /> and <paramref name="timeSpan" />.</para>
+        </returns>
         <param name="dateTimeOffset">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to add the time interval to.</param>
         <param name="timeSpan">
@@ -1342,7 +1471,6 @@
         <Parameter Name="right" Type="System.DateTimeOffset" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.DateTimeOffset.op_Equality(System.DateTimeOffset,System.DateTimeOffset)" /> method defines the operation of the equality operator for <see cref="T:System.DateTimeOffset" /> objects. It enables code such as the following:</para>
@@ -1355,6 +1483,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two specified <see cref="T:System.DateTimeOffset" /> objects represent the same point in time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if both <see cref="T:System.DateTimeOffset" /> objects have the same <see cref="P:System.DateTimeOffset.UtcDateTime" /> value; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare.</param>
         <param name="right">
@@ -1377,7 +1509,6 @@
         <Parameter Name="right" Type="System.DateTimeOffset" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.DateTimeOffset.op_GreaterThan(System.DateTimeOffset,System.DateTimeOffset)" /> method defines the operation of the greater than operator for <see cref="T:System.DateTimeOffset" /> objects. It enables code such as the following:</para>
@@ -1391,6 +1522,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether one specified <see cref="T:System.DateTimeOffset" /> object is greater than (or later than) a second specified <see cref="T:System.DateTimeOffset" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="P:System.DateTimeOffset.UtcDateTime" /> value of <paramref name="left" /> is later than the <see cref="P:System.DateTimeOffset.UtcDateTime" /> value of <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare.</param>
         <param name="right">
@@ -1413,7 +1548,6 @@
         <Parameter Name="right" Type="System.DateTimeOffset" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.DateTimeOffset.op_GreaterThan(System.DateTimeOffset,System.DateTimeOffset)" /> method defines the operation of the greater than or equal to operator for <see cref="T:System.DateTimeOffset" /> objects. It enables code such as the following:</para>
@@ -1427,6 +1561,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether one specified <see cref="T:System.DateTimeOffset" /> object is greater than or equal to a second specified <see cref="T:System.DateTimeOffset" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="P:System.DateTimeOffset.UtcDateTime" /> value of <paramref name="left" /> is the same as or later than the <see cref="P:System.DateTimeOffset.UtcDateTime" /> value of <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare.</param>
         <param name="right">
@@ -1470,7 +1608,6 @@
         <Parameter Name="right" Type="System.DateTimeOffset" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.DateTimeOffset.op_Inequality(System.DateTimeOffset,System.DateTimeOffset)" /> method defines the operation of the inequality operator for <see cref="T:System.DateTimeOffset" /> objects. It always returns the opposite result from <see cref="M:System.DateTimeOffset.op_Equality(System.DateTimeOffset,System.DateTimeOffset)" />. The <see cref="M:System.DateTimeOffset.op_Inequality(System.DateTimeOffset,System.DateTimeOffset)" /> method enables code such as the following:</para>
@@ -1485,6 +1622,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two specified <see cref="T:System.DateTimeOffset" /> objects refer to different points in time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> and <paramref name="right" /> do not have the same <see cref="P:System.DateTimeOffset.UtcDateTime" /> value; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare.</param>
         <param name="right">
@@ -1507,7 +1648,6 @@
         <Parameter Name="right" Type="System.DateTimeOffset" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.DateTimeOffset.op_LessThan(System.DateTimeOffset,System.DateTimeOffset)" /> method defines the operation of the less than operator for <see cref="T:System.DateTimeOffset" /> objects. It enables code such as the following:</para>
@@ -1521,6 +1661,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether one specified <see cref="T:System.DateTimeOffset" /> object is less than a second specified <see cref="T:System.DateTimeOffset" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="P:System.DateTimeOffset.UtcDateTime" /> value of <paramref name="left" /> is earlier than the <see cref="P:System.DateTimeOffset.UtcDateTime" /> value of <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare.</param>
         <param name="right">
@@ -1543,7 +1687,6 @@
         <Parameter Name="right" Type="System.DateTimeOffset" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.DateTimeOffset.op_LessThanOrEqual(System.DateTimeOffset,System.DateTimeOffset)" /> method defines the operation of the less than or equal to operator for <see cref="T:System.DateTimeOffset" /> objects. It enables code such as the following:</para>
@@ -1557,6 +1700,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether one specified <see cref="T:System.DateTimeOffset" /> object is less than a second specified <see cref="T:System.DateTimeOffset" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="P:System.DateTimeOffset.UtcDateTime" /> value of <paramref name="left" /> is earlier than the <see cref="P:System.DateTimeOffset.UtcDateTime" /> value of <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare.</param>
         <param name="right">
@@ -1579,7 +1726,6 @@
         <Parameter Name="right" Type="System.DateTimeOffset" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.DateTimeOffset.op_Subtraction(System.DateTimeOffset,System.DateTimeOffset)" /> method defines the subtraction operation for <see cref="T:System.DateTimeOffset" /> objects. It enables code such as the following:</para>
@@ -1590,6 +1736,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts one <see cref="T:System.DateTimeOffset" /> object from another and yields a time interval.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the difference between <paramref name="left" /> and <paramref name="right" />.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The minuend.   </param>
         <param name="right">
@@ -1612,7 +1762,6 @@
         <Parameter Name="timeSpan" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.DateTimeOffset.op_Subtraction(System.DateTimeOffset,System.TimeSpan)" /> method defines the subtraction operation for <see cref="T:System.DateTimeOffset" /> objects. It enables code such as the following:</para>
@@ -1623,6 +1772,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts a specified time interval from a specified date and time, and yields a new date and time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is equal to the value of <paramref name="dateTimeOffset" /> minus <paramref name="timeSpan" />.</para>
+        </returns>
         <param name="dateTimeOffset">
           <attribution license="cc4" from="Microsoft" modified="false" />The date and time object to subtract from.</param>
         <param name="timeSpan">
@@ -1644,7 +1797,6 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -1692,6 +1844,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a date, time, and offset to its <see cref="T:System.DateTimeOffset" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is equivalent to the date and time that is contained in <paramref name="input" />.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a date and time to convert.</param>
       </Docs>
@@ -1712,7 +1868,6 @@
         <Parameter Name="formatProvider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method parses a string with three elements that can appear in any order and are delimited by white space. These three elements are shown in the following table.</para>
@@ -1769,6 +1924,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a date and time to its <see cref="T:System.DateTimeOffset" /> equivalent using the specified culture-specific format information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is equivalent to the date and time that is contained in <paramref name="input" />, as specified by <paramref name="formatProvider" />.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a date and time to convert.   </param>
         <param name="formatProvider">
@@ -1792,7 +1951,6 @@
         <Parameter Name="styles" Type="System.Globalization.DateTimeStyles" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method parses a string with three elements that can appear in any order and are delimited by white space. These three elements are shown in the following table.</para>
@@ -1954,6 +2112,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a date and time to its <see cref="T:System.DateTimeOffset" /> equivalent using the specified culture-specific format information and formatting style.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is equivalent to the date and time that is contained in <paramref name="input" /> as specified by <paramref name="formatProvider" /> and <paramref name="styles" />.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a date and time to convert.   </param>
         <param name="formatProvider">
@@ -1979,7 +2141,6 @@
         <Parameter Name="formatProvider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.DateTimeOffset.ParseExact(System.String,System.String,System.IFormatProvider)" /> method parses the string representation of a date, which must be in the format defined by the <paramref name="format" /> parameter. It also requires that the &lt;Date&gt;, &lt;Time&gt;, and &lt;Offset&gt; elements of the string representation of a date and time appear in the order specified by <paramref name="format" />. If the <paramref name="input" /> string does not match this <paramref name="format" /> parameter, the method throws a <see cref="T:System.FormatException" />.  In contrast, the <see cref="M:System.DateTimeOffset.Parse(System.String,System.IFormatProvider)" /> method parses the string representation of a date in any one of the formats recognized by the format provider's <see cref="T:System.Globalization.DateTimeFormatInfo" /> object. <see cref="M:System.DateTimeOffset.Parse(System.String,System.IFormatProvider)" /> also allows the &lt;Date&gt;, &lt;Time&gt;, and &lt;Offset&gt; elements of the string representation of a date and time to appear in any order.</para>
@@ -2000,6 +2161,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a date and time to its <see cref="T:System.DateTimeOffset" /> equivalent using the specified format and culture-specific format information. The format of the string representation must match the specified format exactly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is equivalent to the date and time that is contained in <paramref name="input" /> as specified by <paramref name="format" /> and <paramref name="formatProvider" />.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a date and time to convert.</param>
         <param name="format">
@@ -2026,7 +2191,6 @@
         <Parameter Name="styles" Type="System.Globalization.DateTimeStyles" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.DateTimeOffset.ParseExact(System.String,System.String,System.IFormatProvider,System.Globalization.DateTimeStyles)" /> method parses the string representation of a date, which must be in the format defined by the <paramref name="format" /> parameter. It also requires that the &lt;Date&gt;, &lt;Time&gt;, and &lt;Offset&gt; elements of the string representation of a date and time appear in the order specified by <paramref name="format" />. If the <paramref name="input" /> string does not match the pattern of the <paramref name="format" /> parameter, with any variations defined by the <paramref name="styles" /> parameter, the method throws a <see cref="T:System.FormatException" />.  In contrast, the <see cref="M:System.DateTimeOffset.Parse(System.String,System.IFormatProvider,System.Globalization.DateTimeStyles)" /> method parses the string representation of a date in any one of the formats recognized by the format provider's <see cref="T:System.Globalization.DateTimeFormatInfo" /> object. <see cref="M:System.DateTimeOffset.Parse(System.String,System.IFormatProvider,System.Globalization.DateTimeStyles)" /> also allows the &lt;Date&gt;, &lt;Time&gt;, and &lt;Offset&gt; elements of the string representation of a date and time to appear in any order.</para>
@@ -2150,6 +2314,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a date and time to its <see cref="T:System.DateTimeOffset" /> equivalent using the specified format, culture-specific format information, and style. The format of the string representation must match the specified format exactly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is equivalent to the date and time that is contained in the <paramref name="input" /> parameter, as specified by the <paramref name="format" />, <paramref name="formatProvider" />, and <paramref name="styles" /> parameters.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a date and time to convert.</param>
         <param name="format">
@@ -2178,7 +2346,6 @@
         <Parameter Name="styles" Type="System.Globalization.DateTimeStyles" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.DateTimeOffset.ParseExact(System.String,System.String[],System.IFormatProvider,System.Globalization.DateTimeStyles)" /> method parses the string representation of a date that matches any one of the patterns assigned to the <paramref name="formats" /> parameter. If the <paramref name="input" /> string does not match any one of these patterns with any of the variations defined by the <paramref name="styles" /> parameter, the method throws a <see cref="T:System.FormatException" />. Aside from comparing <paramref name="input" /> to multiple formatting patterns, this overload behaves identically to the <see cref="M:System.DateTimeOffset.ParseExact(System.String,System.String,System.IFormatProvider,System.Globalization.DateTimeStyles)" /> method.</para>
@@ -2305,6 +2472,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified string representation of a date and time to its <see cref="T:System.DateTimeOffset" /> equivalent using the specified formats, culture-specific format information, and style. The format of the string representation must match one of the specified formats exactly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is equivalent to the date and time that is contained in the <paramref name="input" /> parameter, as specified by the <paramref name="formats" />, <paramref name="formatProvider" />, and <paramref name="styles" /> parameters.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a date and time to convert.</param>
         <param name="formats">
@@ -2354,7 +2525,6 @@
         <Parameter Name="value" Type="System.DateTimeOffset" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method converts both <see cref="T:System.DateTimeOffset" /> objects to Coordinated Universal Time (UTC) before calculating the time interval that separates them. This removes any effect that different offsets from UTC may have on the comparison.</para>
@@ -2367,6 +2537,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts a <see cref="T:System.DateTimeOffset" /> value that represents a specific date and time from the current <see cref="T:System.DateTimeOffset" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that specifies the interval between the two <see cref="T:System.DateTimeOffset" /> objects.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that represents the value to subtract. </param>
       </Docs>
@@ -2386,7 +2560,6 @@
         <Parameter Name="value" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the <see cref="M:System.DateTimeOffset.Subtract(System.TimeSpan)" /> method to subtract more than one kind of time interval (days, hours, minutes, seconds, or milliseconds) in a single operation. Its behavior is identical to the <see cref="M:System.DateTimeOffset.op_Subtraction(System.DateTimeOffset,System.TimeSpan)" /> method, which defines the subtraction operator. The <see cref="T:System.DateTimeOffset" /> structure also supports specialized addition methods (such as <see cref="M:System.DateTimeOffset.AddDays(System.Double)" />, <see cref="M:System.DateTimeOffset.AddHours(System.Double)" />, and <see cref="M:System.DateTimeOffset.AddMinutes(System.Double)" />) that allow you to perform subtraction by assigning a negative value to the method parameter. </para>
@@ -2400,6 +2573,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts a specified time interval from the current <see cref="T:System.DateTimeOffset" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is equal to the date and time represented by the current <see cref="T:System.DateTimeOffset" /> object, minus the time interval represented by <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The time interval to subtract.</param>
       </Docs>
@@ -2419,12 +2596,51 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the value of the current <see cref="T:System.DateTimeOffset" /> object with another object of the same type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer that indicates whether the current <see cref="T:System.DateTimeOffset" /> object is less than, equal to, or greater than <paramref name="obj" />. The return values of the method are interpreted as follows:</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero</para>
+              </term>
+              <description>
+                <para>The current <see cref="T:System.DateTimeOffset" /> object is less than (earlier than) <paramref name="obj" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>The current <see cref="T:System.DateTimeOffset" /> object is equal to (the same point in time as) <paramref name="obj" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero</para>
+              </term>
+              <description>
+                <para>The current <see cref="T:System.DateTimeOffset" /> object is greater than (later than) <paramref name="obj" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current <see cref="T:System.DateTimeOffset" /> object.</param>
       </Docs>
@@ -2542,7 +2758,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A Windows file time is a 64-bit value that represents the number of 100-nanosecond intervals that have elapsed since 12:00 midnight, January 1, 1601 A.D. (C.E.) Coordinated Universal Time (UTC). Windows uses a file time to record when an application creates, accesses, or writes to a file. </para>
@@ -2556,6 +2771,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current <see cref="T:System.DateTimeOffset" /> object to a Windows file time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current <see cref="T:System.DateTimeOffset" /> object, expressed as a Windows file time.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToLocalTime">
@@ -2571,7 +2790,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>In performing the conversion to local time, the method first converts the current <see cref="T:System.DateTimeOffset" /> object's date and time to Coordinated Universal Time (UTC) by subtracting the offset from the time. It then converts the UTC date and time to local time by adding the local time zone offset. In doing this, it takes account of any adjustment rules for the local time zone.  </para>
@@ -2582,6 +2800,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the current <see cref="T:System.DateTimeOffset" /> object to a <see cref="T:System.DateTimeOffset" /> object that represents the local time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the date and time of the current <see cref="T:System.DateTimeOffset" /> object converted to local time.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToOffset">
@@ -2599,7 +2821,6 @@
         <Parameter Name="offset" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.DateTimeOffset.ToOffset(System.TimeSpan)" /> method is an alternative to calling the <see cref="M:System.TimeZoneInfo.ConvertTime(System.DateTimeOffset,System.TimeZoneInfo)" />  method. It can be useful for performing simple conversions from one time zone to another when the time zones' offsets from Coordinated Universal Time (UTC) are known. However, because neither the original <see cref="T:System.DateTimeOffset" /> object nor the new <see cref="T:System.DateTimeOffset" /> object returned by the method call are unambiguously related to a particular time zone, the method does not apply any time zone adjustment rules in the conversion. </para>
@@ -2608,6 +2829,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current <see cref="T:System.DateTimeOffset" /> object to the date and time specified by an offset value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is equal to the original <see cref="T:System.DateTimeOffset" /> object (that is, their <see cref="M:System.DateTimeOffset.ToUniversalTime" /> methods return identical points in time) but whose <see cref="P:System.DateTimeOffset.Offset" /> property is set to <paramref name="offset" />.</para>
+        </returns>
         <param name="offset">
           <attribution license="cc4" from="Microsoft" modified="false" />The offset to convert the <see cref="T:System.DateTimeOffset" /> value to.   </param>
       </Docs>
@@ -2625,7 +2850,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value of this method is identical to that of the <see cref="M:System.DateTime.ToString" /> method, except that it includes a space followed by the offset appended at the end of the string. In other words, it formats output using the short date pattern, the long time pattern, and the zzz custom format string, with each element separated from the previous element by a space. For example, if <see cref="M:System.DateTime.ToString" /> returns a value of 1/12/2008 6:15:50 PM, <see cref="M:System.DateTimeOffset.ToString" /> returns a value of 1/12/2008 6:15:50 PM -08:00 for a time that is eight hours behind Coordinated Universal Time (UTC).</para>
@@ -2635,6 +2859,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current <see cref="T:System.DateTimeOffset" /> object to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of a <see cref="T:System.DateTimeOffset" /> object that includes the offset appended at the end of the string.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -2652,7 +2880,6 @@
         <Parameter Name="formatProvider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value of this method is identical to that of its equivalent overload of the <see cref="M:System.DateTime.ToString" /> method, except that it includes a space followed by the offset appended at the end of the string. In other words, it formats output using the short date pattern, the long time pattern, and the zzz custom format string, with each element separated from the previous element by a space.</para>
@@ -2671,6 +2898,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current <see cref="T:System.DateTimeOffset" /> object to its equivalent string representation using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the value of the current <see cref="T:System.DateTimeOffset" /> object, as specified by <paramref name="formatProvider" />.</para>
+        </returns>
         <param name="formatProvider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information.</param>
       </Docs>
@@ -2690,7 +2921,6 @@
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="format" /> parameter should contain either a single format specifier character (see <format type="text/html"><a href="bb79761a-ca08-44ee-b142-b06b3e2fc22b">Standard DateTime Format Strings</a></format>) or a custom format pattern (see <format type="text/html"><a href="98b374e3-0cc2-4c78-ab44-efb671d71984">Custom DateTime Format Strings</a></format>) that defines the format of the returned string. If <paramref name="format" /> is a null or empty string (""), the <see cref="T:System.DateTimeOffset" /> value is output using the default format.</para>
@@ -2746,6 +2976,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current <see cref="T:System.DateTimeOffset" /> object to its equivalent string representation using the specified format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the value of the current <see cref="T:System.DateTimeOffset" /> object, as specified by <paramref name="format" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A format string.</param>
       </Docs>
@@ -2766,7 +3000,6 @@
         <Parameter Name="formatProvider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="format" /> parameter should contain either a single format specifier character (see <format type="text/html"><a href="bb79761a-ca08-44ee-b142-b06b3e2fc22b">Standard DateTime Format Strings</a></format>) or a custom format pattern (see <format type="text/html"><a href="98b374e3-0cc2-4c78-ab44-efb671d71984">Custom DateTime Format Strings</a></format>). If <paramref name="format" /> is a null or empty string (""), the <see cref="T:System.DateTimeOffset" /> object is output using the default format.</para>
@@ -2831,6 +3064,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current <see cref="T:System.DateTimeOffset" /> object to its equivalent string representation using the specified format and culture-specific format information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the value of the current <see cref="T:System.DateTimeOffset" /> object, as specified by <paramref name="format" /> and <paramref name="provider" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A format string.</param>
         <param name="formatProvider">
@@ -2850,7 +3087,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns a <see cref="T:System.DateTimeOffset" /> object whose <see cref="P:System.DateTimeOffset.Offset" /> property is set to zero.</para>
@@ -2860,6 +3096,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the current <see cref="T:System.DateTimeOffset" /> object to a <see cref="T:System.DateTimeOffset" /> value that represents the Coordinated Universal Time (UTC).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the date and time of the current <see cref="T:System.DateTimeOffset" /> object converted to Coordinated Universal Time (UTC).</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TryParse">
diff --git a/mcs/class/corlib/Documentation/en/System/Decimal.xml b/mcs/class/corlib/Documentation/en/System/Decimal.xml
index e0af97c6545..12893c483c0 100644
--- a/mcs/class/corlib/Documentation/en/System/Decimal.xml
+++ b/mcs/class/corlib/Documentation/en/System/Decimal.xml
@@ -418,11 +418,6 @@ class ConstructDecimal {
         <Parameter Name="d2" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Decimal" /> containing the sum of <paramref name="d1" /> and <paramref name="d2" />. The 
-   scale of the result, before any rounding, is the larger of the scales of d1 and
-   d2. For example, 1.1 + 2.22 gives 3.32, and 2.50 + 1 gives 3.50.</para>
-        </returns>
         <exception cref="T:System.OverflowException">The sum of <paramref name="d1" /> and <paramref name="d2" /> is less than <see cref="F:System.Decimal.MinValue" /> or greater than <see cref="F:System.Decimal.MaxValue" />.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -433,6 +428,10 @@ class ConstructDecimal {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds two specified <see cref="T:System.Decimal" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sum of <paramref name="d1" /> and <paramref name="d2" />.</para>
+        </returns>
         <param name="d1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to add. </param>
         <param name="d2">
@@ -455,7 +454,6 @@ class ConstructDecimal {
         <Parameter Name="d" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -465,6 +463,10 @@ class ConstructDecimal {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the smallest integral value that is greater than or equal to the specified decimal number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The smallest integral value that is greater than or equal to the <paramref name="d" /> parameter. Note that this method returns a <see cref="T:System.Decimal" /> instead of an integral type.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />A decimal number. </param>
       </Docs>
@@ -492,38 +494,54 @@ class ConstructDecimal {
         <Parameter Name="d2" Type="System.Decimal" />
       </Parameters>
       <Docs>
+        <remarks>To be added.</remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Compares two specified <see cref="T:System.Decimal" /> values.</para>
+        </summary>
         <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of <paramref name="d1" /> as compared to <paramref name="d2" />.  Trailing zero digits in the fractional part of  are ignored.  For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value. Each comparison compares the numerical values of <paramref name="d1" /> and <paramref name="d2" />.</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number indicating the relative values of <paramref name="d1" /> and <paramref name="d2" />.</para>
           <list type="table">
             <listheader>
-              <term> Return Value</term>
-              <description> Meaning</description>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Meaning </para>
+                </description>
+              </item>
             </listheader>
             <item>
-              <term> Any
-         negative
-         number</term>
+              <term>
+                <para>Less than zero </para>
+              </term>
               <description>
-                <paramref name="d1" />&lt; <paramref name="d2" /></description>
+                <para>
+                        <paramref name="d1" /> is less than <paramref name="d2" />. </para>
+              </description>
             </item>
             <item>
-              <term> Zero</term>
+              <term>
+                <para>Zero </para>
+              </term>
               <description>
-                <paramref name="d1" /> == <paramref name="d2" /></description>
+                <para>
+                            <paramref name="d1" /> and <paramref name="d2" /> are equal. </para>
+              </description>
             </item>
             <item>
-              <term> A positive
-      number</term>
+              <term>
+                <para>Greater than zero </para>
+              </term>
               <description>
-                <paramref name="d1" />&gt;<paramref name="d2" /></description>
+                <para>
+                                <paramref name="d1" /> is greater than <paramref name="d2" />. </para>
+              </description>
             </item>
           </list>
         </returns>
-        <remarks>To be added.</remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Compares two specified <see cref="T:System.Decimal" /> values.</para>
-        </summary>
         <param name="d1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare. </param>
         <param name="d2">
@@ -546,27 +564,6 @@ class ConstructDecimal {
         <Parameter Name="value" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="value" />. Trailing zero digits in the fractional part of the current instance and <paramref name="value" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> A negative number</term>
-              <description>Current instance &lt; <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> Zero</term>
-              <description>Current instance == <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> A positive number</term>
-              <description>current instance &gt; <paramref name="value" />.</description>
-            </item>
-          </list>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -579,6 +576,46 @@ class ConstructDecimal {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this instance to a specified <see cref="T:System.Decimal" /> object and returns a comparison of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number indicating the relative values of this instance and <paramref name="value" />.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Meaning </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is equal to <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than <paramref name="value" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this instance.</param>
       </Docs>
@@ -600,39 +637,60 @@ class ConstructDecimal {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="value" /> is not a <see cref="T:System.Decimal" /> and is not a null reference. </exception>
+        <remarks>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Any instance of <see cref="T:System.Decimal" />, regardless of its value, is considered greater than null.</para>
+          <para>Parameter <paramref name="value" /> must be null or an instance of <see cref="T:System.Decimal" />; otherwise, an exception is thrown.</para>
+        </remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Compares this instance to a specified object and returns a comparison of their relative values.</para>
+        </summary>
         <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="value" />. Trailing zero digits in the fractional part of the current instance and <paramref name="value" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number indicating the relative values of this instance and <paramref name="value" />.</para>
           <list type="table">
             <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Meaning </para>
+                </description>
+              </item>
             </listheader>
             <item>
-              <term> A negative number</term>
-              <description>Current instance &lt; <paramref name="value" />.</description>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than <paramref name="value" />. </para>
+              </description>
             </item>
             <item>
-              <term> Zero</term>
-              <description>Current instance == <paramref name="value" />.</description>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is equal to <paramref name="value" />. </para>
+              </description>
             </item>
             <item>
-              <term> A positive number</term>
-              <description>current instance &gt; <paramref name="value" />, or <paramref name="value" /> is
-   a null reference.</description>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than <paramref name="value" />.</para>
+                <para>-or- </para>
+                <para>
+                        <paramref name="value" /> is null. </para>
+              </description>
             </item>
           </list>
         </returns>
-        <exception cref="T:System.ArgumentException">
-          <paramref name="value" /> is not a <see cref="T:System.Decimal" /> and is not a null reference. </exception>
-        <remarks>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Any instance of <see cref="T:System.Decimal" />, regardless of its value, is considered greater than null.</para>
-          <para>Parameter <paramref name="value" /> must be null or an instance of <see cref="T:System.Decimal" />; otherwise, an exception is thrown.</para>
-        </remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Compares this instance to a specified object and returns a comparison of their relative values.</para>
-        </summary>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this instance, or null. </param>
       </Docs>
@@ -656,11 +714,6 @@ class ConstructDecimal {
         <Parameter Name="d2" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Decimal" /> containing the result of dividing <paramref name="d1" /> by
-<paramref name="d2" />. The scale of the result, before any rounding, is 
-   the closest scale to the preferred scale which will preserve a result equal to the exact result. The preferred scale is the scale of <paramref name="d1" />  less the scale of <paramref name="d2" />. For example, 2.20 / 2 gives 1.10.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.DivideByZeroException">
           <paramref name="d2" /> is zero. </exception>
@@ -669,6 +722,10 @@ class ConstructDecimal {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Divides two specified <see cref="T:System.Decimal" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of dividing <paramref name="d1" /> by <paramref name="d2" />.</para>
+        </returns>
         <param name="d1">
           <attribution license="cc4" from="Microsoft" modified="false" />The dividend. </param>
         <param name="d2">
@@ -691,10 +748,6 @@ class ConstructDecimal {
         <Parameter Name="value" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="value" /> is numerically equal to (has the same value as) the current instance; otherwise, <see langword="false" />. </para>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -707,6 +760,11 @@ class ConstructDecimal {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance and a specified <see cref="T:System.Decimal" /> object represent the same value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            true if <paramref name="value" /> is equal to this instance; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare to this instance.</param>
       </Docs>
@@ -728,13 +786,6 @@ class ConstructDecimal {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="value" /> has the same type and is numerically equal to
-   (has the same value as) the current instance. If <paramref name="value" /> is a null
-   reference or is not an instance of <see cref="T:System.Decimal" />, returns
-<see langword="false" />. </para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note"> This method
@@ -745,6 +796,11 @@ class ConstructDecimal {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance and a specified <see cref="T:System.Object" /> represent the same type and value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            true if <paramref name="value" /> is a <see cref="T:System.Decimal" /> and equal to this instance; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this instance. </param>
       </Docs>
@@ -768,17 +824,16 @@ class ConstructDecimal {
         <Parameter Name="d2" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="d1" /> and <paramref name="d2" /> are numerically
-   equal
-   (have the same value), otherwise <see langword="false" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether two specified instances of <see cref="T:System.Decimal" /> represent the same value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            true if <paramref name="d1" /> and <paramref name="d2" /> are equal; otherwise, false.</para>
+        </returns>
         <param name="d1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare. </param>
         <param name="d2">
@@ -803,14 +858,6 @@ class ConstructDecimal {
         <Parameter Name="d" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Decimal" /> value <paramref name="v" /> such that <paramref name="v" /> is an integer and <paramref name="d" />
-   - 1 &lt; <paramref name="v" />
-   &lt;=
-   
-<paramref name="d" /> . The scale of the result will be zero.
-   </para>
-        </returns>
         <example>
           <para>The following example demonstrates the <see cref="M:System.Decimal.Floor(System.Decimal)" /> method.</para>
           <code lang="C#">using System;
@@ -837,6 +884,12 @@ class DecimalTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Rounds a specified <see cref="T:System.Decimal" /> number to the closest integer toward negative infinity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If <paramref name="d" /> has a fractional part, the next whole <see cref="T:System.Decimal" /> number toward negative infinity that is less than <paramref name="d" />.</para>
+          <para>-or- </para>
+          <para>If <paramref name="d" /> doesn't have a fractional part, <paramref name="d" /> is returned unchanged. Note that the method returns an integral value of type <see cref="T:System.Decimal" />. </para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to round. </param>
       </Docs>
@@ -858,12 +911,15 @@ class DecimalTest {
         <Parameter Name="cy" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified 64-bit signed integer, which contains an OLE Automation Currency value, to the equivalent <see cref="T:System.Decimal" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Decimal" /> that contains the equivalent of <paramref name="cy" />.</para>
+        </returns>
         <param name="cy">
           <attribution license="cc4" from="Microsoft" modified="false" />An OLE Automation Currency value. </param>
       </Docs>
@@ -885,10 +941,6 @@ class DecimalTest {
         <Parameter Name="d" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>An array of four <see cref="T:System.Int32" /> containing an unspecified 128-bit representation of a    <see cref="T:System.Decimal" /> in its raw form.
-   </para>
-        </returns>
         <example>
           <para>The following example demonstrates the different
       representations of 1.00 and 1.</para>
@@ -932,6 +984,10 @@ public static void Main () {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of a specified instance of <see cref="T:System.Decimal" /> to its equivalent binary representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer array with four elements that contain the binary representation of <paramref name="d" />.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to convert. </param>
       </Docs>
@@ -952,9 +1008,6 @@ public static void Main () {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the hash code for this instance.</para>
-        </returns>
         <remarks>
           <para>The algorithm used to
       generate the hash code value is unspecified.</para>
@@ -967,6 +1020,10 @@ public static void Main () {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -984,12 +1041,15 @@ public static void Main () {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.TypeCode" /> for value type <see cref="T:System.Decimal" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The enumerated constant <see cref="F:System.TypeCode.Decimal" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MaxValue">
@@ -1091,19 +1151,16 @@ public static void Main () {
         <Parameter Name="d2" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> The result of multiplying <paramref name="d1" /> and
-<paramref name="d2" /> . The scale of the result, before any 
-   rounding, is the sum of the scales of d1 and
-   d2.</para>
-          <para>For example, 123 x 3 gives 369, and 2.2 x 1.35 gives 2.970.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.OverflowException">The result is greater than <see cref="F:System.Decimal.MaxValue" /> or less than <see cref="F:System.Decimal.MinValue" />. </exception>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Multiplies two specified <see cref="T:System.Decimal" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of multiplying <paramref name="d1" /> and <paramref name="d2" />.</para>
+        </returns>
         <param name="d1">
           <attribution license="cc4" from="Microsoft" modified="false" />The multiplicand. </param>
         <param name="d2">
@@ -1128,16 +1185,17 @@ public static void Main () {
         <Parameter Name="d" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> The negated value of <paramref name="d" />. If <paramref name="d" /> is zero then zero is returned (with 0 sign); otherwise the scale of the result is the same as the scale of
-<paramref name="d" />
-.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the result of multiplying the specified <see cref="T:System.Decimal" /> value by negative one.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decimal number with the value of <paramref name="d" />, but the opposite sign.</para>
+          <para>-or- </para>
+          <para>Zero, if <paramref name="d" /> is zero.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to negate. </param>
       </Docs>
@@ -1188,10 +1246,6 @@ public static void Main () {
         <Parameter Name="d2" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The value returned by <see cref="M:System.Decimal.Add(System.Decimal,System.Decimal)" />
-(<paramref name="d1" />,<paramref name="d2" />).</para>
-        </returns>
         <exception cref="T:System.OverflowException">The sum of <paramref name="d1" /> and <paramref name="d2" /> is greater than <see cref="F:System.Decimal.MaxValue" /> or less than <see cref="F:System.Decimal.MinValue" />. </exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1203,6 +1257,10 @@ public static void Main () {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds two specified <see cref="T:System.Decimal" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of adding <paramref name="d1" /> and <paramref name="d2" />.</para>
+        </returns>
         <param name="d1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to add. </param>
         <param name="d2">
@@ -1227,9 +1285,6 @@ public static void Main () {
         <Parameter Name="d" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The value returned by <see cref="M:System.Decimal.Subtract(System.Decimal,System.Decimal)" /> (<paramref name="d" /> , <see cref="F:System.Decimal.One" /> ).</para>
-        </returns>
         <exception cref="T:System.OverflowException">The result is greater than <see cref="F:System.Decimal.MaxValue" /> or less than <see cref="F:System.Decimal.MinValue" /> .</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1244,6 +1299,10 @@ public static void Main () {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Decrements the <see cref="T:System.Decimal" /> operand by one.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of <paramref name="d" /> decremented by 1.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to decrement. </param>
       </Docs>
@@ -1267,10 +1326,6 @@ public static void Main () {
         <Parameter Name="d2" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> The value returned by <see cref="M:System.Decimal.Divide(System.Decimal,System.Decimal)" /> (<paramref name="d1" />,
-<paramref name="d2" />). </para>
-        </returns>
         <exception cref="T:System.DivideByZeroException">The divisor is zero. </exception>
         <exception cref="T:System.OverflowException">The result is greater than <see cref="F:System.Decimal.MaxValue" /> or less than <see cref="F:System.Decimal.MinValue" />.</exception>
         <remarks>
@@ -1283,6 +1338,10 @@ public static void Main () {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Divides two specified <see cref="T:System.Decimal" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of dividing <paramref name="d1" /> by <paramref name="d2" />.</para>
+        </returns>
         <param name="d1">
           <attribution license="cc4" from="Microsoft" modified="false" />The dividend. </param>
         <param name="d2">
@@ -1308,12 +1367,6 @@ public static void Main () {
         <Parameter Name="d2" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <see cref="M:System.Decimal.Compare(System.Decimal,System.Decimal)" />
-(<paramref name="d1" />, <paramref name="d2" /> ) returns
-zero; otherwise <see langword="false" />. </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Decimal.op_Equality(System.Decimal,System.Decimal)" /> method defines the operation of the equality operator for <see cref="T:System.Decimal" /> values. It enables code such as the following: </para>
@@ -1324,6 +1377,11 @@ zero; otherwise <see langword="false" />. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether two <see cref="T:System.Decimal" /> values are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            true if <paramref name="d1" /> and <paramref name="d2" /> are equal; otherwise, false.</para>
+        </returns>
         <param name="d1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare. </param>
         <param name="d2">
@@ -1808,12 +1866,6 @@ specified value.</para>
         <Parameter Name="d2" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <see cref="M:System.Decimal.Compare(System.Decimal,System.Decimal)" /> (<paramref name="d1" />,
-<paramref name="d2" />) returns a value that is greater than zero; otherwise 
-<see langword="false" />. </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Decimal.op_GreaterThan(System.Decimal,System.Decimal)" /> method defines the operation of the greater than operator for <see cref="T:System.Decimal" /> values. It enables code such as the following: </para>
@@ -1825,6 +1877,11 @@ specified value.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether a specified <see cref="T:System.Decimal" /> is greater than another specified <see cref="T:System.Decimal" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+                    true if <paramref name="d1" /> is greater than <paramref name="d2" />; otherwise, false.</para>
+        </returns>
         <param name="d1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare. </param>
         <param name="d2">
@@ -1850,12 +1907,6 @@ specified value.</para>
         <Parameter Name="d2" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <see cref="M:System.Decimal.Compare(System.Decimal,System.Decimal)" /> (<paramref name="d1" />,
-<paramref name="d2" />) returns a value that is greater than or equal to zero; otherwise 
-<see langword="false" />. </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Decimal.op_GreaterThanOrEqual(System.Decimal,System.Decimal)" /> method defines the operation of the greater than or equal operator for <see cref="T:System.Decimal" /> values. It enables code such as the following: </para>
@@ -1867,6 +1918,11 @@ specified value.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether a specified <see cref="T:System.Decimal" /> is greater than or equal to another specified <see cref="T:System.Decimal" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+                    true if <paramref name="d1" /> is greater than or equal to <paramref name="d2" />; otherwise, false.</para>
+        </returns>
         <param name="d1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare. </param>
         <param name="d2">
@@ -2191,10 +2247,6 @@ specified value.</para>
         <Parameter Name="d" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The value returned by <see cref="M:System.Decimal.Add(System.Decimal,System.Decimal)" /> (<paramref name="d" /> ,
-<see cref="F:System.Decimal.One" /> ).</para>
-        </returns>
         <exception cref="T:System.OverflowException">The result is greater than <see cref="F:System.Decimal.MaxValue" /> or less than <see cref="F:System.Decimal.MinValue" /> .</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2209,6 +2261,10 @@ specified value.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Increments the <see cref="T:System.Decimal" /> operand by 1.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of <paramref name="d" /> incremented by 1.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to increment. </param>
       </Docs>
@@ -2232,11 +2288,6 @@ specified value.</para>
         <Parameter Name="d2" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <see cref="M:System.Decimal.Compare(System.Decimal,System.Decimal)" /> (<paramref name="d1" />,
-<paramref name="d2" />) does not return zero; otherwise <see langword="false" />. </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Decimal.op_Inequality(System.Decimal,System.Decimal)" /> method defines the operation of the inequality operator for <see cref="T:System.Decimal" /> values. It enables code such as the following: </para>
@@ -2255,6 +2306,11 @@ specified value.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether two <see cref="T:System.Decimal" /> objects have different values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            true if <paramref name="d1" /> and <paramref name="d2" /> are not equal; otherwise, false.</para>
+        </returns>
         <param name="d1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare. </param>
         <param name="d2">
@@ -2280,12 +2336,6 @@ specified value.</para>
         <Parameter Name="d2" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <see cref="M:System.Decimal.Compare(System.Decimal,System.Decimal)" /> (<paramref name="d1" />,
-<paramref name="d2" />) returns a value that is less than zero; otherwise 
-<see langword="false" />. </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Decimal.op_LessThan(System.Decimal,System.Decimal)" /> method defines the operation of the less than operator for <see cref="T:System.Decimal" /> values. It enables code such as the following: </para>
@@ -2297,6 +2347,11 @@ specified value.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether a specified <see cref="T:System.Decimal" /> is less than another specified <see cref="T:System.Decimal" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            true if <paramref name="d1" /> is less than <paramref name="d2" />; otherwise, false.</para>
+        </returns>
         <param name="d1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare. </param>
         <param name="d2">
@@ -2322,12 +2377,6 @@ specified value.</para>
         <Parameter Name="d2" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <see cref="M:System.Decimal.Compare(System.Decimal,System.Decimal)" /> (<paramref name="d1" />,
-<paramref name="d2" />) returns a value that is less than or equal to zero; otherwise 
-<see langword="false" />. </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Decimal.op_LessThanOrEqual(System.Decimal,System.Decimal)" /> method defines the operation of the less than or equal operator for <see cref="T:System.Decimal" /> values. It enables code such as the following: </para>
@@ -2339,6 +2388,11 @@ specified value.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether a specified <see cref="T:System.Decimal" /> is less than or equal to another specified <see cref="T:System.Decimal" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+            true if <paramref name="d1" /> is less than or equal to <paramref name="d2" />; otherwise, false.</para>
+        </returns>
         <param name="d1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare. </param>
         <param name="d2">
@@ -2364,10 +2418,6 @@ specified value.</para>
         <Parameter Name="d2" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The value returned by <see cref="M:System.Decimal.Remainder(System.Decimal,System.Decimal)" /> (<paramref name="d1" />,
-<paramref name="d2" />).</para>
-        </returns>
         <exception cref="T:System.DivideByZeroException">
           <paramref name="d2" /> is zero. </exception>
         <exception cref="T:System.OverflowException">
@@ -2383,6 +2433,10 @@ specified value.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the remainder resulting from dividing two specified <see cref="T:System.Decimal" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The remainder resulting from dividing <paramref name="d1" /> by <paramref name="d2" />.</para>
+        </returns>
         <param name="d1">
           <attribution license="cc4" from="Microsoft" modified="false" />The dividend. </param>
         <param name="d2">
@@ -2408,10 +2462,6 @@ specified value.</para>
         <Parameter Name="d2" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> The value returned by <see cref="M:System.Decimal.Multiply(System.Decimal,System.Decimal)" /> (<paramref name="d1" />,
-<paramref name="d2" />). </para>
-        </returns>
         <exception cref="T:System.OverflowException">The result is greater than <see cref="F:System.Decimal.MaxValue" /> or less than <see cref="F:System.Decimal.MinValue" />.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2423,6 +2473,10 @@ specified value.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Multiplies two specified <see cref="T:System.Decimal" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of multiplying <paramref name="d1" /> by <paramref name="d2" />.</para>
+        </returns>
         <param name="d1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to multiply. </param>
         <param name="d2">
@@ -2448,11 +2502,6 @@ specified value.</para>
         <Parameter Name="d2" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> The value returned by <see cref="M:System.Decimal.Subtract(System.Decimal,System.Decimal)" /> (<paramref name="d1" />,
-<paramref name="d2" />
-).</para>
-        </returns>
         <exception cref="T:System.OverflowException">The result is greater than <see cref="F:System.Decimal.MaxValue" /> or less than <see cref="F:System.Decimal.MinValue" />. </exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2464,6 +2513,10 @@ specified value.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts two specified <see cref="T:System.Decimal" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of subtracting <paramref name="d2" /> from <paramref name="d1" />.</para>
+        </returns>
         <param name="d1">
           <attribution license="cc4" from="Microsoft" modified="false" />The minuend. </param>
         <param name="d2">
@@ -2488,9 +2541,6 @@ specified value.</para>
         <Parameter Name="d" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The value returned by <see cref="M:System.Decimal.Negate(System.Decimal)" /> (<paramref name="d" />).</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Decimal.op_UnaryPlus(System.Decimal)" /> method defines the operation of the unary negation operator (or the additive inverse operator) for <see cref="T:System.Decimal" /> values. The operation produces a value that results in 0 (zero) when it is added to the original number. Languages that do not support custom operators can call the <see cref="M:System.Decimal.Negate(System.Decimal)" /> method instead. </para>
@@ -2499,6 +2549,10 @@ specified value.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Negates the value of the specified <see cref="T:System.Decimal" /> operand.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of <paramref name="d" /> multiplied by negative one (-1).</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to negate. </param>
       </Docs>
@@ -2521,9 +2575,6 @@ specified value.</para>
         <Parameter Name="d" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns <paramref name="d" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Decimal.op_UnaryPlus(System.Decimal)" /> method defines the operation of the unary positive operator for <see cref="T:System.Decimal" /> values. </para>
@@ -2532,6 +2583,10 @@ specified value.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the value of the <see cref="T:System.Decimal" /> operand (the sign of the operand is unchanged).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the operand, <paramref name="d" />.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />The operand to return.</param>
       </Docs>
@@ -2554,9 +2609,6 @@ specified value.</para>
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Decimal" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -2672,6 +2724,10 @@ class DecimalParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number to its <see cref="T:System.Decimal" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The equivalent to the number contained in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string representation of the number to convert.</param>
       </Docs>
@@ -2695,10 +2751,6 @@ class DecimalParseClass {
         <Parameter Name="style" Type="System.Globalization.NumberStyles" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Decimal" /> value obtained from <paramref name="s" />
-.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -2997,6 +3049,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified style to its <see cref="T:System.Decimal" /> equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Decimal" /> number equivalent to the number contained in <paramref name="s" /> as specified by <paramref name="style" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string representation of the number to convert. </param>
         <param name="style">
@@ -3022,10 +3078,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Decimal" /> value obtained from <paramref name="s" />
-.</para>
-        </returns>
         <exception cref="T:System.FormatException">
           <paramref name="s" /> is not in the correct style.</exception>
         <exception cref="T:System.OverflowException">
@@ -3143,6 +3195,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number to its <see cref="T:System.Decimal" /> equivalent using the specified culture-specific format information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Decimal" /> number equivalent to the number contained in <paramref name="s" /> as specified by <paramref name="provider" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string representation of the number to convert. </param>
         <param name="provider">
@@ -3169,10 +3225,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Decimal" /> value obtained from <paramref name="s" />
-.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <para>
             <paramref name="s" /> is a null reference. </para>
@@ -3478,6 +3530,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number to its <see cref="T:System.Decimal" /> equivalent using the specified style and culture-specific format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Decimal" /> number equivalent to the number contained in <paramref name="s" /> as specified by <paramref name="style" /> and <paramref name="provider" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />The string representation of the number to convert. </param>
         <param name="style">
@@ -3505,13 +3561,6 @@ public static void Main() {
         <Parameter Name="d2" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The remainder after dividing d1 by d2 to give an integer
-      result. The sign of the result, if non-zero, is the same as the sign of d1, and
-      the scale of the result is the larger of the scales of d1 and d2.</para>
-          <para>For example, -10 % 3 gives -1, and 3.6 % 1.3 gives 1.0 (where % indicates the
-      remainder operation).</para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.DivideByZeroException">
           <paramref name="d2" /> is zero.</exception>
@@ -3523,6 +3572,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Computes the remainder after dividing two <see cref="T:System.Decimal" /> values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The remainder after dividing <paramref name="d1" /> by <paramref name="d2" />.</para>
+        </returns>
         <param name="d1">
           <attribution license="cc4" from="Microsoft" modified="false" />The dividend. </param>
         <param name="d2">
@@ -3545,7 +3598,6 @@ public static void Main() {
         <Parameter Name="d" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3555,6 +3607,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Rounds a decimal value to the nearest integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The integer that is nearest to the <paramref name="d" /> parameter. If <paramref name="d" /> is halfway between two integers, one of which is even and the other odd, the even number is returned.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />A decimal number to round. </param>
       </Docs>
@@ -3577,10 +3633,6 @@ public static void Main() {
         <Parameter Name="decimals" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Decimal" /> result of rounding <paramref name="d" /> to <paramref name="decimals" />
-decimal places.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="decimals" /> is not between 0 and 28, inclusive. </exception>
         <example>
@@ -3627,6 +3679,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Rounds a <see cref="T:System.Decimal" /> value to a specified number of decimal places.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The decimal number equivalent to <paramref name="d" /> rounded to <paramref name="decimals" /> number of decimal places.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />A decimal number to round. </param>
         <param name="decimals">
@@ -3650,7 +3706,6 @@ public static void Main() {
         <Parameter Name="mode" Type="System.MidpointRounding" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3660,6 +3715,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Rounds a decimal value to the nearest integer. A parameter specifies how to round the value if it is midway between two other numbers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The integer that is nearest to the <paramref name="d" /> parameter. If <paramref name="d" /> is halfway between two numbers, one of which is even and the other odd, the <paramref name="mode" /> parameter determines which of the two numbers is returned. </para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />A decimal number to round. </param>
         <param name="mode">
@@ -3683,7 +3742,6 @@ public static void Main() {
         <Parameter Name="mode" Type="System.MidpointRounding" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3694,6 +3752,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Rounds a decimal value to a specified precision. A parameter specifies how to round the value if it is midway between two other numbers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number that is nearest to the <paramref name="d" /> parameter with a precision equal to the <paramref name="decimals" /> parameter. If <paramref name="d" /> is halfway between two numbers, one of which is even and the other odd, the <paramref name="mode" /> parameter determines which of the two numbers is returned. If the precision of <paramref name="d" /> is less than <paramref name="decimals" />, <paramref name="d" /> is returned unchanged.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />A decimal number to round. </param>
         <param name="decimals">
@@ -3720,19 +3782,16 @@ public static void Main() {
         <Parameter Name="d2" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Decimal" /> containing the result of subtracting <paramref name="d2" /> from
-<paramref name="d1" /> . The scale of the result, before any rounding, is 
-   the larger of the scales of d1 and
-   d2.</para>
-          <para>For example, 1.1 - 2.22 gives -1.12, and 2.50 - 1 gives 1.50.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.OverflowException">The result is greater than <see cref="F:System.Decimal.MaxValue" /> or less than <see cref="F:System.Decimal.MinValue" />. </exception>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts one specified <see cref="T:System.Decimal" /> value from another.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of subtracting <paramref name="d2" /> from <paramref name="d1" />.</para>
+        </returns>
         <param name="d1">
           <attribution license="cc4" from="Microsoft" modified="false" />The minuend. </param>
         <param name="d2">
@@ -3756,7 +3815,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Decimal" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToBoolean(System.Decimal)" /> method.</para>
@@ -3765,6 +3823,11 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToBoolean(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+                                            true if the value of the current instance is not zero; otherwise, false.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored. </param>
       </Docs>
@@ -3785,7 +3848,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Decimal" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call either the <see cref="M:System.Decimal.ToByte(System.Decimal)" /> method or the <see cref="M:System.Convert.ToByte(System.Decimal)" /> method.</para>
@@ -3794,6 +3856,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToByte(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Byte" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -3814,12 +3880,15 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to use this method throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>None. This conversion is not supported. </para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -3840,12 +3909,15 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to use this method throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>None. This conversion is not supported. </para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -3866,7 +3938,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Decimal" /> instance is cast to an <see cref="T:System.IConvertible" /> interface.</para>
@@ -3875,6 +3946,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToDecimal(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, unchanged.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -3895,7 +3970,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Decimal" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call either the <see cref="M:System.Decimal.ToDouble(System.Decimal)" /> method or the <see cref="M:System.Convert.ToDouble(System.Decimal)" /> method.</para>
@@ -3905,6 +3979,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToDouble(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Double" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -3925,7 +4003,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Decimal" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call either the <see cref="M:System.Decimal.ToInt16(System.Decimal)" /> method or the <see cref="M:System.Convert.ToInt16(System.Decimal)" /> method.</para>
@@ -3935,6 +4012,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt16(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Int16" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -3955,7 +4036,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Decimal" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call either the <see cref="M:System.Decimal.ToInt32(System.Decimal)" /> method or the <see cref="M:System.Convert.ToInt32(System.Decimal)" /> method.</para>
@@ -3965,6 +4045,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt32(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Int32" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />The parameter is ignored.</param>
       </Docs>
@@ -3985,7 +4069,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Decimal" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call either the <see cref="M:System.Decimal.ToInt64(System.Decimal)" /> method or the <see cref="M:System.Convert.ToInt64(System.Decimal)" /> method.</para>
@@ -3994,6 +4077,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt64(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Int64" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -4014,7 +4101,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Decimal" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call either the <see cref="M:System.Decimal.ToSByte(System.Decimal)" /> method or the <see cref="M:System.Convert.ToSByte(System.Decimal)" /> method.</para>
@@ -4023,6 +4109,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToSByte(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.SByte" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -4043,7 +4133,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Decimal" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call either the <see cref="M:System.Decimal.ToSingle(System.Decimal)" /> method or the <see cref="M:System.Convert.ToSingle(System.Decimal)" /> method.</para>
@@ -4052,6 +4141,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToSingle(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Single" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -4074,7 +4167,6 @@ public static void Main() {
       </Parameters>
       <Docs>
         <param name="targetType">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Decimal" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the static (Shared in Visual Basic) <see cref="M:System.Convert.ChangeType(System.Object,System.Type,System.IFormatProvider)" /> method instead.</para>
@@ -4083,6 +4175,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToType(System.Type,System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <paramref name="type" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> implementation that supplies culture-specific information about the format of the returned value.</param>
       </Docs>
@@ -4103,7 +4199,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Decimal" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call either the <see cref="M:System.Decimal.ToUInt16(System.Decimal)" /> method or the <see cref="M:System.Convert.ToUInt16(System.Decimal)" /> method.</para>
@@ -4112,6 +4207,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt16(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.UInt16" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -4132,7 +4231,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Decimal" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call either the <see cref="M:System.Decimal.ToUInt32(System.Decimal)" /> method or the <see cref="M:System.Convert.ToUInt32(System.Decimal)" /> method.</para>
@@ -4142,6 +4240,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt32(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.UInt32" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -4162,7 +4264,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Decimal" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call either the <see cref="M:System.Decimal.ToUInt64(System.Decimal)" /> method or the <see cref="M:System.Convert.ToUInt64(System.Decimal)" /> method.</para>
@@ -4172,6 +4273,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt64(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.UInt64" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -4215,7 +4320,6 @@ public static void Main() {
         <Parameter Name="value" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Parameter <paramref name="value" /> is rounded to the nearest integer value toward zero, and that result is returned.</para>
@@ -4224,6 +4328,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified <see cref="T:System.Decimal" /> to the equivalent 8-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit unsigned integer equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The decimal number to convert. </param>
       </Docs>
@@ -4244,7 +4352,6 @@ public static void Main() {
         <Parameter Name="d" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation can produce round-off errors because a double-precision floating-point number has fewer significant digits than a <see cref="T:System.Decimal" />.</para>
@@ -4253,6 +4360,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified <see cref="T:System.Decimal" /> to the equivalent double-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A double-precision floating-point number equivalent to <paramref name="d" />.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />The decimal number to convert. </param>
       </Docs>
@@ -4273,12 +4384,15 @@ public static void Main() {
         <Parameter Name="value" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified <see cref="T:System.Decimal" /> to the equivalent 16-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit signed integer equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The decimal number to convert. </param>
       </Docs>
@@ -4299,7 +4413,6 @@ public static void Main() {
         <Parameter Name="d" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is the integral part of the decimal value; fractional digits are truncated.</para>
@@ -4308,6 +4421,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified <see cref="T:System.Decimal" /> to the equivalent 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer equivalent to the value of <paramref name="d" />.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />The decimal number to convert. </param>
       </Docs>
@@ -4328,7 +4445,6 @@ public static void Main() {
         <Parameter Name="d" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is the integral part of the decimal value; fractional digits are truncated.</para>
@@ -4337,6 +4453,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified <see cref="T:System.Decimal" /> to the equivalent 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit signed integer equivalent to the value of <paramref name="d" />.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />The decimal number to convert. </param>
       </Docs>
@@ -4357,12 +4477,15 @@ public static void Main() {
         <Parameter Name="value" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified <see cref="T:System.Decimal" /> value to the equivalent OLE Automation Currency value, which is contained in a 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit signed integer that contains the OLE Automation equivalent of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The decimal number to convert. </param>
       </Docs>
@@ -4388,12 +4511,15 @@ public static void Main() {
         <Parameter Name="value" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified <see cref="T:System.Decimal" /> to the equivalent 8-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit signed integer equivalent to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The decimal number to convert. </param>
       </Docs>
@@ -4414,7 +4540,6 @@ public static void Main() {
         <Parameter Name="d" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This operation can produce round-off errors because a single-precision floating-point number has fewer significant digits than a <see cref="T:System.Decimal" />.</para>
@@ -4423,6 +4548,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified <see cref="T:System.Decimal" /> to the equivalent single-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A single-precision floating-point number equivalent to the value of <paramref name="d" />.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />The decimal number to convert. </param>
       </Docs>
@@ -4442,12 +4571,6 @@ public static void Main() {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of
-   the current instance formatted using the general format specifier, ("G"). The string
-   takes into account the current system culture and
-   preserves the scale of the number.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Decimal.ToString" /> method formats a <see cref="T:System.Decimal" /> value in the default ("G", or general) format of the current culture. If you want to specify a different format or culture, use the other overloads of the <see cref="M:System.Decimal.ToString(System.String)" /> method, as follows: </para>
@@ -4521,6 +4644,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the value of this instance.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -4541,11 +4668,6 @@ public static void Main() {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted using
-   the general format specifier, ("G"). The string takes into account the
-   formatting information in the <see cref="T:System.Globalization.NumberFormatInfo" /> instance supplied by <paramref name="provider" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Decimal.ToString(System.IFormatProvider)" /> method formats a <see cref="T:System.Decimal" /> value in the default ("G", or general) format of a specified culture. If you want to specify a different format or the current culture, use the other overloads of the <see cref="M:System.Decimal.ToString(System.String)" /> method, as follows:</para>
@@ -4621,6 +4743,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance as specified by <paramref name="provider" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information. </param>
       </Docs>
@@ -4643,11 +4769,6 @@ public static void Main() {
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted as
-   specified by <paramref name="format" />. The string takes into account the current system
-   culture.</para>
-        </returns>
         <exception cref="T:System.FormatException">
           <paramref name="format" /> is invalid.</exception>
         <example>
@@ -4751,6 +4872,10 @@ class test {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation, using the specified format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance as specified by <paramref name="format" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A standard or custom numeric format string (see Remarks).</param>
       </Docs>
@@ -4774,11 +4899,6 @@ class test {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted as
-   specified by <paramref name="format" />. The string takes into account the information in
-   the <see cref="T:System.Globalization.NumberFormatInfo" /> instance supplied by <paramref name="provider" />.</para>
-        </returns>
         <exception cref="T:System.FormatException">
           <paramref name="format" /> is invalid.</exception>
         <remarks>
@@ -4854,6 +4974,10 @@ class test {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance as specified by <paramref name="format" /> and <paramref name="provider" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A numeric format string (see Remarks).</param>
         <param name="provider">
@@ -4882,7 +5006,6 @@ class test {
         <Parameter Name="value" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is the integral part of the decimal value; fractional digits are truncated.</para>
@@ -4891,6 +5014,10 @@ class test {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified <see cref="T:System.Decimal" /> to the equivalent 16-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit unsigned integer equivalent to the value of <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The decimal number to convert. </param>
       </Docs>
@@ -4916,7 +5043,6 @@ class test {
         <Parameter Name="d" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is the integral part of the decimal value; fractional digits are truncated.</para>
@@ -4925,6 +5051,10 @@ class test {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified <see cref="T:System.Decimal" /> to the equivalent 32-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit unsigned integer equivalent to the value of <paramref name="d" />.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />The decimal number to convert. </param>
       </Docs>
@@ -4950,7 +5080,6 @@ class test {
         <Parameter Name="d" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is the integral part of the decimal value; fractional digits are truncated.</para>
@@ -4959,6 +5088,10 @@ class test {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the specified <see cref="T:System.Decimal" /> to the equivalent 64-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit unsigned integer equivalent to the value of <paramref name="d" />.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />The decimal number to convert. </param>
       </Docs>
@@ -4980,10 +5113,6 @@ class test {
         <Parameter Name="d" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Decimal" /> result of truncating <paramref name="d" /> . the scale of the result is 
-   0.</para>
-        </returns>
         <example>
           <para>The following example demonstrates using the <see cref="M:System.Decimal.Truncate(System.Decimal)" /> method.</para>
           <code lang="C#">using System;
@@ -5010,6 +5139,10 @@ public static void Main() {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the integral digits of the specified <see cref="T:System.Decimal" />; any fractional digits are discarded.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of <paramref name="d" /> rounded toward zero, to the nearest whole number.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />The decimal number to truncate. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System/Delegate.xml b/mcs/class/corlib/Documentation/en/System/Delegate.xml
index 32bcefbef6b..6fa1c6e8a4c 100644
--- a/mcs/class/corlib/Documentation/en/System/Delegate.xml
+++ b/mcs/class/corlib/Documentation/en/System/Delegate.xml
@@ -226,9 +226,6 @@ class TestClass {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Object" /> that is a copy of the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The clone has the same <see cref="T:System.Type" />, target, method, and invocation list as the original delegate.</para>
@@ -238,6 +235,10 @@ class TestClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a shallow copy of the delegate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A shallow copy of the delegate.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -269,11 +270,6 @@ class TestClass {
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new delegate, or <see langword="null" /> if <paramref name="delegates" /> is <see langword="null" /> or has only
-<see langword="null" /> 
-elements.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>The non-<see langword="null" /> delegates in <paramref name="delegates" /> are not of the same type.</para>
         </exception>
@@ -291,6 +287,10 @@ elements.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Concatenates the invocation lists of an array of delegates.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new delegate with an invocation list that concatenates the invocation lists of the delegates in the <paramref name="delegates" /> array. Returns null if <paramref name="delegates" /> is null, if <paramref name="delegates" /> contains zero elements, or if every entry in <paramref name="delegates" /> is null.</para>
+        </returns>
         <param name="delegates">
           <attribution license="cc4" from="Microsoft" modified="false" />The array of delegates to combine. </param>
       </Docs>
@@ -314,42 +314,6 @@ elements.</para>
         <Parameter Name="b" Type="System.Delegate" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A delegate, or <see langword="null" /> .</para>
-          <para>The following table describes the value returned
-   when <paramref name="a" /> or <paramref name="b" /> is
-<see langword="null" />
-.</para>
-          <list type="table">
-            <listheader>
-              <term>a</term>
-              <description>b</description>
-              <description>Return Value</description>
-            </listheader>
-            <item>
-              <term> null</term>
-              <description>null</description>
-              <description>null</description>
-            </item>
-            <item>
-              <term> null</term>
-              <description>non-null</description>
-              <description>
-                <paramref name="b" />
-              </description>
-            </item>
-            <item>
-              <term> non-null</term>
-              <description>null</description>
-              <description>
-                <paramref name="a" />
-              </description>
-            </item>
-          </list>
-          <para>When <paramref name="a" /> and <paramref name="b" /> are non-null, this method
-returns a new delegate with the concatenated invocation lists of <paramref name="a" /> and
-<paramref name="b" /> .</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>
             <paramref name="a" /> and <paramref name="b" /> are not <see langword="null" /> and not of the same type.</para>
@@ -367,6 +331,10 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Concatenates the invocation lists of two delegates.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new delegate with an invocation list that concatenates the invocation lists of <paramref name="a" /> and <paramref name="b" /> in that order. Returns <paramref name="a" /> if <paramref name="b" /> is null, returns <paramref name="b" /> if <paramref name="a" /> is a null reference, and returns a null reference if both <paramref name="a" /> and <paramref name="b" /> are null references.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate whose invocation list comes first. </param>
         <param name="b">
@@ -390,7 +358,6 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
         <Parameter Name="d" Type="System.Delegate" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method applies only if the current delegate is multicast (combinable).</para>
@@ -401,6 +368,10 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Concatenates the invocation lists of the specified multicast (combinable) delegate and the current multicast (combinable) delegate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new multicast (combinable) delegate with an invocation list that concatenates the invocation list of the current multicast (combinable) delegate and the invocation list of <paramref name="d" />, or the current multicast (combinable) delegate if <paramref name="d" /> is null.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />The multicast (combinable) delegate whose invocation list to append to the end of the invocation list of the current multicast (combinable) delegate. </param>
       </Docs>
@@ -423,9 +394,6 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Delegate" /> of type <paramref name="type" /> that invokes <paramref name="method." /></para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="type" /> or <paramref name="method" /> is <see langword="null" />.</exception>
         <exception cref="T:System.ArgumentException">
@@ -468,6 +436,10 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a delegate of the specified type to represent the specified static method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A delegate of the specified type to represent the specified static method.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of delegate to create. </param>
         <param name="method">
@@ -493,7 +465,6 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
         <Parameter Name="method" Type="System.Reflection.MethodInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -562,6 +533,10 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a delegate of the specified type that represents the specified static or instance method, with the specified first argument.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A delegate of the specified type that represents the specified static or instance method. </para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of delegate to create. </param>
         <param name="firstArgument">
@@ -589,10 +564,6 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
         <Parameter Name="method" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Delegate" /> of type
-<paramref name="type" /> that invokes <paramref name="method" /> on <paramref name="target" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <para>
             <paramref name="type, target, or method" /> is <see langword="null" />.</para>
@@ -624,6 +595,10 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a delegate of the specified type that represents the specified instance method to invoke on the specified class instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A delegate of the specified type that represents the specified instance method to invoke on the specified class instance.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of delegate to create. </param>
         <param name="target">
@@ -651,7 +626,6 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
         <Parameter Name="throwOnBindFailure" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -678,6 +652,10 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a delegate of the specified type to represent the specified static method, with the specified behavior on failure to bind.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A delegate of the specified type to represent the specified static method.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of delegate to create. </param>
         <param name="method">
@@ -705,9 +683,6 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
         <Parameter Name="method" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Delegate" /> of type <paramref name="type" /> that invokes <paramref name="method." /></para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <para>
             <paramref name="type, target, or method" /> is <see langword="null" />.</para>
@@ -739,6 +714,10 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a delegate of the specified type that represents the specified static method of the specified class.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A delegate of the specified type that represents the specified static method of the specified class.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of delegate to create. </param>
         <param name="target">
@@ -767,7 +746,6 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
         <Parameter Name="throwOnBindFailure" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -836,6 +814,10 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a delegate of the specified type that represents the specified static or instance method, with the specified first argument and the specified behavior on failure to bind.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A delegate of the specified type that represents the specified static or instance method, or null if <paramref name="throwOnBindFailure" /> is false and the delegate cannot be bound to <paramref name="method" />. </para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> representing the type of delegate to create. </param>
         <param name="firstArgument">
@@ -865,7 +847,6 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates delegates for instance methods only. An instance method is a method that is associated with an instance of a class; a static method is a method that is associated with the class itself.</para>
@@ -879,6 +860,10 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a delegate of the specified type that represents the specified instance method to invoke on the specified class instance with the specified case-sensitivity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A delegate of the specified type that represents the specified instance method to invoke on the specified class instance.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of delegate to create. </param>
         <param name="target">
@@ -907,7 +892,6 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates delegates for static methods only. An instance method is a method that is associated with an instance of a class; a static method is a method that is associated with the class itself.</para>
@@ -921,6 +905,10 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a delegate of the specified type that represents the specified static method of the specified class, with the specified case-sensitivity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A delegate of the specified type that represents the specified static method of the specified class.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of delegate to create. </param>
         <param name="target">
@@ -950,7 +938,6 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
         <Parameter Name="throwOnBindFailure" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -964,6 +951,10 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a delegate of the specified type that represents the specified instance method to invoke on the specified class instance, with the specified case-sensitivity and the specified behavior on failure to bind.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A delegate of the specified type that represents the specified instance method to invoke on the specified class instance.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of delegate to create. </param>
         <param name="target">
@@ -995,7 +986,6 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
         <Parameter Name="throwOnBindFailure" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method creates delegates for static methods only. An instance method is a method that is associated with an instance of a class; a static method is a method that is associated with the class itself.</para>
@@ -1008,6 +998,10 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a delegate of the specified type that represents the specified static method of the specified class, with the specified case-sensitivity and the specified behavior on failure to bind.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A delegate of the specified type that represents the specified static method of the specified class.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of delegate to create. </param>
         <param name="target">
@@ -1043,10 +1037,6 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Object" /> returned by the
-   last method in the invocation list of the current instance.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>The type of one or more elements in <paramref name="args" /> is invalid as a parameter to the methods implemented by the current instance.</para>
         </exception>
@@ -1072,6 +1062,10 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Dynamically invokes (late-bound) the method represented by the current delegate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object returned by the method represented by the delegate.</para>
+        </returns>
         <param name="args">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of objects that are the arguments to pass to the method represented by the current delegate.</param>
       </Docs>
@@ -1094,7 +1088,6 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
         <Parameter Name="args" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method implements the <see cref="M:System.Delegate.DynamicInvoke(System.Object[])" /> method.</para>
@@ -1103,6 +1096,10 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Dynamically invokes (late-bound) the method represented by the current delegate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object returned by the method represented by the delegate.</para>
+        </returns>
         <param name="args">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of objects that are the arguments to pass to the method represented by the current delegate.</param>
       </Docs>
@@ -1124,11 +1121,6 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> is equal to the
-   current instance, otherwise <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the two delegates are not of the same type, they are not considered equal.</para>
@@ -1153,6 +1145,10 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified object and the current delegate are of the same type and share the same targets, methods, and invocation list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> and the current delegate have the same targets, methods, and invocation list; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current delegate. </param>
       </Docs>
@@ -1173,9 +1169,6 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the hash code for this instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value of this method must not be persisted for two reasons. First, the hash function of a class might be altered to generate a better distribution, rendering any values from the old hash function useless. Second, the default implementation of this class does not guarantee that the same value will be returned by different instances.</para>
@@ -1184,6 +1177,10 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash code for the delegate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the delegate.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1202,9 +1199,6 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>An ordered set of <see cref="T:System.Delegate" /> instances whose invocation lists collectively match those of the current delegate.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Each delegate in the array represents exactly one method.</para>
@@ -1214,6 +1208,10 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the invocation list of the delegate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of delegates representing the invocation list of the current delegate.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1231,7 +1229,6 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method applies only if the current delegate represents a static method.</para>
@@ -1240,6 +1237,10 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the static method represented by the current delegate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.MethodInfo" /> describing the static method represented by the current delegate.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetObjectData">
@@ -1320,12 +1321,6 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
         <Parameter Name="d2" Type="System.Delegate" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if
-<paramref name="d1" />.Equals(<paramref name="d2" />) returns <see langword="true" />; 
-   otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Two delegates of the same type with the same targets, methods, and invocation lists are considered equal.</para>
@@ -1351,6 +1346,10 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified delegates are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="d1" /> is equal to <paramref name="d2" />; otherwise, false.</para>
+        </returns>
         <param name="d1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first delegate to compare. </param>
         <param name="d2">
@@ -1376,12 +1375,6 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
         <Parameter Name="d2" Type="System.Delegate" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if
-<paramref name="d1" />.Equals(<paramref name="d2" />) returns 
-<see langword="false" />; otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Two delegates are considered not equal if they are of different types, or have different methods, different targets, or different invocation lists.</para>
@@ -1407,6 +1400,10 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified delegates are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="d1" /> is not equal to <paramref name="d2" />; otherwise, false.</para>
+        </returns>
         <param name="d1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first delegate to compare. </param>
         <param name="d2">
@@ -1432,49 +1429,6 @@ returns a new delegate with the concatenated invocation lists of <paramref name=
         <Parameter Name="value" Type="System.Delegate" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns a new delegate, <paramref name="source" />, or <see langword="null" /> . </para>
-          <para>If <paramref name="source" /> and <paramref name="value" /> are not <see langword="null" /> , are not equal, and the
-invocation list of <paramref name="value" /> is contained in the invocation list of source,
-returns a new delegate with the invocation list of <paramref name="value" /> removed from
-the invocation list of <paramref name="source" />.</para>
-          <para>If the invocation lists of <paramref name="source" /> and <paramref name="value" /> are equal,
-returns <see langword="null" />
-.</para>
-          <para>If the invocation list of <paramref name="value" /> is not found in the invocation list
-of <paramref name="source" />, returns <paramref name="source" />.</para>
-          <para>The following table describes the value returned when <paramref name="source" /> or
-<paramref name="value" /> is 
-<see langword="null" /> .</para>
-          <list type="table">
-            <listheader>
-              <term>
-                <paramref name="source" />
-              </term>
-              <description>
-                <paramref name="value" />
-              </description>
-              <description>Return value</description>
-            </listheader>
-            <item>
-              <term> null</term>
-              <description>null</description>
-              <description>null</description>
-            </item>
-            <item>
-              <term> null</term>
-              <description>non-null</description>
-              <description>null</description>
-            </item>
-            <item>
-              <term> non-null</term>
-              <description>null</description>
-              <description>
-                <paramref name="source" />
-              </description>
-            </item>
-          </list>
-        </returns>
         <example>
           <para>The following example demonstrates the <see cref="M:System.Delegate.Remove(System.Delegate,System.Delegate)" /> method.</para>
           <code lang="C#">using System;
@@ -1623,6 +1577,10 @@ class TestClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the last occurrence of the invocation list of a delegate from the invocation list of another delegate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new delegate with an invocation list formed by taking the invocation list of <paramref name="source" /> and removing the last occurrence of the invocation list of <paramref name="value" />, if the invocation list of <paramref name="value" /> is found within the invocation list of <paramref name="source" />. Returns <paramref name="source" /> if <paramref name="value" /> is null or if the invocation list of <paramref name="value" /> is not found within the invocation list of <paramref name="source" />. Returns a null reference if the invocation list of <paramref name="value" /> is equal to the invocation list of <paramref name="source" /> or if <paramref name="source" /> is a null reference.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate from which to remove the invocation list of <paramref name="value" />. </param>
         <param name="value">
@@ -1648,42 +1606,6 @@ class TestClass {
         <Parameter Name="value" Type="System.Delegate" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>Returns a new delegate, <paramref name="source" />, or <see langword="null" />.</para>
-          <para>If <paramref name="source" /> and <paramref name="value" /> are not <see langword="null" /> , are not equal, and the invocation list of <paramref name="value" /> is contained in the invocation list of source, returns a new delegate with all matching occurrences of the invocation list of <paramref name="value" /> removed from the invocation list of <paramref name="source" />.
-    </para>
-          <para>If the invocation lists of <paramref name="source" /> and <paramref name="value" /> are equal, or if <paramref name="source" /> contains only a succession of invocation lists equal to <paramref name="value" />, returns <see langword="null" />.</para>
-          <para>If the invocation list of <paramref name="value" /> is not found in the invocation list of <paramref name="source" />, returns <paramref name="source" />.</para>
-          <para>The following table describes the value returned when <paramref name="source" /> or <paramref name="value" /> is <see langword="null" /> .</para>
-          <list type="table">
-            <listheader>
-              <term>
-                <paramref name="source" />
-              </term>
-              <description>
-                <paramref name="value" />
-              </description>
-              <description>Return value</description>
-            </listheader>
-            <item>
-              <term> null</term>
-              <description>null</description>
-              <description>null</description>
-            </item>
-            <item>
-              <term> null</term>
-              <description>non-null</description>
-              <description>null</description>
-            </item>
-            <item>
-              <term> non-null</term>
-              <description>null</description>
-              <description>
-                <paramref name="source" />
-              </description>
-            </item>
-          </list>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the invocation list of <paramref name="value" /> matches a contiguous set of elements in the invocation list of <paramref name="source" />, then the invocation list of <paramref name="value" /> is said to occur within the invocation list of <paramref name="source" />. If the invocation list of <paramref name="value" /> occurs more than once in the invocation list of <paramref name="source" />, all occurrences are removed.</para>
@@ -1692,6 +1614,10 @@ class TestClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes all occurrences of the invocation list of a delegate from the invocation list of another delegate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new delegate with an invocation list formed by taking the invocation list of <paramref name="source" /> and removing all occurrences of the invocation list of <paramref name="value" />, if the invocation list of <paramref name="value" /> is found within the invocation list of <paramref name="source" />. Returns <paramref name="source" /> if <paramref name="value" /> is null or if the invocation list of <paramref name="value" /> is not found within the invocation list of <paramref name="source" />. Returns a null reference if the invocation list of <paramref name="value" /> is equal to the invocation list of <paramref name="source" />, if <paramref name="source" /> contains only a series of invocation lists that are equal to the invocation list of <paramref name="value" />, or if <paramref name="source" /> is a null reference.</para>
+        </returns>
         <param name="source">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate from which to remove the invocation list of <paramref name="value" />. </param>
         <param name="value">
@@ -1715,7 +1641,6 @@ class TestClass {
         <Parameter Name="d" Type="System.Delegate" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the invocation list of <paramref name="value" /> matches a contiguous set of elements in the current delegate's invocation list, then the invocation list of <paramref name="value" /> is said to occur within the current delegate's invocation list. If the invocation list of <paramref name="value" /> occurs more than once in the current delegate's invocation list, the last occurrence is removed.</para>
@@ -1724,6 +1649,10 @@ class TestClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes the invocation list of a delegate from the invocation list of another delegate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new delegate with an invocation list formed by taking the invocation list of the current delegate and removing the invocation list of <paramref name="value" />, if the invocation list of <paramref name="value" /> is found within the current delegate's invocation list. Returns the current delegate if <paramref name="value" /> is null or if the invocation list of <paramref name="value" /> is not found within the current delegate's invocation list. Returns null if the invocation list of <paramref name="value" /> is equal to the current delegate's invocation list.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate that supplies the invocation list to remove from the invocation list of the current delegate. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System/Double.xml b/mcs/class/corlib/Documentation/en/System/Double.xml
index 5524f1c4a7c..3109b4a0049 100644
--- a/mcs/class/corlib/Documentation/en/System/Double.xml
+++ b/mcs/class/corlib/Documentation/en/System/Double.xml
@@ -319,46 +319,6 @@
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="value" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
-          <list type="table">
-            <listheader>
-              <term>Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> Any
-         negative
-         number</term>
-              <description>
-                <para>Current instance &lt; <paramref name="value" />.</para>
-                <para>-or-</para>
-                <para>Current instance is a NaN and <paramref name="value" /> is
-      not a NaN.</para>
-              </description>
-            </item>
-            <item>
-              <term> Zero</term>
-              <description>
-                <para> Current instance ==
-      <paramref name="value" />.</para>
-                <para>-or-</para>
-                <para> Current instance and <paramref name="value" />
-   are both NaN, positive infinity, or negative
-   infinity.</para>
-              </description>
-            </item>
-            <item>
-              <term> A positive number</term>
-              <description>
-                <para>Current instance &gt; <paramref name="value" />.</para>
-                <para>-or-</para>
-                <para>Current instance is not a NaN and <paramref name="value" />
-is a NaN.</para>
-              </description>
-            </item>
-          </list>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -381,6 +341,52 @@ is a NaN.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this instance to a specified double-precision floating-point number and returns an integer that indicates whether the value of this instance is less than, equal to, or greater than the value of the specified double-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number indicating the relative values of this instance and <paramref name="value" />.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than <paramref name="value" />.</para>
+                <para>-or- </para>
+                <para>This instance is not a number (<see cref="F:System.Double.NaN" />) and <paramref name="value" /> is a number. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is equal to <paramref name="value" />.</para>
+                <para>-or- </para>
+                <para>Both this instance and <paramref name="value" /> are not a number (<see cref="F:System.Double.NaN" />), <see cref="F:System.Double.PositiveInfinity" />, or <see cref="F:System.Double.NegativeInfinity" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than <paramref name="value" />.</para>
+                <para>-or- </para>
+                <para>This instance is a number and <paramref name="value" /> is not a number (<see cref="F:System.Double.NaN" />). </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A double-precision floating-point number to compare. </param>
       </Docs>
@@ -402,66 +408,72 @@ is a NaN.</para>
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="value " />is not a null reference and is not of type <see cref="T:System.Double" />.</exception>
+        <remarks>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <paramref name="value" /> parameter must be null or an instance of Double; otherwise, an exception is thrown. Any instance of <see cref="T:System.Double" />, regardless of its value, is considered greater than null.</para>
+          <para>Values must be identical to be considered equal. Particularly when floating-point values depend on multiple mathematical operations, it is common for them to lose precision and for their values to be nearly identical except for their least significant digits. Because of this, the return value of the <see cref="M:System.Double.CompareTo(System.Object)" /> method at times may seem surprising. For example, multiplication by a particular value followed by division by the same value should produce the original value. In the following example, however, the computed value turns out to be greater than the original value. Showing all significant digits of the two values by using the "R" <format type="text/html"><a href="580e57eb-ac47-4ffd-bccd-3a1637c2f467">standard numeric format string</a></format> indicates that the computed value differs from the original value in its least significant digits. For information on handling such comparisons, see the Remarks section of the <see cref="M:System.Double.Equals(System.Double)" /> method. </para>
+          <para>code reference: System.Double.CompareTo#2</para>
+          <para>This method is implemented to support the <see cref="T:System.IComparable" /> interface. Note that, although a <see cref="F:System.Double.NaN" /> is not considered to be equal to another <see cref="F:System.Double.NaN" /> (even itself), the <see cref="T:System.IComparable" /> interface requires that A.CompareTo(A) return zero.</para>
+          <format type="text/html">
+            <h2>Precision in Comparisons</h2>
+          </format>
+          <para>The precision of floating-point numbers beyond the documented precision is specific to the implementation and version of the .NET Framework. Consequently, a comparison of two particular numbers might change between versions of the .NET Framework because the precision of the numbers' internal representation might change.</para>
+        </remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Compares this instance to a specified object and returns an integer that indicates whether the value of this instance is less than, equal to, or greater than the value of the specified object.</para>
+        </summary>
         <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="value" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number indicating the relative values of this instance and <paramref name="value" />.</para>
           <list type="table">
             <listheader>
-              <term>Value</term>
-              <description>Description</description>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
             </listheader>
             <item>
-              <term> Any
-         negative
-         number</term>
+              <term>
+                <para>A negative integer </para>
+              </term>
               <description>
-                <para>Current instance &lt; <paramref name="value" />.</para>
-                <para>-or-</para>
-                <para>Current instance is a NaN and <paramref name="value" /> is
-      not a NaN and is not a null reference.</para>
+                <para>This instance is less than <paramref name="value" />.</para>
+                <para>-or- </para>
+                <para>This instance is not a number (<see cref="F:System.Double.NaN" />) and <paramref name="value" /> is a number. </para>
               </description>
             </item>
             <item>
-              <term> Zero</term>
+              <term>
+                <para>Zero </para>
+              </term>
               <description>
-                <para> Current instance ==
-      <paramref name="value" />.</para>
-                <para>-or-</para>
-                <para> Current instance and <paramref name="value" />
-   are both NaN, positive infinity, or negative
-   infinity.</para>
+                <para>This instance is equal to <paramref name="value" />.</para>
+                <para>-or- </para>
+                <para>This instance and <paramref name="value" /> are both Double.NaN, <see cref="F:System.Double.PositiveInfinity" />, or <see cref="F:System.Double.NegativeInfinity" /> </para>
               </description>
             </item>
             <item>
-              <term> A positive number</term>
+              <term>
+                <para>A positive integer </para>
+              </term>
               <description>
-                <para>Current instance &gt; <paramref name="value" />.</para>
-                <para>-or-</para>
+                <para>This instance is greater than <paramref name="value" />.</para>
+                <para>-or- </para>
+                <para>This instance is a number and <paramref name="value" /> is not a number (<see cref="F:System.Double.NaN" />).</para>
+                <para>-or- </para>
                 <para>
-                  <paramref name="value" /> is a null reference.</para>
-                <para>-or-</para>
-                <para>Current instance is not a NaN and <paramref name="value" />
-is a NaN.</para>
+                  <paramref name="value" /> is null. </para>
               </description>
             </item>
           </list>
         </returns>
-        <exception cref="T:System.ArgumentException">
-          <paramref name="value " />is not a null reference and is not of type <see cref="T:System.Double" />.</exception>
-        <remarks>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>The <paramref name="value" /> parameter must be null or an instance of Double; otherwise, an exception is thrown. Any instance of <see cref="T:System.Double" />, regardless of its value, is considered greater than null.</para>
-          <para>Values must be identical to be considered equal. Particularly when floating-point values depend on multiple mathematical operations, it is common for them to lose precision and for their values to be nearly identical except for their least significant digits. Because of this, the return value of the <see cref="M:System.Double.CompareTo(System.Object)" /> method at times may seem surprising. For example, multiplication by a particular value followed by division by the same value should produce the original value. In the following example, however, the computed value turns out to be greater than the original value. Showing all significant digits of the two values by using the "R" <format type="text/html"><a href="580e57eb-ac47-4ffd-bccd-3a1637c2f467">standard numeric format string</a></format> indicates that the computed value differs from the original value in its least significant digits. For information on handling such comparisons, see the Remarks section of the <see cref="M:System.Double.Equals(System.Double)" /> method. </para>
-          <para>code reference: System.Double.CompareTo#2</para>
-          <para>This method is implemented to support the <see cref="T:System.IComparable" /> interface. Note that, although a <see cref="F:System.Double.NaN" /> is not considered to be equal to another <see cref="F:System.Double.NaN" /> (even itself), the <see cref="T:System.IComparable" /> interface requires that A.CompareTo(A) return zero.</para>
-          <format type="text/html">
-            <h2>Precision in Comparisons</h2>
-          </format>
-          <para>The precision of floating-point numbers beyond the documented precision is specific to the implementation and version of the .NET Framework. Consequently, a comparison of two particular numbers might change between versions of the .NET Framework because the precision of the numbers' internal representation might change.</para>
-        </remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Compares this instance to a specified object and returns an integer that indicates whether the value of this instance is less than, equal to, or greater than the value of the specified object.</para>
-        </summary>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare, or null. </param>
       </Docs>
@@ -522,11 +534,6 @@ is a NaN.</para>
         <Parameter Name="obj" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> has  the same value as the current instance, otherwise <see langword="false" />. If either <paramref name="obj" /> or the current instance is a NaN and the other is not, returns <see langword="false" />. If <paramref name="obj" /> and the current instance are both
-NaN, positive infinity, or negative infinity, returns <see langword="true" />.</para>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -556,6 +563,10 @@ NaN, positive infinity, or negative infinity, returns <see langword="true" />.</
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance and a specified <see cref="T:System.Double" /> object represent the same value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is equal to this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Double" /> object to compare to this instance.</param>
       </Docs>
@@ -577,16 +588,6 @@ NaN, positive infinity, or negative infinity, returns <see langword="true" />.</
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> is a <see cref="T:System.Double" /> 
-with the same value as the current instance, otherwise <see langword="false" />.
-If <paramref name="obj" /> is a null reference or is not an instance of <see cref="T:System.Double" />, returns
-<see langword="false" />. If 
-either <paramref name="obj" /> or the current instance is a NaN and the other is not,
-returns <see langword="false" />. If <paramref name="obj" /> and the current instance are both
-NaN, positive infinity, or negative infinity, returns <see langword="true" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Double.Equals(System.Double)" /> method should be used with caution, because two apparently equivalent values can be unequal due to the differing precision of the two values. The following example reports that the <see cref="T:System.Double" /> value .3333 and the <see cref="T:System.Double" /> returned by dividing 1 by 3 are unequal.</para>
@@ -602,6 +603,10 @@ NaN, positive infinity, or negative infinity, returns <see langword="true" />.</
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is an instance of <see cref="T:System.Double" /> and equals the value of this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance. </param>
       </Docs>
@@ -622,9 +627,6 @@ NaN, positive infinity, or negative infinity, returns <see langword="true" />.</
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the hash code for this instance.</para>
-        </returns>
         <remarks>
           <para>
  The algorithm used to generate the hash code is
@@ -640,6 +642,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -657,12 +663,15 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.TypeCode" /> for value type <see cref="T:System.Double" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The enumerated constant, <see cref="F:System.TypeCode.Double" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsInfinity">
@@ -682,11 +691,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="d" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="d" /> represents a
-   positive or negative infinity value; otherwise <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Floating-point operations return <see cref="F:System.Double.PositiveInfinity" /> or <see cref="F:System.Double.NegativeInfinity" /> to signal an overflow condition.</para>
@@ -695,6 +699,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified number evaluates to negative or positive infinity </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="d" /> evaluates to <see cref="F:System.Double.PositiveInfinity" /> or <see cref="F:System.Double.NegativeInfinity" />; otherwise, false.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />A double-precision floating-point number. </param>
       </Docs>
@@ -722,11 +730,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="d" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="d" /> represents a NaN
-   value; otherwise <see langword="false." /></para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Floating-point operations return <see cref="F:System.Double.NaN" /> to signal that that result of the operation is undefined. For example, dividing 0.0 by 0.0 results in <see cref="F:System.Double.NaN" />.</para>
@@ -739,6 +742,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the specified value is not a number (<see cref="F:System.Double.NaN" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="d" /> evaluates to <see cref="F:System.Double.NaN" />; otherwise, false.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />A double-precision floating-point number. </param>
       </Docs>
@@ -761,12 +768,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="d" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="d" /> represents a negative
-   infinity value; otherwise <see langword="false" />
-   .</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Floating-point operations return <see cref="F:System.Double.NegativeInfinity" /> to signal an overflow condition.</para>
@@ -775,6 +776,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified number evaluates to negative infinity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="d" /> evaluates to <see cref="F:System.Double.NegativeInfinity" />; otherwise, false.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />A double-precision floating-point number. </param>
       </Docs>
@@ -797,11 +802,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="d" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="d " />represents a positive
-   infinity value; otherwise <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Floating-point operations return <see cref="F:System.Double.PositiveInfinity" /> to signal an overflow condition.</para>
@@ -810,6 +810,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified number evaluates to positive infinity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="d" /> evaluates to <see cref="F:System.Double.PositiveInfinity" />; otherwise, false.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />A double-precision floating-point number. </param>
       </Docs>
@@ -949,7 +953,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="right" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Double.op_Equality(System.Double,System.Double)" /> method defines the equality operator for <see cref="T:System.Double" /> values.</para>
@@ -959,6 +962,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether two specified <see cref="T:System.Double" /> values are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> and <paramref name="right" /> are equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare. </param>
         <param name="right">
@@ -980,7 +987,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="right" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Double.op_GreaterThan(System.Double,System.Double)" /> method defines the operation of the greater-than operator for <see cref="T:System.Double" /> values.</para>
@@ -989,6 +995,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a specified <see cref="T:System.Double" /> value is greater than another specified <see cref="T:System.Double" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is greater than <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -1010,7 +1020,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="right" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Double.op_GreaterThanOrEqual(System.Double,System.Double)" /> method defines the operation of the greater-than-or-equal operator for <see cref="T:System.Double" /> values.</para>
@@ -1019,6 +1028,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a specified <see cref="T:System.Double" /> value is greater than or equal to another specified <see cref="T:System.Double" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is greater than or equal to <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -1040,7 +1053,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="right" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Double.op_Inequality(System.Double,System.Double)" /> method defines the inequality operator for <see cref="T:System.Double" /> values.</para>
@@ -1049,6 +1061,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether two specified <see cref="T:System.Double" /> values are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> and <paramref name="right" /> are not equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -1070,7 +1086,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="right" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Double.op_LessThan(System.Double,System.Double)" /> method defines the operation of the less-than operator for <see cref="T:System.Double" /> values.</para>
@@ -1079,6 +1094,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a specified <see cref="T:System.Double" /> value is less than another specified <see cref="T:System.Double" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is less than <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -1100,7 +1119,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="right" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Double.op_LessThanOrEqual(System.Double,System.Double)" /> method defines the operation of the less-than-or-equal operator for <see cref="T:System.Double" /> values.</para>
@@ -1109,6 +1127,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a specified <see cref="T:System.Double" /> value is less than or equal to another specified <see cref="T:System.Double" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is less than or equal to <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -1132,12 +1154,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Double" /> value obtained from <paramref name="s" />. If
-<paramref name="s" /> equals
-<see cref="P:System.Globalization.NumberFormatInfo.NaNSymbol" />, this method returns 
-<see cref="F:System.Double.NaN" /> .</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -1235,6 +1251,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number to its double-precision floating-point number equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A double-precision floating-point number that is equivalent to the numeric value or symbol specified in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a number to convert. </param>
       </Docs>
@@ -1258,11 +1278,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="style" Type="System.Globalization.NumberStyles" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Double" /> value obtained from <paramref name="s" />. If <paramref name="s" />
-   equals <see cref="P:System.Globalization.NumberFormatInfo.NaNSymbol" />, this method returns
-<see cref="F:System.Double.NaN" /> .</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -1533,6 +1548,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified style to its double-precision floating-point number equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A double-precision floating-point number that is equivalent to the numeric value or symbol specified in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a number to convert. </param>
         <param name="style">
@@ -1558,11 +1577,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Double" /> value obtained from <paramref name="s" />.  If <paramref name="s" />
-   equals <see cref="P:System.Globalization.NumberFormatInfo.NaNSymbol" />, this method returns
-<see cref="F:System.Double.NaN" /> .</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -1653,6 +1667,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified culture-specific format to its double-precision floating-point number equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A double-precision floating-point number that is equivalent to the numeric value or symbol specified in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a number to convert. </param>
         <param name="provider">
@@ -1679,11 +1697,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Double" /> value obtained from <paramref name="s" />.  If <paramref name="s" /> equals
-<see cref="P:System.Globalization.NumberFormatInfo.NaNSymbol" />, this method returns 
-<see cref="F:System.Double.NaN" /> .</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference</exception>
         <exception cref="T:System.FormatException">
@@ -1954,6 +1967,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified style and culture-specific format to its double-precision floating-point number equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A double-precision floating-point number that is equivalent to the numeric value or symbol specified in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a number to convert. </param>
         <param name="style">
@@ -2008,7 +2025,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Double" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToBoolean(System.Double)" /> method. </para>
@@ -2017,6 +2033,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToBoolean(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of the current instance is not zero; otherwise, false.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2037,7 +2057,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Double" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToByte(System.Double)" /> method.</para>
@@ -2046,6 +2065,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToByte(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Byte" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2066,12 +2089,15 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to use this method throws an <see cref="T:System.InvalidCastException" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2092,12 +2118,15 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to use this method throws an <see cref="T:System.InvalidCastException" /></para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2118,7 +2147,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Double" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToDecimal(System.Double)" /> method.</para>
@@ -2127,6 +2155,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToDecimal(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Decimal" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2147,7 +2179,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Double" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. </para>
@@ -2156,6 +2187,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToDouble(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, unchanged.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2176,7 +2211,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Double" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt16(System.Double)" /> method.</para>
@@ -2185,6 +2219,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt16(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.Int16" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2205,7 +2243,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Double" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt32(System.Double)" /> method.</para>
@@ -2214,6 +2251,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt32(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.Int32" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2234,7 +2275,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Double" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt64(System.Double)" /> method.</para>
@@ -2243,6 +2283,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt64(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.Int64" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2263,7 +2307,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Double" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToSByte(System.Double)" /> method.</para>
@@ -2272,6 +2315,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToSByte(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.SByte" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2292,7 +2339,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Double" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToSingle(System.Double)" /> method.</para>
@@ -2301,6 +2347,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToSingle(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Single" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2323,7 +2373,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
       </Parameters>
       <Docs>
         <param name="targetType">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Double" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the static (Shared in Visual Basic) <see cref="M:System.Convert.ChangeType(System.Object,System.Type,System.IFormatProvider)" /> method.</para>
@@ -2332,6 +2381,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToType(System.Type,System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to <paramref name="type" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> implementation that supplies culture-specific information about the format of the returned value.</param>
       </Docs>
@@ -2352,7 +2405,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Double" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt16(System.Double)" /> method.</para>
@@ -2361,6 +2413,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt16(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.UInt16" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored. </param>
       </Docs>
@@ -2381,7 +2437,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Double" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt32(System.Double)" /> method.</para>
@@ -2390,6 +2445,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt32(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.UInt32" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.   </param>
       </Docs>
@@ -2410,7 +2469,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Double" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt64(System.Double)" /> method.</para>
@@ -2419,6 +2477,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt64(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.UInt64" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2438,11 +2500,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted using
-   the general format specifier, ("G"). The string
-   takes into account the current system culture.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Double.ToString" /> method formats a <see cref="T:System.Double" /> value in the default ("G", or general) format of the current culture. If you want to specify a different format or culture, use the other overloads of the <see cref="M:System.Double.ToString(System.String)" /> method, as follows: </para>
@@ -2579,6 +2636,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -2599,12 +2660,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted using
-   the general format specifier, ("G"). The string takes into account the
-   formatting information in the <see cref="T:System.Globalization.NumberFormatInfo" /> instance supplied by
-<paramref name="provider" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Double.ToString(System.IFormatProvider)" /> method formats a <see cref="T:System.Double" /> value in the default ("G", or general) format of a specified culture. If you want to specify a different format or culture, use the other overloads of the <see cref="M:System.Double.ToString(System.String)" /> method, as follows:</para>
@@ -2742,6 +2797,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance as specified by <paramref name="provider" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information. </param>
       </Docs>
@@ -2764,11 +2823,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted as
-   specified by <paramref name="format" />. The string takes into account the current system
-   culture.</para>
-        </returns>
         <exception cref="T:System.FormatException">
           <paramref name="format" /> is invalid.</exception>
         <example>
@@ -2873,6 +2927,10 @@ class test {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation, using the specified format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance as specified by <paramref name="format" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A numeric format string.</param>
       </Docs>
@@ -2896,11 +2954,6 @@ class test {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted as
-   specified by <paramref name="format" />. The string takes into account the information in
-   the <see cref="T:System.Globalization.NumberFormatInfo" /> instance supplied by <paramref name="provider" />.</para>
-        </returns>
         <exception cref="T:System.FormatException">
           <paramref name="format" /> is invalid.</exception>
         <remarks>
@@ -2978,6 +3031,10 @@ class test {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance as specified by <paramref name="format" /> and <paramref name="provider" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A numeric format string.</param>
         <param name="provider">
diff --git a/mcs/class/corlib/Documentation/en/System/Enum.xml b/mcs/class/corlib/Documentation/en/System/Enum.xml
index 030c355fbb1..88451c0ca68 100644
--- a/mcs/class/corlib/Documentation/en/System/Enum.xml
+++ b/mcs/class/corlib/Documentation/en/System/Enum.xml
@@ -230,34 +230,6 @@
         <Parameter Name="target" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="target" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> 
-         A negative
-         integer</term>
-              <description>The value of the current instance is less than
-         the value of <paramref name="target" />.</description>
-            </item>
-            <item>
-              <term> Zero</term>
-              <description>The value of the current instance is equal to the
-         value of <paramref name="target" />.</description>
-            </item>
-            <item>
-              <term> Any
-         positive integer</term>
-              <description>The value of the current instance is greater than the
-         value of <paramref name="target" />, or <paramref name="target" /> is
-      <see langword="null" />.</description>
-            </item>
-          </list>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note"> This method is
@@ -271,6 +243,49 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this instance to a specified object and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number that indicates the relative values of this instance and <paramref name="target" />.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Meaning </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>The value of this instance is less than the value of <paramref name="target" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>The value of this instance is equal to the value of <paramref name="target" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>The value of this instance is greater than the value of <paramref name="target" />.</para>
+                <para>-or- </para>
+                <para>
+                  <paramref name="target" /> is null. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare, or null. </param>
       </Docs>
@@ -293,12 +308,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> is of the same
-   enumeration type and represents the same value as the current instance;
-   otherwise, <see langword="false" />.</para>
-        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance, or null. </param>
         <remarks>
@@ -309,6 +318,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is an enumeration value of the same type and with the same underlying value as this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance, or null. </param>
       </Docs>
@@ -338,10 +351,6 @@
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> The <see cref="T:System.String" /> representation of the value of the enumeration
-   element. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="enumType" />, <paramref name="value" /> or <paramref name="format" /> is a null reference. </exception>
         <exception cref="T:System.ArgumentException">
@@ -445,6 +454,10 @@ public class EnumCompTo {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified value of a specified enumerated type to its equivalent string representation according to the specified format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of <paramref name="value" />.</para>
+        </returns>
         <param name="enumType">
           <attribution license="cc4" from="Microsoft" modified="false" />The enumeration type of the value to convert. </param>
         <param name="value">
@@ -469,9 +482,6 @@ public class EnumCompTo {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing a hash code for the current instance.</para>
-        </returns>
         <remarks>
           <para> The algorithm used to
       generate the hash code is unspecified.</para>
@@ -484,6 +494,10 @@ public class EnumCompTo {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for the value of this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -510,11 +524,6 @@ public class EnumCompTo {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.String" /> containing the name of the enumerated constant
-   in <paramref name="enumType" /> whose value is <paramref name="value" />, or a null reference
-   if no such constant is found. If multiple constants have the same value, as to which name is returned for that value, is unspecified.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="enumType" /> or <paramref name="value" /> is a null reference.</exception>
         <exception cref="T:System.ArgumentException">
@@ -555,6 +564,10 @@ public class EnumCompTo {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the name of the constant in the specified enumeration that has the specified value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string containing the name of the enumerated constant in <paramref name="enumType" /> whose value is <paramref name="value" />; or null if no such constant is found.</para>
+        </returns>
         <param name="enumType">
           <attribution license="cc4" from="Microsoft" modified="false" />An enumeration type. </param>
         <param name="value">
@@ -584,11 +597,6 @@ public class EnumCompTo {
         <Parameter Name="enumType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> vector of the names of the constants in
-<paramref name="enumType" />. The elements of the vector
-   are sorted by the values of the enumerated constants.  If multiple constants have the same value, the order in which their names appear in the vector, relative to each other, is unspecified.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="enumType" /> is a null reference. </exception>
         <exception cref="T:System.ArgumentException">
@@ -634,6 +642,10 @@ public class enumGetNames {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of the names of the constants in a specified enumeration.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string array of the names of the constants in <paramref name="enumType" />. </para>
+        </returns>
         <param name="enumType">
           <attribution license="cc4" from="Microsoft" modified="false" />An enumeration type. </param>
       </Docs>
@@ -653,12 +665,15 @@ public class enumGetNames {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the underlying <see cref="T:System.TypeCode" /> for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type for this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetUnderlyingType">
@@ -683,9 +698,6 @@ public class enumGetNames {
         <Parameter Name="enumType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Type" /> instance that describes the underlying type of <paramref name="enumType" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="enumType" /> is a null reference. </exception>
         <exception cref="T:System.ArgumentException">
@@ -721,6 +733,10 @@ public class EnumUnderlyingTypeTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the underlying type of the specified enumeration.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The underlying type of <paramref name="enumType" />.</para>
+        </returns>
         <param name="enumType">
           <attribution license="cc4" from="Microsoft" modified="false" />The enumeration whose underlying type will be retrieved.</param>
       </Docs>
@@ -748,13 +764,6 @@ public class EnumUnderlyingTypeTest {
         <Parameter Name="enumType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A vector of the enumeration type specified by
-   <paramref name="enumType" /> containing the values of the
-      constants in <paramref name="enumType" />. The elements of the array
-      are sorted by the values of the enumeration constants. If multiple constants have the same value, the value of each is included in the array.
-      </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="enumType" /> is a null reference. </exception>
         <exception cref="T:System.ArgumentException">
@@ -800,6 +809,10 @@ public class enumGetValues {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an array of the values of the constants in a specified enumeration.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains the values of the constants in <paramref name="enumType" />. </para>
+        </returns>
         <param name="enumType">
           <attribution license="cc4" from="Microsoft" modified="false" />An enumeration type. </param>
       </Docs>
@@ -819,7 +832,6 @@ public class enumGetValues {
         <Parameter Name="flag" Type="System.Enum" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Enum.HasFlag(System.Enum)" /> method returns the result of the following Boolean expression.</para>
@@ -832,6 +844,10 @@ public class enumGetValues {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether one or more bit fields are set in the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the bit field or bit fields that are set in <paramref name="flag" /> are also set in the current instance; otherwise, false.</para>
+        </returns>
         <param name="flag">
           <attribution license="cc4" from="Microsoft" modified="false" />An enumeration value.</param>
       </Docs>
@@ -859,13 +875,6 @@ public class enumGetValues {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if a constant
-   in the enumeration described by <paramref name="enumType" />
-   has a value equal to <paramref name="value" />; otherwise,
-<see langword="false" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="enumType " />or <paramref name="value" /> is a null reference. </exception>
         <exception cref="T:System.ArgumentException">
@@ -922,6 +931,10 @@ public class enumIsDefined {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an indication whether a constant with a specified value exists in a specified enumeration.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if a constant in <paramref name="enumType" /> has a value equal to <paramref name="value" />; otherwise, false.</para>
+        </returns>
         <param name="enumType">
           <attribution license="cc4" from="Microsoft" modified="false" />An enumeration type. </param>
         <param name="value">
@@ -952,11 +965,6 @@ public class enumIsDefined {
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Object" /> of type
-<paramref name="enumType" /> whose values are
-   represented by <paramref name="value" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="enumType" /> or <paramref name="value" /> is a null reference. </exception>
         <exception cref="T:System.ArgumentException">
@@ -1008,6 +1016,10 @@ public class enumTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of the name or numeric value of one or more enumerated constants to an equivalent enumerated object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object of type <paramref name="enumType" /> whose value is represented by <paramref name="value" />.</para>
+        </returns>
         <param name="enumType">
           <attribution license="cc4" from="Microsoft" modified="false" />An enumeration type. </param>
         <param name="value">
@@ -1039,11 +1051,6 @@ public class enumTest {
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Object" /> of type
-<paramref name="enumType" />
-whose values are represented by <paramref name="value" />. </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="enumType" /> or <paramref name="value" /> is a null reference. </exception>
         <exception cref="T:System.ArgumentException">
@@ -1073,6 +1080,10 @@ whose values are represented by <paramref name="value" />. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of the name or numeric value of one or more enumerated constants to an equivalent enumerated object. A parameter specifies whether the operation is case-insensitive.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object of type <paramref name="enumType" /> whose value is represented by <paramref name="value" />.</para>
+        </returns>
         <param name="enumType">
           <attribution license="cc4" from="Microsoft" modified="false" />An enumeration type. </param>
         <param name="value">
@@ -1098,7 +1109,6 @@ whose values are represented by <paramref name="value" />. </para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Currently not implemented. Always throws an exception.</para>
@@ -1107,6 +1117,10 @@ whose values are represented by <paramref name="value" />. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the current value to a Boolean value based on the underlying type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This member always throws an exception.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information.</param>
       </Docs>
@@ -1127,7 +1141,6 @@ whose values are represented by <paramref name="value" />. </para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uses <see cref="T:System.Convert" /> to perform the conversion.</para>
@@ -1136,6 +1149,10 @@ whose values are represented by <paramref name="value" />. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the current value to an 8-bit unsigned integer based on the underlying type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information.</param>
       </Docs>
@@ -1156,7 +1173,6 @@ whose values are represented by <paramref name="value" />. </para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Currently not implemented. Always throws an exception.</para>
@@ -1165,6 +1181,10 @@ whose values are represented by <paramref name="value" />. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the current value to a Unicode character based on the underlying type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This member always throws an exception.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information.</param>
       </Docs>
@@ -1185,7 +1205,6 @@ whose values are represented by <paramref name="value" />. </para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Currently not implemented. Always throws an exception.</para>
@@ -1194,6 +1213,10 @@ whose values are represented by <paramref name="value" />. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the current value to a <see cref="T:System.DateTime" /> based on the underlying type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This member always throws an exception.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information.</param>
       </Docs>
@@ -1214,7 +1237,6 @@ whose values are represented by <paramref name="value" />. </para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Currently not implemented. Always throws an exception.</para>
@@ -1223,6 +1245,10 @@ whose values are represented by <paramref name="value" />. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the current value to a <see cref="T:System.Decimal" /> based on the underlying type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This member always throws an exception.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information.</param>
       </Docs>
@@ -1243,7 +1269,6 @@ whose values are represented by <paramref name="value" />. </para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Currently not implemented. Always throws an exception.</para>
@@ -1252,6 +1277,10 @@ whose values are represented by <paramref name="value" />. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the current value to a double-precision floating point number based on the underlying type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This member always throws an exception.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information.</param>
       </Docs>
@@ -1272,7 +1301,6 @@ whose values are represented by <paramref name="value" />. </para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uses <see cref="T:System.Convert" /> to perform the conversion.</para>
@@ -1281,6 +1309,10 @@ whose values are represented by <paramref name="value" />. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the current value to a 16-bit signed integer based on the underlying type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information.</param>
       </Docs>
@@ -1301,7 +1333,6 @@ whose values are represented by <paramref name="value" />. </para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uses <see cref="T:System.Convert" /> to perform the conversion.</para>
@@ -1310,6 +1341,10 @@ whose values are represented by <paramref name="value" />. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the current value to a 32-bit signed integer based on the underlying type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information.</param>
       </Docs>
@@ -1330,7 +1365,6 @@ whose values are represented by <paramref name="value" />. </para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uses <see cref="T:System.Convert" /> to perform the conversion.</para>
@@ -1339,6 +1373,10 @@ whose values are represented by <paramref name="value" />. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the current value to a 64-bit signed integer based on the underlying type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information.</param>
       </Docs>
@@ -1359,7 +1397,6 @@ whose values are represented by <paramref name="value" />. </para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uses <see cref="T:System.Convert" /> to perform the conversion.</para>
@@ -1368,6 +1405,10 @@ whose values are represented by <paramref name="value" />. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the current value to an 8-bit signed integer based on the underlying type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information.</param>
       </Docs>
@@ -1388,7 +1429,6 @@ whose values are represented by <paramref name="value" />. </para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Currently not implemented. Always throws an exception.</para>
@@ -1397,6 +1437,10 @@ whose values are represented by <paramref name="value" />. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the current value to a single-precision floating-point number based on the underlying type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This member always throws an exception.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information.</param>
       </Docs>
@@ -1419,7 +1463,6 @@ whose values are represented by <paramref name="value" />. </para>
       </Parameters>
       <Docs>
         <param name="targetType">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uses <see cref="T:System.Convert" /> to perform the conversion.</para>
@@ -1428,6 +1471,10 @@ whose values are represented by <paramref name="value" />. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the current value to a specified type based on the underlying type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information.</param>
       </Docs>
@@ -1448,7 +1495,6 @@ whose values are represented by <paramref name="value" />. </para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uses <see cref="T:System.Convert" /> to perform the conversion.</para>
@@ -1457,6 +1503,10 @@ whose values are represented by <paramref name="value" />. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the current value to a 16-bit unsigned integer based on the underlying type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information.</param>
       </Docs>
@@ -1477,7 +1527,6 @@ whose values are represented by <paramref name="value" />. </para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uses <see cref="T:System.Convert" /> to perform the conversion.</para>
@@ -1486,6 +1535,10 @@ whose values are represented by <paramref name="value" />. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the current value to a 32-bit unsigned integer based on the underlying type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information.</param>
       </Docs>
@@ -1506,7 +1559,6 @@ whose values are represented by <paramref name="value" />. </para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Uses <see cref="T:System.Convert" /> to perform the conversion.</para>
@@ -1515,6 +1567,10 @@ whose values are represented by <paramref name="value" />. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the current value to a 64-bit unsigned integer based on the underlying type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information.</param>
       </Docs>
@@ -1542,10 +1598,6 @@ whose values are represented by <paramref name="value" />. </para>
         <Parameter Name="value" Type="System.Byte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>An enumeration object of type <paramref name="enumType" /> whose 
-   value is <paramref name="value" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="enumType" /> is a null reference. </exception>
         <exception cref="T:System.ArgumentException">
@@ -1563,6 +1615,10 @@ whose values are represented by <paramref name="value" />. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified 8-bit unsigned integer to an enumeration member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the enumeration set to <paramref name="value" />.</para>
+        </returns>
         <param name="enumType">
           <attribution license="cc4" from="Microsoft" modified="false" />The enumeration type to return. </param>
         <param name="value">
@@ -1593,10 +1649,6 @@ whose values are represented by <paramref name="value" />. </para>
         <Parameter Name="value" Type="System.Int16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> An enumeration object of type <paramref name="enumType" /> whose 
-   value is <paramref name="value" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="enumType" /> is a null reference. </exception>
         <exception cref="T:System.ArgumentException">
@@ -1614,6 +1666,10 @@ whose values are represented by <paramref name="value" />. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified 16-bit signed integer to an enumeration member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the enumeration set to <paramref name="value" />.</para>
+        </returns>
         <param name="enumType">
           <attribution license="cc4" from="Microsoft" modified="false" />The enumeration type to return. </param>
         <param name="value">
@@ -1644,9 +1700,6 @@ whose values are represented by <paramref name="value" />. </para>
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>An enumeration object of type <paramref name="enumType" /> whose value is <paramref name="value" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="enumType" /> is a null reference. </exception>
         <exception cref="T:System.ArgumentException">
@@ -1664,6 +1717,10 @@ whose values are represented by <paramref name="value" />. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified 32-bit signed integer to an enumeration member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the enumeration set to <paramref name="value" />.</para>
+        </returns>
         <param name="enumType">
           <attribution license="cc4" from="Microsoft" modified="false" />The enumeration type to return. </param>
         <param name="value">
@@ -1694,10 +1751,6 @@ whose values are represented by <paramref name="value" />. </para>
         <Parameter Name="value" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>An enumeration object of type <paramref name="enumType" /> whose 
-   value is <paramref name="value" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="enumType" /> is a null reference. </exception>
         <exception cref="T:System.ArgumentException">
@@ -1715,6 +1768,10 @@ whose values are represented by <paramref name="value" />. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified 64-bit signed integer to an enumeration member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the enumeration set to <paramref name="value" />.</para>
+        </returns>
         <param name="enumType">
           <attribution license="cc4" from="Microsoft" modified="false" />The enumeration type to return. </param>
         <param name="value">
@@ -1745,11 +1802,6 @@ whose values are represented by <paramref name="value" />. </para>
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> An enumeration object of type <paramref name="enumType" /> whose value is
-<paramref name="value" />.
-   </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="enumType" /> is a null reference. </exception>
         <exception cref="T:System.ArgumentException">
@@ -1767,6 +1819,10 @@ whose values are represented by <paramref name="value" />. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified object with an integer value to an enumeration member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumeration object whose value is <paramref name="value" />.</para>
+        </returns>
         <param name="enumType">
           <attribution license="cc4" from="Microsoft" modified="false" />The enumeration type to return. </param>
         <param name="value">
@@ -1800,9 +1856,6 @@ whose values are represented by <paramref name="value" />. </para>
         <Parameter Name="value" Type="System.SByte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>An enumeration object of type <paramref name="enumType" /> whose value is <paramref name="value" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="enumType" /> is a null reference. </exception>
         <exception cref="T:System.ArgumentException">
@@ -1820,6 +1873,10 @@ whose values are represented by <paramref name="value" />. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified 8-bit signed integer value to an enumeration member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the enumeration set to <paramref name="value" />.</para>
+        </returns>
         <param name="enumType">
           <attribution license="cc4" from="Microsoft" modified="false" />The enumeration type to return. </param>
         <param name="value">
@@ -1853,9 +1910,6 @@ whose values are represented by <paramref name="value" />. </para>
         <Parameter Name="value" Type="System.UInt16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>An enumeration object of type <paramref name="enumType" /> whose value is <paramref name="value" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="enumType" /> is a null reference. </exception>
         <exception cref="T:System.ArgumentException">
@@ -1873,6 +1927,10 @@ whose values are represented by <paramref name="value" />. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified 16-bit unsigned integer value to an enumeration member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the enumeration set to <paramref name="value" />.</para>
+        </returns>
         <param name="enumType">
           <attribution license="cc4" from="Microsoft" modified="false" />The enumeration type to return. </param>
         <param name="value">
@@ -1906,10 +1964,6 @@ whose values are represented by <paramref name="value" />. </para>
         <Parameter Name="value" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>An enumeration object of type <paramref name="enumType" /> whose
-   value is <paramref name="value" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="enumType" /> is a null reference. </exception>
         <exception cref="T:System.ArgumentException">
@@ -1927,6 +1981,10 @@ whose values are represented by <paramref name="value" />. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified 32-bit unsigned integer value to an enumeration member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the enumeration set to <paramref name="value" />.</para>
+        </returns>
         <param name="enumType">
           <attribution license="cc4" from="Microsoft" modified="false" />The enumeration type to return. </param>
         <param name="value">
@@ -1960,10 +2018,6 @@ whose values are represented by <paramref name="value" />. </para>
         <Parameter Name="value" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>An enumeration object of type <paramref name="enumType" /> whose
-   value is <paramref name="value" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="enumType" /> is a null reference. </exception>
         <exception cref="T:System.ArgumentException">
@@ -1981,6 +2035,10 @@ whose values are represented by <paramref name="value" />. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified 64-bit unsigned integer value to an enumeration member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the enumeration set to <paramref name="value" />.</para>
+        </returns>
         <param name="enumType">
           <attribution license="cc4" from="Microsoft" modified="false" />The enumeration type to return. </param>
         <param name="value">
@@ -2003,9 +2061,6 @@ whose values are represented by <paramref name="value" />. </para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.String" /> representation of the named constant specified by the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is formatted with the general format specifier ("G"). That is, if the <see cref="T:System.FlagsAttribute" /> is not applied to this enumerated type and there is a named constant equal to the value of this instance, then the return value is a string containing the name of the constant. If the <see cref="T:System.FlagsAttribute" /> is applied and there is a combination of one or more named constants equal to the value of this instance, then the return value is a string containing a delimiter-separated list of the names of the constants. Otherwise, the return value is the string representation of the numeric value of this instance. For more information about formatting enumeration values, see <format type="text/html"><a href="dd1ff672-1052-42cf-8666-4924fb6cd1a1">Enumeration Format Strings</a></format>. For more information about formatting in general, see <format type="text/html"><a href="0d1364da-5b30-4d42-8e6b-03378343343f">Formatting Types</a></format>.</para>
@@ -2014,6 +2069,10 @@ whose values are represented by <paramref name="value" />. </para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -2039,11 +2098,6 @@ whose values are represented by <paramref name="value" />. </para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>  The <see cref="T:System.String" /> representation of
-   the name of the value of the current instance.
-</para>
-        </returns>
         <remarks>
           <para>This method is equivalent to the version of <see cref="M:System.Enum.ToString(System.String)" />
 that takes no arguments.</para>
@@ -2052,6 +2106,10 @@ that takes no arguments.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method overload is obsolete; use <see cref="M:System.Enum.ToString" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />(obsolete) </param>
       </Docs>
@@ -2074,10 +2132,6 @@ that takes no arguments.</para>
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.String" /> representation of the value of the current
-   instance as specified by <paramref name="format" />.</para>
-        </returns>
         <exception cref="T:System.FormatException">
           <paramref name="format" /> contains an invalid value. </exception>
         <remarks>
@@ -2088,6 +2142,10 @@ that takes no arguments.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to its equivalent string representation using the specified format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance as specified by <paramref name="format" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A format string. </param>
       </Docs>
@@ -2116,9 +2174,6 @@ that takes no arguments.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.String" /> representation of the value of the current instance as specified by <paramref name="format" />.</para>
-        </returns>
         <exception cref="T:System.FormatException">
           <paramref name="format" /> does not contain a valid format specifier.</exception>
         <param name="format">
@@ -2133,6 +2188,10 @@ that takes no arguments.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method overload is obsolete; use <see cref="M:System.Enum.ToString(System.String)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance as specified by <paramref name="format" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A format specification. </param>
         <param name="provider">
diff --git a/mcs/class/corlib/Documentation/en/System/Environment.xml b/mcs/class/corlib/Documentation/en/System/Environment.xml
index 268742f8536..8eb56e0c7dd 100644
--- a/mcs/class/corlib/Documentation/en/System/Environment.xml
+++ b/mcs/class/corlib/Documentation/en/System/Environment.xml
@@ -210,7 +210,6 @@ value returned by a process. The default value is zero.</para>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>COM interop is used to retrieve the environment variables from the operating system. If the environment variables cannot be retrieved due to a COM error, the HRESULT that explains the cause of the failure is used to generate one of several possible exceptions; that is, the exception depends on the HRESULT. For more information about how the HRESULT is processed, see the Remarks section of the <see cref="M:System.Runtime.InteropServices.Marshal.ThrowExceptionForHR(System.Int32)" /> method.</para>
@@ -221,6 +220,10 @@ value returned by a process. The default value is zero.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Replaces the name of each environment variable embedded in the specified string with the string equivalent of the value of the variable, then returns the resulting string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string with each environment variable replaced by its value.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />A string containing the names of zero or more environment variables. Each environment variable is quoted with the percent sign character (%).</param>
       </Docs>
@@ -308,10 +311,6 @@ value returned by a process. The default value is zero.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> Returns a <see cref="T:System.String" /> array. Each <see cref="T:System.String" /> in the array
-   contains a single command line argument.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The first element in the array contains the file name of the executing program. If the file name is not available, the first element is equal to <see cref="F:System.String.Empty" />. The remaining elements contain any additional tokens entered on the command line.</para>
@@ -377,6 +376,10 @@ value returned by a process. The default value is zero.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string array containing the command-line arguments for the current process.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of string where each element contains a command-line argument. The first element is the executable file name, and the following zero or more elements contain the remaining command-line arguments.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -397,10 +400,6 @@ value returned by a process. The default value is zero.</para>
         <Parameter Name="variable" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing the current setting of <paramref name="variable" /> , or 
-<see langword="null" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="variable" /> is a null reference.</exception>
         <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
@@ -414,6 +413,10 @@ value returned by a process. The default value is zero.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the value of an environment variable from the current process.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the environment variable specified by <paramref name="variable" />, or null if the environment variable is not found.</para>
+        </returns>
         <param name="variable">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the environment variable.</param>
       </Docs>
@@ -435,7 +438,6 @@ value returned by a process. The default value is zero.</para>
         <Parameter Name="target" Type="System.EnvironmentVariableTarget" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -447,6 +449,10 @@ value returned by a process. The default value is zero.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the value of an environment variable from the current process or from the Windows operating system registry key for the current user or local machine.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the environment variable specified by the <paramref name="variable" /> and <paramref name="target" /> parameters, or null if the environment variable is not found.</para>
+        </returns>
         <param name="variable">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of an environment variable.</param>
         <param name="target">
@@ -468,13 +474,6 @@ value returned by a process. The default value is zero.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Collections.IDictionary" /> object containing environment variable names
-   and settings, or <see langword="null" />
-   if
-   the system does not
-   support environment variables.</para>
-        </returns>
         <exception cref="T:System.Security.SecurityException">The caller does not have the required permission.</exception>
         <permission cref="T:System.Security.Permissions.EnvironmentPermission">Requires permission to read environment variables. See <see cref="F:System.Security.Permissions.EnvironmentPermissionAccess.Read" />.</permission>
         <example>
@@ -508,6 +507,10 @@ class EnvTest:Object {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves all environment variable names and their values from the current process.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A dictionary that contains all environment variable names and their values; otherwise, an empty dictionary if no environment variables are found.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -526,7 +529,6 @@ class EnvTest:Object {
         <Parameter Name="target" Type="System.EnvironmentVariableTarget" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -537,6 +539,10 @@ class EnvTest:Object {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves all environment variable names and their values from the current process, or from the Windows operating system registry key for the current user or local machine.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A dictionary that contains all environment variable names and their values from the source specified by the <paramref name="target" /> parameter; otherwise, an empty dictionary if no environment variables are found.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />One of the <see cref="T:System.EnvironmentVariableTarget" /> values.</param>
       </Docs>
@@ -599,12 +605,15 @@ class EnvTest:Object {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of string containing the names of the logical drives on the current computer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of strings where each element contains the name of a logical drive. For example, if the computer's hard drive is the first logical drive, the first element returned is "C:\".</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HasShutdownStarted">
diff --git a/mcs/class/corlib/Documentation/en/System/Exception.xml b/mcs/class/corlib/Documentation/en/System/Exception.xml
index da1c961b817..bcb4a8b14ee 100644
--- a/mcs/class/corlib/Documentation/en/System/Exception.xml
+++ b/mcs/class/corlib/Documentation/en/System/Exception.xml
@@ -491,11 +491,6 @@ ArithmeticException Handler: System.DivideByZeroException: Attempted to divide b
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>Returns the first Exception thrown in a chain of
-      Exceptions. If the <see cref="P:System.Exception.InnerException" /> property
-      of the current Exception is <see langword="null" /> , returns the current Exception.</para>
-        </returns>
         <example>
           <para>The following example shows an implementation of the
       <see cref="M:System.Exception.GetBaseException" /> method.</para>
@@ -520,6 +515,10 @@ ArithmeticException Handler: System.DivideByZeroException: Attempted to divide b
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the <see cref="T:System.Exception" /> that is the root cause of one or more subsequent exceptions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The first exception thrown in a chain of exceptions. If the <see cref="P:System.Exception.InnerException" /> property of the current exception is a null reference (Nothing in Visual Basic), this property returns the current exception.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -567,7 +566,6 @@ ArithmeticException Handler: System.DivideByZeroException: Attempted to divide b
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -577,6 +575,10 @@ ArithmeticException Handler: System.DivideByZeroException: Attempted to divide b
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the runtime type of the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object that represents the exact runtime type of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="HelpLink">
@@ -866,10 +868,6 @@ Inner Exception is MyAppException: ExceptExample inner exception
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" />
-representation of the current Exception.</para>
-        </returns>
         <example>
           <para>The following example causes an Exception and displays
       the result of calling <see cref="M:System.Exception.ToString" /> on that Exception.</para>
@@ -907,6 +905,10 @@ Error: System.ArgumentException: Object must be of type String.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a string representation of the current exception.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string representation of the current exception.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System/GC.xml b/mcs/class/corlib/Documentation/en/System/GC.xml
index c379995fbdf..6eb0bacc8bf 100644
--- a/mcs/class/corlib/Documentation/en/System/GC.xml
+++ b/mcs/class/corlib/Documentation/en/System/GC.xml
@@ -287,7 +287,6 @@
         <Parameter Name="generation" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -297,6 +296,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the number of times garbage collection has occurred for the specified generation of objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number of times garbage collection has occurred for the specified generation since the process was started.</para>
+        </returns>
         <param name="generation">
           <attribution license="cc4" from="Microsoft" modified="false" />The generation of objects for which the garbage collection count is to be determined. </param>
       </Docs>
@@ -317,7 +320,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method to determine the age of an object, and then use that information with the <see cref="M:System.GC.Collect(System.Int32)" /> method to force the garbage collector to collect objects in the same generation. For example, use this method when you have a set of objects that are created as a group and that become inaccessible at the same time.</para>
@@ -326,6 +328,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the current generation number of the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current generation number of <paramref name="obj" />.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object that generation information is retrieved for. </param>
       </Docs>
@@ -346,12 +352,15 @@
         <Parameter Name="wo" Type="System.WeakReference" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the current generation number of the target of a specified weak reference.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current generation number of the target of <paramref name="wo" />.</para>
+        </returns>
         <param name="wo">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.WeakReference" /> that refers to the target object whose generation number is to be determined. </param>
       </Docs>
@@ -372,7 +381,6 @@
         <Parameter Name="forceFullCollection" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <paramref name="forceFullCollection" /> parameter is true, this method waits a short interval before returning while the system collects garbage and finalizes objects. The duration of the interval is an internally specified limit determined by the number of garbage collection cycles completed and the change in the amount of memory recovered between cycles. The garbage collector does not guarantee that all inaccessible memory is collected.</para>
@@ -381,6 +389,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the number of bytes currently thought to be allocated. A parameter indicates whether this method can wait a short interval before returning, to allow the system to collect garbage and finalize objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A number that is the best available approximation of the number of bytes currently allocated in managed memory.</para>
+        </returns>
         <param name="forceFullCollection">
           <attribution license="cc4" from="Microsoft" modified="false" />true to indicate that this method can wait for garbage collection to occur before returning; otherwise, false.</param>
       </Docs>
@@ -609,7 +621,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="T:System.GCNotificationStatus" /> enumeration returned by this method to determine the status of the current garbage collection notification that was registered by using the <see cref="M:System.GC.RegisterForFullGCNotification(System.Int32,System.Int32)" /> method. You can also use the <see cref="M:System.GC.WaitForFullGCComplete" /> method to determine whether the full garbage collection has completed.</para>
@@ -621,6 +632,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the status of a registered notification for determining whether a full, blocking garbage collection by the common language runtime is imminent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The status of the registered garbage collection notification.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="WaitForFullGCApproach">
@@ -637,7 +652,6 @@
         <Parameter Name="millisecondsTimeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="T:System.GCNotificationStatus" /> enumeration returned by this method to determine the status of the current garbage collection notification that was registered by using the <see cref="M:System.GC.RegisterForFullGCNotification(System.Int32,System.Int32)" /> method. You can also use the <see cref="M:System.GC.WaitForFullGCComplete" /> method to determine whether the full garbage collection has completed.</para>
@@ -650,6 +664,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns, in a specified time-out period, the status of a registered notification for determining whether a full, blocking garbage collection by the common language runtime is imminent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The status of the registered garbage collection notification.</para>
+        </returns>
         <param name="millisecondsTimeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The length of time to wait before a notification status can be obtained. Specify -1 to wait indefinitely.</param>
       </Docs>
@@ -666,7 +684,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="T:System.GCNotificationStatus" /> enumeration returned by this method to determine the status of the current garbage collection notification that was registered by using the <see cref="M:System.GC.RegisterForFullGCNotification(System.Int32,System.Int32)" /> method. You can also use the <see cref="M:System.GC.WaitForFullGCApproach" /> method to determine whether a full garbage collection is imminent.</para>
@@ -678,6 +695,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the status of a registered notification for determining whether a full, blocking garbage collection by the common language runtime has completed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The status of the registered garbage collection notification.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="WaitForFullGCComplete">
@@ -694,7 +715,6 @@
         <Parameter Name="millisecondsTimeout" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="T:System.GCNotificationStatus" /> enumeration returned by this method to determine the status of the current garbage collection notification that was registered by using the <see cref="M:System.GC.RegisterForFullGCNotification(System.Int32,System.Int32)" /> method. You can also use the <see cref="M:System.GC.WaitForFullGCApproach" /> method to determine whether a full garbage collection is imminent.</para>
@@ -707,6 +727,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns, in a specified time-out period, the status of a registered notification for determining whether a full, blocking garbage collection by common language the runtime has completed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The status of the registered garbage collection notification.</para>
+        </returns>
         <param name="millisecondsTimeout">
           <attribution license="cc4" from="Microsoft" modified="false" />The length of time to wait before a notification status can be obtained. Specify -1 to wait indefinitely.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System/Guid.xml b/mcs/class/corlib/Documentation/en/System/Guid.xml
index 4c2d55a25b4..0f60e60e28b 100644
--- a/mcs/class/corlib/Documentation/en/System/Guid.xml
+++ b/mcs/class/corlib/Documentation/en/System/Guid.xml
@@ -261,7 +261,6 @@
         <Parameter Name="value" Type="System.Guid" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -271,6 +270,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this instance to a specified <see cref="T:System.Guid" /> object and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number indicating the relative values of this instance and <paramref name="value" />.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>A negative integer </para>
+              </term>
+              <description>
+                <para>This instance is less than <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is equal to <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>A positive integer </para>
+              </term>
+              <description>
+                <para>This instance is greater than <paramref name="value" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare to this instance.</param>
       </Docs>
@@ -291,7 +330,6 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Any instance of <see cref="T:System.Guid" />, regardless of its value, is considered greater than null.</para>
@@ -301,6 +339,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this instance to a specified object and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number indicating the relative values of this instance and <paramref name="value" />.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>A negative integer </para>
+              </term>
+              <description>
+                <para>This instance is less than <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is equal to <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>A positive integer </para>
+              </term>
+              <description>
+                <para>This instance is greater than <paramref name="value" />, or <paramref name="value" /> is null. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare, or null. </param>
       </Docs>
@@ -346,7 +424,6 @@
         <Parameter Name="g" Type="System.Guid" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -356,6 +433,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance and a specified <see cref="T:System.Guid" /> object represent the same value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="g" /> is equal to this instance; otherwise, false.</para>
+        </returns>
         <param name="g">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare to this instance.</param>
       </Docs>
@@ -376,12 +457,15 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="o" /> is a <see cref="T:System.Guid" /> that has the same value as this instance; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this instance. </param>
       </Docs>
@@ -400,12 +484,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="NewGuid">
@@ -422,7 +509,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>A new, random Guid.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is a convenient static method that you can call to get a new <see cref="T:System.Guid" />.</para>
@@ -432,6 +518,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Initializes a new instance of the <see cref="T:System.Guid" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new GUID object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="op_Equality">
@@ -451,12 +541,15 @@
         <Parameter Name="b" Type="System.Guid" />
       </Parameters>
       <Docs>
-        <returns>True if the two Guids have the same value.</returns>
         <remarks>None.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the values of two specified <see cref="T:System.Guid" /> objects are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> and <paramref name="b" /> are equal; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare. </param>
         <param name="b">
@@ -480,12 +573,15 @@
         <Parameter Name="b" Type="System.Guid" />
       </Parameters>
       <Docs>
-        <returns>True if the two Guids have different values.</returns>
         <remarks>None.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the values of two specified <see cref="T:System.Guid" /> objects are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="a" /> and <paramref name="b" /> are not equal; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare. </param>
         <param name="b">
@@ -506,7 +602,6 @@
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use <see cref="M:System.Guid.TryParse(System.String,System.Guid@)" /> method to catch any unsuccessful parse operations. </para>
@@ -515,6 +610,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a GUID to the equivalent <see cref="T:System.Guid" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that contains the value that was parsed.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The GUID to convert.</param>
       </Docs>
@@ -534,7 +633,6 @@
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following table shows the accepted format specifiers for the <paramref name="format" /> parameter. "0" represents a digit; hyphens ("-"), braces ("{", "}"), and parentheses ("(", ")") appear as shown.</para>
@@ -600,6 +698,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a GUID to the equivalent <see cref="T:System.Guid" /> structure, provided that the string is in the specified format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A structure that contains the value that was parsed.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />The GUID to convert.</param>
         <param name="format">
@@ -620,7 +722,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>The byte values of the Guid.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>You can use the byte array returned by this method to round-trip a <see cref="T:System.Guid" /> value by calling the <see cref="M:System.Guid.#ctor(System.Byte[])" /> constructor. </para>
@@ -630,6 +731,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a 16-element byte array that contains the value of this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-element byte array.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -646,7 +751,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method provides a default GUID format that is sufficient for typical use; however, other versions of this method that take a <paramref name="format" /> parameter provide a few common format variations.</para>
@@ -655,6 +759,12 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of the value of this instance in registry format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of this <see cref="T:System.Guid" />, formatted by using the "D" format specifier as follows: </para>
+          <para>xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx </para>
+          <para>where the value of the GUID is represented as a series of lowercase hexadecimal digits in groups of 8, 4, 4, 4, and 12 digits and separated by hyphens. An example of a return value is "382c74c3-721d-4f34-80e5-57657b6cbc27". To convert the hexadecimal digits from a through f to uppercase, call the <see cref="M:System.String.ToUpper" />  method on the returned string.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -673,7 +783,6 @@
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>The Guid as a string.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following table shows the accepted format specifiers for the <paramref name="format" /> parameter. "0" represents a digit; hyphens ("-"), braces ("{", "}"), and parentheses ("(", ")") appear as shown.</para>
@@ -740,6 +849,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of the value of this <see cref="T:System.Guid" /> instance, according to the provided format specifier.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of this <see cref="T:System.Guid" />, represented as a series of lowercase hexadecimal digits in the specified format. </para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A single format specifier that indicates how to format the value of this <see cref="T:System.Guid" />. The <paramref name="format" /> parameter can be "N", "D", "B", "P", or "X". If <paramref name="format" /> is null or an empty string (""), "D" is used. </param>
       </Docs>
@@ -761,7 +874,6 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>A representation of the Guid as a string.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="provider" /> parameter is reserved for future use and does not contribute to the execution of this method. You can pass null in the method call.</para>
@@ -830,6 +942,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string representation of the value of this instance of the <see cref="T:System.Guid" /> class, according to the provided format specifier and culture-specific format information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of this <see cref="T:System.Guid" />, represented as a series of lowercase hexadecimal digits in the specified format.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A single format specifier that indicates how to format the value of this <see cref="T:System.Guid" />. The <paramref name="format" /> parameter can be "N", "D", "B", "P", or "X". If <paramref name="format" /> is null or an empty string (""), "D" is used. </param>
         <param name="provider">
diff --git a/mcs/class/corlib/Documentation/en/System/ICloneable.xml b/mcs/class/corlib/Documentation/en/System/ICloneable.xml
index cbf44f53f79..04d6655d68d 100644
--- a/mcs/class/corlib/Documentation/en/System/ICloneable.xml
+++ b/mcs/class/corlib/Documentation/en/System/ICloneable.xml
@@ -43,11 +43,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Object" /> of the same type as the current instance, containing
-   copies of the non-static members of the current instance.
-   </para>
-        </returns>
         <example>
           <para>The following example shows an implementation of <see cref="M:System.ICloneable.Clone" /> that
    uses the <see cref="M:System.Object.MemberwiseClone" />
@@ -92,6 +87,10 @@ public class TestMyClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new object that is a copy of the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new object that is a copy of this instance.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System/IComparable.xml b/mcs/class/corlib/Documentation/en/System/IComparable.xml
index b5e68a5d964..4ecb5e380dd 100644
--- a/mcs/class/corlib/Documentation/en/System/IComparable.xml
+++ b/mcs/class/corlib/Documentation/en/System/IComparable.xml
@@ -83,40 +83,57 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
+        <remarks>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="M:System.IComparable.CompareTo(System.Object)" /> method is implemented by types whose values can be ordered or sorted. It is called automatically by methods of non-generic collection objects, such as <see cref="M:System.Array.Sort(System.Array)" />, to order each member of the array. If a custom class or structure does not implement <see cref="T:System.IComparable" />, its members cannot be ordered and the sort operation can throw an <see cref="T:System.InvalidOperationException" />. </para>
+          <para>This method is only a definition and must be implemented by a specific class or value type to have effect. The meaning of the comparisons specified in the Return Value section ("precedes", "occurs in the same position as", and "follows") depends on the particular implementation.</para>
+          <para>By definition, any object compares greater than (or follows) null, and two null references compare equal to each other.</para>
+          <para>The parameter, <paramref name="obj" />, must be the same type as the class or value type that implements this interface; otherwise, an <see cref="T:System.ArgumentException" /> is thrown.</para>
+        </remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Compares the current instance with another object of the same type and returns an integer that indicates whether the current instance precedes, follows, or occurs in the same position in the sort order as the other object.</para>
+        </summary>
         <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="obj" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A value that indicates the relative order of the objects being compared. The return value has these meanings: </para>
           <list type="table">
             <listheader>
-              <term>Returned Value </term>
-              <description>Description </description>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Meaning </para>
+                </description>
+              </item>
             </listheader>
             <item>
-              <term> A negative value </term>
-              <description> The current instance is &lt; <paramref name="obj" />. </description>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance precedes <paramref name="obj" /> in the sort order. </para>
+              </description>
             </item>
             <item>
-              <term> Zero </term>
-              <description>The current instance is ==
-   <paramref name="obj" />. </description>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance occurs in the same position in the sort order as <paramref name="obj" />. </para>
+              </description>
             </item>
             <item>
-              <term> A positive value </term>
-              <description> The current instance is &gt; than <paramref name="obj" /> or <paramref name="obj" /> is a null
-   reference. </description>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance follows <paramref name="obj" /> in the sort order. </para>
+              </description>
             </item>
           </list>
         </returns>
-        <remarks>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>The <see cref="M:System.IComparable.CompareTo(System.Object)" /> method is implemented by types whose values can be ordered or sorted. It is called automatically by methods of non-generic collection objects, such as <see cref="M:System.Array.Sort(System.Array)" />, to order each member of the array. If a custom class or structure does not implement <see cref="T:System.IComparable" />, its members cannot be ordered and the sort operation can throw an <see cref="T:System.InvalidOperationException" />. </para>
-          <para>This method is only a definition and must be implemented by a specific class or value type to have effect. The meaning of the comparisons specified in the Return Value section ("precedes", "occurs in the same position as", and "follows") depends on the particular implementation.</para>
-          <para>By definition, any object compares greater than (or follows) null, and two null references compare equal to each other.</para>
-          <para>The parameter, <paramref name="obj" />, must be the same type as the class or value type that implements this interface; otherwise, an <see cref="T:System.ArgumentException" /> is thrown.</para>
-        </remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Compares the current instance with another object of the same type and returns an integer that indicates whether the current instance precedes, follows, or occurs in the same position in the sort order as the other object.</para>
-        </summary>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System/IConvertible.xml b/mcs/class/corlib/Documentation/en/System/IConvertible.xml
index 04b2ccfc329..3ea25c6d293 100644
--- a/mcs/class/corlib/Documentation/en/System/IConvertible.xml
+++ b/mcs/class/corlib/Documentation/en/System/IConvertible.xml
@@ -47,12 +47,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'TypeCode'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.TypeCode" /> for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The enumerated constant that is the <see cref="T:System.TypeCode" /> of the class or value type that implements this interface.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToBoolean">
@@ -71,12 +74,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to an equivalent Boolean value using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Boolean value equivalent to the value of this instance.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> interface implementation that supplies culture-specific formatting information. </param>
       </Docs>
@@ -97,12 +103,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'byte'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to an equivalent 8-bit unsigned integer using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit unsigned integer equivalent to the value of this instance.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> interface implementation that supplies culture-specific formatting information. </param>
       </Docs>
@@ -123,12 +132,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'char'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to an equivalent Unicode character using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Unicode character equivalent to the value of this instance.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> interface implementation that supplies culture-specific formatting information. </param>
       </Docs>
@@ -149,12 +161,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DateTime'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to an equivalent <see cref="T:System.DateTime" /> using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DateTime" /> instance equivalent to the value of this instance.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> interface implementation that supplies culture-specific formatting information. </param>
       </Docs>
@@ -175,12 +190,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'decimal'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to an equivalent <see cref="T:System.Decimal" /> number using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Decimal" /> number equivalent to the value of this instance.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> interface implementation that supplies culture-specific formatting information. </param>
       </Docs>
@@ -201,12 +219,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'double'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to an equivalent double-precision floating-point number using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A double-precision floating-point number equivalent to the value of this instance.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> interface implementation that supplies culture-specific formatting information. </param>
       </Docs>
@@ -227,12 +248,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'short'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to an equivalent 16-bit signed integer using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 16-bit signed integer equivalent to the value of this instance.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> interface implementation that supplies culture-specific formatting information. </param>
       </Docs>
@@ -253,12 +277,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to an equivalent 32-bit signed integer using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 32-bit signed integer equivalent to the value of this instance.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> interface implementation that supplies culture-specific formatting information. </param>
       </Docs>
@@ -279,12 +306,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'long'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to an equivalent 64-bit signed integer using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 64-bit signed integer equivalent to the value of this instance.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> interface implementation that supplies culture-specific formatting information. </param>
       </Docs>
@@ -305,12 +335,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'sbyte'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to an equivalent 8-bit signed integer using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit signed integer equivalent to the value of this instance.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> interface implementation that supplies culture-specific formatting information. </param>
       </Docs>
@@ -331,12 +364,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'float'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to an equivalent single-precision floating-point number using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A single-precision floating-point number equivalent to the value of this instance.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> interface implementation that supplies culture-specific formatting information. </param>
       </Docs>
@@ -357,12 +393,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to an equivalent <see cref="T:System.String" /> using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> instance equivalent to the value of this instance.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> interface implementation that supplies culture-specific formatting information. </param>
       </Docs>
@@ -384,12 +423,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to an <see cref="T:System.Object" /> of the specified <see cref="T:System.Type" /> that has an equivalent value, using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> instance of type <paramref name="conversionType" /> whose value is equivalent to the value of this instance.</para>
+        </returns>
         <param name="conversionType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> to which the value of this instance is converted. </param>
         <param name="provider">
@@ -412,12 +454,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ushort'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to an equivalent 16-bit unsigned integer using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 16-bit unsigned integer equivalent to the value of this instance.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> interface implementation that supplies culture-specific formatting information. </param>
       </Docs>
@@ -438,12 +483,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'uint'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to an equivalent 32-bit unsigned integer using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 32-bit unsigned integer equivalent to the value of this instance.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> interface implementation that supplies culture-specific formatting information. </param>
       </Docs>
@@ -464,12 +512,15 @@
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'ulong'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to an equivalent 64-bit unsigned integer using the specified culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 64-bit unsigned integer equivalent to the value of this instance.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> interface implementation that supplies culture-specific formatting information. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System/ICustomFormatter.xml b/mcs/class/corlib/Documentation/en/System/ICustomFormatter.xml
index 45169244999..7745f6ed9bf 100644
--- a/mcs/class/corlib/Documentation/en/System/ICustomFormatter.xml
+++ b/mcs/class/corlib/Documentation/en/System/ICustomFormatter.xml
@@ -59,7 +59,6 @@
         <Parameter Name="formatProvider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -75,6 +74,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of a specified object to an equivalent string representation using specified format and culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of <paramref name="arg" />, formatted as specified by <paramref name="format" /> and <paramref name="formatProvider" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A format string containing formatting specifications. </param>
         <param name="arg">
diff --git a/mcs/class/corlib/Documentation/en/System/IFormatProvider.xml b/mcs/class/corlib/Documentation/en/System/IFormatProvider.xml
index 88db38be569..ce850f62338 100644
--- a/mcs/class/corlib/Documentation/en/System/IFormatProvider.xml
+++ b/mcs/class/corlib/Documentation/en/System/IFormatProvider.xml
@@ -61,9 +61,6 @@
         <Parameter Name="formatType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The current instance, if <paramref name="formatType" /> is the same type as the current instance; otherwise, a <see langword="null" /> reference.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>
@@ -75,6 +72,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an object that provides formatting services for the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An instance of the object specified by <paramref name="formatType" />, if the <see cref="T:System.IFormatProvider" /> implementation can supply that type of object; otherwise, null.</para>
+        </returns>
         <param name="formatType">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that specifies the type of format object to return. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System/IFormattable.xml b/mcs/class/corlib/Documentation/en/System/IFormattable.xml
index 0c52f8ea7a7..23fbd383cfb 100644
--- a/mcs/class/corlib/Documentation/en/System/IFormattable.xml
+++ b/mcs/class/corlib/Documentation/en/System/IFormattable.xml
@@ -77,10 +77,6 @@
         <Parameter Name="formatProvider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing the value of the current instance formatted
-   in accordance with <paramref name="format" /> and <paramref name="formatProvider" /> .</para>
-        </returns>
         <exception cref="T:System.FormatException">The specified <paramref name="format" /> is invalid or cannot be used with the type of the current instance.</exception>
         <example>
           <para>The following example demonstrates using the <see cref="M:System.IFormattable.ToString(System.String,System.IFormatProvider)" />
@@ -160,6 +156,10 @@ class FormattableExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Formats the value of the current instance using the specified format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance in the specified format.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />The format to use.</param>
         <param name="formatProvider">
diff --git a/mcs/class/corlib/Documentation/en/System/IServiceProvider.xml b/mcs/class/corlib/Documentation/en/System/IServiceProvider.xml
index bae6063881e..7ebcfd1f11b 100644
--- a/mcs/class/corlib/Documentation/en/System/IServiceProvider.xml
+++ b/mcs/class/corlib/Documentation/en/System/IServiceProvider.xml
@@ -40,12 +40,17 @@
         <Parameter Name="serviceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the service object of the specified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A service object of type <paramref name="serviceType" />.</para>
+          <para>-or- </para>
+          <para>null if there is no service object of type <paramref name="serviceType" />.</para>
+        </returns>
         <param name="serviceType">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that specifies the type of service object to get. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System/Int16.xml b/mcs/class/corlib/Documentation/en/System/Int16.xml
index 7435e149b5d..ec115abc5db 100644
--- a/mcs/class/corlib/Documentation/en/System/Int16.xml
+++ b/mcs/class/corlib/Documentation/en/System/Int16.xml
@@ -66,27 +66,6 @@
         <Parameter Name="value" Type="System.Int16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="value" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> A negative number</term>
-              <description>Current instance &lt; <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> Zero</term>
-              <description>Current instance == <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> A positive number</term>
-              <description>Current instance &gt; <paramref name="value" />.</description>
-            </item>
-          </list>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -99,6 +78,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this instance to a specified 16-bit signed integer and returns an integer that indicates whether the value of this instance is less than, equal to, or greater than the value of the specified 16-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number indicating the relative values of this instance and <paramref name="value" />.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is equal to <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than <paramref name="value" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer to compare. </param>
       </Docs>
@@ -120,39 +139,60 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="value" /> is not a <see cref="T:System.Int16" /> and is not a null reference.</exception>
+        <remarks>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Int16" />, regardless of its value, is considered greater than a null reference.</para>
+          <para>The <paramref name="value" /> parameter must be null or an instance of <see cref="T:System.Int16" />; otherwise, an exception is thrown.</para>
+        </remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Compares this instance to a specified object and returns an integer that indicates whether the value of this instance is less than, equal to, or greater than the value of the object.</para>
+        </summary>
         <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="value" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number indicating the relative values of this instance and <paramref name="value" />.</para>
           <list type="table">
             <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
             </listheader>
             <item>
-              <term> A negative number</term>
-              <description>Current instance &lt; <paramref name="value" />.</description>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than <paramref name="value" />. </para>
+              </description>
             </item>
             <item>
-              <term> Zero</term>
-              <description>Current instance == <paramref name="value" />.</description>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is equal to <paramref name="value" />. </para>
+              </description>
             </item>
             <item>
-              <term> A positive number</term>
-              <description>Current instance &gt; <paramref name="value" />, or
-<paramref name="value" /> is a null reference.</description>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than <paramref name="value" />.</para>
+                <para>-or- </para>
+                <para>
+                  <paramref name="value" /> is null. </para>
+              </description>
             </item>
           </list>
         </returns>
-        <exception cref="T:System.ArgumentException">
-          <paramref name="value" /> is not a <see cref="T:System.Int16" /> and is not a null reference.</exception>
-        <remarks>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>An <see cref="T:System.Int16" />, regardless of its value, is considered greater than a null reference.</para>
-          <para>The <paramref name="value" /> parameter must be null or an instance of <see cref="T:System.Int16" />; otherwise, an exception is thrown.</para>
-        </remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Compares this instance to a specified object and returns an integer that indicates whether the value of this instance is less than, equal to, or greater than the value of the object.</para>
-        </summary>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare, or null. </param>
       </Docs>
@@ -173,10 +213,6 @@
         <Parameter Name="obj" Type="System.Int16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> represents the same value as the current instance; otherwise, <see langword="false" />.</para>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -186,6 +222,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified <see cref="T:System.Int16" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> has the same value as this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Int16" /> value to compare to this instance.</param>
       </Docs>
@@ -207,12 +247,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> represents the
-   same type and value as the current instance. If <paramref name="obj" /> is a null reference
-   or is not an instance of <see cref="T:System.Int16" />, returns <see langword="false" />.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note">This method
@@ -223,6 +257,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is an instance of <see cref="T:System.Int16" /> and equals the value of this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare to this instance. </param>
       </Docs>
@@ -243,9 +281,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the hash code for the current instance.</para>
-        </returns>
         <remarks>
           <para>The algorithm used to
       generate the hash code is unspecified. </para>
@@ -258,6 +293,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -275,12 +314,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.TypeCode" /> for value type <see cref="T:System.Int16" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The enumerated constant, <see cref="F:System.TypeCode.Int16" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MaxValue">
@@ -356,9 +398,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Int16" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -429,6 +468,10 @@ public class Int16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number to its 16-bit signed integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit signed integer equivalent to the number contained in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string containing a number to convert. </param>
       </Docs>
@@ -452,9 +495,6 @@ public class Int16ParseClass {
         <Parameter Name="style" Type="System.Globalization.NumberStyles" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Int16" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference. </exception>
         <exception cref="T:System.FormatException">
@@ -676,6 +716,10 @@ public class Int16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified style to its 16-bit signed integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit signed integer equivalent to the number specified in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string containing a number to convert. </param>
         <param name="style">
@@ -701,9 +745,6 @@ public class Int16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Int16" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -760,6 +801,10 @@ public class Int16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified culture-specific format to its 16-bit signed integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit signed integer equivalent to the number specified in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string containing a number to convert. </param>
         <param name="provider">
@@ -786,9 +831,6 @@ public class Int16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Int16" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -1010,6 +1052,10 @@ public class Int16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified style and culture-specific format to its 16-bit signed integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit signed integer equivalent to the number specified in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string containing a number to convert. </param>
         <param name="style">
@@ -1035,7 +1081,6 @@ public class Int16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int16" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToBoolean(System.Int16)" /> method.</para>
@@ -1044,6 +1089,10 @@ public class Int16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToBoolean(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of the current instance is not zero; otherwise, false.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1064,7 +1113,6 @@ public class Int16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int16" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToByte(System.Int16)" /> method</para>
@@ -1073,6 +1121,10 @@ public class Int16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToByte(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Byte" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1093,7 +1145,6 @@ public class Int16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int16" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToChar(System.Int16)" /> method.</para>
@@ -1102,6 +1153,10 @@ public class Int16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToChar(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Char" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1122,12 +1177,15 @@ public class Int16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to use this method throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1148,7 +1206,6 @@ public class Int16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int16" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToDecimal(System.Int16)" /> method.</para>
@@ -1157,6 +1214,10 @@ public class Int16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToDecimal(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Decimal" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1177,7 +1238,6 @@ public class Int16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int16" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToDouble(System.Int16)" /> method.</para>
@@ -1186,6 +1246,10 @@ public class Int16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToDouble(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Double" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1206,7 +1270,6 @@ public class Int16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int16" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. </para>
@@ -1215,6 +1278,10 @@ public class Int16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt16(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, unchanged.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1235,7 +1302,6 @@ public class Int16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int16" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt32(System.Int16)" /> method.</para>
@@ -1244,6 +1310,10 @@ public class Int16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt32(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.Int32" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1264,7 +1334,6 @@ public class Int16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int16" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt64(System.Int16)" /> method.</para>
@@ -1273,6 +1342,10 @@ public class Int16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt64(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.Int64" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1293,7 +1366,6 @@ public class Int16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int16" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToSByte(System.Int16)" /> method.</para>
@@ -1302,6 +1374,10 @@ public class Int16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToSByte(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.SByte" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1322,7 +1398,6 @@ public class Int16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int16" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToSingle(System.Int16)" /> method.</para>
@@ -1331,6 +1406,10 @@ public class Int16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToSingle(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Single" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1353,7 +1432,6 @@ public class Int16ParseClass {
       </Parameters>
       <Docs>
         <param name="targetType">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int16" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the static (Shared in Visual Basic) <see cref="M:System.Convert.ChangeType(System.Object,System.Type,System.IFormatProvider)" /> method.</para>
@@ -1362,6 +1440,10 @@ public class Int16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToType(System.Type,System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to <paramref name="type" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> implementation that supplies information about the format of the returned value.</param>
       </Docs>
@@ -1382,7 +1464,6 @@ public class Int16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int16" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt16(System.Int16)" /> method.</para>
@@ -1391,6 +1472,10 @@ public class Int16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt16(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, unchanged.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1411,7 +1496,6 @@ public class Int16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int16" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt32(System.Int16)" /> method.</para>
@@ -1420,6 +1504,10 @@ public class Int16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt32(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.UInt32" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1440,7 +1528,6 @@ public class Int16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int16" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt64(System.Int16)" /> method.</para>
@@ -1449,6 +1536,10 @@ public class Int16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt64(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.UInt64" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1468,11 +1559,6 @@ public class Int16ParseClass {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted using
-   the general format specifier ("G"). The string takes into account the current
-   system culture.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Int16.ToString" /> method formats an <see cref="T:System.Int16" /> value in the default ("G", or general) format by using the <see cref="T:System.Globalization.NumberFormatInfo" /> object of the current culture. If you want to specify a different format or culture, use the other overloads of the <see cref="M:System.Int16.ToString(System.String)" /> method, as follows: </para>
@@ -1545,6 +1631,10 @@ public class Int16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance, consisting of a minus sign if the value is negative, and a sequence of digits ranging from 0 to 9 with no leading zeroes.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1565,12 +1655,6 @@ public class Int16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted using
-   the general format specifier, ("G"). The string takes into account the
-   formatting information in the <see cref="T:System.Globalization.NumberFormatInfo" /> instance supplied by
-<paramref name="provider" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Int16.ToString(System.IFormatProvider)" /> method formats an <see cref="T:System.Int16" /> value in the default ("G", or general) format by using the <see cref="T:System.Globalization.NumberFormatInfo" /> object of a specified culture. If you want to specify a different format or the current culture, use the other overloads of the <see cref="M:System.Int16.ToString(System.String)" /> method, as follows:</para>
@@ -1643,6 +1727,10 @@ public class Int16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance as specified by <paramref name="provider" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> that supplies culture-specific formatting information. </param>
       </Docs>
@@ -1665,10 +1753,6 @@ public class Int16ParseClass {
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted as
-   specified by <paramref name="format" />. The string takes into account the current system culture.</para>
-        </returns>
         <exception cref="T:System.FormatException">
           <paramref name="format" /> is invalid.</exception>
         <example>
@@ -1770,6 +1854,10 @@ public class Int16ToStringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation, using the specified format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance as specified by <paramref name="format" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A numeric format string.</param>
       </Docs>
@@ -1793,11 +1881,6 @@ public class Int16ToStringExample {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted as
-   specified by <paramref name="format" />. The string takes into account the formatting
-   information in the <see cref="T:System.Globalization.NumberFormatInfo" /> instance supplied by <paramref name="provider" />.</para>
-        </returns>
         <exception cref="T:System.FormatException">
           <paramref name="format" /> is invalid.</exception>
         <param name="format">
@@ -1887,6 +1970,10 @@ public class Int16ToStringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance as specified by <paramref name="format" /> and <paramref name="provider" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A numeric format string.</param>
         <param name="provider">
diff --git a/mcs/class/corlib/Documentation/en/System/Int32.xml b/mcs/class/corlib/Documentation/en/System/Int32.xml
index 4f6f9e07118..582c8b94fc9 100644
--- a/mcs/class/corlib/Documentation/en/System/Int32.xml
+++ b/mcs/class/corlib/Documentation/en/System/Int32.xml
@@ -108,27 +108,6 @@
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="value" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> A negative number</term>
-              <description>Current instance &lt; <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> Zero</term>
-              <description>Current instance == <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> A positive number</term>
-              <description>Current instance &gt; <paramref name="value" />.</description>
-            </item>
-          </list>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -141,6 +120,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this instance to a specified 32-bit signed integer and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number indicating the relative values of this instance and <paramref name="value" />.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is equal to <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than <paramref name="value" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer to compare. </param>
       </Docs>
@@ -162,42 +181,61 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="value" /> is not a <see cref="T:System.Int32" /> and is not a null reference.</exception>
+        <remarks>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Any instance of <see cref="T:System.Int32" />, regardless of its value, is considered greater than null.</para>
+          <para>
+            <paramref name="value" /> must be null or an instance of <see cref="T:System.Int32" />; otherwise, an exception is thrown.</para>
+        </remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Compares this instance to a specified object and returns an indication of their relative values.</para>
+        </summary>
         <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="value" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number indicating the relative values of this instance and <paramref name="value" />.</para>
           <list type="table">
             <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
             </listheader>
             <item>
-              <term> A negative number</term>
-              <description>Current instance &lt; <paramref name="value" />.</description>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than <paramref name="value" />. </para>
+              </description>
             </item>
             <item>
-              <term> Zero</term>
-              <description>Current instance == <paramref name="value" />.</description>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is equal to <paramref name="value" />. </para>
+              </description>
             </item>
             <item>
-              <term> A positive number</term>
+              <term>
+                <para>Greater than zero </para>
+              </term>
               <description>
-                <para>Current instance &gt; <paramref name="value" />, or
-<paramref name="value" /> is a null reference.</para>
+                <para>This instance is greater than <paramref name="value" />.</para>
+                <para>-or- </para>
+                <para>
+                  <paramref name="value" /> is null. </para>
               </description>
             </item>
           </list>
         </returns>
-        <exception cref="T:System.ArgumentException">
-          <paramref name="value" /> is not a <see cref="T:System.Int32" /> and is not a null reference.</exception>
-        <remarks>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Any instance of <see cref="T:System.Int32" />, regardless of its value, is considered greater than null.</para>
-          <para>
-            <paramref name="value" /> must be null or an instance of <see cref="T:System.Int32" />; otherwise, an exception is thrown.</para>
-        </remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Compares this instance to a specified object and returns an indication of their relative values.</para>
-        </summary>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare, or null. </param>
       </Docs>
@@ -218,10 +256,6 @@
         <Parameter Name="obj" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> represents the same and value as the current instance; otherwise,  <see langword="false" />.</para>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -231,6 +265,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified <see cref="T:System.Int32" /> value. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> has the same value as this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Int32" /> value to compare to this instance.</param>
       </Docs>
@@ -252,12 +290,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> represents the same
-   type and value as the current instance. If <paramref name="obj" /> is a null reference or
-   is not an instance of <see cref="T:System.Int32" />, returns <see langword="false" />.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note">This method
@@ -268,6 +300,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is an instance of <see cref="T:System.Int32" /> and equals the value of this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance. </param>
       </Docs>
@@ -288,9 +324,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the hash code for the current instance.</para>
-        </returns>
         <remarks>
           <para> The algorithm used to
       generate the hash code is unspecified. </para>
@@ -303,6 +336,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -320,12 +357,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.TypeCode" /> for value type <see cref="T:System.Int32" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The enumerated constant, <see cref="F:System.TypeCode.Int32" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MaxValue">
@@ -399,9 +439,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Int32" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -472,6 +509,10 @@ public class Int32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number to its 32-bit signed integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer equivalent to the number contained in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string containing a number to convert. </param>
       </Docs>
@@ -495,9 +536,6 @@ public class Int32ParseClass {
         <Parameter Name="style" Type="System.Globalization.NumberStyles" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Int32" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -749,6 +787,10 @@ public class Int32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified style to its 32-bit signed integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer equivalent to the number specified in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string containing a number to convert. </param>
         <param name="style">
@@ -774,9 +816,6 @@ public class Int32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Int32" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -832,6 +871,10 @@ public class Int32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified culture-specific format to its 32-bit signed integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer equivalent to the number specified in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string containing a number to convert. </param>
         <param name="provider">
@@ -858,9 +901,6 @@ public class Int32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Int32" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -1077,6 +1117,10 @@ public class Int32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified style and culture-specific format to its 32-bit signed integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer equivalent to the number specified in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string containing a number to convert. </param>
         <param name="style">
@@ -1102,7 +1146,6 @@ public class Int32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int32" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToBoolean(System.Int32)" /> method.</para>
@@ -1111,6 +1154,10 @@ public class Int32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToBoolean(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of the current instance is not zero; otherwise, false.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1131,7 +1178,6 @@ public class Int32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int32" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToByte(System.Int32)" /> method.</para>
@@ -1140,6 +1186,10 @@ public class Int32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToByte(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Byte" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1160,7 +1210,6 @@ public class Int32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int32" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToChar(System.Int32)" /> method.</para>
@@ -1169,6 +1218,10 @@ public class Int32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToChar(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Char" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1189,12 +1242,15 @@ public class Int32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to use this method throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1215,7 +1271,6 @@ public class Int32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int32" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToDecimal(System.Int32)" /> method.</para>
@@ -1224,6 +1279,10 @@ public class Int32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToDecimal(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Decimal" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1244,7 +1303,6 @@ public class Int32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int32" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToDouble(System.Int32)" /> method.</para>
@@ -1253,6 +1311,10 @@ public class Int32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToDouble(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Double" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1273,7 +1335,6 @@ public class Int32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int32" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt16(System.Int32)" /> method.</para>
@@ -1282,6 +1343,10 @@ public class Int32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt16(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.Int16" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1302,7 +1367,6 @@ public class Int32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int32" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. </para>
@@ -1311,6 +1375,10 @@ public class Int32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt32(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, unchanged.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1331,7 +1399,6 @@ public class Int32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int32" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt64(System.Int32)" /> method.</para>
@@ -1340,6 +1407,10 @@ public class Int32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt64(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.Int64" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1360,7 +1431,6 @@ public class Int32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int32" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToSByte(System.Int32)" /> method.</para>
@@ -1369,6 +1439,10 @@ public class Int32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToSByte(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.SByte" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1389,7 +1463,6 @@ public class Int32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int32" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToSingle(System.Int32)" /> method.</para>
@@ -1398,6 +1471,10 @@ public class Int32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToSingle(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Single" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1420,7 +1497,6 @@ public class Int32ParseClass {
       </Parameters>
       <Docs>
         <param name="targetType">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int32" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the static (Shared in Visual Basic) <see cref="M:System.Convert.ChangeType(System.Object,System.Type,System.IFormatProvider)" /> method instead.</para>
@@ -1429,6 +1505,10 @@ public class Int32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToType(System.Type,System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to <paramref name="type" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that provides information about the format of the returned value.</param>
       </Docs>
@@ -1449,7 +1529,6 @@ public class Int32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int32" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt16(System.Int32)" /> method.</para>
@@ -1458,6 +1537,10 @@ public class Int32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt16(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.UInt16" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1478,7 +1561,6 @@ public class Int32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int32" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt32(System.Int32)" /> method.</para>
@@ -1487,6 +1569,10 @@ public class Int32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt32(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.UInt32" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1507,7 +1593,6 @@ public class Int32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int32" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt64(System.Int32)" /> method.</para>
@@ -1516,6 +1601,10 @@ public class Int32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt64(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.UInt64" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1535,11 +1624,6 @@ public class Int32ParseClass {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted using
-   the general format specifier ("G"). The string takes into account the current
-   system culture.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Int32.ToString" /> method formats an <see cref="T:System.Int32" /> value in the default ("G", or general) format by using the <see cref="T:System.Globalization.NumberFormatInfo" /> object of the current culture. If you want to specify a different format or culture, use the other overloads of the <see cref="M:System.Int32.ToString(System.String)" /> method, as follows: </para>
@@ -1612,6 +1696,10 @@ public class Int32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance, consisting of a negative sign if the value is negative, and a sequence of digits ranging from 0 to 9 with no leading zeroes.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1632,12 +1720,6 @@ public class Int32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted using
-   the general format specifier, ("G"). The string takes into account the
-   formatting information in the <see cref="T:System.Globalization.NumberFormatInfo" /> instance supplied by
-<paramref name="provider" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Int32.ToString(System.IFormatProvider)" /> method formats an <see cref="T:System.Int32" /> value in the default ("G", or general) format by using the <see cref="T:System.Globalization.NumberFormatInfo" /> object of a specified culture. If you want to specify a different format or the current culture, use the other overloads of the <see cref="M:System.Int32.ToString(System.String)" /> method, as follows:</para>
@@ -1723,6 +1805,10 @@ public class Int32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance as specified by <paramref name="provider" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information. </param>
       </Docs>
@@ -1745,11 +1831,6 @@ public class Int32ParseClass {
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted as
-   specified by <paramref name="format" />. The string takes into account the current system
-   culture.</para>
-        </returns>
         <exception cref="T:System.FormatException">
           <paramref name="format" /> is invalid.</exception>
         <example>
@@ -1852,6 +1933,10 @@ public class Int32ToStringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation, using the specified format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance as specified by <paramref name="format" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A standard or custom numeric format string.</param>
       </Docs>
@@ -1875,12 +1960,6 @@ public class Int32ToStringExample {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted as
-   specified by <paramref name="format" />. The string takes into account the formatting
-   information in the <see cref="T:System.Globalization.NumberFormatInfo" /> instance supplied by <paramref name="provider" />.
-   </para>
-        </returns>
         <exception cref="T:System.FormatException">
           <paramref name="format" /> is invalid.</exception>
         <remarks>
@@ -1969,6 +2048,10 @@ public class Int32ToStringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance as specified by <paramref name="format" /> and <paramref name="provider" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A standard or custom numeric format string.</param>
         <param name="provider">
diff --git a/mcs/class/corlib/Documentation/en/System/Int64.xml b/mcs/class/corlib/Documentation/en/System/Int64.xml
index 5b299de2f3d..2f803c4b431 100644
--- a/mcs/class/corlib/Documentation/en/System/Int64.xml
+++ b/mcs/class/corlib/Documentation/en/System/Int64.xml
@@ -66,27 +66,6 @@
         <Parameter Name="value" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="value" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> A negative number</term>
-              <description>Current instance &lt; <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> Zero</term>
-              <description>Current instance == <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> A positive number</term>
-              <description>Current instance &gt; <paramref name="value" />.</description>
-            </item>
-          </list>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -99,6 +78,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this instance to a specified 64-bit signed integer and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number indicating the relative values of this instance and <paramref name="value" />.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is equal to <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than <paramref name="value" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An integer to compare. </param>
       </Docs>
@@ -120,41 +139,60 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="value" /> is not a <see cref="T:System.Int64" /> and is not a null reference.</exception>
+        <remarks>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Int64" />, regardless of its value, is considered greater than a null reference.</para>
+          <para>The <paramref name="value" /> parameter must be null or an instance of <see cref="T:System.Int64" />; otherwise, an exception is thrown.</para>
+        </remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Compares this instance to a specified object and returns an indication of their relative values.</para>
+        </summary>
         <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="value" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number indicating the relative values of this instance and <paramref name="value" />.</para>
           <list type="table">
             <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
             </listheader>
             <item>
-              <term> A negative number</term>
-              <description>Current instance &lt; <paramref name="value" />.</description>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than <paramref name="value" />. </para>
+              </description>
             </item>
             <item>
-              <term> Zero</term>
-              <description>Current instance == <paramref name="value" />.</description>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is equal to <paramref name="value" />. </para>
+              </description>
             </item>
             <item>
-              <term> A positive number</term>
+              <term>
+                <para>Greater than zero </para>
+              </term>
               <description>
-                <para>Current instance &gt; <paramref name="value" />, or
-<paramref name="value" /> is a null reference.</para>
+                <para>This instance is greater than <paramref name="value" />.</para>
+                <para>-or- </para>
+                <para>
+                  <paramref name="value" /> is null. </para>
               </description>
             </item>
           </list>
         </returns>
-        <exception cref="T:System.ArgumentException">
-          <paramref name="value" /> is not a <see cref="T:System.Int64" /> and is not a null reference.</exception>
-        <remarks>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>An <see cref="T:System.Int64" />, regardless of its value, is considered greater than a null reference.</para>
-          <para>The <paramref name="value" /> parameter must be null or an instance of <see cref="T:System.Int64" />; otherwise, an exception is thrown.</para>
-        </remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Compares this instance to a specified object and returns an indication of their relative values.</para>
-        </summary>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare, or null. </param>
       </Docs>
@@ -175,10 +213,6 @@
         <Parameter Name="obj" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> represents the same value as the current instance; otherwise, <see langword="false" />.</para>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -188,6 +222,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified <see cref="T:System.Int64" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> has the same value as this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.Int64" /> value to compare to this instance.</param>
       </Docs>
@@ -209,12 +247,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> represents the
-   same type and value as the current instance. If <paramref name="obj" /> is a null reference
-   or is not an instance of <see cref="T:System.Int64" />, returns <see langword="false" />.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note">This method
@@ -225,6 +257,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is an instance of an <see cref="T:System.Int64" /> and equals the value of this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance. </param>
       </Docs>
@@ -245,9 +281,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the hash code for the current instance.</para>
-        </returns>
         <remarks>
           <para>The algorithm used to
       generate the hash code is unspecified.</para>
@@ -260,6 +293,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -277,12 +314,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.TypeCode" /> for value type <see cref="T:System.Int64" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The enumerated constant, <see cref="F:System.TypeCode.Int64" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MaxValue">
@@ -356,9 +396,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Int64" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -429,6 +466,10 @@ public class Int64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number to its 64-bit signed integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit signed integer equivalent to the number contained in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string containing a number to convert. </param>
       </Docs>
@@ -452,9 +493,6 @@ public class Int64ParseClass {
         <Parameter Name="style" Type="System.Globalization.NumberStyles" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Int64" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -710,6 +748,10 @@ public class Int64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified style to its 64-bit signed integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit signed integer equivalent to the number specified in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string containing a number to convert. </param>
         <param name="style">
@@ -735,9 +777,6 @@ public class Int64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Int64" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -779,6 +818,10 @@ public class Int64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified culture-specific format to its 64-bit signed integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit signed integer equivalent to the number specified in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string containing a number to convert. </param>
         <param name="provider">
@@ -805,9 +848,6 @@ public class Int64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Int64" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -1024,6 +1064,10 @@ public class Int64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified style and culture-specific format to its 64-bit signed integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit signed integer equivalent to the number specified in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string containing a number to convert. </param>
         <param name="style">
@@ -1049,7 +1093,6 @@ public class Int64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int64" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToBoolean(System.Int64)" /> method.</para>
@@ -1058,6 +1101,10 @@ public class Int64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToBoolean(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of the current instance is not zero; otherwise, false.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1078,7 +1125,6 @@ public class Int64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int64" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToByte(System.Int64)" /> method.</para>
@@ -1087,6 +1133,10 @@ public class Int64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToByte(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Byte" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1107,7 +1157,6 @@ public class Int64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int64" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToChar(System.Int64)" /> method.</para>
@@ -1116,6 +1165,10 @@ public class Int64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToChar(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Char" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1136,12 +1189,15 @@ public class Int64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to use this method throws an <see cref="T:System.InvalidCastException" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1162,7 +1218,6 @@ public class Int64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int64" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToDecimal(System.Int64)" /> method.</para>
@@ -1171,6 +1226,10 @@ public class Int64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToDecimal(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Decimal" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1191,7 +1250,6 @@ public class Int64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int64" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToDouble(System.Int64)" /> method.</para>
@@ -1200,6 +1258,10 @@ public class Int64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToDouble(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Double" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1220,7 +1282,6 @@ public class Int64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int64" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt16(System.Int64)" /> method.</para>
@@ -1229,6 +1290,10 @@ public class Int64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt16(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.Int16" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1249,7 +1314,6 @@ public class Int64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int64" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt32(System.Int64)" /> method.</para>
@@ -1258,6 +1322,10 @@ public class Int64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt32(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.Int32" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1278,7 +1346,6 @@ public class Int64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int64" /> instance is cast to an <see cref="T:System.IConvertible" /> interface.</para>
@@ -1287,6 +1354,10 @@ public class Int64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt64(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, unchanged.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1307,7 +1378,6 @@ public class Int64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int64" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToSByte(System.Int64)" /> method.</para>
@@ -1316,6 +1386,10 @@ public class Int64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToSByte(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.SByte" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1336,7 +1410,6 @@ public class Int64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int64" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToSingle(System.Int64)" /> method.</para>
@@ -1345,6 +1418,10 @@ public class Int64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToSingle(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Single" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1367,7 +1444,6 @@ public class Int64ParseClass {
       </Parameters>
       <Docs>
         <param name="targetType">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int64" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the static (Shared in Visual Basic) <see cref="M:System.Convert.ChangeType(System.Object,System.Type,System.IFormatProvider)" /> method.</para>
@@ -1376,6 +1452,10 @@ public class Int64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToType(System.Type,System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to <paramref name="type" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> implementation that provides information about the format of the returned value.</param>
       </Docs>
@@ -1396,7 +1476,6 @@ public class Int64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int64" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt16(System.Int64)" /> method.</para>
@@ -1405,6 +1484,10 @@ public class Int64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt16(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.UInt16" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1425,7 +1508,6 @@ public class Int64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int64" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt32(System.Int64)" /> method.</para>
@@ -1434,6 +1516,10 @@ public class Int64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt32(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.UInt32" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1454,7 +1540,6 @@ public class Int64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Int64" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt64(System.Int64)" /> method.</para>
@@ -1463,6 +1548,10 @@ public class Int64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt64(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.UInt64" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1482,11 +1571,6 @@ public class Int64ParseClass {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted using
-   the general format specifier ("G"). The string takes into account the current
-   system culture.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Int64.ToString" /> method formats an <see cref="T:System.Int64" /> value in the default ("G", or general) format by using the <see cref="T:System.Globalization.NumberFormatInfo" /> object of the current culture. If you want to specify a different format or culture, use the other overloads of the <see cref="M:System.Int64.ToString(System.String)" /> method, as follows: </para>
@@ -1559,6 +1643,10 @@ public class Int64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance, consisting of a minus sign if the value is negative, and a sequence of digits ranging from 0 to 9 with no leading zeroes.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1579,12 +1667,6 @@ public class Int64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted using
-   the general format specifier, ("G"). The string takes into account the
-   formatting information in the <see cref="T:System.Globalization.NumberFormatInfo" /> instance supplied by
-<paramref name="provider" /> .</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Int64.ToString(System.IFormatProvider)" /> method formats an <see cref="T:System.Int64" /> value in the default ("G", or general) format by using the <see cref="T:System.Globalization.NumberFormatInfo" /> object of a specified culture. If you want to specify a different format or the current culture, use the other overloads of the <see cref="M:System.Int64.ToString(System.String)" /> method, as follows:</para>
@@ -1670,6 +1752,10 @@ public class Int64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance as specified by <paramref name="provider" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> that supplies culture-specific formatting information. </param>
       </Docs>
@@ -1692,10 +1778,6 @@ public class Int64ParseClass {
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted as
-   specified by <paramref name="format" />. The string takes into account the current system culture.</para>
-        </returns>
         <exception cref="T:System.FormatException">
           <paramref name="format" /> is invalid.</exception>
         <example>
@@ -1798,6 +1880,10 @@ public class Int64ToStringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation, using the specified format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance as specified by <paramref name="format" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A numeric format string.</param>
       </Docs>
@@ -1821,11 +1907,6 @@ public class Int64ToStringExample {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted as
-   specified by <paramref name="format" />. The string takes into account the formatting
-   information in the <see cref="T:System.Globalization.NumberFormatInfo" /> instance supplied by <paramref name="provider" />.</para>
-        </returns>
         <exception cref="T:System.FormatException">
           <paramref name="format" /> is invalid.</exception>
         <param name="format">
@@ -1916,6 +1997,10 @@ public class Int64ToStringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance as specified by <paramref name="format" /> and <paramref name="provider" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A numeric format string.</param>
         <param name="provider">
diff --git a/mcs/class/corlib/Documentation/en/System/IntPtr.xml b/mcs/class/corlib/Documentation/en/System/IntPtr.xml
index ae7621f42fc..b7210ba2a32 100644
--- a/mcs/class/corlib/Documentation/en/System/IntPtr.xml
+++ b/mcs/class/corlib/Documentation/en/System/IntPtr.xml
@@ -155,7 +155,6 @@
         <Parameter Name="offset" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.IntPtr.Add(System.IntPtr,System.Int32)" /> method does not throw an exception if the result is too large to represent as a pointer on the specified platform. Instead, the addition operation is performed in an unchecked context.</para>
@@ -165,6 +164,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an offset to the value of a pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new pointer that reflects the addition of <paramref name="offset" /> to <paramref name="pointer" />.</para>
+        </returns>
         <param name="pointer">
           <attribution license="cc4" from="Microsoft" modified="false" />The pointer to add the offset to.</param>
         <param name="offset">
@@ -188,12 +191,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> is a <see cref="T:System.IntPtr" /> instance and has the same value as the current
-   instance. If <paramref name="obj" /> is a null reference or is not an instance of
-<see cref="T:System.IntPtr" />, returns <see langword="false" />.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note">The method overrides
@@ -204,6 +201,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is an instance of <see cref="T:System.IntPtr" /> and equals the value of this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance or null. </param>
       </Docs>
@@ -224,9 +225,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the hash code for the current instance.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note">The algorithm
@@ -241,6 +239,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -264,7 +266,6 @@
         <Parameter Name="offset" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.IntPtr.op_Addition(System.IntPtr,System.Int32)" /> method defines the addition operation for <see cref="T:System.IntPtr" /> objects. It enables code such as the following.</para>
@@ -276,6 +277,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an offset to the value of a pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new pointer that reflects the addition of <paramref name="offset" /> to <paramref name="pointer" />.</para>
+        </returns>
         <param name="pointer">
           <attribution license="cc4" from="Microsoft" modified="false" />The pointer to add the offset to.</param>
         <param name="offset">
@@ -305,17 +310,16 @@
         <Parameter Name="value2" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if
-<paramref name="value1" /> represents the same value as <paramref name="value2" />; otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <altmember cref="M:System.IntPtr.Equals(System.Object)" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two specified instances of <see cref="T:System.IntPtr" /> are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value1" /> equals <paramref name="value2" />; otherwise, false.</para>
+        </returns>
         <param name="value1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first pointer or handle to compare.</param>
         <param name="value2">
@@ -501,17 +505,16 @@
         <Parameter Name="value2" Type="System.IntPtr" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if
-<paramref name="value1" /> represents a different value than <paramref name="value2" />; otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <altmember cref="M:System.IntPtr.Equals(System.Object)" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two specified instances of <see cref="T:System.IntPtr" /> are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value1" /> does not equal <paramref name="value2" />; otherwise, false.</para>
+        </returns>
         <param name="value1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first pointer or handle to compare. </param>
         <param name="value2">
@@ -539,7 +542,6 @@
         <Parameter Name="offset" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.IntPtr.op_Subtraction(System.IntPtr,System.Int32)" /> method defines the subtraction operation for <see cref="T:System.IntPtr" /> objects. It enables code such as the following.</para>
@@ -551,6 +553,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts an offset from the value of a pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new pointer that reflects the subtraction of <paramref name="offset" /> from <paramref name="pointer" />.</para>
+        </returns>
         <param name="pointer">
           <attribution license="cc4" from="Microsoft" modified="false" />The pointer to subtract the offset from.</param>
         <param name="offset">
@@ -618,7 +624,6 @@
         <Parameter Name="offset" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.IntPtr.Subtract(System.IntPtr,System.Int32)" /> method does not throw an exception if the result is too small to represent as a pointer on the specified platform. Instead, the subtraction operation is performed in an unchecked context.</para>
@@ -628,6 +633,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts an offset from the value of a pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new pointer that reflects the subtraction of <paramref name="offset" /> from <paramref name="pointer" />.</para>
+        </returns>
         <param name="pointer">
           <attribution license="cc4" from="Microsoft" modified="false" />The pointer to subtract the offset from.</param>
         <param name="offset">
@@ -685,16 +694,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing 
-   the same value as the current instance.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.OverflowException">The current platform is not a 32-bit platform and the value of the current instance is greater than <see cref="F:System.Int32.MaxValue" /> or less than <see cref="F:System.Int32.MinValue" />.</exception>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to a 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer equal to the value of this instance.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -718,15 +727,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int64" /> containing the
- same value as the current instance.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to a 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit signed integer equal to the value of this instance.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -753,9 +762,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A pointer to <see langword="void" />. </para>
-        </returns>
         <remarks>
           <para>This member is not CLS-compliant. For a CLS-compliant alternative, use 
    <see cref="M:System.IntPtr.ToInt32" />.</para>
@@ -768,6 +774,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to a pointer to an unspecified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A pointer to <see cref="T:System.Void" />; that is, a pointer to memory containing data of an unspecified type.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -786,9 +796,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the value of the <see cref="P:System.IntPtr.Size" /> property for this instance is 4, then this method is equivalent to <see cref="M:System.Int32.ToString" />; otherwise, this method is equivalent to <see cref="M:System.Int64.ToString" />.</para>
@@ -797,6 +804,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of the current <see cref="T:System.IntPtr" /> object to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -815,7 +826,6 @@
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the <paramref name="format" /> parameter is null or an empty string (""), the return value is formatted with the general format specifier ("G"). For more information about numeric format specifiers, see the <format type="text/html"><a href="580e57eb-ac47-4ffd-bccd-3a1637c2f467">Standard Numeric Format Strings</a></format> topic. </para>
@@ -825,6 +835,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of the current <see cref="T:System.IntPtr" /> object to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of the current <see cref="T:System.IntPtr" /> object.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A format specification that governs how the current <see cref="T:System.IntPtr" /> object is converted. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System/Lazy`1.xml b/mcs/class/corlib/Documentation/en/System/Lazy`1.xml
index ce41a580483..cbbfe796ba5 100644
--- a/mcs/class/corlib/Documentation/en/System/Lazy`1.xml
+++ b/mcs/class/corlib/Documentation/en/System/Lazy`1.xml
@@ -327,7 +327,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calling this method does not cause initialization.</para>
@@ -337,6 +336,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates and returns a string representation of the <see cref="P:System.Lazy`1.Value" /> property for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The result of calling the <see cref="M:System.Object.ToString" /> method on the <see cref="P:System.Lazy`1.Value" /> property for this instance, if the value has been created (that is, if the <see cref="P:System.Lazy`1.IsValueCreated" /> property returns true). Otherwise, a string indicating that the value has not been created. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System/MarshalByRefObject.xml b/mcs/class/corlib/Documentation/en/System/MarshalByRefObject.xml
index 50003598a40..0298d36650f 100644
--- a/mcs/class/corlib/Documentation/en/System/MarshalByRefObject.xml
+++ b/mcs/class/corlib/Documentation/en/System/MarshalByRefObject.xml
@@ -71,7 +71,6 @@
         <Parameter Name="requestedType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.MarshalByRefObject.CreateObjRef(System.Type)" /> method is called by remote object creation methods such as <see cref="M:System.AppDomain.CreateInstance(System.String,System.String)" /> and <see cref="M:System.AppDomain.CreateInstanceAndUnwrap(System.String,System.String)" />. In most cases, there is no need to override this method.</para>
@@ -80,6 +79,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Information required to generate a proxy.</para>
+        </returns>
         <param name="requestedType">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Type" /> of the object that the new <see cref="T:System.Runtime.Remoting.ObjRef" /> will reference. </param>
       </Docs>
@@ -98,7 +101,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information about lifetime services, see the <see cref="T:System.Runtime.Remoting.Lifetime.LifetimeServices" /> class.</para>
@@ -107,6 +109,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the current lifetime service object that controls the lifetime policy for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object of type <see cref="T:System.Runtime.Remoting.Lifetime.ILease" /> used to control the lifetime policy for this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="InitializeLifetimeService">
@@ -123,7 +129,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For more information about lifetime services, see the <see cref="T:System.Runtime.Remoting.Lifetime.LifetimeServices" /> class.</para>
@@ -132,6 +137,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains a lifetime service object to control the lifetime policy for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object of type <see cref="T:System.Runtime.Remoting.Lifetime.ILease" /> used to control the lifetime policy for this instance. This is the current lifetime service object for this instance if one exists; otherwise, a new lifetime service object initialized to the value of the <see cref="P:System.Runtime.Remoting.Lifetime.LifetimeServices.LeaseManagerPollTime" /> property.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MemberwiseClone">
@@ -149,7 +158,6 @@
         <Parameter Name="cloneIdentity" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.MarshalByRefObject.MemberwiseClone(System.Boolean)" /> method creates a shallow copy by creating a new <see cref="T:System.MarshalByRefObject" /> object, and then copying the nonstatic fields of the current <see cref="T:System.MarshalByRefObject" /> object to the new object. If a field is a value type, a bit-by-bit copy of the field is performed. If a field is a reference type, the reference is copied but the referred object is not; therefore, the original object and its clone refer to the same object. </para>
@@ -160,6 +168,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a shallow copy of the current <see cref="T:System.MarshalByRefObject" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A shallow copy of the current <see cref="T:System.MarshalByRefObject" /> object.</para>
+        </returns>
         <param name="cloneIdentity">
           <attribution license="cc4" from="Microsoft" modified="false" />false to delete the current <see cref="T:System.MarshalByRefObject" /> object's identity, which will cause the object to be assigned a new identity when it is marshaled across a remoting boundary. A value of false is usually appropriate. true to copy the current <see cref="T:System.MarshalByRefObject" /> object's identity to its clone, which will cause remoting client calls to be routed to the remote server object. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System/Math.xml b/mcs/class/corlib/Documentation/en/System/Math.xml
index ccdce939330..c4b1e083cb5 100644
--- a/mcs/class/corlib/Documentation/en/System/Math.xml
+++ b/mcs/class/corlib/Documentation/en/System/Math.xml
@@ -41,9 +41,6 @@
         <Parameter Name="value" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Decimal" /> containing the absolute value of <paramref name="value" />.</para>
-        </returns>
         <example>
           <para>The following example demonstrates the <see cref="M:System.Math.Abs(System.SByte)" />(<see cref="T:System.Decimal" />) method.</para>
           <code lang="C#">
@@ -74,6 +71,10 @@ public class MathAbsExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the absolute value of a <see cref="T:System.Decimal" /> number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A decimal number, x, such that 0 <math>≤</math> x <math>≤</math> <see cref="F:System.Decimal.MaxValue" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A number that is greater than or equal to <see cref="F:System.Decimal.MinValue" />, but less than or equal to <see cref="F:System.Decimal.MaxValue" />. </param>
       </Docs>
@@ -96,11 +97,6 @@ public class MathAbsExample
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Double" /> containing the absolute value of <paramref name="value" />. If <paramref name="value " />
-is equal to <see cref="F:System.Double.NegativeInfinity" /> or <see cref="F:System.Double.PositiveInfinity" />,
-returns <see cref="F:System.Double.PositiveInfinity" />. If value is equal to <see cref="F:System.Double.NaN" />, returns <see cref="F:System.Double.NaN" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The absolute value of a <see cref="T:System.Double" /> is its numeric value without its sign. For example, the absolute value of both 1.2e-03 and -1.2e03 is 1.2e03.</para>
@@ -110,6 +106,10 @@ returns <see cref="F:System.Double.PositiveInfinity" />. If value is equal to <s
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the absolute value of a double-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A double-precision floating-point number, x, such that 0 <math>≤</math> x <math>≤</math> <see cref="F:System.Double.MaxValue" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A number that is greater than or equal to <see cref="F:System.Double.MinValue" />, but less than or equal to <see cref="F:System.Double.MaxValue" />.</param>
       </Docs>
@@ -132,10 +132,6 @@ returns <see cref="F:System.Double.PositiveInfinity" />. If value is equal to <s
         <Parameter Name="value" Type="System.Int16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int16" />
-containing the absolute value of <paramref name="value" />.</para>
-        </returns>
         <exception cref="T:System.OverflowException">
           <paramref name="value" /> equals <see cref="F:System.Int16.MinValue" />.</exception>
         <remarks>
@@ -146,6 +142,10 @@ containing the absolute value of <paramref name="value" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the absolute value of a 16-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit signed integer, x, such that 0 <math>≤</math> x <math>≤</math> <see cref="F:System.Int16.MaxValue" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A number that is greater than <see cref="F:System.Int16.MinValue" />, but less than or equal to <see cref="F:System.Int16.MaxValue" />.</param>
       </Docs>
@@ -168,9 +168,6 @@ containing the absolute value of <paramref name="value" />.</para>
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the absolute value of <paramref name="value" />.</para>
-        </returns>
         <exception cref="T:System.OverflowException">
           <paramref name="value " /> equals <see cref="F:System.Int32.MinValue" />.</exception>
         <remarks>
@@ -181,6 +178,10 @@ containing the absolute value of <paramref name="value" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the absolute value of a 32-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer, x, such that 0 <math>≤</math> x <math>≤</math> <see cref="F:System.Int32.MaxValue" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A number that is greater than <see cref="F:System.Int32.MinValue" />, but less than or equal to <see cref="F:System.Int32.MaxValue" />.</param>
       </Docs>
@@ -203,9 +204,6 @@ containing the absolute value of <paramref name="value" />.</para>
         <Parameter Name="value" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int64" /> containing the absolute value of <paramref name="value" />.</para>
-        </returns>
         <exception cref="T:System.OverflowException">
           <paramref name="value " /> equals <see cref="F:System.Int64.MinValue" />.</exception>
         <remarks>
@@ -216,6 +214,10 @@ containing the absolute value of <paramref name="value" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the absolute value of a 64-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit signed integer, x, such that 0 <math>≤</math> x <math>≤</math> <see cref="F:System.Int64.MaxValue" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A number that is greater than <see cref="F:System.Int64.MinValue" />, but less than or equal to <see cref="F:System.Int64.MaxValue" />.</param>
       </Docs>
@@ -243,9 +245,6 @@ containing the absolute value of <paramref name="value" />.</para>
         <Parameter Name="value" Type="System.SByte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.SByte" /> containing the absolute value of <paramref name="value" />.</para>
-        </returns>
         <exception cref="T:System.OverflowException">
           <paramref name="value" /> equals <see cref="F:System.SByte.MinValue" />.</exception>
         <remarks>
@@ -256,6 +255,10 @@ containing the absolute value of <paramref name="value" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the absolute value of an 8-bit signed integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit signed integer, x, such that 0 <math>≤</math> x <math>≤</math> <see cref="F:System.SByte.MaxValue" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A number that is greater than <see cref="F:System.SByte.MinValue" />, but less than or equal to <see cref="F:System.SByte.MaxValue" />.</param>
       </Docs>
@@ -278,12 +281,6 @@ containing the absolute value of <paramref name="value" />.</para>
         <Parameter Name="value" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Single" />
-containing the absolute value of <paramref name="value" />. If <paramref name="value " /> is equal to <see cref="F:System.Single.NegativeInfinity" />
-or <see cref="F:System.Single.PositiveInfinity" />, returns <see cref="F:System.Single.PositiveInfinity" />. If <paramref name="value" /> is equal to <see cref="F:System.Single.NaN" />, returns
-<see cref="F:System.Single.NaN" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The absolute value of a <see cref="T:System.Single" /> is its numeric value without its sign. For example, the absolute value of both 1.2e-03 and -1.2e03 is 1.2e03.</para>
@@ -293,6 +290,10 @@ or <see cref="F:System.Single.PositiveInfinity" />, returns <see cref="F:System.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the absolute value of a single-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A single-precision floating-point number, x, such that 0 <math>≤</math> x <math>≤</math> <see cref="F:System.Single.MaxValue" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A number that is greater than or equal to <see cref="F:System.Single.MinValue" />, but less than or equal to <see cref="F:System.Single.MaxValue" />.</param>
       </Docs>
@@ -315,12 +316,6 @@ or <see cref="F:System.Single.PositiveInfinity" />, returns <see cref="F:System.
         <Parameter Name="d" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Double" /> containing the 
-   value of an angle, <theta />, measured in radians, for which <paramref name="d" />
-   is the cosine, such that 0 &lt;= <theta /> &lt;= <pi />. If
-<paramref name="d" /> &lt; -1, <paramref name="d" /> &gt; 1, or <paramref name="d" /> = <see cref="F:System.Double.NaN" />, returns <see cref="F:System.Double.NaN" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Multiply the return value by 180/<see cref="F:System.Math.PI" /> to convert from radians to degrees.</para>
@@ -329,6 +324,13 @@ or <see cref="F:System.Single.PositiveInfinity" />, returns <see cref="F:System.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the angle whose cosine is the specified number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An angle, <math>θ</math>, measured in radians, such that 0 <math>≤</math> <math>θ</math> <math>≤</math> <math>π</math> </para>
+          <para>-or- </para>
+          <para>
+            <see cref="F:System.Double.NaN" /> if <paramref name="d" /> &lt; -1 or <paramref name="d" /> &gt; 1 or <paramref name="d" /> equals <see cref="F:System.Double.NaN" />.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />A number representing a cosine, where <paramref name="d" /> must be greater than or equal to -1, but less than or equal to 1. </param>
       </Docs>
@@ -351,15 +353,6 @@ or <see cref="F:System.Single.PositiveInfinity" />, returns <see cref="F:System.
         <Parameter Name="d" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Double" /> containing the 
-   value of an angle, <theta />, measured in radians, for which <paramref name="d" /> is the sine, such that -<pi />/2 &lt;= <theta /> &lt;=
-   <pi />/2. If <paramref name="d" /> &lt; -1, <paramref name="d" /> &gt; 1, or <paramref name="d" /> =
-   
-<see cref="F:System.Double.NaN" />, returns
-<see cref="F:System.Double.NaN" />
-.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A positive return value represents a counterclockwise angle from the x-axis; a negative return value represents a clockwise angle.</para>
@@ -369,6 +362,13 @@ or <see cref="F:System.Single.PositiveInfinity" />, returns <see cref="F:System.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the angle whose sine is the specified number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An angle, <math>θ</math>, measured in radians, such that -<math>π</math>/2 <math>≤</math> <math>θ</math> <math>≤</math> <math>π</math>/2 </para>
+          <para>-or- </para>
+          <para>
+            <see cref="F:System.Double.NaN" /> if <paramref name="d" /> &lt; -1 or <paramref name="d" /> &gt; 1 or <paramref name="d" /> equals <see cref="F:System.Double.NaN" />.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />A number representing a sine, where <paramref name="d" /> must be greater than or equal to -1, but less than or equal to 1. </param>
       </Docs>
@@ -391,40 +391,6 @@ or <see cref="F:System.Single.PositiveInfinity" />, returns <see cref="F:System.
         <Parameter Name="d" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Double" /> containing the 
-   value of the angle, <theta />, measured in radians, for which <paramref name="d" /> is the tangent, such that -<pi />/2 &lt;=
-   <theta /> &lt;=
-   
-   <pi />/2.</para>
-          <para> The
-   following table specifies the return value if d is equal to <see cref="F:System.Double.NaN" />, <see cref="F:System.Double.NegativeInfinity" />,
-   or <see cref="F:System.Double.PositiveInfinity" /> .</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Condition</description>
-            </listheader>
-            <item>
-              <term>
-                <see cref="F:System.Double.NaN" />
-              </term>
-              <description>
-                <paramref name="d" /> is equal to <see cref="F:System.Double.NaN" />.</description>
-            </item>
-            <item>
-              <term> -<pi />/2 rounded to double precision (-1.5707963267949)</term>
-              <description>
-                <paramref name="d" /> is equal to <see cref="F:System.Double.NegativeInfinity" />.</description>
-            </item>
-            <item>
-              <term>
-                <pi />/2 rounded to double precision (1.5707963267949)</term>
-              <description>
-                <paramref name="d" /> is equal to <see cref="F:System.Double.PositiveInfinity" />.</description>
-            </item>
-          </list>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A positive return value represents a counterclockwise angle from the x-axis; a negative return value represents a clockwise angle.</para>
@@ -434,6 +400,13 @@ or <see cref="F:System.Single.PositiveInfinity" />, returns <see cref="F:System.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the angle whose tangent is the specified number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An angle, <math>θ</math>, measured in radians, such that -<math>π</math>/2 <math>≤</math> <math>θ</math> <math>≤</math> <math>π</math>/2.</para>
+          <para>-or- </para>
+          <para>
+            <see cref="F:System.Double.NaN" /> if <paramref name="d" /> equals <see cref="F:System.Double.NaN" />, -<math>π</math>/2 rounded to double precision (-1.5707963267949) if <paramref name="d" /> equals <see cref="F:System.Double.NegativeInfinity" />, or <math>π</math>/2 rounded to double precision (1.5707963267949) if <paramref name="d" /> equals <see cref="F:System.Double.PositiveInfinity" />.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />A number representing a tangent. </param>
       </Docs>
@@ -457,86 +430,6 @@ or <see cref="F:System.Single.PositiveInfinity" />, returns <see cref="F:System.
         <Parameter Name="x" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Double" /> containing the 
-   value of an angle, <theta />, measured in radians, such that -<pi /> &lt;=
-   <theta /> &lt;=
-   
-   <pi /> and tan<theta /> =
-   
-<paramref name="y/x" />, where (<paramref name="x, y" />) is a 
-   point in the Cartesian plane.</para>
-          <para>If both <paramref name="x" /> and <paramref name="y" /> are any combination of <see cref="F:System.Double.NegativeInfinity" /> and <see cref="F:System.Double.PositiveInfinity" />, <see cref="F:System.Double.NaN" /> is
-returned.</para>
-          <para>If either <paramref name="x" /> or <paramref name="y" /> is equal to <see cref="F:System.Double.NaN" />, <see cref="F:System.Double.NaN" /> is
-returned.</para>
-          <para>The following table specifies the return value if
-<paramref name="x" /> or <paramref name="y" /> 
-is equal to <see cref="F:System.Double.NegativeInfinity" /> or <see cref="F:System.Double.PositiveInfinity" />.</para>
-          <list type="table">
-            <listheader>
-              <term>Condition</term>
-              <description>Return Value</description>
-            </listheader>
-            <item>
-              <term>
-                <para>
-                  <paramref name="y " /> is equal to <see cref="F:System.Double.PositiveInfinity" /> or <see cref="F:System.Double.NegativeInfinity" />, and</para>
-                <para>
-                  <paramref name="x " /> is equal to <see cref="F:System.Double.PositiveInfinity" /> or <see cref="F:System.Double.NegativeInfinity" />.</para>
-              </term>
-              <description>
-                <see cref="F:System.Double.NaN" />.</description>
-            </item>
-            <item>
-              <term>
-                <para>
-                  <paramref name="y " /> is equal to <see cref="F:System.Double.NegativeInfinity" />, and</para>
-                <para>
-                  <paramref name="x " /> is not equal to <see cref="F:System.Double.PositiveInfinity" /> or <see cref="F:System.Double.NegativeInfinity" />.</para>
-              </term>
-              <description>-<see cref="F:System.Math.PI" />/2.</description>
-            </item>
-            <item>
-              <term>
-                <para>
-                  <paramref name="y " /> is equal to <see cref="F:System.Double.PositiveInfinity" />, and</para>
-                <para>
-                  <paramref name="x " /> is not equal to <see cref="F:System.Double.PositiveInfinity" /> or <see cref="F:System.Double.NegativeInfinity" />.</para>
-              </term>
-              <description>
-                <see cref="F:System.Math.PI" />/2.</description>
-            </item>
-            <item>
-              <term>
-                <para>
-                  <paramref name="x " /> is equal to <see cref="F:System.Double.PositiveInfinity" />, and</para>
-                <para>
-                  <paramref name="y " /> is not equal to <see cref="F:System.Double.PositiveInfinity" /> or <see cref="F:System.Double.NegativeInfinity" />.</para>
-              </term>
-              <description>0.</description>
-            </item>
-            <item>
-              <term>
-                <para>
-                  <paramref name="x " /> is equal to <see cref="F:System.Double.NegativeInfinity" />, and </para>
-                <para>
-                  <paramref name="y " /> &gt;= 0 and not equal to <see cref="F:System.Double.PositiveInfinity" />.</para>
-              </term>
-              <description>
-                <see cref="F:System.Math.PI" />.</description>
-            </item>
-            <item>
-              <term>
-                <para>
-                  <paramref name="x " /> is equal to <see cref="F:System.Double.NegativeInfinity" />, and </para>
-                <para>
-                  <paramref name="y " /> &lt; 0 and not equal to <see cref="F:System.Double.NegativeInfinity" />.</para>
-              </term>
-              <description>-<see cref="F:System.Math.PI" />.</description>
-            </item>
-          </list>
-        </returns>
         <example>
           <para>The following example demonstrates using the <see cref="M:System.Math.Atan2(System.Double,System.Double)" /> method.</para>
           <code lang="C#">using System;
@@ -570,6 +463,43 @@ public class MathAtan2Example
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the angle whose tangent is the quotient of two specified numbers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An angle, <math>θ</math>, measured in radians, such that -<math>π</math> <math>≤</math> <math>θ</math> <math>≤</math> <math>π</math>, and tan(<math>θ</math>) = <paramref name="y" /> / <paramref name="x" />, where (<paramref name="x" />, <paramref name="y" />) is a point in the Cartesian plane. Observe the following: </para>
+          <list type="bullet">
+            <item>
+              <para>For (<paramref name="x" />, <paramref name="y" />) in quadrant 1, 0 &lt; <math>θ</math> &lt; <math>π</math>/2.</para>
+            </item>
+            <item>
+              <para>For (<paramref name="x" />, <paramref name="y" />) in quadrant 2, <math>π</math>/2 &lt; <math>θ</math> <math>≤</math> <math>π</math>.</para>
+            </item>
+            <item>
+              <para>For (<paramref name="x" />, <paramref name="y" />) in quadrant 3, -<math>π</math> &lt; <math>θ</math> &lt; -<math>π</math>/2.</para>
+            </item>
+            <item>
+              <para>For (<paramref name="x" />, <paramref name="y" />) in quadrant 4, -<math>π</math>/2 &lt; <math>θ</math> &lt; 0.</para>
+            </item>
+          </list>
+          <para>For points on the boundaries of the quadrants, the return value is the following:</para>
+          <list type="bullet">
+            <item>
+              <para>If y is 0 and x is not negative, θ = 0.</para>
+            </item>
+            <item>
+              <para>If y is 0 and x is negative, θ = π.</para>
+            </item>
+            <item>
+              <para>If y is positive and x is 0, θ = π/2.</para>
+            </item>
+            <item>
+              <para>If y is negative and x is 0, θ = -π/2.</para>
+            </item>
+            <item>
+              <para>If y is 0 and x is 0, θ = 0. </para>
+            </item>
+          </list>
+          <para>If <paramref name="x" /> or <paramref name="y" /> is <see cref="F:System.Double.NaN" />, or if <paramref name="x" /> and <paramref name="y" /> are either <see cref="F:System.Double.PositiveInfinity" /> or <see cref="F:System.Double.NegativeInfinity" />, the method returns <see cref="F:System.Double.NaN" />.</para>
+        </returns>
         <param name="y">
           <attribution license="cc4" from="Microsoft" modified="false" />The y coordinate of a point. </param>
         <param name="x">
@@ -595,15 +525,15 @@ public class MathAtan2Example
         <Parameter Name="b" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Int64" /> containing the product of the specified numbers. 
-      </para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Produces the full product of two 32-bit numbers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number containing the product of the specified numbers.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The first number to multiply. </param>
         <param name="b">
@@ -626,7 +556,6 @@ public class MathAtan2Example
         <Parameter Name="d" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -636,6 +565,10 @@ public class MathAtan2Example
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the smallest integral value that is greater than or equal to the specified decimal number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The smallest integral value that is greater than or equal to <paramref name="d" />. Note that this method returns a <see cref="T:System.Decimal" /> instead of an integral type.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />A decimal number. </param>
       </Docs>
@@ -657,13 +590,6 @@ public class MathAtan2Example
         <Parameter Name="a" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Double" /> containing the value of the smallest integer greater
-   than or equal to <paramref name="a" />. If <paramref name="a" /> is equal to <see cref="F:System.Double.NaN" />, <see cref="F:System.Double.NegativeInfinity" />,
-   or <see cref="F:System.Double.PositiveInfinity" />
-   , that value
-   is returned.</para>
-        </returns>
         <example>
           <para>The following example demonstrates using the <see cref="M:System.Math.Ceiling(System.Double)" /> method.</para>
           <code lang="C#">using System;
@@ -697,6 +623,10 @@ public class MathCeilingExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the smallest integral value that is greater than or equal to the specified double-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The smallest integral value that is greater than or equal to <paramref name="a" />. If <paramref name="a" /> is equal to <see cref="F:System.Double.NaN" />, <see cref="F:System.Double.NegativeInfinity" />, or <see cref="F:System.Double.PositiveInfinity" />, that value is returned. Note that this method returns a <see cref="T:System.Double" /> instead of an integral type.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />A double-precision floating-point number. </param>
       </Docs>
@@ -719,11 +649,6 @@ public class MathCeilingExample
         <Parameter Name="d" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Double" /> containing the value of the cosine of <paramref name="d" />. If
-<paramref name="d" /> is equal to <see cref="F:System.Double.NaN" />, <see cref="F:System.Double.NegativeInfinity" />, or <see cref="F:System.Double.PositiveInfinity" />, 
-   returns <see cref="F:System.Double.NaN" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The angle, <paramref name="d" />, must be in radians. Multiply by <see cref="F:System.Math.PI" />/180 to convert degrees to radians.</para>
@@ -733,6 +658,10 @@ public class MathCeilingExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the cosine of the specified angle.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The cosine of <paramref name="d" />. If <paramref name="d" /> is equal to <see cref="F:System.Double.NaN" />, <see cref="F:System.Double.NegativeInfinity" />, or <see cref="F:System.Double.PositiveInfinity" />, this method returns <see cref="F:System.Double.NaN" />.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />An angle, measured in radians. </param>
       </Docs>
@@ -755,12 +684,6 @@ public class MathCeilingExample
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The hyperbolic cosine of <paramref name="value" />. If
-<paramref name="value" /> is equal to <see cref="F:System.Double.NegativeInfinity" /> or <see cref="F:System.Double.PositiveInfinity" />, 
-   returns <see cref="F:System.Double.PositiveInfinity" />. If <paramref name="value" /> is equal to <see cref="F:System.Double.NaN" />, returns
-<see cref="F:System.Double.NaN" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The angle, <paramref name="value" />, must be in radians. Multiply by <see cref="F:System.Math.PI" />/180 to convert degrees to radians.</para>
@@ -769,6 +692,10 @@ public class MathCeilingExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hyperbolic cosine of the specified angle.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hyperbolic cosine of <paramref name="value" />. If <paramref name="value" /> is equal to <see cref="F:System.Double.NegativeInfinity" /> or <see cref="F:System.Double.PositiveInfinity" />, <see cref="F:System.Double.PositiveInfinity" /> is returned. If <paramref name="value" /> is equal to <see cref="F:System.Double.NaN" />, <see cref="F:System.Double.NaN" /> is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An angle, measured in radians. </param>
       </Docs>
@@ -888,12 +815,6 @@ public class MathCeilingExample
         <Parameter Name="d" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Double" /> equal to the number <see langword="e" /> raised to the power of
-<paramref name="d" />. If <paramref name="d " />equals <see cref="F:System.Double.NaN" /> or <see cref="F:System.Double.PositiveInfinity" />, 
-   returns that value. If <paramref name="d " />equals <see cref="F:System.Double.NegativeInfinity" />,
-   returns 0.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use the <see cref="M:System.Math.Pow(System.Double,System.Double)" /> method to calculate powers of other bases.</para>
@@ -904,6 +825,10 @@ public class MathCeilingExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns e raised to the specified power.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number e raised to the power <paramref name="d" />. If <paramref name="d" /> equals <see cref="F:System.Double.NaN" /> or <see cref="F:System.Double.PositiveInfinity" />, that value is returned. If <paramref name="d" /> equals <see cref="F:System.Double.NegativeInfinity" />, 0 is returned.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />A number specifying a power. </param>
       </Docs>
@@ -924,7 +849,6 @@ public class MathCeilingExample
         <Parameter Name="d" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -934,6 +858,10 @@ public class MathCeilingExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the largest integer less than or equal to the specified decimal number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The largest integer less than or equal to <paramref name="d" />.  Note that the method returns an integral value of type <see cref="T:System.Math" />. </para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />A decimal number. </param>
       </Docs>
@@ -955,11 +883,6 @@ public class MathCeilingExample
         <Parameter Name="d" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Double" /> containing the value of the largest integer less than or
-   equal to <paramref name="d" />. If <paramref name="d" /> is equal to <see cref="F:System.Double.NaN" />, <see cref="F:System.Double.NegativeInfinity" />,
-   or <see cref="F:System.Double.PositiveInfinity" />, that value is returned..</para>
-        </returns>
         <example>
           <para>The following example demonstrates using the <see cref="M:System.Math.Floor(System.Double)" /> method.</para>
           <code lang="C#">using System;
@@ -993,6 +916,10 @@ public class MathFloorExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the largest integer less than or equal to the specified double-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The largest integer less than or equal to <paramref name="d" />. If <paramref name="d" /> is equal to <see cref="F:System.Double.NaN" />, <see cref="F:System.Double.NegativeInfinity" />, or <see cref="F:System.Double.PositiveInfinity" />, that value is returned.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />A double-precision floating-point number. </param>
       </Docs>
@@ -1016,42 +943,6 @@ public class MathFloorExample
         <Parameter Name="y" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Double" />
-whose value is as follows:</para>
-          <list type="table">
-            <listheader>
-              <term>Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term>
-                <paramref name="x" /> - (<paramref name="y" />
-      Q),</term>
-              <description>Q is the quotient of <paramref name="x/y" /> rounded to
-   the nearest integer (if <paramref name="x/y" /> is exactly halfway between two
-   integers, the even integer is returned).</description>
-            </item>
-            <item>
-              <term> +0</term>
-              <description>Q is the quotient of <paramref name="x/y" /> rounded to the nearest integer (if
-<paramref name="x/y" /> is exactly halfway between two integers, the even integer is 
-   returned), <paramref name="x" /> - (y Q) is zero, and <paramref name="x" /> is positive.</description>
-            </item>
-            <item>
-              <term> -0</term>
-              <description>Q is the quotient of <paramref name="x/y" /> rounded to the nearest integer (if
-<paramref name="x/y" /> is exactly halfway between two integers, the even integer is 
-   returned), <paramref name="x" /> - (y Q) is zero, and <paramref name="x" /> is negative.</description>
-            </item>
-            <item>
-              <term>
-                <see cref="F:System.Double.NaN" />
-              </term>
-              <description>y = 0.</description>
-            </item>
-          </list>
-        </returns>
         <example>
           <para>The following example demonstrates using the <see cref="M:System.Math.IEEERemainder(System.Double,System.Double)" /> 
 method.</para>
@@ -1098,6 +989,12 @@ public class MathIEEERemainderExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the remainder resulting from the division of a specified number by another specified number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A number equal to <paramref name="x" /> - (<paramref name="y" /> Q), where Q is the quotient of <paramref name="x" /> / <paramref name="y" /> rounded to the nearest integer (if <paramref name="x" /> / <paramref name="y" /> falls halfway between two integers, the even integer is returned).</para>
+          <para>If <paramref name="x" /> - (<paramref name="y" /> Q) is zero, the value +0 is returned if <paramref name="x" /> is positive, or -0 if <paramref name="x" /> is negative.</para>
+          <para>If <paramref name="y" /> = 0, <see cref="F:System.Double.NaN" /> is returned.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A dividend. </param>
         <param name="y">
@@ -1122,60 +1019,77 @@ public class MathIEEERemainderExample
         <Parameter Name="d" Type="System.Double" />
       </Parameters>
       <Docs>
+        <remarks>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Parameter <paramref name="d" /> is specified as a base 10 number.</para>
+        </remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the natural (base e) logarithm of a specified number.</para>
+        </summary>
         <returns>
-          <para> Returns a <see cref="T:System.Double" /> whose value is as
-   follows.</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the values in the following table. </para>
           <list type="table">
             <listheader>
-              <term>Condition</term>
-              <description>Returns</description>
+              <item>
+                <term>
+                  <para>
+                    <paramref name="d" /> parameter</para>
+                </term>
+                <description>
+                  <para>Return value </para>
+                </description>
+              </item>
             </listheader>
             <item>
               <term>
-                <paramref name="d" />
-   
-   &gt;
-   0.</term>
-              <description> The value of the natural logarithm of <paramref name="d" />.</description>
+                <para>Positive </para>
+              </term>
+              <description>
+                <para>The natural logarithm of <paramref name="d" />; that is, ln <paramref name="d" />, or log <subscript>e</subscript> <paramref name="d" /> </para>
+              </description>
             </item>
             <item>
               <term>
-                <paramref name="d" /> == 0.</term>
+                <para>Zero </para>
+              </term>
               <description>
-                <see cref="F:System.Double.NegativeInfinity" />.</description>
+                <para>
+                  <see cref="F:System.Double.NegativeInfinity" /> </para>
+              </description>
             </item>
             <item>
               <term>
+                <para>Negative </para>
+              </term>
+              <description>
                 <para>
-                  <paramref name="d " /> &lt;
-      0.</para>
-                <para>-or-</para>
-                <para>
-                  <paramref name="d " /> is equal to <see cref="F:System.Double.NegativeInfinity" />.</para>
-                <para>-or-</para>
-                <para>
-                  <paramref name="d " /> is equal to <see cref="F:System.Double.NaN" />.</para>
+                  <see cref="F:System.Double.NaN" /> </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Equal to <see cref="F:System.Double.NaN" /></para>
               </term>
               <description>
-                <see cref="F:System.Double.NaN" />.</description>
+                <para>
+                  <see cref="F:System.Double.NaN" />
+                </para>
+              </description>
             </item>
             <item>
               <term>
-                <paramref name="d" />
-is equal to <see cref="F:System.Double.PositiveInfinity" />.</term>
+                <para>Equal to <see cref="F:System.Double.PositiveInfinity" /></para>
+              </term>
               <description>
-                <see cref="F:System.Double.PositiveInfinity" />.</description>
+                <para>
+                  <see cref="F:System.Double.PositiveInfinity" />
+                </para>
+              </description>
             </item>
           </list>
         </returns>
-        <remarks>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Parameter <paramref name="d" /> is specified as a base 10 number.</para>
-        </remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Returns the natural (base e) logarithm of a specified number.</para>
-        </summary>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />The number whose logarithm is to be found. </param>
       </Docs>
@@ -1199,103 +1113,208 @@ is equal to <see cref="F:System.Double.PositiveInfinity" />.</term>
         <Parameter Name="newBase" Type="System.Double" />
       </Parameters>
       <Docs>
+        <remarks>To be added.</remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the logarithm of a specified number in a specified base.</para>
+        </summary>
         <returns>
-          <para>Returns a <see cref="T:System.Double" /> whose value is as follows:</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the values in the following table. (+Infinity denotes <see cref="F:System.Double.PositiveInfinity" />, -Infinity denotes <see cref="F:System.Double.NegativeInfinity" />, and NaN denotes <see cref="F:System.Double.NaN" />.)</para>
           <list type="table">
             <listheader>
-              <term>Condition</term>
-              <description>Returns</description>
+              <item>
+                <term>
+                  <para>
+                    <paramref name="a" />
+                  </para>
+                </term>
+                <description>
+                  <para>
+                    <paramref name="newBase" />
+                  </para>
+                </description>
+                <description>
+                  <para>Return value</para>
+                </description>
+              </item>
             </listheader>
             <item>
               <term>
-                <paramref name="a" /> &gt; 0, <paramref name="newBase" /> &gt; 0, but <paramref name="newBase" /> != 1</term>
-              <description>log<sub><paramref name="newBase" /></sub><paramref name="a" /></description>
+                <para>
+                  <paramref name="a" /> <math>&gt;</math> 0</para>
+              </term>
+              <description>
+                <para>(0 <math>&lt;</math> <paramref name="newBase" /> <math>&lt;</math> 1) -or-(<paramref name="newBase" /> <math>&gt;</math> 1)</para>
+              </description>
+              <description>
+                <para>log<subscript>newBase</subscript>(a)</para>
+              </description>
             </item>
             <item>
               <term>
-                <paramref name="a " /> &lt; 0</term>
+                <para>
+                  <paramref name="a" /> <math>&lt;</math> 0</para>
+              </term>
+              <description>
+                <para>(any value)</para>
+              </description>
               <description>
-                <see cref="F:System.Double.NaN" />
+                <para>NaN</para>
               </description>
             </item>
             <item>
               <term>
-                <paramref name="newBase" /> &lt; 0</term>
+                <para>(any value)</para>
+              </term>
               <description>
-                <see cref="F:System.Double.NaN" />
+                <para>
+                  <paramref name="newBase" /> <math>&lt;</math> 0</para>
+              </description>
+              <description>
+                <para>NaN</para>
               </description>
             </item>
             <item>
               <term>
-                <paramref name="newBase" /> == 0, <paramref name="a" />  != 1</term>
+                <para>
+                  <paramref name="a" /> != 1</para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="newBase" /> = 0</para>
+              </description>
               <description>
-                <see cref="F:System.Double.NaN" />
+                <para>NaN</para>
               </description>
             </item>
             <item>
               <term>
-                <paramref name="newBase" /> == 0, <paramref name="a" /> == 1</term>
-              <description>Zero</description>
+                <para>
+                  <paramref name="a" /> != 1</para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="newBase" /> = +Infinity</para>
+              </description>
+              <description>
+                <para>NaN</para>
+              </description>
             </item>
             <item>
-              <term>0 &lt; <paramref name="newBase" /> &lt; 1, <paramref name="a" /> == 0</term>
+              <term>
+                <para>
+                  <paramref name="a" /> = NaN</para>
+              </term>
+              <description>
+                <para>(any value)</para>
+              </description>
               <description>
-                <see cref="F:System.Double.PositiveInfinity" />
+                <para>NaN</para>
               </description>
             </item>
             <item>
-              <term>0 &lt; <paramref name="newBase" /> &lt; 1, <paramref name="a" /> == +infinity</term>
+              <term>
+                <para>(any value)</para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="newBase" /> = NaN</para>
+              </description>
               <description>
-                <see cref="F:System.Double.NegativeInfinity" />
+                <para>NaN</para>
               </description>
             </item>
             <item>
               <term>
-                <paramref name="newBase" /> == 1</term>
+                <para>(any value)</para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="newBase" /> = 1</para>
+              </description>
               <description>
-                <see cref="F:System.Double.NaN" />
+                <para>NaN</para>
               </description>
             </item>
             <item>
               <term>
-                <paramref name="newBase" /> &gt; 1, <paramref name="a" /> == 0</term>
+                <para>
+                  <paramref name="a" /> = 0</para>
+              </term>
               <description>
-                <see cref="F:System.Double.NegativeInfinity" />
+                <para>0 <math>&lt;</math> <paramref name="newBase" /> <math>&lt;</math> 1 </para>
+              </description>
+              <description>
+                <para>+Infinity</para>
               </description>
             </item>
             <item>
               <term>
-                <paramref name="newBase" /> &gt; 1, <paramref name="a" /> == +infinity</term>
+                <para>
+                  <paramref name="a" /> = 0</para>
+              </term>
               <description>
-                <see cref="F:System.Double.PositiveInfinity" />
+                <para>
+                  <paramref name="newBase" /> <math>&gt;</math> 1</para>
+              </description>
+              <description>
+                <para>-Infinity</para>
               </description>
             </item>
             <item>
               <term>
-                <paramref name="newBase" /> == +infinity, <paramref name="a" /> != 1</term>
+                <para>
+                  <paramref name="a" /> =  +Infinity</para>
+              </term>
+              <description>
+                <para>0 <math>&lt;</math> <paramref name="newBase" /> <math>&lt;</math> 1</para>
+              </description>
               <description>
-                <see cref="F:System.Double.NaN" />
+                <para>-Infinity</para>
               </description>
             </item>
             <item>
               <term>
-                <paramref name="newBase" /> == +infinity, <paramref name="a" /> == 1</term>
-              <description>Zero</description>
+                <para>
+                  <paramref name="a" /> =  +Infinity</para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="newBase" /> <math>&gt;</math> 1</para>
+              </description>
+              <description>
+                <para>+Infinity</para>
+              </description>
             </item>
             <item>
               <term>
-                <paramref name="a" /> == NaN or <paramref name="newBase" /> == NaN</term>
+                <para>
+                  <paramref name="a" /> = 1</para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="newBase" /> = 0</para>
+              </description>
               <description>
-                <see cref="F:System.Double.NaN" />
+                <para>0</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>
+                  <paramref name="a" /> = 1</para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="newBase" /> = +Infinity</para>
+              </description>
+              <description>
+                <para>0</para>
               </description>
             </item>
           </list>
         </returns>
-        <remarks>To be added.</remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Returns the logarithm of a specified number in a specified base.</para>
-        </summary>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The number whose logarithm is to be found. </param>
         <param name="newBase">
@@ -1320,62 +1339,77 @@ is equal to <see cref="F:System.Double.PositiveInfinity" />.</term>
         <Parameter Name="d" Type="System.Double" />
       </Parameters>
       <Docs>
+        <remarks>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Parameter <paramref name="d" /> is specified as a base 10 number.</para>
+        </remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns the base 10 logarithm of a specified number.</para>
+        </summary>
         <returns>
-          <para>Returns a <see cref="T:System.Double" /> as indicated by the following table.</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the values in the following table. </para>
           <list type="table">
             <listheader>
-              <term>Condition</term>
-              <description>Returns</description>
+              <item>
+                <term>
+                  <para>
+                    <paramref name="d" /> parameter </para>
+                </term>
+                <description>
+                  <para>Return value </para>
+                </description>
+              </item>
             </listheader>
             <item>
               <term>
-                <paramref name="d" /> &gt;
-      0.</term>
-              <description>A
-   <see cref="T:System.Double" />
-   containing the value of log<sub>10</sub><paramref name="d" />.</description>
+                <para>Positive </para>
+              </term>
+              <description>
+                <para>The base 10 log of <paramref name="d" />; that is, log <subscript>10</subscript> <paramref name="d" />. </para>
+              </description>
             </item>
             <item>
               <term>
-                <paramref name="d" /> == 0.</term>
+                <para>Zero </para>
+              </term>
               <description>
-                <see cref="F:System.Double.NegativeInfinity" />.</description>
+                <para>
+                  <see cref="F:System.Double.NegativeInfinity" /> </para>
+              </description>
             </item>
             <item>
               <term>
-                <para>
-                  <paramref name="d " /> &lt;
-      0. </para>
-                <para>-or-</para>
-                <para>
-                  <paramref name="d " />is equal to <see cref="F:System.Double.NegativeInfinity" />.</para>
-                <para>-or-</para>
-                <para>
-                  <paramref name="d " />is equal to <see cref="F:System.Double.NaN" />.</para>
+                <para>Negative </para>
               </term>
               <description>
-                <see cref="F:System.Double.NaN" />.</description>
+                <para>
+                  <see cref="F:System.Double.NaN" /> </para>
+              </description>
             </item>
             <item>
               <term>
+                <para>Equal to <see cref="F:System.Double.NaN" /></para>
+              </term>
+              <description>
                 <para>
-                  <paramref name="d" /> is equal to
-   <see cref="F:System.Double.PositiveInfinity" />.
-      </para>
+                  <see cref="F:System.Double.NaN" />
+                </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Equal to <see cref="F:System.Double.PositiveInfinity" /></para>
               </term>
               <description>
-                <see cref="F:System.Double.PositiveInfinity" />.</description>
+                <para>
+                  <see cref="F:System.Double.PositiveInfinity" />
+                </para>
+              </description>
             </item>
           </list>
         </returns>
-        <remarks>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Parameter <paramref name="d" /> is specified as a base 10 number.</para>
-        </remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Returns the base 10 logarithm of a specified number.</para>
-        </summary>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />A number whose logarithm is to be found. </param>
       </Docs>
@@ -1404,17 +1438,15 @@ is equal to <see cref="F:System.Double.PositiveInfinity" />.</term>
         <Parameter Name="val2" Type="System.Byte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Byte" /> that 
-   is equal to <paramref name="val1 " />if <paramref name="val1" /> is greater than or equal to <paramref name="val2" />; otherwise, the return value
-   is equal
-   to <paramref name="val2" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the larger of two 8-bit unsigned integers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Parameter <paramref name="val1" /> or <paramref name="val2" />, whichever is larger.</para>
+        </returns>
         <param name="val1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first of two 8-bit unsigned integers to compare. </param>
         <param name="val2">
@@ -1445,15 +1477,15 @@ is equal to <see cref="F:System.Double.PositiveInfinity" />.</term>
         <Parameter Name="val2" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Decimal" /> that is equal to <paramref name="val1 " />if <paramref name="val1" /> is greater than or 
-   equal to <paramref name="val2" />; otherwise, the return value is equal to <paramref name="val2" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the larger of two decimal numbers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Parameter <paramref name="val1" /> or <paramref name="val2" />, whichever is larger.</para>
+        </returns>
         <param name="val1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first of two decimal numbers to compare. </param>
         <param name="val2">
@@ -1484,16 +1516,15 @@ is equal to <see cref="F:System.Double.PositiveInfinity" />.</term>
         <Parameter Name="val2" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Double" /> equal to <paramref name="val1" /> if <paramref name="val1" /> is greater than or equal to
-<paramref name="val2" />; otherwise, the return value is equal to <paramref name="val2" />. If <paramref name="val1" /> , <paramref name="val2" />, or both 
-   are equal to <see cref="F:System.Double.NaN" /> , <see cref="F:System.Double.NaN" /> is returned.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the larger of two double-precision floating-point numbers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Parameter <paramref name="val1" /> or <paramref name="val2" />, whichever is larger. If <paramref name="val1" />, <paramref name="val2" />, or both <paramref name="val1" /> and <paramref name="val2" /> are equal to <see cref="F:System.Double.NaN" />, <see cref="F:System.Double.NaN" /> is returned.</para>
+        </returns>
         <param name="val1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first of two double-precision floating-point numbers to compare. </param>
         <param name="val2">
@@ -1524,11 +1555,6 @@ is equal to <see cref="F:System.Double.PositiveInfinity" />.</term>
         <Parameter Name="val2" Type="System.Int16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int16" /> that 
-   is equal to <paramref name="val1 " />if <paramref name="val1" /> is greater than or equal to <paramref name="val2" />; otherwise, the return value is equal
-   to <paramref name="val2" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <param name="val1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first of two 16-bit signed integers to compare. </param>
@@ -1538,6 +1564,10 @@ is equal to <see cref="F:System.Double.PositiveInfinity" />.</term>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the larger of two 16-bit signed integers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Parameter <paramref name="val1" /> or <paramref name="val2" />, whichever is larger.</para>
+        </returns>
         <param name="val1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first of two 16-bit signed integers to compare. </param>
         <param name="val2">
@@ -1568,16 +1598,15 @@ is equal to <see cref="F:System.Double.PositiveInfinity" />.</term>
         <Parameter Name="val2" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> that 
-   is equal to <paramref name="val1 " />if <paramref name="val1" /> is greater than or equal to <paramref name="val2" />; otherwise, the return value is equal
-   to <paramref name="val2" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the larger of two 32-bit signed integers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Parameter <paramref name="val1" /> or <paramref name="val2" />, whichever is larger.</para>
+        </returns>
         <param name="val1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first of two 32-bit signed integers to compare. </param>
         <param name="val2">
@@ -1608,16 +1637,15 @@ is equal to <see cref="F:System.Double.PositiveInfinity" />.</term>
         <Parameter Name="val2" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int64" /> that 
-   is equal to <paramref name="val1 " />if <paramref name="val1" /> is greater than or equal to <paramref name="val2" />; otherwise, the return value is equal
-   to <paramref name="val2" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the larger of two 64-bit signed integers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Parameter <paramref name="val1" /> or <paramref name="val2" />, whichever is larger.</para>
+        </returns>
         <param name="val1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first of two 64-bit signed integers to compare. </param>
         <param name="val2">
@@ -1651,12 +1679,6 @@ is equal to <see cref="F:System.Double.PositiveInfinity" />.</term>
         <Parameter Name="val2" Type="System.SByte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.SByte" /> that
-   is equal to <paramref name="val1 " />if <paramref name="val1" /> is greater than or equal to <paramref name="val2" />; otherwise, the return value
-   is equal
-   to <paramref name="val2" />.</para>
-        </returns>
         <remarks>
           <para>This method is not CLS-compliant. For a CLS-compliant
       alternative, use <see cref="M:System.Math.Max(System.SByte,System.SByte)" />(<see cref="T:System.Int16" />, <see cref="T:System.Int16" />).</para>
@@ -1665,6 +1687,10 @@ is equal to <see cref="F:System.Double.PositiveInfinity" />.</term>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the larger of two 8-bit signed integers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Parameter <paramref name="val1" /> or <paramref name="val2" />, whichever is larger.</para>
+        </returns>
         <param name="val1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first of two 8-bit signed integers to compare. </param>
         <param name="val2">
@@ -1695,18 +1721,15 @@ is equal to <see cref="F:System.Double.PositiveInfinity" />.</term>
         <Parameter Name="val2" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Single" />
-equal to <paramref name="val1" /> if <paramref name="val1" /> is greater than or equal to
-<paramref name="val2" />; otherwise, the return value is equal to <paramref name="val2" />. If <paramref name="val1" />, <paramref name="val2" />, or 
-both are equal to <see cref="F:System.Single.NaN" />, <see cref="F:System.Single.NaN" /> is
-returned.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the larger of two single-precision floating-point numbers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Parameter <paramref name="val1" /> or <paramref name="val2" />, whichever is larger. If <paramref name="val1" />, or <paramref name="val2" />, or both <paramref name="val1" /> and <paramref name="val2" /> are equal to <see cref="F:System.Single.NaN" />, <see cref="F:System.Single.NaN" /> is returned.</para>
+        </returns>
         <param name="val1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first of two single-precision floating-point numbers to compare. </param>
         <param name="val2">
@@ -1740,11 +1763,6 @@ returned.</para>
         <Parameter Name="val2" Type="System.UInt16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.UInt16" /> that
-   is equal to <paramref name="val1 " />if <paramref name="val1" /> is greater than or equal to <paramref name="val2" />; otherwise, the return value is equal
-   to <paramref name="val2" />.</para>
-        </returns>
         <remarks>
           <para>This method is not CLS-compliant. For a CLS-compliant
       alternative, use <see cref="M:System.Math.Max(System.SByte,System.SByte)" />(<see cref="T:System.Int32" />, <see cref="T:System.Int32" />).</para>
@@ -1753,6 +1771,10 @@ returned.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the larger of two 16-bit unsigned integers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Parameter <paramref name="val1" /> or <paramref name="val2" />, whichever is larger.</para>
+        </returns>
         <param name="val1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first of two 16-bit unsigned integers to compare. </param>
         <param name="val2">
@@ -1786,11 +1808,6 @@ returned.</para>
         <Parameter Name="val2" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.UInt32" /> that
-   is equal to <paramref name="val1 " />if <paramref name="val1" /> is greater than or equal to <paramref name="val2" />; otherwise, the return value is equal
-   to <paramref name="val2" />.</para>
-        </returns>
         <remarks>
           <para>This method is not CLS-compliant. For a CLS-compliant
       alternative, use <see cref="M:System.Math.Max(System.SByte,System.SByte)" />(<see cref="T:System.Int64" />, <see cref="T:System.Int64" />).</para>
@@ -1799,6 +1816,10 @@ returned.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the larger of two 32-bit unsigned integers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Parameter <paramref name="val1" /> or <paramref name="val2" />, whichever is larger.</para>
+        </returns>
         <param name="val1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first of two 32-bit unsigned integers to compare. </param>
         <param name="val2">
@@ -1832,11 +1853,6 @@ returned.</para>
         <Parameter Name="val2" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>
-   A <see cref="T:System.UInt64" />
-   equal to <paramref name="val1" /> if <paramref name="val1" /> is greater than or equal to
-<paramref name="val2" />; otherwise, the return value is equal to <paramref name="val2" />.
-</returns>
         <remarks>
           <para>This method is not CLS-compliant. For a CLS-compliant alternative, use
    <see cref="M:System.Math.Max(System.SByte,System.SByte)" />(<see cref="T:System.Decimal" />, <see cref="T:System.Decimal" />).</para>
@@ -1845,6 +1861,10 @@ returned.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the larger of two 64-bit unsigned integers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Parameter <paramref name="val1" /> or <paramref name="val2" />, whichever is larger.</para>
+        </returns>
         <param name="val1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first of two 64-bit unsigned integers to compare. </param>
         <param name="val2">
@@ -1875,17 +1895,15 @@ returned.</para>
         <Parameter Name="val2" Type="System.Byte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Byte" /> equal
-   to
-<paramref name="val1" /> if <paramref name="val1" /> is less than or equal
-   to <paramref name="val2" />; otherwise, the return value is equal to <paramref name="val2" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the smaller of two 8-bit unsigned integers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Parameter <paramref name="val1" /> or <paramref name="val2" />, whichever is smaller.</para>
+        </returns>
         <param name="val1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first of two 8-bit unsigned integers to compare. </param>
         <param name="val2">
@@ -1916,15 +1934,15 @@ returned.</para>
         <Parameter Name="val2" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Decimal" /> equal to <paramref name="val1" /> if <paramref name="val1" /> is less than or equal to <paramref name="val2" />; otherwise, the return value is equal to
-<paramref name="val2" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the smaller of two decimal numbers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Parameter <paramref name="val1" /> or <paramref name="val2" />, whichever is smaller.</para>
+        </returns>
         <param name="val1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first of two decimal numbers to compare. </param>
         <param name="val2">
@@ -1955,19 +1973,15 @@ returned.</para>
         <Parameter Name="val2" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Double" />
-equal to <paramref name="val1" /> if <paramref name="val1" /> is less than or equal to
-<paramref name="val2" />; otherwise, the return value is equal to <paramref name="val2" />. If <paramref name="val1" />, 
-<paramref name="val2" />, or both 
-are equal to <see cref="F:System.Double.NaN" />, <see cref="F:System.Double.NaN" /> is
-returned.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the smaller of two double-precision floating-point numbers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Parameter <paramref name="val1" /> or <paramref name="val2" />, whichever is smaller. If <paramref name="val1" />, <paramref name="val2" />, or both <paramref name="val1" /> and <paramref name="val2" /> are equal to <see cref="F:System.Double.NaN" />, <see cref="F:System.Double.NaN" /> is returned.</para>
+        </returns>
         <param name="val1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first of two double-precision floating-point numbers to compare. </param>
         <param name="val2">
@@ -1998,16 +2012,15 @@ returned.</para>
         <Parameter Name="val2" Type="System.Int16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int16" /> that 
-   is equal to <paramref name="val1 " />if <paramref name="val1" /> is less than or equal to <paramref name="val2" />; otherwise, the return value is equal
-   to <paramref name="val2" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the smaller of two 16-bit signed integers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Parameter <paramref name="val1" /> or <paramref name="val2" />, whichever is smaller.</para>
+        </returns>
         <param name="val1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first of two 16-bit signed integers to compare. </param>
         <param name="val2">
@@ -2038,15 +2051,15 @@ returned.</para>
         <Parameter Name="val2" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> 
-equal to <paramref name="val1" /> if <paramref name="val1" /> is less than or equal to <paramref name="val2" />; otherwise, the return value is equal to <paramref name="val2" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the smaller of two 32-bit signed integers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Parameter <paramref name="val1" /> or <paramref name="val2" />, whichever is smaller.</para>
+        </returns>
         <param name="val1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first of two 32-bit signed integers to compare. </param>
         <param name="val2">
@@ -2077,15 +2090,15 @@ equal to <paramref name="val1" /> if <paramref name="val1" /> is less than or eq
         <Parameter Name="val2" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int64" /> 
-equal to <paramref name="val1" /> if <paramref name="val1" /> is less than or equal to <paramref name="val2" />; otherwise, the return value is equal to <paramref name="val2" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the smaller of two 64-bit signed integers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Parameter <paramref name="val1" /> or <paramref name="val2" />, whichever is smaller.</para>
+        </returns>
         <param name="val1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first of two 64-bit signed integers to compare. </param>
         <param name="val2">
@@ -2119,10 +2132,6 @@ equal to <paramref name="val1" /> if <paramref name="val1" /> is less than or eq
         <Parameter Name="val2" Type="System.SByte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.SByte" />
-equal to <paramref name="val1" /> if <paramref name="val1" /> is less than or equal to <paramref name="val2" />; otherwise, the return value is equal to <paramref name="val2" />.</para>
-        </returns>
         <remarks>
           <para>This method is not CLS-compliant. For a CLS-compliant
       alternative, use <see cref="M:System.Math.Min(System.SByte,System.SByte)" />(<see cref="T:System.Int16" />, <see cref="T:System.Int16" />).</para>
@@ -2131,6 +2140,10 @@ equal to <paramref name="val1" /> if <paramref name="val1" /> is less than or eq
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the smaller of two 8-bit signed integers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Parameter <paramref name="val1" /> or <paramref name="val2" />, whichever is smaller.</para>
+        </returns>
         <param name="val1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first of two 8-bit signed integers to compare. </param>
         <param name="val2">
@@ -2161,18 +2174,15 @@ equal to <paramref name="val1" /> if <paramref name="val1" /> is less than or eq
         <Parameter Name="val2" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Single" />
-equal to <paramref name="val1" /> if <paramref name="val1" /> is less than or equal to
-<paramref name="val2" />; otherwise, the return value is equal to <paramref name="val2" />. If <paramref name="val1" />, <paramref name="val2" />, or both 
-are equal to <see cref="F:System.Single.NaN" />, <see cref="F:System.Single.NaN" /> is
-returned.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the smaller of two single-precision floating-point numbers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Parameter <paramref name="val1" /> or <paramref name="val2" />, whichever is smaller. If <paramref name="val1" />, <paramref name="val2" />, or both <paramref name="val1" /> and <paramref name="val2" /> are equal to <see cref="F:System.Single.NaN" />, <see cref="F:System.Single.NaN" /> is returned.</para>
+        </returns>
         <param name="val1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first of two single-precision floating-point numbers to compare. </param>
         <param name="val2">
@@ -2206,10 +2216,6 @@ returned.</para>
         <Parameter Name="val2" Type="System.UInt16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.UInt16" /> equal to <paramref name="val1" /> if <paramref name="val1" /> is less
-   than or equal to <paramref name="val2" />; otherwise, the return value is equal to <paramref name="val2" /> .</para>
-        </returns>
         <remarks>
           <para>This method is not CLS-compliant. For a CLS-compliant
       alternative, use <see cref="M:System.Math.Min(System.SByte,System.SByte)" />(<see cref="T:System.Int32" />, <see cref="T:System.Int32" />).</para>
@@ -2218,6 +2224,10 @@ returned.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the smaller of two 16-bit unsigned integers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Parameter <paramref name="val1" /> or <paramref name="val2" />, whichever is smaller.</para>
+        </returns>
         <param name="val1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first of two 16-bit unsigned integers to compare. </param>
         <param name="val2">
@@ -2251,10 +2261,6 @@ returned.</para>
         <Parameter Name="val2" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.UInt32" />
-equal to <paramref name="val1" /> if <paramref name="val1" /> is less than or equal to <paramref name="val2" />; otherwise, the return value is equal to <paramref name="val2" />.</para>
-        </returns>
         <remarks>
           <para>This method is not CLS-compliant. For a CLS-compliant
       alternative, use <see cref="M:System.Math.Min(System.SByte,System.SByte)" />(<see cref="T:System.Int64" />, <see cref="T:System.Int64" />).</para>
@@ -2263,6 +2269,10 @@ equal to <paramref name="val1" /> if <paramref name="val1" /> is less than or eq
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the smaller of two 32-bit unsigned integers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Parameter <paramref name="val1" /> or <paramref name="val2" />, whichever is smaller.</para>
+        </returns>
         <param name="val1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first of two 32-bit unsigned integers to compare. </param>
         <param name="val2">
@@ -2296,10 +2306,6 @@ equal to <paramref name="val1" /> if <paramref name="val1" /> is less than or eq
         <Parameter Name="val2" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.UInt64" />
-equal to <paramref name="val1" /> if <paramref name="val1" /> is less than or equal to <paramref name="val2" />; otherwise, the return value is equal to <paramref name="val2" />.</para>
-        </returns>
         <remarks>
           <para>This method is not CLS-compliant. For a CLS-compliant
       alternative, use <see cref="M:System.Math.Min(System.SByte,System.SByte)" />(<see cref="T:System.Decimal" />, <see cref="T:System.Decimal" />).</para>
@@ -2308,6 +2314,10 @@ equal to <paramref name="val1" /> if <paramref name="val1" /> is less than or eq
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the smaller of two 64-bit unsigned integers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Parameter <paramref name="val1" /> or <paramref name="val2" />, whichever is smaller.</para>
+        </returns>
         <param name="val1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first of two 64-bit unsigned integers to compare. </param>
         <param name="val2">
@@ -2360,143 +2370,6 @@ equal to <paramref name="val1" /> if <paramref name="val1" /> is less than or eq
         <Parameter Name="y" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Double" /> equal to <paramref name="x" /> raised to the power <paramref name="y" />.
-   The following table specifies the results if <paramref name="x" /> or <paramref name="y" />
-   is equal to <see cref="F:System.Double.NaN" />, <see cref="F:System.Double.NegativeInfinity" />, or <see cref="F:System.Double.PositiveInfinity" />.</para>
-          <list type="table">
-            <listheader>
-              <term>Parameter Values</term>
-              <description>Returns</description>
-            </listheader>
-            <item>
-              <term>
-                <paramref name="x" /> or <paramref name="y" /> == NaN
-   </term>
-              <description>
-                <see cref="F:System.Double.NaN" />
-              </description>
-            </item>
-            <item>
-              <term>
-                <paramref name="x" /> == any value except NaN, <paramref name="y" /> == 0
-   </term>
-              <description>1</description>
-            </item>
-            <item>
-              <term>
-                <paramref name="x" /> == -infinity, <paramref name="y" /> &lt; 0
-   </term>
-              <description>0</description>
-            </item>
-            <item>
-              <term>
-                <paramref name="x" /> == -infinity, <paramref name="y" /> is a positive odd integer
-   </term>
-              <description>
-                <see cref="F:System.Double.NegativeInfinity" />
-              </description>
-            </item>
-            <item>
-              <term>
-                <paramref name="x" /> == -infinity, <paramref name="y" /> is not 0 or a positive odd integer
-   </term>
-              <description>
-                <see cref="F:System.Double.PositiveInfinity" />
-              </description>
-            </item>
-            <item>
-              <term>
-                <paramref name="x" /> &lt; 0, (-1 &lt; <paramref name="y" /> &lt; 0) or (0 &lt; <paramref name="y" /> &lt; 1) </term>
-              <description>
-                <see cref="F:System.Double.NaN" />
-              </description>
-            </item>
-            <item>
-              <term>
-                <paramref name="x" /> &lt; -1, <paramref name="y" /> == -infinity   </term>
-              <description>0</description>
-            </item>
-            <item>
-              <term>
-                <paramref name="x" /> &lt; -1, <paramref name="y" /> == +infinity   </term>
-              <description>
-                <see cref="F:System.Double.PositiveInfinity" />
-              </description>
-            </item>
-            <item>
-              <term>
-                <paramref name="x" /> == -1, <paramref name="y" /> == -infinity or +infinity </term>
-              <description>
-                <see cref="F:System.Double.NaN" />
-              </description>
-            </item>
-            <item>
-              <term>(-1 &lt; <paramref name="x" /> &lt;= 0), <paramref name="y" /> == -infinity   </term>
-              <description>
-                <see cref="F:System.Double.PositiveInfinity" />
-              </description>
-            </item>
-            <item>
-              <term>(-1 &lt; <paramref name="x" /> &lt;= 0), <paramref name="y" /> == +infinity   </term>
-              <description>0</description>
-            </item>
-            <item>
-              <term>
-                <paramref name="x" /> == 0, <paramref name="y" /> &lt; 0
-   </term>
-              <description>
-                <see cref="F:System.Double.PositiveInfinity" />
-              </description>
-            </item>
-            <item>
-              <term>
-                <paramref name="x" /> == 0, <paramref name="y" /> &gt; 0
-   </term>
-              <description>0</description>
-            </item>
-            <item>
-              <term>(0 &lt; <paramref name="x" /> &lt; 1), <paramref name="y" /> == -infinity   </term>
-              <description>
-                <see cref="F:System.Double.PositiveInfinity" />
-              </description>
-            </item>
-            <item>
-              <term>(0 &lt; <paramref name="x" /> &lt; 1), <paramref name="y" /> == +infinity   </term>
-              <description>0</description>
-            </item>
-            <item>
-              <term>
-                <paramref name="x" /> == 1 <paramref name="y" /> == any value except NaN 
-   </term>
-              <description>1</description>
-            </item>
-            <item>
-              <term>
-                <paramref name="x" /> &gt; 1, <paramref name="y" /> == -infinity   </term>
-              <description>0</description>
-            </item>
-            <item>
-              <term>
-                <paramref name="x" /> &gt; 1, <paramref name="y" /> == +infinity   </term>
-              <description>
-                <see cref="F:System.Double.PositiveInfinity" />
-              </description>
-            </item>
-            <item>
-              <term>
-                <paramref name="x" /> == +infinity <paramref name="y" />   &lt; 0</term>
-              <description>0</description>
-            </item>
-            <item>
-              <term>
-                <paramref name="x" /> == +infinity <paramref name="y" />   &gt; 0</term>
-              <description>
-                <see cref="F:System.Double.PositiveInfinity" />
-              </description>
-            </item>
-          </list>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following table indicates the return value when various values or ranges of values are specified for the <paramref name="x" /> and <paramref name="y" /> parameters. For more information, see <see cref="F:System.Double.PositiveInfinity" />, <see cref="F:System.Double.NegativeInfinity" />, and <see cref="F:System.Double.NaN" />.</para>
@@ -2659,6 +2532,10 @@ equal to <paramref name="val1" /> if <paramref name="val1" /> is less than or eq
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a specified number raised to the specified power.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number <paramref name="x" /> raised to the power <paramref name="y" />.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A double-precision floating-point number to be raised to a power. </param>
         <param name="y">
@@ -2683,10 +2560,6 @@ equal to <paramref name="val1" /> if <paramref name="val1" /> is less than or eq
         <Parameter Name="d" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Decimal" /> containing the value of the integer nearest <paramref name="d" />. If <paramref name="d" />
-is exactly halfway between two integers, one of which is even and the other odd, then the even integer is returned.</para>
-        </returns>
         <example>
           <para>The following example demonstrates using the <see cref="M:System.Math.Round(System.Double)" />(<see cref="T:System.Decimal" />) method.</para>
           <code lang="C#">using System;
@@ -2725,6 +2598,10 @@ public class MathRoundExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Rounds a decimal value to the nearest integral value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The integer nearest parameter <paramref name="d" />. If the fractional component of <paramref name="d" /> is halfway between two integers, one of which is even and the other odd, the even number is returned. Note that this method returns a <see cref="T:System.Decimal" /> instead of an integral type.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />A decimal number to be rounded. </param>
       </Docs>
@@ -2747,10 +2624,6 @@ public class MathRoundExample
         <Parameter Name="a" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Double" /> containing the value of the integer nearest <paramref name="a" />.
-   If <paramref name="a" /> is exactly halfway between two integers, one of which is even and the other odd, then the even integer is returned.</para>
-        </returns>
         <example>
           <para>The following example demonstrates using the <see cref="M:System.Math.Round(System.Double)" />(<see cref="T:System.Double" />) method.</para>
           <code lang="C#">using System;
@@ -2789,6 +2662,10 @@ public class MathRoundExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Rounds a double-precision floating-point value to the nearest integral value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The integer nearest <paramref name="a" />. If the fractional component of <paramref name="a" /> is halfway between two integers, one of which is even and the other odd, then the even number is returned. Note that this method returns a <see cref="T:System.Double" /> instead of an integral type.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />A double-precision floating-point number to be rounded. </param>
       </Docs>
@@ -2811,7 +2688,6 @@ public class MathRoundExample
         <Parameter Name="decimals" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -2822,6 +2698,10 @@ public class MathRoundExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Rounds a decimal value to a specified number of fractional digits.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number nearest to <paramref name="d" /> that contains a number of fractional digits equal to <paramref name="decimals" />. </para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />A decimal number to be rounded. </param>
         <param name="decimals">
@@ -2844,7 +2724,6 @@ public class MathRoundExample
         <Parameter Name="mode" Type="System.MidpointRounding" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2856,6 +2735,10 @@ public class MathRoundExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Rounds a decimal value to the nearest integer. A parameter specifies how to round the value if it is midway between two numbers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The integer nearest <paramref name="d" />. If <paramref name="d" /> is halfway between two numbers, one of which is even and the other odd, then <paramref name="mode" /> determines which of the two is returned. </para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />A decimal number to be rounded. </param>
         <param name="mode">
@@ -2880,19 +2763,6 @@ public class MathRoundExample
         <Parameter Name="digits" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Double" /> containing the value of the number
-   nearest <paramref name="value" /> with a precision
-   equal to <paramref name="digits" /> . If the digit
-   in <paramref name="value" /> that is in the 10<sup>-(<paramref name="digits " /> + 1)</sup> place is equal
-to 5 and there are no non-zero numbers in any less significant place, then the
-digit in the 10<sup>-<paramref name="digits" /></sup> place will be unchanged if it is even, else it
-will be set to the closest even integer value in the direction of the digit in
-the 10<sup>-(<paramref name="digits" /> + 1)</sup> place. If the precision of <paramref name="value" /> is less
-than <paramref name="digits" />, then <paramref name="value" /> is returned unchanged. If
-<paramref name="digits" /> is zero, this method behaves in the same manner as <see cref="M:System.Math.Round(System.Double)" /> 
-(<paramref name="value" /> ).</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="digits" /> &lt; 0</para>
@@ -2940,6 +2810,10 @@ public class MathRoundExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Rounds a double-precision floating-point value to a specified number of fractional digits.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number nearest to <paramref name="value" /> that contains a number of fractional digits equal to <paramref name="digits" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A double-precision floating-point number to be rounded. </param>
         <param name="digits">
@@ -2963,7 +2837,6 @@ public class MathRoundExample
         <Parameter Name="mode" Type="System.MidpointRounding" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2975,6 +2848,10 @@ public class MathRoundExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Rounds a double-precision floating-point value to the nearest integer. A parameter specifies how to round the value if it is midway between two numbers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The integer nearest <paramref name="value" />. If <paramref name="value" /> is halfway between two integers, one of which is even and the other odd, then <paramref name="mode" /> determines which of the two is returned.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A double-precision floating-point number to be rounded. </param>
         <param name="mode">
@@ -2998,7 +2875,6 @@ public class MathRoundExample
         <Parameter Name="mode" Type="System.MidpointRounding" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3010,6 +2886,10 @@ public class MathRoundExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Rounds a decimal value to a specified number of fractional digits. A parameter specifies how to round the value if it is midway between two numbers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number nearest to <paramref name="d" /> that contains a number of fractional digits equal to <paramref name="decimals" />. If <paramref name="d" /> has fewer fractional digits than <paramref name="decimals" />, <paramref name="d" /> is returned unchanged.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />A decimal number to be rounded. </param>
         <param name="decimals">
@@ -3035,7 +2915,6 @@ public class MathRoundExample
         <Parameter Name="mode" Type="System.MidpointRounding" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3047,6 +2926,10 @@ public class MathRoundExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Rounds a double-precision floating-point value to a specified number of fractional digits. A parameter specifies how to round the value if it is midway between two numbers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The number nearest to <paramref name="value" /> that has a number of fractional digits equal to <paramref name="digits" />. If <paramref name="value" /> has fewer fractional digits than <paramref name="digits" />, <paramref name="value" /> is returned unchanged.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A double-precision floating-point number to be rounded. </param>
         <param name="digits">
@@ -3072,36 +2955,54 @@ public class MathRoundExample
         <Parameter Name="value" Type="System.Decimal" />
       </Parameters>
       <Docs>
+        <remarks>To be added.</remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a value indicating the sign of a decimal number.</para>
+        </summary>
         <returns>
-          <para>A <see cref="T:System.Int32" /> indicating the sign of <paramref name="value" />.</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A number that indicates the sign of <paramref name="value" />, as shown in the following table.</para>
           <list type="table">
             <listheader>
-              <term>Number</term>
-              <description>Description</description>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Meaning </para>
+                </description>
+              </item>
             </listheader>
             <item>
-              <term> -1</term>
+              <term>
+                <para>-1 </para>
+              </term>
               <description>
-                <paramref name="value" /> &lt;
-      0.</description>
+                <para>
+                  <paramref name="value" /> is less than zero. </para>
+              </description>
             </item>
             <item>
-              <term> 0</term>
+              <term>
+                <para>0 </para>
+              </term>
               <description>
-                <paramref name="value" /> == 0.</description>
+                <para>
+                  <paramref name="value" /> is equal to zero. </para>
+              </description>
             </item>
             <item>
-              <term> 1</term>
+              <term>
+                <para>1 </para>
+              </term>
               <description>
-                <paramref name="value" /> &gt; 0.</description>
+                <para>
+                  <paramref name="value" /> is greater than zero. </para>
+              </description>
             </item>
           </list>
         </returns>
-        <remarks>To be added.</remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Returns a value indicating the sign of a decimal number.</para>
-        </summary>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A signed decimal number. </param>
       </Docs>
@@ -3124,32 +3025,6 @@ public class MathRoundExample
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" />
-indicating the sign of <paramref name="value" />.</para>
-          <list type="table">
-            <listheader>
-              <term>Number</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> -1</term>
-              <description>
-                <paramref name="value" /> &lt;
-      0.</description>
-            </item>
-            <item>
-              <term> 0</term>
-              <description>
-                <paramref name="value" /> == 0.</description>
-            </item>
-            <item>
-              <term> 1</term>
-              <description>
-                <paramref name="value" /> &gt; 0.</description>
-            </item>
-          </list>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArithmeticException">
           <paramref name="value " />is equal to <see cref="F:System.Double.NaN" />.</exception>
@@ -3185,6 +3060,49 @@ public class MathSignExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating the sign of a double-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A number that indicates the sign of <paramref name="value" />, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Meaning </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>-1 </para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="value" /> is less than zero. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>0 </para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="value" /> is equal to zero. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>1 </para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="value" /> is greater than zero. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A signed number. </param>
       </Docs>
@@ -3207,36 +3125,54 @@ public class MathSignExample
         <Parameter Name="value" Type="System.Int16" />
       </Parameters>
       <Docs>
+        <remarks>To be added.</remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a value indicating the sign of a 16-bit signed integer.</para>
+        </summary>
         <returns>
-          <para>A <see cref="T:System.Int32" /> indicating the sign of <paramref name="value" />.</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A number that indicates the sign of <paramref name="value" />, as shown in the following table.</para>
           <list type="table">
             <listheader>
-              <term>Number</term>
-              <description>Description</description>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Meaning </para>
+                </description>
+              </item>
             </listheader>
             <item>
-              <term> -1</term>
+              <term>
+                <para>-1 </para>
+              </term>
               <description>
-                <paramref name="value" /> &lt;
-      0.</description>
+                <para>
+                  <paramref name="value" /> is less than zero. </para>
+              </description>
             </item>
             <item>
-              <term> 0</term>
+              <term>
+                <para>0 </para>
+              </term>
               <description>
-                <paramref name="value" /> == 0.</description>
+                <para>
+                  <paramref name="value" /> is equal to zero. </para>
+              </description>
             </item>
             <item>
-              <term> 1</term>
+              <term>
+                <para>1 </para>
+              </term>
               <description>
-                <paramref name="value" /> &gt; 0.</description>
+                <para>
+                  <paramref name="value" /> is greater than zero. </para>
+              </description>
             </item>
           </list>
         </returns>
-        <remarks>To be added.</remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Returns a value indicating the sign of a 16-bit signed integer.</para>
-        </summary>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A signed number. </param>
       </Docs>
@@ -3259,36 +3195,54 @@ public class MathSignExample
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
+        <remarks>To be added.</remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a value indicating the sign of a 32-bit signed integer.</para>
+        </summary>
         <returns>
-          <para>A <see cref="T:System.Int32" /> indicating the sign of <paramref name="value" />.</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A number that indicates the sign of <paramref name="value" />, as shown in the following table.</para>
           <list type="table">
             <listheader>
-              <term>Number</term>
-              <description>Description</description>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Meaning </para>
+                </description>
+              </item>
             </listheader>
             <item>
-              <term> -1</term>
+              <term>
+                <para>-1 </para>
+              </term>
               <description>
-                <paramref name="value" /> &lt;
-      0.</description>
+                <para>
+                  <paramref name="value" /> is less than zero. </para>
+              </description>
             </item>
             <item>
-              <term> 0</term>
+              <term>
+                <para>0 </para>
+              </term>
               <description>
-                <paramref name="value" /> == 0.</description>
+                <para>
+                  <paramref name="value" /> is equal to zero. </para>
+              </description>
             </item>
             <item>
-              <term> 1</term>
+              <term>
+                <para>1 </para>
+              </term>
               <description>
-                <paramref name="value" /> &gt; 0.</description>
+                <para>
+                  <paramref name="value" /> is greater than zero. </para>
+              </description>
             </item>
           </list>
         </returns>
-        <remarks>To be added.</remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Returns a value indicating the sign of a 32-bit signed integer.</para>
-        </summary>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A signed number. </param>
       </Docs>
@@ -3311,36 +3265,54 @@ public class MathSignExample
         <Parameter Name="value" Type="System.Int64" />
       </Parameters>
       <Docs>
+        <remarks>To be added.</remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a value indicating the sign of a 64-bit signed integer.</para>
+        </summary>
         <returns>
-          <para>A <see cref="T:System.Int32" /> indicating the sign of <paramref name="value" />.</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A number that indicates the sign of <paramref name="value" />, as shown in the following table.</para>
           <list type="table">
             <listheader>
-              <term>Number</term>
-              <description>Description</description>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Meaning </para>
+                </description>
+              </item>
             </listheader>
             <item>
-              <term> -1</term>
+              <term>
+                <para>-1 </para>
+              </term>
               <description>
-                <paramref name="value" /> &lt;
-      0.</description>
+                <para>
+                  <paramref name="value" /> is less than zero. </para>
+              </description>
             </item>
             <item>
-              <term> 0</term>
+              <term>
+                <para>0 </para>
+              </term>
               <description>
-                <paramref name="value" /> == 0.</description>
+                <para>
+                  <paramref name="value" /> is equal to zero. </para>
+              </description>
             </item>
             <item>
-              <term> 1</term>
+              <term>
+                <para>1 </para>
+              </term>
               <description>
-                <paramref name="value" /> &gt; 0.</description>
+                <para>
+                  <paramref name="value" /> is greater than zero. </para>
+              </description>
             </item>
           </list>
         </returns>
-        <remarks>To be added.</remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Returns a value indicating the sign of a 64-bit signed integer.</para>
-        </summary>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A signed number. </param>
       </Docs>
@@ -3368,40 +3340,57 @@ public class MathSignExample
         <Parameter Name="value" Type="System.SByte" />
       </Parameters>
       <Docs>
+        <remarks>
+          <para>This method is not CLS-compliant. For a CLS-compliant alternative, use
+   <see cref="M:System.Math.Sign(System.SByte)" />(<see cref="T:System.Int16" />).</para>
+        </remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a value indicating the sign of an 8-bit signed integer.</para>
+        </summary>
         <returns>
-          <para>A <see cref="T:System.Int32" /> indicating the
-   sign of <paramref name="value" />.</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A number that indicates the sign of <paramref name="value" />, as shown in the following table.</para>
           <list type="table">
             <listheader>
-              <term>Number</term>
-              <description>Description</description>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Meaning </para>
+                </description>
+              </item>
             </listheader>
             <item>
-              <term> -1</term>
+              <term>
+                <para>-1 </para>
+              </term>
               <description>
-                <paramref name="value" /> &lt;
-      0.</description>
+                <para>
+                  <paramref name="value" /> is less than zero. </para>
+              </description>
             </item>
             <item>
-              <term> 0</term>
+              <term>
+                <para>0 </para>
+              </term>
               <description>
-                <paramref name="value" /> == 0.</description>
+                <para>
+                  <paramref name="value" /> is equal to zero. </para>
+              </description>
             </item>
             <item>
-              <term> 1</term>
+              <term>
+                <para>1 </para>
+              </term>
               <description>
-                <paramref name="value" /> &gt; 0.</description>
+                <para>
+                  <paramref name="value" /> is greater than zero. </para>
+              </description>
             </item>
           </list>
         </returns>
-        <remarks>
-          <para>This method is not CLS-compliant. For a CLS-compliant alternative, use
-   <see cref="M:System.Math.Sign(System.SByte)" />(<see cref="T:System.Int16" />).</para>
-        </remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Returns a value indicating the sign of an 8-bit signed integer.</para>
-        </summary>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A signed number. </param>
       </Docs>
@@ -3424,38 +3413,56 @@ public class MathSignExample
         <Parameter Name="value" Type="System.Single" />
       </Parameters>
       <Docs>
+        <remarks>To be added.</remarks>
+        <exception cref="T:System.ArithmeticException">
+          <paramref name="value" /> is equal to <see cref="F:System.Single.NaN" />.</exception>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Returns a value indicating the sign of a single-precision floating-point number.</para>
+        </summary>
         <returns>
-          <para>A <see cref="T:System.Int32" /> indicating the sign of value.</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A number that indicates the sign of <paramref name="value" />, as shown in the following table.</para>
           <list type="table">
             <listheader>
-              <term>Number</term>
-              <description>Description</description>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Meaning </para>
+                </description>
+              </item>
             </listheader>
             <item>
-              <term> -1</term>
+              <term>
+                <para>-1 </para>
+              </term>
               <description>
-                <paramref name="value" /> &lt;
-      0.</description>
+                <para>
+                  <paramref name="value" /> is less than zero. </para>
+              </description>
             </item>
             <item>
-              <term> 0</term>
+              <term>
+                <para>0 </para>
+              </term>
               <description>
-                <paramref name="value" /> == 0.</description>
+                <para>
+                  <paramref name="value" /> is equal to zero. </para>
+              </description>
             </item>
             <item>
-              <term> 1</term>
+              <term>
+                <para>1 </para>
+              </term>
               <description>
-                <paramref name="value" /> &gt; 0.</description>
+                <para>
+                  <paramref name="value" /> is greater than zero. </para>
+              </description>
             </item>
           </list>
         </returns>
-        <remarks>To be added.</remarks>
-        <exception cref="T:System.ArithmeticException">
-          <paramref name="value" /> is equal to <see cref="F:System.Single.NaN" />.</exception>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Returns a value indicating the sign of a single-precision floating-point number.</para>
-        </summary>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A signed number. </param>
       </Docs>
@@ -3478,11 +3485,6 @@ public class MathSignExample
         <Parameter Name="a" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Double" /> containing the value of the sine of <paramref name="a" />. If
-<paramref name="a" /> is equal to <see cref="F:System.Double.NaN" />, <see cref="F:System.Double.NegativeInfinity" />, or <see cref="F:System.Double.PositiveInfinity" />, 
-   returns <see cref="F:System.Double.NaN" />.</para>
-        </returns>
         <example>
           <para>The following example demonstrates using the <see cref="M:System.Math.Sin(System.Double)" /> method.</para>
           <code lang="C#">using System;
@@ -3517,6 +3519,10 @@ public class MathSinExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the sine of the specified angle.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The sine of <paramref name="a" />. If <paramref name="a" /> is equal to <see cref="F:System.Double.NaN" />, <see cref="F:System.Double.NegativeInfinity" />, or <see cref="F:System.Double.PositiveInfinity" />, this method returns <see cref="F:System.Double.NaN" />.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />An angle, measured in radians. </param>
       </Docs>
@@ -3539,11 +3545,6 @@ public class MathSinExample
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Double" /> containing the value of the hyperbolic sine of
-<paramref name="value" />. If <paramref name="value" /> is equal to <see cref="F:System.Double.NegativeInfinity" />, 
-<see cref="F:System.Double.PositiveInfinity" />, or <see cref="F:System.Double.NaN" />, returns a <see cref="T:System.Double" /> equal to <paramref name="value" />.</para>
-        </returns>
         <example>
           <para>The following example demonstrates using the <see cref="M:System.Math.Sinh(System.Double)" /> method.</para>
           <code lang="C#">using System;
@@ -3577,6 +3578,10 @@ public class MathSinhExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hyperbolic sine of the specified angle.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hyperbolic sine of <paramref name="value" />. If <paramref name="value" /> is equal to <see cref="F:System.Double.NegativeInfinity" />, <see cref="F:System.Double.PositiveInfinity" />, or <see cref="F:System.Double.NaN" />, this method returns a <see cref="T:System.Double" /> equal to <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An angle, measured in radians. </param>
       </Docs>
@@ -3604,47 +3609,6 @@ public class MathSinhExample
         <Parameter Name="d" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Double" /> whose value is indicated as
-   follows:</para>
-          <list type="table">
-            <listheader>
-              <term>Condition</term>
-              <description>Returns</description>
-            </listheader>
-            <item>
-              <term>
-                <paramref name="d" /> &gt;=
-      0</term>
-              <description>A
-   <see cref="T:System.Double" />
-   containing the positive square root of <paramref name="d" />.</description>
-            </item>
-            <item>
-              <term>
-                <para>
-                  <paramref name="d" /> &lt;
-      0</para>
-                <para>
-                  <paramref name="d " />is equal to <see cref="F:System.Double.NegativeInfinity" />.</para>
-                <para>
-                  <paramref name="d " />is equal to <see cref="F:System.Double.NaN" />.</para>
-              </term>
-              <description>
-                <see cref="F:System.Double.NaN" />.</description>
-            </item>
-            <item>
-              <term>
-                <para>
-                  <paramref name="d " />is equal to <see cref="F:System.Double.PositiveInfinity" /></para>
-              </term>
-              <description>
-                <para>
-                  <see cref="F:System.Double.PositiveInfinity" />.</para>
-              </description>
-            </item>
-          </list>
-        </returns>
         <remarks>To be added.</remarks>
         <example>
           <para>The following example demonstrates using the <see cref="M:System.Math.Sqrt(System.Double)" /> method.</para>
@@ -3678,6 +3642,60 @@ public class MathSqrtExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the square root of a specified number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the values in the following table. </para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>
+                    <paramref name="d" /> parameter </para>
+                </term>
+                <description>
+                  <para>Return value </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Zero or positive </para>
+              </term>
+              <description>
+                <para>The positive square root of <paramref name="d" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Negative </para>
+              </term>
+              <description>
+                <para>
+                  <see cref="F:System.Double.NaN" /> </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Equals <see cref="F:System.Double.NaN" /></para>
+              </term>
+              <description>
+                <para>
+                  <see cref="F:System.Double.NaN" />
+                </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Equals <see cref="F:System.Double.PositiveInfinity" /></para>
+              </term>
+              <description>
+                <para>
+                  <see cref="F:System.Double.PositiveInfinity" />
+                </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />The number whose square root is to be found. </param>
       </Docs>
@@ -3700,11 +3718,6 @@ public class MathSqrtExample
         <Parameter Name="a" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Double" /> containing the value of the tangent of <paramref name="a" />. If a
-   is equal to <see cref="F:System.Double.NaN" />, <see cref="F:System.Double.NegativeInfinity" />, or <see cref="F:System.Double.PositiveInfinity" />,
-   returns <see cref="F:System.Double.NaN" />.</para>
-        </returns>
         <example>
           <para>The following example demonstrates using the <see cref="M:System.Math.Tan(System.Double)" /> method.</para>
           <code lang="C#">using System;
@@ -3738,6 +3751,10 @@ public class MathTanExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the tangent of the specified angle.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The tangent of <paramref name="a" />. If <paramref name="a" /> is equal to <see cref="F:System.Double.NaN" />, <see cref="F:System.Double.NegativeInfinity" />, or <see cref="F:System.Double.PositiveInfinity" />, this method returns <see cref="F:System.Double.NaN" />.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />An angle, measured in radians. </param>
       </Docs>
@@ -3760,11 +3777,6 @@ public class MathTanExample
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Double" /> containing the value of the hyperbolic tangent of
-<paramref name="value" />. If <paramref name="value" /> is equal to <see cref="F:System.Double.NegativeInfinity" />, returns -1. If value is equal to <see cref="F:System.Double.PositiveInfinity" />,
-   returns 1. If value is equal to <see cref="F:System.Double.NaN" />, returns <see cref="F:System.Double.NaN" />.</para>
-        </returns>
         <example>
           <para>The following example demonstrates using the <see cref="M:System.Math.Tanh(System.Double)" /> method.</para>
           <code lang="C#">using System;
@@ -3798,6 +3810,10 @@ public class MathTanhExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hyperbolic tangent of the specified angle.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hyperbolic tangent of <paramref name="value" />. If <paramref name="value" /> is equal to <see cref="F:System.Double.NegativeInfinity" />, this method returns -1. If value is equal to <see cref="F:System.Double.PositiveInfinity" />, this method returns 1. If <paramref name="value" /> is equal to <see cref="F:System.Double.NaN" />, this method returns <see cref="F:System.Double.NaN" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An angle, measured in radians. </param>
       </Docs>
@@ -3818,7 +3834,6 @@ public class MathTanhExample
         <Parameter Name="d" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3829,6 +3844,10 @@ public class MathTanhExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the integral part of a specified decimal number. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The integral part of <paramref name="d" />; that is, the number that remains after any fractional digits have been discarded.</para>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />A number to truncate.</param>
       </Docs>
@@ -3848,7 +3867,6 @@ public class MathTanhExample
         <Parameter Name="d" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3859,6 +3877,60 @@ public class MathTanhExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the integral part of a specified double-precision floating-point number. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The integral part of <paramref name="d" />; that is, the number that remains after any fractional digits have been discarded, or one of the values listed in the following table. </para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>
+                    <paramref name="d" />
+                  </para>
+                </term>
+                <description>
+                  <para>Return value</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>
+                  <see cref="F:System.Double.NaN" />
+                </para>
+              </term>
+              <description>
+                <para>
+                  <see cref="F:System.Double.NaN" />
+                </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>
+                  <see cref="F:System.Double.NegativeInfinity" />
+                </para>
+              </term>
+              <description>
+                <para>
+                  <see cref="F:System.Double.NegativeInfinity" />
+                </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>
+                  <see cref="F:System.Double.PositiveInfinity" />
+                </para>
+              </term>
+              <description>
+                <para>
+                  <see cref="F:System.Double.PositiveInfinity" />
+                </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="d">
           <attribution license="cc4" from="Microsoft" modified="false" />A number to truncate.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System/ModuleHandle.xml b/mcs/class/corlib/Documentation/en/System/ModuleHandle.xml
index ef1f408bab2..92570759195 100644
--- a/mcs/class/corlib/Documentation/en/System/ModuleHandle.xml
+++ b/mcs/class/corlib/Documentation/en/System/ModuleHandle.xml
@@ -68,13 +68,16 @@
         <Parameter Name="handle" Type="System.ModuleHandle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Boolean" /> value indicating whether the specified <see cref="T:System.ModuleHandle" /> structure is equal to the current <see cref="T:System.ModuleHandle" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="handle" /> is equal to the current <see cref="T:System.ModuleHandle" /> structure; otherwise false.</para>
+        </returns>
         <param name="handle">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ModuleHandle" /> structure to be compared with the current <see cref="T:System.ModuleHandle" />.</param>
       </Docs>
@@ -99,13 +102,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Boolean" /> value indicating whether the specified object is a <see cref="T:System.ModuleHandle" /> structure, and equal to the current <see cref="T:System.ModuleHandle" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is a <see cref="T:System.ModuleHandle" /> structure, and is equal to the current <see cref="T:System.ModuleHandle" /> structure; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to be compared with the current <see cref="T:System.ModuleHandle" /> structure.</param>
       </Docs>
@@ -144,13 +150,16 @@
         <Parameter Name="fieldToken" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a runtime handle for the field identified by the specified metadata token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.RuntimeFieldHandle" /> for the field identified by <paramref name="fieldToken" />.</para>
+        </returns>
         <param name="fieldToken">
           <attribution license="cc4" from="Microsoft" modified="false" />A metadata token that identifies a field in the module.</param>
       </Docs>
@@ -170,13 +179,16 @@
         <Parameter Name="methodToken" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a runtime method handle for the method or constructor identified by the specified metadata token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.RuntimeMethodHandle" /> for the method or constructor identified by <paramref name="methodToken" />.</para>
+        </returns>
         <param name="methodToken">
           <attribution license="cc4" from="Microsoft" modified="false" />A metadata token that identifies a method or constructor in the module.</param>
       </Docs>
@@ -196,13 +208,16 @@
         <Parameter Name="typeToken" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a runtime type handle for the type identified by the specified metadata token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.RuntimeTypeHandle" /> for the type identified by <paramref name="typeToken" />.</para>
+        </returns>
         <param name="typeToken">
           <attribution license="cc4" from="Microsoft" modified="false" />A metadata token that identifies a type in the module.</param>
       </Docs>
@@ -248,12 +263,15 @@
         <Parameter Name="right" Type="System.ModuleHandle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether two <see cref="T:System.ModuleHandle" /> structures are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ModuleHandle" /> structures are equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ModuleHandle" /> structure to the left of the equality operator.</param>
         <param name="right">
@@ -276,12 +294,15 @@
         <Parameter Name="right" Type="System.ModuleHandle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Tests whether two <see cref="T:System.ModuleHandle" /> structures are unequal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.ModuleHandle" /> structures are unequal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.ModuleHandle" /> structure to the left of the inequality operator.</param>
         <param name="right">
@@ -303,7 +324,6 @@
         <Parameter Name="fieldToken" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -316,6 +336,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a runtime handle for the field identified by the specified metadata token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.RuntimeFieldHandle" /> for the field identified by <paramref name="fieldToken" />.</para>
+        </returns>
         <param name="fieldToken">
           <attribution license="cc4" from="Microsoft" modified="false" />A metadata token that identifies a field in the module.</param>
       </Docs>
@@ -337,7 +361,6 @@
         <Parameter Name="methodInstantiationContext" Type="System.RuntimeTypeHandle[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -348,6 +371,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a runtime field handle for the field identified by the specified metadata token, specifying the generic type arguments of the type and method where the token is in scope.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.RuntimeFieldHandle" /> for the field identified by <paramref name="fieldToken" />.</para>
+        </returns>
         <param name="fieldToken">
           <attribution license="cc4" from="Microsoft" modified="false" />A metadata token that identifies a field in the module.</param>
         <param name="typeInstantiationContext">
@@ -371,7 +398,6 @@
         <Parameter Name="methodToken" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -384,6 +410,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a runtime method handle for the method or constructor identified by the specified metadata token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.RuntimeMethodHandle" /> for the method or constructor identified by <paramref name="methodToken" />.</para>
+        </returns>
         <param name="methodToken">
           <attribution license="cc4" from="Microsoft" modified="false" />A metadata token that identifies a method or constructor in the module.</param>
       </Docs>
@@ -405,7 +435,6 @@
         <Parameter Name="methodInstantiationContext" Type="System.RuntimeTypeHandle[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -416,6 +445,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a runtime method handle for the method or constructor identified by the specified metadata token, specifying the generic type arguments of the type and method where the token is in scope.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.RuntimeMethodHandle" /> for the method or constructor identified by <paramref name="methodToken" />.</para>
+        </returns>
         <param name="methodToken">
           <attribution license="cc4" from="Microsoft" modified="false" />A metadata token that identifies a method or constructor in the module.</param>
         <param name="typeInstantiationContext">
@@ -439,7 +472,6 @@
         <Parameter Name="typeToken" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -452,6 +484,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a runtime type handle for the type identified by the specified metadata token.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.RuntimeTypeHandle" /> for the type identified by <paramref name="typeToken" />.</para>
+        </returns>
         <param name="typeToken">
           <attribution license="cc4" from="Microsoft" modified="false" />A metadata token that identifies a type in the module.</param>
       </Docs>
@@ -473,7 +509,6 @@
         <Parameter Name="methodInstantiationContext" Type="System.RuntimeTypeHandle[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <block subset="none" type="note">
@@ -484,6 +519,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a runtime type handle for the type identified by the specified metadata token, specifying the generic type arguments of the type and method where the token is in scope.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.RuntimeTypeHandle" /> for the type identified by <paramref name="typeToken" />.</para>
+        </returns>
         <param name="typeToken">
           <attribution license="cc4" from="Microsoft" modified="false" />A metadata token that identifies a type in the module.</param>
         <param name="typeInstantiationContext">
diff --git a/mcs/class/corlib/Documentation/en/System/MulticastDelegate.xml b/mcs/class/corlib/Documentation/en/System/MulticastDelegate.xml
index 42460113c64..419d956eb71 100644
--- a/mcs/class/corlib/Documentation/en/System/MulticastDelegate.xml
+++ b/mcs/class/corlib/Documentation/en/System/MulticastDelegate.xml
@@ -111,12 +111,15 @@
         <Parameter Name="follow" Type="System.Delegate" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Combines this <see cref="T:System.Delegate" /> with the specified <see cref="T:System.Delegate" /> to form a new delegate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A delegate that is the new root of the <see cref="T:System.MulticastDelegate" /> invocation list.</para>
+        </returns>
         <param name="follow">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate to combine with this delegate. </param>
       </Docs>
@@ -137,12 +140,15 @@
         <Parameter Name="args" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Processes the full invocation list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains the return value of the encapsulated method.</para>
+        </returns>
         <param name="args">
           <attribution license="cc4" from="Microsoft" modified="false" />The arguments to pass to the encapsulated method. </param>
       </Docs>
@@ -163,7 +169,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Two delegates are equal if they are not null and are of exactly the same type, their invocation lists contain the same number of elements, and every element in the invocation list of the first delegate is equal to the corresponding element in the invocation list of the second delegate.</para>
@@ -173,6 +178,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether this multicast delegate and the specified object are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> and this instance have the same invocation lists; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this instance. </param>
       </Docs>
@@ -191,12 +200,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetInvocationList">
@@ -213,7 +225,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The array contains a set of delegates, each with an invocation list of one entry. Invoking these delegates sequentially, in the order they appear in the array, produces the same results as invoking the current instance.</para>
@@ -222,6 +233,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the invocation list of this multicast delegate, in invocation order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of delegates whose invocation lists collectively match the invocation list of this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetObjectData">
@@ -273,7 +288,6 @@
         <Parameter Name="d2" Type="System.MulticastDelegate" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Two delegates are equal if they are not null and are of exactly the same type, their invocation lists contain the same number of elements, and every element in the invocation list of the first delegate is equal to the corresponding element in the invocation list of the second delegate.</para>
@@ -283,6 +297,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two <see cref="T:System.MulticastDelegate" /> objects are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="d1" /> and <paramref name="d2" /> have the same invocation lists; otherwise, false.</para>
+        </returns>
         <param name="d1">
           <attribution license="cc4" from="Microsoft" modified="false" />The left operand. </param>
         <param name="d2">
@@ -306,7 +324,6 @@
         <Parameter Name="d2" Type="System.MulticastDelegate" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Two delegates are equal if they are not null and are of exactly the same type, their invocation lists contain the same number of elements, and every element in the invocation list of the first delegate is equal to the corresponding element in the invocation list of the second delegate.</para>
@@ -316,6 +333,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two <see cref="T:System.MulticastDelegate" /> objects are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="d1" /> and <paramref name="d2" /> do not have the same invocation lists; otherwise, false.</para>
+        </returns>
         <param name="d1">
           <attribution license="cc4" from="Microsoft" modified="false" />The left operand. </param>
         <param name="d2">
@@ -338,12 +359,15 @@
         <Parameter Name="value" Type="System.Delegate" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes an element from the invocation list of this <see cref="T:System.MulticastDelegate" /> that is equal to the specified delegate.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If <paramref name="value" /> is found in the invocation list for this instance, then a new <see cref="T:System.Delegate" /> without <paramref name="value" /> in its invocation list; otherwise, this instance with its original invocation list.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate to search for in the invocation list. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System/Nullable.xml b/mcs/class/corlib/Documentation/en/System/Nullable.xml
index 426e8462674..71c10b13e99 100644
--- a/mcs/class/corlib/Documentation/en/System/Nullable.xml
+++ b/mcs/class/corlib/Documentation/en/System/Nullable.xml
@@ -59,13 +59,58 @@
         <Parameter Name="n2" Type="System.Nullable&lt;T&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the relative values of two <see cref="T:System.Nullable`1" /> objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that indicates the relative values of the <paramref name="n1" /> and <paramref name="n2" /> parameters.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero</para>
+              </term>
+              <description>
+                <para>The <see cref="P:System.Nullable`1.HasValue" /> property for <paramref name="n1" /> is false, and the <see cref="P:System.Nullable`1.HasValue" /> property for <paramref name="n2" /> is true.</para>
+                <para>-or-</para>
+                <para>The <see cref="P:System.Nullable`1.HasValue" /> properties for <paramref name="n1" /> and <paramref name="n2" /> are true, and the value of the <see cref="P:System.Nullable`1.Value" /> property for <paramref name="n1" /> is less than the value of the <see cref="P:System.Nullable`1.Value" /> property for <paramref name="n2" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>The <see cref="P:System.Nullable`1.HasValue" /> properties for <paramref name="n1" /> and <paramref name="n2" /> are false.</para>
+                <para>-or-</para>
+                <para>The <see cref="P:System.Nullable`1.HasValue" /> properties for <paramref name="n1" /> and <paramref name="n2" /> are true, and the value of the <see cref="P:System.Nullable`1.Value" /> property for <paramref name="n1" /> is equal to the value of the <see cref="P:System.Nullable`1.Value" /> property for <paramref name="n2" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero</para>
+              </term>
+              <description>
+                <para>The <see cref="P:System.Nullable`1.HasValue" /> property for <paramref name="n1" /> is true, and the <see cref="P:System.Nullable`1.HasValue" /> property for <paramref name="n2" /> is false.</para>
+                <para>-or-</para>
+                <para>The <see cref="P:System.Nullable`1.HasValue" /> properties for <paramref name="n1" /> and <paramref name="n2" /> are true, and the value of the <see cref="P:System.Nullable`1.Value" /> property for <paramref name="n1" /> is greater than the value of the <see cref="P:System.Nullable`1.Value" /> property for <paramref name="n2" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="n1">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Nullable`1" /> object.</param>
         <param name="n2">
@@ -99,13 +144,49 @@
         <Parameter Name="n2" Type="System.Nullable&lt;T&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two specified <see cref="T:System.Nullable`1" /> objects are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="n1" /> parameter is equal to the <paramref name="n2" /> parameter; otherwise, false. </para>
+          <para>The return value depends on the <see cref="P:System.Nullable`1.HasValue" /> and <see cref="P:System.Nullable`1.Value" /> properties of the two parameters that are compared.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>true</para>
+              </term>
+              <description>
+                <para>The <see cref="P:System.Nullable`1.HasValue" /> properties for <paramref name="n1" /> and <paramref name="n2" /> are false. </para>
+                <para>-or-</para>
+                <para>The <see cref="P:System.Nullable`1.HasValue" /> properties for <paramref name="n1" /> and <paramref name="n2" /> are true, and the <see cref="P:System.Nullable`1.Value" /> properties of the parameters are equal.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>false</para>
+              </term>
+              <description>
+                <para>The <see cref="P:System.Nullable`1.HasValue" /> property is true for one parameter and false for the other parameter.</para>
+                <para>-or-</para>
+                <para>The <see cref="P:System.Nullable`1.HasValue" /> properties for <paramref name="n1" /> and <paramref name="n2" /> are true, and the <see cref="P:System.Nullable`1.Value" /> properties of the parameters are unequal.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="n1">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Nullable`1" /> object.</param>
         <param name="n2">
@@ -129,7 +210,6 @@
         <Parameter Name="nullableType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -140,6 +220,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the underlying type argument of the specified nullable type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type argument of the <paramref name="nullableType" /> parameter, if the <paramref name="nullableType" /> parameter is a closed generic nullable type; otherwise, null. </para>
+        </returns>
         <param name="nullableType">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Type" /> object that describes a closed generic nullable type. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System/Nullable`1.xml b/mcs/class/corlib/Documentation/en/System/Nullable`1.xml
index e0274e0bdc8..12ec0c8b97e 100644
--- a/mcs/class/corlib/Documentation/en/System/Nullable`1.xml
+++ b/mcs/class/corlib/Documentation/en/System/Nullable`1.xml
@@ -93,98 +93,54 @@
         <Parameter Name="other" Type="System.Object" />
       </Parameters>
       <Docs>
+        <since version=".NET 2.0" />
+        <remarks>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>If the <see cref="P:System.Nullable`1.HasValue" /> property of the current <see cref="T:System.Nullable`1" /> structure is true, equality is determined by passing the <paramref name="other" /> parameter to the Equals method of the underlying value of the current <see cref="T:System.Nullable`1" /> structure.</para>
+        </remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Indicates whether the current <see cref="T:System.Nullable`1" /> object is equal to a specified object.</para>
+        </summary>
         <returns>
-          <para>The following table defines the conditions under which the return value is <see langword="true" /> or <see langword="false" />:</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <paramref name="other" /> parameter is equal to the current <see cref="T:System.Nullable`1" /> object; otherwise, false. </para>
+          <para>This table describes how equality is defined for the compared values: </para>
           <list type="table">
             <listheader>
-              <term>Returned Value</term>
-              <description>HasValue Condition</description>
-              <description>obj.HasValue Condition</description>
+              <item>
+                <term>
+                  <para>Return Value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
             </listheader>
             <item>
               <term>
-                <see langword="false" />
-              </term>
-              <description>The current instance and <paramref name="obj" /> have different types.</description>
-              <description>The current instance and <paramref name="obj" /> have different types.</description>
-            </item>
-            <item>
-              <term>
-                <see langword="true" />
-              </term>
-              <description>
-                <see langword="false" />
-              </description>
-              <description>
-                <paramref name="obj" /> is <see langword="null" />.</description>
-            </item>
-            <item>
-              <term>
-                <see langword="false" />
-              </term>
-              <description>
-                <see langword="true" />
-              </description>
-              <description>
-                <paramref name="obj" /> is <see langword="null" />.</description>
-            </item>
-            <item>
-              <term>
-                <see langword="true" />
-              </term>
-              <description>
-                <see langword="false" />
-              </description>
-              <description>
-                <see langword="false" />
-              </description>
-            </item>
-            <item>
-              <term>
-                <see langword="false" />
+                <para>true</para>
               </term>
               <description>
-                <see langword="false" />
-              </description>
-              <description>
-                <see langword="true" />
-              </description>
-            </item>
-            <item>
-              <term>
-                <see langword="false" />
-              </term>
-              <description>
-                <see langword="true" />
-              </description>
-              <description>
-                <see langword="false" />
+                <para>The <see cref="P:System.Nullable`1.HasValue" /> property is false, and the <paramref name="other" /> parameter is null. That is, two null values are equal by definition.</para>
+                <para>-or-</para>
+                <para>The <see cref="P:System.Nullable`1.HasValue" /> property is true, and the value returned by the <see cref="P:System.Nullable`1.Value" /> property is equal to the <paramref name="other" /> parameter.</para>
               </description>
             </item>
             <item>
               <term>
-                <see langword="Value.Equals(" />
-                <paramref name="obj" />
-                <see langword=".Value)" />
+                <para>false</para>
               </term>
               <description>
-                <see langword="true" />
-              </description>
-              <description>
-                <see langword="true" />
+                <para>The <see cref="P:System.Nullable`1.HasValue" /> property for the current <see cref="T:System.Nullable`1" /> structure is true, and the <paramref name="other" /> parameter is null.</para>
+                <para>-or-</para>
+                <para>The <see cref="P:System.Nullable`1.HasValue" /> property for the current <see cref="T:System.Nullable`1" /> structure is false, and the <paramref name="other" /> parameter is not null.</para>
+                <para>-or-</para>
+                <para>The <see cref="P:System.Nullable`1.HasValue" /> property for the current <see cref="T:System.Nullable`1" /> structure is true, and the value returned by the <see cref="P:System.Nullable`1.Value" /> property is not equal to the <paramref name="other" /> parameter.</para>
               </description>
             </item>
           </list>
         </returns>
-        <since version=".NET 2.0" />
-        <remarks>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>If the <see cref="P:System.Nullable`1.HasValue" /> property of the current <see cref="T:System.Nullable`1" /> structure is true, equality is determined by passing the <paramref name="other" /> parameter to the Equals method of the underlying value of the current <see cref="T:System.Nullable`1" /> structure.</para>
-        </remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Indicates whether the current <see cref="T:System.Nullable`1" /> object is equal to a specified object.</para>
-        </summary>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />An object.</param>
       </Docs>
@@ -202,9 +158,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>If <see cref="P:System.Nullable&lt;T&gt;.HasValue" /> is <see langword="true" />, a  <see cref="T:System.Int32" /> containing the hash code for the value of the current instance is returned; otherwise, 0 is returned.</para>
-        </returns>
         <remarks>
           <para> The algorithm used to generate the hash code is unspecified. </para>
           <para>
@@ -217,6 +170,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the hash code of the object returned by the <see cref="P:System.Nullable`1.Value" /> property.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code of the object returned by the <see cref="P:System.Nullable`1.Value" /> property if the <see cref="P:System.Nullable`1.HasValue" /> property is true, or zero if the <see cref="P:System.Nullable`1.HasValue" /> property is false. </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetValueOrDefault">
@@ -232,9 +189,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A value of type <see langword="T" />, which is either the value of the current instance, or if it has none, the default value for the type <see langword="T" /> (i.e., all-bits-zero).</para>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -244,6 +198,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the value of the current <see cref="T:System.Nullable`1" /> object, or the object's default value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the <see cref="P:System.Nullable`1.Value" /> property if the  <see cref="P:System.Nullable`1.HasValue" /> property is true; otherwise, the default value of the current <see cref="T:System.Nullable`1" /> object. The type of the default value is the type argument of the current <see cref="T:System.Nullable`1" /> object, and the value of the default value consists solely of binary zeroes.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetValueOrDefault">
@@ -378,9 +336,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>If <see cref="P:System.Nullable&lt;T&gt;.HasValue" /> is true, <see cref="P:System.Nullable&lt;T&gt;.Value.ToString" /><see langword="()" /> is returned; otherwise, <see cref="F:System.String.Empty" /> is returned.</para>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -390,6 +345,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the text representation of the value of the current <see cref="T:System.Nullable`1" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The text representation of the value of the current <see cref="T:System.Nullable`1" /> object if the <see cref="P:System.Nullable`1.HasValue" /> property is true, or an empty string ("") if the <see cref="P:System.Nullable`1.HasValue" /> property is false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Value">
diff --git a/mcs/class/corlib/Documentation/en/System/Object.xml b/mcs/class/corlib/Documentation/en/System/Object.xml
index 3ca2b19da84..95f84347496 100644
--- a/mcs/class/corlib/Documentation/en/System/Object.xml
+++ b/mcs/class/corlib/Documentation/en/System/Object.xml
@@ -110,11 +110,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> is equal to the
-   current instance; otherwise, <see langword="false" />.</para>
-        </returns>
         <example>
           <para>
             <see langword="Example 1:" />
@@ -458,6 +453,10 @@ parameter.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified object is equal to the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified object  is equal to the current object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current object. </param>
       </Docs>
@@ -481,28 +480,6 @@ parameter.</para>
         <Parameter Name="objB" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if one or more of the following statements is
-   true:</para>
-          <list type="bullet">
-            <item>
-              <term>
-                <paramref name="objA" /> and <paramref name="objB" /> refer to the same object,</term>
-            </item>
-            <item>
-              <term>
-                <paramref name="objA" /> and <paramref name="objB" /> are both null references,</term>
-            </item>
-            <item>
-              <term>
-                <paramref name="objA" /> is not 
-   <see langword="null" /> and
-   <paramref name="objA" />.Equals(<paramref name="objB" /> ) returns true;</term>
-            </item>
-          </list>
-          <para>otherwise returns <see langword="false" />.</para>
-        </returns>
         <example>
           <para>The following example demonstrates the <see cref="M:System.Object.Equals(System.Object)" /> method.</para>
           <code lang="C#">using System;
@@ -564,6 +541,10 @@ public class MyClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified object instances are considered equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the objects are considered equal; otherwise, false. If both <paramref name="objA" /> and <paramref name="objB" /> are null, the method returns true.</para>
+        </returns>
         <param name="objA">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare. </param>
         <param name="objB">
@@ -741,9 +722,6 @@ public class MyClass {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the hash code for the current instance.</para>
-        </returns>
         <example>
           <para>
             <see langword="Example 1" />
@@ -888,6 +866,10 @@ public struct Int64 {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Serves as the default hash function. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current object.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -906,9 +888,6 @@ public struct Int64 {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> The instance of <see cref="T:System.Type" /> that represents the run-time type (the exact type) of the current instance.</para>
-        </returns>
         <example>
           <para>The following example demonstrates the fact that <see cref="M:System.Object.GetType" />
 returns the run-time type of the current instance:</para>
@@ -953,6 +932,10 @@ public class Test {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Type" /> of the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The exact runtime type of the current instance.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -971,11 +954,6 @@ public class Test {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A shallow copy of the current instance. The run-time
-      type (the exact type) of the returned object is the same as the run-time type of
-      the object that was copied.</para>
-        </returns>
         <example>
           <para>The following example shows a class called
    <see langword="MyClass" /> as well as a representation of the instance of
@@ -1054,6 +1032,10 @@ class MyDerivedClass: MyBaseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a shallow copy of the current <see cref="T:System.Object" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A shallow copy of the current <see cref="T:System.Object" />.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1080,12 +1062,6 @@ class MyDerivedClass: MyBaseClass {
         <Parameter Name="objB" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="True" /> if <paramref name="a" /> and <paramref name="b" /> refer
-   to the same object or are both null references; otherwise,
-<see langword="false" />.</para>
-        </returns>
         <example>
           <code lang="C#">using System;
 class MyClass {
@@ -1126,6 +1102,10 @@ class MyClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified <see cref="T:System.Object" /> instances are the same instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="objA" /> is the same instance as <paramref name="objB" /> or if both are null; otherwise, false.</para>
+        </returns>
         <param name="objA">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare. </param>
         <param name="objB">
@@ -1148,9 +1128,6 @@ class MyClass {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance.</para>
-        </returns>
         <example>
           <para>The following example outputs the textual description of
       the value of an object of type <see cref="T:System.Object" /> to the console.</para>
@@ -1233,6 +1210,10 @@ public class NewClass : IStringable
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the current object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that represents the current object.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System/OperatingSystem.xml b/mcs/class/corlib/Documentation/en/System/OperatingSystem.xml
index 5cd94d1cdbf..a1ebcd0611b 100644
--- a/mcs/class/corlib/Documentation/en/System/OperatingSystem.xml
+++ b/mcs/class/corlib/Documentation/en/System/OperatingSystem.xml
@@ -96,12 +96,15 @@ Microsoft Windows NT 5.1.2600.0
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates an <see cref="T:System.OperatingSystem" /> object that is identical to this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.OperatingSystem" /> object that is a copy of this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetObjectData">
@@ -195,12 +198,15 @@ Microsoft Windows NT 5.1.2600.0
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this <see cref="T:System.OperatingSystem" /> object to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the values returned by the <see cref="P:System.OperatingSystem.Platform" />, <see cref="P:System.OperatingSystem.Version" />, and <see cref="P:System.OperatingSystem.ServicePack" /> properties.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Version">
diff --git a/mcs/class/corlib/Documentation/en/System/Random.xml b/mcs/class/corlib/Documentation/en/System/Random.xml
index ce27968b895..e8738b802ed 100644
--- a/mcs/class/corlib/Documentation/en/System/Random.xml
+++ b/mcs/class/corlib/Documentation/en/System/Random.xml
@@ -134,10 +134,6 @@ class RandomTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> greater than or equal to zero and less than
-<see cref="F:System.Int32.MaxValue" />.</para>
-        </returns>
         <example>
           <para>The following example demonstrates using the
    <see langword="Next" /> method. The output generated by this example 
@@ -186,6 +182,10 @@ class RandomTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a nonnegative random integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer greater than or equal to zero and less than <see cref="F:System.Int32.MaxValue" />.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -206,10 +206,6 @@ class RandomTest {
         <Parameter Name="maxValue" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> set to a psuedo-random value greater than or equal to zero
-   and less than <paramref name="maxValue" />. If <paramref name="maxValue" /> is zero, returns zero.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="behaviors">As described
@@ -230,6 +226,10 @@ class RandomTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a nonnegative random integer that is less than the specified maximum.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer greater than or equal to zero, and less than <paramref name="maxValue" />; that is, the range of return values ordinarily includes zero but not <paramref name="maxValue" />. However, if <paramref name="maxValue" /> equals zero, <paramref name="maxValue" /> is returned.</para>
+        </returns>
         <param name="maxValue">
           <attribution license="cc4" from="Microsoft" modified="false" />The exclusive upper bound of the random number to be generated. <paramref name="maxValue" /> must be greater than or equal to zero. </param>
       </Docs>
@@ -253,12 +253,6 @@ class RandomTest {
         <Parameter Name="maxValue" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A psuedo-random number greater than or equal to <paramref name="minValue" /> and
-   less than <paramref name="maxValue" />. If <paramref name="minValue" /> and
-<paramref name="maxValue " />are equal, this value 
-   is returned.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="minValue" /> is greater than <paramref name="maxValue" />.</exception>
         <remarks>
@@ -269,6 +263,10 @@ class RandomTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a random integer that is within a specified range.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer greater than or equal to <paramref name="minValue" /> and less than <paramref name="maxValue" />; that is, the range of return values includes <paramref name="minValue" /> but not <paramref name="maxValue" />. If <paramref name="minValue" /> equals <paramref name="maxValue" />, <paramref name="minValue" /> is returned.</para>
+        </returns>
         <param name="minValue">
           <attribution license="cc4" from="Microsoft" modified="false" />The inclusive lower bound of the random number returned. </param>
         <param name="maxValue">
@@ -324,9 +322,6 @@ class RandomTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Double" /> greater than or equal to 0.0, and less than 1.0.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is the public version of the protected method, <see cref="M:System.Random.Sample" />.</para>
@@ -335,6 +330,10 @@ class RandomTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a random floating-point number between 0.0 and 1.0.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A double-precision floating point number greater than or equal to 0.0, and less than 1.0.</para>
+        </returns>
       </Docs>
       <Excluded>1</Excluded>
       <ExcludedLibrary>ExtendedNumerics</ExcludedLibrary>
@@ -353,7 +352,6 @@ class RandomTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>To produce a different random distribution or a different random number generator principle, derive a class from the <see cref="T:System.Random" /> class and override the <see cref="M:System.Random.Sample" /> method.</para>
@@ -365,6 +363,10 @@ class RandomTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a random floating-point number between 0.0 and 1.0.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A double-precision floating point number greater than or equal to 0.0, and less than 1.0.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System/RuntimeFieldHandle.xml b/mcs/class/corlib/Documentation/en/System/RuntimeFieldHandle.xml
index 1d221d706ee..b784f44326d 100644
--- a/mcs/class/corlib/Documentation/en/System/RuntimeFieldHandle.xml
+++ b/mcs/class/corlib/Documentation/en/System/RuntimeFieldHandle.xml
@@ -56,13 +56,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the current instance is equal to the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is a <see cref="T:System.RuntimeFieldHandle" /> and equal to the value of the current instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare to the current instance.</param>
       </Docs>
@@ -87,13 +90,16 @@
         <Parameter Name="handle" Type="System.RuntimeFieldHandle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the current instance is equal to the specified <see cref="T:System.RuntimeFieldHandle" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of <paramref name="handle" /> is equal to the value of the current instance; otherwise, false.</para>
+        </returns>
         <param name="handle">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.RuntimeFieldHandle" /> to compare to the current instance.</param>
       </Docs>
@@ -165,13 +171,16 @@
         <Parameter Name="right" Type="System.RuntimeFieldHandle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.RuntimeFieldHandle" /> structures are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is equal to <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.RuntimeFieldHandle" /> to compare to <paramref name="right" />.</param>
         <param name="right">
@@ -194,13 +203,16 @@
         <Parameter Name="right" Type="System.RuntimeFieldHandle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.RuntimeFieldHandle" /> structures are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is not equal to <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.RuntimeFieldHandle" /> to compare to <paramref name="right" />.</param>
         <param name="right">
diff --git a/mcs/class/corlib/Documentation/en/System/RuntimeMethodHandle.xml b/mcs/class/corlib/Documentation/en/System/RuntimeMethodHandle.xml
index 130f0f15b30..7fc877a592a 100644
--- a/mcs/class/corlib/Documentation/en/System/RuntimeMethodHandle.xml
+++ b/mcs/class/corlib/Documentation/en/System/RuntimeMethodHandle.xml
@@ -61,13 +61,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is a <see cref="T:System.RuntimeMethodHandle" /> and equal to the value of this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Object" /> to compare to this instance.</param>
       </Docs>
@@ -92,13 +95,16 @@
         <Parameter Name="handle" Type="System.RuntimeMethodHandle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether this instance is equal to a specified <see cref="T:System.RuntimeMethodHandle" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="handle" /> is equal to the value of this instance; otherwise, false.</para>
+        </returns>
         <param name="handle">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.RuntimeMethodHandle" /> to compare to this instance.</param>
       </Docs>
@@ -117,12 +123,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Obtains a pointer to the method represented by this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A pointer to the method represented by this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -138,13 +147,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetObjectData">
@@ -195,13 +207,16 @@
         <Parameter Name="right" Type="System.RuntimeMethodHandle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two instances of <see cref="T:System.RuntimeMethodHandle" /> are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of <paramref name="left" /> is equal to the value of <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.RuntimeMethodHandle" /> to compare to <paramref name="right" />.</param>
         <param name="right">
@@ -224,13 +239,16 @@
         <Parameter Name="right" Type="System.RuntimeMethodHandle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two instances of <see cref="T:System.RuntimeMethodHandle" /> are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of <paramref name="left" /> is unequal to the value of <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.RuntimeMethodHandle" /> to compare to <paramref name="right" />.</param>
         <param name="right">
diff --git a/mcs/class/corlib/Documentation/en/System/RuntimeTypeHandle.xml b/mcs/class/corlib/Documentation/en/System/RuntimeTypeHandle.xml
index 43260fac0b3..f6ff9127ef4 100644
--- a/mcs/class/corlib/Documentation/en/System/RuntimeTypeHandle.xml
+++ b/mcs/class/corlib/Documentation/en/System/RuntimeTypeHandle.xml
@@ -60,13 +60,16 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified object is equal to the current <see cref="T:System.RuntimeTypeHandle" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is a <see cref="T:System.RuntimeTypeHandle" /> structure and is equal to the value of this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare to the current instance.</param>
       </Docs>
@@ -91,13 +94,16 @@
         <Parameter Name="handle" Type="System.RuntimeTypeHandle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified <see cref="T:System.RuntimeTypeHandle" /> structure is equal to the current <see cref="T:System.RuntimeTypeHandle" /> structure.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of <paramref name="handle" /> is equal to the value of this instance; otherwise, false.</para>
+        </returns>
         <param name="handle">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.RuntimeTypeHandle" /> structure to compare to the current instance.</param>
       </Docs>
@@ -115,13 +121,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetModuleHandle">
@@ -145,13 +154,16 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets a handle to the module that contains the type represented by the current instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.ModuleHandle" /> structure representing a handle to the module that contains the type represented by the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetObjectData">
@@ -202,7 +214,6 @@
         <Parameter Name="right" Type="System.RuntimeTypeHandle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -212,6 +223,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether an object and a <see cref="T:System.RuntimeTypeHandle" /> structure are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is a <see cref="T:System.RuntimeTypeHandle" /> structure and is equal to <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare to <paramref name="right" />.</param>
         <param name="right">
@@ -234,7 +249,6 @@
         <Parameter Name="right" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Using this operator to compare two variables of type <see cref="T:System.RuntimeTypeHandle" /> causes an ambiguous overload resolution error when compiled. Use the <see cref="Overload:System.RuntimeTypeHandle.Equals" /> method instead.</para>
@@ -243,6 +257,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a <see cref="T:System.RuntimeTypeHandle" /> structure is equal to an object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="right" /> is a <see cref="T:System.RuntimeTypeHandle" /> and is equal to <paramref name="left" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.RuntimeTypeHandle" /> structure to compare to <paramref name="right" />.</param>
         <param name="right">
@@ -265,7 +283,6 @@
         <Parameter Name="right" Type="System.RuntimeTypeHandle" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -275,6 +292,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether an object and a <see cref="T:System.RuntimeTypeHandle" /> structure are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is a <see cref="T:System.RuntimeTypeHandle" /> and is not equal to <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare to <paramref name="right" />.</param>
         <param name="right">
@@ -297,7 +318,6 @@
         <Parameter Name="right" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Using this operator to compare two variables of type <see cref="T:System.RuntimeTypeHandle" /> causes an ambiguous overload resolution error when compiled. Use the <see cref="Overload:System.RuntimeTypeHandle.Equals" /> method instead.</para>
@@ -306,6 +326,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a <see cref="T:System.RuntimeTypeHandle" /> structure is not equal to an object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="right" /> is a <see cref="T:System.RuntimeTypeHandle" /> structure and is not equal to <paramref name="left" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.RuntimeTypeHandle" /> structure to compare to <paramref name="right" />.</param>
         <param name="right">
diff --git a/mcs/class/corlib/Documentation/en/System/SByte.xml b/mcs/class/corlib/Documentation/en/System/SByte.xml
index e2df55e0633..31e884cab4a 100644
--- a/mcs/class/corlib/Documentation/en/System/SByte.xml
+++ b/mcs/class/corlib/Documentation/en/System/SByte.xml
@@ -74,39 +74,60 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="obj" /> is not a <see cref="T:System.SByte" /> and is not a null reference.</exception>
+        <remarks>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Any instance of <see cref="T:System.SByte" />, regardless of its value, is considered greater than null.</para>
+          <para>The <paramref name="obj" /> parameter must be null or an instance of <see cref="T:System.SByte" />; otherwise, an exception is thrown.</para>
+        </remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Compares this instance to a specified object and returns an indication of their relative values.</para>
+        </summary>
         <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="obj" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number indicating the relative values of this instance and <paramref name="obj" />.</para>
           <list type="table">
             <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
             </listheader>
             <item>
-              <term> A negative number</term>
-              <description>Current instance &lt; <paramref name="obj" />.</description>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than <paramref name="obj" />. </para>
+              </description>
             </item>
             <item>
-              <term> Zero</term>
-              <description>Current instance == <paramref name="obj" />.</description>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is equal to <paramref name="obj" />. </para>
+              </description>
             </item>
             <item>
-              <term> A positive number</term>
-              <description>Current instance &gt; <paramref name="obj" />, or
-<paramref name="obj" /> is a null reference.</description>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than <paramref name="obj" />.</para>
+                <para>-or- </para>
+                <para>
+                  <paramref name="obj" /> is null. </para>
+              </description>
             </item>
           </list>
         </returns>
-        <exception cref="T:System.ArgumentException">
-          <paramref name="obj" /> is not a <see cref="T:System.SByte" /> and is not a null reference.</exception>
-        <remarks>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Any instance of <see cref="T:System.SByte" />, regardless of its value, is considered greater than null.</para>
-          <para>The <paramref name="obj" /> parameter must be null or an instance of <see cref="T:System.SByte" />; otherwise, an exception is thrown.</para>
-        </remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Compares this instance to a specified object and returns an indication of their relative values.</para>
-        </summary>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare, or null. </param>
       </Docs>
@@ -127,27 +148,6 @@
         <Parameter Name="value" Type="System.SByte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="value" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> A negative number</term>
-              <description>Current instance &lt; <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> Zero</term>
-              <description>Current instance == <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> A positive number</term>
-              <description>Current instance &gt; <paramref name="value" />.</description>
-            </item>
-          </list>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -160,6 +160,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this instance to a specified 8-bit signed integer and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative order of this instance and <paramref name="value" />.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is equal to <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than <paramref name="value" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An 8-bit signed integer to compare. </param>
       </Docs>
@@ -181,13 +221,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> represents the
-   same type and value as the current instance. If <paramref name="obj" /> is a null reference
-   or is not an instance of <see cref="T:System.SByte" />, returns <see langword="false" />.</para>
-          <see langword="" />
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note">This method
@@ -198,6 +231,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is an instance of <see cref="T:System.SByte" /> and equals the value of this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance. </param>
       </Docs>
@@ -218,10 +255,6 @@
         <Parameter Name="obj" Type="System.SByte" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> represents the same value as the current instance; otherwise, <see langword="false" />.</para>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -231,6 +264,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified <see cref="T:System.SByte" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> has the same value as this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.SByte" /> value to compare to this instance.</param>
       </Docs>
@@ -250,10 +287,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" />
-containing the hash code for the current instance.</para>
-        </returns>
         <remarks>
           <para>The algorithm used to generate the hash code is
       unspecified. </para>
@@ -265,6 +298,10 @@ containing the hash code for the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -282,12 +319,15 @@ containing the hash code for the current instance.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.TypeCode" /> for value type <see cref="T:System.SByte" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The enumerated constant, <see cref="F:System.TypeCode.SByte" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MaxValue">
@@ -366,9 +406,6 @@ containing the hash code for the current instance.</para>
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.SByte" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -440,6 +477,10 @@ public class SByteParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number to its 8-bit signed integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit signed integer that is equivalent to the number contained in the <paramref name="s" /> parameter.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents a number to convert. The string is interpreted using the <see cref="F:System.Globalization.NumberStyles.Integer" /> style.</param>
       </Docs>
@@ -468,10 +509,6 @@ public class SByteParseClass {
         <Parameter Name="style" Type="System.Globalization.NumberStyles" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.SByte" />
-value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -698,6 +735,10 @@ value obtained from <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified style to its 8-bit signed integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit signed integer that is equivalent to the number specified in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a number to convert. The string is interpreted using the style specified by <paramref name="style" />.</param>
         <param name="style">
@@ -728,9 +769,6 @@ value obtained from <paramref name="s" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.SByte" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -797,6 +835,10 @@ value obtained from <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified culture-specific format to its 8-bit signed integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit signed integer that is equivalent to the number specified in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents a number to convert. The string is interpreted using the <see cref="F:System.Globalization.NumberStyles.Integer" /> style.</param>
         <param name="provider">
@@ -828,9 +870,6 @@ value obtained from <paramref name="s" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.SByte" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -1071,6 +1110,10 @@ value obtained from <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number that is in a specified style and culture-specific format to its 8-bit signed equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An 8-bit signed byte value that is equivalent to the number specified in the <paramref name="s" /> parameter.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains the number to convert. The string is interpreted by using the style specified by <paramref name="style" />.</param>
         <param name="style">
@@ -1096,7 +1139,6 @@ value obtained from <paramref name="s" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.SByte" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToBoolean(System.SByte)" /> method.</para>
@@ -1105,6 +1147,10 @@ value obtained from <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToBoolean(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of the current instance is not zero; otherwise, false.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is unused.</param>
       </Docs>
@@ -1125,7 +1171,6 @@ value obtained from <paramref name="s" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.SByte" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToByte(System.SByte)" /> method.</para>
@@ -1134,6 +1179,10 @@ value obtained from <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToByte(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Byte" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is unused.</param>
       </Docs>
@@ -1154,7 +1203,6 @@ value obtained from <paramref name="s" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.SByte" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToChar(System.SByte)" /> method.</para>
@@ -1163,6 +1211,10 @@ value obtained from <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToChar(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Char" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1183,12 +1235,15 @@ value obtained from <paramref name="s" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to do so throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>None. This conversion is not supported. </para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1209,7 +1264,6 @@ value obtained from <paramref name="s" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.SByte" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToDecimal(System.SByte)" /> method.</para>
@@ -1218,6 +1272,10 @@ value obtained from <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToDecimal(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Decimal" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is unused.</param>
       </Docs>
@@ -1238,7 +1296,6 @@ value obtained from <paramref name="s" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.SByte" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToDouble(System.SByte)" /> method.</para>
@@ -1247,6 +1304,10 @@ value obtained from <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToDouble(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Double" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1267,7 +1328,6 @@ value obtained from <paramref name="s" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.SByte" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt16(System.SByte)" /> method.</para>
@@ -1276,6 +1336,10 @@ value obtained from <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt16(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.Int16" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1296,7 +1360,6 @@ value obtained from <paramref name="s" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.SByte" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt32(System.SByte)" /> method.</para>
@@ -1305,6 +1368,10 @@ value obtained from <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt32(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.Int32" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1325,7 +1392,6 @@ value obtained from <paramref name="s" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.SByte" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt64(System.SByte)" /> method.</para>
@@ -1334,6 +1400,10 @@ value obtained from <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt64(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.Int64" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1354,7 +1424,6 @@ value obtained from <paramref name="s" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.SByte" /> instance is cast to an <see cref="T:System.IConvertible" /> interface.</para>
@@ -1363,6 +1432,10 @@ value obtained from <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToSByte(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, unchanged.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1383,7 +1456,6 @@ value obtained from <paramref name="s" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.SByte" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToSingle(System.SByte)" /> method.</para>
@@ -1392,6 +1464,10 @@ value obtained from <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToSingle(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Single" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1414,7 +1490,6 @@ value obtained from <paramref name="s" />.</para>
       </Parameters>
       <Docs>
         <param name="targetType">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.SByte" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the static (Shared in Visual Basic) <see cref="M:System.Convert.ChangeType(System.Object,System.Type,System.IFormatProvider)" /> method.</para>
@@ -1423,6 +1498,10 @@ value obtained from <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToType(System.Type,System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an object of type <paramref name="type" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.IFormatProvider" /> implementation that provides information about the format of the returned value.</param>
       </Docs>
@@ -1443,7 +1522,6 @@ value obtained from <paramref name="s" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.SByte" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt16(System.SByte)" /> method.</para>
@@ -1452,6 +1530,10 @@ value obtained from <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt16(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.UInt16" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1472,7 +1554,6 @@ value obtained from <paramref name="s" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.SByte" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt32(System.SByte)" /> method.</para>
@@ -1481,6 +1562,10 @@ value obtained from <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt32(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.UInt32" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1501,7 +1586,6 @@ value obtained from <paramref name="s" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.SByte" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt64(System.SByte)" /> method.</para>
@@ -1510,6 +1594,10 @@ value obtained from <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt64(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.UInt64" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1529,11 +1617,6 @@ value obtained from <paramref name="s" />.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted using
-   the general format specifier ("G"). The string takes into account the current
-   system culture.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.SByte.ToString" /> method formats an <see cref="T:System.SByte" /> value in the default ("G", or general) format of the current culture. If you want to specify a different format or culture, use the other overloads of the <see cref="M:System.SByte.ToString(System.String)" /> method, as follows: </para>
@@ -1599,6 +1682,10 @@ value obtained from <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance, consisting of a negative sign if the value is negative, and a sequence of digits ranging from 0 to 9 with no leading zeroes.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1619,12 +1706,6 @@ value obtained from <paramref name="s" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted using
-   the general format specifier, ("G"). The string takes into account the
-   formatting information in the <see cref="T:System.Globalization.NumberFormatInfo" /> instance supplied by
-<paramref name="provider" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.SByte.ToString(System.IFormatProvider)" /> method formats an <see cref="T:System.SByte" /> value in the default ("G", or general) format of a specified culture. If you want to specify a different format or the current culture, use the other overloads of the <see cref="M:System.SByte.ToString(System.String)" /> method, as follows:</para>
@@ -1701,6 +1782,10 @@ value obtained from <paramref name="s" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance, as specified by <paramref name="provider" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information. </param>
       </Docs>
@@ -1723,11 +1808,6 @@ value obtained from <paramref name="s" />.</para>
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted as
-   specified by <paramref name="format" />. The string takes into account the current system
-   culture.</para>
-        </returns>
         <exception cref="T:System.FormatException">
           <paramref name="format" /> is invalid.</exception>
         <example>
@@ -1830,6 +1910,10 @@ public class SByteToStringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation, using the specified format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance as specified by <paramref name="format" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A standard or custom numeric format string.</param>
       </Docs>
@@ -1853,11 +1937,6 @@ public class SByteToStringExample {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted as
-   specified by <paramref name="format" />. The string takes into account the formatting
-   information in the <see cref="T:System.Globalization.NumberFormatInfo" /> instance supplied by <paramref name="provider" /> .</para>
-        </returns>
         <exception cref="T:System.FormatException">
           <paramref name="format" /> is invalid.</exception>
         <remarks>
@@ -1945,6 +2024,10 @@ public class SByteToStringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance as specified by <paramref name="format" /> and <paramref name="provider" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A standard or custom numeric format string.</param>
         <param name="provider">
diff --git a/mcs/class/corlib/Documentation/en/System/Single.xml b/mcs/class/corlib/Documentation/en/System/Single.xml
index cb9b703556e..41a02e4be06 100644
--- a/mcs/class/corlib/Documentation/en/System/Single.xml
+++ b/mcs/class/corlib/Documentation/en/System/Single.xml
@@ -332,64 +332,72 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="value" /> is not a null reference and is not of type <see cref="T:System.Single" />.</exception>
+        <remarks>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <paramref name="value" /> parameter must be null or an instance of <see cref="T:System.Single" />; otherwise, an exception is thrown. Any instance of <see cref="T:System.Single" />, regardless of its value, is considered greater than null.</para>
+          <para>Values must be identical to be considered equal. Particularly when floating-point values depend on multiple mathematical operations, it is common for them to lose precision and for their values to be nearly identical except for their least significant digits. Because of this, the return value of the <see cref="M:System.Single.CompareTo(System.Object)" /> method may seem surprising at times. For example, multiplication by a particular value followed by division by the same value should produce the original value, but in the following example, the computed value turns out to be greater than the original value. Showing all significant digits of the two values by using the "R" <format type="text/html"><a href="580e57eb-ac47-4ffd-bccd-3a1637c2f467">standard numeric format string</a></format> indicates that the computed value differs from the original value in its least significant digits. For information about handling such comparisons, see the Remarks section of the <see cref="M:System.Single.Equals(System.Single)" /> method. </para>
+          <para>code reference: System.Single.CompareTo#2</para>
+          <para>This method is implemented to support the <see cref="T:System.IComparable" /> interface. Note that, although a <see cref="F:System.Single.NaN" /> is not considered to be equal to another <see cref="F:System.Single.NaN" /> (even itself), the <see cref="T:System.IComparable" /> interface requires that A.CompareTo(A) return zero.</para>
+          <format type="text/html">
+            <h2>Precision in Comparisons</h2>
+          </format>
+          <para>The precision of floating-point numbers beyond the documented precision is specific to the implementation and version of the .NET Framework. Consequently, a comparison of two particular numbers might change between versions of the .NET Framework because the precision of the numbers' internal representation might change.</para>
+        </remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Compares this instance to a specified object and returns an integer that indicates whether the value of this instance is less than, equal to, or greater than the value of the specified object.</para>
+        </summary>
         <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="value" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number indicating the relative values of this instance and <paramref name="value" />.</para>
           <list type="table">
             <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
             </listheader>
             <item>
-              <term> Any
-         negative
-         number</term>
+              <term>
+                <para>Less than zero </para>
+              </term>
               <description>
-                <para>Current instance &lt; <paramref name="value" />.</para>
-                <para>-or-</para>
-                <para>Current instance is a NaN and <paramref name="value" /> is
-      not a NaN and is not a null reference.</para>
+                <para>This instance is less than <paramref name="value" />.</para>
+                <para>-or- </para>
+                <para>This instance is not a number (<see cref="F:System.Single.NaN" />) and <paramref name="value" /> is a number. </para>
               </description>
             </item>
             <item>
-              <term> Zero</term>
+              <term>
+                <para>Zero </para>
+              </term>
               <description>
-                <para>Current instance == <paramref name="value" /> .</para>
-                <para>-or-</para>
-                <para>Current instance and <paramref name="value" /> are both NaN,
-   positive infinity, or negative infinity.</para>
+                <para>This instance is equal to <paramref name="value" />.</para>
+                <para>-or- </para>
+                <para>This instance and value are both not a number (<see cref="F:System.Single.NaN" />), <see cref="F:System.Single.PositiveInfinity" />, or <see cref="F:System.Single.NegativeInfinity" />. </para>
               </description>
             </item>
             <item>
-              <term> A positive number</term>
+              <term>
+                <para>Greater than zero </para>
+              </term>
               <description>
-                <para>Current instance &gt; <paramref name="value" />.</para>
-                <para>-or-</para>
+                <para>This instance is greater than <paramref name="value" />.</para>
+                <para>-or- </para>
+                <para>This instance is a number and <paramref name="value" /> is not a number (<see cref="F:System.Single.NaN" />).</para>
+                <para>-or- </para>
                 <para>
-                  <paramref name="value" /> is a null reference.</para>
-                <para>-or-</para>
-                <para>Current instance is not a NaN and <paramref name="value" />
-is a NaN.</para>
+                  <paramref name="value" /> is null. </para>
               </description>
             </item>
           </list>
         </returns>
-        <exception cref="T:System.ArgumentException">
-          <paramref name="value" /> is not a null reference and is not of type <see cref="T:System.Single" />.</exception>
-        <remarks>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>The <paramref name="value" /> parameter must be null or an instance of <see cref="T:System.Single" />; otherwise, an exception is thrown. Any instance of <see cref="T:System.Single" />, regardless of its value, is considered greater than null.</para>
-          <para>Values must be identical to be considered equal. Particularly when floating-point values depend on multiple mathematical operations, it is common for them to lose precision and for their values to be nearly identical except for their least significant digits. Because of this, the return value of the <see cref="M:System.Single.CompareTo(System.Object)" /> method may seem surprising at times. For example, multiplication by a particular value followed by division by the same value should produce the original value, but in the following example, the computed value turns out to be greater than the original value. Showing all significant digits of the two values by using the "R" <format type="text/html"><a href="580e57eb-ac47-4ffd-bccd-3a1637c2f467">standard numeric format string</a></format> indicates that the computed value differs from the original value in its least significant digits. For information about handling such comparisons, see the Remarks section of the <see cref="M:System.Single.Equals(System.Single)" /> method. </para>
-          <para>code reference: System.Single.CompareTo#2</para>
-          <para>This method is implemented to support the <see cref="T:System.IComparable" /> interface. Note that, although a <see cref="F:System.Single.NaN" /> is not considered to be equal to another <see cref="F:System.Single.NaN" /> (even itself), the <see cref="T:System.IComparable" /> interface requires that A.CompareTo(A) return zero.</para>
-          <format type="text/html">
-            <h2>Precision in Comparisons</h2>
-          </format>
-          <para>The precision of floating-point numbers beyond the documented precision is specific to the implementation and version of the .NET Framework. Consequently, a comparison of two particular numbers might change between versions of the .NET Framework because the precision of the numbers' internal representation might change.</para>
-        </remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Compares this instance to a specified object and returns an integer that indicates whether the value of this instance is less than, equal to, or greater than the value of the specified object.</para>
-        </summary>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare, or null. </param>
       </Docs>
@@ -410,43 +418,6 @@ is a NaN.</para>
         <Parameter Name="value" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="value" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> Any
-         negative
-         number</term>
-              <description>
-                <para>Current instance &lt; <paramref name="value" />.</para>
-                <para>-or-</para>
-                <para>Current instance is a NaN and <paramref name="value" /> is not a NaN.</para>
-              </description>
-            </item>
-            <item>
-              <term> Zero</term>
-              <description>
-                <para>Current instance == <paramref name="value" /> .</para>
-                <para>-or-</para>
-                <para>Current instance and <paramref name="value" /> are both NaN,
-   positive infinity, or negative infinity.</para>
-              </description>
-            </item>
-            <item>
-              <term> A positive number</term>
-              <description>
-                <para>Current instance &gt; <paramref name="value" />.</para>
-                <para>-or-</para>
-                <para>Current instance is not a NaN and <paramref name="value" />
-is a NaN.</para>
-              </description>
-            </item>
-          </list>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -469,6 +440,52 @@ is a NaN.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this instance to a specified single-precision floating-point number and returns an integer that indicates whether the value of this instance is less than, equal to, or greater than the value of the specified single-precision floating-point number.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number indicating the relative values of this instance and <paramref name="value" />.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than <paramref name="value" />.</para>
+                <para>-or- </para>
+                <para>This instance is not a number (<see cref="F:System.Single.NaN" />) and <paramref name="value" /> is a number. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is equal to <paramref name="value" />.</para>
+                <para>-or- </para>
+                <para>Both this instance and <paramref name="value" /> are not a number (<see cref="F:System.Single.NaN" />), <see cref="F:System.Single.PositiveInfinity" />, or <see cref="F:System.Single.NegativeInfinity" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than <paramref name="value" />.</para>
+                <para>-or- </para>
+                <para>This instance is a number and <paramref name="value" /> is not a number (<see cref="F:System.Single.NaN" />). </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A single-precision floating-point number to compare. </param>
       </Docs>
@@ -530,16 +547,6 @@ is a NaN.</para>
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> represents the same type and value as the current
-   instance, otherwise <see langword="false" />
-   . If <paramref name="obj" /> is
-   a null reference or is not an instance of <see cref="T:System.Single" />, returns <see langword="false" />. If either <paramref name="obj" /> or the current
-   instance is a NaN and the other is not, returns <see langword="false" />. If
-<paramref name="obj" /> and the current instance are both NaN, positive infinity, or negative 
-   infinity, returns <see langword="true" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Single.Equals(System.Single)" /> method should be used with caution, because two apparently equivalent values can be unequal due to the differing precision of the two values. The following example reports that the <see cref="T:System.Single" /> value .3333 and the <see cref="T:System.Single" /> returned by dividing 1 by 3 are unequal.</para>
@@ -556,6 +563,10 @@ is a NaN.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is an instance of <see cref="T:System.Single" /> and equals the value of this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance. </param>
       </Docs>
@@ -576,14 +587,6 @@ is a NaN.</para>
         <Parameter Name="obj" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> represents the same value as the current
-   instance, otherwise <see langword="false" />. If either <paramref name="obj" /> or the current
-   instance is a NaN and the other is not, returns <see langword="false" />. If
-<paramref name="obj" /> and the current instance are both NaN, positive infinity, or negative 
-   infinity, returns <see langword="true" />.</para>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -613,6 +616,10 @@ is a NaN.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance and a specified <see cref="T:System.Single" /> object represent the same value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is equal to this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance.</param>
       </Docs>
@@ -632,9 +639,6 @@ is a NaN.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the hash code for this instance.</para>
-        </returns>
         <remarks>
           <para>
  The algorithm used to generate the hash code is
@@ -650,6 +654,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -667,12 +675,15 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.TypeCode" /> for value type <see cref="T:System.Single" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The enumerated constant, <see cref="F:System.TypeCode.Single" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsInfinity">
@@ -692,11 +703,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="f" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="f " />represents a
- positive or negative infinity value; otherwise <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Floating-point operations return <see cref="F:System.Single.PositiveInfinity" /> or <see cref="F:System.Single.NegativeInfinity" /> to signal an overflow condition.</para>
@@ -705,6 +711,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified number evaluates to negative or positive infinity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="f" /> evaluates to <see cref="F:System.Single.PositiveInfinity" /> or <see cref="F:System.Single.NegativeInfinity" />; otherwise, false.</para>
+        </returns>
         <param name="f">
           <attribution license="cc4" from="Microsoft" modified="false" />A single-precision floating-point number. </param>
       </Docs>
@@ -732,11 +742,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="f" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="f" /> represents a NaN
- value; otherwise <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Floating-point operations return <see cref="F:System.Single.NaN" /> to signal that that result of the operation is undefined. For example, dividing 0.0 by 0.0 results in <see cref="F:System.Single.NaN" />.</para>
@@ -749,6 +754,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the specified value is not a number (<see cref="F:System.Single.NaN" />).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="f" /> evaluates to not a number (<see cref="F:System.Single.NaN" />); otherwise, false.</para>
+        </returns>
         <param name="f">
           <attribution license="cc4" from="Microsoft" modified="false" />A single-precision floating-point number. </param>
       </Docs>
@@ -771,12 +780,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="f" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="f" /> represents a
- negative infinity value; otherwise <see langword="false" />
- .</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Floating-point operations return <see cref="F:System.Single.NegativeInfinity" /> to signal an overflow condition.</para>
@@ -785,6 +788,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified number evaluates to negative infinity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="f" /> evaluates to <see cref="F:System.Single.NegativeInfinity" />; otherwise, false.</para>
+        </returns>
         <param name="f">
           <attribution license="cc4" from="Microsoft" modified="false" />A single-precision floating-point number. </param>
       </Docs>
@@ -807,12 +814,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="f" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="f" /> represents a
- positive infinity value; otherwise <see langword="false" />
- .</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Floating-point operations return <see cref="F:System.Single.PositiveInfinity" /> to signal an overflow condition.</para>
@@ -821,6 +822,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified number evaluates to positive infinity.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="f" /> evaluates to <see cref="F:System.Single.PositiveInfinity" />; otherwise, false.</para>
+        </returns>
         <param name="f">
           <attribution license="cc4" from="Microsoft" modified="false" />A single-precision floating-point number. </param>
       </Docs>
@@ -960,7 +965,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="right" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Single.op_Equality(System.Single,System.Single)" /> method defines the equality operator for <see cref="T:System.Single" /> values.</para>
@@ -969,6 +973,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether two specified <see cref="T:System.Single" /> values are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> and <paramref name="right" /> are equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -990,7 +998,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="right" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Single.op_GreaterThan(System.Single,System.Single)" /> method defines the operation of the greater-than operator for <see cref="T:System.Single" /> values.</para>
@@ -999,6 +1006,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a specified <see cref="T:System.Single" /> value is greater than another specified <see cref="T:System.Single" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is greater than <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -1020,7 +1031,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="right" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Single.op_GreaterThanOrEqual(System.Single,System.Single)" /> method defines the operation of the greater-than-or-equal operator for <see cref="T:System.Single" /> values.</para>
@@ -1029,6 +1039,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a specified <see cref="T:System.Single" /> value is greater than or equal to another specified <see cref="T:System.Single" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is greater than or equal to <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -1050,7 +1064,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="right" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Single.op_Inequality(System.Single,System.Single)" /> method defines the inequality operator for <see cref="T:System.Single" /> values.</para>
@@ -1059,6 +1072,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether two specified <see cref="T:System.Single" /> values are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> and <paramref name="right" /> are not equal; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -1080,7 +1097,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="right" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Single.op_LessThan(System.Single,System.Single)" /> method defines the operation of the less-than operator for <see cref="T:System.Single" /> values.</para>
@@ -1089,6 +1105,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a specified <see cref="T:System.Single" /> value is less than another specified <see cref="T:System.Single" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is less than <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -1110,7 +1130,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="right" Type="System.Single" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Single.op_LessThanOrEqual(System.Single,System.Single)" /> method defines the operation of the less-than-or-equal operator for <see cref="T:System.Single" /> values.</para>
@@ -1119,6 +1138,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether a specified <see cref="T:System.Single" /> value is less than or equal to another specified <see cref="T:System.Single" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is less than or equal to <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first value to compare.</param>
         <param name="right">
@@ -1142,11 +1165,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Single" /> value obtained from <paramref name="s" />.  If <paramref name="s" /> equals
-<see cref="P:System.Globalization.NumberFormatInfo.NaNSymbol" />, this method returns 
-<see cref="F:System.Single.NaN" /> .</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -1243,6 +1261,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number to its single-precision floating-point number equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A single-precision floating-point number equivalent to the numeric value or symbol specified in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a number to convert. </param>
       </Docs>
@@ -1266,11 +1288,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="style" Type="System.Globalization.NumberStyles" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Single" /> value obtained from <paramref name="s" />. If <paramref name="s" />
-   equals <see cref="P:System.Globalization.NumberFormatInfo.NaNSymbol" />, this method returns
-<see cref="F:System.Single.NaN" /> .</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -1513,6 +1530,10 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified style to its single-precision floating-point number equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A single-precision floating-point number that is equivalent to the numeric value or symbol specified in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a number to convert. </param>
         <param name="style">
@@ -1538,11 +1559,6 @@ This method overrides <see cref="M:System.Object.GetHashCode" />.
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Single" />
-value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see cref="P:System.Globalization.NumberFormatInfo.NaNSymbol" />, this method returns
-<see cref="F:System.Single.NaN" /> .</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s " />is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -1644,6 +1660,10 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified culture-specific format to its single-precision floating-point number equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A single-precision floating-point number equivalent to the numeric value or symbol specified in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a number to convert. </param>
         <param name="provider">
@@ -1670,10 +1690,6 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Single" /> value obtained from <paramref name="s" />. If <paramref name="s" />
-   equals <see cref="P:System.Globalization.NumberFormatInfo.NaNSymbol" />, this method returns NaN.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -1954,6 +1970,10 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified style and culture-specific format to its single-precision floating-point number equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A single-precision floating-point number equivalent to the numeric value or symbol specified in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a number to convert. </param>
         <param name="style">
@@ -2008,7 +2028,6 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Single" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToBoolean(System.Single)" /> method.</para>
@@ -2017,6 +2036,10 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToBoolean(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of the current instance is not zero; otherwise, false.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2037,7 +2060,6 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Single" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToByte(System.Single)" /> method.</para>
@@ -2046,6 +2068,10 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToByte(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Byte" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2066,12 +2092,15 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to use this method throws an <see cref="T:System.InvalidCastException" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2092,12 +2121,15 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to use this method throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2118,7 +2150,6 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Single" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToDecimal(System.Single)" /> method.</para>
@@ -2127,6 +2158,10 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToDecimal(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Decimal" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2147,7 +2182,6 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Single" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToDouble(System.Single)" /> method.</para>
@@ -2156,6 +2190,10 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToDouble(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Double" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2176,7 +2214,6 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Single" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt16(System.Single)" /> method.</para>
@@ -2185,6 +2222,10 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt16(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.Int16" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2205,7 +2246,6 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Single" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt32(System.Single)" /> method.</para>
@@ -2214,6 +2254,10 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt32(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.Int32" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2234,7 +2278,6 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Single" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt64(System.Single)" /> method.</para>
@@ -2243,6 +2286,10 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt64(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.Int64" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2263,7 +2310,6 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Single" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToSByte(System.Single)" /> method.</para>
@@ -2272,6 +2318,10 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToSByte(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.SByte" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2292,7 +2342,6 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Single" /> instance is cast to an <see cref="T:System.IConvertible" /> interface.</para>
@@ -2301,6 +2350,10 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToSingle(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, unchanged.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2323,7 +2376,6 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
       </Parameters>
       <Docs>
         <param name="targetType">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Single" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the static (Shared in Visual Basic) <see cref="M:System.Convert.ChangeType(System.Object,System.Type,System.IFormatProvider)" /> method.</para>
@@ -2332,6 +2384,10 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToType(System.Type,System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to <paramref name="type" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies information about the format of the returned value.</param>
       </Docs>
@@ -2352,7 +2408,6 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Single" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt16(System.Single)" /> method.</para>
@@ -2361,6 +2416,10 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt16(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.UInt16" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2381,7 +2440,6 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Single" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt32(System.Single)" /> method.</para>
@@ -2390,6 +2448,10 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt32(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.UInt32" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2410,7 +2472,6 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Single" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt64(System.Single)" /> method.</para>
@@ -2419,6 +2480,10 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt64(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.UInt64" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -2438,11 +2503,6 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted using
-   the general format specifier, ("G"). The string
-   takes into account the current system culture.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Single.ToString" /> method formats a <see cref="T:System.Single" /> value in the default ("G", or general) format of the current culture. If you want to specify a different format or culture, use the other overloads of the <see cref="M:System.Single.ToString(System.String)" /> method, as follows: </para>
@@ -2579,6 +2639,10 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -2599,12 +2663,6 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted using
-   the general format specifier, ("G"). The string takes into account the
-   formatting information in the <see cref="T:System.Globalization.NumberFormatInfo" /> instance supplied by
-<paramref name="provider" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Single.ToString(System.IFormatProvider)" /> method formats a <see cref="T:System.Single" /> value in the default ("G", or general) format of a specified culture. If you want to specify a different format or the current culture, use the other overloads of the <see cref="M:System.Single.ToString(System.String)" /> method, as follows:</para>
@@ -2743,6 +2801,10 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance as specified by <paramref name="provider" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information. </param>
       </Docs>
@@ -2765,12 +2827,6 @@ value obtained from <paramref name="s" />. If <paramref name="s" /> equals <see
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of
-   the current instance formatted as specified by <paramref name="format" />
-   . The string takes into account the current system
-   culture.</para>
-        </returns>
         <exception cref="T:System.FormatException">
           <paramref name="format" /> is invalid.</exception>
         <example>
@@ -2877,6 +2933,10 @@ class test {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation, using the specified format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance as specified by <paramref name="format" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A numeric format string.</param>
       </Docs>
@@ -2900,11 +2960,6 @@ class test {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted as
-   specified by <paramref name="format" />. The string takes into account the information in
-   the <see cref="T:System.Globalization.NumberFormatInfo" /> instance supplied by <paramref name="provider" />.</para>
-        </returns>
         <exception cref="T:System.FormatException">
           <paramref name="format" /> is invalid.</exception>
         <remarks>
@@ -2983,6 +3038,10 @@ class test {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance as specified by <paramref name="format" /> and <paramref name="provider" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A numeric format string.</param>
         <param name="provider">
diff --git a/mcs/class/corlib/Documentation/en/System/String.xml b/mcs/class/corlib/Documentation/en/System/String.xml
index 309cafadb87..8db635ca927 100644
--- a/mcs/class/corlib/Documentation/en/System/String.xml
+++ b/mcs/class/corlib/Documentation/en/System/String.xml
@@ -1071,9 +1071,6 @@ public class StringExample {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A reference to the current instance of <see cref="T:System.String" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The return value is not an independent copy of this instance; it is simply another view of the same data. Use the <see cref="M:System.String.Copy(System.String)" /> or <see cref="M:System.String.CopyTo(System.Int32,System.Char[],System.Int32,System.Int32)" /> method to create a separate <see cref="T:System.String" /> object with the same value as this instance.</para>
@@ -1083,6 +1080,10 @@ public class StringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a reference to this instance of <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This instance of <see cref="T:System.String" />.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1104,30 +1105,6 @@ public class StringExample {
         <Parameter Name="strB" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the specified strings. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
-          <list type="table">
-            <listheader>
-              <term> Value</term>
-              <description>Meaning</description>
-            </listheader>
-            <item>
-              <term> A negative number</term>
-              <description>
-                <paramref name="strA" /> is lexicographically &lt; <paramref name="strB" />.</description>
-            </item>
-            <item>
-              <term> Zero</term>
-              <description>
-                <paramref name="strA" /> is lexicographically == <paramref name="strB" />.</description>
-            </item>
-            <item>
-              <term> A positive number</term>
-              <description>
-                <paramref name="strA" /> is lexicographically &gt; <paramref name="strB" />.</description>
-            </item>
-          </list>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The comparison uses the current culture to obtain culture-specific information such as casing rules and the alphabetic order of individual characters. For example, a culture could specify that certain combinations of characters be treated as a single character, or uppercase and lowercase characters be compared in a particular way, or that the sorting order of a character depends on the characters that precede or follow it.</para>
@@ -1146,6 +1123,49 @@ public class StringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two specified <see cref="T:System.String" /> objects and returns an integer that indicates their relative position in the sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer that indicates the lexical relationship between the two comparands.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>

+                                                                                                                                                                                                                                                                                        <paramref name="strA" /> is less than <paramref name="strB" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>

+                                                                                                                                                                                                                                                                                            <paramref name="strA" /> equals <paramref name="strB" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>

+                                                                                                                                                                                                                                                                                                <paramref name="strA" /> is greater than <paramref name="strB" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="strA">
           <attribution license="cc4" from="Microsoft" modified="false" />The first string to compare. </param>
         <param name="strB">
@@ -1172,30 +1192,6 @@ public class StringExample {
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the specified substrings. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
-          <list type="table">
-            <listheader>
-              <term> Value</term>
-              <description>Meaning</description>
-            </listheader>
-            <item>
-              <term> A negative number</term>
-              <description>
-                <paramref name="strA" /> is &lt; <paramref name="strB" />.</description>
-            </item>
-            <item>
-              <term> Zero</term>
-              <description>
-                <paramref name="strA" /> == <paramref name="strB" />.</description>
-            </item>
-            <item>
-              <term> A positive number</term>
-              <description>
-                <paramref name="strA" /> is &gt; <paramref name="strB" />.</description>
-            </item>
-          </list>
-        </returns>
         <example>
           <para>The following example demonstrates comparing strings with and without case 
       sensitivity.</para>
@@ -1237,6 +1233,49 @@ public class StringCompareExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two specified <see cref="T:System.String" /> objects, ignoring or honoring their case, and returns an integer that indicates their relative position in the sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer that indicates the lexical relationship between the two comparands.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>

+                                                                                                                                                                                                                                                                                                    <paramref name="strA" /> is less than <paramref name="strB" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>

+                                                                                                                                                                                                                                                                                                        <paramref name="strA" /> equals <paramref name="strB" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>

+                                                                                                                                                                                                                                                                                                            <paramref name="strA" /> is greater than <paramref name="strB" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="strA">
           <attribution license="cc4" from="Microsoft" modified="false" />The first string to compare. </param>
         <param name="strB">
@@ -1264,7 +1303,6 @@ public class StringCompareExample {
         <Parameter Name="comparisonType" Type="System.StringComparison" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1280,6 +1318,49 @@ public class StringCompareExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two specified <see cref="T:System.String" /> objects using the specified rules, and returns an integer that indicates their relative position in the sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer that indicates the lexical relationship between the two comparands.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>

+                                                                                                                                                                                                                                                                                                                            <paramref name="strA" /> is less than <paramref name="strB" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>

+                                                                                                                                                                                                                                                                                                                                <paramref name="strA" /> equals <paramref name="strB" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>

+                                                                                                                                                                                                                                                                                                                                    <paramref name="strA" /> is greater than <paramref name="strB" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="strA">
           <attribution license="cc4" from="Microsoft" modified="false" />The first string to compare.</param>
         <param name="strB">
@@ -1307,7 +1388,6 @@ public class StringCompareExample {
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The comparison uses the <paramref name="culture" /> parameter to obtain culture-specific information such as casing rules and the alphabetic order of individual characters. For example, a culture could specify that certain combinations of characters be treated as a single character, or uppercase and lowercase characters be compared in a particular way, or that the sorting order of a character depends on the characters that precede or follow it.</para>
@@ -1323,6 +1403,49 @@ public class StringCompareExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two specified <see cref="T:System.String" /> objects, ignoring or honoring their case, and using culture-specific information to influence the comparison, and returns an integer that indicates their relative position in the sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer that indicates the lexical relationship between the two comparands.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>

+                                                                                                                                                                                                                                                                                                                <paramref name="strA" /> is less than <paramref name="strB" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>

+                                                                                                                                                                                                                                                                                                                    <paramref name="strA" /> equals <paramref name="strB" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>

+                                                                                                                                                                                                                                                                                                                        <paramref name="strA" /> is greater than <paramref name="strB" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="strA">
           <attribution license="cc4" from="Microsoft" modified="false" />The first string to compare. </param>
         <param name="strB">
@@ -1352,7 +1475,6 @@ public class StringCompareExample {
         <Parameter Name="options" Type="System.Globalization.CompareOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The comparison uses the <paramref name="culture" /> parameter to obtain culture-specific information, such as casing rules and the alphabetical order of individual characters. For example, a particular culture could specify that certain combinations of characters be treated as a single character, that uppercase and lowercase characters be compared in a particular way, or that the sort order of a character depends on the characters that precede or follow it.</para>
@@ -1367,6 +1489,49 @@ public class StringCompareExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares two specified <see cref="T:System.String" /> objects using the specified comparison options and culture-specific information to influence the comparison, and returns an integer that indicates the relationship of the two strings to each other in the sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer that indicates the lexical relationship between <paramref name="strA" /> and <paramref name="strB" />, as shown in the following table</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value</para>
+                </term>
+                <description>
+                  <para>Condition</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero</para>
+              </term>
+              <description>
+                <para>

+                                                                                                                                                                                                                                                                                                                                                                                                                                                    <paramref name="strA" /> is less than <paramref name="strB" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>

+                                                                                                                                                                                                                                                                                                                                                                                                                                                        <paramref name="strA" /> equals <paramref name="strB" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero</para>
+              </term>
+              <description>
+                <para>

+                                                                                                                                                                                                                                                                                                                                                                                                                                                            <paramref name="strA" /> is greater than <paramref name="strB" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="strA">
           <attribution license="cc4" from="Microsoft" modified="false" />The first string to compare.  </param>
         <param name="strB">
@@ -1398,31 +1563,6 @@ public class StringCompareExample {
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the specified substrings. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
-          <list type="table">
-            <listheader>
-              <term> Value</term>
-              <description>Meaning</description>
-            </listheader>
-            <item>
-              <term> A negative number</term>
-              <description>The substring in <paramref name="strA" /> is &lt; the substring
-      in <paramref name="strB" />.</description>
-            </item>
-            <item>
-              <term> Zero</term>
-              <description>The substring in <paramref name="strA" /> == 
-   the substring in
-<paramref name="strB" />, or <paramref name="length" /> is zero.</description>
-            </item>
-            <item>
-              <term> A positive number</term>
-              <description>The substring in <paramref name="strA" /> is &gt; the substring
-   in <paramref name="strB" />.</description>
-            </item>
-          </list>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>The sum of <paramref name="indexA" /> and <paramref name="length" /> is greater than <paramref name="strA" /> .Length .</para>
           <para> -or-</para>
@@ -1473,6 +1613,46 @@ public class StringCompareExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares substrings of two specified <see cref="T:System.String" /> objects and returns an integer that indicates their relative position in the sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer indicating the lexical relationship between the two comparands.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>The substring in <paramref name="strA" /> is less than the substring in <paramref name="strB" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>The substrings are equal, or <paramref name="length" /> is zero. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>The substring in <paramref name="strA" /> is greater than the substring in <paramref name="strB" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="strA">
           <attribution license="cc4" from="Microsoft" modified="false" />The first string to use in the comparison. </param>
         <param name="indexA">
@@ -1508,31 +1688,6 @@ public class StringCompareExample {
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the specified substrings. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
-          <list type="table">
-            <listheader>
-              <term>Value Type</term>
-              <description>Condition</description>
-            </listheader>
-            <item>
-              <term> A negative number</term>
-              <description>The substring in <paramref name="strA" /> is &lt; the substring
-      in <paramref name="strB" />.</description>
-            </item>
-            <item>
-              <term> Zero</term>
-              <description>The substring in <paramref name="strA" /> == 
-   the substring in
-<paramref name="strB" />, or <paramref name="length" /> is zero.</description>
-            </item>
-            <item>
-              <term> A positive number</term>
-              <description>The substring in <paramref name="strA" /> is &gt; the substring
-   in <paramref name="strB" />.</description>
-            </item>
-          </list>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="indexA" /> is greater than <paramref name="strA" /> .Length</para>
@@ -1593,6 +1748,46 @@ public class StringCompareExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares substrings of two specified <see cref="T:System.String" /> objects, ignoring or honoring their case, and returns an integer that indicates their relative position in the sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer that indicates the lexical relationship between the two comparands.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value</para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>The substring in <paramref name="strA" /> is less than the substring in <paramref name="strB" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>The substrings are equal, or <paramref name="length" /> is zero. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>The substring in <paramref name="strA" /> is greater than the substring in <paramref name="strB" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="strA">
           <attribution license="cc4" from="Microsoft" modified="false" />The first string to use in the comparison. </param>
         <param name="indexA">
@@ -1629,7 +1824,6 @@ public class StringCompareExample {
         <Parameter Name="comparisonType" Type="System.StringComparison" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1647,6 +1841,46 @@ public class StringCompareExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares substrings of two specified <see cref="T:System.String" /> objects using the specified rules, and returns an integer that indicates their relative position in the sort order. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer that indicates the lexical relationship between the two comparands.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>The substring in the <paramref name="strA" /> parameter is less than the substring in the <paramref name="strB" /> parameter.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>The substrings are equal, or the <paramref name="length" /> parameter is zero. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>The substring in <paramref name="strA" /> is greater than the substring in <paramref name="strB" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="strA">
           <attribution license="cc4" from="Microsoft" modified="false" />The first string to use in the comparison. </param>
         <param name="indexA">
@@ -1683,7 +1917,6 @@ public class StringCompareExample {
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The substrings to compare start in <paramref name="strA" /> at <paramref name="indexA" />, and in <paramref name="strB" /> at <paramref name="indexB" />. Both <paramref name="indexA" /> and <paramref name="indexB" /> are zero-based; that is, the first character in <paramref name="strA" /> and <paramref name="strB" /> is at position zero, not position one. The length of the first substring is equal to the length of <paramref name="strA" /> minus <paramref name="indexA" /> plus one. The length of the second substring is equal to the length of <paramref name="strB" /> minus <paramref name="indexB" /> plus one. </para>
@@ -1701,6 +1934,46 @@ public class StringCompareExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares substrings of two specified <see cref="T:System.String" /> objects, ignoring or honoring their case and using culture-specific information to influence the comparison, and returns an integer that indicates their relative position in the sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that indicates the lexical relationship between the two comparands.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>The substring in <paramref name="strA" /> is less than the substring in <paramref name="strB" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>The substrings are equal, or <paramref name="length" /> is zero. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>The substring in <paramref name="strA" /> is greater than the substring in <paramref name="strB" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="strA">
           <attribution license="cc4" from="Microsoft" modified="false" />The first string to use in the comparison. </param>
         <param name="indexA">
@@ -1739,7 +2012,6 @@ public class StringCompareExample {
         <Parameter Name="options" Type="System.Globalization.CompareOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The substrings to compare start in <paramref name="strA" /> at position <paramref name="indexA" /> and in <paramref name="strB" /> at position <paramref name="indexB" />. The length of the first substring is the length of <paramref name="strA" /> minus <paramref name="indexA" />. The length of the second substring is the length of <paramref name="strB" /> minus <paramref name="indexB" />.</para>
@@ -1756,6 +2028,46 @@ public class StringCompareExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares substrings of two specified <see cref="T:System.String" /> objects using the specified comparison options and culture-specific information to influence the comparison, and returns an integer that indicates the relationship of the two substrings to each other in the sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that indicates the lexical relationship between the two substrings, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value</para>
+                </term>
+                <description>
+                  <para>Condition</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero</para>
+              </term>
+              <description>
+                <para>The substring in <paramref name="strA" /> is less than the substring in <paramref name="strB" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>The substrings are equal or <paramref name="length" /> is zero.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero</para>
+              </term>
+              <description>
+                <para>The substring in <paramref name="strA" /> is greater than the substring in <paramref name="strB" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="strA">
           <attribution license="cc4" from="Microsoft" modified="false" />The first string to use in the comparison.   </param>
         <param name="indexA">
@@ -1790,42 +2102,58 @@ public class StringCompareExample {
         <Parameter Name="strB" Type="System.String" />
       </Parameters>
       <Docs>
+        <remarks>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method performs a case-sensitive comparison using ordinal sort rules. For more information about word, string, and ordinal sorts, see <see cref="T:System.Globalization.CompareOptions" />. To perform a case-insensitive comparison using ordinal sort rules, call the <see cref="M:System.String.Compare(System.String,System.String,System.StringComparison)" /> method with a <see cref="T:System.StringComparison" /> value of <see cref="F:System.StringComparison.OrdinalIgnoreCase" />.</para>
+          <para>Because <see cref="M:System.String.CompareOrdinal(System.String,System.String)" /> is a static method, <paramref name="strA" /> and <paramref name="strB" /> can be null. If both values are null, the method returns 0 (zero), which indicates that <paramref name="strA" /> and <paramref name="strB" /> are equal. If only one of the values is null, the method considers the non-null value to be greater. </para>
+        </remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Compares two specified <see cref="T:System.String" /> objects by evaluating the numeric values of the corresponding <see cref="T:System.Char" /> objects in each string.</para>
+        </summary>
         <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the specified strings. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An integer that indicates the lexical relationship between the two comparands.</para>
           <list type="table">
             <listheader>
-              <term>Value</term>
-              <description>Description</description>
+              <item>
+                <term>
+                  <para>Value</para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
             </listheader>
             <item>
-              <term> A negative number</term>
+              <term>
+                <para>Less than zero </para>
+              </term>
               <description>
-                <paramref name="strA" /> is &lt; <paramref name="strB" />, or <paramref name="strA" />
-   is a null reference.</description>
+                <para>

+                                                                                                                                                                                                                                                                                                                                                <paramref name="strA" /> is less than <paramref name="strB" />. </para>
+              </description>
             </item>
             <item>
-              <term> Zero</term>
+              <term>
+                <para>Zero </para>
+              </term>
               <description>
-                <paramref name="strA" /> == <paramref name="strB" />, or both <paramref name="strA" />
-and <paramref name="strB" /> are null references.</description>
+                <para>

+                                                                                                                                                                                                                                                                                                                                                    <paramref name="strA" /> and <paramref name="strB" /> are equal. </para>
+              </description>
             </item>
             <item>
-              <term> A positive number</term>
+              <term>
+                <para>Greater than zero </para>
+              </term>
               <description>
-                <paramref name="strA" /> is &gt; <paramref name="strB" />, or <paramref name="strB" />
-is a null reference.</description>
+                <para>

+                                                                                                                                                                                                                                                                                                                                                        <paramref name="strA" /> is greater than <paramref name="strB" />. </para>
+              </description>
             </item>
           </list>
         </returns>
-        <remarks>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>This method performs a case-sensitive comparison using ordinal sort rules. For more information about word, string, and ordinal sorts, see <see cref="T:System.Globalization.CompareOptions" />. To perform a case-insensitive comparison using ordinal sort rules, call the <see cref="M:System.String.Compare(System.String,System.String,System.StringComparison)" /> method with a <see cref="T:System.StringComparison" /> value of <see cref="F:System.StringComparison.OrdinalIgnoreCase" />.</para>
-          <para>Because <see cref="M:System.String.CompareOrdinal(System.String,System.String)" /> is a static method, <paramref name="strA" /> and <paramref name="strB" /> can be null. If both values are null, the method returns 0 (zero), which indicates that <paramref name="strA" /> and <paramref name="strB" /> are equal. If only one of the values is null, the method considers the non-null value to be greater. </para>
-        </remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Compares two specified <see cref="T:System.String" /> objects by evaluating the numeric values of the corresponding <see cref="T:System.Char" /> objects in each string.</para>
-        </summary>
         <param name="strA">
           <attribution license="cc4" from="Microsoft" modified="false" />The first string to compare. </param>
         <param name="strB">
@@ -1854,33 +2182,6 @@ is a null reference.</description>
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the specified strings. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
-          <list type="table">
-            <listheader>
-              <term>Value Type</term>
-              <description>Condition</description>
-            </listheader>
-            <item>
-              <term> A negative number</term>
-              <description>The substring in <paramref name="strA" /> is &lt; the
-      substring in <paramref name="strB" />, or <paramref name="strA" /> is a null reference.</description>
-            </item>
-            <item>
-              <term> Zero</term>
-              <description>The substring in <paramref name="strA" /> ==
-   the substring in
-<paramref name="strB" />, or both <paramref name="strA" /> and <paramref name="strB" /> are null 
-   references.</description>
-            </item>
-            <item>
-              <term> A positive number</term>
-              <description>The substring in <paramref name="strA" /> is &gt; the substring
-   in <paramref name="strB" />, or <paramref name="strB" /> is a null
-   reference.</description>
-            </item>
-          </list>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="indexA" /> is greater than <paramref name="strA" /> .Length</para>
@@ -1902,6 +2203,46 @@ is a null reference.</description>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares substrings of two specified <see cref="T:System.String" /> objects by evaluating the numeric values of the corresponding <see cref="T:System.Char" /> objects in each substring. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer that indicates the lexical relationship between the two comparands.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value</para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>The substring in <paramref name="strA" /> is less than the substring in <paramref name="strB" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>The substrings are equal, or <paramref name="length" /> is zero. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>The substring in <paramref name="strA" /> is greater than the substring in <paramref name="strB" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="strA">
           <attribution license="cc4" from="Microsoft" modified="false" />The first string to use in the comparison. </param>
         <param name="indexA">
@@ -1932,35 +2273,6 @@ is a null reference.</description>
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="value" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
-          <list type="table">
-            <listheader>
-              <term>Value</term>
-              <description>Condition</description>
-            </listheader>
-            <item>
-              <term> A negative number</term>
-              <description>The current instance is lexicographically &lt;
-      <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> Zero</term>
-              <description>The current instance is lexicographically ==
-      <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term>
-                <para> A positive number</para>
-              </term>
-              <description>
-                <para>The current instance is lexicographically &gt;
-            <paramref name="value" />, or <paramref name="value" /> is a null
-               reference.</para>
-              </description>
-            </item>
-          </list>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="value" /> is not a <see cref="T:System.String" />.</exception>
         <remarks>
@@ -1977,6 +2289,49 @@ is a null reference.</description>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this instance with a specified <see cref="T:System.Object" /> and indicates whether this instance precedes, follows, or appears in the same position in the sort order as the specified <see cref="T:System.Object" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer that indicates whether this instance precedes, follows, or appears in the same position in the sort order as the <paramref name="value" /> parameter.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance precedes <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance has the same position in the sort order as <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance follows <paramref name="value" />.</para>
+                <para>-or- </para>
+                <para>

+                                                                                                                                                                                                                                                                                                                                                    <paramref name="value" /> is null. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that evaluates to a <see cref="T:System.String" />. </param>
       </Docs>
@@ -1998,45 +2353,62 @@ is a null reference.</description>
         <Parameter Name="strB" Type="System.String" />
       </Parameters>
       <Docs>
+        <remarks>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method performs a word (case-sensitive and culture-sensitive) comparison using the current culture. For more information about word, string, and ordinal sorts, see <see cref="T:System.Globalization.CompareOptions" />.</para>
+          <block subset="none" type="note">
+            <para>The <see cref="M:System.String.CompareTo(System.Object)" /> method was designed primarily for use in sorting or alphabetizing operations. It should not be used when the primary purpose of the method call is to determine whether two strings are equivalent. To determine whether two strings are equivalent, call the <see cref="Overload:System.String.Equals" /> method.</para>
+          </block>
+          <para>For more information about the behavior of this method, see the Remarks section of the <see cref="M:System.String.Compare(System.String,System.String)" /> method.</para>
+          <para>This method implements the <see cref="T:System.IComparable`1" /> interface and performs slightly better than the <see cref="M:System.String.CompareTo(System.Object)" /> method, because it does not have to determine whether the <paramref name="value" /> argument is a mutable value type that must be boxed, and it does not have to cast its parameter from an <see cref="T:System.Object" /> to a <see cref="T:System.String" />.</para>
+        </remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Compares this instance with a specified <see cref="T:System.String" /> object and indicates whether this instance precedes, follows, or appears in the same position in the sort order as the specified <see cref="T:System.String" />.</para>
+        </summary>
         <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="strB" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer that indicates whether this instance precedes, follows, or appears in the same position in the sort order as the <paramref name="value" /> parameter.</para>
           <list type="table">
             <listheader>
-              <term>Value</term>
-              <description>Condition</description>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Condition </para>
+                </description>
+              </item>
             </listheader>
             <item>
-              <term> A negative number</term>
-              <description>The current instance is lexicographically &lt;
-      <paramref name="strB" />.</description>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance precedes <paramref name="strB" />. </para>
+              </description>
             </item>
             <item>
-              <term> Zero</term>
-              <description>The current instance is lexicographically ==
-      <paramref name="strB" />.</description>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance has the same position in the sort order as <paramref name="strB" />. </para>
+              </description>
             </item>
             <item>
               <term>
-                <para> A positive number</para>
+                <para>Greater than zero </para>
               </term>
-              <description>The current instance is lexicographically &gt;
-            <paramref name="strB" />, or <paramref name="strB" /> is a null reference.</description>
+              <description>
+                <para>This instance follows <paramref name="strB" />.</para>
+                <para>-or- </para>
+                <para>

+                                                                                                                                                                                                                                                                                                                                                            <paramref name="strB" /> is null. </para>
+              </description>
             </item>
           </list>
         </returns>
-        <remarks>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>This method performs a word (case-sensitive and culture-sensitive) comparison using the current culture. For more information about word, string, and ordinal sorts, see <see cref="T:System.Globalization.CompareOptions" />.</para>
-          <block subset="none" type="note">
-            <para>The <see cref="M:System.String.CompareTo(System.Object)" /> method was designed primarily for use in sorting or alphabetizing operations. It should not be used when the primary purpose of the method call is to determine whether two strings are equivalent. To determine whether two strings are equivalent, call the <see cref="Overload:System.String.Equals" /> method.</para>
-          </block>
-          <para>For more information about the behavior of this method, see the Remarks section of the <see cref="M:System.String.Compare(System.String,System.String)" /> method.</para>
-          <para>This method implements the <see cref="T:System.IComparable`1" /> interface and performs slightly better than the <see cref="M:System.String.CompareTo(System.Object)" /> method, because it does not have to determine whether the <paramref name="value" /> argument is a mutable value type that must be boxed, and it does not have to cast its parameter from an <see cref="T:System.Object" /> to a <see cref="T:System.String" />.</para>
-        </remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Compares this instance with a specified <see cref="T:System.String" /> object and indicates whether this instance precedes, follows, or appears in the same position in the sort order as the specified <see cref="T:System.String" />.</para>
-        </summary>
         <param name="strB">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to compare with this instance. </param>
       </Docs>
@@ -2060,7 +2432,6 @@ is a null reference.</description>
         <Parameter Name="values" Type="System.Collections.Generic.IEnumerable&lt;System.String&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method concatenates each object in <paramref name="values" />; it does not add any delimiters. To specify a delimiter between each member of <paramref name="values" />, call the <see cref="M:System.String.Join(System.String,System.Collections.Generic.IEnumerable{System.String})" /> method.</para>
@@ -2073,6 +2444,10 @@ is a null reference.</description>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Concatenates the members of a constructed <see cref="T:System.Collections.Generic.IEnumerable`1" /> collection of type <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The concatenated strings in <paramref name="values" />.</para>
+        </returns>
         <param name="values">
           <attribution license="cc4" from="Microsoft" modified="false" />A collection object that implements <see cref="T:System.Collections.Generic.IEnumerable`1" /> and whose generic type argument is <see cref="T:System.String" />.</param>
       </Docs>
@@ -2093,7 +2468,6 @@ is a null reference.</description>
         <Parameter Name="arg0" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.String.Concat(System.Object)" /> method represents <paramref name="arg0" /> as a string by calling its parameterless ToString method.</para>
@@ -2102,6 +2476,10 @@ is a null reference.</description>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates the string  representation of a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of <paramref name="arg0" />, or <see cref="F:System.String.Empty" /> if <paramref name="arg0" /> is null.</para>
+        </returns>
         <param name="arg0">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to represent, or null. </param>
       </Docs>
@@ -2129,10 +2507,6 @@ is a null reference.</description>
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>
-          <para>The concatenated <see cref="T:System.String" /> representations of the values of the
-   elements in <paramref name="args" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="args" /> is a null reference.</exception>
         <example>
@@ -2161,6 +2535,10 @@ public class StringConcatExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Concatenates the string representations of the elements in a specified <see cref="T:System.Object" /> array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The concatenated string representations of the values of the elements in <paramref name="args" />.</para>
+        </returns>
         <param name="args">
           <attribution license="cc4" from="Microsoft" modified="false" />An object array that contains the elements to concatenate. </param>
       </Docs>
@@ -2189,9 +2567,6 @@ public class StringConcatExample {
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.String" /> containing the concatenated elements of <paramref name="values" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="values" /> is a null reference.</exception>
         <example>
@@ -2219,6 +2594,10 @@ public class StringConcatExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Concatenates the elements of a specified <see cref="T:System.String" /> array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The concatenated elements of <paramref name="values" />.</para>
+        </returns>
         <param name="values">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of string instances. </param>
       </Docs>
@@ -2242,10 +2621,6 @@ public class StringConcatExample {
         <Parameter Name="arg1" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The concatenated <see cref="T:System.String" /> representation of the values of
-<paramref name="arg0" /> and <paramref name="arg1" />.</para>
-        </returns>
         <example>
           <para>The following example demonstrates concatenating two objects.</para>
           <code lang="C#">using System;
@@ -2273,6 +2648,10 @@ public class StringConcatExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Concatenates the string representations of two specified objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The concatenated string representations of the values of <paramref name="arg0" /> and <paramref name="arg1" />.</para>
+        </returns>
         <param name="arg0">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to concatenate. </param>
         <param name="arg1">
@@ -2298,10 +2677,6 @@ public class StringConcatExample {
         <Parameter Name="str1" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing the concatenation of <paramref name="str0" /> and
-<paramref name="str1" />.</para>
-        </returns>
         <example>
           <para>The following example demonstrates concatenating two strings.</para>
           <code lang="C#">using System;
@@ -2327,6 +2702,10 @@ public class StringConcatExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Concatenates two specified instances of <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The concatenation of <paramref name="str0" /> and <paramref name="str1" />.</para>
+        </returns>
         <param name="str0">
           <attribution license="cc4" from="Microsoft" modified="false" />The first string to concatenate. </param>
         <param name="str1">
@@ -2353,10 +2732,6 @@ public class StringConcatExample {
         <Parameter Name="arg2" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The concatenated <see cref="T:System.String" /> representations of the values of
-<paramref name="arg0" />, <paramref name="arg1" />, and <paramref name="arg2" />.</para>
-        </returns>
         <example>
           <para>The following example demonstrates concatenating three objects.</para>
           <code lang="C#">using System;
@@ -2383,6 +2758,10 @@ public class StringConcatExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Concatenates the string representations of three specified objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The concatenated string representations of the values of <paramref name="arg0" />, <paramref name="arg1" />, and <paramref name="arg2" />.</para>
+        </returns>
         <param name="arg0">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to concatenate. </param>
         <param name="arg1">
@@ -2411,10 +2790,6 @@ public class StringConcatExample {
         <Parameter Name="str2" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing the concatenation of <paramref name="str0" />, <paramref name="str1" />, and
-<paramref name="str2" />.</para>
-        </returns>
         <example>
           <para>The following example demonstrates concatenating three strings.</para>
           <code lang="C#">using System;
@@ -2440,6 +2815,10 @@ public class StringConcatExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Concatenates three specified instances of <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The concatenation of <paramref name="str0" />, <paramref name="str1" />, and <paramref name="str2" />.</para>
+        </returns>
         <param name="str0">
           <attribution license="cc4" from="Microsoft" modified="false" />The first string to concatenate. </param>
         <param name="str1">
@@ -2473,7 +2852,6 @@ public class StringConcatExample {
         <Parameter Name="arg3" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method concatenates each object in the parameter list by calling its parameterless ToString method; it does not add any delimiters.</para>
@@ -2487,6 +2865,10 @@ public class StringConcatExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Concatenates the string representations of four specified objects and any objects specified in an optional variable length parameter list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The concatenated string representation of each value in the parameter list.</para>
+        </returns>
         <param name="arg0">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to concatenate. </param>
         <param name="arg1">
@@ -2516,7 +2898,6 @@ public class StringConcatExample {
         <Parameter Name="str3" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method concatenates <paramref name="str0" />, <paramref name="str1" />, <paramref name="str2" />, and <paramref name="str3" />; it does not add any delimiters.</para>
@@ -2526,6 +2907,10 @@ public class StringConcatExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Concatenates four specified instances of <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The concatenation of <paramref name="str0" />, <paramref name="str1" />, <paramref name="str2" />, and <paramref name="str3" />.</para>
+        </returns>
         <param name="str0">
           <attribution license="cc4" from="Microsoft" modified="false" />The first string to concatenate. </param>
         <param name="str1">
@@ -2558,7 +2943,6 @@ public class StringConcatExample {
         <Parameter Name="values" Type="System.Collections.Generic.IEnumerable&lt;T&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The method concatenates each object in <paramref name="values" />; it does not add any delimiters.</para>
@@ -2570,6 +2954,10 @@ public class StringConcatExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Concatenates the members of an <see cref="T:System.Collections.Generic.IEnumerable`1" /> implementation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The concatenated members in <paramref name="values" />.</para>
+        </returns>
         <param name="values">
           <attribution license="cc4" from="Microsoft" modified="false" />A collection object that implements the <see cref="T:System.Collections.Generic.IEnumerable`1" /> interface.</param>
         <typeparam name="T">
@@ -2591,7 +2979,6 @@ public class StringConcatExample {
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2601,6 +2988,11 @@ public class StringConcatExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether a specified substring occurs within this string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+                                                                                                                                                                                                                                                                                                                                        true if the <paramref name="value" /> parameter occurs within this string, or if <paramref name="value" /> is the empty string (""); otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to seek. </param>
       </Docs>
@@ -2622,10 +3014,6 @@ public class StringConcatExample {
         <Parameter Name="str" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.String" /> with the same value as
-<paramref name="str" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="str" /> is a null reference.</exception>
         <example>
@@ -2659,6 +3047,10 @@ public class StringCopyExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a new instance of <see cref="T:System.String" /> with the same value as a specified <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new string with the same value as <paramref name="str" />.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to copy. </param>
       </Docs>
@@ -2789,13 +3181,6 @@ public class StringCopyToExample {
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the end of the current instance
-   is equal to <paramref name="value" />; <see langword="false" /> if <paramref name="value" /> is not
-   equal to the end of the current instance or is longer than the
-   current instance.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference.</exception>
         <example>
@@ -2829,6 +3214,11 @@ public class StringEndsWithExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the end of this string instance matches the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+                                                                                                                                                                                                                                                                                                                                                                true if <paramref name="value" /> matches the end of this instance; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to compare to the substring at the end of this instance. </param>
       </Docs>
@@ -2855,7 +3245,6 @@ public class StringEndsWithExample {
         <Parameter Name="comparisonType" Type="System.StringComparison" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2865,6 +3254,11 @@ public class StringEndsWithExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the end of this string instance matches the specified string when compared using the specified comparison option.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+                                                                                                                                                                                                                                                                                                                                                                            true if the <paramref name="value" /> parameter matches the end of this string; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to compare to the substring at the end of this instance. </param>
         <param name="comparisonType">
@@ -2888,7 +3282,6 @@ public class StringEndsWithExample {
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2899,6 +3292,11 @@ public class StringEndsWithExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the end of this string instance matches the specified string when compared using the specified culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+                                                                                                                                                                                                                                                                                                                                                                        true if the <paramref name="value" /> parameter matches the end of this string; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to compare to the substring at the end of this instance. </param>
         <param name="ignoreCase">
@@ -2930,12 +3328,6 @@ public class StringEndsWithExample {
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> is a <see cref="T:System.String" /> and its value is
-   the same as the value of the current instance; otherwise,
-<see langword="false" />.</para>
-        </returns>
         <exception cref="T:System.NullReferenceException">The current instance is a null reference.</exception>
         <example>
           <para>The following example demonstrates checking to see if an object is equal to 
@@ -2967,6 +3359,11 @@ public class StringEqualsExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether this instance and a specified object, which must also be a <see cref="T:System.String" /> object, have the same value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+                                                                                                                                                                                                                                                                                                                                                                                true if <paramref name="obj" /> is a <see cref="T:System.String" /> and its value is the same as this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to compare to this instance. </param>
       </Docs>
@@ -2993,10 +3390,6 @@ public class StringEqualsExample {
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the value of <paramref name="value" /> is the same as the value of the current instance; otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method performs an ordinal (case-sensitive and culture-insensitive) comparison.</para>
@@ -3005,6 +3398,11 @@ public class StringEqualsExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether this instance and another specified <see cref="T:System.String" /> object have the same value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+                                                                                                                                                                                                                                                                                                                                                                                true if the value of the <paramref name="value" /> parameter is the same as this instance; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to compare to this instance. </param>
       </Docs>
@@ -3027,11 +3425,6 @@ public class StringEqualsExample {
         <Parameter Name="b" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true " />if the value of <paramref name="a" /> is the
-   same as the value of <paramref name="b" />; otherwise, <see langword="false" />.</para>
-        </returns>
         <example>
           <para>The following example demonstrates checking to see if two strings are 
       equal.</para>
@@ -3062,6 +3455,11 @@ public class StringEqualsExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two specified <see cref="T:System.String" /> objects have the same value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+                                                                                                                                                                                                                                                                                                                                                                                true if the value of <paramref name="a" /> is the same as the value of <paramref name="b" />; otherwise, false. If both <paramref name="a" /> and <paramref name="b" /> are null, the method returns true.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The first string to compare, or null. </param>
         <param name="b">
@@ -3085,7 +3483,6 @@ public class StringEqualsExample {
         <Parameter Name="comparisonType" Type="System.StringComparison" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3095,6 +3492,11 @@ public class StringEqualsExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether this string and a specified <see cref="T:System.String" /> object have the same value. A parameter specifies the culture, case, and sort rules used in the comparison.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+                                                                                                                                                                                                                                                                                                                                                                                    true if the value of the <paramref name="value" /> parameter is the same as this string; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to compare to this instance.</param>
         <param name="comparisonType">
@@ -3118,7 +3520,6 @@ public class StringEqualsExample {
         <Parameter Name="comparisonType" Type="System.StringComparison" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3128,6 +3529,11 @@ public class StringEqualsExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two specified <see cref="T:System.String" /> objects have the same value. A parameter specifies the culture, case, and sort rules used in the comparison.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+                                                                                                                                                                                                                                                                                                                                                                                true if the value of the <paramref name="a" /> parameter is equal to the value of the <paramref name="b" /> parameter; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The first string to compare, or null. </param>
         <param name="b">
@@ -3154,11 +3560,6 @@ public class StringEqualsExample {
         <Parameter Name="arg0" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A copy of <paramref name="format" /> in which the
-   first format specification has been replaced by the formatted <see cref="T:System.String" /> equivalent of the
-<paramref name="arg0" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="format " /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -3193,6 +3594,10 @@ The museum had 88     visitors today.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Replaces one or more format items in a specified string with the string representation of a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of <paramref name="format" /> in which any format items are replaced by the string representation of <paramref name="arg0" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A <format type="text/html"><a href="87b7d528-73f6-43c6-b71a-f23043039a49">composite format string</a></format>. </param>
         <param name="arg0">
@@ -3224,11 +3629,6 @@ The museum had 88     visitors today.
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing a copy of <paramref name="format" /> in which the format
-   specifications have been replaced by the <see cref="T:System.String" /> equivalent of the corresponding
-   instances of <see cref="T:System.Object" /> in <paramref name="args" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="format" /> or <paramref name="args " />is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -3264,6 +3664,10 @@ The winning numbers were 5     10    11    37    42     today.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Replaces the format item in a specified string with the string representation of a corresponding object in a specified array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of <paramref name="format" /> in which the format items have been replaced by the string representation of the corresponding objects in <paramref name="args" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A <format type="text/html"><a href="87b7d528-73f6-43c6-b71a-f23043039a49">composite format string</a></format>.</param>
         <param name="args">
@@ -3296,11 +3700,6 @@ The winning numbers were 5     10    11    37    42     today.
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing a copy of <paramref name="format" /> in which the format
-   specifications have been replaced by the <see cref="T:System.String" /> equivalent of the corresponding
-   instances of <see cref="T:System.Object" /> in <paramref name="args" /> .</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="format" /> or <paramref name="args" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -3319,6 +3718,10 @@ The winning numbers were 5     10    11    37    42     today.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Replaces the format items in a specified string with the string representations of corresponding objects in a specified array. A parameter supplies culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of <paramref name="format" /> in which the format items have been replaced by the string representation of the corresponding objects in <paramref name="args" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information. </param>
         <param name="format">
@@ -3347,11 +3750,6 @@ The winning numbers were 5     10    11    37    42     today.
         <Parameter Name="arg1" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing a copy of <paramref name="format" /> in which the format
-   specifications have been replaced by the <see cref="T:System.String" /> equivalent of <paramref name="arg0" /> and
-<paramref name="arg1" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="format" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -3388,6 +3786,10 @@ The temperature today oscillated between 78   and 100  degrees.
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Replaces the format items in a specified string with the string representation of two specified objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of <paramref name="format" /> in which format items are replaced by the string representations of <paramref name="arg0" /> and <paramref name="arg1" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A <format type="text/html"><a href="87b7d528-73f6-43c6-b71a-f23043039a49">composite format string</a></format>. </param>
         <param name="arg0">
@@ -3417,11 +3819,6 @@ The temperature today oscillated between 78   and 100  degrees.
         <Parameter Name="arg2" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing a copy of <paramref name="format" /> in which the first, second,
-   and third format specifications have been replaced by the <see cref="T:System.String" /> equivalent of
-<paramref name="arg0" />, <paramref name="arg1" />, and <paramref name="arg2" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="format" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -3456,6 +3853,10 @@ The temperature today oscillated between   78 and  100 degrees. The average temp
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Replaces the format items in a specified string with the string representation of three specified objects.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A copy of <paramref name="format" /> in which the format items have been replaced by the string representations of <paramref name="arg0" />, <paramref name="arg1" />, and <paramref name="arg2" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A <format type="text/html"><a href="87b7d528-73f6-43c6-b71a-f23043039a49">composite format string</a></format>.</param>
         <param name="arg0">
@@ -3482,9 +3883,6 @@ The temperature today oscillated between   78 and  100 degrees. The average temp
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.CharEnumerator" /> object.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method enables you to iterate the individual characters in a string. For example, the Visual Basic For Each and C# foreach statements invoke this method to return a <see cref="T:System.CharEnumerator" /> object that can provide read-only access to the characters in this string instance. </para>
@@ -3493,6 +3891,10 @@ The temperature today oscillated between   78 and  100 degrees. The average temp
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves an object that can iterate through the individual characters in this string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator object.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -3516,9 +3918,6 @@ The temperature today oscillated between   78 and  100 degrees. The average temp
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the hash code for this instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The behavior of <see cref="M:System.String.GetHashCode" /> is dependent on its implementation, which might change from one version of the common language runtime to another. A reason why this might happen is to improve the performance of <see cref="M:System.String.GetHashCode" />. </para>
@@ -3559,6 +3958,10 @@ The temperature today oscillated between   78 and  100 degrees. The average temp
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -3576,12 +3979,15 @@ The temperature today oscillated between   78 and  100 degrees. The average temp
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.TypeCode" /> for class <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The enumerated constant, <see cref="F:System.TypeCode.String" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IndexOf">
@@ -3601,10 +4007,6 @@ The temperature today oscillated between   78 and  100 degrees. The average temp
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the zero-based index of the first occurrence of <paramref name="value" />
-   character in the current instance; otherwise, -1 if <paramref name="value" /> was not found.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Index numbering starts from zero.</para>
@@ -3614,6 +4016,10 @@ The temperature today oscillated between   78 and  100 degrees. The average temp
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reports the zero-based index of the first occurrence of the specified Unicode character in this string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index position of <paramref name="value" /> if that character is found, or -1 if it is not.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A Unicode character to seek. </param>
       </Docs>
@@ -3636,30 +4042,6 @@ The temperature today oscillated between   78 and  100 degrees. The average temp
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> that indicates the result of the search for
-<paramref name="value" /> in the current instance as follows:</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> A zero-based number equal to the index of the start of the first substring in
-         the current instance that is equal to <paramref name="value" />
-         
-         .</term>
-              <description>
-                <paramref name="value" />
-   was found starting at the index returned.</description>
-            </item>
-            <item>
-              <term> -1</term>
-              <description>
-                <paramref name="value" /> was not found.</description>
-            </item>
-          </list>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference.</exception>
         <example>
@@ -3693,6 +4075,10 @@ public class StringIndexOf {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reports the zero-based index of the first occurrence of the specified string in this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index position of <paramref name="value" /> if that string is found, or -1 if it is not. If <paramref name="value" /> is <see cref="F:System.String.Empty" />, the return value is 0.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to seek. </param>
       </Docs>
@@ -3716,10 +4102,6 @@ public class StringIndexOf {
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Int32" /> containing the zero-based index of the first occurrence of
-<paramref name="value" /> in the current instance starting from the specified index; otherwise, -1 if <paramref name="value" /> was not found.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="startIndex" /> is less than zero or greater than the length of the current instance.</exception>
         <example>
@@ -3750,6 +4132,10 @@ public class StringIndexOf {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reports the zero-based index of the first occurrence of the specified Unicode character in this string. The search starts at a specified character position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index position of <paramref name="value" /> if that character is found, or -1 if it is not.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A Unicode character to seek. </param>
         <param name="startIndex">
@@ -3775,28 +4161,6 @@ public class StringIndexOf {
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> that indicates the result of the search for
-<paramref name="value" /> in the current instance as follows:</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> A zero-based number equal to the index of the start of the first substring in
-         the current instance that is equal to <paramref name="value" />
-         .</term>
-              <description>
-                <paramref name="value" /> was found starting at the index returned.</description>
-            </item>
-            <item>
-              <term> -1</term>
-              <description>
-                <paramref name="value" /> was not found.</description>
-            </item>
-          </list>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -3814,6 +4178,10 @@ public class StringIndexOf {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reports the zero-based index of the first occurrence of the specified string in this instance. The search starts at a specified character position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index position of <paramref name="value" /> if that string is found, or -1 if it is not. If <paramref name="value" /> is <see cref="F:System.String.Empty" />, the return value is <paramref name="startIndex" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to seek. </param>
         <param name="startIndex">
@@ -3837,7 +4205,6 @@ public class StringIndexOf {
         <Parameter Name="comparisonType" Type="System.StringComparison" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3848,6 +4215,10 @@ public class StringIndexOf {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reports the zero-based index of the first occurrence of the specified string in the current <see cref="T:System.String" /> object. A parameter specifies the type of search to use for the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index position of the <paramref name="value" /> parameter if that string is found, or -1 if it is not. If <paramref name="value" /> is <see cref="F:System.String.Empty" />, the return value is 0.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to seek. </param>
         <param name="comparisonType">
@@ -3873,12 +4244,6 @@ public class StringIndexOf {
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Int32" /> containing the zero-based index of
-   the first occurrence of <paramref name="value" /> in the current instance in the specified range of indexes; otherwise, -1 if
-<paramref name="value" />
-was not found.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="startIndex" /> or <paramref name="count" /> is negative</para>
@@ -3896,6 +4261,10 @@ was not found.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reports the zero-based index of the first occurrence of the specified character in this instance. The search starts at a specified character position and examines a specified number of character positions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index position of <paramref name="value" /> if that character is found, or -1 if it is not.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A Unicode character to seek. </param>
         <param name="startIndex">
@@ -3924,28 +4293,6 @@ was not found.</para>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> that indicates the result of the search for
-<paramref name="value" /> in the current instance as follows:</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> A zero-based number equal to the index of the start of the first substring in
-         the current instance that is equal to <paramref name="value" />
-         .</term>
-              <description>
-                <paramref name="value" /> was found starting at the index returned.</description>
-            </item>
-            <item>
-              <term> -1</term>
-              <description>
-                <paramref name="value" /> was not found.</description>
-            </item>
-          </list>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -3966,6 +4313,10 @@ was not found.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reports the zero-based index of the first occurrence of the specified string in this instance. The search starts at a specified character position and examines a specified number of character positions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index position of <paramref name="value" /> if that string is found, or -1 if it is not. If <paramref name="value" /> is <see cref="F:System.String.Empty" />, the return value is <paramref name="startIndex" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to seek. </param>
         <param name="startIndex">
@@ -3992,7 +4343,6 @@ was not found.</para>
         <Parameter Name="comparisonType" Type="System.StringComparison" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4003,6 +4353,10 @@ was not found.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reports the zero-based index of the first occurrence of the specified string in the current <see cref="T:System.String" /> object. Parameters specify the starting search position in the current string and the type of search to use for the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index position of the <paramref name="value" /> parameter if that string is found, or -1 if it is not. If <paramref name="value" /> is <see cref="F:System.String.Empty" />, the return value is <paramref name="startIndex" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to seek. </param>
         <param name="startIndex">
@@ -4029,7 +4383,6 @@ was not found.</para>
         <Parameter Name="comparisonType" Type="System.StringComparison" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4041,6 +4394,10 @@ was not found.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reports the zero-based index of the first occurrence of the specified string in the current <see cref="T:System.String" /> object. Parameters specify the starting search position in the current string, the number of characters in the current string to search, and the type of search to use for the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index position of the <paramref name="value" /> parameter if that string is found, or -1 if it is not. If <paramref name="value" /> is <see cref="F:System.String.Empty" />, the return value is <paramref name="startIndex" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to seek. </param>
         <param name="startIndex">
@@ -4068,10 +4425,6 @@ was not found.</para>
         <Parameter Name="anyOf" Type="System.Char[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The index of the first occurrence of an element of <paramref name="anyOf" /> in the
-   current instance; otherwise, -1 if no element of <paramref name="anyOf" /> was found.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="anyOf" /> is a null reference.</exception>
         <remarks>
@@ -4084,6 +4437,10 @@ was not found.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reports the zero-based index of the first occurrence in this instance of any character in a specified array of Unicode characters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index position of the first occurrence in this instance where any character in <paramref name="anyOf" /> was found; -1 if no character in <paramref name="anyOf" /> was found.</para>
+        </returns>
         <param name="anyOf">
           <attribution license="cc4" from="Microsoft" modified="false" />A Unicode character array containing one or more characters to seek. </param>
       </Docs>
@@ -4107,12 +4464,6 @@ was not found.</para>
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing a positive value equal to the index of the
-   first occurrence of an element of <paramref name="anyOf" /> in the current instance;
-   otherwise, -1 if no element of <paramref name="anyOf" />
-   was found.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="anyOf" /> is a null reference.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -4128,6 +4479,10 @@ was not found.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reports the zero-based index of the first occurrence in this instance of any character in a specified array of Unicode characters. The search starts at a specified character position.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index position of the first occurrence in this instance where any character in <paramref name="anyOf" /> was found; -1 if no character in <paramref name="anyOf" /> was found.</para>
+        </returns>
         <param name="anyOf">
           <attribution license="cc4" from="Microsoft" modified="false" />A Unicode character array containing one or more characters to seek. </param>
         <param name="startIndex">
@@ -4154,11 +4509,6 @@ was not found.</para>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing a positive value equal to the index of
-   the first occurrence of an element of <paramref name="anyOf" /> in the current instance;
-   otherwise, -1 if no element of <paramref name="anyOf" /> was found.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="anyOf" /> is a null reference.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -4179,6 +4529,10 @@ was not found.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reports the zero-based index of the first occurrence in this instance of any character in a specified array of Unicode characters. The search starts at a specified character position and examines a specified number of character positions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index position of the first occurrence in this instance where any character in <paramref name="anyOf" /> was found; -1 if no character in <paramref name="anyOf" /> was found.</para>
+        </returns>
         <param name="anyOf">
           <attribution license="cc4" from="Microsoft" modified="false" />A Unicode character array containing one or more characters to seek. </param>
         <param name="startIndex">
@@ -4206,10 +4560,6 @@ was not found.</para>
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.String" /> that is equivalent to the current string with
-<paramref name="value" /> inserted at index <paramref name="startIndex." /></para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference. </exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -4228,6 +4578,10 @@ was not found.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new string in which a specified string is inserted at a specified index position in this instance. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new string that is equivalent to this instance, but with <paramref name="value" /> inserted at position <paramref name="startIndex" />.</para>
+        </returns>
         <param name="startIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based index position of the insertion. </param>
         <param name="value">
@@ -4252,10 +4606,6 @@ was not found.</para>
         <Parameter Name="str" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> The <see cref="T:System.String" /> reference to <paramref name="str" />.
-   </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="str" /> is a null reference. </exception>
         <example>
@@ -4304,6 +4654,10 @@ public class StringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves the system's reference to the specified <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The system's reference to <paramref name="str" />, if it is interned; otherwise, a new reference to a string with the value of <paramref name="str" />.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />A string to search for in the intern pool. </param>
       </Docs>
@@ -4326,10 +4680,6 @@ public class StringExample {
         <Parameter Name="str" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.String" /> reference to <paramref name="str" /> if it is in the system's
-   intern pool; otherwise, a null reference.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="str" /> is a null reference. </exception>
         <example>
@@ -4368,6 +4718,10 @@ public class StringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a reference to a specified <see cref="T:System.String" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A reference to <paramref name="str" /> if it is in the common language runtime intern pool; otherwise, null.</para>
+        </returns>
         <param name="str">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to search for in the intern pool. </param>
       </Docs>
@@ -4386,7 +4740,6 @@ public class StringExample {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4398,6 +4751,11 @@ public class StringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether this string is in Unicode normalization form C.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        true if this string is in normalization form C; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsNormalized">
@@ -4415,7 +4773,6 @@ public class StringExample {
         <Parameter Name="normalizationForm" Type="System.Text.NormalizationForm" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4427,6 +4784,11 @@ public class StringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether this string is in the specified Unicode normalization form.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        true if this string is in the normalization form specified by the <paramref name="normalizationForm" /> parameter; otherwise, false.</para>
+        </returns>
         <param name="normalizationForm">
           <attribution license="cc4" from="Microsoft" modified="false" />A Unicode normalization form. </param>
       </Docs>
@@ -4446,7 +4808,6 @@ public class StringExample {
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4459,6 +4820,11 @@ public class StringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether the specified string is null or an <see cref="F:System.String.Empty" /> string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        true if the <paramref name="value" /> parameter is null or an empty string (""); otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to test. </param>
       </Docs>
@@ -4477,7 +4843,6 @@ public class StringExample {
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>

@@ -4489,6 +4854,11 @@ public class StringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a specified string is null, empty, or consists only of white-space characters.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            true if the <paramref name="value" /> parameter is null or <see cref="F:System.String.Empty" />, or if <paramref name="value" /> consists exclusively of white-space characters. </para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to test.</param>
       </Docs>
@@ -4513,7 +4883,6 @@ public class StringExample {
         <Parameter Name="values" Type="System.Collections.Generic.IEnumerable&lt;System.String&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="separator" /> is null, an empty string (<see cref="F:System.String.Empty" />) is used instead. If any member of <paramref name="values" /> is null, an empty string is used instead.</para>
@@ -4525,6 +4894,10 @@ public class StringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Concatenates the members of a constructed <see cref="T:System.Collections.Generic.IEnumerable`1" /> collection of type <see cref="T:System.String" />, using the specified separator between each member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that consists of the members of <paramref name="values" /> delimited by the <paramref name="separator" /> string. If <paramref name="values" /> has no members, the method returns <see cref="F:System.String.Empty" />.</para>
+        </returns>
         <param name="separator">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to use as a separator. <paramref name="separator" /> is included in the returned string only if <paramref name="values" /> has more than one element.</param>
         <param name="values">
@@ -4557,7 +4930,6 @@ public class StringExample {
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="separator" /> is null or if any element of <paramref name="values" /> other than the first element is null, an empty string (<see cref="F:System.String.Empty" />) is used instead. See the Notes for Callers section if the first element of <paramref name="values" /> is null.</para>
@@ -4568,6 +4940,10 @@ public class StringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Concatenates the elements of an object array, using the specified separator between each element.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that consists of the elements of <paramref name="values" /> delimited by the <paramref name="separator" /> string. If <paramref name="values" /> is an empty array, the method returns <see cref="F:System.String.Empty" />.</para>
+        </returns>
         <param name="separator">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to use as a separator. <paramref name="separator" /> is included in the returned string only if <paramref name="values" /> has more than one element.</param>
         <param name="values">
@@ -4598,11 +4974,6 @@ public class StringExample {
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.String" /> consisting of the elements of <paramref name="value" /> separated
-   by instances of the <paramref name="separator" />
-   string.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference. </exception>
         <example>
@@ -4630,6 +5001,10 @@ public class StringJoin {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Concatenates all the elements of a string array, using the specified separator between each element. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that consists of the elements in <paramref name="value" /> delimited by the <paramref name="separator" /> string. If <paramref name="value" /> is an empty array, the method returns <see cref="F:System.String.Empty" />.</para>
+        </returns>
         <param name="separator">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to use as a separator. <paramref name="separator" /> is included in the returned string only if <paramref name="value" /> has more than one element.</param>
         <param name="value">
@@ -4657,12 +5032,6 @@ public class StringJoin {
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.String" /> consisting of the specified strings in <paramref name="value" /> joined by
-<paramref name="separator" />. Returns <see cref="F:System.String.Empty" /> if <paramref name="count" /> is zero, <paramref name="value" /> has no
-   elements, or <paramref name="separator" /> and all the elements of <paramref name="value" /> are
-<see langword="Empty" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="startIndex" /> plus <paramref name="count" /> is greater than the number of elements in <paramref name="value" />.</exception>
         <example>
@@ -4690,6 +5059,13 @@ public class StringJoin {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Concatenates the specified elements of a string array, using the specified separator between each element. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that consists of the strings in <paramref name="value" /> delimited by the <paramref name="separator" /> string. </para>
+          <para>-or-</para>
+          <para>

+                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            <see cref="F:System.String.Empty" /> if <paramref name="count" /> is zero, <paramref name="value" /> has no elements, or <paramref name="separator" /> and all the elements of <paramref name="value" /> are <see cref="F:System.String.Empty" />.</para>
+        </returns>
         <param name="separator">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to use as a separator. <paramref name="separator" /> is included in the returned string only if <paramref name="value" /> has more than one element.</param>
         <param name="value">
@@ -4724,7 +5100,6 @@ public class StringJoin {
         <Parameter Name="values" Type="System.Collections.Generic.IEnumerable&lt;T&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="separator" /> is null, an empty string (<see cref="F:System.String.Empty" />) is used instead. If any member of <paramref name="values" /> is null, an empty string is used instead.</para>
@@ -4737,6 +5112,10 @@ public class StringJoin {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Concatenates the members of a collection, using the specified separator between each member.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that consists of the members of <paramref name="values" /> delimited by the <paramref name="separator" /> string. If <paramref name="values" /> has no members, the method returns <see cref="F:System.String.Empty" />.</para>
+        </returns>
         <param name="separator">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to use as a separator. <paramref name="separator" /> is included in the returned string only if <paramref name="values" /> has more than one element.</param>
         <param name="values">
@@ -4762,10 +5141,6 @@ public class StringJoin {
         <Parameter Name="value" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Int32" /> containing the index of the last occurrence of <paramref name="value" />
-in the current instance, if found; otherwise, -1.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Index numbering starts from zero. That is, the first character in the string is at index zero and the last is at <see cref="P:System.String.Length" /> - 1.</para>
@@ -4776,6 +5151,10 @@ in the current instance, if found; otherwise, -1.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reports the zero-based index position of the last occurrence of a specified Unicode character within this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index position of <paramref name="value" /> if that character is found, or -1 if it is not.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to seek. </param>
       </Docs>
@@ -4798,11 +5177,6 @@ in the current instance, if found; otherwise, -1.</para>
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-   A <see cref="T:System.Int32" /> that indicates the result of the search for <paramref name="value" />
-   in the current instance as follows:<list type="table"><listheader><term>Return Value</term><description>Description</description></listheader><item><term> A zero-based number equal to the index of the start of the last substring in
-         the current instance that is equal to <paramref name="value" />
-         .</term><description><paramref name="value" /> was found.</description></item><item><term> -1</term><description><paramref name="value" /> was not found.</description></item></list></returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference.</exception>
         <remarks>
@@ -4817,6 +5191,10 @@ in the current instance, if found; otherwise, -1.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reports the zero-based index position of the last occurrence of a specified string within this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based starting index position of <paramref name="value" /> if that string is found, or -1 if it is not. If <paramref name="value" /> is <see cref="F:System.String.Empty" />, the return value is the last index position in this instance.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to seek. </param>
       </Docs>
@@ -4840,9 +5218,6 @@ in the current instance, if found; otherwise, -1.</para>
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Int32" /> containing the index of the last occurrence of <paramref name="value" /> in the current instance, if found; otherwise, -1.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -4875,6 +5250,10 @@ public class StringLastIndexOfTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reports the zero-based index position of the last occurrence of a specified Unicode character within this instance. The search starts at a specified character position and proceeds backward toward the beginning of the string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index position of <paramref name="value" /> if that character is found, or -1 if it is not found or if the current instance equals <see cref="F:System.String.Empty" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to seek. </param>
         <param name="startIndex">
@@ -4900,28 +5279,6 @@ public class StringLastIndexOfTest {
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> that indicates the result of the search for <paramref name="value" />
-in the current instance as follows:</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> A zero-based number equal to the index of the start of the last substring in
-         the current instance that is equal to <paramref name="value" />
-         .</term>
-              <description>
-                <paramref name="value" /> was found.</description>
-            </item>
-            <item>
-              <term> -1</term>
-              <description>
-                <paramref name="value" /> was not found.</description>
-            </item>
-          </list>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference. <paramref name="" /></exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -4938,6 +5295,10 @@ in the current instance as follows:</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reports the zero-based index position of the last occurrence of a specified string within this instance. The search starts at a specified character position and proceeds backward toward the beginning of the string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based starting index position of <paramref name="value" /> if that string is found, or -1 if it is not found or if the current instance equals <see cref="F:System.String.Empty" />. If <paramref name="value" /> is <see cref="F:System.String.Empty" />, the return value is the smaller of <paramref name="startIndex" /> and the last index position in this instance.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to seek. </param>
         <param name="startIndex">
@@ -4961,7 +5322,6 @@ in the current instance as follows:</para>
         <Parameter Name="comparisonType" Type="System.StringComparison" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4973,6 +5333,10 @@ in the current instance as follows:</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reports the zero-based index of the last occurrence of a specified string within the current <see cref="T:System.String" /> object. A parameter specifies the type of search to use for the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based starting index position of the <paramref name="value" /> parameter if that string is found, or -1 if it is not. If <paramref name="value" /> is <see cref="F:System.String.Empty" />, the return value is the last index position in this instance.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to seek. </param>
         <param name="comparisonType">
@@ -4998,11 +5362,6 @@ in the current instance as follows:</para>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Int32" /> containing the index of the last occurrence of <paramref name="value" /> in the
-   current instance if found between <paramref name="startIndex" /> and (<paramref name="startIndex" /> -
-<paramref name="count" /> + 1); otherwise, -1.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -5022,6 +5381,10 @@ in the current instance as follows:</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reports the zero-based index position of the last occurrence of the specified Unicode character in a substring within this instance. The search starts at a specified character position and proceeds backward toward the beginning of the string for a specified number of character positions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based index position of <paramref name="value" /> if that character is found, or -1 if it is not found or if the current instance equals <see cref="F:System.String.Empty" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to seek. </param>
         <param name="startIndex">
@@ -5050,11 +5413,6 @@ in the current instance as follows:</para>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-   A <see cref="T:System.Int32" /> that indicates the result of the search for <paramref name="value" />
-   in the current instance as follows:<list type="table"><listheader><term>Return Value</term><description>Description</description></listheader><item><term> A zero-based number equal to the index of the start of the last substring in
-         the current instance that is equal to <paramref name="value" />
-         .</term><description><paramref name="value" /> was found.</description></item><item><term> -1</term><description><paramref name="value" /> was not found.</description></item></list></returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value " />is a null reference.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -5076,6 +5434,10 @@ in the current instance as follows:</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reports the zero-based index position of the last occurrence of a specified string within this instance. The search starts at a specified character position and proceeds backward toward the beginning of the string for a specified number of character positions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based starting index position of <paramref name="value" /> if that string is found, or -1 if it is not found or if the current instance equals <see cref="F:System.String.Empty" />. If <paramref name="value" /> is <see cref="F:System.String.Empty" />, the return value is the smaller of <paramref name="startIndex" /> and the last index position in this instance.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to seek. </param>
         <param name="startIndex">
@@ -5102,7 +5464,6 @@ in the current instance as follows:</para>
         <Parameter Name="comparisonType" Type="System.StringComparison" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -5114,6 +5475,10 @@ in the current instance as follows:</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reports the zero-based index of the last occurrence of a specified string within the current <see cref="T:System.String" /> object. The search starts at a specified character position and proceeds backward toward the beginning of the string. A parameter specifies the type of comparison to perform when searching for the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based starting index position of the <paramref name="value" /> parameter if that string is found, or -1 if it is not found or if the current instance equals <see cref="F:System.String.Empty" />. If <paramref name="value" /> is <see cref="F:System.String.Empty" />, the return value is the smaller of <paramref name="startIndex" /> and the last index position in this instance.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to seek. </param>
         <param name="startIndex">
@@ -5140,7 +5505,6 @@ in the current instance as follows:</para>
         <Parameter Name="comparisonType" Type="System.StringComparison" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -5153,6 +5517,10 @@ in the current instance as follows:</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reports the zero-based index position of the last occurrence of a specified string within this instance. The search starts at a specified character position and proceeds backward toward the beginning of the string for the specified number of character positions. A parameter specifies the type of comparison to perform when searching for the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The zero-based starting index position of the <paramref name="value" /> parameter if that string is found, or -1 if it is not found or if the current instance equals <see cref="F:System.String.Empty" />. If <paramref name="value" /> is <see cref="F:System.String.Empty" />, the return value is the smaller of <paramref name="startIndex" /> and the last index position in this instance.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to seek. </param>
         <param name="startIndex">
@@ -5180,10 +5548,6 @@ in the current instance as follows:</para>
         <Parameter Name="anyOf" Type="System.Char[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the index of the last occurrence of any element of
-<paramref name="anyOf" /> in the current instance, if found; otherwise, -1.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="anyOf" /> is a null reference. </exception>
         <remarks>
@@ -5196,6 +5560,10 @@ in the current instance as follows:</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reports the zero-based index position of the last occurrence in this instance of one or more characters specified in a Unicode array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index position of the last occurrence in this instance where any character in <paramref name="anyOf" /> was found; -1 if no character in <paramref name="anyOf" /> was found.</para>
+        </returns>
         <param name="anyOf">
           <attribution license="cc4" from="Microsoft" modified="false" />A Unicode character array containing one or more characters to seek. </param>
       </Docs>
@@ -5219,10 +5587,6 @@ in the current instance as follows:</para>
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the index of the last occurrence of any element of <paramref name="anyOf" /> in the
-   current instance, if found; otherwise, -1.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="anyOf" /> is a null reference.<paramref name="" /></exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -5239,6 +5603,10 @@ in the current instance as follows:</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reports the zero-based index position of the last occurrence in this instance of one or more characters specified in a Unicode array. The search starts at a specified character position and proceeds backward toward the beginning of the string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index position of the last occurrence in this instance where any character in <paramref name="anyOf" /> was found; -1 if no character in <paramref name="anyOf" /> was found or if the current instance equals <see cref="F:System.String.Empty" />.</para>
+        </returns>
         <param name="anyOf">
           <attribution license="cc4" from="Microsoft" modified="false" />A Unicode character array containing one or more characters to seek. </param>
         <param name="startIndex">
@@ -5265,11 +5633,6 @@ in the current instance as follows:</para>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the index of the last occurrence of any element of
-<paramref name="anyOf" /> if found between <paramref name="startIndex" /> and (<paramref name="startIndex" /> -
-<paramref name="count" /> + 1); otherwise, -1.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="anyOf" /> is a null reference.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -5289,6 +5652,10 @@ in the current instance as follows:</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Reports the zero-based index position of the last occurrence in this instance of one or more characters specified in a Unicode array. The search starts at a specified character position and proceeds backward toward the beginning of the string for a specified number of character positions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The index position of the last occurrence in this instance where any character in <paramref name="anyOf" /> was found; -1 if no character in <paramref name="anyOf" /> was found or if the current instance equals <see cref="F:System.String.Empty" />.</para>
+        </returns>
         <param name="anyOf">
           <attribution license="cc4" from="Microsoft" modified="false" />A Unicode character array containing one or more characters to seek. </param>
         <param name="startIndex">
@@ -5358,7 +5725,6 @@ public class StringLengthExample {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -5397,6 +5763,10 @@ public class StringLengthExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new string whose textual value is the same as this string, but whose binary representation is in Unicode normalization form C.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new, normalized string whose textual value is the same as this string, but whose binary representation is in normalization form C.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Normalize">
@@ -5414,7 +5784,6 @@ public class StringLengthExample {
         <Parameter Name="normalizationForm" Type="System.Text.NormalizationForm" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -5441,6 +5810,10 @@ public class StringLengthExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new string whose textual value is the same as this string, but whose binary representation is in the specified Unicode normalization form.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new string whose textual value is the same as this string, but whose binary representation is in the normalization form specified by the <paramref name="normalizationForm" /> parameter.</para>
+        </returns>
         <param name="normalizationForm">
           <attribution license="cc4" from="Microsoft" modified="false" />A Unicode normalization form. </param>
       </Docs>
@@ -5463,11 +5836,6 @@ public class StringLengthExample {
         <Parameter Name="b" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="a" /> and <paramref name="b" />
-represent the same string value; otherwise, <see langword="false" />.</para>
-        </returns>
         <altmember cref="M:System.String.Equals(System.Object)" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -5480,6 +5848,11 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two specified strings have the same value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        true if the value of <paramref name="a" /> is the same as the value of <paramref name="b" />; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The first string to compare, or null. </param>
         <param name="b">
@@ -5505,11 +5878,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="b" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="a" /> and <paramref name="b" /> do not
-   represent the same string value; otherwise, <see langword="false" />.</para>
-        </returns>
         <altmember cref="M:System.String.Equals(System.Object)" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -5523,6 +5891,11 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two specified strings have different values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        true if the value of <paramref name="a" /> is different from the value of <paramref name="b" />; otherwise, false.</para>
+        </returns>
         <param name="a">
           <attribution license="cc4" from="Microsoft" modified="false" />The first string to compare, or null. </param>
         <param name="b">
@@ -5547,13 +5920,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="totalWidth" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.String" /> that 
-   is equivalent to the current instance right-aligned and padded on the left with as
-   many spaces as needed to create a length of <paramref name="totalWidth" />. If <paramref name="totalWidth" /> is less than the length of the current instance, returns a new
-<see cref="T:System.String" /> that is identical 
-   to the current instance.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="totalWidth " /> is less than zero.</exception>
         <remarks>
@@ -5568,6 +5934,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new string that right-aligns the characters in this instance by padding them with spaces on the left, for a specified total length.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new string that is equivalent to this instance, but right-aligned and padded on the left with as many spaces as needed to create a length of <paramref name="totalWidth" />. However, if <paramref name="totalWidth" /> is less than the length of this instance, the method returns a reference to the existing instance. If <paramref name="totalWidth" /> is equal to the length of this instance, the method returns a new string that is identical to this instance.</para>
+        </returns>
         <param name="totalWidth">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of characters in the resulting string, equal to the number of original characters plus any additional padding characters. </param>
       </Docs>
@@ -5591,13 +5961,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="paddingChar" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.String" /> that is equivalent to the current instance right-aligned
-   and padded on the left with as many <paramref name="paddingChar" /> characters as needed to
-   create a length of <paramref name="totalWidth" /> . If <paramref name="totalWidth" /> is less than the length of the current
-   instance, returns a new <see cref="T:System.String" /> that is identical
-   to the current instance.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="totalWidth" /> is less than zero.</exception>
         <remarks>
@@ -5611,6 +5974,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new string that right-aligns the characters in this instance by padding them on the left with a specified Unicode character, for a specified total length.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new string that is equivalent to this instance, but right-aligned and padded on the left with as many <paramref name="paddingChar" /> characters as needed to create a length of <paramref name="totalWidth" />. However, if <paramref name="totalWidth" /> is less than the length of this instance, the method returns a reference to the existing instance. If <paramref name="totalWidth" /> is equal to the length of this instance, the method returns a new string that is identical to this instance.</para>
+        </returns>
         <param name="totalWidth">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of characters in the resulting string, equal to the number of original characters plus any additional padding characters. </param>
         <param name="paddingChar">
@@ -5635,13 +6002,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="totalWidth" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.String" /> that is equivalent to this instance left aligned and
-   padded on the right with as many spaces as needed to create a length of
-<paramref name="totalWidth" />. If <paramref name="totalWidth" /> is less than the length of the current
-   instance, returns a new <see cref="T:System.String" /> that is identical
-   to the current instance.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="totalWidth " />is less than zero.</exception>
         <remarks>
@@ -5656,6 +6016,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new string that left-aligns the characters in this string by padding them with spaces on the right, for a specified total length.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new string that is equivalent to this instance, but left-aligned and padded on the right with as many spaces as needed to create a length of <paramref name="totalWidth" />. However, if <paramref name="totalWidth" /> is less than the length of this instance, the method returns a reference to the existing instance. If <paramref name="totalWidth" /> is equal to the length of this instance, the method returns a new string that is identical to this instance.</para>
+        </returns>
         <param name="totalWidth">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of characters in the resulting string, equal to the number of original characters plus any additional padding characters. </param>
       </Docs>
@@ -5679,13 +6043,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="paddingChar" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.String" /> that is equivalent to the current instance left aligned and
-   padded on the right with as many <paramref name="paddingChar" /> characters as needed to
-   create a length of <paramref name="totalWidth" />. If <paramref name="totalWidth" /> is less than the length of the current instance, returns a new
-<see cref="T:System.String" /> that is identical 
-   to the current instance.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="totalWidth" /> is less than zero.</exception>
         <remarks>
@@ -5699,6 +6056,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new string that left-aligns the characters in this string by padding them on the right with a specified Unicode character, for a specified total length.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new string that is equivalent to this instance, but left-aligned and padded on the right with as many <paramref name="paddingChar" /> characters as needed to create a length of <paramref name="totalWidth" />.  However, if <paramref name="totalWidth" /> is less than the length of this instance, the method returns a reference to the existing instance. If <paramref name="totalWidth" /> is equal to the length of this instance, the method returns a new string that is identical to this instance.</para>
+        </returns>
         <param name="totalWidth">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of characters in the resulting string, equal to the number of original characters plus any additional padding characters. </param>
         <param name="paddingChar">
@@ -5721,7 +6082,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -5734,6 +6094,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new string in which all the characters in the current instance, beginning at a specified position and continuing through the last position, have been deleted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new string that is equivalent to this string except for the removed characters.</para>
+        </returns>
         <param name="startIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based position to begin deleting characters. </param>
       </Docs>
@@ -5756,10 +6120,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A new <see cref="T:System.String" /> that is equivalent to the current instance without the
-   specified range characters.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="startIndex" /> or <paramref name="count" /> is less than zero.</para>
@@ -5778,6 +6138,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new string in which a specified number of characters in the current instance beginning at a specified position have been deleted.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new string that is equivalent to this instance except for the removed characters.</para>
+        </returns>
         <param name="startIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based position to begin deleting characters. </param>
         <param name="count">
@@ -5803,10 +6167,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="newChar" Type="System.Char" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.String" /> equivalent to the current instance with all occurrences of
-<paramref name="oldChar" /> replaced with <paramref name="newChar" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method performs an ordinal (case-sensitive and culture-insensitive) search to find <paramref name="oldChar" />.</para>
@@ -5818,6 +6178,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new string in which all occurrences of a specified Unicode character in this instance are replaced with another specified Unicode character.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that is equivalent to this instance except that all instances of <paramref name="oldChar" /> are replaced with <paramref name="newChar" />. If <paramref name="oldChar" /> is not found in the current instance, the method returns the current instance unchanged. </para>
+        </returns>
         <param name="oldChar">
           <attribution license="cc4" from="Microsoft" modified="false" />The Unicode character to be replaced. </param>
         <param name="newChar">
@@ -5843,11 +6207,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="newValue" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.String" /> equivalent to the current instance with all occurrences of
-<paramref name="oldValue" /> replaced with <paramref name="newValue" />. If the replacement value is a 
-   null reference, the specified substring is removed.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If <paramref name="newValue" /> is null, all occurrences of <paramref name="oldValue" /> are removed.</para>
@@ -5860,6 +6219,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new string in which all occurrences of a specified string in the current instance are replaced with another specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that is equivalent to the current string except that all instances of <paramref name="oldValue" /> are replaced with <paramref name="newValue" />. If <paramref name="oldValue" /> is not found in the current instance, the method returns the current instance unchanged. </para>
+        </returns>
         <param name="oldValue">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to be replaced. </param>
         <param name="newValue">
@@ -5890,38 +6253,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> array containing the results of the split operation as
-   follows:</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> A single-element array containing the
-         current instance.</term>
-              <description>None of the elements of <paramref name="separator" />
-   are contained in the current instance.</description>
-            </item>
-            <item>
-              <term> A
-      multi-element <see cref="T:System.String" /> array, each element of which is a substring of the
-      current instance that was delimited by one or more characters in
-      <paramref name="separator." /></term>
-              <description>At least one element of <paramref name="separator" /> is contained in the current
-   instance.</description>
-            </item>
-            <item>
-              <term>A multi-element <see cref="T:System.String" /> array, each
-   element of which is a substring of the current instance that was delimited
-   by white space characters.</term>
-              <description>The current instance contains white space characters and
-<paramref name="separator" /> is a null reference or an empty 
-   array.</description>
-            </item>
-          </list>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Delimiter characters are not included in the elements of the returned array. </para>
@@ -6016,6 +6347,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string array that contains the substrings in this instance that are delimited by elements of a specified Unicode character array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array whose elements contain the substrings in this instance that are delimited by one or more characters in <paramref name="separator" />. For more information, see the Remarks section.</para>
+        </returns>
         <param name="separator">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of Unicode characters that delimit the substrings in this instance, an empty array that contains no delimiters, or null. </param>
       </Docs>
@@ -6039,39 +6374,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="count" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> array containing the results of the split operation as
-   follows:</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> A single-element array containing the
-         current instance.</term>
-              <description>None of the elements of <paramref name="separator" /> are
-      contained in the current instance.</description>
-            </item>
-            <item>
-              <term> A
-      multi-element <see cref="T:System.String" /> array, each element of
-      which is a substring of the current instance that was delimited by one or
-      more characters in <paramref name="separator" /></term>
-              <description>At least one element of <paramref name="separator" /> is
-   contained in the current instance.</description>
-            </item>
-            <item>
-              <term> A
-      multi-element <see cref="T:System.String" /> array, each element of
-      which is a substring of the current instance that was delimited by white
-      space characters.</term>
-              <description>The current instance contains white space
-      characters and <paramref name="separator" /> is a null reference or an empty
-      array.</description>
-            </item>
-          </list>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="count" /> is negative.</exception>
         <remarks>
@@ -6206,6 +6508,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string array that contains the substrings in this instance that are delimited by elements of a specified Unicode character array. A parameter specifies the maximum number of substrings to return.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array whose elements contain the substrings in this instance that are delimited by one or more characters in <paramref name="separator" />. For more information, see the Remarks section.</para>
+        </returns>
         <param name="separator">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of Unicode characters that delimit the substrings in this instance, an empty array that contains no delimiters, or null. </param>
         <param name="count">
@@ -6234,7 +6540,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="options" Type="System.StringSplitOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -6254,6 +6559,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string array that contains the substrings in this string that are delimited by elements of a specified Unicode character array. A parameter specifies whether to return empty array elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array whose elements contain the substrings in this string that are delimited by one or more characters in <paramref name="separator" />. For more information, see the Remarks section.</para>
+        </returns>
         <param name="separator">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of Unicode characters that delimit the substrings in this string, an empty array that contains no delimiters, or null. </param>
         <param name="options">
@@ -6282,7 +6591,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="options" Type="System.StringSplitOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -6318,6 +6626,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string array that contains the substrings in this string that are delimited by elements of a specified string array. A parameter specifies whether to return empty array elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array whose elements contain the substrings in this string that are delimited by one or more strings in <paramref name="separator" />. For more information, see the Remarks section.</para>
+        </returns>
         <param name="separator">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of single-character strings that delimit the substrings in this string, an empty array that contains no delimiters, or null. </param>
         <param name="options">
@@ -6347,7 +6659,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="options" Type="System.StringSplitOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -6369,6 +6680,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string array that contains the substrings in this string that are delimited by elements of a specified Unicode character array. Parameters specify the maximum number of substrings to return and whether to return empty array elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array whose elements contain the substrings in this string that are delimited by one or more characters in <paramref name="separator" />. For more information, see the Remarks section.</para>
+        </returns>
         <param name="separator">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of Unicode characters that delimit the substrings in this string, an empty array that contains no delimiters, or null. </param>
         <param name="count">
@@ -6400,7 +6715,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="options" Type="System.StringSplitOptions" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -6438,6 +6752,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string array that contains the substrings in this string that are delimited by elements of a specified string array. Parameters specify the maximum number of substrings to return and whether to return empty array elements.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array whose elements contain the substrings in this string that are delimited by one or more strings in <paramref name="separator" />. For more information, see the Remarks section.</para>
+        </returns>
         <param name="separator">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of single-character strings that delimit the substrings in this string, an empty array that contains no delimiters, or null. </param>
         <param name="count">
@@ -6464,13 +6782,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the start of the current
-   instance is equal to <paramref name="value" />; <see langword="false" /> if <paramref name="value" /> is
-   not equal to the start of the current instance or is longer than the current
-   instance.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="value" /> is a null reference. </exception>
         <remarks>
@@ -6482,6 +6793,11 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the beginning of this string instance matches the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        true if <paramref name="value" /> matches the beginning of this string; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to compare. </param>
       </Docs>
@@ -6508,7 +6824,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="comparisonType" Type="System.StringComparison" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -6518,6 +6833,11 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the beginning of this string instance matches the specified string when compared using the specified comparison option.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    true if this instance begins with <paramref name="value" />; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to compare. </param>
         <param name="comparisonType">
@@ -6541,7 +6861,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -6552,6 +6871,11 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the beginning of this string instance matches the specified string when compared using the specified culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                true if the <paramref name="value" /> parameter matches the beginning of this string; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The string to compare. </param>
         <param name="ignoreCase">
@@ -6578,12 +6902,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="startIndex" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> equivalent to the substring that begins at
-<paramref name="startIndex" /> of the current 
-   instance. Returns <see cref="F:System.String.Empty" />
-   if <paramref name="startIndex" /> is equal to the length of the current instance.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="startIndex" /> is less than zero or greater than the length of the current instance.</exception>
         <remarks>
@@ -6597,6 +6915,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a substring from this instance. The substring starts at a specified character position and continues to the end of the string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that is equivalent to the substring that begins at <paramref name="startIndex" /> in this instance, or <see cref="F:System.String.Empty" /> if <paramref name="startIndex" /> is equal to the length of this instance.</para>
+        </returns>
         <param name="startIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based starting character position of a substring in this instance. </param>
       </Docs>
@@ -6620,11 +6942,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> containing the substring of the current instance with 
-   the specified length that begins at the specified position. Returns <see cref="F:System.String.Empty" /> if <paramref name="startIndex" /> is equal to the length of
-   the current instance and length is zero.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="length" /> is greater than the length of the current instance.</para>
@@ -6644,6 +6961,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Retrieves a substring from this instance. The substring starts at a specified character position and has a specified length.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string that is equivalent to the substring of length <paramref name="length" /> that begins at <paramref name="startIndex" /> in this instance, or <see cref="F:System.String.Empty" /> if <paramref name="startIndex" /> is equal to the length of this instance and <paramref name="length" /> is zero.</para>
+        </returns>
         <param name="startIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The zero-based starting character position of a substring in this instance. </param>
         <param name="length">
@@ -6686,7 +7007,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.String" /> instance is cast to an <see cref="T:System.Collections.IEnumerable" /> interface. For more information, see the <see cref="M:System.Collections.IEnumerable.GetEnumerator" /> method.</para>
@@ -6695,6 +7015,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an enumerator that iterates through the current <see cref="T:System.String" /> object. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An enumerator that can be used to iterate through the current string.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="System.IConvertible.ToBoolean">
@@ -6713,7 +7037,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.String" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToBoolean(System.String)" /> method.</para>
@@ -6722,6 +7045,11 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToBoolean(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>
+                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            true if the value of the current string is <see cref="F:System.Boolean.TrueString" />; false if the value of the current string is <see cref="F:System.Boolean.FalseString" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -6742,7 +7070,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.String" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToByte(System.String,System.IFormatProvider)" /> method.</para>
@@ -6751,6 +7078,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToByte(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value of the current <see cref="T:System.String" /> object.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that provides culture-specific formatting information. </param>
       </Docs>
@@ -6771,7 +7102,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.String" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToChar(System.String,System.IFormatProvider)" /> method.</para>
@@ -6780,6 +7110,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToChar(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The character at index 0 in the current <see cref="T:System.String" /> object.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that provides culture-specific formatting information. </param>
       </Docs>
@@ -6800,7 +7134,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.String" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToDateTime(System.String,System.IFormatProvider)" /> method.</para>
@@ -6809,6 +7142,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToDateTime(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value of the current <see cref="T:System.String" /> object.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that provides culture-specific formatting information. </param>
       </Docs>
@@ -6829,7 +7166,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.String" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToDecimal(System.String,System.IFormatProvider)" /> method.</para>
@@ -6838,6 +7174,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToDecimal(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value of the current <see cref="T:System.String" /> object.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that provides culture-specific formatting information. </param>
       </Docs>
@@ -6858,7 +7198,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.String" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToDouble(System.String,System.IFormatProvider)" /> method.</para>
@@ -6867,6 +7206,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToDouble(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value of the current <see cref="T:System.String" /> object.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that provides culture-specific formatting information. </param>
       </Docs>
@@ -6887,7 +7230,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.String" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt16(System.String,System.IFormatProvider)" /> method.</para>
@@ -6896,6 +7238,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt16(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value of the current <see cref="T:System.String" /> object.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that provides culture-specific formatting information. </param>
       </Docs>
@@ -6916,7 +7262,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.String" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt32(System.String,System.IFormatProvider)" /> method.</para>
@@ -6926,6 +7271,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt32(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value of the current <see cref="T:System.String" /> object.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that provides culture-specific formatting information. </param>
       </Docs>
@@ -6946,7 +7295,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.String" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt64(System.String,System.IFormatProvider)" /> method.</para>
@@ -6955,6 +7303,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt64(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value of the current <see cref="T:System.String" /> object.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that provides culture-specific formatting information. </param>
       </Docs>
@@ -6975,7 +7327,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.String" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToSByte(System.String,System.IFormatProvider)" /> method.</para>
@@ -6984,6 +7335,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToSByte(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value of the current <see cref="T:System.String" /> object.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that provides culture-specific formatting information. </param>
       </Docs>
@@ -7004,7 +7359,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.String" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToSingle(System.String,System.IFormatProvider)" /> method.</para>
@@ -7013,6 +7367,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToSingle(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value of the current <see cref="T:System.String" /> object.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that provides culture-specific formatting information. </param>
       </Docs>
@@ -7035,7 +7393,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
       </Parameters>
       <Docs>
         <param name="targetType">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.String" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ChangeType(System.Object,System.Type,System.IFormatProvider)" /> method.</para>
@@ -7044,6 +7401,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToType(System.Type,System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value of the current <see cref="T:System.String" /> object.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that provides culture-specific formatting information.</param>
       </Docs>
@@ -7064,7 +7425,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.String" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt16(System.String,System.IFormatProvider)" /> method.</para>
@@ -7073,6 +7433,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt16(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value of the current <see cref="T:System.String" /> object.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that provides culture-specific formatting information. </param>
       </Docs>
@@ -7093,7 +7457,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.String" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt32(System.String,System.IFormatProvider)" /> method.</para>
@@ -7102,6 +7465,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt32(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value of the current <see cref="T:System.String" /> object.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that provides culture-specific formatting information. </param>
       </Docs>
@@ -7122,7 +7489,6 @@ represent the same string value; otherwise, <see langword="false" />.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.String" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt64(System.String,System.IFormatProvider)" /> method.</para>
@@ -7131,6 +7497,10 @@ represent the same string value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt64(System.IFormatProvider)" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The converted value of the current <see cref="T:System.String" /> object.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that provides culture-specific formatting information. </param>
       </Docs>
@@ -7150,17 +7520,15 @@ represent the same string value; otherwise, <see langword="false" />.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Char" /> 
-array whose elements are the individual characters of
-the current instance. If the current instance is an empty string, the array returned by this method is empty
-and has a zero length.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the characters in this instance to a Unicode character array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Unicode character array whose elements are the individual characters of this instance. If this instance is an empty string, the returned array is empty and has a zero length.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -7182,14 +7550,6 @@ and has a zero length.</para>
         <Parameter Name="length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Char" /> array whose elements are the
-<paramref name="length" /> number of characters in the current instance, starting from the
-   index <paramref name="startIndex" /> in the current instance. If the specified length is
-   zero, the entire string is copied starting from the beginning of the current
-   instance, and ignoring the value of <paramref name="startIndex" />. If the current instance
-   is an empty string, the returned array is empty and has a zero length.</para>
-        </returns>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <para>
             <paramref name="startIndex" /> or <paramref name="length" /> is less than zero. </para>
@@ -7206,6 +7566,10 @@ and has a zero length.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Copies the characters in a specified substring in this instance to a Unicode character array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A Unicode character array whose elements are the <paramref name="length" /> number of characters in this instance starting from character position <paramref name="startIndex" />.</para>
+        </returns>
         <param name="startIndex">
           <attribution license="cc4" from="Microsoft" modified="false" />The starting position of a substring in this instance. </param>
         <param name="length">
@@ -7228,9 +7592,6 @@ and has a zero length.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> in lowercase..</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method takes into account the casing rules of the current culture.</para>
@@ -7246,6 +7607,10 @@ and has a zero length.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a copy of this string converted to lowercase.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string in lowercase.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -7265,7 +7630,6 @@ and has a zero length.</para>
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The casing rules of the culture specified by the <paramref name="culture" /> parameter determine the way the case of the string is changed. </para>
@@ -7281,6 +7645,10 @@ and has a zero length.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a copy of this string converted to lowercase, using the casing rules of the specified culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The lowercase equivalent of the current string.</para>
+        </returns>
         <param name="culture">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific casing rules. </param>
       </Docs>
@@ -7298,7 +7666,6 @@ and has a zero length.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -7316,6 +7683,10 @@ and has a zero length.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a copy of this <see cref="T:System.String" /> object converted to lowercase using the casing rules of the invariant culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The lowercase equivalent of the current string.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -7333,9 +7704,6 @@ and has a zero length.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>The current <see cref="T:System.String" />.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note"> This method
@@ -7346,6 +7714,10 @@ and has a zero length.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns this instance of <see cref="T:System.String" />; no actual conversion is performed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current string.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -7366,9 +7738,6 @@ and has a zero length.</para>
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>This <see langword="String" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>

@@ -7378,6 +7747,10 @@ and has a zero length.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns this instance of <see cref="T:System.String" />; no actual conversion is performed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current string.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />(Reserved) An object that supplies culture-specific formatting information. </param>
       </Docs>
@@ -7398,10 +7771,6 @@ and has a zero length.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.String" /> 
-in uppercase.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method uses the casing rules of the current culture to convert each character in the current instance to its uppercase equivalent. If a character does not have an uppercase equivalent, it is included unchanged in the returned string.</para>
@@ -7418,6 +7787,10 @@ in uppercase.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a copy of this string converted to uppercase.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The uppercase equivalent of the current string.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -7437,7 +7810,6 @@ in uppercase.</para>
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The casing rules of the culture specified by the <paramref name="culture" /> parameter determine the way the case of a string is changed. </para>
@@ -7453,6 +7825,10 @@ in uppercase.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a copy of this string converted to uppercase, using the casing rules of the specified culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The uppercase equivalent of the current string.</para>
+        </returns>
         <param name="culture">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific casing rules. </param>
       </Docs>
@@ -7470,7 +7846,6 @@ in uppercase.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -7488,6 +7863,10 @@ in uppercase.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a copy of this <see cref="T:System.String" /> object converted to uppercase using the casing rules of the invariant culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The uppercase equivalent of the current string.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Trim">
@@ -7505,12 +7884,6 @@ in uppercase.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.String" /> equivalent to the current instance after
-   white space characters
-   are removed from its
-   beginning and end.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.String.Trim" /> method removes from the current string all leading and trailing white-space characters. Each leading and trailing trim operation stops when a non-white-space character is encountered. For example, if the current string is "   abc   xyz   ", the <see cref="M:System.String.Trim" /> method returns "abc   xyz".</para>
@@ -7524,6 +7897,10 @@ in uppercase.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes all leading and trailing white-space characters from the current <see cref="T:System.String" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string that remains after all white-space characters are removed from the start and end of the current string.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -7550,13 +7927,6 @@ in uppercase.</para>
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.String" /> equivalent to the current instance with the characters
-   in <paramref name="trimChars" /> removed from its beginning and end. If <paramref name="trimChars" />
-   is a null reference, all of the white space characters are removed from the
-   beginning and end of
-   the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.String.Trim(System.Char[])" /> method removes from the current string all leading and trailing characters that are in the <paramref name="trimChars" /> parameter. Each leading and trailing trim operation stops when a character that is not in <paramref name="trimChars" /> is encountered. For example, if the current string is "123abc456xyz789" and <paramref name="trimChars" /> contains the digits from "1" through "9", the <see cref="M:System.String.Trim(System.Char[])" /> method returns "abc456xyz".</para>
@@ -7570,6 +7940,10 @@ in uppercase.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes all leading and trailing occurrences of a set of characters specified in an array from the current <see cref="T:System.String" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string that remains after all occurrences of the characters in the <paramref name="trimChars" /> parameter are removed from the start and end of the current string. If <paramref name="trimChars" /> is null or an empty array, white-space characters are removed instead.</para>
+        </returns>
         <param name="trimChars">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of Unicode characters to remove, or null. </param>
       </Docs>
@@ -7598,11 +7972,6 @@ in uppercase.</para>
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.String" /> equivalent to the current instance with characters in
-<paramref name="trimChars" /> removed from its end. If <paramref name="trimChars" /> is a null reference, white space
-   characters are removed.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.String.TrimEnd(System.Char[])" /> method removes from the current string all trailing characters that are in the <paramref name="trimChars" /> parameter. The trim operation stops when the first character that is not in <paramref name="trimChars" /> is encountered at the end of the string. For example, if the current string is "123abc456xyz789" and <paramref name="trimChars" /> contains the digits from "1" through "9", the <see cref="M:System.String.TrimEnd(System.Char[])" /> method returns "123abc456xyz".</para>
@@ -7614,6 +7983,10 @@ in uppercase.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes all trailing occurrences of a set of characters specified in an array from the current <see cref="T:System.String" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string that remains after all occurrences of the characters in the <paramref name="trimChars" /> parameter are removed from the end of the current string. If <paramref name="trimChars" /> is null or an empty array, Unicode white-space characters are removed instead.</para>
+        </returns>
         <param name="trimChars">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of Unicode characters to remove, or null. </param>
       </Docs>
@@ -7642,12 +8015,6 @@ in uppercase.</para>
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.String" /> equivalent to the current instance with the characters
-   in <paramref name="trimChars" /> removed from its beginning. If <paramref name="trimChars" /> is a
-   null reference, white space
-   characters are removed.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.String.TrimStart(System.Char[])" /> method removes from the current string all leading characters that are in the <paramref name="trimChars" /> parameter. The trim operation stops when a character that is not in <paramref name="trimChars" /> is encountered. For example, if the current string is "123abc456xyz789" and <paramref name="trimChars" /> contains the digits from "1" through "9", the <see cref="M:System.String.TrimStart(System.Char[])" /> method returns "abc456xyz789".</para>
@@ -7659,6 +8026,10 @@ in uppercase.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Removes all leading occurrences of a set of characters specified in an array from the current <see cref="T:System.String" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string that remains after all occurrences of characters in the <paramref name="trimChars" /> parameter are removed from the start of the current string. If <paramref name="trimChars" /> is null or an empty array, white-space characters are removed instead.</para>
+        </returns>
         <param name="trimChars">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of Unicode characters to remove, or null. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System/StringComparer.xml b/mcs/class/corlib/Documentation/en/System/StringComparer.xml
index 164471ecd2e..cc1afa85d8d 100644
--- a/mcs/class/corlib/Documentation/en/System/StringComparer.xml
+++ b/mcs/class/corlib/Documentation/en/System/StringComparer.xml
@@ -81,7 +81,6 @@
         <Parameter Name="y" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -91,6 +90,55 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, compares two objects and returns an indication of their relative sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative values of <paramref name="x" /> and <paramref name="y" />, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value</para>
+                </term>
+                <description>
+                  <para>Meaning</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero</para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="x" /> is less than <paramref name="y" />. </para>
+                <para>-or-</para>
+                <para>
+                  <paramref name="x" /> is null.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="x" /> is equal to <paramref name="y" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero</para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="x" /> is greater than <paramref name="y" />.</para>
+                <para>-or-</para>
+                <para>
+                  <paramref name="y" /> is null.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare to <paramref name="y" />.</param>
         <param name="y">
@@ -113,7 +161,6 @@
         <Parameter Name="y" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -123,6 +170,55 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, compares two strings and returns an indication of their relative sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative values of <paramref name="x" /> and <paramref name="y" />, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value</para>
+                </term>
+                <description>
+                  <para>Meaning</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero</para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="x" /> is less than <paramref name="y" />.</para>
+                <para>-or-</para>
+                <para>
+                  <paramref name="x" /> is null.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="x" /> is equal to <paramref name="y" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero</para>
+              </term>
+              <description>
+                <para>
+                  <paramref name="x" /> is greater than <paramref name="y" />.</para>
+                <para>-or-</para>
+                <para>
+                  <paramref name="y" /> is null.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A string to compare to <paramref name="y" />.</param>
         <param name="y">
@@ -145,13 +241,16 @@
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <since version=".NET 2.0" />
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Creates a <see cref="T:System.StringComparer" /> object that compares strings according to the rules of a specified culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.StringComparer" /> object that performs string comparisons according to the comparison rules used by the <paramref name="culture" /> parameter and the case rule specified by the <paramref name="ignoreCase" /> parameter.</para>
+        </returns>
         <param name="culture">
           <attribution license="cc4" from="Microsoft" modified="false" />A culture whose linguistic rules are used to perform a string comparison.</param>
         <param name="ignoreCase">
@@ -232,7 +331,6 @@
         <Parameter Name="y" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -242,6 +340,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, indicates whether two objects are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="x" /> and <paramref name="y" /> refer to the same object, or <paramref name="x" /> and <paramref name="y" /> are both the same type of object and those objects are equal; otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare to <paramref name="y" />.</param>
         <param name="y">
@@ -264,7 +366,6 @@
         <Parameter Name="y" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -274,6 +375,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, indicates whether two strings are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="x" /> and <paramref name="y" /> refer to the same object, or <paramref name="x" /> and <paramref name="y" /> are equal; otherwise, false.</para>
+        </returns>
         <param name="x">
           <attribution license="cc4" from="Microsoft" modified="false" />A string to compare to <paramref name="y" />.</param>
         <param name="y">
@@ -295,7 +400,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -306,6 +410,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, gets the hash code for the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed hash code calculated from the value of the <paramref name="obj" /> parameter.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object.</param>
       </Docs>
@@ -325,7 +433,6 @@
         <Parameter Name="obj" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -336,6 +443,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, gets the hash code for the specified string.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed hash code calculated from the value of the <paramref name="obj" /> parameter.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />A string.</param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System/TimeSpan.xml b/mcs/class/corlib/Documentation/en/System/TimeSpan.xml
index a57ed0f72b0..ead1beb1db7 100644
--- a/mcs/class/corlib/Documentation/en/System/TimeSpan.xml
+++ b/mcs/class/corlib/Documentation/en/System/TimeSpan.xml
@@ -260,10 +260,6 @@
         <Parameter Name="ts" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.TimeSpan" /> that represents the value of the current instance plus
-   the value of <paramref name="ts" />.</para>
-        </returns>
         <exception cref="T:System.OverflowException">The sum of the value of the current instance and the value of <paramref name="ts" /> is less than <see cref="F:System.TimeSpan.MinValue" /> or greater than <see cref="F:System.TimeSpan.MaxValue" />.</exception>
         <example>
           <para>This example demonstrates the <see cref="M:System.TimeSpan.Add(System.TimeSpan)" /> method.</para>
@@ -291,6 +287,10 @@ public class TimeSpanAddExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new <see cref="T:System.TimeSpan" /> object whose value is the sum of the specified <see cref="T:System.TimeSpan" /> object and this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new object that represents the value of this instance plus the value of <paramref name="ts" />.</para>
+        </returns>
         <param name="ts">
           <attribution license="cc4" from="Microsoft" modified="false" />The time interval to add.</param>
       </Docs>
@@ -314,40 +314,54 @@ public class TimeSpanAddExample {
         <Parameter Name="t2" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
+        <remarks>To be added.</remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Compares two <see cref="T:System.TimeSpan" /> values and returns an integer that indicates whether the first value is shorter than, equal to, or longer than the second value.</para>
+        </summary>
         <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of <paramref name="t1" /> as compared to <paramref name="t2" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the following values.</para>
           <list type="table">
             <listheader>
-              <term>Value</term>
-              <description>Condition</description>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
             </listheader>
             <item>
-              <term> Any
-      negative
-      number</term>
+              <term>
+                <para>-1 </para>
+              </term>
               <description>
-                <paramref name="t1" /> &lt; <paramref name="t2" />.</description>
+                <para>
+                  <paramref name="t1" /> is shorter than <paramref name="t2" />. </para>
+              </description>
             </item>
             <item>
-              <term> Zero</term>
+              <term>
+                <para>0 </para>
+              </term>
               <description>
-                <paramref name="t1" /> == <paramref name="t2" />.</description>
+                <para>
+                  <paramref name="t1" /> is equal to <paramref name="t2" />. </para>
+              </description>
             </item>
             <item>
-              <term> Any
-      positive
-      number</term>
+              <term>
+                <para>1 </para>
+              </term>
               <description>
-                <paramref name="t1" /> &gt;
-<paramref name="t2" />.</description>
+                <para>
+                  <paramref name="t1" /> is longer than <paramref name="t2" />. </para>
+              </description>
             </item>
           </list>
         </returns>
-        <remarks>To be added.</remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Compares two <see cref="T:System.TimeSpan" /> values and returns an integer that indicates whether the first value is shorter than, equal to, or longer than the second value.</para>
-        </summary>
         <param name="t1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first time interval to compare. </param>
         <param name="t2">
@@ -372,47 +386,62 @@ public class TimeSpanAddExample {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
+        <exception cref="T:System.ArgumentException">
+          <para>
+            <paramref name="value" /> is not a <see cref="T:System.TimeSpan" /> and is not a null reference.</para>
+        </exception>
+        <remarks>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Any instance of <see cref="T:System.TimeSpan" />, regardless of its value, is considered greater than null.</para>
+          <para>The <paramref name="value" /> parameter must be an instance of <see cref="T:System.TimeSpan" /> or null; otherwise, an exception is thrown.</para>
+        </remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Compares this instance to a specified object and returns an integer that indicates whether this instance is shorter than, equal to, or longer than the specified object.</para>
+        </summary>
         <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="value" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>One of the following values.</para>
           <list type="table">
             <listheader>
-              <term>Value</term>
-              <description>Condition</description>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
             </listheader>
             <item>
-              <term> Any
-      negative
-      number</term>
-              <description>Current instance &lt; <paramref name="value" />.</description>
+              <term>
+                <para>-1 </para>
+              </term>
+              <description>
+                <para>This instance is shorter than <paramref name="value" />. </para>
+              </description>
             </item>
             <item>
-              <term> Zero</term>
-              <description>Current instance == <paramref name="value" />.</description>
+              <term>
+                <para>0 </para>
+              </term>
+              <description>
+                <para>This instance is equal to <paramref name="value" />. </para>
+              </description>
             </item>
             <item>
-              <term> Any
-      positive
-      number</term>
+              <term>
+                <para>1 </para>
+              </term>
               <description>
-                <para>Current instance &gt; <paramref name="value" />, or
-   <paramref name="value" /> is a null reference.</para>
+                <para>This instance is longer than <paramref name="value" />.</para>
+                <para>-or- </para>
+                <para>
+                  <paramref name="value" /> is null. </para>
               </description>
             </item>
           </list>
         </returns>
-        <exception cref="T:System.ArgumentException">
-          <para>
-            <paramref name="value" /> is not a <see cref="T:System.TimeSpan" /> and is not a null reference.</para>
-        </exception>
-        <remarks>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Any instance of <see cref="T:System.TimeSpan" />, regardless of its value, is considered greater than null.</para>
-          <para>The <paramref name="value" /> parameter must be an instance of <see cref="T:System.TimeSpan" /> or null; otherwise, an exception is thrown.</para>
-        </remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Compares this instance to a specified object and returns an integer that indicates whether this instance is shorter than, equal to, or longer than the specified object.</para>
-        </summary>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare, or null. </param>
       </Docs>
@@ -433,40 +462,55 @@ public class TimeSpanAddExample {
         <Parameter Name="value" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
+        <since version=".NET 2.0" />
+        <remarks>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method implements the <see cref="T:System.IComparable`1" /> interface and performs slightly better than the <see cref="M:System.TimeSpan.CompareTo(System.Object)" /> method because it does not have to convert the <paramref name="value" /> parameter to an object.</para>
+        </remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Compares this instance to a specified <see cref="T:System.TimeSpan" /> object and returns an integer that indicates whether this instance is shorter than, equal to, or longer than the <see cref="T:System.TimeSpan" /> object.</para>
+        </summary>
         <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="value" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number indicating the relative values of this instance and <paramref name="value" />.</para>
           <list type="table">
             <listheader>
-              <term>Value</term>
-              <description>Condition</description>
+              <item>
+                <term>
+                  <para>Value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
             </listheader>
             <item>
-              <term> Any
-      negative
-      number</term>
-              <description>Current instance &lt; <paramref name="value" />.</description>
+              <term>
+                <para>A negative integer </para>
+              </term>
+              <description>
+                <para>This instance is shorter than <paramref name="value" />. </para>
+              </description>
             </item>
             <item>
-              <term> Zero</term>
-              <description>Current instance == <paramref name="value" />.</description>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is equal to <paramref name="value" />. </para>
+              </description>
             </item>
             <item>
-              <term> Any
-      positive
-      number</term>
-              <description>Current instance &gt; <paramref name="value" />.   </description>
+              <term>
+                <para>A positive integer </para>
+              </term>
+              <description>
+                <para>This instance is longer than <paramref name="value" />. </para>
+              </description>
             </item>
           </list>
         </returns>
-        <since version=".NET 2.0" />
-        <remarks>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>This method implements the <see cref="T:System.IComparable`1" /> interface and performs slightly better than the <see cref="M:System.TimeSpan.CompareTo(System.Object)" /> method because it does not have to convert the <paramref name="value" /> parameter to an object.</para>
-        </remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Compares this instance to a specified <see cref="T:System.TimeSpan" /> object and returns an integer that indicates whether this instance is shorter than, equal to, or longer than the <see cref="T:System.TimeSpan" /> object.</para>
-        </summary>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare to this instance.</param>
       </Docs>
@@ -534,11 +578,6 @@ public class TimeSpanPropertiesExampleOne {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.TimeSpan" />
-whose value is
-the absolute value of the current instance.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.OverflowException">The value of the current instance is <see cref="F:System.TimeSpan.MinValue" />.</exception>
         <example>
@@ -562,6 +601,10 @@ public class TimeSpanDurationExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new <see cref="T:System.TimeSpan" /> object whose value is the absolute value of the current <see cref="T:System.TimeSpan" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new object whose value is the absolute value of the current <see cref="T:System.TimeSpan" /> object.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -582,12 +625,6 @@ public class TimeSpanDurationExample {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="value" /> represents the
-   same type and value as the current instance. If <paramref name="value" /> is
-   a null reference or is not a <see cref="T:System.TimeSpan" />, returns <see langword="false" />.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note">This method
@@ -598,6 +635,10 @@ public class TimeSpanDurationExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value" /> is a <see cref="T:System.TimeSpan" /> object that represents the same time interval as the current <see cref="T:System.TimeSpan" /> structure; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance. </param>
       </Docs>
@@ -618,10 +659,6 @@ public class TimeSpanDurationExample {
         <Parameter Name="obj" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> represents the same value as the current instance; otherwise, <see langword="false" />.</para>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -631,6 +668,10 @@ public class TimeSpanDurationExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified <see cref="T:System.TimeSpan" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> represents the same time interval as this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance. </param>
       </Docs>
@@ -653,16 +694,15 @@ public class TimeSpanDurationExample {
         <Parameter Name="t2" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="t1" /> and <paramref name="t2" />
-represent the same value; otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether two specified instances of <see cref="T:System.TimeSpan" /> are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the values of <paramref name="t1" /> and <paramref name="t2" /> are equal; otherwise, false.</para>
+        </returns>
         <param name="t1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first time interval to compare. </param>
         <param name="t2">
@@ -687,9 +727,6 @@ represent the same value; otherwise, <see langword="false" />.</para>
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.TimeSpan" /> that represents <paramref name="value" />.</para>
-        </returns>
         <exception cref="T:System.OverflowException">The <see cref="T:System.TimeSpan" /> represented by <paramref name="value" /> is greater than <see cref="F:System.TimeSpan.MaxValue" /> or less than <see cref="F:System.TimeSpan.MinValue" />.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="value" /> is equal to <see cref="F:System.Double.NaN" />.</exception>
@@ -702,6 +739,10 @@ represent the same value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.TimeSpan" /> that represents a specified number of days, where the specification is accurate to the nearest millisecond.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A number of days, accurate to the nearest millisecond. </param>
       </Docs>
@@ -725,9 +766,6 @@ represent the same value; otherwise, <see langword="false" />.</para>
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.TimeSpan" /> that represents <paramref name="value" />.</para>
-        </returns>
         <exception cref="T:System.OverflowException">The <see cref="T:System.TimeSpan" /> represented by <paramref name="value" /> is greater than <see cref="F:System.TimeSpan.MaxValue" /> or less than <see cref="F:System.TimeSpan.MinValue" />.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="value" /> is equal to <see cref="F:System.Double.NaN" />.</exception>
@@ -741,6 +779,10 @@ represent the same value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.TimeSpan" /> that represents a specified number of hours, where the specification is accurate to the nearest millisecond.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A number of hours accurate to the nearest millisecond. </param>
       </Docs>
@@ -764,9 +806,6 @@ represent the same value; otherwise, <see langword="false" />.</para>
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.TimeSpan" /> that represents <paramref name="value" />.</para>
-        </returns>
         <exception cref="T:System.OverflowException">The <see cref="T:System.TimeSpan" /> represented by <paramref name="value" /> is greater than <see cref="F:System.TimeSpan.MaxValue" /> or less than <see cref="F:System.TimeSpan.MinValue" />.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="value" /> is equal to <see cref="F:System.Double.NaN" />.</exception>
@@ -780,6 +819,10 @@ represent the same value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.TimeSpan" /> that represents a specified number of milliseconds.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A number of milliseconds. </param>
       </Docs>
@@ -803,9 +846,6 @@ represent the same value; otherwise, <see langword="false" />.</para>
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.TimeSpan" /> that represents <paramref name="value" />.</para>
-        </returns>
         <exception cref="T:System.OverflowException">The <see cref="T:System.TimeSpan" /> represented by <paramref name="value" /> is greater than <see cref="F:System.TimeSpan.MaxValue" /> or less than <see cref="F:System.TimeSpan.MinValue" />.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="value" /> is equal to <see cref="F:System.Double.NaN" />.</exception>
@@ -819,6 +859,10 @@ represent the same value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.TimeSpan" /> that represents a specified number of minutes, where the specification is accurate to the nearest millisecond.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A number of minutes, accurate to the nearest millisecond. </param>
       </Docs>
@@ -842,9 +886,6 @@ represent the same value; otherwise, <see langword="false" />.</para>
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.TimeSpan" /> that represents <paramref name="value" />.</para>
-        </returns>
         <exception cref="T:System.OverflowException">The <see cref="T:System.TimeSpan" /> represented by <paramref name="value" /> is greater than <see cref="F:System.TimeSpan.MaxValue" /> or less than <see cref="F:System.TimeSpan.MinValue" />.</exception>
         <exception cref="T:System.ArgumentException">
           <paramref name="value" /> is equal to <see cref="F:System.Double.NaN" />.</exception>
@@ -858,6 +899,10 @@ represent the same value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.TimeSpan" /> that represents a specified number of seconds, where the specification is accurate to the nearest millisecond.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A number of seconds, accurate to the nearest millisecond. </param>
       </Docs>
@@ -881,9 +926,6 @@ represent the same value; otherwise, <see langword="false" />.</para>
         <Parameter Name="value" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.TimeSpan" /> with a value of <paramref name="value" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This is a convenience method with the same behavior as the <see cref="M:System.TimeSpan.#ctor(System.Int64)" /> constructor. A single tick represents one hundred nanoseconds or one ten-millionth of a second. There are 10,000 ticks in a millisecond. </para>
@@ -892,6 +934,10 @@ represent the same value; otherwise, <see langword="false" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.TimeSpan" /> that represents a specified time, where the specification is in units of ticks.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents <paramref name="value" />.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A number of ticks that represent a time. </param>
       </Docs>
@@ -912,10 +958,6 @@ represent the same value; otherwise, <see langword="false" />.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" />
-value containing a hash code for the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Two <see cref="T:System.TimeSpan" /> objects might have the same hash code even though they represent different time values.</para>
@@ -924,6 +966,10 @@ value containing a hash code for the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1142,15 +1188,16 @@ public class TimeSpanPropertiesExampleOne {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.TimeSpan" /> with the same absolute value but with the opposite sign as the current instance.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.OverflowException">The value of the current instance is <see cref="F:System.TimeSpan.MinValue" />.</exception>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new <see cref="T:System.TimeSpan" /> object whose value is the negated value of this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new object with the same numeric value as this instance, but with the opposite sign.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1172,10 +1219,6 @@ public class TimeSpanPropertiesExampleOne {
         <Parameter Name="t2" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.TimeSpan" /> whose value is the sum of the values of <paramref name="t1" /> and
-<paramref name="t2" />.</para>
-        </returns>
         <exception cref="T:System.OverflowException">The sum of <paramref name="t1" /> and <paramref name="t2" /> is less than <see cref="F:System.TimeSpan.MinValue" /> or greater than <see cref="F:System.TimeSpan.MaxValue" />.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1187,6 +1230,10 @@ public class TimeSpanPropertiesExampleOne {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds two specified <see cref="T:System.TimeSpan" /> instances.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose value is the sum of the values of <paramref name="t1" /> and <paramref name="t2" />.</para>
+        </returns>
         <param name="t1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first time interval to add. </param>
         <param name="t2">
@@ -1212,12 +1259,6 @@ public class TimeSpanPropertiesExampleOne {
         <Parameter Name="t2" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the values of <paramref name="t1" /> and
-<paramref name="t2" /> are equal; otherwise, <see langword="false" />.</para>
-          <see langword="" />
-        </returns>
         <remarks>To be added.</remarks>
         <param name="t1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first time interval to compare. </param>
@@ -1227,6 +1268,10 @@ public class TimeSpanPropertiesExampleOne {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.TimeSpan" /> instances are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the values of <paramref name="t1" /> and <paramref name="t2" /> are equal; otherwise, false.</para>
+        </returns>
         <param name="t1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first time interval to compare. </param>
         <param name="t2">
@@ -1252,17 +1297,15 @@ public class TimeSpanPropertiesExampleOne {
         <Parameter Name="t2" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the value of <paramref name="t1" /> is
-   greater than the value of <paramref name="t2" />; otherwise, <see langword="false" />.</para>
-          <see langword="" />
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a specified <see cref="T:System.TimeSpan" /> is greater than another specified <see cref="T:System.TimeSpan" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of <paramref name="t1" /> is greater than the value of <paramref name="t2" />; otherwise, false.</para>
+        </returns>
         <param name="t1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first time interval to compare. </param>
         <param name="t2">
@@ -1288,18 +1331,15 @@ public class TimeSpanPropertiesExampleOne {
         <Parameter Name="t2" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the value of <paramref name="t1" /> is
-   greater than or equal to the value of <paramref name="t2" />; otherwise,
-<see langword="false" />.</para>
-          <see langword="" />
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a specified <see cref="T:System.TimeSpan" /> is greater than or equal to another specified <see cref="T:System.TimeSpan" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of <paramref name="t1" /> is greater than or equal to the value of <paramref name="t2" />; otherwise, false.</para>
+        </returns>
         <param name="t1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first time interval to compare.</param>
         <param name="t2">
@@ -1325,16 +1365,15 @@ public class TimeSpanPropertiesExampleOne {
         <Parameter Name="t2" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the values of <paramref name="t1" /> and
-<paramref name="t2" /> are unequal; otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.TimeSpan" /> instances are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the values of <paramref name="t1" /> and <paramref name="t2" /> are not equal; otherwise, false.</para>
+        </returns>
         <param name="t1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first time interval to compare.</param>
         <param name="t2">
@@ -1360,16 +1399,15 @@ public class TimeSpanPropertiesExampleOne {
         <Parameter Name="t2" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the value of <paramref name="t1" /> is 
- less than the value of <paramref name="t2" />; otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a specified <see cref="T:System.TimeSpan" /> is less than another specified <see cref="T:System.TimeSpan" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of <paramref name="t1" /> is less than the value of <paramref name="t2" />; otherwise, false.</para>
+        </returns>
         <param name="t1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first time interval to compare.</param>
         <param name="t2">
@@ -1395,17 +1433,15 @@ public class TimeSpanPropertiesExampleOne {
         <Parameter Name="t2" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the value of <paramref name="t1" /> is 
- less than or equal to the value of <paramref name="t2" />; otherwise,
-<see langword="false" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether a specified <see cref="T:System.TimeSpan" /> is less than or equal to another specified <see cref="T:System.TimeSpan" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of <paramref name="t1" /> is less than or equal to the value of <paramref name="t2" />; otherwise, false.</para>
+        </returns>
         <param name="t1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first time interval to compare. </param>
         <param name="t2">
@@ -1431,16 +1467,16 @@ public class TimeSpanPropertiesExampleOne {
         <Parameter Name="t2" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.TimeSpan" /> whose value is the result of the value of <paramref name="t1" />
-minus the value of <paramref name="t2" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.OverflowException">The value of <paramref name="t2" /> subtracted from <paramref name="t1" /> is less than <see cref="F:System.TimeSpan.MinValue" /> or greater than <see cref="F:System.TimeSpan.MaxValue" />.</exception>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts a specified <see cref="T:System.TimeSpan" /> from another specified <see cref="T:System.TimeSpan" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object whose value is the result of the value of <paramref name="t1" /> minus the value of <paramref name="t2" />.</para>
+        </returns>
         <param name="t1">
           <attribution license="cc4" from="Microsoft" modified="false" />The minuend. </param>
         <param name="t2">
@@ -1465,10 +1501,6 @@ minus the value of <paramref name="t2" />.</para>
         <Parameter Name="t" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.TimeSpan" /> with the same absolute value but the opposite sign as
-<paramref name="t" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.OverflowException">
           <paramref name="t" /> equals <see cref="F:System.TimeSpan.MinValue" />.</exception>
@@ -1476,6 +1508,10 @@ minus the value of <paramref name="t2" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.TimeSpan" /> whose value is the negated value of the specified instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that has the same numeric value as this instance, but the opposite sign.</para>
+        </returns>
         <param name="t">
           <attribution license="cc4" from="Microsoft" modified="false" />The time interval to be negated. </param>
       </Docs>
@@ -1498,11 +1534,6 @@ minus the value of <paramref name="t2" />.</para>
         <Parameter Name="t" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see cref="T:System.TimeSpan" />
-            <paramref name="t" />.</para>
-        </returns>
         <remarks>
           <para>This method returns <see cref="T:System.TimeSpan" /><paramref name="t" />.</para>
         </remarks>
@@ -1510,6 +1541,10 @@ minus the value of <paramref name="t2" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the specified instance of <see cref="T:System.TimeSpan" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The time interval specified by <paramref name="t" />.</para>
+        </returns>
         <param name="t">
           <attribution license="cc4" from="Microsoft" modified="false" />The time interval to return. </param>
       </Docs>
@@ -1532,9 +1567,6 @@ minus the value of <paramref name="t2" />.</para>
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.TimeSpan" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -1668,6 +1700,10 @@ parses to TimeSpan -5.12:34:56.7890000
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a time interval to its <see cref="T:System.TimeSpan" /> equivalent. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A time interval that corresponds to <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that specifies the time interval to convert. </param>
       </Docs>
@@ -1688,7 +1724,6 @@ parses to TimeSpan -5.12:34:56.7890000
         <Parameter Name="formatProvider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="input" /> parameter contains a time interval specification in the form: </para>
@@ -1806,6 +1841,10 @@ parses to TimeSpan -5.12:34:56.7890000
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a time interval to its <see cref="T:System.TimeSpan" /> equivalent by using the specified culture-specific format information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A time interval that corresponds to <paramref name="input" />, as specified by <paramref name="formatProvider" />.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that specifies the time interval to convert.</param>
         <param name="formatProvider">
@@ -1828,7 +1867,6 @@ parses to TimeSpan -5.12:34:56.7890000
         <Parameter Name="formatProvider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.TimeSpan.ParseExact(System.String,System.String,System.IFormatProvider)" /> method parses the string representation of a time interval, which must be in the format defined by the <paramref name="format" /> parameter, except that leading and trailing white-space characters are ignored. Because <paramref name="input" /> must conform to the format of <paramref name="format" /> exactly, you should always use exception handling when converting a string input by the user to a time interval. If you prefer not to use exception handling, you can call the <see cref="M:System.TimeSpan.TryParseExact(System.String,System.String,System.IFormatProvider,System.TimeSpan@)" /> method instead.</para>
@@ -1854,6 +1892,10 @@ parses to TimeSpan -5.12:34:56.7890000
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a time interval to its <see cref="T:System.TimeSpan" /> equivalent by using the specified format and culture-specific format information. The format of the string representation must match the specified format exactly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A time interval that corresponds to <paramref name="input" />, as specified by <paramref name="format" /> and <paramref name="formatProvider" />.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that specifies the time interval to convert.</param>
         <param name="format">
@@ -1878,7 +1920,6 @@ parses to TimeSpan -5.12:34:56.7890000
         <Parameter Name="formatProvider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.TimeSpan.ParseExact(System.String,System.String,System.IFormatProvider)" /> method parses the string representation of a time interval, which must be in one of the formats defined by the <paramref name="formats" /> parameter, except that leading and trailing white-space characters are ignored. Because <paramref name="input" /> must exactly conform to one of the formats specified in <paramref name="formats" />, you should always use exception handling when converting a string input by the user to a time interval. If you prefer not to use exception handling, you can call the <see cref="M:System.TimeSpan.TryParseExact(System.String,System.String[],System.IFormatProvider,System.TimeSpan@)" /> method instead.</para>
@@ -1904,6 +1945,10 @@ parses to TimeSpan -5.12:34:56.7890000
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a time interval to its <see cref="T:System.TimeSpan" /> equivalent by using the specified array of format strings and culture-specific format information. The format of the string representation must match one of the specified formats exactly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A time interval that corresponds to <paramref name="input" />, as specified by <paramref name="formats" /> and <paramref name="formatProvider" />.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that specifies the time interval to convert.</param>
         <param name="formats">
@@ -1929,7 +1974,6 @@ parses to TimeSpan -5.12:34:56.7890000
         <Parameter Name="styles" Type="System.Globalization.TimeSpanStyles" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.TimeSpan.ParseExact(System.String,System.String,System.IFormatProvider,System.Globalization.TimeSpanStyles)" /> method parses the string representation of a time interval, which must be in the format defined by the <paramref name="format" /> parameter, except that leading and trailing white-space characters are ignored. Because <paramref name="input" /> must conform to the format of <paramref name="format" /> exactly, you should always use exception handling when converting a string input by the user to a time interval. If you prefer not to use exception handling, you can call the <see cref="M:System.TimeSpan.TryParseExact(System.String,System.String,System.IFormatProvider,System.Globalization.TimeSpanStyles,System.TimeSpan@)" /> method instead.</para>
@@ -1956,6 +2000,10 @@ parses to TimeSpan -5.12:34:56.7890000
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a time interval to its <see cref="T:System.TimeSpan" /> equivalent by using the specified format, culture-specific format information, and styles. The format of the string representation must match the specified format exactly.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A time interval that corresponds to <paramref name="input" />, as specified by <paramref name="format" />, <paramref name="formatProvider" />, and <paramref name="styles" />.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that specifies the time interval to convert.</param>
         <param name="format">
@@ -1983,7 +2031,6 @@ parses to TimeSpan -5.12:34:56.7890000
         <Parameter Name="styles" Type="System.Globalization.TimeSpanStyles" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.TimeSpan.ParseExact(System.String,System.String[],System.IFormatProvider,System.Globalization.TimeSpanStyles)" /> method parses the string representation of a time interval, which must be in one of the formats defined by the <paramref name="formats" /> parameter, except that leading and trailing white-space characters are ignored. Because <paramref name="input" /> must exactly conform to one of the formats specified in <paramref name="formats" />, you should always use exception handling when converting a string input by the user to a time interval. If you prefer not to use exception handling, you can call the <see cref="M:System.TimeSpan.TryParseExact(System.String,System.String[],System.IFormatProvider,System.Globalization.TimeSpanStyles,System.TimeSpan@)" /> method instead.</para>
@@ -2010,6 +2057,10 @@ parses to TimeSpan -5.12:34:56.7890000
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a time interval to its <see cref="T:System.TimeSpan" /> equivalent by using the specified formats, culture-specific format information, and styles. The format of the string representation must match one of the specified formats exactly. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A time interval that corresponds to <paramref name="input" />, as specified by <paramref name="formats" />, <paramref name="formatProvider" />, and <paramref name="styles" />.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that specifies the time interval to convert.</param>
         <param name="formats">
@@ -2086,10 +2137,6 @@ public class TimeSpanPropertiesExampleOne {
         <Parameter Name="ts" Type="System.TimeSpan" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.TimeSpan" /> whose value is equal to the value of the current
-   instance minus the value of <paramref name="ts" />.</para>
-        </returns>
         <exception cref="T:System.OverflowException">The difference between the value of the current instance and <paramref name="ts" /> is less than <see cref="F:System.TimeSpan.MinValue" /> or greater than <see cref="F:System.TimeSpan.MaxValue" />.</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2100,6 +2147,10 @@ public class TimeSpanPropertiesExampleOne {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new <see cref="T:System.TimeSpan" /> object whose value is the difference between the specified <see cref="T:System.TimeSpan" /> object and this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new time interval whose value is the result of the value of this instance minus the value of <paramref name="ts" />.</para>
+        </returns>
         <param name="ts">
           <attribution license="cc4" from="Microsoft" modified="false" />The time interval to be subtracted. </param>
       </Docs>
@@ -2285,45 +2336,6 @@ public class TimeSpanPropertiesExampleOne {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted as follows:</para>
-          <para>[-][d.]hh:mm:ss[.ff]</para>
-          <para>Items in square brackets ('[' and ']') are included
-   provisionally: '-' is included if and only if the current instance is negative;
-   "d." and ".ff" are included if and only if those components are non-zero. Colons
-   and periods (':' and '.') are literal characters. Other components are as follows.</para>
-          <list type="table">
-            <listheader>
-              <term>Component</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> "-"</term>
-              <description>Minus sign, indicating a negative time
-         interval.</description>
-            </item>
-            <item>
-              <term> "d"</term>
-              <description>Days.</description>
-            </item>
-            <item>
-              <term> "hh"</term>
-              <description>Hours, ranging from 0 to 23 inclusive.</description>
-            </item>
-            <item>
-              <term> "mm"</term>
-              <description>Minutes, ranging from 0 to 59 inclusive.</description>
-            </item>
-            <item>
-              <term> "ss"</term>
-              <description>Seconds, ranging from 0 to 59 inclusive.</description>
-            </item>
-            <item>
-              <term> "ff"</term>
-              <description>Fractional seconds.</description>
-            </item>
-          </list>
-        </returns>
         <example>
           <para>This example demonstrates the <see cref="M:System.TimeSpan.ToString" /> method.</para>
           <code lang="C#">using System;
@@ -2417,6 +2429,10 @@ public class TimeSpanToStringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current <see cref="T:System.TimeSpan" /> object to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the current <see cref="T:System.TimeSpan" /> value. </para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -2434,7 +2450,6 @@ public class TimeSpanToStringExample {
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="format" /> parameter can be any valid standard or custom format specifier for <see cref="T:System.TimeSpan" /> values. If <paramref name="format" /> is equal to <see cref="F:System.String.Empty" /> or is null, the return value of the current <see cref="T:System.TimeSpan" /> object is formatted with the common format specifier ("c"). If <paramref name="format" /> is any other value, the method throws a <see cref="T:System.FormatException" />. </para>
@@ -2456,6 +2471,10 @@ public class TimeSpanToStringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current <see cref="T:System.TimeSpan" /> object to its equivalent string representation by using the specified format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the current <see cref="T:System.TimeSpan" /> value in the format specified by the <paramref name="format" /> parameter.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A standard or custom <see cref="T:System.TimeSpan" /> format string.</param>
       </Docs>
@@ -2475,7 +2494,6 @@ public class TimeSpanToStringExample {
         <Parameter Name="formatProvider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="format" /> parameter can be any valid standard or custom format specifier for <see cref="T:System.TimeSpan" /> values. If <paramref name="format" /> is equal to <see cref="F:System.String.Empty" /> or is null, the return value of the current <see cref="T:System.TimeSpan" /> object is formatted with the common format specifier ("c"). If format is any other value, the method throws a <see cref="T:System.FormatException" />. </para>
@@ -2509,6 +2527,10 @@ public class TimeSpanToStringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current <see cref="T:System.TimeSpan" /> object to its equivalent string representation by using the specified format and culture-specific formatting information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the current <see cref="T:System.TimeSpan" /> value, as specified by <paramref name="format" /> and <paramref name="formatProvider" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A standard or custom <see cref="T:System.TimeSpan" /> format string.</param>
         <param name="formatProvider">
diff --git a/mcs/class/corlib/Documentation/en/System/TimeZone.xml b/mcs/class/corlib/Documentation/en/System/TimeZone.xml
index 1a023dc65f9..4b27619d46b 100644
--- a/mcs/class/corlib/Documentation/en/System/TimeZone.xml
+++ b/mcs/class/corlib/Documentation/en/System/TimeZone.xml
@@ -119,7 +119,6 @@
         <Parameter Name="year" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Globalization.DaylightTime'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Only one daylight saving time period per year is supported.</para>
@@ -129,6 +128,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the daylight saving time period for a particular year.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Globalization.DaylightTime" /> object that contains the start and end date for daylight saving time in <paramref name="year" />.</para>
+        </returns>
         <param name="year">
           <attribution license="cc4" from="Microsoft" modified="false" />The year that the daylight saving time period applies to. </param>
       </Docs>
@@ -149,7 +152,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'TimeSpan'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns the offset, or difference, between the <paramref name="time" /> parameter and Coordinated Universal Time (UTC). That is:</para>
@@ -167,6 +169,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the Coordinated Universal Time (UTC) offset for the specified local time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The Coordinated Universal Time (UTC) offset from <paramref name="time" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />A date and time value.</param>
       </Docs>
@@ -187,7 +193,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The year to which the daylight saving time period applies is derived from the <paramref name="time" /> parameter.</para>
@@ -197,6 +202,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified date and time is within a daylight saving time period.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="time" /> is in a daylight saving time period; otherwise, false.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />A date and time. </param>
       </Docs>
@@ -218,7 +227,6 @@
         <Parameter Name="daylightTimes" Type="System.Globalization.DaylightTime" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.TimeZoneInfo.IsDaylightSavingTime(System.DateTime)" /> method provides the same functionality as this overload of the <see cref="M:System.TimeZone.IsDaylightSavingTime(System.DateTime,System.Globalization.DaylightTime)" /> method. Whenever possible, use the <see cref="M:System.TimeZoneInfo.IsDaylightSavingTime(System.DateTime)" /> method.</para>
@@ -227,6 +235,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the specified date and time is within the specified daylight saving time period.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="time" /> is in <paramref name="daylightTimes" />; otherwise, false.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />A date and time. </param>
         <param name="daylightTimes">
@@ -273,7 +285,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>A DateTime object adjusted for the object's time zone.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The following table shows the relationship between the <paramref name="time" /> parameter and the <see cref="T:System.DateTime" /> value returned by this method.</para>
@@ -336,6 +347,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the local time that corresponds to a specified date and time value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DateTime" /> object whose value is the local time that corresponds to <paramref name="time" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />A Coordinated Universal Time (UTC) time. </param>
       </Docs>
@@ -356,7 +371,6 @@
         <Parameter Name="time" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'DateTime'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the local time zone observes daylight saving time, <see cref="M:System.TimeZone.ToUniversalTime(System.DateTime)" /> applies the current adjustment rule to the <paramref name="time" /> parameter when performing the conversion. </para>
@@ -371,6 +385,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the Coordinated Universal Time (UTC) that corresponds to a specified time.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.DateTime" /> object whose value is the Coordinated Universal Time (UTC) that corresponds to <paramref name="time" />.</para>
+        </returns>
         <param name="time">
           <attribution license="cc4" from="Microsoft" modified="false" />A date and time. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System/Tuple`1.xml b/mcs/class/corlib/Documentation/en/System/Tuple`1.xml
index e961a307f12..900542afe1f 100644
--- a/mcs/class/corlib/Documentation/en/System/Tuple`1.xml
+++ b/mcs/class/corlib/Documentation/en/System/Tuple`1.xml
@@ -69,7 +69,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="obj" /> parameter is considered to be equal to the current instance under the following conditions:</para>
@@ -89,6 +88,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current <see cref="T:System.Tuple`1" /> object is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current instance is equal to the specified object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this instance.</param>
       </Docs>
@@ -105,12 +108,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for the current <see cref="T:System.Tuple`1" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Item1">
@@ -159,7 +165,6 @@
         <Parameter Name="comparer" Type="System.Collections.IComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Although this method can be called directly, it is most commonly called by collection sorting methods that include <see cref="T:System.Collections.IComparer" /> parameters to order the members of a collection. For example, it is called by the <see cref="M:System.Array.Sort(System.Array,System.Collections.IComparer)" /> method and the <see cref="M:System.Collections.SortedList.Add(System.Object,System.Object)" /> method of a <see cref="T:System.Collections.SortedList" /> object that is instantiated by using the <see cref="M:System.Collections.SortedList.#ctor(System.Collections.IComparer)" /> constructor.</para>
@@ -171,6 +176,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current <see cref="T:System.Tuple`1" /> object to a specified object by using a specified comparer, and returns an integer that indicates whether the current object is before, after, or in the same position as the specified object in the sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative position of this instance and <paramref name="other" /> in the sort order, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>A negative integer</para>
+              </term>
+              <description>
+                <para>This instance precedes <paramref name="other" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>This instance and <paramref name="other" /> have the same position in the sort order.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>A positive integer</para>
+              </term>
+              <description>
+                <para>This instance follows <paramref name="other" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with the current instance.</param>
         <param name="comparer">
@@ -192,7 +237,6 @@
         <Parameter Name="comparer" Type="System.Collections.IEqualityComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Tuple`1" /> instance is cast to an <see cref="T:System.Collections.IStructuralEquatable" /> interface.</para>
@@ -202,6 +246,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current <see cref="T:System.Tuple`1" /> object is equal to a specified object based on a specified comparison method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current instance is equal to the specified object; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this instance.</param>
         <param name="comparer">
@@ -222,7 +270,6 @@
         <Parameter Name="comparer" Type="System.Collections.IEqualityComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Tuple`1" /> instance is cast to an <see cref="T:System.Collections.IStructuralEquatable" /> interface.</para>
@@ -233,6 +280,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the hash code for the current <see cref="T:System.Tuple`1" /> object by using a specified computation method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
         <param name="comparer">
           <attribution license="cc4" from="Microsoft" modified="false" />An object whose <see cref="M:System.Collections.IEqualityComparer.GetHashCode(System.Object)" />  method calculates the hash code of the current <see cref="T:System.Tuple`1" /> object.</param>
       </Docs>
@@ -251,7 +302,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Tuple`1" /> instance is cast to an <see cref="T:System.IComparable" /> interface.</para>
@@ -265,6 +315,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current <see cref="T:System.Tuple`1" /> object to a specified object, and returns an integer that indicates whether the current object is before, after, or in the same position as the specified object in the sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative position of this instance and <paramref name="obj" /> in the sort order, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>A negative integer</para>
+              </term>
+              <description>
+                <para>This instance precedes <paramref name="obj" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>This instance and <paramref name="obj" /> have the same position in the sort order.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>A positive integer</para>
+              </term>
+              <description>
+                <para>This instance follows <paramref name="obj" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with the current instance.</param>
       </Docs>
@@ -298,7 +388,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The string returned by this method takes the form (Item1), where Item1 represents the value of the <see cref="P:System.Tuple`1.Item1" /> property. If the value of <see cref="P:System.Tuple`1.Item1" /> is null, it is represented as <see cref="F:System.String.Empty" />.</para>
@@ -307,6 +396,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the value of this <see cref="T:System.Tuple`1" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of this <see cref="T:System.Tuple`1" /> object.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System/Tuple`2.xml b/mcs/class/corlib/Documentation/en/System/Tuple`2.xml
index b1a73c2acb4..4cf27901d66 100644
--- a/mcs/class/corlib/Documentation/en/System/Tuple`2.xml
+++ b/mcs/class/corlib/Documentation/en/System/Tuple`2.xml
@@ -90,7 +90,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="obj" /> parameter is considered to be equal to the current instance under the following conditions:</para>
@@ -110,6 +109,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current <see cref="T:System.Tuple`2" /> object is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current instance is equal to the specified object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this instance.</param>
       </Docs>
@@ -126,12 +129,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for the current <see cref="T:System.Tuple`2" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Item1">
@@ -209,7 +215,6 @@
         <Parameter Name="comparer" Type="System.Collections.IComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Tuple`2" /> instance is cast to an <see cref="T:System.Collections.IStructuralComparable" /> interface.</para>
@@ -222,6 +227,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current <see cref="T:System.Tuple`2" /> object to a specified object by using a specified comparer, and returns an integer that indicates whether the current object is before, after, or in the same position as the specified object in the sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative position of this instance and <paramref name="other" /> in the sort order, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>A negative integer</para>
+              </term>
+              <description>
+                <para>This instance precedes <paramref name="other" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>This instance and <paramref name="other" /> have the same position in the sort order.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>A positive integer</para>
+              </term>
+              <description>
+                <para>This instance follows <paramref name="other" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with the current instance.</param>
         <param name="comparer">
@@ -243,7 +288,6 @@
         <Parameter Name="comparer" Type="System.Collections.IEqualityComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Tuple`2" /> instance is cast to an <see cref="T:System.Collections.IStructuralEquatable" /> interface.</para>
@@ -253,6 +297,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current <see cref="T:System.Tuple`2" /> object is equal to a specified object based on a specified comparison method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current instance is equal to the specified object; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this instance.</param>
         <param name="comparer">
@@ -273,7 +321,6 @@
         <Parameter Name="comparer" Type="System.Collections.IEqualityComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Tuple`2" /> instance is cast to an <see cref="T:System.Collections.IStructuralEquatable" /> interface.</para>
@@ -284,6 +331,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the hash code for the current <see cref="T:System.Tuple`2" /> object by using a specified computation method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
         <param name="comparer">
           <attribution license="cc4" from="Microsoft" modified="false" />An object whose <see cref="M:System.Collections.IEqualityComparer.GetHashCode(System.Object)" />  method calculates the hash code of the current <see cref="T:System.Tuple`2" /> object.</param>
       </Docs>
@@ -302,7 +353,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Tuple`2" /> instance is cast to an <see cref="T:System.IComparable" /> interface.</para>
@@ -316,6 +366,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current <see cref="T:System.Tuple`2" /> object to a specified object and returns an integer that indicates whether the current object is before, after, or in the same position as the specified object in the sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative position of this instance and <paramref name="obj" /> in the sort order, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>A negative integer</para>
+              </term>
+              <description>
+                <para>This instance precedes <paramref name="obj" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>This instance and <paramref name="obj" /> have the same position in the sort order.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>A positive integer</para>
+              </term>
+              <description>
+                <para>This instance follows <paramref name="obj" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with the current instance.</param>
       </Docs>
@@ -349,7 +439,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The string returned by this method takes the form (Item1, Item2), where Item1 and Item2 represent the values of the <see cref="P:System.Tuple`2.Item1" /> and <see cref="P:System.Tuple`2.Item2" /> properties. If either property value is null, it is represented as <see cref="F:System.String.Empty" />.</para>
@@ -358,6 +447,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the value of this <see cref="T:System.Tuple`2" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of this <see cref="T:System.Tuple`2" /> object.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System/Tuple`3.xml b/mcs/class/corlib/Documentation/en/System/Tuple`3.xml
index 59eccd39341..b7f9c07023f 100644
--- a/mcs/class/corlib/Documentation/en/System/Tuple`3.xml
+++ b/mcs/class/corlib/Documentation/en/System/Tuple`3.xml
@@ -93,7 +93,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="obj" /> parameter is considered to be equal to the current instance under the following conditions:</para>
@@ -113,6 +112,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current <see cref="T:System.Tuple`3" /> object is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current instance is equal to the specified object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this instance.</param>
       </Docs>
@@ -129,12 +132,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for the current <see cref="T:System.Tuple`3" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Item1">
@@ -242,7 +248,6 @@
         <Parameter Name="comparer" Type="System.Collections.IComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Tuple`3" /> instance is cast to an <see cref="T:System.Collections.IStructuralComparable" /> interface.</para>
@@ -255,6 +260,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current <see cref="T:System.Tuple`3" /> object to a specified object by using a specified comparer, and returns an integer that indicates whether the current object is before, after, or in the same position as the specified object in the sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative position of this instance and <paramref name="other" /> in the sort order, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>A negative integer</para>
+              </term>
+              <description>
+                <para>This instance precedes <paramref name="other" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>This instance and <paramref name="other" /> have the same position in the sort order.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>A positive integer</para>
+              </term>
+              <description>
+                <para>This instance follows <paramref name="other" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with the current instance.</param>
         <param name="comparer">
@@ -276,7 +321,6 @@
         <Parameter Name="comparer" Type="System.Collections.IEqualityComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Tuple`3" /> instance is cast to an <see cref="T:System.Collections.IStructuralEquatable" /> interface.</para>
@@ -286,6 +330,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current <see cref="T:System.Tuple`3" /> object is equal to a specified object based on a specified comparison method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current instance is equal to the specified object; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this instance.</param>
         <param name="comparer">
@@ -306,7 +354,6 @@
         <Parameter Name="comparer" Type="System.Collections.IEqualityComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Tuple`3" /> instance is cast to an <see cref="T:System.Collections.IStructuralEquatable" /> interface.</para>
@@ -317,6 +364,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the hash code for the current <see cref="T:System.Tuple`3" /> object by using a specified computation method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
         <param name="comparer">
           <attribution license="cc4" from="Microsoft" modified="false" />An object whose <see cref="M:System.Collections.IEqualityComparer.GetHashCode(System.Object)" />  method calculates the hash code of the current <see cref="T:System.Tuple`3" /> object.</param>
       </Docs>
@@ -335,7 +386,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Tuple`3" /> instance is cast to an <see cref="T:System.IComparable" /> interface.</para>
@@ -349,6 +399,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current <see cref="T:System.Tuple`3" /> object to a specified object and returns an integer that indicates whether the current object is before, after, or in the same position as the specified object in the sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative position of this instance and <paramref name="obj" /> in the sort order, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>A negative integer</para>
+              </term>
+              <description>
+                <para>This instance precedes <paramref name="obj" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>This instance and <paramref name="obj" /> have the same position in the sort order.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>A positive integer</para>
+              </term>
+              <description>
+                <para>This instance follows <paramref name="obj" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with the current instance.</param>
       </Docs>
@@ -382,7 +472,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The string returned by this method takes the form (Item1, Item2, Item3), where Item1, Item2, and Item3 represent the values of the <see cref="P:System.Tuple`3.Item1" />, <see cref="P:System.Tuple`3.Item2" />, and <see cref="P:System.Tuple`3.Item3" /> properties, respectively. If any of the property values is null, it is represented as <see cref="F:System.String.Empty" />.</para>
@@ -391,6 +480,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the value of this <see cref="T:System.Tuple`3" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of this <see cref="T:System.Tuple`3" /> object.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System/Tuple`4.xml b/mcs/class/corlib/Documentation/en/System/Tuple`4.xml
index e4a07b0060f..d1829a4b459 100644
--- a/mcs/class/corlib/Documentation/en/System/Tuple`4.xml
+++ b/mcs/class/corlib/Documentation/en/System/Tuple`4.xml
@@ -97,7 +97,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="obj" /> parameter is considered to be equal to the current instance under the following conditions:</para>
@@ -117,6 +116,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current <see cref="T:System.Tuple`4" /> object is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current instance is equal to the specified object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this instance.</param>
       </Docs>
@@ -133,12 +136,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for the current <see cref="T:System.Tuple`4" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Item1">
@@ -276,7 +282,6 @@
         <Parameter Name="comparer" Type="System.Collections.IComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Tuple`4" /> instance is cast to an <see cref="T:System.Collections.IStructuralComparable" />  interface.</para>
@@ -289,6 +294,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current <see cref="T:System.Tuple`4" /> object to a specified object by using a specified comparer and returns an integer that indicates whether the current object is before, after, or in the same position as the specified object in the sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative position of this instance and <paramref name="other" /> in the sort order, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>A negative integer</para>
+              </term>
+              <description>
+                <para>This instance precedes <paramref name="other" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>This instance and <paramref name="other" /> have the same position in the sort order.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>A positive integer</para>
+              </term>
+              <description>
+                <para>This instance follows <paramref name="other" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with the current instance.</param>
         <param name="comparer">
@@ -310,7 +355,6 @@
         <Parameter Name="comparer" Type="System.Collections.IEqualityComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Tuple`4" /> instance is cast to an <see cref="T:System.Collections.IStructuralEquatable" /> interface.</para>
@@ -320,6 +364,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current <see cref="T:System.Tuple`4" /> object is equal to a specified object based on a specified comparison method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current instance is equal to the specified object; otherwise, false. </para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this instance.</param>
         <param name="comparer">
@@ -340,7 +388,6 @@
         <Parameter Name="comparer" Type="System.Collections.IEqualityComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Tuple`4" /> instance is cast to an <see cref="T:System.Collections.IStructuralEquatable" /> interface.</para>
@@ -351,6 +398,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the hash code for the current <see cref="T:System.Tuple`4" /> object by using a specified computation method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
         <param name="comparer">
           <attribution license="cc4" from="Microsoft" modified="false" />An object whose <see cref="M:System.Collections.IEqualityComparer.GetHashCode(System.Object)" />  method calculates the hash code of the current <see cref="T:System.Tuple`4" /> object.</param>
       </Docs>
@@ -369,7 +420,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Tuple`4" /> instance is cast to an <see cref="T:System.IComparable" /> interface.</para>
@@ -383,6 +433,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current <see cref="T:System.Tuple`4" /> object to a specified object and returns an integer that indicates whether the current object is before, after, or in the same position as the specified object in the sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative position of this instance and <paramref name="obj" /> in the sort order, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>A negative integer</para>
+              </term>
+              <description>
+                <para>This instance precedes <paramref name="obj" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>This instance and <paramref name="obj" /> have the same position in the sort order.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>A positive integer</para>
+              </term>
+              <description>
+                <para>This instance follows <paramref name="obj" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with the current instance.</param>
       </Docs>
@@ -416,7 +506,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The string returned by this method takes the form (Item1, Item2, Item3, Item4), where Item1, Item2, Item3, and Item4 represent the values of the <see cref="P:System.Tuple`4.Item1" />, <see cref="P:System.Tuple`4.Item2" />, <see cref="P:System.Tuple`4.Item3" />, and <see cref="P:System.Tuple`4.Item4" /> properties, respectively. If any of the property values is null, it is represented as <see cref="F:System.String.Empty" />.</para>
@@ -425,6 +514,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the value of this <see cref="T:System.Tuple`4" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of this <see cref="T:System.Tuple`4" /> object.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System/Tuple`5.xml b/mcs/class/corlib/Documentation/en/System/Tuple`5.xml
index 61503316d76..fb552165514 100644
--- a/mcs/class/corlib/Documentation/en/System/Tuple`5.xml
+++ b/mcs/class/corlib/Documentation/en/System/Tuple`5.xml
@@ -101,7 +101,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="obj" /> parameter is considered to be equal to the current instance under the following conditions:</para>
@@ -121,6 +120,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current <see cref="T:System.Tuple`5" /> object is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current instance is equal to the specified object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this instance.</param>
       </Docs>
@@ -137,12 +140,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for the current <see cref="T:System.Tuple`5" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Item1">
@@ -310,7 +316,6 @@
         <Parameter Name="comparer" Type="System.Collections.IComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Tuple`5" /> instance is cast to an <see cref="T:System.Collections.IStructuralComparable" /> interface.</para>
@@ -323,6 +328,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current <see cref="T:System.Tuple`5" /> object to a specified object by using a specified comparer and returns an integer that indicates whether the current object is before, after, or in the same position as the specified object in the sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative position of this instance and <paramref name="other" /> in the sort order, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>A negative integer</para>
+              </term>
+              <description>
+                <para>This instance precedes <paramref name="other" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>This instance and <paramref name="other" /> have the same position in the sort order.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>A positive integer</para>
+              </term>
+              <description>
+                <para>This instance follows <paramref name="other" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with the current instance.</param>
         <param name="comparer">
@@ -344,7 +389,6 @@
         <Parameter Name="comparer" Type="System.Collections.IEqualityComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Tuple`5" /> instance is cast to an <see cref="T:System.Collections.IStructuralEquatable" /> interface.</para>
@@ -354,6 +398,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current <see cref="T:System.Tuple`5" /> object is equal to a specified object based on a specified comparison method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current instance is equal to the specified object; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this instance.</param>
         <param name="comparer">
@@ -374,7 +422,6 @@
         <Parameter Name="comparer" Type="System.Collections.IEqualityComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Tuple`5" /> instance is cast to an <see cref="T:System.Collections.IStructuralEquatable" /> interface.</para>
@@ -385,6 +432,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the hash code for the current <see cref="T:System.Tuple`5" /> object by using a specified computation method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
         <param name="comparer">
           <attribution license="cc4" from="Microsoft" modified="false" />An object whose <see cref="M:System.Collections.IEqualityComparer.GetHashCode(System.Object)" />  method calculates the hash code of the current <see cref="T:System.Tuple`5" /> object.</param>
       </Docs>
@@ -403,7 +454,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Tuple`5" /> instance is cast to an <see cref="T:System.IComparable" /> interface.</para>
@@ -417,6 +467,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current <see cref="T:System.Tuple`5" /> object to a specified object and returns an integer that indicates whether the current object is before, after, or in the same position as the specified object in the sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative position of this instance and <paramref name="obj" /> in the sort order, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>A negative integer</para>
+              </term>
+              <description>
+                <para>This instance precedes <paramref name="obj" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>This instance and <paramref name="obj" /> have the same position in the sort order.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>A positive integer</para>
+              </term>
+              <description>
+                <para>This instance follows <paramref name="obj" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with the current instance.</param>
       </Docs>
@@ -450,7 +540,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The string returned by this method takes the form (Item1, Item2, Item3, Item4, <paramref name="Item5" />), where Item1, Item2, Item3, Item4, and <paramref name="Item5" /> represent the values of the <see cref="P:System.Tuple`5.Item1" />, <see cref="P:System.Tuple`5.Item2" />, <see cref="P:System.Tuple`5.Item3" />, <see cref="P:System.Tuple`5.Item4" />, and <see cref="P:System.Tuple`5.Item5" /> properties, respectively. If any of the property values is null, it is represented as <see cref="F:System.String.Empty" />.</para>
@@ -459,6 +548,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the value of this <see cref="T:System.Tuple`5" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of this <see cref="T:System.Tuple`5" /> object.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System/Tuple`6.xml b/mcs/class/corlib/Documentation/en/System/Tuple`6.xml
index 0e3888430ab..7cb4928ec59 100644
--- a/mcs/class/corlib/Documentation/en/System/Tuple`6.xml
+++ b/mcs/class/corlib/Documentation/en/System/Tuple`6.xml
@@ -105,7 +105,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="obj" /> parameter is considered to be equal to the current instance under the following conditions:</para>
@@ -125,6 +124,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current <see cref="T:System.Tuple`6" /> object is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current instance is equal to the specified object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this instance.</param>
       </Docs>
@@ -141,12 +144,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for the current <see cref="T:System.Tuple`6" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Item1">
@@ -344,7 +350,6 @@
         <Parameter Name="comparer" Type="System.Collections.IComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Tuple`6" /> instance is cast to an <see cref="T:System.Collections.IStructuralComparable" /> interface.</para>
@@ -358,6 +363,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current <see cref="T:System.Tuple`6" /> object to a specified object by using a specified comparer and returns an integer that indicates whether the current object is before, after, or in the same position as the specified object in the sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative position of this instance and <paramref name="other" /> in the sort order, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>A negative integer</para>
+              </term>
+              <description>
+                <para>This instance precedes <paramref name="other" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>This instance and <paramref name="other" /> have the same position in the sort order.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>A positive integer</para>
+              </term>
+              <description>
+                <para>This instance follows <paramref name="other" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with the current instance.</param>
         <param name="comparer">
@@ -379,7 +424,6 @@
         <Parameter Name="comparer" Type="System.Collections.IEqualityComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Tuple`6" /> instance is cast to an <see cref="T:System.Collections.IStructuralEquatable" /> interface.</para>
@@ -389,6 +433,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current <see cref="T:System.Tuple`6" /> object is equal to a specified object based on a specified comparison method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current instance is equal to the specified object; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this instance.</param>
         <param name="comparer">
@@ -409,7 +457,6 @@
         <Parameter Name="comparer" Type="System.Collections.IEqualityComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Tuple`6" /> instance is cast to an <see cref="T:System.Collections.IStructuralEquatable" /> interface.</para>
@@ -420,6 +467,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the hash code for the current <see cref="T:System.Tuple`6" /> object by using a specified computation method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
         <param name="comparer">
           <attribution license="cc4" from="Microsoft" modified="false" />An object whose <see cref="M:System.Collections.IEqualityComparer.GetHashCode(System.Object)" />  method calculates the hash code of the current <see cref="T:System.Tuple`6" /> object.</param>
       </Docs>
@@ -438,7 +489,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Tuple`6" /> instance is cast to an <see cref="T:System.IComparable" /> interface.</para>
@@ -452,6 +502,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current <see cref="T:System.Tuple`6" /> object to a specified object and returns an integer that indicates whether the current object is before, after, or in the same position as the specified object in the sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative position of this instance and <paramref name="obj" /> in the sort order, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>A negative integer</para>
+              </term>
+              <description>
+                <para>This instance precedes <paramref name="obj" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>This instance and <paramref name="obj" /> have the same position in the sort order.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>A positive integer</para>
+              </term>
+              <description>
+                <para>This instance follows <paramref name="obj" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with the current instance.</param>
       </Docs>
@@ -485,7 +575,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The string returned by this method takes the form (Item1, Item2, Item3, Item4, <paramref name="Item5, Item6" />), where Item1, Item2, Item3, Item4, Item5, and Item6 represent the values of the <see cref="P:System.Tuple`6.Item1" />, <see cref="P:System.Tuple`6.Item2" />, <see cref="P:System.Tuple`6.Item3" />, <see cref="P:System.Tuple`6.Item4" />, <see cref="P:System.Tuple`6.Item5" />, and <see cref="P:System.Tuple`6.Item6" /> properties, respectively. If any of the property values is null, it is represented as <see cref="F:System.String.Empty" />.</para>
@@ -494,6 +583,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the value of this <see cref="T:System.Tuple`6" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of this <see cref="T:System.Tuple`6" /> object.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System/Tuple`7.xml b/mcs/class/corlib/Documentation/en/System/Tuple`7.xml
index f9c7efc436e..c8a8c8b1a92 100644
--- a/mcs/class/corlib/Documentation/en/System/Tuple`7.xml
+++ b/mcs/class/corlib/Documentation/en/System/Tuple`7.xml
@@ -109,7 +109,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="obj" /> parameter is considered to be equal to the current instance under the following conditions:</para>
@@ -129,6 +128,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current <see cref="T:System.Tuple`7" /> object is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current instance is equal to the specified object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this instance.</param>
       </Docs>
@@ -145,12 +148,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for the current <see cref="T:System.Tuple`7" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Item1">
@@ -378,7 +384,6 @@
         <Parameter Name="comparer" Type="System.Collections.IComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface implementation. It can be used only when the <see cref="T:System.Tuple`7" /> instance is cast to an <see cref="T:System.Collections.IStructuralComparable" /> interface.</para>
@@ -392,6 +397,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current <see cref="T:System.Tuple`7" /> object to a specified object by using a specified comparer, and returns an integer that indicates whether the current object is before, after, or in the same position as the specified object in the sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative position of this instance and <paramref name="other" /> in the sort order, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>A negative integer</para>
+              </term>
+              <description>
+                <para>This instance precedes <paramref name="other" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>This instance and <paramref name="other" /> have the same position in the sort order.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>A positive integer</para>
+              </term>
+              <description>
+                <para>This instance follows <paramref name="other" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with the current instance.</param>
         <param name="comparer">
@@ -413,7 +458,6 @@
         <Parameter Name="comparer" Type="System.Collections.IEqualityComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Tuple`7" /> instance is cast to an <see cref="T:System.Collections.IStructuralEquatable" /> interface.</para>
@@ -423,6 +467,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current <see cref="T:System.Tuple`7" /> object is equal to a specified object based on a specified comparison method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current instance is equal to the specified object; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this instance.</param>
         <param name="comparer">
@@ -443,7 +491,6 @@
         <Parameter Name="comparer" Type="System.Collections.IEqualityComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Tuple`7" /> instance is cast to an <see cref="T:System.Collections.IStructuralEquatable" /> interface.</para>
@@ -454,6 +501,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the hash code for the current <see cref="T:System.Tuple`7" /> object by using a specified computation method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
         <param name="comparer">
           <attribution license="cc4" from="Microsoft" modified="false" />An object whose <see cref="M:System.Collections.IEqualityComparer.GetHashCode(System.Object)" /> method calculates the hash code of the current <see cref="T:System.Tuple`7" /> object.</param>
       </Docs>
@@ -472,7 +523,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Tuple`7" /> instance is cast to an <see cref="T:System.IComparable" /> interface.</para>
@@ -486,6 +536,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current <see cref="T:System.Tuple`7" /> object to a specified object and returns an integer that indicates whether the current object is before, after, or in the same position as the specified object in the sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative position of this instance and <paramref name="obj" /> in the sort order, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>A negative integer</para>
+              </term>
+              <description>
+                <para>This instance precedes <paramref name="obj" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>This instance and <paramref name="obj" /> have the same position in the sort order.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>A positive integer</para>
+              </term>
+              <description>
+                <para>This instance follows <paramref name="obj" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with the current instance.</param>
       </Docs>
@@ -519,7 +609,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The string returned by this method takes the form (Item1, Item2, Item3, Item4, <paramref name="Item5, Item6, Item7" />), where Item1, Item2, Item3, Item4, Item5, Item6, and Item7 represent the values of the <see cref="P:System.Tuple`7.Item1" />, <see cref="P:System.Tuple`7.Item2" />, <see cref="P:System.Tuple`7.Item3" />, <see cref="P:System.Tuple`7.Item4" />, <see cref="P:System.Tuple`7.Item5" />, <see cref="P:System.Tuple`7.Item6" />, and <see cref="P:System.Tuple`7.Item7" /> properties, respectively. If any of the property values is null, it is represented as <see cref="F:System.String.Empty" />.</para>
@@ -528,6 +617,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the value of this <see cref="T:System.Tuple`7" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of this <see cref="T:System.Tuple`7" /> object.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System/Tuple`8.xml b/mcs/class/corlib/Documentation/en/System/Tuple`8.xml
index 471b6f73d3c..6fa2e15fb66 100644
--- a/mcs/class/corlib/Documentation/en/System/Tuple`8.xml
+++ b/mcs/class/corlib/Documentation/en/System/Tuple`8.xml
@@ -122,7 +122,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="obj" /> parameter is considered to be equal to the current instance if it meets all the following conditions:</para>
@@ -142,6 +141,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current <see cref="T:System.Tuple`8" /> object is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current instance is equal to the specified object; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this instance.</param>
       </Docs>
@@ -158,12 +161,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the hash code for the current <see cref="T:System.Tuple`8" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Item1">
@@ -415,7 +421,6 @@
         <Parameter Name="comparer" Type="System.Collections.IComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface implementation. It can be used only when the <see cref="T:System.Tuple`8" /> instance is cast to an <see cref="T:System.Collections.IStructuralComparable" /> interface.</para>
@@ -429,6 +434,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current <see cref="T:System.Tuple`8" /> object to a specified object by using a specified comparer and returns an integer that indicates whether the current object is before, after, or in the same position as the specified object in the sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative position of this instance and <paramref name="other" /> in the sort order, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>A negative integer</para>
+              </term>
+              <description>
+                <para>This instance precedes <paramref name="other" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>This instance and <paramref name="other" /> have the same position in the sort order.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>A positive integer</para>
+              </term>
+              <description>
+                <para>This instance follows <paramref name="other" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with the current instance.</param>
         <param name="comparer">
@@ -450,7 +495,6 @@
         <Parameter Name="comparer" Type="System.Collections.IEqualityComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Tuple`8" /> instance is cast to an <see cref="T:System.Collections.IStructuralEquatable" /> interface.</para>
@@ -460,6 +504,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the current <see cref="T:System.Tuple`8" /> object is equal to a specified object based on a specified comparison method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current instance is equal to the specified object; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with this instance.</param>
         <param name="comparer">
@@ -480,7 +528,6 @@
         <Parameter Name="comparer" Type="System.Collections.IEqualityComparer" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Tuple`8" /> instance is cast to an <see cref="T:System.Collections.IStructuralEquatable" /> interface.</para>
@@ -491,6 +538,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Calculates the hash code for the current <see cref="T:System.Tuple`8" /> object by using a specified computation method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
         <param name="comparer">
           <attribution license="cc4" from="Microsoft" modified="false" />An object whose <see cref="M:System.Collections.IEqualityComparer.GetHashCode(System.Object)" />  method calculates the hash code of the current <see cref="T:System.Tuple`8" /> object.</param>
       </Docs>
@@ -509,7 +560,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.Tuple`8" /> instance is cast to an <see cref="T:System.IComparable" /> interface.</para>
@@ -523,6 +573,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current <see cref="T:System.Tuple`8" /> object to a specified object and returns an integer that indicates whether the current object is before, after, or in the same position as the specified object in the sort order.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative position of this instance and <paramref name="obj" /> in the sort order, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Value</para>
+                </term>
+                <description>
+                  <para>Description</para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>A negative integer</para>
+              </term>
+              <description>
+                <para>This instance precedes <paramref name="obj" />.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero</para>
+              </term>
+              <description>
+                <para>This instance and <paramref name="obj" /> have the same position in the sort order.</para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>A positive integer</para>
+              </term>
+              <description>
+                <para>This instance follows <paramref name="obj" />.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with the current instance.</param>
       </Docs>
@@ -556,7 +646,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The string returned by this method takes the form (Item1, Item2, Item3, Item4, <paramref name="Item5, Item6, Item7" />, Item8…), where Item1, Item2, Item3, Item4, Item5, Item6, and Item7 represent the values of the <see cref="P:System.Tuple`8.Item1" />, <see cref="P:System.Tuple`8.Item2" />, <see cref="P:System.Tuple`8.Item3" />, <see cref="P:System.Tuple`8.Item4" />, <see cref="P:System.Tuple`8.Item5" />, <see cref="P:System.Tuple`8.Item6" />, and <see cref="P:System.Tuple`8.Item7" /> properties. Item8 represents the value of the <see cref="T:System.Tuple`8" /> object's Next.Item1 property. The value of any additional nested components follow Item8. If any of the property values is null, it is represented as <see cref="F:System.String.Empty" />.</para>
@@ -565,6 +654,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a string that represents the value of this <see cref="T:System.Tuple`8" /> instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of this <see cref="T:System.Tuple`8" /> object.</para>
+        </returns>
       </Docs>
     </Member>
   </Members>
diff --git a/mcs/class/corlib/Documentation/en/System/Type.xml b/mcs/class/corlib/Documentation/en/System/Type.xml
index dd5b05c5525..e376ad49d96 100644
--- a/mcs/class/corlib/Documentation/en/System/Type.xml
+++ b/mcs/class/corlib/Documentation/en/System/Type.xml
@@ -740,7 +740,6 @@ public abstract class DeclaringTypeTest{
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method overrides <see cref="M:System.Object.Equals(System.Object)" />.</para>
@@ -749,6 +748,10 @@ public abstract class DeclaringTypeTest{
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the underlying system type of the current <see cref="T:System.Type" /> is the same as the underlying system type of the specified <see cref="T:System.Object" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the underlying system type of <paramref name="o" /> is the same as the underlying system type of the current <see cref="T:System.Type" />; otherwise, false. This method also returns false if the object specified by the <paramref name="o" /> parameter is not a Type.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object whose underlying system type is to be compared with the underlying system type of the current <see cref="T:System.Type" />. </param>
       </Docs>
@@ -770,16 +773,15 @@ public abstract class DeclaringTypeTest{
         <Parameter Name="o" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the underlying system type of <paramref name="o" /> is the same
-   as the underlying system type of the current <see cref="T:System.Type" />; otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines if the underlying system type of the current <see cref="T:System.Type" /> is the same as the underlying system type of the specified <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the underlying system type of <paramref name="o" /> is the same as the underlying system type of the current <see cref="T:System.Type" />; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object whose underlying system type is to be compared with the underlying system type of the current <see cref="T:System.Type" />. </param>
       </Docs>
@@ -875,7 +877,6 @@ public abstract class DeclaringTypeTest{
         <Parameter Name="filterCriteria" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be overridden by a derived class.</para>
@@ -892,6 +893,10 @@ public abstract class DeclaringTypeTest{
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of <see cref="T:System.Type" /> objects representing a filtered list of interfaces implemented or inherited by the current <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Type" /> objects representing a filtered list of the interfaces implemented or inherited by the current <see cref="T:System.Type" />, or an empty array of type <see cref="T:System.Type" /> if no interfaces matching the filter are implemented or inherited by the current <see cref="T:System.Type" />.</para>
+        </returns>
         <param name="filter">
           <attribution license="cc4" from="Microsoft" modified="false" />The delegate that compares the interfaces against <paramref name="filterCriteria" />. </param>
         <param name="filterCriteria">
@@ -917,7 +922,6 @@ public abstract class DeclaringTypeTest{
         <Parameter Name="filterCriteria" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be overridden by a derived class.</para>
@@ -955,6 +959,12 @@ public abstract class DeclaringTypeTest{
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a filtered array of <see cref="T:System.Reflection.MemberInfo" /> objects of the specified member type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A filtered array of <see cref="T:System.Reflection.MemberInfo" /> objects of the specified member type.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Reflection.MemberInfo" />, if the current <see cref="T:System.Type" /> does not have members of type <paramref name="memberType" /> that match the filter criteria.</para>
+        </returns>
         <param name="memberType">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that indicates the type of member to search for. </param>
         <param name="bindingAttr">
@@ -1220,16 +1230,16 @@ Base[System.Int32, V]
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the number of dimensions in the  current
-<see cref="T:System.Type" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentException">The current <see cref="T:System.Type" /> is  not an array.</exception>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the number of dimensions in an <see cref="T:System.Array" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Int32" /> containing the number of dimensions in the current Type.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1248,10 +1258,6 @@ Base[System.Int32, V]
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.TypeAttributes" /> value that signifies the attributes of the
-   type represented by the current instance.</para>
-        </returns>
         <remarks>
           <block subset="none" type="behaviors">
             <para>This property is read-only.</para>
@@ -1270,6 +1276,10 @@ Base[System.Int32, V]
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, implements the <see cref="P:System.Type.Attributes" /> property and gets a bitmask indicating the attributes associated with the <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.TypeAttributes" /> object representing the attribute set of the <see cref="T:System.Type" />.</para>
+        </returns>
       </Docs>
       <Excluded>1</Excluded>
       <ExcludedLibrary>Reflection</ExcludedLibrary>
@@ -1296,15 +1306,6 @@ Base[System.Int32, V]
         <Parameter Name="types" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.ConstructorInfo" /> object representing the public instance
-   constructor whose parameters match exactly the types in <paramref name="types" /> , if found;
-   otherwise, <see langword="null" />. If the type represented by the current
-   instance is contained in a loaded assembly, the constructor that matches the
-   specified criteria is not public, and the caller does not have sufficient
-   permissions, returns <see langword="null" />. </para>
-          <para>If the current instance represents a generic type, this method returns the  <see cref="T:System.Reflection.ConstructorInfo" /> with the type parameters replaced by the appropriate type arguments. If the current instance represents an unassigned type parameter of a generic type or method, this method always returns <see langword="null" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <para>
             <paramref name="types" /> is <see langword="null" />, or at least one of the elements in <paramref name="types" /> is <see langword="null" />.</para>
@@ -1327,6 +1328,10 @@ Base[System.Int32, V]
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for a public instance constructor whose parameters match the types in the specified array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the public instance constructor whose parameters match the types in the parameter type array, if found; otherwise, null.</para>
+        </returns>
         <param name="types">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of <see cref="T:System.Type" /> objects representing the number, order, and type of the parameters for the desired constructor.</param>
       </Docs>
@@ -1358,16 +1363,6 @@ Base[System.Int32, V]
         <Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.ConstructorInfo" /> object that reflects the constructor
-   that matches the specified criteria. If an exact match does not exist,
-<paramref name="binder" /> will attempt to coerce the parameter types specified in 
-<paramref name="types" /> to select a match. If <paramref name="binder" /> is unable to select a 
-   match, returns <see langword="null" /> . If the type represented by the current
-   instance is contained in a loaded assembly, the constructor that matches the
-   specified criteria is not public, and the caller does not have sufficient
-   permissions, returns <see langword="null" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <para>
             <paramref name="types" /> is <see langword="null" />, or at least one of the elements in <paramref name="types" /> is <see langword="null" />.</para>
@@ -1403,6 +1398,10 @@ Base[System.Int32, V]
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for a constructor whose parameters match the specified argument types and modifiers, using the specified binding constraints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.ConstructorInfo" /> object representing the constructor that matches the specified requirements, if found; otherwise, null.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitmask comprised of one or more <see cref="T:System.Reflection.BindingFlags" /> that specify how the search is conducted.</param>
         <param name="binder">
@@ -1440,7 +1439,6 @@ Base[System.Int32, V]
         <Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Although the default binder does not process <see cref="T:System.Reflection.ParameterModifier" /> (the <paramref name="modifiers" /> parameter), you can use the abstract <see cref="T:System.Reflection.Binder" /> class to write a custom binder that does process <paramref name="modifiers" />. ParameterModifier is only used when calling through COM interop, and only parameters that are passed by reference are handled.</para>
@@ -1561,6 +1559,10 @@ Base[System.Int32, V]
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for a constructor whose parameters match the specified argument types and modifiers, using the specified binding constraints and the specified calling convention.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the constructor that matches the specified requirements, if found; otherwise, null.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitmask comprised of one or more <see cref="T:System.Reflection.BindingFlags" /> that specify how the search is conducted.</param>
         <param name="binder">
@@ -1593,7 +1595,6 @@ Base[System.Int32, V]
         <Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Although the default binder does not process <see cref="T:System.Reflection.ParameterModifier" /> (the <paramref name="modifiers" /> parameter), you can use the abstract <see cref="T:System.Reflection.Binder" /> class to write a custom binder that does process <paramref name="modifiers" />. ParameterModifier is only used when calling through COM interop, and only parameters that are passed by reference are handled.</para>
@@ -1617,6 +1618,10 @@ Base[System.Int32, V]
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, searches for a constructor whose parameters match the specified argument types and modifiers, using the specified binding constraints and the specified calling convention.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Reflection.ConstructorInfo" /> object representing the constructor that matches the specified requirements, if found; otherwise, null.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitmask comprised of one or more <see cref="T:System.Reflection.BindingFlags" /> that specify how the search is conducted.</param>
         <param name="binder">
@@ -1649,14 +1654,6 @@ Base[System.Int32, V]
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>An array of <see cref="T:System.Reflection.ConstructorInfo" /> objects that reflect the public constructors
-   defined in the type represented by the current instance. If no public
-   constructors are defined in the type represented by the current instance, or if the current instance represents an unassigned type parameter of a generic type or method,
-   returns an empty array.</para>
-          <para>If the current instance represents a generic type, this method returns the <see cref="T:System.Reflection.ConstructorInfo" /> objects with the type parameters replaced by the appropriate type arguments.</para>
-          <para>If the current instance represents a generic type parameter, the <see cref="M:System.Type.GetConstructors" />method returns an empty array.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Type.GetConstructors" /> method does not return constructors in a particular order, such as declaration order. Your code must not depend on the order in which constructors are returned, because that order varies.</para>
@@ -1761,6 +1758,10 @@ Base[System.Int32, V]
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the public constructors defined for the current <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.ConstructorInfo" /> objects representing all the public instance constructors defined for the current <see cref="T:System.Type" />, but not including the type initializer (static constructor). If no public instance constructors are defined for the current <see cref="T:System.Type" />, or if the current <see cref="T:System.Type" /> represents a type parameter in the definition of a generic type or generic method, an empty array of type <see cref="T:System.Reflection.ConstructorInfo" /> is returned.</para>
+        </returns>
       </Docs>
       <Excluded>1</Excluded>
       <ExcludedLibrary>Reflection</ExcludedLibrary>
@@ -1787,19 +1788,6 @@ Base[System.Int32, V]
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>An array of <see cref="T:System.Reflection.ConstructorInfo" /> objects that reflect the constructors that
-   are defined in the type represented by the current instance and match the
-   constraints of <paramref name="bindingAttr" />. If <see cref="F:System.Reflection.BindingFlags.NonPublic" /> and <see cref="F:System.Reflection.BindingFlags.Static" /> are specified, this array
-   includes the type initializer if it is defined. If no constructors meeting the
-   constraints of <paramref name="bindingAttr" /> are defined in the type represented by the
-   current instance, or if the current instance represents an unassigned type parameter of a generic type or method, returns an empty array. If the type represented by the current
-   instance is contained in a loaded assembly, the constructors that match the
-   specified criteria are not public, and the caller does not have sufficient
-   permission, returns <see langword="null" /> .</para>
-          <para>If the current instance represents a generic type, this method returns the <see cref="T:System.Reflection.ConstructorInfo" /> objects with the type parameters replaced by the appropriate type arguments.</para>
-          <para>If the current instance represents a generic type parameter, the <see cref="M:System.Type.GetConstructors" />method returns an empty array.</para>
-        </returns>
         <permission cref="T:System.Security.Permissions.ReflectionPermission">Requires permission to retrieve information on non-public members of types in loaded assemblies. See <see cref="F:System.Security.Permissions.ReflectionPermissionFlag.TypeInformation" />.</permission>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -1828,6 +1816,10 @@ Base[System.Int32, V]
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, searches for the constructors defined for the current <see cref="T:System.Type" />, using the specified BindingFlags.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.ConstructorInfo" /> objects representing all constructors defined for the current <see cref="T:System.Type" /> that match the specified binding constraints, including the type initializer if it is defined. Returns an empty array of type <see cref="T:System.Reflection.ConstructorInfo" /> if no constructors are defined for the current <see cref="T:System.Type" />, if none of the defined constructors match the binding constraints, or if the current <see cref="T:System.Type" /> represents a type parameter in the definition of a generic type or generic method.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitmask comprised of one or more <see cref="T:System.Reflection.BindingFlags" /> that specify how the search is conducted.</param>
       </Docs>
@@ -1849,11 +1841,6 @@ Base[System.Int32, V]
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>An array of <see cref="T:System.Reflection.MemberInfo" /> objects reflecting the default members of the
-   type represented by the current instance. If the type represented by the current
-   instance does not have any default members, returns an empty array.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Type.GetDefaultMembers" /> method does not return members in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which members are returned, because that order varies.</para>
@@ -1959,6 +1946,12 @@ Base[System.Int32, V]
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the members defined for the current <see cref="T:System.Type" /> whose <see cref="T:System.Reflection.DefaultMemberAttribute" /> is set.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.MemberInfo" /> objects representing all default members of the current <see cref="T:System.Type" />.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Reflection.MemberInfo" />, if the current <see cref="T:System.Type" /> does not have default members.</para>
+        </returns>
       </Docs>
       <Excluded>1</Excluded>
       <ExcludedLibrary>Reflection</ExcludedLibrary>
@@ -1978,13 +1971,6 @@ Base[System.Int32, V]
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Type" /> that represents 
-   the type used to create the current instance if the current
-   instance represents an array, pointer, or an argument
-   passed by reference. Otherwise, returns <see langword="null" />
- if the current instance is not an array or a pointer, or is not passed by reference, or represents a generic type or a type parameter of a generic type or method.</para>
-        </returns>
         <example>
           <para>The following example demonstrates the <see cref="M:System.Type.GetElementType" />
 method.</para>
@@ -2017,6 +2003,10 @@ class TestType {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the <see cref="T:System.Type" /> of the object encompassed or referred to by the current array, pointer or reference type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.Type" /> of the object encompassed or referred to by the current array, pointer, or reference type, or null if the current <see cref="T:System.Type" /> is not an array or a pointer, or is not passed by reference, or represents a generic type or a type parameter in the definition of a generic type or generic method.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -2034,12 +2024,15 @@ class TestType {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the name of the constant that has the specified value, for the current enumeration type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The name of the member of the current enumeration type that has the specified value, or null if no such constant is found.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value whose name is to be retrieved.</param>
       </Docs>
@@ -2056,7 +2049,6 @@ class TestType {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The elements of the return value array are sorted by the binary values (that is, the unsigned values) of the enumerated constants. If the array contains enumerated constants with the same value, the order of their corresponding names is unspecified.</para>
@@ -2065,6 +2057,10 @@ class TestType {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the names of the members of the current enumeration type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains the names of the members of the enumeration.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetEnumUnderlyingType">
@@ -2079,7 +2075,6 @@ class TestType {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>By default, the underlying type of an enumeration in C# and Visual Basic is <see cref="T:System.Int32" />. Other integer types can be specified.</para>
@@ -2088,6 +2083,10 @@ class TestType {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the underlying type of the current enumeration type. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The underlying type of the current enumeration.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetEnumValues">
@@ -2102,12 +2101,15 @@ class TestType {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of the values of the constants in the current enumeration type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array that contains the values. The elements of the array are sorted by the binary values (that is, the unsigned values) of the enumeration constants.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetEvent">
@@ -2127,13 +2129,6 @@ class TestType {
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.EventInfo" /> object 
-   reflecting the public event that is named
-<paramref name="name" /> and is defined in the type represented by the current instance, if 
-   found; otherwise, <see langword="null" />.</para>
-          <para>If the current instance represents a generic type, this method returns the <see cref="T:System.Reflection.EventInfo" /> with the type parameters replaced by the appropriate type arguments.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="name" /> is <see langword="null" />.</exception>
         <remarks>
@@ -2240,6 +2235,10 @@ class TestType {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.Reflection.EventInfo" /> object representing the specified public event.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object representing the specified public event that is declared or inherited by the current <see cref="T:System.Type" />, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of an event that is declared or inherited by the current <see cref="T:System.Type" />. </param>
       </Docs>
@@ -2264,16 +2263,6 @@ class TestType {
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.EventInfo" /> object reflecting the event that is named
-<paramref name="name" />, is defined in the type represented by the current instance, and 
-   matches the constraints of <paramref name="bindingAttr" />. If an event
-   matching these criteria is not found, returns <see langword="null" />. If the event is not
-   public, the current instance represents
-   a type from a loaded assembly, and the caller does not have sufficient
-   permission, returns <see langword="null" />.</para>
-          <para>If the current instance represents a generic type, this method returns the <see cref="T:System.Reflection.EventInfo" /> with the type parameters replaced by the appropriate type arguments.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="name" /> is <see langword="null" />. </exception>
         <permission cref="T:System.Security.Permissions.ReflectionPermission">Requires permission to retrieve information on non-public members of types in loaded assemblies. See <see cref="F:System.Security.Permissions.ReflectionPermissionFlag.TypeInformation" />.</permission>
@@ -2312,6 +2301,10 @@ class TestType {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, returns the <see cref="T:System.Reflection.EventInfo" /> object representing the specified event, using the specified binding constraints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The object representing the specified event that is declared or inherited by the current <see cref="T:System.Type" />, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of an event which is declared or inherited by the current <see cref="T:System.Type" />. </param>
         <param name="bindingAttr">
@@ -2335,13 +2328,6 @@ class TestType {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>An array of <see cref="T:System.Reflection.EventInfo" /> objects that reflect the public events
-   defined in the type represented by the current instance. If no public events
-   are defined in the type represented by the current instance, returns an empty
-   array.</para>
-          <para>If the current instance represents a generic type, this method returns the <see cref="T:System.Reflection.EventInfo" /> objects with the type parameters replaced by the appropriate type arguments.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An event is considered public to reflection if it has at least one method or accessor that is public. Otherwise the event is considered private, and you must use <see cref="F:System.Reflection.BindingFlags.NonPublic" /> | <see cref="F:System.Reflection.BindingFlags.Instance" /> | <see cref="F:System.Reflection.BindingFlags.Static" /> (in Visual Basic, combine the values using Or) to get it.</para>
@@ -2447,6 +2433,12 @@ class TestType {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the public events that are declared or inherited by the current <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.EventInfo" /> objects representing all the public events which are declared or inherited by the current <see cref="T:System.Type" />.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Reflection.EventInfo" />, if the current <see cref="T:System.Type" /> does not have public events.</para>
+        </returns>
       </Docs>
       <Excluded>1</Excluded>
       <ExcludedLibrary>Reflection</ExcludedLibrary>
@@ -2468,16 +2460,6 @@ class TestType {
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>An array of <see cref="T:System.Reflection.EventInfo" /> objects that reflect the events that are
-   defined in the type represented by the current instance and match the
-   constraints of <paramref name="bindingAttr" /> . If no events match
-   these constraints, returns an empty array. If the type reflected by the current
-   instance is from a loaded assembly and the caller does not have permission to
-   reflect on non-public objects in loaded assemblies, returns only public
-   events.</para>
-          <para>If the current instance represents a generic type, this method returns the <see cref="T:System.Reflection.EventInfo" /> objects with the type parameters replaced by the appropriate type arguments.</para>
-        </returns>
         <permission cref="T:System.Security.Permissions.ReflectionPermission">Requires permission to retrieve information on non-public members of types in loaded assemblies. See <see cref="F:System.Security.Permissions.ReflectionPermissionFlag.TypeInformation" />.</permission>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2512,6 +2494,12 @@ class TestType {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, searches for events that are declared or inherited by the current <see cref="T:System.Type" />, using the specified binding constraints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.EventInfo" /> objects representing all events that are declared or inherited by the current <see cref="T:System.Type" /> that match the specified binding constraints.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Reflection.EventInfo" />, if the current <see cref="T:System.Type" /> does not have events, or if none of the events match the binding constraints.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitmask comprised of one or more <see cref="T:System.Reflection.BindingFlags" /> that specify how the search is conducted.</param>
       </Docs>
@@ -2535,16 +2523,6 @@ class TestType {
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.FieldInfo" /> object reflecting the field that is named
-<paramref name="name" /> and is defined in the type represented by the current instance, if 
-   found; otherwise, <see langword="null" />. If the selected field is non-public, the type represented by the
-   current instance is from a loaded assembly and the caller does not have
-   sufficient permission to reflect on non-public objects in loaded assemblies,
-   returns <see langword="null" />.</para>
-          <para>If the current instance represents a generic type, this method returns the <see cref="T:System.Reflection.FieldInfo" /> with the type parameters replaced by the appropriate type arguments.
-</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="name" /> is <see langword="null" />. </exception>
         <permission cref="T:System.Security.Permissions.ReflectionPermission">Requires permission to retrieve information on non-public members of types in loaded assemblies. See <see cref="F:System.Security.Permissions.ReflectionPermissionFlag.TypeInformation" />.</permission>
@@ -2558,6 +2536,10 @@ class TestType {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the public field with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the public field with the specified name, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the data field to get. </param>
       </Docs>
@@ -2582,16 +2564,6 @@ class TestType {
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.FieldInfo" /> object reflecting the field that is named
-<paramref name="name" />, is defined in the type represented by the current instance, and 
-   matches the constraints of <paramref name="bindingAttr" />. If a field matching these criteria
-   cannot be found, returns <see langword="null" />. If the field is not public, the current type is
-   from a loaded assembly, and the caller does not have sufficient permission,
-   returns <see langword="null" />.</para>
-          <para>If the current instance represents a generic type, this method returns the <see cref="T:System.Reflection.FieldInfo" /> with the type parameters replaced by the appropriate type arguments.
-</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="name" /> is <see langword="null" />. </exception>
         <permission cref="T:System.Security.Permissions.ReflectionPermission">Requires permission to retrieve information on non-public members of types in loaded assemblies. See <see cref="F:System.Security.Permissions.ReflectionPermissionFlag.TypeInformation" />.</permission>
@@ -2722,6 +2694,10 @@ class TestType {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified field, using the specified binding constraints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the field that matches the specified requirements, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the data field to get. </param>
         <param name="bindingAttr">
@@ -2745,13 +2721,6 @@ class TestType {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>An array of <see cref="T:System.Reflection.FieldInfo" /> objects that reflect the public fields
-   defined in the type represented by the current instance. If no public fields
-   are defined in the type represented by the current instance, returns an empty
-   array.</para>
-          <para>If the current instance represents a generic type, this method returns the <see cref="T:System.Reflection.FieldInfo" /> objects with the type parameters replaced by the appropriate type arguments.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Type.GetFields" /> method does not return fields in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which fields are returned, because that order varies.</para>
@@ -2855,6 +2824,12 @@ class TestType {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the public fields of the current <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.FieldInfo" /> objects representing all the public fields defined for the current <see cref="T:System.Type" />.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Reflection.FieldInfo" />, if no public fields are defined for the current <see cref="T:System.Type" />.</para>
+        </returns>
       </Docs>
       <Excluded>1</Excluded>
       <ExcludedLibrary>Reflection</ExcludedLibrary>
@@ -2876,16 +2851,6 @@ class TestType {
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>An array of <see cref="T:System.Reflection.FieldInfo" /> objects that reflect the fields that are
-   defined in the type represented by the current instance and match the
-   constraints of <paramref name="bindingAttr" /> . If no fields match
-   these constraints, returns an empty array. If the type represented by the
-   current instance is from a loaded assembly and the caller does not have
-   sufficient permission to reflect on non-public objects in loaded assemblies,
-   returns only public fields.</para>
-          <para>If the current instance represents a generic type, this method returns the <see cref="T:System.Reflection.FieldInfo" /> objects with the type parameters replaced by the appropriate type arguments.</para>
-        </returns>
         <permission cref="T:System.Security.Permissions.ReflectionPermission">Requires permission to retrieve information on non-public members of a type in loaded assemblies. See <see cref="F:System.Security.Permissions.ReflectionPermissionFlag.TypeInformation" />.</permission>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -2919,6 +2884,12 @@ class TestType {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, searches for the fields defined for the current <see cref="T:System.Type" />, using the specified binding constraints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.FieldInfo" /> objects representing all fields defined for the current <see cref="T:System.Type" /> that match the specified binding constraints.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Reflection.FieldInfo" />, if no fields are defined for the current <see cref="T:System.Type" />, or if none of the defined fields match the binding constraints.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitmask comprised of one or more <see cref="T:System.Reflection.BindingFlags" /> that specify how the search is conducted.</param>
       </Docs>
@@ -2938,9 +2909,6 @@ class TestType {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>An array of <see cref="T:System.Type" /> objects that represent the type arguments of a generic type or the type parameters of a generic type definition. Returns an empty array if the current type is not a generic type. The array elements are returned in the order in which they appear in the list of type arguments for the generic type.</para>
-        </returns>
         <since version=".NET 2.0" />
         <example>
           <para>For an example of using this method, see the example for <see cref="P:System.Type.GenericParameterPosition" />.</para>
@@ -2965,6 +2933,10 @@ class TestType {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of <see cref="T:System.Type" /> objects that represent the type arguments of a generic type or the type parameters of a generic type definition.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Type" /> objects that represent the type arguments of a generic type. Returns an empty array if the current type is not a generic type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetGenericParameterConstraints">
@@ -2980,9 +2952,6 @@ class TestType {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>An array of <see cref="T:System.Type" /> objects that represent the type constraints on the current generic type parameter.</para>
-        </returns>
         <since version=".NET 2.0" />
         <exception cref="T:System.InvalidOperationException">The current <see cref="T:System.Type" /> object is not a generic type parameter. That is, the <see cref="P:System.Type.IsGenericParameter" /> property returns <see langword="false" />.</exception>
         <remarks>
@@ -2994,6 +2963,10 @@ class TestType {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an array of <see cref="T:System.Type" /> objects that represent the constraints on the current generic type parameter. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Type" /> objects that represent the constraints on the current generic type parameter.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetGenericTypeDefinition">
@@ -3009,9 +2982,6 @@ class TestType {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Type" /> object representing a generic type from which the current type can be constructed.</para>
-        </returns>
         <since version=".NET 2.0" />
         <exception cref="T:System.InvalidOperationException">The current type is not a generic type.  That is, <see cref="P:System.Type.HasGenericArguments" /> returns <see langword="false" />. </exception>
         <example>
@@ -3031,6 +3001,10 @@ class TestType {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Type" /> object that represents a generic type definition from which the current generic type can be constructed.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object representing a generic type from which the current type can be constructed.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -3048,10 +3022,6 @@ class TestType {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" />
-containing the hash code for this instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method overrides <see cref="M:System.Object.GetHashCode" />.</para>
@@ -3060,6 +3030,10 @@ containing the hash code for this instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code for this instance.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -3080,12 +3054,6 @@ containing the hash code for this instance.</para>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> A <see cref="T:System.Type" /> object
-   representing the interface with the specified name, implemented or inherited by
-   the current <see cref="T:System.Type" />, if found; otherwise, <see langword="null" />.
-   </para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="name" /> is <see langword="null" />. </exception>
         <exception cref="T:System.Reflection.AmbiguousMatchException">The current instance represents a type that implements the same generic interface with different type arguments.</exception>
@@ -3102,6 +3070,10 @@ containing the hash code for this instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the interface with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the interface with the specified name, implemented or inherited by the current <see cref="T:System.Type" />, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the interface to get. For generic interfaces, this is the mangled name.</param>
       </Docs>
@@ -3126,11 +3098,6 @@ containing the hash code for this instance.</para>
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Type" /> object representing
-   the interface with the specified name, implemented or inherited by the type
-   represented by the instance, if found; otherwise, <see langword="null" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="name" /> is <see langword="null" />. </exception>
         <exception cref="T:System.Reflection.AmbiguousMatchException">The current instance represents a type that implements the same generic interface with different type arguments.</exception>
@@ -3147,6 +3114,10 @@ containing the hash code for this instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, searches for the specified interface, specifying whether to do a case-insensitive search for the interface name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the interface with the specified name, implemented or inherited by the current <see cref="T:System.Type" />, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the interface to get. For generic interfaces, this is the mangled name.</param>
         <param name="ignoreCase">
@@ -3176,7 +3147,6 @@ containing the hash code for this instance.</para>
         <Parameter Name="interfaceType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The interface map denotes how an interface is mapped into the actual methods on a class that implements that interface.</para>
@@ -3186,6 +3156,10 @@ containing the hash code for this instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns an interface mapping for the specified interface type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the interface mapping for <paramref name="interfaceType" />.</para>
+        </returns>
         <param name="interfaceType">
           <attribution license="cc4" from="Microsoft" modified="false" />The interface type to retrieve a mapping for. </param>
       </Docs>
@@ -3205,11 +3179,6 @@ containing the hash code for this instance.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>An array of <see cref="T:System.Type" /> objects representing the interfaces implemented or
-   inherited by the type represented by the current instance. If no interfaces are
-   found, returns an empty <see cref="T:System.Type" /> array.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Type.GetInterfaces" /> method does not return interfaces in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which interfaces are returned, because that order varies.</para>
@@ -3220,6 +3189,12 @@ containing the hash code for this instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, gets all the interfaces implemented or inherited by the current <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Type" /> objects representing all the interfaces implemented or inherited by the current <see cref="T:System.Type" />.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Type" />, if no interfaces are implemented or inherited by the current <see cref="T:System.Type" />.</para>
+        </returns>
       </Docs>
       <Excluded>1</Excluded>
       <ExcludedLibrary>Reflection</ExcludedLibrary>
@@ -3241,12 +3216,6 @@ containing the hash code for this instance.</para>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>An array of <see cref="T:System.Reflection.MemberInfo" /> objects that reflect the public members that
-   are named <paramref name="name" /> and are defined in the type represented by the current instance. If no public
-   members with the specified name are defined in the type represented by the
-   current instance, returns an empty array.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="name" /> is <see langword="null" />. </exception>
         <remarks>
@@ -3358,6 +3327,10 @@ containing the hash code for this instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the public members with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.MemberInfo" /> objects representing the public members with the specified name, if found; otherwise, an empty array.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the public members to get. </param>
       </Docs>
@@ -3382,15 +3355,6 @@ containing the hash code for this instance.</para>
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>An array of <see cref="T:System.Reflection.MemberInfo" /> objects that reflect the members
-   named <paramref name="name" />, are defined in the type represented by the current instance
-   and match the constraints of <paramref name="bindingAttr" /> .
-   If no members match these constraints, returns an empty array.
-   If the selected member is non-public, the type reflected by the current instance is from a
-   loaded assembly and the caller does not have sufficient permission to reflect on
-   non-public objects in loaded assemblies, returns <see langword="null" /> .</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="name" /> is <see langword="null" />. </exception>
         <permission cref="T:System.Security.Permissions.ReflectionPermission">Requires permission to retrieve information on non-public members of types in loaded assemblies. See <see cref="F:System.Security.Permissions.ReflectionPermissionFlag.TypeInformation" />.</permission>
@@ -3435,6 +3399,10 @@ containing the hash code for this instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified members, using the specified binding constraints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.MemberInfo" /> objects representing the public members with the specified name, if found; otherwise, an empty array.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the members to get. </param>
         <param name="bindingAttr">
@@ -3461,7 +3429,6 @@ containing the hash code for this instance.</para>
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Members include properties, methods, fields, events, and so on. </para>
@@ -3502,6 +3469,10 @@ containing the hash code for this instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified members of the specified member type, using the specified binding constraints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.MemberInfo" /> objects representing the public members with the specified name, if found; otherwise, an empty array.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the members to get. </param>
         <param name="type">
@@ -3525,12 +3496,6 @@ containing the hash code for this instance.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>An array of <see cref="T:System.Reflection.MemberInfo" /> objects that reflect the public members
-   defined in the type represented by the current instance. If no public members
-   are defined in the type represented by the current instance, returns an empty
-   array.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Members include properties, methods, fields, events, and so on.</para>
@@ -3636,6 +3601,12 @@ containing the hash code for this instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the public members of the current <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.MemberInfo" /> objects representing all the public members of the current <see cref="T:System.Type" />.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Reflection.MemberInfo" />, if the current <see cref="T:System.Type" /> does not have public members.</para>
+        </returns>
       </Docs>
       <Excluded>1</Excluded>
       <ExcludedLibrary>Reflection</ExcludedLibrary>
@@ -3657,14 +3628,6 @@ containing the hash code for this instance.</para>
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>An array of <see cref="T:System.Reflection.MemberInfo" /> objects that reflect the members
-   defined in the type represented by the current instance that match the
-   constraints of <paramref name="bindingAttr" /> . If no members match these constraints,
-   returns an empty array. If the type represented by the current instance is from
-   a loaded assembly and the caller does not have sufficient permission to reflect
-   on non-public objects in loaded assemblies, returns only public members.</para>
-        </returns>
         <permission cref="T:System.Security.Permissions.ReflectionPermission">Requires permission to retrieve information on non-public members of types in loaded assemblies. See <see cref="F:System.Security.Permissions.ReflectionPermissionFlag.TypeInformation" />.</permission>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -3701,6 +3664,12 @@ containing the hash code for this instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, searches for the members defined for the current <see cref="T:System.Type" />, using the specified binding constraints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.MemberInfo" /> objects representing all members defined for the current <see cref="T:System.Type" /> that match the specified binding constraints.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Reflection.MemberInfo" />, if no members are defined for the current <see cref="T:System.Type" />, or if none of the defined members match the binding constraints.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitmask comprised of one or more <see cref="T:System.Reflection.BindingFlags" /> that specify how the search is conducted.</param>
       </Docs>
@@ -3724,11 +3693,6 @@ containing the hash code for this instance.</para>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.MethodInfo" /> object reflecting the public method that is
-   defined in the type represented by the current instance and has the specified
-   name, if found; otherwise, <see langword="null" />.</para>
-        </returns>
         <exception cref="T:System.Reflection.AmbiguousMatchException">More than one method matching the specified criteria was found.</exception>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="name" /> is <see langword="null" />. </exception>
@@ -3748,6 +3712,10 @@ containing the hash code for this instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the public method with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that represents the public method with the specified name, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the public method to get. </param>
       </Docs>
@@ -3772,12 +3740,6 @@ containing the hash code for this instance.</para>
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.MethodInfo" /> object
-   that reflects the method that is defined
-   in the type represented by the current instance and matches the specified
-   criteria, if found; otherwise, <see langword="null" />.</para>
-        </returns>
         <exception cref="T:System.Reflection.AmbiguousMatchException">More than one method matching the specified criteria was found.</exception>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="name" /> is <see langword="null" />.</exception>
@@ -3822,6 +3784,10 @@ containing the hash code for this instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified method, using the specified binding constraints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the method that matches the specified requirements, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the method to get. </param>
         <param name="bindingAttr">
@@ -3848,12 +3814,6 @@ containing the hash code for this instance.</para>
         <Parameter Name="types" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.MethodInfo" /> object reflecting
-   the public method defined in the type represented by the current instance
-   that matches the specified criteria. If no public method matching the specified criteria
-   is found, returns <see langword="null" /> . </para>
-        </returns>
         <exception cref="T:System.Reflection.AmbiguousMatchException">More than one method matching the specified criteria was found.</exception>
         <exception cref="T:System.ArgumentNullException">
           <para>
@@ -3881,6 +3841,10 @@ containing the hash code for this instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified public method whose parameters match the specified argument types.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the public method whose parameters match the specified argument types, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the public method to get. </param>
         <param name="types">
@@ -3908,11 +3872,6 @@ containing the hash code for this instance.</para>
         <Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.MethodInfo" /> object reflecting the public method that is
-   defined in the type represented by the current instance and matches the
-   specified criteria, if found; otherwise, <see langword="null" />.</para>
-        </returns>
         <exception cref="T:System.Reflection.AmbiguousMatchException">More than one method matching the specified criteria was found.</exception>
         <exception cref="T:System.ArgumentNullException">
           <para>
@@ -3941,6 +3900,10 @@ containing the hash code for this instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified public method whose parameters match the specified argument types and modifiers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the public method that matches the specified requirements, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the public method to get. </param>
         <param name="types">
@@ -3972,16 +3935,6 @@ containing the hash code for this instance.</para>
         <Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.MethodInfo" /> object that reflects
-   the method defined in the type represented by the current instance that
-   matches the specified criteria. If no method matching the specified criteria is found, returns
-<see langword="null" /> . If the 
-   selected method is non-public, the type reflected by
-   the current instance is from a loaded assembly, and the caller
-   does not have permission to reflect on non-public objects in loaded assemblies,
-   returns <see langword="null" />.</para>
-        </returns>
         <exception cref="T:System.Reflection.AmbiguousMatchException">More than one method matching the specified criteria was found.</exception>
         <exception cref="T:System.ArgumentNullException">
           <para>
@@ -4035,6 +3988,10 @@ containing the hash code for this instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified method whose parameters match the specified argument types and modifiers, using the specified binding constraints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the method that matches the specified requirements, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the method to get. </param>
         <param name="bindingAttr">
@@ -4070,7 +4027,6 @@ containing the hash code for this instance.</para>
         <Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Although the default binder does not process <see cref="T:System.Reflection.ParameterModifier" /> (the <paramref name="modifiers" /> parameter), you can use the abstract <see cref="T:System.Reflection.Binder" /> class to write a custom binder that does process <paramref name="modifiers" />. ParameterModifier is only used when calling through COM interop, and only parameters that are passed by reference are handled.</para>
@@ -4205,6 +4161,10 @@ containing the hash code for this instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified method whose parameters match the specified argument types and modifiers, using the specified binding constraints and the specified calling convention.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the method that matches the specified requirements, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the method to get. </param>
         <param name="bindingAttr">
@@ -4240,7 +4200,6 @@ containing the hash code for this instance.</para>
         <Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Although the default binder does not process <see cref="T:System.Reflection.ParameterModifier" /> (the <paramref name="modifiers" /> parameter), you can use the abstract <see cref="T:System.Reflection.Binder" /> class to write a custom binder that does process <paramref name="modifiers" />. ParameterModifier is only used when calling through COM interop, and only parameters that are passed by reference are handled.</para>
@@ -4275,6 +4234,10 @@ containing the hash code for this instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, searches for the specified method whose parameters match the specified argument types and modifiers, using the specified binding constraints and the specified calling convention.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the method that matches the specified requirements, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the method to get. </param>
         <param name="bindingAttr">
@@ -4304,9 +4267,6 @@ containing the hash code for this instance.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>An array of <see cref="T:System.Reflection.MethodInfo" /> objects reflecting the public methods defined in the type represented by the current instance. If no methods are found, returns an empty array.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Type.GetMethods" /> method does not return methods in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which methods are returned, because that order varies.</para>
@@ -4414,6 +4374,12 @@ containing the hash code for this instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the public methods of the current <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.MethodInfo" /> objects representing all the public methods defined for the current <see cref="T:System.Type" />.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Reflection.MethodInfo" />, if no public methods are defined for the current <see cref="T:System.Type" />.</para>
+        </returns>
       </Docs>
       <Excluded>1</Excluded>
       <ExcludedLibrary>Reflection</ExcludedLibrary>
@@ -4435,14 +4401,6 @@ containing the hash code for this instance.</para>
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>An array of <see cref="T:System.Reflection.MethodInfo" /> objects reflecting the methods defined in the type
-   represented by the current instance that match the constraints of
-<paramref name="bindingAttr" /> . If no such methods found, returns an 
-   empty array. If the type represented by the current instance is from a loaded
-   assembly and the caller does not have permission to reflect on non-public
-   objects in loaded assemblies, returns only public methods.</para>
-        </returns>
         <permission cref="T:System.Security.Permissions.ReflectionPermission">Requires permission to retrieve information on non-public members of types in loaded assemblies. See <see cref="F:System.Security.Permissions.ReflectionPermissionFlag.TypeInformation" />.</permission>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4479,6 +4437,12 @@ containing the hash code for this instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, searches for the methods defined for the current <see cref="T:System.Type" />, using the specified binding constraints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.MethodInfo" /> objects representing all methods defined for the current <see cref="T:System.Type" /> that match the specified binding constraints.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Reflection.MethodInfo" />, if no methods are defined for the current <see cref="T:System.Type" />, or if none of the defined methods match the binding constraints.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitmask comprised of one or more <see cref="T:System.Reflection.BindingFlags" /> that specify how the search is conducted.</param>
       </Docs>
@@ -4502,11 +4466,6 @@ containing the hash code for this instance.</para>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Type" /> object
-   representing the public nested type with the specified
-   name, if found; otherwise, <see langword="null" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="name" /> is <see langword="null" />. </exception>
         <remarks>
@@ -4617,6 +4576,10 @@ containing the hash code for this instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the public nested type with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the public nested type with the specified name, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the nested type to get. </param>
       </Docs>
@@ -4641,14 +4604,6 @@ containing the hash code for this instance.</para>
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Type" /> object representing the nested type that
-   matches the specified criteria, if found; otherwise, <see langword="null" />. If the selected nested
-   type is non-public, the current instance represents a type contained in a loaded
-   assembly and the caller does not have sufficient permissions, returns
-<see langword="null" /> 
-.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="name" /> is <see langword="null" />. </exception>
         <permission cref="T:System.Security.Permissions.ReflectionPermission">Requires permission to retrieve information on non-public members of types in loaded assemblies. See <see cref="F:System.Security.Permissions.ReflectionPermissionFlag.TypeInformation" />.</permission>
@@ -4682,6 +4637,10 @@ containing the hash code for this instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, searches for the specified nested type, using the specified binding constraints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the nested type that matches the specified requirements, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the nested type to get. </param>
         <param name="bindingAttr">
@@ -4705,10 +4664,6 @@ containing the hash code for this instance.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>An array of <see cref="T:System.Type" /> objects representing all public types nested within the type
-   represented by the current instance, if any. Otherwise, returns an empty <see cref="T:System.Type" /> array.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.Type.GetNestedTypes" /> method does not return types in a particular order, such as alphabetical or declaration order. Your code must not depend on the order in which types are returned, because that order varies.</para>
@@ -4817,6 +4772,10 @@ containing the hash code for this instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the public types nested in the current <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Type" /> objects representing the public types nested in the current <see cref="T:System.Type" /> (the search is not recursive), or an empty array of type <see cref="T:System.Type" /> if no public types are nested in the current <see cref="T:System.Type" />.</para>
+        </returns>
       </Docs>
       <Excluded>1</Excluded>
       <ExcludedLibrary>Reflection</ExcludedLibrary>
@@ -4838,14 +4797,6 @@ containing the hash code for this instance.</para>
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>An array of <see cref="T:System.Type" /> objects representing all types nested within the type
-   represented by the current instance that match the specified binding constraints,
-   if any. Otherwise, returns an empty <see cref="T:System.Type" /> array. If the type reflected by the current instance is
-   contained in a loaded assembly, the type that matches the specified criteria is
-   not public, and the caller does not have sufficient permission, returns only
-   public types.</para>
-        </returns>
         <permission cref="T:System.Security.Permissions.ReflectionPermission">Requires permission to retrieve information on non-public members of types in loaded assemblies. See <see cref="F:System.Security.Permissions.ReflectionPermissionFlag.TypeInformation" />.</permission>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -4878,6 +4829,10 @@ containing the hash code for this instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, searches for the types nested in the current <see cref="T:System.Type" />, using the specified binding constraints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Type" /> objects representing all the types nested in the current <see cref="T:System.Type" /> that match the specified binding constraints (the search is not recursive), or an empty array of type <see cref="T:System.Type" />, if no nested types are found that match the binding constraints.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitmask comprised of one or more <see cref="T:System.Reflection.BindingFlags" /> that specify how the search is conducted.</param>
       </Docs>
@@ -4899,12 +4854,6 @@ containing the hash code for this instance.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>An array of <see cref="T:System.Reflection.PropertyInfo" /> 
-objects that reflect the public properties defined in the type
-represented by the current instance. If no public properties are found, returns
-an empty array.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A property is considered public to reflection if it has at least one accessor that is public. Otherwise the property is considered private, and you must use <see cref="F:System.Reflection.BindingFlags.NonPublic" /> | <see cref="F:System.Reflection.BindingFlags.Instance" /> | <see cref="F:System.Reflection.BindingFlags.Static" /> (in Visual Basic, combine the values using Or) to get it.</para>
@@ -5009,6 +4958,12 @@ an empty array.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns all the public properties of the current <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.PropertyInfo" /> objects representing all public properties of the current <see cref="T:System.Type" />.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Reflection.PropertyInfo" />, if the current <see cref="T:System.Type" /> does not have public properties.</para>
+        </returns>
       </Docs>
       <Excluded>1</Excluded>
       <ExcludedLibrary>Reflection</ExcludedLibrary>
@@ -5030,14 +4985,6 @@ an empty array.</para>
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>An array of <see cref="T:System.Reflection.PropertyInfo" /> objects that reflect the properties
-   defined in the type represented by the current instance and match the
-   constraints of <paramref name="bindingAttr" /> . If no matching properties are found,
-   returns an empty array. If the type represented by the current instance is from
-   a loaded assembly and the caller does not have permission to reflect on
-   non-public objects in loaded assemblies, returns only public properties.</para>
-        </returns>
         <permission cref="T:System.Security.Permissions.ReflectionPermission">Requires permission to retrieve information on non-public members of types in loaded assemblies. See <see cref="F:System.Security.Permissions.ReflectionPermissionFlag.TypeInformation" />.</permission>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -5073,6 +5020,12 @@ an empty array.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, searches for the properties of the current <see cref="T:System.Type" />, using the specified binding constraints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Reflection.PropertyInfo" /> objects representing all properties of the current <see cref="T:System.Type" /> that match the specified binding constraints.</para>
+          <para>-or- </para>
+          <para>An empty array of type <see cref="T:System.Reflection.PropertyInfo" />, if the current <see cref="T:System.Type" /> does not have properties, or if none of the properties match the binding constraints.</para>
+        </returns>
         <param name="bindingAttr">
           <attribution license="cc4" from="Microsoft" modified="false" />A bitmask comprised of one or more <see cref="T:System.Reflection.BindingFlags" /> that specify how the search is conducted.</param>
       </Docs>
@@ -5096,11 +5049,6 @@ an empty array.</para>
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.PropertyInfo" /> object reflecting the public property defined 
-   on the type represented by the current instance that has the specified name. If
-   no matching property is found, returns <see langword="null" /> . </para>
-        </returns>
         <exception cref="T:System.Reflection.AmbiguousMatchException">More than one property matching the specified criteria was found.</exception>
         <exception cref="T:System.ArgumentNullException">
           <para>
@@ -5132,6 +5080,10 @@ an empty array.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the public property with the specified name.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the public property with the specified name, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the public property to get. </param>
       </Docs>
@@ -5156,15 +5108,6 @@ an empty array.</para>
         <Parameter Name="bindingAttr" Type="System.Reflection.BindingFlags" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.PropertyInfo" />
-object reflecting the property defined in the type represented by
-the current instance that matches the specified criteria. If no matching property is
-found, returns <see langword="null" /> . If the type reflected by the current
-instance is contained in a loaded assembly, the property that matches the
-specified criteria is not public, and the caller does not have sufficient
-permission, returns <see langword="null" />.</para>
-        </returns>
         <exception cref="T:System.Reflection.AmbiguousMatchException">More than one property matching the specified criteria was found.</exception>
         <exception cref="T:System.ArgumentNullException">
           <para>
@@ -5221,6 +5164,10 @@ permission, returns <see langword="null" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified property, using the specified binding constraints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the property that matches the specified requirements, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the property to get. </param>
         <param name="bindingAttr">
@@ -5247,11 +5194,6 @@ permission, returns <see langword="null" />.</para>
         <Parameter Name="returnType" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.PropertyInfo" /> object reflecting the public property defined 
-   on the type represented by the current instance that matches the specified
-   criteria. If no matching property is found, returns <see langword="null" /> .</para>
-        </returns>
         <exception cref="T:System.Reflection.AmbiguousMatchException">More than one property matching the specified criteria was found.</exception>
         <exception cref="T:System.ArgumentNullException">
           <para>
@@ -5276,6 +5218,10 @@ permission, returns <see langword="null" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the public property with the specified name and return type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the public property with the specified name, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the public property to get. </param>
         <param name="returnType">
@@ -5302,11 +5248,6 @@ permission, returns <see langword="null" />.</para>
         <Parameter Name="types" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.PropertyInfo" /> object reflecting the public property defined
-   on the type represented by the current instance that matches the specified
-   criteria. If no matching property is found, returns <see langword="null" /> .</para>
-        </returns>
         <exception cref="T:System.Reflection.AmbiguousMatchException">More than one property matching the specified criteria was found.</exception>
         <exception cref="T:System.ArgumentNullException">
           <para>
@@ -5333,6 +5274,10 @@ permission, returns <see langword="null" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified public property whose parameters match the specified argument types.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the public property whose parameters match the specified argument types, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the public property to get. </param>
         <param name="types">
@@ -5360,12 +5305,6 @@ permission, returns <see langword="null" />.</para>
         <Parameter Name="types" Type="System.Type[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.PropertyInfo" /> object
-   reflecting the public property defined in the type represented by
-   the current instance that matches the specified criteria. If no matching property is
-   found, returns <see langword="null" /> . </para>
-        </returns>
         <exception cref="T:System.Reflection.AmbiguousMatchException">More than one property matching the specified criteria was found.</exception>
         <exception cref="T:System.ArgumentNullException">
           <para>
@@ -5392,6 +5331,10 @@ permission, returns <see langword="null" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified public property whose parameters match the specified argument types.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the public property whose parameters match the specified argument types, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the public property to get. </param>
         <param name="returnType">
@@ -5421,7 +5364,6 @@ permission, returns <see langword="null" />.</para>
         <Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>A property is considered public to reflection if it has at least one accessor that is public. Otherwise the property is considered private, and you must use <see cref="F:System.Reflection.BindingFlags.NonPublic" /> | <see cref="F:System.Reflection.BindingFlags.Instance" /> | <see cref="F:System.Reflection.BindingFlags.Static" /> (in Visual Basic, combine the values using Or) to get it.</para>
@@ -5440,6 +5382,10 @@ permission, returns <see langword="null" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified public property whose parameters match the specified argument types and modifiers.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the public property that matches the specified requirements, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the public property to get. </param>
         <param name="returnType">
@@ -5472,15 +5418,6 @@ permission, returns <see langword="null" />.</para>
         <Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.PropertyInfo" /> object
-   reflecting the property that is defined in the type represented by the
-   current instance and matches the specified criteria. If no matching property is
-   found, returns <see langword="null" /> . If the type reflected by the current
-   instance is contained in a loaded assembly, the property that matches the
-   specified criteria is not public, and the caller does not have sufficient
-   permission, returns <see langword="null" />.</para>
-        </returns>
         <exception cref="T:System.Reflection.AmbiguousMatchException">More than one property matching the specified criteria was found.</exception>
         <exception cref="T:System.ArgumentNullException">
           <para>
@@ -5628,6 +5565,10 @@ permission, returns <see langword="null" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Searches for the specified property whose parameters match the specified argument types and modifiers, using the specified binding constraints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the property that matches the specified requirements, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the property to get. </param>
         <param name="bindingAttr">
@@ -5666,13 +5607,6 @@ permission, returns <see langword="null" />.</para>
         <Parameter Name="modifiers" Type="System.Reflection.ParameterModifier[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Reflection.PropertyInfo" /> object representing the property that matches the
-   specified search criteria, if found; otherwise, <see langword="null" />. If the type reflected by the current
-   instance is from a loaded assembly, the matching property is not
-   public, and the caller does not have permission to reflect on non-public
-   objects in loaded assemblies, returns <see langword="null" />.</para>
-        </returns>
         <exception cref="T:System.Reflection.AmbiguousMatchException">More than one property matching the specified criteria was found.</exception>
         <exception cref="T:System.ArgumentNullException">
           <para>
@@ -5718,6 +5652,10 @@ permission, returns <see langword="null" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, searches for the specified property whose parameters match the specified argument types and modifiers, using the specified binding constraints.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the property that matches the specified requirements, if found; otherwise, null.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the property to get. </param>
         <param name="bindingAttr">
@@ -5748,12 +5686,15 @@ permission, returns <see langword="null" />.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the current <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current <see cref="T:System.Type" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetType">
@@ -5773,12 +5714,6 @@ permission, returns <see langword="null" />.</para>
         <Parameter Name="typeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Type" /> with the specified name, if found; otherwise, <see langword="null" />. If the
-   requested type is non-public and the caller does not have permission to reflect
-   non-public objects outside the current assembly, this method returns
-<see langword="null" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="typeName" /> is <see langword="null" />. </exception>
         <exception cref="T:System.Reflection.TargetInvocationException">A type initializer was invoked and threw an exception.</exception>
@@ -6107,6 +6042,10 @@ permission, returns <see langword="null" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Type" /> with the specified name, performing a case-sensitive search.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type with the specified name, if found; otherwise, null.</para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly-qualified name of the type to get. See <see cref="P:System.Type.AssemblyQualifiedName" />. If the type is in the currently executing assembly or in Mscorlib.dll, it is sufficient to supply the type name qualified by its namespace.</param>
       </Docs>
@@ -6131,11 +6070,6 @@ permission, returns <see langword="null" />.</para>
         <Parameter Name="throwOnError" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Type" /> with the specified name, if found; otherwise, <see langword="null" /> . If the
-   requested type is non-public and the caller does not have permission to reflect non-public objects
-   outside the current assembly, this method returns <see langword="null" /> .</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="typeName" /> is <see langword="null" />. </exception>
         <exception cref="T:System.Reflection.TargetInvocationException">A type initializer was invoked and threw an exception.</exception>
@@ -6467,6 +6401,10 @@ permission, returns <see langword="null" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Type" /> with the specified name, performing a case-sensitive search and specifying whether to throw an exception if the type is not found.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type with the specified name. If the type is not found, the <paramref name="throwOnError" /> parameter specifies whether null is returned or an exception is thrown. In some cases, an exception is thrown regardless of the value of <paramref name="throwOnError" />. See the Exceptions section. </para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly-qualified name of the type to get. See <see cref="P:System.Type.AssemblyQualifiedName" />. If the type is in the currently executing assembly or in Mscorlib.dll, it is sufficient to supply the type name qualified by its namespace.</param>
         <param name="throwOnError">
@@ -6494,11 +6432,6 @@ permission, returns <see langword="null" />.</para>
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Type" /> with the specified name, if found; otherwise, <see langword="null" />. If the
-   requested type is non-public and the caller does not have permission to reflect non-public objects
-   outside the current assembly, this method returns <see langword="null" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="typeName" /> is <see langword="null" />.</exception>
         <exception cref="T:System.Reflection.TargetInvocationException">A type initializer was invoked and threw an exception.</exception>
@@ -6830,6 +6763,10 @@ permission, returns <see langword="null" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Type" /> with the specified name, specifying whether to perform a case-sensitive search and whether to throw an exception if the type is not found.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type with the specified name. If the type is not found, the <paramref name="throwOnError" /> parameter specifies whether null is returned or an exception is thrown. In some cases, an exception is thrown regardless of the value of <paramref name="throwOnError" />. See the Exceptions section. </para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly-qualified name of the type to get. See <see cref="P:System.Type.AssemblyQualifiedName" />. If the type is in the currently executing assembly or in Mscorlib.dll, it is sufficient to supply the type name qualified by its namespace.</param>
         <param name="throwOnError">
@@ -6856,7 +6793,6 @@ permission, returns <see langword="null" />.</para>
         <Parameter Name="typeResolver" Type="System.Func&lt;System.Reflection.Assembly,System.String,System.Boolean,System.Type&gt;" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Usage scenarios for this method and details about the <paramref name="assemblyResolver" /> and <paramref name="typeResolver" /> parameters can be found in the <see cref="M:System.Type.GetType(System.String,System.Func{System.Reflection.AssemblyName,System.Reflection.Assembly},System.Func{System.Reflection.Assembly,System.String,System.Boolean,System.Type},System.Boolean,System.Boolean)" /> method overload.</para>
@@ -6866,6 +6802,10 @@ permission, returns <see langword="null" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the type with the specified name, optionally providing custom methods to resolve the assembly and the type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type with the specified name, or null if the type is not found. </para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the type to get. If the <paramref name="typeResolver" /> parameter is provided, the type name can be any string that <paramref name="typeResolver" /> is capable of resolving. If the <paramref name="assemblyResolver" /> parameter is provided or if standard type resolution is used, <paramref name="typeName" /> must be an assembly-qualified name (see <see cref="P:System.Type.AssemblyQualifiedName" />), unless the type is in the currently executing assembly or in Mscorlib.dll, in which case it is sufficient to supply the type name qualified by its namespace.</param>
         <param name="assemblyResolver">
@@ -6891,7 +6831,6 @@ permission, returns <see langword="null" />.</para>
         <Parameter Name="throwOnError" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Usage scenarios for this method and details about the <paramref name="assemblyResolver" /> and <paramref name="typeResolver" /> parameters can be found in the <see cref="M:System.Type.GetType(System.String,System.Func{System.Reflection.AssemblyName,System.Reflection.Assembly},System.Func{System.Reflection.Assembly,System.String,System.Boolean,System.Type},System.Boolean,System.Boolean)" /> method overload.</para>
@@ -6901,6 +6840,10 @@ permission, returns <see langword="null" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the type with the specified name, specifying whether to throw an exception if the type is not found, and optionally providing custom methods to resolve the assembly and the type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type with the specified name. If the type is not found, the <paramref name="throwOnError" /> parameter specifies whether null is returned or an exception is thrown. In some cases, an exception is thrown regardless of the value of <paramref name="throwOnError" />. See the Exceptions section. </para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the type to get. If the <paramref name="typeResolver" /> parameter is provided, the type name can be any string that <paramref name="typeResolver" /> is capable of resolving. If the <paramref name="assemblyResolver" /> parameter is provided or if standard type resolution is used, <paramref name="typeName" /> must be an assembly-qualified name (see <see cref="P:System.Type.AssemblyQualifiedName" />), unless the type is in the currently executing assembly or in Mscorlib.dll, in which case it is sufficient to supply the type name qualified by its namespace.</param>
         <param name="assemblyResolver">
@@ -6929,7 +6872,6 @@ permission, returns <see langword="null" />.</para>
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Use this method overload and its associated overloads (<see cref="M:System.Type.GetType(System.String,System.Func{System.Reflection.AssemblyName,System.Reflection.Assembly},System.Func{System.Reflection.Assembly,System.String,System.Boolean,System.Type})" /> and <see cref="M:System.Type.GetType(System.String,System.Func{System.Reflection.AssemblyName,System.Reflection.Assembly},System.Func{System.Reflection.Assembly,System.String,System.Boolean,System.Type},System.Boolean)" />) to replace the default implementation of the <see cref="M:System.Type.GetType(System.String)" /> method with more flexible implementations. By providing your own methods that resolve type names and the names of the assemblies that contain them, you can do the following:</para>
@@ -7230,6 +7172,10 @@ permission, returns <see langword="null" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the type with the specified name, specifying whether to perform a case-sensitive search and whether to throw an exception if the type is not found, and optionally providing custom methods to resolve the assembly and the type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type with the specified name. If the type is not found, the <paramref name="throwOnError" /> parameter specifies whether null is returned or an exception is thrown. In some cases, an exception is thrown regardless of the value of <paramref name="throwOnError" />. See the Exceptions section. </para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the type to get. If the <paramref name="typeResolver" /> parameter is provided, the type name can be any string that <paramref name="typeResolver" /> is capable of resolving. If the <paramref name="assemblyResolver" /> parameter is provided or if standard type resolution is used, <paramref name="typeName" /> must be an assembly-qualified name (see <see cref="P:System.Type.AssemblyQualifiedName" />), unless the type is in the currently executing assembly or in Mscorlib.dll, in which case it is sufficient to supply the type name qualified by its namespace.</param>
         <param name="assemblyResolver">
@@ -7259,14 +7205,6 @@ permission, returns <see langword="null" />.</para>
         <Parameter Name="args" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para> An array of <see cref="T:System.Type" /> objects representing the types of the corresponding
-   elements in <paramref name="args" />. If a requested type is not public
-   and the caller does not have permission to
-   reflect non-public objects outside the current assembly, the corresponding element in the
-   array returned by this method will be <see langword="null" />.
-   </para>
-        </returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="args" /> is <see langword="null" />. </exception>
@@ -7276,6 +7214,10 @@ permission, returns <see langword="null" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the types of the objects in the specified array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of <see cref="T:System.Type" /> objects representing the types of the corresponding elements in <paramref name="args" />.</para>
+        </returns>
         <param name="args">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of objects whose types to determine. </param>
       </Docs>
@@ -7298,7 +7240,6 @@ permission, returns <see langword="null" />.</para>
         <Parameter Name="type" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When you inherit from <see cref="T:System.Type" />, you can change the behavior of this method by overriding the <see cref="M:System.Type.GetTypeCodeImpl" /> method.</para>
@@ -7307,6 +7248,10 @@ permission, returns <see langword="null" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the underlying type code of the specified <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The code of the underlying type, or <see cref="F:System.TypeCode.Empty" /> if <paramref name="type" /> is null.</para>
+        </returns>
         <param name="type">
           <attribution license="cc4" from="Microsoft" modified="false" />The type whose underlying type code to get. </param>
       </Docs>
@@ -7323,7 +7268,6 @@ permission, returns <see langword="null" />.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method provides the implementation for the <see cref="M:System.Type.GetTypeCode(System.Type)" /> method. When you inherit from <see cref="T:System.Type" />, you can override this method to provide your own implementation of <see cref="M:System.Type.GetTypeCode(System.Type)" />.</para>
@@ -7332,6 +7276,10 @@ permission, returns <see langword="null" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the underlying type code of the specified <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The code of the underlying type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetTypeFromCLSID">
@@ -7350,12 +7298,15 @@ permission, returns <see langword="null" />.</para>
         <Parameter Name="clsid" Type="System.Guid" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the type associated with the specified class identifier (CLSID).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>System.__ComObject regardless of whether the CLSID is valid.</para>
+        </returns>
         <param name="clsid">
           <attribution license="cc4" from="Microsoft" modified="false" />The CLSID of the type to get. </param>
       </Docs>
@@ -7377,7 +7328,6 @@ permission, returns <see langword="null" />.</para>
         <Parameter Name="throwOnError" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Exceptions such as <see cref="T:System.OutOfMemoryException" /> will be thrown when specifying true for <paramref name="throwOnError" />, but it will not fail for unregistered CLSIDs.</para>
@@ -7386,6 +7336,10 @@ permission, returns <see langword="null" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the type associated with the specified class identifier (CLSID), specifying whether to throw an exception if an error occurs while loading the type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>System.__ComObject regardless of whether the CLSID is valid.</para>
+        </returns>
         <param name="clsid">
           <attribution license="cc4" from="Microsoft" modified="false" />The CLSID of the type to get. </param>
         <param name="throwOnError">
@@ -7409,12 +7363,15 @@ permission, returns <see langword="null" />.</para>
         <Parameter Name="server" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the type associated with the specified class identifier (CLSID) from the specified server.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>System.__ComObject regardless of whether the CLSID is valid.</para>
+        </returns>
         <param name="clsid">
           <attribution license="cc4" from="Microsoft" modified="false" />The CLSID of the type to get. </param>
         <param name="server">
@@ -7439,7 +7396,6 @@ permission, returns <see langword="null" />.</para>
         <Parameter Name="throwOnError" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Exceptions such as <see cref="T:System.OutOfMemoryException" /> will be thrown when specifying true for <paramref name="throwOnError" />, but it will not fail for unregistered CLSIDs.</para>
@@ -7448,6 +7404,10 @@ permission, returns <see langword="null" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the type associated with the specified class identifier (CLSID) from the specified server, specifying whether to throw an exception if an error occurs while loading the type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>System.__ComObject regardless of whether the CLSID is valid.</para>
+        </returns>
         <param name="clsid">
           <attribution license="cc4" from="Microsoft" modified="false" />The CLSID of the type to get. </param>
         <param name="server">
@@ -7473,9 +7433,6 @@ permission, returns <see langword="null" />.</para>
         <Parameter Name="handle" Type="System.RuntimeTypeHandle" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Type" /> referenced by the specified <see cref="T:System.RuntimeTypeHandle" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="handle" /> is <see langword="null" />.</exception>
         <exception cref="T:System.Security.SecurityException">The requested type is non-public and outside the current assembly, and the caller does not have the required permission.</exception>
@@ -7489,6 +7446,10 @@ permission, returns <see langword="null" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the type referenced by the specified type handle.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type referenced by the specified <see cref="T:System.RuntimeTypeHandle" />, or null if the <see cref="P:System.RuntimeTypeHandle.Value" /> property of <paramref name="handle" /> is null.</para>
+        </returns>
         <param name="handle">
           <attribution license="cc4" from="Microsoft" modified="false" />The object that refers to the type. </param>
       </Docs>
@@ -7511,7 +7472,6 @@ permission, returns <see langword="null" />.</para>
         <Parameter Name="progID" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is provided for COM support. ProgIDs are not used in the Microsoft .NET Framework because they have been superseded by the concept of namespace.</para>
@@ -7520,6 +7480,10 @@ permission, returns <see langword="null" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the type associated with the specified program identifier (ProgID), returning null if an error is encountered while loading the <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type associated with the specified ProgID, if <paramref name="progID" /> is a valid entry in the registry and a type is associated with it; otherwise, null.</para>
+        </returns>
         <param name="progID">
           <attribution license="cc4" from="Microsoft" modified="false" />The ProgID of the type to get. </param>
       </Docs>
@@ -7541,7 +7505,6 @@ permission, returns <see langword="null" />.</para>
         <Parameter Name="throwOnError" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is provided for COM support. Program IDs are not used in Microsoft .NET Framework because they have been superseded by the concept of namespace.</para>
@@ -7550,6 +7513,10 @@ permission, returns <see langword="null" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the type associated with the specified program identifier (ProgID), specifying whether to throw an exception if an error occurs while loading the type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type associated with the specified program identifier (ProgID), if <paramref name="progID" /> is a valid entry in the registry and a type is associated with it; otherwise, null.</para>
+        </returns>
         <param name="progID">
           <attribution license="cc4" from="Microsoft" modified="false" />The ProgID of the type to get. </param>
         <param name="throwOnError">
@@ -7573,7 +7540,6 @@ permission, returns <see langword="null" />.</para>
         <Parameter Name="server" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is provided for COM support. Program IDs are not used in Microsoft .NET Framework because they have been superseded by the concept of namespace.</para>
@@ -7582,6 +7548,10 @@ permission, returns <see langword="null" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the type associated with the specified program identifier (progID) from the specified server, returning null if an error is encountered while loading the type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type associated with the specified program identifier (progID), if <paramref name="progID" /> is a valid entry in the registry and a type is associated with it; otherwise, null.</para>
+        </returns>
         <param name="progID">
           <attribution license="cc4" from="Microsoft" modified="false" />The progID of the type to get. </param>
         <param name="server">
@@ -7606,7 +7576,6 @@ permission, returns <see langword="null" />.</para>
         <Parameter Name="throwOnError" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is provided for COM support. Program IDs are not used in Microsoft .NET Framework because they have been superseded by the concept of namespace.</para>
@@ -7615,6 +7584,10 @@ permission, returns <see langword="null" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the type associated with the specified program identifier (progID) from the specified server, specifying whether to throw an exception if an error occurs while loading the type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type associated with the specified program identifier (progID), if <paramref name="progID" /> is a valid entry in the registry and a type is associated with it; otherwise, null.</para>
+        </returns>
         <param name="progID">
           <attribution license="cc4" from="Microsoft" modified="false" />The progID of the <see cref="T:System.Type" /> to get. </param>
         <param name="server">
@@ -7640,9 +7613,6 @@ permission, returns <see langword="null" />.</para>
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.RuntimeTypeHandle" /> for the <see cref="T:System.Type" /> of the specified <see cref="T:System.Object" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The handles are valid only in the application domain in which they were obtained.</para>
@@ -7651,6 +7621,10 @@ permission, returns <see langword="null" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the handle for the <see cref="T:System.Type" /> of a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The handle for the <see cref="T:System.Type" /> of the specified <see cref="T:System.Object" />.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object for which to get the type handle. </param>
       </Docs>
@@ -7728,10 +7702,6 @@ permission, returns <see langword="null" />.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the <see cref="T:System.Type" /> is an array, a pointer, or is passed by reference; otherwise, <see langword="false" />. </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For example, Type.GetType("Int32[]").HasElementTypeImpl returns true, but Type.GetType("Int32").HasElementTypeImpl returns false. HasElementTypeImpl also returns true for "Int32*" and "Int32&amp;".</para>
@@ -7740,6 +7710,10 @@ permission, returns <see langword="null" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, implements the <see cref="P:System.Type.HasElementType" /> property and determines whether the current <see cref="T:System.Type" /> encompasses or refers to another type; that is, whether the current <see cref="T:System.Type" /> is an array, a pointer, or is passed by reference.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Type" /> is an array, a pointer, or is passed by reference; otherwise, false.</para>
+        </returns>
       </Docs>
       <Excluded>1</Excluded>
       <ExcludedLibrary>Reflection</ExcludedLibrary>
@@ -7770,11 +7744,6 @@ permission, returns <see langword="null" />.</para>
         <Parameter Name="args" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Object" />
-containing the return value of the invoked member. If the invoked member does
-not have a return value, returns a <see cref="T:System.Object" /> containing <see cref="T:System.Void" /> .</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <para>
             <paramref name="name" /> is <see langword="null" />.</para>
@@ -7901,6 +7870,10 @@ not have a return value, returns a <see cref="T:System.Object" /> containing <se
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes the specified member, using the specified binding constraints and matching the specified argument list.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the return value of the invoked member.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the constructor, method, property, or field member to invoke.</param>
         <param name="invokeAttr">
@@ -7942,11 +7915,6 @@ not have a return value, returns a <see cref="T:System.Object" /> containing <se
         <Parameter Name="culture" Type="System.Globalization.CultureInfo" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Object" />
-containing the return value of the invoked member. If the invoked member does
-not have a return value, returns a <see cref="T:System.Object" /> containing <see cref="T:System.Void" /> .</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <para>
             <paramref name="n" />
@@ -8082,6 +8050,10 @@ not have a return value, returns a <see cref="T:System.Object" /> containing <se
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Invokes the specified member, using the specified binding constraints and matching the specified argument list and culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the return value of the invoked member.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the constructor, method, property, or field member to invoke.</param>
         <param name="invokeAttr">
@@ -8122,11 +8094,6 @@ not have a return value, returns a <see cref="T:System.Object" /> containing <se
         <Parameter Name="namedParameters" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Object" />
-containing the return value of the invoked or accessed member. If the member
-does not have a return value, returns a <see cref="T:System.Object" /> containing <see cref="T:System.Void" /> .</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <para>
             <paramref name="name" /> is <see langword="null" />.</para>
@@ -8324,6 +8291,10 @@ class InvokeMemberExample
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, invokes the specified member, using the specified binding constraints and matching the specified argument list, modifiers and culture.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing the return value of the invoked member.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The string containing the name of the constructor, method, property, or field member to invoke.</param>
         <param name="invokeAttr">
@@ -8471,10 +8442,6 @@ class TestType {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the <see cref="T:System.Type" /> is an array; otherwise, <see langword="false" />. </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>An instance of the <see cref="T:System.Array" /> class must return false because it is an object, not an array.</para>
@@ -8483,6 +8450,10 @@ class TestType {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, implements the <see cref="P:System.Type.IsArray" /> property and determines whether the <see cref="T:System.Type" /> is an array.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Type" /> is an array; otherwise, false.</para>
+        </returns>
       </Docs>
       <Excluded>1</Excluded>
       <ExcludedLibrary>Reflection</ExcludedLibrary>
@@ -8504,35 +8475,6 @@ class TestType {
         <Parameter Name="c" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="false" /> if <paramref name="c" /> is a null reference.</para>
-          <para>
-            <see langword="true" /> if one or more of the following
-statements are true; otherwise <see langword="false" />. </para>
-          <list type="bullet">
-            <item>
-              <term>
-      
-      If <paramref name="c" /> and the current <see cref="T:System.Type" /> represent the same type.</term>
-            </item>
-            <item>
-              <term>
-      
-      If the current <see cref="T:System.Type" /> is in the inheritance hierarchy of <paramref name="c" />.</term>
-            </item>
-            <item>
-              <term>
-      
-      If the current <see cref="T:System.Type" /> is an interface and <paramref name="c" /> supports that
-      interface.</term>
-            </item>
-            <item>
-              <term>If <paramref name="c" /> is a generic type parameter and the current instance represents one of the constraints of <paramref name="c" />.</term>
-            </item>
-          </list>
-          <see langword="" />
-        </returns>
         <example>
           <para>The following example demonstrates the <see cref="M:System.Type.IsAssignableFrom(System.Type)" />
 method using arrays.</para>
@@ -8592,6 +8534,10 @@ typeof(A).IsAssignableFrom(b1))</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether an instance of the current <see cref="T:System.Type" /> can be assigned from an instance of the specified Type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="c" /> and the current Type represent the same type, or if the current Type is in the inheritance hierarchy of <paramref name="c" />, or if the current Type is an interface that <paramref name="c" /> implements, or if <paramref name="c" /> is a generic type parameter and the current Type represents one of the constraints of <paramref name="c" />, or if <paramref name="c" /> represents a value type and the current Type represents Nullable&lt;c&gt; (Nullable(Of c) in Visual Basic). false if none of these conditions are true, or if <paramref name="c" /> is null.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to compare with the current type. </param>
       </Docs>
@@ -8708,10 +8654,6 @@ typeof(A).IsAssignableFrom(b1))</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the <see cref="T:System.Type" /> is passed by reference; otherwise, <see langword="false" />. </para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="behaviors">As described above.</block>
@@ -8721,6 +8663,10 @@ typeof(A).IsAssignableFrom(b1))</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, implements the <see cref="P:System.Type.IsByRef" /> property and determines whether the <see cref="T:System.Type" /> is passed by reference.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Type" /> is passed by reference; otherwise, false.</para>
+        </returns>
       </Docs>
       <Excluded>1</Excluded>
       <ExcludedLibrary>Reflection</ExcludedLibrary>
@@ -8805,11 +8751,6 @@ typeof(A).IsAssignableFrom(b1))</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>
-            <see langword="false" />
-          </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns false for COM interfaces because they are not objects. COM interfaces can be implemented by Microsoft .NET Framework objects.</para>
@@ -8818,6 +8759,10 @@ typeof(A).IsAssignableFrom(b1))</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, implements the <see cref="P:System.Type.IsCOMObject" /> property and determines whether the <see cref="T:System.Type" /> is a COM object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Type" /> is a COM object; otherwise, false.</para>
+        </returns>
       </Docs>
       <Excluded>1</Excluded>
       <ExcludedLibrary>Reflection</ExcludedLibrary>
@@ -8884,7 +8829,6 @@ typeof(A).IsAssignableFrom(b1))</code>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be overridden by a derived class.</para>
@@ -8894,6 +8838,10 @@ typeof(A).IsAssignableFrom(b1))</code>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implements the <see cref="P:System.Type.IsContextful" /> property and determines whether the <see cref="T:System.Type" /> can be hosted in a context.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Type" /> can be hosted in a context; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsEnum">
@@ -8970,12 +8918,15 @@ class TestType {
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value that indicates whether the specified value exists in the current enumeration type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified value is a member of the current enumeration type; otherwise, false.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value to be tested.</param>
       </Docs>
@@ -8994,7 +8945,6 @@ class TestType {
         <Parameter Name="other" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Beginning with the net_v40_long, the common language runtime supports the embedding of type information for COM types directly into managed assemblies, instead of requiring the managed assemblies to obtain type information for COM types from interop assemblies. Because the embedded type information includes only the types and members that are actually used by a managed assembly, two managed assemblies might have very different views of the same COM type. Each managed assembly has a different <see cref="T:System.Type" /> object to represent its view of the COM type. The common language runtime supports type equivalence between these different views for interfaces, structures, enumerations, and delegates.</para>
@@ -9005,6 +8955,10 @@ class TestType {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two COM types have the same identity and are eligible for type equivalence.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the COM types are equivalent; otherwise, false. This method also returns false if one type is in an assembly that is loaded for execution, and the other is in an assembly that is loaded into the reflection-only context.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The COM type that is tested for equivalence with the current type.</param>
       </Docs>
@@ -9375,26 +9329,6 @@ class TestType {
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if either of the following
-   statements is true; otherwise <see langword="false" />.
-   </para>
-          <list type="bullet">
-            <item>
-              <term>
-      
-      If the current <see cref="T:System.Type" /> is in the inheritance hierarchy of <paramref name="o" />.</term>
-            </item>
-            <item>
-              <term>
-      
-      If the current <see cref="T:System.Type" /> is an interface and <paramref name="o" /> supports that
-      interface.</term>
-            </item>
-          </list>
-          <para>If <paramref name="o" /> is a null reference or if the current instance is an open generic type (that is, <see cref="P:System.Type.ContainsGenericParameters" />  returns <see langword="true" />) returns <see langword="false" />.</para>
-        </returns>
         <example>
           <para>The following example demonstrates the <see cref="M:System.Type.IsInstanceOfType(System.Object)" />
 method.</para>
@@ -9439,6 +9373,10 @@ class IsInstanceTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the specified object is an instance of the current <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current Type is in the inheritance hierarchy of the object represented by <paramref name="o" />, or if the current Type is an interface that <paramref name="o" /> supports. false if neither of these conditions is the case, or if <paramref name="o" /> is null, or if the current Type is an open generic type (that is, <see cref="P:System.Type.ContainsGenericParameters" /> returns true).</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current type. </param>
       </Docs>
@@ -9562,7 +9500,6 @@ class IsInstanceTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method can be overridden by a derived class.</para>
@@ -9571,6 +9508,10 @@ class IsInstanceTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implements the <see cref="P:System.Type.IsMarshalByRef" /> property and determines whether the <see cref="T:System.Type" /> is marshaled by reference.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Type" /> is marshaled by reference; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsNested">
@@ -9888,10 +9829,6 @@ class IsInstanceTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the <see cref="T:System.Type" /> is a pointer; otherwise, <see langword="false" />. </para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="behaviors">As described above.</block>
@@ -9901,6 +9838,10 @@ class IsInstanceTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, implements the <see cref="P:System.Type.IsPointer" /> property and determines whether the <see cref="T:System.Type" /> is a pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Type" /> is a pointer; otherwise, false.</para>
+        </returns>
       </Docs>
       <Excluded>1</Excluded>
       <ExcludedLibrary>Reflection</ExcludedLibrary>
@@ -9952,10 +9893,6 @@ class IsInstanceTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if the <see cref="T:System.Type" /> is one of the primitive types; otherwise, <see langword="false" />. </para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The primitive types are <see cref="T:System.Boolean" />, <see cref="T:System.Byte" />, <see cref="T:System.SByte" />, <see cref="T:System.Int16" />, <see cref="T:System.UInt16" />, <see cref="T:System.Int32" />, <see cref="T:System.UInt32" />, <see cref="T:System.Int64" />, <see cref="T:System.UInt64" />, <see cref="T:System.Char" />, <see cref="T:System.Double" />, and <see cref="T:System.Single" />.</para>
@@ -9964,6 +9901,10 @@ class IsInstanceTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When overridden in a derived class, implements the <see cref="P:System.Type.IsPrimitive" /> property and determines whether the <see cref="T:System.Type" /> is one of the primitive types.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Type" /> is one of the primitive types; otherwise, false.</para>
+        </returns>
       </Docs>
       <Excluded>1</Excluded>
       <ExcludedLibrary>Reflection</ExcludedLibrary>
@@ -10314,14 +10255,6 @@ class IsInstanceTest {
         <Parameter Name="c" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="c" /> and the current
-<see cref="T:System.Type" /> represent 
-   classes, and the class represented by the current <see cref="T:System.Type" /> derives from the class represented by
-<paramref name="c" />; otherwise <see langword="false" />. Returns <see langword="false" /> if 
-<paramref name="c" /> and the current <see cref="T:System.Type" /> represent the same class.</para>
-        </returns>
         <example>
           <para>The following example demonstrates the <see cref="M:System.Type.IsSubclassOf(System.Type)" />
 method.</para>
@@ -10374,6 +10307,10 @@ class IsSubclassTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the class represented by the current <see cref="T:System.Type" /> derives from the class represented by the specified <see cref="T:System.Type" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the Type represented by the <paramref name="c" /> parameter and the current Type represent classes, and the class represented by the current Type derives from the class represented by <paramref name="c" />; otherwise, false. This method also returns false if <paramref name="c" /> and the current Type represent the same class.</para>
+        </returns>
         <param name="c">
           <attribution license="cc4" from="Microsoft" modified="false" />The type to compare with the current type. </param>
       </Docs>
@@ -10454,7 +10391,6 @@ class IsSubclassTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method is provided to enable the implementation of alternate type systems. It is not generally used in application code. </para>
@@ -10463,6 +10399,10 @@ class IsSubclassTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Implements the <see cref="P:System.Type.IsValueType" /> property and determines whether the <see cref="T:System.Type" /> is a value type; that is, not a class or an interface.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the <see cref="T:System.Type" /> is a value type; otherwise, false.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="IsVisible">
@@ -10502,9 +10442,6 @@ class IsSubclassTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Type" /> object representing a one-dimensional array type whose element type is the current type, with a lower bound of zero.</para>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -10515,6 +10452,10 @@ class IsSubclassTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Type" /> object representing a one-dimensional array of the current type, with a lower bound of zero.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object representing a one-dimensional array of the current type, with a lower bound of zero.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MakeArrayType">
@@ -10532,9 +10473,6 @@ class IsSubclassTest {
         <Parameter Name="rank" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Type" /> object representing an array of the current type, with the specified number of dimensions.</para>
-        </returns>
         <since version=".NET 2.0" />
         <exception cref="T:System.IndexOutOfRangeException">
           <para>
@@ -10551,6 +10489,10 @@ class IsSubclassTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Type" /> object representing an array of the current type, with the specified number of dimensions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object representing an array of the current type, with the specified number of dimensions.</para>
+        </returns>
         <param name="rank">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of dimensions for the array. This number must be less than or equal to 32.</param>
       </Docs>
@@ -10568,9 +10510,6 @@ class IsSubclassTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Type" /> object that represents the current type when passed as a byref parameter.</para>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -10581,6 +10520,10 @@ class IsSubclassTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Type" /> object that represents the current type when passed as a ref parameter (ByRef parameter in Visual Basic).</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object that represents the current type when passed as a ref parameter (ByRef parameter in Visual Basic).</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MakeGenericType">
@@ -10604,9 +10547,6 @@ class IsSubclassTest {
         </Parameter>
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Type" /> representing the constructed type formed by substituting the elements of <paramref name="typeArguments" /> for the type parameters of the current generic type definition.</para>
-        </returns>
         <since version=".NET 2.0" />
         <exception cref="T:System.ArgumentException">
           <para>The number of elements in 
@@ -10741,6 +10681,10 @@ System.Collections.Generic.Dictionary[System.String, Test]
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Substitutes the elements of an array of types for the type parameters of the current generic type definition and returns a <see cref="T:System.Type" /> object representing the resulting constructed type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> representing the constructed type formed by substituting the elements of <paramref name="typeArguments" /> for the type parameters of the current generic type.</para>
+        </returns>
         <param name="typeArguments">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of types to be substituted for the type parameters of the current generic type.</param>
       </Docs>
@@ -10758,9 +10702,6 @@ System.Collections.Generic.Dictionary[System.String, Test]
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Type" /> object that represents the type of an unmanaged pointer to the current type.</para>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -10771,6 +10712,10 @@ System.Collections.Generic.Dictionary[System.String, Test]
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a <see cref="T:System.Type" /> object that represents a pointer to the current type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> object that represents a pointer to the current type.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MemberType">
@@ -10905,12 +10850,15 @@ System.Collections.Generic.Dictionary[System.String, Test]
         <Parameter Name="right" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Type" /> objects are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is equal to <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare.</param>
         <param name="right">
@@ -10932,12 +10880,15 @@ System.Collections.Generic.Dictionary[System.String, Test]
         <Parameter Name="right" Type="System.Type" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether two <see cref="T:System.Type" /> objects are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="left" /> is not equal to <paramref name="right" />; otherwise, false.</para>
+        </returns>
         <param name="left">
           <attribution license="cc4" from="Microsoft" modified="false" />The first object to compare.</param>
         <param name="right">
@@ -11015,7 +10966,6 @@ public abstract class ReflectedTypeTest {
         <Parameter Name="ignoreCase" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -11028,6 +10978,10 @@ public abstract class ReflectedTypeTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Gets the <see cref="T:System.Type" /> with the specified name, specifying whether to perform a case-sensitive search and whether to throw an exception if the type is not found. The type is loaded for reflection only, not for execution.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type with the specified name, if found; otherwise, null. If the type is not found, the <paramref name="throwIfNotFound" /> parameter specifies whether null is returned or an exception is thrown. In some cases, an exception is thrown regardless of the value of <paramref name="throwIfNotFound" />. See the Exceptions section.</para>
+        </returns>
         <param name="typeName">
           <attribution license="cc4" from="Microsoft" modified="false" />The assembly-qualified name of the <see cref="T:System.Type" /> to get. </param>
         <param name="throwIfNotFound">
@@ -11195,9 +11149,6 @@ public abstract class ReflectedTypeTest {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>Returns <see cref="P:System.Type.FullName" /> .</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This method returns the fully qualified common language runtime namespace and name for all primitive types. For example, the C# instruction, (long)0.Type().ToString() returns "System.Int64" instead of merely "Int64".</para>
@@ -11207,6 +11158,10 @@ public abstract class ReflectedTypeTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a String representing the name of the current Type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> representing the name of the current <see cref="T:System.Type" />.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System/TypedReference.xml b/mcs/class/corlib/Documentation/en/System/TypedReference.xml
index 600e9d290e2..cb271be5da9 100644
--- a/mcs/class/corlib/Documentation/en/System/TypedReference.xml
+++ b/mcs/class/corlib/Documentation/en/System/TypedReference.xml
@@ -51,11 +51,6 @@
         <Parameter Name="o" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> represents the same
-   type and value as the current instance; otherwise,  <see langword="false" />.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note">This method
@@ -66,6 +61,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Checks if this object is equal to the specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if this object is equal to the specified object; otherwise, false.</para>
+        </returns>
         <param name="o">
           <attribution license="cc4" from="Microsoft" modified="false" />The object with which to compare the current object. </param>
       </Docs>
@@ -84,9 +83,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the hash code for the current instance.</para>
-        </returns>
         <remarks>
           <para> The algorithm used to
       generate the hash code is unspecified. </para>
@@ -99,6 +95,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code of this object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The hash code of this object.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetTargetType">
@@ -117,14 +117,15 @@
         <Parameter Name="value" Type="System.TypedReference" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Type" /> of the target of the specified <see cref="T:System.TypedReference" />.</para>
-        </returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the type of the target of the specified TypedReference.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The type of the target of the specified TypedReference.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The value whose target's type is to be returned. </param>
       </Docs>
@@ -151,9 +152,6 @@
         <Parameter Name="flds" Type="System.Reflection.FieldInfo[]" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.TypedReference" /> for the field described by the last element of <paramref name="flds" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentException">
           <para>The 
 <paramref name="flds" /> array has no elements. </para>
@@ -184,6 +182,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Makes a TypedReference for a field identified by a specified object and list of field descriptions.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.TypedReference" /> for the field described by the last element of <paramref name="flds" />.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that contains the field described by the first element of <paramref name="flds" />. </param>
         <param name="flds">
@@ -226,6 +228,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified value to a TypedReference. This method is not supported.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This method always throws <see cref="T:System.NotSupportedException" />.</para>
+        </returns>
         <param name="target">
           <attribution license="cc4" from="Microsoft" modified="false" />The target of the conversion. </param>
         <param name="value">
@@ -248,14 +254,15 @@
         <Parameter Name="value" Type="System.TypedReference" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The internal metadata type handle for the specified <see cref="T:System.TypedReference" />.</para>
-        </returns>
         <remarks>To be added</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the internal metadata type handle for the specified TypedReference.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The internal metadata type handle for the specified TypedReference.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The TypedReference for which the type handle is requested. </param>
       </Docs>
@@ -276,9 +283,6 @@
         <Parameter Name="value" Type="System.TypedReference" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.Object" /> that results from the conversion of the specified <see cref="T:System.TypedReference" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This might be a boxing operation.</para>
@@ -287,6 +291,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the specified TypedReference to an Object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An <see cref="T:System.Object" /> converted from a TypedReference.</para>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />The TypedReference to be converted. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System/UInt16.xml b/mcs/class/corlib/Documentation/en/System/UInt16.xml
index 9974ea9c01a..a2216c81a3a 100644
--- a/mcs/class/corlib/Documentation/en/System/UInt16.xml
+++ b/mcs/class/corlib/Documentation/en/System/UInt16.xml
@@ -73,42 +73,61 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="value" /> is not a <see cref="T:System.UInt16" /> and is not a null reference.</exception>
+        <remarks>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Any instance of <see cref="T:System.UInt16" />, regardless of its value, is considered greater than null.</para>
+          <para>
+            <paramref name="value" /> must be null or an instance of <see cref="T:System.UInt16" />; otherwise, an exception is thrown.</para>
+        </remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Compares this instance to a specified object and returns an indication of their relative values.</para>
+        </summary>
         <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="value" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number indicating the relative values of this instance and <paramref name="value" />.</para>
           <list type="table">
             <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
             </listheader>
             <item>
-              <term> A negative number</term>
-              <description>Current instance &lt; <paramref name="value" />.</description>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than <paramref name="value" />. </para>
+              </description>
             </item>
             <item>
-              <term> Zero</term>
-              <description>Current instance == <paramref name="value" />.</description>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is equal to <paramref name="value" />. </para>
+              </description>
             </item>
             <item>
-              <term> A positive number</term>
+              <term>
+                <para>Greater than zero </para>
+              </term>
               <description>
-                <para>Current instance &gt; <paramref name="value" />, or
-<paramref name="value" /> is a null reference.</para>
+                <para>This instance is greater than <paramref name="value" />.</para>
+                <para>-or- </para>
+                <para>
+                  <paramref name="value" /> is null. </para>
               </description>
             </item>
           </list>
         </returns>
-        <exception cref="T:System.ArgumentException">
-          <paramref name="value" /> is not a <see cref="T:System.UInt16" /> and is not a null reference.</exception>
-        <remarks>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Any instance of <see cref="T:System.UInt16" />, regardless of its value, is considered greater than null.</para>
-          <para>
-            <paramref name="value" /> must be null or an instance of <see cref="T:System.UInt16" />; otherwise, an exception is thrown.</para>
-        </remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Compares this instance to a specified object and returns an indication of their relative values.</para>
-        </summary>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare, or null. </param>
       </Docs>
@@ -129,27 +148,6 @@
         <Parameter Name="value" Type="System.UInt16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="value" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> A negative number</term>
-              <description>Current instance &lt; <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> Zero</term>
-              <description>Current instance == <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> A positive number</term>
-              <description>Current instance &gt; <paramref name="value" />.</description>
-            </item>
-          </list>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -162,6 +160,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this instance to a specified 16-bit unsigned integer and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number indicating the relative values of this instance and <paramref name="value" />.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is equal to <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than <paramref name="value" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An unsigned integer to compare. </param>
       </Docs>
@@ -183,12 +221,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> represents the
-   same value and type as the current instance. If <paramref name="obj" /> is a null reference
-   or is not an instance of <see cref="T:System.UInt16" />, returns <see langword="false" />.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note">This method
@@ -199,6 +231,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is an instance of <see cref="T:System.UInt16" /> and equals the value of this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare to this instance. </param>
       </Docs>
@@ -219,11 +255,6 @@
         <Parameter Name="obj" Type="System.UInt16" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> represents the
-   same value and type as the current instance; otherwise, <see langword="false" />.</para>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -233,6 +264,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified <see cref="T:System.UInt16" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> has the same value as this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />A 16-bit unsigned integer to compare to this instance.</param>
       </Docs>
@@ -252,10 +287,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" />
-containing the hash code for the current instance.</para>
-        </returns>
         <remarks>
           <para>The algorithm used to
       generate the hash code is unspecified. </para>
@@ -268,6 +299,10 @@ containing the hash code for the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -285,12 +320,15 @@ containing the hash code for the current instance.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.TypeCode" /> for value type <see cref="T:System.UInt16" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The enumerated constant, <see cref="F:System.TypeCode.UInt16" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MaxValue">
@@ -369,9 +407,6 @@ containing the hash code for the current instance.</para>
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.UInt16" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -444,6 +479,10 @@ public class UInt16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number to its 16-bit unsigned integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit unsigned integer equivalent to the number contained in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents the number to convert. </param>
       </Docs>
@@ -472,9 +511,6 @@ public class UInt16ParseClass {
         <Parameter Name="style" Type="System.Globalization.NumberStyles" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.UInt16" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -734,6 +770,10 @@ public class UInt16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified style to its 16-bit unsigned integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit unsigned integer equivalent to the number specified in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents the number to convert. The string is interpreted by using the style specified by the <paramref name="style" /> parameter.</param>
         <param name="style">
@@ -764,9 +804,6 @@ public class UInt16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.UInt16" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -837,6 +874,10 @@ public class UInt16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified culture-specific format to its 16-bit unsigned integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit unsigned integer equivalent to the number specified in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents the number to convert. </param>
         <param name="provider">
@@ -868,9 +909,6 @@ public class UInt16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.UInt16" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -1110,6 +1148,10 @@ public class UInt16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified style and culture-specific format to its 16-bit unsigned integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 16-bit unsigned integer equivalent to the number specified in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents the number to convert. The string is interpreted by using the style specified by the <paramref name="style" /> parameter.</param>
         <param name="style">
@@ -1135,7 +1177,6 @@ public class UInt16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt16" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToBoolean(System.UInt16)" /> method.</para>
@@ -1144,6 +1185,10 @@ public class UInt16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToBoolean(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of the current instance is not zero; otherwise, false.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1164,7 +1209,6 @@ public class UInt16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt16" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToByte(System.UInt16)" /> method.</para>
@@ -1173,6 +1217,10 @@ public class UInt16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToByte(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Byte" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1193,7 +1241,6 @@ public class UInt16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt16" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToChar(System.UInt16)" /> method.</para>
@@ -1202,6 +1249,10 @@ public class UInt16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToChar(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Char" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1222,12 +1273,15 @@ public class UInt16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to use this method throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1248,7 +1302,6 @@ public class UInt16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt16" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToDecimal(System.UInt16)" /> method.</para>
@@ -1257,6 +1310,10 @@ public class UInt16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToDecimal(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current value of this instance, converted to a <see cref="T:System.Decimal" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1277,7 +1334,6 @@ public class UInt16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt16" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToDouble(System.UInt16)" /> method.</para>
@@ -1286,6 +1342,10 @@ public class UInt16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToDouble(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current value of this instance, converted to a <see cref="T:System.Double" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1306,7 +1366,6 @@ public class UInt16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt16" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt16(System.UInt16)" /> method.</para>
@@ -1315,6 +1374,10 @@ public class UInt16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt16(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current value of this instance, converted to an <see cref="T:System.Int16" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1335,7 +1398,6 @@ public class UInt16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt16" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt32(System.UInt16)" /> method.</para>
@@ -1344,6 +1406,10 @@ public class UInt16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt32(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of this instance, converted to an <see cref="T:System.Int32" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1364,7 +1430,6 @@ public class UInt16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt16" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt64(System.UInt16)" /> method.</para>
@@ -1373,6 +1438,10 @@ public class UInt16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt64(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current value of this instance, converted to an <see cref="T:System.Int64" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1393,7 +1462,6 @@ public class UInt16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt16" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToSByte(System.UInt16)" /> method.</para>
@@ -1402,6 +1470,10 @@ public class UInt16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToSByte(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current value of this instance, converted to an <see cref="T:System.SByte" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1422,7 +1494,6 @@ public class UInt16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt16" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToSingle(System.UInt16)" /> method.</para>
@@ -1431,6 +1502,10 @@ public class UInt16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToSingle(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current value pf this instance, converted to a <see cref="T:System.Single" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1453,7 +1528,6 @@ public class UInt16ParseClass {
       </Parameters>
       <Docs>
         <param name="targetType">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt16" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the static (Shared in Visual Basic) <see cref="M:System.Convert.ChangeType(System.Object,System.Type,System.IFormatProvider)" /> method.</para>
@@ -1462,6 +1536,10 @@ public class UInt16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToType(System.Type,System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current value of this instance, converted to <paramref name="type" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> implementation that supplies information about the format of the returned value.</param>
       </Docs>
@@ -1482,7 +1560,6 @@ public class UInt16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt16" /> instance is cast to an <see cref="T:System.IConvertible" /> interface.</para>
@@ -1491,6 +1568,10 @@ public class UInt16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt16(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current value of this instance, unchanged.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1511,7 +1592,6 @@ public class UInt16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt16" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt32(System.UInt16)" /> method.</para>
@@ -1520,6 +1600,10 @@ public class UInt16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt32(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current value of this instance, converted to a <see cref="T:System.UInt32" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1540,7 +1624,6 @@ public class UInt16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt16" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt64(System.UInt16)" /> method.</para>
@@ -1549,6 +1632,10 @@ public class UInt16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt64(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The current value of this instance, converted to a <see cref="T:System.UInt64" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1568,9 +1655,6 @@ public class UInt16ParseClass {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted using the general format specifier ("G"). The string takes into account the current system culture.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.UInt16.ToString" /> method formats a <see cref="T:System.UInt16" /> value in the default ("G", or general) format by using the <see cref="T:System.Globalization.NumberFormatInfo" /> object of the current culture. If you want to specify a different format or culture, use the other overloads of the <see cref="M:System.UInt16.ToString(System.String)" /> method, as follows: </para>
@@ -1634,6 +1718,10 @@ public class UInt16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance, which consists of a sequence of digits ranging from 0 to 9, without a sign or leading zeros.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1654,12 +1742,6 @@ public class UInt16ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted using
-   the general format specifier, ("G"). The string takes into account the
-   formatting information in the <see cref="T:System.Globalization.NumberFormatInfo" /> instance supplied by
-<paramref name="provider" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.UInt16.ToString(System.IFormatProvider)" /> method formats a <see cref="T:System.UInt16" /> value in the default ("G", or general) format by using the <see cref="T:System.Globalization.NumberFormatInfo" /> object of a specified culture. If you want to specify a different format or the current culture, use the other overloads of the <see cref="M:System.UInt16.ToString(System.String)" /> method, as follows:</para>
@@ -1723,6 +1805,10 @@ public class UInt16ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance, which consists of a sequence of digits ranging from 0 to 9, without a sign or leading zeros.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information. </param>
       </Docs>
@@ -1745,11 +1831,6 @@ public class UInt16ParseClass {
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted as
-   specified by <paramref name="format" />. The string takes into account the current system
-   culture.</para>
-        </returns>
         <exception cref="T:System.FormatException">
           <paramref name="format" /> is invalid.</exception>
         <example>
@@ -1851,6 +1932,10 @@ public class UInt16ToStringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation using the specified format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance as specified by <paramref name="format" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A numeric format string.</param>
       </Docs>
@@ -1874,13 +1959,6 @@ public class UInt16ToStringExample {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" />
-representation of the current instance formatted as specified by
-<paramref name="format" />. The string takes into account the formatting information in the 
-<see cref="T:System.Globalization.NumberFormatInfo" /> 
-instance supplied by <paramref name="provider" />.</para>
-        </returns>
         <exception cref="T:System.FormatException">
           <paramref name="format" /> is invalid.</exception>
         <param name="format">
@@ -1971,6 +2049,10 @@ instance supplied by <paramref name="provider" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance, as specified by <paramref name="format" /> and <paramref name="provider" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A numeric format string.</param>
         <param name="provider">
diff --git a/mcs/class/corlib/Documentation/en/System/UInt32.xml b/mcs/class/corlib/Documentation/en/System/UInt32.xml
index 9edafa82ea1..3a59a06c204 100644
--- a/mcs/class/corlib/Documentation/en/System/UInt32.xml
+++ b/mcs/class/corlib/Documentation/en/System/UInt32.xml
@@ -73,41 +73,60 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="value" /> is not a <see cref="T:System.UInt32" /> and is not a null reference.</exception>
+        <remarks>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Any instance of <see cref="T:System.UInt32" />, regardless of its value, is considered greater than null.</para>
+          <para>The <paramref name="value" /> parameter must be null or an instance of <see cref="T:System.UInt32" />; otherwise, an exception is thrown.</para>
+        </remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Compares this instance to a specified object and returns an indication of their relative values.</para>
+        </summary>
         <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="value" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number indicating the relative values of this instance and <paramref name="value" />.</para>
           <list type="table">
             <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
             </listheader>
             <item>
-              <term> A negative number</term>
-              <description>Current instance &lt; <paramref name="value" />.</description>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than <paramref name="value" />. </para>
+              </description>
             </item>
             <item>
-              <term> Zero</term>
-              <description>Current instance == <paramref name="value" />.</description>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is equal to <paramref name="value" />. </para>
+              </description>
             </item>
             <item>
-              <term> A positive number</term>
+              <term>
+                <para>Greater than zero </para>
+              </term>
               <description>
-                <para>Current instance &gt; <paramref name="value" />, or
-<paramref name="value" /> is a null reference.</para>
+                <para>This instance is greater than <paramref name="value" />.</para>
+                <para>-or- </para>
+                <para>
+                  <paramref name="value" /> is null. </para>
               </description>
             </item>
           </list>
         </returns>
-        <exception cref="T:System.ArgumentException">
-          <paramref name="value" /> is not a <see cref="T:System.UInt32" /> and is not a null reference.</exception>
-        <remarks>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Any instance of <see cref="T:System.UInt32" />, regardless of its value, is considered greater than null.</para>
-          <para>The <paramref name="value" /> parameter must be null or an instance of <see cref="T:System.UInt32" />; otherwise, an exception is thrown.</para>
-        </remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Compares this instance to a specified object and returns an indication of their relative values.</para>
-        </summary>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare, or null. </param>
       </Docs>
@@ -128,27 +147,6 @@
         <Parameter Name="value" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="value" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> A negative number</term>
-              <description>Current instance &lt; <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> Zero</term>
-              <description>Current instance == <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> A positive number</term>
-              <description>Current instance &gt; <paramref name="value" />.</description>
-            </item>
-          </list>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -161,6 +159,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this instance to a specified 32-bit unsigned integer and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number indicating the relative values of this instance and <paramref name="value" />.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is equal to <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than <paramref name="value" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An unsigned integer to compare. </param>
       </Docs>
@@ -182,12 +220,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> represents the same
-   type and value as the current instance. If <paramref name="obj" /> is a null reference or
-   is not an instance of <see cref="T:System.UInt32" />, returns <see langword="false" />.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note">This method
@@ -198,6 +230,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is an instance of <see cref="T:System.UInt32" /> and equals the value of this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance. </param>
       </Docs>
@@ -218,10 +254,6 @@
         <Parameter Name="obj" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> represents the same value as the current instance; otherwise, <see langword="false" />.</para>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -231,6 +263,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified <see cref="T:System.UInt32" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> has the same value as this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />A value to compare to this instance.</param>
       </Docs>
@@ -250,9 +286,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the hash code for the current instance.</para>
-        </returns>
         <remarks>
           <para>The algorithm used to
       generate the hash code is unspecified.</para>
@@ -265,6 +298,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -282,12 +319,15 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.TypeCode" /> for value type <see cref="T:System.UInt32" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The enumerated constant, <see cref="F:System.TypeCode.UInt32" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MaxValue">
@@ -366,9 +406,6 @@
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.UInt32" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -443,6 +480,10 @@ public class UInt32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number to its 32-bit unsigned integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit unsigned integer equivalent to the number contained in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string representing the number to convert. </param>
       </Docs>
@@ -471,9 +512,6 @@ public class UInt32ParseClass {
         <Parameter Name="style" Type="System.Globalization.NumberStyles" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.UInt32" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -735,6 +773,10 @@ public class UInt32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified style to its 32-bit unsigned integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit unsigned integer equivalent to the number specified in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string representing the number to convert. The string is interpreted by using the style specified by the <paramref name="style" /> parameter.</param>
         <param name="style">
@@ -765,9 +807,6 @@ public class UInt32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.UInt32" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -834,6 +873,10 @@ public class UInt32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified culture-specific format to its 32-bit unsigned integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit unsigned integer equivalent to the number specified in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents the number to convert. </param>
         <param name="provider">
@@ -865,9 +908,6 @@ public class UInt32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.UInt32" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -1103,6 +1143,10 @@ public class UInt32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified style and culture-specific format to its 32-bit unsigned integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit unsigned integer equivalent to the number specified in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string representing the number to convert. The string is interpreted by using the style specified by the <paramref name="style" /> parameter.</param>
         <param name="style">
@@ -1128,7 +1172,6 @@ public class UInt32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt32" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToBoolean(System.UInt32)" /> method.</para>
@@ -1137,6 +1180,10 @@ public class UInt32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToBoolean(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of the current instance is not zero; otherwise, false.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1157,7 +1204,6 @@ public class UInt32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt32" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToByte(System.UInt32)" /> method.</para>
@@ -1166,6 +1212,10 @@ public class UInt32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToByte(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Byte" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1186,7 +1236,6 @@ public class UInt32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt32" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToChar(System.UInt32)" /> method.</para>
@@ -1195,6 +1244,10 @@ public class UInt32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToChar(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Char" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1215,12 +1268,15 @@ public class UInt32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to use this method throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1241,7 +1297,6 @@ public class UInt32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt32" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToDecimal(System.UInt32)" /> method.</para>
@@ -1250,6 +1305,10 @@ public class UInt32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToDecimal(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Decimal" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1270,7 +1329,6 @@ public class UInt32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt32" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToDouble(System.UInt32)" /> method.</para>
@@ -1279,6 +1337,10 @@ public class UInt32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToDouble(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Double" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1299,7 +1361,6 @@ public class UInt32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt32" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt16(System.UInt32)" /> method.</para>
@@ -1308,6 +1369,10 @@ public class UInt32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt16(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.Int16" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1328,7 +1393,6 @@ public class UInt32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt32" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt32(System.UInt32)" /> method.</para>
@@ -1337,6 +1401,10 @@ public class UInt32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt32(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.Int32" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1357,7 +1425,6 @@ public class UInt32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt32" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt64(System.UInt32)" /> method.</para>
@@ -1366,6 +1433,10 @@ public class UInt32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt64(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.Int64" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1386,7 +1457,6 @@ public class UInt32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt32" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToSByte(System.UInt32)" /> method.</para>
@@ -1395,6 +1465,10 @@ public class UInt32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToSByte(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.SByte" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1415,7 +1489,6 @@ public class UInt32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt32" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToSingle(System.UInt32)" /> method.</para>
@@ -1424,6 +1497,10 @@ public class UInt32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToSingle(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Single" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1446,7 +1523,6 @@ public class UInt32ParseClass {
       </Parameters>
       <Docs>
         <param name="targetType">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt32" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the static (Shared in Visual Basic) <see cref="M:System.Convert.ChangeType(System.Object,System.Type,System.IFormatProvider)" /> method.</para>
@@ -1455,6 +1531,10 @@ public class UInt32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToType(System.Type,System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to <paramref name="type" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> implementation that supplies culture-specific information about the format of the returned value.</param>
       </Docs>
@@ -1475,7 +1555,6 @@ public class UInt32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt32" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt16(System.UInt32)" /> method.</para>
@@ -1484,6 +1563,10 @@ public class UInt32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt16(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.UInt16" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1504,7 +1587,6 @@ public class UInt32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt32" /> instance is cast to an <see cref="T:System.IConvertible" /> interface.</para>
@@ -1513,6 +1595,10 @@ public class UInt32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt32(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, unchanged.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1533,7 +1619,6 @@ public class UInt32ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt32" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt64(System.UInt32)" /> method.</para>
@@ -1542,6 +1627,10 @@ public class UInt32ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt64(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.UInt64" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1561,11 +1650,6 @@ public class UInt32ParseClass {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" />
-representation of the current instance formatted using the general format
-specifier, ("G"). The string takes into account the current system culture.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.UInt32.ToString" /> method formats a <see cref="T:System.UInt32" /> value in the default ("G", or general) format by using the <see cref="T:System.Globalization.NumberFormatInfo" /> object of the current culture. If you want to specify a different format or culture, use the other overloads of the <see cref="M:System.UInt32.ToString(System.String)" /> method, as follows: </para>
@@ -1629,6 +1713,10 @@ specifier, ("G"). The string takes into account the current system culture.</par
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance, consisting of a sequence of digits ranging from 0 to 9, without a sign or leading zeroes.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1649,12 +1737,6 @@ specifier, ("G"). The string takes into account the current system culture.</par
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted using
-   the general format specifier, ("G"). The string takes into account the
-   formatting information in the <see cref="T:System.Globalization.NumberFormatInfo" /> instance supplied by
-<paramref name="provider" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.UInt32.ToString(System.IFormatProvider)" /> method formats a <see cref="T:System.UInt32" /> value in the default ("G", or general) format by using the <see cref="T:System.Globalization.NumberFormatInfo" /> object of a specified culture. If you want to specify a different format or the current culture, use the other overloads of the <see cref="M:System.UInt32.ToString(System.String)" /> method, as follows:</para>
@@ -1719,6 +1801,10 @@ specifier, ("G"). The string takes into account the current system culture.</par
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance, which consists of a sequence of digits ranging from 0 to 9, without a sign or leading zeros.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information. </param>
       </Docs>
@@ -1741,10 +1827,6 @@ specifier, ("G"). The string takes into account the current system culture.</par
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted as
-   specified by <paramref name="format" />. The string takes into account the current system culture.</para>
-        </returns>
         <exception cref="T:System.FormatException">
           <paramref name="format" /> is invalid.</exception>
         <example>
@@ -1847,6 +1929,10 @@ public class UInt32ToStringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation using the specified format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance as specified by <paramref name="format" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A numeric format string.</param>
       </Docs>
@@ -1870,11 +1956,6 @@ public class UInt32ToStringExample {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted as
-   specified by <paramref name="format" />. The string takes into account the formatting
-   information in the <see cref="T:System.Globalization.NumberFormatInfo" /> instance supplied by <paramref name="provider" />.</para>
-        </returns>
         <exception cref="T:System.FormatException">
           <paramref name="format" /> is invalid.</exception>
         <remarks>
@@ -1963,6 +2044,10 @@ public class UInt32ToStringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance as specified by <paramref name="format" /> and <paramref name="provider" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A numeric format string.</param>
         <param name="provider">
diff --git a/mcs/class/corlib/Documentation/en/System/UInt64.xml b/mcs/class/corlib/Documentation/en/System/UInt64.xml
index 11a03a8e578..a1ab6ed969a 100644
--- a/mcs/class/corlib/Documentation/en/System/UInt64.xml
+++ b/mcs/class/corlib/Documentation/en/System/UInt64.xml
@@ -73,42 +73,61 @@
         <Parameter Name="value" Type="System.Object" />
       </Parameters>
       <Docs>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="value" /> is not a <see cref="T:System.UInt64" /> and is not a null reference.</exception>
+        <remarks>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Any instance of <see cref="T:System.UInt64" />, regardless of its value, is considered greater than null.</para>
+          <para>
+            <paramref name="value" /> must be null or an instance of <see cref="T:System.UInt64" />; otherwise, an exception is thrown.</para>
+        </remarks>
+        <summary>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Compares this instance to a specified object and returns an indication of their relative values.</para>
+        </summary>
         <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="value" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number indicating the relative values of this instance and <paramref name="value" />.</para>
           <list type="table">
             <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
             </listheader>
             <item>
-              <term> A negative number</term>
-              <description>Current instance &lt; <paramref name="value" />.</description>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than <paramref name="value" />. </para>
+              </description>
             </item>
             <item>
-              <term> Zero</term>
-              <description>Current instance == <paramref name="value" />.</description>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is equal to <paramref name="value" />. </para>
+              </description>
             </item>
             <item>
-              <term> A positive number</term>
+              <term>
+                <para>Greater than zero </para>
+              </term>
               <description>
-                <para>Current instance &gt; <paramref name="value" />, or
-   <paramref name="value" /> is a null reference. </para>
+                <para>This instance is greater than <paramref name="value" />.</para>
+                <para>-or- </para>
+                <para>
+                  <paramref name="value" /> is null. </para>
               </description>
             </item>
           </list>
         </returns>
-        <exception cref="T:System.ArgumentException">
-          <paramref name="value" /> is not a <see cref="T:System.UInt64" /> and is not a null reference.</exception>
-        <remarks>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Any instance of <see cref="T:System.UInt64" />, regardless of its value, is considered greater than null.</para>
-          <para>
-            <paramref name="value" /> must be null or an instance of <see cref="T:System.UInt64" />; otherwise, an exception is thrown.</para>
-        </remarks>
-        <summary>
-          <attribution license="cc4" from="Microsoft" modified="false" />
-          <para>Compares this instance to a specified object and returns an indication of their relative values.</para>
-        </summary>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare, or null. </param>
       </Docs>
@@ -129,27 +148,6 @@
         <Parameter Name="value" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="value" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> A negative number</term>
-              <description>Current instance &lt; <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> Zero</term>
-              <description>Current instance == <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> A positive number</term>
-              <description>Current instance &gt; <paramref name="value" />.  </description>
-            </item>
-          </list>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -162,6 +160,46 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares this instance to a specified 64-bit unsigned integer and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed number indicating the relative values of this instance and <paramref name="value" />.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return Value </para>
+                </term>
+                <description>
+                  <para>Description </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>This instance is less than <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>This instance is equal to <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>This instance is greater than <paramref name="value" />. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />An unsigned integer to compare. </param>
       </Docs>
@@ -183,12 +221,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> represents the same
-   value and type as the current instance. If <paramref name="obj" /> is a null reference or
-   is not an instance of <see cref="T:System.UInt64" />, returns <see langword="false" />.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note">This method
@@ -199,6 +231,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is an instance of <see cref="T:System.UInt64" /> and equals the value of this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare to this instance. </param>
       </Docs>
@@ -219,10 +255,6 @@
         <Parameter Name="obj" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> represents the same value as the current instance; otherwise, <see langword="false" />.</para>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -232,6 +264,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified <see cref="T:System.UInt64" /> value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> has the same value as this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.UInt64" /> value to compare to this instance.</param>
       </Docs>
@@ -251,10 +287,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" />
-containing the hash code for the current instance.</para>
-        </returns>
         <remarks>
           <para>The algorithm used to
       generate the hash code is unspecified.</para>
@@ -267,6 +299,10 @@ containing the hash code for the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -284,12 +320,15 @@ containing the hash code for the current instance.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the <see cref="T:System.TypeCode" /> for value type <see cref="T:System.UInt64" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The enumerated constant, <see cref="F:System.TypeCode.UInt64" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="MaxValue">
@@ -368,9 +407,6 @@ containing the hash code for the current instance.</para>
         <Parameter Name="s" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.UInt64" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -445,6 +481,10 @@ public class UInt64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number to its 64-bit unsigned integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit unsigned integer equivalent to the number contained in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents the number to convert. </param>
       </Docs>
@@ -473,9 +513,6 @@ public class UInt64ParseClass {
         <Parameter Name="style" Type="System.Globalization.NumberStyles" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.UInt64" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -737,6 +774,10 @@ public class UInt64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified style to its 64-bit unsigned integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit unsigned integer equivalent to the number specified in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents the number to convert. The string is interpreted by using the style specified by the <paramref name="style" /> parameter. </param>
         <param name="style">
@@ -767,9 +808,6 @@ public class UInt64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.UInt64" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -841,6 +879,10 @@ public class UInt64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified culture-specific format to its 64-bit unsigned integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit unsigned integer equivalent to the number specified in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents the number to convert. </param>
         <param name="provider">
@@ -872,9 +914,6 @@ public class UInt64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The <see cref="T:System.UInt64" /> value obtained from <paramref name="s" />.</para>
-        </returns>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="s" /> is a null reference.</exception>
         <exception cref="T:System.FormatException">
@@ -1114,6 +1153,10 @@ public class UInt64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a number in a specified style and culture-specific format to its 64-bit unsigned integer equivalent.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit unsigned integer equivalent to the number specified in <paramref name="s" />.</para>
+        </returns>
         <param name="s">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that represents the number to convert. The string is interpreted by using the style specified by the <paramref name="style" /> parameter.</param>
         <param name="style">
@@ -1139,7 +1182,6 @@ public class UInt64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt64" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToBoolean(System.UInt64)" /> method.</para>
@@ -1148,6 +1190,10 @@ public class UInt64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToBoolean(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the value of the current instance is not zero; otherwise, false.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1168,7 +1214,6 @@ public class UInt64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt64" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToByte(System.UInt64)" /> method.</para>
@@ -1177,6 +1222,10 @@ public class UInt64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToByte(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Byte" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1197,7 +1246,6 @@ public class UInt64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt64" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToChar(System.UInt64)" /> method.</para>
@@ -1206,6 +1254,10 @@ public class UInt64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToChar(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Char" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1226,12 +1278,15 @@ public class UInt64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This conversion is not supported. Attempting to use this method throws an <see cref="T:System.InvalidCastException" />.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>This conversion is not supported. No value is returned.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1252,7 +1307,6 @@ public class UInt64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt64" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToDecimal(System.UInt64)" /> method.</para>
@@ -1261,6 +1315,10 @@ public class UInt64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToDecimal(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Decimal" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1281,7 +1339,6 @@ public class UInt64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt64" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToDouble(System.UInt64)" /> method.</para>
@@ -1290,6 +1347,10 @@ public class UInt64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToDouble(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Double" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1310,7 +1371,6 @@ public class UInt64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt64" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt16(System.UInt64)" /> method.</para>
@@ -1319,6 +1379,10 @@ public class UInt64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt16(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.Int16" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1339,7 +1403,6 @@ public class UInt64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt64" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt32(System.UInt64)" /> method.</para>
@@ -1348,6 +1411,10 @@ public class UInt64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt32(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.Int32" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1368,7 +1435,6 @@ public class UInt64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt64" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToInt64(System.UInt64)" /> method.</para>
@@ -1377,6 +1443,10 @@ public class UInt64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToInt64(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.Int64" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1397,7 +1467,6 @@ public class UInt64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt64" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToSByte(System.UInt64)" /> method.</para>
@@ -1406,6 +1475,10 @@ public class UInt64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToSByte(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to an <see cref="T:System.SByte" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1426,7 +1499,6 @@ public class UInt64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt64" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToSingle(System.UInt64)" /> method.</para>
@@ -1435,6 +1507,10 @@ public class UInt64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToSingle(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.Single" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1457,7 +1533,6 @@ public class UInt64ParseClass {
       </Parameters>
       <Docs>
         <param name="targetType">To be added.</param>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt64" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the static (Shared in Visual Basic) <see cref="M:System.Convert.ChangeType(System.Object,System.Type,System.IFormatProvider)" /> method.</para>
@@ -1466,6 +1541,10 @@ public class UInt64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToType(System.Type,System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to <paramref name="type" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An <see cref="T:System.IFormatProvider" /> implementation that supplies information about the format of the returned value.</param>
       </Docs>
@@ -1486,7 +1565,6 @@ public class UInt64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt64" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt16(System.UInt64)" /> method.</para>
@@ -1495,6 +1573,10 @@ public class UInt64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt16(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.UInt16" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1515,7 +1597,6 @@ public class UInt64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt64" /> instance is cast to an <see cref="T:System.IConvertible" /> interface. The recommended alternative is to call the <see cref="M:System.Convert.ToUInt32(System.UInt64)" /> method.</para>
@@ -1524,6 +1605,10 @@ public class UInt64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt32(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, converted to a <see cref="T:System.UInt32" />.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1544,7 +1629,6 @@ public class UInt64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>This member is an explicit interface member implementation. It can be used only when the <see cref="T:System.UInt64" /> instance is cast to an <see cref="T:System.IConvertible" /> interface.</para>
@@ -1553,6 +1637,10 @@ public class UInt64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>For a description of this member, see <see cref="M:System.IConvertible.ToUInt64(System.IFormatProvider)" />. </para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the current instance, unchanged.</para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />This parameter is ignored.</param>
       </Docs>
@@ -1572,9 +1660,6 @@ public class UInt64ParseClass {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted using the general format specifier, ("G"). The string takes into account the current system culture.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.UInt64.ToString" /> method formats a <see cref="T:System.UInt64" /> value in the default ("G", or general) format by using the <see cref="T:System.Globalization.NumberFormatInfo" /> object of the current culture. If you want to specify a different format or culture, use the other overloads of the <see cref="M:System.UInt64.ToString(System.String)" /> method, as follows: </para>
@@ -1638,6 +1723,10 @@ public class UInt64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance, consisting of a sequence of digits ranging from 0 to 9, without a sign or leading zeroes.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -1658,12 +1747,6 @@ public class UInt64ParseClass {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted using
-   the general format specifier, ("G"). The string takes into account the
-   formatting information in the <see cref="T:System.Globalization.NumberFormatInfo" /> instance supplied by
-<paramref name="provider" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.UInt64.ToString(System.IFormatProvider)" /> method formats a <see cref="T:System.UInt64" /> value in the default ("G", or general) format by using the <see cref="T:System.Globalization.NumberFormatInfo" /> object of a specified culture. If you want to specify a different format or the current culture, use the other overloads of the <see cref="M:System.UInt64.ToString(System.String)" /> method, as follows:</para>
@@ -1728,6 +1811,10 @@ public class UInt64ParseClass {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance, consisting of a sequence of digits ranging from 0 to 9, without a sign or leading zeros.  </para>
+        </returns>
         <param name="provider">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that supplies culture-specific formatting information. </param>
       </Docs>
@@ -1750,11 +1837,6 @@ public class UInt64ParseClass {
         <Parameter Name="format" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted as
-   specified by <paramref name="format" />. The string takes into account the current system
-   culture.</para>
-        </returns>
         <exception cref="T:System.FormatException">
           <paramref name="format" /> is invalid.</exception>
         <example>
@@ -1857,6 +1939,10 @@ public class UInt64ToStringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation using the specified format.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance as specified by <paramref name="format" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A numeric format string.</param>
       </Docs>
@@ -1880,11 +1966,6 @@ public class UInt64ToStringExample {
         <Parameter Name="provider" Type="System.IFormatProvider" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the current instance formatted as
-   specified by <paramref name="format" />. The string takes into account the formatting
-   information in the <see cref="T:System.Globalization.NumberFormatInfo" /> instance supplied by <paramref name="provider" />.</para>
-        </returns>
         <exception cref="T:System.FormatException">
           <paramref name="format" /> is invalid.</exception>
         <param name="format">
@@ -1975,6 +2056,10 @@ public class UInt64ToStringExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance as specified by <paramref name="format" /> and <paramref name="provider" />.</para>
+        </returns>
         <param name="format">
           <attribution license="cc4" from="Microsoft" modified="false" />A numeric format string.</param>
         <param name="provider">
diff --git a/mcs/class/corlib/Documentation/en/System/UIntPtr.xml b/mcs/class/corlib/Documentation/en/System/UIntPtr.xml
index 687b7b275a3..7113499a05d 100644
--- a/mcs/class/corlib/Documentation/en/System/UIntPtr.xml
+++ b/mcs/class/corlib/Documentation/en/System/UIntPtr.xml
@@ -140,7 +140,6 @@
         <Parameter Name="offset" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.IntPtr.Add(System.IntPtr,System.Int32)" /> method does not throw an exception if the result is too large to represent as a pointer on the specified platform. Instead, the addition operation is performed in an unchecked context.</para>
@@ -150,6 +149,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an offset to the value of an unsigned pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new unsigned pointer that reflects the addition of <paramref name="offset" /> to <paramref name="pointer" />.</para>
+        </returns>
         <param name="pointer">
           <attribution license="cc4" from="Microsoft" modified="false" />The unsigned pointer to add the offset to.</param>
         <param name="offset">
@@ -173,14 +176,6 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="obj" /> is a <see cref="T:System.UIntPtr" /> instance and has the same value as the 
- current instance. If <paramref name="obj" /> is a null reference or is not an instance of
-<see cref="T:System.UIntPtr" /> , 
- returns <see langword="false" />.</para>
-          <see langword="" />
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note">The method overrides <see cref="M:System.Object.Equals(System.Object)" qualify="true" />.</block>
@@ -192,6 +187,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether this instance is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> is an instance of <see cref="T:System.UIntPtr" /> and equals the value of this instance; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with this instance or null. </param>
       </Docs>
@@ -212,10 +211,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" />
-containing the hash code for the current instance.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note">The algorithm used to generate the
@@ -229,6 +224,10 @@ containing the hash code for the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -247,7 +246,6 @@ containing the hash code for the current instance.</para>
         <Parameter Name="offset" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.UIntPtr.op_Addition(System.UIntPtr,System.Int32)" /> method defines the addition operation for <see cref="T:System.UIntPtr" /> objects. It enables code such as the following.</para>
@@ -259,6 +257,10 @@ containing the hash code for the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Adds an offset to the value of an unsigned pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new unsigned pointer that reflects the addition of <paramref name="offset" /> to <paramref name="pointer" />.</para>
+        </returns>
         <param name="pointer">
           <attribution license="cc4" from="Microsoft" modified="false" />The unsigned pointer to add the offset to.</param>
         <param name="offset">
@@ -283,11 +285,6 @@ containing the hash code for the current instance.</para>
         <Parameter Name="value2" Type="System.UIntPtr" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="value1" /> represents the same value as 
-<paramref name="value2" />; otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <altmember cref="M:System.UIntPtr.Equals(System.Object)" />
         <param name="value2">
@@ -296,6 +293,10 @@ containing the hash code for the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two specified instances of <see cref="T:System.UIntPtr" /> are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value1" /> equals <paramref name="value2" />; otherwise, false.</para>
+        </returns>
         <param name="value1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first pointer or handle to compare. </param>
         <param name="value2">
@@ -463,11 +464,6 @@ containing the hash code for the current instance.</para>
         <Parameter Name="value2" Type="System.UIntPtr" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true" /> if <paramref name="value1" /> represents a different value than 
-<paramref name="value2" />; otherwise, <see langword="false" />.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <altmember cref="M:System.UIntPtr.Equals(System.Object)" />
         <param name="value2">
@@ -476,6 +472,10 @@ containing the hash code for the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two specified instances of <see cref="T:System.UIntPtr" /> are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="value1" /> does not equal <paramref name="value2" />; otherwise, false.</para>
+        </returns>
         <param name="value1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first pointer or handle to compare. </param>
         <param name="value2">
@@ -498,7 +498,6 @@ containing the hash code for the current instance.</para>
         <Parameter Name="offset" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.UIntPtr.op_Subtraction(System.UIntPtr,System.Int32)" /> method defines the subtraction operation for <see cref="T:System.UIntPtr" /> objects. It enables code such as the following.</para>
@@ -510,6 +509,10 @@ containing the hash code for the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts an offset from the value of an unsigned pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new unsigned pointer that reflects the subtraction of <paramref name="offset" /> from <paramref name="pointer" />.</para>
+        </returns>
         <param name="pointer">
           <attribution license="cc4" from="Microsoft" modified="false" />The unsigned pointer to subtract the offset from.</param>
         <param name="offset">
@@ -565,7 +568,6 @@ containing the hash code for the current instance.</para>
         <Parameter Name="offset" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.IntPtr.Subtract(System.IntPtr,System.Int32)" /> method does not throw an exception if the result is too small to represent as a pointer on the specified platform. Instead, the subtraction operation is performed in an unchecked context.</para>
@@ -575,6 +577,10 @@ containing the hash code for the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Subtracts an offset from the value of an unsigned pointer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new unsigned pointer that reflects the subtraction of <paramref name="offset" /> from <paramref name="pointer" />.</para>
+        </returns>
         <param name="pointer">
           <attribution license="cc4" from="Microsoft" modified="false" />The unsigned pointer to subtract the offset from.</param>
         <param name="offset">
@@ -632,9 +638,6 @@ containing the hash code for the current instance.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A pointer to <see langword="void" />. </para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note">A pointer to <see langword="void" />
@@ -647,6 +650,10 @@ points to memory containing data of an unspecified type.</block>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to a pointer to an unspecified type.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A pointer to <see cref="T:System.Void" />; that is, a pointer to memory containing data of an unspecified type.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -665,10 +672,6 @@ points to memory containing data of an unspecified type.</block>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" />
-representation of the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>If the value of the <see cref="P:System.IntPtr.Size" /> property for this instance is 4, then this method is equivalent to <see cref="M:System.UInt32.ToString" />; otherwise, this method is equivalent to <see cref="M:System.UInt64.ToString" />.</para>
@@ -677,6 +680,10 @@ representation of the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the numeric value of this instance to its equivalent string representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The string representation of the value of this instance.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -695,10 +702,6 @@ representation of the current instance.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.UInt32" /> containing the
- same value as the current instance.</para>
-        </returns>
         <exception cref="T:System.OverflowException">The current platform is not a 32-bit platform and the value of the current instance is greater than <see cref="F:System.UInt32.MaxValue" /> .</exception>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -708,6 +711,10 @@ representation of the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to a 32-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit unsigned integer equal to the value of this instance.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -726,15 +733,15 @@ representation of the current instance.</para>
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.UInt64" /> containing the 
-   same value as the current instance.</para>
-        </returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of this instance to a 64-bit unsigned integer.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 64-bit unsigned integer equal to the value of this instance.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System/ValueType.xml b/mcs/class/corlib/Documentation/en/System/ValueType.xml
index 9b3e8415a2b..c3b74d43285 100644
--- a/mcs/class/corlib/Documentation/en/System/ValueType.xml
+++ b/mcs/class/corlib/Documentation/en/System/ValueType.xml
@@ -92,12 +92,6 @@ class Boxer {
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>
-            <see langword="true " />if <paramref name="obj" /> and the current
-   instance are of the same type and represent the same value; otherwise,
-<see langword="false" />.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ValueType.Equals(System.Object)" /> method overrides <see cref="M:System.Object.Equals(System.Object)" /> and provides the default implementation of value equality for all value types in the .NET Framework. </para>
@@ -114,6 +108,10 @@ class Boxer {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Indicates whether this instance and a specified object are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="obj" /> and this instance are the same type and represent the same value; otherwise, false. </para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />The object to compare with the current instance. </param>
       </Docs>
@@ -134,9 +132,6 @@ class Boxer {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> containing the hash code for the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <see cref="M:System.ValueType.GetHashCode" /> method applies to types derived from <see cref="T:System.ValueType" />. One or more fields of the derived type is used to calculate the return value. If you call the derived type's GetHashCode method, the return value is not likely to be suitable for use as a key in a hash table. Additionally, if the value of one or more of those fields changes, the return value might become unsuitable for use as a key in a hash table. In either case, consider writing your own implementation of the <see cref="M:System.ValueType.GetHashCode" /> method that more closely represents the concept of a hash code for the type. </para>
@@ -150,6 +145,10 @@ class Boxer {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the hash code for this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer that is the hash code for this instance.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -168,10 +167,6 @@ class Boxer {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.String" /> representation of the fully-qualified name of
-   the type of the current instance.</para>
-        </returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>When you call the <see cref="M:System.ValueType.ToString" /> method on a wrt structure, it provides the default behavior for value types that don’t override <see cref="M:System.ValueType.ToString" />. This is part of the support that the .NET Framework provides for the wrt (see <format type="text/html"><a href="6fa7d044-ae12-4c54-b8ee-50915607a565">.NET Framework Support for Windows Store Apps and Windows Runtime</a></format>). wrt structures can’t override <see cref="M:System.ValueType.ToString" />, even if they’re written with C# or Visual Basic, because they can’t have methods. (In addition, structures in the wrt itself don’t inherit <see cref="T:System.ValueType" />.) However, they appear to have <see cref="M:System.ValueType.ToString" />, <see cref="M:System.ValueType.Equals(System.Object)" />, and <see cref="M:System.ValueType.GetHashCode" /> methods when you use them in your C# or Visual Basic code, and the .NET Framework provides the default behavior for these methods. </para>
@@ -180,6 +175,10 @@ class Boxer {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns the fully qualified type name of this instance.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.String" /> containing a fully qualified type name.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
diff --git a/mcs/class/corlib/Documentation/en/System/Version.xml b/mcs/class/corlib/Documentation/en/System/Version.xml
index 131de9c00e8..7511c11c872 100644
--- a/mcs/class/corlib/Documentation/en/System/Version.xml
+++ b/mcs/class/corlib/Documentation/en/System/Version.xml
@@ -416,10 +416,6 @@ class VersionBuildExample {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A new <see cref="T:System.Object" />
-whose values are equal to the property values of the current instance.</para>
-        </returns>
         <example>
           <para>The following example clones the version number and
       writes the result to the console.</para>
@@ -454,6 +450,10 @@ class VersionCloneExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a new <see cref="T:System.Version" /> object whose value is the same as the current <see cref="T:System.Version" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A new <see cref="T:System.Object" /> whose values are a copy of the current <see cref="T:System.Version" /> object.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -474,33 +474,6 @@ class VersionCloneExample {
         <Parameter Name="version" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="version" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> A negative number</term>
-              <description> Current instance &lt; <paramref name="version" />.</description>
-            </item>
-            <item>
-              <term> Zero</term>
-              <description>Current instance ==
-   <paramref name="version" />.</description>
-            </item>
-            <item>
-              <term> A positive number</term>
-              <description>
-                <para> Current instance &gt;
-      <paramref name="version" />, or <paramref name="version" /> is a null
-         reference.</para>
-              </description>
-            </item>
-          </list>
-          <list type="table" />
-        </returns>
         <exception cref="T:System.ArgumentException">
           <paramref name="version" /> is not a <see cref="T:System.Version" /> and is not a null reference</exception>
         <example>
@@ -568,6 +541,49 @@ class VersionTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current <see cref="T:System.Version" /> object to a specified object and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative values of the two objects, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Meaning </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>The current <see cref="T:System.Version" /> object is a version before <paramref name="version" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>The current <see cref="T:System.Version" /> object is the same version as <paramref name="version" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>The current <see cref="T:System.Version" /> object is a version subsequent to <paramref name="version" />.</para>
+                <para>-or- </para>
+                <para>
+                  <paramref name="version" /> is null. </para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="version">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare, or null. </param>
       </Docs>
@@ -588,33 +604,6 @@ class VersionTest {
         <Parameter Name="value" Type="System.Version" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>The return value is a negative number, zero, or a positive number reflecting the sort order of the current instance as compared to <paramref name="version" />. For non-zero return values, the exact value returned by this method is unspecified. The following table defines the return value:</para>
-          <list type="table">
-            <listheader>
-              <term>Return Value</term>
-              <description>Description</description>
-            </listheader>
-            <item>
-              <term> A negative number</term>
-              <description> Current instance &lt; <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> Zero</term>
-              <description>Current instance ==
-   <paramref name="value" />.</description>
-            </item>
-            <item>
-              <term> A positive number</term>
-              <description>
-                <para> Current instance &gt;
-      <paramref name="value" />, or <paramref name="value" /> is a null
-         reference.</para>
-              </description>
-            </item>
-          </list>
-          <list type="table" />
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -642,6 +631,49 @@ class VersionTest {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Compares the current <see cref="T:System.Version" /> object to a specified <see cref="T:System.Version" /> object and returns an indication of their relative values.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A signed integer that indicates the relative values of the two objects, as shown in the following table.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>Return value </para>
+                </term>
+                <description>
+                  <para>Meaning </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>Less than zero </para>
+              </term>
+              <description>
+                <para>The current <see cref="T:System.Version" /> object is a version before <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Zero </para>
+              </term>
+              <description>
+                <para>The current <see cref="T:System.Version" /> object is the same version as <paramref name="value" />. </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>Greater than zero </para>
+              </term>
+              <description>
+                <para>The current <see cref="T:System.Version" /> object is a version subsequent to <paramref name="value" />. </para>
+                <para>-or-</para>
+                <para>
+                  <paramref name="value" /> is null.</para>
+              </description>
+            </item>
+          </list>
+        </returns>
         <param name="value">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Version" /> object to compare to the current <see cref="T:System.Version" /> object, or null.</param>
       </Docs>
@@ -663,12 +695,6 @@ class VersionTest {
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" /> where <see langword="true" />
-indicates <paramref name="obj" /> is
-the same type as the current instance and has equal <see cref="P:System.Version.Major" />, <see cref="P:System.Version.Minor" />, <see cref="P:System.Version.Build" />, and <see cref="P:System.Version.Revision" /> properties as the current
-instance. If <paramref name="obj" /> is a null reference or is not an instance of <see cref="T:System.Version" />, returns <see langword="false" />.</para>
-        </returns>
         <remarks>
           <para>
             <block subset="none" type="note">This method
@@ -704,6 +730,10 @@ class VersionEqualsExample {
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the current <see cref="T:System.Version" /> object is equal to a specified object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the current <see cref="T:System.Version" /> object and <paramref name="obj" /> are both <see cref="T:System.Version" /> objects, and every component of the current <see cref="T:System.Version" /> object matches the corresponding component of <paramref name="obj" />; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />An object to compare with the current <see cref="T:System.Version" /> object, or null. </param>
       </Docs>
@@ -724,11 +754,6 @@ class VersionEqualsExample {
         <Parameter Name="obj" Type="System.Version" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" /> where <see langword="true" />
-indicates <paramref name="obj" /> has equal <see cref="P:System.Version.Major" />, <see cref="P:System.Version.Minor" />, <see cref="P:System.Version.Build" />, and <see cref="P:System.Version.Revision" /> properties as the current
-instance. If <paramref name="obj" /> is a null reference, returns <see langword="false" />.</para>
-        </returns>
         <since version=".NET 2.0" />
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
@@ -738,6 +763,10 @@ instance. If <paramref name="obj" /> is a null reference, returns <see langword=
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a value indicating whether the current <see cref="T:System.Version" /> object and a specified <see cref="T:System.Version" /> object represent the same value.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if every component of the current <see cref="T:System.Version" /> object matches the corresponding component of the <paramref name="obj" /> parameter; otherwise, false.</para>
+        </returns>
         <param name="obj">
           <attribution license="cc4" from="Microsoft" modified="false" />A <see cref="T:System.Version" /> object to compare to the current <see cref="T:System.Version" /> object, or null.</param>
       </Docs>
@@ -757,10 +786,6 @@ instance. If <paramref name="obj" /> is a null reference, returns <see langword=
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Int32" /> 
-containing the hash code for the current instance.</para>
-        </returns>
         <remarks>
           <para>The algorithm used to generate the hash code is
       unspecified.</para>
@@ -773,6 +798,10 @@ containing the hash code for the current instance.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Returns a hash code for the current <see cref="T:System.Version" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A 32-bit signed integer hash code.</para>
+        </returns>
       </Docs>
       <Excluded>0</Excluded>
     </Member>
@@ -936,12 +965,6 @@ class VersionMinorExample {
         <Parameter Name="v2" Type="System.Version" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" /> where
-<see langword="true" /> 
-indicates <paramref name="v1" /> and <paramref name="v2" /> have equal <see cref="P:System.Version.Major" />, <see cref="P:System.Version.Minor" />, <see cref="P:System.Version.Build" />, and <see cref="P:System.Version.Revision" /> properties, or both <paramref name="v1" /> and
-<paramref name="v2" /> are <see langword="null" />; otherwise <see langword="false" />.</para>
-        </returns>
         <remarks>
           <para>The parts of the version number are compared 
       independently starting with the <see cref="P:System.Version.Major" /> property and then the <see cref="P:System.Version.Minor" />, <see cref="P:System.Version.Build" />, and <see cref="P:System.Version.Revision" /> properties, in order. This method returns
@@ -951,6 +974,10 @@ indicates <paramref name="v1" /> and <paramref name="v2" /> have equal <see cref
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two specified <see cref="T:System.Version" /> objects are equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="v1" /> equals <paramref name="v2" />; otherwise, false.</para>
+        </returns>
         <param name="v1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Version" /> object. </param>
         <param name="v2">
@@ -976,11 +1003,6 @@ indicates <paramref name="v1" /> and <paramref name="v2" /> have equal <see cref
         <Parameter Name="v2" Type="System.Version" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" /> where <see langword="true" /> indicates <paramref name="v1 " />is greater
-   than <paramref name="v2" />; otherwise <see langword="false" />. If <paramref name="v1" /> is
-<see langword="null" />, <see langword="false" /> is returned.</para>
-        </returns>
         <remarks>
           <para>The parts of the version number are compared independently starting with the 
    <see cref="P:System.Version.Major" /> 
@@ -994,6 +1016,10 @@ indicates <paramref name="v1" /> and <paramref name="v2" /> have equal <see cref
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the first specified <see cref="T:System.Version" /> object is greater than the second specified <see cref="T:System.Version" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="v1" /> is greater than <paramref name="v2" />; otherwise, false.</para>
+        </returns>
         <param name="v1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Version" /> object. </param>
         <param name="v2">
@@ -1019,12 +1045,6 @@ indicates <paramref name="v1" /> and <paramref name="v2" /> have equal <see cref
         <Parameter Name="v2" Type="System.Version" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" /> where <see langword="true" /> indicates <paramref name="v1 " />is greater
-   than or equal to <paramref name="v2" />; otherwise <see langword="false" />. If <paramref name="v1" />
-   is <see langword="null" />, <see langword="false" /> is returned.</para>
-          <see langword="" />
-        </returns>
         <remarks>
           <para>The parts of the version number are compared independently starting with the 
    <see cref="P:System.Version.Major" /> 
@@ -1038,6 +1058,10 @@ indicates <paramref name="v1" /> and <paramref name="v2" /> have equal <see cref
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the first specified <see cref="T:System.Version" /> object is greater than or equal to the second specified <see cref="T:System.Version" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="v1" /> is greater than or equal to <paramref name="v2" />; otherwise, false.</para>
+        </returns>
         <param name="v1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Version" /> object. </param>
         <param name="v2">
@@ -1063,16 +1087,6 @@ indicates <paramref name="v1" /> and <paramref name="v2" /> have equal <see cref
         <Parameter Name="v2" Type="System.Version" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" />
-where <see langword="true" /> indicates <paramref name="v1" /> and <paramref name="v2" /> have at least
-one unequal property; otherwise
-<see langword="false" />. If 
-<paramref name="v1" /> and <paramref name="v2" /> are 
-both <see langword="null" />, returns false; if one is
-<see langword="null" /> 
-but not the other, returns <see langword="true" />.</para>
-        </returns>
         <remarks>
           <para>The parts of the version number are compared independently starting with the 
    <see cref="P:System.Version.Major" /> 
@@ -1084,6 +1098,10 @@ but not the other, returns <see langword="true" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether two specified <see cref="T:System.Version" /> objects are not equal.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="v1" /> does not equal <paramref name="v2" />; otherwise, false.</para>
+        </returns>
         <param name="v1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Version" /> object. </param>
         <param name="v2">
@@ -1109,11 +1127,6 @@ but not the other, returns <see langword="true" />.</para>
         <Parameter Name="v2" Type="System.Version" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" /> where <see langword="true" /> indicates <paramref name="v1 " />is less than
-<paramref name="v2" />; otherwise <see langword="false" />. If <paramref name="v2" /> is <see langword="null" />, 
-<see langword="false" /> is returned.</para>
-        </returns>
         <remarks>
           <para>The parts of the version number are compared independently starting with the 
    <see cref="P:System.Version.Major" /> 
@@ -1127,6 +1140,10 @@ but not the other, returns <see langword="true" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the first specified <see cref="T:System.Version" /> object is less than the second specified <see cref="T:System.Version" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="v1" /> is less than <paramref name="v2" />; otherwise, false.</para>
+        </returns>
         <param name="v1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Version" /> object. </param>
         <param name="v2">
@@ -1152,12 +1169,6 @@ but not the other, returns <see langword="true" />.</para>
         <Parameter Name="v2" Type="System.Version" />
       </Parameters>
       <Docs>
-        <returns>
-          <para>A <see cref="T:System.Boolean" qualify="true" /> where <see langword="true" /> indicates <paramref name="v1 " />is less than or
-   equal to <paramref name="v2" />; otherwise <see langword="false" />. If <paramref name="v2" /> is
-<see langword="null" />, <see langword="false" /> is returned.</para>
-          <see langword="" />
-        </returns>
         <remarks>
           <para>The parts of the version number are compared independently starting with the 
    <see cref="P:System.Version.Major" /> 
@@ -1171,6 +1182,10 @@ but not the other, returns <see langword="true" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Determines whether the first specified <see cref="T:System.Version" /> object is less than or equal to the second <see cref="T:System.Version" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if <paramref name="v1" /> is less than or equal to <paramref name="v2" />; otherwise, false.</para>
+        </returns>
         <param name="v1">
           <attribution license="cc4" from="Microsoft" modified="false" />The first <see cref="T:System.Version" /> object. </param>
         <param name="v2">
@@ -1192,7 +1207,6 @@ but not the other, returns <see langword="true" />.</para>
         <Parameter Name="input" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>The <paramref name="input" /> parameter must have the following format:</para>
@@ -1207,6 +1221,10 @@ but not the other, returns <see langword="true" />.</para>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the string representation of a version number to an equivalent <see cref="T:System.Version" /> object.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is equivalent to the version number specified in the <paramref name="input" /> parameter.</para>
+        </returns>
         <param name="input">
           <attribution license="cc4" from="Microsoft" modified="false" />A string that contains a version number to convert.</param>
       </Docs>
@@ -1272,12 +1290,17 @@ class VersionRevisionExample {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current <see cref="T:System.Version" /> object to its equivalent <see cref="T:System.String" /> representation.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.String" /> representation of the values of the major, minor, build, and revision components of the current <see cref="T:System.Version" /> object, as depicted in the following format. Each component is separated by a period character ('.'). Square brackets ('[' and ']') indicate a component that will not appear in the return value if the component is not defined: </para>
+          <para>major.minor[.build[.revision]] </para>
+          <para>For example, if you create a <see cref="T:System.Version" /> object using the constructor Version(1,1), the returned string is "1.1". If you create a <see cref="T:System.Version" /> object using the constructor Version(1,3,4,2), the returned string is "1.3.4.2".</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="ToString">
@@ -1296,12 +1319,68 @@ class VersionRevisionExample {
         <Parameter Name="fieldCount" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <returns>To be added.</returns>
         <remarks>To be added.</remarks>
         <summary>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Converts the value of the current <see cref="T:System.Version" /> object to its equivalent <see cref="T:System.String" /> representation. A specified count indicates the number of components to return.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The <see cref="T:System.String" /> representation of the values of the major, minor, build, and revision components of the current <see cref="T:System.Version" /> object, each separated by a period character ('.'). The <paramref name="fieldCount" /> parameter determines how many components are returned.</para>
+          <list type="table">
+            <listheader>
+              <item>
+                <term>
+                  <para>fieldCount </para>
+                </term>
+                <description>
+                  <para>Return Value </para>
+                </description>
+              </item>
+            </listheader>
+            <item>
+              <term>
+                <para>0 </para>
+              </term>
+              <description>
+                <para>An empty string (""). </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>1 </para>
+              </term>
+              <description>
+                <para>major </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>2 </para>
+              </term>
+              <description>
+                <para>major.minor </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>3 </para>
+              </term>
+              <description>
+                <para>major.minor.build </para>
+              </description>
+            </item>
+            <item>
+              <term>
+                <para>4 </para>
+              </term>
+              <description>
+                <para>major.minor.build.revision </para>
+              </description>
+            </item>
+          </list>
+          <para>For example, if you create <see cref="T:System.Version" /> object using the constructor Version(1,3,5), ToString(2) returns "1.3" and ToString(4) throws an exception.</para>
+        </returns>
         <param name="fieldCount">
           <attribution license="cc4" from="Microsoft" modified="false" />The number of components to return. The <paramref name="fieldCount" /> ranges from 0 to 4. </param>
       </Docs>
diff --git a/mcs/class/corlib/Documentation/en/System/_AppDomain.xml b/mcs/class/corlib/Documentation/en/System/_AppDomain.xml
index d18a3ae8c66..7550819f4df 100644
--- a/mcs/class/corlib/Documentation/en/System/_AppDomain.xml
+++ b/mcs/class/corlib/Documentation/en/System/_AppDomain.xml
@@ -201,7 +201,6 @@
         <Parameter Name="typeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.ObjectHandle'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.CreateInstance(System.String,System.String)" /> method.</para>
@@ -210,6 +209,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.CreateInstance(System.String,System.String)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is a wrapper for the new instance specified by <paramref name="typeName" />. The return value needs to be unwrapped to access the real object.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The display name of the assembly. See <see cref="P:System.Reflection.Assembly.FullName" />.</param>
         <param name="typeName">
@@ -234,7 +237,6 @@
         <Parameter Name="activationAttributes" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.ObjectHandle'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.CreateInstance(System.String,System.String,System.Object[])" /> method overload.</para>
@@ -244,6 +246,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.CreateInstance(System.String,System.String,System.Object[])" /> method overload.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is a wrapper for the new instance specified by <paramref name="typeName" />. The return value needs to be unwrapped to access the real object.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The display name of the assembly. See <see cref="P:System.Reflection.Assembly.FullName" />.</param>
         <param name="typeName">
@@ -276,7 +282,6 @@
         <Parameter Name="securityAttributes" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.ObjectHandle'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.CreateInstance(System.String,System.String,System.Boolean,System.Reflection.BindingFlags,System.Reflection.Binder,System.Object[],System.Globalization.CultureInfo,System.Object[],System.Security.Policy.Evidence)" /> method overload. </para>
@@ -286,6 +291,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.CreateInstance(System.String,System.String,System.Boolean,System.Reflection.BindingFlags,System.Reflection.Binder,System.Object[],System.Globalization.CultureInfo,System.Object[],System.Security.Policy.Evidence)" /> method overload.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is a wrapper for the new instance specified by <paramref name="typeName" />. The return value needs to be unwrapped to access the real object.</para>
+        </returns>
         <param name="assemblyName">
           <attribution license="cc4" from="Microsoft" modified="false" />The display name of the assembly. See <see cref="P:System.Reflection.Assembly.FullName" />.</param>
         <param name="typeName">
@@ -323,7 +332,6 @@
         <Parameter Name="typeName" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.ObjectHandle'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.CreateInstanceFrom(System.String,System.String)" /> method overload.</para>
@@ -332,6 +340,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.CreateInstanceFrom(System.String,System.String)" /> method overload.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is a wrapper for the new instance, or null if <paramref name="typeName" /> is not found. The return value needs to be unwrapped to access the real object.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The name, including the path, of a file that contains an assembly that defines the requested type. The assembly is loaded using the <see cref="M:System.Reflection.Assembly.LoadFrom(System.String)" />  method.</param>
         <param name="typeName">
@@ -356,7 +368,6 @@
         <Parameter Name="activationAttributes" Type="System.Object[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.ObjectHandle'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.CreateInstanceFrom(System.String,System.String,System.Object[])" /> method overload.</para>
@@ -366,6 +377,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.CreateInstanceFrom(System.String,System.String,System.Object[])" /> method overload.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is a wrapper for the new instance, or null if <paramref name="typeName" /> is not found. The return value needs to be unwrapped to access the real object.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The name, including the path, of a file that contains an assembly that defines the requested type. The assembly is loaded using the <see cref="M:System.Reflection.Assembly.LoadFrom(System.String)" />  method. </param>
         <param name="typeName">
@@ -398,7 +413,6 @@
         <Parameter Name="securityAttributes" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Runtime.Remoting.ObjectHandle'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.CreateInstanceFrom(System.String,System.String,System.Boolean,System.Reflection.BindingFlags,System.Reflection.Binder,System.Object[],System.Globalization.CultureInfo,System.Object[],System.Security.Policy.Evidence)" /> method overload.</para>
@@ -408,6 +422,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.CreateInstanceFrom(System.String,System.String,System.Boolean,System.Reflection.BindingFlags,System.Reflection.Binder,System.Object[],System.Globalization.CultureInfo,System.Object[],System.Security.Policy.Evidence)" /> method overload.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object that is a wrapper for the new instance, or null if <paramref name="typeName" /> is not found. The return value needs to be unwrapped to access the real object.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The name, including the path, of a file that contains an assembly that defines the requested type. The assembly is loaded using the <see cref="M:System.Reflection.Assembly.LoadFrom(System.String)" />  method.</param>
         <param name="typeName">
@@ -445,7 +463,6 @@
         <Parameter Name="access" Type="System.Reflection.Emit.AssemblyBuilderAccess" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.Emit.AssemblyBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.DefineDynamicAssembly(System.Reflection.AssemblyName,System.Reflection.Emit.AssemblyBuilderAccess)" /> method overload.</para>
@@ -454,6 +471,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.DefineDynamicAssembly(System.Reflection.AssemblyName,System.Reflection.Emit.AssemblyBuilderAccess)" /> method overload.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Represents the dynamic assembly created.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique identity of the dynamic assembly. </param>
         <param name="access">
@@ -478,7 +499,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.Emit.AssemblyBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.DefineDynamicAssembly(System.Reflection.AssemblyName,System.Reflection.Emit.AssemblyBuilderAccess,System.Security.Policy.Evidence)" /> method overload.</para>
@@ -487,6 +507,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.DefineDynamicAssembly(System.Reflection.AssemblyName,System.Reflection.Emit.AssemblyBuilderAccess,System.Security.Policy.Evidence)" /> method overload.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Represents the dynamic assembly created.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique identity of the dynamic assembly. </param>
         <param name="access">
@@ -513,7 +537,6 @@
         <Parameter Name="dir" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.Emit.AssemblyBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.DefineDynamicAssembly(System.Reflection.AssemblyName,System.Reflection.Emit.AssemblyBuilderAccess,System.String)" /> method overload.</para>
@@ -522,6 +545,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.DefineDynamicAssembly(System.Reflection.AssemblyName,System.Reflection.Emit.AssemblyBuilderAccess,System.String)" /> method overload.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Represents the dynamic assembly created.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique identity of the dynamic assembly. </param>
         <param name="access">
@@ -549,7 +576,6 @@
         <Parameter Name="evidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.Emit.AssemblyBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.DefineDynamicAssembly(System.Reflection.AssemblyName,System.Reflection.Emit.AssemblyBuilderAccess,System.String,System.Security.Policy.Evidence)" /> method overload.</para>
@@ -558,6 +584,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.DefineDynamicAssembly(System.Reflection.AssemblyName,System.Reflection.Emit.AssemblyBuilderAccess,System.String,System.Security.Policy.Evidence)" /> method overload.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Represents the dynamic assembly created.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique identity of the dynamic assembly. </param>
         <param name="access">
@@ -588,7 +618,6 @@
         <Parameter Name="refusedPermissions" Type="System.Security.PermissionSet" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.Emit.AssemblyBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.DefineDynamicAssembly(System.Reflection.AssemblyName,System.Reflection.Emit.AssemblyBuilderAccess,System.Security.PermissionSet,System.Security.PermissionSet,System.Security.PermissionSet)" /> method overload.</para>
@@ -597,6 +626,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.DefineDynamicAssembly(System.Reflection.AssemblyName,System.Reflection.Emit.AssemblyBuilderAccess,System.Security.PermissionSet,System.Security.PermissionSet,System.Security.PermissionSet)" /> method overload.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Represents the dynamic assembly created.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique identity of the dynamic assembly. </param>
         <param name="access">
@@ -630,7 +663,6 @@
         <Parameter Name="refusedPermissions" Type="System.Security.PermissionSet" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.Emit.AssemblyBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.DefineDynamicAssembly(System.Reflection.AssemblyName,System.Reflection.Emit.AssemblyBuilderAccess,System.Security.Policy.Evidence,System.Security.PermissionSet,System.Security.PermissionSet,System.Security.PermissionSet)" /> method overload.</para>
@@ -639,6 +671,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.DefineDynamicAssembly(System.Reflection.AssemblyName,System.Reflection.Emit.AssemblyBuilderAccess,System.Security.Policy.Evidence,System.Security.PermissionSet,System.Security.PermissionSet,System.Security.PermissionSet)" /> method overload.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Represents the dynamic assembly created.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique identity of the dynamic assembly. </param>
         <param name="access">
@@ -674,7 +710,6 @@
         <Parameter Name="refusedPermissions" Type="System.Security.PermissionSet" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.Emit.AssemblyBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.DefineDynamicAssembly(System.Reflection.AssemblyName,System.Reflection.Emit.AssemblyBuilderAccess,System.String,System.Security.PermissionSet,System.Security.PermissionSet,System.Security.PermissionSet)" /> method overload.</para>
@@ -683,6 +718,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.DefineDynamicAssembly(System.Reflection.AssemblyName,System.Reflection.Emit.AssemblyBuilderAccess,System.String,System.Security.PermissionSet,System.Security.PermissionSet,System.Security.PermissionSet)" /> method overload.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Represents the dynamic assembly created.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique identity of the dynamic assembly. </param>
         <param name="access">
@@ -719,7 +758,6 @@
         <Parameter Name="refusedPermissions" Type="System.Security.PermissionSet" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.Emit.AssemblyBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.DefineDynamicAssembly(System.Reflection.AssemblyName,System.Reflection.Emit.AssemblyBuilderAccess,System.String,System.Security.Policy.Evidence,System.Security.PermissionSet,System.Security.PermissionSet,System.Security.PermissionSet)" /> method overload.</para>
@@ -728,6 +766,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.DefineDynamicAssembly(System.Reflection.AssemblyName,System.Reflection.Emit.AssemblyBuilderAccess,System.String,System.Security.Policy.Evidence,System.Security.PermissionSet,System.Security.PermissionSet,System.Security.PermissionSet)" /> method overload.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Represents the dynamic assembly created.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique identity of the dynamic assembly. </param>
         <param name="access">
@@ -767,7 +809,6 @@
         <Parameter Name="isSynchronized" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.Emit.AssemblyBuilder'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.DefineDynamicAssembly(System.Reflection.AssemblyName,System.Reflection.Emit.AssemblyBuilderAccess,System.String,System.Security.Policy.Evidence,System.Security.PermissionSet,System.Security.PermissionSet,System.Security.PermissionSet,System.Boolean)" /> method overload.</para>
@@ -776,6 +817,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.DefineDynamicAssembly(System.Reflection.AssemblyName,System.Reflection.Emit.AssemblyBuilderAccess,System.String,System.Security.Policy.Evidence,System.Security.PermissionSet,System.Security.PermissionSet,System.Security.PermissionSet,System.Boolean)" /> method overload.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Represents the dynamic assembly created.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The unique identity of the dynamic assembly. </param>
         <param name="access">
@@ -886,7 +931,6 @@
         <Parameter Name="other" Type="System.Object" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'bool'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.Object.Equals(System.Object)" /> method.</para>
@@ -895,6 +939,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the inherited <see cref="M:System.Object.Equals(System.Object)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>true if the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Object" />; otherwise, false.</para>
+        </returns>
         <param name="other">
           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Object" /> to compare to the current <see cref="T:System.Object" />. </param>
       </Docs>
@@ -939,7 +987,6 @@
         <Parameter Name="assemblyFile" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.ExecuteAssembly(System.String)" /> method overload.</para>
@@ -948,6 +995,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.ExecuteAssembly(System.String)" /> method overload.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value returned by the entry point of the assembly.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the file that contains the assembly to execute. </param>
       </Docs>
@@ -969,7 +1020,6 @@
         <Parameter Name="assemblySecurity" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.ExecuteAssembly(System.String,System.Security.Policy.Evidence)" /> method overload.</para>
@@ -978,6 +1028,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.ExecuteAssembly(System.String,System.Security.Policy.Evidence)" /> method overload.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value returned by the entry point of the assembly.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the file that contains the assembly to execute. </param>
         <param name="assemblySecurity">
@@ -1002,7 +1056,6 @@
         <Parameter Name="args" Type="System.String[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.ExecuteAssembly(System.String,System.Security.Policy.Evidence,System.String[])" /> method overload.</para>
@@ -1011,6 +1064,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.ExecuteAssembly(System.String,System.Security.Policy.Evidence,System.String[])" /> method overload.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value returned by the entry point of the assembly.</para>
+        </returns>
         <param name="assemblyFile">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of the file that contains the assembly to execute. </param>
         <param name="assemblySecurity">
@@ -1057,7 +1114,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Reflection.Assembly []'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.GetAssemblies" /> method.</para>
@@ -1066,6 +1122,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.GetAssemblies" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An array of assemblies in this application domain.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetData">
@@ -1084,7 +1144,6 @@
         <Parameter Name="name" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.GetData(System.String)" /> method.</para>
@@ -1093,6 +1152,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.GetData(System.String)" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The value of the <paramref name="name" /> property.</para>
+        </returns>
         <param name="name">
           <attribution license="cc4" from="Microsoft" modified="false" />The name of a predefined application domain property, or the name of an application domain property you have defined. </param>
       </Docs>
@@ -1111,7 +1174,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'int'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.Object.GetHashCode" /> method.</para>
@@ -1120,6 +1182,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the inherited <see cref="M:System.Object.GetHashCode" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A hash code for the current <see cref="T:System.Object" />.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetIDsOfNames">
@@ -1165,7 +1231,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.MarshalByRefObject.GetLifetimeService" /> method.</para>
@@ -1174,6 +1239,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the inherited <see cref="M:System.MarshalByRefObject.GetLifetimeService" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>An object of type <see cref="T:System.Runtime.Remoting.Lifetime.ILease" /> used to control the lifetime policy for this instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetType">
@@ -1190,7 +1259,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'Type'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.GetType" /> method.</para>
@@ -1199,6 +1267,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.GetType" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A <see cref="T:System.Type" /> representing the type of the current instance.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="GetTypeInfo">
@@ -1270,7 +1342,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'object'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.InitializeLifetimeService" /> method.</para>
@@ -1279,6 +1350,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.InitializeLifetimeService" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>Always null.</para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="Invoke">
@@ -1332,7 +1407,6 @@
         <Parameter Name="rawAssembly" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.Assembly'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.Load(System.Byte[])" /> method overload.</para>
@@ -1341,6 +1415,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.Load(System.Byte[])" /> method overload.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="rawAssembly">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type byte that is a COFF-based image containing an emitted assembly. </param>
       </Docs>
@@ -1361,7 +1439,6 @@
         <Parameter Name="assemblyRef" Type="System.Reflection.AssemblyName" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.Assembly'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.Load(System.Reflection.AssemblyName)" /> method overload.</para>
@@ -1370,6 +1447,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.Load(System.Reflection.AssemblyName)" /> method overload.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="assemblyRef">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that describes the assembly to load. </param>
       </Docs>
@@ -1390,7 +1471,6 @@
         <Parameter Name="assemblyString" Type="System.String" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.Assembly'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.Load(System.String)" /> method overload.</para>
@@ -1399,6 +1479,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.Load(System.String)" /> method overload.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="assemblyString">
           <attribution license="cc4" from="Microsoft" modified="false" />The display name of the assembly. See <see cref="P:System.Reflection.Assembly.FullName" />.</param>
       </Docs>
@@ -1420,7 +1504,6 @@
         <Parameter Name="rawSymbolStore" Type="System.Byte[]" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.Assembly'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.Load(System.Byte[],System.Byte[])" /> method overload.</para>
@@ -1429,6 +1512,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.Load(System.Byte[],System.Byte[])" /> method overload.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="rawAssembly">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type byte that is a COFF-based image containing an emitted assembly. </param>
         <param name="rawSymbolStore">
@@ -1452,7 +1539,6 @@
         <Parameter Name="assemblySecurity" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.Assembly'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.Load(System.Reflection.AssemblyName,System.Security.Policy.Evidence)" /> method overload.</para>
@@ -1461,6 +1547,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.Load(System.Reflection.AssemblyName,System.Security.Policy.Evidence)" /> method overload.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="assemblyRef">
           <attribution license="cc4" from="Microsoft" modified="false" />An object that describes the assembly to load. </param>
         <param name="assemblySecurity">
@@ -1484,7 +1574,6 @@
         <Parameter Name="assemblySecurity" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.Assembly'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.Load(System.String,System.Security.Policy.Evidence)" /> method overload.</para>
@@ -1493,6 +1582,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.Load(System.String,System.Security.Policy.Evidence)" /> method overload.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="assemblyString">
           <attribution license="cc4" from="Microsoft" modified="false" />The display name of the assembly. See <see cref="P:System.Reflection.Assembly.FullName" />.</param>
         <param name="assemblySecurity">
@@ -1517,7 +1610,6 @@
         <Parameter Name="securityEvidence" Type="System.Security.Policy.Evidence" />
       </Parameters>
       <Docs>
-        <returns>To be added: an object of type 'Reflection.Assembly'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.Load(System.Byte[],System.Byte[],System.Security.Policy.Evidence)" /> method overload.</para>
@@ -1526,6 +1618,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.Load(System.Byte[],System.Byte[],System.Security.Policy.Evidence)" /> method overload.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>The loaded assembly.</para>
+        </returns>
         <param name="rawAssembly">
           <attribution license="cc4" from="Microsoft" modified="false" />An array of type byte that is a COFF-based image containing an emitted assembly. </param>
         <param name="rawSymbolStore">
@@ -1815,7 +1911,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <returns>To be added: an object of type 'string'</returns>
         <remarks>
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>See the <see cref="M:System.AppDomain.ToString" /> method.</para>
@@ -1824,6 +1919,10 @@
           <attribution license="cc4" from="Microsoft" modified="false" />
           <para>Provides COM objects with version-independent access to the <see cref="M:System.AppDomain.ToString" /> method.</para>
         </summary>
+        <returns>
+          <attribution license="cc4" from="Microsoft" modified="false" />
+          <para>A string formed by concatenating the literal string "Name:", the friendly name of the application domain, and either string representations of the context policies or the string "There are no context policies." </para>
+        </returns>
       </Docs>
     </Member>
     <Member MemberName="TypeResolve">